@wrongstack/tools 0.295.1 → 0.296.2

package/dist/auto-proceed-loop-guard.d.ts

@@ -155,5 +155,72 @@ export interface AutoProceedLoopGuard {
  *     feedPrompt(prompt);
  *   }
  */
+export interface ContinuationAttemptTracker {
+    /** Record an attempt against a todo. Returns the new attempt count (≥ 1). */
+    recordAttempt(todoId: string): number;
+    /** How many times continuation has been attempted for this todo (0 = never). */
+    getAttempts(todoId: string): number;
+    /** Mark a todo as "skipped" — a later attempt tried advancing past it. */
+    markSkipped(todoId: string): void;
+    /** True when this todo has been skipped due to no board progress. */
+    isSkipped(todoId: string): boolean;
+    /** Reset every tracked todo (call on manual user input). */
+    reset(): void;
+    /** Read-only snapshot for diagnostic use. */
+    snapshot(): Record<string, {
+        attempts: number;
+        skipped: boolean;
+    }>;
+}
+export declare function createContinuationAttemptTracker(): ContinuationAttemptTracker;
+/**
+ * Build a continuation-advancement prompt when the normal todo-sourced
+ * prompt has stalled (no board progress). The text varies by attempt count
+ * to avoid triggering the repetition guard.
+ *
+ * @param stalledTodo   The todo that didn't progress (used for its id/label).
+ * @param nextTodo      The next open todo to advance to, or null if none left.
+ * @param attemptCount  How many times stalledTodo has been retried.
+ * @param todos         The full current todo list for board context.
+ * @returns A varied advancement prompt for the next auto-feed.
+ */
+export declare function generateAdvancementPrompt(stalledTodo: {
+    id: string;
+    content: string;
+}, nextTodo: {
+    id: string;
+    content: string;
+    status: string;
+    activeForm?: string | undefined;
+} | null, attemptCount: number, todos: readonly {
+    id: string;
+    content: string;
+    status: string;
+    activeForm?: string | undefined;
+}[]): string;
+export interface StalledTodoMatch {
+    id: string;
+    content: string;
+}
+/**
+ * Identify the todo whose content appears in a stalled continuation prompt.
+ * Scans the board for the in_progress item first (that's what
+ * `resolveContinuation` picks), then falls back to any pending item whose
+ * text appears in the prompt. Last resort: the first non-completed todo.
+ *
+ * Returns `null` when the board is empty or all items are completed.
+ */
+export declare function matchTodoIdFromPrompt(todos: readonly {
+    id: string;
+    content: string;
+    status: string;
+    activeForm?: string | undefined;
+}[], prompt: string): StalledTodoMatch | null;
+/**
+ * Maximum total advancement attempts before we give up on the board and
+ * halt. Otherwise a board where no agent turn makes progress cycles through
+ * the same todos indefinitely. Reset on manual user input.
+ */
+export declare const MAX_ADVANCEMENT_ATTEMPTS = 9;
 export declare function createAutoProceedLoopGuard(options?: LoopGuardOptions): AutoProceedLoopGuard;
 //# sourceMappingURL=auto-proceed-loop-guard.d.ts.map

package/dist/auto-proceed-loop-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-proceed-loop-guard.d.ts","sourceRoot":"","sources":["../src/auto-proceed-loop-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,QAO3B,CAAC;AAEb,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE;;;;;;;OAOG;IACH,MAAM,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAAC;IACzD;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,OAAO,IAAI,SAAS,MAAM,EAAE,CAAC;IAC7B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,gBAAqB,GAAG,oBAAoB,CAqE/F"}
+{"version":3,"file":"auto-proceed-loop-guard.d.ts","sourceRoot":"","sources":["../src/auto-proceed-loop-guard.ts"],"names":[],"mappings":"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"}

package/dist/auto-proceed-loop-guard.js

@@ -10,6 +10,97 @@ var GROUNDED_NO_PROGRESS_STEER = [
   "- remove or reword items that no longer apply.",
   "Then continue the work. If you are blocked, state exactly what is blocking you instead of repeating the same turn."
 ].join("\n");
+function createContinuationAttemptTracker() {
+  const attempts = /* @__PURE__ */ new Map();
+  const skipped = /* @__PURE__ */ new Set();
+  return {
+    recordAttempt(todoId) {
+      const count = (attempts.get(todoId) ?? 0) + 1;
+      attempts.set(todoId, count);
+      return count;
+    },
+    getAttempts(todoId) {
+      return attempts.get(todoId) ?? 0;
+    },
+    markSkipped(todoId) {
+      skipped.add(todoId);
+    },
+    isSkipped(todoId) {
+      return skipped.has(todoId);
+    },
+    reset() {
+      attempts.clear();
+      skipped.clear();
+    },
+    snapshot() {
+      const result = {};
+      const allIds = /* @__PURE__ */ new Set([...attempts.keys(), ...skipped]);
+      for (const id of allIds) {
+        result[id] = { attempts: attempts.get(id) ?? 0, skipped: skipped.has(id) };
+      }
+      return result;
+    }
+  };
+}
+var ADVANCE_PREAMBLES = [
+  "Pivoting to the next open item \u2014 previous todo still pending after {attempts} attempt(s).",
+  "Shifting focus to a different task while the previous item ({label}) remains open after {attempts} attempt(s).",
+  "No board progress on the current item after {attempts} attempt(s). Continuing with the next todo.",
+  "The previous item is still unresolved after {attempts} try(ies). Moving on down the list.",
+  "Advancing to the next piece of work after {attempts} unproductive attempt(s) on the prior one.",
+  "Taking a different angle \u2014 the stalled item ({label}) stays open after {attempts} attempt(s). Pressing ahead.",
+  "The todo board shows no movement on the current task after {attempts} attempt(s). Switching gears.",
+  "No change on the board from the last {attempts} continuation(s). Proceeding to the next open item."
+];
+function generateAdvancementPrompt(stalledTodo, nextTodo, attemptCount, todos) {
+  const idx = Math.max(0, Math.min(attemptCount - 1, ADVANCE_PREAMBLES.length - 1));
+  const preamble = ADVANCE_PREAMBLES[idx].replace(/\{attempts\}/g, () => String(attemptCount)).replace(/\{label\}/g, () => stalledTodo.content.slice(0, 72));
+  if (!nextTodo) {
+    return [
+      preamble,
+      "",
+      "No more open items remain on the todo list. What has been accomplished and what should I do next?"
+    ].join("\n");
+  }
+  const itemLabel = nextTodo.status === "in_progress" && nextTodo.activeForm ? nextTodo.activeForm : nextTodo.content;
+  const done = todos.filter((t) => t.status === "completed").length;
+  const total = todos.length;
+  const lines = [preamble, "", `Proceed with: ${itemLabel}`];
+  if (total > 0) {
+    lines.push("", `Todo board (${done}/${total} done):`);
+    lines.push(
+      ...todos.slice(0, 20).map((t) => {
+        const mark = t.status === "completed" ? "[x]" : t.status === "in_progress" ? "[~]" : "[ ]";
+        const flat = t.content.replace(/\n|\r/g, " ");
+        return `  ${mark} ${flat}`;
+      })
+    );
+  }
+  lines.push("", "If this item is already done, mark it complete and move to the next open todo. Keep the board honest as you work.");
+  return lines.join("\n");
+}
+function matchTodoIdFromPrompt(todos, prompt) {
+  if (todos.length === 0 || !prompt) return null;
+  const lowerPrompt = prompt.toLowerCase();
+  const inProgress = todos.find((t) => t.status === "in_progress");
+  if (inProgress) {
+    const label = (inProgress.activeForm ?? inProgress.content).toLowerCase();
+    if (label.length > 5 && lowerPrompt.includes(label)) {
+      return { id: inProgress.id, content: inProgress.activeForm ?? inProgress.content };
+    }
+  }
+  for (const t of todos) {
+    if (t.status === "completed") continue;
+    if (inProgress && t.id === inProgress.id) continue;
+    const label = (t.activeForm ?? t.content).toLowerCase();
+    if (label.length > 5 && lowerPrompt.includes(label)) {
+      return { id: t.id, content: t.activeForm ?? t.content };
+    }
+  }
+  const firstOpen = todos.find((t) => t.status !== "completed");
+  return firstOpen ? { id: firstOpen.id, content: firstOpen.activeForm ?? firstOpen.content } : null;
+}
+var MAX_ADVANCEMENT_ATTEMPTS = 9;
 function createAutoProceedLoopGuard(options = {}) {
   const safeIntegerOption = (value, fallback) => {
     if (value === void 0) return fallback;
@@ -63,7 +154,11 @@ function createAutoProceedLoopGuard(options = {}) {
 }
 export {
   GROUNDED_NO_PROGRESS_STEER,
+  MAX_ADVANCEMENT_ATTEMPTS,
   createAutoProceedLoopGuard,
+  createContinuationAttemptTracker,
+  generateAdvancementPrompt,
+  matchTodoIdFromPrompt,
   normalizeForRepetition
 };
 //# sourceMappingURL=auto-proceed-loop-guard.js.map

package/dist/auto-proceed-loop-guard.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/auto-proceed-loop-guard.ts"],
-  "sourcesContent": ["/**\n * Auto-proceed loop guard.\n *\n * ## Problem\n *\n * The REPL and TUI both implement an \"auto\" autonomy mode that, after every\n * completed agent turn, feeds the next suggestion (or top auto=\"true\" item)\n * back as a fresh prompt. When the agent emits the same `<nextsteps>` block\n * on every reply \u2014 which happens whenever the model's output is stable but\n * autonomy treats the next step as \"still actionable\" \u2014 the loop self-feeds\n * the same instruction 2\u20133 times in a row before the longer\n * `autoProceedMaxIterations` cap (default 50) trips.\n *\n * The user reports the visible symptom: the same response, including the same\n * `<nextsteps>` block, repeats. Manual input from the user is the only thing\n * that breaks out. They suspect the next-steps mechanism is the source.\n *\n * The 50-iteration cap is intentionally loose \u2014 it is a runaway safety net,\n * not a UX signal. By the time it trips, the user has already watched the\n * same response 50 times.\n *\n * ## Approach\n *\n * A small, pure, browser-safe stateful helper that records the last few\n * prompts fed through the auto-proceed / auto-submit path. It normalizes\n * prompts (whitespace, casing) so trivial rewordings are not collapsed, but\n * identical re-feeds are. When the same normalized prompt is fed\n * `repeatThreshold` (default 2) times in a row, the guard returns\n * `{ shouldHalt: true }`.\n *\n * Callers are expected to:\n *   1. Call `record(prompt)` immediately before each auto-feed.\n *   2. If `shouldHalt` is true, clear the suggestion + auto-suggestion store,\n *      cancel any pending countdown, and surface a \"we detected a loop\"\n *      message asking the user what's happening. Do NOT feed the prompt.\n *   3. Call `reset()` whenever the user types anything manually (REPL manual\n *      input or any user-driven submit) so the next auto-feed starts clean.\n *\n * The default `repeatThreshold` is 2 \u2014 i.e. the second consecutive identical\n * feed (the first re-feed of an already-seen prompt) halts the loop. That\n * matches the user's report (\"receiving the same prompt 2-3 times in a row\n * causes the system to enter a loop\"). Setting it to 2 catches the loop on\n * the first identical re-feed rather than after the 50-iteration runaway cap trips.\n *\n * The window size is intentionally small (default 3). The loop we care about\n * is the immediate repetition \u2014 a longer history would misfire on legitimate\n * \"do X, then do Y, then do X\" sequences the model occasionally returns to.\n *\n * This module is BROWSER-SAFE \u2014 no Node-only imports \u2014 so it can be imported\n * from Vite-bundled WebUI as well as Node-based CLI/TUI.\n */\n\n/**\n * Normalize a prompt for repetition comparison. Whitespace is collapsed and\n * trimmed; case is folded to lowercase. Nothing semantic is removed, so two\n * prompts that differ in any meaningful way (extra word, different code,\n * different file path) compare as distinct. Two prompts that differ only by\n * leading/trailing whitespace and casing are treated as identical.\n */\nexport function normalizeForRepetition(prompt: string): string {\n  return prompt.replace(/\\s+/g, ' ').trim().toLowerCase();\n}\n\nexport interface LoopGuardOptions {\n  /**\n   * How many consecutive identical prompts (after normalization) trigger a\n   * halt. Default 2 \u2014 i.e. the second consecutive identical feed (the first\n   * re-feed of an already-seen prompt) halts the loop. Clamped to >= 2.\n   */\n  repeatThreshold?: number;\n  /**\n   * How many of the most recent feeds to retain for comparison. The window\n   * is searched from newest to oldest; the guard cares about the run of\n   * identical entries ending at the most recent one, not about identical\n   * entries anywhere in history. Default 3.\n   */\n  windowSize?: number;\n}\n\nexport interface RepetitionSignal {\n  /** The normalized prompt that just got recorded. */\n  normalized: string;\n  /**\n   * Number of consecutive identical feeds ending at the most recent feed,\n   * including this one. Always >= 1.\n   */\n  runLength: number;\n  /**\n   * True when the run length has crossed `repeatThreshold`. Callers must\n   * stop feeding and surface a user prompt instead.\n   */\n  shouldHalt: boolean;\n}\n\n/**\n * Steer text appended (once) to a grounded todo continuation when the board\n * has not moved between two consecutive automatic turns. Grounded prompts are\n * synthesized from durable todo state, so an identical re-feed means the whole\n * previous turn produced zero board movement \u2014 usually the model worked but\n * forgot to update the board. One explicit steer fixes that far more often\n * than halting; the halt only fires if the board stays frozen AFTER the steer.\n */\nexport const GROUNDED_NO_PROGRESS_STEER = [\n  'NOTE: The todo board has not changed since the previous automatic continuation \u2014 this exact instruction is being repeated.',\n  'Before anything else, bring the board up to date so the loop stays grounded:',\n  '- mark work that is actually finished as completed,',\n  '- split the current item into smaller concrete sub-items if it needs more than one turn,',\n  '- remove or reword items that no longer apply.',\n  'Then continue the work. If you are blocked, state exactly what is blocking you instead of repeating the same turn.',\n].join('\\n');\n\nexport type GroundedRepetitionAction = 'feed' | 'steer' | 'halt';\n\nexport interface GroundedRepetitionSignal extends RepetitionSignal {\n  /**\n   * What the caller should do with this grounded (todo-sourced) prompt:\n   *   - `feed`  \u2014 no repetition; feed the prompt as-is.\n   *   - `steer` \u2014 first repetition; feed the prompt with\n   *     {@link GROUNDED_NO_PROGRESS_STEER} appended instead of halting.\n   *   - `halt`  \u2014 the board stayed frozen even after a steer; break the loop\n   *     exactly like a `shouldHalt` from {@link AutoProceedLoopGuard.record}.\n   */\n  action: GroundedRepetitionAction;\n}\n\nexport interface AutoProceedLoopGuard {\n  /**\n   * Record a prompt that is about to be auto-fed. Returns the repetition\n   * signal for that prompt. When `shouldHalt` is true the caller MUST NOT\n   * feed the prompt \u2014 it has been recorded for post-mortem inspection, but\n   * the loop must be broken instead.\n   */\n  record(prompt: string): RepetitionSignal;\n  /**\n   * Record a GROUNDED prompt \u2014 one synthesized from durable state (the todo\n   * board) rather than echoed from model output. Repetition of a grounded\n   * prompt is a \"no board progress\" signal, not necessarily an echo loop, so\n   * the first repetition asks the caller to steer (append\n   * {@link GROUNDED_NO_PROGRESS_STEER} to the fed text) and only a repetition\n   * that survives the steer halts. The steer state resets whenever a\n   * different prompt is recorded (board moved) or on {@link reset}.\n   */\n  recordGrounded(prompt: string): GroundedRepetitionSignal;\n  /**\n   * Drop the history. Call this on any manual user input so a fresh run\n   * starts with no memory of the prior cycle.\n   */\n  reset(): void;\n  /**\n   * Read-only view of the most recent normalized prompts (newest last).\n   * Useful for diagnostics and for the message shown to the user when the\n   * guard halts the loop.\n   */\n  history(): readonly string[];\n  /**\n   * How many entries the guard is currently retaining.\n   */\n  size(): number;\n}\n\n/**\n * Build a fresh loop guard. Defaults: `repeatThreshold = 2`, `windowSize = 3`.\n *\n * @example\n *   const guard = createAutoProceedLoopGuard();\n *   for (const prompt of candidates) {\n *     const signal = guard.record(prompt);\n *     if (signal.shouldHalt) {\n *       haltAutoProceedAndAskUser(signal);\n *       break;\n *     }\n *     feedPrompt(prompt);\n *   }\n */\nexport function createAutoProceedLoopGuard(options: LoopGuardOptions = {}): AutoProceedLoopGuard {\n  // Validate options defensively. Non-finite values (NaN, Infinity) MUST\n  // fall back to the documented default \u2014 a guard that silently disables\n  // itself is worse than no guard at all. Specifically:\n  //   - `repeatThreshold: NaN` would cause `Math.floor(NaN) = NaN`,\n  //     `Math.max(2, NaN) = NaN`, and `runLength >= NaN` is always false,\n  //     making the guard permanent no-op.\n  //   - `windowSize: NaN` / `Infinity` would skip the trim branch entirely\n  //     (`buffer.length > NaN` and `buffer.length > Infinity` are both\n  //     false), so the buffer would grow without bound.\n  const safeIntegerOption = (value: number | undefined, fallback: number): number => {\n    if (value === undefined) return fallback;\n    if (!Number.isFinite(value)) return fallback;\n    return Math.floor(value);\n  };\n  const repeatThreshold = Math.max(2, safeIntegerOption(options.repeatThreshold, 2));\n  const windowSize = Math.max(repeatThreshold, safeIntegerOption(options.windowSize, 3));\n  let buffer: string[] = [];\n  // Normalized grounded prompt we already steered for; a halt only fires for\n  // a grounded prompt that repeats again AFTER its steer.\n  let steeredFor: string | null = null;\n\n  function record(prompt: string): RepetitionSignal {\n    const normalized = normalizeForRepetition(prompt);\n    buffer.push(normalized);\n    if (buffer.length > windowSize) {\n      buffer = buffer.slice(buffer.length - windowSize);\n    }\n    // Count the trailing run of identical normalized prompts.\n    let runLength = 0;\n    for (let i = buffer.length - 1; i >= 0; i--) {\n      if (buffer[i] === normalized) runLength++;\n      else break;\n    }\n    return {\n      normalized,\n      runLength,\n      shouldHalt: runLength >= repeatThreshold,\n    };\n  }\n\n  function recordGrounded(prompt: string): GroundedRepetitionSignal {\n    const signal = record(prompt);\n    if (!signal.shouldHalt) {\n      // The board moved (different prompt) \u2014 clear any pending steer state.\n      steeredFor = null;\n      return { ...signal, shouldHalt: false, action: 'feed' };\n    }\n    if (steeredFor === signal.normalized) {\n      return { ...signal, action: 'halt' };\n    }\n    steeredFor = signal.normalized;\n    return { ...signal, shouldHalt: false, action: 'steer' };\n  }\n\n  function reset(): void {\n    buffer = [];\n    steeredFor = null;\n  }\n\n  function history(): readonly string[] {\n    return buffer.slice();\n  }\n\n  function size(): number {\n    return buffer.length;\n  }\n\n  return { record, recordGrounded, reset, history, size };\n}\n"],
-  "mappings": ";AA2DO,SAAS,uBAAuB,QAAwB;AAC7D,SAAO,OAAO,QAAQ,QAAQ,GAAG,EAAE,KAAK,EAAE,YAAY;AACxD;AAyCO,IAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAiEJ,SAAS,2BAA2B,UAA4B,CAAC,GAAyB;AAU/F,QAAM,oBAAoB,CAAC,OAA2B,aAA6B;AACjF,QAAI,UAAU,OAAW,QAAO;AAChC,QAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACpC,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AACA,QAAM,kBAAkB,KAAK,IAAI,GAAG,kBAAkB,QAAQ,iBAAiB,CAAC,CAAC;AACjF,QAAM,aAAa,KAAK,IAAI,iBAAiB,kBAAkB,QAAQ,YAAY,CAAC,CAAC;AACrF,MAAI,SAAmB,CAAC;AAGxB,MAAI,aAA4B;AAEhC,WAAS,OAAO,QAAkC;AAChD,UAAM,aAAa,uBAAuB,MAAM;AAChD,WAAO,KAAK,UAAU;AACtB,QAAI,OAAO,SAAS,YAAY;AAC9B,eAAS,OAAO,MAAM,OAAO,SAAS,UAAU;AAAA,IAClD;AAEA,QAAI,YAAY;AAChB,aAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,UAAI,OAAO,CAAC,MAAM,WAAY;AAAA,UACzB;AAAA,IACP;AACA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,YAAY,aAAa;AAAA,IAC3B;AAAA,EACF;AAEA,WAAS,eAAe,QAA0C;AAChE,UAAM,SAAS,OAAO,MAAM;AAC5B,QAAI,CAAC,OAAO,YAAY;AAEtB,mBAAa;AACb,aAAO,EAAE,GAAG,QAAQ,YAAY,OAAO,QAAQ,OAAO;AAAA,IACxD;AACA,QAAI,eAAe,OAAO,YAAY;AACpC,aAAO,EAAE,GAAG,QAAQ,QAAQ,OAAO;AAAA,IACrC;AACA,iBAAa,OAAO;AACpB,WAAO,EAAE,GAAG,QAAQ,YAAY,OAAO,QAAQ,QAAQ;AAAA,EACzD;AAEA,WAAS,QAAc;AACrB,aAAS,CAAC;AACV,iBAAa;AAAA,EACf;AAEA,WAAS,UAA6B;AACpC,WAAO,OAAO,MAAM;AAAA,EACtB;AAEA,WAAS,OAAe;AACtB,WAAO,OAAO;AAAA,EAChB;AAEA,SAAO,EAAE,QAAQ,gBAAgB,OAAO,SAAS,KAAK;AACxD;",
+  "sourcesContent": ["/**\n * Auto-proceed loop guard.\n *\n * ## Problem\n *\n * The REPL and TUI both implement an \"auto\" autonomy mode that, after every\n * completed agent turn, feeds the next suggestion (or top auto=\"true\" item)\n * back as a fresh prompt. When the agent emits the same `<nextsteps>` block\n * on every reply \u2014 which happens whenever the model's output is stable but\n * autonomy treats the next step as \"still actionable\" \u2014 the loop self-feeds\n * the same instruction 2\u20133 times in a row before the longer\n * `autoProceedMaxIterations` cap (default 50) trips.\n *\n * The user reports the visible symptom: the same response, including the same\n * `<nextsteps>` block, repeats. Manual input from the user is the only thing\n * that breaks out. They suspect the next-steps mechanism is the source.\n *\n * The 50-iteration cap is intentionally loose \u2014 it is a runaway safety net,\n * not a UX signal. By the time it trips, the user has already watched the\n * same response 50 times.\n *\n * ## Approach\n *\n * A small, pure, browser-safe stateful helper that records the last few\n * prompts fed through the auto-proceed / auto-submit path. It normalizes\n * prompts (whitespace, casing) so trivial rewordings are not collapsed, but\n * identical re-feeds are. When the same normalized prompt is fed\n * `repeatThreshold` (default 2) times in a row, the guard returns\n * `{ shouldHalt: true }`.\n *\n * Callers are expected to:\n *   1. Call `record(prompt)` immediately before each auto-feed.\n *   2. If `shouldHalt` is true, clear the suggestion + auto-suggestion store,\n *      cancel any pending countdown, and surface a \"we detected a loop\"\n *      message asking the user what's happening. Do NOT feed the prompt.\n *   3. Call `reset()` whenever the user types anything manually (REPL manual\n *      input or any user-driven submit) so the next auto-feed starts clean.\n *\n * The default `repeatThreshold` is 2 \u2014 i.e. the second consecutive identical\n * feed (the first re-feed of an already-seen prompt) halts the loop. That\n * matches the user's report (\"receiving the same prompt 2-3 times in a row\n * causes the system to enter a loop\"). Setting it to 2 catches the loop on\n * the first identical re-feed rather than after the 50-iteration runaway cap trips.\n *\n * The window size is intentionally small (default 3). The loop we care about\n * is the immediate repetition \u2014 a longer history would misfire on legitimate\n * \"do X, then do Y, then do X\" sequences the model occasionally returns to.\n *\n * This module is BROWSER-SAFE \u2014 no Node-only imports \u2014 so it can be imported\n * from Vite-bundled WebUI as well as Node-based CLI/TUI.\n */\n\n/**\n * Normalize a prompt for repetition comparison. Whitespace is collapsed and\n * trimmed; case is folded to lowercase. Nothing semantic is removed, so two\n * prompts that differ in any meaningful way (extra word, different code,\n * different file path) compare as distinct. Two prompts that differ only by\n * leading/trailing whitespace and casing are treated as identical.\n */\nexport function normalizeForRepetition(prompt: string): string {\n  return prompt.replace(/\\s+/g, ' ').trim().toLowerCase();\n}\n\nexport interface LoopGuardOptions {\n  /**\n   * How many consecutive identical prompts (after normalization) trigger a\n   * halt. Default 2 \u2014 i.e. the second consecutive identical feed (the first\n   * re-feed of an already-seen prompt) halts the loop. Clamped to >= 2.\n   */\n  repeatThreshold?: number;\n  /**\n   * How many of the most recent feeds to retain for comparison. The window\n   * is searched from newest to oldest; the guard cares about the run of\n   * identical entries ending at the most recent one, not about identical\n   * entries anywhere in history. Default 3.\n   */\n  windowSize?: number;\n}\n\nexport interface RepetitionSignal {\n  /** The normalized prompt that just got recorded. */\n  normalized: string;\n  /**\n   * Number of consecutive identical feeds ending at the most recent feed,\n   * including this one. Always >= 1.\n   */\n  runLength: number;\n  /**\n   * True when the run length has crossed `repeatThreshold`. Callers must\n   * stop feeding and surface a user prompt instead.\n   */\n  shouldHalt: boolean;\n}\n\n/**\n * Steer text appended (once) to a grounded todo continuation when the board\n * has not moved between two consecutive automatic turns. Grounded prompts are\n * synthesized from durable todo state, so an identical re-feed means the whole\n * previous turn produced zero board movement \u2014 usually the model worked but\n * forgot to update the board. One explicit steer fixes that far more often\n * than halting; the halt only fires if the board stays frozen AFTER the steer.\n */\nexport const GROUNDED_NO_PROGRESS_STEER = [\n  'NOTE: The todo board has not changed since the previous automatic continuation \u2014 this exact instruction is being repeated.',\n  'Before anything else, bring the board up to date so the loop stays grounded:',\n  '- mark work that is actually finished as completed,',\n  '- split the current item into smaller concrete sub-items if it needs more than one turn,',\n  '- remove or reword items that no longer apply.',\n  'Then continue the work. If you are blocked, state exactly what is blocking you instead of repeating the same turn.',\n].join('\\n');\n\nexport type GroundedRepetitionAction = 'feed' | 'steer' | 'halt';\n\nexport interface GroundedRepetitionSignal extends RepetitionSignal {\n  /**\n   * What the caller should do with this grounded (todo-sourced) prompt:\n   *   - `feed`  \u2014 no repetition; feed the prompt as-is.\n   *   - `steer` \u2014 first repetition; feed the prompt with\n   *     {@link GROUNDED_NO_PROGRESS_STEER} appended instead of halting.\n   *   - `halt`  \u2014 the board stayed frozen even after a steer; break the loop\n   *     exactly like a `shouldHalt` from {@link AutoProceedLoopGuard.record}.\n   */\n  action: GroundedRepetitionAction;\n}\n\nexport interface AutoProceedLoopGuard {\n  /**\n   * Record a prompt that is about to be auto-fed. Returns the repetition\n   * signal for that prompt. When `shouldHalt` is true the caller MUST NOT\n   * feed the prompt \u2014 it has been recorded for post-mortem inspection, but\n   * the loop must be broken instead.\n   */\n  record(prompt: string): RepetitionSignal;\n  /**\n   * Record a GROUNDED prompt \u2014 one synthesized from durable state (the todo\n   * board) rather than echoed from model output. Repetition of a grounded\n   * prompt is a \"no board progress\" signal, not necessarily an echo loop, so\n   * the first repetition asks the caller to steer (append\n   * {@link GROUNDED_NO_PROGRESS_STEER} to the fed text) and only a repetition\n   * that survives the steer halts. The steer state resets whenever a\n   * different prompt is recorded (board moved) or on {@link reset}.\n   */\n  recordGrounded(prompt: string): GroundedRepetitionSignal;\n  /**\n   * Drop the history. Call this on any manual user input so a fresh run\n   * starts with no memory of the prior cycle.\n   */\n  reset(): void;\n  /**\n   * Read-only view of the most recent normalized prompts (newest last).\n   * Useful for diagnostics and for the message shown to the user when the\n   * guard halts the loop.\n   */\n  history(): readonly string[];\n  /**\n   * How many entries the guard is currently retaining.\n   */\n  size(): number;\n}\n\n/**\n * Build a fresh loop guard. Defaults: `repeatThreshold = 2`, `windowSize = 3`.\n *\n * @example\n *   const guard = createAutoProceedLoopGuard();\n *   for (const prompt of candidates) {\n *     const signal = guard.record(prompt);\n *     if (signal.shouldHalt) {\n *       haltAutoProceedAndAskUser(signal);\n *       break;\n *     }\n *     feedPrompt(prompt);\n *   }\n */\n// \u2500\u2500 Continuation-attempt tracker \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Tracks per-todo how many times auto-submit has continued on it, so\n// advancement prompts can vary wording and report \"attempt N\" rather than\n// feeding an identical instruction. Resets on manual user input.\n\nexport interface ContinuationAttemptTracker {\n  /** Record an attempt against a todo. Returns the new attempt count (\u2265 1). */\n  recordAttempt(todoId: string): number;\n  /** How many times continuation has been attempted for this todo (0 = never). */\n  getAttempts(todoId: string): number;\n  /** Mark a todo as \"skipped\" \u2014 a later attempt tried advancing past it. */\n  markSkipped(todoId: string): void;\n  /** True when this todo has been skipped due to no board progress. */\n  isSkipped(todoId: string): boolean;\n  /** Reset every tracked todo (call on manual user input). */\n  reset(): void;\n  /** Read-only snapshot for diagnostic use. */\n  snapshot(): Record<string, { attempts: number; skipped: boolean }>;\n}\n\nexport function createContinuationAttemptTracker(): ContinuationAttemptTracker {\n  const attempts = new Map<string, number>();\n  const skipped = new Set<string>();\n\n  return {\n    recordAttempt(todoId: string): number {\n      const count = (attempts.get(todoId) ?? 0) + 1;\n      attempts.set(todoId, count);\n      return count;\n    },\n    getAttempts(todoId: string): number {\n      return attempts.get(todoId) ?? 0;\n    },\n    markSkipped(todoId: string): void {\n      skipped.add(todoId);\n    },\n    isSkipped(todoId: string): boolean {\n      return skipped.has(todoId);\n    },\n    reset(): void {\n      attempts.clear();\n      skipped.clear();\n    },\n    snapshot(): Record<string, { attempts: number; skipped: boolean }> {\n      const result: Record<string, { attempts: number; skipped: boolean }> = {};\n      const allIds = new Set([...attempts.keys(), ...skipped]);\n      for (const id of allIds) {\n        result[id] = { attempts: attempts.get(id) ?? 0, skipped: skipped.has(id) };\n      }\n      return result;\n    },\n  };\n}\n\n// \u2500\u2500 Advancement prompt generator \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// When a grounded (todo-sourced) prompt stalls because the board hasn't\n// moved, instead of halting we advance to the next open todo and generate\n// a varied prompt that references the stalled item's attempt count. The\n// wording rotates through a pool so identical todos produce different\n// text across attempts.\n\nconst ADVANCE_PREAMBLES = [\n  'Pivoting to the next open item \u2014 previous todo still pending after {attempts} attempt(s).',\n  'Shifting focus to a different task while the previous item ({label}) remains open after {attempts} attempt(s).',\n  'No board progress on the current item after {attempts} attempt(s). Continuing with the next todo.',\n  'The previous item is still unresolved after {attempts} try(ies). Moving on down the list.',\n  'Advancing to the next piece of work after {attempts} unproductive attempt(s) on the prior one.',\n  'Taking a different angle \u2014 the stalled item ({label}) stays open after {attempts} attempt(s). Pressing ahead.',\n  'The todo board shows no movement on the current task after {attempts} attempt(s). Switching gears.',\n  'No change on the board from the last {attempts} continuation(s). Proceeding to the next open item.',\n];\n\n/**\n * Build a continuation-advancement prompt when the normal todo-sourced\n * prompt has stalled (no board progress). The text varies by attempt count\n * to avoid triggering the repetition guard.\n *\n * @param stalledTodo   The todo that didn't progress (used for its id/label).\n * @param nextTodo      The next open todo to advance to, or null if none left.\n * @param attemptCount  How many times stalledTodo has been retried.\n * @param todos         The full current todo list for board context.\n * @returns A varied advancement prompt for the next auto-feed.\n */\nexport function generateAdvancementPrompt(\n  stalledTodo: { id: string; content: string },\n  nextTodo: { id: string; content: string; status: string; activeForm?: string | undefined } | null,\n  attemptCount: number,\n  todos: readonly { id: string; content: string; status: string; activeForm?: string | undefined }[],\n): string {\n  const idx = Math.max(0, Math.min(attemptCount - 1, ADVANCE_PREAMBLES.length - 1));\n  const preamble = ADVANCE_PREAMBLES[idx]!\n    .replace(/\\{attempts\\}/g, () => String(attemptCount))\n    .replace(/\\{label\\}/g, () => stalledTodo.content.slice(0, 72));\n\n  if (!nextTodo) {\n    return [\n      preamble,\n      '',\n      'No more open items remain on the todo list. What has been accomplished and what should I do next?',\n    ].join('\\n');\n  }\n\n  const itemLabel =\n    nextTodo.status === 'in_progress' && nextTodo.activeForm\n      ? nextTodo.activeForm\n      : nextTodo.content;\n\n  const done = todos.filter((t) => t.status === 'completed').length;\n  const total = todos.length;\n\n  const lines: string[] = [preamble, '', `Proceed with: ${itemLabel}`];\n\n  if (total > 0) {\n    lines.push('', `Todo board (${done}/${total} done):`);\n    lines.push(\n      ...todos.slice(0, 20).map((t) => {\n        const mark = t.status === 'completed' ? '[x]' : t.status === 'in_progress' ? '[~]' : '[ ]';\n        const flat = t.content.replace(/\\n|\\r/g, ' ');\n        return `  ${mark} ${flat}`;\n      }),\n    );\n  }\n\n  lines.push('', 'If this item is already done, mark it complete and move to the next open todo. Keep the board honest as you work.');\n\n  return lines.join('\\n');\n}\n\n// \u2500\u2500 Stalled-todo matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Shared helper used by both TUI and WebUI to identify which todo produced a\n// stalled continuation prompt. Matches by content against the in_progress /\n// pending todos in the board before falling back to the first open item.\n\nexport interface StalledTodoMatch {\n  id: string;\n  content: string;\n}\n\n/**\n * Identify the todo whose content appears in a stalled continuation prompt.\n * Scans the board for the in_progress item first (that's what\n * `resolveContinuation` picks), then falls back to any pending item whose\n * text appears in the prompt. Last resort: the first non-completed todo.\n *\n * Returns `null` when the board is empty or all items are completed.\n */\nexport function matchTodoIdFromPrompt(\n  todos: readonly { id: string; content: string; status: string; activeForm?: string | undefined }[],\n  prompt: string,\n): StalledTodoMatch | null {\n  if (todos.length === 0 || !prompt) return null;\n  const lowerPrompt = prompt.toLowerCase();\n\n  // 1. In-progress item \u2014 resolveContinuation promotes this first.\n  const inProgress = todos.find((t) => t.status === 'in_progress');\n  if (inProgress) {\n    const label = (inProgress.activeForm ?? inProgress.content).toLowerCase();\n    if (label.length > 5 && lowerPrompt.includes(label)) {\n      return { id: inProgress.id, content: inProgress.activeForm ?? inProgress.content };\n    }\n  }\n\n  // 2. Any pending item whose content appears in the prompt (board snapshot).\n  for (const t of todos) {\n    if (t.status === 'completed') continue;\n    if (inProgress && t.id === inProgress.id) continue;\n    const label = (t.activeForm ?? t.content).toLowerCase();\n    if (label.length > 5 && lowerPrompt.includes(label)) {\n      return { id: t.id, content: t.activeForm ?? t.content };\n    }\n  }\n\n  // 3. Last resort \u2014 pick the first non-completed todo.\n  const firstOpen = todos.find((t) => t.status !== 'completed');\n  return firstOpen ? { id: firstOpen.id, content: firstOpen.activeForm ?? firstOpen.content } : null;\n}\n\n/**\n * Maximum total advancement attempts before we give up on the board and\n * halt. Otherwise a board where no agent turn makes progress cycles through\n * the same todos indefinitely. Reset on manual user input.\n */\nexport const MAX_ADVANCEMENT_ATTEMPTS = 9;\n\nexport function createAutoProceedLoopGuard(options: LoopGuardOptions = {}): AutoProceedLoopGuard {\n  // Validate options defensively. Non-finite values (NaN, Infinity) MUST\n  // fall back to the documented default \u2014 a guard that silently disables\n  // itself is worse than no guard at all. Specifically:\n  //   - `repeatThreshold: NaN` would cause `Math.floor(NaN) = NaN`,\n  //     `Math.max(2, NaN) = NaN`, and `runLength >= NaN` is always false,\n  //     making the guard permanent no-op.\n  //   - `windowSize: NaN` / `Infinity` would skip the trim branch entirely\n  //     (`buffer.length > NaN` and `buffer.length > Infinity` are both\n  //     false), so the buffer would grow without bound.\n  const safeIntegerOption = (value: number | undefined, fallback: number): number => {\n    if (value === undefined) return fallback;\n    if (!Number.isFinite(value)) return fallback;\n    return Math.floor(value);\n  };\n  const repeatThreshold = Math.max(2, safeIntegerOption(options.repeatThreshold, 2));\n  const windowSize = Math.max(repeatThreshold, safeIntegerOption(options.windowSize, 3));\n  let buffer: string[] = [];\n  // Normalized grounded prompt we already steered for; a halt only fires for\n  // a grounded prompt that repeats again AFTER its steer.\n  let steeredFor: string | null = null;\n\n  function record(prompt: string): RepetitionSignal {\n    const normalized = normalizeForRepetition(prompt);\n    buffer.push(normalized);\n    if (buffer.length > windowSize) {\n      buffer = buffer.slice(buffer.length - windowSize);\n    }\n    // Count the trailing run of identical normalized prompts.\n    let runLength = 0;\n    for (let i = buffer.length - 1; i >= 0; i--) {\n      if (buffer[i] === normalized) runLength++;\n      else break;\n    }\n    return {\n      normalized,\n      runLength,\n      shouldHalt: runLength >= repeatThreshold,\n    };\n  }\n\n  function recordGrounded(prompt: string): GroundedRepetitionSignal {\n    const signal = record(prompt);\n    if (!signal.shouldHalt) {\n      // The board moved (different prompt) \u2014 clear any pending steer state.\n      steeredFor = null;\n      return { ...signal, shouldHalt: false, action: 'feed' };\n    }\n    if (steeredFor === signal.normalized) {\n      return { ...signal, action: 'halt' };\n    }\n    steeredFor = signal.normalized;\n    return { ...signal, shouldHalt: false, action: 'steer' };\n  }\n\n  function reset(): void {\n    buffer = [];\n    steeredFor = null;\n  }\n\n  function history(): readonly string[] {\n    return buffer.slice();\n  }\n\n  function size(): number {\n    return buffer.length;\n  }\n\n  return { record, recordGrounded, reset, history, size };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bash.js

@@ -935,7 +935,11 @@ var PersistentProcessRegistry = class {
   cleanupRunning = false;
   isShuttingDown = false;
   onProcessExit = () => {
-    void this.syncToPersistent();
+    this.runInBackground(
+      this.syncToPersistent(),
+      "process_registry.exit_sync_failed",
+      "PersistentProcessRegistry: exit sync failed"
+    );
   };
   constructor(baseRegistry) {
     this.instanceId = generateInstanceId();
@@ -955,6 +959,11 @@ var PersistentProcessRegistry = class {
       if (!isNodeError(err) || err.code !== "EEXIST") throw err;
     }
   }
+  runInBackground(operation, event, message) {
+    void operation.catch((err) => {
+      emitStructuredLog("warn", event, message, err);
+    });
+  }
   /**
    * Start the heartbeat and periodic cleanup tasks.
    */
@@ -987,26 +996,34 @@ var PersistentProcessRegistry = class {
       this.cleanupInterval = null;
     }
     process.off("exit", this.onProcessExit);
-    void this.syncToPersistent();
+    this.runInBackground(
+      this.syncToPersistent(),
+      "process_registry.stop_sync_failed",
+      "PersistentProcessRegistry: stop sync failed"
+    );
   }
   /**
    * Register the main WrongStack process as protected.
    */
   registerMainProcess() {
     const mainPid = process.pid;
-    this.updatePersistentEntry({
-      pid: mainPid,
-      name: "wrongstack-main",
-      command: process.argv.slice(0, 3).join(" "),
-      startedAt: Date.now(),
-      lastHeartbeat: Date.now(),
-      instanceId: this.instanceId,
-      hostname: os2.hostname(),
-      protected: true,
-      spawnMode: "main",
-      parentPid: process.ppid,
-      platform: process.platform
-    });
+    this.runInBackground(
+      this.updatePersistentEntry({
+        pid: mainPid,
+        name: "wrongstack-main",
+        command: process.argv.slice(0, 3).join(" "),
+        startedAt: Date.now(),
+        lastHeartbeat: Date.now(),
+        instanceId: this.instanceId,
+        hostname: os2.hostname(),
+        protected: true,
+        spawnMode: "main",
+        parentPid: process.ppid,
+        platform: process.platform
+      }),
+      "process_registry.main_register_failed",
+      "PersistentProcessRegistry: failed to register main process"
+    );
   }
   /**
    * Register a spawned child process with the persistent registry.
@@ -1029,7 +1046,11 @@ var PersistentProcessRegistry = class {
     if (sessionId) {
       entry.sessionId = sessionId;
     }
-    this.updatePersistentEntry(entry);
+    this.runInBackground(
+      this.updatePersistentEntry(entry),
+      "process_registry.child_register_failed",
+      "PersistentProcessRegistry: failed to register child process"
+    );
   }
   /**
    * Update or add an entry in the persistent registry.
@@ -1073,14 +1094,28 @@ var PersistentProcessRegistry = class {
   heartbeat() {
     if (this.isShuttingDown || this.heartbeatRunning) return;
     this.heartbeatRunning = true;
-    void this.syncToPersistent().finally(() => {
+    void this.syncToPersistent().catch((err) => {
+      emitStructuredLog(
+        "warn",
+        "process_registry.heartbeat_failed",
+        "PersistentProcessRegistry: heartbeat failed",
+        err
+      );
+    }).finally(() => {
       this.heartbeatRunning = false;
     });
   }
   cleanup() {
     if (this.isShuttingDown || this.cleanupRunning) return;
     this.cleanupRunning = true;
-    void this.cleanupStaleEntries().finally(() => {
+    void this.cleanupStaleEntries().catch((err) => {
+      emitStructuredLog(
+        "warn",
+        "process_registry.periodic_cleanup_failed",
+        "PersistentProcessRegistry: periodic cleanup failed",
+        err
+      );
+    }).finally(() => {
       this.cleanupRunning = false;
     });
   }