archmantic 1.0.0

package/dist/mcp/bench.d.ts

@@ -0,0 +1,25 @@
+import { type ArchitectureModel } from "../ir/types.js";
+export interface BenchTask {
+    question: string;
+    mcpTool: string;
+    mcpAnswer: string;
+    rawFiles: string[];
+}
+export interface BenchRow extends BenchTask {
+    mcpTokens: number;
+    rawTokens: number;
+    savedPct: number;
+}
+export interface BenchReport {
+    rows: BenchRow[];
+    totalMcp: number;
+    totalRaw: number;
+    savedPct: number;
+    mode: "estimate" | "exact";
+}
+export type TokenCounter = (text: string) => Promise<number>;
+/** Offline heuristic — clearly labeled as an estimate (≈ chars/4). */
+export declare const estimateCounter: TokenCounter;
+export declare function runBenchmark(root: string, model: ArchitectureModel, count: TokenCounter, mode: "estimate" | "exact"): Promise<BenchReport>;
+export declare function renderBench(report: BenchReport): string;
+//# sourceMappingURL=bench.d.ts.map

package/dist/mcp/bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.d.ts","sourceRoot":"","sources":["../../src/mcp/bench.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7D,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAE,YAAmD,CAAC;AA0DlF,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,UAAU,GAAG,OAAO,GACzB,OAAO,CAAC,WAAW,CAAC,CAatB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAyBvD"}

package/dist/mcp/bench.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateCounter = void 0;
+exports.runBenchmark = runBenchmark;
+exports.renderBench = renderBench;
+/**
+ * Token-savings benchmark (the *second* proof). For a set of realistic
+ * architecture questions, compare the tokens an agent consumes answering via the
+ * Archmantic MCP tools vs. reading the raw source files it would otherwise need.
+ *
+ * Graph questions (dependencies, dependents, "what can this do?") are the win:
+ * the MCP answer is a few hundred tokens; the file-reading baseline is the whole
+ * subtree. Default counting is an offline estimate (chars/4); `--exact` uses the
+ * Anthropic token-counting endpoint (BYOK) for a precise number.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const walk_js_1 = require("../analyze/walk.js");
+const queries_js_1 = require("./queries.js");
+/** Offline heuristic — clearly labeled as an estimate (≈ chars/4). */
+const estimateCounter = async (t) => Math.ceil(t.length / 4);
+exports.estimateCounter = estimateCounter;
+function buildTasks(root, model) {
+    const src = (0, walk_js_1.walkSourceFiles)(root).filter((f) => f.startsWith("src/"));
+    return [
+        {
+            question: "What can this system do?",
+            mcpTool: "search_capabilities",
+            mcpAnswer: (0, queries_js_1.searchCapabilities)(model, ""),
+            rawFiles: src, // an agent would read the whole codebase to enumerate capabilities
+        },
+        {
+            question: "What is the overall architecture context?",
+            mcpTool: "get_context",
+            mcpAnswer: (0, queries_js_1.getContext)(model),
+            rawFiles: ["package.json", ...src],
+        },
+        {
+            question: "What does the analysis pipeline depend on and do?",
+            mcpTool: "get_component(analyze)",
+            mcpAnswer: (0, queries_js_1.getComponent)(model, "analyze/index.ts"),
+            rawFiles: [
+                "src/analyze/index.ts",
+                "src/analyze/walk.ts",
+                "src/analyze/tier0.ts",
+                "src/analyze/tier1.ts",
+                "src/analyze/derive.ts",
+            ],
+        },
+        {
+            question: "What business process does the CLI implement?",
+            mcpTool: "get_process",
+            mcpAnswer: (0, queries_js_1.getProcess)(model),
+            rawFiles: ["src/cli.ts", "src/analyze/index.ts", "src/analyze/derive.ts"],
+        },
+        {
+            question: "What depends on the IR types module?",
+            mcpTool: "whats_related(ir/types)",
+            mcpAnswer: (0, queries_js_1.whatsRelated)(model, "ir/types.ts"),
+            rawFiles: src, // finding dependents without the model means scanning everything
+        },
+    ];
+}
+function readFiles(root, files) {
+    const parts = [];
+    for (const f of files) {
+        const p = (0, node_path_1.join)(root, f);
+        if (!(0, node_fs_1.existsSync)(p))
+            continue;
+        try {
+            parts.push((0, node_fs_1.readFileSync)(p, "utf8"));
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return parts.join("\n");
+}
+async function runBenchmark(root, model, count, mode) {
+    const tasks = buildTasks(root, model);
+    const rows = [];
+    for (const t of tasks) {
+        const mcpTokens = await count(t.mcpAnswer);
+        const rawTokens = await count(readFiles(root, t.rawFiles));
+        const savedPct = rawTokens === 0 ? 0 : Math.round(((rawTokens - mcpTokens) / rawTokens) * 1000) / 10;
+        rows.push({ ...t, mcpTokens, rawTokens, savedPct });
+    }
+    const totalMcp = rows.reduce((n, r) => n + r.mcpTokens, 0);
+    const totalRaw = rows.reduce((n, r) => n + r.rawTokens, 0);
+    const savedPct = totalRaw === 0 ? 0 : Math.round(((totalRaw - totalMcp) / totalRaw) * 1000) / 10;
+    return { rows, totalMcp, totalRaw, savedPct, mode };
+}
+function renderBench(report) {
+    const BOLD = "\x1b[1m";
+    const DIM = "\x1b[2m";
+    const GREEN = "\x1b[32m";
+    const RESET = "\x1b[0m";
+    const out = [];
+    out.push(`${BOLD}Token-savings benchmark${RESET} ${DIM}(MCP query vs. raw file reads · ${report.mode} counts)${RESET}`);
+    out.push("");
+    for (const r of report.rows) {
+        out.push(`${BOLD}${r.question}${RESET}`);
+        out.push(`  via MCP ${DIM}(${r.mcpTool})${RESET}: ${r.mcpTokens} tok   ` +
+            `via files ${DIM}(${r.rawFiles.length} files)${RESET}: ${r.rawTokens} tok   ` +
+            `${GREEN}−${r.savedPct}%${RESET}`);
+    }
+    out.push("");
+    out.push(`${BOLD}Total:${RESET} ${report.totalMcp} tok via MCP vs ${report.totalRaw} tok via files  →  ` +
+        `${GREEN}${BOLD}${report.savedPct}% fewer tokens${RESET}`);
+    if (report.mode === "estimate") {
+        out.push(`${DIM}Estimated (≈ chars/4). Run \`archmantic bench --exact\` (needs ANTHROPIC_API_KEY) for precise counts.${RESET}`);
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=bench.js.map

package/dist/mcp/bench.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.js","sourceRoot":"","sources":["../../src/mcp/bench.ts"],"names":[],"mappings":";;;AAkGA,oCAkBC;AAED,kCAyBC;AA/ID;;;;;;;;;GASG;AACH,qCAAmD;AACnD,yCAAiC;AAEjC,gDAAqD;AACrD,6CAAsG;AAyBtG,sEAAsE;AAC/D,MAAM,eAAe,GAAiB,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAArE,QAAA,eAAe,mBAAsD;AAElF,SAAS,UAAU,CAAC,IAAY,EAAE,KAAwB;IACxD,MAAM,GAAG,GAAG,IAAA,yBAAe,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO;QACL;YACE,QAAQ,EAAE,0BAA0B;YACpC,OAAO,EAAE,qBAAqB;YAC9B,SAAS,EAAE,IAAA,+BAAkB,EAAC,KAAK,EAAE,EAAE,CAAC;YACxC,QAAQ,EAAE,GAAG,EAAE,mEAAmE;SACnF;QACD;YACE,QAAQ,EAAE,2CAA2C;YACrD,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,IAAA,uBAAU,EAAC,KAAK,CAAC;YAC5B,QAAQ,EAAE,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC;SACnC;QACD;YACE,QAAQ,EAAE,mDAAmD;YAC7D,OAAO,EAAE,wBAAwB;YACjC,SAAS,EAAE,IAAA,yBAAY,EAAC,KAAK,EAAE,kBAAkB,CAAC;YAClD,QAAQ,EAAE;gBACR,sBAAsB;gBACtB,qBAAqB;gBACrB,sBAAsB;gBACtB,sBAAsB;gBACtB,uBAAuB;aACxB;SACF;QACD;YACE,QAAQ,EAAE,+CAA+C;YACzD,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,IAAA,uBAAU,EAAC,KAAK,CAAC;YAC5B,QAAQ,EAAE,CAAC,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,CAAC;SAC1E;QACD;YACE,QAAQ,EAAE,sCAAsC;YAChD,OAAO,EAAE,yBAAyB;YAClC,SAAS,EAAE,IAAA,yBAAY,EAAC,KAAK,EAAE,aAAa,CAAC;YAC7C,QAAQ,EAAE,GAAG,EAAE,iEAAiE;SACjF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAe;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAA,oBAAU,EAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,KAAwB,EACxB,KAAmB,EACnB,IAA0B;IAE1B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACjG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,SAAgB,WAAW,CAAC,MAAmB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC;IACvB,MAAM,GAAG,GAAG,SAAS,CAAC;IACtB,MAAM,KAAK,GAAG,UAAU,CAAC;IACzB,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,0BAA0B,KAAK,IAAI,GAAG,mCAAmC,MAAM,CAAC,IAAI,WAAW,KAAK,EAAE,CAAC,CAAC;IACxH,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,GAAG,KAAK,EAAE,CAAC,CAAC;QACzC,GAAG,CAAC,IAAI,CACN,aAAa,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC,CAAC,SAAS,SAAS;YAC7D,aAAa,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,UAAU,KAAK,KAAK,CAAC,CAAC,SAAS,SAAS;YAC7E,GAAG,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,EAAE,CACpC,CAAC;IACJ,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CACN,GAAG,IAAI,SAAS,KAAK,IAAI,MAAM,CAAC,QAAQ,mBAAmB,MAAM,CAAC,QAAQ,qBAAqB;QAC7F,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,iBAAiB,KAAK,EAAE,CAC5D,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,wGAAwG,KAAK,EAAE,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/mcp/queries.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Read queries over the IR — the data plane behind both the MCP server and the
+ * token-savings benchmark. Pure functions: model in, compact grounded text out.
+ *
+ * The whole MCP value prop is that an agent gets exactly the architectural slice
+ * it needs (a few hundred tokens) instead of reading whole source files. Keep
+ * every answer tight and always carry the `file:line` grounding so the agent can
+ * cite/verify.
+ */
+import { type ArchitectureModel, type Component } from "../ir/types.js";
+/** Resolve a loose name (id, path, basename, suffix) to a component. */
+export declare function findComponent(model: ArchitectureModel, name: string): Component | undefined;
+export declare function getContext(model: ArchitectureModel): string;
+export declare function listComponents(model: ArchitectureModel, filter?: string): string;
+export declare function getComponent(model: ArchitectureModel, name: string): string;
+export declare function searchCapabilities(model: ArchitectureModel, query: string): string;
+export declare function getProcess(model: ArchitectureModel): string;
+export declare function getSequence(model: ArchitectureModel): string;
+export declare function getDataModel(model: ArchitectureModel): string;
+export declare function getApiSurface(model: ArchitectureModel): string;
+export declare function whatsRelated(model: ArchitectureModel, name: string): string;
+//# sourceMappingURL=queries.d.ts.map

package/dist/mcp/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/mcp/queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiBxE,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAU3F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAa3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB3E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASlF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAO3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAM5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAqB7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAW9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3E"}

package/dist/mcp/queries.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findComponent = findComponent;
+exports.getContext = getContext;
+exports.listComponents = listComponents;
+exports.getComponent = getComponent;
+exports.searchCapabilities = searchCapabilities;
+exports.getProcess = getProcess;
+exports.getSequence = getSequence;
+exports.getDataModel = getDataModel;
+exports.getApiSurface = getApiSurface;
+exports.whatsRelated = whatsRelated;
+const naming_js_1 = require("../ir/naming.js");
+const rel = (id) => id.slice(id.indexOf(":") + 1);
+/** Short display name: folder-aware component label, or external system name. */
+const shortName = (id) => id.startsWith("comp:")
+    ? (0, naming_js_1.componentLabel)(id)
+    : id.startsWith("sys:ext:")
+        ? id.slice("sys:ext:".length)
+        : id;
+function refOf(el) {
+    return el.provenance[0]?.ref ?? "?";
+}
+/** Resolve a loose name (id, path, basename, suffix) to a component. */
+function findComponent(model, name) {
+    const n = name.trim();
+    const r = n.startsWith("comp:") ? n.slice("comp:".length) : n;
+    return (model.components.find((c) => c.id === n) ??
+        model.components.find((c) => rel(c.id) === r) ??
+        model.components.find((c) => rel(c.id).endsWith("/" + r)) ??
+        model.components.find((c) => (0, naming_js_1.componentLabel)(c.id).toLowerCase() === r.toLowerCase()) ??
+        model.components.find((c) => rel(c.id).split("/").pop() === r));
+}
+function getContext(model) {
+    const internal = model.systems.find((s) => s.kind === "internal");
+    const externals = model.systems.filter((s) => s.kind === "external");
+    const internalDeps = model.relations.filter((r) => r.to.startsWith("comp:")).length;
+    const lines = [
+        `Project: ${model.project}`,
+        internal ? `System: ${internal.name} — ${internal.description ?? "internal system"}` : "",
+        `Components: ${model.components.length}  ·  internal dependencies: ${internalDeps}`,
+        `External systems (${externals.length}): ${externals.map((s) => s.name).join(", ") || "none"}`,
+        `Capabilities: ${model.capabilities.length}  ·  processes: ${model.processes.length}  ·  flows: ${model.flows.length}`,
+    ];
+    if (model.processes[0])
+        lines.push(`Primary process: ${model.processes[0].name}`);
+    return lines.filter(Boolean).join("\n");
+}
+function listComponents(model, filter) {
+    const f = filter?.trim().toLowerCase();
+    const rows = model.components
+        .filter((c) => !f || rel(c.id).toLowerCase().includes(f) || c.name.toLowerCase().includes(f))
+        .map((c) => `- ${(0, naming_js_1.componentLabel)(c.id)} (${rel(c.id)})${c.responsibility ? ` — ${c.responsibility}` : ""}`);
+    return rows.length ? rows.join("\n") : "(no matching components)";
+}
+function getComponent(model, name) {
+    const c = findComponent(model, name);
+    if (!c)
+        return `No component matches "${name}". Try \`list_components\`.`;
+    const out = model.relations.filter((r) => r.from === c.id).map((r) => `${shortName(r.to)} (${refOf(r)})`);
+    const inc = model.relations.filter((r) => r.to === c.id).map((r) => (0, naming_js_1.componentLabel)(r.from));
+    const caps = model.capabilities.filter((cap) => cap.componentIds.includes(c.id)).map((cap) => cap.name);
+    return [
+        `${(0, naming_js_1.componentLabel)(c.id)}  [${rel(c.id)}]`,
+        c.responsibility ? `Responsibility: ${c.responsibility}` : "",
+        `Confidence: ${c.confidence} · grounded: ${refOf(c)}`,
+        `Depends on (${out.length}): ${out.join(", ") || "—"}`,
+        `Used by (${inc.length}): ${inc.join(", ") || "—"}`,
+        caps.length ? `Capabilities: ${caps.join(", ")}` : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function searchCapabilities(model, query) {
+    const q = query.trim().toLowerCase();
+    const hits = model.capabilities.filter((cap) => !q || cap.name.toLowerCase().includes(q) || (cap.description ?? "").toLowerCase().includes(q));
+    if (!hits.length)
+        return `No capabilities match "${query}".`;
+    return hits
+        .map((cap) => `- ${cap.name}: ${cap.description ?? "(no description)"}  [${refOf(cap)}]`)
+        .join("\n");
+}
+function getProcess(model) {
+    const p = model.processes[0];
+    if (!p)
+        return "No process derived.";
+    const steps = p.tasks.map((t, i) => `${i + 1}. ${t.name}`).join("\n");
+    return [`Process: ${p.name}`, p.description ?? "", `Steps:`, steps, `(grounded: ${refOf(p)}, confidence ${p.confidence})`]
+        .filter(Boolean)
+        .join("\n");
+}
+function getSequence(model) {
+    const f = model.flows[0];
+    if (!f)
+        return "No flow derived.";
+    const nameFor = (id) => (id.startsWith("comp:") ? (0, naming_js_1.componentLabel)(id) : id);
+    const steps = f.steps.map((s) => `${nameFor(s.participant)} ${s.action} ${nameFor(s.to ?? s.participant)}`);
+    return [`Sequence: ${f.name}`, ...steps].join("\n");
+}
+function getDataModel(model) {
+    const entities = model.dataEntities ?? [];
+    if (!entities.length)
+        return "No data model detected (no Prisma schema found).";
+    const out = [`Data model: ${entities.length} entities`];
+    for (const e of entities) {
+        const cols = e.fields
+            .filter((f) => !(f.relationTo && !f.isForeignKey))
+            .map((f) => {
+            const tags = [f.isId ? "PK" : "", f.isForeignKey ? "FK" : "", f.isUnique && !f.isId ? "unique" : ""]
+                .filter(Boolean)
+                .join(" ");
+            return `${f.name}: ${f.type}${f.list ? "[]" : ""}${f.optional ? "?" : ""}${tags ? ` (${tags})` : ""}`;
+        });
+        const rels = e.fields
+            .filter((f) => f.relationTo)
+            .map((f) => `${f.name} → ${f.type}${f.list ? "[]" : ""}`);
+        out.push(`\n${e.name}  [${refOf(e)}]`);
+        out.push(`  fields: ${cols.join(", ") || "—"}`);
+        if (rels.length)
+            out.push(`  relations: ${rels.join(", ")}`);
+    }
+    return out.join("\n");
+}
+function getApiSurface(model) {
+    const eps = model.endpoints ?? [];
+    if (!eps.length)
+        return "No API endpoints detected (no routes/procedures/GraphQL schema found).";
+    const byProto = new Map();
+    for (const e of eps)
+        (byProto.get(e.protocol) ?? byProto.set(e.protocol, []).get(e.protocol)).push(e);
+    const out = [`API surface: ${eps.length} endpoints`];
+    for (const [proto, list] of [...byProto.entries()].sort()) {
+        out.push(`\n${proto.toUpperCase()} (${list.length})`);
+        for (const e of list)
+            out.push(`  ${e.method} ${e.path}  [${refOf(e)}]`);
+    }
+    return out.join("\n");
+}
+function whatsRelated(model, name) {
+    const c = findComponent(model, name);
+    if (!c)
+        return `No component matches "${name}".`;
+    const out = model.relations.filter((r) => r.from === c.id).map((r) => `→ ${shortName(r.to)}`);
+    const inc = model.relations.filter((r) => r.to === c.id).map((r) => `← ${(0, naming_js_1.componentLabel)(r.from)}`);
+    return [`Related to ${(0, naming_js_1.componentLabel)(c.id)}:`, ...out, ...inc].join("\n") || "(no relations)";
+}
+//# sourceMappingURL=queries.js.map

package/dist/mcp/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/mcp/queries.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,2 @@
+export declare function startMcpServer(root: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAmEA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiKhE"}

package/dist/mcp/server.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMcpServer = startMcpServer;
+/**
+ * MCP server (USP 7: the diagram you edit *is* the context your agent queries).
+ * Exposes read tools over the committed IR so an agent (Claude Code, Cursor, …)
+ * gets exactly the architectural slice it needs instead of reading whole files.
+ *
+ * stdio transport: protocol travels on stdout, so all human logging goes to
+ * stderr. Built on the official @modelcontextprotocol/sdk.
+ */
+const node_fs_1 = require("node:fs");
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const types_js_1 = require("../ir/types.js");
+const index_js_1 = require("../analyze/index.js");
+const index_js_2 = require("../diff/index.js");
+const index_js_3 = require("../cloud/index.js");
+const usage_js_1 = require("./usage.js");
+const queries_js_1 = require("./queries.js");
+const MODEL_PATH = (0, node_path_1.join)(".archmantic", "model.json");
+function loadModel(root) {
+    const file = (0, node_path_1.join)(root, MODEL_PATH);
+    if (!(0, node_fs_1.existsSync)(file)) {
+        throw new Error(`No model at ${MODEL_PATH}. Run \`archmantic analyze\` first.`);
+    }
+    return JSON.parse((0, node_fs_1.readFileSync)(file, "utf8"));
+}
+function currentCommit(root) {
+    try {
+        return (0, node_child_process_1.execFileSync)("git", ["-C", root, "rev-parse", "HEAD"], { encoding: "utf8" }).trim();
+    }
+    catch {
+        return "working-tree";
+    }
+}
+/** Re-analyze the repo from disk, persist canonically, and return the fresh model. */
+function reanalyze(root) {
+    const model = { ...(0, index_js_1.analyzeRepo)(root), generatedAt: new Date().toISOString() };
+    const dir = (0, node_path_1.join)(root, ".archmantic");
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, "model.json"), (0, types_js_1.serializeModel)(model), "utf8");
+    return model;
+}
+const text = (s) => ({ content: [{ type: "text", text: s }] });
+async function startMcpServer(root) {
+    // Mutable so `refresh`/`sync` update what the read tools serve.
+    let model = loadModel(root);
+    const server = new mcp_js_1.McpServer({ name: "archmantic", version: "1.0.0" });
+    // Usage stats: record each read tool, best-effort flush to the cloud (API if a
+    // token is set, else direct DB, else local-log only). Never breaks the agent.
+    const flushUsage = async (events) => {
+        if ((0, index_js_3.hasApiToken)())
+            await (0, index_js_3.recordUsageApi)(events);
+        else if (process.env.DATABASE_URL)
+            await (0, index_js_3.recordUsage)(events);
+        // no creds → local log only (still queryable via `archmantic usage`)
+    };
+    const usage = new usage_js_1.UsageRecorder(root, () => model.project, flushUsage);
+    usage.start();
+    /** Record the read, then return it as an MCP text result. */
+    const served = (tool, answer) => {
+        usage.record(tool, answer, new Date().toISOString());
+        return text(answer);
+    };
+    server.registerTool("get_context", {
+        title: "Get architecture context",
+        description: "High-level architecture context: project, systems, external dependencies, counts, primary process.",
+    }, async () => served("get_context", (0, queries_js_1.getContext)(model)));
+    server.registerTool("list_components", {
+        title: "List components",
+        description: "List components (optionally filtered by a substring) with their responsibilities.",
+        inputSchema: { filter: zod_1.z.string().optional().describe("optional substring to filter by path/name") },
+    }, async ({ filter }) => served("list_components", (0, queries_js_1.listComponents)(model, filter)));
+    server.registerTool("get_component", {
+        title: "Get component detail",
+        description: "Responsibility, dependencies, dependents, and capabilities for one component (by name or path).",
+        inputSchema: { name: zod_1.z.string().describe("component name, basename, or repo path") },
+    }, async ({ name }) => served("get_component", (0, queries_js_1.getComponent)(model, name)));
+    server.registerTool("search_capabilities", {
+        title: "Search capabilities",
+        description: "Plain-English 'what can this system do?' capabilities matching a query (empty = all).",
+        inputSchema: { query: zod_1.z.string().default("").describe("search text; empty returns all capabilities") },
+    }, async ({ query }) => served("search_capabilities", (0, queries_js_1.searchCapabilities)(model, query)));
+    server.registerTool("get_process", {
+        title: "Get business process",
+        description: "The primary business process (BPMN) as an ordered list of steps.",
+    }, async () => served("get_process", (0, queries_js_1.getProcess)(model)));
+    server.registerTool("get_sequence", {
+        title: "Get sequence",
+        description: "The primary call/dependency sequence (sequence diagram) as ordered messages.",
+    }, async () => served("get_sequence", (0, queries_js_1.getSequence)(model)));
+    server.registerTool("get_data_model", {
+        title: "Get data model",
+        description: "The persisted data model (DB entities/tables): each entity's fields with PK/FK/unique markers and its relations. Grounded in the schema file.",
+    }, async () => served("get_data_model", (0, queries_js_1.getDataModel)(model)));
+    server.registerTool("get_api_surface", {
+        title: "Get API surface",
+        description: "The API contract: REST routes, tRPC procedures, and GraphQL operations with HTTP methods/paths, grouped by protocol. Grounded in code.",
+    }, async () => served("get_api_surface", (0, queries_js_1.getApiSurface)(model)));
+    server.registerTool("whats_related", {
+        title: "What's related",
+        description: "Immediate architectural neighbors (depends-on / used-by) of a component.",
+        inputSchema: { name: zod_1.z.string().describe("component name, basename, or repo path") },
+    }, async ({ name }) => served("whats_related", (0, queries_js_1.whatsRelated)(model, name)));
+    // ── Write tools: the agent keeps the living model current ──────────────────
+    server.registerTool("refresh", {
+        title: "Refresh the model",
+        description: "Re-analyze the repository from disk and update the served model (and .archmantic/model.json). Call this after changing code so subsequent reads reflect reality.",
+    }, async () => {
+        model = reanalyze(root);
+        return text(`Refreshed — ${model.components.length} components, ${model.capabilities.length} capabilities.`);
+    });
+    server.registerTool("sync", {
+        title: "Sync the model to the cloud",
+        description: "Re-analyze the repo and push the updated architecture model to the team cloud (org-scoped via your token; direct via DATABASE_URL otherwise). Returns what changed. Call this after making architectural changes.",
+    }, async () => {
+        const before = model;
+        model = reanalyze(root);
+        const diff = (0, index_js_2.diffModels)(before, model, "previous", "updated");
+        const commit = currentCommit(root);
+        const viaApi = (0, index_js_3.hasApiToken)();
+        try {
+            if (viaApi)
+                await (0, index_js_3.pushModelApi)(model, commit);
+            else
+                await (0, index_js_3.pushModel)(model, commit);
+        }
+        catch (err) {
+            return text(`Model refreshed locally, but cloud push failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return text(`Synced "${model.project}" @ ${commit.slice(0, 7)} ${viaApi ? "(org-scoped API)" : "(direct)"}.\nChanges: ${(0, index_js_2.summarizeChange)(diff)}`);
+    });
+    // Flush buffered usage on shutdown so short sessions still report.
+    for (const sig of ["SIGINT", "SIGTERM"]) {
+        process.on(sig, () => {
+            void usage.stop().finally(() => process.exit(0));
+        });
+    }
+    process.on("beforeExit", () => void usage.stop());
+    process.stderr.write(`archmantic MCP server: serving "${model.project}" (${model.components.length} components, ${model.capabilities.length} capabilities) over stdio — read + sync tools, usage stats on\n`);
+    await server.connect(new stdio_js_1.StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/usage.d.ts

@@ -0,0 +1,23 @@
+import { type UsageEvent } from "../cloud/store.js";
+export declare const USAGE_LOG: string;
+export declare class UsageRecorder {
+    private root;
+    private getProject;
+    private flush;
+    private buffer;
+    private srcTokensCache;
+    private timer;
+    constructor(root: string, getProject: () => string, flush: (events: UsageEvent[]) => Promise<void>);
+    /** Approx tokens an agent would read to answer broad questions (cached). */
+    private srcTokens;
+    /** Record one tool call. `answer` is the text returned to the agent. */
+    record(tool: string, answer: string, now: string): void;
+    private appendLocal;
+    /** Flush the buffer to the cloud; on failure, retry next time (id makes it idempotent). */
+    private drain;
+    start(): void;
+    stop(): Promise<void>;
+}
+/** Parse the local usage log into events (for `archmantic usage`). */
+export declare function readUsageLog(root: string): UsageEvent[];
+//# sourceMappingURL=usage.d.ts.map

package/dist/mcp/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/mcp/usage.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgBpD,eAAO,MAAM,SAAS,QAAqC,CAAC;AAI5D,qBAAa,aAAa;IAMtB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK;IAPf,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,KAAK,CAA6C;gBAGhD,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,MAAM,EACxB,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;IAGxD,4EAA4E;IAC5E,OAAO,CAAC,SAAS;IAcjB,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBvD,OAAO,CAAC,WAAW;IASnB,2FAA2F;YAC7E,KAAK;IAWnB,KAAK,IAAI,IAAI;IAKP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CASvD"}