eminiar 0.13.4 → 0.13.5

package/dist/server.js

@@ -7256,8 +7256,8 @@ var require_dist = __commonJS({
         return ajv;
       }
       const [formats, exportName] = opts.mode === "fast" ? [formats_1.fastFormats, fastName] : [formats_1.fullFormats, fullName];
-      const list2 = opts.formats || formats_1.formatNames;
-      addFormats(ajv, list2, formats, exportName);
+      const list3 = opts.formats || formats_1.formatNames;
+      addFormats(ajv, list3, formats, exportName);
       if (opts.keywords)
         (0, limit_1.default)(ajv);
       return ajv;
@@ -7269,11 +7269,11 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list2, fs, exportName) {
+    function addFormats(ajv, list3, fs, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
-      for (const f of list2)
+      for (const f of list3)
         ajv.addFormat(f, fs[f]);
     }
     module.exports = exports = formatsPlugin;
@@ -10441,9 +10441,9 @@ var require_micromatch = __commonJS({
       const index = v.indexOf("{");
       return index > -1 && v.indexOf("}", index) > -1;
     };
-    var micromatch2 = (list2, patterns, options) => {
+    var micromatch2 = (list3, patterns, options) => {
       patterns = [].concat(patterns);
-      list2 = [].concat(list2);
+      list3 = [].concat(list3);
       let omit2 = /* @__PURE__ */ new Set();
       let keep = /* @__PURE__ */ new Set();
       let items = /* @__PURE__ */ new Set();
@@ -10458,7 +10458,7 @@ var require_micromatch = __commonJS({
         let isMatch = picomatch(String(patterns[i]), { ...options, onResult }, true);
         let negated = isMatch.state.negated || isMatch.state.negatedExtglob;
         if (negated) negatives++;
-        for (let item of list2) {
+        for (let item of list3) {
           let matched = isMatch(item, true);
           let match = negated ? !matched.isMatch : matched.isMatch;
           if (!match) continue;
@@ -10486,7 +10486,7 @@ var require_micromatch = __commonJS({
     micromatch2.matcher = (pattern2, options) => picomatch(pattern2, options);
     micromatch2.isMatch = (str4, patterns, options) => picomatch(patterns, options)(str4);
     micromatch2.any = micromatch2.isMatch;
-    micromatch2.not = (list2, patterns, options = {}) => {
+    micromatch2.not = (list3, patterns, options = {}) => {
       patterns = [].concat(patterns).map(String);
       let result = /* @__PURE__ */ new Set();
       let items = [];
@@ -10494,7 +10494,7 @@ var require_micromatch = __commonJS({
         if (options.onResult) options.onResult(state);
         items.push(state.output);
       };
-      let matches2 = new Set(micromatch2(list2, patterns, { ...options, onResult }));
+      let matches2 = new Set(micromatch2(list3, patterns, { ...options, onResult }));
       for (let item of items) {
         if (!matches2.has(item)) {
           result.add(item);
@@ -10528,8 +10528,8 @@ var require_micromatch = __commonJS({
       for (let key of keys) res[key] = obj[key];
       return res;
     };
-    micromatch2.some = (list2, patterns, options) => {
-      let items = [].concat(list2);
+    micromatch2.some = (list3, patterns, options) => {
+      let items = [].concat(list3);
       for (let pattern2 of [].concat(patterns)) {
         let isMatch = picomatch(String(pattern2), options);
         if (items.some((item) => isMatch(item))) {
@@ -10538,8 +10538,8 @@ var require_micromatch = __commonJS({
       }
       return false;
     };
-    micromatch2.every = (list2, patterns, options) => {
-      let items = [].concat(list2);
+    micromatch2.every = (list3, patterns, options) => {
+      let items = [].concat(list3);
       for (let pattern2 of [].concat(patterns)) {
         let isMatch = picomatch(String(pattern2), options);
         if (!items.every((item) => isMatch(item))) {
@@ -15445,15 +15445,15 @@ var ZodObject = class _ZodObject extends ZodType {
       });
     }
     if (this._def.catchall instanceof ZodNever) {
-      const unknownKeys = this._def.unknownKeys;
-      if (unknownKeys === "passthrough") {
+      const unknownKeys2 = this._def.unknownKeys;
+      if (unknownKeys2 === "passthrough") {
         for (const key of extraKeys) {
           pairs.push({
             key: { status: "valid", value: key },
             value: { status: "valid", value: ctx.data[key] }
           });
         }
-      } else if (unknownKeys === "strict") {
+      } else if (unknownKeys2 === "strict") {
         if (extraKeys.length > 0) {
           addIssueToContext(ctx, {
             code: ZodIssueCode.unrecognized_keys,
@@ -15461,7 +15461,7 @@ var ZodObject = class _ZodObject extends ZodType {
           });
           status.dirty();
         }
-      } else if (unknownKeys === "strip") {
+      } else if (unknownKeys2 === "strip") {
       } else {
         throw new Error(`Internal ZodObject error: invalid unknownKeys value.`);
       }
@@ -33067,8 +33067,8 @@ var contributors = {
 function aggregateChecks(schema2) {
   const agg = {};
   const def = schema2._zod.def;
-  const list2 = schema2._zod.traits.has("$ZodCheck") ? [schema2, ...def.checks ?? []] : def.checks ?? [];
-  for (const ch of list2)
+  const list3 = schema2._zod.traits.has("$ZodCheck") ? [schema2, ...def.checks ?? []] : def.checks ?? [];
+  for (const ch of list3)
     contributors[ch._zod.def.check]?.(agg, ch._zod.def);
   const bag = schema2._zod.bag;
   if (bag.minimum !== void 0)
@@ -44222,8 +44222,8 @@ function parseRouteAnnotations(doc) {
     const body = m[1] ?? "";
     const path3 = /^\s*"([^"]*)"/.exec(body)?.[1] ?? /\bpath\s*=\s*"([^"]*)"/.exec(body)?.[1];
     if (path3 === void 0) continue;
-    const list2 = /\bmethods\s*=\s*(\{[^}]*\}|"[^"]*")/.exec(body)?.[1] ?? "";
-    const methods = [...list2.matchAll(/"([^"]+)"/g)].map((x) => httpMethod(x[1])).filter((x) => !!x);
+    const list3 = /\bmethods\s*=\s*(\{[^}]*\}|"[^"]*")/.exec(body)?.[1] ?? "";
+    const methods = [...list3.matchAll(/"([^"]+)"/g)].map((x) => httpMethod(x[1])).filter((x) => !!x);
     for (const method of methods.length ? methods : ["ALL"]) out.push({ method, path: path3 });
   }
   return out;
@@ -45037,16 +45037,16 @@ function phpString(n) {
   return literalText(n)?.replace(/\\(\\|')/g, "$1");
 }
 function argsOf(call) {
-  const list2 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
-  return (list2?.namedChildren ?? []).filter((a) => a?.type === "argument").map((a) => a.namedChildren[a.namedChildren.length - 1]).filter((a) => !!a);
+  const list3 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
+  return (list3?.namedChildren ?? []).filter((a) => a?.type === "argument").map((a) => a.namedChildren[a.namedChildren.length - 1]).filter((a) => !!a);
 }
 function positionalArgs(call) {
-  const list2 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
-  return (list2?.namedChildren ?? []).filter((a) => a?.type === "argument" && !a.childForFieldName("name")).map((a) => a.namedChildren[0]).filter((a) => !!a);
+  const list3 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
+  return (list3?.namedChildren ?? []).filter((a) => a?.type === "argument" && !a.childForFieldName("name")).map((a) => a.namedChildren[0]).filter((a) => !!a);
 }
 function namedArg(call, name) {
-  const list2 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
-  for (const a of list2?.namedChildren ?? []) {
+  const list3 = call.childForFieldName("arguments") ?? call.childForFieldName("parameters");
+  for (const a of list3?.namedChildren ?? []) {
     if (a?.type === "argument" && a.childForFieldName("name")?.text === name)
       return a.namedChildren[a.namedChildren.length - 1] ?? void 0;
   }
@@ -48137,9 +48137,9 @@ function computeMetrics(db) {
   for (const s of symbols) {
     const f = s.path ? `file:${s.path}` : void 0;
     if (!f) continue;
-    const list2 = symbolsByFile.get(f) ?? [];
-    list2.push(s);
-    symbolsByFile.set(f, list2);
+    const list3 = symbolsByFile.get(f) ?? [];
+    list3.push(s);
+    symbolsByFile.set(f, list3);
   }
   for (const f of files) {
     const m = meta3(f);
@@ -48192,9 +48192,9 @@ function computeMetrics(db) {
   const members2 = /* @__PURE__ */ new Map();
   for (const r of fileRows) {
     if (r.cluster === null) continue;
-    const list2 = members2.get(r.cluster) ?? [];
-    list2.push(r);
-    members2.set(r.cluster, list2);
+    const list3 = members2.get(r.cluster) ?? [];
+    list3.push(r);
+    members2.set(r.cluster, list3);
   }
   const links = /* @__PURE__ */ new Map();
   for (const e of importEdges) {
@@ -55822,11 +55822,11 @@ function createOpenAIProvider(r, cfg, deps = {}) {
   };
 }
 function mapAnswers(reqs, items, raw, cat, askTool) {
-  const list2 = raw && typeof raw === "object" && Array.isArray(raw.items) ? raw.items : void 0;
-  if (!list2) throw new ProviderError("invalid", "the answer has no items array");
+  const list3 = raw && typeof raw === "object" && Array.isArray(raw.items) ? raw.items : void 0;
+  if (!list3) throw new ProviderError("invalid", "the answer has no items array");
   const Item = itemSchema(cat, askTool);
   const byId = /* @__PURE__ */ new Map();
-  for (const x of list2) {
+  for (const x of list3) {
     const p2 = Item.safeParse(x);
     if (p2.success && !byId.has(p2.data.id)) byId.set(p2.data.id, p2.data);
   }
@@ -57175,8 +57175,8 @@ function pricedSavings(stats, calls, overrides, opts = {}) {
   };
   const bySession2 = /* @__PURE__ */ new Map();
   for (const c of calls) {
-    const list2 = bySession2.get(c.session_id);
-    if (list2) list2.push(c);
+    const list3 = bySession2.get(c.session_id);
+    if (list3) list3.push(c);
     else bySession2.set(c.session_id, [c]);
   }
   const sessionModel = /* @__PURE__ */ new Map();
@@ -57348,29 +57348,29 @@ function promptWindows(prompts, calls) {
   const bySession2 = /* @__PURE__ */ new Map();
   for (const p2 of prompts) {
     if (!p2.sessionId) continue;
-    const list2 = bySession2.get(p2.sessionId);
-    if (list2) list2.push(p2);
+    const list3 = bySession2.get(p2.sessionId);
+    if (list3) list3.push(p2);
     else bySession2.set(p2.sessionId, [p2]);
   }
-  for (const list2 of bySession2.values()) list2.sort((a, b) => a.ts - b.ts || a.id - b.id);
+  for (const list3 of bySession2.values()) list3.sort((a, b) => a.ts - b.ts || a.id - b.id);
   const out = /* @__PURE__ */ new Map();
   for (const p2 of prompts) out.set(p2.id, []);
   for (const c of calls) {
     if (c.sidechain) continue;
-    const list2 = bySession2.get(c.session_id);
-    if (!list2) continue;
+    const list3 = bySession2.get(c.session_id);
+    if (!list3) continue;
     let lo = 0;
-    let hi = list2.length - 1;
+    let hi = list3.length - 1;
     let at = -1;
     while (lo <= hi) {
       const mid = lo + hi >> 1;
-      if (list2[mid].ts <= c.ts) {
+      if (list3[mid].ts <= c.ts) {
         at = mid;
         lo = mid + 1;
       } else hi = mid - 1;
     }
     if (at < 0) continue;
-    out.get(list2[at].id)?.push(c);
+    out.get(list3[at].id)?.push(c);
   }
   return out;
 }
@@ -57719,8 +57719,8 @@ var Reconciler = class {
       const m = /* @__PURE__ */ new Map();
       for (const p2 of allRows(this.db, { surface: "prompt", since })) {
         if (!p2.sessionId) continue;
-        const list2 = m.get(p2.sessionId);
-        if (list2) list2.push(p2);
+        const list3 = m.get(p2.sessionId);
+        if (list3) list3.push(p2);
         else m.set(p2.sessionId, [p2]);
       }
       this.promptsBySession = m;
@@ -57746,8 +57746,8 @@ var Reconciler = class {
     const bySession2 = /* @__PURE__ */ new Map();
     for (const r of targets) {
       if (r.agentId || !r.sessionId) continue;
-      const list2 = bySession2.get(r.sessionId);
-      if (list2) list2.push(r);
+      const list3 = bySession2.get(r.sessionId);
+      if (list3) list3.push(r);
       else bySession2.set(r.sessionId, [r]);
     }
     if (!bySession2.size) return;
@@ -57765,8 +57765,8 @@ var Reconciler = class {
       const callsBy = /* @__PURE__ */ new Map();
       for (const c of this.calls(sessionId)) {
         if (!c.sidechain || !c.agent_id || this.taken.has(c.agent_id)) continue;
-        const list2 = callsBy.get(c.agent_id);
-        if (list2) list2.push(c);
+        const list3 = callsBy.get(c.agent_id);
+        if (list3) list3.push(c);
         else callsBy.set(c.agent_id, [c]);
       }
       const agents = [...callsBy].map(([id, cs]) => ({
@@ -58880,6 +58880,70 @@ function existingGenerated(dir) {
   }
   return out;
 }
+function ignoredWhere(ignored, config2, agentType) {
+  const hit = config2.swarms.flatMap(
+    (swarm) => swarm.roles.filter((r) => r.agentType === agentType).map((r) => ({ swarm, role: r }))
+  )[0];
+  if (!hit) return [];
+  const out = [];
+  for (const i of ignored) {
+    const seg = i.path === "" ? [] : i.path.split(".");
+    const name = /"(.+?)"/.exec(i.message)?.[1] ?? "?";
+    const mine = seg[0] !== "swarms" || seg.length < 2 || seg[1] === hit.swarm.name && (seg.length < 4 || seg[2] !== "agents" || seg[3] === hit.role.role);
+    if (mine) out.push(name);
+  }
+  return out;
+}
+var list2 = (v) => typeof v === "string" ? v.split(",").map((x) => x.trim()).filter(Boolean) : [];
+function frontmatterOf(raw) {
+  const content = raw.replace(/\r\n/g, "\n");
+  const end = content.indexOf("\n---\n", 3);
+  if (!content.startsWith("---\n") || end === -1) return void 0;
+  try {
+    const v = yaml().parse(content.slice(4, end));
+    return v && typeof v === "object" ? v : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var NEUTRAL_KEYS = /* @__PURE__ */ new Set(["name", "description", "skills", "color", "model", "effort"]);
+function tightens(oldRaw, newRaw) {
+  const o = frontmatterOf(oldRaw);
+  const n = frontmatterOf(newRaw);
+  if (!o || !n) return false;
+  let tighter = false;
+  for (const k of Object.keys(o)) {
+    if (NEUTRAL_KEYS.has(k)) continue;
+    if (!(k in n)) return false;
+    const a = o[k];
+    const b = n[k];
+    if (JSON.stringify(a) === JSON.stringify(b)) continue;
+    if (k === "tools") {
+      const ob = new Set(list2(a));
+      const nb = list2(b);
+      if (!nb.every((t) => ob.has(t))) return false;
+      tighter = true;
+    } else if (k === "disallowedTools") {
+      const nb = new Set(list2(b));
+      if (!list2(a).every((t) => nb.has(t))) return false;
+      tighter = true;
+    } else if (k === "hooks") {
+      const oh = a ?? {};
+      const nh = b ?? {};
+      for (const [ev3, entries] of Object.entries(oh)) {
+        const have = new Set((nh[ev3] ?? []).map((e) => JSON.stringify(e)));
+        if (!Array.isArray(entries) || !entries.every((e) => have.has(JSON.stringify(e))))
+          return false;
+      }
+      tighter = true;
+    } else if (k === "maxTurns") {
+      if (typeof a !== "number" || typeof b !== "number" || b > a) return false;
+      tighter = true;
+    } else return false;
+  }
+  for (const k of Object.keys(n)) if (!(k in o) && !NEUTRAL_KEYS.has(k)) tighter = true;
+  return tighter;
+}
 function planAgentSync(root, config2, opts = {}) {
   const dir = agentsDir(root);
   const wantedRoles = config2?.enabled ? config2.swarms.flatMap((swarm) => swarm.roles.map((role) => ({ swarm, role }))) : [];
@@ -58947,6 +59011,24 @@ function planAgentSync(root, config2, opts = {}) {
           reason: config2?.enabled ? "no longer in the swarm file" : "swarms are disabled"
         }
       );
+  const ignored = config2?.ignoredKeys ?? [];
+  if (ignored.length && !opts.force) {
+    const holds = (agentType) => ignoredWhere(ignored, config2, agentType);
+    return actions.map((a) => {
+      if (a.action !== "update") return a;
+      const where = holds(a.agentType);
+      if (!where.length) return a;
+      const old = generated.get(a.agentType);
+      if (old && tightens(old.content, a.content ?? "")) return a;
+      return {
+        agentType: a.agentType,
+        path: a.path,
+        action: "conflict",
+        held: true,
+        reason: `kept: ${config2.rel} has keys this eminiar version does not know (${where.slice(0, 3).join(", ")}${where.length > 3 ? ", ..." : ""}), and a newer one may have generated this file with them; update eminiar, or sync with --force`
+      };
+    });
+  }
   return actions;
 }
 function syncAgents(root, config2, opts = {}) {
@@ -59188,8 +59270,8 @@ function manifest(dir) {
 }
 function agentPaths(dir) {
   const a = manifest(dir)?.agents;
-  const list2 = typeof a === "string" ? [a] : Array.isArray(a) ? a.filter((x) => typeof x === "string") : [];
-  return (list2.length ? list2 : ["./agents"]).map((p2) => resolve8(dir, p2));
+  const list3 = typeof a === "string" ? [a] : Array.isArray(a) ? a.filter((x) => typeof x === "string") : [];
+  return (list3.length ? list3 : ["./agents"]).map((p2) => resolve8(dir, p2));
 }
 function pluginDefs(segments, env, home) {
   const [plugin, ...rest] = segments;
@@ -59577,6 +59659,52 @@ import { existsSync as existsSync11, readFileSync as readFileSync13 } from "fs";
 import { createRequire as createRequire2 } from "module";
 import { join as join17 } from "path";
 
+// src/search/typo.ts
+init_esm_shims();
+function editDistance(a, b, max = 3) {
+  if (Math.abs(a.length - b.length) > max) return max + 1;
+  const prev2 = [];
+  let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+  let cur = new Array(b.length + 1).fill(0);
+  for (let i = 1; i <= a.length; i++) {
+    cur[0] = i;
+    let rowMin = cur[0];
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      let v = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+        v = Math.min(v, prev2[j - 2] + 1);
+      }
+      cur[j] = v;
+      if (v < rowMin) rowMin = v;
+    }
+    if (rowMin > max) return max + 1;
+    prev2.splice(0, prev2.length, ...prev);
+    [prev, cur] = [cur, prev];
+  }
+  return prev[b.length];
+}
+function correctTerms(db, terms) {
+  const corrections = [];
+  const out = terms.map((term) => {
+    if (term.length < 4 || /[^a-z0-9]/.test(term) || db.termExists(term)) return term;
+    const max = term.length >= 7 ? 2 : 1;
+    const candidates2 = db.vocabCandidates(term[0], 3e3);
+    let best;
+    for (const c of candidates2) {
+      if (c.term.length < 3) continue;
+      const d = editDistance(term, c.term, max);
+      if (d > max) continue;
+      if (!best || d < best.d || d === best.d && c.df > best.df)
+        best = { term: c.term, d, df: c.df };
+    }
+    if (!best) return term;
+    corrections.push({ from: term, to: best.term });
+    return `${best.term}*`;
+  });
+  return { terms: out, corrections };
+}
+
 // src/swarm/glob.ts
 init_esm_shims();
 var MAX_EXPANSIONS = 64;
@@ -59756,15 +59884,6 @@ var NAME_MSG = "use 1-32 characters: lowercase letters and digits in words joine
 var noFence = (s) => !s.includes("---");
 var FENCE_MSG = 'must not contain "---" (Claude Code would end the agent frontmatter there)';
 var MODEL_RE = /^(?:inherit|opusplan|(?:sonnet|opus|haiku|fable)(?:\[1m\])?|(?:[a-z0-9-]+\.)*claude-[a-z0-9.:@-]+(?:\[1m\])?)$/;
-var TOP_KEYS = /* @__PURE__ */ new Set([
-  "version",
-  "enabled",
-  "sync",
-  "enforce",
-  "allowed_agents",
-  "defaults",
-  "swarms"
-]);
 var DEFAULT_CONTEXT = {
   memories: 4,
   docs: 2,
@@ -59793,7 +59912,7 @@ var SkillName = external_exports.string().regex(
 ).refine(noFence, FENCE_MSG);
 var Model = external_exports.string().max(100).regex(MODEL_RE, "a model alias (inherit, sonnet, opus, haiku, fable) or a Claude model id").refine(noFence, FENCE_MSG);
 var rank = (t) => TIERS.indexOf(t);
-var RawModelRange = external_exports.strictObject({ floor: external_exports.enum(TIERS).optional(), ceiling: external_exports.enum(TIERS).optional() }).refine(
+var RawModelRange = external_exports.object({ floor: external_exports.enum(TIERS).optional(), ceiling: external_exports.enum(TIERS).optional() }).refine(
   (r) => !r.floor || !r.ceiling || rank(r.floor) <= rank(r.ceiling),
   `floor must not be above ceiling (${TIERS.join(" < ")})`
 );
@@ -59817,7 +59936,7 @@ var AgentName = external_exports.string().trim().regex(
   (n) => !n.startsWith("swarm-"),
   "swarm workers need no entry: they are allowed during a run of their swarm"
 );
-var RawContext = external_exports.strictObject({
+var RawContext = external_exports.object({
   memories: external_exports.number().int().min(0).max(10).optional(),
   docs: external_exports.number().int().min(0).max(10).optional(),
   history: external_exports.boolean().optional(),
@@ -59826,12 +59945,12 @@ var RawContext = external_exports.strictObject({
   // SubagentStart context over 10,000 characters is moved to a file Claude may never read.
   max_chars: external_exports.number().int().min(500).max(9e3).optional()
 });
-var RawHookCommand = external_exports.strictObject({
+var RawHookCommand = external_exports.object({
   type: external_exports.literal("command"),
   command: external_exports.string().trim().min(1).max(2e3).refine(noFence, FENCE_MSG),
   timeout: external_exports.number().int().positive().max(600).optional()
 });
-var RawHookMatcher = external_exports.strictObject({
+var RawHookMatcher = external_exports.object({
   matcher: external_exports.string().max(200).refine(noFence, FENCE_MSG).refine((m) => {
     try {
       new RegExp(m);
@@ -59842,12 +59961,12 @@ var RawHookMatcher = external_exports.strictObject({
   }, "not a valid regular expression (Claude Code matches tool names with it)").optional(),
   hooks: external_exports.array(RawHookCommand).min(1).max(10)
 });
-var RawHooks = external_exports.strictObject({
+var RawHooks = external_exports.object({
   PreToolUse: external_exports.array(RawHookMatcher).max(10).optional(),
   PostToolUse: external_exports.array(RawHookMatcher).max(10).optional(),
   Stop: external_exports.array(RawHookMatcher).max(10).optional()
 });
-var RawAgent = external_exports.strictObject({
+var RawAgent = external_exports.object({
   description: external_exports.string().trim().min(1).max(500).refine(noFence, FENCE_MSG),
   prompt: external_exports.string().max(2e4).optional(),
   model: Model.optional(),
@@ -59865,7 +59984,7 @@ var RawAgent = external_exports.strictObject({
   color: external_exports.enum(AGENT_COLORS).optional(),
   context: RawContext.optional()
 });
-var RawSwarm = external_exports.strictObject({
+var RawSwarm = external_exports.object({
   description: external_exports.string().trim().min(1).max(500),
   topology: external_exports.enum(TOPOLOGIES).optional(),
   max_agents: external_exports.number().int().min(1).max(16).optional(),
@@ -59881,7 +60000,7 @@ var RawFile = external_exports.looseObject({
   sync: external_exports.enum(["auto", "manual"]).optional(),
   enforce: external_exports.boolean().optional(),
   allowed_agents: external_exports.array(AgentName).max(50).optional(),
-  defaults: external_exports.strictObject({
+  defaults: external_exports.object({
     model: Model.optional(),
     model_range: RawModelRange.optional(),
     skills: external_exports.array(SkillName).max(20).optional(),
@@ -59906,6 +60025,53 @@ function mergeContext(...layers) {
   return out;
 }
 var uniq = (xs) => [...new Set(xs)];
+function unknownKeys(v, s = RawFile, at = []) {
+  if (s instanceof external_exports.ZodOptional) s = s.unwrap();
+  if (Array.isArray(v))
+    return s instanceof external_exports.ZodArray ? v.flatMap((x, i) => unknownKeys(x, s.element, [...at, String(i)])) : [];
+  if (!v || typeof v !== "object") return [];
+  const entries = Object.entries(v);
+  if (s instanceof external_exports.ZodRecord)
+    return entries.flatMap(([k, x]) => unknownKeys(x, s.valueType, [...at, k]));
+  if (!(s instanceof external_exports.ZodObject)) return [];
+  const known = Object.keys(s.shape);
+  return entries.flatMap(
+    ([k, x]) => Object.hasOwn(s.shape, k) ? unknownKeys(x, s.shape[k], [...at, k]) : at.length === 0 && (k.startsWith("x-") || k === "<<") ? [] : [{ at, key: k, known }]
+  );
+}
+function schemaKeys(s = RawFile, out = /* @__PURE__ */ new Set()) {
+  if (s instanceof external_exports.ZodOptional) s = s.unwrap();
+  if (s instanceof external_exports.ZodArray) schemaKeys(s.element, out);
+  else if (s instanceof external_exports.ZodRecord) schemaKeys(s.valueType, out);
+  else if (s instanceof external_exports.ZodObject) {
+    for (const [k, v] of Object.entries(s.shape))
+      if (!out.has(k)) {
+        out.add(k);
+        schemaKeys(v, out);
+      }
+  }
+  return out;
+}
+var RESTRICTION_KEY = /tool|scope|hook|allow|deny|permission|model|effort|count/i;
+function restrictionLike(key, known) {
+  let best;
+  for (const k of known) {
+    if (!RESTRICTION_KEY.test(k)) continue;
+    const d = editDistance(key.toLowerCase(), k.toLowerCase(), 2);
+    if (d <= 2 && key.length >= 3 && (!best || d < best.d)) best = { k, d };
+  }
+  if (best) return best.k;
+  return RESTRICTION_KEY.test(key) ? "" : void 0;
+}
+function typoOf(key, known) {
+  const max = key.length >= 7 ? 2 : 1;
+  let best;
+  for (const k of known) {
+    const d = editDistance(key.toLowerCase(), k.toLowerCase(), max);
+    if (d <= max && (!best || d < best.d)) best = { k, d };
+  }
+  return best?.k;
+}
 function roleRange(defaults, a, at, issue2) {
   const spec = a.model_range ?? defaults?.model_range;
   if (!spec || !spec.floor && !spec.ceiling) return void 0;
@@ -60041,6 +60207,27 @@ function parseSwarmYaml(text2, file3, rel) {
         for (const role of Object.keys(agents))
           checkName(["swarms", name, "agents", role], role, "agent");
     }
+  const ignoredKeys = [];
+  const allKeys = schemaKeys();
+  for (const u of unknownKeys(js)) {
+    const near = typoOf(u.key, u.known);
+    const found = { path: u.at.join("."), line: lineOf([...u.at, u.key]) };
+    if (allKeys.has(u.key))
+      issues.push({ ...found, message: `unknown key "${u.key}": not allowed here` });
+    else if (near)
+      issues.push({ ...found, message: `unknown key "${u.key}" (did you mean "${near}"?)` });
+    else if (u.at.length === 4 && u.at[0] === "swarms" && u.at[2] === "agents" && restrictionLike(u.key, u.known) !== void 0) {
+      const like = restrictionLike(u.key, u.known);
+      issues.push({
+        ...found,
+        message: `unknown key "${u.key}" looks like a restriction${like ? ` (did you mean "${like}"?)` : ""}: ignoring it would silently drop a limit`
+      });
+    } else
+      ignoredKeys.push({
+        ...found,
+        message: `unknown key "${u.key}" ignored: not a setting in this eminiar version`
+      });
+  }
   const parsed = RawFile.safeParse(js);
   if (!parsed.success) {
     return {
@@ -60058,15 +60245,9 @@ function parseSwarmYaml(text2, file3, rel) {
       ]
     };
   }
-  for (const k of Object.keys(js))
-    if (!TOP_KEYS.has(k) && !k.startsWith("x-") && k !== "<<")
-      issue2(
-        [k],
-        `unknown key "${k}" (top-level keys: ${[...TOP_KEYS].join(", ")}; x-* keys may hold YAML anchors)`
-      );
   const config2 = resolve9(parsed.data, file3, rel, issue2);
   if (issues.length) return { state: "invalid", file: file3, rel, enforce, issues };
-  return { state: "ok", config: config2 };
+  return { state: "ok", config: { ...config2, ignoredKeys } };
 }
 function resolve9(raw, file3, rel, issue2) {
   const swarms = [];
@@ -60796,6 +60977,7 @@ function formatSwarmList(config2, plan, active, opts = {}) {
   const lines = [
     `eminiar swarms \xB7 ${config2.rel} \xB7 sync ${config2.sync}${enforceNote(config2)} \xB7 agent files: ${fileSummary || "none"}`
   ];
+  if (config2.ignoredKeys.length) lines.push(formatIssues(config2.rel, config2.ignoredKeys));
   if (opts.swarm && !swarms.length)
     lines.push(
       `No swarm "${opts.swarm}"; ${config2.rel} defines: ${config2.swarms.map((s) => s.name).join(", ")}`
@@ -60861,6 +61043,11 @@ function formatSync(result, opts = {}) {
       `  ${SYNC_VERB[a.action].mark} ${word(a.action)} ${a.path}${a.reason ? `: ${a.reason}` : ""}`
     );
   }
+  const held = result.actions.filter((a) => a.held).length;
+  if (held)
+    lines.push(
+      `${held} update(s) held: the swarm file has keys this eminiar version does not know, so those agent files were not rewritten (an update that only tightens a file still applies). Update eminiar, or run \`eminiar swarm sync --force\`.`
+    );
   if (!opts.dryRun && result.actions.some((a) => a.action === "create"))
     lines.push(
       "Claude Code reads agent files when a session starts: if a new worker type is not available yet, open /agents or restart the session."
@@ -61308,8 +61495,8 @@ function groupBy(calls, keyFn) {
     if (!isRealCall(c)) continue;
     const k = keyFn(c);
     if (k == null) continue;
-    const list2 = buckets.get(k);
-    if (list2) list2.push(c);
+    const list3 = buckets.get(k);
+    if (list3) list3.push(c);
     else buckets.set(k, [c]);
   }
   return [...buckets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, rows]) => ({ key, totals: totals(rows) }));
@@ -62006,18 +62193,18 @@ function threads(calls) {
   const out = /* @__PURE__ */ new Map();
   for (const c of calls) {
     const key = `${c.session_id}\0${c.sidechain ? c.agent_id ?? "sidechain" : ""}`;
-    const list2 = out.get(key);
-    if (list2) list2.push(c);
+    const list3 = out.get(key);
+    if (list3) list3.push(c);
     else out.set(key, [c]);
   }
-  for (const list2 of out.values()) list2.sort((a, b) => a.ts - b.ts);
+  for (const list3 of out.values()) list3.sort((a, b) => a.ts - b.ts);
   return out;
 }
 function groupBySession(rows) {
   const out = /* @__PURE__ */ new Map();
   for (const r of rows) {
-    const list2 = out.get(r.session_id);
-    if (list2) list2.push(r);
+    const list3 = out.get(r.session_id);
+    if (list3) list3.push(r);
     else out.set(r.session_id, [r]);
   }
   return out;
@@ -62049,9 +62236,9 @@ function withScope(base, sessionIds) {
 }
 var SEVERITY_RANK = { high: 0, warn: 1, info: 2 };
 function hasCompactionBetween(ctx, sessionId, from, to) {
-  const list2 = ctx.compactionsBySession.get(sessionId);
-  if (!list2) return false;
-  return list2.some((t) => t > from && t <= to);
+  const list3 = ctx.compactionsBySession.get(sessionId);
+  if (!list3) return false;
+  return list3.some((t) => t > from && t <= to);
 }
 function detectCacheThrash(ctx) {
   let runs = 0;
@@ -62059,7 +62246,7 @@ function detectCacheThrash(ctx) {
   let rewritten = 0;
   let savings = 0;
   const sessions = /* @__PURE__ */ new Set();
-  for (const list2 of ctx.threads.values()) {
+  for (const list3 of ctx.threads.values()) {
     let run = [];
     const flush = () => {
       if (run.length >= THRASH_RUN) {
@@ -62075,12 +62262,12 @@ function detectCacheThrash(ctx) {
       }
       run = [];
     };
-    for (let i = 1; i < list2.length; i++) {
-      const c = list2[i];
-      const prev = list2[i - 1];
+    for (let i = 1; i < list3.length; i++) {
+      const c = list3[i];
+      const prev = list3[i - 1];
       const ctxTokens = contextOf(c);
       const heavy = ctxTokens > 0 && writesOf(c) / ctxTokens >= THRASH_WRITE_SHARE;
-      const broken = hasCompactionBetween(ctx, c.session_id, prev.ts, c.ts) || c.ts - prev.ts > ttlFor(list2);
+      const broken = hasCompactionBetween(ctx, c.session_id, prev.ts, c.ts) || c.ts - prev.ts > ttlFor(list3);
       if (!heavy || broken) {
         flush();
         continue;
@@ -62103,10 +62290,10 @@ function detectCacheThrash(ctx) {
     sessions
   );
 }
-function ttlFor(list2) {
+function ttlFor(list3) {
   let w5 = 0;
   let w1 = 0;
-  for (const c of list2) {
+  for (const c of list3) {
     w5 += num4(c.cache_create_5m);
     w1 += num4(c.cache_create_1h);
   }
@@ -62118,11 +62305,11 @@ function detectCacheCold(ctx) {
   let savings = 0;
   let longestGap = 0;
   const sessions = /* @__PURE__ */ new Set();
-  for (const list2 of ctx.threads.values()) {
-    const ttl = ttlFor(list2);
-    for (let i = 1; i < list2.length; i++) {
-      const c = list2[i];
-      const prev = list2[i - 1];
+  for (const list3 of ctx.threads.values()) {
+    const ttl = ttlFor(list3);
+    for (let i = 1; i < list3.length; i++) {
+      const c = list3[i];
+      const prev = list3[i - 1];
       const gap = c.ts - prev.ts;
       if (gap <= ttl) continue;
       if (hasCompactionBetween(ctx, c.session_id, prev.ts, c.ts)) continue;
@@ -62398,15 +62585,15 @@ function detectErrorLoop(ctx) {
   const byThread = /* @__PURE__ */ new Map();
   for (const u of ctx.toolUses) {
     const key = `${u.session_id}\0${u.agent_id ?? ""}`;
-    const list2 = byThread.get(key);
-    if (list2) list2.push(u);
+    const list3 = byThread.get(key);
+    if (list3) list3.push(u);
     else byThread.set(key, [u]);
   }
-  for (const list2 of byThread.values()) {
-    list2.sort((a, b) => a.ts - b.ts);
+  for (const list3 of byThread.values()) {
+    list3.sort((a, b) => a.ts - b.ts);
     let run = 0;
     let tool = "";
-    for (const u of list2) {
+    for (const u of list3) {
       if (u.is_error && u.tool === tool) run += 1;
       else {
         run = u.is_error ? 1 : 0;
@@ -62644,11 +62831,11 @@ function detectInsights(input2) {
   const calls = input2.calls.filter(isRealCall);
   const compactionsBySession = /* @__PURE__ */ new Map();
   for (const e of input2.contextEvents) {
-    const list2 = compactionsBySession.get(e.session_id);
-    if (list2) list2.push(e.ts);
+    const list3 = compactionsBySession.get(e.session_id);
+    if (list3) list3.push(e.ts);
     else compactionsBySession.set(e.session_id, [e.ts]);
   }
-  for (const list2 of compactionsBySession.values()) list2.sort((a, b) => a - b);
+  for (const list3 of compactionsBySession.values()) list3.sort((a, b) => a - b);
   const callTs = /* @__PURE__ */ new Map();
   for (const [sid, rows] of groupBySession(calls))
     callTs.set(
@@ -62835,8 +63022,8 @@ function periods(calls, keyFn) {
   const buckets = /* @__PURE__ */ new Map();
   for (const c of calls) {
     const k = keyFn(c.ts);
-    const list2 = buckets.get(k);
-    if (list2) list2.push(c);
+    const list3 = buckets.get(k);
+    if (list3) list3.push(c);
     else buckets.set(k, [c]);
   }
   return [...buckets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, rows]) => ({ key, totals: totals(rows), models: modelSlices(rows) }));
@@ -62867,8 +63054,8 @@ function insightsFor(ctx, data) {
   return { insights: r.insights, scores: r.scores };
 }
 var SEVERITY_RANK2 = { high: 0, warn: 1, info: 2 };
-function sortInsights(list2) {
-  return list2.slice().sort(
+function sortInsights(list3) {
+  return list3.slice().sort(
     (a, b) => SEVERITY_RANK2[a.severity] - SEVERITY_RANK2[b.severity] || (b.estimatedSavingsUsd ?? 0) - (a.estimatedSavingsUsd ?? 0)
   );
 }
@@ -63603,10 +63790,10 @@ function impact(db, ref, opts = {}) {
       add3(e.dst, e.weight, 1, `co-changed ${meta4.count ?? "?"}\xD7 (${Math.round(e.weight * 100)}%)`);
     }
   }
-  const list2 = [...hits.values()].sort((a, b) => b.score - a.score);
-  const nodes = new Map(db.graphGetNodes(list2.map((h) => h.id)).map((n) => [n.id, n]));
-  for (const h of list2) h.node = nodes.get(h.id);
-  return { root, hits: list2 };
+  const list3 = [...hits.values()].sort((a, b) => b.score - a.score);
+  const nodes = new Map(db.graphGetNodes(list3.map((h) => h.id)).map((n) => [n.id, n]));
+  for (const h of list3) h.node = nodes.get(h.id);
+  return { root, hits: list3 };
 }
 function dependencies(db, ref, depth = 1) {
   const root = resolveNode(db, ref);
@@ -63633,10 +63820,10 @@ function dependencies(db, ref, depth = 1) {
     frontier = next;
     if (!frontier.length) break;
   }
-  const list2 = [...hits.values()].sort((a, b) => b.score - a.score);
-  const nodes = new Map(db.graphGetNodes(list2.map((h) => h.id)).map((n) => [n.id, n]));
-  for (const h of list2) h.node = nodes.get(h.id);
-  return { root, hits: list2 };
+  const list3 = [...hits.values()].sort((a, b) => b.score - a.score);
+  const nodes = new Map(db.graphGetNodes(list3.map((h) => h.id)).map((n) => [n.id, n]));
+  for (const h of list3) h.node = nodes.get(h.id);
+  return { root, hits: list3 };
 }
 function neighbors(db, ref, depth = 1, kinds) {
   const root = resolveNode(db, ref);
@@ -64447,10 +64634,10 @@ function loadPermissionRules(root, extraDeny = []) {
   const hit = cache5.get(key);
   if (hit?.stamps.every((s, i) => s === stamps[i])) return hit.rules;
   const out = { allow: [], deny: [], ask: [], root };
-  const push = (list2, raws) => {
+  const push = (list3, raws) => {
     for (const raw of raws ?? []) {
       const r = parseRule(raw);
-      if (r) list2.push(r);
+      if (r) list3.push(r);
     }
   };
   for (const f of files) {
@@ -65541,19 +65728,19 @@ function mergedCatalog(extra) {
 function catalogLookup(kind, key, catalog = CATALOG) {
   const k = key.trim();
   for (const e of catalog) {
-    const list2 = kind === "api" ? e.hosts : e[kind];
-    if (!list2) continue;
+    const list3 = kind === "api" ? e.hosts : e[kind];
+    if (!list3) continue;
     if (kind === "env") {
-      if (list2.some((p2) => envMatches(p2, k))) return e;
+      if (list3.some((p2) => envMatches(p2, k))) return e;
     } else if (kind === "api") {
       const host = k.toLowerCase();
-      if (list2.some((h) => host === h || host.endsWith(`.${h}`))) return e;
+      if (list3.some((h) => host === h || host.endsWith(`.${h}`))) return e;
     } else if (kind === "image") {
       const bare = k.split(":")[0].replace(/^docker\.io\/(library\/)?/, "");
-      if (list2.some((p2) => matches(p2, bare))) return e;
+      if (list3.some((p2) => matches(p2, bare))) return e;
     } else if (kind === "go") {
-      if (list2.some((p2) => k === p2 || k.startsWith(p2))) return e;
-    } else if (list2.some((p2) => matches(p2, k))) return e;
+      if (list3.some((p2) => k === p2 || k.startsWith(p2))) return e;
+    } else if (list3.some((p2) => matches(p2, k))) return e;
   }
   return void 0;
 }
@@ -65935,9 +66122,9 @@ function schemaSummary(doc, schema2, depth = 0) {
   if (Array.isArray(s.enum))
     return `enum(${s.enum.slice(0, 8).map(String).join(", ")}${s.enum.length > 8 ? ", \u2026" : ""})`;
   for (const k of ["oneOf", "anyOf", "allOf"]) {
-    const list2 = s[k];
-    if (Array.isArray(list2))
-      return `${k}<${list2.slice(0, 4).map((x) => schemaSummary(doc, x, depth + 1)).join(" | ")}>`;
+    const list3 = s[k];
+    if (Array.isArray(list3))
+      return `${k}<${list3.slice(0, 4).map((x) => schemaSummary(doc, x, depth + 1)).join(" | ")}>`;
   }
   if (type === "array" || s.items) return `${schemaSummary(doc, s.items, depth + 1) || "any"}[]`;
   if (type === "object" || isObj2(s.properties)) {
@@ -66100,9 +66287,9 @@ function postmanBody(body) {
     const lang = isObj2(body.options) && isObj2(body.options.raw) ? String(body.options.raw.language ?? "json") : "json";
     return raw.length > 2e3 ? [`Body (${lang}): ${raw.slice(0, 2e3)}\u2026`] : ["Body:", "", `\`\`\`${lang}`, raw, "```"];
   }
-  const list2 = body[mode];
-  if (Array.isArray(list2)) {
-    const keys = list2.filter(isObj2).map(
+  const list3 = body[mode];
+  if (Array.isArray(list3)) {
+    const keys = list3.filter(isObj2).map(
       (e) => `${String(e.key)}${e.type && e.type !== "text" ? ` (${String(e.type)})` : ""}${e.description ? ` \u2014 ${clip4(e.description, 100)}` : ""}`
     );
     return keys.length ? [`Body (${mode}): ${keys.join(", ")}`] : [];
@@ -67467,52 +67654,6 @@ function snippet(body, terms, opts = {}) {
   }).join("\n\u22EF\n");
 }
 
-// src/search/typo.ts
-init_esm_shims();
-function editDistance(a, b, max = 3) {
-  if (Math.abs(a.length - b.length) > max) return max + 1;
-  const prev2 = [];
-  let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
-  let cur = new Array(b.length + 1).fill(0);
-  for (let i = 1; i <= a.length; i++) {
-    cur[0] = i;
-    let rowMin = cur[0];
-    for (let j = 1; j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      let v = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + cost);
-      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-        v = Math.min(v, prev2[j - 2] + 1);
-      }
-      cur[j] = v;
-      if (v < rowMin) rowMin = v;
-    }
-    if (rowMin > max) return max + 1;
-    prev2.splice(0, prev2.length, ...prev);
-    [prev, cur] = [cur, prev];
-  }
-  return prev[b.length];
-}
-function correctTerms(db, terms) {
-  const corrections = [];
-  const out = terms.map((term) => {
-    if (term.length < 4 || /[^a-z0-9]/.test(term) || db.termExists(term)) return term;
-    const max = term.length >= 7 ? 2 : 1;
-    const candidates2 = db.vocabCandidates(term[0], 3e3);
-    let best;
-    for (const c of candidates2) {
-      if (c.term.length < 3) continue;
-      const d = editDistance(term, c.term, max);
-      if (d > max) continue;
-      if (!best || d < best.d || d === best.d && c.df > best.df)
-        best = { term: c.term, d, df: c.df };
-    }
-    if (!best) return term;
-    corrections.push({ from: term, to: best.term });
-    return `${best.term}*`;
-  });
-  return { terms: out, corrections };
-}
-
 // src/search/pipeline.ts
 var WEIGHTS = { porter: 1, trigram: 0.7, vector: 1 };
 function lexical(db, terms, phrases, filters, n) {
@@ -68107,9 +68248,9 @@ function envSignals(dir, project, catalog) {
       }
       const token = name.split("_")[0];
       if (token.length < 3 || GENERIC_ENV.has(token)) continue;
-      const list2 = unknownPrefixes.get(token) ?? [];
-      if (!list2.includes(name)) list2.push(name);
-      unknownPrefixes.set(token, list2);
+      const list3 = unknownPrefixes.get(token) ?? [];
+      if (!list3.includes(name)) list3.push(name);
+      unknownPrefixes.set(token, list3);
     }
   }
   return { signals, unknownPrefixes };
@@ -68561,15 +68702,15 @@ function discoverDocs(ctx, opts = {}) {
     );
     for (const hit of api.hits.values()) {
       if (inSubproject(hit.samples)) continue;
-      const list2 = apiHits.get(hit.host) ?? [];
-      list2.push(hit);
-      apiHits.set(hit.host, list2);
+      const list3 = apiHits.get(hit.host) ?? [];
+      list3.push(hit);
+      apiHits.set(hit.host, list3);
     }
     for (const link of api.docLinks.values()) {
       if (inSubproject(link.samples)) continue;
-      const list2 = docLinks.get(link.host) ?? [];
-      list2.push(link);
-      docLinks.set(link.host, list2);
+      const list3 = docLinks.get(link.host) ?? [];
+      list3.push(link);
+      docLinks.set(link.host, list3);
     }
     const env = envSignals(dir, project, catalog);
     signals.push(...env.signals);
@@ -68659,12 +68800,12 @@ function discoverDocs(ctx, opts = {}) {
         evidence: `${info.vars.slice(0, 4).join(", ")}${info.vars.length > 4 ? ", \u2026" : ""}`
       });
   }
-  for (const [host, list2] of apiHits) {
-    const calls = list2.reduce((n, h) => n + h.calls, 0);
+  for (const [host, list3] of apiHits) {
+    const calls = list3.reduce((n, h) => n + h.calls, 0);
     if (!calls) continue;
     const entry = catalogLookup("api", host, catalog);
-    const specUrls = [...new Set(list2.flatMap((h) => h.specUrls))];
-    for (const h of list2) {
+    const specUrls = [...new Set(list3.flatMap((h) => h.specUrls))];
+    for (const h of list3) {
       if (!h.calls) continue;
       const evidence = `api:${host} (${h.samples.slice(0, 2).join(", ")})${specUrls.length ? ` \xB7 spec ${specUrls[0]}` : ""}`;
       if (entry) {
@@ -68697,10 +68838,10 @@ function discoverDocs(ctx, opts = {}) {
       }
     }
   }
-  for (const [host, list2] of docLinks) {
-    const urls = [...new Set(list2.flatMap((l) => l.urls))].slice(0, 3);
+  for (const [host, list3] of docLinks) {
+    const urls = [...new Set(list3.flatMap((l) => l.urls))].slice(0, 3);
     const entry = catalogLookup("api", host, catalog);
-    for (const l of list2) {
+    for (const l of list3) {
       const evidence = `link:${host} (${l.samples.slice(0, 2).join(", ")})`;
       if (entry) {
         add3({
@@ -68875,7 +69016,7 @@ function rootOf(host) {
 function docGuesses(host) {
   const h = host.toLowerCase();
   const root = rootOf(h);
-  const list2 = [
+  const list3 = [
     `https://docs.${root}/`,
     `https://developer.${root}/`,
     `https://developers.${root}/`,
@@ -68893,7 +69034,7 @@ function docGuesses(host) {
     `https://${h}/openapi.json`,
     `https://${h}/swagger.json`
   ];
-  return [...new Set(list2)];
+  return [...new Set(list3)];
 }
 async function probe2(url2, opts) {
   const f = opts.fetchImpl ?? fetch;
@@ -69288,16 +69429,16 @@ function formatDiscovery(d, max = 40) {
     ]
   ];
   for (const [conf, title, note, wants] of groups) {
-    const list2 = d.providers.filter(wants);
-    if (!list2.length) continue;
-    lines.push("", `${title} (${list2.length}; ${note}):`);
-    for (const p2 of list2.slice(0, max)) {
+    const list3 = d.providers.filter(wants);
+    if (!list3.length) continue;
+    lines.push("", `${title} (${list3.length}; ${note}):`);
+    for (const p2 of list3.slice(0, max)) {
       const used = p2.usedBy.length > 1 ? ` \xB7 used by ${p2.usedBy.length} projects` : p2.usedBy[0] && p2.usedBy[0] !== "." ? ` \xB7 ${p2.usedBy[0]}` : "";
       const where = p2.urls[0] ? ` \xB7 ${p2.urls[0]}` : "";
       const ev3 = conf === "probe" || conf === "unknown" ? ` \xB7 ${p2.evidence[0]}` : "";
       lines.push(`- ${p2.name} \u2190 ${p2.provider}${used}${where}${ev3}${reg(p2.registered)}`);
     }
-    if (list2.length > max) lines.push(`  \u2026 ${list2.length - max} more`);
+    if (list3.length > max) lines.push(`  \u2026 ${list3.length - max} more`);
   }
   const rec = d.local.filter((c) => !c.registered).length + d.providers.filter(
     (p2) => !p2.registered && (p2.confidence === "probe" || p2.confidence === "catalog" && (p2.tier ?? "library") === "service")
@@ -70303,21 +70444,21 @@ function detectChanges(db, root, opts = {}) {
   }
   const byFile = /* @__PURE__ */ new Map();
   for (const h of hunks) {
-    const list2 = byFile.get(h.path) ?? [];
-    list2.push(h);
-    byFile.set(h.path, list2);
+    const list3 = byFile.get(h.path) ?? [];
+    list3.push(h);
+    byFile.set(h.path, list3);
   }
   const symbols = /* @__PURE__ */ new Map();
   const files = [];
   const unindexed = [];
-  for (const [path3, list2] of byFile) {
+  for (const [path3, list3] of byFile) {
     const indexed = !!db.graphGetNode(fileId(path3));
-    files.push({ path: path3, hunks: list2.length, indexed });
+    files.push({ path: path3, hunks: list3.length, indexed });
     if (!indexed) {
       unindexed.push(path3);
       continue;
     }
-    for (const [id, s] of symbolsAt(db, path3, list2)) symbols.set(id, s);
+    for (const [id, s] of symbolsAt(db, path3, list3)) symbols.set(id, s);
   }
   const ids = [...symbols.keys()];
   const metrics = new Map(db.metricsGet(ids).map((m) => [m.node_id, m]));
@@ -72444,7 +72585,9 @@ var schema = {
   remember: external_exports.boolean().optional().describe("finish: keep the outcome as an eminiar memory"),
   agent: external_exports.string().optional().describe("release: worker agent id (a prefix is enough)"),
   role: external_exports.string().optional().describe("release: every running worker of this role"),
-  force: external_exports.boolean().optional().describe("sync: also overwrite generated agent files that were edited by hand"),
+  force: external_exports.boolean().optional().describe(
+    "sync: also overwrite generated agent files that were edited by hand, and write them while the swarm file has keys this eminiar does not know"
+  ),
   caller_kind: external_exports.string().optional().describe(HOOK_FIELD),
   caller_agent_id: external_exports.string().optional().describe(HOOK_FIELD),
   caller_agent_type: external_exports.string().optional().describe(HOOK_FIELD),
@@ -72633,9 +72776,9 @@ async function dispatch(args, callerCtx) {
     case "list": {
       const plan = planAgentSync(ctx.root, config2);
       const active = listItems(db, db.swarm.runs({ status: "active", limit: 10 }));
-      const list2 = formatSwarmList(config2, plan, active, { swarm: args.swarm, sessionId });
+      const list3 = formatSwarmList(config2, plan, active, { swarm: args.swarm, sessionId });
       return who.unverified !== void 0 ? `${unstampedNote(who.unverified)}
-${list2}` : list2;
+${list3}` : list3;
     }
     case "start": {
       if (!args.swarm)
@@ -72692,7 +72835,7 @@ ${list2}` : list2;
       if (ctx.config.adjudicator?.enabled && ctx.config.adjudicator.surfaces.plan) {
         const unavailable = "Adjudicator advice unavailable for this plan (the tasks are planned).";
         try {
-          const list2 = await adjudicatePlan(ctx, db, run, swarm, rows, {
+          const list3 = await adjudicatePlan(ctx, db, run, swarm, rows, {
             sessionId,
             log: (line) => process.stderr.write(`eminiar: ${line}
 `),
@@ -72700,8 +72843,8 @@ ${list2}` : list2;
               adviceNote = unavailable;
             }
           });
-          advice = planAdviceBlock(list2);
-          adviceHint = planNextHint(list2);
+          advice = planAdviceBlock(list3);
+          adviceHint = planNextHint(list3);
         } catch (err) {
           process.stderr.write(
             `eminiar: adjudicator plan advice skipped: ${err?.message ?? String(err)}