@wrongstack/plugins 0.316.2 → 0.317.2

package/dist/injection-shield/index.d.ts

@@ -58,6 +58,7 @@ import type { Plugin } from '@wrongstack/core/types';
  */
 export declare function stripInvisible(text: string): string;
 export declare function scanForInjection(text: string): string[];
+export declare function extractToolContent(toolResult: unknown): string;
 declare const plugin: Plugin;
 export default plugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/injection-shield.js

@@ -15,11 +15,14 @@ var DEFAULTS = {
 function readConfig(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS };
   const r = raw;
+  const rawTools = r["tools"] ?? r["matcher"] ?? r["toolMatcher"] ?? r["tool_matcher"];
+  const rawMin = r["minMatches"] ?? r["min_matches"] ?? r["min"];
+  const rawMax = r["maxScanChars"] ?? r["max_scan_chars"] ?? r["maxChars"] ?? r["max_chars"];
   return {
     enabled: r["enabled"] !== false,
-    tools: typeof r["tools"] === "string" && r["tools"].length > 0 ? r["tools"] : DEFAULTS.tools,
-    minMatches: typeof r["minMatches"] === "number" && r["minMatches"] >= 1 && r["minMatches"] <= 10 ? r["minMatches"] : DEFAULTS.minMatches,
-    maxScanChars: typeof r["maxScanChars"] === "number" && r["maxScanChars"] >= 1024 ? r["maxScanChars"] : DEFAULTS.maxScanChars
+    tools: typeof rawTools === "string" && rawTools.length > 0 ? rawTools : DEFAULTS.tools,
+    minMatches: typeof rawMin === "number" && rawMin >= 1 && rawMin <= 10 ? rawMin : DEFAULTS.minMatches,
+    maxScanChars: typeof rawMax === "number" && rawMax >= 1024 ? rawMax : DEFAULTS.maxScanChars
   };
 }
 var PATTERNS = [
@@ -78,6 +81,27 @@ function scanForInjection(text) {
   }
   return [...hits];
 }
+function extractToolContent(toolResult) {
+  if (!toolResult) return "";
+  if (typeof toolResult === "string") return toolResult;
+  if (typeof toolResult === "object") {
+    const tr = toolResult;
+    if (typeof tr["content"] === "string") return tr["content"];
+    if (Array.isArray(tr["content"])) {
+      return tr["content"].map(
+        (item) => typeof item === "string" ? item : typeof item === "object" && item && typeof item["text"] === "string" ? item["text"] : ""
+      ).filter(Boolean).join("\n");
+    }
+    if (typeof tr["output"] === "string") return tr["output"];
+    if (typeof tr["stdout"] === "string") return tr["stdout"];
+    if (typeof tr["text"] === "string") return tr["text"];
+    if (typeof tr["result"] === "string") return tr["result"];
+    if (typeof tr["body"] === "string") return tr["body"];
+    if (typeof tr["contents"] === "string") return tr["contents"];
+    if (typeof tr["data"] === "string") return tr["data"];
+  }
+  return "";
+}
 var plugin = {
   name: "injection-shield",
   version: "0.1.0",
@@ -125,8 +149,8 @@ var plugin = {
     const hook = (input) => {
       if (!cfg.enabled) return;
       state.invocations += 1;
-      const content = input.toolResult?.content;
-      if (typeof content !== "string" || content.length === 0) return;
+      const content = extractToolContent(input.toolResult);
+      if (content.length === 0) return;
       state.scans += 1;
       const hits = scanForInjection(content.slice(0, cfg.maxScanChars));
       if (hits.length < cfg.minMatches) return;
@@ -211,6 +235,7 @@ var plugin = {
 var injection_shield_default = plugin;
 export {
   injection_shield_default as default,
+  extractToolContent,
   scanForInjection,
   stripInvisible
 };

package/dist/interface-contract-guard.js

@@ -175,7 +175,8 @@ var plugin = {
       if (!cfg.enabled) return;
       if (input.toolResult?.isError) return;
       const inp = input.toolInput ?? {};
-      const sourcePath = inp["path"];
+      const rawPath = inp["path"] ?? inp["TargetFile"] ?? inp["filePath"] ?? inp["targetFile"] ?? inp["file_path"] ?? inp["file"];
+      const sourcePath = typeof rawPath === "string" && rawPath.trim() ? rawPath.trim() : void 0;
       if (!sourcePath || typeof sourcePath !== "string") return;
       if (!(0, runtime_exports.withinProject)(sourcePath)) return;
       const exts = normalizeExtensions(cfg.extensions);
@@ -214,7 +215,8 @@ If you changed member shapes, search the project for implementers/\`satisfies\`/
       mutating: false,
       async execute(input) {
         if (!cfg.enabled) return { ok: false, error: "interface-contract-guard is disabled" };
-        const rawPath = typeof input.path === "string" ? input.path : ".";
+        const raw = input ?? {};
+        const rawPath = (typeof input.path === "string" && input.path.trim().length > 0 ? input.path.trim() : void 0) ?? (typeof raw["directory"] === "string" ? raw["directory"] : void 0) ?? (typeof raw["dir"] === "string" ? raw["dir"] : void 0) ?? (typeof raw["SearchDirectory"] === "string" ? raw["SearchDirectory"] : void 0) ?? (typeof raw["TargetFile"] === "string" ? raw["TargetFile"] : void 0) ?? (typeof raw["filePath"] === "string" ? raw["filePath"] : void 0) ?? (typeof raw["targetFile"] === "string" ? raw["targetFile"] : void 0) ?? (typeof raw["file"] === "string" ? raw["file"] : void 0) ?? ".";
         if (!(0, runtime_exports.withinProject)(rawPath)) {
           return { ok: false, error: "path is outside the project root" };
         }

package/dist/knowledge-graph.js

@@ -25,19 +25,24 @@ function resolveProjectPath(rawPath, cwd = process.cwd()) {
   const root = resolve(cwd);
   const resolved = isAbsolute(rawPath) ? resolve(rawPath) : resolve(root, rawPath);
   const rel = relative(root, resolved);
-  if (rel === "" || !rel.startsWith("..") && !isAbsolute(rel)) return resolved;
-  return null;
+  if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) return null;
+  return resolved;
 }
 function readConfig(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS };
   const r = raw;
+  const rawPath = typeof r["filePath"] === "string" ? r["filePath"] : typeof r["file_path"] === "string" ? r["file_path"] : typeof r["path"] === "string" ? r["path"] : typeof r["file"] === "string" ? r["file"] : DEFAULTS.filePath;
+  const rawMaxFacts = r["maxFacts"] ?? r["max_facts"] ?? r["limit"];
+  const rawMaxFactChars = r["maxFactChars"] ?? r["max_fact_chars"] ?? r["maxChars"] ?? r["max_chars"];
+  const rawContribute = r["contributeToSystemPrompt"] ?? r["contribute_to_system_prompt"] ?? r["contribute"];
+  const rawContributeMax = r["contributeMaxChars"] ?? r["contribute_max_chars"];
   return {
     enabled: r["enabled"] !== false,
-    filePath: typeof r["filePath"] === "string" ? r["filePath"] : DEFAULTS.filePath,
-    maxFacts: typeof r["maxFacts"] === "number" && r["maxFacts"] >= 1 && r["maxFacts"] <= 2e3 ? r["maxFacts"] : DEFAULTS.maxFacts,
-    maxFactChars: typeof r["maxFactChars"] === "number" && r["maxFactChars"] >= 20 ? r["maxFactChars"] : DEFAULTS.maxFactChars,
-    contributeToSystemPrompt: r["contributeToSystemPrompt"] !== false,
-    contributeMaxChars: typeof r["contributeMaxChars"] === "number" && r["contributeMaxChars"] >= 100 ? r["contributeMaxChars"] : DEFAULTS.contributeMaxChars
+    filePath: typeof rawPath === "string" ? rawPath : DEFAULTS.filePath,
+    maxFacts: typeof rawMaxFacts === "number" && rawMaxFacts >= 1 && rawMaxFacts <= 2e3 ? rawMaxFacts : DEFAULTS.maxFacts,
+    maxFactChars: typeof rawMaxFactChars === "number" && rawMaxFactChars >= 20 ? rawMaxFactChars : DEFAULTS.maxFactChars,
+    contributeToSystemPrompt: rawContribute !== false,
+    contributeMaxChars: typeof rawContributeMax === "number" && rawContributeMax >= 100 ? rawContributeMax : DEFAULTS.contributeMaxChars
   };
 }
 function loadFacts(filePath) {
@@ -174,19 +179,28 @@ var plugin = {
           };
         }
         const trim = (s) => String(s ?? "").trim().slice(0, cfg.maxFactChars);
-        const subject = trim(input.subject);
-        const relation = trim(input.relation);
-        const object = trim(input.object);
+        const raw = input;
+        const subject = trim(
+          input.subject ?? raw["entity"] ?? raw["topic"] ?? raw["sub"] ?? raw["name"] ?? raw["sourceEntity"]
+        );
+        const relation = trim(
+          input.relation ?? raw["predicate"] ?? raw["rel"] ?? raw["verb"] ?? raw["relationship"] ?? raw["action"]
+        );
+        const object = trim(
+          input.object ?? raw["target"] ?? raw["val"] ?? raw["value"] ?? raw["obj"] ?? raw["targetEntity"]
+        );
         if (!subject || !relation || !object) {
           return { ok: false, error: "subject, relation, and object are required" };
         }
+        const rawConf = typeof input.confidence === "string" ? input.confidence.trim().toLowerCase() : "";
+        const confidence = rawConf === "low" || rawConf === "high" || rawConf === "medium" ? rawConf : "medium";
         const fact = {
           id: `kg-${state.nextId++}`,
           subject,
           relation,
           object,
           source: input.source ? String(input.source).slice(0, cfg.maxFactChars) : null,
-          confidence: input.confidence ?? "medium",
+          confidence,
           createdAt: (/* @__PURE__ */ new Date()).toISOString()
         };
         state.facts.push(fact);
@@ -215,19 +229,29 @@ var plugin = {
       async execute(input) {
         if (!cfg.enabled) return { ok: false, error: "knowledge-graph is disabled" };
         state.queries += 1;
+        const raw = input;
+        const rawQ = (typeof raw["query"] === "string" ? raw["query"] : void 0) ?? (typeof raw["q"] === "string" ? raw["q"] : void 0);
+        const q = rawQ?.toLowerCase();
+        const rawFilterConf = typeof input.confidence === "string" ? input.confidence.trim().toLowerCase() : void 0;
+        const filterConf = rawFilterConf === "low" || rawFilterConf === "medium" || rawFilterConf === "high" ? rawFilterConf : void 0;
         const limit = typeof input.limit === "number" && input.limit >= 1 ? Math.floor(input.limit) : 20;
         const matches = state.facts.filter((f) => {
+          if (q) {
+            const hasMatch = f.subject.toLowerCase().includes(q) || f.relation.toLowerCase().includes(q) || f.object.toLowerCase().includes(q);
+            if (!hasMatch) return false;
+          }
           if (input.subject && !f.subject.toLowerCase().includes(input.subject.toLowerCase())) return false;
           if (input.relation && !f.relation.toLowerCase().includes(input.relation.toLowerCase())) return false;
           if (input.object && !f.object.toLowerCase().includes(input.object.toLowerCase())) return false;
-          if (input.confidence && f.confidence !== input.confidence) return false;
+          if (filterConf && f.confidence.toLowerCase() !== filterConf) return false;
           return true;
         });
+        const returnedFacts = matches.slice(-limit);
         return {
           ok: true,
           totalFacts: state.facts.length,
-          returned: Math.min(matches.length, limit),
-          facts: matches.slice(-limit)
+          returned: returnedFacts.length,
+          facts: returnedFacts
         };
       }
     });
@@ -247,9 +271,12 @@ var plugin = {
       async execute(input) {
         if (!cfg.enabled) return { ok: false, error: "knowledge-graph is disabled" };
         const before = state.facts.length;
-        state.facts = state.facts.filter((f) => f.id !== input.id);
+        const raw = input ?? {};
+        const rawId = String(input.id ?? raw["factId"] ?? raw["fact_id"] ?? "").trim();
+        const normalized = rawId.toLowerCase().startsWith("kg-") ? rawId.toLowerCase() : `kg-${rawId.toLowerCase()}`;
+        state.facts = state.facts.filter((f) => f.id.toLowerCase() !== normalized && f.id !== rawId);
         const removed = before - state.facts.length;
-        if (removed === 0) return { ok: false, error: `no fact matches "${input.id}"` };
+        if (removed === 0) return { ok: false, error: `no fact matches "${input.id ?? rawId}"` };
         state.removals += removed;
         api.metrics.counter("removals", removed);
         const persisted = await persistFacts(resolved);

package/dist/license-audit-gate.js

@@ -36,14 +36,14 @@ function readConfig(raw) {
     confirmTyposquatsWithLlm: r["confirmTyposquatsWithLlm"] === true
   };
 }
-var INSTALL_RE = /(?:^|[;&|]\s*)(npm|pnpm|yarn|bun)\s+(?:install|i|add)\s+([^;&|]+)|(?:^|[;&|]\s*)(pip3?|uv)\s+(?:pip\s+)?install\s+([^;&|]+)|(?:^|[;&|]\s*)(cargo)\s+add\s+([^;&|]+)/gi;
+var INSTALL_RE = /(?:^|[;&|]\s*)(npm|pnpm|yarn|bun)\s+(?:install|i|add)\s+([^;&|]+)|(?:^|[;&|]\s*)(pip3?|uv)\s+(?:pip\s+)?install\s+([^;&|]+)|(?:^|[;&|]\s*)(uv)\s+add\s+([^;&|]+)|(?:^|[;&|]\s*)(cargo)\s+add\s+([^;&|]+)/gi;
 function parseInstallCommands(command) {
   const out = [];
   INSTALL_RE.lastIndex = 0;
   let m = INSTALL_RE.exec(command);
   while (m !== null) {
-    const manager = (m[1] ?? m[3] ?? m[5] ?? "").toLowerCase();
-    const argString = m[2] ?? m[4] ?? m[6] ?? "";
+    const manager = (m[1] ?? m[3] ?? m[5] ?? m[7] ?? "").toLowerCase();
+    const argString = m[2] ?? m[4] ?? m[6] ?? m[8] ?? "";
     const packages = [];
     for (const token of argString.split(/\s+/)) {
       if (!token || token.startsWith("-")) continue;
@@ -205,7 +205,8 @@ var plugin = {
       if (!cfg.enabled) return;
       state.invocations += 1;
       const ti = input.toolInput ?? {};
-      const command = typeof ti["command"] === "string" ? ti["command"] : "";
+      const rawCmd = ti["command"] ?? ti["CommandLine"] ?? ti["cmd"] ?? ti["script"] ?? ti["input"];
+      const command = typeof rawCmd === "string" ? rawCmd : "";
       if (!command) return;
       const installs = parseInstallCommands(command);
       const packages = installs.flatMap((i) => i.packages);
@@ -400,11 +401,13 @@ function normalizeStrings(v) {
 function readConfig2(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS2 };
   const r = raw;
-  const allowed = normalizeStrings(r["allowedLicenses"]);
+  const rawLicenses = r["allowedLicenses"] ?? r["allowed_licenses"] ?? r["licenses"];
+  const allowed = normalizeStrings(rawLicenses);
+  const rawBlock = r["block"] ?? r["fail_on_violation"] ?? r["failOnViolation"];
   return {
     enabled: r["enabled"] !== false,
     allowedLicenses: allowed.length > 0 ? allowed : [...DEFAULTS2.allowedLicenses],
-    block: r["block"] !== false
+    block: rawBlock !== false
   };
 }
 function extractLicenseStrings(pkg) {
@@ -430,6 +433,56 @@ function parsePackageNames(command) {
     ...new Set(parseInstallCommands(command).flatMap((entry) => entry.packages.map((pkg) => pkg.name)))
   ];
 }
+function splitTopLevel(expr, separator) {
+  const parts = [];
+  let depth = 0;
+  let start = 0;
+  for (let i = 0; i < expr.length; i++) {
+    const ch = expr[i];
+    if (ch === "(") depth++;
+    else if (ch === ")") depth = Math.max(0, depth - 1);
+    else if (depth === 0) {
+      const match = separator.exec(expr.slice(i));
+      if (match && match.index === 0) {
+        parts.push(expr.slice(start, i).trim());
+        i += match[0].length - 1;
+        start = i + 1;
+      }
+    }
+  }
+  parts.push(expr.slice(start).trim());
+  return parts;
+}
+function isLicenseAllowed(licenseStr, normalizedAllowed) {
+  let expr = licenseStr.trim();
+  if (!expr) return false;
+  if (normalizedAllowed.has(expr.toLowerCase())) return true;
+  while (expr.startsWith("(")) {
+    let depth = 0;
+    let close = -1;
+    for (let i = 0; i < expr.length; i++) {
+      if (expr[i] === "(") depth++;
+      else if (expr[i] === ")") {
+        depth--;
+        if (depth === 0) {
+          close = i;
+          break;
+        }
+      }
+    }
+    if (close !== expr.length - 1) break;
+    expr = expr.slice(1, -1).trim();
+  }
+  const orParts = splitTopLevel(expr, /\s+OR\s+/i);
+  if (orParts.length > 1) {
+    return orParts.some((p) => isLicenseAllowed(p, normalizedAllowed));
+  }
+  const andParts = splitTopLevel(expr, /\s+AND\s+/i);
+  if (andParts.length > 1) {
+    return andParts.every((p) => isLicenseAllowed(p, normalizedAllowed));
+  }
+  return normalizedAllowed.has(expr.toLowerCase());
+}
 function auditPackages(names, allowedLicenses) {
   const results = [];
   const errors = [];
@@ -443,7 +496,7 @@ function auditPackages(names, allowedLicenses) {
     } catch {
       errors.push(name);
     }
-    const allowed = licenses.length > 0 && licenses.every((l) => normalizedAllowed.has(l.toLowerCase()));
+    const allowed = licenses.length > 0 && licenses.every((l) => isLicenseAllowed(l, normalizedAllowed));
     results.push({ name, licenses, allowed });
   }
   const ok = errors.length === 0 && results.every((r) => r.allowed);
@@ -498,7 +551,7 @@ var plugin2 = {
       if (!cfg.enabled) return;
       if (input.toolResult?.isError) return;
       const ti = input.toolInput ?? {};
-      const command = typeof ti["command"] === "string" ? ti["command"] : "";
+      const command = (typeof ti["command"] === "string" ? ti["command"] : void 0) ?? (typeof ti["CommandLine"] === "string" ? ti["CommandLine"] : void 0) ?? (typeof ti["cmd"] === "string" ? ti["cmd"] : void 0) ?? (typeof ti["script"] === "string" ? ti["script"] : void 0) ?? "";
       if (!command) return;
       state2.invocations += 1;
       const names = parsePackageNames(command);

package/dist/lint-gate.js

@@ -51,12 +51,20 @@ var DEFAULTS = {
 function readConfig(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS };
   const r = raw;
+  const rawLinter = typeof r["linter"] === "string" ? r["linter"].trim().toLowerCase() : void 0;
+  const linter = rawLinter === "biome" || rawLinter === "eslint" ? rawLinter : "auto";
+  const rawMode = typeof (r["mode"] ?? r["action"] ?? r["behavior"]) === "string" ? String(r["mode"] ?? r["action"] ?? r["behavior"]).trim().toLowerCase() : void 0;
+  const mode = rawMode === "block" ? "block" : rawMode === "fix" ? "fix" : "warn";
+  const rawSeverity = typeof r["severity"] === "string" ? r["severity"].trim().toLowerCase() : void 0;
+  const severity = rawSeverity === "warning" ? "warning" : "error";
+  const rawTimeout = r["timeoutMs"] ?? r["timeout_ms"] ?? r["timeout"];
+  const rawRules = r["fixRules"] ?? r["fix_rules"] ?? r["rules"];
   return {
-    linter: r["linter"] === "biome" || r["linter"] === "eslint" ? r["linter"] : "auto",
-    mode: r["mode"] === "block" ? "block" : r["mode"] === "fix" ? "fix" : "warn",
-    severity: r["severity"] === "warning" ? "warning" : "error",
-    timeoutMs: typeof r["timeoutMs"] === "number" ? r["timeoutMs"] : DEFAULTS.timeoutMs,
-    fixRules: Array.isArray(r["fixRules"]) ? r["fixRules"].filter((x) => typeof x === "string") : []
+    linter,
+    mode,
+    severity,
+    timeoutMs: typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : DEFAULTS.timeoutMs,
+    fixRules: Array.isArray(rawRules) ? rawRules.filter((x) => typeof x === "string") : []
   };
 }
 var LINTER_PACKAGES = {

package/dist/llm-cache.js

@@ -20,12 +20,16 @@ var DEFAULTS = {
 function readConfig(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS };
   const r = raw;
+  const rawMax = r["maxEntries"] ?? r["max_entries"] ?? r["limit"];
+  const rawTtl = r["ttlMs"] ?? r["ttl_ms"] ?? r["ttl"];
+  const rawDet = r["onlyDeterministic"] ?? r["only_deterministic"];
+  const rawZero = r["zeroUsageOnHit"] ?? r["zero_usage_on_hit"] ?? r["zeroUsage"] ?? r["zero_usage"];
   return {
     enabled: r["enabled"] === true,
-    maxEntries: typeof r["maxEntries"] === "number" && r["maxEntries"] >= 1 ? Math.floor(r["maxEntries"]) : DEFAULTS.maxEntries,
-    ttlMs: typeof r["ttlMs"] === "number" && r["ttlMs"] >= 0 ? r["ttlMs"] : DEFAULTS.ttlMs,
-    onlyDeterministic: r["onlyDeterministic"] !== false,
-    zeroUsageOnHit: r["zeroUsageOnHit"] === true
+    maxEntries: typeof rawMax === "number" && rawMax >= 1 ? Math.floor(rawMax) : DEFAULTS.maxEntries,
+    ttlMs: typeof rawTtl === "number" && rawTtl >= 0 ? rawTtl : DEFAULTS.ttlMs,
+    onlyDeterministic: rawDet !== false,
+    zeroUsageOnHit: rawZero === true
   };
 }
 function isDeterministic(request) {
@@ -36,6 +40,7 @@ var fingerprintCache = /* @__PURE__ */ new WeakMap();
 function fingerprintRequest(request) {
   const cached = fingerprintCache.get(request);
   if (cached) return cached;
+  const rawTools = request["tools"] ?? request["tool_definitions"] ?? request["toolDefinitions"] ?? request["functions"];
   const subset = {
     maxTokens: request["maxTokens"] ?? null,
     messages: request["messages"] ?? null,
@@ -45,7 +50,7 @@ function fingerprintRequest(request) {
     stopSequences: request["stopSequences"] ?? null,
     system: request["system"] ?? null,
     temperature: request["temperature"] ?? null,
-    tools: Array.isArray(request["tools"]) ? request["tools"].map((t) => t?.name ?? t) : null,
+    tools: Array.isArray(rawTools) ? rawTools.map((t) => t?.name ?? t) : null,
     topK: request["topK"] ?? null,
     topP: request["topP"] ?? null
   };
@@ -173,7 +178,16 @@ var plugin = {
           api.metrics.counter("misses");
           const response = await inner(_ctx, request);
           const sr = response && typeof response === "object" ? response.stopReason : void 0;
-          if (response && typeof response === "object" && (sr === "end_turn" || sr === "stop" || sr === "tool_use")) {
+          const normSr = typeof sr === "string" ? sr.toLowerCase() : "";
+          const validStopReasons = /* @__PURE__ */ new Set([
+            "end_turn",
+            "stop",
+            "tool_use",
+            "tool_calls",
+            "function_call",
+            "stop_sequence"
+          ]);
+          if (response && typeof response === "object" && validStopReasons.has(normSr)) {
             lruSet(key, response, cfg.maxEntries);
           }
           return response;

package/dist/loop-breaker.js

@@ -42,17 +42,24 @@ function readConfig(raw) {
     return { ...DEFAULTS };
   }
   const r = raw;
-  const warnAfter = typeof r["warnAfter"] === "number" && r["warnAfter"] >= 2 ? r["warnAfter"] : DEFAULTS.warnAfter;
-  const blockAfter = typeof r["blockAfter"] === "number" && r["blockAfter"] > warnAfter ? r["blockAfter"] : Math.max(DEFAULTS.blockAfter, warnAfter + 1);
-  const ignoreTools = Array.isArray(r["ignoreTools"]) ? r["ignoreTools"].filter((t) => typeof t === "string") : [];
+  const rawWarn = r["warnAfter"] ?? r["warn_after"] ?? r["warnThreshold"] ?? r["warn_threshold"];
+  const warnAfter = typeof rawWarn === "number" && rawWarn >= 2 ? rawWarn : DEFAULTS.warnAfter;
+  const rawBlock = r["blockAfter"] ?? r["block_after"] ?? r["blockThreshold"] ?? r["block_threshold"];
+  const blockAfter = typeof rawBlock === "number" && rawBlock > warnAfter ? rawBlock : Math.max(DEFAULTS.blockAfter, warnAfter + 1);
+  const rawIgnore = r["ignoreTools"] ?? r["ignore_tools"] ?? r["ignore"] ?? r["ignoredTools"];
+  const ignoreTools = Array.isArray(rawIgnore) ? rawIgnore.filter((t) => typeof t === "string") : [];
   ignoreToolsSet = new Set(ignoreTools);
+  const rawMode = typeof (r["mode"] ?? r["action"] ?? r["behavior"]) === "string" ? String(r["mode"] ?? r["action"] ?? r["behavior"]).trim().toLowerCase() : void 0;
+  const mode = rawMode === "warn" ? "warn" : "block";
+  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,
-    mode: r["mode"] === "warn" ? "warn" : "block",
+    mode,
     warnAfter,
     blockAfter,
-    oscillationWindow: typeof r["oscillationWindow"] === "number" && r["oscillationWindow"] >= 4 ? r["oscillationWindow"] : DEFAULTS.oscillationWindow,
-    maxSteps: typeof r["maxSteps"] === "number" && r["maxSteps"] >= 0 ? Math.floor(r["maxSteps"]) : DEFAULTS.maxSteps,
+    oscillationWindow: typeof rawOsc === "number" && rawOsc >= 4 ? rawOsc : DEFAULTS.oscillationWindow,
+    maxSteps: typeof rawMaxSteps === "number" && rawMaxSteps >= 0 ? Math.floor(rawMaxSteps) : DEFAULTS.maxSteps,
     noDiffWarnAfter: typeof r["noDiffWarnAfter"] === "number" && r["noDiffWarnAfter"] >= 1 ? Math.floor(r["noDiffWarnAfter"]) : DEFAULTS.noDiffWarnAfter,
     noDiffBlockAfter: typeof r["noDiffBlockAfter"] === "number" && r["noDiffBlockAfter"] >= 0 ? Math.floor(r["noDiffBlockAfter"]) : DEFAULTS.noDiffBlockAfter,
     repeatedErrorWarnAfter: typeof r["repeatedErrorWarnAfter"] === "number" && r["repeatedErrorWarnAfter"] >= 1 ? Math.floor(r["repeatedErrorWarnAfter"]) : DEFAULTS.repeatedErrorWarnAfter,
@@ -101,7 +108,7 @@ function isOscillating(recent, windowSize) {
   }
   return window[0] !== window[1];
 }
-var MUTATING_TOOLS = /* @__PURE__ */ new Set(["edit", "write"]);
+var MUTATING_TOOLS = /* @__PURE__ */ new Set(["edit", "write", "write_to_file", "replace_file_content"]);
 function hashString(value) {
   let h = 5381;
   const cap = Math.min(value.length, 1e6);
@@ -339,7 +346,8 @@ var plugin = {
       state.repeatedErrorStreak = 0;
       if (!MUTATING_TOOLS.has(toolName)) return;
       const toolInput = input.toolInput ?? {};
-      const targetPath = toolInput["path"];
+      const rawTarget = toolInput["path"] ?? toolInput["TargetFile"] ?? toolInput["filePath"] ?? toolInput["targetFile"] ?? toolInput["file_path"] ?? toolInput["destination"] ?? toolInput["file"];
+      const targetPath = typeof rawTarget === "string" ? rawTarget : void 0;
       if (typeof targetPath !== "string" || targetPath.length === 0) return;
       const diffFingerprint = await gitDiffFingerprint(
         input.cwd ?? process.cwd(),

package/dist/migration-planner.js

@@ -49,12 +49,16 @@ var DEFAULTS = {
 function readConfig(raw) {
   if (!raw || typeof raw !== "object") return { ...DEFAULTS };
   const r = raw;
+  const rawPaths = r["changelogPaths"] ?? r["changelog_paths"] ?? r["paths"];
+  const rawMax = r["maxChars"] ?? r["max_chars"] ?? r["limit"];
+  const rawUseLlm = r["useLlm"] ?? r["use_llm"];
+  const rawMaxLlm = r["maxLlmChars"] ?? r["max_llm_chars"];
   return {
     enabled: r["enabled"] !== false,
-    changelogPaths: Array.isArray(r["changelogPaths"]) ? r["changelogPaths"].filter((x) => typeof x === "string") : DEFAULTS.changelogPaths,
-    maxChars: typeof r["maxChars"] === "number" && r["maxChars"] >= 1e3 && r["maxChars"] <= 1e6 ? r["maxChars"] : DEFAULTS.maxChars,
-    useLlm: r["useLlm"] === true,
-    maxLlmChars: typeof r["maxLlmChars"] === "number" && r["maxLlmChars"] >= 1e3 && r["maxLlmChars"] <= 1e5 ? r["maxLlmChars"] : DEFAULTS.maxLlmChars
+    changelogPaths: Array.isArray(rawPaths) ? rawPaths.filter((x) => typeof x === "string") : DEFAULTS.changelogPaths,
+    maxChars: typeof rawMax === "number" && rawMax >= 1e3 && rawMax <= 1e6 ? rawMax : DEFAULTS.maxChars,
+    useLlm: rawUseLlm === true,
+    maxLlmChars: typeof rawMaxLlm === "number" && rawMaxLlm >= 1e3 && rawMaxLlm <= 1e5 ? rawMaxLlm : DEFAULTS.maxLlmChars
   };
 }
 function normalizeVersion(v) {
@@ -280,7 +284,8 @@ var plugin = {
       if (!cfg.enabled) return;
       if (input.toolResult?.isError) return;
       const inp = input.toolInput ?? {};
-      const path = inp["path"];
+      const rawPath = inp["path"] ?? inp["TargetFile"] ?? inp["filePath"] ?? inp["targetFile"] ?? inp["file_path"] ?? inp["file"];
+      const path = typeof rawPath === "string" ? rawPath : void 0;
       if (!path) return;
       const basename = path.split(/[/\\]/).pop() ?? "";
       if (!/^(package\.json|package-lock\.json|pnpm-lock\.yaml|yarn\.lock|bun\.lockb?)$/i.test(
@@ -305,14 +310,31 @@ var plugin = {
             type: "string",
             description: "Name of the npm package or framework."
           },
+          package: { type: "string", description: "Alias for packageName." },
+          pkg: { type: "string", description: "Alias for packageName." },
+          name: { type: "string", description: "Alias for packageName." },
+          package_name: { type: "string", description: "Alias for packageName." },
+          dependency: { type: "string", description: "Alias for packageName." },
+          dep: { type: "string", description: "Alias for packageName." },
+          module: { type: "string", description: "Alias for packageName." },
           fromVersion: {
             type: "string",
             description: 'Current version, e.g. "1.2.3".'
           },
+          from: { type: "string", description: "Alias for fromVersion." },
+          from_version: { type: "string", description: "Alias for fromVersion." },
+          currentVersion: { type: "string", description: "Alias for fromVersion." },
+          since: { type: "string", description: "Alias for fromVersion." },
+          start: { type: "string", description: "Alias for fromVersion." },
           toVersion: {
             type: "string",
             description: 'Target version, e.g. "2.0.0".'
           },
+          to: { type: "string", description: "Alias for toVersion." },
+          to_version: { type: "string", description: "Alias for toVersion." },
+          targetVersion: { type: "string", description: "Alias for toVersion." },
+          until: { type: "string", description: "Alias for toVersion." },
+          end: { type: "string", description: "Alias for toVersion." },
           scope: {
             type: "string",
             description: "Optional scope describing which parts of the project use the package."
@@ -320,9 +342,51 @@ var plugin = {
           use_llm: {
             type: "boolean",
             description: "Add evidence-bounded Council risk analysis with One Shot fallback. Overrides useLlm for this call."
-          }
+          },
+          useLlm: { type: "boolean", description: "Alias for use_llm." },
+          use_ai: { type: "boolean", description: "Alias for use_llm." },
+          useAi: { type: "boolean", description: "Alias for use_llm." }
         },
-        required: ["packageName", "fromVersion", "toVersion"]
+        // One name from each required field group must be sufficient for
+        // raw-schema validation. Note: the tool-wire flattener strips
+        // top-level combinators (docs/tool-author-guide.md), so wire-level
+        // guidance loses these required markers by design — the executor
+        // remains the authoritative validator and reports missing canonical
+        // fields with a clear error.
+        allOf: [
+          {
+            anyOf: [
+              { required: ["packageName"] },
+              { required: ["package"] },
+              { required: ["pkg"] },
+              { required: ["name"] },
+              { required: ["package_name"] },
+              { required: ["dependency"] },
+              { required: ["dep"] },
+              { required: ["module"] }
+            ]
+          },
+          {
+            anyOf: [
+              { required: ["fromVersion"] },
+              { required: ["from"] },
+              { required: ["from_version"] },
+              { required: ["currentVersion"] },
+              { required: ["since"] },
+              { required: ["start"] }
+            ]
+          },
+          {
+            anyOf: [
+              { required: ["toVersion"] },
+              { required: ["to"] },
+              { required: ["to_version"] },
+              { required: ["targetVersion"] },
+              { required: ["until"] },
+              { required: ["end"] }
+            ]
+          }
+        ]
       },
       permission: "auto",
       category: "Planning",
@@ -330,9 +394,14 @@ var plugin = {
       async execute(input, _ctx, execOpts) {
         if (!cfg.enabled) return { ok: false, error: "migration-planner is disabled" };
         execOpts?.signal?.throwIfAborted();
-        const packageName = String(input.packageName ?? "").trim();
-        const fromVersion = String(input.fromVersion ?? "").trim();
-        const toVersion = String(input.toVersion ?? "").trim();
+        const raw = input ?? {};
+        const rawPackage = input.packageName || raw["package"] || raw["pkg"] || raw["name"] || raw["package_name"] || raw["packageName"] || raw["dependency"] || raw["dep"] || raw["module"];
+        const rawFrom = input.fromVersion || raw["from"] || raw["from_version"] || raw["fromVersion"] || raw["currentVersion"] || raw["since"] || raw["start"];
+        const rawTo = input.toVersion || raw["to"] || raw["to_version"] || raw["toVersion"] || raw["targetVersion"] || raw["until"] || raw["end"];
+        const rawUseLlm = input.use_llm ?? raw["useLlm"] ?? raw["use_ai"] ?? raw["useAi"];
+        const packageName = String(rawPackage ?? "").trim();
+        const fromVersion = String(rawFrom ?? "").trim();
+        const toVersion = String(rawTo ?? "").trim();
         if (!packageName || !fromVersion || !toVersion) {
           return { ok: false, error: "packageName, fromVersion, and toVersion are required" };
         }
@@ -357,7 +426,7 @@ var plugin = {
           evidence = `No local changelog was found for ${packageName}.`;
         }
         execOpts?.signal?.throwIfAborted();
-        const requested = input.use_llm ?? cfg.useLlm;
+        const requested = typeof rawUseLlm === "boolean" ? rawUseLlm : cfg.useLlm;
         const llm = await runOptionalPluginCouncil({
           requested,
           api,