@kage-core/kage-graph-mcp 1.4.0 → 2.0.0

package/dist/cli.js

@@ -2,18 +2,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 const promises_1 = require("node:readline/promises");
 const node_process_1 = require("node:process");
 const daemon_js_1 = require("./daemon.js");
 const kernel_js_1 = require("./kernel.js");
 const graph_registry_js_1 = require("./graph-registry.js");
-function usage() {
-    console.log(`Kage repo memory and code graph
+const CORE_USAGE = `Kage — code-grounded memory for coding agents
+
+Core commands:
+  kage demo                                  30-second trust demo (temp dir)
+  kage scan --project <dir>                  60-second truth report on any repo (zero setup)
+  kage init --project <dir>                  create repo memory (.agent_memory only)
+  kage index --project <dir> [--full]        build/refresh code graph + indexes
+  kage recall "<query>" --project <dir>      grounded recall from repo memory
+  kage learn --project <dir> ...             capture a learning as a memory packet
+  kage gains --project <dir>                 what Kage saved you (tokens, cost, stale blocks)
+  kage verify --project <dir>                check memory citations against code
+  kage setup <agent> --project <dir> --write wire your agent (claude-code, codex, cursor, ...)
+  kage doctor --project <dir>                health check
+  kage viewer --project <dir>                local dashboard
+
+Run 'kage help --all' for the full command list (lifecycle, CI, benchmarks, daemon, workspace).`;
+const FULL_USAGE = `Kage — full command reference
 
 Usage:
   kage index --project <dir>
+  kage scan --project <dir> [--json]
   kage demo [--project <dir>]
-  kage init --project <dir>
+  kage init --project <dir> [--with-policy]
   kage policy --project <dir>
   kage doctor --project <dir>
   kage setup list
@@ -35,9 +54,11 @@ Usage:
   kage suppressed --project <dir> [--json]
   kage pr summarize --project <dir> [--json]
   kage pr check --project <dir> [--json]
+  kage staleguard --project <dir> [--json]
   kage upgrade [--dry-run]
   kage branch --project <dir> [--json]
   kage metrics --project <dir> [--json]
+  kage gains --project <dir> [--json]
   kage memory-access --project <dir> [--json]
   kage activity --project <dir> [--json]
   kage memory-audit --project <dir> [--limit <n>] [--json]
@@ -93,23 +114,30 @@ Usage:
   kage promote --project <dir> --public <packet-id>
   kage export-public --project <dir>
   kage registry --project <dir> [--json]
-  kage marketplace --project <dir> [--json]
-  kage org status --project <dir> --org <org> [--json]
-  kage org upload --project <dir> --org <org> --packet <approved-packet-id>
-  kage org review --project <dir> --org <org> --packet <org-packet-id> --approve|--reject
-  kage org recall "<query>" --project <dir> --org <org> [--json]
-  kage org export --project <dir> --org <org> [--json]
-  kage layered-recall "<query>" --project <dir> [--org <org>] [--global] [--json]
-  kage global build --project <dir> [--org <org>] [--json]
   kage changelog --project <dir> [--days <n>] [--json]
   kage review --project <dir>
   kage validate --project <dir>
 
 Types:
-  ${kernel_js_1.MEMORY_TYPES.join(", ")}
-`);
+  ${kernel_js_1.MEMORY_TYPES.join(", ")}`;
+function usage() {
+    console.log(CORE_USAGE);
     process.exit(1);
 }
+// Stale-catch lines lead with color when attached to a terminal so the
+// retention heartbeat is impossible to miss; plain text otherwise (CI, pipes).
+function printStaleCatch(result) {
+    const useColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+    const [headline, ...rest] = (0, kernel_js_1.formatStaleCatch)(result);
+    if (!useColor) {
+        console.log([headline, ...rest].join("\n"));
+        return;
+    }
+    const tint = result.invalidated.length ? "\u001b[33m" : "\u001b[32m";
+    console.log(`${tint}${headline}\u001b[0m`);
+    if (rest.length)
+        console.log(rest.join("\n"));
+}
 function takeArg(args, name) {
     const index = args.indexOf(name);
     if (index === -1)
@@ -170,6 +198,11 @@ async function main() {
     const command = args[0];
     if (!command)
         usage();
+    if (command === "help") {
+        console.log(args.includes("--all") ? FULL_USAGE : CORE_USAGE);
+        return;
+    }
+    await (0, kernel_js_1.ensureTreeSitterLanguages)();
     if (command === "index") {
         const result = (0, kernel_js_1.indexProject)(projectArg(args));
         console.log(`Indexed ${result.projectDir}`);
@@ -180,15 +213,54 @@ async function main() {
         console.log(`Indexes:\n${result.indexes.map((path) => `  - ${path}`).join("\n")}`);
         return;
     }
+    if (command === "scan") {
+        const result = (0, kernel_js_1.truthReport)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`Kage Truth Report — ${result.project_dir}`);
+        console.log(`Scanned ${result.totals.files_scanned} files, ${result.totals.symbols_scanned} symbols${result.totals.docs_scanned ? `, ${result.totals.docs_scanned} doc file(s)` : ""}\n`);
+        console.log(`  ${result.headline}\n`);
+        const sections = [
+            { kind: "duplicate_cluster", heading: "DUPLICATE IMPLEMENTATIONS", count: result.totals.duplicate_clusters },
+            { kind: "ghost_export", heading: "GHOST KNOWLEDGE — exported, never called", count: result.totals.ghost_exports },
+            { kind: "bus_factor", heading: "BUS FACTOR 1 — one head holds it all", count: result.totals.bus_factor_files },
+            { kind: "knowledge_void", heading: "KNOWLEDGE VOID — high churn, zero memory", count: result.totals.knowledge_voids },
+            { kind: "doc_lie", heading: "DOC LIES — the README vs reality", count: result.totals.doc_lies },
+        ];
+        for (const section of sections) {
+            const items = result.findings.filter((finding) => finding.kind === section.kind);
+            if (!items.length)
+                continue;
+            console.log(`■ ${section.heading} (${section.count}${section.count > items.length ? `, showing top ${items.length}` : ""})`);
+            for (const finding of items) {
+                console.log(`  • ${finding.title}`);
+                console.log(`    ${finding.detail}`);
+                for (const evidence of finding.evidence)
+                    console.log(`      ${evidence}`);
+            }
+            console.log("");
+        }
+        if (!result.findings.length)
+            console.log("No surprising findings — this repo's knowledge is unusually well distributed.\n");
+        if (result.warnings.length)
+            console.log(`Warnings:\n${result.warnings.map((warning) => `  - ${warning}`).join("\n")}\n`);
+        console.log("Fix the void:");
+        for (const action of result.next_actions)
+            console.log(`  ${action}`);
+        return;
+    }
     if (command === "demo") {
-        const demoDir = takeArg(args, "--project") ?? `${process.cwd()}/kage-demo`;
+        // Default to a temp dir: the demo must never write into the user's cwd uninvited.
+        const demoDir = takeArg(args, "--project") ?? (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "kage-demo-"));
         const result = (0, kernel_js_1.runDemo)(demoDir);
         if (args.includes("--json")) {
             console.log(JSON.stringify(result, null, 2));
             return;
         }
         console.log("Kage demo — can you trust your agent's memory?\n");
-        console.log(`Seeded ${result.captured.length} grounded memories in ${result.project_dir}\n`);
+        console.log(`Seeded ${result.captured.length} grounded memories in a throwaway project (${result.project_dir})\n`);
         console.log("1. Hallucinated citation — REJECTED on write:");
         if (result.rejected_hallucination) {
             console.log(`   ✗ "${result.rejected_hallucination.title}"`);
@@ -201,23 +273,40 @@ async function main() {
         for (const t of result.recalled)
             console.log(`   ✓ ${t}`);
         console.log(`\nTrust score: ${result.trust_score}/100`);
-        console.log(`\nSee it in the viewer:  ${result.viewer_command}`);
+        console.log("\nNext, in your own repo:");
+        console.log("  kage init --project .                         create repo memory");
+        console.log("  kage setup <agent> --project . --write        wire your agent (claude-code, codex, cursor, ...)");
+        console.log("  kage viewer --project .                       see the dashboard");
         return;
     }
     if (command === "init") {
-        const result = (0, kernel_js_1.initProject)(projectArg(args));
+        const withPolicy = args.includes("--with-policy");
+        const result = (0, kernel_js_1.initProject)(projectArg(args), { policy: withPolicy });
         console.log(`Initialized Kage memory for ${result.index.projectDir}`);
-        console.log(`Packets: ${result.index.packets}`);
-        console.log(`Migrated legacy nodes: ${result.index.migrated}`);
-        if (result.index.policyPath)
-            console.log(`Agent policy: ${result.index.policyPath}`);
+        console.log("\nCreated:");
+        console.log("  .agent_memory/            memory packets + indexes (only directory Kage owns)");
+        if (result.policyInstalled) {
+            console.log("  AGENTS.md, CLAUDE.md      agent policy (requested via --with-policy)");
+            console.log("  .claude/settings.json     allowed kage tools (requested via --with-policy)");
+        }
+        console.log(`\nPackets: ${result.index.packets}`);
+        if (result.index.migrated)
+            console.log(`Migrated legacy nodes: ${result.index.migrated}`);
         console.log(result.validation.ok ? "Validation passed." : "Validation failed.");
         if (result.validation.errors.length)
             console.log(`Errors:\n${result.validation.errors.map((error) => `  - ${error}`).join("\n")}`);
         if (result.validation.warnings.length)
             console.log(`Warnings:\n${result.validation.warnings.map((warning) => `  - ${warning}`).join("\n")}`);
-        console.log("\nFirst recall preview:\n");
-        console.log(result.sampleRecall.context_block);
+        console.log("\nTip — version control:");
+        console.log("  commit  .agent_memory/packets/    (your team's reviewed memory)");
+        console.log("  ignore  .agent_memory/indexes/ .agent_memory/reports/    (regenerated)");
+        if (!result.policyInstalled) {
+            console.log("\nNot written (opt-in): agent policy files. Add them with `kage policy --project .`");
+            console.log("or rerun `kage init --with-policy` when you're ready to commit them.");
+        }
+        console.log("\nNext:");
+        console.log("  kage setup <agent> --project . --write    wire your agent (claude-code, codex, cursor, ...)");
+        console.log("  kage viewer --project .                   see the dashboard");
         if (!result.validation.ok)
             process.exit(2);
         return;
@@ -570,6 +659,10 @@ async function main() {
                     process.exit(2);
                 return;
             }
+            // The stale-catch moment comes first: the human-readable heartbeat that a
+            // change just invalidated team memory beats the mechanical check output.
+            printStaleCatch((0, kernel_js_1.staleCatch)(projectArg(args)));
+            console.log("");
             console.log(`PR memory check for ${result.project_dir}`);
             console.log(`Branch: ${result.branch ?? "(detached)"}`);
             console.log(`Changed files: ${result.changed_files.length}`);
@@ -588,6 +681,18 @@ async function main() {
         }
         usage();
     }
+    if (command === "staleguard") {
+        // Lightweight stale-catch for pre-commit/pre-push hooks: no graph builds,
+        // no validation — just "did this change invalidate team memory?". Advisory
+        // by design (exit 0) so it informs the commit instead of blocking it.
+        const result = (0, kernel_js_1.staleCatch)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        printStaleCatch(result);
+        return;
+    }
     if (command === "upgrade") {
         const commandLine = "npm install -g @kage-core/kage-graph-mcp@latest";
         if (args.includes("--dry-run")) {
@@ -960,6 +1065,30 @@ async function main() {
         }
         return;
     }
+    if (command === "gains") {
+        const summary = (0, kernel_js_1.valueSummary)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        const plural = (count, singular, pluralForm) => (count === 1 ? singular : pluralForm);
+        const week = summary.last_7d;
+        if (!summary.all_time.recalls && !summary.all_time.stale_withheld && !summary.all_time.stale_caught && !summary.all_time.caller_answers) {
+            console.log("No value events recorded yet. Run kage recall (or let your agent call kage_context) and check back.");
+            return;
+        }
+        console.log(`This week Kage saved you ~${(0, kernel_js_1.formatTokenCount)(week.tokens_saved)} tokens (~$${week.estimated_dollars.toFixed(2)}), ` +
+            `blocked ${week.stale_withheld} stale ${plural(week.stale_withheld, "memory", "memories")}, ` +
+            `caught ${week.stale_caught} stale at change-time, ` +
+            `answered ${week.recalls} ${plural(week.recalls, "recall", "recalls")}.`);
+        const windowLine = (label, window) => `  ${label} ~${(0, kernel_js_1.formatTokenCount)(window.tokens_saved)} tokens (~$${window.estimated_dollars.toFixed(2)}) · ` +
+            `${window.stale_withheld} stale blocked · ${window.stale_caught} stale caught at change-time · ` +
+            `${window.recalls} ${plural(window.recalls, "recall", "recalls")} · ` +
+            `${window.caller_answers} caller ${plural(window.caller_answers, "answer", "answers")}`;
+        console.log(windowLine("Today:   ", summary.today));
+        console.log(windowLine("All time:", summary.all_time));
+        return;
+    }
     if (command === "memory-access") {
         const result = (0, kernel_js_1.kageMemoryAccess)(projectArg(args));
         if (args.includes("--json")) {
@@ -1588,119 +1717,6 @@ async function main() {
         }
         return;
     }
-    if (command === "marketplace") {
-        const result = (0, kernel_js_1.buildMarketplace)(projectArg(args));
-        if (args.includes("--json")) {
-            console.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        console.log(`Marketplace manifest: ${result.path}`);
-        console.log(`Packs: ${result.packs.length}`);
-        for (const pack of result.packs) {
-            console.log(`- ${pack.id} [${pack.kind}] ${pack.title} (${pack.install})`);
-        }
-        return;
-    }
-    if (command === "org") {
-        const action = args[1];
-        const org = takeArg(args, "--org") ?? "local";
-        const projectDir = projectArg(args);
-        if (action === "status") {
-            const result = (0, kernel_js_1.orgStatus)(projectDir, org);
-            if (args.includes("--json"))
-                console.log(JSON.stringify(result, null, 2));
-            else {
-                console.log(`Org memory: ${result.org}`);
-                console.log(`Path: ${result.path}`);
-                console.log(`Inbox: ${result.inbox}`);
-                console.log(`Approved: ${result.approved}`);
-                console.log(`Rejected: ${result.rejected}`);
-                console.log(`Audit events: ${result.audit_events}`);
-                if (result.registry_path)
-                    console.log(`Registry: ${result.registry_path}`);
-            }
-            return;
-        }
-        if (action === "upload") {
-            const id = takeArg(args, "--packet");
-            if (!id)
-                usage();
-            const result = (0, kernel_js_1.orgUploadPacket)(projectDir, org, id);
-            if (!result.ok) {
-                console.error(`Org upload blocked:\n${result.errors.map((error) => `  - ${error}`).join("\n")}`);
-                process.exit(2);
-            }
-            console.log(`Created org review candidate: ${result.path}`);
-            console.log("Approve explicitly with: kage org review --approve");
-            return;
-        }
-        if (action === "review") {
-            const id = takeArg(args, "--packet");
-            if (!id || (!args.includes("--approve") && !args.includes("--reject")))
-                usage();
-            const result = (0, kernel_js_1.orgReviewPacket)(projectDir, org, id, args.includes("--approve") ? "approve" : "reject");
-            if (!result.ok) {
-                console.error(`Org review failed:\n${result.errors.map((error) => `  - ${error}`).join("\n")}`);
-                process.exit(2);
-            }
-            console.log(`Org review wrote: ${result.path}`);
-            return;
-        }
-        if (action === "recall") {
-            const query = firstPositional(args.slice(1));
-            if (!query)
-                usage();
-            const result = (0, kernel_js_1.orgRecall)(projectDir, org, query);
-            if (args.includes("--json"))
-                console.log(JSON.stringify(result, null, 2));
-            else
-                console.log(result.context_block);
-            return;
-        }
-        if (action === "export") {
-            const result = (0, kernel_js_1.exportOrgRegistry)(projectDir, org);
-            if (args.includes("--json"))
-                console.log(JSON.stringify(result, null, 2));
-            else
-                console.log(`Exported org registry: ${result.registry_path}`);
-            return;
-        }
-        usage();
-    }
-    if (command === "layered-recall") {
-        const query = firstPositional(args);
-        if (!query)
-            usage();
-        const result = (0, kernel_js_1.layeredRecall)(projectArg(args), query, {
-            org: takeArg(args, "--org"),
-            includeGlobal: args.includes("--global"),
-        });
-        if (args.includes("--json"))
-            console.log(JSON.stringify(result, null, 2));
-        else
-            console.log(result.context_block);
-        return;
-    }
-    if (command === "global") {
-        const action = args[1];
-        if (action !== "build")
-            usage();
-        const result = (0, kernel_js_1.buildGlobalCdnBundle)(projectArg(args), takeArg(args, "--org") ?? "local");
-        if (args.includes("--json")) {
-            console.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        if (!result.ok) {
-            console.error(`Global bundle failed:\n${result.errors.map((error) => `  - ${error}`).join("\n")}`);
-            process.exit(2);
-        }
-        console.log(`Global registry: ${result.manifest_path}`);
-        console.log(`Latest alias: ${result.alias_path}`);
-        console.log(`Marketplace: ${result.marketplace_path}`);
-        console.log(`Public packets: ${result.packet_count}`);
-        console.log(`Marketplace packs: ${result.marketplace_packs}`);
-        return;
-    }
     if (command === "recall") {
         const query = firstPositional(args);
         if (!query)
@@ -1712,8 +1728,12 @@ async function main() {
             : (0, kernel_js_1.recall)(projectArg(args), query, 5, args.includes("--explain"), { maxContextTokens, structuralHops });
         if (args.includes("--json"))
             console.log(JSON.stringify(result, null, 2));
-        else
+        else {
             console.log(result.context_block);
+            if (result.value_receipt) {
+                console.log(`\n↳ saved ~${(0, kernel_js_1.formatTokenCount)(result.value_receipt.tokens_saved)} tokens vs reading source · ${result.value_receipt.stale_withheld} stale withheld`);
+            }
+        }
         return;
     }
     if (command === "embeddings") {

package/dist/daemon.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.viewerStaticHeaders = viewerStaticHeaders;
 exports.viewerRedirectLocation = viewerRedirectLocation;
+exports.viewerReportPaths = viewerReportPaths;
+exports.viewerUrl = viewerUrl;
 exports.viewerBenchmarkReport = viewerBenchmarkReport;
 exports.daemonContextReport = daemonContextReport;
 exports.readDaemonStatus = readDaemonStatus;
@@ -63,6 +65,52 @@ function viewerRedirectLocation(pathname, search, fallbackSearch) {
         return null;
     return `/viewer/index.html${search || fallbackSearch}`;
 }
+// Every report file the dashboard reads, keyed by its query-string param name.
+// `value` points at the cumulative value ledger written by recall — it is read-only
+// here and must never be regenerated, or the all-time savings history is lost.
+function viewerReportPaths(projectRoot) {
+    const agentDir = (0, node_path_1.join)(projectRoot, ".agent_memory");
+    const reportsDir = (0, node_path_1.join)(agentDir, "reports");
+    return {
+        graph: (0, node_path_1.join)(agentDir, "graph", "graph.json"),
+        code: (0, node_path_1.join)(agentDir, "code_graph", "graph.json"),
+        metrics: (0, node_path_1.join)(agentDir, "metrics.json"),
+        inbox: (0, node_path_1.join)(agentDir, "inbox.json"),
+        review: (0, node_path_1.join)(agentDir, "review", "memory-review.md"),
+        pending: (0, node_path_1.join)(agentDir, "pending"),
+        quality: (0, node_path_1.join)(reportsDir, "quality.json"),
+        benchmark: (0, node_path_1.join)(reportsDir, "benchmark.json"),
+        contributors: (0, node_path_1.join)(reportsDir, "contributors.json"),
+        profile: (0, node_path_1.join)(reportsDir, "profile.json"),
+        xray: (0, node_path_1.join)(reportsDir, "xray.json"),
+        capabilities: (0, node_path_1.join)(reportsDir, "capabilities.json"),
+        slots: (0, node_path_1.join)(reportsDir, "context-slots.json"),
+        decisions: (0, node_path_1.join)(reportsDir, "decisions.json"),
+        risk: (0, node_path_1.join)(reportsDir, "risk.json"),
+        moduleHealth: (0, node_path_1.join)(reportsDir, "module-health.json"),
+        graphInsights: (0, node_path_1.join)(reportsDir, "graph-insights.json"),
+        workspace: (0, node_path_1.join)(reportsDir, "workspace.json"),
+        sessions: (0, node_path_1.join)(reportsDir, "sessions.json"),
+        replay: (0, node_path_1.join)(reportsDir, "replay.json"),
+        memoryAccess: (0, node_path_1.join)(reportsDir, "memory-access.json"),
+        memoryAudit: (0, node_path_1.join)(reportsDir, "memory-audit.json"),
+        handoff: (0, node_path_1.join)(reportsDir, "handoff.json"),
+        lifecycle: (0, node_path_1.join)(reportsDir, "lifecycle.json"),
+        activity: (0, node_path_1.join)(reportsDir, "activity.json"),
+        timeline: (0, node_path_1.join)(reportsDir, "timeline.json"),
+        lineage: (0, node_path_1.join)(reportsDir, "lineage.json"),
+        setup: (0, node_path_1.join)(reportsDir, "setup.json"),
+        trust: (0, node_path_1.join)(reportsDir, "trust.json"),
+        suppressed: (0, node_path_1.join)(reportsDir, "suppressed.json"),
+        value: (0, node_path_1.join)(reportsDir, "value.json"),
+    };
+}
+function viewerUrl(host, port, projectRoot) {
+    const query = Object.entries(viewerReportPaths(projectRoot))
+        .map(([name, path]) => `${name}=${encodeURIComponent(path)}`)
+        .join("&");
+    return `http://${host}:${port}/viewer/index.html?${query}&view=code`;
+}
 function viewerBenchmarkReport(projectDir) {
     const gates = (0, kernel_js_1.benchmarkProject)(projectDir);
     const memoryQuality = (0, kernel_js_1.benchmarkCodingMemoryQuality)();
@@ -545,73 +593,46 @@ async function startViewer(projectDir, options = {}) {
     const viewerDir = (0, node_path_1.resolve)(__dirname, "..", "viewer");
     const threeDir = (0, node_path_1.resolve)(__dirname, "..", "node_modules", "three");
     const projectRoot = (0, node_path_1.resolve)(projectDir);
-    const graphPath = (0, node_path_1.join)(projectRoot, ".agent_memory", "graph", "graph.json");
-    const codePath = (0, node_path_1.join)(projectRoot, ".agent_memory", "code_graph", "graph.json");
-    const metricsPath = (0, node_path_1.join)(projectRoot, ".agent_memory", "metrics.json");
-    const inboxPath = (0, node_path_1.join)(projectRoot, ".agent_memory", "inbox.json");
-    const reviewPath = (0, node_path_1.join)(projectRoot, ".agent_memory", "review", "memory-review.md");
-    const pendingDir = (0, node_path_1.join)(projectRoot, ".agent_memory", "pending");
+    const reports = viewerReportPaths(projectRoot);
     const reportsDir = (0, node_path_1.join)(projectRoot, ".agent_memory", "reports");
-    const qualityPath = (0, node_path_1.join)(reportsDir, "quality.json");
-    const benchmarkPath = (0, node_path_1.join)(reportsDir, "benchmark.json");
-    const contributorsPath = (0, node_path_1.join)(reportsDir, "contributors.json");
-    const profilePath = (0, node_path_1.join)(reportsDir, "profile.json");
-    const xrayPath = (0, node_path_1.join)(reportsDir, "xray.json");
-    const capabilitiesPath = (0, node_path_1.join)(reportsDir, "capabilities.json");
-    const slotsPath = (0, node_path_1.join)(reportsDir, "context-slots.json");
-    const decisionsPath = (0, node_path_1.join)(reportsDir, "decisions.json");
-    const riskPath = (0, node_path_1.join)(reportsDir, "risk.json");
-    const moduleHealthPath = (0, node_path_1.join)(reportsDir, "module-health.json");
-    const graphInsightsPath = (0, node_path_1.join)(reportsDir, "graph-insights.json");
-    const workspacePath = (0, node_path_1.join)(reportsDir, "workspace.json");
-    const sessionsPath = (0, node_path_1.join)(reportsDir, "sessions.json");
-    const replayPath = (0, node_path_1.join)(reportsDir, "replay.json");
-    const memoryAccessPath = (0, node_path_1.join)(reportsDir, "memory-access.json");
-    const memoryAuditPath = (0, node_path_1.join)(reportsDir, "memory-audit.json");
-    const handoffPath = (0, node_path_1.join)(reportsDir, "handoff.json");
-    const lifecyclePath = (0, node_path_1.join)(reportsDir, "lifecycle.json");
-    const activityPath = (0, node_path_1.join)(reportsDir, "activity.json");
-    const timelinePath = (0, node_path_1.join)(reportsDir, "timeline.json");
-    const lineagePath = (0, node_path_1.join)(reportsDir, "lineage.json");
-    const setupPath = (0, node_path_1.join)(reportsDir, "setup.json");
-    const trustPath = (0, node_path_1.join)(reportsDir, "trust.json");
-    const suppressedPath = (0, node_path_1.join)(reportsDir, "suppressed.json");
     // Pre-generate lightweight JSON reports so the viewer can load them directly.
+    // Note: reports.value (the cumulative value ledger written by recall) is served
+    // as-is and intentionally never regenerated here.
     try {
         (0, node_fs_1.mkdirSync)(reportsDir, { recursive: true });
         const metrics = (0, kernel_js_1.kageMetrics)(projectDir);
-        (0, node_fs_1.writeFileSync)(metricsPath, JSON.stringify(metrics, null, 2));
+        (0, node_fs_1.writeFileSync)(reports.metrics, JSON.stringify(metrics, null, 2));
         const inbox = (0, kernel_js_1.memoryInbox)(projectDir);
-        (0, node_fs_1.writeFileSync)(inboxPath, JSON.stringify(inbox, null, 2));
-        (0, node_fs_1.writeFileSync)(qualityPath, JSON.stringify((0, kernel_js_1.qualityReport)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(benchmarkPath, JSON.stringify(viewerBenchmarkReport(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(contributorsPath, JSON.stringify((0, kernel_js_1.kageContributors)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(profilePath, JSON.stringify((0, kernel_js_1.kageProjectProfile)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(xrayPath, JSON.stringify((0, kernel_js_1.kageRepoXray)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(capabilitiesPath, JSON.stringify((0, kernel_js_1.kageCapabilityAudit)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(slotsPath, JSON.stringify((0, kernel_js_1.kageContextSlots)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(decisionsPath, JSON.stringify((0, kernel_js_1.kageDecisionIntelligence)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(riskPath, JSON.stringify((0, kernel_js_1.kageRisk)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(moduleHealthPath, JSON.stringify((0, kernel_js_1.kageModuleHealth)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(graphInsightsPath, JSON.stringify((0, kernel_js_1.kageGraphInsights)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(workspacePath, JSON.stringify((0, kernel_js_1.kageWorkspace)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(sessionsPath, JSON.stringify((0, kernel_js_1.kageSessionCaptureReport)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(replayPath, JSON.stringify((0, kernel_js_1.kageSessionReplay)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(memoryAccessPath, JSON.stringify((0, kernel_js_1.kageMemoryAccess)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(memoryAuditPath, JSON.stringify((0, kernel_js_1.kageMemoryAudit)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(handoffPath, JSON.stringify((0, kernel_js_1.kageMemoryHandoff)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(lifecyclePath, JSON.stringify((0, kernel_js_1.kageMemoryLifecycle)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(activityPath, JSON.stringify((0, kernel_js_1.kageActivity)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(timelinePath, JSON.stringify((0, kernel_js_1.kageMemoryTimeline)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(lineagePath, JSON.stringify((0, kernel_js_1.kageMemoryLineage)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(setupPath, JSON.stringify((0, kernel_js_1.setupDoctor)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(trustPath, JSON.stringify((0, kernel_js_1.benchmarkTrust)(projectDir), null, 2));
-        (0, node_fs_1.writeFileSync)(suppressedPath, JSON.stringify((0, kernel_js_1.kageSuppressedMemory)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.inbox, JSON.stringify(inbox, null, 2));
+        (0, node_fs_1.writeFileSync)(reports.quality, JSON.stringify((0, kernel_js_1.qualityReport)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.benchmark, JSON.stringify(viewerBenchmarkReport(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.contributors, JSON.stringify((0, kernel_js_1.kageContributors)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.profile, JSON.stringify((0, kernel_js_1.kageProjectProfile)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.xray, JSON.stringify((0, kernel_js_1.kageRepoXray)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.capabilities, JSON.stringify((0, kernel_js_1.kageCapabilityAudit)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.slots, JSON.stringify((0, kernel_js_1.kageContextSlots)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.decisions, JSON.stringify((0, kernel_js_1.kageDecisionIntelligence)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.risk, JSON.stringify((0, kernel_js_1.kageRisk)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.moduleHealth, JSON.stringify((0, kernel_js_1.kageModuleHealth)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.graphInsights, JSON.stringify((0, kernel_js_1.kageGraphInsights)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.workspace, JSON.stringify((0, kernel_js_1.kageWorkspace)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.sessions, JSON.stringify((0, kernel_js_1.kageSessionCaptureReport)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.replay, JSON.stringify((0, kernel_js_1.kageSessionReplay)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.memoryAccess, JSON.stringify((0, kernel_js_1.kageMemoryAccess)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.memoryAudit, JSON.stringify((0, kernel_js_1.kageMemoryAudit)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.handoff, JSON.stringify((0, kernel_js_1.kageMemoryHandoff)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.lifecycle, JSON.stringify((0, kernel_js_1.kageMemoryLifecycle)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.activity, JSON.stringify((0, kernel_js_1.kageActivity)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.timeline, JSON.stringify((0, kernel_js_1.kageMemoryTimeline)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.lineage, JSON.stringify((0, kernel_js_1.kageMemoryLineage)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.setup, JSON.stringify((0, kernel_js_1.setupDoctor)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.trust, JSON.stringify((0, kernel_js_1.benchmarkTrust)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(reports.suppressed, JSON.stringify((0, kernel_js_1.kageSuppressedMemory)(projectDir), null, 2));
     }
     catch {
         // non-fatal: viewer will show 404 for reports if generation fails
     }
-    const url = `http://${host}:${port}/viewer/index.html?graph=${encodeURIComponent(graphPath)}&code=${encodeURIComponent(codePath)}&metrics=${encodeURIComponent(metricsPath)}&inbox=${encodeURIComponent(inboxPath)}&review=${encodeURIComponent(reviewPath)}&pending=${encodeURIComponent(pendingDir)}&quality=${encodeURIComponent(qualityPath)}&benchmark=${encodeURIComponent(benchmarkPath)}&contributors=${encodeURIComponent(contributorsPath)}&profile=${encodeURIComponent(profilePath)}&xray=${encodeURIComponent(xrayPath)}&capabilities=${encodeURIComponent(capabilitiesPath)}&slots=${encodeURIComponent(slotsPath)}&decisions=${encodeURIComponent(decisionsPath)}&risk=${encodeURIComponent(riskPath)}&moduleHealth=${encodeURIComponent(moduleHealthPath)}&graphInsights=${encodeURIComponent(graphInsightsPath)}&workspace=${encodeURIComponent(workspacePath)}&sessions=${encodeURIComponent(sessionsPath)}&replay=${encodeURIComponent(replayPath)}&memoryAccess=${encodeURIComponent(memoryAccessPath)}&memoryAudit=${encodeURIComponent(memoryAuditPath)}&handoff=${encodeURIComponent(handoffPath)}&lifecycle=${encodeURIComponent(lifecyclePath)}&activity=${encodeURIComponent(activityPath)}&timeline=${encodeURIComponent(timelinePath)}&lineage=${encodeURIComponent(lineagePath)}&setup=${encodeURIComponent(setupPath)}&trust=${encodeURIComponent(trustPath)}&suppressed=${encodeURIComponent(suppressedPath)}&view=code`;
+    const url = viewerUrl(host, port, projectRoot);
     const server = (0, node_http_1.createServer)((req, res) => {
         const requestUrl = new URL(req.url ?? "/", `http://${host}:${port}`);
         let filePath = null;