Reference

Reference pages document exact shapes: the commands an operator runs, the schemas that tooling parses, the manifest keys that bind a runtime, and the grammars that make an artifact well-formed or malformed. They are written to be checked against the source, not read end to end. Each one opens with a plain-language statement of what the thing is and who touches it, then gets specific.

If you are looking for why any of this is shaped the way it is, that belongs to How It Works. If you are looking for the TypeScript interfaces behind the CLI and the engine, that is the generated API documentation.

The pages

CLI reference

The gateline command is the gate frontend in terminal form. Every subcommand across the inspect, decide (including close and reopen), create, serve and integrate (render, init, validate, fork) groups, with purpose and key flags, plus the gateline-orchestrator engine binary, the gateline-runner-agent dispatch relay, and the dependency-free gateline-framework entry point.

state.yaml

The run-state contract, field by field: phases, the three profiles and their gate sets, the gate entry shape including burden, the closure record, the append-only budget ledger, task entries and review rounds, escalations and dispositions, and the co-writer rules both writers obey.

orchestrator.yaml

Schedules for periodic, gate-less role dispatches. The schedules.<role> keys, the interval grammar, where and when the engine reads the file, and the sweep derivation rules.

Adapter manifests

The manifest schema key by key, as a union across the three shipped adapters; how gateline render consumes role specs and manifests to write a runner's agent files; the deny-by-default permission map and the narrow-never-widen rule.

Contract grammar

The ten artifact contracts and their two normative rule families (the ID and heading grammars, and the READABILITY rules for human-facing sections), plus the AUDIENCE: line, the required-sections discipline, the bounce-never-guess rule, and the human-versus-orchestrator commit-message grammar.