mandrel 1.75.0 → 1.76.0

package/.agents/scripts/lib/orchestration/epic-plan-lease-guard.js

@@ -341,11 +341,20 @@ export async function assertNoOpenPlanChildren({
   const openChildren = (children ?? []).filter((t) => {
     const labels = Array.isArray(t.labels) ? t.labels : [];
     const isOpen = t.state === undefined || t.state === 'open';
-    // Any open typed plan ticket counts — `type::story` plus pre-v4
-    // `type::feature` leftovers. The prefix check is legacy-data
-    // detection, not compat support: the guard only refuses, it never
-    // processes the legacy tier. Context tickets (`context::*`) are
-    // untouched.
+    // Context spec tickets (PRD / Tech Spec / Acceptance Spec) carry a
+    // `context::*` label and — since the `createTicket` factory injects
+    // `type::story` by default — also `type::story`. They are reference
+    // artifacts that stay open across delivery, NOT plan children, so they
+    // MUST be excluded here: counting them would make every first decompose
+    // (where the three context tickets are the only open children) refuse.
+    const isContext = labels.some(
+      (l) => typeof l === 'string' && l.startsWith('context::'),
+    );
+    if (isContext) return false;
+    // Any remaining open typed plan ticket counts — `type::story` plus pre-v4
+    // `type::feature` leftovers. The prefix check is legacy-data detection,
+    // not compat support: the guard only refuses, it never processes the
+    // legacy tier.
     return (
       isOpen &&
       labels.some((l) => typeof l === 'string' && l.startsWith('type::'))

package/.agents/scripts/lib/orchestration/epic-runner/phases/build-wave-dag.js

@@ -35,6 +35,17 @@ export async function discoverOpenStories({ epicId, provider }) {
   for (const t of descendants) {
     const labels = t.labels ?? [];
     if (!labels.includes(TYPE_LABELS.STORY)) continue;
+    // Defense-in-depth: never enumerate a context spec ticket (PRD / Tech
+    // Spec / Acceptance Spec) as a deliverable Story even if it carries
+    // `type::story`. The `createTicket` factory no longer stamps context
+    // tickets that way, but a context ticket mislabelled out-of-band must
+    // still never reach a delivery wave (it has no `story-<id>` branch or
+    // acceptance contract to deliver against).
+    if (
+      labels.some((l) => typeof l === 'string' && l.startsWith('context::'))
+    ) {
+      continue;
+    }
     const rawState = t.state ?? 'open';
     const norm = typeof rawState === 'string' ? rawState.toLowerCase() : 'open';
     if (norm !== 'open') continue;

package/.agents/scripts/providers/github/tickets.js

@@ -320,13 +320,26 @@ export class TicketGateway {
     });
 
     // Mirror the Epic create path (issues.js:160 → `labels: TYPE_LABELS.EPIC`):
-    // always inject TYPE_LABELS.STORY so a spec that omits the labels array
-    // cannot produce an unlabeled, undispatchable Story. Dedupe to avoid
-    // duplicates when the caller already carries the label.
+    // inject TYPE_LABELS.STORY so a spec that omits the labels array cannot
+    // produce an unlabeled, undispatchable Story. Dedupe to avoid duplicates
+    // when the caller already carries the label.
+    //
+    // Context spec tickets (PRD / Tech Spec / Acceptance Spec) are a distinct
+    // ticket class created through this same factory carrying a `context::*`
+    // label (and no `type::story`). They MUST NOT be stamped `type::story`:
+    // doing so makes every `type::story`-counting consumer — the decompose
+    // open-children guard (`assertNoOpenPlanChildren`), the delivery wave
+    // builder (`discoverOpenStories`), the plan healthcheck — mis-classify
+    // them as deliverable Stories. Skip the injection when the caller's labels
+    // already classify the ticket as context.
     const callerLabels = ticketData.labels ?? [];
-    const labels = callerLabels.includes(TYPE_LABELS.STORY)
-      ? callerLabels
-      : [TYPE_LABELS.STORY, ...callerLabels];
+    const isContextTicket = callerLabels.some(
+      (l) => typeof l === 'string' && l.startsWith('context::'),
+    );
+    const labels =
+      isContextTicket || callerLabels.includes(TYPE_LABELS.STORY)
+        ? callerLabels
+        : [TYPE_LABELS.STORY, ...callerLabels];
     const result = await this._gh.api({
       method: 'POST',
       endpoint: `/repos/${this.owner}/${this.repo}/issues`,

package/docs/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.76.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.75.0...mandrel-v1.76.0) (2026-06-20)
+
+
+### Fixed
+
+* **plan:** stop stamping context spec tickets as type::story so first decompose isn't blocked ([#4246](https://github.com/dsj1984/mandrel/issues/4246)) ([#4247](https://github.com/dsj1984/mandrel/issues/4247)) ([564cfb8](https://github.com/dsj1984/mandrel/commit/564cfb81876f87ad5f61f3c670efb7cfc2c95540))
+
 ## [1.75.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.74.0...mandrel-v1.75.0) (2026-06-19)
 
 

package/package.json

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