@dotdotgod/claude-code 0.6.6 → 0.7.0

package/mcp/cli.mjs

@@ -760,6 +760,24 @@ var init_parser = __esm({
   }
 });
 
+// packages/cli/src/graph-view/node-style.cjs
+var require_node_style = __commonJS({
+  "packages/cli/src/graph-view/node-style.cjs"(exports, module) {
+    var palette = ["#b9a3ff", "#70c9a2", "#72b9e6", "#d6b879", "#e393a9", "#78c9cd", "#a6c67a", "#e5a475"];
+    function describeNode(path, root = "docs") {
+      root = root.replace(/^\.\//, "").replace(/\/$/, "");
+      if (!path.startsWith(`${root}/`)) return { label: path, group: null, color: null };
+      const parts = path.slice(root.length + 1).split("/");
+      const group = parts.length === 1 ? root : parts.shift();
+      let hash2 = 0;
+      for (const char of group) hash2 = Math.imul(hash2, 31) + char.charCodeAt(0) >>> 0;
+      const known = { docs: "#b9a3ff", spec: "#72b9e6", arch: "#d6b879", test: "#70c9a2", concept: "#e393a9", report: "#78c9cd" };
+      return { label: parts.join("/"), group, color: known[group] ?? palette[hash2 % palette.length] };
+    }
+    module.exports = { describeNode };
+  }
+});
+
 // packages/cli/src/init.mjs
 import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { basename, dirname as dirname2, join as join5, resolve as resolve3 } from "node:path";
@@ -1503,9 +1521,15 @@ function memoryConfigSummary(config) {
 
 // packages/cli/src/config/templates.mjs
 var DEFAULT_TEMPLATE_NAME = "software";
+var engineeringScaffold = [
+  ["docs/spec/README.md", "Specs", "Use this area for behavior specs, API contracts, and requirements. Follow `dotdotgod validate` traceability guidance for applicable documents."],
+  ["docs/arch/README.md", "Architecture", "Use this area for architecture decisions, design rationale, conventions, and integration boundaries."],
+  ["docs/test/README.md", "Verification", "Use this area for test strategy, evaluation methods, regression cases, and verification records."]
+];
 var BUILT_IN_TEMPLATE_SCAFFOLDS = {
-  software: [],
+  software: engineeringScaffold,
   research: [
+    ...engineeringScaffold,
     ["docs/research/README.md", "Research", "Use this area for research notes, sources, and findings."],
     ["docs/record/README.md", "Research Records", "Use this area for dated measurements, experiments, and execution records."],
     ["docs/report/README.md", "Reports", "Use this area for research diagnoses, analyses, results, and performance reports."],
@@ -1771,11 +1795,10 @@ function formatAction(item) {
   return `${item.status.padEnd(13)} ${item.path}${extra}`;
 }
 function parseInitOptions(argv) {
-  const options = { root: null, projectName: "", dotdotSetting: false, dryRun: false, json: false, template: null, documentationRoot: "docs", documentationRootExplicit: false };
+  const options = { root: null, projectName: "", dryRun: false, json: false, template: null, documentationRoot: "docs", documentationRootExplicit: false };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if (arg === "--json") options.json = true;
-    else if (arg === "--dotdot-setting") options.dotdotSetting = true;
     else if (arg === "--dry-run") options.dryRun = true;
     else if (arg === "--claude-plans") options.claudePlans = true;
     else if (arg === "--project-name" || arg === "--template" || arg === "--documentation-root") {
@@ -1854,8 +1877,7 @@ function ensureGitignoreEntry(options, entry, actions) {
 `);
   actions.push(action(existed ? "updated" : "created", target, { add: entry }));
 }
-function agentContent(projectName, dotdotSetting) {
-  const dotdotAgentRule = dotdotSetting ? "\n- Follow the project documentation structure in `docs/arch/DOCS_STRUCTURE.md` and code conventions in `docs/arch/CODE_CONVENTIONS.md`." : "";
+function agentContent(projectName, domainMap) {
   return `# AGENTS.md
 
 Canonical instructions for AI coding agents working in this repository.
@@ -1873,7 +1895,7 @@ Canonical instructions for AI coding agents working in this repository.
 - Preserve user edits and unrelated dirty worktree changes.
 - Prefer existing local patterns over introducing new abstractions.
 - Update docs when behavior, architecture, or test strategy changes.
-- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance for behavior specs.${dotdotAgentRule}
+- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance.
 
 ## dotdotgod
 
@@ -1898,15 +1920,12 @@ TODO
 
 ## Documentation Map
 
-- \`docs/spec/\`: product behavior, API contracts, user-facing requirements.
-- \`docs/test/\`: test strategy, regression cases, manual verification notes.
-- \`docs/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+${domainMap}
 - \`docs/\`: all directories use kebab-case; all markdown file names use UPPER_SNAKE_CASE, including \`README.md\`.
 - \`docs/\`: prefer keeping individual markdown files under the configured markdown validation budgets (default 200 lines and 10,000 characters); split larger docs into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview unless a narrow size-check exception is configured.
 - \`docs/\`: when adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` index/table of contents in the same change.
 - \`docs/\`: each docs subdirectory \`README.md\` acts as the local table of contents; list important files, task directories, status, and a one-line purpose for each entry.
 - \`docs/\`: start small with a single focused markdown file; when one domain grows into multiple docs, promote it to \`docs/<area>/<domain>/README.md\` plus related UPPER_SNAKE_CASE files in that directory.
-- \`docs/arch/\`: code conventions may start as \`CODE_CONVENTIONS.md\`; when they grow across multiple topics, use \`docs/arch/conventions/README.md\` as the index with supporting UPPER_SNAKE_CASE files.
 - \`docs/plan/\`: local active implementation plans. Create one kebab-case directory per task (\`docs/plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`docs/archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`docs/archive/plan/<task-slug>/\`; put temporary reports and investigations under \`docs/archive/report/<report-slug>/\`. Ignored by git by default.
 
@@ -1917,7 +1936,7 @@ TODO
 
 Keep long-lived instructions here so agent-specific files do not drift.`;
 }
-function docsReadmeContent() {
+function docsReadmeContent(domainMap) {
   return `# Docs
 
 This directory keeps project knowledge close to the code.
@@ -1936,114 +1955,20 @@ This directory keeps project knowledge close to the code.
 
 ## Map
 
-- \`spec/\`: product behavior, API contracts, user-facing requirements.
-- \`test/\`: test strategy, regression cases, manual verification notes.
-- \`arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+${domainMap.replaceAll("`docs/", "`")}
 - \`plan/\`: local active implementation plans. Create one kebab-case directory per task (\`plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`archive/plan/<task-slug>/\`; put temporary reports and investigations under \`archive/report/<report-slug>/\`. Ignored by git by default.`;
 }
-function docsStructureContent() {
-  return `# Docs Structure
-
-Long-term documentation structure for this project.
-
-## Top-Level Areas
-
-- \`docs/spec/\`: product behavior, API contracts, user-facing requirements, and feature contracts.
-- \`docs/test/\`: test strategy, coverage notes, regression cases, and manual verification records.
-- \`docs/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
-- \`docs/plan/\`: local active implementation plans.
-- \`docs/archive/\`: local completed plans, historical notes, payload captures, and investigation notes.
-
-## Naming
-
-- Directories under \`docs/\` use kebab-case.
-- Markdown files under \`docs/\` use UPPER_SNAKE_CASE.
-- \`README.md\` is the only mixed-case markdown filename exception and is required for index/overview files.
-
-## File Size Guideline
-
-Prefer keeping individual markdown files under 200 lines and 10,000 characters. When either guideline is exceeded, split the document into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview. Configured validation exceptions should stay narrow and intentional.
-
-## README Indexes
-
-Each docs subdirectory \`README.md\` acts as the local table of contents. It should list important files, task directories, status, and a one-line purpose for each entry.
-
-When adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` in the same change.
-
-## Domain Directory Promotion
-
-Start small with one focused markdown file. When one domain grows into multiple docs, promote it to \`docs/<area>/<domain>/README.md\` and place related UPPER_SNAKE_CASE markdown files in that directory.
-
-## Spec Writing Contract
-
-Behavior specs describe the current product contract: supported commands, API shapes, user-visible behavior, defaults, constraints, and validation outcomes.
-
-Specs should not describe how behavior changed over time. Rewrite historical-change wording into direct current-state rules. Historical context, migration rationale, future extension ideas, and completed-plan notes belong in \`docs/arch/\`, \`docs/test/\`, \`docs/archive/\`, or active \`docs/plan/\` files rather than behavior specs. If compatibility behavior is still user-visible, keep it in the spec but phrase it as a current supported or unsupported rule.
-
-Config/action terms such as \`remove\`, \`exclude\`, \`fallback\`, and \`replacement semantics\` are allowed when they name current behavior precisely.
-
-## Traceability Blocks
-
-Behavior specs may include fenced \`json dotdotgod\` traceability blocks as the final section to connect specs to source, tests, related docs, and verification commands. The dotdotgod CLI owns the schema and validation behavior.
-
-## Plan and Archive Directories
-
-Active task plans use \`docs/plan/<task-slug>/README.md\`. Completed or superseded plan task directories move to \`docs/archive/plan/<task-slug>/\`. Temporary investigations, reports, payload captures, and historical notes move to \`docs/archive/report/<report-slug>/\`.
-
-\`docs/plan\` and \`docs/archive\` are ignored by git by default.`;
-}
-function codeConventionsContent() {
-  return `# Code Conventions
-
-Dotdot code conventions for keeping implementation simple and maintainable.
-
-## Abstraction Boundaries
-
-- Do not introduce unnecessary abstractions.
-- Do not abstract code that is not reused.
-- Do not abstract reused code when the reused behavior is likely to split into separate features or flows later.
-- Prefer local, explicit code until a stable reuse pattern appears.
-
-## Source File Size
-
-- Keep source files small enough to read in one focused pass by humans and coding agents.
-- If code grows beyond 150 lines, consider splitting or extracting focused units even when it is not reused.
-- Review files approaching 250 lines for focused extraction by responsibility.
-- Split by behavior or responsibility, not by arbitrary layers.
-
-## Dotdotgod Impact Hotspots
-
-- Treat repeated \`dotdotgod graph impact\` results that collapse onto one large file as a design signal, not as normal precision.
-- Dotdotgod impact reveals mixed-responsibility hotspots; it does not replace focused module boundaries.
-- When unrelated changes keep pointing to the same source file, split the file by behavior so impact results, tests, and docs can map to narrower responsibilities.
-
-## Extraction and Testability
-
-- Prefer extracting pure helpers when behavior can be tested without runtime dependencies.
-- Keep runtime integration explicit and local until reuse is stable.
-- Put testable logic in focused modules before adding broad framework abstractions.
-- Preserve plain-text readability: avoid dense clever code, hidden control flow, and large mixed-responsibility files.`;
-}
-function initFiles(options) {
-  const archReadmeExtra = options.dotdotSetting ? "\n\n## Index\n\n- `DOCS_STRUCTURE.md`: documentation layout, naming, README index, spec current-state writing contract, and domain directory promotion rules.\n- `CODE_CONVENTIONS.md`: dotdot code conventions, including abstraction boundaries, source file size guidance, impact hotspot handling, and extraction/testability rules. If conventions grow across multiple topics, promote them to `conventions/README.md` with supporting UPPER_SNAKE_CASE files." : "";
+function initFiles(options, scaffold) {
+  const domainMap = scaffold.filter((item) => item.type === "file").map((item) => `- \`${item.path.replace(/README\.md$/, "")}\`: ${item.content.split("\n\n")[1]}`).join("\n");
   const files = [
-    ["AGENTS.md", agentContent(options.projectName, options.dotdotSetting)],
+    ["AGENTS.md", agentContent(options.projectName, domainMap)],
     ["CLAUDE.md", "# CLAUDE.md\n\n@AGENTS.md"],
     ["CODEX.md", "# CODEX.md\n\nSee [AGENTS.md](./AGENTS.md)."],
-    ["docs/README.md", docsReadmeContent()],
-    ["docs/spec/README.md", "# Specs\n\nUse this area for behavior specs, API contracts, and product requirements.\n\nFor projects using the dotdotgod CLI, behavior specs may be required by `dotdotgod validate` to include fenced `json dotdotgod` traceability blocks as the final section. The CLI owns the schema and prints property-level repair guidance when validation fails."],
-    ["docs/test/README.md", "# Tests\n\nUse this area for test strategy, coverage notes, regression cases, and manual verification records."],
-    ["docs/arch/README.md", `# Architecture
-
-Use this area for architecture decisions, code conventions, module boundaries, data flow notes, infrastructure/runtime dependencies, integration boundaries, and migration design.${archReadmeExtra}`],
+    ["docs/README.md", docsReadmeContent(domainMap)],
     ["docs/plan/README.md", "# Plans\n\nUse this area for active implementation plans.\n\n## Naming\n\n- Task directories use kebab-case: `docs/plan/<task-slug>/`.\n- Markdown file names use UPPER_SNAKE_CASE: `README.md`, `RESEARCH_NOTES.md`, `VERIFICATION.md`.\n\n## Structure\n\n- Create one directory per task: `docs/plan/<task-slug>/`.\n- Put the task overview, index, scope, status, and main plan in `docs/plan/<task-slug>/README.md`.\n- Add supporting research, checklists, payload captures, or verification notes as additional UPPER_SNAKE_CASE markdown files in the same task directory.\n- Move completed or superseded task directories to `docs/archive/plan/<task-slug>/`.\n\nThis directory is local-only and ignored by git by default."],
     ["docs/archive/README.md", "# Archive\n\nUse this area for local completed plans, temporary reports, historical notes, payload captures, and investigation notes.\n\n## Naming\n\n- Archived plan task directories preserve their kebab-case task slug.\n- Archived report directories use a focused kebab-case report slug.\n- Markdown file names use UPPER_SNAKE_CASE, including `README.md`.\n\n## Structure\n\n- Move completed plan task directories from `docs/plan/<task-slug>/` to `docs/archive/plan/<task-slug>/`.\n- Put temporary investigations, reports, payload captures, and historical notes under `docs/archive/report/<report-slug>/`.\n- Preserve each archive directory's `README.md` overview/index and supporting UPPER_SNAKE_CASE markdown files.\n- Additional archive categories can be added later as focused kebab-case subdirectories when needed.\n\nThis directory is local-only and ignored by git by default."]
   ];
-  if (options.dotdotSetting) {
-    files.push(["docs/arch/DOCS_STRUCTURE.md", docsStructureContent()]);
-    files.push(["docs/arch/CODE_CONVENTIONS.md", codeConventionsContent()]);
-  }
   return files.map(([path, content]) => [path.replace(/^docs(?=\/|$)/, options.documentationRoot), content.replaceAll("docs/", `${options.documentationRoot}/`).replaceAll("`docs`", `\`${options.documentationRoot}\``)]);
 }
 function runInit(argv, usage2) {
@@ -2087,7 +2012,8 @@ function runInit(argv, usage2) {
 ` };
   }
   const actions = [];
-  for (const [relativePath, content] of initFiles(options)) writeInitFile(options, relativePath, content, actions);
+  const scaffold = template?.source === "bundled" ? builtInTemplateScaffold(template.name) : [];
+  for (const [relativePath, content] of initFiles(options, scaffold)) writeInitFile(options, relativePath, content, actions);
   if (template?.source === "bundled") {
     for (const item of builtInTemplateScaffold(template.name, { documentationRoot: options.documentationRoot }) ?? []) {
       if (item.type === "directory") ensureInitDirectory(options, item.path, actions);
@@ -2103,7 +2029,7 @@ function runInit(argv, usage2) {
       initError(options, "CLAUDE_SETTINGS_CHANGED", error.message);
     }
   }
-  const payload = { ok: true, command: "init", root: options.root, projectName: options.projectName, documentationRoot: options.documentationRoot, dryRun: options.dryRun, dotdotSetting: options.dotdotSetting, template: template ? { name: template.name, source: template.source, selectedBy: template.selectedBy } : null, actions };
+  const payload = { ok: true, command: "init", root: options.root, projectName: options.projectName, documentationRoot: options.documentationRoot, dryRun: options.dryRun, template: template ? { name: template.name, source: template.source, selectedBy: template.selectedBy } : null, actions };
   if (options.json) console.log(JSON.stringify(payload, null, 2));
   else {
     if (template) console.log(`template      ${template.source}:${template.name} (${template.selectedBy})`);
@@ -2123,7 +2049,7 @@ function commandUsage(command = "root") {
   dotdotgod validate <root> [--include-local-memory] [--check-index] [--max-lines n] [--max-chars n] [--no-link-check] [--json]`;
     case "init":
       return `Usage:
-  dotdotgod init <root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--dotdot-setting] [--claude-plans] [--dry-run] [--json]
+  dotdotgod init <root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--claude-plans] [--dry-run] [--json]
 
 Create AGENTS.md, agent entrypoints, docs indexes, a project config from an initialization template, and local memory gitignore entries.
 Use --claude-plans only after opting into project-local native plan storage; existing Claude settings are preserved.`;
@@ -2185,7 +2111,8 @@ Checks or writes generated Markdown traceability link sections from canonical fe
     case "graph":
       return `Usage:
   dotdotgod graph impact <root> --changed <path> [--changed <path> ...] [--compact|--json|--yml|--yaml]
-  dotdotgod graph serve <root> --changed <path> [--changed <path> ...] [--host HOST] [--port PORT]
+  dotdotgod graph serve <root> [--host HOST] [--port PORT]
+  dotdotgod graph export <root> [--json]
   dotdotgod graph communities <root> [--json]`;
     case "graph impact":
       return `Usage:
@@ -2194,9 +2121,14 @@ Checks or writes generated Markdown traceability link sections from canonical fe
 Ranks nodes related to one or more changed files. <root> is the project root; repeat --changed with project-relative file paths. Results include a combined ranking and the top five related nodes for each changed file. Use --compact for a short text summary or --yml/--yaml for structured agent-facing output.`;
     case "graph serve":
       return `Usage:
-  dotdotgod graph serve <root> --changed <path> [--changed <path> ...] [--host HOST] [--port PORT]
+  dotdotgod graph serve <root> [--host HOST] [--port PORT]
 
-Starts a local-only impact graph explorer. Changed files are rendered as root nodes and are excluded from related-result lists.`;
+Starts a standalone local traceability graph without Obsidian.`;
+    case "graph export":
+      return `Usage:
+  dotdotgod graph export <root> [--json]
+
+Write .dotdotgod/traceability.json for the Obsidian plugin.`;
     case "graph communities":
       return `Usage:
   dotdotgod graph communities <root> [--json]`;
@@ -2220,7 +2152,8 @@ Commands:
   status                Show local index status.
   traceability links    Check or write generated traceability links.
   graph impact          Find files related to changed files.
-  graph serve           Open a local impact graph explorer.
+  graph serve           Open a standalone local traceability graph.
+  graph export          Export traceability data for Obsidian.
   graph communities     Find groups of related project-memory nodes.
 
 Options:
@@ -2731,19 +2664,19 @@ function addConfiguredLocalMemoryCandidates(root, candidates, config, limit = 5e
   let added = 0;
   const addPath = (path) => {
     if (added >= limit || !existsSync7(path)) return;
-    let stat;
+    let stat2;
     try {
-      stat = statSync2(path);
+      stat2 = statSync2(path);
     } catch {
       return;
     }
     const pathRel = rel(root, path);
-    if (stat.isFile()) {
+    if (stat2.isFile()) {
       candidates.add(pathRel);
       added += 1;
       return;
     }
-    if (!stat.isDirectory() || isExcludedIndexDir(pathRel)) return;
+    if (!stat2.isDirectory() || isExcludedIndexDir(pathRel)) return;
     for (const entry of readdirSync(path, { withFileTypes: true })) {
       if (added >= limit) return;
       addPath(join6(path, entry.name));
@@ -3226,13 +3159,13 @@ var OUTLINE_SCHEMA = 1;
 var outlinePath = (root) => join11(root, ".dotdotgod", "outlines.json");
 function assertCachePath(root) {
   for (const path of [dirname8(outlinePath(root)), outlinePath(root)]) {
-    let stat;
+    let stat2;
     try {
-      stat = lstatSync3(path);
+      stat2 = lstatSync3(path);
     } catch (error) {
       if (error.code !== "ENOENT") throw error;
     }
-    if (stat?.isSymbolicLink()) throw new Error(`Outline cache must not use symlinks: ${path}`);
+    if (stat2?.isSymbolicLink()) throw new Error(`Outline cache must not use symlinks: ${path}`);
   }
 }
 function readOutlines(root) {
@@ -3937,12 +3870,196 @@ function runConfig(argv) {
 // packages/cli/src/commands/query.mjs
 import { resolve as resolve11 } from "node:path";
 
+// packages/cli/src/query/cache-session.mjs
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { mkdirSync as mkdirSync6, openSync, closeSync, readFileSync as readFileSync16, writeFileSync as writeFileSync7, renameSync as renameSync3, rmSync as rmSync2 } from "node:fs";
+import { join as join16 } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+
+// packages/cli/src/query/store.mjs
+import { createHash as createHash6 } from "node:crypto";
+import { existsSync as existsSync16, mkdirSync as mkdirSync5, readFileSync as readFileSync15, renameSync as renameSync2, rmSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join15 } from "node:path";
+var VECTOR_SCHEMA_VERSION = 2;
+var VECTOR_DIMENSIONS = 384;
+function profileFingerprint(identity2) {
+  return createHash6("sha256").update(JSON.stringify(identity2)).digest("hex");
+}
+function isValidNormalizedVectorValues(values, dimensions = VECTOR_DIMENSIONS) {
+  if (!Number.isInteger(dimensions) || dimensions < 1 || !values || values.length % dimensions !== 0) return false;
+  for (let offset = 0; offset < values.length; offset += dimensions) {
+    let squaredNorm = 0;
+    for (let index = 0; index < dimensions; index += 1) {
+      const value = values[offset + index];
+      if (!Number.isFinite(value) || value < -1 || value > 1) return false;
+      squaredNorm += value * value;
+    }
+    if (Math.abs(Math.sqrt(squaredNorm) - 1) > 0.01) return false;
+  }
+  return true;
+}
+function vectorCachePaths(root) {
+  const directory = join15(root, ".dotdotgod", "vectors");
+  return { directory, manifest: join15(directory, "manifest.json"), chunks: join15(directory, "chunks.jsonl"), embeddings: join15(directory, "embeddings.f32") };
+}
+function readVectorCache(root, identity2 = null, diagnostics = {}) {
+  diagnostics.reason = "missing";
+  const paths = vectorCachePaths(root);
+  if (!existsSync16(paths.manifest) || !existsSync16(paths.chunks) || !existsSync16(paths.embeddings)) return null;
+  try {
+    const manifest = JSON.parse(readFileSync15(paths.manifest, "utf8"));
+    diagnostics.reason = "schema-mismatch";
+    if (manifest.schemaVersion !== VECTOR_SCHEMA_VERSION || !Number.isInteger(manifest.dimensions) || manifest.dimensions < 1) return null;
+    diagnostics.reason = "profile-mismatch";
+    if (identity2 && manifest.profileFingerprint !== profileFingerprint(identity2)) return null;
+    diagnostics.reason = "corrupt";
+    const chunks = readFileSync15(paths.chunks, "utf8").split("\n").filter(Boolean).map((line) => JSON.parse(line));
+    const buffer = readFileSync15(paths.embeddings);
+    if (buffer.byteLength !== chunks.length * manifest.dimensions * 4) return null;
+    const vectors = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 4);
+    if (!isValidNormalizedVectorValues(vectors, manifest.dimensions)) return null;
+    diagnostics.reason = "valid";
+    return { manifest, chunks, vectors: new Float32Array(vectors) };
+  } catch {
+    diagnostics.reason = "corrupt";
+    return null;
+  }
+}
+function atomicWrite(path, data) {
+  const temporary = `${path}.tmp-${process.pid}`;
+  writeFileSync6(temporary, data);
+  renameSync2(temporary, path);
+}
+function writeVectorCache(root, chunks, vectors, metadata = {}) {
+  const paths = vectorCachePaths(root);
+  const dimensions = metadata.dimensions;
+  if (!Number.isInteger(dimensions) || dimensions < 1) throw new Error("Vector dimensions must be a positive integer.");
+  mkdirSync5(paths.directory, { recursive: true });
+  if (vectors.length !== chunks.length * dimensions) throw new Error("Vector count does not match chunk metadata.");
+  if (!isValidNormalizedVectorValues(vectors, dimensions)) throw new Error("Vectors must contain finite normalized values.");
+  const manifest = { schemaVersion: VECTOR_SCHEMA_VERSION, chunks: chunks.length, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), ...metadata };
+  atomicWrite(paths.chunks, `${chunks.map((chunk) => JSON.stringify(chunk)).join("\n")}
+`);
+  atomicWrite(paths.embeddings, Buffer.from(vectors.buffer, vectors.byteOffset, vectors.byteLength));
+  atomicWrite(paths.manifest, `${JSON.stringify(manifest, null, 2)}
+`);
+  return manifest;
+}
+
+// packages/cli/src/query/cache-session.mjs
+async function vectorCacheSession(root, identity2, action2) {
+  const directory = join16(root, ".dotdotgod", "vectors");
+  mkdirSync6(directory, { recursive: true });
+  const lock = join16(directory, "build.lock");
+  const token = randomUUID2();
+  const started = Date.now();
+  let waited = false;
+  while (true) {
+    try {
+      const fd = openSync(lock, "wx");
+      try {
+        writeFileSync7(fd, JSON.stringify({ pid: process.pid, token }));
+      } finally {
+        closeSync(fd);
+      }
+      break;
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+      waited = true;
+      if (Date.now() - started >= 3e4) throw new Error("Vector cache lock timed out; another build may be running or the lock needs inspection.");
+      try {
+        const owner = JSON.parse(readFileSync16(lock, "utf8"));
+        if (!Number.isInteger(owner.pid) || owner.pid < 1) throw new Error("Invalid lock owner.");
+        try {
+          process.kill(owner.pid, 0);
+        } catch (probe) {
+          if (probe.code !== "ESRCH") throw probe;
+          const recovery = `${lock}.recovery`;
+          try {
+            mkdirSync6(recovery);
+          } catch (claim) {
+            if (claim.code === "EEXIST") {
+              await sleep(50);
+              continue;
+            }
+            throw claim;
+          }
+          try {
+            const current = JSON.parse(readFileSync16(lock, "utf8"));
+            if (current.token === owner.token && current.pid === owner.pid) rmSync2(lock);
+          } finally {
+            rmSync2(recovery, { recursive: true, force: true });
+          }
+          continue;
+        }
+      } catch (probe) {
+        if (probe.code === "ENOENT") continue;
+      }
+      await sleep(50);
+    }
+  }
+  try {
+    const path = join16(directory, "snapshots.json");
+    const fingerprint2 = profileFingerprint(identity2);
+    let state;
+    let reason = "missing";
+    try {
+      state = JSON.parse(readFileSync16(path, "utf8"));
+      if (state.schema !== 1) {
+        reason = "schema-mismatch";
+        state = null;
+      } else if (state.profile !== fingerprint2) {
+        reason = "profile-mismatch";
+        state = null;
+      } else {
+        if (state.dimensions !== null && (!Number.isInteger(state.dimensions) || state.dimensions < 1)) throw new Error("Invalid cache dimensions.");
+        for (const rows of [state.docs, state.code, state.pending]) {
+          if (!Array.isArray(rows) || rows.some((row) => typeof row.chunk?.fingerprint !== "string" || !Array.isArray(row.vector) || row.vector.length !== state.dimensions || !isValidNormalizedVectorValues(row.vector, state.dimensions))) throw new Error("Invalid cache rows.");
+        }
+        reason = "valid";
+      }
+    } catch (error) {
+      state = null;
+      reason = error.code === "ENOENT" ? "missing" : "corrupt";
+    }
+    if (!state) {
+      state = { schema: 1, profile: fingerprint2, dimensions: null, docs: [], code: [], pending: [] };
+      if (reason === "missing") {
+        const legacyDiagnostics = {};
+        const legacy = readVectorCache(root, identity2, legacyDiagnostics);
+        reason = legacyDiagnostics.reason;
+        if (legacy) {
+          state.dimensions = legacy.manifest.dimensions;
+          legacy.chunks.forEach((chunk, i) => state[chunk.kind === "symbol" ? "code" : "docs"].push({ chunk, vector: Array.from(legacy.vectors.subarray(i * state.dimensions, (i + 1) * state.dimensions)) }));
+          reason = "legacy-migrated";
+        }
+      }
+    }
+    const save = () => {
+      const temporary = `${path}.tmp-${token}`;
+      try {
+        writeFileSync7(temporary, JSON.stringify(state));
+        renameSync3(temporary, path);
+      } finally {
+        rmSync2(temporary, { force: true });
+      }
+    };
+    return await action2(state, save, { reason, lockWaitMs: waited ? Date.now() - started : 0 });
+  } finally {
+    try {
+      if (JSON.parse(readFileSync16(lock, "utf8")).token === token) rmSync2(lock);
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+  }
+}
+
 // packages/cli/src/query/embedding-runtime.mjs
-import { existsSync as existsSync16, mkdirSync as mkdirSync5, readFileSync as readFileSync15, rmSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync17, mkdirSync as mkdirSync7, readFileSync as readFileSync17, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "node:fs";
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir3 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join17 } from "node:path";
 import { pathToFileURL } from "node:url";
 var EMBEDDING_RUNTIME_PACKAGE = "@huggingface/transformers";
 var EMBEDDING_RUNTIME_VERSION = "4.2.0";
@@ -3954,12 +4071,12 @@ var EmbeddingRuntimeMissingError = class extends Error {
   }
 };
 function embeddingRuntimeRoot(options = {}) {
-  return join15(options.home ?? homedir3(), ".dotdotgod", "runtime", "embedding");
+  return join17(options.home ?? homedir3(), ".dotdotgod", "runtime", "embedding");
 }
 function resolvePersistentTransformers(options = {}) {
   const root = embeddingRuntimeRoot(options);
   try {
-    const require3 = createRequire2(join15(root, "package.json"));
+    const require3 = createRequire2(join17(root, "package.json"));
     return require3.resolve(EMBEDDING_RUNTIME_PACKAGE);
   } catch {
     throw new EmbeddingRuntimeMissingError();
@@ -3968,10 +4085,10 @@ function resolvePersistentTransformers(options = {}) {
 function embeddingRuntimeStatus(options = {}) {
   const root = embeddingRuntimeRoot(options);
   try {
-    const require3 = createRequire2(join15(root, "package.json"));
+    const require3 = createRequire2(join17(root, "package.json"));
     require3.resolve(EMBEDDING_RUNTIME_PACKAGE);
-    const packagePath = join15(root, "node_modules", ...EMBEDDING_RUNTIME_PACKAGE.split("/"), "package.json");
-    const version = JSON.parse(readFileSync15(packagePath, "utf8")).version;
+    const packagePath = join17(root, "node_modules", ...EMBEDDING_RUNTIME_PACKAGE.split("/"), "package.json");
+    const version = JSON.parse(readFileSync17(packagePath, "utf8")).version;
     return { ok: true, installed: true, installAvailable: true, package: EMBEDDING_RUNTIME_PACKAGE, requiredVersion: EMBEDDING_RUNTIME_VERSION, packageVersion: version, location: root };
   } catch {
     return { ok: true, installed: false, installAvailable: true, package: EMBEDDING_RUNTIME_PACKAGE, requiredVersion: EMBEDDING_RUNTIME_VERSION, packageVersion: null, location: root };
@@ -3980,10 +4097,10 @@ function embeddingRuntimeStatus(options = {}) {
 function installEmbeddingRuntime(options = {}) {
   if (options.confirm !== true) throw new Error("Embedding runtime installation requires explicit confirmation.");
   const root = embeddingRuntimeRoot(options);
-  const lock = join15(root, ".installing");
-  if (existsSync16(lock)) throw new Error("Embedding runtime installation is already in progress.");
-  mkdirSync5(root, { recursive: true });
-  writeFileSync6(lock, `${process.pid}
+  const lock = join17(root, ".installing");
+  if (existsSync17(lock)) throw new Error("Embedding runtime installation is already in progress.");
+  mkdirSync7(root, { recursive: true });
+  writeFileSync8(lock, `${process.pid}
 `, { flag: "wx" });
   try {
     const spawn = options.spawnImpl ?? spawnSync2;
@@ -3993,7 +4110,7 @@ function installEmbeddingRuntime(options = {}) {
     if (!status.installed) throw new Error("Embedding runtime installation could not be verified.");
     return { ...status, command: "embedding install", modelDownloadPending: true };
   } finally {
-    rmSync(lock, { force: true });
+    rmSync3(lock, { force: true });
   }
 }
 async function importTransformers(options = {}) {
@@ -4103,70 +4220,6 @@ async function resolveEmbedder(root, options = {}) {
   return { ...resolved, identity: embeddingProfileIdentity(resolved.profile), embed: options.embed ? withInputFormat(options.embed, resolved.profile) : await createEmbedder(resolved.profile) };
 }
 
-// packages/cli/src/query/store.mjs
-import { createHash as createHash6 } from "node:crypto";
-import { existsSync as existsSync17, mkdirSync as mkdirSync6, readFileSync as readFileSync16, renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join16 } from "node:path";
-var VECTOR_SCHEMA_VERSION = 2;
-var VECTOR_DIMENSIONS = 384;
-function profileFingerprint(identity2) {
-  return createHash6("sha256").update(JSON.stringify(identity2)).digest("hex");
-}
-function isValidNormalizedVectorValues(values, dimensions = VECTOR_DIMENSIONS) {
-  if (!Number.isInteger(dimensions) || dimensions < 1 || !values || values.length % dimensions !== 0) return false;
-  for (let offset = 0; offset < values.length; offset += dimensions) {
-    let squaredNorm = 0;
-    for (let index = 0; index < dimensions; index += 1) {
-      const value = values[offset + index];
-      if (!Number.isFinite(value) || value < -1 || value > 1) return false;
-      squaredNorm += value * value;
-    }
-    if (Math.abs(Math.sqrt(squaredNorm) - 1) > 0.01) return false;
-  }
-  return true;
-}
-function vectorCachePaths(root) {
-  const directory = join16(root, ".dotdotgod", "vectors");
-  return { directory, manifest: join16(directory, "manifest.json"), chunks: join16(directory, "chunks.jsonl"), embeddings: join16(directory, "embeddings.f32") };
-}
-function readVectorCache(root, identity2 = null) {
-  const paths = vectorCachePaths(root);
-  if (!existsSync17(paths.manifest) || !existsSync17(paths.chunks) || !existsSync17(paths.embeddings)) return null;
-  try {
-    const manifest = JSON.parse(readFileSync16(paths.manifest, "utf8"));
-    if (manifest.schemaVersion !== VECTOR_SCHEMA_VERSION || !Number.isInteger(manifest.dimensions) || manifest.dimensions < 1) return null;
-    if (identity2 && manifest.profileFingerprint !== profileFingerprint(identity2)) return null;
-    const chunks = readFileSync16(paths.chunks, "utf8").split("\n").filter(Boolean).map((line) => JSON.parse(line));
-    const buffer = readFileSync16(paths.embeddings);
-    if (buffer.byteLength !== chunks.length * manifest.dimensions * 4) return null;
-    const vectors = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 4);
-    if (!isValidNormalizedVectorValues(vectors, manifest.dimensions)) return null;
-    return { manifest, chunks, vectors: new Float32Array(vectors) };
-  } catch {
-    return null;
-  }
-}
-function atomicWrite(path, data) {
-  const temporary = `${path}.tmp-${process.pid}`;
-  writeFileSync7(temporary, data);
-  renameSync2(temporary, path);
-}
-function writeVectorCache(root, chunks, vectors, metadata = {}) {
-  const paths = vectorCachePaths(root);
-  const dimensions = metadata.dimensions;
-  if (!Number.isInteger(dimensions) || dimensions < 1) throw new Error("Vector dimensions must be a positive integer.");
-  mkdirSync6(paths.directory, { recursive: true });
-  if (vectors.length !== chunks.length * dimensions) throw new Error("Vector count does not match chunk metadata.");
-  if (!isValidNormalizedVectorValues(vectors, dimensions)) throw new Error("Vectors must contain finite normalized values.");
-  const manifest = { schemaVersion: VECTOR_SCHEMA_VERSION, chunks: chunks.length, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), ...metadata };
-  atomicWrite(paths.chunks, `${chunks.map((chunk) => JSON.stringify(chunk)).join("\n")}
-`);
-  atomicWrite(paths.embeddings, Buffer.from(vectors.buffer, vectors.byteOffset, vectors.byteLength));
-  atomicWrite(paths.manifest, `${JSON.stringify(manifest, null, 2)}
-`);
-  return manifest;
-}
-
 // packages/cli/src/query/hybrid.mjs
 var resultKey = (chunk) => chunk.kind === "symbol" ? chunk.id : chunk.path;
 var terms = (text) => [...new Set(text.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean))];
@@ -4284,38 +4337,62 @@ async function buildVectorIndex(root, embedOrOptions = {}) {
   const config = readMemoryConfig(root);
   const exclude = config.load?.documentationSummary?.exclude ?? ["docs/plan", "docs/archive"];
   const chunks = options.chunks ?? collectDocumentationChunks(root, exclude, config.documentation?.root ?? "docs");
-  const cached = readVectorCache(root, resolved.identity);
-  const cachedOffsets = new Map((cached?.chunks ?? []).map((chunk, index) => [chunk.fingerprint, index]));
-  const rows = new Array(chunks.length);
-  const missing = [];
-  let reused = 0;
-  chunks.forEach((chunk, index) => {
-    const oldIndex = cachedOffsets.get(chunk.fingerprint);
-    if (oldIndex === void 0 || !cached) missing.push({ chunk, index });
-    else {
-      const d = cached.manifest.dimensions;
-      rows[index] = Array.from(cached.vectors.subarray(oldIndex * d, (oldIndex + 1) * d));
-      reused += 1;
-    }
-  });
-  for (let offset = 0; offset < missing.length; offset += EMBED_BATCH_SIZE) {
-    const batch = missing.slice(offset, offset + EMBED_BATCH_SIZE);
-    const embedded = await resolved.embed(batch.map(({ chunk }) => chunk.passage), "document");
-    embedded.forEach((vector, index) => {
-      rows[batch[index].index] = vector;
+  return vectorCacheSession(root, resolved.identity, async (state, save, diagnostics) => {
+    const selectedFingerprints = new Set(chunks.map((chunk) => chunk.fingerprint));
+    state.pending = state.pending.filter((row) => selectedFingerprints.has(row.chunk.fingerprint));
+    const recovered = new Set(state.pending.map((row) => row.chunk.fingerprint));
+    const cacheRows = [...state.docs, ...state.code, ...state.pending];
+    const cached = state.dimensions ? { chunks: cacheRows.map((row) => row.chunk), vectors: Float32Array.from(cacheRows.flatMap((row) => row.vector)), manifest: { dimensions: state.dimensions } } : null;
+    const cachedOffsets = new Map((cached?.chunks ?? []).map((chunk, index) => [chunk.fingerprint, index]));
+    const rows = new Array(chunks.length);
+    const missing = [];
+    let reused = 0;
+    chunks.forEach((chunk, index) => {
+      const oldIndex = cachedOffsets.get(chunk.fingerprint);
+      if (oldIndex === void 0 || !cached) missing.push({ chunk, index });
+      else {
+        const d = cached.manifest.dimensions;
+        rows[index] = Array.from(cached.vectors.subarray(oldIndex * d, (oldIndex + 1) * d));
+        reused += 1;
+      }
     });
-  }
-  const dimensions = rows[0]?.length ?? cached?.manifest?.dimensions;
-  if (!dimensions) throw new Error("No documentation chunks were available to establish vector dimensions.");
-  if (rows.some((row) => !row || row.length !== dimensions)) throw new Error("Embedder returned inconsistent passage-vector dimensions.");
-  const vectors = new Float32Array(chunks.length * dimensions);
-  rows.forEach((row, index) => {
-    assertVector(row, dimensions, "Passage vector");
-    vectors.set(row, index * dimensions);
+    for (let offset = 0; offset < missing.length; offset += EMBED_BATCH_SIZE) {
+      const batch = missing.slice(offset, offset + EMBED_BATCH_SIZE);
+      const embedded = await resolved.embed(batch.map(({ chunk }) => chunk.passage), "document");
+      if (!Array.isArray(embedded) || embedded.length !== batch.length) throw new Error("Embedder returned an unexpected vector count.");
+      embedded.forEach((vector, index) => {
+        const dimensions2 = state.dimensions ?? vector.length;
+        assertVector(vector, dimensions2, "Passage vector");
+        state.dimensions = dimensions2;
+        rows[batch[index].index] = vector;
+        const { passage, ...chunk } = batch[index].chunk;
+        state.pending.push({ chunk, vector: Array.from(vector) });
+      });
+      save();
+    }
+    const dimensions = rows[0]?.length ?? cached?.manifest?.dimensions;
+    if (!dimensions && chunks.length) throw new Error("No documentation chunks were available to establish vector dimensions.");
+    if (rows.some((row) => !row || row.length !== dimensions)) throw new Error("Embedder returned inconsistent passage-vector dimensions.");
+    const vectors = new Float32Array(chunks.length * dimensions);
+    rows.forEach((row, index) => {
+      assertVector(row, dimensions, "Passage vector");
+      vectors.set(row, index * dimensions);
+    });
+    const storedChunks = chunks.map(({ passage, ...chunk }) => chunk);
+    const refreshed = options.corpora ?? (options.chunks ? [...new Set(chunks.map((chunk) => chunk.kind === "symbol" ? "code" : "docs"))] : ["docs"]);
+    const counters = {};
+    for (const corpus of refreshed) {
+      const positions = chunks.map((chunk, index) => ({ chunk, index })).filter(({ chunk }) => (chunk.kind === "symbol" ? "code" : "docs") === corpus);
+      state[corpus] = positions.map(({ index }) => ({ chunk: storedChunks[index], vector: Array.from(rows[index]) }));
+      counters[corpus] = { chunks: positions.length, embedded: missing.filter(({ chunk }) => (chunk.kind === "symbol" ? "code" : "docs") === corpus).length, recovered: positions.filter(({ chunk }) => recovered.has(chunk.fingerprint)).length };
+      counters[corpus].reused = positions.length - counters[corpus].embedded;
+    }
+    state.pending = [];
+    save();
+    const metadata = { provider: resolved.profile.provider, model: resolved.profile.model, dimensions, profileFingerprint: profileFingerprint(resolved.identity), excluded: exclude, embedded: missing.length, reused, diagnostics: { ...diagnostics, corpora: counters } };
+    const manifest = dimensions ? writeVectorCache(root, storedChunks, vectors, metadata) : { chunks: 0, ...metadata };
+    return { chunks: storedChunks, vectors, manifest, embedding: resolved };
   });
-  const storedChunks = chunks.map(({ passage, ...chunk }) => chunk);
-  const manifest = writeVectorCache(root, storedChunks, vectors, { provider: resolved.profile.provider, model: resolved.profile.model, dimensions, profileFingerprint: profileFingerprint(resolved.identity), excluded: exclude, embedded: missing.length, reused });
-  return { chunks: storedChunks, vectors, manifest, embedding: resolved };
 }
 async function queryProject(root, query, options = {}) {
   const scope = options.scope ?? "all";
@@ -4336,10 +4413,10 @@ async function queryProject(root, query, options = {}) {
     }
     if (!configured && !vectorError && search === "vector") throw new Error("Embedding is not configured. Set embedding in project or global configuration to use vector search.");
   }
-  if (search !== "keyword" && configured && corpus.chunks.length) {
+  if (search !== "keyword" && configured) {
     try {
-      index = await buildVectorIndex(root, { ...options, chunks: corpus.chunks });
-      const [queryVector] = await index.embedding.embed([query], "query");
+      index = await buildVectorIndex(root, { ...options, chunks: corpus.chunks, corpora: scope === "all" ? ["docs", "code"] : [scope] });
+      const [queryVector] = index.chunks.length ? await index.embedding.embed([query], "query") : [];
       vector = index.chunks.map((chunk, position) => ({ ...chunk, vectorScore: cosineScore(queryVector, index.vectors, position * index.manifest.dimensions, index.manifest.dimensions) })).sort((a, b) => b.vectorScore - a.vectorScore || a.id.localeCompare(b.id));
     } catch (error) {
       if (search === "vector") throw error;
@@ -4430,7 +4507,7 @@ import { resolve as resolve14 } from "node:path";
 
 // packages/cli/src/memory/documentation-map.mjs
 import { existsSync as existsSync18, readdirSync as readdirSync4, statSync as statSync7 } from "node:fs";
-import { join as join17, resolve as resolve13 } from "node:path";
+import { join as join18, resolve as resolve13 } from "node:path";
 var SKIPPED_DIRECTORIES2 = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "coverage", ".git", ".dotdotgod"]);
 function node() {
   return { directories: /* @__PURE__ */ new Map(), files: [] };
@@ -4493,7 +4570,7 @@ function discoverMarkdown(root, documentationRoot, exclude) {
   const walk = (relativeDirectory) => {
     let entries;
     try {
-      entries = readdirSync4(join17(root, relativeDirectory), { withFileTypes: true, encoding: "utf8" });
+      entries = readdirSync4(join18(root, relativeDirectory), { withFileTypes: true, encoding: "utf8" });
     } catch {
       return;
     }
@@ -5942,7 +6019,7 @@ function compareImpactItems(seeds) {
 }
 
 // packages/cli/src/impact/references.mjs
-import { readFileSync as readFileSync17, statSync as statSync8 } from "node:fs";
+import { readFileSync as readFileSync18, statSync as statSync8 } from "node:fs";
 import { extname as extname7, resolve as resolve15 } from "node:path";
 var WARNING_LIMIT = 20;
 var edgeKey = (source, target, relation) => `${source}\0${target}\0${relation}`;
@@ -5956,9 +6033,9 @@ function prepareImpactReferences(index, root, changedPaths) {
     let result;
     try {
       const absolute = resolve15(root, path);
-      const stat = statSync8(absolute);
+      const stat2 = statSync8(absolute);
       result = { status: "exists" };
-      if (stat.isFile() && extname7(absolute) === ".md") result.anchors = extractAnchors(readFileSync17(absolute, "utf8"));
+      if (stat2.isFile() && extname7(absolute) === ".md") result.anchors = extractAnchors(readFileSync18(absolute, "utf8"));
     } catch (error) {
       result = { status: ["ENOENT", "ENOTDIR"].includes(error.code) ? "missing" : "unavailable" };
     }
@@ -6020,7 +6097,7 @@ function prepareImpactReferences(index, root, changedPaths) {
 }
 
 // packages/cli/src/impact/vector-profile.mjs
-import { lstatSync as lstatSync4, readFileSync as readFileSync18, realpathSync as realpathSync3 } from "node:fs";
+import { lstatSync as lstatSync4, readFileSync as readFileSync19, realpathSync as realpathSync3 } from "node:fs";
 import { extname as extname8, relative as relative7, resolve as resolve16, sep } from "node:path";
 var MAX_VECTOR_PROFILE_FILE_BYTES = 64 * 1024;
 var MAX_VECTOR_PROFILE_CHARS = 4e3;
@@ -6079,7 +6156,7 @@ function safeTextPrefix(root, path) {
     if (canonicalPath !== path || unsafeProfilePath(canonicalPath) || !TEXT_EXTENSIONS.has(extname8(canonicalPath).toLowerCase())) return "";
     const stats = lstatSync4(canonicalAbsolute);
     if (!stats.isFile() || stats.isSymbolicLink() || stats.size > MAX_VECTOR_PROFILE_FILE_BYTES) return "";
-    const buffer = readFileSync18(canonicalAbsolute);
+    const buffer = readFileSync19(canonicalAbsolute);
     if (buffer.includes(0)) return "";
     const text = new TextDecoder("utf-8", { fatal: true }).decode(buffer);
     return text.slice(0, MAX_VECTOR_PROFILE_CHARS);
@@ -6530,15 +6607,15 @@ function runExpand(argv) {
 }
 
 // packages/cli/src/commands/traceability.mjs
-import { existsSync as existsSync19, readFileSync as readFileSync19, readdirSync as readdirSync5, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join18, resolve as resolve18 } from "node:path";
+import { existsSync as existsSync19, readFileSync as readFileSync20, readdirSync as readdirSync5, writeFileSync as writeFileSync9 } from "node:fs";
+import { join as join19, resolve as resolve18 } from "node:path";
 function collectDocsMarkdownFiles(root) {
-  const docs = join18(root, "docs");
+  const docs = join19(root, "docs");
   const files = [];
   const walk = (dir) => {
     if (!existsSync19(dir)) return;
     for (const entry of readdirSync5(dir, { withFileTypes: true })) {
-      const path = join18(dir, entry.name);
+      const path = join19(dir, entry.name);
       if (entry.isDirectory()) walk(path);
       else if (entry.isFile() && entry.name.endsWith(".md")) files.push(path);
     }
@@ -6574,7 +6651,7 @@ function runTraceability(argv) {
   const errors = [...config.errors ?? []];
   for (const file of files) {
     if (options.write && errors.length > 0) break;
-    const content = readFileSync19(file, "utf8");
+    const content = readFileSync20(file, "utf8");
     for (const error of validateTraceabilityLinksRegion(content, options.root, file)) errors.push(error);
     const blocks = extractDotdotgodTraceabilityBlocks(content).filter((block) => !block.error);
     if (blocks.length === 0) continue;
@@ -6583,7 +6660,7 @@ function runTraceability(argv) {
       for (const error of result.errors ?? []) errors.push(error);
       continue;
     }
-    if (options.write && result.changed) writeFileSync8(file, result.content);
+    if (options.write && result.changed) writeFileSync9(file, result.content);
     if (result.changed) results.push({ file: rel(options.root, file), changed: true });
   }
   const ok = errors.length === 0 && (!options.check || results.length === 0);
@@ -6602,126 +6679,57 @@ function runTraceability(argv) {
   process.exit(ok ? 0 : 1);
 }
 
-// packages/cli/src/graph-view/server.mjs
-import { createServer } from "node:http";
-import { readFileSync as readFileSync20 } from "node:fs";
-import { dirname as dirname13, extname as extname10, join as join19 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+// packages/cli/src/commands/graph.mjs
+import { mkdir, writeFile, rename, rm } from "node:fs/promises";
+import { join as join21 } from "node:path";
 
-// packages/cli/src/graph-view/payload.mjs
-function edgeKey2(edge) {
-  return `${edge.source}\0${edge.target}\0${edge.relation}`;
-}
-function labelForNode(node2) {
-  if (node2.type === "contract") return node2.title ?? node2.contractId ?? node2.id;
-  return node2.path ?? node2.command ?? node2.name ?? node2.target ?? node2.id;
-}
-function adjacencyFor(nodes, edges) {
-  const adjacency = new Map(nodes.map((node2) => [node2.id, /* @__PURE__ */ new Set()]));
-  for (const edge of edges) {
-    adjacency.get(edge.source)?.add(edge.target);
-    adjacency.get(edge.target)?.add(edge.source);
-  }
-  return adjacency;
-}
-function rootReachability(nodes, edges, seedIds) {
-  const adjacency = adjacencyFor(nodes, edges);
-  const reachable = /* @__PURE__ */ new Set();
-  const depthByNode = /* @__PURE__ */ new Map();
-  const nearestRootByNode = /* @__PURE__ */ new Map();
-  const queue = [];
-  for (const node2 of nodes) {
-    if (!seedIds.has(node2.id)) continue;
-    reachable.add(node2.id);
-    depthByNode.set(node2.id, 0);
-    nearestRootByNode.set(node2.id, node2.id);
-    queue.push(node2.id);
-  }
-  for (let cursor = 0; cursor < queue.length; cursor += 1) {
-    const current = queue[cursor];
-    for (const neighbor of adjacency.get(current) ?? []) {
-      if (reachable.has(neighbor)) continue;
-      reachable.add(neighbor);
-      depthByNode.set(neighbor, (depthByNode.get(current) ?? 0) + 1);
-      nearestRootByNode.set(neighbor, nearestRootByNode.get(current));
-      queue.push(neighbor);
-    }
-  }
-  return { reachable, depthByNode, nearestRootByNode };
-}
-function buildImpactGraphPayload(index, impact) {
-  const graph = impact.structuralGraph ?? index?.graph ?? { nodes: [], edges: [] };
-  const config = index?.memoryConfig;
-  const seedIds = new Set((impact.changedFiles ?? [impact.changed]).map((path) => `file:${path}`));
-  const impactItems = new Map((impact.related ?? []).map((item) => [item.id, item]));
-  const isAllowedNode = (node2) => {
-    if (!node2) return false;
-    if (node2.path && resolveMemoryArea(node2.path, config)?.scope === "local") return false;
-    return true;
-  };
-  const sourceNodes = (graph.nodes ?? []).filter(isAllowedNode);
-  const indexedNodes = new Map(sourceNodes.map((node2) => [node2.id, node2]));
-  const seenEdges = /* @__PURE__ */ new Set();
+// packages/cli/src/graph-view/traceability.mjs
+import { resolve as resolve19 } from "node:path";
+import { stat } from "node:fs/promises";
+async function exportTraceability(root) {
+  const config = readMemoryConfig(root);
+  if (config.errors?.length) throw new Error(JSON.stringify(config.errors));
+  const { index } = readFreshIndex(root);
+  const nodes = new Map(index.graph.nodes.map((n) => [n.id, n]));
+  const colors = ["#b9a3ff", "#70c9a2", "#72b9e6", "#d6b879", "#e393a9", "#78c9cd"];
+  const types = config.traceability.keys.map((k, i) => ({ ...k, color: colors[i % colors.length] }));
+  const typesByRelation = new Map(types.map((t) => [t.relation, t]));
   const edges = [];
-  for (const edge of graph.edges ?? []) {
-    if (!indexedNodes.has(edge.source) || !indexedNodes.has(edge.target)) continue;
-    const key = edgeKey2(edge);
-    if (seenEdges.has(key)) continue;
-    seenEdges.add(key);
-    edges.push({ source: edge.source, target: edge.target, relation: edge.relation, confidence: edge.confidence, weight: edge.weight ?? edge.relationWeight, score: edge.score, traceabilityKey: edge.traceabilityKey });
-  }
-  const { reachable, depthByNode, nearestRootByNode } = rootReachability(sourceNodes, edges, seedIds);
-  const retainedNodes = sourceNodes.filter((node2) => reachable.has(node2.id));
-  const retainedEdges = edges.filter((edge) => reachable.has(edge.source) && reachable.has(edge.target));
-  const nodes = retainedNodes.map((source) => {
-    const item = impactItems.get(source.id);
-    const seed = seedIds.has(source.id);
-    return {
-      id: source.id,
-      type: source.type ?? item?.type ?? "file",
-      path: source.path ?? item?.path,
-      label: labelForNode({ ...source, ...item }),
-      seed,
-      ranked: Boolean(item),
-      depth: depthByNode.get(source.id) ?? 0,
-      nearestRoot: nearestRootByNode.get(source.id),
-      component: 0,
-      seededComponent: true,
-      impactScore: seed ? 100 : item?.impactScore ?? 0,
-      reasons: seed ? ["changed-file"] : item?.reasons ?? [],
-      scoreBreakdown: seed ? { seed: 100 } : item?.scoreBreakdown,
-      retrieval: item?.retrieval ?? source.retrieval,
-      contractId: item?.contractId ?? source.contractId,
-      title: item?.title ?? source.title,
-      sections: item?.sections ?? source.sections,
-      vectorEvidence: item?.vectorEvidence
-    };
-  });
+  for (const edge of index.graph.edges) {
+    const type = typesByRelation.get(edge.relation);
+    const source = nodes.get(edge.source)?.path;
+    const target = nodes.get(edge.target)?.path;
+    if (!type || !source || !target || source === target) continue;
+    if ([source, target].some((p) => resolveMemoryArea(p, config)?.scope === "local")) continue;
+    if (!(await Promise.all([source, target].map(async (p) => {
+      const absolute = resolve19(root, p);
+      if (!absolute.startsWith(resolve19(root) + "/")) return false;
+      try {
+        return (await stat(absolute)).isFile();
+      } catch {
+        return false;
+      }
+    }))).every(Boolean)) continue;
+    edges.push({ source, target, relation: type.relation, weight: type.weight, color: type.color });
+  }
   return {
-    changed: impact.changed,
-    changedFiles: impact.changedFiles ?? [impact.changed],
-    ranking: impact.ranking,
-    semantic: impact.semantic,
-    complete: true,
-    nodes,
-    edges: retainedEdges,
-    components: retainedNodes.length > 0 ? [{ id: 0, size: retainedNodes.length, seeded: true }] : [],
-    diagnostics: {
-      rootNodes: retainedNodes.filter((node2) => seedIds.has(node2.id)).length,
-      connectedNodes: retainedNodes.length,
-      disconnectedNodesOmitted: sourceNodes.length - retainedNodes.length,
-      maximumDepth: Math.max(0, ...depthByNode.values())
-    },
-    omittedRelated: impact.omittedRelated ?? 0
+    version: 1,
+    projectRoot: resolve19(root),
+    config: memoryConfigSummary(config),
+    types,
+    edges: [...new Map(edges.map((e) => [`${e.source}\0${e.target}\0${e.relation}`, e])).values()]
   };
 }
 
 // packages/cli/src/graph-view/server.mjs
-var ASSET_ROOT = join19(dirname13(fileURLToPath2(import.meta.url)), "assets");
-var CONTENT_TYPES = { ".css": "text/css; charset=utf-8", ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".map": "application/json; charset=utf-8" };
+import { createServer } from "node:http";
+import { readFileSync as readFileSync21 } from "node:fs";
+import { dirname as dirname13, extname as extname10, join as join20, resolve as resolve20 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var import_node_style = __toESM(require_node_style(), 1);
+var ASSET_ROOT = join20(dirname13(fileURLToPath2(import.meta.url)), "assets");
+var CONTENT_TYPES = { ".css": "text/css; charset=utf-8", ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".cjs": "text/javascript; charset=utf-8", ".map": "application/json; charset=utf-8" };
 var VENDOR_FILES = {
-  "/vendor/sigma.js": new URL("../../node_modules/sigma/dist/sigma.min.js", import.meta.url),
-  "/vendor/graphology.js": new URL("../../node_modules/graphology/dist/graphology.umd.min.js", import.meta.url),
   "/vendor/d3.js": new URL("../../node_modules/d3/dist/d3.min.js", import.meta.url)
 };
 function json(response, status, value) {
@@ -6730,7 +6738,7 @@ function json(response, status, value) {
 }
 function asset(response, file) {
   try {
-    const body = readFileSync20(file);
+    const body = readFileSync21(file);
     response.writeHead(200, { "content-type": CONTENT_TYPES[extname10(file)] ?? "application/octet-stream", "cache-control": "no-store" });
     response.end(body);
   } catch {
@@ -6738,49 +6746,42 @@ function asset(response, file) {
     response.end("Not found");
   }
 }
-async function buildServedImpact(root, changedPaths) {
-  const normalized = [...new Set(changedPaths.map((path) => canonicalizeChangedPath(root, path)).filter(Boolean))];
-  const { status, index, metadata } = readFreshIndex(root);
-  const overlay = await buildVectorImpactOverlay(root, index, normalized);
-  const impact = buildImpactReport(index, normalized, { root, overlay, verboseSemantic: false, related: 40 });
-  const graph = buildImpactGraphPayload(index, impact);
-  const graphIds = new Set(graph.nodes.map((node2) => node2.id));
-  const explorerImpact = {
-    ...impact,
-    related: impact.related.filter((item) => graphIds.has(item.id))
-  };
-  return { ok: status.ok, status, metadata, impact: explorerImpact, graph };
-}
 async function startImpactGraphServer({ root, changed, host = "127.0.0.1", port = 0 }) {
-  let payload = await buildServedImpact(root, changed);
+  root = resolve20(root);
+  if (!["127.0.0.1", "localhost", "::1"].includes(host)) throw new Error("Graph UI is local-only; use a loopback host.");
+  const build = async () => {
+    const data = await exportTraceability(root);
+    const paths = [...new Set(data.edges.flatMap((e) => [e.source, e.target]))];
+    return { ...data, projectRoot: void 0, nodes: paths.map((path) => ({ id: path, ...import_node_style.default.describeNode(path, data.config.documentation.root) })) };
+  };
+  let payload = await build();
   const server = createServer(async (request, response) => {
     const url = new URL(request.url ?? "/", `http://${request.headers.host ?? host}`);
-    if (url.pathname === "/api/impact") return json(response, 200, payload);
-    if (url.pathname === "/api/reroot") {
-      const paths = url.searchParams.getAll("changed");
-      if (paths.length === 0) return json(response, 400, { ok: false, error: { code: "MISSING_CHANGED", message: "At least one changed path is required." } });
+    if (!["GET", "HEAD"].includes(request.method)) return json(response, 405, { error: "Method not allowed" });
+    if (url.pathname === "/api/graph") {
       try {
-        payload = await buildServedImpact(root, paths);
+        payload = await build();
         return json(response, 200, payload);
       } catch (error) {
         return json(response, 500, { ok: false, error: { code: "GRAPH_SERVE_FAILED", message: error instanceof Error ? error.message : String(error) } });
       }
     }
     if (VENDOR_FILES[url.pathname]) return asset(response, fileURLToPath2(VENDOR_FILES[url.pathname]));
+    if (url.pathname === "/policy.js") return asset(response, join20(ASSET_ROOT, "../policy.cjs"));
     const relative8 = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-    if (!["index.html", "app.css", "app.js"].includes(relative8)) {
+    if (!["index.html", "app.css", "app.js", "file-list.js", "graph-client.js", "layout.js"].includes(relative8)) {
       response.writeHead(404);
       return response.end("Not found");
     }
-    return asset(response, join19(ASSET_ROOT, relative8));
+    return asset(response, join20(ASSET_ROOT, relative8));
   });
-  await new Promise((resolve19, reject) => {
+  await new Promise((resolve21, reject) => {
     server.once("error", reject);
-    server.listen(port, host, resolve19);
+    server.listen(port, host, resolve21);
   });
   const address = server.address();
   const actualPort = typeof address === "object" && address ? address.port : port;
-  return { server, url: `http://${host}:${actualPort}`, payload };
+  return { server, url: `http://${host.includes(":") ? `[${host}]` : host}:${actualPort}`, payload };
 }
 
 // packages/cli/src/impact/format.mjs
@@ -6936,9 +6937,25 @@ async function runGraph(argv) {
   const sub = argv[0];
   const isImpact = sub === "impact";
   const isServe = sub === "serve";
-  if (!["impact", "communities", "serve"].includes(sub)) usage(sub ? `Unknown graph command: ${sub}` : "Missing graph command.", "graph");
+  if (!["impact", "communities", "serve", "export"].includes(sub)) usage(sub ? `Unknown graph command: ${sub}` : "Missing graph command.", "graph");
   const options = parseGraphOptions(argv.slice(1));
-  if (isServe && options.changed.length === 0) usage("Missing required option: --changed <path>.", "graph serve");
+  if (sub === "export") {
+    const graph = await exportTraceability(options.root);
+    delete graph.projectRoot;
+    const directory = join21(options.root, ".dotdotgod");
+    await mkdir(directory, { recursive: true });
+    const path = join21(directory, "traceability.json");
+    const temporary = `${path}.${process.pid}.tmp`;
+    try {
+      await writeFile(temporary, JSON.stringify(graph, null, 2));
+      await rename(temporary, path);
+    } finally {
+      await rm(temporary, { force: true });
+    }
+    console.log(options.json ? JSON.stringify({ ok: true, path, edges: graph.edges.length }) : `graph export: ${path} (${graph.edges.length} relations)`);
+    return;
+  }
+  if (isServe && options.changed.length > 0) usage("graph serve now shows project traceability. Use graph impact for --changed analysis.", "graph serve");
   if (isServe && !Number.isInteger(options.port)) usage("Invalid --port. Use an integer from 0 through 65535.", "graph serve");
   if (isServe) {
     options.changed = [...new Set(options.changed.map((path) => canonicalizeChangedPath(options.root, path)).filter(Boolean))];