jonah-fleet 1.12.0 → 1.14.0

package/CHANGELOG.md

@@ -5,19 +5,30 @@ All notable changes to `jonah-fleet` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.12.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.11.0...v1.12.0) (2026-09-18)
+## [1.14.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.13.0...v1.14.0) (2026-09-19)
 
 
 ### Features
 
-* **radar:** add zqiren/Orbital to ecosystem radar and evaluation matrix ([#212](https://github.com/juliendurandeu/jonah-fleet/issues/212)) ([910febb](https://github.com/juliendurandeu/jonah-fleet/commit/910febbbc8196d53c20f05730770aae231a6b8ea)), closes [#206](https://github.com/juliendurandeu/jonah-fleet/issues/206)
+* **workflows:** handle LLM quota limits with graceful pause (status:quota-paused) ([#240](https://github.com/juliendurandeu/jonah-fleet/issues/240)) ([98bb176](https://github.com/juliendurandeu/jonah-fleet/commit/98bb176f0b29462ab9de6baf5d0f102fee78b0ba))
 
+## [Unreleased] - 2026-09-19
 
-### Bug Fixes
+### Features
+
+* **workflows:** intercept LLM quota limit errors (`Individual quota reached`), record reset timeline, label tracking issue `status:quota-paused`, and pause routine execution gracefully with exit code 0 to prevent broken Action builds and wasted runner minutes.
+* **labels:** introduce `status:quota-paused` to core fleet label definitions.
+
+## [1.13.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.12.0...v1.13.0) (2026-09-19)
 
-* **runner:** prevent premature routine termination on async background tasks in headless mode ([6641b2b](https://github.com/juliendurandeu/jonah-fleet/commit/6641b2b2e46ab363b73d490aac1144a33a1c69f9))
 
-## [Unreleased] - 2026-09-18
+### Features
+
+* **guard:** implement CLI runner loop-guard and circuit-breaker wrapper ([#222](https://github.com/juliendurandeu/jonah-fleet/issues/222)) ([bedacc0](https://github.com/juliendurandeu/jonah-fleet/commit/bedacc0d9bc2a36276f58901ffa2f2b06e797016))
+* **memory:** introduce opt-in LESSONS.md operational memory tier ([#207](https://github.com/juliendurandeu/jonah-fleet/issues/207)) ([#219](https://github.com/juliendurandeu/jonah-fleet/issues/219)) ([13f74fa](https://github.com/juliendurandeu/jonah-fleet/commit/13f74fa2acc78554bba486b2bf77521106265f03))
+* **orchestration:** standardize 'Why I believe this' structured human escalation card ([#229](https://github.com/juliendurandeu/jonah-fleet/issues/229)) ([997e1d2](https://github.com/juliendurandeu/jonah-fleet/commit/997e1d20d7d0a3970ecca9f209841db745f99979))
+
+## [1.12.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.11.0...v1.12.0) (2026-09-18)
 
 ### Bug Fixes
 

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export {};
+export * from './lib/loop-guard.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6IA,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -122,7 +122,7 @@ var ROUTINE_TO_WORKFLOW_MAP = {
   "issues-housekeeping": ["issues-housekeeping-cron.yml"],
   "dependency-update-security-check": ["dependency-check-cron.yml"],
   "product-planning": [],
-  "analytics-review": [],
+  "analytics-review": ["analytics-review-cron.yml"],
   "design-review": ["design-review-cron.yml"]
 };
 var FLEET_VERSION = "1.8.0";
@@ -608,6 +608,22 @@ function installFleet(targetDir, manifest, options = {}) {
       }
     }
   }
+  const targetScriptsDir = path3.join(targetDir, ".github/scripts");
+  fs3.mkdirSync(targetScriptsDir, { recursive: true });
+  const baseScripts = ["run-with-loop-guard.js"];
+  for (const file of baseScripts) {
+    const src = path3.join(templatesDir, "scripts", file);
+    const dest = path3.join(targetScriptsDir, file);
+    if (fs3.existsSync(src)) {
+      if (!fs3.existsSync(dest) || options.force) {
+        fs3.copyFileSync(src, dest);
+        try {
+          fs3.chmodSync(dest, 493);
+        } catch {
+        }
+      }
+    }
+  }
   for (const [routineName, isEnabled] of Object.entries(manifest.routines)) {
     if (!isEnabled) continue;
     const promptFile = `${routineName}.md`;
@@ -672,6 +688,17 @@ function installFleet(targetDir, manifest, options = {}) {
       result.docsInstalled.push("AGENTS.md");
     }
   }
+  const lessonsEnabled = manifest.lessons === true || typeof manifest.lessons === "object" && manifest.lessons?.enabled;
+  if (lessonsEnabled) {
+    const lessonsPath = path3.join(targetDir, "LESSONS.md");
+    if (!fs3.existsSync(lessonsPath) || options.force) {
+      const lessonsSrc = path3.join(templatesDir, "docs/LESSONS.template.md");
+      if (fs3.existsSync(lessonsSrc)) {
+        fs3.copyFileSync(lessonsSrc, lessonsPath);
+        result.docsInstalled.push("LESSONS.md");
+      }
+    }
+  }
   return result;
 }
 
@@ -1321,6 +1348,7 @@ var FLEET_CORE_LABELS = [
   { name: "status:running", color: "fbca04", description: "Routine execution in progress" },
   { name: "status:success", color: "0e8a16", description: "Routine execution succeeded" },
   { name: "status:failure", color: "d93f0b", description: "Routine execution failed" },
+  { name: "status:quota-paused", color: "e4e669", description: "Routine execution paused due to API quota limits" },
   { name: "needs-attention", color: "e11d48", description: "Requires maintainer triage" },
   { name: "runner:github-actions", color: "1f883d", description: "Executed via GitHub Actions" },
   { name: "runner:local", color: "bfd4f2", description: "Executed via local machine daemon" },
@@ -3495,6 +3523,223 @@ var TerminalSpinner = class {
   }
 };
 
+// src/lib/loop-guard.ts
+import crypto from "crypto";
+function canonicalStringify(value) {
+  if (value === null || value === void 0) {
+    return "";
+  }
+  if (typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return "[" + value.map(canonicalStringify).join(",") + "]";
+  }
+  const keys = Object.keys(value).sort();
+  const entries = keys.map((k) => `${JSON.stringify(k)}:${canonicalStringify(value[k])}`);
+  return "{" + entries.join(",") + "}";
+}
+function computeActionHash(toolName, args) {
+  const canonicalArgs = canonicalStringify(args);
+  return crypto.createHash("sha256").update(`${toolName}:${canonicalArgs}`).digest("hex");
+}
+var LoopGuard = class {
+  repetitionThreshold;
+  pingPongThreshold;
+  consecutiveErrorThreshold;
+  slidingWindowSize;
+  onTrip;
+  history = [];
+  lastErrorHash = null;
+  consecutiveErrorCount = 0;
+  trippedResult = null;
+  constructor(options = {}) {
+    this.repetitionThreshold = options.repetitionThreshold ?? 5;
+    this.pingPongThreshold = options.pingPongThreshold ?? 3;
+    this.consecutiveErrorThreshold = options.consecutiveErrorThreshold ?? 2;
+    this.slidingWindowSize = options.slidingWindowSize ?? 20;
+    this.onTrip = options.onTrip;
+  }
+  setOnTrip(callback) {
+    this.onTrip = callback;
+  }
+  isTripped() {
+    return this.trippedResult !== null;
+  }
+  getTrip() {
+    return this.trippedResult;
+  }
+  getHistory() {
+    return [...this.history];
+  }
+  reset() {
+    this.history = [];
+    this.lastErrorHash = null;
+    this.consecutiveErrorCount = 0;
+    this.trippedResult = null;
+  }
+  /**
+   * Records an action occurrence and evaluates repetition, ping-pong, and error guards.
+   */
+  recordAction(toolName, args, isError = false) {
+    if (this.trippedResult) {
+      return this.trippedResult;
+    }
+    const hash = computeActionHash(toolName, args);
+    const record = {
+      toolName,
+      args,
+      hash,
+      isError,
+      timestamp: Date.now()
+    };
+    if (isError) {
+      if (this.lastErrorHash === hash) {
+        this.consecutiveErrorCount++;
+      } else {
+        this.lastErrorHash = hash;
+        this.consecutiveErrorCount = 1;
+      }
+      if (this.consecutiveErrorCount >= this.consecutiveErrorThreshold) {
+        return this.triggerTrip({
+          reason: "consecutive_errors",
+          message: `Tool circuit breaker tripped: ${this.consecutiveErrorCount} consecutive identical tool errors for '${toolName}' with unchanged arguments.`,
+          toolName,
+          actionHash: hash,
+          count: this.consecutiveErrorCount
+        });
+      }
+    } else {
+      this.lastErrorHash = null;
+      this.consecutiveErrorCount = 0;
+    }
+    this.history.push(record);
+    const windowStart = Math.max(0, this.history.length - this.slidingWindowSize);
+    const currentWindow = this.history.slice(windowStart);
+    let repetitionCount = 0;
+    for (const item of currentWindow) {
+      if (item.hash === hash) {
+        repetitionCount++;
+      }
+    }
+    if (repetitionCount >= this.repetitionThreshold) {
+      return this.triggerTrip({
+        reason: "repetition",
+        message: `Action repetition loop detected: tool '${toolName}' called ${repetitionCount} times with identical parameters within sliding window of ${this.slidingWindowSize}.`,
+        toolName,
+        actionHash: hash,
+        count: repetitionCount
+      });
+    }
+    const requiredPingPongLength = this.pingPongThreshold * 2;
+    if (this.history.length >= requiredPingPongLength) {
+      const pingPongSlice = this.history.slice(-requiredPingPongLength);
+      const hashA = pingPongSlice[0].hash;
+      const hashB = pingPongSlice[1].hash;
+      if (hashA !== hashB) {
+        let isPingPong = true;
+        for (let i = 0; i < requiredPingPongLength; i++) {
+          const expectedHash = i % 2 === 0 ? hashA : hashB;
+          if (pingPongSlice[i].hash !== expectedHash) {
+            isPingPong = false;
+            break;
+          }
+        }
+        if (isPingPong) {
+          return this.triggerTrip({
+            reason: "ping_pong",
+            message: `Alternating ping-pong action loop detected: ${this.pingPongThreshold} consecutive alternating cycles between tools (A-B-A-B-A-B).`,
+            toolName,
+            actionHash: hash,
+            count: this.pingPongThreshold
+          });
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Feeds a single line of output (stream-json or raw text) into the guard.
+   */
+  feedLine(line) {
+    if (!line || !line.trim()) return null;
+    try {
+      const parsed = JSON.parse(line.trim());
+      if (parsed && typeof parsed === "object" && parsed.event === "step_update") {
+        const su = parsed.step_update;
+        if (su && su.step_type === "tool") {
+          const toolName = su.tool_name || su.tool_info?.name || "unknown";
+          const params = su.tool_info?.parameters;
+          if (su.state === "ACTIVE") {
+            return this.recordAction(toolName, params, false);
+          }
+          if (su.state === "ERROR") {
+            return this.recordAction(toolName, params, true);
+          }
+        }
+      }
+    } catch {
+    }
+    return null;
+  }
+  triggerTrip(trip) {
+    this.trippedResult = trip;
+    if (this.onTrip) {
+      try {
+        this.onTrip(trip);
+      } catch {
+      }
+    }
+    return trip;
+  }
+};
+function formatLoopGuardFailureCard(options) {
+  const serverUrl = options.serverUrl || process.env.GITHUB_SERVER_URL || "https://github.com";
+  const repository = options.repository || process.env.GITHUB_REPOSITORY || "";
+  const runId = options.runId || process.env.GITHUB_RUN_ID || "";
+  const logUrl = runId && repository ? `${serverUrl}/${repository}/actions/runs/${runId}` : "";
+  const lines = [
+    `### \u274C Milestone: Run Interrupted / Failed`,
+    `- **Routine**: \`${options.routine}\``,
+    `- **Status**: Loop guard circuit breaker tripped (\`loop_circuit_breaker\`)`,
+    `- **Root Cause Category**: \`loop_circuit_breaker\``,
+    `- **Trigger**: \`${options.trip.reason}\``,
+    `- **Reason**: ${options.trip.message}`,
+    `- **Action**: Process terminated to prevent runaway token burn`
+  ];
+  if (logUrl) {
+    lines.push(`- **Action Log**: [View Run Logs](${logUrl})`);
+  }
+  return lines.join("\n");
+}
+function formatLoopGuardReport(options) {
+  return [
+    `# Run Report`,
+    ``,
+    `## Result`,
+    `FAILURE`,
+    ``,
+    `## Summary`,
+    `| Metric | Value |`,
+    `|---|---|`,
+    `| Routine | \`${options.routine}\` |`,
+    `| Timestamp | \`${options.timestamp}\` |`,
+    `| Result | \`FAILURE\` |`,
+    `| Category | \`loop_circuit_breaker\` |`,
+    `| Trigger | \`${options.trip.reason}\` |`,
+    `| Tool | \`${options.trip.toolName}\` |`,
+    `| Action Hash | \`${options.trip.actionHash}\` |`,
+    ``,
+    `### Failure Details`,
+    `The autonomous execution was halted by the deterministic loop-guard wrapper.`,
+    `- **Category**: \`loop_circuit_breaker\``,
+    `- **Trigger**: \`${options.trip.reason}\``,
+    `- **Tool**: \`${options.trip.toolName}\``,
+    `- **Action Hash**: \`${options.trip.actionHash}\``,
+    `- **Message**: ${options.trip.message}`
+  ].join("\n");
+}
+
 // src/lib/runner.ts
 import pc10 from "picocolors";
 var execFileAsync4 = promisify4(execFile4);
@@ -3699,8 +3944,56 @@ async function tryPostLocalRunMilestoneAsync(cwd, issueNumber, cardContent) {
     }
   }
 }
-function tryReconcileLocalRunIssue(cwd, issueNumber, reportContent, exitCode, hostname, routine) {
+function detectQuotaExceeded(output, stderr) {
+  const combined = `${output}
+${stderr}`;
+  if (/individual quota reached|quota reached/i.test(combined)) {
+    const match = combined.match(/Resets in ([^.\n]+)/i);
+    return {
+      isQuota: true,
+      resetInfo: match ? `Resets in ${match[1].trim()}` : void 0
+    };
+  }
+  return { isQuota: false };
+}
+function tryReconcileLocalRunIssue(cwd, issueNumber, reportContent, exitCode, hostname, routine, quotaInfo) {
   try {
+    if (quotaInfo?.isQuota) {
+      const resetStr = quotaInfo.resetInfo || "Resets in future window";
+      const quotaCard = [
+        `### \u23F8\uFE0F Milestone: Routine Execution Quota-Paused`,
+        `- **Routine**: \`${routine || "local-routine"}\``,
+        `- **Status**: LLM quota reached (\`${resetStr}\`)`,
+        `- **Runner**: \`local (${hostname})\``,
+        `- **Next Action**: Routine execution paused cleanly. Work will resume on next sweep after quota resets.`
+      ].join("\n");
+      tryPostLocalRunMilestone(cwd, issueNumber, quotaCard);
+      const finalBody2 = `${reportContent}
+
+---
+_Generated by Jonah Fleet local runner on ${hostname}._`;
+      const tmpFile2 = path12.join(os2.tmpdir(), `jonah-fleet-run-${issueNumber}-${Date.now()}.md`);
+      fs12.writeFileSync(tmpFile2, finalBody2, "utf8");
+      try {
+        execSync2(`gh issue edit ${issueNumber} --body-file ${JSON.stringify(tmpFile2)}`, {
+          cwd,
+          stdio: ["ignore", "ignore", "ignore"]
+        });
+        execSync2(`gh issue edit ${issueNumber} --add-label "status:quota-paused" --remove-label "status:running"`, {
+          cwd,
+          stdio: ["ignore", "ignore", "ignore"]
+        });
+        execSync2(`gh issue close ${issueNumber} --reason completed`, {
+          cwd,
+          stdio: ["ignore", "ignore", "ignore"]
+        });
+      } finally {
+        if (fs12.existsSync(tmpFile2)) {
+          fs12.unlinkSync(tmpFile2);
+        }
+      }
+      return;
+    }
     if (exitCode !== 0) {
       const interruptionCard = formatInterruptionCard({
         routine: routine || "local-routine",
@@ -4044,6 +4337,33 @@ Timeout: ${printTimeout}`,
       });
     }
   };
+  let loopGuardTrip = null;
+  let activeChild = null;
+  const loopGuard = new LoopGuard({
+    repetitionThreshold: 5,
+    pingPongThreshold: 3,
+    consecutiveErrorThreshold: 2,
+    slidingWindowSize: 20,
+    onTrip: (trip) => {
+      loopGuardTrip = trip;
+      spinner?.stop();
+      if (activeChild && !activeChild.killed) {
+        try {
+          activeChild.kill("SIGTERM");
+        } catch {
+        }
+        const killTimer = setTimeout(() => {
+          try {
+            if (activeChild && !activeChild.killed) {
+              activeChild.kill("SIGKILL");
+            }
+          } catch {
+          }
+        }, 3e3);
+        killTimer.unref();
+      }
+    }
+  });
   const stdoutParser = new LineBufferedStreamParser((line) => {
     const event = parseStreamJsonEvent(line);
     if (event) {
@@ -4053,6 +4373,7 @@ Timeout: ${printTimeout}`,
           const toolName = su.tool_name || su.tool_info?.name || "unknown";
           const toolParams = su.tool_info?.parameters;
           if (su.state === "ACTIVE") {
+            loopGuard.recordAction(toolName, toolParams, false);
             const actionDesc = formatActionDescription(toolName, toolParams);
             lastActionDesc = actionDesc;
             if (spinner) {
@@ -4065,6 +4386,9 @@ Timeout: ${printTimeout}`,
               const formatted = formatVerboseEvent(event);
               if (formatted) console.log(formatted);
             }
+          } else if (su.state === "ERROR") {
+            loopGuard.recordAction(toolName, toolParams, true);
+            lastActionDesc = null;
           } else if (su.state === "DONE") {
             lastActionDesc = null;
             if (su.tool_info?.output) {
@@ -4168,6 +4492,7 @@ Timeout: ${printTimeout}`,
         env: childEnv,
         stdio: ["inherit", "pipe", "pipe"]
       });
+      activeChild = child;
       child.stdout?.on("data", (data) => {
         processChunk(data.toString(), false);
       });
@@ -4204,7 +4529,26 @@ Timeout: ${printTimeout}`,
       exitCode = 1;
     }
   }
-  if (!reportContent) {
+  if (loopGuardTrip) {
+    exitCode = 1;
+    reportContent = formatLoopGuardReport({
+      routine,
+      timestamp,
+      trip: loopGuardTrip
+    });
+    try {
+      fs12.writeFileSync(executionReportPath, reportContent, "utf8");
+      fs12.writeFileSync(targetReportPath, reportContent, "utf8");
+    } catch {
+    }
+    if (routineIssueNumber) {
+      const failureCard = formatLoopGuardFailureCard({
+        routine,
+        trip: loopGuardTrip
+      });
+      tryPostLocalRunMilestone(targetDir, routineIssueNumber, failureCard);
+    }
+  } else if (!reportContent) {
     reportContent = formatFallbackRunReport({
       routine,
       timestamp,
@@ -4243,8 +4587,9 @@ Timeout: ${printTimeout}`,
     );
   } catch {
   }
+  const quotaInfo = detectQuotaExceeded(output, accumulatedStderr);
   if (routineIssueNumber) {
-    tryReconcileLocalRunIssue(targetDir, routineIssueNumber, reportContent, exitCode, hostname, routine);
+    tryReconcileLocalRunIssue(targetDir, routineIssueNumber, reportContent, exitCode, hostname, routine, quotaInfo);
   }
   if (options.showCard !== false && !options.verbose) {
     const prMatch = targetLabel.match(/PR\s*#?(\d+)/i);
@@ -5919,3 +6264,10 @@ program.command("telemetry [repos...]").description("Aggregate and report fleet-
   await runTelemetry({ ...options, repos, action });
 });
 program.parse(process.argv);
+export {
+  LoopGuard,
+  canonicalStringify,
+  computeActionHash,
+  formatLoopGuardFailureCard,
+  formatLoopGuardReport
+};

package/dist/lib/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/lib/installer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAA2B,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAyC,MAAM,eAAe,CAAC;AAKrF,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,aAAa,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAqBpB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CA2GpH"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/lib/installer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAA2B,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAyC,MAAM,eAAe,CAAC;AAKrF,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,aAAa,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAqBpB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAyIpH"}

package/dist/lib/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/lib/labels.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/lib/labels.ts"],"names":[],"mappings":"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"}

package/dist/lib/loop-guard.d.ts

@@ -0,0 +1,80 @@
+export type LoopGuardTripReason = 'repetition' | 'ping_pong' | 'consecutive_errors';
+export interface LoopGuardTrip {
+    reason: LoopGuardTripReason;
+    message: string;
+    toolName: string;
+    actionHash: string;
+    count: number;
+}
+export interface ActionRecord {
+    toolName: string;
+    args: any;
+    hash: string;
+    isError: boolean;
+    timestamp: number;
+}
+export interface LoopGuardOptions {
+    repetitionThreshold?: number;
+    pingPongThreshold?: number;
+    consecutiveErrorThreshold?: number;
+    slidingWindowSize?: number;
+    onTrip?: (trip: LoopGuardTrip) => void;
+}
+/**
+ * Deterministically stringifies an object by recursively sorting its keys.
+ */
+export declare function canonicalStringify(value: any): string;
+/**
+ * Computes a deterministic SHA-256 action hash: SHA-256(tool_name + canonicalString(args))
+ */
+export declare function computeActionHash(toolName: string, args: any): string;
+/**
+ * Deterministic Loop Guard & Circuit Breaker monitoring tool calls and execution events.
+ */
+export declare class LoopGuard {
+    private repetitionThreshold;
+    private pingPongThreshold;
+    private consecutiveErrorThreshold;
+    private slidingWindowSize;
+    private onTrip?;
+    private history;
+    private lastErrorHash;
+    private consecutiveErrorCount;
+    private trippedResult;
+    constructor(options?: LoopGuardOptions);
+    setOnTrip(callback: (trip: LoopGuardTrip) => void): void;
+    isTripped(): boolean;
+    getTrip(): LoopGuardTrip | null;
+    getHistory(): ActionRecord[];
+    reset(): void;
+    /**
+     * Records an action occurrence and evaluates repetition, ping-pong, and error guards.
+     */
+    recordAction(toolName: string, args: any, isError?: boolean): LoopGuardTrip | null;
+    /**
+     * Feeds a single line of output (stream-json or raw text) into the guard.
+     */
+    feedLine(line: string): LoopGuardTrip | null;
+    private triggerTrip;
+}
+export interface LoopGuardFailureCardOptions {
+    routine: string;
+    trip: LoopGuardTrip;
+    runId?: string;
+    serverUrl?: string;
+    repository?: string;
+}
+/**
+ * Formats a structured 5-point milestone interruption card on circuit breaker trip.
+ */
+export declare function formatLoopGuardFailureCard(options: LoopGuardFailureCardOptions): string;
+export interface LoopGuardReportOptions {
+    routine: string;
+    timestamp: string;
+    trip: LoopGuardTrip;
+}
+/**
+ * Formats a markdown run report for .jonah-fleet/run-report.md when loop guard terminates a run.
+ */
+export declare function formatLoopGuardReport(options: LoopGuardReportOptions): string;
+//# sourceMappingURL=loop-guard.d.ts.map

package/dist/lib/loop-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-guard.d.ts","sourceRoot":"","sources":["../../src/lib/loop-guard.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAarD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAGrE;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,CAAgC;IAE/C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,aAAa,CAA8B;IAEnD,YAAY,OAAO,GAAE,gBAAqB,EAMzC;IAEM,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAE9D;IAEM,SAAS,IAAI,OAAO,CAE1B;IAEM,OAAO,IAAI,aAAa,GAAG,IAAI,CAErC;IAEM,UAAU,IAAI,YAAY,EAAE,CAElC;IAEM,KAAK,IAAI,IAAI,CAKnB;IAED;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,OAAe,GAAG,aAAa,GAAG,IAAI,CA6F/F;IAED;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwBlD;IAED,OAAO,CAAC,WAAW;CAWpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAqBvF;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA0B7E"}

package/dist/lib/presets.d.ts

@@ -80,6 +80,11 @@ export interface FleetManifest {
     labels?: {
         protected?: string[];
     };
+    lessons?: boolean | LessonsConfig;
+}
+export interface LessonsConfig {
+    enabled?: boolean;
+    maxEntries?: number;
 }
 export declare const DEFAULT_ROUTINE_MODELS: Record<string, string>;
 export declare const DEFAULT_ROUTINE_TIMEOUTS: Record<string, number>;

package/dist/lib/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/lib/presets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/lib/presets.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kCAAkC,CAAC,EAAE,MAAM,CAAC;QAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kCAAkC,CAAC,EAAE,MAAM,CAAC;QAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE;QACR,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;QACnB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,kCAAkC,EAAE,OAAO,CAAC;QAC5C,kBAAkB,EAAE,OAAO,CAAC;QAC5B,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kCAAkC,CAAC,EAAE,MAAM,CAAC;QAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC9B,CAAC;IACF,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASzD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS3D,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASjE,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aAKnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAsBpC,CAAC;AAGF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAI3C,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoE3H,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAcrF,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,GAAG,YAAY,CASlG,CAAC;AAEF,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,UAAU,kFAAkF,CAAC"}

package/dist/lib/runner.d.ts

@@ -145,12 +145,21 @@ export declare function tryPostLocalRunMilestone(cwd: string, issueNumber: numbe
  * Fails gracefully if offline or unauthenticated.
  */
 export declare function tryPostLocalRunMilestoneAsync(cwd: string, issueNumber: number, cardContent: string): Promise<boolean>;
+export interface QuotaDetectionResult {
+    isQuota: boolean;
+    resetInfo?: string;
+}
+/**
+ * Detects whether routine runner stdout/stderr failed due to LLM quota exhaustion.
+ */
+export declare function detectQuotaExceeded(output: string, stderr: string): QuotaDetectionResult;
 /**
  * Reconciles a GitHub issue for local routine execution.
  * Closes the issue if success, leaves it open with needs-attention if failure.
+ * Handles quota-paused routines gracefully without marking as failure.
  * Fails gracefully if offline or unauthenticated.
  */
-export declare function tryReconcileLocalRunIssue(cwd: string, issueNumber: number, reportContent: string, exitCode: number, hostname: string, routine?: string): void;
+export declare function tryReconcileLocalRunIssue(cwd: string, issueNumber: number, reportContent: string, exitCode: number, hostname: string, routine?: string, quotaInfo?: QuotaDetectionResult): void;
 /**
  * Asynchronously marks an interrupted local routine run as failed and posts an interruption card.
  * Leaves the issue open with status:failure,needs-attention for maintainer triage.