mandrel 1.76.0 → 1.77.0

package/.agents/workflows/helpers/epic-deliver-story.md

@@ -77,9 +77,22 @@ the parent's permissions but have **no input channel** mid-run.
 Run from the **main checkout** (the worktree does not exist yet):
 
 ```bash
-node .agents/scripts/story-init.js --story <storyId>
+node .agents/scripts/story-init.js --story <storyId> \
+  --prd <prdId> --tech-spec <techSpecId>
 ```
 
+**Thread the Epic linkages (Story #4253).** The parent `/deliver` resolved
+the Epic's `prdId` / `techSpecId` **once** in its Phase 1 prepare and passed
+them into your dispatch prompt. Forward them as `--prd` / `--tech-spec` so
+this `story-init.js` run **skips** the per-Story `getEpic` round-trip — the
+two ids are invariant for the whole delivery run, so re-fetching the
+immutable Epic per Story is pure waste (and secondary-rate-limit pressure
+during wide fan-out). **Omit** whichever flag the prompt reported as `null`;
+`story-init.js` then falls back to its own `getEpic` resolution for the
+missing id (graceful degradation on a missing Epic linkage). When dispatched
+interactively with neither flag, drop both — the legacy single-fetch path is
+unchanged.
+
 > **Execution mode (sub-agents must read).** This command typically takes
 > 3–6 minutes when the worktree's per-tree install runs. Invoke it
 > **synchronously** with the Bash tool's maximum timeout
@@ -139,11 +152,15 @@ the Story-level rollup the parent `/deliver` aggregator reads).
 Run a single Story-implementation phase against the inline `acceptance[]`
 / `verify[]` arrays on the Story body.
 
-1. Flip the snapshot to the `implementing` phase:
+1. Flip the snapshot to the `implementing` phase. Pass `--epic <epicId>`
+   and `--branch story-<storyId>` from the Step 0 envelope so the render
+   skips the `readEpicIdFromStory` / `resolveStoryBranch` GitHub reads
+   (pass these same flags to **every** `story-phase.js` call below):
 
    ```bash
    node .agents/scripts/story-phase.js \
-     --story <storyId> --phase implementing
+     --story <storyId> --epic <epicId> --branch story-<storyId> \
+     --phase implementing
    ```
 
 2. Read the Story body's inline `acceptance[]` and `verify[]` arrays
@@ -166,11 +183,14 @@ Run a single Story-implementation phase against the inline `acceptance[]`
    evidence** — they are no longer optional advisory pre-flight.
 
 5. Once the eval loop returns `proceed`, flip the snapshot to `closing`
-   and proceed to Step 3:
+   and proceed to Step 3 (Step 3 invokes close directly — it no longer
+   re-renders the `closing` snapshot, so this is the single `closing`
+   render):
 
    ```bash
    node .agents/scripts/story-phase.js \
-     --story <storyId> --phase closing
+     --story <storyId> --epic <epicId> --branch story-<storyId> \
+     --phase closing
    ```
 
 6. If blocked (including by the eval loop reaching its round cap with
@@ -180,7 +200,8 @@ Run a single Story-implementation phase against the inline `acceptance[]`
 
    ```bash
    node .agents/scripts/story-phase.js \
-     --story <storyId> --phase blocked
+     --story <storyId> --epic <epicId> --branch story-<storyId> \
+     --phase blocked
    ```
 
 ### Step 1a — Bounded acceptance self-eval loop (**required, not optional**)
@@ -195,6 +216,18 @@ The critic reads the Story's inline `acceptance[]` / `verify[]` arrays from the
 
 Epic-attached specifics for this path:
 
+- **Critic evidence-share** (Story #4250). When the critic runs a `verify[]`
+  command that is byte-identical to a close gate (`lint` / `typecheck`), it
+  records the pass into the Epic-keyed evidence keyspace via `--epic-id
+  <epicId>` so `story-close.js` short-circuits the gate at unchanged HEAD.
+  Run it in the **Story worktree** (`.worktrees/story-<storyId>`):
+
+  ```bash
+  node .agents/scripts/evidence-gate.js \
+    --epic-id <epicId> --scope-id <storyId> --gate lint \
+    --worktree .worktrees/story-<storyId> -- npm run lint
+  ```
+
 - **Gate invocation** (pass `--epic <epicId>` so the per-criterion signal lands
   on the Epic-scoped stream):
 
@@ -235,16 +268,18 @@ fine as advisory pre-flight.)
 
 ## Step 3 — Close (`story-close.js`)
 
-Flip the snapshot to the closing phase, then invoke close. Pass the
-main-checkout path via `--cwd` so the merge and branch deletion run
-against the main repo (branches checked out in a worktree cannot be
+Step 1 item 5 already flipped the snapshot to the `closing` phase, so this
+step does **not** re-render it (the duplicate render was removed). Invoke
+close directly. Pass the parent Epic id via `--epic <epicId>` from the
+Step 0 envelope so close skips re-parsing the Epic hierarchy off the
+Story body (which also closes the malformed-`Epic:`-line failure mode).
+Pass the main-checkout path via `--cwd` so the merge and branch deletion
+run against the main repo (branches checked out in a worktree cannot be
 deleted from themselves):
 
 ```bash
-node .agents/scripts/story-phase.js \
-  --story <storyId> --phase closing
-
-node <main-repo>/.agents/scripts/story-close.js --story <storyId> --cwd <main-repo>
+node <main-repo>/.agents/scripts/story-close.js \
+  --story <storyId> --epic <epicId> --cwd <main-repo>
 ```
 
 In single-tree mode, `--cwd` defaults to `PROJECT_ROOT`. The script merges
@@ -261,7 +296,8 @@ After close, upsert a terminal snapshot:
 
 ```bash
 node .agents/scripts/story-phase.js \
-  --story <storyId> --phase done
+  --story <storyId> --epic <epicId> --branch story-<storyId> \
+  --phase done
 ```
 
 ---

package/.agents/workflows/helpers/single-story-deliver.md

@@ -215,6 +215,18 @@ proceed / redraft / block decision) is the single-homed include
 
 Standalone specifics for this path:
 
+- **Critic evidence-share** (Story #4250). When the critic runs a `verify[]`
+  command that is byte-identical to a close gate (`lint` / `typecheck`), it
+  records the pass into the standalone evidence keyspace via `--standalone`
+  (no parent Epic to key on) so Step 3's close short-circuits the gate at
+  unchanged HEAD. Run it in the **Story worktree** (`workCwd` from Step 0):
+
+  ```bash
+  node <main-repo>/.agents/scripts/evidence-gate.js \
+    --standalone --scope-id <storyId> --gate lint \
+    --worktree <workCwd> -- npm run lint
+  ```
+
 - **Gate invocation** (omit `--epic` — there is no parent Epic):
 
   ```bash

package/docs/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.77.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.76.0...mandrel-v1.77.0) (2026-06-24)
+
+
+### Added
+
+* **close-validation:** unify evidence keyspace — critic verify[] sharing + standalone parity (refs [#4250](https://github.com/dsj1984/mandrel/issues/4250)) ([#4266](https://github.com/dsj1984/mandrel/issues/4266)) ([0555f3b](https://github.com/dsj1984/mandrel/commit/0555f3b0aaeabfb09c2ab02ed2bf7f5182a96c28))
+* **decompose-gates:** emit a deterministic soft missing-reason-to-exist finding + document reason_to_exist in the author SKILL (refs [#4273](https://github.com/dsj1984/mandrel/issues/4273)) ([#4280](https://github.com/dsj1984/mandrel/issues/4280)) ([98d3d5b](https://github.com/dsj1984/mandrel/commit/98d3d5b3d4ba8aa1c5485f5728e44bda09a6f3d3))
+* **decompose:** single-source the binding-vs-advisory authoring altitude + New-File Contract into the decomposer prompt (refs [#4272](https://github.com/dsj1984/mandrel/issues/4272)) ([#4279](https://github.com/dsj1984/mandrel/issues/4279)) ([3fc9adb](https://github.com/dsj1984/mandrel/commit/3fc9adb848226e4ef90463e31d5cbabb3f350c7f))
+* **deliver:** add --epic/--branch flags to story-phase.js and drop duplicate closing snapshot (refs [#4256](https://github.com/dsj1984/mandrel/issues/4256)) ([#4261](https://github.com/dsj1984/mandrel/issues/4261)) ([0f75eda](https://github.com/dsj1984/mandrel/commit/0f75eda48568d136803cd714ab0fd04bc341033d))
+* overhaul worktree install: copy-on-write node_modules + correct, PM-aware retry ([#4249](https://github.com/dsj1984/mandrel/issues/4249)) ([#4267](https://github.com/dsj1984/mandrel/issues/4267)) ([ce92a71](https://github.com/dsj1984/mandrel/commit/ce92a71b47a7851a04ce4d48ce6fa16c9ea41988))
+* persist Projects v2 board metadata to a disk cache ([#4252](https://github.com/dsj1984/mandrel/issues/4252)) ([#4263](https://github.com/dsj1984/mandrel/issues/4263)) ([277d9ec](https://github.com/dsj1984/mandrel/commit/277d9ecd8ac05fa291bb873a57966fc67d768205))
+* **story-body:** add optional advisory non_goals negative-scope section (refs [#4275](https://github.com/dsj1984/mandrel/issues/4275)) ([#4281](https://github.com/dsj1984/mandrel/issues/4281)) ([e118482](https://github.com/dsj1984/mandrel/commit/e118482aa5aa6ae2874c1da9d470d8c53b26bdf8))
+
+
+### Fixed
+
+* **decompose-gates:** parse string Story bodies in sizing/conflict gates (refs [#4271](https://github.com/dsj1984/mandrel/issues/4271)) ([#4277](https://github.com/dsj1984/mandrel/issues/4277)) ([6c804a4](https://github.com/dsj1984/mandrel/commit/6c804a4b6645f0742ba21ef145a5dc5a351b21bb))
+* rebuild the audit-to-stories Story body to the canonical inline-contract shape and gate it before issue creation ([#4270](https://github.com/dsj1984/mandrel/issues/4270)) ([#4278](https://github.com/dsj1984/mandrel/issues/4278)) ([058ff7b](https://github.com/dsj1984/mandrel/commit/058ff7b13ec799c11ed2ddf134adaf82c289168f))
+* **single-story-close:** release assignee-lease on recoverable-blocked exits (refs [#4257](https://github.com/dsj1984/mandrel/issues/4257)) ([#4268](https://github.com/dsj1984/mandrel/issues/4268)) ([108fa5f](https://github.com/dsj1984/mandrel/commit/108fa5f834121bf53c5cb59005415ea30b6e990f))
+* **story-body:** close section on unrecognized heading to stop content bleed (refs [#4274](https://github.com/dsj1984/mandrel/issues/4274)) ([#4276](https://github.com/dsj1984/mandrel/issues/4276)) ([808d508](https://github.com/dsj1984/mandrel/commit/808d5080fee460f24cae8ef43b2c8c1b442de1f3))
+
+
+### Performance
+
+* **coverage:** make run-coverage.js host-aware for --test-concurrency (refs [#4254](https://github.com/dsj1984/mandrel/issues/4254)) ([#4260](https://github.com/dsj1984/mandrel/issues/4260)) ([0078195](https://github.com/dsj1984/mandrel/commit/0078195afeee50fafefdaf4dea3d59b33b172cc6))
+* **deliver:** resolve Epic once and thread --prd/--tech-spec into story-init (refs [#4253](https://github.com/dsj1984/mandrel/issues/4253)) ([#4269](https://github.com/dsj1984/mandrel/issues/4269)) ([8dbc006](https://github.com/dsj1984/mandrel/commit/8dbc006882379ccdfb5dca90d8d8bca11c2dbb0e))
+* **story-init:** short-circuit childless 2-tier sub-issues + Search probe in buildTaskGraph (refs [#4251](https://github.com/dsj1984/mandrel/issues/4251)) ([#4265](https://github.com/dsj1984/mandrel/issues/4265)) ([7c8fcd2](https://github.com/dsj1984/mandrel/commit/7c8fcd21a9c781bd2e4592d7c8e7b4bf8476cd22))
+
+
+### Changed
+
+* **story-init:** single-home the duplicated branch-seed action switch (refs [#4255](https://github.com/dsj1984/mandrel/issues/4255)) ([#4264](https://github.com/dsj1984/mandrel/issues/4264)) ([7a6f2ec](https://github.com/dsj1984/mandrel/commit/7a6f2ec9c2e7ce0b680c620e9bb52541ec37db1b))
+
 ## [1.76.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.75.0...mandrel-v1.76.0) (2026-06-20)
 
 

package/package.json

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