moai harness Harness
moai harness is a unified command tree that manages SPEC-complexity routing and the harness learning subsystem. It provides subcommands for routing, validation, lifecycle, proposal management, the v4 harness lifecycle, and the observation ledger.
Deciding how much harness gating a SPEC needs based on its scope is a decision manager agents must repeat every time, so this command accumulates the observation ledger to track how the routing rules are actually used. That makes it the single source of truth when routing inaccuracies recur and you need to trace the cause.
It accepts the common flag --project-root <path> (default: current directory).
| Command | Description |
|---|---|
moai harness route --spec <id> | Route a SPEC to a minimal/standard/thorough harness level |
moai harness validate | Validate harness.yaml against the schema and invariants |
route accepts --json (JSON output), --path <harness.yaml>, and --base-dir <dir>.
| Command | Description |
|---|---|
moai harness status | Show observation/tier/evolution summary |
moai harness apply | Return pending proposals to the orchestrator (or run the Go apply path with --execute) |
moai harness rollback <date> | Restore the snapshot for the given date |
moai harness disable | Disable the learning subsystem (learning.enabled: false) |
| Command | Description |
|---|---|
moai harness mute | Mute a proposal category (workflow.yaml) |
moai harness mute-list | Print the currently muted categories |
moai harness unmute | Remove a category from the mute list |
moai harness verify | Verify harness determinism |
| Command | Description |
|---|---|
moai harness list | List all v4 harnesses (name + domain + entry command) |
moai harness edit <name> | Show the edit paths for a v4 harness manifest + specialist |
moai harness remove <name> | Atomically remove a v4 harness (command + workflow + specialist + skill + manifest) |
moai harness doctor | Diagnose harness installation status |
list and edit accept the --json flag.
moai harness ledger manages the routing observation ledger.
| Command | Description |
|---|---|
moai harness ledger record | Record the routing decision at dispatch time (pending row) |
moai harness ledger annotate | Patch routing metadata into an already-existing pending row |
moai harness ledger evidence | Add a machine-evidence ref (or delegation entry) to a pending row |
moai harness ledger list | List final ledger rows with filters |
ledger recordandledger evidencedo not expose an--outcomeflag, so the outcome cannot be forged. The outcome is derived from the machine evidence.
moai harness delegation covers delegation map analysis built from the observed routing record.
| Command | Description |
|---|---|
moai harness delegation analyze | Analyze observed delegation history and produce a delegation-map proposal |