# ThreeGate Tools

This directory contains stdlib-only validators and helper scripts.

## Validators

- `validate_research_packet.py`  
  Validates Research Packets before CORE consumption.

- `validate_tool_request.py`  
  Validates Tool Requests before TOOL-EXEC execution.

- `validate_tool_result.py`  
  Validates Tool Results before CORE consumption.

All validators are intentionally conservative.

## Quarantine scripts

- `validate_and_quarantine_packets.sh`
- `validate_and_quarantine_tool_requests.sh`
- `validate_and_quarantine_tool_results.sh`

These scripts:
- run the relevant validator
- move rejects into quarantine with validator output

## Quick Start

From repo root:

```sh
chmod +x tools/*.py tools/*.sh
tools/validate_and_quarantine_packets.sh
tools/validate_and_quarantine_tool_requests.sh
tools/validate_and_quarantine_tool_results.sh

Adjust directories using env vars if needed.


---

## Next (recommended)
To complete the “loop” safely, the next step is a **TOOL-EXEC request runner stub** that:

1) validates a request  
2) stages `/in` + empty `/out`  
3) invokes `tool-exec/era/era-wrapper.sh`  
4) captures stdout/stderr + hashes  
5) emits a Tool Result `.md` to `results_out/`