jonah-fleet 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.13.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.12.0...v1.13.0) (2026-09-19)
+
+
+### 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)
 
 
@@ -17,7 +26,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * **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
+## [Unreleased] - 2026-09-19
+
+### Features
+
+* **orchestration:** standardize 'Why I believe this' structured human escalation card across autowork, triage, and housekeeping routines ([#209](https://github.com/juliendurandeu/jonah-fleet/issues/209))
+* **guard:** implement CLI runner loop-guard and circuit-breaker wrapper ([#208](https://github.com/juliendurandeu/jonah-fleet/issues/208))
+* **memory:** introduce opt-in LESSONS.md operational memory tier with 25-entry hard cap, schema configuration, and routine prompt gates ([#207](https://github.com/juliendurandeu/jonah-fleet/issues/207)).
 
 ### 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

@@ -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;
 }
 
@@ -3495,6 +3522,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);
@@ -4044,6 +4288,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 +4324,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 +4337,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 +4443,7 @@ Timeout: ${printTimeout}`,
         env: childEnv,
         stdio: ["inherit", "pipe", "pipe"]
       });
+      activeChild = child;
       child.stdout?.on("data", (data) => {
         processChunk(data.toString(), false);
       });
@@ -4204,7 +4480,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,
@@ -5919,3 +6214,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/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,CAQlG,CAAC;AAEF,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,UAAU,kFAAkF,CAAC"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jonah-fleet",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Standalone autonomous agent fleet with Symphony orchestration, claim protocols, and continuous improvement loops",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schema.json

@@ -163,6 +163,32 @@
       },
       "additionalProperties": false,
       "description": "Configuration for label management and protection shields"
+    },
+    "lessons": {
+      "oneOf": [
+        {
+          "type": "boolean",
+          "description": "Enable or disable opt-in LESSONS.md operational memory tier"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable opt-in LESSONS.md operational memory tier"
+            },
+            "maxEntries": {
+              "type": "number",
+              "default": 25,
+              "description": "Maximum number of active operational lesson entries (hard cap: 25)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Configuration for opt-in operational memory tier (LESSONS.md)"
+        }
+      ],
+      "description": "Configuration for opt-in operational memory tier (LESSONS.md)"
     }
   },
   "required": ["version", "preset", "routines", "skills"],

package/templates/docs/LESSONS.template.md

@@ -0,0 +1,7 @@
+# Operational Lessons & Repository Heuristics
+<!-- Invariants: Max 25 entries. Hard cap. Older entries graduate or demote to LESSONS_ARCHIVE.md -->
+
+### [subsystem] Title
+- **Symptom:** <Symptom description or error message>
+- **Root Cause:** <Brief explanation of the underlying cause>
+- **Rule:** <Actionable rule or constraint to follow>

package/templates/prompts/ORCHESTRATION.md

@@ -272,3 +272,29 @@ In headless CLI environments (`agy -p` / GitHub Actions), agent sessions termina
 1. **Zero-Yield Waiting Invariant**: Agents MUST NEVER call `schedule` or emit a terminal turn with plain text to "wait" for background commands, timers, or long-running checks. In headless mode, yielding the turn halts the process immediately with exit code 0 before reaching the Definition of Done.
 2. **Active Task Supervision**: If a verification command (`npm test`, `npm run type-check`) is sent to the background by `run_command`, the agent must actively poll `manage_task(Action='status')` or inspect code while waiting within the continuous tool-calling loop.
 3. **CI Trust Bar & Test Discipline**: Peer review routines should trust green passing remote CI checks (GitHub Actions or Vercel preview deployments) on the PR's head commit rather than initiating slow, background-prone full test runs. Run repository verification locally ONLY if CI status is unconfirmed, missing, or failing.
+
+---
+
+## Structured Human Escalation Card Protocol ("Why I believe this")
+
+How autonomous routines escalate decisions, ambiguities, and blockers to human maintainers without unbounded back-and-forth or vague questions:
+
+1. **Mandatory 4-Part Escalation Schema**: Whenever a routine cannot proceed autonomously due to ambiguity, conflicting requirements, unobservable acceptance criteria, or repeated review ping-pong—and applies `needs-human` or `needs-info`—it MUST post a comment structured as the mandatory 4-part escalation card (inspired by Orbital's Workbench Provenance format):
+   ```markdown
+   ## 🛑 Escalation: Human Decision Required
+   - **Decision Needed**: [1 focused question or choice]
+   - **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+   - **Evaluated Options & Trade-offs**:
+     - *Option A*: [Pros / Cons]
+     - *Option B*: [Pros / Cons]
+   - **Recommended Path**: [Agent recommendation]
+   ```
+2. **Card Invariants**:
+   - **Decision Needed**: Exactly 1 high-leverage question or choice required from the maintainer or reporter. Prohibit question dumps or vague "please provide more details".
+   - **Evidence ("Why I believe this")**: Concrete artifacts, specific file paths, line numbers, test outputs, or contradicting specification documents justifying why the routine cannot proceed without human guidance.
+   - **Evaluated Options & Trade-offs**: At least two distinct, viable options with concrete pros and cons. Never ask maintainers to solve problems from scratch without agent-evaluated trade-offs.
+   - **Recommended Path**: The agent's recommended decision and reasoning, allowing maintainers to unblock execution with a simple confirmation.
+3. **Cross-Routine Enforcement**:
+   - `autowork.md`: Required when tripping the Ambiguity Gate (Step 12), encountering a 2nd-strike permanent blocker (`needs-human`), or hitting the review Ping-Pong Cap (Step 3b).
+   - `triage/SKILL.md`: Required when transitioning issues or PRs to `needs-info` or `ready-for-human`.
+   - `issues-housekeeping.md`: Required when auditing and escalating ambiguous, stale, or infeasible issues with `needs-human` or `needs-info`.

package/templates/prompts/autowork.md

@@ -45,7 +45,7 @@ If any criterion cannot be met, stop immediately and log FAILURE with the reason
 - Do not start implementing an issue before claiming it (both assignment AND claim comment).
 - Do not mark a PR ready while its `mergeable_state` is `dirty` — resolve merge conflicts first.
 - Do not fall into the **Telemetry Rabbit Hole**: do not spend cycles instrumenting elaborate fallback telemetry or defensive error handling for features that suffer from lack of user intent rather than software bugs.
-- Do not guess or invent arbitrary specifications for ambiguous issues — post clarifying questions, label `needs-info`, and release the claim instead of blindly writing code.
+- Do not guess or invent arbitrary specifications for ambiguous issues — post the 4-part escalation card ('Why I believe this'), label `needs-info`, and release the claim instead of blindly writing code.
 - Do not call `schedule` or yield the turn with plain text while waiting for background verification tasks — stay in the tool loop until the Definition of Done is met.
 
 ## Instructions
@@ -90,8 +90,17 @@ a. **Read the target issue and check eligibility.** Eligible = open, unassigned
    - **Build & type-check verification**: run the repository's test, type-check, and lint commands from `AGENTS.md` (e.g. `npm test`, `npm run type-check`, `npm run lint`, `pytest`, `cargo test`). Confirm zero errors and zero test failures.
    - **Active Origin Sync & Clean-Merge Gate**: Run `git fetch origin main && git merge origin/main --no-edit` to absorb any newly merged pull requests and resolve any conflicts locally. Verify `git merge-tree origin/main HEAD` reports no conflicts before marking ready.
    - **Release claim on ready**: mark the PR ready (`gh pr ready <PR>`) and unassign yourself (`gh pr edit <PR> --remove-assignee <login>`) so Peer Review can evaluate without holding stale agent reservation locks.
-     Only mark the PR ready after passing every check above.
-     3b. **Ping-pong cap**: If this same PR has bounced between draft and ready 3 or more times over the same substantive finding, stop re-marking it ready. Post a comment summarizing the disagreement for human resolution and leave the PR in draft.
+      Only mark the PR ready after passing every check above.
+      3b. **Ping-pong cap**: If this same PR has bounced between draft and ready 3 or more times over the same substantive finding, stop re-marking it ready. Post the mandatory 4-part escalation card summarizing the disagreement for human resolution and leave the PR in draft:
+        ```markdown
+        ## 🛑 Escalation: Human Decision Required
+        - **Decision Needed**: [1 focused question or choice]
+        - **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+        - **Evaluated Options & Trade-offs**:
+          - *Option A*: [Pros / Cons]
+          - *Option B*: [Pros / Cons]
+        - **Recommended Path**: [Agent recommendation]
+        ```
      3c. **Orphaned Ready PR Recovery**: If an open PR authored by this routine is `ready_for_review`, has passing CI, no unaddressed review comments, and has received no review activity for over 2 hours (e.g. because peer review crashed or encountered quota limits), kickstart the review routine by posting `/review` comment or toggling draft and ready (`gh pr ready <PR> --undo && gh pr ready <PR>`).
    - **Passing CI Verification Gate**: Verify via `gh pr view <PR> --json statusCheckRollup,mergeStateStatus` that all required and existing checks have completed with `conclusion: "SUCCESS"` and `mergeStateStatus` is `CLEAN` (neither `UNSTABLE`, `BLOCKED`, nor `DIRTY`).
    - **Unapproved/Pending Workflow Invariant**: NEVER post `/review` or toggle draft state if checks are in-progress, failing, or awaiting approval (`conclusion: "ACTION_REQUIRED"`). Doing so creates an infinite comment storm while workflows remain paused awaiting human permissions.
@@ -130,13 +139,23 @@ a. **Read the target issue and check eligibility.** Eligible = open, unassigned
     - Read the issue description, linked code, and comment thread.
     - If bug: use `/diagnosing-bugs` to establish reproduction test before fixing.
     - If large/complex: use `/domain-modeling` and `/codebase-design`.
+    - **Pre-Flight Memory Scan**: If `LESSONS.md` exists, grep matching subsystem tags (`grep -E "^### \[(subsystem)\]" LESSONS.md -A 4`) to incorporate known landmines into implementation plans before writing code.
     - **Ambiguity & Missing Acceptance Criteria Gate**: Challenge underspecified or incomplete requests before writing any code. If the issue lacks observable acceptance criteria, relies on unverified assumptions, or leaves critical technical/UX decisions ambiguous:
       - Do NOT guess or invent arbitrary requirements to force completion.
-      - Post a comment on the issue posing 1–3 focused clarifying questions that identify the exact decisions or trade-offs needed.
+      - Post the mandatory 4-part escalation card on the issue:
+        ```markdown
+        ## 🛑 Escalation: Human Decision Required
+        - **Decision Needed**: [1 focused question or choice]
+        - **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+        - **Evaluated Options & Trade-offs**:
+          - *Option A*: [Pros / Cons]
+          - *Option B*: [Pros / Cons]
+        - **Recommended Path**: [Agent recommendation]
+        ```
       - Apply the `needs-info` label and release the claim (unassign).
       - Select the next candidate (evaluating ambiguous issues counts toward step 12's infeasible-continuation cap).
     - **Intent vs. Defect Guardrail**: When investigating issues related to low conversion, zero-click events, or underperforming features: verify whether the issue is a software defect or a lack of user intent. If data indicates the root cause is **lack of user intent** (e.g. button is rendered above fold and functions correctly when clicked, but user interaction rate is <2%) rather than a software defect, do NOT fall into the **telemetry rabbit hole** (adding elaborate fallback telemetry, downstream error handling, or defensive rendering). Categorize the issue as a **product/UX question** (`needs-design` / `roadmap/*`), comment explaining the lack of user intent, release the claim (unassign), and select the next candidate.
-    - If infeasible: comment explaining blocker, release claim (unassign), and select next candidate (up to 3 infeasible evaluations per run). If permanent blocker on 2nd strike, apply `needs-human` label and tag repo owner.
+    - If infeasible: comment explaining blocker, release claim (unassign), and select next candidate (up to 3 infeasible evaluations per run). If permanent blocker on 2nd strike, post the mandatory 4-part escalation card (`## 🛑 Escalation: Human Decision Required`), apply `needs-human` label, and tag repo owner.
       12a. **Umbrella-issue handoff + batching:** If candidate is an umbrella epic:
     - Read `🧭 Decomposition plan` comment (or create if first run).
     - Pick next slice(s), batching up to 3 same-recipe slices into one child issue + PR.
@@ -153,7 +172,9 @@ a. **Read the target issue and check eligibility.** Eligible = open, unassigned
 13. **Implementation & PR creation:**
     - Branch from freshly fetched `origin/main` with descriptive name (e.g. `feat/...` or `fix/...`).
     - Drive implementation via `/tdd` (red-green-refactor).
+    - **Diagnostic Reflex**: On unexpected test/build failure during TDD, grep symptom text in `LESSONS.md` before making speculative code edits.
     - Run repository tests and verification.
+    - **Pre-PR Lessons Capture Gate**: If solving the issue required overcoming a non-obvious quirk not caught by tests/linters, append a 3-line structured entry on the active PR branch adhering to the 25-entry hard cap. Never write to `LESSONS.md` directly on `main`.
     - **Milestone 2 (Verification & Tests)**: Once implementation passes tests and type checks, emit milestone card if `$ROUTINE_ISSUE_NUMBER` is set:
       ```bash
       gh issue comment "$ROUTINE_ISSUE_NUMBER" --body "### 🧪 Milestone: Verification & Tests

package/templates/prompts/issues-housekeeping.md

@@ -39,7 +39,17 @@ If any criterion cannot be met, stop immediately and log FAILURE with the reason
 3. **Priority review**: Check open P1/P2/P3 issues. Promote critical bugs or unblocked items; demote items that lack immediate priority.
 4. **Duplicate & consolidation check**: Identify duplicate issues; close duplicates with cross-references. Consolidate small, related micro-tasks into batch issues.
 5. **Premise-obsolete & stale check**: If an issue's premise was resolved by already-merged PRs or recent refactors, close as completed with evidence.
-6. **Label audit & safe prune**: Ensure open issues carry standard role labels (`needs-triage`, `ready-for-agent`, `needs-human`, etc.). Use `/triage` if classifying incoming issues. Run `npx --yes jonah-fleet labels prune --yes` (or `jonah-fleet labels prune --yes`) to safely prune strictly unused boilerplate labels (`issues: 0`, `pullRequests: 0`, non-protected taxonomy) without deleting historical or fleet taxonomy labels.
+6. **Label audit & safe prune**: Ensure open issues carry standard role labels (`needs-triage`, `ready-for-agent`, `needs-human`, etc.). Use `/triage` if classifying incoming issues. Whenever applying `needs-human` or `needs-info` to escalate an ambiguous, stale, or infeasible issue, mandate formatting the escalation comment with the 4-part card:
+   ```markdown
+   ## 🛑 Escalation: Human Decision Required
+   - **Decision Needed**: [1 focused question or choice]
+   - **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+   - **Evaluated Options & Trade-offs**:
+     - *Option A*: [Pros / Cons]
+     - *Option B*: [Pros / Cons]
+   - **Recommended Path**: [Agent recommendation]
+   ```
+   Run `npx --yes jonah-fleet labels prune --yes` (or `jonah-fleet labels prune --yes`) to safely prune strictly unused boilerplate labels (`issues: 0`, `pullRequests: 0`, non-protected taxonomy) without deleting historical or fleet taxonomy labels.
 7. **Closed-loop verification check**: For projects running impact or verification loops, audit recently closed roadmap/feature issues against tracking issues to ensure shipped levers do not remain untracked.
 
 ### Phase 3: Summary

package/templates/prompts/optimizer.md

@@ -71,6 +71,8 @@ If any criterion cannot be met, stop immediately and log FAILURE with the reason
    - **Passive Order-Taking Anomaly ("Yes-Man Blindspot")**: The Ambiguity Gate trigger rate across intake runs in `autowork` or `triage` is <5% despite elevated PR review bounces ($\ge 2$) or high iteration usage ($\ge 35$), indicating agents are silently guessing requirements and building flawed implementations rather than interrogating underspecified issues.
    - **Speculative Runaway Waste**: An agent run consumed >50k tokens on an underspecified issue with 0 clarifying questions asked, and subsequently failed, bounced, or required post-merge rework.
 6. **Analyze resolved bugs & review comments**: Examine closed bug issues, merged bug-fix PRs, and review feedback for missing checks in authoring (`autowork.md`) or review (`peer-review.md`).
+7. **Scan & Audit Operational Lessons (`LESSONS.md`)**:
+   - Scan `LESSONS.md` during routine optimization sweeps, graduating stable rules to automated linter/CI checks or archiving stale entries to `LESSONS_ARCHIVE.md`.
 
 ### 2. Formulate preventative improvements
 
@@ -81,6 +83,7 @@ Translate findings into concrete preventative improvements and remediation trigg
 - **Ping-Pong Convergence**: For Review Loop Burn, tighten reviewer trust & noise filtering, enforce clean-merge gates, and apply ping-pong caps to prevent endless bounce cycles.
 - **Loop Discovery Mechanical Audits**: For Feedback Loop Stagnation, tighten discovery sweeps by mandating deterministic per-issue matching tables and itemized reconciliation against upstream closed issues/PRs rather than allowing un-itemized generic summary assertions.
 - **Ambiguity Gate & Benchmark Eval Feeding**: For Passive Order-Taking and Speculative Runaway Waste, tighten Step 12 criteria in `autowork.md` and `triage.md` to mandate clarifying questions, and automatically extract the problem issue into a `BenchmarkIssue` test case to feed the automated ambiguity benchmark eval suite (`tests/evals.test.ts`), ensuring future agent prompts are continuously tested against real failure cases.
+- **Operational Memory Graduation & Archiving**: Scan `LESSONS.md` to identify recurring, stable rules for graduation into automated linter rules or CI workflow checks. Move obsolete or overflow entries (>25 cap) to `LESSONS_ARCHIVE.md`.
 - **Verification & Invariant Tests**: Add automated test cases in `tests/` verifying prompt invariant preservation and schema conformity.
 
 ### 3. Open Fix PR (Local or Upstream Bridge)

package/templates/prompts/peer-review.md

@@ -105,6 +105,7 @@ Check if `$PR_NUMBER` is set:
 1. Run `/code-review` over the diff (or delta commits if re-review) evaluating:
    - **Standards**: Conformance to `AGENTS.md` (or `CLAUDE.md`/`GEMINI.md`), conventions, and architecture.
    - **Spec Compliance**: Verification against the linked issue's deliverables (`## Tasks`), or against the PR description's summary/changes if no tracking issue is linked.
+   - **Operational Memory & Lessons Invariant**: Inspect `LESSONS.md` diffs in PRs to verify the lesson is accurate, non-trivial, follows the 3-line structured schema, and the file adheres to the 25-entry hard cap.
 2. Run Security Pass: auth gates, permission checks, injection risks, sensitive credentials.
 3. **Design System & Viewport Density Pass** (if PR modifies frontend/rendered UI):
    - **Token Purity**: Check for arbitrary CSS/Tailwind sizing overrides (e.g. `text-[...px]`, `w-[...px]`) or bespoke button styling bypassing standard design system tokens.

package/templates/scripts/run-with-loop-guard.js

@@ -0,0 +1,439 @@
+#!/usr/bin/env node
+
+/**
+ * Deterministic Execution Wrapper Script for Antigravity CLI (agy)
+ *
+ * Intercepts runner stdout/stderr in real-time to enforce:
+ * - Repetition Guard: Kills process on 5 identical action hashes within sliding window
+ * - Ping-Pong Guard: Kills process on 3 consecutive alternating action pairs (A-B-A-B-A-B)
+ * - Tool Circuit Breaker: Kills process on 2 consecutive identical tool call errors
+ *
+ * On trip, emits a structured failure card with category `loop_circuit_breaker`
+ * and writes `.jonah-fleet/run-report.md` before exiting with non-zero status.
+ */
+
+import { spawn, execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+
+export function canonicalStringify(value) {
+  if (value === null || value === undefined) {
+    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(',') + '}';
+}
+
+export function computeActionHash(toolName, args) {
+  const canonicalArgs = canonicalStringify(args);
+  return crypto.createHash('sha256').update(`${toolName}:${canonicalArgs}`).digest('hex');
+}
+
+export class LoopGuard {
+  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;
+
+    this.history = [];
+    this.lastErrorHash = null;
+    this.consecutiveErrorCount = 0;
+    this.trippedResult = null;
+  }
+
+  isTripped() {
+    return this.trippedResult !== null;
+  }
+
+  getTrip() {
+    return this.trippedResult;
+  }
+
+  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(),
+    };
+
+    // 1. Tool Circuit Breaker Guard
+    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);
+
+    // 2. Repetition Guard within sliding window
+    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,
+      });
+    }
+
+    // 3. Ping-Pong Guard: 3 consecutive alternating pairs (length 6)
+    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;
+  }
+
+  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;
+  }
+}
+
+export 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 = [
+    `### ❌ 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');
+}
+
+export 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');
+}
+
+class LineParser {
+  constructor(onLine) {
+    this.buffer = '';
+    this.onLine = onLine;
+  }
+
+  feed(chunk) {
+    this.buffer += chunk;
+    const lines = this.buffer.split('\n');
+    this.buffer = lines.pop() ?? '';
+    for (const line of lines) {
+      if (line.trim().length > 0) {
+        this.onLine(line);
+      }
+    }
+  }
+
+  flush() {
+    if (this.buffer.trim().length > 0) {
+      this.onLine(this.buffer);
+      this.buffer = '';
+    }
+  }
+}
+
+/**
+ * Main execution logic when invoked as CLI script.
+ */
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  const commandArgs = rawArgs[0] === 'agy' ? rawArgs.slice(1) : rawArgs;
+
+  // Detect routine name from environment or prompt
+  const routine = process.env.ROUTINE || 'autowork';
+  const routineIssueNumber = process.env.ROUTINE_ISSUE_NUMBER;
+  const cwd = process.cwd();
+
+  // Ensure --output-format stream-json is configured so tool calls can be inspected
+  const finalArgs = [];
+  let hasOutputFormat = false;
+  let requestedTextFormat = false;
+
+  for (let i = 0; i < commandArgs.length; i++) {
+    const arg = commandArgs[i];
+    if (arg === '--output-format') {
+      hasOutputFormat = true;
+      const nextArg = commandArgs[i + 1];
+      if (nextArg === 'text') {
+        requestedTextFormat = true;
+      }
+      finalArgs.push('--output-format', 'stream-json');
+      i++;
+    } else {
+      finalArgs.push(arg);
+    }
+  }
+
+  if (!hasOutputFormat) {
+    finalArgs.push('--output-format', 'stream-json');
+  }
+
+  let childProcess = null;
+  let tripped = null;
+
+  const guard = new LoopGuard({
+    repetitionThreshold: 5,
+    pingPongThreshold: 3,
+    consecutiveErrorThreshold: 2,
+    slidingWindowSize: 20,
+    onTrip: (trip) => {
+      tripped = trip;
+      console.error(`\n🚨 ::error::[LoopGuard] ${trip.message}`);
+
+      if (childProcess && !childProcess.killed) {
+        console.error(`🛑 Terminating runner process with SIGTERM...`);
+        childProcess.kill('SIGTERM');
+
+        const killTimer = setTimeout(() => {
+          if (childProcess && !childProcess.killed) {
+            console.error(`🛑 Runner did not terminate; sending SIGKILL...`);
+            try {
+              childProcess.kill('SIGKILL');
+            } catch {}
+          }
+        }, 3000);
+        killTimer.unref();
+      }
+    },
+  });
+
+  const stdoutParser = new LineParser((line) => {
+    guard.feedLine(line);
+
+    try {
+      const parsed = JSON.parse(line.trim());
+      if (parsed && typeof parsed === 'object') {
+        if (parsed.event === 'step_update' && parsed.step_update) {
+          const su = parsed.step_update;
+          if (su.step_type === 'agent_response' || su.step_type === 'thought') {
+            if (su.text_delta) {
+              process.stdout.write(su.text_delta);
+            }
+          } else if (su.step_type === 'tool') {
+            const name = su.tool_name || su.tool_info?.name || 'tool';
+            if (su.state === 'ACTIVE') {
+              console.log(`\n[tool:start] ${name}`);
+            } else if (su.state === 'DONE') {
+              console.log(`[tool:done] ${name}`);
+            } else if (su.state === 'ERROR') {
+              console.log(`[tool:error] ${name}`);
+            }
+          }
+        } else if (parsed.event === 'result' && parsed.result?.response) {
+          console.log(`\n${parsed.result.response}\n`);
+        }
+        return;
+      }
+    } catch {}
+
+    // Non-JSON line from stdout: print directly
+    console.log(line);
+  });
+
+  const stderrParser = new LineParser((line) => {
+    guard.feedLine(line);
+    console.error(line);
+  });
+
+  const runnerBinEnv = process.env.RUNNER_BIN || 'agy';
+  const [command, ...prefixArgs] = runnerBinEnv.split(' ');
+  const execArgs = [...prefixArgs, ...finalArgs];
+
+  const exitCode = await new Promise((resolve) => {
+    childProcess = spawn(command, execArgs, {
+      cwd,
+      env: process.env,
+      stdio: ['inherit', 'pipe', 'pipe'],
+    });
+
+    childProcess.stdout?.on('data', (chunk) => stdoutParser.feed(chunk.toString()));
+    childProcess.stderr?.on('data', (chunk) => stderrParser.feed(chunk.toString()));
+
+    childProcess.on('close', (code, signal) => {
+      stdoutParser.flush();
+      stderrParser.flush();
+      resolve(code ?? (signal ? 1 : 0));
+    });
+
+    childProcess.on('error', (err) => {
+      console.error(`Failed to launch '${command}':`, err.message);
+      resolve(1);
+    });
+  });
+
+  if (tripped) {
+    const timestamp = new Date().toISOString();
+    const logDir = path.join(cwd, '.jonah-fleet');
+    fs.mkdirSync(logDir, { recursive: true });
+    const reportPath = path.join(logDir, 'run-report.md');
+
+    const reportContent = formatLoopGuardReport({
+      routine,
+      timestamp,
+      trip: tripped,
+    });
+    fs.writeFileSync(reportPath, reportContent, 'utf8');
+
+    if (routineIssueNumber) {
+      try {
+        const failureCard = formatLoopGuardFailureCard({
+          routine,
+          trip: tripped,
+          runId: process.env.GITHUB_RUN_ID,
+          serverUrl: process.env.GITHUB_SERVER_URL,
+          repository: process.env.GITHUB_REPOSITORY,
+        });
+        const tmpFile = path.join(os.tmpdir(), `loop-guard-card-${Date.now()}.md`);
+        fs.writeFileSync(tmpFile, failureCard, 'utf8');
+        try {
+          execSync(`gh issue comment ${routineIssueNumber} --body-file ${JSON.stringify(tmpFile)}`, {
+            cwd,
+            stdio: 'ignore',
+          });
+        } finally {
+          if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile);
+        }
+      } catch (err) {
+        console.error('Failed to post failure card to tracking issue:', err.message);
+      }
+    }
+
+    process.exit(1);
+  }
+
+  process.exit(exitCode);
+}
+
+if (process.argv[1] && process.argv[1].endsWith('run-with-loop-guard.js')) {
+  main().catch((err) => {
+    console.error('Fatal wrapper error:', err);
+    process.exit(1);
+  });
+}

package/templates/skills/triage/SKILL.md

@@ -77,8 +77,17 @@ Show counts and a one-line summary per item. Let the maintainer pick.
 
 5. **Apply the outcome:**
    - `ready-for-agent`: post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
-   - `ready-for-human`: same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
-   - `needs-info`: post triage notes (template below).
+   - `ready-for-human`: same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing) and format the maintainer escalation using the mandatory 4-part escalation card:
+     ```markdown
+     ## 🛑 Escalation: Human Decision Required
+     - **Decision Needed**: [1 focused question or choice]
+     - **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+     - **Evaluated Options & Trade-offs**:
+       - *Option A*: [Pros / Cons]
+       - *Option B*: [Pros / Cons]
+     - **Recommended Path**: [Agent recommendation]
+     ```
+   - `needs-info`: post triage notes formatted with the mandatory 4-part escalation card (template below).
    - For `wontfix`, close the issue, with the comment depending on *why*:
      - **Already implemented**: the change already exists in the codebase. Point to where it lives; do **not** write to `.out-of-scope/` (that KB is for *rejected* requests, not built ones).
      - **Rejected (bug)**: give a polite explanation, then close.
@@ -92,20 +101,16 @@ If the maintainer says "move #42 to ready-for-agent", trust them and apply the r
 ## Needs-info template
 
 ```markdown
-## Triage Notes
-
-**What we've established so far:**
-
-- point 1
-- point 2
-
-**What we still need from you (@reporter):**
-
-- question 1
-- question 2
+## 🛑 Escalation: Human Decision Required
+- **Decision Needed**: [1 focused question or choice]
+- **Evidence ("Why I believe this")**: [Specific files, lines, test outputs, or conflicting docs]
+- **Evaluated Options & Trade-offs**:
+  - *Option A*: [Pros / Cons]
+  - *Option B*: [Pros / Cons]
+- **Recommended Path**: [Agent recommendation]
 ```
 
-Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+Capture everything resolved during grilling under the evidence and options sections so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
 
 ## Resuming a previous session