eminiar 0.6.2 → 0.8.0

package/dist/server.js

@@ -3912,49 +3912,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative9, options, skipNormalization) {
+    function resolveComponent(base, relative10, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative9 = parse3(serialize(relative9, options), options);
+        relative10 = parse3(serialize(relative10, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative9.scheme) {
-        target.scheme = relative9.scheme;
-        target.userinfo = relative9.userinfo;
-        target.host = relative9.host;
-        target.port = relative9.port;
-        target.path = removeDotSegments(relative9.path || "");
-        target.query = relative9.query;
+      if (!options.tolerant && relative10.scheme) {
+        target.scheme = relative10.scheme;
+        target.userinfo = relative10.userinfo;
+        target.host = relative10.host;
+        target.port = relative10.port;
+        target.path = removeDotSegments(relative10.path || "");
+        target.query = relative10.query;
       } else {
-        if (relative9.userinfo !== void 0 || relative9.host !== void 0 || relative9.port !== void 0) {
-          target.userinfo = relative9.userinfo;
-          target.host = relative9.host;
-          target.port = relative9.port;
-          target.path = removeDotSegments(relative9.path || "");
-          target.query = relative9.query;
+        if (relative10.userinfo !== void 0 || relative10.host !== void 0 || relative10.port !== void 0) {
+          target.userinfo = relative10.userinfo;
+          target.host = relative10.host;
+          target.port = relative10.port;
+          target.path = removeDotSegments(relative10.path || "");
+          target.query = relative10.query;
         } else {
-          if (!relative9.path) {
+          if (!relative10.path) {
             target.path = base.path;
-            if (relative9.query !== void 0) {
-              target.query = relative9.query;
+            if (relative10.query !== void 0) {
+              target.query = relative10.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative9.path[0] === "/") {
-              target.path = removeDotSegments(relative9.path);
+            if (relative10.path[0] === "/") {
+              target.path = removeDotSegments(relative10.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative9.path;
+                target.path = "/" + relative10.path;
               } else if (!base.path) {
-                target.path = relative9.path;
+                target.path = relative10.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative9.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative10.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative9.query;
+            target.query = relative10.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -3962,7 +3962,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative9.fragment;
+      target.fragment = relative10.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -10015,9 +10015,9 @@ var require_parse2 = __commonJS({
                 const idx = prev.value.lastIndexOf("[");
                 const pre = prev.value.slice(0, idx);
                 const rest2 = prev.value.slice(idx + 2);
-                const posix = POSIX_REGEX_SOURCE[rest2];
-                if (posix) {
-                  prev.value = pre + posix;
+                const posix2 = POSIX_REGEX_SOURCE[rest2];
+                if (posix2) {
+                  prev.value = pre + posix2;
                   state.backtrack = true;
                   advance();
                   if (!bos.output && tokens.indexOf(prev) === 1) {
@@ -10539,7 +10539,7 @@ var require_picomatch = __commonJS({
         throw new TypeError("Expected pattern to be a non-empty string");
       }
       const opts = options || {};
-      const posix = utils.isWindows(options);
+      const posix2 = utils.isWindows(options);
       const regex = isState ? picomatch.compileRe(glob2, options) : picomatch.makeRe(glob2, options, false, true);
       const state = regex.state;
       delete regex.state;
@@ -10549,8 +10549,8 @@ var require_picomatch = __commonJS({
         isIgnored = picomatch(opts.ignore, ignoreOpts, returnState);
       }
       const matcher = (input2, returnObject = false) => {
-        const { isMatch, match, output: output2 } = picomatch.test(input2, regex, options, { glob: glob2, posix });
-        const result = { glob: glob2, state, regex, posix, input: input2, output: output2, match, isMatch };
+        const { isMatch, match, output: output2 } = picomatch.test(input2, regex, options, { glob: glob2, posix: posix2 });
+        const result = { glob: glob2, state, regex, posix: posix2, input: input2, output: output2, match, isMatch };
         if (typeof opts.onResult === "function") {
           opts.onResult(result);
         }
@@ -10575,7 +10575,7 @@ var require_picomatch = __commonJS({
       }
       return matcher;
     };
-    picomatch.test = (input2, regex, options, { glob: glob2, posix } = {}) => {
+    picomatch.test = (input2, regex, options, { glob: glob2, posix: posix2 } = {}) => {
       if (typeof input2 !== "string") {
         throw new TypeError("Expected input to be a string");
       }
@@ -10583,7 +10583,7 @@ var require_picomatch = __commonJS({
         return { isMatch: false, output: "" };
       }
       const opts = options || {};
-      const format = opts.format || (posix ? utils.toPosixSlashes : null);
+      const format = opts.format || (posix2 ? utils.toPosixSlashes : null);
       let match = input2 === glob2;
       let output2 = match && format ? format(input2) : input2;
       if (match === false) {
@@ -10592,14 +10592,14 @@ var require_picomatch = __commonJS({
       }
       if (match === false || opts.capture === true) {
         if (opts.matchBase === true || opts.basename === true) {
-          match = picomatch.matchBase(input2, regex, options, posix);
+          match = picomatch.matchBase(input2, regex, options, posix2);
         } else {
           match = regex.exec(output2);
         }
       }
       return { isMatch: Boolean(match), match, output: output2 };
     };
-    picomatch.matchBase = (input2, glob2, options, posix = utils.isWindows(options)) => {
+    picomatch.matchBase = (input2, glob2, options, posix2 = utils.isWindows(options)) => {
       const regex = glob2 instanceof RegExp ? glob2 : picomatch.makeRe(glob2, options);
       return regex.test(path3.basename(input2));
     };
@@ -10790,9 +10790,9 @@ var require_micromatch = __commonJS({
       return [].concat(patterns).every((p) => picomatch(p, options)(str2));
     };
     micromatch.capture = (glob2, input2, options) => {
-      let posix = utils.isWindows(options);
+      let posix2 = utils.isWindows(options);
       let regex = picomatch.makeRe(String(glob2), { ...options, capture: true });
-      let match = regex.exec(posix ? utils.toPosixSlashes(input2) : input2);
+      let match = regex.exec(posix2 ? utils.toPosixSlashes(input2) : input2);
       if (match) {
         return match.slice(1).map((v) => v === void 0 ? "" : v);
       }
@@ -10972,15 +10972,15 @@ var require_pattern2 = __commonJS({
     exports.removeDuplicateSlashes = removeDuplicateSlashes;
     function partitionAbsoluteAndRelative(patterns) {
       const absolute = [];
-      const relative9 = [];
+      const relative10 = [];
       for (const pattern2 of patterns) {
         if (isAbsolute2(pattern2)) {
           absolute.push(pattern2);
         } else {
-          relative9.push(pattern2);
+          relative10.push(pattern2);
         }
       }
-      return [absolute, relative9];
+      return [absolute, relative10];
     }
     exports.partitionAbsoluteAndRelative = partitionAbsoluteAndRelative;
     function isAbsolute2(pattern2) {
@@ -11411,11 +11411,11 @@ var require_out = __commonJS({
       async.read(path3, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports.stat = stat;
-    function statSync10(path3, optionsOrSettings) {
+    function statSync11(path3, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
       return sync.read(path3, settings);
     }
-    exports.statSync = statSync10;
+    exports.statSync = statSync11;
     function getSettings(settingsOrOptions = {}) {
       if (settingsOrOptions instanceof settings_1.default) {
         return settingsOrOptions;
@@ -13295,19 +13295,19 @@ var require_out4 = __commonJS({
         return utils.path.convertPathToPattern(source);
       }
       FastGlob2.convertPathToPattern = convertPathToPattern;
-      let posix;
-      (function(posix2) {
+      let posix2;
+      (function(posix3) {
         function escapePath2(source) {
           assertPatternsInput(source);
           return utils.path.escapePosixPath(source);
         }
-        posix2.escapePath = escapePath2;
+        posix3.escapePath = escapePath2;
         function convertPathToPattern2(source) {
           assertPatternsInput(source);
           return utils.path.convertPosixPathToPattern(source);
         }
-        posix2.convertPathToPattern = convertPathToPattern2;
-      })(posix = FastGlob2.posix || (FastGlob2.posix = {}));
+        posix3.convertPathToPattern = convertPathToPattern2;
+      })(posix2 = FastGlob2.posix || (FastGlob2.posix = {}));
       let win32;
       (function(win322) {
         function escapePath2(source) {
@@ -13790,13 +13790,14 @@ function fileOf(id) {
   if (kind === "sym") return rest.split("#")[0];
   return void 0;
 }
-var fileId, memoryId, symId, pkgId, personId, conceptId;
+var fileId, memoryId, docId, symId, pkgId, personId, conceptId;
 var init_ids = __esm({
   "src/graph/ids.ts"() {
     "use strict";
     init_esm_shims();
     fileId = (rel) => `file:${rel}`;
     memoryId = (name) => `memory:${name}`;
+    docId = (name) => `doc:${name}`;
     symId = (rel, name) => `sym:${rel}#${name}`;
     pkgId = (name) => `pkg:${name}`;
     personId = (name) => `person:${name}`;
@@ -18022,10 +18023,13 @@ __export(store_exports, {
   isValidName: () => isValidName,
   list: () => list,
   memoriesDir: () => memoriesDir,
+  memoriesRel: () => memoriesRel,
+  memoryLinks: () => memoryLinks,
   normalizeRelated: () => normalizeRelated,
   read: () => read,
   reconcile: () => reconcile,
   relOf: () => relOf,
+  relatedTarget: () => relatedTarget,
   remove: () => remove,
   rename: () => rename,
   setMeta: () => setMeta,
@@ -18101,6 +18105,17 @@ function normalizeRelated(ids) {
   }
   return [...out];
 }
+function relatedTarget(id) {
+  return id.startsWith("mem:") ? memoryId(id.slice(4)) : id;
+}
+function memoryLinks(body, self) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of body.matchAll(MEM_LINK_RE)) {
+    const name = m[1].replace(/[.-]+$/, "");
+    if (name && name !== self && isValidName(name)) out.add(name);
+  }
+  return [...out];
+}
 function writeMemoryFile(ctx, name, meta4, body) {
   const abs = absOf(ctx, name);
   mkdirSync3(dirname7(abs), { recursive: true });
@@ -18108,36 +18123,30 @@ function writeMemoryFile(ctx, name, meta4, body) {
 ${body.trim()}
 `));
 }
-function syncGraph(db, name, rel, kind, tags, related, supersedes) {
+function syncGraph(db, name, rel, g) {
+  const self = memoryId(name);
   db.graphDeleteForPath("curated", rel);
   db.graphUpsertNodes([
     {
-      id: memoryId(name),
+      id: self,
       kind: "memory",
       name,
       path: rel,
       source: "curated",
-      meta: { kind, tags }
+      meta: { kind: g.kind, tags: g.tags, ...g.status ? { status: g.status } : {} }
     }
   ]);
-  const edges = related.map((dst) => ({
-    src: memoryId(name),
-    dst,
-    kind: "mentions",
-    source: "curated",
-    confidence: 1,
-    weight: 1
-  }));
-  if (supersedes) {
-    edges.push({
-      src: memoryId(name),
-      dst: memoryId(supersedes),
-      kind: "supersedes",
-      source: "curated",
-      confidence: 1,
-      weight: 1
-    });
-  }
+  const edges = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (dst, kind) => {
+    const key = `${kind}|${dst}`;
+    if (dst === self || seen.has(key)) return;
+    seen.add(key);
+    edges.push({ src: self, dst, kind, source: "curated", confidence: 1, weight: 1 });
+  };
+  for (const id of g.related) push(relatedTarget(id), "mentions");
+  for (const other of memoryLinks(g.body, name)) push(memoryId(other), "links");
+  if (g.supersedes) push(memoryId(g.supersedes.replace(/^mem(?:ory)?:/, "")), "supersedes");
   if (edges.length) db.graphUpsertEdges(edges);
 }
 function forgetInDb(db, name, rel) {
@@ -18224,7 +18233,7 @@ tags: ${tags.join(", ")}` : ""}`,
     status,
     supersedes
   });
-  syncGraph(db, name, rel, kind, tags, related, supersedes);
+  syncGraph(db, name, rel, { kind, tags, related, status, supersedes, body });
   return { changed: true, row: db.memoryGetByName(name) };
 }
 function setMeta(ctx, db, name, patch) {
@@ -18427,7 +18436,7 @@ function gitignoreHint(ctx) {
   const ignored = readFileSync8(file3, "utf8").split(/\r?\n/).map((l) => l.trim().replace(/^\//, "").replace(/\/$/, "")).some((l) => l === top || l === dir || l === `${top}/**` || l === `${dir}/**`);
   return ignored ? `note: .gitignore ignores ${dir}, so memories stay local to this machine (remove that line to share them with the team)` : void 0;
 }
-var import_fast_glob3, MEMORY_KINDS, SEGMENT, NAME_RE, hinted;
+var import_fast_glob3, MEMORY_KINDS, SEGMENT, NAME_RE, MEM_LINK_RE, hinted;
 var init_store = __esm({
   "src/memory/store.ts"() {
     "use strict";
@@ -18449,6 +18458,7 @@ var init_store = __esm({
     ];
     SEGMENT = "[a-z0-9][a-z0-9._-]*";
     NAME_RE = new RegExp(`^(?:${SEGMENT}/)?${SEGMENT}$`);
+    MEM_LINK_RE = /(?<![A-Za-z0-9_./-])mem:([a-z0-9][a-z0-9._-]*(?:\/[a-z0-9][a-z0-9._-]*)?)/g;
     hinted = /* @__PURE__ */ new Set();
   }
 });
@@ -50808,9 +50818,10 @@ function impact(db, ref, opts = {}) {
     frontier = next;
     if (!frontier.length) break;
   }
-  for (const e of db.graphEdgesTo(start, ["mentions"])) {
+  for (const e of db.graphEdgesTo(start, ["mentions", "documents"])) {
     const via = e.dst === root.id ? root.name : e.dst.replace(/^sym:[^#]*#/, "");
-    add(e.src, 0.5 * e.confidence, 1, `memory mentions ${via}`);
+    const who = e.kind === "documents" ? "doc documents" : "memory mentions";
+    add(e.src, 0.5 * e.confidence, 1, `${who} ${via}`);
   }
   if (opts.includeGit !== false) {
     const file3 = toFile(root.id);
@@ -51231,7 +51242,7 @@ function architecture(ctx, db, aspects = ASPECTS) {
   for (const l of languages2.values()) langCounts[l] = (langCounts[l] ?? 0) + 1;
   const counts = db.graphCounts();
   const nodeCounts = db.graphNodeCounts();
-  const symbols = Object.entries(nodeCounts).filter(([k]) => !["file", "package", "person", "concept", "memory"].includes(k)).reduce((a, [, n]) => a + n, 0);
+  const symbols = Object.entries(nodeCounts).filter(([k]) => !["file", "package", "person", "concept", "memory", "doc"].includes(k)).reduce((a, [, n]) => a + n, 0);
   const out = {
     project: {
       name: typeof pkg.name === "string" ? pkg.name : void 0,
@@ -55141,6 +55152,309 @@ function discoverDocs(ctx, opts = {}) {
   };
 }
 
+// src/docs/graph.ts
+init_esm_shims();
+init_ids();
+import { existsSync as existsSync14, statSync as statSync10 } from "fs";
+import { dirname as dirname9, posix, relative as relative8, sep as sep2 } from "path";
+
+// src/docs/category.ts
+init_esm_shims();
+var DOC_CATEGORIES = [
+  {
+    id: "readme",
+    group: "project",
+    label: "Readme & guides",
+    blurb: "README, CONTRIBUTING, CHANGELOG and other top-level guides"
+  },
+  {
+    id: "guides",
+    group: "project",
+    label: "Docs folders",
+    blurb: "docs/ directories: handbooks, how-tos, references"
+  },
+  {
+    id: "adr",
+    group: "project",
+    label: "Decision records",
+    blurb: "architecture decision records"
+  },
+  {
+    id: "agent-instructions",
+    group: "project",
+    label: "Agent instructions",
+    blurb: "Copilot, Claude and Cursor instructions, agents and skills"
+  },
+  {
+    id: "api-specs",
+    group: "project",
+    label: "API specs",
+    blurb: "OpenAPI, Postman, GraphQL and protobuf definitions"
+  },
+  {
+    id: "env-reference",
+    group: "project",
+    label: "Environment reference",
+    blurb: ".env examples: every variable the project reads"
+  },
+  {
+    id: "deploy-config",
+    group: "project",
+    label: "Deploy config",
+    blurb: "Terraform, Kubernetes, Helm, Compose and CI workflows"
+  },
+  { id: "local", group: "project", label: "Other local files", blurb: "hand-registered paths" },
+  {
+    id: "service",
+    group: "external",
+    label: "Services",
+    blurb: "third-party products and APIs the project integrates"
+  },
+  {
+    id: "api",
+    group: "external",
+    label: "External APIs",
+    blurb: "hosts the code calls, found by probing their docs"
+  },
+  {
+    id: "infra",
+    group: "external",
+    label: "Infrastructure",
+    blurb: "platforms the project runs on"
+  },
+  { id: "library", group: "external", label: "Libraries", blurb: "frameworks and packages" },
+  { id: "web", group: "external", label: "Web pages", blurb: "hand-registered URLs" }
+];
+var BY_ID = new Map(DOC_CATEGORIES.map((c) => [c.id, c]));
+function categoryInfo(id) {
+  return BY_ID.get(id) ?? BY_ID.get("local");
+}
+var GROUP_LABELS = {
+  project: "Project documentation",
+  external: "External documentation"
+};
+var TITLE_RULES = [
+  [/^project readme/i, "readme"],
+  [/^(docs|doc|documentation)\/ directory$/i, "guides"],
+  [/decision records/i, "adr"],
+  [/copilot|claude|cursor/i, "agent-instructions"],
+  [/openapi|postman|graphql|protobuf/i, "api-specs"],
+  [/environment variable/i, "env-reference"],
+  [/terraform|kubernetes|helm|compose|workflow/i, "deploy-config"]
+];
+var NAME_RULES = [
+  [/(^|-)readme$/, "readme"],
+  [/(^|-)docs$/, "guides"],
+  [/(^|-)adrs?$/, "adr"],
+  [/(^|-)agent-instructions$/, "agent-instructions"],
+  [/(^|-)api-specs$/, "api-specs"],
+  [/(^|-)env-example$/, "env-reference"],
+  [/(^|-)deploy-config$/, "deploy-config"]
+];
+var GLOB_RULES = [
+  [/openapi|swagger|postman_collection|asyncapi|\.graphql$|\.proto$/i, "api-specs"],
+  [/^\.env\./, "env-reference"],
+  [
+    /\.tf$|tfvars|^k8s\/|^helm\/|^charts\/|^manifests\/|compose.*\.ya?ml|\.github\/workflows/i,
+    "deploy-config"
+  ],
+  [
+    /copilot-instructions|\.github\/(instructions|agents|skills)|\.claude\/(agents|skills)|\.cursor\/rules|^(AGENTS|CLAUDE)\.md$/i,
+    "agent-instructions"
+  ],
+  [/^(README|CONTRIBUTING|CHANGELOG|SECURITY)(\.md)?$/i, "readme"],
+  [/^\*\*\/\*\.(md|mdx|rst|txt)$/i, "guides"]
+];
+function localCategory(s) {
+  const title = s.title ?? "";
+  for (const [re, cat] of TITLE_RULES) if (re.test(title)) return cat;
+  for (const [re, cat] of NAME_RULES) if (re.test(s.name)) return cat;
+  const path3 = s.path ?? "";
+  if (/(^|\/)(adrs?|decisions)$/i.test(path3)) return "adr";
+  const globs = s.glob ?? [];
+  const hits = /* @__PURE__ */ new Map();
+  for (const g of globs)
+    for (const [re, cat] of GLOB_RULES)
+      if (re.test(g)) {
+        hits.set(cat, (hits.get(cat) ?? 0) + 1);
+        break;
+      }
+  if (hits.size) return [...hits.entries()].sort((a, b) => b[1] - a[1])[0][0];
+  if (/(^|\/)(docs?|documentation)$/i.test(path3)) return "guides";
+  if (/README|CONTRIBUTING|CHANGELOG/i.test(path3)) return "readme";
+  return "local";
+}
+function docCategory(s, entry) {
+  if (s.kind === "path") return localCategory(s);
+  if (entry) {
+    const tier = entry.tier ?? "library";
+    return tier === "service" ? "service" : tier === "infra" ? "infra" : "library";
+  }
+  const provider = s.provider ?? "";
+  const i = provider.indexOf(":");
+  const kind = i === -1 ? provider : provider.slice(0, i);
+  switch (kind) {
+    case "api":
+      return "api";
+    case "env":
+      return "service";
+    case "image":
+    case "files":
+      return "infra";
+    case "npm":
+    case "pypi":
+    case "go":
+      return "library";
+    default:
+      return "web";
+  }
+}
+function categoryRank(id) {
+  const i = DOC_CATEGORIES.findIndex((c) => c.id === id);
+  return i === -1 ? DOC_CATEGORIES.length : i;
+}
+
+// src/docs/graph.ts
+var DOCUMENTS_EDGE = "documents";
+var MAX_PAGES = 500;
+var MAX_EDGES = 400;
+var PATH_RE = /(?:^|[\s(`'"[<])((?:\.{1,2}\/)*(?:[\w@.-]+\/)+[\w@.-]+\.[A-Za-z0-9]{1,8})(?=$|[\s)`'"\]>:#,;!?]|\.(?:\s|$))/gm;
+function manifestRel(ctx) {
+  return relative8(ctx.root, manifestPath(ctx)).split(sep2).join("/");
+}
+function packageCandidates(provider) {
+  if (!provider) return [];
+  const i = provider.indexOf(":");
+  if (i === -1) return [];
+  const kind = provider.slice(0, i);
+  const name = provider.slice(i + 1).trim();
+  if (!name) return [];
+  if (kind === "npm" || kind === "go") return [pkgId(name)];
+  if (kind === "pypi") {
+    const lower = name.toLowerCase();
+    return [.../* @__PURE__ */ new Set([pkgId(lower.replace(/-/g, "_")), pkgId(lower), pkgId(name)])];
+  }
+  return [];
+}
+function pathsIn(text2, pageRel, files) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of text2.matchAll(PATH_RE)) {
+    const raw = m[1];
+    const tries = [raw.replace(/^(\.\/)+/, "")];
+    if (pageRel && raw.startsWith("."))
+      tries.unshift(posix.normalize(posix.join(dirname9(pageRel), raw)));
+    for (const t of tries) {
+      if (files.has(t)) {
+        out.add(t);
+        break;
+      }
+    }
+  }
+  return [...out];
+}
+function pageRelOf(ctx, uri) {
+  if (!uri?.startsWith("file://")) return void 0;
+  const rel = relative8(ctx.root, uri.slice("file://".length)).split(sep2).join("/");
+  return rel.startsWith("..") ? void 0 : rel;
+}
+function localEdges(ctx, db, src, files) {
+  const id = docId(src.name);
+  const hits = /* @__PURE__ */ new Map();
+  for (const page of db.documentsBySource(docsTag(src.name), MAX_PAGES)) {
+    const rel = pageRelOf(ctx, page.uri);
+    if (rel && files.has(rel)) hits.set(rel, { via: "covers", count: 1 });
+    const text2 = db.chunksOfDocument(page.id).map((c) => c.body).join("\n");
+    for (const f of pathsIn(text2, rel, files)) {
+      const h = hits.get(f);
+      if (h) h.count++;
+      else hits.set(f, { via: "mentions", count: 1 });
+    }
+    if (hits.size >= MAX_EDGES) break;
+  }
+  return [...hits].sort((a, b) => b[1].count - a[1].count).slice(0, MAX_EDGES).map(([rel, h]) => ({
+    src: id,
+    dst: `file:${rel}`,
+    kind: DOCUMENTS_EDGE,
+    source: "curated",
+    confidence: h.via === "covers" ? 1 : 0.8,
+    weight: Math.min(1, 0.5 + h.count / 10),
+    meta: { via: h.via, count: h.count }
+  }));
+}
+function packageEdges(src, packages) {
+  const id = docId(src.name);
+  const cands = packageCandidates(src.provider);
+  if (!cands.length) return [];
+  let targets = cands.filter((c) => packages.has(c));
+  if (src.provider?.startsWith("go:"))
+    targets = [...targets, ...[...packages].filter((p) => p.startsWith(`${cands[0]}/`))];
+  if (!targets.length) targets = [cands[0]];
+  return [...new Set(targets)].map((dst) => ({
+    src: id,
+    dst,
+    kind: DOCUMENTS_EDGE,
+    source: "curated",
+    confidence: 1,
+    weight: 1,
+    meta: { via: "provider" }
+  }));
+}
+var STAMP_KEY = "docs.graph.stamp";
+function stampOf(ctx, db) {
+  const file3 = manifestPath(ctx);
+  const st = existsSync14(file3) ? statSync10(file3) : void 0;
+  const counts = db.graphNodeCounts();
+  const syncs = readManifest(ctx).sources.map((s) => syncState(db, s.name)?.at ?? 0).join(",");
+  return `${st ? `${Math.floor(st.mtimeMs)}:${st.size}` : "none"}|${counts.file ?? 0}|${counts.package ?? 0}|${syncs}`;
+}
+function syncDocsGraph(ctx, db) {
+  const rel = manifestRel(ctx);
+  const m = readManifest(ctx);
+  const catalog = mergedCatalog(ctx.config.docs.catalog);
+  const files = new Set(
+    db.graphFileNodes().filter((n) => n.source === "tree-sitter" && n.path).map((n) => n.path)
+  );
+  const packages = new Set(db.graphNodesByKind(["package"]).map((n) => n.id));
+  const nodes = [];
+  const edges = [];
+  for (const s of m.sources) {
+    const category = docCategory(
+      s,
+      s.provider ? catalogForProvider(s.provider, catalog) : void 0
+    );
+    nodes.push({
+      id: docId(s.name),
+      kind: "doc",
+      name: s.name,
+      path: rel,
+      source: "curated",
+      meta: {
+        category,
+        group: categoryInfo(category).group,
+        sourceKind: s.kind,
+        ...s.provider ? { provider: s.provider } : {},
+        ...s.title ? { title: s.title } : {},
+        ...s.tags?.length ? { tags: s.tags } : {},
+        ...s.kind === "path" ? { target: s.path } : { url: s.urls?.[0] },
+        documents: db.countDocuments(docsTag(s.name))
+      }
+    });
+    edges.push(...packageEdges(s, packages));
+    if (s.kind === "path") edges.push(...localEdges(ctx, db, s, files));
+  }
+  db.graphDeleteForPath("curated", rel, { keepFile: true });
+  if (nodes.length) db.graphUpsertNodes(nodes);
+  if (edges.length) db.graphUpsertEdges(edges);
+  db.metaSet(STAMP_KEY, stampOf(ctx, db));
+  return { sources: nodes.length, edges: edges.length };
+}
+function syncDocsGraphQuietly(ctx, db) {
+  try {
+    syncDocsGraph(ctx, db);
+  } catch {
+  }
+}
+
 // src/docs/resolve.ts
 init_esm_shims();
 async function getJson(url2, opts) {
@@ -56009,6 +56323,7 @@ async function syncSources(ctx, db, names, opts = {}) {
       });
   }
   for (const src of wanted) out.push(await syncSource(ctx, db, src, opts));
+  syncDocsGraphQuietly(ctx, db);
   return out;
 }
 function formatSync(results) {
@@ -56178,12 +56493,14 @@ async function addDocSources(ctx, db, inputs, opts = {}) {
   const names = [...out.added, ...out.updated];
   if (opts.sync !== false && names.length)
     out.sync = await syncSources(ctx, db, names, { force: opts.force });
+  else if (names.length) syncDocsGraphQuietly(ctx, db);
   return out;
 }
 function removeDocSource(ctx, db, name) {
   const removed = removeSource(ctx, name);
   const documents = db.deleteDocumentsBySource(docsTag(name));
   clearSyncState(db, name);
+  if (removed) syncDocsGraphQuietly(ctx, db);
   return { removed, documents };
 }
 function formatAdd(o) {
@@ -56211,162 +56528,6 @@ async function addPicked(ctx, db, pick2, opts) {
   );
 }
 
-// src/docs/category.ts
-init_esm_shims();
-var DOC_CATEGORIES = [
-  {
-    id: "readme",
-    group: "project",
-    label: "Readme & guides",
-    blurb: "README, CONTRIBUTING, CHANGELOG and other top-level guides"
-  },
-  {
-    id: "guides",
-    group: "project",
-    label: "Docs folders",
-    blurb: "docs/ directories: handbooks, how-tos, references"
-  },
-  {
-    id: "adr",
-    group: "project",
-    label: "Decision records",
-    blurb: "architecture decision records"
-  },
-  {
-    id: "agent-instructions",
-    group: "project",
-    label: "Agent instructions",
-    blurb: "Copilot, Claude and Cursor instructions, agents and skills"
-  },
-  {
-    id: "api-specs",
-    group: "project",
-    label: "API specs",
-    blurb: "OpenAPI, Postman, GraphQL and protobuf definitions"
-  },
-  {
-    id: "env-reference",
-    group: "project",
-    label: "Environment reference",
-    blurb: ".env examples: every variable the project reads"
-  },
-  {
-    id: "deploy-config",
-    group: "project",
-    label: "Deploy config",
-    blurb: "Terraform, Kubernetes, Helm, Compose and CI workflows"
-  },
-  { id: "local", group: "project", label: "Other local files", blurb: "hand-registered paths" },
-  {
-    id: "service",
-    group: "external",
-    label: "Services",
-    blurb: "third-party products and APIs the project integrates"
-  },
-  {
-    id: "api",
-    group: "external",
-    label: "External APIs",
-    blurb: "hosts the code calls, found by probing their docs"
-  },
-  {
-    id: "infra",
-    group: "external",
-    label: "Infrastructure",
-    blurb: "platforms the project runs on"
-  },
-  { id: "library", group: "external", label: "Libraries", blurb: "frameworks and packages" },
-  { id: "web", group: "external", label: "Web pages", blurb: "hand-registered URLs" }
-];
-var BY_ID = new Map(DOC_CATEGORIES.map((c) => [c.id, c]));
-function categoryInfo(id) {
-  return BY_ID.get(id) ?? BY_ID.get("local");
-}
-var GROUP_LABELS = {
-  project: "Project documentation",
-  external: "External documentation"
-};
-var TITLE_RULES = [
-  [/^project readme/i, "readme"],
-  [/^(docs|doc|documentation)\/ directory$/i, "guides"],
-  [/decision records/i, "adr"],
-  [/copilot|claude|cursor/i, "agent-instructions"],
-  [/openapi|postman|graphql|protobuf/i, "api-specs"],
-  [/environment variable/i, "env-reference"],
-  [/terraform|kubernetes|helm|compose|workflow/i, "deploy-config"]
-];
-var NAME_RULES = [
-  [/(^|-)readme$/, "readme"],
-  [/(^|-)docs$/, "guides"],
-  [/(^|-)adrs?$/, "adr"],
-  [/(^|-)agent-instructions$/, "agent-instructions"],
-  [/(^|-)api-specs$/, "api-specs"],
-  [/(^|-)env-example$/, "env-reference"],
-  [/(^|-)deploy-config$/, "deploy-config"]
-];
-var GLOB_RULES = [
-  [/openapi|swagger|postman_collection|asyncapi|\.graphql$|\.proto$/i, "api-specs"],
-  [/^\.env\./, "env-reference"],
-  [
-    /\.tf$|tfvars|^k8s\/|^helm\/|^charts\/|^manifests\/|compose.*\.ya?ml|\.github\/workflows/i,
-    "deploy-config"
-  ],
-  [
-    /copilot-instructions|\.github\/(instructions|agents|skills)|\.claude\/(agents|skills)|\.cursor\/rules|^(AGENTS|CLAUDE)\.md$/i,
-    "agent-instructions"
-  ],
-  [/^(README|CONTRIBUTING|CHANGELOG|SECURITY)(\.md)?$/i, "readme"],
-  [/^\*\*\/\*\.(md|mdx|rst|txt)$/i, "guides"]
-];
-function localCategory(s) {
-  const title = s.title ?? "";
-  for (const [re, cat] of TITLE_RULES) if (re.test(title)) return cat;
-  for (const [re, cat] of NAME_RULES) if (re.test(s.name)) return cat;
-  const path3 = s.path ?? "";
-  if (/(^|\/)(adrs?|decisions)$/i.test(path3)) return "adr";
-  const globs = s.glob ?? [];
-  const hits = /* @__PURE__ */ new Map();
-  for (const g of globs)
-    for (const [re, cat] of GLOB_RULES)
-      if (re.test(g)) {
-        hits.set(cat, (hits.get(cat) ?? 0) + 1);
-        break;
-      }
-  if (hits.size) return [...hits.entries()].sort((a, b) => b[1] - a[1])[0][0];
-  if (/(^|\/)(docs?|documentation)$/i.test(path3)) return "guides";
-  if (/README|CONTRIBUTING|CHANGELOG/i.test(path3)) return "readme";
-  return "local";
-}
-function docCategory(s, entry) {
-  if (s.kind === "path") return localCategory(s);
-  if (entry) {
-    const tier = entry.tier ?? "library";
-    return tier === "service" ? "service" : tier === "infra" ? "infra" : "library";
-  }
-  const provider = s.provider ?? "";
-  const i = provider.indexOf(":");
-  const kind = i === -1 ? provider : provider.slice(0, i);
-  switch (kind) {
-    case "api":
-      return "api";
-    case "env":
-      return "service";
-    case "image":
-    case "files":
-      return "infra";
-    case "npm":
-    case "pypi":
-    case "go":
-      return "library";
-    default:
-      return "web";
-  }
-}
-function categoryRank(id) {
-  const i = DOC_CATEGORIES.findIndex((c) => c.id === id);
-  return i === -1 ? DOC_CATEGORIES.length : i;
-}
-
 // src/tools/em_docs.ts
 init_queue();
 var sourceShape2 = {
@@ -56674,7 +56835,7 @@ init_esm_shims();
 init_esm_shims();
 init_paths();
 init_version();
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync14, readFileSync as readFileSync14 } from "fs";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync15, readFileSync as readFileSync14 } from "fs";
 import { createRequire as createRequire3 } from "module";
 import { join as join20 } from "path";
 var require4 = createRequire3(import.meta.url);
@@ -56705,7 +56866,7 @@ function runDoctor() {
   );
   checks.push(
     check2("node-path pin", () => {
-      if (!existsSync14(p.nodePathFile)) return "not pinned (run `eminiar install`); using PATH node";
+      if (!existsSync15(p.nodePathFile)) return "not pinned (run `eminiar install`); using PATH node";
       const pinned = readFileSync14(p.nodePathFile, "utf8").trim();
       accessSync2(pinned, constants2.X_OK);
       return pinned;
@@ -56713,10 +56874,10 @@ function runDoctor() {
   );
   checks.push(
     check2("root-path pin", () => {
-      if (!existsSync14(p.rootPathFile))
+      if (!existsSync15(p.rootPathFile))
         return "not pinned (run `eminiar install`); the bin/ shims run only from a directory that has node_modules";
       const root = readFileSync14(p.rootPathFile, "utf8").trim();
-      if (!existsSync14(join20(root, "dist", "server.js")))
+      if (!existsSync15(join20(root, "dist", "server.js")))
         throw new Error(`${root} has no dist/server.js (run \`eminiar install\`)`);
       return root;
     })
@@ -56758,7 +56919,7 @@ function runDoctor() {
   checks.push(
     check2("embedding model", () => {
       const dir = paths().models;
-      return existsSync14(dir) ? `${dir} (downloaded lazily on first hybrid search)` : "not present";
+      return existsSync15(dir) ? `${dir} (downloaded lazily on first hybrid search)` : "not present";
     })
   );
   return checks;
@@ -56783,18 +56944,18 @@ init_esm_shims();
 init_paths();
 import {
   copyFileSync,
-  existsSync as existsSync15,
+  existsSync as existsSync16,
   mkdirSync as mkdirSync6,
   readdirSync as readdirSync5,
   readFileSync as readFileSync15,
   writeFileSync as writeFileSync6
 } from "fs";
 import { homedir as homedir3 } from "os";
-import { dirname as dirname9, join as join21 } from "path";
+import { dirname as dirname10, join as join21 } from "path";
 var claudeDir = () => process.env.CLAUDE_CONFIG_DIR || join21(homedir3(), ".claude");
 var pluginsDir = () => join21(claudeDir(), "plugins");
 function readJson3(file3) {
-  if (!existsSync15(file3)) return {};
+  if (!existsSync16(file3)) return {};
   try {
     return JSON.parse(readFileSync15(file3, "utf8"));
   } catch (err) {
@@ -56937,7 +57098,7 @@ init_esm_shims();
 // src/sandbox/file.ts
 init_esm_shims();
 import { realpathSync as realpathSync2 } from "fs";
-import { isAbsolute, relative as relative8, resolve as resolve7 } from "path";
+import { isAbsolute, relative as relative9, resolve as resolve7 } from "path";
 function confinePath(root, target, rules) {
   const abs = resolve7(root, target);
   let real;
@@ -56946,7 +57107,7 @@ function confinePath(root, target, rules) {
   } catch {
     throw new Error(`file not found: ${target}`);
   }
-  const rel = relative8(root, real);
+  const rel = relative9(root, real);
   const inside = rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
   if (inside) return real;
   if (rules.allow.some((r) => matchRead(r, real))) return real;
@@ -57303,7 +57464,7 @@ init_esm_shims();
 
 // src/code/symbols.ts
 init_esm_shims();
-import { existsSync as existsSync16, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync17 } from "fs";
 import { join as join23 } from "path";
 
 // src/code/namepath.ts
@@ -57374,7 +57535,7 @@ function children(db, parent, depth = 1) {
 function symbolBody(db, root, n) {
   if (!n.path || !n.start_line || !n.end_line) return void 0;
   const abs = join23(root, n.path);
-  if (existsSync16(abs)) {
+  if (existsSync17(abs)) {
     try {
       return readFileSync17(abs, "utf8").split("\n").slice(n.start_line - 1, n.end_line).join("\n");
     } catch {
@@ -58386,13 +58547,13 @@ function mergeByTool(rows) {
 // src/tools/em_symbols.ts
 init_esm_shims();
 init_backend();
-function fence(body, budget, docId) {
+function fence(body, budget, docId2) {
   const cut = body.length > budget;
   const shown = cut ? body.slice(0, budget) : body;
   return `\`\`\`
 ${shown}
 \`\`\`${cut ? `
-\u2026 ${body.length - budget} more chars (raise max_tokens${docId ? ` or em_search {document_ids:[${docId}]}` : ""})` : ""}`;
+\u2026 ${body.length - budget} more chars (raise max_tokens${docId2 ? ` or em_search {document_ids:[${docId2}]}` : ""})` : ""}`;
 }
 function referrerLabel(db, id, nodes) {
   const n = nodes.get(id) ?? db.graphGetNode(id);