mandrel 1.71.0 → 1.73.0

package/.agents/workflows/plan.md

@@ -44,6 +44,7 @@ forwards them to the active path helper:
 | `--force` | Epic | Close + recreate an existing ticket tree on re-plan. |
 | `--force-review` | Epic | Force the operator review gate even when risk routing would skip it. |
 | `--allow-over-budget` | Epic | Permit a decomposition that exceeds the framework `maxTickets` reviewability budget. |
+| `--yes` | both | **Non-interactive / headless mode.** Deterministically auto-proceeds the two `/plan` HITL STOP gates — the ideation one-pager / scope-triage confirm (gate #1) and the Phase-7 Epic operator review gate (gate #2) — without waiting for operator input. Parallel to [`/deliver --yes`](deliver.md). Composes with `--allow-over-budget` and with the risk-routed Phase-7 skip (it forces a proceed where those do not apply). Default (flag absent) behavior is unchanged: both gates still STOP for interactive use. |
 | `--steal` | Epic | Forcibly transfer a foreign Epic-lease. |
 | `--dry-run` | both | Author + validate without GitHub writes. |
 | `--body <path>` | Story | Pre-authored Story body file; validate (and create, unless `--dry-run`) without re-authoring. |
@@ -58,6 +59,71 @@ commands (story-sized Epic ↘ Story; epic-sized Story draft ↗ Epic) is now
 an **internal branch switch** inside this router: same skills, same
 helpers, no command hop and no operator re-entry.
 
+### Headless / non-interactive mode (`--yes`)
+
+`--yes` is the headless escape hatch for an unattended driver (CI, a
+benchmark harness, or any `claude -p` run with no human at the keyboard). It
+is the `/plan`-side parallel of [`/deliver --yes`](deliver.md), which
+suppresses that command's segment-plan confirmation. `/plan` has exactly
+**two** HITL STOP gates, and `--yes` deterministically auto-proceeds **both**
+without waiting for operator input:
+
+1. **Gate #1 — the ideation one-pager / scope-triage / clarity confirm.**
+   This single conceptual gate has three faces depending on the entry form,
+   and `--yes` auto-proceeds **all three**:
+   - On the `--idea` Epic path,
+     [`helpers/plan-epic.md`](helpers/plan-epic.md) Phase 1 (folding in the
+     Phase 1.5 scope-triage verdict) STOPs to confirm the sharpened one-pager.
+   - On the `--idea` Story path,
+     [`helpers/plan-story.md`](helpers/plan-story.md) Phase 2 STOPs to
+     confirm the drafted Story body.
+   - On the existing-Epic (`/plan <epicId>`) path, the Phase 6 Epic Clarity
+     Gate's **needs-refinement** branch STOPs to confirm the refined-body
+     diff before persisting it.
+
+   Under `--yes` each auto-proceeds: the one-pager / draft / refined-body
+   confirm resolves as **approved**, and a `story` / `borderline` triage
+   verdict resolves to its **recommended** branch (the one the gate prose
+   marks "Recommended") rather than prompting the three-way choice. The
+   verdict / clarity scoring is still recorded in chat (one line); only the
+   *wait* is suppressed. The clarity-gate *scoring* itself (deterministic
+   section-presence in Phase 6 step 1) still runs — `--yes` suppresses only
+   the operator confirm of the proposed refinement.
+2. **Gate #2 — the Phase-7 Epic operator review gate.** When risk routing
+   forces a review (`planningRisk.requiresReview === true`, or the operator
+   also passed `--force-review`),
+   [`helpers/plan-epic.md`](helpers/plan-epic.md) Phase 7 STOPs for operator
+   approval of the PRD / Tech Spec / Acceptance Spec before decomposition.
+   Under `--yes` this review auto-proceeds straight to Phase 8 — the three
+   context tickets stay **open** through delivery exactly as on the low-risk
+   auto-proceed path.
+
+**Composition.** `--yes` is orthogonal to the other planning flags and
+composes cleanly:
+
+- With **`--allow-over-budget`**: `--yes` suppresses the gate *waits* while
+  `--allow-over-budget` still governs the `maxTickets` over-budget persist —
+  passing `--yes` alone does **not** waive the budget gate.
+- With the **risk-routed Phase-7 skip**: when risk routing already skips the
+  Phase-7 review (low-risk, no `--force-review`), `--yes` is a no-op for that
+  gate — it only *forces a proceed where the gate would otherwise STOP*, it
+  never *adds* a stop or relaxes any non-HITL validator.
+
+**`--yes` suppresses only the HITL operator *waits* above.** It does **not**
+relax any deterministic gate — the Phase 6 Epic Clarity Gate **scoring**
+(section-presence), the Phase 7.5 Tech Spec Section Gate, the file-assumption
+/ DAG validators, the Phase 10 readiness healthcheck, and the `agent::blocked`
+runtime pause all behave exactly as without the flag. A `--yes` run that hits
+one of those still fails closed; the flag is an operator-input suppressor, not
+a validation override. The other operator-input *waits* in the pipeline also
+auto-proceed under `--yes` — the non-blocking Phase 2 duplicate-search pause
+(distinct-Epic confirmed), the Phase 6 clarity refinement-diff confirm
+(refined body approved), and the advisory Phase 8.3/8.4/8.5
+consolidation/critic diffs (consolidated/critic output applied) — since they
+are operator-input waits, not validators. The two *named* HITL STOP gates the
+Story tracks (gate #1, gate #2) are the load-bearing pair; these additional
+waits are auto-proceeded for the same headless reason.
+
 ## First-run preflight
 
 Before routing to a path helper, run a **first-run preflight** to catch
@@ -109,9 +175,11 @@ stubbed docs, or an unready doctor verdict).
    [`core/scope-triage`](../skills/core/scope-triage/SKILL.md) skill on the
    seed. Record the verdict in chat (one line).
 4. **Delegate.** Read the selected path helper **in full** and execute it
-   from its entry phase, forwarding the absorbed flags. The helper's phase
-   numbering, HITL gates, and scripts are unchanged — this router adds no
-   phase content.
+   from its entry phase, forwarding the absorbed flags (including `--yes`).
+   The helper's phase numbering, HITL gates, and scripts are unchanged — this
+   router adds no phase content. When `--yes` is present, the two HITL STOP
+   gates auto-proceed per [Headless / non-interactive mode](#headless--non-interactive-mode---yes)
+   above; every deterministic gate still runs.
 5. **Internal returns.** When a path helper would historically have handed
    off to the other planning command, switch helpers in-place and continue;
    surface the switch to the operator as a one-line note.

package/docs/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.73.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.72.0...mandrel-v1.73.0) (2026-06-17)
+
+
+### Added
+
+* generate GitHub issue forms from the Story/Epic body SSOT (human↔agent ticket consistency) ([#4227](https://github.com/dsj1984/mandrel/issues/4227)) ([#4233](https://github.com/dsj1984/mandrel/issues/4233)) ([d42b0cb](https://github.com/dsj1984/mandrel/commit/d42b0cb6122f46d8528d4bbb3793f27be2854bc1))
+* **plan:** robust tech-stack hydrator resolution (refs [#4228](https://github.com/dsj1984/mandrel/issues/4228)) ([#4230](https://github.com/dsj1984/mandrel/issues/4230)) ([4f1ad3c](https://github.com/dsj1984/mandrel/commit/4f1ad3c13b9a50f4e436d63282c7f6c2f461ab0e))
+
+## [1.72.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.71.0...mandrel-v1.72.0) (2026-06-17)
+
+
+### Added
+
+* **plan:** add a headless/non-interactive flag to suppress the ideation one-pager + Phase-7 review gate ([#4223](https://github.com/dsj1984/mandrel/issues/4223)) ([#4226](https://github.com/dsj1984/mandrel/issues/4226)) ([9ffa355](https://github.com/dsj1984/mandrel/commit/9ffa35543f897199c096ad45a568de39b0424ba7))
+
+
+### Fixed
+
+* **deliver:** fail open on unparseable code-review severity bullets in auto-merge gate (refs [#4222](https://github.com/dsj1984/mandrel/issues/4222)) ([#4224](https://github.com/dsj1984/mandrel/issues/4224)) ([ca949bd](https://github.com/dsj1984/mandrel/commit/ca949bd7d98eea440571db6636f8be2f2128c3b9))
+
 ## [1.71.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.70.0...mandrel-v1.71.0) (2026-06-16)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mandrel",
-  "version": "1.71.0",
+  "version": "1.73.0",
   "description": "Claude Code-first opinionated workflow framework: instructions, personas, skills, and SDLC workflows that govern AI coding assistants.",
   "files": [
     ".agents/",