# detz: C++23 port of tai.py

Future `molo detz` subcommand. See plan.md, SPEC.md, docs/.
Build: `make && make test`. Binary: `build/detz`. Rules for working here: `AGENTS.md`.

## What taicpp adds on top of the port

The port is behavior-compatible with `../tai.py` and checked against it (`PARITY.md`, `docs/parity.md`).
These parts exist only here; each has a specification and tests:

| Feature | Spec | Code | Tests |
|---|---|---|---|
| Fuzzy matching of identifiers (letter order, word boundaries, typos, trigrams) | [docs/fuzzy.md](docs/fuzzy.md) | `src/util/fuzzy.*` | `build/fuzzy_test` |
| CAP agents and their models: discovery, probes, `@agent`, `@agent:model`, `@model` | [docs/cap-agents.md](docs/cap-agents.md) | `src/cap/cap_model_catalog.*`, `src/cap/cap_mention.*` | `build/capmcp/cap_model_catalog_test` |
| Sub agents in live panels on the multiplexer screen, with supervision | [docs/orchestration.md](docs/orchestration.md) | `src/orch/`, `src/mplex/mplex_vpane.*` | `build/orch_test`, `tests/orch_mplex_e2e.py` |

Reading order for a new contributor: `docs/cap.md` (the protocol), `docs/cap-agents.md` (agents and
models), `docs/fuzzy.md` (how a mention is matched), `docs/mplex.md` and `docs/orchestration.md` (the screen).

## Using it

```
@claude refactor the parser           run one turn on a CAP agent (typos are fine: @clde)
@claude:opus review the diff          on a specific model of that agent
@opus review the diff                 a model name alone works when one agent offers it
@claude                               pin the agent for following messages;  @auto clears all pins
```

Sub agents (`fork` workers and agent turns) appear in panels on the right of the multiplexer screen while
they work; closing a panel cancels its agent. `TAI_ORCH_PANELS=0` turns the panels off.

## Tests

`make test` builds every test binary and runs `tests/run_all.py` (36 steps, logs in `build/test-logs/`).
Single steps: `python3 tests/run_all.py --only orch`, `--only mplex`, `--only capmcp`, `--only fuzzy`.
The research behind the decisions is in `../research/` (index: `../research/INDEX.md`).