saphan train

Shows and maintains trains: a train is a planned series of related work items, called wagons, declared in a train order and identified by its track name; each wagon is dispatched as its own stream. saphan train next answers what can be started now, what is blocked and by what, and what is already in progress.

saphan train

saphan train backfill

Proposes which train and wagon each stream already in the record belongs to, with the evidence for each guess: the stream's own order, the train order, or the stream's name. Without --write it only proposes; with --write it records the new placements, which fill in a train or wagon the order left empty and never override one it declares.

saphan train backfill --train my-train --corpus /abs/bridge
saphan train backfill --train my-train --corpus /abs/bridge --write --actor <owner>

saphan train backfill --train <train>

saphan train delegation

Writes the train-delegation block for a train order from the order's own wagon headings, one row per wagon with the reason printed beside it, and prints it; --write puts it into the file. The block is checked with the delegation door's own parser first. The coordinating agent then commits the file and the owner signs the train order.

saphan train delegation --order <TRAIN_ORDER.md> --master-key <apk-…>

saphan train next

For one track, lists each wagon its train order declares with its state, rounds so far, last verdict, what blocks it and whether it is independent, then sorts every wagon into dispatchable now, blocked, or in flight, each with a ready-to-run next command. It also prints the three conditions for starting another wagon — an independent unstarted wagon exists, a seat (agent slot) is free, the coordinating agent is under its concurrency cap — and only reads, so it is safe in a loop. It covers only wagons named in the train order: an order never dispatched and named in no train order is invisible to it, as the printed population line says.

saphan train next --track <track>

saphan train rename

Gives a train a display name of your own; its slug never changes, and --clear returns it to the generated name.

saphan train rename <train-slug> --name <name>

saphan train sign

Lets a train's coordinating agent sign a wagon order with its own key, writing only <order>.sig. The signature counts only at the delegation door, and only when the owner's newest signature on the train order delegates that wagon, role and quote to this key. For a review, sign the source order you pass to dispatch place --order.

saphan train sign <order>

saphan train wagon-edit

Edits the design of a wagon that has not been dispatched yet — title, cost quote, time budget, review mode, vendor and model, dependencies, allowed machines and preferred seat — and commits the new version of its order to the workspace's bridge repository. Use --dry-run to validate and preview the new header first.

saphan train wagon-edit my-train-w3 --quote 6 --wall 120m --review named --backend codex --model gpt-6-sol

saphan train wagon-edit <stream>

Global options apply to every command — see Every command.