@inerrata-corporation/errata 2.0.0-dev.35 → 2.0.0-dev.37

package/errata.mjs

@@ -15268,6 +15268,85 @@ var init_edge_rules = __esm({
   }
 });
 
+// ../../packages/shared/src/symbol-intent.ts
+function extractIdentifierTokens(text) {
+  const out2 = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of text.matchAll(TOKEN_RE2)) {
+    if (!seen.has(m[0])) {
+      seen.add(m[0]);
+      out2.push(m[0]);
+    }
+  }
+  return out2;
+}
+function summaryRejectionReason(summary, isKnownToken) {
+  if (!summary.trim()) return "empty summary";
+  if (summary.length > MAX_SYMBOL_SUMMARY_CHARS) return "summary too long";
+  if (PATH_SHAPE_RE.test(summary)) return "contains a path shape";
+  if (QUOTED_LITERAL_RE.test(summary.replace(CONTRACTION_RE, "$1$2")))
+    return "contains a quoted literal";
+  for (const tok of extractIdentifierTokens(summary)) {
+    if (isKnownToken(tok)) return `contains verbatim identifier '${tok}'`;
+    if (tok.includes(".")) {
+      const segs = tok.split(".");
+      for (let i2 = 0; i2 < segs.length; i2++) {
+        let span = "";
+        for (let j = i2; j < segs.length; j++) {
+          span = span ? `${span}.${segs[j]}` : segs[j];
+          if (span !== tok && span && isKnownToken(span))
+            return `contains verbatim identifier '${span}'`;
+        }
+      }
+    }
+  }
+  return null;
+}
+function substituteSymbolSummaries(text, summaryByToken) {
+  if (summaryByToken.size === 0) return text;
+  const present = extractIdentifierTokens(text).filter((t) => summaryByToken.has(t));
+  present.sort((a, b) => b.length - a.length);
+  let out2 = text;
+  for (const key of present) {
+    const re = new RegExp(`(?<![A-Za-z0-9_$.])${escapeRe2(key)}(?![A-Za-z0-9_$])`, "g");
+    out2 = out2.replace(re, summaryByToken.get(key));
+  }
+  return out2;
+}
+function vetSidecarSummaries(sidecar) {
+  if (!sidecar) return null;
+  const keys = new Set(Object.keys(sidecar));
+  if (keys.size === 0 || keys.size > MAX_SIDECAR_SYMBOLS) return null;
+  const clean = /* @__PURE__ */ new Map();
+  for (const [symbol2, entry] of Object.entries(sidecar)) {
+    if (!entry || typeof entry.summary !== "string") continue;
+    if (summaryRejectionReason(entry.summary, (t) => keys.has(t)) !== null) continue;
+    clean.set(symbol2, entry.summary);
+  }
+  return clean.size > 0 ? clean : null;
+}
+var SYMBOL_SUMMARY_KINDS, MAX_SYMBOL_SUMMARY_CHARS, MAX_SIDECAR_SYMBOLS, TOKEN_RE2, RE_RESERVED, escapeRe2, PATH_SHAPE_RE, CONTRACTION_RE, QUOTED_LITERAL_RE;
+var init_symbol_intent = __esm({
+  "../../packages/shared/src/symbol-intent.ts"() {
+    "use strict";
+    SYMBOL_SUMMARY_KINDS = [
+      "function",
+      "method",
+      "class",
+      "interface",
+      "constant"
+    ];
+    MAX_SYMBOL_SUMMARY_CHARS = 300;
+    MAX_SIDECAR_SYMBOLS = 200;
+    TOKEN_RE2 = /[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*/g;
+    RE_RESERVED = /[.*+?^${}()|[\]\\]/g;
+    escapeRe2 = (s) => s.replace(RE_RESERVED, "\\$&");
+    PATH_SHAPE_RE = /[\w.~-]+[/\\][\w.$~-]+/;
+    CONTRACTION_RE = /([A-Za-z])'([A-Za-z])/g;
+    QUOTED_LITERAL_RE = /"[^"]+"|'[^']+'|`[^`]+`/;
+  }
+});
+
 // ../../packages/shared/src/wire.ts
 function provenanceBand(source) {
   switch (source) {
@@ -15317,13 +15396,14 @@ function summarizeIngestResult(r) {
     ...r.patternReconciliation ? { patternReconciliation: r.patternReconciliation } : {}
   };
 }
-var CLOUD_NODE_LABELS, CLOUD_EDGE_TYPES, INGEST_SOURCES, INGEST_EXTRACTION_SOURCES, MAX_NODES_PER_PAYLOAD, MAX_EDGES_PER_PAYLOAD, CastaliaIngestNodeSchema, RouteContextCountWireSchema, CastaliaIngestEdgeSchema, CastaliaIngestPayloadSchema;
+var CLOUD_NODE_LABELS, CLOUD_EDGE_TYPES, INGEST_SOURCES, INGEST_EXTRACTION_SOURCES, MAX_NODES_PER_PAYLOAD, MAX_EDGES_PER_PAYLOAD, CastaliaIngestNodeSchema, RouteContextCountWireSchema, CastaliaIngestEdgeSchema, SymbolSummarySidecarSchema, CastaliaIngestPayloadSchema;
 var init_wire = __esm({
   "../../packages/shared/src/wire.ts"() {
     "use strict";
     init_zod();
     init_castalia();
     init_edge_rules();
+    init_symbol_intent();
     CLOUD_NODE_LABELS = [
       ...SEMANTIC_NODE_LABELS,
       ...CONTEXT_NODE_LABELS
@@ -15373,12 +15453,24 @@ var init_wire = __esm({
         perContext: external_exports.record(external_exports.string(), RouteContextCountWireSchema).optional()
       }).optional()
     });
+    SymbolSummarySidecarSchema = external_exports.record(
+      external_exports.string().min(1).max(160),
+      external_exports.object({
+        kind: external_exports.enum(SYMBOL_SUMMARY_KINDS),
+        summary: external_exports.string().min(1).max(MAX_SYMBOL_SUMMARY_CHARS)
+      })
+    ).refine((m) => Object.keys(m).length <= MAX_SIDECAR_SYMBOLS, {
+      message: `symbolSummaries sidecar exceeds ${MAX_SIDECAR_SYMBOLS} entries`
+    });
     CastaliaIngestPayloadSchema = external_exports.object({
       /** Client-supplied UUID — one batch; pairs with the payload digest for replay. */
       runId: external_exports.string().uuid(),
       source: external_exports.enum(INGEST_SOURCES),
       nodes: external_exports.array(CastaliaIngestNodeSchema).max(1e3),
-      edges: external_exports.array(CastaliaIngestEdgeSchema).max(5e3)
+      edges: external_exports.array(CastaliaIngestEdgeSchema).max(5e3),
+      /** Optional symbol→intent-summary sidecar (PP-symbol-intent). Only symbols
+       *  present in this payload's node text; server re-vets no-verbatim. */
+      symbolSummaries: SymbolSummarySidecarSchema.optional()
     });
   }
 });
@@ -15443,12 +15535,16 @@ __export(src_exports, {
   JUSTIFICATION_EDGES: () => JUSTIFICATION_EDGES,
   MAX_EDGES_PER_PAYLOAD: () => MAX_EDGES_PER_PAYLOAD,
   MAX_NODES_PER_PAYLOAD: () => MAX_NODES_PER_PAYLOAD,
+  MAX_SIDECAR_SYMBOLS: () => MAX_SIDECAR_SYMBOLS,
+  MAX_SYMBOL_SUMMARY_CHARS: () => MAX_SYMBOL_SUMMARY_CHARS,
   PAGERANK_EXCLUSIONS: () => PAGERANK_EXCLUSIONS,
   PROBLEM_RESOLUTION: () => PROBLEM_RESOLUTION,
   RESOLUTION_EDGES: () => RESOLUTION_EDGES,
   RouteContextCountWireSchema: () => RouteContextCountWireSchema,
   SEMANTIC_NODE_LABELS: () => SEMANTIC_NODE_LABELS,
   STRUCTURAL_EDGES: () => STRUCTURAL_EDGES,
+  SYMBOL_SUMMARY_KINDS: () => SYMBOL_SUMMARY_KINDS,
+  SymbolSummarySidecarSchema: () => SymbolSummarySidecarSchema,
   TAXONOMY_EDGES: () => TAXONOMY_EDGES,
   TRANSFER_EDGES: () => TRANSFER_EDGES,
   TRIAGE_EDGES: () => TRIAGE_EDGES,
@@ -15468,6 +15564,7 @@ __export(src_exports, {
   detectStance: () => detectStance,
   digest: () => digest,
   errorSignatureEqual: () => errorSignatureEqual,
+  extractIdentifierTokens: () => extractIdentifierTokens,
   genericCanonicalId: () => genericCanonicalId,
   identityId: () => identityId,
   isCausalProtected: () => isCausalProtected,
@@ -15493,9 +15590,12 @@ __export(src_exports, {
   resolveCanonicalId: () => resolveCanonicalId,
   sha256: () => sha256,
   sha256Short: () => sha256Short,
+  substituteSymbolSummaries: () => substituteSymbolSummaries,
   summarizeIngestResult: () => summarizeIngestResult,
+  summaryRejectionReason: () => summaryRejectionReason,
   toCloudAttrs: () => toCloudAttrs,
-  validateCastaliaPayload: () => validateCastaliaPayload
+  validateCastaliaPayload: () => validateCastaliaPayload,
+  vetSidecarSummaries: () => vetSidecarSummaries
 });
 var init_src = __esm({
   "../../packages/shared/src/index.ts"() {
@@ -15504,6 +15604,7 @@ var init_src = __esm({
     init_identity();
     init_wire();
     init_edge_rules();
+    init_symbol_intent();
     init_hash();
     init_error_signature();
     init_canonicalize();
@@ -17246,7 +17347,7 @@ function buildPackageIndex(store) {
   }
   return idx;
 }
-function escapeRe2(s) {
+function escapeRe3(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function matchPackagesInText(text, index) {
@@ -17256,7 +17357,7 @@ function matchPackagesInText(text, index) {
   for (const [key, node2] of index) {
     if (key.length < MIN_NAME_LEN) continue;
     if (!hay.includes(key)) continue;
-    const esc3 = escapeRe2(key);
+    const esc3 = escapeRe3(key);
     const bounded = new RegExp(`(?<![\\w@/.\\-])${esc3}(?![\\w])`);
     if (!bounded.test(hay)) continue;
     const verMatch = new RegExp(`${esc3}\\s*@?\\s*v?(\\d+(?:\\.\\d+){0,2})\\b`).exec(hay);
@@ -20507,6 +20608,38 @@ var init_oauth = __esm({
 
 // ../../packages/cloud-client/src/client.ts
 import { randomUUID } from "node:crypto";
+function wirePerContext(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const out2 = {};
+  for (const [bucket, entry] of Object.entries(value)) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const e = entry;
+    const confirmed = asWireCount(e["confirmed"]);
+    if (confirmed === null) continue;
+    const independent = asWireCount(e["independent"]);
+    const inferredIndependent = asWireCount(e["inferredIndependent"]);
+    out2[bucket] = {
+      confirmed,
+      ...independent !== null ? { independent } : {},
+      ...inferredIndependent !== null ? { inferredIndependent } : {}
+    };
+  }
+  return Object.keys(out2).length > 0 ? out2 : null;
+}
+function sidecarForNodes(sidecar, nodes) {
+  if (!sidecar) return void 0;
+  const present = /* @__PURE__ */ new Set();
+  for (const n of nodes) for (const tok of extractIdentifierTokens(n.description)) present.add(tok);
+  const filtered = {};
+  let count = 0;
+  for (const [symbol2, entry] of Object.entries(sidecar)) {
+    if (present.has(symbol2)) {
+      filtered[symbol2] = entry;
+      count++;
+    }
+  }
+  return count > 0 ? filtered : void 0;
+}
 function toWirePayload(batch, runId) {
   const nodes = batch.nodes.map((n) => ({
     canonicalId: n.id,
@@ -20517,15 +20650,20 @@ function toWirePayload(batch, runId) {
     attrs: n.attrs ?? {},
     extractionSource: n.extractionSource
   }));
-  const edges = batch.edges.map((e) => ({
-    fromCanonicalId: e.from,
-    toCanonicalId: e.to,
-    type: e.type,
-    attrs: {
-      ...typeof e.confidence === "number" ? { confidence: clamp012(e.confidence) } : {}
-    }
-  }));
-  return { runId, source: "daemon", nodes, edges };
+  const edges = batch.edges.map((e) => {
+    const perContext = wirePerContext(e.attrs?.["perContext"]);
+    return {
+      fromCanonicalId: e.from,
+      toCanonicalId: e.to,
+      type: e.type,
+      attrs: {
+        ...typeof e.confidence === "number" ? { confidence: clamp012(e.confidence) } : {},
+        ...perContext ? { perContext } : {}
+      }
+    };
+  });
+  const symbolSummaries = sidecarForNodes(batch.symbolSummaries, nodes);
+  return { runId, source: "daemon", nodes, edges, ...symbolSummaries ? { symbolSummaries } : {} };
 }
 function clamp012(x) {
   return Math.max(0, Math.min(1, x));
@@ -20536,12 +20674,13 @@ function chunkArray(items, size) {
   for (let i2 = 0; i2 < items.length; i2 += size) out2.push(items.slice(i2, i2 + size));
   return out2;
 }
-var INGEST_NODE_CHUNK, CloudClient, CloudError;
+var asWireCount, INGEST_NODE_CHUNK, CloudClient, CloudError;
 var init_client = __esm({
   "../../packages/cloud-client/src/client.ts"() {
     "use strict";
     init_oauth();
     init_src();
+    asWireCount = (n) => typeof n === "number" && Number.isFinite(n) && n >= 0 ? Math.floor(n) : null;
     INGEST_NODE_CHUNK = 25;
     CloudClient = class {
       baseUrl;
@@ -23939,21 +24078,32 @@ function isDistinctiveIdentifier(name2) {
   if (/^[A-Z]/.test(name2) && name2.length >= 4) return true;
   return name2.length >= 8;
 }
-function buildSymbolLexicon(store) {
+function buildSymbolLexicon(store, summariesByBodyHash2) {
   const lex = /* @__PURE__ */ new Map();
+  const candidates = [];
   for (const [label, kind] of SYMBOL_LABELS) {
     for (const n of store.findNodesByLabel(label)) {
+      const bodyHash = typeof n.attrs["bodyHash"] === "string" ? n.attrs["bodyHash"] : void 0;
+      const summary = bodyHash ? summariesByBodyHash2?.get(bodyHash) : void 0;
       for (const name2 of [n.description, String(n.attrs["qname"] ?? "")]) {
-        if (name2 && isDistinctiveIdentifier(name2)) lex.set(name2, kind);
+        if (name2 && isDistinctiveIdentifier(name2)) {
+          if (!lex.has(name2)) lex.set(name2, { kind });
+          if (summary) candidates.push([name2, summary]);
+        }
       }
     }
   }
+  for (const [name2, summary] of candidates) {
+    if (summaryRejectionReason(summary, (tok) => lex.has(tok)) === null) {
+      lex.get(name2).summary = summary;
+    }
+  }
   return lex;
 }
 function generalizeSymbols(text, lexicon, level = 1) {
   const present = [];
   const seen = /* @__PURE__ */ new Set();
-  for (const m of text.matchAll(TOKEN_RE2)) {
+  for (const m of text.matchAll(TOKEN_RE3)) {
     const tok = m[0];
     if (!seen.has(tok) && lexicon.has(tok)) {
       seen.add(tok);
@@ -23963,17 +24113,19 @@ function generalizeSymbols(text, lexicon, level = 1) {
   present.sort((a, b) => b.length - a.length);
   let out2 = text;
   for (const key of present) {
-    const phrase = KIND_PHRASE[lexicon.get(key)][level === 1 ? "l1" : "l2"];
-    const re = new RegExp(`(?<![A-Za-z0-9_$.])${escapeRe3(key)}(?![A-Za-z0-9_$])`, "g");
+    const entry = lexicon.get(key);
+    const phrase = level === 1 && entry.summary ? entry.summary : KIND_PHRASE[entry.kind][level === 1 ? "l1" : "l2"];
+    const re = new RegExp(`(?<![A-Za-z0-9_$.])${escapeRe4(key)}(?![A-Za-z0-9_$])`, "g");
     out2 = out2.replace(re, phrase);
   }
   return generalize(out2, { level }).text;
 }
-var SYMBOL_LABELS, KIND_PHRASE, RE_RESERVED, escapeRe3, TOKEN_RE2;
+var SYMBOL_LABELS, KIND_PHRASE, RE_RESERVED2, escapeRe4, TOKEN_RE3;
 var init_generalize_graph = __esm({
   "src/generalize-graph.ts"() {
     "use strict";
     init_src8();
+    init_src();
     SYMBOL_LABELS = [
       ["Function", "function"],
       ["Method", "method"],
@@ -23988,9 +24140,9 @@ var init_generalize_graph = __esm({
       interface: { l1: "an interface", l2: "an interface" },
       constant: { l1: "a constant", l2: "a value" }
     };
-    RE_RESERVED = /[.*+?^${}()|[\]\\]/g;
-    escapeRe3 = (s) => s.replace(RE_RESERVED, "\\$&");
-    TOKEN_RE2 = /[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*/g;
+    RE_RESERVED2 = /[.*+?^${}()|[\]\\]/g;
+    escapeRe4 = (s) => s.replace(RE_RESERVED2, "\\$&");
+    TOKEN_RE3 = /[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*/g;
   }
 });
 
@@ -24095,7 +24247,7 @@ async function dualAugment(opts) {
   let seedProvenance = "local";
   const calls = [];
   try {
-    const lexicon = buildSymbolLexicon(store);
+    const lexicon = buildSymbolLexicon(store, opts.summaries);
     const hardIds = [.../* @__PURE__ */ new Set([...seedNode ? [seedNode.id] : [], ...localHits.map((h) => h.id)])].filter((nid) => {
       const n = seedNode && nid === seedNode.id ? seedNode : store.getNode(nid);
       return !!n && isHardBridge(n);
@@ -25920,6 +26072,177 @@ var init_src10 = __esm({
   }
 });
 
+// src/symbol-summaries.ts
+import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join6 } from "node:path";
+function symbolSummariesPath(configDir) {
+  return join6(configDir, "symbol-summaries.json");
+}
+function loadSymbolSummaryCache(configDir) {
+  const p = symbolSummariesPath(configDir);
+  if (existsSync7(p)) {
+    try {
+      const raw2 = JSON.parse(readFileSync5(p, "utf8"));
+      if (raw2 && raw2.version === 1 && raw2.entries && typeof raw2.entries === "object") {
+        return { version: 1, entries: raw2.entries };
+      }
+    } catch {
+    }
+  }
+  return { version: 1, entries: {} };
+}
+function saveSymbolSummaryCache(configDir, cache) {
+  writeFileSync6(symbolSummariesPath(configDir), JSON.stringify(cache, null, 2), "utf8");
+}
+function summariesByBodyHash(cache) {
+  const m = /* @__PURE__ */ new Map();
+  for (const [bodyHash, e] of Object.entries(cache.entries)) {
+    if (!e.rejected && typeof e.summary === "string" && e.summary.trim()) m.set(bodyHash, e.summary);
+  }
+  return m;
+}
+function parseSummaryJson(text, expected) {
+  const start2 = text.indexOf("[");
+  const end = text.lastIndexOf("]");
+  if (start2 < 0 || end <= start2) return new Array(expected).fill(null);
+  let arr;
+  try {
+    arr = JSON.parse(text.slice(start2, end + 1));
+  } catch {
+    return new Array(expected).fill(null);
+  }
+  if (!Array.isArray(arr)) return new Array(expected).fill(null);
+  const out2 = [];
+  for (let i2 = 0; i2 < expected; i2++) {
+    const v = arr[i2];
+    out2.push(typeof v === "string" && v.trim() ? v.trim().slice(0, MAX_SYMBOL_SUMMARY_CHARS) : null);
+  }
+  return out2;
+}
+function haikuIntentSummarizer(apiKey) {
+  if (!apiKey) return void 0;
+  return async (symbols) => {
+    try {
+      const listing = symbols.map(
+        (s, i2) => `### ${i2 + 1}. kind: ${s.kind}
+name: ${s.name}
+${s.snippet ? `\`\`\`
+${s.snippet}
+\`\`\`` : "(no source available \u2014 describe from the name)"}`
+      ).join("\n\n");
+      const resp = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+          "x-api-key": apiKey,
+          "anthropic-version": "2023-06-01",
+          "content-type": "application/json"
+        },
+        body: JSON.stringify({
+          model: SUMMARY_MODEL,
+          max_tokens: 2e3,
+          messages: [{ role: "user", content: `${SUMMARY_PROMPT}
+
+SYMBOLS:
+${listing}` }]
+        })
+      });
+      if (!resp.ok) return symbols.map(() => null);
+      const json2 = await resp.json();
+      return parseSummaryJson(json2.content?.find((c) => c.type === "text")?.text ?? "", symbols.length);
+    } catch {
+      return symbols.map(() => null);
+    }
+  };
+}
+function envIntentSummarizer() {
+  if (process.env["ERRATA_SYMBOL_SUMMARIES"] !== "1") return void 0;
+  return haikuIntentSummarizer(process.env["ANTHROPIC_API_KEY"] ?? null);
+}
+function readSnippet(workspaceRoot, attrs) {
+  const relPath = attrs["relPath"];
+  const startByte = attrs["startByte"];
+  const endByte = attrs["endByte"];
+  if (typeof relPath !== "string" || typeof startByte !== "number" || typeof endByte !== "number") {
+    return void 0;
+  }
+  try {
+    const buf = readFileSync5(join6(workspaceRoot, ...relPath.split("/")));
+    const slice = buf.subarray(Math.max(0, startByte), Math.min(buf.length, endByte));
+    const text = slice.toString("utf8");
+    return text.length > MAX_SNIPPET_CHARS ? text.slice(0, MAX_SNIPPET_CHARS) : text;
+  } catch {
+    return void 0;
+  }
+}
+async function runSymbolSummarySweep(store, workspaceRoot, configDir, summarizer, opts = {}) {
+  const maxSymbols = opts.maxSymbols ?? DEFAULT_MAX_SYMBOLS_PER_SWEEP;
+  const batchSize = Math.max(1, opts.batchSize ?? DEFAULT_BATCH_SIZE);
+  const cache = loadSymbolSummaryCache(configDir);
+  const candidates = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const [label, kind] of SUMMARY_LABELS) {
+    for (const n of store.findNodesByLabel(label)) {
+      const bodyHash = n.attrs["bodyHash"];
+      if (typeof bodyHash !== "string" || !bodyHash || seen.has(bodyHash)) continue;
+      if (cache.entries[bodyHash]) continue;
+      const name2 = n.description;
+      if (!name2 || !isDistinctiveIdentifier(name2)) continue;
+      seen.add(bodyHash);
+      const snippet = readSnippet(workspaceRoot, n.attrs);
+      candidates.push({ bodyHash, name: name2, kind, ...snippet ? { snippet } : {} });
+    }
+  }
+  const todo = candidates.slice(0, maxSymbols);
+  const remaining = candidates.length - todo.length;
+  if (todo.length === 0) return { generated: 0, rejected: 0, remaining };
+  const lexicon = buildSymbolLexicon(store);
+  const isKnown = (tok) => lexicon.has(tok);
+  let generated = 0;
+  let rejected = 0;
+  for (let i2 = 0; i2 < todo.length; i2 += batchSize) {
+    const batch = todo.slice(i2, i2 + batchSize);
+    const phrases = await summarizer(batch);
+    const now = Date.now();
+    for (let j = 0; j < batch.length; j++) {
+      const sym = batch[j];
+      const phrase = phrases[j];
+      if (phrase == null) continue;
+      if (summaryRejectionReason(phrase, isKnown) === null) {
+        cache.entries[sym.bodyHash] = { summary: phrase, model: SUMMARY_MODEL, createdAt: now };
+        generated++;
+      } else {
+        cache.entries[sym.bodyHash] = { rejected: true, model: SUMMARY_MODEL, createdAt: now };
+        rejected++;
+      }
+    }
+    saveSymbolSummaryCache(configDir, cache);
+  }
+  return { generated, rejected, remaining };
+}
+var SUMMARY_LABELS, MAX_SNIPPET_CHARS, DEFAULT_MAX_SYMBOLS_PER_SWEEP, DEFAULT_BATCH_SIZE, SUMMARY_MODEL, SUMMARY_PROMPT;
+var init_symbol_summaries = __esm({
+  "src/symbol-summaries.ts"() {
+    "use strict";
+    init_src();
+    init_generalize_graph();
+    SUMMARY_LABELS = [
+      ["Function", "function"],
+      ["Method", "method"],
+      ["Class", "class"]
+    ];
+    MAX_SNIPPET_CHARS = 1500;
+    DEFAULT_MAX_SYMBOLS_PER_SWEEP = 64;
+    DEFAULT_BATCH_SIZE = 16;
+    SUMMARY_MODEL = "claude-haiku-4-5-20251001";
+    SUMMARY_PROMPT = `For each code symbol below, write ONE short English phrase stating its intent/role, shaped like "a <kind> that <does what>" (e.g. "a function that binds the server's listen port").
+HARD RULES \u2014 a violating phrase is discarded:
+- NEVER include any identifier, symbol name, variable, type name, file path, or module name from the code \u2014 describe meaning in plain English words only.
+- NEVER include quoted strings, literals, numbers copied from the code, or code syntax.
+- One phrase per symbol, under 200 characters, lowercase start, no trailing period.
+Output a JSON array of strings, one per symbol in the SAME ORDER (use null for a symbol you cannot describe). Output JSON only, no prose.`;
+  }
+});
+
 // ../../packages/indexer/src/simhash.ts
 function fnv1a64(s) {
   let h = FNV_OFFSET;
@@ -26143,9 +26466,9 @@ var init_identity2 = __esm({
 });
 
 // ../../packages/indexer/src/pipeline.ts
-import { appendFileSync, readFileSync as readFileSync5, statSync } from "node:fs";
+import { appendFileSync, readFileSync as readFileSync6, statSync } from "node:fs";
 import { readdir } from "node:fs/promises";
-import { extname, join as join6, relative as relative2, sep } from "node:path";
+import { extname, join as join7, relative as relative2, sep } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
 import { execFileSync } from "node:child_process";
 function nowTs() {
@@ -26261,7 +26584,7 @@ async function incrementalReindex(store, rootPath, workspaceId2, changedAbsPaths
   for (const rel of [...changedRelPaths]) {
     let h;
     try {
-      h = createHash3("sha256").update(readFileSync5(join6(rootPath, rel))).digest("hex");
+      h = createHash3("sha256").update(readFileSync6(join7(rootPath, rel))).digest("hex");
     } catch {
       continue;
     }
@@ -26308,13 +26631,13 @@ async function incrementalReindex(store, rootPath, workspaceId2, changedAbsPaths
   let parsedFiles = 0;
   for (const rel of changedRelPaths) {
     if (parsedFiles++ > 0) await new Promise((r2) => setImmediate(r2));
-    const abs = join6(rootPath, ...rel.split("/"));
+    const abs = join7(rootPath, ...rel.split("/"));
     const ext = extname(abs).toLowerCase();
     const provider = providers.find((p) => p.fileExtensions.includes(ext));
     if (!provider) continue;
     let symbols;
     try {
-      symbols = provider.extractSymbols(readFileSync5(abs, "utf8"), abs);
+      symbols = provider.extractSymbols(readFileSync6(abs, "utf8"), abs);
     } catch {
       continue;
     }
@@ -26614,7 +26937,7 @@ async function runIndexer(store, opts) {
         report.filesSkipped++;
         continue;
       }
-      source = readFileSync5(f.absPath, "utf8");
+      source = readFileSync6(f.absPath, "utf8");
     } catch {
       report.filesSkipped++;
       continue;
@@ -26666,7 +26989,7 @@ async function runIndexer(store, opts) {
     const depth = fileNode.relPath.split("/").length;
     if (depth !== 3) continue;
     try {
-      const pkg = JSON.parse(readFileSync5(fileNode.absPath, "utf8"));
+      const pkg = JSON.parse(readFileSync6(fileNode.absPath, "utf8"));
       if (!pkg.name) continue;
       const pkgDir = fileNode.relPath.replace(/\/package\.json$/, "");
       const candidates = [
@@ -27048,7 +27371,7 @@ async function scan(root, current, ignores, providers, out2) {
   for (const ent of entries) {
     if (ignores.has(ent.name)) continue;
     if (ent.name.startsWith(".") && ent.name !== ".") continue;
-    const abs = join6(current, ent.name);
+    const abs = join7(current, ent.name);
     if (ent.isDirectory()) {
       await scan(root, abs, ignores, providers, out2);
     } else if (ent.isFile()) {
@@ -27094,7 +27417,7 @@ function gitListFiles(root, ignores, providers) {
     if (segs.some((s) => ignores.has(s) || s.startsWith(".") && s.length > 1)) {
       continue;
     }
-    const abs = join6(root, rel);
+    const abs = join7(root, rel);
     let size;
     try {
       size = statSync(abs).size;
@@ -27117,7 +27440,7 @@ function upsertFile(store, id, f, workspaceId2) {
   const now = nowTs();
   let contentHash;
   try {
-    contentHash = createHash3("sha256").update(readFileSync5(f.absPath)).digest("hex");
+    contentHash = createHash3("sha256").update(readFileSync6(f.absPath)).digest("hex");
   } catch {
   }
   const node2 = {
@@ -31479,8 +31802,8 @@ ${JSON.stringify(symbolNames, null, 2)}`);
 
 // ../../packages/indexer/src/languages/tree-sitter-loader.ts
 import { fileURLToPath } from "node:url";
-import { dirname as dirname4, join as join7 } from "node:path";
-import { existsSync as existsSync7, readdirSync as readdirSync2 } from "node:fs";
+import { dirname as dirname4, join as join8 } from "node:path";
+import { existsSync as existsSync8, readdirSync as readdirSync2 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 function entryDir() {
   try {
@@ -31494,27 +31817,27 @@ function entryDir() {
 }
 function findWasmDir() {
   const here = entryDir();
-  const seaWasm = join7(here, "resources", "wasm");
-  if (existsSync7(join7(seaWasm, "tree-sitter-typescript.wasm"))) return seaWasm;
+  const seaWasm = join8(here, "resources", "wasm");
+  if (existsSync8(join8(seaWasm, "tree-sitter-typescript.wasm"))) return seaWasm;
   let dir = here;
   for (let i2 = 0; i2 < 6; i2++) {
-    const flat = join7(
+    const flat = join8(
       dir,
       "node_modules",
       "@vscode",
       "tree-sitter-wasm",
       "wasm"
     );
-    if (existsSync7(join7(flat, "tree-sitter-typescript.wasm"))) return flat;
+    if (existsSync8(join8(flat, "tree-sitter-typescript.wasm"))) return flat;
     dir = dirname4(dir);
   }
   let root = here;
   for (let i2 = 0; i2 < 6; i2++) {
-    const pnpmDir = join7(root, "node_modules", ".pnpm");
-    if (existsSync7(pnpmDir)) {
+    const pnpmDir = join8(root, "node_modules", ".pnpm");
+    if (existsSync8(pnpmDir)) {
       for (const entry of readdirSync2(pnpmDir)) {
         if (entry.startsWith("@vscode+tree-sitter-wasm@")) {
-          const candidate = join7(
+          const candidate = join8(
             pnpmDir,
             entry,
             "node_modules",
@@ -31522,7 +31845,7 @@ function findWasmDir() {
             "tree-sitter-wasm",
             "wasm"
           );
-          if (existsSync7(join7(candidate, "tree-sitter-typescript.wasm"))) {
+          if (existsSync8(join8(candidate, "tree-sitter-typescript.wasm"))) {
             return candidate;
           }
         }
@@ -31536,27 +31859,27 @@ function findWasmDir() {
 }
 function findRuntimeDir() {
   const here = entryDir();
-  const seaRuntime = join7(here, "resources", "wasm");
-  if (existsSync7(join7(seaRuntime, "web-tree-sitter.wasm"))) return seaRuntime;
+  const seaRuntime = join8(here, "resources", "wasm");
+  if (existsSync8(join8(seaRuntime, "web-tree-sitter.wasm"))) return seaRuntime;
   let dir = here;
   for (let i2 = 0; i2 < 6; i2++) {
-    const flat = join7(dir, "node_modules", "web-tree-sitter");
-    if (existsSync7(join7(flat, "web-tree-sitter.wasm"))) return flat;
+    const flat = join8(dir, "node_modules", "web-tree-sitter");
+    if (existsSync8(join8(flat, "web-tree-sitter.wasm"))) return flat;
     dir = dirname4(dir);
   }
   let root = here;
   for (let i2 = 0; i2 < 6; i2++) {
-    const pnpmDir = join7(root, "node_modules", ".pnpm");
-    if (existsSync7(pnpmDir)) {
+    const pnpmDir = join8(root, "node_modules", ".pnpm");
+    if (existsSync8(pnpmDir)) {
       for (const entry of readdirSync2(pnpmDir)) {
         if (entry.startsWith("web-tree-sitter@")) {
-          const candidate = join7(
+          const candidate = join8(
             pnpmDir,
             entry,
             "node_modules",
             "web-tree-sitter"
           );
-          if (existsSync7(join7(candidate, "web-tree-sitter.wasm"))) {
+          if (existsSync8(join8(candidate, "web-tree-sitter.wasm"))) {
             return candidate;
           }
         }
@@ -31573,7 +31896,7 @@ async function loadWebTreeSitter() {
     void err2;
   }
   const here = entryDir();
-  const seaResourceBase = join7(here, "resources", "_resolve.js");
+  const seaResourceBase = join8(here, "resources", "_resolve.js");
   const resourceRequire = createRequire2(seaResourceBase);
   return resourceRequire("web-tree-sitter");
 }
@@ -31588,9 +31911,9 @@ async function ensureTreeSitterReady() {
     await Parser2.init({
       locateFile: (name2) => {
         if (name2 === "tree-sitter.wasm" || name2 === "web-tree-sitter.wasm") {
-          return join7(runtime, name2);
+          return join8(runtime, name2);
         }
-        return join7(grammars, name2);
+        return join8(grammars, name2);
       }
     });
   })();
@@ -31602,7 +31925,7 @@ async function loadGrammar(name2) {
   if (cached2) return cached2;
   if (!languageClass) throw new Error("tree-sitter not initialized");
   const grammars = findWasmDir();
-  const lang = await languageClass.load(join7(grammars, `${name2}.wasm`));
+  const lang = await languageClass.load(join8(grammars, `${name2}.wasm`));
   grammarCache.set(name2, lang);
   return lang;
 }
@@ -34504,7 +34827,7 @@ var init_src11 = __esm({
 // src/reconcile.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { readdirSync as readdirSync3, statSync as statSync2 } from "node:fs";
-import { join as join8, relative as relative3, sep as sep2 } from "node:path";
+import { join as join9, relative as relative3, sep as sep2 } from "node:path";
 function gitSourceFiles(root) {
   let stdout;
   try {
@@ -34519,7 +34842,7 @@ function gitSourceFiles(root) {
   const out2 = [];
   for (const rel of stdout.split("\0")) {
     if (!rel || !SOURCE_RE.test(rel)) continue;
-    const abs = join8(root, rel);
+    const abs = join9(root, rel);
     if (IGNORED.test(abs)) continue;
     out2.push(abs);
   }
@@ -34534,7 +34857,7 @@ function* walkSource(dir) {
   }
   for (const e of entries) {
     const name2 = String(e.name);
-    const full = join8(dir, name2);
+    const full = join9(dir, name2);
     if (IGNORED.test(full)) continue;
     if (e.isDirectory()) yield* walkSource(full);
     else if (SOURCE_RE.test(name2)) yield full;
@@ -34612,7 +34935,7 @@ __export(mcp_exports, {
   runTool: () => runTool,
   searchGraph: () => searchGraph
 });
-import { existsSync as existsSync8, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:fs";
 import { resolve } from "node:path";
 function collectEnrichmentPulls(store, opts = {}) {
   const pending = store.findNodesByLabel("Solution").filter((s) => s.attrs["enrichmentPending"] === true).filter((s) => !opts.onlyUnsurfaced || s.attrs["enrichmentSurfaced"] !== true);
@@ -34725,10 +35048,10 @@ function showNode(store, node2, maxLines) {
   if (!relPath) return { found: false, reason: "no file owner for node" };
   const workspaceRoot = process.cwd();
   const absPath = resolve(workspaceRoot, relPath);
-  if (!existsSync8(absPath)) {
+  if (!existsSync9(absPath)) {
     return { found: false, reason: `file not found on disk: ${absPath}` };
   }
-  const source = readFileSync6(absPath, "utf8");
+  const source = readFileSync7(absPath, "utf8");
   const attrs = node2.attrs;
   let startByte = attrs["bodyStartByte"] ?? attrs["startByte"];
   let endByte = attrs["bodyEndByte"] ?? attrs["endByte"];
@@ -34941,7 +35264,20 @@ function buildToolContext() {
 async function runMcpServer(workspaceRoot) {
   const paths = workspacePaths(workspaceRoot);
   const store = openGraphStore({ path: paths.castalia });
-  const handle2 = createMcpHandler(store, buildToolContext());
+  let summariesMemo = null;
+  const symbolSummaries = () => {
+    const now = Date.now();
+    if (!summariesMemo || now - summariesMemo.at > 6e4) {
+      let map2 = /* @__PURE__ */ new Map();
+      try {
+        map2 = summariesByBodyHash(loadSymbolSummaryCache(paths.configDir));
+      } catch {
+      }
+      summariesMemo = { at: now, map: map2 };
+    }
+    return summariesMemo.map;
+  };
+  const handle2 = createMcpHandler(store, { ...buildToolContext(), symbolSummaries });
   process.stdin.setEncoding("utf8");
   let buffer = "";
   process.stdin.on("data", (chunk) => {
@@ -34980,6 +35316,7 @@ var init_mcp = __esm({
     init_src2();
     init_src10();
     init_paths();
+    init_symbol_summaries();
     init_webui();
     init_reconcile();
     init_agent_signals();
@@ -35052,7 +35389,14 @@ var init_mcp = __esm({
               score: h.pageRank,
               hops: 0
             }));
-            const dual = await dualAugment({ store, cloud: ctx.cloud, localHits, queryText: query, limit });
+            const dual = await dualAugment({
+              store,
+              cloud: ctx.cloud,
+              localHits,
+              queryText: query,
+              limit,
+              ...ctx.symbolSummaries ? { summaries: ctx.symbolSummaries() } : {}
+            });
             if (dual.status === "merged") {
               return {
                 query,
@@ -35217,7 +35561,8 @@ var init_mcp = __esm({
               cloud: ctx.cloud,
               localHits,
               seedNode,
-              limit: args2["limit"] != null ? Number(args2["limit"]) : 20
+              limit: args2["limit"] != null ? Number(args2["limit"]) : 20,
+              ...ctx.symbolSummaries ? { summaries: ctx.symbolSummaries() } : {}
             });
             if (dual.status === "merged") {
               return {
@@ -35732,7 +36077,14 @@ var init_mcp = __esm({
               score: h.score,
               hops: 0
             }));
-            const dual = await dualAugment({ store, cloud: ctx.cloud, localHits, seedNode: node2, limit });
+            const dual = await dualAugment({
+              store,
+              cloud: ctx.cloud,
+              localHits,
+              seedNode: node2,
+              limit,
+              ...ctx.symbolSummaries ? { summaries: ctx.symbolSummaries() } : {}
+            });
             if (dual.status === "merged") {
               return {
                 seedId: id,
@@ -35923,7 +36275,7 @@ var init_mcp = __esm({
         inputSchema: { type: "object", properties: {} },
         handler: () => {
           const path2 = sharedStorePath();
-          if (!existsSync8(path2)) return { count: 0, pending: [] };
+          if (!existsSync9(path2)) return { count: 0, pending: [] };
           const shared = openGraphStore({ path: path2 });
           try {
             const pending = pendingAbstractions(shared);
@@ -35954,7 +36306,7 @@ var init_mcp = __esm({
         },
         handler: (args2) => {
           const path2 = sharedStorePath();
-          if (!existsSync8(path2)) return { count: 0, routes: [] };
+          if (!existsSync9(path2)) return { count: 0, routes: [] };
           const shared = openGraphStore({ path: path2 });
           try {
             const result = triageOf(shared, {
@@ -36339,8 +36691,8 @@ __export(vfile_exports, {
   resolvePath: () => resolvePath,
   segmentsOf: () => segmentsOf
 });
-import { writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join9, resolve as resolve2, sep as sep3 } from "node:path";
+import { writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join10, resolve as resolve2, sep as sep3 } from "node:path";
 function segmentsOf(rawPath) {
   let p = rawPath.replace(/\\/g, "/");
   p = p.replace(/^.*\.errata\/g\//, "").replace(/^\/?g\//, "").replace(/^\/+/, "");
@@ -36414,14 +36766,14 @@ async function renderVFile(rawPath, store, ctx = {}) {
 }
 async function materializeVFile(rawPath, workspaceRoot, store, ctx = {}) {
   const segs = segmentsOf(rawPath);
-  const gRoot = join9(workspaceRoot, ".errata", "g");
+  const gRoot = join10(workspaceRoot, ".errata", "g");
   const abs = resolve2(gRoot, ...segs.length ? segs : ["index"]);
   if (abs !== gRoot && !abs.startsWith(gRoot + sep3)) {
     throw new Error(`refusing to materialize outside .errata/g: ${rawPath}`);
   }
   const text = await renderVFile(rawPath, store, ctx);
   ensureParent(abs);
-  writeFileSync6(abs, text, "utf8");
+  writeFileSync7(abs, text, "utf8");
   return abs;
 }
 async function materializeOverview(workspaceRoot, store, ctx = {}) {
@@ -36506,25 +36858,25 @@ the tool surface; the path is the thin, composable channel.
 
 // src/outbox.ts
 import {
-  existsSync as existsSync9,
+  existsSync as existsSync10,
   readdirSync as readdirSync4,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync8,
   renameSync,
   unlinkSync,
-  writeFileSync as writeFileSync7
+  writeFileSync as writeFileSync8
 } from "node:fs";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 import { createHash as createHash11 } from "node:crypto";
 function enqueueOutbox(paths, payload) {
   ensureDir(paths.outbox);
   const id = createHash11("sha256").update(JSON.stringify(payload)).digest("hex").slice(0, 16);
-  const file2 = join10(paths.outbox, `${Date.now()}-${id}.json`);
-  writeFileSync7(file2, JSON.stringify(payload, null, 2), "utf8");
+  const file2 = join11(paths.outbox, `${Date.now()}-${id}.json`);
+  writeFileSync8(file2, JSON.stringify(payload, null, 2), "utf8");
   return file2;
 }
 async function flushOutbox(paths, client, store) {
   ensureDir(paths.outbox);
-  const entries = existsSync9(paths.outbox) ? readdirSync4(paths.outbox) : [];
+  const entries = existsSync10(paths.outbox) ? readdirSync4(paths.outbox) : [];
   let uploaded = 0;
   let failed = 0;
   const quarantine = (abs, reason) => {
@@ -36535,10 +36887,10 @@ async function flushOutbox(paths, client, store) {
     }
   };
   for (const f of entries.filter((e) => e.endsWith(".json")).sort()) {
-    const abs = join10(paths.outbox, f);
+    const abs = join11(paths.outbox, f);
     let payload;
     try {
-      payload = JSON.parse(readFileSync7(abs, "utf8"));
+      payload = JSON.parse(readFileSync8(abs, "utf8"));
     } catch {
       failed++;
       quarantine(abs, "unparseable JSON");
@@ -36566,7 +36918,7 @@ async function flushOutbox(paths, client, store) {
       }
     }
   }
-  const remainingFiles = existsSync9(paths.outbox) ? readdirSync4(paths.outbox).filter((e) => e.endsWith(".json")) : [];
+  const remainingFiles = existsSync10(paths.outbox) ? readdirSync4(paths.outbox).filter((e) => e.endsWith(".json")) : [];
   return { uploaded, failed, remaining: remainingFiles.length };
 }
 var init_outbox = __esm({
@@ -36585,7 +36937,7 @@ __export(webui_exports, {
   findFileByPath: () => findFileByPath,
   recallForFile: () => recallForFile
 });
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function fileUriToFsPath(raw2) {
   let p = raw2.replace(/^file:\/\//, "").replace(/\\/g, "/");
   if (/^\/[A-Za-z]:/.test(p)) p = p.slice(1);
@@ -36946,7 +37298,7 @@ function buildWebUi(deps) {
     } catch {
       return c.json({});
     }
-    const block = readManagedBlockWithHash(join11(deps.paths.root, "AGENTS.md"));
+    const block = readManagedBlockWithHash(join12(deps.paths.root, "AGENTS.md"));
     const decision = decideContextInject({
       event: String(body2["hook_event_name"] ?? "UserPromptSubmit"),
       source: String(body2["source"] ?? ""),
@@ -37548,12 +37900,12 @@ var init_report_render = __esm({
 
 // src/cli.ts
 init_src5();
-import { closeSync as closeSync2, existsSync as existsSync19, openSync as openSync2, readFileSync as readFileSync18, renameSync as renameSync3, statSync as statSync5 } from "node:fs";
-import { join as join22 } from "node:path";
+import { closeSync as closeSync2, existsSync as existsSync20, openSync as openSync2, readFileSync as readFileSync19, renameSync as renameSync3, statSync as statSync5 } from "node:fs";
+import { join as join23 } from "node:path";
 import { spawn as spawn3 } from "node:child_process";
 
 // src/daemon.ts
-import { existsSync as existsSync15, writeFileSync as writeFileSync12 } from "node:fs";
+import { existsSync as existsSync16, writeFileSync as writeFileSync13 } from "node:fs";
 
 // ../../node_modules/.pnpm/@hono+node-server@1.19.11_hono@4.12.8/node_modules/@hono/node-server/dist/index.mjs
 import { createServer as createServerHTTP } from "http";
@@ -38133,8 +38485,8 @@ init_config();
 
 // src/engine.ts
 import { execFileSync as execFileSync3 } from "node:child_process";
-import { existsSync as existsSync14, statSync as statSync4, appendFileSync as appendFileSync2, readdirSync as readdirSync7, renameSync as renameSync2, readFileSync as readFileSync13, writeFileSync as writeFileSync11 } from "node:fs";
-import { join as join19, relative as relative6, sep as sep4 } from "node:path";
+import { existsSync as existsSync15, statSync as statSync4, appendFileSync as appendFileSync2, readdirSync as readdirSync7, renameSync as renameSync2, readFileSync as readFileSync14, writeFileSync as writeFileSync12 } from "node:fs";
+import { join as join20, relative as relative6, sep as sep4 } from "node:path";
 
 // ../../node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/esm/index.js
 import { stat as statcb } from "fs";
@@ -39996,8 +40348,8 @@ init_src10();
 init_review2();
 
 // src/turn.ts
-import { closeSync, existsSync as existsSync10, fstatSync, openSync, readdirSync as readdirSync5, readSync, statSync as statSync3 } from "node:fs";
-import { basename as basename3, dirname as dirname7, join as join14 } from "node:path";
+import { closeSync, existsSync as existsSync11, fstatSync, openSync, readdirSync as readdirSync5, readSync, statSync as statSync3 } from "node:fs";
+import { basename as basename3, dirname as dirname7, join as join15 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 function readTail(path2, maxBytes) {
   let fd;
@@ -40106,11 +40458,11 @@ function turnsSince(turns, mark) {
   return at >= 0 ? turns.slice(at + 1) : turns;
 }
 function claudeProjectDir(cwd, home = homedir3()) {
-  return join14(home, ".claude", "projects", cwd.replace(/[\\/:.]/g, "-"));
+  return join15(home, ".claude", "projects", cwd.replace(/[\\/:.]/g, "-"));
 }
 function recentTranscripts(cwd, opts = {}) {
   const dir = claudeProjectDir(cwd, opts.home ?? homedir3());
-  if (!existsSync10(dir)) return [];
+  if (!existsSync11(dir)) return [];
   let names;
   try {
     names = readdirSync5(dir);
@@ -40121,7 +40473,7 @@ function recentTranscripts(cwd, opts = {}) {
   const refs = [];
   for (const name2 of names) {
     if (!name2.endsWith(".jsonl")) continue;
-    const path2 = join14(dir, name2);
+    const path2 = join15(dir, name2);
     let mtimeMs;
     try {
       mtimeMs = statSync3(path2).mtimeMs;
@@ -40136,8 +40488,8 @@ function recentTranscripts(cwd, opts = {}) {
 }
 function subagentTranscripts(mainTranscriptPath, sessionId) {
   if (!mainTranscriptPath || !sessionId) return [];
-  const dir = join14(dirname7(mainTranscriptPath), sessionId, "subagents");
-  if (!existsSync10(dir)) return [];
+  const dir = join15(dirname7(mainTranscriptPath), sessionId, "subagents");
+  if (!existsSync11(dir)) return [];
   let names;
   try {
     names = readdirSync5(dir);
@@ -40147,7 +40499,7 @@ function subagentTranscripts(mainTranscriptPath, sessionId) {
   const refs = [];
   for (const name2 of names) {
     if (!name2.endsWith(".jsonl")) continue;
-    const path2 = join14(dir, name2);
+    const path2 = join15(dir, name2);
     let mtimeMs;
     try {
       mtimeMs = statSync3(path2).mtimeMs;
@@ -40164,7 +40516,7 @@ function subagentTranscripts(mainTranscriptPath, sessionId) {
 init_src();
 init_src2();
 init_agent_signals();
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "node:fs";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "node:fs";
 var NEG = /n['']t|\b(?:not|never|no|none|neither|nor|unrelated|irrelevant|would|might|could|if)\b/i;
 var CITE_GROUP_RE = /\(((?:[^()\n]|\([^()\n]*\)){1,200})\)/g;
 var HANDLE_RE = /\[([a-z0-9][\w-]{0,40})\]|((?:pat|sol|drc|dcause|dfix|dprob|prob|claim|err)_[0-9a-f]{6,})/gi;
@@ -40414,13 +40766,13 @@ function writePrimingHandles(path2, nodes, now = Date.now()) {
       entries.sort((a, b) => (b[1].seenAt ?? 0) - (a[1].seenAt ?? 0));
       entries.length = HANDLE_MAP_MAX;
     }
-    writeFileSync8(path2, JSON.stringify(Object.fromEntries(entries)));
+    writeFileSync9(path2, JSON.stringify(Object.fromEntries(entries)));
   } catch {
   }
 }
 function readPrimingHandles(path2) {
   try {
-    return JSON.parse(readFileSync8(path2, "utf8"));
+    return JSON.parse(readFileSync9(path2, "utf8"));
   } catch {
     return {};
   }
@@ -40676,6 +41028,7 @@ ${conversation}` }]
 }
 
 // src/engine.ts
+init_symbol_summaries();
 init_reconcile();
 
 // src/episode.ts
@@ -40872,11 +41225,11 @@ init_outbox();
 init_src8();
 init_src();
 init_src2();
-import { readFileSync as readFileSync9 } from "node:fs";
-import { join as join15 } from "node:path";
+import { readFileSync as readFileSync10 } from "node:fs";
+import { join as join16 } from "node:path";
 function loadClaimIgnorePatterns(workspaceRoot) {
   try {
-    return readFileSync9(join15(workspaceRoot, ".errataignore"), "utf8").split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#")).map((l) => l.toLowerCase());
+    return readFileSync10(join16(workspaceRoot, ".errataignore"), "utf8").split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#")).map((l) => l.toLowerCase());
   } catch {
     return [];
   }
@@ -41067,13 +41420,21 @@ function isSyncableRoute(edge2, shared, triage, ignorePatterns = []) {
 function generalizeRouteForSync(edge2, level) {
   const disc = edge2.attrs["discriminator"];
   const local = edge2.attrs["perContext"] ?? {};
-  const confirmed = {};
-  for (const [b, c] of Object.entries(local)) confirmed[b] = c.confirmed;
+  const perContext = {};
+  for (const [b, c] of Object.entries(local)) {
+    const independent = c.independent ?? c.contributors?.length;
+    const inferredIndependent = c.inferredIndependent ?? c.inferredContributors?.length;
+    perContext[b] = {
+      confirmed: c.confirmed,
+      ...typeof independent === "number" && independent > 0 ? { independent } : {},
+      ...typeof inferredIndependent === "number" && inferredIndependent > 0 ? { inferredIndependent } : {}
+    };
+  }
   return {
     ...edge2,
     attrs: {
       driftKind: edge2.attrs["driftKind"],
-      perContext: confirmed,
+      perContext,
       provisional: false,
       ...typeof disc === "string" && disc.trim() ? { discriminator: generalize(disc, { level }).text } : {}
     },
@@ -41168,22 +41529,22 @@ async function pullCloudTriage(shared, cloud, profile, limit = 50) {
 }
 
 // src/git-sensor.ts
-import { existsSync as existsSync11, readFileSync as readFileSync10, watch as fsWatch } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync11, watch as fsWatch } from "node:fs";
+import { join as join17 } from "node:path";
 function readFirstLine(path2) {
   try {
-    return readFileSync10(path2, "utf8").split(/\r?\n/, 1)[0].trim();
+    return readFileSync11(path2, "utf8").split(/\r?\n/, 1)[0].trim();
   } catch {
     return null;
   }
 }
 function readGitRefState(gitDir) {
-  const head2 = readFirstLine(join16(gitDir, "HEAD"));
+  const head2 = readFirstLine(join17(gitDir, "HEAD"));
   const m = head2 ? /^ref:\s*refs\/heads\/(.+)$/.exec(head2) : null;
   const branch = m ? m[1] : null;
   let sha2 = null;
   if (branch) {
-    sha2 = readFirstLine(join16(gitDir, "refs", "heads", branch));
+    sha2 = readFirstLine(join17(gitDir, "refs", "heads", branch));
     if (!sha2) sha2 = shaFromPackedRefs(gitDir, `refs/heads/${branch}`);
   } else if (head2 && /^[0-9a-f]{7,40}$/i.test(head2)) {
     sha2 = head2;
@@ -41191,13 +41552,13 @@ function readGitRefState(gitDir) {
   return {
     branch,
     sha: sha2,
-    mergeHeadExists: existsSync11(join16(gitDir, "MERGE_HEAD")),
-    origHeadExists: existsSync11(join16(gitDir, "ORIG_HEAD"))
+    mergeHeadExists: existsSync12(join17(gitDir, "MERGE_HEAD")),
+    origHeadExists: existsSync12(join17(gitDir, "ORIG_HEAD"))
   };
 }
 function shaFromPackedRefs(gitDir, ref) {
   try {
-    for (const line of readFileSync10(join16(gitDir, "packed-refs"), "utf8").split(/\r?\n/)) {
+    for (const line of readFileSync11(join17(gitDir, "packed-refs"), "utf8").split(/\r?\n/)) {
       const [sha2, name2] = line.split(/\s+/);
       if (name2 === ref && sha2) return sha2;
     }
@@ -41231,7 +41592,7 @@ function startGitSensor(gitDir, onEvent, opts = {}) {
   const settle = () => {
     if (timer) clearTimeout(timer);
     timer = setTimeout(() => {
-      if (existsSync11(join16(gitDir, "index.lock"))) {
+      if (existsSync12(join17(gitDir, "index.lock"))) {
         settle();
         return;
       }
@@ -41242,7 +41603,7 @@ function startGitSensor(gitDir, onEvent, opts = {}) {
     }, debounceMs);
   };
   for (const sub of ["HEAD", "logs/HEAD", "MERGE_HEAD", "ORIG_HEAD"]) {
-    const p = join16(gitDir, sub);
+    const p = join17(gitDir, sub);
     try {
       watchers.push(fsWatch(p, settle));
     } catch {
@@ -41467,21 +41828,21 @@ var TelemetryRecorder = class {
 
 // src/skills.ts
 import {
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   mkdirSync as mkdirSync5,
-  readFileSync as readFileSync11,
+  readFileSync as readFileSync12,
   readdirSync as readdirSync6,
   unlinkSync as unlinkSync2,
-  writeFileSync as writeFileSync9
+  writeFileSync as writeFileSync10
 } from "node:fs";
-import { basename as basename4, join as join17 } from "node:path";
+import { basename as basename4, join as join18 } from "node:path";
 function skillFileName(id) {
   return `${id.replace(/[^A-Za-z0-9_.-]/g, "_")}.md`;
 }
 function readSkillManifest(manifestPath) {
-  if (!existsSync12(manifestPath)) return [];
+  if (!existsSync13(manifestPath)) return [];
   try {
-    const parsed = JSON.parse(readFileSync11(manifestPath, "utf8"));
+    const parsed = JSON.parse(readFileSync12(manifestPath, "utf8"));
     return (parsed.skills ?? []).map((s) => ({
       title: s.title ?? "",
       layer: s.layer ?? "technique",
@@ -41504,7 +41865,7 @@ async function syncSkills(paths, client, seed) {
   for (const s of res.skills) {
     const fileName = skillFileName(s.id);
     keep.add(fileName);
-    writeFileSync9(join17(paths.skillsDir, fileName), s.markdown, "utf8");
+    writeFileSync10(join18(paths.skillsDir, fileName), s.markdown, "utf8");
     rows.push({
       id: s.id,
       title: s.title,
@@ -41518,13 +41879,13 @@ async function syncSkills(paths, client, seed) {
     if (!f.endsWith(".md")) continue;
     if (keep.has(basename4(f))) continue;
     try {
-      unlinkSync2(join17(paths.skillsDir, f));
+      unlinkSync2(join18(paths.skillsDir, f));
       pruned++;
     } catch {
     }
   }
   rows.sort((a, b) => a.id.localeCompare(b.id));
-  writeFileSync9(
+  writeFileSync10(
     paths.skillsManifest,
     JSON.stringify({ generatedAt: Date.now(), skills: rows }, null, 2),
     "utf8"
@@ -41661,30 +42022,30 @@ var CausalBuffer = class {
 // src/profile.ts
 init_src2();
 init_paths();
-import { existsSync as existsSync13, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync13, writeFileSync as writeFileSync11 } from "node:fs";
 import { createHash as createHash12 } from "node:crypto";
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 function workspaceId(root) {
   return "wp_" + createHash12("sha256").update(root).digest("hex").slice(0, 12);
 }
 function loadProfile(root) {
   const p = workspacePaths(root);
-  if (!existsSync13(p.workspaceJson)) return null;
-  return JSON.parse(readFileSync12(p.workspaceJson, "utf8"));
+  if (!existsSync14(p.workspaceJson)) return null;
+  return JSON.parse(readFileSync13(p.workspaceJson, "utf8"));
 }
 function saveProfile(root, profile) {
   const p = workspacePaths(root);
   ensureDir(p.configDir);
-  writeFileSync10(p.workspaceJson, JSON.stringify(profile, null, 2), "utf8");
+  writeFileSync11(p.workspaceJson, JSON.stringify(profile, null, 2), "utf8");
 }
 function autodetectProfile(root) {
   const id = workspaceId(root);
   const name2 = root.split(/[\\/]/).filter(Boolean).pop() ?? "workspace";
   const p = emptyProfile(id, name2);
-  const pkgPath = join18(root, "package.json");
-  if (existsSync13(pkgPath)) {
+  const pkgPath = join19(root, "package.json");
+  if (existsSync14(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync12(pkgPath, "utf8"));
+      const pkg = JSON.parse(readFileSync13(pkgPath, "utf8"));
       p.languages.push("typescript", "javascript");
       const nodeVer = pkg.engines?.node ?? "node";
       p.stack.push(`node@${nodeVer}`);
@@ -41705,10 +42066,10 @@ function autodetectProfile(root) {
     } catch {
     }
   }
-  const pyproject = join18(root, "pyproject.toml");
-  if (existsSync13(pyproject)) {
+  const pyproject = join19(root, "pyproject.toml");
+  if (existsSync14(pyproject)) {
     try {
-      const txt = readFileSync12(pyproject, "utf8");
+      const txt = readFileSync13(pyproject, "utf8");
       const py = /python\s*=\s*"([^"]+)"/.exec(txt)?.[1];
       p.languages.push("python");
       p.stack.push(`python@${py ?? "3"}`);
@@ -41719,16 +42080,16 @@ function autodetectProfile(root) {
     } catch {
     }
   }
-  const reqs = join18(root, "requirements.txt");
-  if (existsSync13(reqs)) {
+  const reqs = join19(root, "requirements.txt");
+  if (existsSync14(reqs)) {
     if (!p.languages.includes("python")) p.languages.push("python");
     if (!p.stack.includes("python@3")) p.stack.push("python@3");
   }
-  if (existsSync13(join18(root, "go.mod"))) {
+  if (existsSync14(join19(root, "go.mod"))) {
     p.languages.push("go");
     p.stack.push("go");
   }
-  if (existsSync13(join18(root, "Cargo.toml"))) {
+  if (existsSync14(join19(root, "Cargo.toml"))) {
     p.languages.push("rust");
     p.stack.push("rust");
   }
@@ -41886,7 +42247,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.35" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.37" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -41896,7 +42257,7 @@ var TURN_REPLAY_LOOKBACK_MS = 7 * 24 * 60 * 6e4;
 function appendIdentityAudit(path2, record2, line) {
   if (!record2.accepted && record2.score <= 0) return;
   try {
-    if (existsSync14(path2) && statSync4(path2).size >= IDENTITY_AUDIT_MAX_BYTES) {
+    if (existsSync15(path2) && statSync4(path2).size >= IDENTITY_AUDIT_MAX_BYTES) {
       renameSync2(path2, `${path2}.1`);
     }
     appendFileSync2(path2, line);
@@ -41906,14 +42267,14 @@ function appendIdentityAudit(path2, record2, line) {
 var yieldToLoop = () => new Promise((r) => setImmediate(r));
 function loadTurnCursors(path2) {
   try {
-    return new Map(Object.entries(JSON.parse(readFileSync13(path2, "utf8"))));
+    return new Map(Object.entries(JSON.parse(readFileSync14(path2, "utf8"))));
   } catch {
     return /* @__PURE__ */ new Map();
   }
 }
 function saveTurnCursors(path2, cursors) {
   try {
-    writeFileSync11(path2, JSON.stringify(Object.fromEntries(cursors)), "utf8");
+    writeFileSync12(path2, JSON.stringify(Object.fromEntries(cursors)), "utf8");
   } catch {
   }
 }
@@ -41935,7 +42296,7 @@ function gitSourceWatchTargets(root) {
         ["-C", root, "ls-files", "--others", "--ignored", "--exclude-standard", "--directory", "-z"],
         { encoding: "utf8", maxBuffer: 256 * 1024 * 1024, windowsHide: true, stdio: ["ignore", "pipe", "ignore"] }
       );
-      ignoredDirs = igOut.split("\0").filter(Boolean).map((d) => d.replace(/\/+$/, "")).filter((d) => !IGNORED_PATH.test(join19(root, d) + sep4));
+      ignoredDirs = igOut.split("\0").filter(Boolean).map((d) => d.replace(/\/+$/, "")).filter((d) => !IGNORED_PATH.test(join20(root, d) + sep4));
     } catch {
     }
     const hasIgnoredChild = (dir) => ignoredDirs.some((ig) => ig.startsWith(dir + "/"));
@@ -41947,19 +42308,19 @@ function gitSourceWatchTargets(root) {
         if (!f.startsWith(prefix)) continue;
         const rest2 = f.slice(prefix.length);
         if (rest2.includes("/")) children.add(dir === "" ? rest2.slice(0, rest2.indexOf("/")) : dir + "/" + rest2.slice(0, rest2.indexOf("/")));
-        else targets.add(join19(root, f));
+        else targets.add(join20(root, f));
       }
       for (const c of children) {
-        if (IGNORED_PATH.test(join19(root, c) + sep4)) continue;
+        if (IGNORED_PATH.test(join20(root, c) + sep4)) continue;
         if (hasIgnoredChild(c)) addUnder(c);
-        else targets.add(join19(root, c));
+        else targets.add(join20(root, c));
       }
     };
     addUnder("");
     if (targets.size > 0) return [...targets];
   } catch {
   }
-  return readdirSync7(root, { withFileTypes: true }).filter((e) => e.isDirectory() && !IGNORED_PATH.test(join19(root, String(e.name)) + sep4)).map((e) => join19(root, String(e.name)));
+  return readdirSync7(root, { withFileTypes: true }).filter((e) => e.isDirectory() && !IGNORED_PATH.test(join20(root, String(e.name)) + sep4)).map((e) => join20(root, String(e.name)));
 }
 function createWorkspaceEngine(opts) {
   const paths = workspacePaths(opts.workspaceRoot);
@@ -42111,7 +42472,7 @@ function createWorkspaceEngine(opts) {
       const srcPaths = diff.changedPaths.filter((p) => /\.(ts|tsx|js|jsx|mjs|cjs|py)$/i.test(p));
       let episodeId2;
       if (srcPaths.length > 0) {
-        const abs = srcPaths.map((p) => join19(opts.workspaceRoot, p));
+        const abs = srcPaths.map((p) => join20(opts.workspaceRoot, p));
         try {
           const r = await runReindexPass(
             `git-reindex:${profile.name} (${abs.length} files)`,
@@ -42142,8 +42503,8 @@ function createWorkspaceEngine(opts) {
         `[errata] git: ${ev.kind} ${ev.newSha.slice(0, 7)} by ${meta3.authorName} \u2014 ${diff.changedPaths.length} file(s), ${diff.renames.length} rename(s)`
       );
     };
-    const gitDir = join19(opts.workspaceRoot, ".git");
-    if (existsSync14(gitDir)) {
+    const gitDir = join20(opts.workspaceRoot, ".git");
+    if (existsSync15(gitDir)) {
       stopGit = startGitSensor(gitDir, (ev) => {
         void handleGitEvent(ev);
       });
@@ -42209,10 +42570,10 @@ function createWorkspaceEngine(opts) {
       ...pendingUpdate ? { pendingUpdate } : {}
     });
     doneRender?.();
-    const target = join19(opts.workspaceRoot, "AGENTS.md");
+    const target = join20(opts.workspaceRoot, "AGENTS.md");
     writeManagedBlock(target, { body: body2 });
     if (elicit) {
-      writePrimingHandles(join19(paths.configDir, "priming-handles.json"), [
+      writePrimingHandles(join20(paths.configDir, "priming-handles.json"), [
         ...snapshot.recentProblems.map((r) => r.node),
         // Resolved-band handles: the ✓ problem AND its Solution are citable
         // (a fix tag on an already-resolved problem no-ops idempotently; the
@@ -42382,7 +42743,7 @@ function createWorkspaceEngine(opts) {
       resultSummary: { exitCode: e.exitCode ?? 1, errorTokens: e.errorTokens }
     });
   };
-  const turnCursorPath = join19(paths.configDir, "turn-cursors.json");
+  const turnCursorPath = join20(paths.configDir, "turn-cursors.json");
   const lastTurnUuid = loadTurnCursors(turnCursorPath);
   const sessionLastProblem = /* @__PURE__ */ new Map();
   const sessionThreads = /* @__PURE__ */ new Map();
@@ -42405,7 +42766,7 @@ function createWorkspaceEngine(opts) {
     const t = Date.now();
     let processedTurns = 0;
     const elicit = isEdgeElicitationEnabled();
-    const handleMap = elicit ? readPrimingHandles(join19(paths.configDir, "priming-handles.json")) : {};
+    const handleMap = elicit ? readPrimingHandles(join20(paths.configDir, "priming-handles.json")) : {};
     const wsRoot = (opts.workspaceRoot ?? "").replace(/\\/g, "/");
     const toRel = (abs) => {
       const p = abs.replace(/\\/g, "/");
@@ -42922,7 +43283,21 @@ function createWorkspaceEngine(opts) {
       return report;
     },
     async nightly() {
-      return (await runNightly()).report;
+      const report = (await runNightly()).report;
+      const summarizer = opts.intentSummarizer ?? envIntentSummarizer();
+      if (summarizer) {
+        try {
+          const s = await runSymbolSummarySweep(store, opts.workspaceRoot, paths.configDir, summarizer);
+          if (s.generated > 0 || s.rejected > 0) {
+            console.log(
+              `[errata] symbol summaries: +${s.generated}${s.rejected > 0 ? ` (${s.rejected} rejected by no-verbatim check)` : ""}${s.remaining > 0 ? `, ${s.remaining} pending` : ""}`
+            );
+          }
+        } catch (err2) {
+          console.warn("[errata] symbol summary sweep failed:", err2 instanceof Error ? err2.message : err2);
+        }
+      }
+      return report;
     },
     async embedSettled() {
       try {
@@ -43010,7 +43385,7 @@ function createWorkspaceEngine(opts) {
         console.log(
           "[errata] sync skipped \u2014 cloud sync consent is off (enable with `errata consent sync on`)"
         );
-        const pending = existsSync14(paths.outbox) ? readdirSync7(paths.outbox).filter((f) => f.endsWith(".json")).length : 0;
+        const pending = existsSync15(paths.outbox) ? readdirSync7(paths.outbox).filter((f) => f.endsWith(".json")).length : 0;
         return { uploaded: 0, failed: 0, remaining: pending };
       }
       try {
@@ -43097,7 +43472,7 @@ async function startDaemon(opts) {
     reviewUrl: () => webUiUrl + "/review"
   });
   const writeLockFile = (url2) => {
-    writeFileSync12(
+    writeFileSync13(
       engine.paths.daemonLock,
       JSON.stringify({ pid: process.pid, webUiUrl: url2, startedAt: Date.now() }),
       "utf8"
@@ -43140,7 +43515,7 @@ async function startDaemon(opts) {
       );
       await engine.stop();
       try {
-        if (existsSync15(engine.paths.daemonLock)) {
+        if (existsSync16(engine.paths.daemonLock)) {
         }
       } catch {
       }
@@ -43157,16 +43532,16 @@ async function listenServer(fetchFn, port) {
 
 // src/registry.ts
 init_paths();
-import { existsSync as existsSync16, readFileSync as readFileSync14, writeFileSync as writeFileSync13 } from "node:fs";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync17, readFileSync as readFileSync15, writeFileSync as writeFileSync14 } from "node:fs";
+import { join as join21 } from "node:path";
 function registryPath() {
-  return process.env["ERRATA_REGISTRY_PATH"] ?? join20(globalDir(), "workspaces.json");
+  return process.env["ERRATA_REGISTRY_PATH"] ?? join21(globalDir(), "workspaces.json");
 }
 function read() {
   const p = registryPath();
-  if (!existsSync16(p)) return { version: 1, workspaces: {} };
+  if (!existsSync17(p)) return { version: 1, workspaces: {} };
   try {
-    const parsed = JSON.parse(readFileSync14(p, "utf8"));
+    const parsed = JSON.parse(readFileSync15(p, "utf8"));
     return { version: 1, workspaces: parsed.workspaces ?? {} };
   } catch {
     return { version: 1, workspaces: {} };
@@ -43174,7 +43549,7 @@ function read() {
 }
 function write(reg) {
   ensureDir(globalDir());
-  writeFileSync13(registryPath(), JSON.stringify(reg, null, 2), "utf8");
+  writeFileSync14(registryPath(), JSON.stringify(reg, null, 2), "utf8");
 }
 function registerWorkspace(profile, root, now = Date.now()) {
   const reg = read();
@@ -43191,7 +43566,7 @@ function pruneMissingWorkspaces() {
   const reg = read();
   const removed = [];
   for (const [id, entry] of Object.entries(reg.workspaces)) {
-    if (!existsSync16(entry.path)) {
+    if (!existsSync17(entry.path)) {
       removed.push(entry);
       delete reg.workspaces[id];
     }
@@ -43200,13 +43575,13 @@ function pruneMissingWorkspaces() {
   return removed;
 }
 function workspaceStatus(entry) {
-  const missing = !existsSync16(entry.path);
+  const missing = !existsSync17(entry.path);
   const lockPath = workspacePaths(entry.path).daemonLock;
   let running = false;
   let webUiUrl = null;
-  if (existsSync16(lockPath)) {
+  if (existsSync17(lockPath)) {
     try {
-      const lock = JSON.parse(readFileSync14(lockPath, "utf8"));
+      const lock = JSON.parse(readFileSync15(lockPath, "utf8"));
       if (lock.pid && lock.webUiUrl && pidAlive(lock.pid)) {
         running = true;
         webUiUrl = lock.webUiUrl;
@@ -43234,7 +43609,7 @@ function pidAlive(pid) {
 // src/multi.ts
 init_dist();
 init_src4();
-import { readFileSync as readFileSync17, unlinkSync as unlinkSync3, writeFileSync as writeFileSync14 } from "node:fs";
+import { readFileSync as readFileSync18, unlinkSync as unlinkSync3, writeFileSync as writeFileSync15 } from "node:fs";
 
 // src/principle-sync.ts
 init_src4();
@@ -43261,8 +43636,8 @@ async function syncPrinciples(store, cloud, opts) {
 init_reconcile();
 
 // src/lockfile-auto.ts
-import { existsSync as existsSync17, readFileSync as readFileSync15 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync18, readFileSync as readFileSync16 } from "node:fs";
+import { join as join22 } from "node:path";
 
 // src/package-index.ts
 init_src();
@@ -43526,11 +43901,11 @@ function runLockfilePass(opts) {
     { file: "package-lock.json", parse: parsePackageLockJson }
   ];
   for (const c of candidates) {
-    const p = join21(opts.root, c.file);
-    if (!existsSync17(p)) continue;
+    const p = join22(opts.root, c.file);
+    if (!existsSync18(p)) continue;
     let sbom;
     try {
-      sbom = c.parse(readFileSync15(p, "utf8"));
+      sbom = c.parse(readFileSync16(p, "utf8"));
     } catch {
       continue;
     }
@@ -43685,6 +44060,27 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
     }
   }
   if (nodes.length === 0 && anchorEdges.length === 0) return null;
+  let symbolSummaries;
+  if (opts.lexicon && opts.lexicon.size > 0 && nodes.length > 0) {
+    const lexicon = opts.lexicon;
+    const isKnown = (tok) => lexicon.has(tok);
+    const sidecar = {};
+    let count = 0;
+    outer: for (const n of nodes) {
+      if (!INSTANCE_LABELS.includes(n.label)) continue;
+      for (const tok of extractIdentifierTokens(n.description)) {
+        if (sidecar[tok]) continue;
+        const entry = lexicon.get(tok);
+        if (!entry?.summary) continue;
+        const scrubbed = generalize(entry.summary, { level }).text.trim();
+        if (!scrubbed || summaryRejectionReason(scrubbed, isKnown) !== null) continue;
+        if (count >= MAX_SIDECAR_SYMBOLS) break outer;
+        sidecar[tok] = { kind: entry.kind, summary: scrubbed };
+        count++;
+      }
+    }
+    if (count > 0) symbolSummaries = sidecar;
+  }
   const edges = [];
   for (const id of seen) {
     for (const e of store.outEdges(id, [...INSTANCE_EDGES])) {
@@ -43699,12 +44095,17 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
     // co-locates the few Language/Package stubs with the first instance chunk,
     // maximizing in-payload endpoint resolution.
     nodes: [...contextNodes, ...nodes],
-    edges
+    edges,
+    // Spread-if-present: an absent sidecar keeps `base` — and therefore the
+    // payloadDigest — byte-identical to the pre-sidecar batch (backward compat).
+    ...symbolSummaries ? { symbolSummaries } : {}
   };
   return { ...base, payloadDigest: digest(base), anchorDigests };
 }
 
 // src/multi.ts
+init_generalize_graph();
+init_symbol_summaries();
 init_webui();
 
 // src/consolidate-worker-client.ts
@@ -43780,7 +44181,7 @@ var ConsolidateWorker = class {
 init_paths();
 
 // src/lock.ts
-import { existsSync as existsSync18, readFileSync as readFileSync16 } from "node:fs";
+import { existsSync as existsSync19, readFileSync as readFileSync17 } from "node:fs";
 function isProcessAlive(pid) {
   if (!pid || pid <= 0) return false;
   try {
@@ -43791,9 +44192,9 @@ function isProcessAlive(pid) {
   }
 }
 function readDaemonLock(lockPath) {
-  if (!existsSync18(lockPath)) return null;
+  if (!existsSync19(lockPath)) return null;
   try {
-    const lock = JSON.parse(readFileSync16(lockPath, "utf8"));
+    const lock = JSON.parse(readFileSync17(lockPath, "utf8"));
     return typeof lock.pid === "number" ? lock : null;
   } catch {
     return null;
@@ -44041,7 +44442,7 @@ async function startMultiDaemon(opts = {}) {
     records.push(rec);
     app.route(`/ws/${rec.id}`, rec.webApp);
     try {
-      writeFileSync14(
+      writeFileSync15(
         rec.engine.paths.daemonLock,
         JSON.stringify({ pid: process.pid, webUiUrl: `${baseUrl}/ws/${rec.id}`, startedAt: Date.now() }),
         "utf8"
@@ -44224,7 +44625,7 @@ async function startMultiDaemon(opts = {}) {
   baseUrl = `http://127.0.0.1:${port}`;
   try {
     ensureDir(globalDir());
-    writeFileSync14(
+    writeFileSync15(
       lockPath,
       JSON.stringify({ pid: process.pid, webUiUrl: baseUrl, startedAt: Date.now() }),
       "utf8"
@@ -44233,7 +44634,7 @@ async function startMultiDaemon(opts = {}) {
   }
   for (const r of records) {
     try {
-      writeFileSync14(
+      writeFileSync15(
         r.engine.paths.daemonLock,
         JSON.stringify({ pid: process.pid, webUiUrl: `${baseUrl}/ws/${r.id}`, startedAt: Date.now() }),
         "utf8"
@@ -44445,8 +44846,15 @@ async function startMultiDaemon(opts = {}) {
           const res = await client.ingest(context);
           uploaded += res.accepted;
         }
+        let lexicon;
+        try {
+          const summaries = summariesByBodyHash(loadSymbolSummaryCache(r.engine.paths.configDir));
+          if (summaries.size > 0) lexicon = buildSymbolLexicon(store, summaries);
+        } catch {
+        }
         const instances = buildInstanceIngest(store, r.engine.profile, DAEMON_VERSION, ignore, {
-          includePackages: cfg2.consent.contributePackages
+          includePackages: cfg2.consent.contributePackages,
+          ...lexicon ? { lexicon } : {}
         });
         if (instances) {
           const res = await client.ingest(instances);
@@ -44529,7 +44937,7 @@ async function startMultiDaemon(opts = {}) {
     },
     async stop() {
       try {
-        const cur = readFileSync17(lockPath, "utf8");
+        const cur = readFileSync18(lockPath, "utf8");
         if (JSON.parse(cur).pid === process.pid) unlinkSync3(lockPath);
       } catch {
       }
@@ -44983,21 +45391,21 @@ async function cmdInit() {
   if (!skipHooks) {
     console.log("");
     console.log("installing harness hooks...");
-    const { existsSync: existsSync20 } = await import("node:fs");
-    const { join: join23 } = await import("node:path");
+    const { existsSync: existsSync21 } = await import("node:fs");
+    const { join: join24 } = await import("node:path");
     try {
       await installClaudeHooks(port);
     } catch (err2) {
       console.warn(`  \u26A0\uFE0F  Claude hook install failed: ${err2 instanceof Error ? err2.message : err2}`);
     }
-    if (existsSync20(join23(ROOT, ".cursor"))) {
+    if (existsSync21(join24(ROOT, ".cursor"))) {
       try {
         await installCursorMcpConfig();
       } catch (err2) {
         console.warn(`  \u26A0\uFE0F  Cursor MCP config failed: ${err2 instanceof Error ? err2.message : err2}`);
       }
     }
-    if (existsSync20(join23(ROOT, ".codex"))) {
+    if (existsSync21(join24(ROOT, ".codex"))) {
       try {
         await installCodexHooks(port);
       } catch (err2) {
@@ -45114,8 +45522,8 @@ async function cmdStatus() {
     console.log(`    stack:     ${profile.stack.join(", ") || "(none)"}`);
     console.log(`    languages: ${profile.languages.join(", ") || "(none)"}`);
   }
-  console.log(`  graph db:  ${existsSync19(paths.castalia) ? "yes" : "no"} (${paths.castalia})`);
-  console.log(`  event log: ${existsSync19(paths.eventLog) ? "yes" : "no"} (${paths.eventLog})`);
+  console.log(`  graph db:  ${existsSync20(paths.castalia) ? "yes" : "no"} (${paths.castalia})`);
+  console.log(`  event log: ${existsSync20(paths.eventLog) ? "yes" : "no"} (${paths.eventLog})`);
   const lockPath = globalDaemonLock();
   const running = isDaemonAlive(lockPath) ? readDaemonLock(lockPath) : null;
   console.log(
@@ -45411,11 +45819,11 @@ async function cmdLogout() {
 }
 async function cmdReview() {
   const paths = workspacePaths(ROOT);
-  if (!existsSync19(paths.reviewQueue)) {
+  if (!existsSync20(paths.reviewQueue)) {
     console.log("(review queue empty)");
     return;
   }
-  const queue = JSON.parse(readFileSync18(paths.reviewQueue, "utf8"));
+  const queue = JSON.parse(readFileSync19(paths.reviewQueue, "utf8"));
   if (queue.length === 0) {
     console.log("(review queue empty)");
     return;
@@ -46045,7 +46453,7 @@ async function gatherRepo(store, ws) {
   };
 }
 async function gatherReportData(generatedAt) {
-  const { existsSync: existsSync20 } = await import("node:fs");
+  const { existsSync: existsSync21 } = await import("node:fs");
   const { openGraphStore: openGraphStore2 } = await Promise.resolve().then(() => (init_src4(), src_exports2));
   const cfg = loadConfig();
   const outbound = cfg.consent.sync ? "auto" : "off";
@@ -46053,7 +46461,7 @@ async function gatherReportData(generatedAt) {
   for (const ws of listWorkspaces()) {
     if (ws.missing) continue;
     const dbPath = workspacePaths(ws.path).castalia;
-    if (!existsSync20(dbPath)) continue;
+    if (!existsSync21(dbPath)) continue;
     let store = null;
     try {
       store = openGraphStore2({ path: dbPath });
@@ -46084,7 +46492,7 @@ async function gatherReportData(generatedAt) {
   };
 }
 async function cmdReport(args2) {
-  const { mkdirSync: mkdirSync6, writeFileSync: writeFileSync15 } = await import("node:fs");
+  const { mkdirSync: mkdirSync6, writeFileSync: writeFileSync16 } = await import("node:fs");
   const { renderReport: renderReport2 } = await Promise.resolve().then(() => (init_report_render(), report_render_exports));
   const includeFutureVerbs = args2.includes("--future-verbs");
   const now = /* @__PURE__ */ new Date();
@@ -46097,8 +46505,8 @@ async function cmdReport(args2) {
   const outDir = workspacePaths(ROOT).configDir;
   mkdirSync6(outDir, { recursive: true });
   const files = renderReport2(data, { includeFutureVerbs });
-  for (const f of files) writeFileSync15(join22(outDir, f.name), f.html, "utf8");
-  const indexPath = join22(outDir, "report.html");
+  for (const f of files) writeFileSync16(join23(outDir, f.name), f.html, "utf8");
+  const indexPath = join23(outDir, "report.html");
   console.log(`report \u2192 ${indexPath}`);
   console.log(`  ${data.repos.length} repo(s) \xB7 ${files.length} file(s) \xB7 ${data.rollup.nodes.toLocaleString("en-US")} nodes`);
   console.log(`  open: file://${indexPath.replace(/\\/g, "/")}`);
@@ -46218,15 +46626,15 @@ function hookRelayCommand(port, path2) {
   return process.platform === "win32" ? `cmd //c "curl -s --connect-timeout 1 --max-time 2 -X POST -H \\"Content-Type: application/json\\" --data-binary @- ${url2} 2>NUL || echo {}"` : `curl -s --connect-timeout 1 --max-time 2 -X POST -H 'Content-Type: application/json' --data-binary @- ${url2} 2>/dev/null || echo '{}'`;
 }
 async function installClaudeHooks(port) {
-  const { mkdirSync: mkdirSync6, existsSync: existsSync20, readFileSync: readFileSync19, writeFileSync: writeFileSync15 } = await import("node:fs");
-  const { join: join23 } = await import("node:path");
-  const dir = join23(ROOT, ".claude");
-  if (!existsSync20(dir)) mkdirSync6(dir, { recursive: true });
-  const file2 = join23(dir, "settings.json");
+  const { mkdirSync: mkdirSync6, existsSync: existsSync21, readFileSync: readFileSync20, writeFileSync: writeFileSync16 } = await import("node:fs");
+  const { join: join24 } = await import("node:path");
+  const dir = join24(ROOT, ".claude");
+  if (!existsSync21(dir)) mkdirSync6(dir, { recursive: true });
+  const file2 = join24(dir, "settings.json");
   let settings = {};
-  if (existsSync20(file2)) {
+  if (existsSync21(file2)) {
     try {
-      settings = JSON.parse(readFileSync19(file2, "utf8"));
+      settings = JSON.parse(readFileSync20(file2, "utf8"));
     } catch {
       console.error(`refusing to overwrite invalid JSON at ${file2}`);
       process.exit(2);
@@ -46271,21 +46679,21 @@ async function installClaudeHooks(port) {
     dropErrata(list);
     list.push({ hooks: [{ type: "command", command: injectCmd }] });
   }
-  writeFileSync15(file2, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  writeFileSync16(file2, JSON.stringify(settings, null, 2) + "\n", "utf8");
   console.log(`installed Claude Code hooks \u2192 ${file2}`);
   await installClaudeMcpConfig();
   console.log(`  endpoint: http://127.0.0.1:${port}/api/hook`);
 }
 async function installClaudeMcpConfig() {
-  const { mkdirSync: mkdirSync6, existsSync: existsSync20, readFileSync: readFileSync19, writeFileSync: writeFileSync15 } = await import("node:fs");
-  const { join: join23, dirname: dirname8 } = await import("node:path");
-  const file2 = join23(ROOT, ".mcp.json");
+  const { mkdirSync: mkdirSync6, existsSync: existsSync21, readFileSync: readFileSync20, writeFileSync: writeFileSync16 } = await import("node:fs");
+  const { join: join24, dirname: dirname8 } = await import("node:path");
+  const file2 = join24(ROOT, ".mcp.json");
   const dir = dirname8(file2);
-  if (!existsSync20(dir)) mkdirSync6(dir, { recursive: true });
+  if (!existsSync21(dir)) mkdirSync6(dir, { recursive: true });
   let cfg = {};
-  if (existsSync20(file2)) {
+  if (existsSync21(file2)) {
     try {
-      cfg = JSON.parse(readFileSync19(file2, "utf8"));
+      cfg = JSON.parse(readFileSync20(file2, "utf8"));
     } catch {
       console.error(`refusing to overwrite invalid JSON at ${file2}`);
       process.exit(2);
@@ -46293,21 +46701,21 @@ async function installClaudeMcpConfig() {
   }
   cfg.mcpServers ??= {};
   cfg.mcpServers["errata"] = errataMcpInvocation();
-  writeFileSync15(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+  writeFileSync16(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
   console.log(`installed Claude Code MCP server config \u2192 ${file2}`);
   console.log(`  Claude Code will spawn \`errata mcp\` on workspace open.`);
   console.log(`  Tools: errata.search / locate / neighbors / callers_of / what_uses / show / similar`);
 }
 async function installCursorMcpConfig() {
-  const { mkdirSync: mkdirSync6, existsSync: existsSync20, readFileSync: readFileSync19, writeFileSync: writeFileSync15 } = await import("node:fs");
-  const { join: join23 } = await import("node:path");
-  const dir = join23(ROOT, ".cursor");
-  if (!existsSync20(dir)) mkdirSync6(dir, { recursive: true });
-  const file2 = join23(dir, "mcp.json");
+  const { mkdirSync: mkdirSync6, existsSync: existsSync21, readFileSync: readFileSync20, writeFileSync: writeFileSync16 } = await import("node:fs");
+  const { join: join24 } = await import("node:path");
+  const dir = join24(ROOT, ".cursor");
+  if (!existsSync21(dir)) mkdirSync6(dir, { recursive: true });
+  const file2 = join24(dir, "mcp.json");
   let cfg = {};
-  if (existsSync20(file2)) {
+  if (existsSync21(file2)) {
     try {
-      cfg = JSON.parse(readFileSync19(file2, "utf8"));
+      cfg = JSON.parse(readFileSync20(file2, "utf8"));
     } catch {
       console.error(`refusing to overwrite invalid JSON at ${file2}`);
       process.exit(2);
@@ -46315,7 +46723,7 @@ async function installCursorMcpConfig() {
   }
   cfg.mcpServers ??= {};
   cfg.mcpServers["errata"] = errataMcpInvocation();
-  writeFileSync15(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+  writeFileSync16(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
   console.log(`installed Cursor MCP server config \u2192 ${file2}`);
   console.log(`  Cursor will spawn \`errata mcp\` on workspace open.`);
   console.log(`  Tools: errata.search / locate / neighbors / callers_of / what_uses`);
@@ -46323,16 +46731,16 @@ async function installCursorMcpConfig() {
   console.log(`  \u26A0\uFE0F  reload Cursor (Cmd/Ctrl-Shift-P \u2192 "Reload Window") to pick it up.`);
 }
 async function installCodexHooks(port) {
-  const { mkdirSync: mkdirSync6, existsSync: existsSync20, readFileSync: readFileSync19, writeFileSync: writeFileSync15 } = await import("node:fs");
-  const { join: join23 } = await import("node:path");
-  const dir = join23(ROOT, ".codex");
-  if (!existsSync20(dir)) mkdirSync6(dir, { recursive: true });
-  const file2 = join23(dir, "config.toml");
+  const { mkdirSync: mkdirSync6, existsSync: existsSync21, readFileSync: readFileSync20, writeFileSync: writeFileSync16 } = await import("node:fs");
+  const { join: join24 } = await import("node:path");
+  const dir = join24(ROOT, ".codex");
+  if (!existsSync21(dir)) mkdirSync6(dir, { recursive: true });
+  const file2 = join24(dir, "config.toml");
   const BEGIN = `# >>> errata hooks (errata-managed)`;
   const END = `# <<< errata hooks`;
   let existing = "";
-  if (existsSync20(file2)) {
-    existing = readFileSync19(file2, "utf8");
+  if (existsSync21(file2)) {
+    existing = readFileSync20(file2, "utf8");
     const beginIdx = existing.indexOf(BEGIN);
     const endIdx = existing.indexOf(END);
     if (beginIdx >= 0 && endIdx > beginIdx) {
@@ -46361,7 +46769,7 @@ ${END}
   const final = existing.length > 0 && !existing.endsWith("\n") ? `${existing}
 
 ${block}` : existing + (existing.endsWith("\n\n") ? "" : "\n") + block;
-  writeFileSync15(file2, final, "utf8");
+  writeFileSync16(file2, final, "utf8");
   console.log(`installed Codex hooks \u2192 ${file2}`);
   console.log(`  endpoint: http://127.0.0.1:${port}/api/hook`);
   console.log("");
@@ -46624,7 +47032,7 @@ async function cmdDash(args2) {
       await yieldToLoop2();
       try {
         const items = selectDurableMemory(handle2.sharedStore, r.engine.profile);
-        const res = bleedRules(join22(r.root, ".claude", "rules"), items);
+        const res = bleedRules(join23(r.root, ".claude", "rules"), items);
         if (res.written || res.pruned) {
           console.log(
             `[rules:${r.entry.name}] ${res.written} collective principle(s) \u2192 .claude/rules` + (res.pruned ? `, ${res.pruned} pruned` : "")