Saphan StudioDocs
Reference/Commands

saphan harvest

Runs the Harvester for a project, which picks the next bug from the backlog for a coordinating agent and writes the order to fix it: show its settings, see what it would pick, or start it by hand.

Runs the Harvester for a project, which picks the next bug from the backlog for a coordinating agent and writes the order to fix it: show its settings, see what it would pick, or start it by hand. Run it with a subcommand.

saphan harvest

saphan harvest pick

Shows which backlog item the Harvester would take next for a coordinating agent, and why every other item was not taken; an item quoted above the project's cost cap is listed but never started. It records nothing and starts nothing.

saphan harvest pick --project <project>
flagtypedefaultwhat it does
--bugs-dirstringThe directory of bug reports; defaults to bridge/development/backlog/bugs in the workspace.
--customerboolfalseThe project belongs to a customer, so collection (harvest.<project>.collect) stays off unless it is set.
--projectstringThe project whose settings apply (required).
--trackstringWhich of this seat's tracks is asking; needed only when it holds more than one.
--trainstringA train whose open owed conditions join the backlog.
--train-dirstringThat train's directory, holding its OWED.md.

saphan harvest settings

Shows a project's Harvester settings and where each value came from.

saphan harvest settings --project <project>
flagtypedefaultwhat it does
--customerboolfalseThe project belongs to a customer, so collection (harvest.<project>.collect) stays off unless it is set.
--projectstringThe project whose settings to show (required).

saphan harvest start

Starts the Harvester by hand: records the start, asks the picker for the coordinating agent's next item and, if one is picked, writes the order for it from the fixed template, ready for a signature. It signs, places and merges nothing.

saphan harvest start --project <project> --repo <repo> --base <branch @ sha>
flagtypedefaultwhat it does
--basestringThe base the fix starts from, written as <branch> @ <sha> (required).
--bugs-dirstringThe directory of bug reports; defaults to bridge/development/backlog/bugs in the workspace.
--customerboolfalseThe project belongs to a customer, so collection (harvest.<project>.collect) stays off unless it is set.
--out-dirstringWhere the order is written; defaults to .saphan/harvest/orders in the workspace.
--projectstringThe project whose settings apply (required).
--repostringThe repository the fix lands in (required).
--trackstringWhich of this seat's tracks is asking; needed only when it holds more than one.
--trainstringA train whose open owed conditions join the backlog.
--train-dirstringThat train's directory, holding its OWED.md.

Global options apply to every command — see Every command.

On this page