npm - @seanyao/roll - Versions diffs - 3.625.1 → 3.625.2 - Mend

@seanyao/roll 3.625.1 → 3.625.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/roll.mjs CHANGED Viewed

@@ -3435,6 +3435,24 @@ function resolveRoute(tier, deps, nudge) {
     out3.warning = warning;
   return out3;
 }
+function resolveRouteExcluding(tier, deps, excluded) {
+  const ex = new Set(excluded.filter((a) => a !== ""));
+  const chain = tier === "default" ? ["default", "fallback"] : [tier, "default", "fallback"];
+  for (const slot of chain) {
+    const s = deps.readSlot(slot);
+    if (s?.agent !== void 0 && s.agent !== "" && !ex.has(s.agent)) {
+      const out3 = { agent: s.agent, tier };
+      if (s.model !== void 0 && s.model !== "")
+        out3.model = s.model;
+      return out3;
+    }
+  }
+  const first = deps.firstInstalled();
+  if (first !== void 0 && first !== "" && !ex.has(first)) {
+    return { agent: first, tier, warning: `agents.yaml: tier '${tier}' chain exhausted by exclusions; using first installed '${first}'` };
+  }
+  return null;
+}
 var EASY_MAX_MIN, HARD_MIN_MIN, SAMPLE_FLOOR;
 var init_router = __esm({
   "packages/core/dist/agent/router.js"() {
@@ -3813,26 +3831,26 @@ function floatOr(v) {
   const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : 0;
   return Number.isFinite(n) ? n : 0;
 }
-function toCycleCost(usage4, facts) {
+function toCycleCost(usage5, facts) {
   const tokens = {
-    input_tokens: usage4.input_tokens,
-    output_tokens: usage4.output_tokens,
-    cache_creation_tokens: usage4.cache_creation_tokens ?? 0,
-    cache_read_tokens: usage4.cache_read_tokens ?? 0
+    input_tokens: usage5.input_tokens,
+    output_tokens: usage5.output_tokens,
+    cache_creation_tokens: usage5.cache_creation_tokens ?? 0,
+    cache_read_tokens: usage5.cache_read_tokens ?? 0
   };
-  const estimatedCost = usage4.cost_list_usd ?? computeListCost(usage4.model, tokens);
+  const estimatedCost = usage5.cost_list_usd ?? computeListCost(usage5.model, tokens);
   const reverts = Math.max(0, Math.trunc(facts.revertCount));
   const effectiveCost = estimatedCost * (reverts + 1);
-  const cur = cycleCurrency(usage4.model);
+  const cur = cycleCurrency(usage5.model);
   return {
     cycleId: facts.cycleId,
     agent: facts.agent,
-    model: usage4.model,
-    tokensIn: usage4.input_tokens,
-    tokensOut: usage4.output_tokens,
+    model: usage5.model,
+    tokensIn: usage5.input_tokens,
+    tokensOut: usage5.output_tokens,
     // FIX-249: keep the cache split when the adapter reported one (absent ≠ 0).
-    ...usage4.cache_read_tokens !== void 0 ? { cacheRead: usage4.cache_read_tokens } : {},
-    ...usage4.cache_creation_tokens !== void 0 ? { cacheWrite: usage4.cache_creation_tokens } : {},
+    ...usage5.cache_read_tokens !== void 0 ? { cacheRead: usage5.cache_read_tokens } : {},
+    ...usage5.cache_creation_tokens !== void 0 ? { cacheWrite: usage5.cache_creation_tokens } : {},
     estimatedCost,
     revertCount: reverts,
     effectiveCost,
@@ -4004,12 +4022,12 @@ function peerReviewCost(peer, stdout) {
   try {
     const canon = canonicalAgentName(peer);
     const lines2 = stdout.split("\n");
-    const usage4 = extractUsage(canon, lines2);
-    if (usage4 === null)
+    const usage5 = extractUsage(canon, lines2);
+    if (usage5 === null)
       return 0;
-    if ((usage4.input_tokens ?? 0) === 0 && (usage4.output_tokens ?? 0) === 0)
+    if ((usage5.input_tokens ?? 0) === 0 && (usage5.output_tokens ?? 0) === 0)
       return 0;
-    const { estimatedCost } = toCycleCost(usage4, { cycleId: "pair", agent: canon, revertCount: 0 });
+    const { estimatedCost } = toCycleCost(usage5, { cycleId: "pair", agent: canon, revertCount: 0 });
     return Number.isFinite(estimatedCost) && estimatedCost > 0 ? estimatedCost : 0;
   } catch {
     return 0;
@@ -7704,6 +7722,19 @@ function cycleTimeoutVerdict(input) {
   const idleRemain = idle > 0 ? idle - input.idleSec : Number.POSITIVE_INFINITY;
   return { timedOut: false, remainingSec: Math.min(wallRemain, idleRemain) };
 }
+function stallVerdict(input) {
+  const threshold = input.stallThresholdSec ?? CYCLE_STALL_THRESHOLD_SEC;
+  const grace = input.startupGraceSec ?? STALL_STARTUP_GRACE_SEC;
+  if (threshold <= 0)
+    return { stalled: false };
+  if (input.alreadyFired)
+    return { stalled: false };
+  if (input.elapsedSec < grace)
+    return { stalled: false };
+  if (input.idleSec < threshold)
+    return { stalled: false };
+  return { stalled: true, idleSec: input.idleSec, thresholdSec: threshold };
+}
 function retryPlan(input) {
   const max = input.maxAttempts ?? MAX_AGENT_ATTEMPTS;
   const base = input.baseBackoffSec ?? RETRY_BASE_BACKOFF_SEC;
@@ -7945,7 +7976,7 @@ function cycleStartEvent(ctx, ts2 = 0) {
 function initialCycleState(ctx) {
   return { phase: "pick", ctx, attempt: 0, done: false };
 }
-var CYCLE_TIMEOUT_SEC, WATCHDOG_KILL_GRACE_SEC, CYCLE_WALL_TIMEOUT_SEC, CYCLE_NO_PROGRESS_SEC, MAX_AGENT_ATTEMPTS, RETRY_BASE_BACKOFF_SEC, EVENT_VALID_PHASES;
+var CYCLE_TIMEOUT_SEC, WATCHDOG_KILL_GRACE_SEC, CYCLE_WALL_TIMEOUT_SEC, CYCLE_NO_PROGRESS_SEC, CYCLE_STALL_THRESHOLD_SEC, STALL_STARTUP_GRACE_SEC, MAX_AGENT_ATTEMPTS, RETRY_BASE_BACKOFF_SEC, EVENT_VALID_PHASES;
 var init_orchestrator = __esm({
   "packages/core/dist/loop/orchestrator.js"() {
     "use strict";
@@ -7955,6 +7986,8 @@ var init_orchestrator = __esm({
     WATCHDOG_KILL_GRACE_SEC = 5;
     CYCLE_WALL_TIMEOUT_SEC = 2700;
     CYCLE_NO_PROGRESS_SEC = 900;
+    CYCLE_STALL_THRESHOLD_SEC = 600;
+    STALL_STARTUP_GRACE_SEC = 120;
     MAX_AGENT_ATTEMPTS = 3;
     RETRY_BASE_BACKOFF_SEC = 30;
     EVENT_VALID_PHASES = {
@@ -8306,6 +8339,73 @@ function watchRenderEventFromRollEvent(ev, mode = "events") {
         detail: [ev.path, ev.paused ? "paused" : ""].filter((v) => v !== "").join(" \xB7 "),
         severity: "muted"
       };
+    // ── FIX-934: pair:* event rendering ────────────────────────────────────
+    case "pair:selected":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:selected",
+        detail: `${text(ev.workingAgent)} \u2192 ${text(ev.peer)} (${text(ev.stage)})`,
+        severity: "normal"
+      };
+    case "pair:verdict":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:verdict",
+        detail: [ev.peer, ev.verdict, `${ev.findings} finding${ev.findings === 1 ? "" : "s"}`, ev.stage !== void 0 ? ev.stage : ""].filter((v) => v !== "").join(" \xB7 "),
+        severity: ev.verdict === "agree" ? "good" : ev.verdict === "object" ? "warn" : "normal"
+      };
+    case "pair:score":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:score",
+        detail: [ev.peer, String(ev.score), ev.verdict].join(" \xB7 "),
+        severity: ev.verdict === "good" ? "good" : ev.verdict === "regression" ? "bad" : "warn"
+      };
+    case "pair:consult": {
+      const durSec = (ev.durationMs / 1e3).toFixed(1);
+      const causeTag = ev.cause !== void 0 ? ` (${ev.cause})` : "";
+      return {
+        kind: "raw",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:consult",
+        detail: `${text(ev.peer)} \xB7 ${ev.outcome} \xB7 ${durSec}s${causeTag}`,
+        severity: ev.outcome === "reviewed" ? "good" : ev.outcome === "timeout" ? "warn" : "bad"
+      };
+    }
+    case "pair:none-available":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:none-available",
+        detail: `${text(ev.stage)} \xB7 ${text(ev.reason)}`,
+        severity: "warn"
+      };
+    case "pair:score-failure":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:score-failure",
+        detail: [ev.peer, ev.cause, ev.detail !== void 0 ? ev.detail : ""].filter((v) => v !== "").join(" \xB7 "),
+        severity: "bad"
+      };
+    case "pair:excluded":
+      return {
+        kind: "gate",
+        observedAt: eventTs(ev),
+        cycleId: ev.cycleId,
+        summary: "pair:excluded",
+        detail: `${text(ev.agent)} \xB7 ${ev.cause} \xB7 ${ev.failures} failure${ev.failures === 1 ? "" : "s"}`,
+        severity: "warn"
+      };
     default:
       return mode === "status" ? null : eventFromUnknown(ev);
   }
@@ -8399,6 +8499,24 @@ function signalLabel(ev) {
       return `${ev.type} #${ev.prNumber}`;
     case "alert:notify":
       return `alert ${clean2(ev.message)}`;
+    // ── FIX-934: pair:* signal labels ─────────────────────────────────────
+    case "pair:selected":
+      return `pair ${clean2(ev.workingAgent)} \u2192 ${clean2(ev.peer)} (${clean2(ev.stage)})`;
+    case "pair:verdict":
+      return `pair ${clean2(ev.peer)} ${ev.verdict} (${ev.findings} finding${ev.findings === 1 ? "" : "s"})`;
+    case "pair:score":
+      return `pair ${clean2(ev.peer)} ${ev.score} ${ev.verdict}`;
+    case "pair:consult": {
+      const durSec = (ev.durationMs / 1e3).toFixed(1);
+      const causeTag = ev.cause !== void 0 ? ` (${ev.cause})` : "";
+      return `pair ${clean2(ev.peer)} ${ev.outcome} ${durSec}s${causeTag}`;
+    }
+    case "pair:none-available":
+      return `pair ${clean2(ev.stage)} none-available`;
+    case "pair:score-failure":
+      return `pair ${clean2(ev.peer)} ${ev.cause}`;
+    case "pair:excluded":
+      return `pair ${clean2(ev.agent)} excluded ${ev.cause} (${ev.failures})`;
     default:
       return void 0;
   }
@@ -37442,7 +37560,7 @@ ${lanes.join("\n")}
             updateLineCountAndPosFor(s);
           }
         }
-        function write2(s) {
+        function write3(s) {
           if (s) hasTrailingComment = false;
           writeText(s);
         }
@@ -37467,7 +37585,7 @@ ${lanes.join("\n")}
         }
         function writeLiteral(s) {
           if (s && s.length) {
-            write2(s);
+            write3(s);
           }
         }
         function writeLine(force) {
@@ -37481,7 +37599,7 @@ ${lanes.join("\n")}
         }
         reset22();
         return {
-          write: write2,
+          write: write3,
           rawWrite,
           writeLiteral,
           writeLine,
@@ -37500,15 +37618,15 @@ ${lanes.join("\n")}
           hasTrailingComment: () => hasTrailingComment,
           hasTrailingWhitespace: () => !!output.length && isWhiteSpaceLike(output.charCodeAt(output.length - 1)),
           clear: reset22,
-          writeKeyword: write2,
-          writeOperator: write2,
-          writeParameter: write2,
-          writeProperty: write2,
-          writePunctuation: write2,
-          writeSpace: write2,
-          writeStringLiteral: write2,
-          writeSymbol: (s, _) => write2(s),
-          writeTrailingSemicolon: write2,
+          writeKeyword: write3,
+          writeOperator: write3,
+          writeParameter: write3,
+          writeProperty: write3,
+          writePunctuation: write3,
+          writeSpace: write3,
+          writeStringLiteral: write3,
+          writeSymbol: (s, _) => write3(s),
+          writeTrailingSemicolon: write3,
           writeComment
         };
       }
@@ -39738,34 +39856,34 @@ ${lanes.join("\n")}
         directories: directoriesMatcher,
         exclude: excludeMatcher
       };
-      function getRegularExpressionForWildcard(specs, basePath, usage4) {
-        const patterns = getRegularExpressionsForWildcards(specs, basePath, usage4);
+      function getRegularExpressionForWildcard(specs, basePath, usage5) {
+        const patterns = getRegularExpressionsForWildcards(specs, basePath, usage5);
         if (!patterns || !patterns.length) {
           return void 0;
         }
         const pattern = patterns.map((pattern2) => `(?:${pattern2})`).join("|");
-        const terminator = usage4 === "exclude" ? "(?:$|/)" : "$";
+        const terminator = usage5 === "exclude" ? "(?:$|/)" : "$";
         return `^(?:${pattern})${terminator}`;
       }
-      function getRegularExpressionsForWildcards(specs, basePath, usage4) {
+      function getRegularExpressionsForWildcards(specs, basePath, usage5) {
         if (specs === void 0 || specs.length === 0) {
           return void 0;
         }
-        return flatMap(specs, (spec) => spec && getSubPatternFromSpec(spec, basePath, usage4, wildcardMatchers[usage4]));
+        return flatMap(specs, (spec) => spec && getSubPatternFromSpec(spec, basePath, usage5, wildcardMatchers[usage5]));
       }
       function isImplicitGlob(lastPathComponent) {
         return !/[.*?]/.test(lastPathComponent);
       }
-      function getPatternFromSpec(spec, basePath, usage4) {
-        const pattern = spec && getSubPatternFromSpec(spec, basePath, usage4, wildcardMatchers[usage4]);
-        return pattern && `^(?:${pattern})${usage4 === "exclude" ? "(?:$|/)" : "$"}`;
+      function getPatternFromSpec(spec, basePath, usage5) {
+        const pattern = spec && getSubPatternFromSpec(spec, basePath, usage5, wildcardMatchers[usage5]);
+        return pattern && `^(?:${pattern})${usage5 === "exclude" ? "(?:$|/)" : "$"}`;
       }
-      function getSubPatternFromSpec(spec, basePath, usage4, { singleAsteriskRegexFragment, doubleAsteriskRegexFragment, replaceWildcardCharacter: replaceWildcardCharacter2 } = wildcardMatchers[usage4]) {
+      function getSubPatternFromSpec(spec, basePath, usage5, { singleAsteriskRegexFragment, doubleAsteriskRegexFragment, replaceWildcardCharacter: replaceWildcardCharacter2 } = wildcardMatchers[usage5]) {
         let subpattern = "";
         let hasWrittenComponent = false;
         const components = getNormalizedPathComponents(spec, basePath);
         const lastComponent = last(components);
-        if (usage4 !== "exclude" && lastComponent === "**") {
+        if (usage5 !== "exclude" && lastComponent === "**") {
           return void 0;
         }
         components[0] = removeTrailingDirectorySeparator(components[0]);
@@ -39777,14 +39895,14 @@ ${lanes.join("\n")}
           if (component === "**") {
             subpattern += doubleAsteriskRegexFragment;
           } else {
-            if (usage4 === "directories") {
+            if (usage5 === "directories") {
               subpattern += "(?:";
               optionalCount++;
             }
             if (hasWrittenComponent) {
               subpattern += directorySeparator;
             }
-            if (usage4 !== "exclude") {
+            if (usage5 !== "exclude") {
               let componentPattern = "";
               if (component.charCodeAt(0) === 42) {
                 componentPattern += "(?:[^./]" + singleAsteriskRegexFragment + ")?";
@@ -73082,27 +73200,27 @@ ${lanes.join("\n")}
           }
           return Debug.fail("There should exist two symbols, one as property declaration and one as parameter declaration");
         }
-        function isBlockScopedNameDeclaredBeforeUse(declaration, usage4) {
+        function isBlockScopedNameDeclaredBeforeUse(declaration, usage5) {
           const declarationFile = getSourceFileOfNode(declaration);
-          const useFile = getSourceFileOfNode(usage4);
+          const useFile = getSourceFileOfNode(usage5);
           const declContainer = getEnclosingBlockScopeContainer(declaration);
           if (declarationFile !== useFile) {
-            if (moduleKind && (declarationFile.externalModuleIndicator || useFile.externalModuleIndicator) || !compilerOptions.outFile || isInTypeQuery(usage4) || declaration.flags & 33554432) {
+            if (moduleKind && (declarationFile.externalModuleIndicator || useFile.externalModuleIndicator) || !compilerOptions.outFile || isInTypeQuery(usage5) || declaration.flags & 33554432) {
               return true;
             }
-            if (isUsedInFunctionOrInstanceProperty(usage4, declaration)) {
+            if (isUsedInFunctionOrInstanceProperty(usage5, declaration)) {
               return true;
             }
             const sourceFiles = host.getSourceFiles();
             return sourceFiles.indexOf(declarationFile) <= sourceFiles.indexOf(useFile);
           }
-          if (!!(usage4.flags & 16777216) || isInTypeQuery(usage4) || isInAmbientOrTypeNode(usage4)) {
+          if (!!(usage5.flags & 16777216) || isInTypeQuery(usage5) || isInAmbientOrTypeNode(usage5)) {
             return true;
           }
-          if (declaration.pos <= usage4.pos && !(isPropertyDeclaration(declaration) && isThisProperty(usage4.parent) && !declaration.initializer && !declaration.exclamationToken)) {
+          if (declaration.pos <= usage5.pos && !(isPropertyDeclaration(declaration) && isThisProperty(usage5.parent) && !declaration.initializer && !declaration.exclamationToken)) {
             if (declaration.kind === 209) {
               const errorBindingElement = getAncestor(
-                usage4,
+                usage5,
                 209
                 /* BindingElement */
               );
@@ -73113,41 +73231,41 @@ ${lanes.join("\n")}
                 declaration,
                 261
                 /* VariableDeclaration */
-              ), usage4);
+              ), usage5);
             } else if (declaration.kind === 261) {
-              return !isImmediatelyUsedInInitializerOfBlockScopedVariable(declaration, usage4);
+              return !isImmediatelyUsedInInitializerOfBlockScopedVariable(declaration, usage5);
             } else if (isClassLike(declaration)) {
-              const container = findAncestor(usage4, (n) => n === declaration ? "quit" : isComputedPropertyName(n) ? n.parent.parent === declaration : !legacyDecorators && isDecorator(n) && (n.parent === declaration || isMethodDeclaration(n.parent) && n.parent.parent === declaration || isGetOrSetAccessorDeclaration(n.parent) && n.parent.parent === declaration || isPropertyDeclaration(n.parent) && n.parent.parent === declaration || isParameter(n.parent) && n.parent.parent.parent === declaration));
+              const container = findAncestor(usage5, (n) => n === declaration ? "quit" : isComputedPropertyName(n) ? n.parent.parent === declaration : !legacyDecorators && isDecorator(n) && (n.parent === declaration || isMethodDeclaration(n.parent) && n.parent.parent === declaration || isGetOrSetAccessorDeclaration(n.parent) && n.parent.parent === declaration || isPropertyDeclaration(n.parent) && n.parent.parent === declaration || isParameter(n.parent) && n.parent.parent.parent === declaration));
               if (!container) {
                 return true;
               }
               if (!legacyDecorators && isDecorator(container)) {
-                return !!findAncestor(usage4, (n) => n === container ? "quit" : isFunctionLike2(n) && !getImmediatelyInvokedFunctionExpression(n));
+                return !!findAncestor(usage5, (n) => n === container ? "quit" : isFunctionLike2(n) && !getImmediatelyInvokedFunctionExpression(n));
               }
               return false;
             } else if (isPropertyDeclaration(declaration)) {
               return !isPropertyImmediatelyReferencedWithinDeclaration(
                 declaration,
-                usage4,
+                usage5,
                 /*stopAtAnyPropertyDeclaration*/
                 false
               );
             } else if (isParameterPropertyDeclaration(declaration, declaration.parent)) {
-              return !(emitStandardClassFields && getContainingClass(declaration) === getContainingClass(usage4) && isUsedInFunctionOrInstanceProperty(usage4, declaration));
+              return !(emitStandardClassFields && getContainingClass(declaration) === getContainingClass(usage5) && isUsedInFunctionOrInstanceProperty(usage5, declaration));
             }
             return true;
           }
-          if (usage4.parent.kind === 282 || usage4.parent.kind === 278 && usage4.parent.isExportEquals) {
+          if (usage5.parent.kind === 282 || usage5.parent.kind === 278 && usage5.parent.isExportEquals) {
             return true;
           }
-          if (usage4.kind === 278 && usage4.isExportEquals) {
+          if (usage5.kind === 278 && usage5.isExportEquals) {
             return true;
           }
-          if (isUsedInFunctionOrInstanceProperty(usage4, declaration)) {
+          if (isUsedInFunctionOrInstanceProperty(usage5, declaration)) {
             if (emitStandardClassFields && getContainingClass(declaration) && (isPropertyDeclaration(declaration) || isParameterPropertyDeclaration(declaration, declaration.parent))) {
               return !isPropertyImmediatelyReferencedWithinDeclaration(
                 declaration,
-                usage4,
+                usage5,
                 /*stopAtAnyPropertyDeclaration*/
                 true
               );
@@ -73753,19 +73871,19 @@ ${lanes.join("\n")}
             /* Default */
           ) || isExportSpecifier(node) || isNamespaceExport(node);
         }
-        function getEmitSyntaxForModuleSpecifierExpression(usage4) {
-          return isStringLiteralLike(usage4) ? host.getEmitSyntaxForUsageLocation(getSourceFileOfNode(usage4), usage4) : void 0;
+        function getEmitSyntaxForModuleSpecifierExpression(usage5) {
+          return isStringLiteralLike(usage5) ? host.getEmitSyntaxForUsageLocation(getSourceFileOfNode(usage5), usage5) : void 0;
         }
         function isESMFormatImportImportingCommonjsFormatFile(usageMode, targetMode) {
           return usageMode === 99 && targetMode === 1;
         }
-        function isOnlyImportableAsDefault(usage4, resolvedModule) {
+        function isOnlyImportableAsDefault(usage5, resolvedModule) {
           if (100 <= moduleKind && moduleKind <= 199) {
-            const usageMode = getEmitSyntaxForModuleSpecifierExpression(usage4);
+            const usageMode = getEmitSyntaxForModuleSpecifierExpression(usage5);
             if (usageMode === 99) {
               resolvedModule ?? (resolvedModule = resolveExternalModuleName(
-                usage4,
-                usage4,
+                usage5,
+                usage5,
                 /*ignoreErrors*/
                 true
               ));
@@ -73775,8 +73893,8 @@ ${lanes.join("\n")}
           }
           return false;
         }
-        function canHaveSyntheticDefault(file, moduleSymbol, dontResolveAlias, usage4) {
-          const usageMode = file && getEmitSyntaxForModuleSpecifierExpression(usage4);
+        function canHaveSyntheticDefault(file, moduleSymbol, dontResolveAlias, usage5) {
+          const usageMode = file && getEmitSyntaxForModuleSpecifierExpression(usage5);
           if (file && usageMode !== void 0) {
             const targetMode = host.getImpliedNodeFormatForEmit(file);
             if (usageMode === 99 && targetMode === 1 && 100 <= moduleKind && moduleKind <= 199) {
@@ -147375,7 +147493,7 @@ ${lanes.join("\n")}
         var nextListElementPos;
         var writer;
         var ownWriter;
-        var write2 = writeBase;
+        var write3 = writeBase;
         var isOwnFileEmit;
         var sourceMapsDisabled = true;
         var sourceMapGenerator;
@@ -148233,7 +148351,7 @@ ${lanes.join("\n")}
           nonEscapingWrite(`$${snippet.order}`);
         }
         function emitIdentifier(node) {
-          const writeText = node.symbol ? writeSymbol : write2;
+          const writeText = node.symbol ? writeSymbol : write3;
           writeText(getTextOfNode2(
             node,
             /*includeTrivia*/
@@ -148247,7 +148365,7 @@ ${lanes.join("\n")}
           );
         }
         function emitPrivateIdentifier(node) {
-          write2(getTextOfNode2(
+          write3(getTextOfNode2(
             node,
             /*includeTrivia*/
             false
@@ -150108,7 +150226,7 @@ ${lanes.join("\n")}
           emitInitializer(node.initializer, node.name.end, node, parenthesizer.parenthesizeExpressionForDisallowedComma);
         }
         function emitJSDoc(node) {
-          write2("/**");
+          write3("/**");
           if (node.comment) {
             const text2 = getTextOfJSDocComment(node.comment);
             if (text2) {
@@ -150118,7 +150236,7 @@ ${lanes.join("\n")}
                 writeSpace();
                 writePunctuation("*");
                 writeSpace();
-                write2(line);
+                write3(line);
               }
             }
           }
@@ -150136,7 +150254,7 @@ ${lanes.join("\n")}
             }
           }
           writeSpace();
-          write2("*/");
+          write3("*/");
         }
         function emitJSDocSimpleTypedTag(tag) {
           emitJSDocTagName(tag.tagName);
@@ -150197,7 +150315,7 @@ ${lanes.join("\n")}
             } else {
               writeSpace();
               writePunctuation("{");
-              write2("Object");
+              write3("Object");
               if (tag.typeExpression.isArrayType) {
                 writePunctuation("[");
                 writePunctuation("]");
@@ -150285,7 +150403,7 @@ ${lanes.join("\n")}
           const text2 = getTextOfJSDocComment(comment);
           if (text2) {
             writeSpace();
-            write2(text2);
+            write3(text2);
           }
         }
         function emitJSDocTypeExpression(typeExpression) {
@@ -150427,10 +150545,10 @@ ${lanes.join("\n")}
         }
         function emitNodeWithWriter(node, writer2) {
           if (!node) return;
-          const savedWrite = write2;
-          write2 = writer2;
+          const savedWrite = write3;
+          write3 = writer2;
           emit4(node);
-          write2 = savedWrite;
+          write3 = savedWrite;
         }
         function emitDecoratorsAndModifiers(node, modifiers, allowDecorators) {
           if (modifiers == null ? void 0 : modifiers.length) {
@@ -150864,7 +150982,7 @@ ${lanes.join("\n")}
             const line = indentation ? lineText.slice(indentation) : lineText;
             if (line.length) {
               writeLine();
-              write2(line);
+              write3(line);
             }
           }
         }
@@ -152985,43 +153103,43 @@ ${lanes.join("\n")}
         }
         return false;
       }
-      function getModeForUsageLocation(file, usage4, compilerOptions) {
-        return getModeForUsageLocationWorker(file, usage4, compilerOptions);
+      function getModeForUsageLocation(file, usage5, compilerOptions) {
+        return getModeForUsageLocationWorker(file, usage5, compilerOptions);
       }
-      function getModeForUsageLocationWorker(file, usage4, compilerOptions) {
-        if (isImportDeclaration2(usage4.parent) || isExportDeclaration2(usage4.parent) || isJSDocImportTag(usage4.parent)) {
-          const isTypeOnly = isExclusivelyTypeOnlyImportOrExport(usage4.parent);
+      function getModeForUsageLocationWorker(file, usage5, compilerOptions) {
+        if (isImportDeclaration2(usage5.parent) || isExportDeclaration2(usage5.parent) || isJSDocImportTag(usage5.parent)) {
+          const isTypeOnly = isExclusivelyTypeOnlyImportOrExport(usage5.parent);
           if (isTypeOnly) {
-            const override = getResolutionModeOverride(usage4.parent.attributes);
+            const override = getResolutionModeOverride(usage5.parent.attributes);
             if (override) {
               return override;
             }
           }
         }
-        if (usage4.parent.parent && isImportTypeNode(usage4.parent.parent)) {
-          const override = getResolutionModeOverride(usage4.parent.parent.attributes);
+        if (usage5.parent.parent && isImportTypeNode(usage5.parent.parent)) {
+          const override = getResolutionModeOverride(usage5.parent.parent.attributes);
           if (override) {
             return override;
           }
         }
         if (compilerOptions && importSyntaxAffectsModuleResolution(compilerOptions)) {
-          return getEmitSyntaxForUsageLocationWorker(file, usage4, compilerOptions);
+          return getEmitSyntaxForUsageLocationWorker(file, usage5, compilerOptions);
         }
       }
-      function getEmitSyntaxForUsageLocationWorker(file, usage4, compilerOptions) {
+      function getEmitSyntaxForUsageLocationWorker(file, usage5, compilerOptions) {
         var _a;
         if (!compilerOptions) {
           return void 0;
         }
-        const exprParentParent = (_a = walkUpParenthesizedExpressions(usage4.parent)) == null ? void 0 : _a.parent;
+        const exprParentParent = (_a = walkUpParenthesizedExpressions(usage5.parent)) == null ? void 0 : _a.parent;
         if (exprParentParent && isImportEqualsDeclaration(exprParentParent) || isRequireCall(
-          usage4.parent,
+          usage5.parent,
           /*requireStringLiteralLikeArgument*/
           false
         )) {
           return 1;
         }
-        if (isImportCall(walkUpParenthesizedExpressions(usage4.parent))) {
+        if (isImportCall(walkUpParenthesizedExpressions(usage5.parent))) {
           return shouldTransformImportCallWorker(file, compilerOptions) ? 1 : 99;
         }
         const fileEmitMode = getEmitModuleFormatOfFileWorker(file, compilerOptions);
@@ -156253,11 +156371,11 @@ ${lanes.join("\n")}
           }
           return symlinks;
         }
-        function getModeForUsageLocation2(file, usage4) {
-          return getModeForUsageLocationWorker(file, usage4, getCompilerOptionsForFile(file));
+        function getModeForUsageLocation2(file, usage5) {
+          return getModeForUsageLocationWorker(file, usage5, getCompilerOptionsForFile(file));
         }
-        function getEmitSyntaxForUsageLocation(file, usage4) {
-          return getEmitSyntaxForUsageLocationWorker(file, usage4, getCompilerOptionsForFile(file));
+        function getEmitSyntaxForUsageLocation(file, usage5) {
+          return getEmitSyntaxForUsageLocationWorker(file, usage5, getCompilerOptionsForFile(file));
         }
         function getModeForResolutionAtIndex2(file, index) {
           return getModeForUsageLocation2(file, getModuleNameStringLiteralAt(file, index));
@@ -160100,24 +160218,24 @@ ${lanes.join("\n")}
       function isBuilderProgram(program) {
         return !!program.state;
       }
-      function listFiles3(program, write2) {
+      function listFiles3(program, write3) {
         const options = program.getCompilerOptions();
         if (options.explainFiles) {
-          explainFiles(isBuilderProgram(program) ? program.getProgram() : program, write2);
+          explainFiles(isBuilderProgram(program) ? program.getProgram() : program, write3);
         } else if (options.listFiles || options.listFilesOnly) {
           forEach(program.getSourceFiles(), (file) => {
-            write2(file.fileName);
+            write3(file.fileName);
           });
         }
       }
-      function explainFiles(program, write2) {
+      function explainFiles(program, write3) {
         var _a, _b;
         const reasons = program.getFileIncludeReasons();
         const relativeFileName = (fileName) => convertToRelativePath(fileName, program.getCurrentDirectory(), program.getCanonicalFileName);
         for (const file of program.getSourceFiles()) {
-          write2(`${toFileName(file, relativeFileName)}`);
-          (_a = reasons.get(file.path)) == null ? void 0 : _a.forEach((reason) => write2(`  ${fileIncludeReasonToDiagnostics(program, reason, relativeFileName).messageText}`));
-          (_b = explainIfFileIsRedirectAndImpliedFormat(file, program.getCompilerOptionsForFile(file), relativeFileName)) == null ? void 0 : _b.forEach((d) => write2(`  ${d.messageText}`));
+          write3(`${toFileName(file, relativeFileName)}`);
+          (_a = reasons.get(file.path)) == null ? void 0 : _a.forEach((reason) => write3(`  ${fileIncludeReasonToDiagnostics(program, reason, relativeFileName).messageText}`));
+          (_b = explainIfFileIsRedirectAndImpliedFormat(file, program.getCompilerOptionsForFile(file), relativeFileName)) == null ? void 0 : _b.forEach((d) => write3(`  ${d.messageText}`));
         }
       }
       function explainIfFileIsRedirectAndImpliedFormat(file, options, fileNameConvertor) {
@@ -160315,7 +160433,7 @@ ${lanes.join("\n")}
         const fileName = isString(file) ? file : file.fileName;
         return fileNameConvertor ? fileNameConvertor(fileName) : fileName;
       }
-      function emitFilesAndReportErrors(program, reportDiagnostic, write2, reportSummary, writeFile22, cancellationToken, emitOnlyDtsFiles, customTransformers) {
+      function emitFilesAndReportErrors(program, reportDiagnostic, write3, reportSummary, writeFile22, cancellationToken, emitOnlyDtsFiles, customTransformers) {
         const options = program.getCompilerOptions();
         const allDiagnostics = program.getConfigFileParsingDiagnostics().slice();
         const configFileParsingDiagnosticsLength = allDiagnostics.length;
@@ -160355,13 +160473,13 @@ ${lanes.join("\n")}
         addRange(allDiagnostics, emitResult.diagnostics);
         const diagnostics = sortAndDeduplicateDiagnostics(allDiagnostics);
         diagnostics.forEach(reportDiagnostic);
-        if (write2) {
+        if (write3) {
           const currentDir = program.getCurrentDirectory();
           forEach(emitResult.emittedFiles, (file) => {
             const filepath = getNormalizedAbsolutePath(file, currentDir);
-            write2(`TSFILE: ${filepath}`);
+            write3(`TSFILE: ${filepath}`);
           });
-          listFiles3(program, write2);
+          listFiles3(program, write3);
         }
         if (reportSummary) {
           reportSummary(getErrorCountForSummary(diagnostics), getFilesInErrorForSummary(diagnostics));
@@ -160371,11 +160489,11 @@ ${lanes.join("\n")}
           diagnostics
         };
       }
-      function emitFilesAndReportErrorsAndGetExitStatus(program, reportDiagnostic, write2, reportSummary, writeFile22, cancellationToken, emitOnlyDtsFiles, customTransformers) {
+      function emitFilesAndReportErrorsAndGetExitStatus(program, reportDiagnostic, write3, reportSummary, writeFile22, cancellationToken, emitOnlyDtsFiles, customTransformers) {
         const { emitResult, diagnostics } = emitFilesAndReportErrors(
           program,
           reportDiagnostic,
-          write2,
+          write3,
           reportSummary,
           writeFile22,
           cancellationToken,
@@ -160533,7 +160651,7 @@ ${lanes.join("\n")}
         };
       }
       function createWatchCompilerHost(system = sys2, createProgram22, reportDiagnostic, reportWatchStatus2) {
-        const write2 = (s) => system.write(s + system.newLine);
+        const write3 = (s) => system.write(s + system.newLine);
         const result = createProgramHost(system, createProgram22);
         copyProperties(result, createWatchHost(system, reportWatchStatus2));
         result.afterProgramCreate = (builderProgram) => {
@@ -160542,7 +160660,7 @@ ${lanes.join("\n")}
           emitFilesAndReportErrors(
             builderProgram,
             reportDiagnostic,
-            write2,
+            write3,
             (errorCount) => result.onWatchStatusChange(
               createCompilerDiagnostic(getWatchErrorSummaryDiagnosticMessage(errorCount), errorCount),
               newLine,
@@ -174564,23 +174682,23 @@ interface Symbol {
           addNewFileToTsconfig(program, changes, oldFile.fileName, targetFile, hostGetCanonicalFileName(host));
         }
       }
-      function getNewStatementsAndRemoveFromOldFile(oldFile, targetFile, usage4, changes, toMove, program, host, preferences, importAdderForNewFile, importAdderForOldFile) {
+      function getNewStatementsAndRemoveFromOldFile(oldFile, targetFile, usage5, changes, toMove, program, host, preferences, importAdderForNewFile, importAdderForOldFile) {
         const checker = program.getTypeChecker();
         const prologueDirectives = takeWhile(oldFile.statements, isPrologueDirective);
         const useEsModuleSyntax = !fileShouldUseJavaScriptRequire(targetFile.fileName, program, host, !!oldFile.commonJsModuleIndicator);
         const quotePreference = getQuotePreference(oldFile, preferences);
-        addImportsForMovedSymbols(usage4.oldFileImportsFromTargetFile, targetFile.fileName, importAdderForOldFile, program);
-        deleteUnusedOldImports(oldFile, toMove.all, usage4.unusedImportsFromOldFile, importAdderForOldFile);
+        addImportsForMovedSymbols(usage5.oldFileImportsFromTargetFile, targetFile.fileName, importAdderForOldFile, program);
+        deleteUnusedOldImports(oldFile, toMove.all, usage5.unusedImportsFromOldFile, importAdderForOldFile);
         importAdderForOldFile.writeFixes(changes, quotePreference);
         deleteMovedStatements(oldFile, toMove.ranges, changes);
-        updateImportsInOtherFiles(changes, program, host, oldFile, usage4.movedSymbols, targetFile.fileName, quotePreference);
-        addExportsInOldFile(oldFile, usage4.targetFileImportsFromOldFile, changes, useEsModuleSyntax);
-        addTargetFileImports(oldFile, usage4.oldImportsNeededByTargetFile, usage4.targetFileImportsFromOldFile, checker, program, importAdderForNewFile);
+        updateImportsInOtherFiles(changes, program, host, oldFile, usage5.movedSymbols, targetFile.fileName, quotePreference);
+        addExportsInOldFile(oldFile, usage5.targetFileImportsFromOldFile, changes, useEsModuleSyntax);
+        addTargetFileImports(oldFile, usage5.oldImportsNeededByTargetFile, usage5.targetFileImportsFromOldFile, checker, program, importAdderForNewFile);
         if (!isFullSourceFile(targetFile) && prologueDirectives.length) {
           changes.insertStatementsInNewFile(targetFile.fileName, prologueDirectives, oldFile);
         }
         importAdderForNewFile.writeFixes(changes, quotePreference);
-        const body = addExports(oldFile, toMove.all, arrayFrom(usage4.oldFileImportsFromTargetFile.keys()), useEsModuleSyntax);
+        const body = addExports(oldFile, toMove.all, arrayFrom(usage5.oldFileImportsFromTargetFile.keys()), useEsModuleSyntax);
         if (isFullSourceFile(targetFile) && targetFile.statements.length > 0) {
           moveStatementsToTargetFile(changes, program, body, targetFile, toMove);
         } else if (isFullSourceFile(targetFile)) {
@@ -174999,7 +175117,7 @@ interface Symbol {
       function createNewFileName(oldFile, program, host, toMove) {
         const checker = program.getTypeChecker();
         if (toMove) {
-          const usage4 = getUsageInfo(oldFile, toMove.all, checker);
+          const usage5 = getUsageInfo(oldFile, toMove.all, checker);
           const currentDirectory = getDirectoryPath(oldFile.fileName);
           const extension = extensionFromPath(oldFile.fileName);
           const newFileName = combinePaths(
@@ -175008,7 +175126,7 @@ interface Symbol {
             // ensures the filename computed below isn't already taken
             makeUniqueFilename(
               // infers a name for the new file from the symbols being moved
-              inferNewFileName(usage4.oldFileImportsFromTargetFile, usage4.movedSymbols),
+              inferNewFileName(usage5.oldFileImportsFromTargetFile, usage5.movedSymbols),
               extension,
               currentDirectory,
               host
@@ -175579,12 +175697,12 @@ interface Symbol {
       });
       function doChange4(oldFile, program, toMove, changes, host, context, preferences) {
         const checker = program.getTypeChecker();
-        const usage4 = getUsageInfo(oldFile, toMove.all, checker);
+        const usage5 = getUsageInfo(oldFile, toMove.all, checker);
         const newFilename = createNewFileName(oldFile, program, host, toMove);
         const newSourceFile = createFutureSourceFile(newFilename, oldFile.externalModuleIndicator ? 99 : oldFile.commonJsModuleIndicator ? 1 : void 0, program, host);
         const importAdderForOldFile = ts_codefix_exports.createImportAdder(oldFile, context.program, context.preferences, context.host);
         const importAdderForNewFile = ts_codefix_exports.createImportAdder(newSourceFile, context.program, context.preferences, context.host);
-        getNewStatementsAndRemoveFromOldFile(oldFile, newSourceFile, usage4, changes, toMove, program, host, preferences, importAdderForNewFile, importAdderForOldFile);
+        getNewStatementsAndRemoveFromOldFile(oldFile, newSourceFile, usage5, changes, toMove, program, host, preferences, importAdderForNewFile, importAdderForOldFile);
         addNewFileToTsconfig(program, changes, oldFile.fileName, newFilename, hostGetCanonicalFileName(host));
       }
       var ts_refactor_addOrRemoveBracesToArrowFunction_exports = {};
@@ -177768,10 +177886,10 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
         const parameters = [];
         const callArguments = [];
         let writes;
-        usagesInScope.forEach((usage4, name) => {
+        usagesInScope.forEach((usage5, name) => {
           let typeNode;
           if (!isJS) {
-            let type = checker.getTypeOfSymbolAtLocation(usage4.symbol, usage4.node);
+            let type = checker.getTypeOfSymbolAtLocation(usage5.symbol, usage5.node);
             type = checker.getBaseTypeOfLiteralType(type);
             typeNode = ts_codefix_exports.typeToAutoImportableTypeNode(
               checker,
@@ -177796,8 +177914,8 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             typeNode
           );
           parameters.push(paramDecl);
-          if (usage4.usage === 2) {
-            (writes || (writes = [])).push(usage4);
+          if (usage5.usage === 2) {
+            (writes || (writes = [])).push(usage5);
           }
           callArguments.push(factory.createIdentifier(name));
         });
@@ -178681,8 +178799,8 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             forEachChild2(node, collectUsages);
           }
         }
-        function recordUsage(n, usage4, isTypeNode2) {
-          const symbolId = recordUsagebySymbol(n, usage4, isTypeNode2);
+        function recordUsage(n, usage5, isTypeNode2) {
+          const symbolId = recordUsagebySymbol(n, usage5, isTypeNode2);
           if (symbolId) {
             for (let i = 0; i < scopes.length; i++) {
               const substitution = substitutionsPerScope[i].get(symbolId);
@@ -178692,22 +178810,22 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             }
           }
         }
-        function recordUsagebySymbol(identifier, usage4, isTypeName) {
+        function recordUsagebySymbol(identifier, usage5, isTypeName) {
           const symbol = getSymbolReferencedByIdentifier(identifier);
           if (!symbol) {
             return void 0;
           }
           const symbolId = getSymbolId(symbol).toString();
           const lastUsage = seenUsages.get(symbolId);
-          if (lastUsage && lastUsage >= usage4) {
+          if (lastUsage && lastUsage >= usage5) {
             return symbolId;
           }
-          seenUsages.set(symbolId, usage4);
+          seenUsages.set(symbolId, usage5);
           if (lastUsage) {
             for (const perScope of usagesPerScope) {
               const prevEntry = perScope.usages.get(identifier.text);
               if (prevEntry) {
-                perScope.usages.set(identifier.text, { usage: usage4, symbol, node: identifier });
+                perScope.usages.set(identifier.text, { usage: usage5, symbol, node: identifier });
               }
             }
             return symbolId;
@@ -178720,7 +178838,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           if (rangeContainsStartEnd(enclosingTextRange, declInFile.getStart(), declInFile.end)) {
             return void 0;
           }
-          if (targetRange.facts & 2 && usage4 === 2) {
+          if (targetRange.facts & 2 && usage5 === 2) {
             const diag2 = createDiagnosticForNode(identifier, Messages.cannotExtractRangeThatContainsWritesToReferencesLocatedOutsideOfTheTargetRangeInGenerators);
             for (const errors of functionErrorsPerScope) {
               errors.push(diag2);
@@ -178752,7 +178870,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
                   constantErrorsPerScope[i].push(diag2);
                 }
               } else {
-                usagesPerScope[i].usages.set(identifier.text, { usage: usage4, symbol, node: identifier });
+                usagesPerScope[i].usages.set(identifier.text, { usage: usage5, symbol, node: identifier });
               }
             }
           }
@@ -185470,9 +185588,9 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
         }
         const checker = program.getTypeChecker();
         for (const specifier2 of nonTypeOnlySpecifiers) {
-          const isUsedAsValue = ts_FindAllReferences_exports.Core.eachSymbolReferenceInFile(specifier2.name, checker, sourceFile, (usage4) => {
-            const symbol = checker.getSymbolAtLocation(usage4);
-            return !!symbol && checker.symbolIsValue(symbol) || !isValidTypeOnlyAliasUseSite(usage4);
+          const isUsedAsValue = ts_FindAllReferences_exports.Core.eachSymbolReferenceInFile(specifier2.name, checker, sourceFile, (usage5) => {
+            const symbol = checker.getSymbolAtLocation(usage5);
+            return !!symbol && checker.symbolIsValue(symbol) || !isValidTypeOnlyAliasUseSite(usage5);
           });
           if (isUsedAsValue) {
             return false;
@@ -192118,12 +192236,12 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           if (references.length === 0 || !declaration.parameters) {
             return void 0;
           }
-          const usage4 = createEmptyUsage();
+          const usage5 = createEmptyUsage();
           for (const reference of references) {
             cancellationToken.throwIfCancellationRequested();
-            calculateUsageOfNode(reference, usage4);
+            calculateUsageOfNode(reference, usage5);
           }
-          const calls = [...usage4.constructs || [], ...usage4.calls || []];
+          const calls = [...usage5.constructs || [], ...usage5.calls || []];
           return declaration.parameters.map((parameter, parameterIndex) => {
             const types = [];
             const isRest = isRestParameter(parameter);
@@ -192153,99 +192271,99 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           });
         }
         function thisParameter() {
-          const usage4 = createEmptyUsage();
+          const usage5 = createEmptyUsage();
           for (const reference of references) {
             cancellationToken.throwIfCancellationRequested();
-            calculateUsageOfNode(reference, usage4);
+            calculateUsageOfNode(reference, usage5);
           }
-          return combineTypes(usage4.candidateThisTypes || emptyArray);
+          return combineTypes(usage5.candidateThisTypes || emptyArray);
         }
         function inferTypesFromReferencesSingle(references2) {
-          const usage4 = createEmptyUsage();
+          const usage5 = createEmptyUsage();
           for (const reference of references2) {
             cancellationToken.throwIfCancellationRequested();
-            calculateUsageOfNode(reference, usage4);
+            calculateUsageOfNode(reference, usage5);
           }
-          return inferTypes(usage4);
+          return inferTypes(usage5);
         }
-        function calculateUsageOfNode(node, usage4) {
+        function calculateUsageOfNode(node, usage5) {
           while (isRightSideOfQualifiedNameOrPropertyAccess(node)) {
             node = node.parent;
           }
           switch (node.parent.kind) {
             case 245:
-              inferTypeFromExpressionStatement(node, usage4);
+              inferTypeFromExpressionStatement(node, usage5);
               break;
             case 226:
-              usage4.isNumber = true;
+              usage5.isNumber = true;
               break;
             case 225:
-              inferTypeFromPrefixUnaryExpression(node.parent, usage4);
+              inferTypeFromPrefixUnaryExpression(node.parent, usage5);
               break;
             case 227:
-              inferTypeFromBinaryExpression(node, node.parent, usage4);
+              inferTypeFromBinaryExpression(node, node.parent, usage5);
               break;
             case 297:
             case 298:
-              inferTypeFromSwitchStatementLabel(node.parent, usage4);
+              inferTypeFromSwitchStatementLabel(node.parent, usage5);
               break;
             case 214:
             case 215:
               if (node.parent.expression === node) {
-                inferTypeFromCallExpression(node.parent, usage4);
+                inferTypeFromCallExpression(node.parent, usage5);
               } else {
-                inferTypeFromContextualType(node, usage4);
+                inferTypeFromContextualType(node, usage5);
               }
               break;
             case 212:
-              inferTypeFromPropertyAccessExpression(node.parent, usage4);
+              inferTypeFromPropertyAccessExpression(node.parent, usage5);
               break;
             case 213:
-              inferTypeFromPropertyElementExpression(node.parent, node, usage4);
+              inferTypeFromPropertyElementExpression(node.parent, node, usage5);
               break;
             case 304:
             case 305:
-              inferTypeFromPropertyAssignment(node.parent, usage4);
+              inferTypeFromPropertyAssignment(node.parent, usage5);
               break;
             case 173:
-              inferTypeFromPropertyDeclaration(node.parent, usage4);
+              inferTypeFromPropertyDeclaration(node.parent, usage5);
               break;
             case 261: {
               const { name, initializer } = node.parent;
               if (node === name) {
                 if (initializer) {
-                  addCandidateType(usage4, checker.getTypeAtLocation(initializer));
+                  addCandidateType(usage5, checker.getTypeAtLocation(initializer));
                 }
                 break;
               }
             }
             // falls through
             default:
-              return inferTypeFromContextualType(node, usage4);
+              return inferTypeFromContextualType(node, usage5);
           }
         }
-        function inferTypeFromContextualType(node, usage4) {
+        function inferTypeFromContextualType(node, usage5) {
           if (isExpressionNode(node)) {
-            addCandidateType(usage4, checker.getContextualType(node));
+            addCandidateType(usage5, checker.getContextualType(node));
           }
         }
-        function inferTypeFromExpressionStatement(node, usage4) {
-          addCandidateType(usage4, isCallExpression2(node) ? checker.getVoidType() : checker.getAnyType());
+        function inferTypeFromExpressionStatement(node, usage5) {
+          addCandidateType(usage5, isCallExpression2(node) ? checker.getVoidType() : checker.getAnyType());
         }
-        function inferTypeFromPrefixUnaryExpression(node, usage4) {
+        function inferTypeFromPrefixUnaryExpression(node, usage5) {
           switch (node.operator) {
             case 46:
             case 47:
             case 41:
             case 55:
-              usage4.isNumber = true;
+              usage5.isNumber = true;
               break;
             case 40:
-              usage4.isNumberOrString = true;
+              usage5.isNumberOrString = true;
               break;
           }
         }
-        function inferTypeFromBinaryExpression(node, parent2, usage4) {
+        function inferTypeFromBinaryExpression(node, parent2, usage5) {
           switch (parent2.operatorToken.kind) {
             // ExponentiationOperator
             case 43:
@@ -192288,23 +192406,23 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             case 34:
               const operandType = checker.getTypeAtLocation(parent2.left === node ? parent2.right : parent2.left);
               if (operandType.flags & 98304) {
-                addCandidateType(usage4, operandType);
+                addCandidateType(usage5, operandType);
               } else {
-                usage4.isNumber = true;
+                usage5.isNumber = true;
               }
               break;
             case 65:
             case 40:
               const otherOperandType = checker.getTypeAtLocation(parent2.left === node ? parent2.right : parent2.left);
               if (otherOperandType.flags & 98304) {
-                addCandidateType(usage4, otherOperandType);
+                addCandidateType(usage5, otherOperandType);
               } else if (otherOperandType.flags & 67648) {
-                usage4.isNumber = true;
+                usage5.isNumber = true;
               } else if (otherOperandType.flags & 12583968) {
-                usage4.isString = true;
+                usage5.isString = true;
               } else if (otherOperandType.flags & 1) {
               } else {
-                usage4.isNumberOrString = true;
+                usage5.isNumberOrString = true;
               }
               break;
             //  AssignmentOperators
@@ -192316,11 +192434,11 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             case 77:
             case 78:
             case 76:
-              addCandidateType(usage4, checker.getTypeAtLocation(parent2.left === node ? parent2.right : parent2.left));
+              addCandidateType(usage5, checker.getTypeAtLocation(parent2.left === node ? parent2.right : parent2.left));
               break;
             case 103:
               if (node === parent2.left) {
-                usage4.isString = true;
+                usage5.isString = true;
               }
               break;
             // LogicalOperator Or NullishCoalescing
@@ -192331,7 +192449,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
                 /*excludeCompoundAssignment*/
                 true
               ))) {
-                addCandidateType(usage4, checker.getTypeAtLocation(parent2.right));
+                addCandidateType(usage5, checker.getTypeAtLocation(parent2.right));
               }
               break;
             case 56:
@@ -192340,10 +192458,10 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
               break;
           }
         }
-        function inferTypeFromSwitchStatementLabel(parent2, usage4) {
-          addCandidateType(usage4, checker.getTypeAtLocation(parent2.parent.parent.expression));
+        function inferTypeFromSwitchStatementLabel(parent2, usage5) {
+          addCandidateType(usage5, checker.getTypeAtLocation(parent2.parent.parent.expression));
         }
-        function inferTypeFromCallExpression(parent2, usage4) {
+        function inferTypeFromCallExpression(parent2, usage5) {
           const call = {
             argumentTypes: [],
             return_: createEmptyUsage()
@@ -192355,41 +192473,41 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           }
           calculateUsageOfNode(parent2, call.return_);
           if (parent2.kind === 214) {
-            (usage4.calls || (usage4.calls = [])).push(call);
+            (usage5.calls || (usage5.calls = [])).push(call);
           } else {
-            (usage4.constructs || (usage4.constructs = [])).push(call);
+            (usage5.constructs || (usage5.constructs = [])).push(call);
           }
         }
-        function inferTypeFromPropertyAccessExpression(parent2, usage4) {
+        function inferTypeFromPropertyAccessExpression(parent2, usage5) {
           const name = escapeLeadingUnderscores(parent2.name.text);
-          if (!usage4.properties) {
-            usage4.properties = /* @__PURE__ */ new Map();
+          if (!usage5.properties) {
+            usage5.properties = /* @__PURE__ */ new Map();
           }
-          const propertyUsage = usage4.properties.get(name) || createEmptyUsage();
+          const propertyUsage = usage5.properties.get(name) || createEmptyUsage();
           calculateUsageOfNode(parent2, propertyUsage);
-          usage4.properties.set(name, propertyUsage);
+          usage5.properties.set(name, propertyUsage);
         }
-        function inferTypeFromPropertyElementExpression(parent2, node, usage4) {
+        function inferTypeFromPropertyElementExpression(parent2, node, usage5) {
           if (node === parent2.argumentExpression) {
-            usage4.isNumberOrString = true;
+            usage5.isNumberOrString = true;
             return;
           } else {
             const indexType = checker.getTypeAtLocation(parent2.argumentExpression);
             const indexUsage = createEmptyUsage();
             calculateUsageOfNode(parent2, indexUsage);
             if (indexType.flags & 67648) {
-              usage4.numberIndex = indexUsage;
+              usage5.numberIndex = indexUsage;
             } else {
-              usage4.stringIndex = indexUsage;
+              usage5.stringIndex = indexUsage;
             }
           }
         }
-        function inferTypeFromPropertyAssignment(assignment, usage4) {
+        function inferTypeFromPropertyAssignment(assignment, usage5) {
           const nodeWithRealType = isVariableDeclaration2(assignment.parent.parent) ? assignment.parent.parent : assignment.parent;
-          addCandidateThisType(usage4, checker.getTypeAtLocation(nodeWithRealType));
+          addCandidateThisType(usage5, checker.getTypeAtLocation(nodeWithRealType));
         }
-        function inferTypeFromPropertyDeclaration(declaration, usage4) {
-          addCandidateThisType(usage4, checker.getTypeAtLocation(declaration.parent));
+        function inferTypeFromPropertyDeclaration(declaration, usage5) {
+          addCandidateThisType(usage5, checker.getTypeAtLocation(declaration.parent));
         }
         function removeLowPriorityInferences(inferences, priorities) {
           const toRemove = [];
@@ -192403,8 +192521,8 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           }
           return inferences.filter((i) => toRemove.every((f) => !f(i)));
         }
-        function combineFromUsage(usage4) {
-          return combineTypes(inferTypes(usage4));
+        function combineFromUsage(usage5) {
+          return combineTypes(inferTypes(usage5));
         }
         function combineTypes(inferences) {
           if (!inferences.length) return checker.getAnyType();
@@ -192499,26 +192617,26 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             indexInfos
           );
         }
-        function inferTypes(usage4) {
+        function inferTypes(usage5) {
           var _a, _b, _c;
           const types = [];
-          if (usage4.isNumber) {
+          if (usage5.isNumber) {
             types.push(checker.getNumberType());
           }
-          if (usage4.isString) {
+          if (usage5.isString) {
             types.push(checker.getStringType());
           }
-          if (usage4.isNumberOrString) {
+          if (usage5.isNumberOrString) {
             types.push(checker.getUnionType([checker.getStringType(), checker.getNumberType()]));
           }
-          if (usage4.numberIndex) {
-            types.push(checker.createArrayType(combineFromUsage(usage4.numberIndex)));
+          if (usage5.numberIndex) {
+            types.push(checker.createArrayType(combineFromUsage(usage5.numberIndex)));
           }
-          if (((_a = usage4.properties) == null ? void 0 : _a.size) || ((_b = usage4.constructs) == null ? void 0 : _b.length) || usage4.stringIndex) {
-            types.push(inferStructuralType(usage4));
+          if (((_a = usage5.properties) == null ? void 0 : _a.size) || ((_b = usage5.constructs) == null ? void 0 : _b.length) || usage5.stringIndex) {
+            types.push(inferStructuralType(usage5));
           }
-          const candidateTypes = (usage4.candidateTypes || []).map((t3) => checker.getBaseTypeOfLiteralType(t3));
-          const callsType = ((_c = usage4.calls) == null ? void 0 : _c.length) ? inferStructuralType(usage4) : void 0;
+          const candidateTypes = (usage5.candidateTypes || []).map((t3) => checker.getBaseTypeOfLiteralType(t3));
+          const callsType = ((_c = usage5.calls) == null ? void 0 : _c.length) ? inferStructuralType(usage5) : void 0;
           if (callsType && candidateTypes) {
             types.push(checker.getUnionType(
               [callsType, ...candidateTypes],
@@ -192533,23 +192651,23 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
               types.push(...candidateTypes);
             }
           }
-          types.push(...inferNamedTypesFromProperties(usage4));
+          types.push(...inferNamedTypesFromProperties(usage5));
           return types;
         }
-        function inferStructuralType(usage4) {
+        function inferStructuralType(usage5) {
           const members = /* @__PURE__ */ new Map();
-          if (usage4.properties) {
-            usage4.properties.forEach((u, name) => {
+          if (usage5.properties) {
+            usage5.properties.forEach((u, name) => {
               const symbol = checker.createSymbol(4, name);
               symbol.links.type = combineFromUsage(u);
               members.set(name, symbol);
             });
           }
-          const callSignatures = usage4.calls ? [getSignatureFromCalls(usage4.calls)] : [];
-          const constructSignatures = usage4.constructs ? [getSignatureFromCalls(usage4.constructs)] : [];
-          const indexInfos = usage4.stringIndex ? [checker.createIndexInfo(
+          const callSignatures = usage5.calls ? [getSignatureFromCalls(usage5.calls)] : [];
+          const constructSignatures = usage5.constructs ? [getSignatureFromCalls(usage5.constructs)] : [];
+          const indexInfos = usage5.stringIndex ? [checker.createIndexInfo(
             checker.getStringType(),
-            combineFromUsage(usage4.stringIndex),
+            combineFromUsage(usage5.stringIndex),
             /*isReadonly*/
             false
           )] : [];
@@ -192562,17 +192680,17 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             indexInfos
           );
         }
-        function inferNamedTypesFromProperties(usage4) {
-          if (!usage4.properties || !usage4.properties.size) return [];
-          const types = builtins.filter((t3) => allPropertiesAreAssignableToUsage(t3, usage4));
+        function inferNamedTypesFromProperties(usage5) {
+          if (!usage5.properties || !usage5.properties.size) return [];
+          const types = builtins.filter((t3) => allPropertiesAreAssignableToUsage(t3, usage5));
           if (0 < types.length && types.length < 3) {
-            return types.map((t3) => inferInstantiationFromUsage(t3, usage4));
+            return types.map((t3) => inferInstantiationFromUsage(t3, usage5));
           }
           return [];
         }
-        function allPropertiesAreAssignableToUsage(type, usage4) {
-          if (!usage4.properties) return false;
-          return !forEachEntry(usage4.properties, (propUsage, name) => {
+        function allPropertiesAreAssignableToUsage(type, usage5) {
+          if (!usage5.properties) return false;
+          return !forEachEntry(usage5.properties, (propUsage, name) => {
             const source = checker.getTypeOfPropertyOfType(type, name);
             if (!source) {
               return true;
@@ -192589,15 +192707,15 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             }
           });
         }
-        function inferInstantiationFromUsage(type, usage4) {
-          if (!(getObjectFlags(type) & 4) || !usage4.properties) {
+        function inferInstantiationFromUsage(type, usage5) {
+          if (!(getObjectFlags(type) & 4) || !usage5.properties) {
             return type;
           }
           const generic = type.target;
           const singleTypeParameter = singleOrUndefined(generic.typeParameters);
           if (!singleTypeParameter) return type;
           const types = [];
-          usage4.properties.forEach((propUsage, name) => {
+          usage5.properties.forEach((propUsage, name) => {
             const genericPropertyType = checker.getTypeOfPropertyOfType(generic, name);
             Debug.assert(!!genericPropertyType, "generic should have all the properties of its reference.");
             types.push(...inferTypeParameters(genericPropertyType, combineFromUsage(propUsage), singleTypeParameter));
@@ -192698,14 +192816,14 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             /* None */
           );
         }
-        function addCandidateType(usage4, type) {
+        function addCandidateType(usage5, type) {
           if (type && !(type.flags & 1) && !(type.flags & 262144)) {
-            (usage4.candidateTypes || (usage4.candidateTypes = [])).push(type);
+            (usage5.candidateTypes || (usage5.candidateTypes = [])).push(type);
           }
         }
-        function addCandidateThisType(usage4, type) {
+        function addCandidateThisType(usage5, type) {
           if (type && !(type.flags & 1) && !(type.flags & 262144)) {
-            (usage4.candidateThisTypes || (usage4.candidateThisTypes = [])).push(type);
+            (usage5.candidateThisTypes || (usage5.candidateThisTypes = [])).push(type);
           }
         }
       }
@@ -196127,15 +196245,15 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           printNode,
           printAndFormatNode
         };
-        function escapingWrite(s, write2) {
+        function escapingWrite(s, write3) {
           const escaped = escapeSnippetText(s);
           if (escaped !== s) {
             const start = baseWriter.getTextPos();
-            write2();
+            write3();
             const end = baseWriter.getTextPos();
             escapes = append(escapes || (escapes = []), { newText: escaped, span: { start, length: end - start } });
           } else {
-            write2();
+            write3();
           }
         }
         function printSnippetList(format, list2, sourceFile) {
@@ -208582,7 +208700,7 @@ ${options.prefix}` : "\n" : options.prefix
             lastNonTriviaPosition -= i;
           }
         }
-        function write2(s) {
+        function write3(s) {
           writer.write(s);
           setLastNonTriviaPosition(
             s,
@@ -208719,7 +208837,7 @@ ${options.prefix}` : "\n" : options.prefix
           onAfterEmitNodeArray,
           onBeforeEmitToken,
           onAfterEmitToken,
-          write: write2,
+          write: write3,
           writeComment,
           writeKeyword,
           writeOperator,
@@ -212959,10 +213077,10 @@ ${options.prefix}` : "\n" : options.prefix
             Debug.assertIsDefined(originalProgram, "no original program found");
             const originalProgramTypeChecker = originalProgram.getTypeChecker();
             const usageInfoRange = getUsageInfoRangeForPasteEdits(copiedFrom);
-            const usage4 = getUsageInfo(copiedFrom.file, statements, originalProgramTypeChecker, getExistingLocals(updatedFile, statements, originalProgramTypeChecker), usageInfoRange);
+            const usage5 = getUsageInfo(copiedFrom.file, statements, originalProgramTypeChecker, getExistingLocals(updatedFile, statements, originalProgramTypeChecker), usageInfoRange);
             const useEsModuleSyntax = !fileShouldUseJavaScriptRequire(targetFile.fileName, originalProgram, host, !!copiedFrom.file.commonJsModuleIndicator);
-            addExportsInOldFile(copiedFrom.file, usage4.targetFileImportsFromOldFile, changes, useEsModuleSyntax);
-            addTargetFileImports(copiedFrom.file, usage4.oldImportsNeededByTargetFile, usage4.targetFileImportsFromOldFile, originalProgramTypeChecker, updatedProgram, importAdder);
+            addExportsInOldFile(copiedFrom.file, usage5.targetFileImportsFromOldFile, changes, useEsModuleSyntax);
+            addTargetFileImports(copiedFrom.file, usage5.oldImportsNeededByTargetFile, usage5.targetFileImportsFromOldFile, originalProgramTypeChecker, updatedProgram, importAdder);
           } else {
             const context = {
               sourceFile: updatedFile,
@@ -228979,9 +229097,9 @@ __export(showcase_exports, {
   showcaseCommand: () => showcaseCommand
 });
 import { spawnSync as spawnSync11 } from "node:child_process";
-import { cpSync, existsSync as existsSync92, mkdirSync as mkdirSync45, mkdtempSync as mkdtempSync6, readdirSync as readdirSync39, readFileSync as readFileSync87, rmSync as rmSync17, statSync as statSync28, writeFileSync as writeFileSync46 } from "node:fs";
+import { cpSync, existsSync as existsSync93, mkdirSync as mkdirSync45, mkdtempSync as mkdtempSync6, readdirSync as readdirSync39, readFileSync as readFileSync88, rmSync as rmSync17, statSync as statSync28, writeFileSync as writeFileSync47 } from "node:fs";
 import { tmpdir as tmpdir8 } from "node:os";
-import { dirname as dirname44, join as join97 } from "node:path";
+import { dirname as dirname44, join as join98 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function parseArgs2(args) {
   const opts = {
@@ -229022,7 +229140,7 @@ function parseArgs2(args) {
 function packageRoot() {
   let dir = dirname44(fileURLToPath3(import.meta.url));
   for (let i = 0; i < 12; i++) {
-    if (existsSync92(join97(dir, "conventions")))
+    if (existsSync93(join98(dir, "conventions")))
       return dir;
     const parent = dirname44(dir);
     if (parent === dir)
@@ -229032,8 +229150,8 @@ function packageRoot() {
   return dir;
 }
 function rollBin3() {
-  const devPath = join97(packageRoot(), "packages", "cli", "bin", "roll.js");
-  if (existsSync92(devPath))
+  const devPath = join98(packageRoot(), "packages", "cli", "bin", "roll.js");
+  if (existsSync93(devPath))
     return devPath;
   return "roll";
 }
@@ -229060,30 +229178,30 @@ function runRoll(sandbox, rollHome4, args, opts = {}) {
 }
 function fileNonEmpty2(p) {
   try {
-    return existsSync92(p) && statSync28(p).size > 0;
+    return existsSync93(p) && statSync28(p).size > 0;
   } catch {
     return false;
   }
 }
 function makeSandbox(sourceProject) {
-  const root = mkdtempSync6(join97(tmpdir8(), "roll-showcase-"));
-  const sandbox = join97(root, "project");
-  const rollHome4 = join97(root, "home");
+  const root = mkdtempSync6(join98(tmpdir8(), "roll-showcase-"));
+  const sandbox = join98(root, "project");
+  const rollHome4 = join98(root, "home");
   mkdirSync45(sandbox, { recursive: true });
   mkdirSync45(rollHome4, { recursive: true });
-  const srcRoll = join97(sourceProject, ".roll");
-  if (existsSync92(srcRoll)) {
-    cpSync(srcRoll, join97(sandbox, ".roll"), { recursive: true });
+  const srcRoll = join98(sourceProject, ".roll");
+  if (existsSync93(srcRoll)) {
+    cpSync(srcRoll, join98(sandbox, ".roll"), { recursive: true });
   } else {
-    mkdirSync45(join97(sandbox, ".roll", "features"), { recursive: true });
+    mkdirSync45(join98(sandbox, ".roll", "features"), { recursive: true });
   }
   return { sandbox, rollHome: rollHome4 };
 }
 function findCardSpec2(sandbox, card) {
-  const featuresDir = join97(sandbox, ".roll", "features");
+  const featuresDir = join98(sandbox, ".roll", "features");
   const candidates = [];
   const walk2 = (dir, depth) => {
-    if (depth > 3 || !existsSync92(dir))
+    if (depth > 3 || !existsSync93(dir))
       return;
     let entries = [];
     try {
@@ -229092,7 +229210,7 @@ function findCardSpec2(sandbox, card) {
       return;
     }
     for (const name of entries) {
-      const full = join97(dir, name);
+      const full = join98(dir, name);
       let isDir3 = false;
       try {
         isDir3 = statSync28(full).isDirectory();
@@ -229100,8 +229218,8 @@ function findCardSpec2(sandbox, card) {
         continue;
       }
       if (isDir3) {
-        if (name === card && existsSync92(join97(full, "spec.md")))
-          candidates.push(join97(full, "spec.md"));
+        if (name === card && existsSync93(join98(full, "spec.md")))
+          candidates.push(join98(full, "spec.md"));
         walk2(full, depth + 1);
       }
     }
@@ -229113,9 +229231,9 @@ function resetSandbox(sandbox, card) {
   const notes = [];
   let reset2 = false;
   let ok13 = false;
-  const backlogPath = join97(sandbox, ".roll", "backlog.md");
-  if (existsSync92(backlogPath)) {
-    const before = readFileSync87(backlogPath, "utf8");
+  const backlogPath = join98(sandbox, ".roll", "backlog.md");
+  if (existsSync93(backlogPath)) {
+    const before = readFileSync88(backlogPath, "utf8");
     const cardRow = before.split("\n").find((line) => line.startsWith("|") && line.includes(card));
     const hadStatusToken = cardRow !== void 0 && statusMarkerRe(false).test(cardRow);
     const alreadyTodo = cardRow !== void 0 && findStatusMarker(cardRow) === STATUS_MARKER.todo;
@@ -229126,7 +229244,7 @@ function resetSandbox(sandbox, card) {
     });
     const after = lines2.join("\n");
     if (after !== before) {
-      writeFileSync46(backlogPath, after, "utf8");
+      writeFileSync47(backlogPath, after, "utf8");
       reset2 = true;
       ok13 = true;
       notes.push(`backlog: ${card} \u2192 Todo`);
@@ -229142,24 +229260,24 @@ function resetSandbox(sandbox, card) {
   } else {
     notes.push("backlog: .roll/backlog.md absent");
   }
-  const pulseCmd = join97(sandbox, "packages", "cli", "src", "commands", "pulse.ts");
-  if (existsSync92(pulseCmd)) {
+  const pulseCmd = join98(sandbox, "packages", "cli", "src", "commands", "pulse.ts");
+  if (existsSync93(pulseCmd)) {
     rmSync17(pulseCmd, { force: true });
     notes.push("removed prior pulse.ts surface");
   }
   return { ok: ok13, reset: reset2, notes };
 }
 function writeCasting(sandbox, casting) {
-  const agentsPath2 = join97(sandbox, ".roll", "agents.yaml");
+  const agentsPath2 = join98(sandbox, ".roll", "agents.yaml");
   mkdirSync45(dirname44(agentsPath2), { recursive: true });
-  writeFileSync46(agentsPath2, castingAgentsYaml(casting), "utf8");
+  writeFileSync47(agentsPath2, castingAgentsYaml(casting), "utf8");
 }
 async function captureScreenshots(sandbox, card) {
   const shots = [];
   const infra = await Promise.resolve().then(() => (init_dist3(), dist_exports));
-  const shotDir = join97(sandbox, ".roll", "showcase", card, "screenshots");
+  const shotDir = join98(sandbox, ".roll", "showcase", card, "screenshots");
   mkdirSync45(shotDir, { recursive: true });
-  const cliOut = join97(shotDir, "pulse-cli.png");
+  const cliOut = join98(shotDir, "pulse-cli.png");
   const cli = await infra.captureScreenshot({
     kind: "terminal",
     out: cliOut,
@@ -229171,12 +229289,12 @@ async function captureScreenshots(sandbox, card) {
     present: cli.taken && fileNonEmpty2(cliOut),
     ...cli.skipped !== void 0 ? { skipped: cli.skipped } : {}
   });
-  const nowPage = join97(sandbox, ".roll", "features", "index.html");
-  const webOut = join97(shotDir, "now-pulse-badge.png");
+  const nowPage = join98(sandbox, ".roll", "features", "index.html");
+  const webOut = join98(shotDir, "now-pulse-badge.png");
   const web = await infra.captureScreenshot({
     kind: "web",
     out: webOut,
-    url: existsSync92(nowPage) ? `file://${nowPage}#now` : "about:blank"
+    url: existsSync93(nowPage) ? `file://${nowPage}#now` : "about:blank"
   });
   shots.push({
     surface: "web",
@@ -229187,10 +229305,10 @@ async function captureScreenshots(sandbox, card) {
   return shots;
 }
 function readBacklogStatus(sandbox, card) {
-  const backlogPath = join97(sandbox, ".roll", "backlog.md");
-  if (!existsSync92(backlogPath))
+  const backlogPath = join98(sandbox, ".roll", "backlog.md");
+  if (!existsSync93(backlogPath))
     return void 0;
-  for (const line of readFileSync87(backlogPath, "utf8").split("\n")) {
+  for (const line of readFileSync88(backlogPath, "utf8").split("\n")) {
     if (line.startsWith("|") && line.includes(card)) {
       const marker = findStatusMarker(line);
       if (marker !== void 0)
@@ -229200,11 +229318,11 @@ function readBacklogStatus(sandbox, card) {
   return void 0;
 }
 function readTruthLadder(sandbox, card) {
-  const truthPath = join97(sandbox, ".roll", "features", "truth.json");
-  if (!existsSync92(truthPath))
+  const truthPath = join98(sandbox, ".roll", "features", "truth.json");
+  if (!existsSync93(truthPath))
     return void 0;
   try {
-    const snap = JSON.parse(readFileSync87(truthPath, "utf8"));
+    const snap = JSON.parse(readFileSync88(truthPath, "utf8"));
     const row2 = (snap.stories ?? []).find((s) => s.id === card);
     return row2?.ladder;
   } catch {
@@ -229212,12 +229330,12 @@ function readTruthLadder(sandbox, card) {
   }
 }
 function readTcrCommits(sandbox) {
-  const runsPath3 = join97(sandbox, ".roll", "loop", "runs.jsonl");
-  if (!existsSync92(runsPath3))
+  const runsPath3 = join98(sandbox, ".roll", "loop", "runs.jsonl");
+  if (!existsSync93(runsPath3))
     return [];
   const out3 = [];
   try {
-    const lines2 = readFileSync87(runsPath3, "utf8").trim().split("\n").filter(Boolean);
+    const lines2 = readFileSync88(runsPath3, "utf8").trim().split("\n").filter(Boolean);
     const last = lines2[lines2.length - 1];
     if (last === void 0)
       return [];
@@ -229296,7 +229414,7 @@ ${msg6}
     const backlogStatus = readBacklogStatus(sandbox, card);
     const truthLadder = readTruthLadder(sandbox, card);
     const tcrCommits = readTcrCommits(sandbox);
-    const reportPath = join97(sandbox, ".roll", "features");
+    const reportPath = join98(sandbox, ".roll", "features");
     const gate = parseAttestGate(attest.stdout + attest.stderr);
     const run = {
       casting,
@@ -230552,12 +230670,12 @@ async function loopResumeCommand(_args, deps = realDeps()) {
     } catch {
     }
   }
-  const stateFile2 = join20(rt, `state-${id.slug}.yaml`);
-  if (existsSync16(stateFile2)) {
+  const stateFile3 = join20(rt, `state-${id.slug}.yaml`);
+  if (existsSync16(stateFile3)) {
     try {
-      const body = readFileSync14(stateFile2, "utf8");
+      const body = readFileSync14(stateFile3, "utf8");
       const lines2 = body.split("\n").filter((l) => /^(?!heal_count_head_)/.test(l));
-      writeFileSync7(stateFile2, lines2.join("\n"), "utf8");
+      writeFileSync7(stateFile3, lines2.join("\n"), "utf8");
     } catch {
     }
   }
@@ -231693,6 +231811,30 @@ function heartbeatRow(lane, generatedAt) {
   ].filter((s) => s !== "").join(" \xB7 ");
   return `<div style="display:grid;${HB_COLS}align-items:center;gap:14px;padding:13px 18px;border-top:1px solid #f4f6f9;"><div style="display:flex;align-items:center;gap:11px;min-width:0;"><span style="${dot}"></span><div style="min-width:0;"><div style="font-size:13.5px;font-weight:600;color:${C.ink};white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">${esc2(lane.name)}</div><div style="${MONO}font-size:10.5px;color:${stale ? C.red : on ? C.green : C.faint};margin-top:1px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">${stateLine}</div></div></div>` + cell2(esc2(lane.mode ?? "\u2014")) + cell2(mins(lane.everyMin)) + cell2(shortTs(lane.lastAt), true) + `<div class="hb-next" data-next="${esc2(lane.nextAt ?? "")}" style="${MONO}font-size:12.5px;color:${C.body};min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">${shortTs(lane.nextAt)}</div></div>`;
 }
+function loopStateBanner(input) {
+  const loop = input.snapshot.loop;
+  const state = loop?.runState ?? "ACTIVE";
+  const lanes = loop?.lanes ?? [];
+  const laneRunning = (mode) => lanes.find((l) => l.mode === mode)?.running === true;
+  const since = loop?.stateSince !== void 0 && loop.stateSince !== "" ? esc2(loop.stateSince) : "\u2014";
+  const reasonRaw = loop?.stateReason ?? "";
+  const reason = reasonRaw !== "" ? ` \xB7 ${esc2(reasonRaw)}` : "";
+  const wrap = (accent, bg, enLines, zhLines) => `<section data-loop-state="${state}" style="border:1px solid ${accent}33;border-left:3px solid ${accent};border-radius:12px;background:${bg};padding:14px 18px;margin:20px 0 4px;">` + enLines.map((l) => `<div style="${MONO}font-size:13px;color:${C.ink};line-height:1.7;">${l}</div>`).join("") + zhLines.map((l) => `<div style="${MONO}font-size:12px;color:${C.sub};line-height:1.7;">${l}</div>`).join("") + `</section>`;
+  if (state === "DORMANT") {
+    const laneEn = (laneRunning("backlog") ? "loop lane active" : "loop lane unloaded \xB7 zero idle") + " \xB7 " + (laneRunning("pr") ? "PR lane active" : "PR lane off") + " \xB7 " + (laneRunning("dream") ? "Dream lane active" : "Dream lane off");
+    const laneZh = (laneRunning("backlog") ? "loop lane \u6D3B\u8DC3" : "loop lane \u5DF2\u5378\u8F7D \xB7 \u96F6\u95F2\u7F6E") + " \xB7 " + (laneRunning("pr") ? "PR lane \u6D3B\u8DC3" : "PR lane \u5173\u95ED") + " \xB7 " + (laneRunning("dream") ? "Dream lane \u6D3B\u8DC3" : "Dream lane \u5173\u95ED");
+    return wrap(C.purple, "#f7f5fc", [
+      `\u{1F4A4} <b>DORMANT</b> \xB7 since ${since}${reason}`,
+      laneEn,
+      "Wakes on: new Todo \xB7 PR merge \xB7 dream scan \xB7 roll loop resume"
+    ], [`\u{1F4A4} \u4F11\u7720 \xB7 \u81EA ${since}${reason}`, laneZh, "\u5524\u9192\u4E8E\uFF1A\u65B0 Todo \xB7 PR \u5408\u5E76 \xB7 dream \u626B\u63CF \xB7 roll loop resume"]);
+  }
+  if (state === "PAUSED") {
+    return wrap(C.amber, "#fdf8ef", [`\u23F8 <b>PAUSED</b>${since !== "\u2014" ? ` \xB7 since ${since}` : ""}${reason}`, "Resume: roll loop resume"], [`\u23F8 \u5DF2\u6682\u505C${since !== "\u2014" ? ` \xB7 \u81EA ${since}` : ""}${reason}`, "\u6062\u590D\uFF1Aroll loop resume"]);
+  }
+  const armed = lanes.filter((l) => l.running).length;
+  return wrap(C.green, "#f1f9f4", [`\u25CF <b>ACTIVE</b> \xB7 loop running \xB7 ${armed}/${lanes.length} lanes armed`], [`\u25CF \u6D3B\u8DC3 \xB7 \u5FAA\u73AF\u8FD0\u884C\u4E2D \xB7 ${armed}/${lanes.length} lane \u5DF2\u5C31\u7EEA`]);
+}
 function repoLoopsPanel(input) {
   const lanes = input.snapshot.loop?.lanes ?? [];
   return `<div style="display:flex;align-items:baseline;gap:12px;margin:24px 0 12px;flex-wrap:wrap;"><span style="${MONO}font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:${C.sub};font-weight:600;">${bi("Loops on this repo", "\u672C\u4ED3 Loops")}</span><span style="${MONO}font-size:11.5px;color:${C.faint};">${bi("backlog \xB7 PR \xB7 dream \xB7 go sessions", "backlog \xB7 PR \xB7 dream \xB7 go \u4F1A\u8BDD")}</span><span style="flex:1;height:1px;background:#dfe4ec;min-width:16px;"></span><span style="${MONO}font-size:11.5px;color:${C.dim};white-space:nowrap;">${lanes.filter((l) => l.running).length}/${lanes.length} ${bi("running", "\u8FD0\u884C\u4E2D")}</span></div><section style="border:1px solid ${C.line};border-radius:14px;background:${C.card};overflow:hidden;margin:0 0 8px;box-shadow:0 1px 2px rgba(17,26,69,.05);">` + (lanes.length > 0 ? heartbeatHeader() + lanes.map((lane) => heartbeatRow(lane, input.snapshot.generatedAt)).join("") : `<div style="padding:16px 18px;font-size:12.5px;color:${C.faint};font-style:italic;">${bi("no loop lanes found for this repo", "\u672A\u53D1\u73B0\u672C\u4ED3 loop lane")}</div>`) + `</section>`;
@@ -232020,7 +232162,9 @@ function loopTab(input) {
     ["7", "7 days", "\u4E03\u5929"],
     ["all", "All", "\u5168\u90E8"]
   ];
-  return `<div style="padding:30px 0 4px;">` + kicker(bi("The engine says it runs \u2014 here is the tape", "\u5F15\u64CE\u8BF4\u5728\u8DD1\u2014\u2014\u8FD9\u662F\u8F68\u8FF9\u5E26")) + `<h1 style="margin:10px 0 0;font-size:28px;line-height:1.1;font-weight:700;letter-spacing:-.02em;color:${C.ink};">${bi("Loop & Cycles", "\u5FAA\u73AF\u4E0E\u5468\u671F")}</h1><p style="margin:10px 0 0;max-width:660px;font-size:14.5px;line-height:1.55;color:${C.sub};">${bi("Every cycle, complete and replayable. Failures are first-class \u2014 never swallowed.", "\u6BCF\u4E00\u4E2A cycle \u5B8C\u6574\u3001\u53EF\u56DE\u6EAF\u3002\u5931\u8D25\u662F\u4E00\u7B49\u516C\u6C11\u2014\u2014\u7EDD\u4E0D\u541E\u3002")}</p></div>` + // US-DOSSIER-040: the Loop tab is Loop&Cycle (heartbeat/lanes) + the
+  return `<div style="padding:30px 0 4px;">` + kicker(bi("The engine says it runs \u2014 here is the tape", "\u5F15\u64CE\u8BF4\u5728\u8DD1\u2014\u2014\u8FD9\u662F\u8F68\u8FF9\u5E26")) + `<h1 style="margin:10px 0 0;font-size:28px;line-height:1.1;font-weight:700;letter-spacing:-.02em;color:${C.ink};">${bi("Loop & Cycles", "\u5FAA\u73AF\u4E0E\u5468\u671F")}</h1><p style="margin:10px 0 0;max-width:660px;font-size:14.5px;line-height:1.55;color:${C.sub};">${bi("Every cycle, complete and replayable. Failures are first-class \u2014 never swallowed.", "\u6BCF\u4E00\u4E2A cycle \u5B8C\u6574\u3001\u53EF\u56DE\u6EAF\u3002\u5931\u8D25\u662F\u4E00\u7B49\u516C\u6C11\u2014\u2014\u7EDD\u4E0D\u541E\u3002")}</p></div>` + // US-LOOP-079l: the 3-state run-state header (ACTIVE/DORMANT/PAUSED) sits
+  // atop the lanes so the dossier reads its own liveness before the grid.
+  loopStateBanner(input) + // US-DOSSIER-040: the Loop tab is Loop&Cycle (heartbeat/lanes) + the
   // project-scoped commit-hooks panel + the Cycle ledger. The inline agents
   // panel (now the machine Agents page) and the inline casting ladder (now its
   // own Casting tab) are NOT rendered here.
@@ -235687,7 +235831,7 @@ async function streamThroughRenderer(input, out3, opts) {
   const st = newNormalizerState();
   const gapMs = opts.gapMs ?? DEFAULT_HEARTBEAT_GAP_MS;
   let lastStatus = null;
-  const write2 = (sig) => {
+  const write3 = (sig) => {
     if (tierVisible(sig.tier, opts.verbose))
       out3.write(renderSignal(sig, { ts: hms() }) + "\n");
   };
@@ -235702,14 +235846,14 @@ async function streamThroughRenderer(input, out3, opts) {
       return;
     }
     for (const sig of maybeHeartbeat(st, Date.now(), gapMs))
-      write2(sig);
+      write3(sig);
   }, Math.min(gapMs, 15e3));
   beat.unref?.();
   const rl = createInterface({ input, crlfDelay: Infinity });
   try {
     for await (const raw of rl) {
       for (const sig of norm.normalize(raw, st, Date.now()))
-        write2(sig);
+        write3(sig);
     }
   } finally {
     clearInterval(beat);
@@ -238165,7 +238309,7 @@ function skillsOnDisk(skillsRoot) {
 function collectSkillsPanel(projectPath3, deps = defaultSkillsPanelDeps(projectPath3)) {
   const audit = deps.audit();
   const auditRan = audit !== null;
-  const usage4 = deps.usageCounts();
+  const usage5 = deps.usageCounts();
   const skillsRoot = join42(projectPath3, "skills");
   const byName = /* @__PURE__ */ new Map();
   for (const a of audit?.skills ?? [])
@@ -238185,7 +238329,7 @@ function collectSkillsPanel(projectPath3, deps = defaultSkillsPanelDeps(projectP
       hasGotchas: a?.hasGotchas === true,
       hasLoadTrigger: a?.descriptionLoadTrigger === true,
       routeCases: { positive: a?.routeCoverage.positiveCount ?? 0, negative: a?.routeCoverage.negativeCount ?? 0 },
-      usage: usage4[name] ?? 0,
+      usage: usage5[name] ?? 0,
       files: skillFiles(dir),
       dirPath: dir,
       hubText: existsSync39(hubPath) ? readFileSync34(hubPath, "utf8") : ""
@@ -238591,6 +238735,16 @@ function defaultHeartbeatDeps(projectPath3, slug2, launchAgentsDir3) {
       } catch {
         return null;
       }
+    },
+    // US-LOOP-079l: resolve the 3-state run-state from on-disk markers; read the
+    // DORMANT marker's since/reason so the dossier header is self-describing.
+    runState: () => {
+      const state = resolveLoopRunState(projectPath3, slug2);
+      if (state === "DORMANT") {
+        const body = readDormantMarker(dormantMarkerPath(projectPath3, slug2));
+        return body !== null ? { state, since: body.since, reason: body.reason } : { state };
+      }
+      return { state };
     }
   };
 }
@@ -238690,7 +238844,16 @@ function collectLoopHeartbeat(deps) {
   const go = goalLane(deps);
   if (go !== void 0)
     lanes.push(go);
-  return { lanes };
+  const snapshot = { lanes };
+  const rs = deps.runState?.();
+  if (rs !== void 0) {
+    snapshot.runState = rs.state;
+    if (rs.since !== void 0)
+      snapshot.stateSince = rs.since;
+    if (rs.reason !== void 0)
+      snapshot.stateReason = rs.reason;
+  }
+  return snapshot;
 }
 // packages/cli/dist/lib/casting.js
@@ -239672,15 +239835,15 @@ function loadStreamJsonSessionUsage(label3, slug2, agent) {
       continue;
     }
     const msg6 = e["message"] ?? {};
-    const usage4 = msg6["usage"] ?? {};
-    if (Object.keys(usage4).length === 0)
+    const usage5 = msg6["usage"] ?? {};
+    if (Object.keys(usage5).length === 0)
       continue;
     if (msg6["model"] && model === null)
       model = msg6["model"];
-    sums.input_tokens += toInt2(usage4["input_tokens"]);
-    sums.output_tokens += toInt2(usage4["output_tokens"]);
-    sums.cache_creation_tokens += toInt2(usage4["cache_creation_input_tokens"]);
-    sums.cache_read_tokens += toInt2(usage4["cache_read_input_tokens"]);
+    sums.input_tokens += toInt2(usage5["input_tokens"]);
+    sums.output_tokens += toInt2(usage5["output_tokens"]);
+    sums.cache_creation_tokens += toInt2(usage5["cache_creation_input_tokens"]);
+    sums.cache_read_tokens += toInt2(usage5["cache_read_input_tokens"]);
   }
   if (sums.input_tokens === 0 && sums.output_tokens === 0)
     return null;
@@ -253503,20 +253666,59 @@ async function loopReviewResizeCommand(argv, deps = realReviewResizeDeps()) {
   return await deps.selfDowngrade(storyId, `reviewer resize: ${resize.reason}`, subIds);
 }
+// packages/cli/dist/commands/loop-exhaustion-split.js
+init_dist2();
+var DESIGN_TIMEOUT_MS = 12e4;
+function realExhaustionSplitDeps() {
+  return {
+    design: async (projectPath3, storyId) => {
+      const installed = agentsInstalled(realAgentEnv()).map(canonicalAgentName).filter((a) => agentCanReviewHeadless(a));
+      const designer = installed[0];
+      if (designer === void 0)
+        return [];
+      const prompt = `Run the $roll-design workflow to split ${storyId} into 2 or more smaller INVEST sub-stories, each sized for a single TCR cycle \u2014 the current card is too large (every agent has failed it). Read its spec at .roll/features/<epic>/${storyId}/spec.md and carve it along natural seams. For each sub-story create its .roll/features/<epic>/<id>/spec.md. Do NOT edit the backlog. Output exactly one final line: SUBCARDS: <id1>,<id2>,...`;
+      const r = await spawnPeerReviewAgent({ agent: designer, projectPath: projectPath3, prompt, timeoutMs: DESIGN_TIMEOUT_MS });
+      const m7 = /^\s*SUBCARDS:\s*(.+?)\s*$/im.exec(r.stdout);
+      if (m7?.[1] === void 0)
+        return [];
+      return m7[1].split(",").map((s) => s.trim()).filter((s) => s !== "");
+    },
+    selfDowngrade: (storyId, reason, subIds) => loopSelfDowngradeCommand([storyId, reason, subIds.join(",")])
+  };
+}
+function usage4() {
+  process.stderr.write("Usage: roll loop exhaustion-split <story-id> [reason]\n  Agent-exhaustion auto-split: $roll-design mints 2+ sub-stories, then self-downgrade\n  parks the parent at Hold + appends them (cap-hit / irreducible \u2192 ALERT for triage).\n");
+  return 2;
+}
+async function loopExhaustionSplitCommand(argv, deps = realExhaustionSplitDeps()) {
+  const storyId = (argv[0] ?? "").trim();
+  if (storyId === "")
+    return usage4();
+  const detail = (argv[1] ?? "").trim() || "every agent exhausted on this card (zero TCR)";
+  const project = (process.env["ROLL_MAIN_PROJECT"] ?? "").trim() || process.cwd();
+  const log = deps.log ?? ((m7) => void process.stdout.write(m7));
+  const subIds = await deps.design(project, storyId);
+  const reason = `auto-split on agent-exhaustion: ${detail}`;
+  log(subIds.length < 2 ? `exhaustion-split: ${storyId} \u2014 design produced <2 sub-stories; parking for triage
+` : `exhaustion-split: ${storyId} \u2014 landing split \u2192 ${subIds.join(", ")}
+`);
+  return await deps.selfDowngrade(storyId, reason, subIds);
+}
 // packages/cli/dist/commands/loop-run-once.js
 init_dist2();
 init_dist();
 init_dist3();
-import { appendFileSync as appendFileSync19, existsSync as existsSync86, mkdirSync as mkdirSync41, readFileSync as readFileSync81, writeFileSync as writeFileSync41 } from "node:fs";
-import { dirname as dirname41, join as join91 } from "node:path";
+import { appendFileSync as appendFileSync19, existsSync as existsSync87, mkdirSync as mkdirSync41, readFileSync as readFileSync82, writeFileSync as writeFileSync42 } from "node:fs";
+import { dirname as dirname41, join as join92 } from "node:path";
 // packages/cli/dist/runner/executor.js
 init_dist2();
 init_dist();
 init_dist3();
 import { execFile as execFile10, execFileSync as execFileSync21 } from "node:child_process";
-import { appendFileSync as appendFileSync16, existsSync as existsSync82, lstatSync as lstatSync4, mkdirSync as mkdirSync37, readdirSync as readdirSync34, readFileSync as readFileSync77, realpathSync as realpathSync9, rmSync as rmSync15, statSync as statSync26, symlinkSync as symlinkSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync37 } from "node:fs";
-import { dirname as dirname37, join as join87 } from "node:path";
+import { appendFileSync as appendFileSync16, existsSync as existsSync83, lstatSync as lstatSync4, mkdirSync as mkdirSync37, readdirSync as readdirSync34, readFileSync as readFileSync78, realpathSync as realpathSync9, rmSync as rmSync15, statSync as statSync26, symlinkSync as symlinkSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync38 } from "node:fs";
+import { dirname as dirname37, join as join88 } from "node:path";
 import { promisify as promisify10 } from "node:util";
 // packages/cli/dist/runner/agent-liveness.js
@@ -253658,16 +253860,84 @@ function clearCardFailure(runtimeDir9, storyId) {
   write(runtimeDir9, s);
 }
+// packages/cli/dist/runner/selfheal-budget.js
+import { existsSync as existsSync80, readFileSync as readFileSync74, writeFileSync as writeFileSync35 } from "node:fs";
+import { join as join84 } from "node:path";
+var SELFHEAL_AGENT_BUDGET = 2;
+function selfHealBudget(env = process.env) {
+  const raw = (env["ROLL_LOOP_AGENT_RETRY_MAX"] ?? "").trim();
+  if (raw === "")
+    return SELFHEAL_AGENT_BUDGET;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 ? Math.trunc(n) : SELFHEAL_AGENT_BUDGET;
+}
+function autoRecoverEnabled(env = process.env) {
+  return (env["ROLL_LOOP_NO_AUTO_RECOVER"] ?? "").trim() !== "1";
+}
+var EMPTY = { attempts: 0, triedAgents: [], lastReason: "" };
+function stateFile2(runtimeDir9) {
+  return join84(runtimeDir9, "selfheal-cards.json");
+}
+function read2(runtimeDir9) {
+  try {
+    const p = stateFile2(runtimeDir9);
+    if (!existsSync80(p))
+      return { stories: {} };
+    const o = JSON.parse(readFileSync74(p, "utf8"));
+    return { stories: o.stories !== void 0 && typeof o.stories === "object" ? o.stories : {} };
+  } catch {
+    return { stories: {} };
+  }
+}
+function write2(runtimeDir9, s) {
+  try {
+    writeFileSync35(stateFile2(runtimeDir9), JSON.stringify(s, null, 2), "utf8");
+  } catch {
+  }
+}
+function readSelfHeal(runtimeDir9, storyId) {
+  if (storyId === "")
+    return { ...EMPTY };
+  const e = read2(runtimeDir9).stories[storyId];
+  return e !== void 0 ? { attempts: e.attempts ?? 0, triedAgents: Array.isArray(e.triedAgents) ? e.triedAgents : [], lastReason: e.lastReason ?? "" } : { ...EMPTY };
+}
+function recordSelfHealAttempt(runtimeDir9, storyId, failedAgent, reason) {
+  if (storyId === "")
+    return { ...EMPTY };
+  const s = read2(runtimeDir9);
+  const prev = s.stories[storyId] ?? { ...EMPTY };
+  const tried = new Set(prev.triedAgents);
+  if (failedAgent !== "")
+    tried.add(failedAgent);
+  const next = {
+    attempts: prev.attempts + 1,
+    triedAgents: [...tried],
+    lastReason: reason
+  };
+  s.stories[storyId] = next;
+  write2(runtimeDir9, s);
+  return next;
+}
+function clearSelfHeal(runtimeDir9, storyId) {
+  if (storyId === "")
+    return;
+  const s = read2(runtimeDir9);
+  if (s.stories[storyId] === void 0)
+    return;
+  delete s.stories[storyId];
+  write2(runtimeDir9, s);
+}
 // packages/cli/dist/runner/usage-recovery.js
 init_dist2();
-import { readFileSync as readFileSync74, readdirSync as readdirSync32, statSync as statSync25 } from "node:fs";
+import { readFileSync as readFileSync75, readdirSync as readdirSync32, statSync as statSync25 } from "node:fs";
 import { homedir as homedir22 } from "node:os";
-import { basename as basename16, join as join84 } from "node:path";
+import { basename as basename16, join as join85 } from "node:path";
 function defaultPiSessionsRoot() {
-  return join84(homedir22(), ".pi", "agent", "sessions");
+  return join85(homedir22(), ".pi", "agent", "sessions");
 }
 function piSessionsDirFor(root, cwd) {
-  return join84(root, `--${cwd.replace(/^\//, "").replace(/\//g, "-")}--`);
+  return join85(root, `--${cwd.replace(/^\//, "").replace(/\//g, "-")}--`);
 }
 function recoverPiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultPiSessionsRoot()) {
   const dir = piSessionsDirFor(sessionsRoot, worktreeCwd);
@@ -253679,11 +253949,11 @@ function recoverPiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultPiSessionsR
   }
   const summaries = [];
   for (const f of files) {
-    const p = join84(dir, f);
+    const p = join85(dir, f);
     try {
       if (sinceSec !== void 0 && statSync25(p).mtimeMs / 1e3 < sinceSec)
         continue;
-      summaries.push(sumPiSession(readFileSync74(p, "utf8").split("\n")));
+      summaries.push(sumPiSession(readFileSync75(p, "utf8").split("\n")));
     } catch {
     }
   }
@@ -253702,7 +253972,7 @@ function recoverPiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultPiSessionsR
   };
 }
 function defaultKimiSessionsRoot() {
-  return (process.env["ROLL_KIMI_SESSIONS_DIR"] ?? "").trim() || join84(homedir22(), ".kimi-code", "sessions");
+  return (process.env["ROLL_KIMI_SESSIONS_DIR"] ?? "").trim() || join85(homedir22(), ".kimi-code", "sessions");
 }
 function recoverKimiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultKimiSessionsRoot()) {
   const wantBasename = basename16(worktreeCwd.replace(/\/+$/, ""));
@@ -253714,7 +253984,7 @@ function recoverKimiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultKimiSessi
   }
   const wireFiles = [];
   for (const wd of wdDirs) {
-    const agentsRoot = join84(sessionsRoot, wd);
+    const agentsRoot = join85(sessionsRoot, wd);
     let sessions;
     try {
       sessions = readdirSync32(agentsRoot).filter((s) => s.startsWith("session_"));
@@ -253722,7 +253992,7 @@ function recoverKimiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultKimiSessi
       continue;
     }
     for (const session of sessions) {
-      wireFiles.push(join84(agentsRoot, session, "agents", "main", "wire.jsonl"));
+      wireFiles.push(join85(agentsRoot, session, "agents", "main", "wire.jsonl"));
     }
   }
   const summaries = [];
@@ -253730,7 +254000,7 @@ function recoverKimiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultKimiSessi
     try {
       if (sinceSec !== void 0 && statSync25(p).mtimeMs / 1e3 < sinceSec)
         continue;
-      summaries.push(sumKimiWire(readFileSync74(p, "utf8").split("\n")));
+      summaries.push(sumKimiWire(readFileSync75(p, "utf8").split("\n")));
     } catch {
     }
   }
@@ -253748,11 +254018,11 @@ function recoverKimiUsage(worktreeCwd, sinceSec, sessionsRoot = defaultKimiSessi
 // packages/cli/dist/runner/attest-remediation.js
 init_dist2();
-import { existsSync as existsSync80, mkdirSync as mkdirSync35, readFileSync as readFileSync75, writeFileSync as writeFileSync35 } from "node:fs";
-import { basename as basename17, join as join85 } from "node:path";
+import { existsSync as existsSync81, mkdirSync as mkdirSync35, readFileSync as readFileSync76, writeFileSync as writeFileSync36 } from "node:fs";
+import { basename as basename17, join as join86 } from "node:path";
 var ACMAP_REMEDIATION_TIMEOUT_MS = 6 * 6e4;
 function acMapPath(worktreeCwd, storyId) {
-  return join85(cardArchiveDir(worktreeCwd, storyId), "ac-map.json");
+  return join86(cardArchiveDir(worktreeCwd, storyId), "ac-map.json");
 }
 function needsAcMapRemediation(worktreeCwd, storyId) {
   if (storyId === "")
@@ -253760,10 +254030,10 @@ function needsAcMapRemediation(worktreeCwd, storyId) {
   if (storyHasAcBlock(worktreeCwd, storyId) !== true)
     return false;
   const p = acMapPath(worktreeCwd, storyId);
-  if (!existsSync80(p))
+  if (!existsSync81(p))
     return true;
   try {
-    const entries = JSON.parse(readFileSync75(p, "utf8"));
+    const entries = JSON.parse(readFileSync76(p, "utf8"));
     if (!Array.isArray(entries) || entries.length === 0)
       return true;
     const allDraft = entries.every((e) => typeof e === "object" && e !== null && (e["status"] === ACMAP_DRAFT_STATUS || e["status"] === ACMAP_PASS_WITH_EVIDENCE));
@@ -253881,13 +254151,13 @@ function generateAcMapDraft(specText, storyId, evidence, signals) {
   return JSON.stringify(entries, null, 2) + "\n";
 }
 function writeAcMapDraftEvidenceFiles(worktreeCwd, storyId, evidence) {
-  const evidenceDir = join85(cardArchiveDir(worktreeCwd, storyId), "evidence");
+  const evidenceDir = join86(cardArchiveDir(worktreeCwd, storyId), "evidence");
   mkdirSync35(evidenceDir, { recursive: true });
-  writeFileSync35(join85(evidenceDir, `commits-${storyId}.txt`), `${evidence.commitLines.length === 0 ? "(no commits observed)" : evidence.commitLines.join("\n")}
+  writeFileSync36(join86(evidenceDir, `commits-${storyId}.txt`), `${evidence.commitLines.length === 0 ? "(no commits observed)" : evidence.commitLines.join("\n")}
 `);
-  writeFileSync35(join85(evidenceDir, `changed-files-${storyId}.txt`), `${evidence.changedFilenames.length === 0 ? "(no changed files observed)" : evidence.changedFilenames.join("\n")}
+  writeFileSync36(join86(evidenceDir, `changed-files-${storyId}.txt`), `${evidence.changedFilenames.length === 0 ? "(no changed files observed)" : evidence.changedFilenames.join("\n")}
 `);
-  writeFileSync35(join85(evidenceDir, `test-output-${storyId}.txt`), [
+  writeFileSync36(join86(evidenceDir, `test-output-${storyId}.txt`), [
     "Harness ac-map draft test signals",
     "",
     "Changed test files:",
@@ -253900,8 +254170,8 @@ function writeAcMapDraftEvidenceFiles(worktreeCwd, storyId, evidence) {
 }
 function buildAcMapRemediationPrompt(worktreeCwd, storyId, runDir) {
   const target = acMapPath(worktreeCwd, storyId);
-  const storyDir = join85(cardArchiveDir(worktreeCwd, storyId));
-  const draftExists = existsSync80(target);
+  const storyDir = join86(cardArchiveDir(worktreeCwd, storyId));
+  const draftExists = existsSync81(target);
   if (draftExists) {
     return [
       `[attest confirmation / \u9A8C\u6536\u786E\u8BA4] \u9A8C\u6536\u8349\u7A3F ac-map.json \u5DF2\u7531 harness \u4ECE cycle \u8BC1\u636E(\u63D0\u4EA4/\u6D4B\u8BD5\u6587\u4EF6/\u6539\u52A8\u6587\u4EF6)\u81EA\u52A8\u751F\u6210\u3002\u4F60\u53EA\u9700\u786E\u8BA4\u6216\u66F4\u6B63\u6BCF\u6761 AC \u7684\u72B6\u6001\u3002`,
@@ -253917,7 +254187,7 @@ function buildAcMapRemediationPrompt(worktreeCwd, storyId, runDir) {
       `   - "claimed" \u2014 you believe it passes but have no hard evidence.`,
       `   - "missing" \u2014 not addressed this cycle.`,
       `   - Do NOT leave any row as "pass-with-evidence" or "needs-confirmation" \u2014 those are harness drafts, not final statuses.`,
-      `4. Where useful, save REAL command output from this cycle as text evidence under ${join85(storyDir, "evidence")}/.`,
+      `4. Where useful, save REAL command output from this cycle as text evidence under ${join86(storyDir, "evidence")}/.`,
       `5. Edit ${target} \u2014 update ONLY the status fields (and optionally add real evidence). Keep the existing evidence chain.`,
       ``,
       `Proof that you updated: \`node -e 'const a=JSON.parse(require("fs").readFileSync("${target}","utf8")); const bad=a.filter(e=>e.status==="pass-with-evidence"||e.status==="needs-confirmation"); if(bad.length>0) throw new Error(bad.length+" ACs still have draft status"); console.log("ok "+a.length+" ACs confirmed")'\``,
@@ -253928,9 +254198,9 @@ function buildAcMapRemediationPrompt(worktreeCwd, storyId, runDir) {
     `[attest remediation / \u9A8C\u6536\u8865\u5168] \u4F60\u521A\u5728\u672C cycle \u4EA4\u4ED8\u4E86 ${storyId},\u4F46\u6F0F\u5199\u4E86\u9A8C\u6536\u610F\u56FE\u6620\u5C04 ac-map.json \u2014 \u8FD9\u662F\u552F\u4E00\u7F3A\u53E3,\u7F3A\u5B83\u6574\u4E2A\u4EA4\u4ED8\u4F1A\u88AB attest gate \u5224\u5931\u8D25\u3002`,
     `You delivered ${storyId} this cycle but skipped the acceptance intent map (skill step 10.6). Without it the attest gate fails the whole delivery. Do ONLY the following:`,
     ``,
-    `1. Read the story spec and its AC list: ${join85(storyDir, "spec.md")}`,
+    `1. Read the story spec and its AC list: ${join86(storyDir, "spec.md")}`,
     `2. Review what you actually did this cycle: \`git log --oneline origin/main..HEAD\` and \`git diff origin/main...HEAD --stat\` in ${worktreeCwd}.`,
-    `3. Where useful, save REAL command output from this cycle as text evidence under ${join85(storyDir, "evidence")}/ (create the dir if absent).`,
+    `3. Where useful, save REAL command output from this cycle as text evidence under ${join86(storyDir, "evidence")}/ (create the dir if absent).`,
     `4. Write ${target} \u2014 a JSON array with EXACTLY one entry per AC:`,
     ``,
     `[{ "ac": "${storyId}:AC1", "status": "pass",`,
@@ -253949,7 +254219,7 @@ function capturedScreenshotRef(runDir) {
     return null;
   const taken = /* @__PURE__ */ new Set();
   try {
-    const ev = JSON.parse(readFileSync75(join85(runDir, "evidence.json"), "utf8"));
+    const ev = JSON.parse(readFileSync76(join86(runDir, "evidence.json"), "utf8"));
     for (const c2 of ev.captures ?? []) {
       if (c2.taken !== true || typeof c2.out !== "string" || c2.out === "")
         continue;
@@ -253961,7 +254231,7 @@ function capturedScreenshotRef(runDir) {
     return null;
   }
   for (const name of ["web.png", "terminal.png"]) {
-    if (taken.has(name) && existsSync80(join85(runDir, "screenshots", name)))
+    if (taken.has(name) && existsSync81(join86(runDir, "screenshots", name)))
       return `screenshots/${name}`;
   }
   return null;
@@ -253978,11 +254248,11 @@ function autoAttachScreenshotToAcMap(worktreeCwd, storyId, runDir) {
     if (ref === null)
       return null;
     const p = acMapPath(worktreeCwd, storyId);
-    if (!existsSync80(p))
+    if (!existsSync81(p))
       return null;
     let entries;
     try {
-      const parsed = JSON.parse(readFileSync75(p, "utf8"));
+      const parsed = JSON.parse(readFileSync76(p, "utf8"));
       if (!Array.isArray(parsed))
         return null;
       entries = parsed;
@@ -254001,7 +254271,7 @@ function autoAttachScreenshotToAcMap(worktreeCwd, storyId, runDir) {
     }
     if (count === 0)
       return null;
-    writeFileSync35(p, JSON.stringify(entries, null, 2) + "\n");
+    writeFileSync36(p, JSON.stringify(entries, null, 2) + "\n");
     return { href: ref, count };
   } catch {
     return null;
@@ -254011,21 +254281,21 @@ function autoAttachScreenshotToAcMap(worktreeCwd, storyId, runDir) {
 // packages/cli/dist/runner/correction-actuator.js
 init_dist2();
 init_dist();
-import { appendFileSync as appendFileSync15, existsSync as existsSync81, mkdirSync as mkdirSync36, readFileSync as readFileSync76, readdirSync as readdirSync33, writeFileSync as writeFileSync36 } from "node:fs";
-import { dirname as dirname36, join as join86 } from "node:path";
+import { appendFileSync as appendFileSync15, existsSync as existsSync82, mkdirSync as mkdirSync36, readFileSync as readFileSync77, readdirSync as readdirSync33, writeFileSync as writeFileSync37 } from "node:fs";
+import { dirname as dirname36, join as join87 } from "node:path";
 function readMode(projectPath3) {
   try {
-    const path = join86(projectPath3, ".roll", "policy.yaml");
-    if (!existsSync81(path))
+    const path = join87(projectPath3, ".roll", "policy.yaml");
+    if (!existsSync82(path))
       return "conservative";
-    return parsePolicy(readFileSync76(path, "utf8")).loopSafety.correctionActuator;
+    return parsePolicy(readFileSync77(path, "utf8")).loopSafety.correctionActuator;
   } catch {
     return "conservative";
   }
 }
 function readEvents2(eventsPath2) {
   try {
-    return readFileSync76(eventsPath2, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
+    return readFileSync77(eventsPath2, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
   } catch {
     return [];
   }
@@ -254048,7 +254318,7 @@ function appendAlert2(alertsPath, msg6) {
 }
 function markStoryTodo(projectPath3, storyId) {
   try {
-    const path = join86(projectPath3, ".roll", "backlog.md");
+    const path = join87(projectPath3, ".roll", "backlog.md");
     const store = new BacklogStore();
     const snap = store.readBacklog(path);
     const row2 = snap.items.find((it) => it.id === storyId);
@@ -254064,18 +254334,18 @@ function markStoryTodo(projectPath3, storyId) {
 }
 function storyEpic(projectPath3, storyId) {
   try {
-    const idx = JSON.parse(readFileSync76(join86(projectPath3, ".roll", "index.json"), "utf8"));
+    const idx = JSON.parse(readFileSync77(join87(projectPath3, ".roll", "index.json"), "utf8"));
     const epic = idx[storyId];
     if (typeof epic === "string" && epic.trim() !== "")
       return epic;
   } catch {
   }
   try {
-    const features = join86(projectPath3, ".roll", "features");
+    const features = join87(projectPath3, ".roll", "features");
     for (const d of readdirSync33(features, { withFileTypes: true })) {
       if (!d.isDirectory())
         continue;
-      if (existsSync81(join86(features, d.name, storyId)))
+      if (existsSync82(join87(features, d.name, storyId)))
         return d.name;
     }
   } catch {
@@ -254084,7 +254354,7 @@ function storyEpic(projectPath3, storyId) {
 }
 function existingFixId(projectPath3, storyId, signal) {
   try {
-    const snap = new BacklogStore().readBacklog(join86(projectPath3, ".roll", "backlog.md"));
+    const snap = new BacklogStore().readBacklog(join87(projectPath3, ".roll", "backlog.md"));
     return snap.items.find((it) => {
       const desc = it.desc.toLowerCase();
       if (!it.id.startsWith("FIX-"))
@@ -254106,7 +254376,7 @@ function fixDescription(storyId, signal) {
 }
 function writeFixSpec(projectPath3, epic, fixId, decision) {
   try {
-    const dir = join86(projectPath3, ".roll", "features", epic, fixId);
+    const dir = join87(projectPath3, ".roll", "features", epic, fixId);
     mkdirSync36(dir, { recursive: true });
     const body = [
       "---",
@@ -254137,7 +254407,7 @@ function writeFixSpec(projectPath3, epic, fixId, decision) {
       "- [ ] Leave the PR open for human merge approval",
       ""
     ].join("\n");
-    writeFileSync36(join86(dir, "spec.md"), body, "utf8");
+    writeFileSync37(join87(dir, "spec.md"), body, "utf8");
   } catch {
   }
 }
@@ -254145,7 +254415,7 @@ function createFix(projectPath3, decision) {
   const existing = existingFixId(projectPath3, decision.storyId, decision.signal);
   if (existing !== void 0)
     return { mutation: "existing_fix", fixId: existing };
-  const path = join86(projectPath3, ".roll", "backlog.md");
+  const path = join87(projectPath3, ".roll", "backlog.md");
   const store = new BacklogStore();
   for (let attempt = 0; attempt < 2; attempt++) {
     try {
@@ -254170,7 +254440,7 @@ function createFix(projectPath3, decision) {
 }
 function markStoryHold(projectPath3, storyId, reason) {
   try {
-    const path = join86(projectPath3, ".roll", "backlog.md");
+    const path = join87(projectPath3, ".roll", "backlog.md");
     const store = new BacklogStore();
     const snap = store.readBacklog(path);
     const row2 = snap.items.find((it) => it.id === storyId);
@@ -254247,14 +254517,14 @@ async function rescueLeakedMain(repoCwd, refName) {
     code = 1;
   }
   let backlogWorktreeContent;
-  const backlogPath = join87(repoCwd, ".roll", "backlog.md");
+  const backlogPath = join88(repoCwd, ".roll", "backlog.md");
   try {
     const status2 = await execFileAsync10("git", ["status", "--porcelain", "--", ".roll/backlog.md"], {
       cwd: repoCwd,
       encoding: "utf8"
     });
     if ((status2.stdout ?? "").trim() !== "") {
-      backlogWorktreeContent = readFileSync77(backlogPath, "utf8");
+      backlogWorktreeContent = readFileSync78(backlogPath, "utf8");
     }
   } catch {
     backlogWorktreeContent = void 0;
@@ -254270,7 +254540,7 @@ async function rescueLeakedMain(repoCwd, refName) {
   if (backlogWorktreeContent !== void 0) {
     try {
       mkdirSync37(dirname37(backlogPath), { recursive: true });
-      writeFileSync37(backlogPath, backlogWorktreeContent, "utf8");
+      writeFileSync38(backlogPath, backlogWorktreeContent, "utf8");
     } catch {
       code = 1;
     }
@@ -254290,7 +254560,7 @@ var ActivitySignalRecorder = class {
     this.state = newNormalizerState();
     try {
       mkdirSync37(dirname37(signalPath), { recursive: true });
-      writeFileSync37(signalPath, "", "utf8");
+      writeFileSync38(signalPath, "", "utf8");
     } catch {
     }
     this.recordLine(banner);
@@ -254402,9 +254672,9 @@ function readCycleTimeoutThresholds(repoCwd) {
   let wallSec = CYCLE_WALL_TIMEOUT_SEC;
   let noProgressSec = CYCLE_NO_PROGRESS_SEC;
   try {
-    const p = join87(repoCwd, ".roll", "policy.yaml");
-    if (existsSync82(p)) {
-      const ls = parsePolicy(readFileSync77(p, "utf8")).loopSafety;
+    const p = join88(repoCwd, ".roll", "policy.yaml");
+    if (existsSync83(p)) {
+      const ls = parsePolicy(readFileSync78(p, "utf8")).loopSafety;
       wallSec = ls.cycleWallTimeoutSec;
       noProgressSec = ls.cycleNoProgressSec;
     }
@@ -254415,6 +254685,17 @@ function readCycleTimeoutThresholds(repoCwd) {
     noProgressSec: envNum("ROLL_CYCLE_NO_PROGRESS_SEC") ?? noProgressSec
   };
 }
+function readStallThreshold(repoCwd) {
+  const envNum = (key) => {
+    const raw = (process.env[key] ?? "").trim();
+    if (raw === "")
+      return void 0;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : void 0;
+  };
+  const thresholdSec = envNum("ROLL_LOOP_STALL_THRESHOLD_MIN");
+  return { thresholdSec: thresholdSec ?? CYCLE_STALL_THRESHOLD_SEC };
+}
 function startSpawnTimeoutWatchdog(opts) {
   const { cycleId, thresholds, clock: clock2, commitCount, appendEvent: appendEvent3 } = opts;
   const kill = opts.kill ?? (() => killLiveAgents("SIGKILL"));
@@ -254490,10 +254771,68 @@ function startSpawnTimeoutWatchdog(opts) {
     }
   };
 }
+function startStallDetector(opts) {
+  const { cycleId, agent, clock: clock2, appendEvent: appendEvent3 } = opts;
+  const thresholdSec = opts.thresholdSec ?? CYCLE_STALL_THRESHOLD_SEC;
+  const startupGraceSec = opts.startupGraceSec ?? STALL_STARTUP_GRACE_SEC;
+  const pollMs = opts.pollMs ?? (Number((process.env["ROLL_STALL_POLL_MS"] ?? "").trim()) || 5e3);
+  if (thresholdSec <= 0) {
+    return { markProgress: () => {
+    }, stop: () => ({ stalled: false }) };
+  }
+  const startSec = clock2();
+  let lastProgressSec = startSec;
+  let fired = false;
+  let running = false;
+  const markProgress = () => {
+    lastProgressSec = clock2();
+  };
+  const tick = () => {
+    if (running || fired)
+      return;
+    running = true;
+    try {
+      const now = clock2();
+      const verdict = stallVerdict({
+        elapsedSec: now - startSec,
+        idleSec: now - lastProgressSec,
+        stallThresholdSec: thresholdSec,
+        startupGraceSec,
+        alreadyFired: fired
+      });
+      if (verdict.stalled) {
+        fired = true;
+        clearInterval(timer);
+        try {
+          appendEvent3({
+            type: "agent:stall",
+            cycleId,
+            agent,
+            idleSec: verdict.idleSec,
+            thresholdSec: verdict.thresholdSec,
+            ts: Date.now()
+          });
+        } catch {
+        }
+      }
+    } finally {
+      running = false;
+    }
+  };
+  const timer = setInterval(tick, pollMs);
+  timer.unref?.();
+  return {
+    markProgress,
+    stop: () => {
+      clearInterval(timer);
+      return { stalled: fired };
+    }
+  };
+}
 function createCaptureMarkerSink(runDir, capture) {
   let buf = "";
   const pending = [];
-  const logPath = join87(runDir, "evidence", "capture-markers.log");
+  const logPath = join88(runDir, "evidence", "capture-markers.log");
   const record = (marker, result) => {
     try {
       mkdirSync37(dirname37(logPath), { recursive: true });
@@ -254507,7 +254846,7 @@ function createCaptureMarkerSink(runDir, capture) {
       return;
     pending.push(capture.fromMarker(marker, runDir).then((result) => record(marker, result)).catch((e) => record(marker, {
       kind: marker.kind,
-      out: join87(runDir, "screenshots", `${marker.phase}-${marker.stem}.png`),
+      out: join88(runDir, "screenshots", `${marker.phase}-${marker.stem}.png`),
       taken: false,
       skipped: `capture errored: ${String(e)}`
     })));
@@ -254674,16 +255013,23 @@ async function executeCommand(cmd, ports, ctx) {
           ctxPatch: { builderSessionId }
         };
       }
-      const livePath = join87(dirname37(ports.paths.eventsPath), "live.log");
+      const livePath = join88(dirname37(ports.paths.eventsPath), "live.log");
       const liveBanner = `\u2500\u2500 cycle ${ctx.cycleId ?? "?"} \xB7 ${ctx.storyId ?? "?"} \xB7 agent ${cmd.agent} \xB7 build-session ${builderSessionId} \u2500\u2500`;
       try {
-        writeFileSync37(livePath, `${liveBanner}
+        writeFileSync38(livePath, `${liveBanner}
 `);
       } catch {
       }
-      const signalRecorder = new ActivitySignalRecorder(join87(dirname37(ports.paths.eventsPath), `cycle-${ctx.cycleId ?? "unknown"}.signals.jsonl`), cmd.agent, liveBanner, () => eventTs2(ports));
+      const signalRecorder = new ActivitySignalRecorder(join88(dirname37(ports.paths.eventsPath), `cycle-${ctx.cycleId ?? "unknown"}.signals.jsonl`), cmd.agent, liveBanner, () => eventTs2(ports));
       const captureSink = ctx.evidenceRunDir !== void 0 && ctx.evidenceRunDir !== "" ? createCaptureMarkerSink(ctx.evidenceRunDir, ports.capture) : void 0;
       const observer = await startCycleObserver(ports, ctx.cycleId ?? "");
+      const stallDetector = startStallDetector({
+        cycleId: ctx.cycleId ?? "",
+        agent: cmd.agent,
+        clock: ports.clock,
+        appendEvent: (ev) => ports.events.appendEvent(ports.paths.eventsPath, ev),
+        thresholdSec: readStallThreshold(ports.repoCwd).thresholdSec
+      });
       const timeoutWatchdog = startSpawnTimeoutWatchdog({
         cycleId: ctx.cycleId ?? "",
         thresholds: readCycleTimeoutThresholds(ports.repoCwd),
@@ -254715,6 +255061,7 @@ ${skillBodyForSpawn}` : skillBodyForSpawn;
           ...ctx.storyId !== void 0 && ctx.storyId !== "" ? { storyId: ctx.storyId } : {},
           onChunk: (d) => {
             timeoutWatchdog.markProgress();
+            stallDetector.markProgress();
             captureSink?.onChunk(d);
             try {
               appendFileSync16(livePath, d);
@@ -254727,6 +255074,7 @@ ${skillBodyForSpawn}` : skillBodyForSpawn;
         signalRecorder.flush();
         await observer.stop();
         timeoutFired = timeoutWatchdog.stop().firedReason;
+        stallDetector.stop();
       }
       if (timeoutFired !== null)
         res = { ...res, timedOut: true };
@@ -254747,10 +255095,10 @@ ${res.stderr}`.split("\n").find((l) => l.trim() !== "") ?? "").slice(0, 200),
         });
       }
       try {
-        const logDir = join87(dirname37(ports.paths.eventsPath), "cycle-logs");
+        const logDir = join88(dirname37(ports.paths.eventsPath), "cycle-logs");
         mkdirSync37(logDir, { recursive: true });
-        writeFileSync37(
-          join87(logDir, `${ctx.cycleId ?? "cycle"}.agent.log`),
+        writeFileSync38(
+          join88(logDir, `${ctx.cycleId ?? "cycle"}.agent.log`),
           // FIX-343 (step ①): the builder session id is part of the auditable
           // header — the attest gate's scorer≠builder-session invariant is then
           // traceable to a recorded build-session id, not asserted.
@@ -254768,19 +255116,19 @@ ${res.stderr}
         const agentName = ctx.agent ?? cmd.agent;
         const lines2 = res.stdout.split("\n");
         const usageSpec = getAgentSpec(agentName)?.usage;
-        let usage4 = usageSpec?.stdoutExtractor === "claude-stream" ? extractUsage(agentName, lines2) : null;
-        if (usage4 === null && usageSpec?.sessionRecovery === "pi") {
+        let usage5 = usageSpec?.stdoutExtractor === "claude-stream" ? extractUsage(agentName, lines2) : null;
+        if (usage5 === null && usageSpec?.sessionRecovery === "pi") {
           const rootOverride = (process.env["ROLL_PI_SESSIONS_ROOT"] ?? "").trim();
-          usage4 = recoverPiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
+          usage5 = recoverPiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
         }
-        if (usage4 === null && usageSpec?.sessionRecovery === "kimi") {
+        if (usage5 === null && usageSpec?.sessionRecovery === "kimi") {
           const rootOverride = (process.env["ROLL_KIMI_SESSIONS_DIR"] ?? "").trim();
-          usage4 = recoverKimiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
+          usage5 = recoverKimiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
         }
-        if (usage4 === null)
-          usage4 = extractUsage(agentName, lines2);
-        if (usage4 !== null) {
-          costPatch = toCycleCost(usage4, {
+        if (usage5 === null)
+          usage5 = extractUsage(agentName, lines2);
+        if (usage5 !== null) {
+          costPatch = toCycleCost(usage5, {
             cycleId: ctx.cycleId,
             agent: agentName,
             // TCR reverts are not tracked at this layer yet; nominal == effective.
@@ -254848,9 +255196,9 @@ ${res.stderr}
       };
       const computeExcludedPeers = () => {
         try {
-          if (!existsSync82(ports.paths.eventsPath))
+          if (!existsSync83(ports.paths.eventsPath))
             return /* @__PURE__ */ new Set();
-          const events = readFileSync77(ports.paths.eventsPath, "utf8").split("\n").map(parseEventLine).filter((e) => e !== null);
+          const events = readFileSync78(ports.paths.eventsPath, "utf8").split("\n").map(parseEventLine).filter((e) => e !== null);
           const states = peerAuthStates(events);
           const excluded = excludedPeers(events);
           const announced = /* @__PURE__ */ new Set();
@@ -254967,8 +255315,8 @@ ${res.stderr}`, "review");
       {
         let pairHistory;
         try {
-          if (existsSync82(ports.paths.eventsPath)) {
-            const events = readFileSync77(ports.paths.eventsPath, "utf8").split("\n").map(parseEventLine).filter((e) => e !== null);
+          if (existsSync83(ports.paths.eventsPath)) {
+            const events = readFileSync78(ports.paths.eventsPath, "utf8").split("\n").map(parseEventLine).filter((e) => e !== null);
             pairHistory = pairingHistory(events);
           }
         } catch {
@@ -255085,9 +255433,9 @@ ${res.stderr}`;
         }
         let goalLine = "";
         try {
-          const specPath = join87(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
-          if (existsSync82(specPath)) {
-            const title = (/^title:\s*(.+)$/m.exec(readFileSync77(specPath, "utf8"))?.[1] ?? "").trim();
+          const specPath = join88(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
+          if (existsSync83(specPath)) {
+            const title = (/^title:\s*(.+)$/m.exec(readFileSync78(specPath, "utf8"))?.[1] ?? "").trim();
             if (title !== "")
               goalLine = `Goal: ${title}
 `;
@@ -255116,7 +255464,7 @@ ${diffStat}`;
           try {
             const specPath = storySpecPath(ports.paths.worktreePath, storyId);
             if (specPath !== null) {
-              const specText = readFileSync77(specPath, "utf8");
+              const specText = readFileSync78(specPath, "utf8");
               const gitEvidence = await collectDraftEvidence(ports.paths.worktreePath);
               let cycleSignals;
               try {
@@ -255131,7 +255479,7 @@ ${diffStat}`;
               const draftJson = generateAcMapDraft(specText, storyId, gitEvidence, cycleSignals);
               if (draftJson !== null) {
                 writeAcMapDraftEvidenceFiles(ports.paths.worktreePath, storyId, gitEvidence);
-                writeFileSync37(acMapPath(ports.paths.worktreePath, storyId), draftJson);
+                writeFileSync38(acMapPath(ports.paths.worktreePath, storyId), draftJson);
                 ports.events.appendEvent(ports.paths.eventsPath, {
                   type: "attest:draft-generated",
                   cycleId: ctx.cycleId ?? "",
@@ -255348,7 +255696,7 @@ ${diffStat}`;
     // pure worktree teardown again.
     case "cleanup_worktree":
       try {
-        const dst = join87(ports.paths.worktreePath, ".roll");
+        const dst = join88(ports.paths.worktreePath, ".roll");
         if (lstatSync4(dst, { throwIfNoEntry: false })?.isSymbolicLink() === true)
           unlinkSync3(dst);
       } catch {
@@ -255574,16 +255922,16 @@ function buildTerminalRecord(cmd, ctx, attestCwd, nowSec2) {
     attest = absent("not_applicable");
   } else {
     const report = verificationReportPath(attestCwd, storyId);
-    const hasReport = existsSync82(report);
-    const hasMap = existsSync82(acMapPath(attestCwd, storyId));
+    const hasReport = existsSync83(report);
+    const hasMap = existsSync83(acMapPath(attestCwd, storyId));
     if (hasReport)
       attest = present({ reportPath: report, acMap: hasMap });
     else
       attest = absent(hasMap ? "not_rendered" : "acmap_missing");
   }
-  let usage4;
+  let usage5;
   if (ctx.cost !== void 0) {
-    usage4 = present({
+    usage5 = present({
       model: ctx.cost.model,
       tokensIn: ctx.cost.tokensIn,
       tokensOut: ctx.cost.tokensOut,
@@ -255591,7 +255939,7 @@ function buildTerminalRecord(cmd, ctx, attestCwd, nowSec2) {
       ...ctx.cost.cacheWrite !== void 0 ? { cacheWrite: ctx.cost.cacheWrite } : {}
     });
   } else {
-    usage4 = absent("no_parseable_usage");
+    usage5 = absent("no_parseable_usage");
   }
   const routedModel = (ctx.model ?? "").trim() !== "" ? ctx.model : ctx.agent ?? "";
   const model = ctx.cost !== void 0 && ctx.cost.model !== "" ? ctx.cost.model : routedModel;
@@ -255609,15 +255957,15 @@ function buildTerminalRecord(cmd, ctx, attestCwd, nowSec2) {
     commit: absent("not_recorded"),
     tcr: ctx.tcrCount !== void 0 ? present(ctx.tcrCount) : absent("not_recorded"),
     attest,
-    usage: usage4,
+    usage: usage5,
     cost: ctx.cost !== void 0 ? present({ estimatedUsd: ctx.cost.estimatedCost, effectiveUsd: ctx.cost.effectiveCost }) : absent("no_parseable_usage")
   });
 }
 function readRunsRows(runsPath3) {
   try {
-    if (!existsSync82(runsPath3))
+    if (!existsSync83(runsPath3))
       return [];
-    const all = readFileSync77(runsPath3, "utf8").split("\n").filter((l) => l.trim() !== "").map((l) => {
+    const all = readFileSync78(runsPath3, "utf8").split("\n").filter((l) => l.trim() !== "").map((l) => {
       try {
         return JSON.parse(l);
       } catch {
@@ -255724,24 +256072,24 @@ function resetSpecTruthText(text2) {
 }
 function resetStaleSpecTruth(ports, storyId) {
   try {
-    const specPath = join87(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
-    if (!existsSync82(specPath))
+    const specPath = join88(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
+    if (!existsSync83(specPath))
       return;
-    const before = readFileSync77(specPath, "utf8");
+    const before = readFileSync78(specPath, "utf8");
     const { text: text2, changed } = resetSpecTruthText(before);
     if (!changed)
       return;
-    writeFileSync37(specPath, text2);
+    writeFileSync38(specPath, text2);
     ports.events.appendAlert(ports.paths.alertsPath, `spec truth reset for ${storyId}: a non-merged terminal cleared a stale \u2705/[x] spec claim so a re-run can deliver`);
   } catch {
   }
 }
 function runVisualEvidencePreflight(ports, storyId, cycleId) {
   try {
-    const specPath = join87(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
-    if (!existsSync82(specPath))
+    const specPath = join88(cardArchiveDir(ports.repoCwd, storyId), "spec.md");
+    if (!existsSync83(specPath))
       return;
-    const specText = readFileSync77(specPath, "utf8");
+    const specText = readFileSync78(specPath, "utf8");
     const v = validateStoryVisualEvidence(specText);
     if (v.ok) {
       ports.events.appendEvent(ports.paths.eventsPath, {
@@ -255796,14 +256144,14 @@ function storyRequiresManualMerge(repoCwd, storyId) {
     return needles.some((n) => lower.includes(n));
   };
   try {
-    const backlog = readFileSync77(join87(repoCwd, ".roll", "backlog.md"), "utf8");
+    const backlog = readFileSync78(join88(repoCwd, ".roll", "backlog.md"), "utf8");
     const row2 = parseBacklog(backlog).find((it) => it.id === storyId);
     if (row2 !== void 0 && containsMarker(row2.desc))
       return true;
   } catch {
   }
   try {
-    return containsMarker(readFileSync77(join87(cardArchiveDir(repoCwd, storyId), "spec.md"), "utf8"));
+    return containsMarker(readFileSync78(join88(cardArchiveDir(repoCwd, storyId), "spec.md"), "utf8"));
   } catch {
     return false;
   }
@@ -255845,12 +256193,12 @@ function agentWritableRoots(repoCwd, alertsPath) {
   const add = (p) => {
     if (p.trim() === "")
       return;
-    const real = existsSync82(p) ? realpathSync9(p) : p;
+    const real = existsSync83(p) ? realpathSync9(p) : p;
     if (!roots.includes(real))
       roots.push(real);
   };
-  const rollDir = join87(repoCwd, ".roll");
-  if (existsSync82(rollDir))
+  const rollDir = join88(repoCwd, ".roll");
+  if (existsSync83(rollDir))
     add(rollDir);
   add(dirname37(alertsPath));
   try {
@@ -255872,10 +256220,10 @@ function persistWorktreeAlerts(worktreePath, alertsPath, events) {
   }
   for (const name of names) {
     try {
-      const path = join87(worktreePath, name);
+      const path = join88(worktreePath, name);
       if (!lstatSync4(path).isFile())
         continue;
-      const body = readFileSync77(path, "utf8").trim();
+      const body = readFileSync78(path, "utf8").trim();
       if (body === "")
         continue;
       events.appendAlert(alertsPath, `# worktree alert persisted: ${name}
@@ -255887,15 +256235,15 @@ ${body}`);
 }
 async function linkRollIntoWorktree(repoCwd, worktreePath) {
   try {
-    const src = join87(repoCwd, ".roll");
-    const dst = join87(worktreePath, ".roll");
-    if (!existsSync82(src))
+    const src = join88(repoCwd, ".roll");
+    const dst = join88(worktreePath, ".roll");
+    if (!existsSync83(src))
       return;
     const dstStat = lstatSync4(dst, { throwIfNoEntry: false });
     if (dstStat) {
       if (dstStat.isSymbolicLink())
         return;
-      const incompleteFossil = existsSync82(join87(src, "backlog.md")) && !existsSync82(join87(dst, "backlog.md"));
+      const incompleteFossil = existsSync83(join88(src, "backlog.md")) && !existsSync83(join88(dst, "backlog.md"));
       if (!incompleteFossil)
         return;
       rmSync15(dst, { recursive: true, force: true });
@@ -255904,8 +256252,8 @@ async function linkRollIntoWorktree(repoCwd, worktreePath) {
     const common = (await execFileAsync10("git", ["-C", repoCwd, "rev-parse", "--path-format=absolute", "--git-common-dir"])).stdout.trim();
     if (common === "")
       return;
-    const exclude = join87(common, "info", "exclude");
-    const cur = existsSync82(exclude) ? readFileSync77(exclude, "utf8") : "";
+    const exclude = join88(common, "info", "exclude");
+    const cur = existsSync83(exclude) ? readFileSync78(exclude, "utf8") : "";
     if (!/^\.roll$/m.test(cur)) {
       mkdirSync37(dirname37(exclude), { recursive: true });
       appendFileSync16(exclude, `${cur === "" || cur.endsWith("\n") ? "" : "\n"}.roll
@@ -255915,8 +256263,8 @@ async function linkRollIntoWorktree(repoCwd, worktreePath) {
   }
 }
 async function commitRollMetadataRepo(projectCwd, message) {
-  const rollDir = join87(projectCwd, ".roll");
-  if (!existsSync82(rollDir))
+  const rollDir = join88(projectCwd, ".roll");
+  if (!existsSync83(rollDir))
     return { committed: false, pushed: false, nothingToCommit: true };
   const top = await git(["rev-parse", "--show-toplevel"], rollDir);
   if (top.code !== 0)
@@ -255969,11 +256317,11 @@ async function rebaseRollMetaOntoUpstream(rollDir, branch) {
 }
 var DEPS_BOOTSTRAP_TIMEOUT_MS = 6e5;
 async function bootstrapWorktreeDeps(worktreePath, alertsPath, events, exec = execFileAsync10) {
-  if (!existsSync82(join87(worktreePath, "package.json")))
+  if (!existsSync83(join88(worktreePath, "package.json")))
     return true;
-  if (existsSync82(join87(worktreePath, "node_modules")))
+  if (existsSync83(join88(worktreePath, "node_modules")))
     return true;
-  const plan = existsSync82(join87(worktreePath, "pnpm-lock.yaml")) ? { cmd: "pnpm", args: ["install", "--prefer-offline"] } : existsSync82(join87(worktreePath, "package-lock.json")) ? { cmd: "npm", args: ["ci", "--prefer-offline"] } : void 0;
+  const plan = existsSync83(join88(worktreePath, "pnpm-lock.yaml")) ? { cmd: "pnpm", args: ["install", "--prefer-offline"] } : existsSync83(join88(worktreePath, "package-lock.json")) ? { cmd: "npm", args: ["ci", "--prefer-offline"] } : void 0;
   if (plan === void 0)
     return true;
   try {
@@ -255992,10 +256340,10 @@ async function bootstrapWorktreeDeps(worktreePath, alertsPath, events, exec = ex
 var PREBUILD_TIMEOUT_MS = 6e5;
 function readPrebuildDistEnabled(repoCwd) {
   try {
-    const p = join87(repoCwd, ".roll", "policy.yaml");
-    if (!existsSync82(p))
+    const p = join88(repoCwd, ".roll", "policy.yaml");
+    if (!existsSync83(p))
       return false;
-    return parsePolicy(readFileSync77(p, "utf8")).loopSafety.prebuildDist === true;
+    return parsePolicy(readFileSync78(p, "utf8")).loopSafety.prebuildDist === true;
   } catch {
     return false;
   }
@@ -256003,9 +256351,9 @@ function readPrebuildDistEnabled(repoCwd) {
 async function bootstrapWorktreePrebuild(worktreePath, alertsPath, events, enabled, exec = execFileAsync10) {
   if (!enabled)
     return;
-  if (!existsSync82(join87(worktreePath, "package.json")))
+  if (!existsSync83(join88(worktreePath, "package.json")))
     return;
-  if (!existsSync82(join87(worktreePath, "pnpm-lock.yaml")))
+  if (!existsSync83(join88(worktreePath, "pnpm-lock.yaml")))
     return;
   try {
     await exec("pnpm", ["-r", "build"], {
@@ -256020,10 +256368,10 @@ async function bootstrapWorktreePrebuild(worktreePath, alertsPath, events, enabl
 }
 function readProjectMapEnabled(repoCwd) {
   try {
-    const p = join87(repoCwd, ".roll", "policy.yaml");
-    if (!existsSync82(p))
+    const p = join88(repoCwd, ".roll", "policy.yaml");
+    if (!existsSync83(p))
       return false;
-    return parsePolicy(readFileSync77(p, "utf8")).loopSafety.projectMap === true;
+    return parsePolicy(readFileSync78(p, "utf8")).loopSafety.projectMap === true;
   } catch {
     return false;
   }
@@ -256081,7 +256429,7 @@ function findRelevantFiles(root, token, limit) {
       scanned += 1;
       const childRel = rel === "" ? ent.name : `${rel}/${ent.name}`;
       if (ent.isDirectory()) {
-        walk2(join87(dir, ent.name), childRel);
+        walk2(join88(dir, ent.name), childRel);
       } else if (childRel.toLowerCase().includes(needle)) {
         hits.push(childRel);
       }
@@ -256100,7 +256448,7 @@ function buildProjectMap(worktreePath, storyId) {
     lines2.push(`  ${name}`);
     const bare = name.replace(/\/$/, "");
     if (name.endsWith("/") && PROJECT_MAP_CONTAINERS.has(bare)) {
-      for (const child of shallowList(join87(worktreePath, bare), PROJECT_MAP_MAX_TOPLEVEL)) {
+      for (const child of shallowList(join88(worktreePath, bare), PROJECT_MAP_MAX_TOPLEVEL)) {
         lines2.push(`    ${child}`);
       }
     }
@@ -256168,8 +256516,8 @@ function buildLowScoreFixForwardPrompt(projectPath3, storyId) {
   ].join("\n");
 }
 function skillsEntryCount(worktreePath) {
-  const dir = join87(worktreePath, "skills");
-  if (!existsSync82(dir))
+  const dir = join88(worktreePath, "skills");
+  if (!existsSync83(dir))
     return 0;
   try {
     return readdirSync34(dir).length;
@@ -256178,7 +256526,7 @@ function skillsEntryCount(worktreePath) {
   }
 }
 async function bootstrapWorktreeSkills(worktreePath, alertsPath, events, submoduleInit) {
-  if (!existsSync82(join87(worktreePath, ".gitmodules")))
+  if (!existsSync83(join88(worktreePath, ".gitmodules")))
     return true;
   if (skillsEntryCount(worktreePath) > 0)
     return true;
@@ -256213,14 +256561,14 @@ function nodePorts(opts) {
     },
     readText(absPath) {
       try {
-        return readFileSync77(absPath, "utf8");
+        return readFileSync78(absPath, "utf8");
       } catch {
         return "";
       }
     },
     writeText(absPath, text2) {
       mkdirSync37(dirname37(absPath), { recursive: true });
-      writeFileSync37(absPath, text2, "utf8");
+      writeFileSync38(absPath, text2, "utf8");
     }
   };
   let deliveredCache;
@@ -256383,10 +256731,10 @@ function nodePorts(opts) {
     },
     backlog: {
       read(projectCwd) {
-        const p = join87(projectCwd, ".roll", "backlog.md");
-        if (!existsSync82(p))
+        const p = join88(projectCwd, ".roll", "backlog.md");
+        if (!existsSync83(p))
           return [];
-        return parseBacklog(readFileSync77(p, "utf8"));
+        return parseBacklog(readFileSync78(p, "utf8"));
       },
       // FIX-198: the production binding was MISSING entirely (the optional
       // chain made every In-Progress claim a silent no-op). ID-anchored mark
@@ -256394,8 +256742,8 @@ function nodePorts(opts) {
       // never kill the cycle, the reconcile pass is the safety net.
       markStatus(projectCwd, id, status2) {
         try {
-          const p = join87(projectCwd, ".roll", "backlog.md");
-          if (!existsSync82(p))
+          const p = join88(projectCwd, ".roll", "backlog.md");
+          if (!existsSync83(p))
             return;
           const store = new BacklogStore();
           const snap = store.readBacklog(p);
@@ -256412,15 +256760,18 @@ function nodePorts(opts) {
       }
     },
     route: opts.routeDeps ? {
-      resolve(_storyId, estMin) {
+      resolve(storyId, estMin) {
         const tier = classifyComplexity(estMin);
-        const dec = resolveRoute(tier, opts.routeDeps);
+        const routeDeps = opts.routeDeps;
+        const rt = (process.env["ROLL_PROJECT_RUNTIME_DIR"] ?? "").trim() || join88(opts.repoCwd, ".roll", "loop");
+        const tried = storyId !== "" ? readSelfHeal(rt, storyId).triedAgents : [];
+        const dec = tried.length > 0 ? resolveRouteExcluding(tier, routeDeps, tried) ?? resolveRoute(tier, routeDeps) : resolveRoute(tier, routeDeps);
         return { agent: dec.agent, model: dec.model ?? "" };
       }
     } : { resolve: () => ({ agent: "claude", model: "" }) },
     evidence: {
       openFrame(projectCwd, storyId, runId) {
-        return openEvidenceFrame({ runDir: join87(cardArchiveDir(projectCwd, storyId), runId) }).runDir;
+        return openEvidenceFrame({ runDir: join88(cardArchiveDir(projectCwd, storyId), runId) }).runDir;
       }
     },
     capture: {
@@ -256633,10 +256984,39 @@ function describeCommand(cmd) {
   }
 }
+// packages/cli/dist/runner/selfheal-switch.js
+init_dist2();
+function maybeSwitchAgent(deps) {
+  if (deps.storyId === "" || deps.failedAgent === "")
+    return false;
+  const read3 = deps.readEntry ?? readSelfHeal;
+  const record = deps.recordAttempt ?? recordSelfHealAttempt;
+  const entry = read3(deps.runtimeDir, deps.storyId);
+  if (entry.attempts >= deps.budget)
+    return false;
+  const tier = classifyComplexity(deps.estMin);
+  const next = resolveRouteExcluding(tier, deps.routeDeps, [...entry.triedAgents, deps.failedAgent]);
+  if (next === null)
+    return false;
+  const updated = record(deps.runtimeDir, deps.storyId, deps.failedAgent, deps.reason);
+  deps.remarkTodo(deps.storyId);
+  deps.emit({
+    type: "agent:retry",
+    cycleId: deps.cycleId,
+    storyId: deps.storyId,
+    fromAgent: deps.failedAgent,
+    toAgent: next.agent,
+    attempt: updated.attempts,
+    reason: deps.reason,
+    ts: deps.now()
+  });
+  return true;
+}
 // packages/cli/dist/runner/binary-staleness.js
 import { execFile as execFile11 } from "node:child_process";
-import { existsSync as existsSync83, mkdirSync as mkdirSync38, readFileSync as readFileSync78, writeFileSync as writeFileSync38 } from "node:fs";
-import { dirname as dirname38, join as join88 } from "node:path";
+import { existsSync as existsSync84, mkdirSync as mkdirSync38, readFileSync as readFileSync79, writeFileSync as writeFileSync39 } from "node:fs";
+import { dirname as dirname38, join as join89 } from "node:path";
 import { promisify as promisify11 } from "node:util";
 var execFileAsync11 = promisify11(execFile11);
 var STALE_CHECK_TTL_MS = 24 * 60 * 60 * 1e3;
@@ -256661,9 +257041,9 @@ function isOlderThan(running, latest) {
 }
 function readCache(cachePath, nowMs) {
   try {
-    if (!existsSync83(cachePath))
+    if (!existsSync84(cachePath))
       return null;
-    const c2 = JSON.parse(readFileSync78(cachePath, "utf8"));
+    const c2 = JSON.parse(readFileSync79(cachePath, "utf8"));
     if (typeof c2.latest !== "string" || typeof c2.fetchedAtMs !== "number")
       return null;
     if (nowMs - c2.fetchedAtMs >= STALE_CHECK_TTL_MS)
@@ -256676,7 +257056,7 @@ function readCache(cachePath, nowMs) {
 function writeCache(cachePath, cache) {
   try {
     mkdirSync38(dirname38(cachePath), { recursive: true });
-    writeFileSync38(cachePath, JSON.stringify(cache), "utf8");
+    writeFileSync39(cachePath, JSON.stringify(cache), "utf8");
   } catch {
   }
 }
@@ -256714,7 +257094,7 @@ async function checkBinaryStaleness(deps) {
 async function warnIfBinaryStale(rollHomeDir, runningVersion, appendAlert3) {
   await checkBinaryStaleness({
     runningVersion,
-    cachePath: join88(rollHomeDir, ".loop-version-check"),
+    cachePath: join89(rollHomeDir, ".loop-version-check"),
     nowMs: Date.now(),
     fetchLatest: fetchRemoteLatest,
     alert: appendAlert3
@@ -256724,21 +257104,21 @@ async function warnIfBinaryStale(rollHomeDir, runningVersion, appendAlert3) {
 // packages/cli/dist/runner/correction-circuit.js
 init_dist2();
 init_dist();
-import { appendFileSync as appendFileSync17, existsSync as existsSync84, mkdirSync as mkdirSync39, readFileSync as readFileSync79, writeFileSync as writeFileSync39 } from "node:fs";
-import { dirname as dirname39, join as join89 } from "node:path";
+import { appendFileSync as appendFileSync17, existsSync as existsSync85, mkdirSync as mkdirSync39, readFileSync as readFileSync80, writeFileSync as writeFileSync40 } from "node:fs";
+import { dirname as dirname39, join as join90 } from "node:path";
 function readLoopSafety(projectPath3) {
   try {
-    const path = join89(projectPath3, ".roll", "policy.yaml");
-    if (!existsSync84(path))
+    const path = join90(projectPath3, ".roll", "policy.yaml");
+    if (!existsSync85(path))
       return parsePolicy("").loopSafety;
-    return parsePolicy(readFileSync79(path, "utf8")).loopSafety;
+    return parsePolicy(readFileSync80(path, "utf8")).loopSafety;
   } catch {
     return parsePolicy("").loopSafety;
   }
 }
 function readEvents3(eventsPath2) {
   try {
-    return readFileSync79(eventsPath2, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
+    return readFileSync80(eventsPath2, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
   } catch {
     return [];
   }
@@ -256759,8 +257139,8 @@ function applyCorrectionCircuitBreaker(projectPath3, slug2, eventsPath2, alertsP
     return { status: "continue" };
   if (alreadyTripped(events, verdict))
     return { status: "already_tripped", verdict };
-  const pauseMarker = join89(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
-  const pauseWritten = !existsSync84(pauseMarker);
+  const pauseMarker = join90(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
+  const pauseWritten = !existsSync85(pauseMarker);
   const alertMsg = `# ALERT \u2014 correction circuit breaker tripped
 **Reason**: ${verdict.reason}
@@ -256772,7 +257152,7 @@ function applyCorrectionCircuitBreaker(projectPath3, slug2, eventsPath2, alertsP
   try {
     mkdirSync39(dirname39(pauseMarker), { recursive: true });
     if (pauseWritten)
-      writeFileSync39(pauseMarker, alertMsg, "utf8");
+      writeFileSync40(pauseMarker, alertMsg, "utf8");
     mkdirSync39(dirname39(alertsPath), { recursive: true });
     appendFileSync17(alertsPath, `${alertMsg}
 `, "utf8");
@@ -256795,22 +257175,22 @@ function applyCorrectionCircuitBreaker(projectPath3, slug2, eventsPath2, alertsP
 // packages/cli/dist/lib/morning-report.js
 init_dist2();
 init_dist();
-import { appendFileSync as appendFileSync18, existsSync as existsSync85, mkdirSync as mkdirSync40, readFileSync as readFileSync80, writeFileSync as writeFileSync40 } from "node:fs";
-import { dirname as dirname40, join as join90 } from "node:path";
+import { appendFileSync as appendFileSync18, existsSync as existsSync86, mkdirSync as mkdirSync40, readFileSync as readFileSync81, writeFileSync as writeFileSync41 } from "node:fs";
+import { dirname as dirname40, join as join91 } from "node:path";
 var esc7 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 function iso3(sec) {
   return new Date(sec * 1e3).toISOString().replace(/\.\d{3}Z$/, "Z");
 }
 function readEvents4(path) {
   try {
-    return readFileSync80(path, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
+    return readFileSync81(path, "utf8").split("\n").map(parseEventLine).filter((ev) => ev !== null);
   } catch {
     return [];
   }
 }
 function readRuns(path) {
   try {
-    const all = readFileSync80(path, "utf8").split("\n").map((line) => line.trim()).filter((line) => line !== "").map((line) => JSON.parse(line));
+    const all = readFileSync81(path, "utf8").split("\n").map((line) => line.trim()).filter((line) => line !== "").map((line) => JSON.parse(line));
     const lastWins = /* @__PURE__ */ new Map();
     const unkeyed = [];
     for (const row2 of all) {
@@ -256866,13 +257246,13 @@ function writeLatestMorningReport(projectPath3, eventsPath2, runsPath3, nowSec2
     windowEnd,
     runDelivered: (row2, now) => rowDelivered(row2, now)
   });
-  const dir = join90(projectPath3, ".roll", "reports", "morning");
-  const latest = join90(dir, "latest.html");
-  const dated = join90(dir, `${new Date(nowSec2 * 1e3).toISOString().slice(0, 10)}.html`);
+  const dir = join91(projectPath3, ".roll", "reports", "morning");
+  const latest = join91(dir, "latest.html");
+  const dated = join91(dir, `${new Date(nowSec2 * 1e3).toISOString().slice(0, 10)}.html`);
   mkdirSync40(dir, { recursive: true });
   const html = renderMorningReportHtml(model);
-  writeFileSync40(latest, html, "utf8");
-  writeFileSync40(dated, html, "utf8");
+  writeFileSync41(latest, html, "utf8");
+  writeFileSync41(dated, html, "utf8");
   try {
     mkdirSync40(dirname40(eventsPath2), { recursive: true });
     appendFileSync18(eventsPath2, `${JSON.stringify({
@@ -256903,20 +257283,20 @@ function announceReport(projectPath3, slug2, storyId, opener = (p) => {
 }) {
   if (storyId === "")
     return null;
-  const report = join91(cardArchiveDir(projectPath3, storyId), "latest", reportFileName(storyId));
-  if (!existsSync86(report))
+  const report = join92(cardArchiveDir(projectPath3, storyId), "latest", reportFileName(storyId));
+  if (!existsSync87(report))
     return null;
   process.stdout.write(`evidence: ${report}
 \u9A8C\u6536\u62A5\u544A: ${report}
 `);
-  const muted = existsSync86(join91(projectPath3, ".roll", "loop", `mute-${slug2}`)) || existsSync86(join91(process.env["ROLL_SHARED_ROOT"] || join91(process.env["HOME"] ?? "", ".shared", "roll"), "loop", `mute-${slug2}`));
+  const muted = existsSync87(join92(projectPath3, ".roll", "loop", `mute-${slug2}`)) || existsSync87(join92(process.env["ROLL_SHARED_ROOT"] || join92(process.env["HOME"] ?? "", ".shared", "roll"), "loop", `mute-${slug2}`));
   if (!muted)
     opener(report);
   return report;
 }
 function resetLiveLog(runtimeDirPath, cycleId) {
   try {
-    writeFileSync41(join91(runtimeDirPath, "live.log"), `=== cycle ${cycleId} ===
+    writeFileSync42(join92(runtimeDirPath, "live.log"), `=== cycle ${cycleId} ===
 `, "utf8");
   } catch {
   }
@@ -256933,7 +257313,7 @@ function cycleSignalTeardown(paths, cycleId, branch, sig, deps = {}) {
   }
   let owned = false;
   try {
-    owned = existsSync86(paths.lockPath) && readLockOwner(paths.lockPath)?.pid === pid;
+    owned = existsSync87(paths.lockPath) && readLockOwner(paths.lockPath)?.pid === pid;
   } catch {
     owned = false;
   }
@@ -257010,7 +257390,7 @@ function makeCycleId(now = /* @__PURE__ */ new Date(), pid = process.pid) {
 }
 function runtimeDir8(projectPath3) {
   const env = (process.env["ROLL_PROJECT_RUNTIME_DIR"] ?? "").trim();
-  return env !== "" ? env : join91(projectPath3, ".roll", "loop");
+  return env !== "" ? env : join92(projectPath3, ".roll", "loop");
 }
 var PAUSE_THRESHOLD = 3;
 var CARD_SKIP_THRESHOLD = 3;
@@ -257041,24 +257421,24 @@ function writeCardSkipAlert(alertsPath, eventsPath2, cycleId, storyId, count) {
 }
 function incrementConsecutiveFails(projectPath3, slug2, alertsPath, eventsPath2, cycleId, storyId, terminal) {
   const rt = runtimeDir8(projectPath3);
-  const counterFile = join91(rt, "consecutive-fails");
+  const counterFile = join92(rt, "consecutive-fails");
   let count = 0;
   try {
-    if (existsSync86(counterFile)) {
-      count = parseInt(readFileSync81(counterFile, "utf8").trim(), 10) || 0;
+    if (existsSync87(counterFile)) {
+      count = parseInt(readFileSync82(counterFile, "utf8").trim(), 10) || 0;
     }
   } catch {
   }
   count += 1;
   try {
-    writeFileSync41(counterFile, String(count), "utf8");
+    writeFileSync42(counterFile, String(count), "utf8");
   } catch {
   }
   const threshold = readFailurePauseThreshold(projectPath3);
   if (count < threshold)
     return;
-  const pauseMarker = join91(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
-  if (existsSync86(pauseMarker))
+  const pauseMarker = join92(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
+  if (existsSync87(pauseMarker))
     return;
   const alertMsg = `# ALERT \u2014 loop auto-paused after ${count} consecutive failures
@@ -257069,7 +257449,7 @@ function incrementConsecutiveFails(projectPath3, slug2, alertsPath, eventsPath2,
   Resolve the root cause, then: \`roll loop resume\`
 `;
   try {
-    writeFileSync41(pauseMarker, alertMsg, "utf8");
+    writeFileSync42(pauseMarker, alertMsg, "utf8");
     appendFileSync19(alertsPath, `${alertMsg}
 `, "utf8");
     const ts2 = Date.now();
@@ -257094,10 +257474,10 @@ loop run-once: \u8FDE\u7EED ${count} \u6B21\u5931\u8D25\u540E\u81EA\u52A8\u6682\
 }
 function readFailurePauseThreshold(projectPath3) {
   try {
-    const policy = join91(projectPath3, ".roll", "policy.yaml");
-    if (!existsSync86(policy))
+    const policy = join92(projectPath3, ".roll", "policy.yaml");
+    if (!existsSync87(policy))
       return PAUSE_THRESHOLD;
-    return parsePolicy(readFileSync81(policy, "utf8")).loopSafety.maxConsecutiveFailures;
+    return parsePolicy(readFileSync82(policy, "utf8")).loopSafety.maxConsecutiveFailures;
   } catch {
     return PAUSE_THRESHOLD;
   }
@@ -257105,25 +257485,34 @@ function readFailurePauseThreshold(projectPath3) {
 function resetConsecutiveFails(projectPath3) {
   const rt = runtimeDir8(projectPath3);
   try {
-    writeFileSync41(join91(rt, "consecutive-fails"), "0", "utf8");
+    writeFileSync42(join92(rt, "consecutive-fails"), "0", "utf8");
+  } catch {
+  }
+}
+async function autoSplitOnExhaustion(storyId, failCount) {
+  process.stdout.write(`loop run-once: ${storyId} \u2014 agents exhausted (${failCount} failed cycles) \u2192 auto-split (FIX-931)
+loop run-once: ${storyId} \u2014 \u4EE3\u7406\u5168\u90E8\u8017\u5C3D(${failCount} \u6B21\u5931\u8D25)\u2192 \u81EA\u52A8\u62C6\u5361(FIX-931)
+`);
+  try {
+    await loopExhaustionSplitCommand([storyId, `${failCount} failed cycles`]);
   } catch {
   }
 }
 function idleCounterPath(projectPath3, slug2) {
-  return join91(runtimeDir8(projectPath3), `consecutive-idle-${slug2}`);
+  return join92(runtimeDir8(projectPath3), `consecutive-idle-${slug2}`);
 }
 function incrementConsecutiveIdle(projectPath3, slug2) {
   const file = idleCounterPath(projectPath3, slug2);
   let count = 0;
   try {
-    if (existsSync86(file)) {
-      count = parseInt(readFileSync81(file, "utf8").trim(), 10) || 0;
+    if (existsSync87(file)) {
+      count = parseInt(readFileSync82(file, "utf8").trim(), 10) || 0;
     }
   } catch {
   }
   count += 1;
   try {
-    writeFileSync41(file, String(count), "utf8");
+    writeFileSync42(file, String(count), "utf8");
   } catch {
   }
   return count;
@@ -257131,7 +257520,7 @@ function incrementConsecutiveIdle(projectPath3, slug2) {
 function resetConsecutiveIdle(projectPath3, slug2) {
   const file = idleCounterPath(projectPath3, slug2);
   try {
-    writeFileSync41(file, "0", "utf8");
+    writeFileSync42(file, "0", "utf8");
   } catch {
   }
 }
@@ -257181,9 +257570,9 @@ function readExternalBlock(eventsPath2, cycleId) {
   const authDetails = [];
   const networkDetails = [];
   try {
-    if (!existsSync86(eventsPath2))
+    if (!existsSync87(eventsPath2))
       return null;
-    for (const line of readFileSync81(eventsPath2, "utf8").split("\n")) {
+    for (const line of readFileSync82(eventsPath2, "utf8").split("\n")) {
       if (line.trim() === "" || !line.includes("agent:blocked"))
         continue;
       let e;
@@ -257239,10 +257628,10 @@ function writeReviewerBlockedAlert(projectPath3, slug2, alertsPath, eventsPath2,
   } catch {
   }
   if (block.cause === "auth") {
-    const pauseMarker = join91(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
-    if (!existsSync86(pauseMarker)) {
+    const pauseMarker = join92(projectPath3, ".roll", "loop", `PAUSE-${slug2}`);
+    if (!existsSync87(pauseMarker)) {
       try {
-        writeFileSync41(pauseMarker, msg6, "utf8");
+        writeFileSync42(pauseMarker, msg6, "utf8");
         bus.appendEvent(eventsPath2, { type: "policy:safety_pause", loop: "ci", reason: `agent auth block: ${agents}`, ts: ts2 });
       } catch {
       }
@@ -257259,15 +257648,15 @@ function readSkillBody2(projectPath3) {
 }
 function buildLoopRouteDeps(projectPath3) {
   function readSlot(slot) {
-    const agentsYaml = join91(projectPath3, ".roll", "agents.yaml");
+    const agentsYaml = join92(projectPath3, ".roll", "agents.yaml");
     try {
-      return readSlotFromText(readFileSync81(agentsYaml, "utf8"), slot);
+      return readSlotFromText(readFileSync82(agentsYaml, "utf8"), slot);
     } catch {
       return void 0;
     }
   }
   function firstInstalled() {
-    const fromLocal = readField(join91(projectPath3, ".roll", "local.yaml"), /^agent:/);
+    const fromLocal = readField(join92(projectPath3, ".roll", "local.yaml"), /^agent:/);
     if (fromLocal !== void 0)
       return fromLocal;
     return firstInstalledAgent(realAgentEnv());
@@ -257276,7 +257665,7 @@ function buildLoopRouteDeps(projectPath3) {
 }
 function readField(path, re) {
   try {
-    const text2 = readFileSync81(path, "utf8");
+    const text2 = readFileSync82(path, "utf8");
     for (const line of text2.split("\n")) {
       const m7 = line.match(re);
       if (m7 !== null) {
@@ -257318,15 +257707,15 @@ async function loopRunOnceCommand(args) {
     return 0;
   }
   const rt = runtimeDir8(id.path);
-  const alertsPath = join91(rt, `ALERT-${id.slug}.md`);
+  const alertsPath = join92(rt, `ALERT-${id.slug}.md`);
   mkdirSync41(dirname41(alertsPath), { recursive: true });
   const paths = {
-    eventsPath: join91(rt, "events.ndjson"),
-    runsPath: join91(rt, "runs.jsonl"),
+    eventsPath: join92(rt, "events.ndjson"),
+    runsPath: join92(rt, "runs.jsonl"),
     alertsPath,
-    lockPath: join91(rt, "inner.lock"),
-    heartbeatPath: join91(rt, "heartbeat"),
-    worktreePath: join91(rt, "worktrees", `cycle-${cycleId}`)
+    lockPath: join92(rt, "inner.lock"),
+    heartbeatPath: join92(rt, "heartbeat"),
+    worktreePath: join92(rt, "worktrees", `cycle-${cycleId}`)
   };
   {
     const lang9 = resolveLang({
@@ -257368,7 +257757,7 @@ async function loopRunOnceCommand(args) {
     process.stderr.write(`loop run-once: roll-loop SKILL.md not found \u2014 refusing to spawn a blind agent (ALERT written)
 loop run-once: \u627E\u4E0D\u5230 roll-loop SKILL.md \u2014 \u62D2\u7EDD\u76F2\u5F00 agent(\u5DF2\u5199 ALERT)
 `);
-    incrementConsecutiveFails(id.path, id.slug, alertsPath, join91(rt, "events.ndjson"), cycleId, "", "skill_missing");
+    incrementConsecutiveFails(id.path, id.slug, alertsPath, join92(rt, "events.ndjson"), cycleId, "", "skill_missing");
     return 1;
   }
   const routeDeps = buildLoopRouteDeps(id.path);
@@ -257436,6 +257825,7 @@ loop run-once: \u8BC4\u5BA1\u5224\u5B9A ${resizeStory} \u8303\u56F4\u8FC7\u5927(
     resetConsecutiveFails(id.path);
     resetConsecutiveIdle(id.path, id.slug);
     clearCardFailure(runtimeDir8(id.path), storyId);
+    clearSelfHeal(runtimeDir8(id.path), storyId);
   }
   if (result.terminal === "published") {
     process.stdout.write("loop run-once: delivery published \u2014 PR open, merge pending (PR loop merges; backfill credits on merge evidence)\nloop run-once: \u4EA4\u4ED8\u5DF2\u53D1\u5E03\u2014\u2014PR \u5DF2\u5F00,\u7B49\u5F85\u5408\u5E76(PR loop \u8D1F\u8D23\u5408\u5E76;\u5408\u5E76\u8BC1\u636E\u843D\u5730\u540E\u7531\u56DE\u586B\u8BB0\u8D26)\n");
@@ -257446,6 +257836,7 @@ loop run-once: \u8BC4\u5BA1\u5224\u5B9A ${resizeStory} \u8303\u56F4\u8FC7\u5927(
     resetConsecutiveFails(id.path);
     resetConsecutiveIdle(id.path, id.slug);
     clearCardFailure(runtimeDir8(id.path), storyId);
+    clearSelfHeal(runtimeDir8(id.path), storyId);
     process.stdout.write("loop run-once: gates passed but publish did not complete \u2014 work committed locally on the branch, not published (unpublished, not a failure)\nloop run-once: \u95F8\u5DF2\u901A\u8FC7\u4F46\u672A\u5B8C\u6210\u53D1\u5E03\u2014\u2014\u5DE5\u4F5C\u5DF2\u5728\u5206\u652F\u4E0A\u672C\u5730\u63D0\u4EA4,\u5C1A\u672A\u53D1\u5E03(\u672A\u53D1\u5E03,\u975E\u5931\u8D25)\n");
   }
   if (result.terminal === "idle") {
@@ -257453,13 +257844,13 @@ loop run-once: \u8BC4\u5BA1\u5224\u5B9A ${resizeStory} \u8303\u56F4\u8FC7\u5927(
     const idleCount = incrementConsecutiveIdle(id.path, id.slug);
     try {
       const bus = new EventBus();
-      const backlogFile = join91(id.path, ".roll", "backlog.md");
+      const backlogFile = join92(id.path, ".roll", "backlog.md");
       const nowSec2 = Math.floor(Date.now() / 1e3);
       const outcome = await maybeEnterDormancy({
         slug: id.slug,
         count: idleCount,
         resolveState: () => resolveLoopRunState(id.path, id.slug),
-        readBacklog: () => existsSync86(backlogFile) ? readFileSync81(backlogFile, "utf8") : "",
+        readBacklog: () => existsSync87(backlogFile) ? readFileSync82(backlogFile, "utf8") : "",
         scheduler: createScheduler(process.platform, { uid: process.getuid?.() ?? 0 }),
         loopLabel: launchdLabel("loop", id.slug),
         now: () => (/* @__PURE__ */ new Date()).toISOString(),
@@ -257467,9 +257858,9 @@ loop run-once: \u8BC4\u5BA1\u5224\u5B9A ${resizeStory} \u8303\u56F4\u8FC7\u5927(
         writeDormant: (body) => writeDormantMarker(dormantMarkerPath(id.path, id.slug), body),
         upsertDormantRun: () => bus.upsertRun(paths.runsPath, { storyId: "", cycleId }, buildRunRow({ kind: "append_run", status: "dormant", outcome: mapV2Status("dormant"), cycleId }, { cycleId, branch, loop: "ci" }, nowSec2)),
         writePause: (reason) => {
-          const p = join91(id.path, ".roll", "loop", `PAUSE-${id.slug}`);
+          const p = join92(id.path, ".roll", "loop", `PAUSE-${id.slug}`);
           mkdirSync41(dirname41(p), { recursive: true });
-          writeFileSync41(p, `# loop paused \u2014 dormancy bootout failed
+          writeFileSync42(p, `# loop paused \u2014 dormancy bootout failed
 ${reason}
 `, "utf8");
@@ -257491,6 +257882,54 @@ loop run-once: cycle ${cycleId} \u2192 ${externalBlock.cause}_blocked(\u53EF\u60
     writeReviewerBlockedAlert(id.path, id.slug, alertsPath, paths.eventsPath, cycleId, externalBlock);
     return externalBlock.cause === "auth" ? 0 : isFail ? 1 : 0;
   }
+  {
+    const sid = (result.state?.ctx?.storyId ?? "").trim();
+    const tcr = result.state?.ctx?.tcrCount ?? 0;
+    const failedAgent = (result.state?.ctx?.agent ?? "").trim();
+    const zeroTcr = tcr === 0 && (result.terminal === "gave_up" || result.terminal === "blocked");
+    if (sid !== "" && failedAgent !== "" && zeroTcr) {
+      const backlogFile = join92(id.path, ".roll", "backlog.md");
+      const bus = new EventBus();
+      const swapped = autoRecoverEnabled() ? maybeSwitchAgent({
+        runtimeDir: runtimeDir8(id.path),
+        storyId: sid,
+        failedAgent,
+        reason: result.terminal === "blocked" ? "stall" : "zero-tcr",
+        estMin: parseEstMin(readBacklogRow(id.path, sid).description ?? ""),
+        routeDeps,
+        budget: selfHealBudget(),
+        cycleId,
+        now: () => Math.floor(Date.now() / 1e3),
+        emit: (ev) => bus.appendEvent(paths.eventsPath, ev),
+        remarkTodo: (storyId) => {
+          try {
+            const content = readFileSync82(backlogFile, "utf8");
+            const r = markStatus(content, storyId, STATUS_MARKER.todo);
+            if (r.count > 0)
+              writeFileSync42(backlogFile, r.content, "utf8");
+          } catch {
+          }
+        }
+      }) : false;
+      if (swapped) {
+        resetConsecutiveIdle(id.path, id.slug);
+        process.stdout.write(`loop run-once: zero-TCR on ${sid} (${failedAgent}) \u2014 auto-switching agent next cycle (self-heal)
+loop run-once: ${sid} \u96F6\u4EA7\u51FA(${failedAgent})\u2014\u2014\u4E0B\u4E00\u5468\u671F\u81EA\u52A8\u6362\u4EE3\u7406(\u81EA\u6108)
+`);
+        return 0;
+      }
+      if (result.terminal === "gave_up") {
+        const card = recordCardFailure(runtimeDir8(id.path), sid, CARD_SKIP_THRESHOLD);
+        if (card.nowSkipped) {
+          writeCardSkipAlert(alertsPath, paths.eventsPath, cycleId, sid, card.count);
+          resetConsecutiveFails(id.path);
+          clearSelfHeal(runtimeDir8(id.path), sid);
+          if (autoRecoverEnabled())
+            await autoSplitOnExhaustion(sid, card.count);
+        }
+      }
+    }
+  }
   if (isFail) {
     resetConsecutiveIdle(id.path, id.slug);
     if (await isOffline()) {
@@ -257508,6 +257947,10 @@ loop run-once: cycle ${cycleId} \u2192 ${externalBlock.cause}_blocked(\u53EF\u60
       if (card.nowSkipped) {
         writeCardSkipAlert(alertsPath, paths.eventsPath, cycleId, storyId, card.count);
         resetConsecutiveFails(id.path);
+        if (result.terminal === "blocked" && autoRecoverEnabled()) {
+          clearSelfHeal(runtimeDir8(id.path), storyId);
+          await autoSplitOnExhaustion(storyId, card.count);
+        }
       } else {
         incrementConsecutiveFails(id.path, id.slug, alertsPath, paths.eventsPath, cycleId, storyId, result.terminal ?? "unknown");
       }
@@ -257573,9 +258016,9 @@ async function isOffline(resolve9 = (h) => lookup2(h)) {
 // packages/cli/dist/commands/offboard.js
 init_dist();
 import { spawnSync as spawnSync10 } from "node:child_process";
-import { existsSync as existsSync87, readFileSync as readFileSync82, realpathSync as realpathSync10, rmSync as rmSync16, writeFileSync as writeFileSync42 } from "node:fs";
+import { existsSync as existsSync88, readFileSync as readFileSync83, realpathSync as realpathSync10, rmSync as rmSync16, writeFileSync as writeFileSync43 } from "node:fs";
 import { homedir as homedir23 } from "node:os";
-import { join as join92, resolve as resolve7 } from "node:path";
+import { join as join93, resolve as resolve7 } from "node:path";
 function pal5() {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   return noColor2 ? { RED: "", GREEN: "", YELLOW: "", CYAN: "", BOLD: "", NC: "" } : {
@@ -257613,7 +258056,7 @@ function m4(key, ...args) {
   return t(v2Catalog, msgLang7(), key, ...args);
 }
 function changesetPath2(projectDir) {
-  return join92(projectDir, ".roll", "onboard-changeset.yaml");
+  return join93(projectDir, ".roll", "onboard-changeset.yaml");
 }
 function loopInCycle2() {
   return (process.env["ROLL_LOOP_AGENT"] ?? "") !== "" || (process.env["ROLL_CYCLE_LOG_RAW"] ?? "") !== "";
@@ -257623,7 +258066,7 @@ function runLaunchctl(args) {
   if (args[0] !== void 0 && readOnly.has(args[0])) {
     return spawnSync10("launchctl", args, { stdio: "inherit" }).status ?? 1;
   }
-  const canonical = join92(homedir23(), "Library", "LaunchAgents");
+  const canonical = join93(homedir23(), "Library", "LaunchAgents");
   const launchdDir = process.env["_LAUNCHD_DIR"] ?? canonical;
   if (launchdDir !== canonical)
     return 0;
@@ -257687,7 +258130,7 @@ function offboardCommand(args) {
     projectDir = process.cwd();
   }
   const changeset = changesetPath2(projectDir);
-  if (!existsSync87(changeset)) {
+  if (!existsSync88(changeset)) {
     err10(m4("offboard.no_changeset_en"));
     err10(m4("offboard.no_changeset_zh"));
     process.stderr.write("\n");
@@ -257701,7 +258144,7 @@ function offboardCommand(args) {
 `);
     return 1;
   }
-  const parsed = parseChangeset(readFileSync82(changeset, "utf8"));
+  const parsed = parseChangeset(readFileSync83(changeset, "utf8"));
   if (!parsed.ok) {
     err10(m4("offboard.failed_to_parse_changeset"));
     return 1;
@@ -257777,8 +258220,8 @@ function offboardCommand(args) {
   process.stdout.write(m4("offboard.applying_offboard") + "\n");
   for (const item of files) {
     try {
-      rmSync16(join92(projectDir, item), { force: true });
-      if (!existsSync87(join92(projectDir, item)))
+      rmSync16(join93(projectDir, item), { force: true });
+      if (!existsSync88(join93(projectDir, item)))
         process.stdout.write(`    removed file ${item}
 `);
     } catch {
@@ -257786,26 +258229,26 @@ function offboardCommand(args) {
   }
   for (const item of dirs) {
     try {
-      rmSync16(join92(projectDir, item), { recursive: true, force: true });
+      rmSync16(join93(projectDir, item), { recursive: true, force: true });
       process.stdout.write(`    removed dir  ${item}
 `);
     } catch {
     }
   }
   for (const item of giEntries) {
-    const gi = join92(projectDir, ".gitignore");
-    if (existsSync87(gi)) {
-      const lines2 = readFileSync82(gi, "utf8").split("\n");
+    const gi = join93(projectDir, ".gitignore");
+    if (existsSync88(gi)) {
+      const lines2 = readFileSync83(gi, "utf8").split("\n");
       if (lines2.includes(item)) {
         const kept = lines2.filter((l) => l !== item);
-        writeFileSync42(gi, kept.join("\n"));
+        writeFileSync43(gi, kept.join("\n"));
         process.stdout.write(`    .gitignore -   ${item}
 `);
       }
     }
   }
   for (const item of plists) {
-    const plistPath = join92(homedir23(), "Library", "LaunchAgents", item);
+    const plistPath = join93(homedir23(), "Library", "LaunchAgents", item);
     const r = runLaunchctl(["unload", "-w", plistPath]);
     if (r === 0)
       process.stdout.write(`    unloaded     ${item}
@@ -257819,13 +258262,13 @@ function offboardCommand(args) {
 // packages/cli/dist/commands/prices.js
 init_dist();
-import { existsSync as existsSync89, readdirSync as readdirSync36, readFileSync as readFileSync84 } from "node:fs";
-import { join as join94 } from "node:path";
+import { existsSync as existsSync90, readdirSync as readdirSync36, readFileSync as readFileSync85 } from "node:fs";
+import { join as join95 } from "node:path";
 // packages/cli/dist/commands/prices-refresh.js
 init_dist();
-import { existsSync as existsSync88, mkdirSync as mkdirSync42, readdirSync as readdirSync35, readFileSync as readFileSync83, writeFileSync as writeFileSync43 } from "node:fs";
-import { join as join93 } from "node:path";
+import { existsSync as existsSync89, mkdirSync as mkdirSync42, readdirSync as readdirSync35, readFileSync as readFileSync84, writeFileSync as writeFileSync44 } from "node:fs";
+import { join as join94 } from "node:path";
 var FetchError = class extends Error {
   constructor(message) {
     super(message);
@@ -258046,13 +258489,13 @@ function vendorFromSnapshotName(name) {
   return match[2] ?? "anthropic";
 }
 function latestSnapshotPath(snapshotDir, vendor) {
-  if (!existsSync88(snapshotDir))
+  if (!existsSync89(snapshotDir))
     return null;
-  const snaps = readdirSync35(snapshotDir).filter((name) => SNAPSHOT_RE.test(name) && vendorFromSnapshotName(name) === vendor).sort().map((name) => join93(snapshotDir, name));
+  const snaps = readdirSync35(snapshotDir).filter((name) => SNAPSHOT_RE.test(name) && vendorFromSnapshotName(name) === vendor).sort().map((name) => join94(snapshotDir, name));
   return snaps[snaps.length - 1] ?? null;
 }
 function readPrices(path) {
-  const data = JSON.parse(readFileSync83(path, "utf8"));
+  const data = JSON.parse(readFileSync84(path, "utf8"));
   return data.prices ?? {};
 }
 function diffPrices(oldPrices, newPrices) {
@@ -258145,8 +258588,8 @@ function snapshotJson(payload) {
 function writeSnapshot(input) {
   mkdirSync42(input.snapshotDir, { recursive: true });
   const suffix = input.vendor === "anthropic" ? "" : `-${input.vendor}`;
-  const dest = join93(input.snapshotDir, `snapshot-${input.effectiveAt}${suffix}.json`);
-  writeFileSync43(dest, snapshotJson({
+  const dest = join94(input.snapshotDir, `snapshot-${input.effectiveAt}${suffix}.json`);
+  writeFileSync44(dest, snapshotJson({
     version: input.effectiveAt,
     effective_at: input.effectiveAt,
     source_url: input.sourceUrl,
@@ -258217,7 +258660,7 @@ async function pricesRefreshCommand(args, deps = {}) {
   } else {
     vendor = "anthropic";
   }
-  const snapshotDir = deps.snapshotDir ?? join93(repoRoot2(), "lib", "prices");
+  const snapshotDir = deps.snapshotDir ?? join94(repoRoot2(), "lib", "prices");
   try {
     const result = await refresh({ snapshotDir, vendor, url, deps });
     if (result.action === "unchanged") {
@@ -258254,13 +258697,13 @@ async function pricesRefreshCommand(args, deps = {}) {
 // packages/cli/dist/commands/prices.js
 function loadSnapshots() {
-  const dir = join94(repoRoot2(), "lib", "prices");
-  if (!existsSync89(dir)) {
+  const dir = join95(repoRoot2(), "lib", "prices");
+  if (!existsSync90(dir)) {
     throw new Error(`no price snapshots found in ${dir}; run \`roll prices refresh\``);
   }
   const files = readdirSync36(dir).filter((n) => n.startsWith("snapshot-") && n.endsWith(".json")).sort();
   return files.map((name) => {
-    const data = JSON.parse(readFileSync84(join94(dir, name), "utf8"));
+    const data = JSON.parse(readFileSync85(join95(dir, name), "utf8"));
     for (const key of ["version", "effective_at", "source_url", "prices"]) {
       if (data[key] === void 0)
         throw new Error(`snapshot ${name} missing required key ${key}`);
@@ -258439,24 +258882,24 @@ init_dist3();
 init_dist();
 init_render();
 import { execFileSync as execFileSync24 } from "node:child_process";
-import { readFileSync as readFileSync88, writeFileSync as writeFileSync47, existsSync as existsSync93 } from "node:fs";
-import { join as join98 } from "node:path";
+import { readFileSync as readFileSync89, writeFileSync as writeFileSync48, existsSync as existsSync94 } from "node:fs";
+import { join as join99 } from "node:path";
 // packages/cli/dist/lib/release-consistency.js
 init_dist2();
 init_dist();
 init_render();
 import { execFileSync as execFileSync23 } from "node:child_process";
-import { existsSync as existsSync91, mkdirSync as mkdirSync44, readFileSync as readFileSync86, readdirSync as readdirSync38, statSync as statSync27, writeFileSync as writeFileSync45 } from "node:fs";
-import { dirname as dirname43, join as join96 } from "node:path";
+import { existsSync as existsSync92, mkdirSync as mkdirSync44, readFileSync as readFileSync87, readdirSync as readdirSync38, statSync as statSync27, writeFileSync as writeFileSync46 } from "node:fs";
+import { dirname as dirname43, join as join97 } from "node:path";
 // packages/cli/dist/lib/consistency-audit.js
 init_dist2();
 init_dist3();
 init_dist();
 import { execFile as execFile12 } from "node:child_process";
-import { existsSync as existsSync90, mkdirSync as mkdirSync43, readFileSync as readFileSync85, readdirSync as readdirSync37, writeFileSync as writeFileSync44 } from "node:fs";
-import { dirname as dirname42, join as join95 } from "node:path";
+import { existsSync as existsSync91, mkdirSync as mkdirSync43, readFileSync as readFileSync86, readdirSync as readdirSync37, writeFileSync as writeFileSync45 } from "node:fs";
+import { dirname as dirname42, join as join96 } from "node:path";
 import { promisify as promisify12 } from "node:util";
 init_dist();
 init_dist();
@@ -258464,10 +258907,10 @@ var PROBE_CAP = 20;
 var COUNT_WINDOW_SEC = 72 * 3600;
 var execFileAsync12 = promisify12(execFile12);
 function readJsonl(path) {
-  if (!existsSync90(path))
+  if (!existsSync91(path))
     return [];
   const out3 = [];
-  for (const line of readFileSync85(path, "utf8").split("\n")) {
+  for (const line of readFileSync86(path, "utf8").split("\n")) {
     if (line.trim() === "")
       continue;
     try {
@@ -258480,10 +258923,10 @@ function readJsonl(path) {
   return out3;
 }
 function readJson(path) {
-  if (!existsSync90(path))
+  if (!existsSync91(path))
     return null;
   try {
-    const parsed = JSON.parse(readFileSync85(path, "utf8"));
+    const parsed = JSON.parse(readFileSync86(path, "utf8"));
     return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
   } catch {
     return null;
@@ -258491,7 +258934,7 @@ function readJson(path) {
 }
 function hasScreenshotArtifact(reportPath) {
   const runDir = dirname42(reportPath);
-  const manifest = readJson(join95(runDir, "evidence.json"));
+  const manifest = readJson(join96(runDir, "evidence.json"));
   if (manifest !== null) {
     const screenshots = manifest["screenshots"];
     if (Array.isArray(screenshots) && screenshots.some((x) => typeof x === "string" && x !== ""))
@@ -258507,8 +258950,8 @@ function hasScreenshotArtifact(reportPath) {
       }
     }
   }
-  const dir = join95(runDir, "screenshots");
-  if (!existsSync90(dir))
+  const dir = join96(runDir, "screenshots");
+  if (!existsSync91(dir))
     return false;
   try {
     return readdirSync37(dir).some((name) => /\.png$/i.test(name));
@@ -258517,7 +258960,7 @@ function hasScreenshotArtifact(reportPath) {
   }
 }
 function hasMachineCaptureSkip2(reportPath) {
-  const manifest = readJson(join95(dirname42(reportPath), "evidence.json"));
+  const manifest = readJson(join96(dirname42(reportPath), "evidence.json"));
   const captures = manifest?.["captures"];
   if (!Array.isArray(captures))
     return false;
@@ -258544,18 +258987,18 @@ async function gatherAuditSnapshot(projectPath3, runtimeDir9, deps = {}) {
   const nowSec2 = deps.nowSec ?? Math.floor(Date.now() / 1e3);
   const snapshot = emptyAuditSnapshot(nowSec2, TERMINAL_SCHEMA_EPOCH_SEC);
   const skipped = [];
-  const backlogPath = join95(projectPath3, ".roll", "backlog.md");
-  if (existsSync90(backlogPath)) {
-    snapshot.backlog = parseBacklog(readFileSync85(backlogPath, "utf8")).map((r) => ({ id: r.id, status: r.status }));
+  const backlogPath = join96(projectPath3, ".roll", "backlog.md");
+  if (existsSync91(backlogPath)) {
+    snapshot.backlog = parseBacklog(readFileSync86(backlogPath, "utf8")).map((r) => ({ id: r.id, status: r.status }));
   }
   snapshot.index = readIndex(projectPath3);
   snapshot.localMainAhead = deps.localMainAhead !== void 0 ? await deps.localMainAhead() : await gitLocalMainAhead(projectPath3);
-  snapshot.runs = readJsonl(join95(runtimeDir9, "runs.jsonl"));
+  snapshot.runs = readJsonl(join96(runtimeDir9, "runs.jsonl"));
   let eventFailed = 0;
   const terminal = [];
-  const eventsPath2 = join95(runtimeDir9, "events.ndjson");
-  if (existsSync90(eventsPath2)) {
-    for (const line of readFileSync85(eventsPath2, "utf8").split("\n")) {
+  const eventsPath2 = join96(runtimeDir9, "events.ndjson");
+  if (existsSync91(eventsPath2)) {
+    for (const line of readFileSync86(eventsPath2, "utf8").split("\n")) {
       const e = parseEventLine(line);
       if (e === null)
         continue;
@@ -258577,22 +259020,22 @@ async function gatherAuditSnapshot(projectPath3, runtimeDir9, deps = {}) {
     if (!row2.status.includes("\u2705"))
       continue;
     const card = cardArchiveDir(projectPath3, row2.id);
-    if (!existsSync90(card))
+    if (!existsSync91(card))
       continue;
-    const reportPath = join95(card, "latest", reportFileName(row2.id));
-    const specPath = join95(card, "spec.md");
+    const reportPath = join96(card, "latest", reportFileName(row2.id));
+    const specPath = join96(card, "spec.md");
     let noVisualSurface = false;
-    if (existsSync90(specPath)) {
+    if (existsSync91(specPath)) {
       try {
-        noVisualSurface = !hasVisualEvidenceAc(readFileSync85(specPath, "utf8"));
+        noVisualSurface = !hasVisualEvidenceAc(readFileSync86(specPath, "utf8"));
       } catch {
       }
     }
     snapshot.attest[row2.id] = {
-      report: existsSync90(reportPath),
-      acMap: existsSync90(join95(card, "ac-map.json")),
-      visualEvidence: existsSync90(reportPath) ? hasScreenshotArtifact(reportPath) : false,
-      machineSkip: existsSync90(reportPath) ? hasMachineCaptureSkip2(reportPath) : false,
+      report: existsSync91(reportPath),
+      acMap: existsSync91(join96(card, "ac-map.json")),
+      visualEvidence: existsSync91(reportPath) ? hasScreenshotArtifact(reportPath) : false,
+      machineSkip: existsSync91(reportPath) ? hasMachineCaptureSkip2(reportPath) : false,
       noVisualSurface
     };
   }
@@ -258676,16 +259119,16 @@ async function consistencyAuditCommand(args, deps = {}) {
   const json = args.includes("--json");
   const projectPath3 = process.cwd();
   const rtEnv = (process.env["ROLL_PROJECT_RUNTIME_DIR"] ?? "").trim();
-  const runtimeDir9 = rtEnv !== "" ? rtEnv : join95(projectPath3, ".roll", "loop");
+  const runtimeDir9 = rtEnv !== "" ? rtEnv : join96(projectPath3, ".roll", "loop");
   const { snapshot, skipped } = await gatherAuditSnapshot(projectPath3, runtimeDir9, deps);
   const report = runConsistencyAudit(snapshot);
   const nowMs = (deps.nowSec ?? Math.floor(Date.now() / 1e3)) * 1e3;
   const dateTag = new Date(nowMs).toISOString().slice(0, 10);
-  const outDir = join95(projectPath3, ".roll", "reports", "consistency");
+  const outDir = join96(projectPath3, ".roll", "reports", "consistency");
   try {
     mkdirSync43(outDir, { recursive: true });
-    writeFileSync44(join95(outDir, `${dateTag}.json`), JSON.stringify({ generatedAt: dateTag, ...report, skipped }, null, 1));
-    writeFileSync44(join95(outDir, `${dateTag}.md`), renderMarkdown2(report, skipped, dateTag));
+    writeFileSync45(join96(outDir, `${dateTag}.json`), JSON.stringify({ generatedAt: dateTag, ...report, skipped }, null, 1));
+    writeFileSync45(join96(outDir, `${dateTag}.md`), renderMarkdown2(report, skipped, dateTag));
   } catch {
     process.stderr.write("consistency audit: report write failed (scan still completed)\n");
   }
@@ -258693,7 +259136,7 @@ async function consistencyAuditCommand(args, deps = {}) {
     process.stdout.write(JSON.stringify({ ...report, skipped }, null, 1) + "\n");
   } else {
     process.stdout.write(`consistency audit (shadow): fail ${report.summary.fail} \xB7 warn ${report.summary.warn} \xB7 unknown ${report.summary.unknown} \xB7 grandfathered ${report.summary.grandfathered}
-\u4E00\u81F4\u6027\u5BA1\u8BA1(\u5F71\u5B50\u6A21\u5F0F): \u62A5\u544A\u5DF2\u5199\u5165 ${join95(".roll", "reports", "consistency", `${dateTag}.md`)}
+\u4E00\u81F4\u6027\u5BA1\u8BA1(\u5F71\u5B50\u6A21\u5F0F): \u62A5\u544A\u5DF2\u5199\u5165 ${join96(".roll", "reports", "consistency", `${dateTag}.md`)}
 `);
     for (const f of report.findings.filter((x) => x.severity === "fail").slice(0, 10)) {
       process.stdout.write(`  \u2717 ${f.rule} ${f.subject} \u2014 ${f.detail}
@@ -258731,7 +259174,7 @@ function escapeRegExp3(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function readText(p) {
-  return readFileSync86(p, "utf8");
+  return readFileSync87(p, "utf8");
 }
 var COMMAND_SURFACE_REPLACEMENTS = /* @__PURE__ */ new Map([
   ["migrate", "npx @seanyao/roll@2 migrate"],
@@ -258749,7 +259192,7 @@ function lineNumberAt(text2, index) {
   return text2.slice(0, index).split("\n").length;
 }
 function existingTextFiles(projectDir, rels) {
-  return rels.map((rel) => ({ rel, abs: join96(projectDir, rel) })).filter((f) => {
+  return rels.map((rel) => ({ rel, abs: join97(projectDir, rel) })).filter((f) => {
     try {
       return statSync27(f.abs).isFile();
     } catch {
@@ -258760,7 +259203,7 @@ function existingTextFiles(projectDir, rels) {
 function walkTextFiles(projectDir, relDir, extensions) {
   const out3 = [];
   const walk2 = (dirRel) => {
-    const dirAbs = join96(projectDir, dirRel);
+    const dirAbs = join97(projectDir, dirRel);
     let entries;
     try {
       entries = readdirSync38(dirAbs, { withFileTypes: true });
@@ -258768,7 +259211,7 @@ function walkTextFiles(projectDir, relDir, extensions) {
       return;
     }
     for (const entry of entries) {
-      const rel = join96(dirRel, entry.name);
+      const rel = join97(dirRel, entry.name);
       if (entry.isDirectory()) {
         walk2(rel);
         continue;
@@ -258776,7 +259219,7 @@ function walkTextFiles(projectDir, relDir, extensions) {
       const dot = entry.name.lastIndexOf(".");
       const ext = dot === -1 ? "" : entry.name.slice(dot);
       if (entry.isFile() && extensions.has(ext))
-        out3.push({ rel, abs: join96(projectDir, rel) });
+        out3.push({ rel, abs: join97(projectDir, rel) });
     }
   };
   walk2(relDir);
@@ -258902,14 +259345,14 @@ var nodeFreshnessPort2 = {
   },
   readText(absPath) {
     try {
-      return readFileSync86(absPath, "utf8");
+      return readFileSync87(absPath, "utf8");
     } catch {
       return "";
     }
   },
   writeText(absPath, text2) {
     mkdirSync44(dirname43(absPath), { recursive: true });
-    writeFileSync45(absPath, text2, "utf8");
+    writeFileSync46(absPath, text2, "utf8");
   }
 };
 var quietExecPort = {
@@ -258946,13 +259389,13 @@ function mergeShasFromStatus(status2) {
   return shas;
 }
 function findCardSpec(projectDir, id) {
-  const featuresDir = join96(projectDir, ".roll", "features");
+  const featuresDir = join97(projectDir, ".roll", "features");
   try {
     for (const epic of readdirSync38(featuresDir, { withFileTypes: true })) {
       if (!epic.isDirectory())
         continue;
-      const spec = join96(featuresDir, epic.name, id, "spec.md");
-      if (existsSync91(spec))
+      const spec = join97(featuresDir, epic.name, id, "spec.md");
+      if (existsSync92(spec))
         return spec;
     }
   } catch {
@@ -258970,13 +259413,13 @@ function cardChangelogExempt(projectDir, id) {
   }
 }
 function checkFeaturesCatalog(projectDir) {
-  const backlog = join96(projectDir, ".roll", "backlog.md");
-  if (!existsSync91(backlog))
+  const backlog = join97(projectDir, ".roll", "backlog.md");
+  if (!existsSync92(backlog))
     return { status: "pass", gaps: [] };
   const backlogText = readText(backlog);
   const gaps = [];
-  const features = join96(projectDir, ".roll", "features.md");
-  if (existsSync91(features)) {
+  const features = join97(projectDir, ".roll", "features.md");
+  if (existsSync92(features)) {
     const featuresText = readText(features);
     for (const featName of readDoneFeatures(backlogText).keys()) {
       const escaped = escapeRegExp3(featName);
@@ -258999,8 +259442,8 @@ function checkFeaturesCatalog(projectDir) {
   return { status: gaps.length === 0 ? "pass" : "fail", gaps };
 }
 function checkTruthLive(projectDir) {
-  const backlog = join96(projectDir, ".roll", "backlog.md");
-  if (!existsSync91(backlog))
+  const backlog = join97(projectDir, ".roll", "backlog.md");
+  if (!existsSync92(backlog))
     return { status: "pass", gaps: [] };
   const backlogText = readText(backlog);
   const facts = backlogRowFacts(backlogText);
@@ -259036,19 +259479,19 @@ function checkTruthLive(projectDir) {
   return { status: gaps.length === 0 ? "pass" : "fail", gaps };
 }
 function checkCards(projectDir) {
-  const backlog = join96(projectDir, ".roll", "backlog.md");
-  const featuresDir = join96(projectDir, ".roll", "features");
-  if (!existsSync91(backlog) || !existsSync91(featuresDir))
+  const backlog = join97(projectDir, ".roll", "backlog.md");
+  const featuresDir = join97(projectDir, ".roll", "features");
+  if (!existsSync92(backlog) || !existsSync92(featuresDir))
     return { status: "pass", gaps: [] };
   const cardEpic = /* @__PURE__ */ new Map();
   try {
     for (const epic of readdirSync38(featuresDir, { withFileTypes: true })) {
       if (!epic.isDirectory())
         continue;
-      for (const card of readdirSync38(join96(featuresDir, epic.name), { withFileTypes: true })) {
+      for (const card of readdirSync38(join97(featuresDir, epic.name), { withFileTypes: true })) {
         if (!card.isDirectory())
           continue;
-        if (existsSync91(join96(featuresDir, epic.name, card.name, "spec.md")) && !cardEpic.has(card.name)) {
+        if (existsSync92(join97(featuresDir, epic.name, card.name, "spec.md")) && !cardEpic.has(card.name)) {
           cardEpic.set(card.name, epic.name);
         }
       }
@@ -259058,7 +259501,7 @@ function checkCards(projectDir) {
   }
   const hasAcBlock = (epic, id) => {
     try {
-      return /\*\*AC:\*\*[\s\S]*?-\s+\[[ xX]\]\s+/.test(readText(join96(featuresDir, epic, id, "spec.md")));
+      return /\*\*AC:\*\*[\s\S]*?-\s+\[[ xX]\]\s+/.test(readText(join97(featuresDir, epic, id, "spec.md")));
     } catch {
       return true;
     }
@@ -259081,12 +259524,12 @@ function checkCards(projectDir) {
     const ev = /\[evidence\]\(([^)]+)\)/.exec(line);
     if (ev !== null) {
       const target = (ev[1] ?? "").replace(/^\.roll\//, "");
-      if (!existsSync91(join96(projectDir, ".roll", target))) {
+      if (!existsSync92(join97(projectDir, ".roll", target))) {
         gaps.push(`Backlog row ${id} evidence link is broken: ${ev[1] ?? ""}`);
       }
     } else if (line.includes(STATUS_MARKER.done)) {
       const epic = cardEpic.get(id) ?? "";
-      if (!existsSync91(join96(featuresDir, epic, id, "latest", `${id}-report.html`))) {
+      if (!existsSync92(join97(featuresDir, epic, id, "latest", `${id}-report.html`))) {
         if (hasAcBlock(epic, id)) {
           gaps.push(`Done backlog row ${id} has ACs but no attest report`);
         } else {
@@ -259107,8 +259550,8 @@ function checkCards(projectDir) {
 }
 function checkDocs(projectDir) {
   const gaps = checkTopLevelCommands(activeDocsFiles(projectDir), DOC_RETIRED_TOP_LEVEL_COMMANDS);
-  const changelogPath = join96(projectDir, "CHANGELOG.md");
-  if (existsSync91(changelogPath)) {
+  const changelogPath = join97(projectDir, "CHANGELOG.md");
+  if (existsSync92(changelogPath)) {
     const changelog = readText(changelogPath);
     for (const id of releaseDeltaCardIds(projectDir)) {
       const base = id.replace(/[a-z]$/, "");
@@ -259181,9 +259624,9 @@ function siteTokens(name) {
 }
 function checkSite(projectDir) {
   const gaps = checkTopLevelCommands(activeSiteFiles(projectDir), SITE_HIDDEN_TOP_LEVEL_COMMANDS);
-  const siteJs = join96(projectDir, "site", "roll-data.js");
-  const backlog = join96(projectDir, ".roll", "backlog.md");
-  if (!existsSync91(siteJs) || !existsSync91(backlog))
+  const siteJs = join97(projectDir, "site", "roll-data.js");
+  const backlog = join97(projectDir, ".roll", "backlog.md");
+  if (!existsSync92(siteJs) || !existsSync92(backlog))
     return { status: gaps.length === 0 ? "pass" : "fail", gaps };
   const siteText = readText(siteJs);
   const seenGuideRefs = /* @__PURE__ */ new Set();
@@ -259192,7 +259635,7 @@ function checkSite(projectDir) {
     if (seenGuideRefs.has(rel))
       continue;
     seenGuideRefs.add(rel);
-    if (!existsSync91(join96(projectDir, rel))) {
+    if (!existsSync92(join97(projectDir, rel))) {
       gaps.push(`site/roll-data.js links a guide that does not exist: ${rel}`);
     }
   }
@@ -259233,7 +259676,7 @@ function listFiles2(dir) {
   try {
     return readdirSync38(dir).filter((n) => {
       try {
-        return statSync27(join96(dir, n)).isFile();
+        return statSync27(join97(dir, n)).isFile();
       } catch {
         return false;
       }
@@ -259244,9 +259687,9 @@ function listFiles2(dir) {
 }
 function checkI18n(projectDir) {
   const gaps = [];
-  const guideEn = join96(projectDir, "guide", "en");
-  const guideZh = join96(projectDir, "guide", "zh");
-  if (existsSync91(guideEn) && existsSync91(guideZh)) {
+  const guideEn = join97(projectDir, "guide", "en");
+  const guideZh = join97(projectDir, "guide", "zh");
+  if (existsSync92(guideEn) && existsSync92(guideZh)) {
     const enFiles = new Set(listFiles2(guideEn));
     const zhFiles = new Set(listFiles2(guideZh));
     const enOnly = [...enFiles].filter((f) => !zhFiles.has(f)).sort();
@@ -259256,8 +259699,8 @@ function checkI18n(projectDir) {
     for (const f of zhOnly)
       gaps.push(`guide/zh/${f} has no corresponding guide/en/${f}`);
   }
-  const i18nDir = join96(projectDir, "lib", "i18n");
-  if (existsSync91(i18nDir)) {
+  const i18nDir = join97(projectDir, "lib", "i18n");
+  if (existsSync92(i18nDir)) {
     const keysEn = /* @__PURE__ */ new Set();
     const keysZh = /* @__PURE__ */ new Set();
     let shFiles = [];
@@ -259267,7 +259710,7 @@ function checkI18n(projectDir) {
       shFiles = [];
     }
     for (const name of shFiles) {
-      const text2 = readText(join96(i18nDir, name));
+      const text2 = readText(join97(i18nDir, name));
       for (const m7 of text2.matchAll(/_i18n_set\s+(en|zh)\s+([^\s]+)/g)) {
         const lang9 = m7[1];
         const key = m7[2] ?? "";
@@ -259307,7 +259750,7 @@ function rglobBats(dir) {
       return;
     }
     for (const e of entries) {
-      const full = join96(d, e);
+      const full = join97(d, e);
       let st;
       try {
         st = statSync27(full);
@@ -259325,9 +259768,9 @@ function rglobBats(dir) {
 }
 function checkTests(projectDir) {
   const gaps = [];
-  const backlog = join96(projectDir, ".roll", "backlog.md");
-  const testsDir = join96(projectDir, "tests");
-  if (!existsSync91(backlog))
+  const backlog = join97(projectDir, ".roll", "backlog.md");
+  const testsDir = join97(projectDir, "tests");
+  if (!existsSync92(backlog))
     return { status: "pass", gaps: [] };
   const backlogText = readText(backlog);
   const allFeatures = /* @__PURE__ */ new Set();
@@ -259352,7 +259795,7 @@ function checkTests(projectDir) {
         doneFeatures.push(currentFeature);
     }
   }
-  const testFiles = existsSync91(testsDir) ? rglobBats(testsDir) : [];
+  const testFiles = existsSync92(testsDir) ? rglobBats(testsDir) : [];
   if (testFiles.length === 0)
     return { status: "pass", gaps: [] };
   for (const feat of doneFeatures) {
@@ -259805,7 +260248,7 @@ function realReleaseDeps() {
   return {
     version: (cwd) => {
       try {
-        const pkg = JSON.parse(readFileSync88(join98(cwd, "package.json"), "utf8"));
+        const pkg = JSON.parse(readFileSync89(join99(cwd, "package.json"), "utf8"));
         return typeof pkg.version === "string" ? pkg.version : "";
       } catch {
         return "";
@@ -259840,13 +260283,13 @@ function realReleaseDeps() {
         return true;
       }
     },
-    readChangelog: (cwd) => readFileSync88(join98(cwd, "CHANGELOG.md"), "utf8"),
-    writeChangelog: (cwd, text2) => writeFileSync47(join98(cwd, "CHANGELOG.md"), text2, "utf8"),
+    readChangelog: (cwd) => readFileSync89(join99(cwd, "CHANGELOG.md"), "utf8"),
+    writeChangelog: (cwd, text2) => writeFileSync48(join99(cwd, "CHANGELOG.md"), text2, "utf8"),
     bumpVersion: (cwd, version) => {
-      const path = join98(cwd, "package.json");
-      const pkg = JSON.parse(readFileSync88(path, "utf8"));
+      const path = join99(cwd, "package.json");
+      const pkg = JSON.parse(readFileSync89(path, "utf8"));
       pkg["version"] = version;
-      writeFileSync47(path, `${JSON.stringify(pkg, null, 2)}
+      writeFileSync48(path, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
     },
     packageGate: (cwd) => {
@@ -259861,7 +260304,7 @@ function realReleaseDeps() {
       commitPushWithGate({
         branch,
         message,
-        rollManaged: existsSync93(join98(cwd, ".roll")),
+        rollManaged: existsSync94(join99(cwd, ".roll")),
         exec: (cmd, args) => execFileSync24(cmd, args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 6e5 })
       });
     },
@@ -259954,7 +260397,7 @@ function realReleaseDeps() {
     recordReleaseFact: (cwd, tagName) => {
       try {
         const runtimeDir9 = (process.env["ROLL_PROJECT_RUNTIME_DIR"] ?? "").trim();
-        const eventsPath2 = runtimeDir9 !== "" ? join98(runtimeDir9, EVENTS_FILE) : join98(cwd, ".roll", "loop", EVENTS_FILE);
+        const eventsPath2 = runtimeDir9 !== "" ? join99(runtimeDir9, EVENTS_FILE) : join99(cwd, ".roll", "loop", EVENTS_FILE);
         new EventBus().appendEvent(eventsPath2, {
           type: "release:gate",
           tag: tagName,
@@ -260175,8 +260618,8 @@ ${c("dim", "\u2192 Running the golden-path showcase (real models; its verdict do
 init_dist();
 init_render();
 import { spawnSync as spawnSync12 } from "node:child_process";
-import { existsSync as existsSync94, lstatSync as lstatSync5, mkdirSync as mkdirSync46, readFileSync as readFileSync89, readdirSync as readdirSync40, readlinkSync as readlinkSync2, statSync as statSync29 } from "node:fs";
-import { join as join99 } from "node:path";
+import { existsSync as existsSync95, lstatSync as lstatSync5, mkdirSync as mkdirSync46, readFileSync as readFileSync90, readdirSync as readdirSync40, readlinkSync as readlinkSync2, statSync as statSync29 } from "node:fs";
+import { join as join100 } from "node:path";
 function err13(line) {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   const RED = noColor2 ? "" : "\x1B[0;31m";
@@ -260219,7 +260662,7 @@ function walk(dir, lines2) {
     return;
   }
   for (const name of names) {
-    const p = join99(dir, name);
+    const p = join100(dir, name);
     let isLink = false;
     try {
       isLink = lstatSync5(p).isSymbolicLink();
@@ -260249,7 +260692,7 @@ function walk(dir, lines2) {
 }
 function fileFingerprint(p) {
   try {
-    const buf = readFileSync89(p);
+    const buf = readFileSync90(p);
     let sum = 0;
     for (let i = 0; i < buf.length; i++)
       sum = sum * 31 + (buf[i] ?? 0) >>> 0;
@@ -260279,18 +260722,18 @@ function ensureHooksPath(repoPath) {
   }
 }
 function peerEnsureStateDir() {
-  const base = join99(rollHome2(), ".peer-state");
+  const base = join100(rollHome2(), ".peer-state");
   mkdirSync46(base, { recursive: true });
-  mkdirSync46(join99(base, "logs"), { recursive: true });
+  mkdirSync46(join100(base, "logs"), { recursive: true });
 }
 function tmuxPresent() {
   return onPath("tmux");
 }
 function submoduleGuard() {
   const pkg = rollPkgDir();
-  const skills = join99(pkg, "skills");
-  const hasGit = existsSync94(join99(pkg, ".git"));
-  const hasMods = existsSync94(join99(pkg, ".gitmodules"));
+  const skills = join100(pkg, "skills");
+  const hasGit = existsSync95(join100(pkg, ".git"));
+  const hasMods = existsSync95(join100(pkg, ".gitmodules"));
   let empty = true;
   try {
     empty = readdirSync40(skills).length === 0;
@@ -260383,7 +260826,7 @@ function setupCommand(args) {
       return 1;
     }
   }
-  if (!existsSync94(rollPkgConventions())) {
+  if (!existsSync95(rollPkgConventions())) {
     err13(m5("shared.convention_source_not_found_at_2", rollPkgConventions()));
     err13(m5("shared.run_this_from_the_roll_repo"));
     return 1;
@@ -260392,7 +260835,7 @@ function setupCommand(args) {
   const home = rollHome2();
   const aiDirsList = [".claude", ".kimi", ".kimi-code", ".codex", ".pi", ".agentrules", ".reasonix"];
   const homeDir = process.env["HOME"] ?? "";
-  const aiDirs = aiDirsList.map((d) => join99(homeDir, d)).join(":");
+  const aiDirs = aiDirsList.map((d) => join100(homeDir, d)).join(":");
   const steps = [];
   const s1 = runSetupStep(home, () => {
     installLocal(force);
@@ -260406,7 +260849,7 @@ function setupCommand(args) {
     syncSkills(force);
   });
   steps.push({ num: 3, label: "Install skills to ~/.claude", status: stateToMarker(s3, force) });
-  const s4 = runSetupStep(join99(home, ".peer-state"), () => {
+  const s4 = runSetupStep(join100(home, ".peer-state"), () => {
     peerEnsureStateDir();
   });
   steps.push({ num: 4, label: "Initialize peer-review state directory", status: stateToMarker(s4, force) });
@@ -260436,8 +260879,8 @@ init_showcase2();
 // packages/cli/dist/commands/test.js
 import { spawnSync as spawnSync13 } from "node:child_process";
-import { appendFileSync as appendFileSync20, existsSync as existsSync95, mkdirSync as mkdirSync47, readFileSync as readFileSync90, rmSync as rmSync18, writeFileSync as writeFileSync48 } from "node:fs";
-import { dirname as dirname45, join as join100, resolve as resolve8 } from "node:path";
+import { appendFileSync as appendFileSync20, existsSync as existsSync96, mkdirSync as mkdirSync47, readFileSync as readFileSync91, rmSync as rmSync18, writeFileSync as writeFileSync49 } from "node:fs";
+import { dirname as dirname45, join as join101, resolve as resolve8 } from "node:path";
 function pal7() {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   return noColor2 ? { CYAN: "", GREEN: "", YELLOW: "", RED: "", NC: "" } : { CYAN: "\x1B[0;36m", GREEN: "\x1B[0;32m", YELLOW: "\x1B[0;33m", RED: "\x1B[0;31m", NC: "\x1B[0m" };
@@ -260458,12 +260901,12 @@ function currentEvidenceFrame() {
   if (raw === "")
     return null;
   const runDir = resolve8(raw);
-  if (!existsSync95(runDir))
+  if (!existsSync96(runDir))
     return null;
   const frame = {
     runDir,
-    evidenceDir: join100(runDir, "evidence"),
-    screenshotsDir: join100(runDir, "screenshots")
+    evidenceDir: join101(runDir, "evidence"),
+    screenshotsDir: join101(runDir, "screenshots")
   };
   try {
     mkdirSync47(frame.evidenceDir, { recursive: true });
@@ -260494,7 +260937,7 @@ function appendRollTestEvidence(frame, cmd, argv, status2, stdout, stderr) {
   try {
     const ts2 = (/* @__PURE__ */ new Date()).toISOString();
     const command = [cmd, ...argv];
-    appendFileSync20(join100(frame.evidenceDir, "roll-test-output.log"), [
+    appendFileSync20(join101(frame.evidenceDir, "roll-test-output.log"), [
       `===== roll test ${ts2} exit=${status2} =====`,
       `$ ${command.join(" ")}`,
       "--- stdout ---",
@@ -260503,7 +260946,7 @@ function appendRollTestEvidence(frame, cmd, argv, status2, stdout, stderr) {
       stderr,
       ""
     ].join("\n"), "utf8");
-    appendFileSync20(join100(frame.evidenceDir, "roll-test-summary.txt"), JSON.stringify({
+    appendFileSync20(join101(frame.evidenceDir, "roll-test-summary.txt"), JSON.stringify({
       ts: ts2,
       command,
       exitCode: status2,
@@ -260514,12 +260957,12 @@ function appendRollTestEvidence(frame, cmd, argv, status2, stdout, stderr) {
   }
 }
 function isolationGetType() {
-  const file = join100(process.cwd(), ".roll", "local.yaml");
-  if (!existsSync95(file))
+  const file = join101(process.cwd(), ".roll", "local.yaml");
+  if (!existsSync96(file))
     return "none";
   let text2;
   try {
-    text2 = readFileSync90(file, "utf8");
+    text2 = readFileSync91(file, "utf8");
   } catch {
     return "none";
   }
@@ -260567,14 +261010,14 @@ function resetLockPath() {
   return ".roll/.iso-reset.lock";
 }
 function resetLockHeld() {
-  return existsSync95(resetLockPath());
+  return existsSync96(resetLockPath());
 }
 function resetAcquireLock() {
   const lock = resetLockPath();
-  if (existsSync95(lock))
+  if (existsSync96(lock))
     return false;
   mkdirSync47(dirname45(lock), { recursive: true });
-  writeFileSync48(lock, `${process.pid}
+  writeFileSync49(lock, `${process.pid}
 `);
   return true;
 }
@@ -260597,15 +261040,15 @@ function runForward(cmd, argv) {
 }
 function ensureSkillsSubmoduleReady() {
   const pkg = rollPkgDir();
-  const required2 = join100(pkg, "skills", "roll-onboard", "SKILL.md");
-  if (existsSync95(required2))
+  const required2 = join101(pkg, "skills", "roll-onboard", "SKILL.md");
+  if (existsSync96(required2))
     return true;
-  if (existsSync95(join100(pkg, ".git")) && existsSync95(join100(pkg, ".gitmodules"))) {
+  if (existsSync96(join101(pkg, ".git")) && existsSync96(join101(pkg, ".gitmodules"))) {
     spawnSync13("git", ["submodule", "update", "--init", "--recursive", "--quiet", "skills"], {
       cwd: pkg,
       stdio: "ignore"
     });
-    if (existsSync95(required2))
+    if (existsSync96(required2))
       return true;
   }
   err14("roll test: skills submodule is empty");
@@ -260614,7 +261057,7 @@ function ensureSkillsSubmoduleReady() {
 }
 function isolationDispatch(method, args) {
   const type = isolationGetType();
-  if (type === "none" && !existsSync95(join100(process.cwd(), ".roll", "local.yaml"))) {
+  if (type === "none" && !existsSync96(join101(process.cwd(), ".roll", "local.yaml"))) {
     infoErr("isolation: no test_isolation config, falling back to type=none (host)");
   }
   if (!SUPPORTED_TYPES.includes(type)) {
@@ -260710,7 +261153,7 @@ function testCommand(args) {
 // packages/cli/dist/commands/tool.js
 init_dist2();
-import { join as join101 } from "node:path";
+import { join as join102 } from "node:path";
 var TOOL_USAGE = "Usage: roll tool status\n  Show registered tools, input contracts, effective policy state, and requirement readiness.\n\u5C55\u793A\u5DF2\u6CE8\u518C\u5DE5\u5177\u3001\u5165\u53C2\u5951\u7EA6\u3001\u6709\u6548 policy \u72B6\u6001\u4E0E requirement \u5C31\u7EEA\u5EA6\u3002\n";
 async function toolCommand(args) {
   const sub = args[0] ?? "";
@@ -260728,7 +261171,7 @@ async function toolCommand(args) {
   return 0;
 }
 async function collectToolRows(projectRoot2, requirementResolver = resolveRequirement) {
-  const policy = new ToolPolicyEngine({ policyPath: join101(projectRoot2, ".roll", "policy.yaml") });
+  const policy = new ToolPolicyEngine({ policyPath: join102(projectRoot2, ".roll", "policy.yaml") });
   const rows = [];
   for (const declaration of collectBuiltinToolDeclarations(projectRoot2)) {
     const effective = await policy.resolve(declaration.id, declaration.defaults);
@@ -260790,8 +261233,8 @@ function pad4(value, width) {
 // packages/cli/dist/commands/truth.js
 init_dist();
 init_dist2();
-import { statSync as statSync30, readFileSync as readFileSync91, writeFileSync as writeFileSync49, mkdirSync as mkdirSync48, existsSync as existsSync96 } from "node:fs";
-import { dirname as dirname46, join as join102 } from "node:path";
+import { statSync as statSync30, readFileSync as readFileSync92, writeFileSync as writeFileSync50, mkdirSync as mkdirSync48, existsSync as existsSync97 } from "node:fs";
+import { dirname as dirname46, join as join103 } from "node:path";
 var TRUTH_USAGE = "Usage: roll truth <command>\n  query <storyId>  Deterministic delivery-truth query (structured, zero markdown parse).\n  audit            Bidirectional drift audit: backlog Done \u2194 projection truth.\n\u547D\u4EE4:\n  query <storyId>  \u7ED3\u6784\u5316\u4EA4\u4ED8\u771F\u76F8\u67E5\u8BE2\uFF08\u786E\u5B9A\u6027\uFF0C\u4E0D\u89E3\u6790 markdown\uFF09\n  audit            \u53CC\u5411\u6F02\u79FB\u5BA1\u8BA1\uFF1Abacklog Done \u2194 \u6295\u5F71\u771F\u76F8";
 function formatTruth(t3, lang9) {
   const lines2 = [];
@@ -260823,22 +261266,22 @@ var nodeFreshnessPort3 = {
   },
   readText(absPath) {
     try {
-      return readFileSync91(absPath, "utf8");
+      return readFileSync92(absPath, "utf8");
     } catch {
       return "";
     }
   },
   writeText(absPath, text2) {
     mkdirSync48(dirname46(absPath), { recursive: true });
-    writeFileSync49(absPath, text2, "utf8");
+    writeFileSync50(absPath, text2, "utf8");
   }
 };
 function truthAuditCommand(args, lang9) {
   const json = args.includes("--json");
   const cwd = process.cwd();
   const nowSec2 = Math.floor(Date.now() / 1e3);
-  const backlogPath = join102(cwd, ".roll", "backlog.md");
-  const backlogRows = existsSync96(backlogPath) ? parseBacklog(readFileSync91(backlogPath, "utf8")).map((r) => ({ id: r.id, status: r.status })) : [];
+  const backlogPath = join103(cwd, ".roll", "backlog.md");
+  const backlogRows = existsSync97(backlogPath) ? parseBacklog(readFileSync92(backlogPath, "utf8")).map((r) => ({ id: r.id, status: r.status })) : [];
   const deliveries = ensureDeliveriesFresh(cwd, nodeFreshnessPort3, nodeExecPort);
   const snapshot = emptyAuditSnapshot(nowSec2, TERMINAL_SCHEMA_EPOCH_SEC);
   snapshot.backlog = backlogRows;
@@ -260923,8 +261366,8 @@ function truthCommand(args) {
 // packages/cli/dist/commands/tune.js
 init_dist2();
-import { existsSync as existsSync97, readFileSync as readFileSync92 } from "node:fs";
-import { join as join103 } from "node:path";
+import { existsSync as existsSync98, readFileSync as readFileSync93 } from "node:fs";
+import { join as join104 } from "node:path";
 function projectPath2() {
   return (process.env["ROLL_MAIN_PROJECT"] ?? "").trim() || process.cwd();
 }
@@ -260932,11 +261375,11 @@ function str6(v, dflt = "") {
   return typeof v === "string" ? v : dflt;
 }
 function parseJsonl(path) {
-  if (!existsSync97(path))
+  if (!existsSync98(path))
     return [];
   let text2;
   try {
-    text2 = readFileSync92(path, "utf8");
+    text2 = readFileSync93(path, "utf8");
   } catch {
     return [];
   }
@@ -261067,9 +261510,9 @@ function tuneCommand(argv) {
   if (argv[0] === "reset")
     return printReset();
   const proj = projectPath2();
-  const loopDir = join103(proj, ".roll", "loop");
-  const runs = parseJsonl(join103(loopDir, "runs.jsonl"));
-  const events = parseJsonl(join103(loopDir, "events.ndjson"));
+  const loopDir = join104(proj, ".roll", "loop");
+  const runs = parseJsonl(join104(loopDir, "runs.jsonl"));
+  const events = parseJsonl(join104(loopDir, "events.ndjson"));
   const minSamplesRaw = flag(argv, "--min-samples");
   const now = flag(argv, "--now") ?? (/* @__PURE__ */ new Date()).toISOString();
   const input = {
@@ -261108,9 +261551,9 @@ function tuneCommand(argv) {
 // packages/cli/dist/commands/update.js
 init_dist();
 import { spawnSync as spawnSync14 } from "node:child_process";
-import { existsSync as existsSync98, mkdtempSync as mkdtempSync7, readFileSync as readFileSync93, rmSync as rmSync19 } from "node:fs";
+import { existsSync as existsSync99, mkdtempSync as mkdtempSync7, readFileSync as readFileSync94, rmSync as rmSync19 } from "node:fs";
 import { tmpdir as tmpdir9 } from "node:os";
-import { join as join104 } from "node:path";
+import { join as join105 } from "node:path";
 function pal8() {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   return noColor2 ? { CYAN: "", GREEN: "", YELLOW: "", RED: "", BOLD: "", NC: "" } : {
@@ -261174,20 +261617,20 @@ function resolveRemoteVersion() {
 }
 function downloadAndInstallCurl(tag) {
   const url = `https://github.com/seanyao/roll/archive/refs/tags/${tag}.tar.gz`;
-  const tmpDir = mkdtempSync7(join104(tmpdir9(), "roll-update-"));
+  const tmpDir = mkdtempSync7(join105(tmpdir9(), "roll-update-"));
   try {
     info5(`[roll] Downloading roll ${tag} ...`);
-    const dl = runForward2("curl", ["-fsSL", url, "-o", join104(tmpDir, "roll.tar.gz")]);
+    const dl = runForward2("curl", ["-fsSL", url, "-o", join105(tmpDir, "roll.tar.gz")]);
     if (dl !== 0) {
       err15(m6("update.curl_download_failed"));
       return { ok: false };
     }
     info5("[roll] Extracting ...");
-    const extractDir = join104(tmpDir, "extract");
+    const extractDir = join105(tmpDir, "extract");
     spawnSync14("mkdir", ["-p", extractDir], { stdio: "ignore" });
     const ex = runForward2("tar", [
       "-xzf",
-      join104(tmpDir, "roll.tar.gz"),
+      join105(tmpDir, "roll.tar.gz"),
       "--strip-components=1",
       "-C",
       extractDir
@@ -261204,7 +261647,7 @@ function downloadAndInstallCurl(tag) {
 function checkInstalledVersionOrRetry() {
   const expected = (spawnSync14("npm", ["view", "@seanyao/roll", "version"], { encoding: "utf8" }).stdout ?? "").trim();
   const pkgRoot = (spawnSync14("npm", ["root", "-g"], { encoding: "utf8" }).stdout ?? "").trim();
-  const installedTree = join104(pkgRoot, "@seanyao", "roll");
+  const installedTree = join105(pkgRoot, "@seanyao", "roll");
   const installed = treeVersion(installedTree);
   if (expected === "" || installed === "")
     return;
@@ -261218,18 +261661,18 @@ function checkInstalledVersionOrRetry() {
   }
 }
 function invalidateUpdateCache() {
-  rmSync19(join104(rollHome2(), ".update-check"), { force: true });
+  rmSync19(join105(rollHome2(), ".update-check"), { force: true });
 }
 function showChangelog() {
-  const changelog = join104(rollPkgDir(), "CHANGELOG.md");
-  if (!existsSync98(changelog))
+  const changelog = join105(rollPkgDir(), "CHANGELOG.md");
+  if (!existsSync99(changelog))
     return;
   const { BOLD: BOLD2, CYAN, NC } = pal8();
   process.stdout.write(`${BOLD2}${m6("changelog.heading")}:${NC}
 `);
   let count = 0;
   let inSection = false;
-  for (const line of readFileSync93(changelog, "utf8").split("\n")) {
+  for (const line of readFileSync94(changelog, "utf8").split("\n")) {
     if (/^## /.test(line)) {
       count += 1;
       if (count > 3)
@@ -261252,9 +261695,9 @@ function updateCommand(args) {
   }
   info5(m6("update.current_version", rollVersion()));
   let installMethod = "npm";
-  const methodFile = join104(rollPkgDir(), ".install-method");
-  if (existsSync98(methodFile)) {
-    installMethod = readFileSync93(methodFile, "utf8").trim() || "npm";
+  const methodFile = join105(rollPkgDir(), ".install-method");
+  if (existsSync99(methodFile)) {
+    installMethod = readFileSync94(methodFile, "utf8").trim() || "npm";
   }
   if (installMethod === "curl") {
     info5(m6("update.upgrading_via_curl"));
@@ -261418,6 +261861,8 @@ function registerAll() {
       return loopSelfDowngradeCommand(args.slice(1));
     if (args[0] === "review-resize")
       return loopReviewResizeCommand(args.slice(1));
+    if (args[0] === "exhaustion-split")
+      return loopExhaustionSplitCommand(args.slice(1));
     if (args[0] === "fmt")
       return loopFmtCommand(args.slice(1));
     if (args[0] === "watch")