@wrongstack/plugins 1.0.13 → 1.0.15

package/dist/index.js

@@ -33,7 +33,7 @@ var state = {
   hookUnregister: null
 };
 var DEFAULTS = {
-  enabled: false,
+  enabled: true,
   includeExtensions: [".tsx", ".jsx", ".html", ".vue"],
   maxFindings: 50,
   severity: "warn",
@@ -1522,6 +1522,10 @@ var plugin4 = {
       },
       permission: "auto",
       mutating: true,
+      // It rewrites project source files, so it declares the same capability
+      // as the built-in writers: the agent-state write gate and capability
+      // allowlists key on `fs.write`, not on `mutating`.
+      capabilities: ["fs.write"],
       category: "Project",
       async execute(input) {
         const inp = input;
@@ -1773,7 +1777,7 @@ var state6 = {
   lastResult: null
 };
 var DEFAULTS5 = {
-  enabled: false,
+  enabled: true,
   fileExtensions: [".tsx", ".jsx", ".vue"],
   minLength: 2,
   maxContextStrings: 10,
@@ -3317,7 +3321,7 @@ var state10 = {
   hookUnregister: null
 };
 var DEFAULTS9 = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx", ".js", ".jsx"],
   maxFiles: 50
 };
@@ -5088,6 +5092,7 @@ var cost_tracker_default = plugin14;
 import { ToolValidationError as ToolValidationError8 } from "@wrongstack/core/types";
 var COORDINATION_CRON_CAPABILITY = "coordination.cron";
 var API_VERSION9 = "^0.1.10";
+var MAX_TIMER_DELAY_MS = 2147483647;
 var state14 = {
   jobs: /* @__PURE__ */ new Map(),
   timers: /* @__PURE__ */ new Map(),
@@ -5233,7 +5238,9 @@ var plugin15 = {
           name: { type: "string", description: "Unique name for this cron job" },
           intervalMs: {
             type: "number",
-            description: "Interval between runs in milliseconds (minimum 1000)"
+            minimum: 1e3,
+            maximum: MAX_TIMER_DELAY_MS,
+            description: `Interval between runs in milliseconds (1000 to ${MAX_TIMER_DELAY_MS})`
           },
           action: {
             type: "string",
@@ -5265,6 +5272,12 @@ var plugin15 = {
             field: "intervalMs"
           });
         }
+        if (intervalMs > MAX_TIMER_DELAY_MS) {
+          throw new ToolValidationError8({
+            message: `intervalMs must be <= ${MAX_TIMER_DELAY_MS} (about 24.8 days)`,
+            field: "intervalMs"
+          });
+        }
         if (typeof action !== "string" || action.trim() === "") {
           throw new ToolValidationError8({
             message: "action is required and must be a non-empty string",
@@ -5390,7 +5403,7 @@ var state15 = {
   hookUnregister: null
 };
 var DEFAULTS13 = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx", ".js", ".jsx"],
   defaultDepth: 3,
   maxDepth: 10,
@@ -5546,7 +5559,7 @@ var plugin16 = {
     properties: {
       enabled: {
         type: "boolean",
-        default: false,
+        default: true,
         description: "Master switch."
       },
       extensions: {
@@ -7103,7 +7116,7 @@ var hookIndexBudgets = {
   maxFileBytes: 2 * 1024 * 1024
 };
 var DEFAULTS18 = {
-  enabled: false,
+  enabled: true,
   minLines: 8,
   threshold: 0.8,
   extensions: [".ts", ".tsx", ".js", ".jsx"],
@@ -7319,7 +7332,7 @@ var plugin21 = {
   configSchema: {
     type: "object",
     properties: {
-      enabled: { type: "boolean", default: false, description: "Master switch." },
+      enabled: { type: "boolean", default: true, description: "Master switch." },
       minLines: {
         type: "number",
         minimum: 2,
@@ -7915,7 +7928,7 @@ var DEFAULT_PATTERNS2 = [
   String.raw`flags(?:\.|\?\.)([A-Za-z_$][A-Za-z0-9_$]*)`
 ];
 var DEFAULTS20 = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx", ".js", ".jsx"],
   patterns: [],
   maxFindings: 50
@@ -9430,8 +9443,9 @@ var plugin26 = {
             try {
               commitScope = await stageFiles(files);
             } catch (err) {
+              const detail = err instanceof Error ? err.message : String(err);
               throw new Error(
-                `Failed to stage files: ${err instanceof Error ? err.message : String(err)}`,
+                detail.startsWith("Failed to stage files") ? detail : `Failed to stage files: ${detail}`,
                 { cause: err }
               );
             }
@@ -10747,7 +10761,7 @@ var state27 = {
   hookUnregister: null
 };
 var DEFAULTS25 = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx"],
   maxFindings: 50,
   maxFiles: 2e3
@@ -12465,29 +12479,70 @@ var llm_cache_default = plugin34;
 // src/loop-breaker/index.ts
 import { execFile as execFile8 } from "node:child_process";
 import { isAbsolute as isAbsolute15, relative as relative15 } from "node:path";
-var state32 = {
-  lastFingerprint: null,
-  streak: 0,
-  recent: [],
-  pendingBlockReason: null,
-  lastDiffFingerprint: null,
-  noDiffStreak: 0,
-  lastErrorFingerprint: null,
-  repeatedErrorStreak: 0,
-  invocations: 0,
-  postInvocations: 0,
-  warnings: 0,
-  blocks: 0,
-  oscillationsDetected: 0,
-  stepBudgetBlocks: 0,
-  noDiffWarnings: 0,
-  noDiffBlocks: 0,
-  repeatedErrorWarnings: 0,
-  repeatedErrorBlocks: 0,
-  hookUnregister: null
-};
+var FALLBACK_SESSION = "__default__";
+var MAX_TRACKED_RUNS = 32;
+function createRunState() {
+  return {
+    lastFingerprint: null,
+    streak: 0,
+    recent: [],
+    pendingBlockReason: null,
+    lastDiffFingerprint: null,
+    noDiffStreak: 0,
+    lastErrorFingerprint: null,
+    repeatedErrorStreak: 0,
+    invocations: 0,
+    postInvocations: 0,
+    warnings: 0,
+    blocks: 0,
+    oscillationsDetected: 0,
+    stepBudgetBlocks: 0,
+    noDiffWarnings: 0,
+    noDiffBlocks: 0,
+    repeatedErrorWarnings: 0,
+    repeatedErrorBlocks: 0
+  };
+}
+var state32 = { runs: /* @__PURE__ */ new Map(), hookUnregister: null };
+function sessionKey(sessionId) {
+  return sessionId || FALLBACK_SESSION;
+}
+function storeRun(key, current) {
+  state32.runs.set(key, current);
+  if (state32.runs.size <= MAX_TRACKED_RUNS) return;
+  const oldest = state32.runs.keys().next().value;
+  if (oldest !== void 0 && oldest !== key) state32.runs.delete(oldest);
+}
+function runState(sessionId) {
+  const key = sessionKey(sessionId);
+  let current = state32.runs.get(key);
+  if (!current) {
+    current = createRunState();
+    storeRun(key, current);
+  }
+  return current;
+}
+function resetRun(sessionId) {
+  storeRun(sessionKey(sessionId), createRunState());
+}
+function aggregateRuns() {
+  const total = createRunState();
+  for (const current of state32.runs.values()) {
+    total.invocations += current.invocations;
+    total.postInvocations += current.postInvocations;
+    total.warnings += current.warnings;
+    total.blocks += current.blocks;
+    total.oscillationsDetected += current.oscillationsDetected;
+    total.stepBudgetBlocks += current.stepBudgetBlocks;
+    total.noDiffWarnings += current.noDiffWarnings;
+    total.noDiffBlocks += current.noDiffBlocks;
+    total.repeatedErrorWarnings += current.repeatedErrorWarnings;
+    total.repeatedErrorBlocks += current.repeatedErrorBlocks;
+  }
+  return total;
+}
 var DEFAULTS30 = {
-  enabled: true,
+  enabled: false,
   // Documented contract (feature matrix, plugin description): warn, then
   // block. A warn-only default meant an agent stuck re-issuing the same call
   // was never actually stopped unless the user happened to set any option.
@@ -12495,7 +12550,7 @@ var DEFAULTS30 = {
   warnAfter: 3,
   blockAfter: 5,
   oscillationWindow: 8,
-  maxSteps: 200,
+  maxSteps: 0,
   noDiffWarnAfter: 6,
   noDiffBlockAfter: 10,
   repeatedErrorWarnAfter: 2,
@@ -12521,7 +12576,7 @@ function readConfig30(raw) {
   const rawOsc = r["oscillationWindow"] ?? r["oscillation_window"] ?? r["window"];
   const rawMaxSteps = r["maxSteps"] ?? r["max_steps"] ?? r["stepLimit"] ?? r["step_limit"];
   return {
-    enabled: r["enabled"] !== false,
+    enabled: r["enabled"] === true,
     mode,
     warnAfter,
     blockAfter,
@@ -12634,7 +12689,11 @@ var plugin35 = {
   configSchema: {
     type: "object",
     properties: {
-      enabled: { type: "boolean", default: true, description: "Master switch." },
+      enabled: {
+        type: "boolean",
+        default: false,
+        description: "Opt-in master switch; disabled unless explicitly enabled."
+      },
       mode: {
         type: "string",
         enum: ["warn", "block"],
@@ -12662,8 +12721,8 @@ var plugin35 = {
       maxSteps: {
         type: "number",
         minimum: 0,
-        default: 200,
-        description: "Maximum tool steps before blocking; 0 disables the step budget."
+        default: 0,
+        description: "Optional maximum tool steps before blocking; 0 keeps runs unlimited."
       },
       noDiffWarnAfter: {
         type: "number",
@@ -12698,24 +12757,7 @@ var plugin35 = {
     }
   },
   setup(api) {
-    state32.lastFingerprint = null;
-    state32.streak = 0;
-    state32.recent = [];
-    state32.pendingBlockReason = null;
-    state32.lastDiffFingerprint = null;
-    state32.noDiffStreak = 0;
-    state32.lastErrorFingerprint = null;
-    state32.repeatedErrorStreak = 0;
-    state32.invocations = 0;
-    state32.postInvocations = 0;
-    state32.warnings = 0;
-    state32.blocks = 0;
-    state32.oscillationsDetected = 0;
-    state32.stepBudgetBlocks = 0;
-    state32.noDiffWarnings = 0;
-    state32.noDiffBlocks = 0;
-    state32.repeatedErrorWarnings = 0;
-    state32.repeatedErrorBlocks = 0;
+    state32.runs.clear();
     if (state32.hookUnregister) {
       try {
         state32.hookUnregister();
@@ -12728,56 +12770,57 @@ var plugin35 = {
       if (!cfg.enabled) return;
       const toolName = input.toolName ?? "unknown";
       if (ignoreToolsSet.has(toolName)) return;
-      state32.invocations += 1;
-      if (state32.pendingBlockReason && cfg.mode === "block") {
-        const reason = state32.pendingBlockReason;
-        state32.pendingBlockReason = null;
-        state32.blocks += 1;
+      const current = runState(input.sessionId);
+      if (current.pendingBlockReason && cfg.mode === "block") {
+        const reason = current.pendingBlockReason;
+        current.pendingBlockReason = null;
+        current.blocks += 1;
         api.metrics.counter("blocks");
         return { decision: "block", reason };
       }
-      if (cfg.maxSteps > 0 && state32.invocations > cfg.maxSteps && cfg.mode === "block") {
-        state32.blocks += 1;
-        state32.stepBudgetBlocks += 1;
+      if (cfg.maxSteps > 0 && current.invocations >= cfg.maxSteps && cfg.mode === "block") {
+        current.blocks += 1;
+        current.stepBudgetBlocks += 1;
         api.metrics.counter("blocks");
         api.metrics.counter("step_budget_blocks");
         return {
           decision: "block",
-          reason: `loop-breaker: step budget exceeded (${state32.invocations}/${cfg.maxSteps} tool calls). Stop and report what has been tried instead of continuing an unbounded loop.`
+          reason: `loop-breaker: step budget exceeded (${current.invocations}/${cfg.maxSteps} tool calls). Stop and report what has been tried instead of continuing an unbounded loop.`
         };
       }
+      current.invocations += 1;
       const fp = fingerprint(toolName, input.toolInput);
-      if (fp === state32.lastFingerprint) {
-        state32.streak += 1;
+      if (fp === current.lastFingerprint) {
+        current.streak += 1;
       } else {
-        state32.lastFingerprint = fp;
-        state32.streak = 1;
+        current.lastFingerprint = fp;
+        current.streak = 1;
       }
-      state32.recent.push(fp);
-      if (state32.recent.length > Math.max(cfg.oscillationWindow, 16)) {
-        state32.recent.splice(0, state32.recent.length - Math.max(cfg.oscillationWindow, 16));
+      current.recent.push(fp);
+      if (current.recent.length > Math.max(cfg.oscillationWindow, 16)) {
+        current.recent.splice(0, current.recent.length - Math.max(cfg.oscillationWindow, 16));
       }
-      if (state32.streak >= cfg.blockAfter && cfg.mode === "block") {
-        state32.blocks += 1;
+      if (current.streak >= cfg.blockAfter && cfg.mode === "block") {
+        current.blocks += 1;
         api.metrics.counter("blocks");
         return {
           decision: "block",
-          reason: `loop-breaker: "${toolName}" has been called ${state32.streak} times in a row with identical input. This looks like a runaway loop. Change the input, try a different tool, or explain to the user why repetition is needed. (Disable this guard via config.extensions["loop-breaker"].enabled = false.)`
+          reason: `loop-breaker: "${toolName}" has been called ${current.streak} times in a row with identical input. This looks like a runaway loop. Change the input, try a different tool, or explain to the user why repetition is needed. (Disable this guard via config.extensions["loop-breaker"].enabled = false.)`
         };
       }
-      if (state32.streak >= cfg.warnAfter) {
-        state32.warnings += 1;
+      if (current.streak >= cfg.warnAfter) {
+        current.warnings += 1;
         api.metrics.counter("warnings");
-        const remaining = cfg.mode === "block" ? cfg.blockAfter - state32.streak : null;
+        const remaining = cfg.mode === "block" ? cfg.blockAfter - current.streak : null;
         return {
           decision: "allow",
-          additionalContext: `loop-breaker: "${toolName}" repeated ${state32.streak}x with identical input.` + (remaining !== null && remaining > 0 ? ` It will be BLOCKED after ${remaining} more identical call(s).` : "") + " If the previous result was not what you needed, change the approach instead of retrying."
+          additionalContext: `loop-breaker: "${toolName}" repeated ${current.streak}x with identical input.` + (remaining !== null && remaining > 0 ? ` It will be BLOCKED after ${remaining} more identical call(s).` : "") + " If the previous result was not what you needed, change the approach instead of retrying."
         };
       }
-      if (isOscillating(state32.recent, cfg.oscillationWindow)) {
-        state32.oscillationsDetected += 1;
+      if (isOscillating(current.recent, cfg.oscillationWindow)) {
+        current.oscillationsDetected += 1;
         api.metrics.counter("oscillations");
-        state32.recent = [];
+        current.recent = [];
         return {
           decision: "allow",
           additionalContext: `loop-breaker: the last ${cfg.oscillationWindow} tool calls alternate between two identical calls (A-B-A-B pattern). You appear to be undoing and redoing the same work. Step back and pick a single approach.`
@@ -12789,32 +12832,33 @@ var plugin35 = {
       if (!cfg.enabled) return;
       const toolName = input.toolName ?? "unknown";
       if (ignoreToolsSet.has(toolName)) return;
-      state32.postInvocations += 1;
+      const current = runState(input.sessionId);
+      current.postInvocations += 1;
       if (input.toolResult?.isError) {
         const errorFingerprint = normalizeError(input.toolResult.content);
-        if (errorFingerprint && errorFingerprint === state32.lastErrorFingerprint) {
-          state32.repeatedErrorStreak += 1;
+        if (errorFingerprint && errorFingerprint === current.lastErrorFingerprint) {
+          current.repeatedErrorStreak += 1;
         } else {
-          state32.lastErrorFingerprint = errorFingerprint;
-          state32.repeatedErrorStreak = errorFingerprint ? 1 : 0;
+          current.lastErrorFingerprint = errorFingerprint;
+          current.repeatedErrorStreak = errorFingerprint ? 1 : 0;
         }
-        state32.noDiffStreak = 0;
-        if (cfg.repeatedErrorBlockAfter > 0 && state32.repeatedErrorStreak >= cfg.repeatedErrorBlockAfter && cfg.mode === "block") {
-          state32.repeatedErrorBlocks += 1;
-          state32.pendingBlockReason = `loop-breaker: the same tool error repeated ${state32.repeatedErrorStreak} times. The next tool call is blocked so you can stop, summarize the repeated failure, and change approach.`;
+        current.noDiffStreak = 0;
+        if (cfg.repeatedErrorBlockAfter > 0 && current.repeatedErrorStreak >= cfg.repeatedErrorBlockAfter && cfg.mode === "block") {
+          current.repeatedErrorBlocks += 1;
+          current.pendingBlockReason = `loop-breaker: the same tool error repeated ${current.repeatedErrorStreak} times. The next tool call is blocked so you can stop, summarize the repeated failure, and change approach.`;
         }
-        if (state32.repeatedErrorStreak >= cfg.repeatedErrorWarnAfter) {
-          state32.repeatedErrorWarnings += 1;
+        if (current.repeatedErrorStreak >= cfg.repeatedErrorWarnAfter) {
+          current.repeatedErrorWarnings += 1;
           api.metrics.counter("repeated_error_warnings");
           return {
             decision: "allow",
-            additionalContext: `loop-breaker: same error repeated ${state32.repeatedErrorStreak}x. Do not retry the same command/tool unchanged; inspect the root cause or ask for help.`
+            additionalContext: `loop-breaker: same error repeated ${current.repeatedErrorStreak}x. Do not retry the same command/tool unchanged; inspect the root cause or ask for help.`
           };
         }
         return;
       }
-      state32.lastErrorFingerprint = null;
-      state32.repeatedErrorStreak = 0;
+      current.lastErrorFingerprint = null;
+      current.repeatedErrorStreak = 0;
       if (!MUTATING_TOOLS.has(toolName)) return;
       const toolInput = input.toolInput ?? {};
       const rawTarget = toolInput["path"] ?? toolInput["TargetFile"] ?? toolInput["filePath"] ?? toolInput["targetFile"] ?? toolInput["file_path"] ?? toolInput["destination"] ?? toolInput["file"];
@@ -12826,22 +12870,22 @@ var plugin35 = {
         runtime.signal
       );
       if (diffFingerprint === null) return;
-      if (diffFingerprint === state32.lastDiffFingerprint) {
-        state32.noDiffStreak += 1;
+      if (diffFingerprint === current.lastDiffFingerprint) {
+        current.noDiffStreak += 1;
       } else {
-        state32.lastDiffFingerprint = diffFingerprint;
-        state32.noDiffStreak = 0;
+        current.lastDiffFingerprint = diffFingerprint;
+        current.noDiffStreak = 0;
       }
-      if (cfg.noDiffBlockAfter > 0 && state32.noDiffStreak >= cfg.noDiffBlockAfter && cfg.mode === "block") {
-        state32.noDiffBlocks += 1;
-        state32.pendingBlockReason = `loop-breaker: no diff was produced in the last ${state32.noDiffStreak} mutating step(s). The next tool call is blocked because continued edits are not changing the working tree.`;
+      if (cfg.noDiffBlockAfter > 0 && current.noDiffStreak >= cfg.noDiffBlockAfter && cfg.mode === "block") {
+        current.noDiffBlocks += 1;
+        current.pendingBlockReason = `loop-breaker: no diff was produced in the last ${current.noDiffStreak} mutating step(s). The next tool call is blocked because continued edits are not changing the working tree.`;
       }
-      if (state32.noDiffStreak >= cfg.noDiffWarnAfter) {
-        state32.noDiffWarnings += 1;
+      if (current.noDiffStreak >= cfg.noDiffWarnAfter) {
+        current.noDiffWarnings += 1;
         api.metrics.counter("no_diff_warnings");
         return {
           decision: "allow",
-          additionalContext: `loop-breaker: no diff has changed for ${state32.noDiffStreak} mutating step(s). Stop repeating edits; read the file/status, explain why no change is happening, or choose a different approach.`
+          additionalContext: `loop-breaker: no diff has changed for ${current.noDiffStreak} mutating step(s). Stop repeating edits; read the file/status, explain why no change is happening, or choose a different approach.`
         };
       }
       return;
@@ -12856,9 +12900,18 @@ var plugin35 = {
       timeoutMs: 2e3,
       failurePolicy: "open"
     });
+    const unregisterPrompt = api.registerHook(
+      "UserPromptSubmit",
+      void 0,
+      ((input) => {
+        resetRun(input.sessionId);
+      }),
+      { name: "loop-breaker-turn-reset", failurePolicy: "open" }
+    );
     state32.hookUnregister = () => {
       unregisterPre();
       unregisterPost();
+      unregisterPrompt();
     };
     api.tools.register({
       name: "loop_breaker_status",
@@ -12867,7 +12920,8 @@ var plugin35 = {
       permission: "auto",
       category: "Diagnostics",
       mutating: false,
-      async execute() {
+      async execute(_input, ctx) {
+        const current = runState(ctx?.session?.id);
         return {
           ok: true,
           enabled: cfg.enabled,
@@ -12881,20 +12935,20 @@ var plugin35 = {
           repeatedErrorWarnAfter: cfg.repeatedErrorWarnAfter,
           repeatedErrorBlockAfter: cfg.repeatedErrorBlockAfter,
           ignoreTools: cfg.ignoreTools,
-          currentStreak: state32.streak,
-          noDiffStreak: state32.noDiffStreak,
-          repeatedErrorStreak: state32.repeatedErrorStreak,
+          currentStreak: current.streak,
+          noDiffStreak: current.noDiffStreak,
+          repeatedErrorStreak: current.repeatedErrorStreak,
           counters: {
-            invocations: state32.invocations,
-            postInvocations: state32.postInvocations,
-            warnings: state32.warnings,
-            blocks: state32.blocks,
-            oscillationsDetected: state32.oscillationsDetected,
-            stepBudgetBlocks: state32.stepBudgetBlocks,
-            noDiffWarnings: state32.noDiffWarnings,
-            noDiffBlocks: state32.noDiffBlocks,
-            repeatedErrorWarnings: state32.repeatedErrorWarnings,
-            repeatedErrorBlocks: state32.repeatedErrorBlocks
+            invocations: current.invocations,
+            postInvocations: current.postInvocations,
+            warnings: current.warnings,
+            blocks: current.blocks,
+            oscillationsDetected: current.oscillationsDetected,
+            stepBudgetBlocks: current.stepBudgetBlocks,
+            noDiffWarnings: current.noDiffWarnings,
+            noDiffBlocks: current.noDiffBlocks,
+            repeatedErrorWarnings: current.repeatedErrorWarnings,
+            repeatedErrorBlocks: current.repeatedErrorBlocks
           }
         };
       }
@@ -12915,53 +12969,26 @@ var plugin35 = {
       }
       state32.hookUnregister = null;
     }
-    const final = {
-      invocations: state32.invocations,
-      postInvocations: state32.postInvocations,
-      warnings: state32.warnings,
-      blocks: state32.blocks,
-      oscillationsDetected: state32.oscillationsDetected,
-      stepBudgetBlocks: state32.stepBudgetBlocks,
-      noDiffWarnings: state32.noDiffWarnings,
-      noDiffBlocks: state32.noDiffBlocks,
-      repeatedErrorWarnings: state32.repeatedErrorWarnings,
-      repeatedErrorBlocks: state32.repeatedErrorBlocks
-    };
-    state32.lastFingerprint = null;
-    state32.streak = 0;
-    state32.recent = [];
-    state32.pendingBlockReason = null;
-    state32.lastDiffFingerprint = null;
-    state32.noDiffStreak = 0;
-    state32.lastErrorFingerprint = null;
-    state32.repeatedErrorStreak = 0;
-    state32.invocations = 0;
-    state32.postInvocations = 0;
-    state32.warnings = 0;
-    state32.blocks = 0;
-    state32.oscillationsDetected = 0;
-    state32.stepBudgetBlocks = 0;
-    state32.noDiffWarnings = 0;
-    state32.noDiffBlocks = 0;
-    state32.repeatedErrorWarnings = 0;
-    state32.repeatedErrorBlocks = 0;
+    const final = aggregateRuns();
+    state32.runs.clear();
     api.log.info("loop-breaker: teardown complete", { final });
   },
   async health() {
+    const totals = aggregateRuns();
     return {
       ok: true,
-      message: `loop-breaker: ${state32.invocations} call(s) observed, ${state32.warnings + state32.noDiffWarnings + state32.repeatedErrorWarnings} warning(s), ${state32.blocks} block(s), ${state32.oscillationsDetected} oscillation(s)`,
+      message: `loop-breaker: ${totals.invocations} call(s) observed, ${totals.warnings + totals.noDiffWarnings + totals.repeatedErrorWarnings} warning(s), ${totals.blocks} block(s), ${totals.oscillationsDetected} oscillation(s)`,
       counters: {
-        invocations: state32.invocations,
-        postInvocations: state32.postInvocations,
-        warnings: state32.warnings,
-        blocks: state32.blocks,
-        oscillationsDetected: state32.oscillationsDetected,
-        stepBudgetBlocks: state32.stepBudgetBlocks,
-        noDiffWarnings: state32.noDiffWarnings,
-        noDiffBlocks: state32.noDiffBlocks,
-        repeatedErrorWarnings: state32.repeatedErrorWarnings,
-        repeatedErrorBlocks: state32.repeatedErrorBlocks
+        invocations: totals.invocations,
+        postInvocations: totals.postInvocations,
+        warnings: totals.warnings,
+        blocks: totals.blocks,
+        oscillationsDetected: totals.oscillationsDetected,
+        stepBudgetBlocks: totals.stepBudgetBlocks,
+        noDiffWarnings: totals.noDiffWarnings,
+        noDiffBlocks: totals.noDiffBlocks,
+        repeatedErrorWarnings: totals.repeatedErrorWarnings,
+        repeatedErrorBlocks: totals.repeatedErrorBlocks
       }
     };
   }
@@ -13879,7 +13906,8 @@ var state35 = {
   lastDelivery: null,
   stopHookUnregister: null,
   eventUnsubscribers: [],
-  circuitWarned: false
+  circuitWarned: false,
+  disabledReason: null
 };
 var KNOWN_EVENTS = ["session.stop", "tool.error", "budget.threshold"];
 var DEFAULTS33 = {
@@ -14062,13 +14090,21 @@ var plugin38 = {
       }
     }
     state35.eventUnsubscribers = [];
-    const cfg = readConfig33(api.config.extensions?.["notify-hub"]);
+    state35.disabledReason = null;
+    const rawCfg = api.config.extensions?.["notify-hub"];
+    const cfg = readConfig33(rawCfg);
     let active = cfg.enabled && cfg.webhookUrl.length > 0;
+    const rawUrl = rawCfg?.["webhookUrl"] ?? rawCfg?.["webhook_url"] ?? rawCfg?.["url"];
+    if (cfg.enabled && typeof rawUrl === "string" && rawUrl.trim() && !cfg.webhookUrl) {
+      state35.disabledReason = "webhookUrl was refused: it must be an http(s) URL without credentials that does not target localhost or a private address";
+      api.log.warn(`notify-hub: ${state35.disabledReason}`);
+    }
     if (active) {
       try {
         const url = new URL(cfg.webhookUrl);
         const hostnameBlocked = await hasPrivateResolvedIP(url.hostname);
         if (hostnameBlocked) {
+          state35.disabledReason = `webhookUrl was refused: ${url.hostname} resolves to a private/local IP`;
           api.log.warn(
             `notify-hub: webhook URL resolves to a private/local IP (${url.hostname}) \u2014 disabling plugin`
           );
@@ -14141,7 +14177,7 @@ var plugin38 = {
         const ch = state35.channel;
         if (!ch) {
           throw new Error(
-            'no webhookUrl configured \u2014 set config.extensions["notify-hub"].webhookUrl to enable deliveries'
+            state35.disabledReason ?? 'no webhookUrl configured \u2014 set config.extensions["notify-hub"].webhookUrl to enable deliveries'
           );
         }
         const inp = input ?? {};
@@ -17401,7 +17437,7 @@ var state41 = {
   lastHookWarning: new runtime_exports.BoundedMap({ max: 512, ttlMs: HOOK_WARNING_COOLDOWN_MS2 })
 };
 var DEFAULTS38 = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx", ".js", ".jsx"],
   maxSuggestions: 5,
   rules: { longFunctionLines: 50, maxParams: 5, maxNesting: 3 }
@@ -17592,7 +17628,7 @@ var plugin44 = {
   configSchema: {
     type: "object",
     properties: {
-      enabled: { type: "boolean", default: false, description: "Master switch." },
+      enabled: { type: "boolean", default: true, description: "Master switch." },
       extensions: {
         type: "array",
         items: { type: "string" },
@@ -19007,7 +19043,7 @@ var state44 = {
   hookUnregister: null
 };
 var DEFAULTS42 = {
-  enabled: false,
+  enabled: true,
   severity: "warn",
   maxFindings: 10,
   scanOnChange: [
@@ -19198,7 +19234,7 @@ var plugin48 = {
   configSchema: {
     type: "object",
     properties: {
-      enabled: { type: "boolean", default: false, description: "Master switch." },
+      enabled: { type: "boolean", default: true, description: "Master switch." },
       severity: {
         type: "string",
         enum: ["warn", "block"],

package/dist/interface-contract-guard.js

@@ -33,7 +33,7 @@ var state = {
   hookUnregister: null
 };
 var DEFAULTS = {
-  enabled: false,
+  enabled: true,
   extensions: [".ts", ".tsx"],
   maxFindings: 50,
   maxFiles: 2e3