@mutmutco/cli 3.98.0 → 3.100.0

package/dist/main.cjs

@@ -3417,7 +3417,7 @@ var program = new Command();
 // src/index.ts
 var import_promises11 = require("node:fs/promises");
 var import_node_fs40 = require("node:fs");
-var import_node_child_process18 = require("node:child_process");
+var import_node_child_process19 = require("node:child_process");
 
 // src/cli-shared.ts
 var import_node_child_process3 = require("node:child_process");
@@ -5779,6 +5779,7 @@ function buildGcPlan(inputs) {
   const preservedBranches2 = new Set(inputs.preservedBranches ?? []);
   const preservedWorktrees = new Set((inputs.worktrees ?? []).filter((w) => w.preserved).map((w) => w.branch));
   const mergedIntoBase = new Set((inputs.mergedIntoBase ?? []).map((b) => b.trim()).filter(Boolean));
+  const prLookupFailures = new Map((inputs.prLookupFailures ?? []).map((f) => [f.branch.trim(), f.detail]));
   const skipped = [];
   const branches = [];
   const skipTrackingBranches = /* @__PURE__ */ new Set();
@@ -5794,6 +5795,11 @@ function buildGcPlan(inputs) {
       skipped.push({ branch, reason: "protected" });
       continue;
     }
+    if (prLookupFailures.has(branch)) {
+      skipped.push({ branch, reason: "pr-lookup-failed", detail: prLookupFailures.get(branch) });
+      skipTrackingBranches.add(branch);
+      continue;
+    }
     const prSet = prs.get(branch);
     if (prSet?.some((pr2) => pr2.state === "OPEN")) {
       skipped.push({ branch, reason: "open-pr" });
@@ -5838,6 +5844,7 @@ function buildGcPlan(inputs) {
     const branch = branchForTrackingRef(ref, remote);
     if (!branch || protectedBranches.has(branch)) return null;
     if (branch === inputs.currentBranch || dirtyWorktrees.has(branch) || unpushedWorktrees.has(branch) || preservedBranches2.has(branch) || preservedWorktrees.has(branch) || skipTrackingBranches.has(branch)) return null;
+    if (prLookupFailures.has(branch)) return null;
     const prSet = prs.get(branch);
     if (prSet?.some((pr2) => pr2.state === "OPEN")) return null;
     const state = closedState(prSet);
@@ -13797,23 +13804,6 @@ async function fetchSchedulesList(deps) {
     return null;
   }
 }
-async function fetchDocsAuditList(deps) {
-  if (!deps.baseUrl) return { notArmed: true };
-  try {
-    const token = await deps.token();
-    if (!token) return { notArmed: true };
-    const res = await retriedFetch(deps, `${deps.baseUrl.replace(/\/$/, "")}/docs-audit/list`, {
-      method: "GET",
-      headers: { Authorization: `Bearer ${token}` }
-    });
-    if (res.status === 404) return { notArmed: true };
-    if (!res.ok) return { ok: false, error: `docs-audit list HTTP ${res.status}` };
-    const body = await res.json();
-    return { ok: true, rows: Array.isArray(body?.docsAudits) ? body.docsAudits : [] };
-  } catch (e) {
-    return { ok: false, error: e.message };
-  }
-}
 async function fetchOrgConfig(deps) {
   if (!deps.baseUrl) return null;
   const token = await deps.token();
@@ -13864,9 +13854,6 @@ async function retireProject(slug, deps) {
 async function setDeployCoords(slug, payload, deps) {
   return postJson(`/projects/${encodeURIComponent(slug)}/deploy`, payload, deps);
 }
-async function recordDocsAudit(verdict, deps) {
-  return postJson("/docs-audit/record", { ...verdict }, deps);
-}
 async function postSchedulesLift(repo, schedules, deps) {
   const res = await postJson("/schedules/lift", { repo, schedules }, deps);
   if (!res.ok && res.status === 404) return { ...res, unreachable: "route-absent" };
@@ -15587,13 +15574,27 @@ async function isOrgRegisteredRepo(cfg, deps = {}) {
   if (!read.ok) return false;
   return read.project !== null;
 }
-async function ghPrs(limit) {
-  const args = (state) => ["pr", "list", "--state", state, "--limit", String(limit), "--json", "number,headRefName,headRefOid,state"];
-  const [open2, closed] = await Promise.all([
-    execFileP2("gh", args("open"), { timeout: GC_GH_TIMEOUT_MS }),
-    execFileP2("gh", args("closed"), { timeout: GC_GH_TIMEOUT_MS })
-  ]);
-  return [...JSON.parse(open2.stdout || "[]"), ...JSON.parse(closed.stdout || "[]")];
+var GC_PR_LOOKUP_CONCURRENCY = 8;
+async function resolveBranchPrs(branches, limit) {
+  const queue = [...new Set(branches.map((b) => b.trim()).filter(Boolean))];
+  const prs = [];
+  const failures = [];
+  const args = (branch) => ["pr", "list", "--head", branch, "--state", "all", "--limit", String(limit), "--json", "number,headRefName,headRefOid,state"];
+  let next = 0;
+  const worker = async () => {
+    for (let i = next++; i < queue.length; i = next++) {
+      const branch = queue[i];
+      try {
+        const { stdout } = await execFileP2("gh", args(branch), { timeout: GC_GH_TIMEOUT_MS });
+        const rows = JSON.parse(stdout || "[]");
+        prs.push(...rows.filter((pr2) => pr2.headRefName?.trim() === branch));
+      } catch (e) {
+        failures.push({ branch, detail: e.message });
+      }
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(GC_PR_LOOKUP_CONCURRENCY, queue.length) }, worker));
+  return { prs, failures };
 }
 async function localBranchHeads() {
   try {
@@ -15737,21 +15738,26 @@ function resolveExplicitScanRoot(explicitRoot, repoRoot2) {
   return explicitRepoWorktreesRoot(explicitRoot, repoRoot2, rootDirs);
 }
 async function gcPlan(remote, limit, opts = {}) {
-  const [branches, heads, current, stale, prs, worktrees, siblingDirs, preserved, mergedIntoBase] = await Promise.all([
+  const [branches, heads, current, stale, worktrees, siblingDirs, preserved, mergedIntoBase] = await Promise.all([
     gitOut(["branch", "--format=%(refname:short)"]),
     localBranchHeads(),
     gitOut(["rev-parse", "--abbrev-ref", "HEAD"]),
     collectStaleTrackingRefs(remote, {
       execGit: (args) => execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })
     }),
-    ghPrs(limit),
     worktreeBranches(),
     siblingWorktreeDirs(opts.root),
     preservedBranches(),
     branchesMergedIntoBase(remote)
   ]);
+  const localBranches = branches.split(/\r?\n/).map((b) => b.trim()).filter(Boolean);
+  const { prs, failures } = await resolveBranchPrs(
+    [...localBranches, ...stale.map((ref) => branchForTrackingRef(ref, remote)).filter((b) => Boolean(b))].filter((b) => !isProtectedBranch(b)),
+    limit
+  );
   return buildGcPlan({
-    localBranches: branches.split(/\r?\n/).map((b) => b.trim()).filter(Boolean),
+    localBranches,
+    prLookupFailures: failures,
     localBranchHeads: heads,
     currentBranch: current,
     siblingWorktreeDirs: siblingDirs,
@@ -17853,8 +17859,6 @@ function consolidateCommandNamespaces(program3) {
   move(program3, plugin, "plugin-heal", "heal");
   move(program3, plugin, "plugin-prune", "prune");
   move(program3, plugin, "session-start");
-  const docs2 = child(program3, "docs");
-  move(program3, docs2, "docs-audit", "audit");
   const train = child(program3, "train");
   const fullTrack2 = child(program3, "full-track");
   move(fullTrack2, train, "readiness");
@@ -18156,6 +18160,22 @@ function healPiPluginRegistration(home, env, installedVersion) {
   }
 }
 
+// src/statusline-invalidate.ts
+var import_node_child_process10 = require("node:child_process");
+function invalidateStatuslineBoardCache() {
+  try {
+    const child2 = (0, import_node_child_process10.spawn)("jerv-cli", ["lane", "ops", "invalidate-board"], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true
+    });
+    child2.on("error", () => {
+    });
+    child2.unref();
+  } catch {
+  }
+}
+
 // src/skill-lesson.ts
 var SKILL_LESSON_LABEL = "skill-lesson";
 var SKILL_NAMES = ["bootstrap", "browser-automation", "doctor", "epic", "hotfix", "mmi", "onboard", "rcand", "release", "resume", "secrets", "stage", "worktree"];
@@ -18395,12 +18415,12 @@ function renderVerifyBroker(input) {
 }
 
 // src/hotfix-coverage.ts
-var import_node_child_process10 = require("node:child_process");
+var import_node_child_process11 = require("node:child_process");
 var CHERRY_TRAILER = /\(cherry picked from commit ([0-9a-f]{7,40})\)/g;
 function checkHotfixCoverage(options = {}) {
   const { cwd = process.cwd(), mainRef = "origin/main", rcRef = "origin/rc", manifestPaths = [] } = options;
   const ack = (options.ack ?? []).filter(Boolean);
-  const git2 = options.git ?? ((args, opts) => (0, import_node_child_process10.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
+  const git2 = options.git ?? ((args, opts) => (0, import_node_child_process11.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
   const revList = (range) => {
     const out = git2(["rev-list", "--no-merges", range]).trim();
     return out ? out.split("\n") : [];
@@ -18468,7 +18488,7 @@ function checkHotfixCoverage(options = {}) {
 }
 function checkHotfixCarries(options) {
   const { cwd = process.cwd(), branch, baseRef, targets } = options;
-  const git2 = options.git ?? ((args, opts) => (0, import_node_child_process10.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
+  const git2 = options.git ?? ((args, opts) => (0, import_node_child_process11.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
   const isAncestor = (sha, ref) => {
     try {
       git2(["merge-base", "--is-ancestor", sha, ref]);
@@ -19582,7 +19602,7 @@ function renderAccessReport(report) {
 
 // src/repo-index.ts
 var import_node_crypto4 = require("node:crypto");
-var import_node_child_process11 = require("node:child_process");
+var import_node_child_process12 = require("node:child_process");
 var import_node_fs23 = require("node:fs");
 var import_node_path21 = require("node:path");
 var REPO_INDEX_SCHEMA = 1;
@@ -19728,7 +19748,7 @@ function loadReadmeHints(cwd, candidatePaths) {
 function toPosix(p) {
   return p.split(import_node_path21.sep).join("/");
 }
-function listCandidatePaths(cwd, exec = import_node_child_process11.execFileSync) {
+function listCandidatePaths(cwd, exec = import_node_child_process12.execFileSync) {
   try {
     const out = exec("git", ["ls-files", "-z", "-c", "-o", "--exclude-standard"], {
       cwd,
@@ -19851,7 +19871,7 @@ function searchRepoIndex(idx, query, limit = 20) {
   }
   return out;
 }
-function inferRepoSlug(cwd, exec = import_node_child_process11.execFileSync) {
+function inferRepoSlug(cwd, exec = import_node_child_process12.execFileSync) {
   try {
     const url = String(exec("git", ["remote", "get-url", "origin"], { cwd, encoding: "utf8" })).trim();
     const m = /[:/]([^/]+\/[^/]+?)(?:\.git)?$/.exec(url);
@@ -20001,7 +20021,7 @@ async function gcRepoIndexCloud(deps) {
 var import_node_fs24 = require("node:fs");
 var import_node_os9 = require("node:os");
 var import_node_path22 = require("node:path");
-var import_node_child_process12 = require("node:child_process");
+var import_node_child_process13 = require("node:child_process");
 var MAX_EMBED_BACKFILL_ROUNDS = 40;
 function normalizeRepo(raw) {
   const t = raw.trim().replace(/\.git$/, "");
@@ -20021,7 +20041,7 @@ function rosterRepos(projects) {
 }
 function shallowClone(repo, dest, token) {
   const basic = Buffer.from(`x-access-token:${token}`, "utf8").toString("base64");
-  (0, import_node_child_process12.execFileSync)(
+  (0, import_node_child_process13.execFileSync)(
     "git",
     ["-c", `http.extraHeader=Authorization: Basic ${basic}`, "clone", "--depth", "1", "--single-branch", `https://github.com/${repo}.git`, dest],
     { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], windowsHide: true }
@@ -20288,7 +20308,7 @@ async function runRepoIndexHealth(opts) {
 }
 
 // src/spawn-policy-core.ts
-var import_node_child_process13 = require("node:child_process");
+var import_node_child_process14 = require("node:child_process");
 var import_node_fs26 = require("node:fs");
 var import_node_path23 = require("node:path");
 var SPAWNERS = ["spawn", "spawnSync", "exec", "execSync", "execFile", "execFileSync"];
@@ -20359,7 +20379,7 @@ function findViolationsInSource(raw) {
   return found;
 }
 function policedFiles(root) {
-  const r = (0, import_node_child_process13.spawnSync)("git", ["ls-files", "-z", "--cached", "--others", "--exclude-standard"], {
+  const r = (0, import_node_child_process14.spawnSync)("git", ["ls-files", "-z", "--cached", "--others", "--exclude-standard"], {
     cwd: root,
     encoding: "utf8",
     windowsHide: true,
@@ -20393,7 +20413,7 @@ function runSpawnPolicy(root) {
 }
 
 // src/test-policy-core.ts
-var import_node_child_process14 = require("node:child_process");
+var import_node_child_process15 = require("node:child_process");
 var import_node_fs27 = require("node:fs");
 var import_node_path24 = require("node:path");
 var POLICY_FILE = "test-policy.json";
@@ -20523,14 +20543,14 @@ function evaluate(changed, policy, present = () => false) {
   return findings;
 }
 function git(args, cwd) {
-  return (0, import_node_child_process14.execFileSync)("git", args, { windowsHide: true, cwd, encoding: "utf8", maxBuffer: 32 * 1024 * 1024 });
+  return (0, import_node_child_process15.execFileSync)("git", args, { windowsHide: true, cwd, encoding: "utf8", maxBuffer: 32 * 1024 * 1024 });
 }
 var COAUTHOR_KEY = "Co-authored-by";
 var GH_MESSAGE_SEPARATOR = /^-{5,}$/;
 var LIFTED_KEYS = new RegExp(`^(?:${TRAILER_KEY}|${COAUTHOR_KEY}):`, "i");
 function parseTrailers(message, cwd) {
   try {
-    return (0, import_node_child_process14.execFileSync)("git", ["interpret-trailers", "--parse", "--unfold"], {
+    return (0, import_node_child_process15.execFileSync)("git", ["interpret-trailers", "--parse", "--unfold"], {
       windowsHide: true,
       cwd,
       input: message,
@@ -20715,124 +20735,6 @@ function runTestPolicy(root, deps = {}) {
   return result;
 }
 
-// src/docs-audit-command.ts
-function serializeOutcome(outcome) {
-  switch (outcome.kind) {
-    case "clean":
-      return "clean";
-    case "refreshed":
-      return `refreshed-${outcome.count}`;
-    case "failed":
-      return "failed";
-  }
-}
-var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-function isValidIsoDate(date) {
-  if (typeof date !== "string" || !ISO_DATE_RE.test(date)) return false;
-  const parsed = Date.parse(`${date}T00:00:00Z`);
-  if (Number.isNaN(parsed)) return false;
-  return new Date(parsed).toISOString().slice(0, 10) === date;
-}
-var OUTCOME_WIRE_RE = /^(clean|refreshed-[1-9]\d*|failed)$/;
-function isValidOutcomeWire(outcome) {
-  return typeof outcome === "string" && OUTCOME_WIRE_RE.test(outcome);
-}
-function docsAuditRecord(input) {
-  const repo = input.repo.trim();
-  const date = input.date.trim();
-  const shaRange = input.shaRange.trim();
-  const checkerVendor = input.checkerVendor.trim();
-  if (!repo) throw new Error("docs audit record: repo is required");
-  if (!date) throw new Error("docs audit record: date is required");
-  if (!isValidIsoDate(date)) throw new Error(`docs audit record: date must be a real ISO date (YYYY-MM-DD), got "${date}"`);
-  if (!shaRange) throw new Error("docs audit record: shaRange is required");
-  if (!checkerVendor) throw new Error("docs audit record: checkerVendor is required");
-  if (input.outcome.kind === "refreshed" && !(Number.isInteger(input.outcome.count) && input.outcome.count > 0)) {
-    throw new Error("docs audit record: a `refreshed` outcome must carry a positive integer count");
-  }
-  if (input.outcome.kind === "failed" && !input.outcome.reason.trim()) {
-    throw new Error("docs audit record: a `failed` outcome must carry a reason");
-  }
-  const outcome = serializeOutcome(input.outcome);
-  if (!isValidOutcomeWire(outcome)) {
-    throw new Error(`docs audit record: outcome serialized to an invalid wire form "${outcome}"`);
-  }
-  return { repo, date, shaRange, outcome, checkerVendor };
-}
-function ageInDays(verdictDate, today) {
-  const a = Date.parse(`${verdictDate}T00:00:00Z`);
-  const b = Date.parse(`${today}T00:00:00Z`);
-  return Math.max(0, Math.round((b - a) / 864e5));
-}
-function docsAuditStatus(fetch2, opts) {
-  if ("notArmed" in fetch2) {
-    return { ok: true, state: "not-armed", line: `docs audit: ${opts.repo} janitor not armed (registry route not live yet)` };
-  }
-  if (!fetch2.ok) {
-    return { ok: false, state: "error", line: `docs audit: ${opts.repo} registry read failed \u2014 ${fetch2.error}` };
-  }
-  if (!isValidIsoDate(opts.today)) {
-    throw new Error(`docs audit status: today must be a real ISO date (YYYY-MM-DD), got "${opts.today}"`);
-  }
-  if (fetch2.verdict === null) {
-    const armedAt = opts.armedAt;
-    if (armedAt && isValidIsoDate(armedAt)) {
-      const cadenceDays = opts.cadenceDays ?? 7;
-      const graceDays = opts.graceDays ?? 3;
-      const sinceArmed = ageInDays(armedAt, opts.today);
-      if (sinceArmed <= cadenceDays + graceDays) {
-        return {
-          ok: true,
-          state: "awaiting-first-tick",
-          line: `docs audit: ${opts.repo} armed ${armedAt} (${sinceArmed}d ago) \u2014 no verdict expected until the first tick`
-        };
-      }
-      return {
-        ok: false,
-        state: "missing",
-        line: `docs audit: ${opts.repo} no verdict on record ${sinceArmed}d after arming ${armedAt} \u2014 janitor blind or dead`
-      };
-    }
-    return { ok: false, state: "missing", line: `docs audit: ${opts.repo} no verdict on record \u2014 janitor blind or dead` };
-  }
-  const verdict = fetch2.verdict;
-  for (const field of ["repo", "shaRange", "checkerVendor"]) {
-    const value = verdict[field];
-    if (typeof value !== "string" || !value.trim()) {
-      const shown = typeof value === "string" ? `"${value}"` : `type ${Array.isArray(value) ? "array" : typeof value}`;
-      return {
-        ok: false,
-        state: "malformed",
-        line: `docs audit: ${opts.repo} malformed verdict ${field} (${shown}, expected a non-empty string) \u2014 registry record corrupt, treating as RED`
-      };
-    }
-  }
-  if (!isValidIsoDate(verdict.date)) {
-    return {
-      ok: false,
-      state: "malformed",
-      line: `docs audit: ${opts.repo} malformed verdict date "${verdict.date}" \u2014 registry record corrupt, treating as RED`
-    };
-  }
-  if (!isValidOutcomeWire(verdict.outcome)) {
-    return {
-      ok: false,
-      state: "malformed",
-      line: `docs audit: ${opts.repo} malformed verdict outcome "${verdict.outcome}" (expected clean|refreshed-N|failed) \u2014 registry record corrupt, treating as RED`
-    };
-  }
-  const cadence = opts.cadenceDays ?? 7;
-  const grace = opts.graceDays ?? 3;
-  const age = ageInDays(verdict.date, opts.today);
-  if (age > cadence + grace) {
-    return { ok: false, state: "stale", line: `docs audit: ${opts.repo} last verdict ${age}d old \u2014 janitor blind or dead` };
-  }
-  if (verdict.outcome === "failed") {
-    return { ok: false, state: "failed", line: `docs audit: ${opts.repo} last run FAILED (${verdict.date}) \u2014 janitor needs attention` };
-  }
-  return { ok: true, state: "clean", line: `docs audit: ${opts.repo} ${verdict.outcome} (${verdict.date}, ${verdict.checkerVendor})` };
-}
-
 // src/project-info-sync.ts
 var import_node_fs28 = require("node:fs");
 var import_node_path25 = require("node:path");
@@ -21021,7 +20923,7 @@ function authorizeBodyHasMismatch(body) {
 }
 
 // src/project-set.ts
-var UNSET_KEYS = ["oauth", "requiredRuntimeSecrets", "requiredBuildSecrets", "secrets", "edgeDomains", "requiredGcpApis", "publishRequired", "publishDir", "dsManifestPath", "fofuEnabled", "consumesDesignSystem", "ci", "requiredChecks", "gate"];
+var UNSET_KEYS = ["oauth", "requiredRuntimeSecrets", "requiredBuildSecrets", "secrets", "edgeDomains", "requiredGcpApis", "publishRequired", "publishDir", "dsManifestPath", "fofuEnabled", "consumesDesignSystem", "ci", "requiredChecks", "gate", "seedCanary"];
 var UNSET_KEY_SET = new Set(UNSET_KEYS);
 var RUNTIME_SECRET_STAGES = ["dev", "rc", "main"];
 var SECRET_CONSUMERS = ["runtime", "build", "lambda", "actions", "agent", "box"];
@@ -21275,6 +21177,11 @@ function parseRuntimeVaultOnlyVar(raw) {
   if (raw === "false") return false;
   throw new Error("org project set: runtimeVaultOnly must be true or false");
 }
+function parseSeedCanaryVar(raw) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  throw new Error("org project set: seedCanary must be true or false");
+}
 function parseConsumesDesignSystemVar(raw) {
   if (raw === "fofu") return raw;
   throw new Error('org project set: consumesDesignSystem must be "fofu"');
@@ -21364,7 +21271,8 @@ var SETTABLE_VAR_KEYS = [
   "ci",
   "requiredChecks",
   "gate",
-  "secrets"
+  "secrets",
+  "seedCanary"
 ];
 var SETTABLE_VAR_KEY_SET = new Set(SETTABLE_VAR_KEYS);
 var SETTABLE_VAR_HINTS = {
@@ -21375,6 +21283,7 @@ var SETTABLE_VAR_HINTS = {
   fofuEnabled: "true|false",
   consumesDesignSystem: '"fofu"',
   runtimeVaultOnly: "true|false",
+  seedCanary: "true|false",
   repos: 'JSON array, e.g. ["mutmutco/mm-foo"]',
   oauth: "JSON {subdomains,domains,callbackPath,fofuSubdomain}",
   requiredGcpApis: "comma-string",
@@ -21471,6 +21380,8 @@ function buildProjectSetPatch(input) {
       patch[key] = parseFofuEnabledVar(raw);
     } else if (key === "runtimeVaultOnly") {
       patch[key] = parseRuntimeVaultOnlyVar(raw);
+    } else if (key === "seedCanary") {
+      patch[key] = parseSeedCanaryVar(raw);
     } else if (key === "consumesDesignSystem") {
       patch[key] = parseConsumesDesignSystemVar(raw);
     } else if (key === "publishDir") {
@@ -22503,7 +22414,7 @@ ${SSH_RECIPE_AGENT_NOTE}`);
 
 // src/schedules-commands.ts
 var import_promises4 = require("node:fs/promises");
-var import_node_child_process15 = require("node:child_process");
+var import_node_child_process16 = require("node:child_process");
 var import_node_util7 = require("node:util");
 
 // src/schedules.ts
@@ -22814,7 +22725,7 @@ function cadenceStale(registryCadence, liveCadence) {
   if (!liveCrons.length) return false;
   return !liveCrons.every((cron) => registered.has(cron));
 }
-function reconcileGithubActions(liveGithub, registry2, readRepos, activeWorkflowNames = /* @__PURE__ */ new Set()) {
+function reconcileGithubActions(liveGithub, registry2, readRepos, activeWorkflowNames = /* @__PURE__ */ new Set(), disabledWorkflowNames = /* @__PURE__ */ new Set()) {
   const registryGithub = registry2.filter((r) => r.executor === "github-actions");
   const liveByName = new Map(liveGithub.map((e) => [e.name, e]));
   const registryById = new Map(registryGithub.map((r) => [r.id, r]));
@@ -22845,6 +22756,18 @@ function reconcileGithubActions(liveGithub, registry2, readRepos, activeWorkflow
       continue;
     }
     if (activeWorkflowNames.has(r.id)) continue;
+    if (disabledWorkflowNames.has(r.id)) {
+      if (readRepos.has(r.repo)) {
+        drifts.push({
+          class: "registered-but-disabled",
+          name: r.id,
+          executor: r.executor || "github-actions",
+          detail: "workflow file present but DISABLED in GitHub Actions \u2014 the dispatcher cannot run it",
+          remedy: `\`gh workflow enable\` it in ${r.repo} to re-arm (or, if it was retired on purpose, re-run schedules register so the replace prunes the SCHEDULE# row) \u2014 never prune a lane parked on purpose`
+        });
+      }
+      continue;
+    }
     if (readRepos.has(r.repo)) {
       drifts.push({
         class: "registered-but-dead",
@@ -22920,7 +22843,7 @@ function registeredButUnarmedDrifts(registry2, liveEntries, opts) {
   }
   return drifts.sort((a, b) => a.name.localeCompare(b.name));
 }
-function assembleReconciliation(githubEntries2, readRepos, registry2, activeWorkflowNames = /* @__PURE__ */ new Set(), harbour = {}) {
+function assembleReconciliation(githubEntries2, readRepos, registry2, activeWorkflowNames = /* @__PURE__ */ new Set(), harbour = {}, disabledWorkflowNames = /* @__PURE__ */ new Set()) {
   if (registry2 === null) {
     return {
       reconciliation: [],
@@ -22930,7 +22853,7 @@ function assembleReconciliation(githubEntries2, readRepos, registry2, activeWork
   }
   const live = githubEntries2.filter((e) => e.executor === "github-actions");
   const drifts = [
-    ...reconcileGithubActions(live, registry2, readRepos, activeWorkflowNames),
+    ...reconcileGithubActions(live, registry2, readRepos, activeWorkflowNames, disabledWorkflowNames),
     ...registeredButUnarmedDrifts(registry2, harbour.awsEntries ?? [], {
       schedulerRead: Boolean(harbour.schedulerRead),
       now: harbour.now
@@ -22940,7 +22863,7 @@ function assembleReconciliation(githubEntries2, readRepos, registry2, activeWork
 }
 
 // src/schedules-commands.ts
-var execFileP5 = (0, import_node_util7.promisify)(import_node_child_process15.execFile);
+var execFileP5 = (0, import_node_util7.promisify)(import_node_child_process16.execFile);
 var AWS_REGION = "eu-central-1";
 var AWS_TIMEOUT_MS = 3e4;
 var AWS_RETRY_DELAY_MS = 1500;
@@ -22964,9 +22887,15 @@ async function repoWorkflowEntries(client, repo) {
   const entries = [];
   const failures = [];
   const workflows = [];
+  const disabled = [];
   for (const wf of workflowsList) {
-    if (wf?.state !== "active" || typeof wf.path !== "string" || !wf.path) continue;
+    if (typeof wf?.path !== "string" || !wf.path) continue;
     if (!wf.path.startsWith(".github/workflows/")) continue;
+    if (wf.state !== "active") {
+      const basename5 = wf.path.split("/").pop() ?? wf.path;
+      disabled.push(`${repo}/${basename5.replace(/\.ya?ml$/, "")}`);
+      continue;
+    }
     try {
       const contents = await client.rest(
         "GET",
@@ -22985,7 +22914,7 @@ async function repoWorkflowEntries(client, repo) {
       else throw e;
     }
   }
-  return { entries, failures, workflows };
+  return { entries, failures, workflows, disabled };
 }
 async function githubEntries(client) {
   const entries = [];
@@ -22993,12 +22922,13 @@ async function githubEntries(client) {
   const drift = [];
   const readRepos = [];
   const workflows = [];
+  const disabledWorkflowNames = [];
   let repos;
   try {
     const listing = await client.restPaginate(`/orgs/${ORG}/repos?per_page=100`);
     repos = listing.filter((r) => typeof r?.name === "string" && r.archived !== true).map((r) => r.name).sort();
   } catch (e) {
-    return { entries, incomplete: [`github: could not list ${ORG} repos \u2014 ${e.message}`], drift, reconciliation: [], readRepos, workflowNames: [] };
+    return { entries, incomplete: [`github: could not list ${ORG} repos \u2014 ${e.message}`], drift, reconciliation: [], readRepos, workflowNames: [], disabledWorkflowNames: [] };
   }
   const results = await Promise.all(
     repos.map(async (repo) => {
@@ -23015,6 +22945,7 @@ async function githubEntries(client) {
       readRepos.push(r.repo);
       entries.push(...r.entries);
       workflows.push(...r.workflows);
+      disabledWorkflowNames.push(...r.disabled);
       if (r.failures.length) {
         drift.push(`${r.repo}: ${r.failures.length} workflow record(s) listed active with no file on the default branch (deleted one-offs?) \u2014 deregister them: ${r.failures.map((f) => f.split(": ")[1]).join(", ")}`);
       }
@@ -23022,7 +22953,7 @@ async function githubEntries(client) {
   }
   const reconciliation = [...strayCronDrifts(workflows), ...unlauncheredLlmDrifts(entries)];
   drift.push(...reconciliation.map(renderDrift));
-  return { entries, incomplete, drift, reconciliation, readRepos, workflowNames: workflows.map((w) => w.name) };
+  return { entries, incomplete, drift, reconciliation, readRepos, workflowNames: workflows.map((w) => w.name), disabledWorkflowNames };
 }
 async function awsJson(args) {
   const run = async () => {
@@ -23077,7 +23008,7 @@ async function fetchNotebook(client = defaultGitHubClient(), readRegistry = defa
     // #3286: the harbour side joins registry rows against the live aws-scheduler clocks by scheduleId.
     awsEntries: aws.entries,
     schedulerRead: Boolean(aws.schedulerRead)
-  });
+  }, new Set(gh.disabledWorkflowNames));
   const selfManaged = /* @__PURE__ */ new Set();
   for (const proj of projects ?? []) {
     if (proj?.schedulesMode !== "self-managed") continue;
@@ -23926,6 +23857,7 @@ var import_node_os11 = require("node:os");
 var import_node_path29 = require("node:path");
 
 // src/bootstrap-drift.ts
+var import_node_crypto6 = require("node:crypto");
 function byteComparableSeeds(manifest, cls) {
   return manifest.seeds.filter((s) => s.ownership === "org" && s.source === "self" && s.classes.includes(cls));
 }
@@ -23934,6 +23866,9 @@ function compareSeedBytes(hubContent, repoContent) {
   const normalize = (s) => s.replace(/\r\n/g, "\n");
   return normalize(hubContent) === normalize(repoContent) ? "match" : "drift";
 }
+function seedContentHash(content) {
+  return (0, import_node_crypto6.createHash)("sha256").update(content.replace(/\r\n/g, "\n"), "utf8").digest("hex");
+}
 function auditRepoSeedDrift(repo, seeds, hubContents, repoReads) {
   const byTarget = new Map(repoReads.map((r) => [r.target, r.content]));
   const slug = repo.includes("/") ? repo.slice(repo.indexOf("/") + 1).toLowerCase() : repo.toLowerCase();
@@ -23956,11 +23891,14 @@ function auditRepoSeedDrift(repo, seeds, hubContents, repoReads) {
       findings.push({ repo, target: seed.target, state: "waived", detail: `${state} \u2014 waived: ${why}` });
       continue;
     }
+    const repoContent = byTarget.get(seed.target);
     findings.push({
       repo,
       target: seed.target,
       state,
-      detail: state === "absent" ? "declared org-owned in the manifest but not present on the base branch" : "differs from MMI-Hub's copy \u2014 propagate with `mmi-cli bootstrap apply <repo> --only <target> --execute`, or, if this repo is RIGHT to differ, declare a waiver for it on the seed in the manifest (#3842)"
+      detail: state === "absent" ? "declared org-owned in the manifest but not present on the base branch" : "differs from MMI-Hub's copy \u2014 fix this in MMI-Hub and let it propagate (#4233); `mmi-cli bootstrap apply <repo> --only <target> --execute` remains for THIS repo's own bootstrap/onboarding, never a fleet-wide fan-out (#4241 fails a hand-edited fleet copy at the merge gate on repos carrying the new seed), or, if this repo is RIGHT to differ, declare a waiver for it on the seed in the manifest (#3842)",
+      // #4242: only a real 'drift' has bytes worth hashing — 'absent' has none to compare against history.
+      ...state === "drift" && repoContent != null ? { contentHash: seedContentHash(repoContent) } : {}
     });
   }
   return findings;
@@ -23979,6 +23917,171 @@ function renderSeedDriftReport(findings, reposAudited, seedsPerRepo) {
   return lines.join("\n");
 }
 
+// src/bootstrap-propagate.ts
+function assertPropagationCoverage(rosterCount, independentRegistryCount) {
+  if (rosterCount === 0) {
+    throw new Error("bootstrap propagate: roster read 0 repos \u2014 refusing to report a plan from a roster this command could not establish (#4232 coverage invariant)");
+  }
+  if (rosterCount < independentRegistryCount) {
+    throw new Error(
+      `bootstrap propagate: roster read ${rosterCount} repo(s) but the independent registry count is ${independentRegistryCount} \u2014 this read did not cover the fleet (#4232 coverage invariant)`
+    );
+  }
+}
+function assignWaves(repos, canarySlug) {
+  const waves = /* @__PURE__ */ new Map();
+  if (!canarySlug) return waves;
+  const rest = repos.filter((r) => r.slug !== canarySlug).slice().sort((a, b) => a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0);
+  const canary = repos.find((r) => r.slug === canarySlug);
+  if (canary) waves.set(canary.repo, 0);
+  const wave1Count = Math.ceil(rest.length * 0.25);
+  rest.forEach((r, i) => waves.set(r.repo, i < wave1Count ? 1 : 2));
+  return waves;
+}
+function statusFor(read) {
+  if (!read) return { status: "pending", record: {} };
+  if (read.drift === "match") return { status: "match", record: { mergeSha: read.pr?.mergeSha } };
+  const pr2 = read.pr;
+  if (!pr2) return { status: "pending", record: {} };
+  if (pr2.state === "closed") return { status: "closed-unmerged", record: { prNumber: pr2.number, prUrl: pr2.url } };
+  if (pr2.checks === "red") return { status: "red", record: { prNumber: pr2.number, prUrl: pr2.url } };
+  return { status: "open-pending", record: { prNumber: pr2.number, prUrl: pr2.url, mergeSha: pr2.mergeSha } };
+}
+var HALTING_STATUSES = /* @__PURE__ */ new Set(["red", "closed-unmerged"]);
+function planPropagationTick(input) {
+  const { target, repos, canarySlug, reads, isWorkflowSeed, functionGateSatisfied } = input;
+  const readByRepo = new Map(reads.map((r) => [r.repo, r]));
+  const records = [];
+  const opened = [];
+  const waived = repos.filter((r) => r.waiver);
+  for (const r of waived) {
+    records.push({ repo: r.repo, target, wave: null, status: "skipped-waived", action: "none", detail: `waived: ${r.waiver}` });
+  }
+  const eligible = repos.filter((r) => !r.waiver);
+  const refusedNoCanary = !canarySlug || !eligible.some((r) => r.slug === canarySlug);
+  if (refusedNoCanary) {
+    for (const r of eligible) {
+      records.push({ repo: r.repo, target, wave: null, status: "not-yet-reached", action: "none", detail: "no canary declared for this target \u2014 refusing to plan any wave (#4238 canary requirement)" });
+    }
+    return { target, reposInScope: repos.length, canary: null, refusedNoCanary: true, halted: false, haltReason: null, opened, records };
+  }
+  const waveOf = assignWaves(eligible, canarySlug);
+  const byWave = { 0: [], 1: [], 2: [] };
+  for (const r of eligible) byWave[waveOf.get(r.repo) ?? 2].push(r);
+  let halted = false;
+  let haltReason = null;
+  let waveGateOpen = true;
+  for (const waveNum of [0, 1, 2]) {
+    const waveRepos = byWave[waveNum];
+    if (!waveRepos.length) continue;
+    if (!waveGateOpen || halted) {
+      for (const r of waveRepos) {
+        records.push({ repo: r.repo, target, wave: waveNum, status: "not-yet-reached", action: "none", detail: "prior wave not yet converged" });
+      }
+      continue;
+    }
+    let waveAllMatch = true;
+    let waveHasRed = false;
+    for (const r of waveRepos) {
+      const { status, record } = statusFor(readByRepo.get(r.repo));
+      const shouldOpen = status === "pending";
+      if (shouldOpen) opened.push(r.repo);
+      records.push({
+        repo: r.repo,
+        target,
+        wave: waveNum,
+        status,
+        action: shouldOpen ? "open-pr" : "none",
+        detail: shouldOpen ? "no open propagation PR and not yet matching \u2014 opening this tick" : status,
+        ...record
+      });
+      if (status !== "match") waveAllMatch = false;
+      if (HALTING_STATUSES.has(status)) waveHasRed = true;
+    }
+    if (waveHasRed) {
+      halted = true;
+      haltReason = `wave ${waveNum} has a red or closed-unmerged PR \u2014 halting; no further wave opens (#4238 halt-and-alarm)`;
+      waveGateOpen = false;
+      continue;
+    }
+    if (waveNum === 0 && isWorkflowSeed && !functionGateSatisfied) {
+      waveGateOpen = false;
+      continue;
+    }
+    waveGateOpen = waveAllMatch;
+  }
+  return { target, reposInScope: repos.length, canary: canarySlug, refusedNoCanary: false, halted, haltReason, opened, records };
+}
+function renderPropagationReport(plan) {
+  const lines = [`bootstrap propagate \u2014 target ${plan.target}: ${plan.reposInScope} repo(s) in scope, canary=${plan.canary ?? "NONE"}`];
+  if (plan.refusedNoCanary) {
+    lines.push("  REFUSED \u2014 no canary declared for this target; plan every repo not-yet-reached");
+    return lines.join("\n");
+  }
+  for (const r of plan.records) {
+    const wave2 = r.wave == null ? "-" : String(r.wave);
+    lines.push(`  wave${wave2.padEnd(2)} ${r.status.padEnd(16)} ${r.repo}${r.prNumber ? ` PR#${r.prNumber}` : ""} \u2014 ${r.detail}`);
+  }
+  lines.push(plan.halted ? `  HALTED \u2014 ${plan.haltReason}` : `  opened this tick: ${plan.opened.length ? plan.opened.join(", ") : "(none)"}`);
+  return lines.join("\n");
+}
+
+// src/bootstrap-rollback.ts
+function resolveRollbackRecord(records, repo, target) {
+  const candidates = records.filter((r) => r.repo === repo && r.target === target && r.mergeSha);
+  if (candidates.length === 0) {
+    return { found: false, reason: `no propagation record resolves for ${repo} + ${target} \u2014 refusing to guess a commit to revert` };
+  }
+  const clean4 = candidates.filter((r) => r.files.length === 1 && r.files[0] === target);
+  if (clean4.length === 0) {
+    return {
+      found: false,
+      reason: `${candidates.length} merged seed-propagate PR(s) found for ${repo} + ${target}, but none is a clean single-file propagation of exactly this target \u2014 refusing to guess a commit to revert`
+    };
+  }
+  const latest = clean4.slice().sort((a, b) => a.mergedAt < b.mergedAt ? 1 : a.mergedAt > b.mergedAt ? -1 : 0)[0];
+  return { found: true, record: latest };
+}
+function planRollback(repo, target, slug, records) {
+  const resolution = resolveRollbackRecord(records, repo, target);
+  if (!resolution.found) return { repo, target, resolution };
+  const branch = `seed-rollback-${slug}`;
+  const title = `revert: rollback org-owned ${target} in ${repo} (seed PR #${resolution.record.number})`;
+  const body = renderRollbackPrBody(resolution.record);
+  return { repo, target, resolution, branch, title, body };
+}
+function renderRollbackPrBody(record) {
+  return [
+    `Per-repo emergency revert of \`${record.target}\`'s seed-propagate merge (\`mmi-cli bootstrap rollback\`, #4240).`,
+    "",
+    `Reverts ${record.url} (merge ${record.mergeSha}) \u2014 restores this repo's copy of \`${record.target}\` to its content immediately before that merge. Nothing else in this repo changes.`,
+    "",
+    "This is the emergency stop, not the fix: MMI-Hub is still the source of truth during a rollback. Closure is the Hub reverting (or fixing forward) the bad seed commit on `development` \u2014 once it does, this repo matches the Hub again and the drift alarm closes itself. A revert with no Hub-side follow-up re-alarms as drift within a week \u2014 deliberately, so an emergency divergence can never silently become permanent.",
+    "",
+    "Never re-run `bootstrap propagate` with the pre-revert bytes before the Hub itself is fixed \u2014 that reopens exactly what this PR closes."
+  ].join("\n");
+}
+function renderRollbackReport(plan) {
+  if (!plan.resolution.found) {
+    return `bootstrap rollback \u2014 ${plan.repo} / ${plan.target}: REFUSED \u2014 ${plan.resolution.reason}`;
+  }
+  const r = plan.resolution.record;
+  const opened = plan.prUrl ? ` \u2014 opened ${plan.prUrl}` : "";
+  return `bootstrap rollback \u2014 ${plan.repo} / ${plan.target}: reverting PR#${r.number} (merge ${r.mergeSha}${r.mergedAt ? `, merged ${r.mergedAt}` : ""}) on branch ${plan.branch}${opened}`;
+}
+function seedPrRecordFromPropagationRecord(record) {
+  if (!record.mergeSha || record.prNumber == null || !record.prUrl) return null;
+  return {
+    repo: record.repo,
+    target: record.target,
+    number: record.prNumber,
+    url: record.prUrl,
+    mergeSha: record.mergeSha,
+    mergedAt: "",
+    files: [record.target]
+  };
+}
+
 // src/bootstrap-verify.ts
 var TRAIN_BRANCHES2 = ["development", "rc", "main"];
 var requiredDocs = ["README.md", "architecture.md", "docs/decisions/README.md", "docs/index.md"];
@@ -25065,6 +25168,304 @@ LIVE apply to ${repo}:
   ${applied.join("\n  ")}`);
     }
   });
+  bootstrap.command("propagate").description("#4238: re-entrant canary\u2192wave tick \u2014 plan (or, with --execute, open) per-repo PRs fanning an org-owned seed out to the fleet").option("--target <path>", "the manifest target to propagate (an ownership:org + source:self seed, e.g. .github/workflows/agent-pr.yml)").option("--execute", "LIVE tick via gh (master-gated) \u2014 opens/reuses per-repo seed-propagate PRs; dry-run prints the plan only").option("--json", "machine-readable output").action(async () => {
+    const o = { target: rawValue("--target", ""), execute: rawFlag("--execute"), json: rawFlag("--json") };
+    const manifestPath = "skills/bootstrap/seeds/manifest.json";
+    if (!(0, import_node_fs31.existsSync)(manifestPath)) return fail(`bootstrap propagate: ${manifestPath} not found; run from the MMI-Hub repo root \u2014 the Hub's copies ARE the desired state this tick propagates`);
+    const manifest = loadBootstrapSeeds((0, import_node_fs31.readFileSync)(manifestPath, "utf8"));
+    const propagatable = manifest.seeds.filter((s) => s.ownership === "org" && s.source === "self");
+    if (!o.target) {
+      return fail(`bootstrap propagate: --target <path> is required \u2014 one of:
+  ${propagatable.map((s) => s.target).join("\n  ")}`);
+    }
+    const seed = propagatable.find((s) => s.target === o.target);
+    if (!seed) return fail(`bootstrap propagate: --target '${o.target}' names no ownership:org + source:self seed in ${manifestPath}. Propagatable targets:
+  ${propagatable.map((s) => s.target).join("\n  ")}`);
+    if (!(0, import_node_fs31.existsSync)(seed.target)) return fail(`bootstrap propagate: the Hub's own copy of '${seed.target}' is missing \u2014 nothing to propagate`);
+    const hubContent = (0, import_node_fs31.readFileSync)(seed.target, "utf8");
+    const isWorkflowSeed = seed.target.startsWith(".github/workflows/");
+    const cfg = await loadConfig();
+    const projects = await fetchProjectsList(registryClientDeps(cfg));
+    if (!projects || projects.length === 0) {
+      return failGraceful("bootstrap propagate: the registry roster is unreadable or empty \u2014 refusing to plan a tick from a scope this command could not establish (#4232 coverage invariant)");
+    }
+    const rosterRepos2 = collectRegistryRepos(projects).filter((r) => r.toLowerCase() !== "mutmutco/mmi-hub");
+    let independentCount = rosterRepos2.length;
+    if ((0, import_node_fs31.existsSync)("projects.json")) {
+      try {
+        const local = JSON.parse((0, import_node_fs31.readFileSync)("projects.json", "utf8"));
+        const localRepos = /* @__PURE__ */ new Set();
+        for (const p of local.projects ?? []) for (const r of p.repos ?? []) {
+          const full = (r.includes("/") ? r : `mutmutco/${r}`).toLowerCase();
+          if (full !== "mutmutco/mmi-hub") localRepos.add(full);
+        }
+        if (localRepos.size > 0) independentCount = localRepos.size;
+      } catch {
+      }
+    }
+    try {
+      assertPropagationCoverage(rosterRepos2.length, independentCount);
+    } catch (e) {
+      return fail(e.message);
+    }
+    const bySlugMeta = new Map(projects.flatMap((p) => (p.repos ?? []).map((r) => [(r.includes("/") ? r : `mutmutco/${r}`).toLowerCase(), p])));
+    const classOf = (repo) => bySlugMeta.get(repo.toLowerCase())?.class ?? "deployable";
+    const canaryProject = projects.find((p) => p.seedCanary === true);
+    const canarySlug = canaryProject ? (canaryProject.repos ?? [])[0]?.split("/").pop()?.toLowerCase() ?? null : null;
+    const repos = rosterRepos2.map((repo) => {
+      const slug = repo.split("/").pop().toLowerCase();
+      const waiver = seed.waivers?.[slug];
+      return { repo, slug, waiver };
+    });
+    const gh = async (args) => execFileP2("gh", args, { timeout: 2e4 });
+    const enc = (p) => p.split("/").map(encodeURIComponent).join("/");
+    const branchPrefix = "seed-propagate";
+    const reads = [];
+    for (const r of repos) {
+      if (r.waiver) continue;
+      const baseBranch = classOf(r.repo) === "content" ? "main" : "development";
+      let content = null;
+      try {
+        const resp = await gh(["api", `repos/${r.repo}/contents/${enc(seed.target)}?ref=${baseBranch}`]);
+        const parsed = JSON.parse(resp.stdout);
+        content = parsed.encoding === "base64" && typeof parsed.content === "string" ? Buffer.from(parsed.content, "base64").toString("utf8") : null;
+      } catch {
+        content = null;
+      }
+      const drift = compareSeedBytes(hubContent, content);
+      let pr2;
+      try {
+        const branch = `${branchPrefix}-${r.slug}`;
+        const listed = await gh(["pr", "list", "--repo", r.repo, "--head", branch, "--base", baseBranch, "--state", "all", "--json", "number,url,state,statusCheckRollup,mergeCommit", "--limit", "1"]);
+        const arr = JSON.parse(listed.stdout || "[]");
+        const p = arr[0];
+        if (p) {
+          const rollup = p.statusCheckRollup ?? [];
+          const checks = rollup.length === 0 ? "none" : rollup.some((c) => c.conclusion === "FAILURE" || c.state === "FAILURE") ? "red" : rollup.every((c) => c.conclusion === "SUCCESS" || c.state === "SUCCESS") ? "success" : "pending";
+          pr2 = { number: p.number, url: p.url, state: p.state === "MERGED" ? "merged" : p.state === "CLOSED" ? "closed" : "open", checks, mergeSha: p.mergeCommit?.oid };
+        }
+      } catch {
+        pr2 = void 0;
+      }
+      reads.push({ repo: r.repo, drift: drift === "waived" ? "match" : drift, pr: pr2 });
+    }
+    let functionGateSatisfied = !isWorkflowSeed;
+    if (isWorkflowSeed && canarySlug) {
+      const canaryRepo = repos.find((r) => r.slug === canarySlug)?.repo;
+      const canaryRead = reads.find((r) => r.repo === canaryRepo);
+      if (canaryRead?.drift === "match") {
+        try {
+          const workflowFile = seed.target.split("/").pop();
+          const runs = await gh(["api", `repos/${canaryRepo}/actions/workflows/${workflowFile}/runs?status=success&per_page=1`]);
+          const parsed = JSON.parse(runs.stdout);
+          functionGateSatisfied = Array.isArray(parsed.workflow_runs) && parsed.workflow_runs.length > 0;
+        } catch {
+          functionGateSatisfied = false;
+        }
+      }
+    }
+    const plan = planPropagationTick({ target: seed.target, repos, canarySlug, reads, isWorkflowSeed, functionGateSatisfied });
+    if (o.execute) {
+      if (plan.refusedNoCanary) return fail("bootstrap propagate --execute: no canary declared for this target \u2014 refusing to write (set seedCanary:true on exactly one registry repo)");
+      const headSha = (await gh(["api", "repos/mutmutco/MMI-Hub/commits/development", "--jq", ".sha"])).stdout.trim();
+      for (const rec of plan.records) {
+        if (rec.action !== "open-pr") continue;
+        const repoEntry = repos.find((r) => r.repo === rec.repo);
+        const baseBranch = classOf(rec.repo) === "content" ? "main" : "development";
+        const branch = `${branchPrefix}-${repoEntry.slug}`;
+        const baseRef = await gh(["api", `repos/${rec.repo}/git/ref/heads/${baseBranch}`, "--jq", ".object.sha"]);
+        const baseSha = baseRef.stdout.trim();
+        let branchExists = true;
+        try {
+          await gh(["api", `repos/${rec.repo}/git/ref/heads/${branch}`]);
+        } catch {
+          branchExists = false;
+        }
+        if (!branchExists) await gh(["api", `repos/${rec.repo}/git/refs`, "-f", `ref=refs/heads/${branch}`, "-f", `sha=${baseSha}`]);
+        let existingSha;
+        try {
+          const cur = await gh(["api", `repos/${rec.repo}/contents/${enc(seed.target)}?ref=${branch}`]);
+          existingSha = JSON.parse(cur.stdout).sha;
+        } catch {
+          existingSha = void 0;
+        }
+        const tmp = (0, import_node_path29.join)((0, import_node_os11.tmpdir)(), `mmi-propagate-${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}.json`);
+        (0, import_node_fs31.writeFileSync)(tmp, JSON.stringify(contentPutBody(seed.target, hubContent, branch, existingSha)), "utf8");
+        try {
+          await gh(contentPutInputArgs(rec.repo, seed.target, tmp));
+        } finally {
+          try {
+            (0, import_node_fs31.unlinkSync)(tmp);
+          } catch {
+          }
+        }
+        const openPrs = await gh(["pr", "list", "--repo", rec.repo, "--head", branch, "--base", baseBranch, "--state", "open", "--json", "number,url"]);
+        const prDecision = decideSeedPrAction(JSON.parse(openPrs.stdout || "[]"));
+        let prUrl;
+        if (prDecision.action === "reuse") {
+          prUrl = prDecision.url;
+        } else {
+          const created = await ghCreate([
+            "pr",
+            "create",
+            "--repo",
+            rec.repo,
+            "--base",
+            baseBranch,
+            "--head",
+            branch,
+            "--title",
+            `chore: propagate org-owned ${seed.target} from MMI-Hub (wave ${rec.wave})`,
+            "--body",
+            `Auto-opened by \`mmi-cli bootstrap propagate --target ${seed.target} --execute\` (#4238), wave ${rec.wave}.
+
+Propagates MMI-Hub@${headSha} 's copy of \`${seed.target}\` to this repo \u2014 the file this PR carries and nothing else.
+
+Rollback: \`mmi-cli bootstrap rollback ${rec.repo} --target ${seed.target} --execute\` (#4240) reverts this PR's merge commit; never re-run propagate with old bytes.`
+          ]);
+          prUrl = created.url;
+        }
+        if (rec.wave !== 0) {
+          await gh(["pr", "merge", prUrl, "--repo", rec.repo, "--auto", "--squash"]).catch(() => {
+          });
+        }
+        rec.prUrl = prUrl;
+      }
+    }
+    if (o.json) console.log(JSON.stringify(plan, null, 2));
+    else console.log(renderPropagationReport(plan));
+    if (plan.halted) process.exitCode = 1;
+  });
+  bootstrap.command("rollback <repo>").description("#4240: open a per-repo revert PR of the recorded seed-propagate merge \u2014 never a fleet-wide overwrite; dry-run unless --execute").addOption(new Option("--class <class>", "deployable | content").default("deployable").choices(["deployable", "content"])).option("--target <path>", "the manifest target to roll back (an ownership:org + source:self seed, e.g. .github/workflows/agent-pr.yml)").option("--record <path>", "read propagation candidates from a persisted `bootstrap propagate --json` report instead of the live seed-propagate PR history").option("--execute", "LIVE revert via gh (master-gated) \u2014 opens/reuses the seed-rollback PR; dry-run prints the plan only").option("--json", "machine-readable output").action(async (repo) => {
+    const o = {
+      class: rawValue("--class", "deployable"),
+      target: rawValue("--target", ""),
+      record: rawValue("--record", ""),
+      execute: rawFlag("--execute"),
+      json: rawFlag("--json")
+    };
+    if (o.class !== "deployable" && o.class !== "content") return fail("bootstrap rollback: --class must be deployable or content");
+    let parsedRepo;
+    try {
+      parsedRepo = parseOwnerRepo(repo);
+    } catch (e) {
+      return fail(`bootstrap rollback: ${e.message}`);
+    }
+    const manifestPath = "skills/bootstrap/seeds/manifest.json";
+    if (!(0, import_node_fs31.existsSync)(manifestPath)) return fail(`bootstrap rollback: ${manifestPath} not found; run from the MMI-Hub repo root \u2014 the manifest names which targets are org-owned and therefore propagated (and rollback-able)`);
+    const manifest = loadBootstrapSeeds((0, import_node_fs31.readFileSync)(manifestPath, "utf8"));
+    const propagatable = manifest.seeds.filter((s) => s.ownership === "org" && s.source === "self");
+    if (!o.target) {
+      return fail(`bootstrap rollback: --target <path> is required \u2014 one of:
+  ${propagatable.map((s) => s.target).join("\n  ")}`);
+    }
+    const seed = propagatable.find((s) => s.target === o.target);
+    if (!seed) return fail(`bootstrap rollback: --target '${o.target}' names no ownership:org + source:self seed in ${manifestPath}. Propagatable (hence rollback-able) targets:
+  ${propagatable.map((s) => s.target).join("\n  ")}`);
+    const slug = parsedRepo.slug;
+    const baseBranch = o.class === "content" ? "main" : "development";
+    const branchPrefix = "seed-propagate";
+    const propagateBranch = `${branchPrefix}-${slug}`;
+    const gh = async (args) => execFileP2("gh", args, { timeout: 2e4 });
+    const enc = (p) => p.split("/").map(encodeURIComponent).join("/");
+    let candidates;
+    if (o.record) {
+      if (!(0, import_node_fs31.existsSync)(o.record)) return fail(`bootstrap rollback: --record '${o.record}' not found`);
+      let parsed;
+      try {
+        parsed = JSON.parse((0, import_node_fs31.readFileSync)(o.record, "utf8"));
+      } catch (e) {
+        return fail(`bootstrap rollback: --record '${o.record}' is not valid JSON: ${e.message}`);
+      }
+      const recs = Array.isArray(parsed?.records) ? parsed.records : Array.isArray(parsed) ? parsed : [];
+      candidates = recs.map((r) => {
+        try {
+          return seedPrRecordFromPropagationRecord(r);
+        } catch {
+          return null;
+        }
+      }).filter((r) => r !== null);
+    } else {
+      candidates = [];
+      try {
+        const listed = await gh(["pr", "list", "--repo", repo, "--head", propagateBranch, "--base", baseBranch, "--state", "merged", "--json", "number,url,mergedAt,mergeCommit,files", "--limit", "20"]);
+        const arr = JSON.parse(listed.stdout || "[]");
+        for (const p of arr) {
+          if (!p.mergeCommit?.oid) continue;
+          candidates.push({
+            repo,
+            target: seed.target,
+            number: p.number,
+            url: p.url,
+            mergeSha: p.mergeCommit.oid,
+            mergedAt: p.mergedAt ?? "",
+            files: (p.files ?? []).map((f) => f.path)
+          });
+        }
+      } catch (e) {
+        return fail(`bootstrap rollback: could not read ${repo}'s merged ${propagateBranch} PR history: ${e.message}`);
+      }
+    }
+    const plan = planRollback(repo, seed.target, slug, candidates);
+    if (!plan.resolution.found) {
+      if (o.json) console.log(JSON.stringify(plan, null, 2));
+      else console.log(renderRollbackReport(plan));
+      return fail(`bootstrap rollback: ${plan.resolution.reason}`);
+    }
+    if (o.execute) {
+      const record = plan.resolution.record;
+      const parentResp = await gh(["api", `repos/${repo}/commits/${record.mergeSha}`, "--jq", ".parents[0].sha"]);
+      const parentSha = parentResp.stdout.trim();
+      if (!parentSha) return fail(`bootstrap rollback: could not resolve ${repo}@${record.mergeSha}'s parent commit \u2014 refusing to guess what to restore`);
+      let preSeedContent = null;
+      try {
+        const resp = await gh(["api", `repos/${repo}/contents/${enc(seed.target)}?ref=${parentSha}`]);
+        const parsed = JSON.parse(resp.stdout);
+        preSeedContent = parsed.encoding === "base64" && typeof parsed.content === "string" ? Buffer.from(parsed.content, "base64").toString("utf8") : null;
+      } catch {
+        preSeedContent = null;
+      }
+      if (preSeedContent == null) return fail(`bootstrap rollback: '${seed.target}' did not exist in ${repo} at ${parentSha} (the commit before the seed merge) \u2014 nothing to restore; refusing to guess`);
+      const baseRef = await gh(["api", `repos/${repo}/git/ref/heads/${baseBranch}`, "--jq", ".object.sha"]);
+      const baseSha = baseRef.stdout.trim();
+      let branchExists = true;
+      try {
+        await gh(["api", `repos/${repo}/git/ref/heads/${plan.branch}`]);
+      } catch {
+        branchExists = false;
+      }
+      if (!branchExists) await gh(["api", `repos/${repo}/git/refs`, "-f", `ref=refs/heads/${plan.branch}`, "-f", `sha=${baseSha}`]);
+      let existingSha;
+      try {
+        const cur = await gh(["api", `repos/${repo}/contents/${enc(seed.target)}?ref=${plan.branch}`]);
+        existingSha = JSON.parse(cur.stdout).sha;
+      } catch {
+        existingSha = void 0;
+      }
+      const tmp = (0, import_node_path29.join)((0, import_node_os11.tmpdir)(), `mmi-rollback-${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}.json`);
+      (0, import_node_fs31.writeFileSync)(tmp, JSON.stringify(contentPutBody(seed.target, preSeedContent, plan.branch, existingSha)), "utf8");
+      try {
+        await gh(contentPutInputArgs(repo, seed.target, tmp));
+      } finally {
+        try {
+          (0, import_node_fs31.unlinkSync)(tmp);
+        } catch {
+        }
+      }
+      const openPrs = await gh(["pr", "list", "--repo", repo, "--head", plan.branch, "--base", baseBranch, "--state", "open", "--json", "number,url"]);
+      const prDecision = decideSeedPrAction(JSON.parse(openPrs.stdout || "[]"));
+      let prUrl;
+      if (prDecision.action === "reuse") {
+        prUrl = prDecision.url;
+      } else {
+        const created = await ghCreate(["pr", "create", "--repo", repo, "--base", baseBranch, "--head", plan.branch, "--title", plan.title, "--body", plan.body]);
+        prUrl = created.url;
+      }
+      plan.prUrl = prUrl;
+    }
+    if (o.json) console.log(JSON.stringify(plan, null, 2));
+    else console.log(renderRollbackReport(plan));
+  });
 }
 
 // src/stage-commands.ts
@@ -25605,6 +26006,7 @@ function registerBoardCommands(program3) {
           force: o.force,
           allowPartial: o.allowPartial
         });
+        invalidateStatuslineBoardCache();
         if (o.json) return console.log(JSON.stringify(result));
         console.log(result.partial ? `Partially claimed ${result.item.ref}: ${result.warning}` : result.alreadyClaimed ? `Already claimed ${result.item.ref} - In Progress (no change)` : `Claimed ${result.item.ref} - In Progress`);
       } catch (e) {
@@ -25621,6 +26023,7 @@ function registerBoardCommands(program3) {
         force: o.force,
         allowPartial: o.allowPartial
       });
+      if (bulk.results.some((r) => r.claimed)) invalidateStatuslineBoardCache();
       if (o.json) {
         console.log(JSON.stringify(bulk.results));
       } else {
@@ -25665,6 +26068,7 @@ function registerBoardCommands(program3) {
         repo: o.repo,
         allowPartial: o.allowPartial
       });
+      if (bulk.results.some((r) => r.moved)) invalidateStatuslineBoardCache();
       if (o.json) {
         console.log(JSON.stringify(bulk.results));
       } else {
@@ -25689,6 +26093,7 @@ function registerBoardCommands(program3) {
     if (issueRefs.length === 1) {
       try {
         const result = await moveBoardItem({ config: await loadConfigForBoardSelector2(issueRefs[0], o.repo), selector: issueRefs[0], status: canonicalStatus, repo: o.repo, allowPartial: o.allowPartial });
+        invalidateStatuslineBoardCache();
         if (o.json) return console.log(JSON.stringify(result));
         console.log(result.partial ? `Partially moved ${result.item.ref}: ${result.warning}` : `Moved ${result.item.ref} -> ${result.status}`);
       } catch (e) {
@@ -25740,6 +26145,7 @@ function registerBoardCommands(program3) {
         force: o.force,
         allowPartial: o.allowPartial
       });
+      invalidateStatuslineBoardCache();
       if (o.json) return console.log(JSON.stringify(result));
       console.log(result.partial ? `Partially unclaimed ${result.item.ref}: ${result.warning}` : `Unclaimed ${result.item.ref} -> ${result.status}`);
     } catch (e) {
@@ -25778,7 +26184,7 @@ var import_node_fs34 = require("node:fs");
 var import_promises8 = require("node:fs/promises");
 var import_node_path33 = require("node:path");
 var import_node_os12 = require("node:os");
-var import_node_child_process16 = require("node:child_process");
+var import_node_child_process17 = require("node:child_process");
 
 // src/board-advance.ts
 function repoOf2(ref) {
@@ -26061,6 +26467,22 @@ function assertPrMergeHousekeepingClean(startingPath, context, options = {}) {
   if (verdict.blocked) throw new Error(verdict.reason);
   return housekeeping;
 }
+async function bestEffortLeaseClose(wtPath, exec = (cmd, args) => execFileP2(cmd, args, { timeout: GIT_TIMEOUT_MS })) {
+  const step = "close jerv worktree lease";
+  try {
+    await exec("jerv-cli", ["lease", "close", "--ref", wtPath]);
+    return { step, status: "done" };
+  } catch (e) {
+    const err = e;
+    const detail = `${err.message}
+${err.stderr ?? ""}`;
+    if (/ENOENT|not found|not recognized/i.test(detail)) {
+      return { step, status: "skipped: jerv-cli not on PATH" };
+    }
+    const msg = (err.stderr?.trim() || err.message).split("\n")[0];
+    return { step, status: `failed: ${msg}` };
+  }
+}
 async function applyGcPlan(plan, remote, opts = {}) {
   const result = { removedBranches: [], removedRemoteBranches: [], removedTrackingRefs: [], removedWorktreeDirs: [], refused: [], failed: [], pruned: false };
   const beforeWorktrees = parseWorktreePorcelain(
@@ -26109,6 +26531,7 @@ async function applyGcPlan(plan, remote, opts = {}) {
         removeWorktreeDir: wtDeps.removeWorktreeDir,
         removalContext: { primaryRoot: primaryRepoRoot, actor: gcActor, command: "worktree gc", force: opts.force }
       });
+      if (cleanup.worktree?.status === "removed") await bestEffortLeaseClose(cleanup.worktree.path);
       return cleanup;
     },
     cleanupRemoteBranch: (branch, expectedHeadOid) => deleteReviewedRemoteBranch(remote, branch.branch, expectedHeadOid),
@@ -26155,6 +26578,7 @@ async function applyGcPlan(plan, remote, opts = {}) {
         owner,
         reason: owner ? "branch merged/closed or directory dead; owner registration was stale" : "branch merged/closed or directory dead; no owner registered"
       });
+      await bestEffortLeaseClose(wt.path);
     } catch (e) {
       const error = e.message.split("\n")[0];
       result.failed.push(`${wt.path}: ${error}`);
@@ -26327,7 +26751,7 @@ async function remoteBranchExists2(branch, options = {}) {
 }
 var COMPOSE_TIMEOUT_MS = 12e4;
 function spawnDeferredGcSweep() {
-  spawnDetachedSelf(["worktree", "gc", "sweep-deferred", "--quiet"], { spawn: import_node_child_process16.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
+  spawnDetachedSelf(["worktree", "gc", "sweep-deferred", "--quiet"], { spawn: import_node_child_process17.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
 }
 async function createDeferredWorktreeStore() {
   try {
@@ -26736,6 +27160,7 @@ var import_node_fs35 = require("node:fs");
 var import_promises9 = require("node:fs/promises");
 var import_node_path34 = require("node:path");
 var GH_TIMEOUT_MS = 2e4;
+var STALE_PR_LOOKUP_LIMIT = 20;
 var DEFAULT_BASE = "origin/development";
 var DEFAULT_REMOTE = "origin";
 var PROTECTED_BRANCHES2 = /* @__PURE__ */ new Set(["development", "main", "master", "rc"]);
@@ -26895,13 +27320,16 @@ function scanOrphanDirs(worktreesRoot, worktreeGitRoot, deps = defaultOrphanDirS
   }
   return candidates;
 }
-function formatStaleLeaks(leaks) {
-  if (!leaks.length) return "worktree list --stale: no leaks found";
-  const lines = [`worktree list --stale: ${leaks.length} leak(s)`];
+function formatStaleLeaks(leaks, prLookupFailures = []) {
+  const lines = leaks.length ? [`worktree list --stale: ${leaks.length} leak(s)`] : ["worktree list --stale: no leaks found"];
   for (const leak of leaks) {
     lines.push(`  [${leak.kind}] ${leak.ref} \u2014 ${leak.detail}`);
     lines.push(`      fix: ${leak.remediation}`);
   }
+  if (prLookupFailures.length) {
+    lines.push(`  INCOMPLETE: merge state could not be read for ${prLookupFailures.length} branch(es) \u2014 they are NOT covered above`);
+    for (const f of prLookupFailures) lines.push(`      ${f.branch}${f.detail ? ` \u2014 ${f.detail}` : ""}`);
+  }
   return lines.join("\n");
 }
 async function repoRootOf() {
@@ -27172,6 +27600,7 @@ function registerWorktreeCommands(program3) {
         }
       }
       report.push(await bestEffortGit(["worktree", "prune"], primaryCheckout, "prune worktree metadata"));
+      report.push(await bestEffortLeaseClose(wtPath));
       const result = {
         dryRun: false,
         ...plan,
@@ -27202,8 +27631,9 @@ function registerWorktreeCommands(program3) {
       const ctx = await gatherWorktreeContext();
       if (o.stale) {
         const leaks = classifyStaleLeaks(ctx);
-        if (o.json) return console.log(JSON.stringify({ stale: leaks, count: leaks.length }, null, 2));
-        return console.log(formatStaleLeaks(leaks));
+        const failures = ctx.prLookupFailures ?? [];
+        if (o.json) return console.log(JSON.stringify({ stale: leaks, count: leaks.length, prLookupFailures: failures, complete: failures.length === 0 }, null, 2));
+        return console.log(formatStaleLeaks(leaks, failures));
       }
       if (o.json) return console.log(JSON.stringify({ worktrees: ctx.worktrees }, null, 2));
       if (!ctx.worktrees.length) return console.log("worktree list: no worktrees");
@@ -27227,22 +27657,18 @@ async function gatherWorktreeContext() {
   const branchOut = (await execFileP2("git", ["branch", "--format=%(refname:short)"], { timeout: GIT_TIMEOUT_MS }).catch(() => ({ stdout: "" }))).stdout;
   const localBranches = branchOut.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
   const currentBranch2 = (await execFileP2("git", ["rev-parse", "--abbrev-ref", "HEAD"], { timeout: GIT_TIMEOUT_MS }).catch(() => ({ stdout: "" }))).stdout.trim() || void 0;
+  const { prs, failures: prLookupFailures } = await resolveBranchPrs(localBranches.filter((b) => !PROTECTED_BRANCHES2.has(b)), STALE_PR_LOOKUP_LIMIT);
   const openPrBranches = /* @__PURE__ */ new Set();
   const closedBranches = /* @__PURE__ */ new Set();
-  try {
-    const { stdout } = await execFileP2("gh", ["pr", "list", "--state", "all", "--limit", "200", "--json", "headRefName,state"], { timeout: GH_TIMEOUT_MS });
-    const prs = JSON.parse(stdout || "[]");
-    const byBranch = /* @__PURE__ */ new Map();
-    for (const pr2 of prs) {
-      const arr = byBranch.get(pr2.headRefName) ?? [];
-      arr.push(pr2.state);
-      byBranch.set(pr2.headRefName, arr);
-    }
-    for (const [br, states] of byBranch) {
-      if (states.some((s) => s === "OPEN")) openPrBranches.add(br);
-      else if (states.some((s) => s === "MERGED" || s === "CLOSED")) closedBranches.add(br);
-    }
-  } catch {
+  const byBranch = /* @__PURE__ */ new Map();
+  for (const pr2 of prs) {
+    const arr = byBranch.get(pr2.headRefName) ?? [];
+    arr.push(pr2.state);
+    byBranch.set(pr2.headRefName, arr);
+  }
+  for (const [br, states] of byBranch) {
+    if (states.some((s) => s === "OPEN")) openPrBranches.add(br);
+    else if (states.some((s) => s === "MERGED" || s === "CLOSED")) closedBranches.add(br);
   }
   const stages = [];
   for (const wt of worktrees) {
@@ -27259,7 +27685,7 @@ async function gatherWorktreeContext() {
       listDirs: (root) => worktreeScanDirs(root, primaryRepoRoot, defaultOrphanDirScanDeps.listDirs, isRepoCheckoutDir)
     });
   }
-  return { worktrees, localBranches, currentBranch: currentBranch2, openPrBranches, closedBranches, stages, orphanDirs };
+  return { worktrees, localBranches, currentBranch: currentBranch2, openPrBranches, closedBranches, stages, orphanDirs, prLookupFailures };
 }
 async function bestEffortGit(args, cwd, step, timeoutMs = GIT_TIMEOUT_MS) {
   try {
@@ -27280,7 +27706,7 @@ ${err.stderr ?? ""}`;
 
 // src/issue-commands.ts
 var import_node_fs36 = require("node:fs");
-var import_node_crypto6 = require("node:crypto");
+var import_node_crypto7 = require("node:crypto");
 var ghRunner = async (args, timeoutMs) => (await execFileP2("gh", args, { timeout: timeoutMs })).stdout;
 var ReparentConflictError = class extends Error {
   constructor(message, payload) {
@@ -27356,6 +27782,44 @@ async function editIssue(client, options, deps = {}) {
     ...parentResult ? { parent: parentResult } : {}
   };
 }
+var EVIDENCE_COMMENT_URL_RE = /^https:\/\/github\.com\/([\w.-]+\/[\w.-]+)\/issues\/(\d+)#issuecomment-(\d+)$/;
+async function verifyCloseEvidence(client, evidence, repo, issueNumber, duplicateOf) {
+  const match = evidence.trim().match(EVIDENCE_COMMENT_URL_RE);
+  if (!match) {
+    throw new Error(
+      `--evidence must be a canonical issue-comment URL (https://github.com/<owner>/<repo>/issues/<n>#issuecomment-<id>), got: ${evidence}`
+    );
+  }
+  const [, evidenceRepo, evidenceIssue, commentId] = match;
+  if (evidenceRepo.toLowerCase() !== repo.toLowerCase() || Number(evidenceIssue) !== issueNumber) {
+    throw new Error(
+      `--evidence comment belongs to ${evidenceRepo}#${evidenceIssue}, not the issue being closed (${repo}#${issueNumber})`
+    );
+  }
+  let comment;
+  try {
+    comment = await client.rest(
+      "GET",
+      `repos/${repo}/issues/comments/${commentId}`
+    );
+  } catch (e) {
+    if (e instanceof GitHubApiError && e.status === 404) {
+      throw new Error(`--evidence comment ${commentId} does not exist on ${repo} \u2014 nothing to anchor the close to`);
+    }
+    throw e;
+  }
+  const expectedAnchor = `/issues/${issueNumber}#issuecomment-${commentId}`;
+  if (!comment.html_url || !comment.html_url.toLowerCase().endsWith(expectedAnchor.toLowerCase())) {
+    throw new Error(
+      `--evidence comment ${commentId} is not a comment on ${repo}#${issueNumber} (it lives at ${comment.html_url ?? "unknown"})`
+    );
+  }
+  if (duplicateOf !== void 0 && !new RegExp(`#${duplicateOf}\\b`).test(comment.body ?? "")) {
+    throw new Error(
+      `--reason duplicate-of ${duplicateOf}: the --evidence comment must cite #${duplicateOf} so the duplicate has an auditable destination`
+    );
+  }
+}
 async function closeIssue(client, options, deps = {}) {
   const parsed = parseIssueRef(options.ref);
   const repo = parsed.repo ?? options.defaultRepo;
@@ -27363,6 +27827,9 @@ async function closeIssue(client, options, deps = {}) {
   const url = `https://github.com/${repo}/issues/${parsed.number}`;
   const reason = options.reason ?? "completed";
   const stateReason = reason === "duplicate-of" ? "not_planned" : reason === "not-planned" ? "not_planned" : "completed";
+  if (options.evidence !== void 0) {
+    await verifyCloseEvidence(client, options.evidence, repo, parsed.number, reason === "duplicate-of" ? options.duplicateOf : void 0);
+  }
   await client.rest("PATCH", `repos/${repo}/issues/${parsed.number}`, {
     body: { state: "closed", state_reason: stateReason }
   });
@@ -27530,7 +27997,7 @@ function rowIdempotencyKey(batchKey, spec) {
   const identity = `${spec.type}
 ${spec.title.trim()}
 ${spec.body ?? ""}`;
-  const hash = (0, import_node_crypto6.createHash)("sha256").update(identity).digest("hex").slice(0, 16);
+  const hash = (0, import_node_crypto7.createHash)("sha256").update(identity).digest("hex").slice(0, 16);
   return `${batchKey}:${hash}`;
 }
 var BATCH_SPEC_KEYS = /* @__PURE__ */ new Set(["type", "title", "body", "priority", "labels", "label", "parent", "repo", "surface"]);
@@ -27749,7 +28216,7 @@ function registerIssueLifecycleCommands(program3, deps = {}) {
     }
   });
   mutating(
-    issue2.command("close <ref>").description("close an issue and move its board item to Done (--reason completed|not-planned|duplicate-of --duplicate-of <n>)").option("--reason <reason>", "completed | not-planned | duplicate-of (defaults to completed)").option("--duplicate-of <number>", "the issue number this duplicates (use with --reason duplicate-of)").option("--comment <text>", "a closing comment to post").option("--repo <owner/repo>", "repo for a bare ref (defaults to the current repo)"),
+    issue2.command("close <ref>").description("close an issue and move its board item to Done (--reason completed|not-planned|duplicate-of --duplicate-of <n>)").option("--reason <reason>", "completed | not-planned | duplicate-of (defaults to completed)").option("--duplicate-of <number>", "the issue number this duplicates (use with --reason duplicate-of)").option("--comment <text>", "a closing comment to post").option("--evidence <comment-url>", "URL of an existing comment on this issue carrying the close evidence \u2014 verified before closing (JPT#4668; the sanctioned agent-shell close shape)").option("--repo <owner/repo>", "repo for a bare ref (defaults to the current repo)"),
     (opts, args) => {
       let reason;
       try {
@@ -27778,7 +28245,8 @@ function registerIssueLifecycleCommands(program3, deps = {}) {
         defaultRepo,
         reason: parsed.reason,
         duplicateOf: o.duplicateOf ? Number(o.duplicateOf) : void 0,
-        comment: o.comment
+        comment: o.comment,
+        evidence: o.evidence
       });
       console.log(JSON.stringify(result));
     } catch (e) {
@@ -27909,6 +28377,7 @@ ${lines}`, {
           surface: batchSurface,
           noSurface: batchNoSurface
         }, { attach: batchAttach });
+        if (result.created.some((row) => !row.idempotent)) invalidateStatuslineBoardCache();
         console.log(JSON.stringify(result));
         if (result.failures.length) process.exitCode = 1;
       } catch (e) {
@@ -31286,9 +31755,9 @@ function ghAccountCaveat(announcedLogin, accounts) {
 var import_node_fs39 = require("node:fs");
 var import_node_os14 = require("node:os");
 var import_node_path37 = require("node:path");
-var import_node_child_process17 = require("node:child_process");
+var import_node_child_process18 = require("node:child_process");
 var import_node_util8 = require("node:util");
-var execFileP6 = (0, import_node_util8.promisify)(import_node_child_process17.execFile);
+var execFileP6 = (0, import_node_util8.promisify)(import_node_child_process18.execFile);
 var MMI_PLUGIN_ID2 = "mmi@mutmutco";
 function installedClaudePluginVersion() {
   try {
@@ -31334,12 +31803,12 @@ function installedSurfacePluginVersion(surface) {
   if (token === "claude") return installedClaudePluginVersion();
   if (token !== "codex") return void 0;
   try {
-    const raw = process.platform === "win32" ? (0, import_node_child_process17.execFileSync)("cmd.exe", ["/c", "codex", "plugin", "list", "--json"], {
+    const raw = process.platform === "win32" ? (0, import_node_child_process18.execFileSync)("cmd.exe", ["/c", "codex", "plugin", "list", "--json"], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 15e3,
       windowsHide: true
-    }) : (0, import_node_child_process17.execFileSync)("codex", ["plugin", "list", "--json"], {
+    }) : (0, import_node_child_process18.execFileSync)("codex", ["plugin", "list", "--json"], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 15e3,
@@ -31357,7 +31826,7 @@ function installedActivePluginVersion(surface = detectSurface(process.env)) {
 }
 function worktreeRootSync() {
   try {
-    const out = (0, import_node_child_process17.execFileSync)("git", ["rev-parse", "--show-toplevel"], { windowsHide: true, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    const out = (0, import_node_child_process18.execFileSync)("git", ["rev-parse", "--show-toplevel"], { windowsHide: true, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
     let root = out.endsWith("\n") ? out.slice(0, -1) : out;
     if (process.platform === "win32" && root.endsWith("\r")) root = root.slice(0, -1);
     return root || null;
@@ -31411,23 +31880,6 @@ function hasRepoLocalWorktrees() {
 
 // src/index.ts
 var execFileGitRun = async (file, args) => (await execFileP2(file, args, { timeout: GIT_TIMEOUT_MS })).stdout;
-async function currentRepoFullName() {
-  const remote = (await gitOut(["remote", "get-url", "origin"])).replace(/\.git$/, "");
-  const parts = remote.split(/[:/]/).filter(Boolean);
-  if (parts.length >= 2) return `${parts[parts.length - 2]}/${parts[parts.length - 1]}`;
-  return `mutmutco/${await repoSlug()}`;
-}
-async function readDocsAuditFetch(repo) {
-  const list = await fetchDocsAuditList(registryClientDeps(await loadConfig()));
-  if ("notArmed" in list) return { notArmed: true };
-  if (!list.ok) return { ok: false, error: list.error };
-  const wanted = repo.toLowerCase();
-  const row = list.rows.find((r) => String(r.repo ?? "").toLowerCase() === wanted);
-  return {
-    ok: true,
-    verdict: row ? { repo: row.repo, date: row.date, shaRange: row.shaRange, outcome: row.outcome, checkerVendor: row.checkerVendor } : null
-  };
-}
 async function githubRepoReachProbe() {
   const remote = await execFileP2("git", ["remote", "get-url", "origin"], { timeout: GIT_TIMEOUT_MS }).then((r) => r.stdout).catch(() => "");
   const repo = parseOriginRepo(remote);
@@ -31694,6 +32146,7 @@ function mmiDoctorDeps(opts = {}) {
         worktreeRemoveDeps(async (args) => (await execFileP2("git", ["-c", "core.fsmonitor=false", ...args], { timeout: GIT_TIMEOUT_MS })).stdout),
         removalContext
       );
+      for (const removedPath of result.removed) await bestEffortLeaseClose(removedPath);
       return {
         removed: result.removed,
         stillQueued: result.stillDeferred.length,
@@ -32148,6 +32601,7 @@ gcCmd.command("sweep-deferred").description("retry IDE-locked deferred worktree
         worktreeRemoveDeps(async (args) => (await execFileP2("git", ["-c", "core.fsmonitor=false", ...args], { timeout: GIT_TIMEOUT_MS })).stdout),
         { removalContext }
       );
+      for (const removedPath of result.removed) await bestEffortLeaseClose(removedPath);
       if (o.json) return console.log(JSON.stringify(result));
       if (!o.quiet || result.removed.length || result.stillDeferred.length || result.skipped.length) {
         if (result.removed.length) console.log(`worktree gc sweep-deferred: removed ${result.removed.length} worktree(s)`);
@@ -32163,7 +32617,7 @@ gcCmd.command("sweep-deferred").description("retry IDE-locked deferred worktree
     process.exit(process.exitCode ?? 0);
   });
 });
-gcCmd.option("--dry-run", "show what would be deleted (default)").option("--apply", "delete only the listed clean merged/closed PR local+remote branches, linked worktrees, and stale tracking refs").option("--json", "machine-readable output").option("--scratch", "prune safe local scratch (#1864) instead of git branches/refs; local plans are surfaced advisory-only, never auto-pruned").option("--remote <name>", "remote name", "origin").option("--limit <n>", "PRs to inspect per state", "200").option("--force", "remove worktrees even when the ownership registry shows another session created or worked in them recently (#3580)").option("--root <path>", "sweep an explicitly named worktrees root instead of the authoritative ../mmi-worktrees (#3471) ? descends into this repo container when present; ownership, dead-dir, and content guards still apply").action(async (o) => {
+gcCmd.option("--dry-run", "show what would be deleted (default)").option("--apply", "delete only the listed clean merged/closed PR local+remote branches, linked worktrees, and stale tracking refs").option("--json", "machine-readable output").option("--scratch", "prune safe local scratch (#1864) instead of git branches/refs; local plans are surfaced advisory-only, never auto-pruned").option("--remote <name>", "remote name", "origin").option("--limit <n>", "PRs to read PER BRANCH ? an effort bound, not a correctness one: merge state is resolved per branch, so no branch is ever skipped for being old (#4227)", "200").option("--force", "remove worktrees even when the ownership registry shows another session created or worked in them recently (#3580)").option("--root <path>", "sweep an explicitly named worktrees root instead of the authoritative ../mmi-worktrees (#3471) ? descends into this repo container when present; ownership, dead-dir, and content guards still apply").action(async (o) => {
   if (o.apply && o.dryRun) return fail("worktree gc: choose either --dry-run or --apply");
   if (o.scratch) {
     try {
@@ -32195,13 +32649,14 @@ gcCmd.option("--dry-run", "show what would be deleted (default)").option("--appl
     if (o.apply) {
       const deferredStore = await createDeferredWorktreeStore();
       const removalContext = await currentWorktreeRemovalContext("worktree gc", o.force);
-      await sweepDeferredWorktrees(
+      const sweepResult = await sweepDeferredWorktrees(
         deferredStore,
         // #2841: same `-c core.fsmonitor=false` guard as the detached `gc sweep-deferred` worker ? keep a
         // git fsmonitor daemon from inheriting this sweep's stdio pipe and wedging the git call on Windows.
         worktreeRemoveDeps(async (args) => (await execFileP2("git", ["-c", "core.fsmonitor=false", ...args], { timeout: GIT_TIMEOUT_MS })).stdout),
         removalContext
       ).catch(() => void 0);
+      for (const removedPath of sweepResult?.removed ?? []) await bestEffortLeaseClose(removedPath);
       applyResult = await applyGcPlan(plan, o.remote, { root, force: o.force });
     }
     if (o.json) {
@@ -32222,11 +32677,11 @@ var WORKTREE_SETUP_LOCK_TTL_MS = 10 * 6e4;
 function runWorktreeInstall(command, cwd, quiet, opts) {
   const stdio = quiet ? "ignore" : "inherit";
   return new Promise((resolve5, reject) => {
-    const child2 = opts?.shell ? (0, import_node_child_process18.spawn)(command, { cwd, stdio, windowsHide: true, shell: true }) : (() => {
+    const child2 = opts?.shell ? (0, import_node_child_process19.spawn)(command, { cwd, stdio, windowsHide: true, shell: true }) : (() => {
       const [bin, ...args] = command.split(" ");
       const file = isWin2 ? "cmd.exe" : bin;
       const spawnArgs = isWin2 ? ["/c", bin, ...args] : args;
-      return (0, import_node_child_process18.spawn)(file, spawnArgs, { cwd, stdio, windowsHide: true });
+      return (0, import_node_child_process19.spawn)(file, spawnArgs, { cwd, stdio, windowsHide: true });
     })();
     const timer = setTimeout(() => {
       try {
@@ -32437,6 +32892,34 @@ withExamples(mutating(
     const owner = { path: wtPath, branch, createdAt, lastSeenAt: createdAt, actor: createActor };
     recordWorktreeOwner(repoRoot2, owner);
     appendWorktreeEvent(repoRoot2, { action: "created", command: "worktree create", target: wtPath, branch, actor: owner.actor });
+    let lease;
+    try {
+      await execFileP2("jerv-cli", [
+        "lease",
+        "open",
+        "--kind",
+        "worktree",
+        "--ref",
+        wtPath,
+        ...selector ? ["--repo", selector.repo] : [],
+        // 72h, not the 24h default: a feature worktree routinely sits untouched over a weekend, and
+        // an expired lease is what makes a CLEAN, unheld tree reapable. Erring long costs disk;
+        // erring short reaps a tree someone is still using between sessions.
+        "--ttl",
+        "72",
+        "--note",
+        `${branch} via mmi-cli worktree create`
+      ], { timeout: GIT_TIMEOUT_MS });
+      lease = { ok: true };
+    } catch (e) {
+      const detail = (e.stderr?.trim() || e.message.trim()).split("\n")[0];
+      lease = { ok: false, error: detail };
+      if (!o.json) {
+        console.error(
+          `  worktree created, but no jerv lease was opened for it: ${detail} \u2014 nothing on the lease plane can expire this tree, so it will need manual cleanup (MMI-Hub#4231).`
+        );
+      }
+    }
     if (o.json) {
       return console.log(JSON.stringify({
         branch,
@@ -32444,6 +32927,7 @@ withExamples(mutating(
         base,
         resumed,
         ...report,
+        lease,
         ...issueForm && selector ? { issue: `${selector.repo}#${selector.number}` } : {},
         ...issueForm && o.claim ? { claim: claimError ? { ok: false, error: claimError } : claim } : {}
       }, null, 2));
@@ -32555,7 +33039,7 @@ function scheduleRelatedDiscovery(o) {
   try {
     const args = ["issue", "discover-related", "--number", String(o.number), "--title", o.title, "--body", o.body, "--fail-soft"];
     if (o.repo) args.push("--repo", o.repo);
-    spawnDetachedSelf(args, { spawn: import_node_child_process18.spawn, execPath: process.execPath, scriptPath: process.argv[1] }, { cwd: process.cwd() });
+    spawnDetachedSelf(args, { spawn: import_node_child_process19.spawn, execPath: process.execPath, scriptPath: process.argv[1] }, { cwd: process.cwd() });
   } catch {
   }
 }
@@ -32883,48 +33367,6 @@ tests.command("policy").description("enforce this repo's test-policy.json agains
     await failGraceful(e.message);
   }
 });
-var docsAudit = program2.command("docs-audit").description("the docs janitor verdict ledger ? record a dated run verdict, or read the dead-man status back");
-docsAudit.command("record").description("write a dated janitor verdict for one repo to the registry ledger (master-only server-side)").option("--repo <owner/name>", "the repo the verdict is for (default: the current repo)").option("--date <YYYY-MM-DD>", "the ISO day the run examined (default: today)").requiredOption("--sha-range <a..b>", "the git range the janitor read (e.g. <lastVerdictSha>..HEAD)").addOption(new Option("--outcome <kind>", "clean | refreshed | failed").makeOptionMandatory().choices(["clean", "refreshed", "failed"])).option("--count <n>", "docs refreshed (required when --outcome refreshed)").option("--reason <text>", "why the run failed (required when --outcome failed)").requiredOption("--checker-vendor <vendor>", "which vendor's model actually ran the check").action(async (o) => {
-  try {
-    const repo = o.repo ?? await currentRepoFullName();
-    const date = o.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    let outcome;
-    if (o.outcome === "clean") outcome = { kind: "clean" };
-    else if (o.outcome === "refreshed") outcome = { kind: "refreshed", count: Number(o.count) };
-    else if (o.outcome === "failed") outcome = { kind: "failed", reason: o.reason ?? "" };
-    else return failGraceful(`docs audit record: --outcome must be clean|refreshed|failed, got "${o.outcome}"`);
-    const verdict = docsAuditRecord({ repo, date, shaRange: o.shaRange, outcome, checkerVendor: o.checkerVendor });
-    await reportWrite("docs-audit record", await recordDocsAudit(verdict, registryClientDeps(await loadConfig())));
-  } catch (e) {
-    await failGraceful(e.message);
-  }
-});
-docsAudit.command("status").description("read the janitor dead-man verdict back for one repo ? missing/stale/failed is RED; a not-yet-armed registry route is an informational exit 0").option("--repo <owner/name>", "the repo to check (default: the current repo)").option("--json", "machine-readable output ? the discrete state rather than the sentence").action(async (o) => {
-  try {
-    const repo = o.repo ?? await currentRepoFullName();
-    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const fetched = await readDocsAuditFetch(repo);
-    const result = docsAuditStatus(fetched, { repo, today });
-    if (o.json) {
-      const verdict = "ok" in fetched && fetched.ok ? fetched.verdict : null;
-      console.log(JSON.stringify({
-        repo,
-        armed: !("notArmed" in fetched),
-        ok: result.ok,
-        state: result.state,
-        date: verdict?.date ?? null,
-        outcome: verdict?.outcome ?? null,
-        checkerVendor: verdict?.checkerVendor ?? null,
-        line: result.line
-      }, null, 2));
-    } else {
-      console.log(result.line);
-    }
-    if (!result.ok) process.exitCode = 1;
-  } catch (e) {
-    await failGraceful(e.message);
-  }
-});
 async function reportWrite(label, res) {
   if (res.ok) {
     console.log(JSON.stringify(res.body));
@@ -33584,6 +34026,7 @@ withExamples(mutating(
     }
   }
   if (o.related !== false) scheduleRelatedDiscovery({ repo: o.repo, number: created.number, title, body });
+  invalidateStatuslineBoardCache();
   console.log(JSON.stringify({
     ...created,
     label: issueType,
@@ -33884,6 +34327,7 @@ withExamples(pr.command("create").description("create a PR and print {number,url
     return fail(`pr create: ${docsCheck.detail} ? ${docsCheck.fix}`);
   }
   const created = await ghCreate(buildPrArgs({ title, body, base: o.base, head: o.head, repo: o.repo, draft: o.draft }));
+  invalidateStatuslineBoardCache();
   console.log(JSON.stringify(created));
 }), [
   'mmi-cli pr create --title "Add the schema" --body "Closes #2680"',
@@ -34283,6 +34727,7 @@ jsonParity(pr.command("merge <number>").description("merge a PR (squash by defau
       preserveWorktree: o.preserveWorktree,
       removalContext
     });
+    if (localCleanup.worktree?.status === "removed") await bestEffortLeaseClose(localCleanup.worktree.path);
   } catch (e) {
     localCleanup = {
       branch: headRef,
@@ -34295,6 +34740,7 @@ jsonParity(pr.command("merge <number>").description("merge a PR (squash by defau
     };
   }
   const boardAdvance = await advanceClosedIssuesToDone2(number, repoForPostCleanup);
+  invalidateStatuslineBoardCache();
   console.log(JSON.stringify({
     ...buildPrMergeResultPayload({
       number,
@@ -34941,7 +35387,7 @@ program2.command("session-start").description("run the SessionStart verbs (whoam
   for (const line of scratchGcLines(process.cwd())) bannerIo.log(line);
   const worktreeBanner = worktreeAutoProvisionBanner(process.cwd());
   if (worktreeBanner) {
-    spawnDetachedSelf(["worktree", "setup", "--quiet"], { spawn: import_node_child_process18.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
+    spawnDetachedSelf(["worktree", "setup", "--quiet"], { spawn: import_node_child_process19.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
     bannerIo.log(worktreeBanner);
   }
   if (isLinkedWorktree(process.cwd())) {