jonah-fleet 1.24.0 → 1.25.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.25.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.24.0...v1.25.0) (2026-09-23)
+
+
+### Features
+
+* **guard:** enrich LoopGuard diagnostics with action details and provision MCP in review workflows ([#367](https://github.com/juliendurandeu/jonah-fleet/issues/367)) ([a93d783](https://github.com/juliendurandeu/jonah-fleet/commit/a93d7833fd3caf6b5a4f8e50ccfeaa2d1e146c36))
+
+## [Unreleased]
+
+### Features
+
+* **guard:** capture action arguments on LoopGuard circuit breaker trips, enrich failure cards and reports with formatted action details, and surface active tool commands in runner stdout.
+* **workflows:** provision MCP servers for Antigravity CLI in `analytics-review-cron.yml` and `design-review-cron.yml`.
+
 ## [1.24.0](https://github.com/juliendurandeu/jonah-fleet/compare/v1.23.1...v1.24.0) (2026-09-23)
 
 

package/dist/index.js

@@ -3623,7 +3623,8 @@ var LoopGuard = class {
           message: `Tool circuit breaker tripped: ${this.consecutiveErrorCount} consecutive identical tool errors for '${toolName}' with unchanged arguments.`,
           toolName,
           actionHash: hash,
-          count: this.consecutiveErrorCount
+          count: this.consecutiveErrorCount,
+          args
         });
       }
     } else {
@@ -3646,7 +3647,8 @@ var LoopGuard = class {
           message: `Action repetition loop detected: tool '${toolName}' called ${repetitionCount} times with identical parameters within sliding window of ${this.slidingWindowSize}.`,
           toolName,
           actionHash: hash,
-          count: repetitionCount
+          count: repetitionCount,
+          args
         });
       }
     }
@@ -3674,7 +3676,8 @@ var LoopGuard = class {
               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
+              count: this.pingPongThreshold,
+              args
             });
           }
         }
@@ -3717,6 +3720,18 @@ var LoopGuard = class {
     return trip;
   }
 };
+function formatActionSummary(toolName, args) {
+  if (!args) return toolName;
+  if (typeof args === "string") return `${toolName}: ${args}`;
+  if (args.CommandLine) return `${toolName}: ${args.CommandLine}`;
+  if (args.command) return `${toolName}: ${args.command}`;
+  if (args.TargetFile) return `${toolName}: ${args.TargetFile}`;
+  if (args.path) return `${toolName}: ${args.path}`;
+  if (args.AbsolutePath) return `${toolName}: ${args.AbsolutePath}`;
+  if (args.Query) return `${toolName}: ${args.Query}`;
+  const str = canonicalStringify(args);
+  return str.length > 200 ? `${toolName}: ${str.slice(0, 197)}...` : `${toolName}: ${str}`;
+}
 function formatLoopGuardFailureCard(options) {
   const serverUrl = options.serverUrl || process.env.GITHUB_SERVER_URL || "https://github.com";
   const repository = options.repository || process.env.GITHUB_REPOSITORY || "";
@@ -3728,16 +3743,19 @@ function formatLoopGuardFailureCard(options) {
     `- **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`
+    `- **Reason**: ${options.trip.message}`
   ];
+  if (options.trip.args !== void 0) {
+    lines.push(`- **Triggered Action**: \`${formatActionSummary(options.trip.toolName, options.trip.args)}\``);
+  }
+  lines.push(`- **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 [
+  const reportLines = [
     `# Run Report`,
     ``,
     `## Result`,
@@ -3758,10 +3776,16 @@ function formatLoopGuardReport(options) {
     `The autonomous execution was halted by the deterministic loop-guard wrapper.`,
     `- **Category**: \`loop_circuit_breaker\``,
     `- **Trigger**: \`${options.trip.reason}\``,
-    `- **Tool**: \`${options.trip.toolName}\``,
+    `- **Tool**: \`${options.trip.toolName}\``
+  ];
+  if (options.trip.args !== void 0) {
+    reportLines.push(`- **Parameters**: \`${formatActionSummary(options.trip.toolName, options.trip.args)}\``);
+  }
+  reportLines.push(
     `- **Action Hash**: \`${options.trip.actionHash}\``,
     `- **Message**: ${options.trip.message}`
-  ].join("\n");
+  );
+  return reportLines.join("\n");
 }
 
 // src/lib/runner.ts
@@ -6297,6 +6321,7 @@ export {
   LoopGuard,
   canonicalStringify,
   computeActionHash,
+  formatActionSummary,
   formatLoopGuardFailureCard,
   formatLoopGuardReport
 };

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

@@ -5,6 +5,7 @@ export interface LoopGuardTrip {
     toolName: string;
     actionHash: string;
     count: number;
+    args?: any;
 }
 export interface ActionRecord {
     toolName: string;
@@ -57,6 +58,10 @@ export declare class LoopGuard {
     feedLine(line: string): LoopGuardTrip | null;
     private triggerTrip;
 }
+/**
+ * Formats a concise, human-readable summary of a tool action and its parameters.
+ */
+export declare function formatActionSummary(toolName: string, args: any): string;
 export interface LoopGuardFailureCardOptions {
     routine: string;
     trip: LoopGuardTrip;

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

@@ -1 +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,CAuH/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"}
+{"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;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;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,CA0H/F;IAED;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwBlD;IAED,OAAO,CAAC,WAAW;CAWpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAWvE;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,CA0BvF;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,CAmC7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jonah-fleet",
-  "version": "1.24.0",
+  "version": "1.25.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/templates/scripts/run-with-loop-guard.js

@@ -98,6 +98,7 @@ export class LoopGuard {
           toolName,
           actionHash: hash,
           count: this.consecutiveErrorCount,
+          args,
         });
       }
     } else {
@@ -126,6 +127,7 @@ export class LoopGuard {
           toolName,
           actionHash: hash,
           count: repetitionCount,
+          args,
         });
       }
     }
@@ -167,6 +169,7 @@ export class LoopGuard {
               toolName,
               actionHash: hash,
               count: this.pingPongThreshold,
+              args,
             });
           }
         }
@@ -209,6 +212,22 @@ export class LoopGuard {
   }
 }
 
+/**
+ * Formats a concise, human-readable summary of a tool action and its parameters.
+ */
+export function formatActionSummary(toolName, args) {
+  if (!args) return toolName;
+  if (typeof args === 'string') return `${toolName}: ${args}`;
+  if (args.CommandLine) return `${toolName}: ${args.CommandLine}`;
+  if (args.command) return `${toolName}: ${args.command}`;
+  if (args.TargetFile) return `${toolName}: ${args.TargetFile}`;
+  if (args.path) return `${toolName}: ${args.path}`;
+  if (args.AbsolutePath) return `${toolName}: ${args.AbsolutePath}`;
+  if (args.Query) return `${toolName}: ${args.Query}`;
+  const str = canonicalStringify(args);
+  return str.length > 200 ? `${toolName}: ${str.slice(0, 197)}...` : `${toolName}: ${str}`;
+}
+
 export function formatLoopGuardFailureCard(options) {
   const serverUrl = options.serverUrl || process.env.GITHUB_SERVER_URL || 'https://github.com';
   const repository = options.repository || process.env.GITHUB_REPOSITORY || '';
@@ -222,9 +241,14 @@ export function formatLoopGuardFailureCard(options) {
     `- **Root Cause Category**: \`loop_circuit_breaker\``,
     `- **Trigger**: \`${options.trip.reason}\``,
     `- **Reason**: ${options.trip.message}`,
-    `- **Action**: Process terminated to prevent runaway token burn`,
   ];
 
+  if (options.trip.args !== undefined) {
+    lines.push(`- **Triggered Action**: \`${formatActionSummary(options.trip.toolName, options.trip.args)}\``);
+  }
+
+  lines.push(`- **Action**: Process terminated to prevent runaway token burn`);
+
   if (logUrl) {
     lines.push(`- **Action Log**: [View Run Logs](${logUrl})`);
   }
@@ -233,7 +257,7 @@ export function formatLoopGuardFailureCard(options) {
 }
 
 export function formatLoopGuardReport(options) {
-  return [
+  const reportLines = [
     `# Run Report`,
     ``,
     `## Result`,
@@ -255,9 +279,18 @@ export function formatLoopGuardReport(options) {
     `- **Category**: \`loop_circuit_breaker\``,
     `- **Trigger**: \`${options.trip.reason}\``,
     `- **Tool**: \`${options.trip.toolName}\``,
+  ];
+
+  if (options.trip.args !== undefined) {
+    reportLines.push(`- **Parameters**: \`${formatActionSummary(options.trip.toolName, options.trip.args)}\``);
+  }
+
+  reportLines.push(
     `- **Action Hash**: \`${options.trip.actionHash}\``,
     `- **Message**: ${options.trip.message}`,
-  ].join('\n');
+  );
+
+  return reportLines.join('\n');
 }
 
 class LineParser {
@@ -332,6 +365,9 @@ async function main() {
     onTrip: (trip) => {
       tripped = trip;
       console.error(`\n🚨 ::error::[LoopGuard] ${trip.message}`);
+      if (trip.args) {
+        console.error(`🚨 Action Details: ${formatActionSummary(trip.toolName, trip.args)}`);
+      }
 
       if (childProcess && !childProcess.killed) {
         console.error(`🛑 Terminating runner process with SIGTERM...`);
@@ -364,12 +400,14 @@ async function main() {
             }
           } else if (su.step_type === 'tool') {
             const name = su.tool_name || su.tool_info?.name || 'tool';
+            const params = su.tool_info?.parameters;
+            const summary = formatActionSummary(name, params);
             if (su.state === 'ACTIVE') {
-              console.log(`\n[tool:start] ${name}`);
+              console.log(`\n[tool:start] ${summary}`);
             } else if (su.state === 'DONE') {
-              console.log(`[tool:done] ${name}`);
+              console.log(`[tool:done] ${summary}`);
             } else if (su.state === 'ERROR') {
-              console.log(`[tool:error] ${name}`);
+              console.log(`[tool:error] ${summary}`);
             }
           }
         } else if (parsed.event === 'result' && parsed.result?.response) {

package/templates/workflows/analytics-review-cron.yml

@@ -82,6 +82,21 @@ jobs:
           fi
           echo "✓ Preflight credential validation passed."
 
+      - name: Configure MCP servers for Antigravity CLI
+        env:
+          POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+        run: |
+          if [ -n "$POSTHOG_API_KEY" ]; then
+            echo "Configuring PostHog MCP server..."
+            agy mcp add --header "Authorization: Bearer $POSTHOG_API_KEY" posthog https://mcp.posthog.com/mcp || true
+          fi
+          if [ -n "$VERCEL_TOKEN" ]; then
+            echo "Configuring Vercel MCP server..."
+            agy mcp add --header "Authorization: Bearer $VERCEL_TOKEN" vercel https://mcp.vercel.com || true
+          fi
+          agy mcp list || true
+
       - name: Discover and compile domain skills (SwarmClaw Pattern #4)
         id: skills
         run: |

package/templates/workflows/design-review-cron.yml

@@ -89,6 +89,16 @@ jobs:
           fi
           echo "✓ Preflight credential validation passed."
 
+      - name: Configure MCP servers for Antigravity CLI
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+        run: |
+          if [ -n "$VERCEL_TOKEN" ]; then
+            echo "Configuring Vercel MCP server..."
+            agy mcp add --header "Authorization: Bearer $VERCEL_TOKEN" vercel https://mcp.vercel.com || true
+          fi
+          agy mcp list || true
+
       - name: Discover and compile domain skills (SwarmClaw Pattern #4)
         id: skills
         run: |
@@ -129,7 +139,6 @@ jobs:
           ROUTINE: design-review
           ROUTINE_ISSUE_NUMBER: ${{ steps.run-issue.outputs.issue_number }}
           VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
-          POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}
           TARGET_SURFACE: ${{ inputs.target_surface }}
           SKILLS_PROMPT: ${{ steps.skills.outputs.skills_prompt }}
           GITHUB_SERVER_URL: ${{ github.server_url }}