pipemason

cli reference

pipemason program

Run a coordinated set of stories. The planning phase decomposes your intent into a DAG; the iterate phase dispatches one (or several, with parallelism) at a time.

Subcommands

pipemason program start "<intent>" --mode <mode> [flags]
pipemason program status [<program-id>]
pipemason program resume <program-id>
pipemason program cancel <program-id>
pipemason program list

start

pipemason program start "<intent>" \
  --mode greenfield-system|greenfield-mobile|brownfield-upgrade|brownfield-extension \
  [--dry-run] [--parallelism <n>] [--cost-ceiling <usd>]

status

Prints the program's current phase, story counts, and any escalated stories. If no id given, uses the program in the current repo's .pipeline/PROGRAM.md.

resume

Resume an escalated program after you've fixed the offending artifact (usually a per-story spec or contract).

cancel

Stop dispatching new stories. In-flight stories complete or escalate normally; nothing is force-killed. Idempotent.

Flags

--mode <mode>            Required for 'start'. One of:
                           greenfield-system, greenfield-mobile,
                           brownfield-upgrade, brownfield-extension.

--dry-run                Run program_plan only; freeze ROADMAP.md
                         and stop. Cheap way to review the
                         decomposition before spending tokens.

--parallelism <n>        Override config.yml. Up to n stories run
                         simultaneously when their deps are met.

--cost-ceiling <usd>     Pause the program if estimated cumulative
                         cost crosses this number.

--from <story-id>        Skip dispatching stories before this one
                         (resume-style; for surgically picking up
                         from a partial run).

What it writes

  • .pipeline/PROGRAM.md — program-level state.
  • .pipeline/ROADMAP.md — frozen story DAG.
  • .pipeline/AUDIT.md — only for brownfield-*.
  • .pipeline/MIGRATIONS.md — only for brownfield-upgrade.
  • .pipeline/DESIGN-SYSTEM.md — only for greenfield-*.
  • .pipeline/stories/<story-id>/ — per-story state.