eminiar 0.13.4 → 0.13.5

package/dist/cli.js

@@ -16309,8 +16309,8 @@ var init_to_json_schema = __esm({
 function aggregateChecks(schema) {
   const agg = {};
   const def = schema._zod.def;
-  const list2 = schema._zod.traits.has("$ZodCheck") ? [schema, ...def.checks ?? []] : def.checks ?? [];
-  for (const ch of list2)
+  const list3 = schema._zod.traits.has("$ZodCheck") ? [schema, ...def.checks ?? []] : def.checks ?? [];
+  for (const ch of list3)
     contributors[ch._zod.def.check]?.(agg, ch._zod.def);
   const bag = schema._zod.bag;
   if (bag.minimum !== void 0)
@@ -24758,6 +24758,57 @@ var init_storage = __esm({
   }
 });
 
+// src/search/typo.ts
+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 };
+}
+var init_typo = __esm({
+  "src/search/typo.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
 // src/swarm/glob.ts
 function normalize(g) {
   let s = g.trim().replace(/\\/g, "/");
@@ -24893,6 +24944,52 @@ function mergeContext(...layers) {
   }
   return out;
 }
+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;
+}
+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;
@@ -25028,6 +25125,27 @@ function parseSwarmYaml(text3, 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 {
@@ -25045,15 +25163,9 @@ function parseSwarmYaml(text3, 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 = resolve3(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 resolve3(raw, file3, rel, issue2) {
   const swarms = [];
@@ -25174,13 +25286,14 @@ function findRole(config2, agentType) {
     for (const role of swarm.roles) if (role.agentType === agentType) return { swarm, role };
   return void 0;
 }
-var yamlLib, SWARM_FILES, AGENT_NAME_MAX, NAME_RE, NAME_MAX, NAME_MSG, noFence, FENCE_MSG, MODEL_RE, TOP_KEYS, DEFAULT_CONTEXT, AGENT_COLORS, ToolName, SkillName, Model, rank, RawModelRange, Glob, AgentName, RawContext, RawHookCommand, RawHookMatcher, RawHooks, RawAgent, RawSwarm, RawFile, uniq, MAX_FILE_CHARS, cache3, STARTER_YAML;
+var yamlLib, SWARM_FILES, AGENT_NAME_MAX, NAME_RE, NAME_MAX, NAME_MSG, noFence, FENCE_MSG, MODEL_RE, DEFAULT_CONTEXT, AGENT_COLORS, ToolName, SkillName, Model, rank, RawModelRange, Glob, AgentName, RawContext, RawHookCommand, RawHookMatcher, RawHooks, RawAgent, RawSwarm, RawFile, uniq, RESTRICTION_KEY, MAX_FILE_CHARS, cache3, STARTER_YAML;
 var init_config2 = __esm({
   "src/swarm/config.ts"() {
     "use strict";
     init_esm_shims();
     init_zod();
     init_types();
+    init_typo();
     init_dispatch();
     init_glob();
     init_types2();
@@ -25192,15 +25305,6 @@ var init_config2 = __esm({
     noFence = (s) => !s.includes("---");
     FENCE_MSG = 'must not contain "---" (Claude Code would end the agent frontmatter there)';
     MODEL_RE = /^(?:inherit|opusplan|(?:sonnet|opus|haiku|fable)(?:\[1m\])?|(?:[a-z0-9-]+\.)*claude-[a-z0-9.:@-]+(?:\[1m\])?)$/;
-    TOP_KEYS = /* @__PURE__ */ new Set([
-      "version",
-      "enabled",
-      "sync",
-      "enforce",
-      "allowed_agents",
-      "defaults",
-      "swarms"
-    ]);
     DEFAULT_CONTEXT = {
       memories: 4,
       docs: 2,
@@ -25229,7 +25333,7 @@ var init_config2 = __esm({
     ).refine(noFence, FENCE_MSG);
     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);
     rank = (t) => TIERS.indexOf(t);
-    RawModelRange = external_exports.strictObject({ floor: external_exports.enum(TIERS).optional(), ceiling: external_exports.enum(TIERS).optional() }).refine(
+    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(" < ")})`
     );
@@ -25253,7 +25357,7 @@ var init_config2 = __esm({
       (n) => !n.startsWith("swarm-"),
       "swarm workers need no entry: they are allowed during a run of their swarm"
     );
-    RawContext = external_exports.strictObject({
+    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(),
@@ -25262,12 +25366,12 @@ var init_config2 = __esm({
       // 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()
     });
-    RawHookCommand = external_exports.strictObject({
+    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()
     });
-    RawHookMatcher = external_exports.strictObject({
+    RawHookMatcher = external_exports.object({
       matcher: external_exports.string().max(200).refine(noFence, FENCE_MSG).refine((m) => {
         try {
           new RegExp(m);
@@ -25278,12 +25382,12 @@ var init_config2 = __esm({
       }, "not a valid regular expression (Claude Code matches tool names with it)").optional(),
       hooks: external_exports.array(RawHookCommand).min(1).max(10)
     });
-    RawHooks = external_exports.strictObject({
+    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()
     });
-    RawAgent = external_exports.strictObject({
+    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(),
@@ -25301,7 +25405,7 @@ var init_config2 = __esm({
       color: external_exports.enum(AGENT_COLORS).optional(),
       context: RawContext.optional()
     });
-    RawSwarm = external_exports.strictObject({
+    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(),
@@ -25317,7 +25421,7 @@ var init_config2 = __esm({
       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(),
@@ -25326,6 +25430,7 @@ var init_config2 = __esm({
       swarms: external_exports.record(external_exports.string(), RawSwarm)
     });
     uniq = (xs) => [...new Set(xs)];
+    RESTRICTION_KEY = /tool|scope|hook|allow|deny|permission|model|effort|count/i;
     MAX_FILE_CHARS = 256e3;
     cache3 = /* @__PURE__ */ new Map();
     STARTER_YAML = `# eminiar agent swarms (opt-in). Docs: https://github.com/rydn/eminiar/blob/main/docs/swarms.md
@@ -25838,9 +25943,9 @@ function consentedOrigins(a) {
   return out;
 }
 function withConsentedOrigin(a, origin) {
-  const list2 = consentedOrigins(a);
-  if (!list2.includes(origin)) list2.push(origin);
-  return list2;
+  const list3 = consentedOrigins(a);
+  if (!list3.includes(origin)) list3.push(origin);
+  return list3;
 }
 function isLoopback(url2) {
   if (!url2) return false;
@@ -28012,11 +28117,11 @@ function createOpenAIProvider(r, cfg, deps = {}) {
   };
 }
 function mapAnswers(reqs, items2, 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);
   }
@@ -29437,8 +29542,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();
@@ -29597,29 +29702,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;
 }
@@ -30223,8 +30328,8 @@ var init_learn = __esm({
           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;
@@ -30250,8 +30355,8 @@ var init_learn = __esm({
         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;
@@ -30269,8 +30374,8 @@ var init_learn = __esm({
           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]) => ({
@@ -31235,6 +31340,68 @@ 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;
+}
+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 = yaml2().parse(content.slice(4, end));
+    return v && typeof v === "object" ? v : void 0;
+  } catch {
+    return void 0;
+  }
+}
+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(list(a));
+      const nb = list(b);
+      if (!nb.every((t) => ob.has(t))) return false;
+      tighter = true;
+    } else if (k === "disallowedTools") {
+      const nb = new Set(list(b));
+      if (!list(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 }))) : [];
@@ -31302,6 +31469,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 = {}) {
@@ -31343,7 +31528,7 @@ function syncAgents(root, config2, opts = {}) {
   }
   return { actions, changed, conflicts: actions.filter((a) => a.action === "conflict").length };
 }
-var MARKER_PREFIX, HASH_RE, RANGE_RE, WORKER_EM_TOOLS, yamlLib2, EXEC_TOOLS, EM_MCP_PREFIXES, AGENTS_REL, TOPOLOGY_RULE, execToolNames, hashOf, SHARED_TREE_RULE;
+var MARKER_PREFIX, HASH_RE, RANGE_RE, WORKER_EM_TOOLS, yamlLib2, EXEC_TOOLS, EM_MCP_PREFIXES, AGENTS_REL, TOPOLOGY_RULE, execToolNames, hashOf, SHARED_TREE_RULE, list, NEUTRAL_KEYS;
 var init_agents = __esm({
   "src/swarm/agents.ts"() {
     "use strict";
@@ -31387,6 +31572,8 @@ ${fm}
 ${rest2}` : `${fm}
 ${rest2}`).digest("hex").slice(0, 12);
     SHARED_TREE_RULE = "Other workers may be editing this working tree at the same time, and their changes are not committed. Never run `git stash`, `git checkout`, `git switch`, `git reset`, `git restore` or `git clean`, not even on one path: they hide or wipe another worker's work. If you commit, add only the files you changed: `git add -A` or `git commit -a` takes their unfinished work with yours. To test without your change (a mutation check), copy the files into a scratch directory outside the tree and run the tests there.";
+    list = (v) => typeof v === "string" ? v.split(",").map((x) => x.trim()).filter(Boolean) : [];
+    NEUTRAL_KEYS = /* @__PURE__ */ new Set(["name", "description", "skills", "color", "model", "effort"]);
   }
 });
 
@@ -31579,8 +31766,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) => resolve4(dir, p2));
+  const list3 = typeof a === "string" ? [a] : Array.isArray(a) ? a.filter((x) => typeof x === "string") : [];
+  return (list3.length ? list3 : ["./agents"]).map((p2) => resolve4(dir, p2));
 }
 function pluginDefs(segments, env, home) {
   const [plugin, ...rest2] = segments;
@@ -34881,9 +35068,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 items2 = /* @__PURE__ */ new Set();
@@ -34898,7 +35085,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;
@@ -34926,7 +35113,7 @@ var require_micromatch = __commonJS({
     micromatch2.matcher = (pattern2, options) => picomatch(pattern2, options);
     micromatch2.isMatch = (str3, patterns, options) => picomatch(patterns, options)(str3);
     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 items2 = [];
@@ -34934,7 +35121,7 @@ var require_micromatch = __commonJS({
         if (options.onResult) options.onResult(state);
         items2.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 items2) {
         if (!matches2.has(item)) {
           result.add(item);
@@ -34968,8 +35155,8 @@ var require_micromatch = __commonJS({
       for (let key of keys) res[key] = obj[key];
       return res;
     };
-    micromatch2.some = (list2, patterns, options) => {
-      let items2 = [].concat(list2);
+    micromatch2.some = (list3, patterns, options) => {
+      let items2 = [].concat(list3);
       for (let pattern2 of [].concat(patterns)) {
         let isMatch = picomatch(String(pattern2), options);
         if (items2.some((item) => isMatch(item))) {
@@ -34978,8 +35165,8 @@ var require_micromatch = __commonJS({
       }
       return false;
     };
-    micromatch2.every = (list2, patterns, options) => {
-      let items2 = [].concat(list2);
+    micromatch2.every = (list3, patterns, options) => {
+      let items2 = [].concat(list3);
       for (let pattern2 of [].concat(patterns)) {
         let isMatch = picomatch(String(pattern2), options);
         if (!items2.every((item) => isMatch(item))) {
@@ -38860,7 +39047,7 @@ function read(ctx, db, name) {
     row: synced.row
   };
 }
-function list(ctx, db, opts = {}) {
+function list2(ctx, db, opts = {}) {
   void ctx;
   const rows = db.memoryList({ ...opts, limit: opts.limit ?? 100 }).filter((r) => r.name);
   return rows.sort((a, b) => Number(b.kind === "onboarding") - Number(a.kind === "onboarding"));
@@ -39286,6 +39473,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(", ")}`
@@ -39344,6 +39532,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."
@@ -39871,8 +40064,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) }));
@@ -40573,18 +40766,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;
@@ -40615,9 +40808,9 @@ function withScope(base, sessionIds) {
   return out;
 }
 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;
@@ -40625,7 +40818,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 run3 = [];
     const flush = () => {
       if (run3.length >= THRASH_RUN) {
@@ -40641,12 +40834,12 @@ function detectCacheThrash(ctx) {
       }
       run3 = [];
     };
-    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;
@@ -40669,10 +40862,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 += num3(c.cache_create_5m);
     w1 += num3(c.cache_create_1h);
   }
@@ -40684,11 +40877,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;
@@ -40950,15 +41143,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 run3 = 0;
     let tool = "";
-    for (const u of list2) {
+    for (const u of list3) {
       if (u.is_error && u.tool === tool) run3 += 1;
       else {
         run3 = u.is_error ? 1 : 0;
@@ -41192,11 +41385,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(
@@ -41450,8 +41643,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) }));
@@ -41481,8 +41674,8 @@ function insightsFor(ctx, data) {
   const r = detectInsights(input2);
   return { insights: r.insights, scores: r.scores };
 }
-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)
   );
 }
@@ -42576,11 +42769,11 @@ import { readFile } from "fs/promises";
 import { basename as basename5, extname as extname2, resolve as resolvePath } from "path";
 import { pathToFileURL } from "url";
 function parseFixture(raw, source = "fixture") {
-  const list2 = Array.isArray(raw) || !raw || typeof raw !== "object" ? raw : raw.items;
-  if (!Array.isArray(list2))
+  const list3 = Array.isArray(raw) || !raw || typeof raw !== "object" ? raw : raw.items;
+  if (!Array.isArray(list3))
     throw new EvalFixtureError(`${source}: expected an array of items or {"items": [...]}`);
-  if (!list2.length) throw new EvalFixtureError(`${source}: the fixture has no items`);
-  return list2.map((it, i) => {
+  if (!list3.length) throw new EvalFixtureError(`${source}: the fixture has no items`);
+  return list3.map((it, i) => {
     const r = ItemSchema.safeParse(it);
     if (!r.success) {
       const issue2 = r.error.issues[0];
@@ -43473,10 +43666,10 @@ function personalConsent() {
   try {
     const a = readRaw(paths().configFile).adjudicator;
     if (!isObj2(a)) return { remoteConsent: false };
-    const list2 = a.remoteConsentOrigins;
+    const list3 = a.remoteConsentOrigins;
     return {
       remoteConsent: a.remoteConsent === true,
-      ...Array.isArray(list2) ? { remoteConsentOrigins: list2.filter((s) => typeof s === "string") } : {}
+      ...Array.isArray(list3) ? { remoteConsentOrigins: list3.filter((s) => typeof s === "string") } : {}
     };
   } catch {
     return { remoteConsent: false };
@@ -43490,8 +43683,8 @@ function mustAsk(r, previous) {
 function consentPatch(r, asked) {
   if (!r.configuredRemote || !r.origin) return {};
   if (!asked && r.consentVia !== "legacy") return {};
-  const list2 = withConsentedOrigin(personalConsent(), r.origin);
-  return { remoteConsent: true, remoteConsentOrigins: list2 };
+  const list3 = withConsentedOrigin(personalConsent(), r.origin);
+  return { remoteConsent: true, remoteConsentOrigins: list3 };
 }
 function personalOrigin(root) {
   try {
@@ -45439,8 +45632,8 @@ function registerSettings(stable) {
   const hooks = settings.hooks ?? {};
   const hookCmd = `"${join21(stable, "bin", "em-hook")}"`;
   for (const ev3 of HOOK_EVENTS) {
-    const list2 = hooks[ev3] ?? [];
-    const filtered = list2.filter(
+    const list3 = hooks[ev3] ?? [];
+    const filtered = list3.filter(
       (entry2) => !(entry2.hooks ?? []).some((h) => isOurs(h.command, stable))
     );
     const entry = {
@@ -45480,9 +45673,9 @@ function unregisterSettings(stable, wrote) {
     const settings = readJson2(settingsPath());
     const hooks = settings.hooks ?? {};
     for (const ev3 of wrote.hookEvents) {
-      const list2 = hooks[ev3];
-      if (!list2) continue;
-      const kept = list2.filter(
+      const list3 = hooks[ev3];
+      if (!list3) continue;
+      const kept = list3.filter(
         (entry) => !(entry.hooks ?? []).some((h) => isOurs(h.command, stable))
       );
       if (kept.length) hooks[ev3] = kept;
@@ -45574,13 +45767,13 @@ function registerCursor(stable) {
   const hooks = cfg.hooks ?? {};
   const command = cursorHookCommand(stable);
   for (const ev3 of CURSOR_HOOK_EVENTS) {
-    const list2 = (Array.isArray(hooks[ev3]) ? hooks[ev3] : []).filter(
+    const list3 = (Array.isArray(hooks[ev3]) ? hooks[ev3] : []).filter(
       (h) => !isOurs(h.command, stable)
     );
     const entry = { command, timeout: TIMEOUTS[ev3] ?? 5 };
     if (ev3 === "preToolUse") entry.matcher = CURSOR_PRE_TOOL_MATCHER;
-    list2.push(entry);
-    hooks[ev3] = list2;
+    list3.push(entry);
+    hooks[ev3] = list3;
   }
   cfg.hooks = hooks;
   writeJsonWithBackup(cursorHooksPath(), cfg);
@@ -46439,8 +46632,8 @@ function findContextMode() {
   const settings = readJson2(settingsPath());
   const hooks = settings.hooks ?? {};
   const hookEntries = [];
-  for (const [event, list2] of Object.entries(hooks)) {
-    for (const entry of list2) {
+  for (const [event, list3] of Object.entries(hooks)) {
+    for (const entry of list3) {
       for (const h of entry.hooks ?? []) {
         if (typeof h.command === "string" && CM_HOOK.test(h.command))
           hookEntries.push({ event, command: h.command });
@@ -46485,8 +46678,8 @@ async function replaceContextMode(opts) {
   if (f.hookEntries.length) {
     const settings = readJson2(settingsPath());
     const hooks = settings.hooks ?? {};
-    for (const [event, list2] of Object.entries(hooks)) {
-      const kept = list2.map((entry) => ({
+    for (const [event, list3] of Object.entries(hooks)) {
+      const kept = list3.map((entry) => ({
         ...entry,
         hooks: (entry.hooks ?? []).filter(
           (h) => !(typeof h.command === "string" && CM_HOOK.test(h.command))
@@ -46752,10 +46945,10 @@ function loadPermissionRules(root, extraDeny = []) {
   const hit = cache4.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) {
@@ -47080,57 +47273,6 @@ var init_snippets = __esm({
   }
 });
 
-// src/search/typo.ts
-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 };
-}
-var init_typo = __esm({
-  "src/search/typo.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
 // src/search/pipeline.ts
 var pipeline_exports = {};
 __export(pipeline_exports, {
@@ -47405,19 +47547,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;
 }
@@ -48827,9 +48969,9 @@ function schemaSummary(doc, schema, 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" || isObj3(s.properties)) {
@@ -48991,9 +49133,9 @@ function postmanBody(body) {
     const lang = isObj3(body.options) && isObj3(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(isObj3).map(
+  const list3 = body[mode];
+  if (Array.isArray(list3)) {
+    const keys = list3.filter(isObj3).map(
       (e) => `${String(e.key)}${e.type && e.type !== "text" ? ` (${String(e.type)})` : ""}${e.description ? ` \u2014 ${clip5(e.description, 100)}` : ""}`
     );
     return keys.length ? [`Body (${mode}): ${keys.join(", ")}`] : [];
@@ -49584,9 +49726,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);
@@ -49639,9 +49781,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) {
@@ -49800,10 +49942,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);
@@ -49830,10 +49972,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);
@@ -50334,8 +50476,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;
@@ -51136,16 +51278,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;
   }
@@ -54479,21 +54621,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]));
@@ -54733,7 +54875,7 @@ function architecture(ctx, db, aspects = ASPECTS) {
     hotspots: want.has("hotspots") ? hotspots(db, 12) : [],
     clusters: want.has("clusters") ? readClusters(db) : [],
     cycles: want.has("cycles") ? readCycles(db) : [],
-    decisions: want.has("decisions") ? list(ctx, db, { kind: "decision", limit: 50 }).filter((r) => (r.status ?? "accepted") === "accepted").map((r) => ({
+    decisions: want.has("decisions") ? list2(ctx, db, { kind: "decision", limit: 50 }).filter((r) => (r.status ?? "accepted") === "accepted").map((r) => ({
       name: r.name ?? "",
       title: r.content.split("\n")[0]?.replace(/^#+\s*/, "").slice(0, 120) ?? "",
       status: r.status ?? "accepted",
@@ -55111,9 +55253,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 };
@@ -55438,15 +55580,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);
@@ -55536,12 +55678,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) {
@@ -55574,10 +55716,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({
@@ -56025,7 +56167,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}/`,
@@ -56043,7 +56185,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;
@@ -56470,16 +56612,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")
@@ -58599,7 +58741,7 @@ var init_em_memory = __esm({
               return text(`${args.name} is now ${args.status}`);
             }
             case "list": {
-              const rows = list(ctx, db, {
+              const rows = list2(ctx, db, {
                 topic: args.topic,
                 kind: args.kind,
                 status: args.status,
@@ -58697,7 +58839,7 @@ var init_em_recall = __esm({
         const limit = args.limit ?? 8;
         const lines = [];
         if (!args.query) {
-          const rows = list(ctx, db, { kind: args.kind, topic: args.topic, limit });
+          const rows = list2(ctx, db, { kind: args.kind, topic: args.topic, limit });
           if (!rows.length)
             return text(
               "no memories yet; use em_remember to record decisions and constraints (or /eminiar:em-onboard to write the onboarding set)"
@@ -60499,7 +60641,7 @@ async function searchPayload(ctx, q, mode, limit, source) {
 function memoriesPayload(ctx, opts = {}) {
   const db = getStorage(ctx);
   const summary = reconcile2(ctx, db);
-  const rows = list(ctx, db, {
+  const rows = list2(ctx, db, {
     kind: opts.kind,
     topic: opts.topic,
     status: opts.status,
@@ -61300,9 +61442,9 @@ function clustersPayload(ctx) {
   for (const m of db.metricsTop({ kind: "file", limit: 5e3 })) {
     if (m.cluster === null || !m.path) continue;
     const key = String(m.cluster);
-    const list2 = members2[key] ?? [];
-    list2.push({ path: m.path, score: m.score, fanIn: m.fan_in });
-    members2[key] = list2;
+    const list3 = members2[key] ?? [];
+    list3.push({ path: m.path, score: m.score, fanIn: m.fan_in });
+    members2[key] = list3;
   }
   return { clusters: readClusters(db), cycles: readCycles(db), members: members2 };
 }
@@ -61671,11 +61813,11 @@ function historyGraphPayload(ctx, limit) {
 function historyRiskPayload(ctx, paths2) {
   const m = model(ctx);
   if (!m) return NO_GIT;
-  const list2 = paths2?.length ? paths2 : workingTreeFiles(ctx.root);
+  const list3 = paths2?.length ? paths2 : workingTreeFiles(ctx.root);
   return {
     git: true,
     source: paths2?.length ? "paths" : "working tree",
-    files: list2.map((p2) => {
+    files: list3.map((p2) => {
       const clean3 = p2.replace(/^\.\//, "");
       const h = m.files.get(clean3);
       const commits = commitsForFile(m, clean3);
@@ -62477,7 +62619,16 @@ function readSwarmDoc(root) {
   const { file: file3, rel, exists } = swarmFile(root);
   const base = { file: file3, rel };
   if (!exists)
-    return { ...base, state: "absent", text: null, hash: null, doc: null, issues: [], locked: [] };
+    return {
+      ...base,
+      state: "absent",
+      text: null,
+      hash: null,
+      doc: null,
+      issues: [],
+      ignoredKeys: [],
+      locked: []
+    };
   let bytes;
   try {
     bytes = readFileSync30(file3);
@@ -62489,6 +62640,7 @@ function readSwarmDoc(root) {
       hash: null,
       doc: null,
       issues: [{ path: "", message: `cannot read ${rel}: ${err.message}` }],
+      ignoredKeys: [],
       locked: []
     };
   }
@@ -62496,9 +62648,10 @@ function readSwarmDoc(root) {
   const hash2 = createHash13("sha256").update(bytes).digest("hex");
   const result = parseSwarmYaml(text3, file3, rel);
   const issues = result.state === "invalid" ? result.issues : [];
+  const ignoredKeys = result.state === "ok" ? result.config.ignoredKeys : [];
   const state = result.state === "ok" ? "ok" : "invalid";
   if (text3.length > SWARM_FILE_MAX_CHARS)
-    return { ...base, state, text: text3, hash: hash2, doc: null, issues, locked: [] };
+    return { ...base, state, text: text3, hash: hash2, doc: null, issues, ignoredKeys, locked: [] };
   const Y = yaml3();
   const parsed = Y.parseDocument(text3, { uniqueKeys: true, merge: true });
   let doc = null;
@@ -62513,7 +62666,7 @@ function readSwarmDoc(root) {
     } catch {
     }
   }
-  return { ...base, state, text: text3, hash: hash2, doc, issues, locked };
+  return { ...base, state, text: text3, hash: hash2, doc, issues, ignoredKeys, locked };
 }
 function checkSwarmText(text3, opts = {}) {
   const rel = opts.rel ?? SWARM_FILES[0];
@@ -62896,6 +63049,9 @@ function applyDiff(ctx, path3, oldV, newV) {
   inherit(old, node2);
   setAt(ctx, path3, node2);
 }
+function ignoredKeyWarnings(ignoredKeys) {
+  return ignoredKeys.map((i) => ({ path: i.path, kind: "ignored-key", message: i.message }));
+}
 function docWarnings(doc, activeRuns = [], prev) {
   const out = [];
   const swarms = isPlain(doc.swarms) ? doc.swarms : {};
@@ -63631,9 +63787,9 @@ function runDetail(ctx, run3, opts = {}) {
   const byAgent2 = /* @__PURE__ */ new Map();
   for (const e of all) {
     if (!e.agent_id) continue;
-    const list2 = byAgent2.get(e.agent_id) ?? [];
-    list2.push(e);
-    byAgent2.set(e.agent_id, list2);
+    const list3 = byAgent2.get(e.agent_id) ?? [];
+    list3.push(e);
+    byAgent2.set(e.agent_id, list3);
   }
   const loaded = loadSwarmConfig(ctx.root);
   const spec = loaded.state === "ok" ? loaded.config.swarms.find((s) => s.name === run3.swarm) : void 0;
@@ -63779,7 +63935,10 @@ function swarmConfigDoc(ctx) {
     hash: read2.hash,
     doc: read2.doc,
     issues: read2.issues,
-    warnings: read2.doc ? docWarnings(read2.doc, activeRuns, read2.doc) : [],
+    warnings: [
+      ...ignoredKeyWarnings(read2.ignoredKeys),
+      ...read2.doc ? docWarnings(read2.doc, activeRuns, read2.doc) : []
+    ],
     locked: read2.locked,
     starter: read2.state === "absent" ? starterDoc() : void 0,
     activeRuns,
@@ -63829,6 +63988,7 @@ async function prepareConfig(ctx, body) {
   const meta4 = { file: read2.file, rel: read2.rel };
   let text3;
   let issues = [];
+  let ignoredKeys = [];
   let draft = null;
   if (b.doc !== void 0) {
     draft = b.doc;
@@ -63836,10 +63996,12 @@ async function prepareConfig(ctx, body) {
     if (!r.ok) return { reply: fail2(422, r.error, { locked: r.locked ?? read2.locked }) };
     text3 = r.text;
     if (r.result.state === "invalid") issues = r.result.issues;
+    else if (r.result.state === "ok") ignoredKeys = r.result.config.ignoredKeys;
   } else {
     text3 = b.text;
     const { result, enforceOk } = checkSwarmText(text3, meta4);
     if (result.state === "invalid") issues = result.issues;
+    else if (result.state === "ok") ignoredKeys = result.config.ignoredKeys;
     if (!enforceOk)
       issues = [
         ...issues,
@@ -63856,7 +64018,10 @@ async function prepareConfig(ctx, body) {
     }
   }
   const diff2 = lineDiff(read2.text ?? "", text3);
-  const warnings = draft && typeof draft === "object" ? docWarnings(draft, activeRunsOf(ctx), read2.doc) : [];
+  const warnings = [
+    ...ignoredKeyWarnings(ignoredKeys),
+    ...draft && typeof draft === "object" ? docWarnings(draft, activeRunsOf(ctx), read2.doc) : []
+  ];
   return {
     parsed: b,
     p: {
@@ -64178,9 +64343,9 @@ function listedProjects() {
   const now = Date.now();
   if (projectList && projectList.mtime === mtime && now - projectList.at < PROJECT_LIST_TTL_MS)
     return projectList.list;
-  const list2 = listProjects();
-  projectList = { at: now, mtime, list: list2 };
-  return list2;
+  const list3 = listProjects();
+  projectList = { at: now, mtime, list: list3 };
+  return list3;
 }
 function resetProjectListCache() {
   projectList = void 0;
@@ -64859,7 +65024,8 @@ async function swarmCommand(args, callerCtx, io = defaultIO, opts = {}) {
             enabled: loaded.config.enabled,
             enforce: loaded.config.enforce,
             allowed_agents: loaded.config.allowedAgents,
-            swarms: loaded.config.swarms.map((s) => s.name)
+            swarms: loaded.config.swarms.map((s) => s.name),
+            ignored_keys: loaded.config.ignoredKeys
           } : loaded.state === "invalid" ? {
             state: "invalid",
             file: loaded.rel,
@@ -64881,6 +65047,7 @@ async function swarmCommand(args, callerCtx, io = defaultIO, opts = {}) {
       io.out(
         `ok: ${c.rel} \xB7 ${c.swarms.length} swarm(s), ${c.swarms.reduce((n, s) => n + s.roles.length, 0)} role(s)${c.enabled ? "" : " \xB7 disabled (enabled: false)"}${enforceNote(c)}`
       );
+      if (c.ignoredKeys.length) io.err(formatIssues(c.rel, c.ignoredKeys));
       return 0;
     }
     case "sync": {
@@ -64963,9 +65130,9 @@ async function swarmCommand(args, callerCtx, io = defaultIO, opts = {}) {
         return 2;
       }
       const db = await storage2(ctx);
-      const list2 = items(db, db.swarm.runs({ limit: Math.min(limit, 500) }));
-      if (json3) emit(list2);
-      else io.out(formatRunList(list2));
+      const list3 = items(db, db.swarm.runs({ limit: Math.min(limit, 500) }));
+      if (json3) emit(list3);
+      else io.out(formatRunList(list3));
       return 0;
     }
     case "status": {