saphan route
Answers which tier a step is routed to under a routing policy: the first matching rule wins, otherwise the policy's default.
Answers which tier a step is routed to under a routing policy: the first matching rule wins, otherwise the policy's default. The policy comes from one manifest file (--policy) or from the default routing policy in a library (--library).
| flag | type | default | what it does |
|---|---|---|---|
--allow-unpinned | bool | false | Load --library even when its pin is missing or does not match; anyone who runs the command can pass it, and the bypass is recorded in the cost ledger and printed. |
--genre | string | The task genre, for a generation step whose routing depends on it. | |
--library | string | A library directory; its routing policy named default is used. Cannot be combined with --policy. | |
--pin | string | The git tag the --library checkout must be at. | |
--policy | string | A single routing-policy manifest file. Cannot be combined with --library. | |
--request-client | bool | false | Also ask the routing gate for a model-capable client: a step routed as deterministic is refused with exit 3 and the refusal is recorded in the cost ledger. A granted request is reported and then discarded — this command makes no model calls. |
Global options apply to every command — see Every command.
saphan round
Records facts about a round — one pass of work on a stream, normally carried out by an agent run — when part of that round was done by hand.
saphan run
Starts one process — an AI coding agent or any executable — under a mandate and records it as a run: the model, effort, budget, time limit, working directory and permissions are fixed up front, enforc