@tablation/crew 0.43.3 → 0.44.0

package/dist/cli.js

@@ -1432,6 +1432,7 @@ var RELEASE_KEYS = /* @__PURE__ */ new Set([
   "ship",
   "ci",
   "verify",
+  "isolateFailures",
   "versioning",
   "versionFiles",
   "changelog",
@@ -1441,6 +1442,14 @@ var RELEASE_KEYS = /* @__PURE__ */ new Set([
 var VERSIONINGS = ["auto", "none"];
 var CI_KEYS = /* @__PURE__ */ new Set(["provider", "ref"]);
 var VERIFY_KEYS = /* @__PURE__ */ new Set(["match", "timeoutSeconds", "intervalSeconds"]);
+var ISOLATE_KEYS = /* @__PURE__ */ new Set(["maxCandidates"]);
+var DEFAULT_ISOLATE_MAX_CANDIDATES = 4;
+function parseIsolateMax(raw, where, fail) {
+  if (raw === void 0 || raw === null) return void 0;
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n < 0) throw fail(`${where}.maxCandidates must be a non-negative integer (got "${raw}")`);
+  return n;
+}
 var MATCHES = ["commit", "version"];
 var MODES = ["local", "integrate", "ci_manual", "ci_auto", "external"];
 var PROVIDERS = ["github", "buildkite", "other", "none"];
@@ -1474,6 +1483,7 @@ function parseRepoConfig(text, file) {
   rejectUnknown(raw.release, RELEASE_KEYS, "release", file);
   rejectUnknown(raw.release?.ci, CI_KEYS, "release.ci", file);
   rejectUnknown(raw.release?.verify, VERIFY_KEYS, "release.verify", file);
+  rejectUnknown(raw.release?.isolateFailures, ISOLATE_KEYS, "release.isolateFailures", file);
   rejectUnknown(raw.branch, BRANCH_KEYS, "branch", file);
   rejectUnknown(raw.worktrees, /* @__PURE__ */ new Set(["copy", "prefix", "name"]), "worktrees", file);
   rejectUnknown(raw.docs, /* @__PURE__ */ new Set(["triagePolicy", "designGuide"]), "docs", file);
@@ -1611,6 +1621,11 @@ function parseRepoConfig(text, file) {
       `${file}: release.verify.intervalSeconds (${verify.intervalSeconds}) exceeds timeoutSeconds (${verify.timeoutSeconds}) \u2014 it would never be asked twice`
     );
   }
+  const isolateMax = parseIsolateMax(
+    raw.release?.isolateFailures?.maxCandidates,
+    "release.isolateFailures",
+    (m) => new RepoConfigError(`${file}: ${m}`)
+  );
   const versioning = String(raw.release?.versioning ?? "auto");
   if (!VERSIONINGS.includes(versioning)) {
     throw new RepoConfigError(`${file}: release.versioning must be auto|none (got "${versioning}")`);
@@ -1664,6 +1679,7 @@ function parseRepoConfig(text, file) {
       ship,
       ci: { provider, ref: raw.release?.ci?.ref ? String(raw.release.ci.ref) : void 0 },
       verify,
+      isolateFailures: isolateMax === void 0 ? void 0 : { maxCandidates: isolateMax },
       versioning,
       versionFiles,
       tag,
@@ -1848,6 +1864,14 @@ function resolveRepoConfig(repo, ship, dir) {
           DEFAULTS.intervalSeconds
         )
       },
+      isolateFailures: {
+        maxCandidates: pick(
+          "release.isolateFailures.maxCandidates",
+          repo?.release.isolateFailures?.maxCandidates,
+          ship?.release?.isolateFailures?.maxCandidates,
+          DEFAULT_ISOLATE_MAX_CANDIDATES
+        )
+      },
       versioning: pick(
         "release.versioning",
         repo?.release.versioning === "auto" ? void 0 : repo?.release.versioning,
@@ -1999,6 +2023,7 @@ var RELEASE_OVERRIDE_KEYS = /* @__PURE__ */ new Set([
   "mode",
   "ci",
   "verify",
+  "isolateFailures",
   "versioning",
   "versionFiles",
   "versionFile",
@@ -2008,6 +2033,7 @@ var RELEASE_OVERRIDE_KEYS = /* @__PURE__ */ new Set([
 ]);
 var CI_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["provider", "ref"]);
 var VERIFY_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["match", "timeoutSeconds", "intervalSeconds"]);
+var ISOLATE_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["maxCandidates"]);
 function rejectUnknownKeys(obj, allowed, where, file) {
   if (!obj || typeof obj !== "object") return;
   const unknown = Object.keys(obj).filter((k) => !allowed.has(k));
@@ -2022,6 +2048,7 @@ function parseReleaseOverride(raw, where, file) {
   rejectUnknownKeys(raw, RELEASE_OVERRIDE_KEYS, `${where}.release`, file);
   if (raw.ci !== void 0) rejectUnknownKeys(raw.ci, CI_OVERRIDE_KEYS, `${where}.release.ci`, file);
   if (raw.verify !== void 0) rejectUnknownKeys(raw.verify, VERIFY_OVERRIDE_KEYS, `${where}.release.verify`, file);
+  if (raw.isolateFailures !== void 0) rejectUnknownKeys(raw.isolateFailures, ISOLATE_OVERRIDE_KEYS, `${where}.release.isolateFailures`, file);
   const mode = raw.mode === void 0 ? void 0 : String(raw.mode);
   if (mode !== void 0 && !MODES.includes(mode)) {
     throw new ConfigError(`${file}: ${where}.release.mode must be one of ${MODES.join("|")} (got "${raw.mode}")`);
@@ -2050,11 +2077,17 @@ function parseReleaseOverride(raw, where, file) {
   };
   const timeoutSeconds = num(raw.verify?.timeoutSeconds, "timeoutSeconds");
   const intervalSeconds = num(raw.verify?.intervalSeconds, "intervalSeconds");
+  const isolateMax = parseIsolateMax(
+    raw.isolateFailures?.maxCandidates,
+    `${where}.release.isolateFailures`,
+    (m) => new ConfigError(`${file}: ${m}`)
+  );
   const versionFiles = Array.isArray(raw.versionFiles) ? raw.versionFiles : raw.versionFile ? [String(raw.versionFile)] : void 0;
   return {
     mode,
     ci: provider !== void 0 || raw.ci?.ref !== void 0 ? { provider, ref: raw.ci?.ref !== void 0 ? String(raw.ci.ref) : void 0 } : void 0,
     verify: match !== void 0 || timeoutSeconds !== void 0 || intervalSeconds !== void 0 ? { match, timeoutSeconds, intervalSeconds } : void 0,
+    ...isolateMax === void 0 ? {} : { isolateFailures: { maxCandidates: isolateMax } },
     versioning,
     versionFiles,
     changelog: raw.changelog !== void 0 ? String(raw.changelog) : void 0,
@@ -2078,10 +2111,12 @@ function mergeRouteRelease(route, override) {
   const match = override?.verify?.match ?? route.verify?.match;
   const timeoutSeconds = override?.verify?.timeoutSeconds ?? route.verify?.timeoutSeconds;
   const intervalSeconds = override?.verify?.intervalSeconds ?? route.verify?.intervalSeconds;
+  const isolateMax = override?.isolateFailures?.maxCandidates ?? route.isolateFailures?.maxCandidates;
   return {
     mode: override?.mode ?? route.mode,
     ci: provider !== void 0 || ref !== void 0 ? { provider, ref } : void 0,
     verify: match !== void 0 || timeoutSeconds !== void 0 || intervalSeconds !== void 0 ? { match, timeoutSeconds, intervalSeconds } : void 0,
+    ...isolateMax === void 0 ? {} : { isolateFailures: { maxCandidates: isolateMax } },
     versioning: override?.versioning ?? route.versioning,
     versionFiles: override?.versionFiles ?? route.versionFiles,
     changelog: override?.changelog ?? route.changelog,
@@ -6675,6 +6710,82 @@ async function applyConflictBounce(writer, b, contract, memberId, log, dryRun) {
   }
 }
 
+// src/build-failure.ts
+import { StaleWriteError as StaleWriteError6 } from "@tablation/client";
+var BUILD_FAILURE_MARKER = "<!-- crew:build-failure -->";
+function failingPaths(output, cwd) {
+  const found = /* @__PURE__ */ new Set();
+  const ext = String.raw`[\w.-]+\.[A-Za-z]{1,6}`;
+  const dir = String.raw`(?:[\w@.~-]+/)*`;
+  const patterns = [
+    new RegExp(String.raw`^\s*(${dir}${ext})\(\d+,\d+\)\s*:`, "gm"),
+    new RegExp(String.raw`(?:^|\s)(/?${dir}${ext}):\d+(?::\d+)?`, "gm"),
+    new RegExp(String.raw`(?:FAIL|✖|✕|not ok \d+ -)\s+(/?${dir}${ext})`, "gm")
+  ];
+  const root = cwd.endsWith("/") ? cwd : `${cwd}/`;
+  for (const re of patterns) {
+    for (const m of output.matchAll(re)) {
+      let p = m[1];
+      if (p.startsWith("/")) {
+        if (!p.startsWith(root)) continue;
+        p = p.slice(root.length);
+      }
+      p = p.replace(/^\.\//, "");
+      if (p.includes("node_modules/")) continue;
+      found.add(p);
+    }
+  }
+  return [...found];
+}
+function culpritByFiles(candidates, paths) {
+  if (paths.length === 0) return null;
+  const hits = candidates.filter((c) => paths.some((p) => c.changed.has(p)));
+  return hits.length === 1 ? hits[0] : null;
+}
+function planBuildFailureBounce(cwd, c, base, remote) {
+  return { ...c, base, remote, worktree: worktreeForBranch(cwd, c.branch) };
+}
+function buildFailureComment(b) {
+  const how = b.how === "files" ? `The failing output names files that only \`${b.branch}\` changed among the branches in that release.` : `Built alone on the previous \`${b.base}\`, \`${b.branch}\` fails the same hook.`;
+  return `${BUILD_FAILURE_MARKER}
+**Back with the dev lane \u2014 this branch builds on its own but not on current \`${b.base}\`.**
+
+\`${b.branch}\` was verified, but the release's \`${b.hook}\` hook failed once it was merged with the other branches in the same release. ${how}
+
+First step: \`git merge ${b.remote}/${b.base}\` in ${b.worktree ? `\`${b.worktree}\`` : "the branch's worktree"}, rebuild, and fix what disagrees \u2014 the merge is clean at the text level, so this is a semantic conflict (a duplicate identifier, a changed signature) with work that landed on \`${b.base}\` after this branch was cut. Push as a plain fast-forward and hand back to QA as usual.
+
+\`\`\`
+${b.tail.trimEnd()}
+\`\`\`
+
+Nothing was written to \`${b.base}\` for this ticket; the rest of the release shipped without it.`;
+}
+async function applyBuildFailureBounce(writer, b, contract, memberId, log, dryRun) {
+  const t = { ticket: b.ticket.issue_id, step: "release" };
+  if (dryRun) {
+    log.emit(`would hand ${b.ticket.issue_id} back to ${contract.statuses.building} \u2014 its branch breaks the ${b.hook} hook`, t);
+    return { kind: "handed-back" };
+  }
+  try {
+    await writer.updateTicket(
+      b.ticket.id,
+      { status: contract.statuses.building, assignee_id: null },
+      b.ticket.updated_at
+    );
+    await writer.postEvent(b.ticket.id, buildFailureComment(b), memberId).catch(() => {
+      log.warn("handed back, but the note failed to post", t);
+    });
+    log.emit(`handed back to ${contract.statuses.building} \u2014 breaks the ${b.hook} hook once merged with the rest`, t);
+    return { kind: "handed-back" };
+  } catch (e) {
+    if (e instanceof StaleWriteError6) {
+      log.emit(`${b.ticket.issue_id} changed on the board since this run read it \u2014 not handing it back over it`, t);
+      return { kind: "stale" };
+    }
+    return { kind: "failed", why: e.message };
+  }
+}
+
 // src/stranded-verified.ts
 var STRANDED_MARKER = "<!-- crew:stranded-verified -->";
 var STRANDED_ESCALATE_AFTER_MS = 30 * 60 * 1e3;
@@ -7196,12 +7307,12 @@ function expandSkillMarkers(text, lookup, opts = {}) {
 import { readFileSync as readFileSync10, readdirSync as readdirSync3, existsSync as existsSync11 } from "fs";
 import { join as join12 } from "path";
 import { parse as parseYaml } from "yaml";
-import { TablationClient as TablationClient3, StaleWriteError as StaleWriteError7, TablationApiError as TablationApiError2 } from "@tablation/client";
+import { TablationClient as TablationClient3, StaleWriteError as StaleWriteError8, TablationApiError as TablationApiError2 } from "@tablation/client";
 
 // src/agents.ts
 import { readFileSync as readFileSync9, existsSync as existsSync10 } from "fs";
 import { join as join11 } from "path";
-import { TablationClient as TablationClient2, StaleWriteError as StaleWriteError6, TablationApiError } from "@tablation/client";
+import { TablationClient as TablationClient2, StaleWriteError as StaleWriteError7, TablationApiError } from "@tablation/client";
 var PERSONA_NAME = {
   dev: "Developer",
   design: "Design",
@@ -7380,7 +7491,7 @@ async function syncPersonas(route, opts) {
         try {
           anchoredAt = (await client2.records.update(agentsModel.id, row.id, promptSourceFields(agentsModel, defaultPrompt), row.updated_at)).updated_at;
         } catch (e) {
-          if (!(e instanceof StaleWriteError6) && !isPromptGateRejection(e)) throw e;
+          if (!(e instanceof StaleWriteError7) && !isPromptGateRejection(e)) throw e;
         }
       }
       const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
@@ -7452,7 +7563,7 @@ async function syncPersonas(route, opts) {
       agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: updated.updated_at, ...historyId ? { historyId } : {} };
       outcomes.push({ role, action: "updated", agentId: row.id });
     } catch (e) {
-      if (e instanceof StaleWriteError6) {
+      if (e instanceof StaleWriteError7) {
         outcomes.push({ role, action: "diverged", agentId: row.id });
         continue;
       }
@@ -7636,7 +7747,7 @@ async function syncSkills(route, opts) {
             row.updated_at
           )).updated_at;
         } catch (e) {
-          if (!(e instanceof StaleWriteError7) && !isPromptGateRejection(e)) throw e;
+          if (!(e instanceof StaleWriteError8) && !isPromptGateRejection(e)) throw e;
         }
       }
       agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: anchoredAt };
@@ -7692,7 +7803,7 @@ async function syncSkills(route, opts) {
       agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: updated.updated_at };
       outcomes.push({ name: skill.name, action: "updated", skillId: row.id });
     } catch (e) {
-      if (e instanceof StaleWriteError7) {
+      if (e instanceof StaleWriteError8) {
         outcomes.push({ name: skill.name, action: "diverged", skillId: row.id });
         continue;
       }
@@ -9474,8 +9585,62 @@ async function runRelease(o) {
     }
   }
 }
-async function mergeAndRelease(o, decision, fresh, releaseBranch) {
+var isolateCap = (o) => o.repo.release.isolateFailures?.maxCandidates ?? DEFAULT_ISOLATE_MAX_CANDIDATES;
+async function isolateAndRetry(o, name, output, merged, preMerge, decision, fresh, releaseBranch) {
+  const applied = merged.filter((c) => c.sha && c.branch);
+  const cap = isolateCap(o);
+  if (o.dryRun || !preMerge || applied.length < 2 || cap === 0) return null;
+  const head = headSha(o.cwd);
+  const withFiles = applied.map((c) => ({
+    c,
+    changed: new Set(
+      (gitOk(o.cwd, ["diff", "--name-only", `${preMerge}...${c.branch}`]) ?? "").split("\n").filter(Boolean)
+    )
+  }));
+  const culprits = [];
+  const byFile = culpritByFiles(withFiles, failingPaths(output, o.cwd));
+  if (byFile) {
+    o.emit.warn(`${name} failed; its output names files only ${byFile.c.branch} changed \u2014 treating it as the culprit`, { ticket: byFile.c.ticket.issue_id });
+    culprits.push({ c: byFile.c, how: "files", tail: lastLines(output, HOOK_FAILURE_TAIL_LINES) });
+  } else if (applied.length > cap) {
+    o.emit.warn(`${name} failed with ${applied.length} branches merged, over release.isolateFailures.maxCandidates (${cap}) \u2014 not isolating`);
+    return null;
+  } else {
+    o.emit.warn(`${name} failed with ${applied.length} branches merged \u2014 building each alone to find the culprit`);
+    for (const c of applied) {
+      gitOk(o.cwd, ["reset", "--hard", preMerge]);
+      const m = mergeOne(o, c);
+      if (typeof m === "object" && "conflict" in m) continue;
+      const r = await hook(o, name);
+      if (r && r.code !== 0) {
+        o.emit.warn(`${c.branch} fails the ${name} hook on its own`, { ticket: c.ticket.issue_id });
+        culprits.push({ c, how: "solo", tail: lastLines(r.output, HOOK_FAILURE_TAIL_LINES) });
+      }
+    }
+  }
+  gitOk(o.cwd, ["reset", "--hard", preMerge]);
+  if (culprits.length === 0) {
+    o.emit.warn("no single branch could be blamed \u2014 failing the release as a whole");
+    gitOk(o.cwd, ["reset", "--hard", head]);
+    return null;
+  }
+  const out = new Set(culprits.map((x) => x.c.ticket.id));
+  const rest = decision.merges.filter((c) => !out.has(c.ticket.id));
+  const retried = await mergeAndRelease(o, { ...decision, merges: rest }, fresh, releaseBranch, true);
+  return {
+    ...retried,
+    buildCulprits: culprits.map((x) => ({
+      ticket: x.c.ticket,
+      branch: x.c.branch,
+      hook: name,
+      tail: x.tail,
+      how: x.how
+    }))
+  };
+}
+async function mergeAndRelease(o, decision, fresh, releaseBranch, isolated = false) {
   o.emit.enter("merge");
+  const preMerge = o.dryRun ? "" : headSha(o.cwd);
   const merged = [];
   const conflicts = [];
   const unbuildable = [];
@@ -9590,6 +9755,10 @@ async function mergeAndRelease(o, decision, fresh, releaseBranch) {
         o.emit.warn("test gate failed with what looks like a worker crash, not a real failure \u2014 retrying once");
         r = await hook(o, "test");
       }
+      if (r && r.code !== 0 && !isolated) {
+        const out = await isolateAndRetry(o, "test", r.output, merged, preMerge, decision, fresh, releaseBranch);
+        if (out) return out;
+      }
       if (r && r.code !== 0) {
         o.emit.error(`test gate FAILED \u2014 not deploying; the target stays on the previous release`);
         const sha = headSha(o.cwd);
@@ -9619,13 +9788,23 @@ async function mergeAndRelease(o, decision, fresh, releaseBranch) {
     }
   }
   if (o.repo.hooks.build) {
-    if (o.dryRun) o.emit.emit(`would run: ${hookLabel(o.repo, "build")}`);
-    else {
+    if (o.dryRun) {
+      o.emit.emit(`would run: ${hookLabel(o.repo, "build")}`);
+      if (applied > 1) {
+        o.emit.emit(
+          `if it fails, would find the one of ${applied} merged branches that broke it (by the files it names, else by building each alone, up to ${isolateCap(o)}), hand that back to the dev lane and ship the rest`
+        );
+      }
+    } else {
       let r = await hook(o, "build");
       if (r && r.code !== 0 && looksLikeTransientResolveFailure(r.output)) {
         o.emit.warn("build failed with what looks like a transient dependency-resolution glitch, not a real failure \u2014 retrying once");
         r = await hook(o, "build");
       }
+      if (r && r.code !== 0 && !isolated) {
+        const out = await isolateAndRetry(o, "build", r.output, merged, preMerge, decision, fresh, releaseBranch);
+        if (out) return out;
+      }
       if (r && r.code !== 0) {
         o.emit.error("build failed \u2014 not deploying");
         if (version && !o.dryRun && headSha(o.cwd) !== preBump) {
@@ -9824,7 +10003,7 @@ function formatProjectsReport(report) {
 }
 
 // src/cli.ts
-import { StaleWriteError as StaleWriteError8 } from "@tablation/client";
+import { StaleWriteError as StaleWriteError9 } from "@tablation/client";
 
 // src/release-ship.ts
 var DAY_MS = 24 * 60 * 60 * 1e3;
@@ -12963,6 +13142,20 @@ ${changed2.map((c) => `  - ${c}
           });
         }
       }
+      if (outcome.buildCulprits?.length) {
+        const seat = releaseSeat(c);
+        for (const cu of outcome.buildCulprits) {
+          try {
+            const bounce = planBuildFailureBounce(target.dir, cu, repo.branch.base, repo.branch.remote);
+            const r = await applyBuildFailureBounce(tracker, bounce, tracker.contract, seat, remit, dryRun);
+            if (r.kind === "failed") {
+              remit.warn(`could not hand back ${cu.ticket.issue_id}: ${r.why}`, { step: "release" });
+            }
+          } catch (e) {
+            remit.warn(`could not hand back ${cu.ticket.issue_id}: ${e.message}`, { step: "release" });
+          }
+        }
+      }
       if (outcome.conflicts?.length || outcome.unbuildable?.length) {
         const comments = await tracker.comments();
         const seat = releaseSeat(c);
@@ -14658,7 +14851,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         await tracker3.updateTicket(ticket.id, { [c.columns.assignee]: null }, ticket.updated_at);
         emit.emit(`cleared assignee on ${label} \u2014 back up for grabs next cycle`);
       } catch (e) {
-        if (e instanceof StaleWriteError8) {
+        if (e instanceof StaleWriteError9) {
           process.stderr.write(`unassign: ${label} changed on the board since it was read \u2014 re-run to retry
 `);
           process.exit(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.43.3",
+  "version": "0.44.0",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",

package/prompts/default/personas/lane-qa.md

@@ -161,6 +161,11 @@ pass.
   base, the bounce says to merge `<remote>/<base>` into the branch, resolve and
   push fast-forward; a rebase would need a force push the builder cannot make.
   Or pass the ticket and let the release's conflict path do the merge.
+- **A branch that came back from a conflict or build-failure bounce is
+  re-verified against the current base, not only its own tip.** Before
+  passing it, merge current `<remote>/<base>` into the worktree (or run the
+  build on a throwaway merge) and run the build: a clean text merge can still
+  fail to compile, and it is far cheaper to find that here than at release.
 - **You only ever enter the worktree of the ticket you are verifying.**
 - Throwaway verification scripts go in a scratch directory outside the
   repository — not the worktree root either.

package/prompts/default/skills/grill-me.md

@@ -116,6 +116,10 @@ Map go active now, or stay a draft?**
      - Any `draft` Issue tied to this Epic that this session's ticket
        set does NOT include (i.e. dropped by this revision) → flip to
        `status: closed_obsolete`.
+  5. Set the Epic itself to `status: planned` (Epics table) if it is
+     still `new`. An active Map is the planning decision for the Epic;
+     leave an Epic that has already moved on (`in_progress`, `done`,
+     `cancelled`) alone.
 
 Do all of this yourself via direct MCP writes. There is no automation
 watching for this — if you don't do it, it doesn't happen.

package/prompts/dev-qa/personas/lane-qa.md

@@ -160,6 +160,11 @@ pass.
   base, the bounce says to merge `<remote>/<base>` into the branch, resolve and
   push fast-forward; a rebase would need a force push the builder cannot make.
   Or pass the ticket and let the release's conflict path do the merge.
+- **A branch that came back from a conflict or build-failure bounce is
+  re-verified against the current base, not only its own tip.** Before
+  passing it, merge current `<remote>/<base>` into the worktree (or run the
+  build on a throwaway merge) and run the build: a clean text merge can still
+  fail to compile, and it is far cheaper to find that here than at release.
 - **You only ever enter the worktree of the ticket you are verifying.**
 - Throwaway verification scripts go in a scratch directory outside the
   repository — not the worktree root either.

package/prompts/dev-qa/skills/grill-me.md

@@ -116,6 +116,10 @@ Map go active now, or stay a draft?**
      - Any `draft` Issue tied to this Epic that this session's ticket
        set does NOT include (i.e. dropped by this revision) → flip to
        `status: closed_obsolete`.
+  5. Set the Epic itself to `status: planned` (Epics table) if it is
+     still `new`. An active Map is the planning decision for the Epic;
+     leave an Epic that has already moved on (`in_progress`, `done`,
+     `cancelled`) alone.
 
 Do all of this yourself via direct MCP writes. There is no automation
 watching for this — if you don't do it, it doesn't happen.