archmantic 1.0.0

package/dist/mcp/usage.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageRecorder = exports.USAGE_LOG = void 0;
+exports.readUsageLog = readUsageLog;
+/**
+ * MCP usage recorder — the proof-of-value loop (and the metering substrate).
+ *
+ * Each read tool call is recorded with an estimate of the tokens it returned and
+ * the tokens it *saved* vs the agent reading raw files to answer the same thing
+ * (the baseline reuses the `bench` heuristic). Events are appended to a durable
+ * local log (`.archmantic/usage.jsonl`) and best-effort batch-flushed to the
+ * cloud, where the web `/usage` dashboard aggregates them. Cloud failures never
+ * surface to the agent; the local log is the source of truth (`usage --sync`
+ * re-pushes it, idempotently by event id).
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const walk_js_1 = require("../analyze/walk.js");
+/** Tools whose file-reading alternative is "scan a lot of the repo". */
+const BROAD_TOOLS = new Set([
+    "get_context",
+    "list_components",
+    "search_capabilities",
+    "get_data_model",
+    "get_api_surface",
+    "get_process",
+    "get_sequence",
+    "whats_related",
+]);
+const estTokens = (s) => Math.ceil(s.length / 4);
+exports.USAGE_LOG = (0, node_path_1.join)(".archmantic", "usage.jsonl");
+const FLUSH_EVERY = 5;
+const FLUSH_MS = 60_000;
+class UsageRecorder {
+    root;
+    getProject;
+    flush;
+    buffer = [];
+    srcTokensCache = -1;
+    timer;
+    constructor(root, getProject, flush) {
+        this.root = root;
+        this.getProject = getProject;
+        this.flush = flush;
+    }
+    /** Approx tokens an agent would read to answer broad questions (cached). */
+    srcTokens() {
+        if (this.srcTokensCache >= 0)
+            return this.srcTokensCache;
+        let chars = 0;
+        for (const rel of (0, walk_js_1.walkSourceFiles)(this.root)) {
+            try {
+                chars += (0, node_fs_1.readFileSync)((0, node_path_1.join)(this.root, rel), "utf8").length;
+            }
+            catch {
+                /* skip unreadable */
+            }
+        }
+        this.srcTokensCache = Math.ceil(chars / 4);
+        return this.srcTokensCache;
+    }
+    /** Record one tool call. `answer` is the text returned to the agent. */
+    record(tool, answer, now) {
+        const tokensOut = estTokens(answer);
+        const baseline = BROAD_TOOLS.has(tool) ? this.srcTokens() : Math.round(this.srcTokens() * 0.12);
+        const event = {
+            id: (0, node_crypto_1.randomUUID)(),
+            project: this.getProject(),
+            tool,
+            tokensOut,
+            tokensSaved: Math.max(0, baseline - tokensOut),
+            at: now,
+        };
+        this.appendLocal(event);
+        this.buffer.push(event);
+        if (this.buffer.length >= FLUSH_EVERY)
+            void this.drain();
+    }
+    appendLocal(event) {
+        try {
+            (0, node_fs_1.mkdirSync)((0, node_path_1.join)(this.root, ".archmantic"), { recursive: true });
+            (0, node_fs_1.appendFileSync)((0, node_path_1.join)(this.root, exports.USAGE_LOG), JSON.stringify(event) + "\n", "utf8");
+        }
+        catch {
+            /* a read-only FS shouldn't break the server */
+        }
+    }
+    /** Flush the buffer to the cloud; on failure, retry next time (id makes it idempotent). */
+    async drain() {
+        if (!this.buffer.length)
+            return;
+        const batch = this.buffer;
+        this.buffer = [];
+        try {
+            await this.flush(batch);
+        }
+        catch {
+            this.buffer.unshift(...batch); // keep for the next attempt
+        }
+    }
+    start() {
+        this.timer = setInterval(() => void this.drain(), FLUSH_MS);
+        this.timer.unref?.(); // don't keep the process alive on our account
+    }
+    async stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        await this.drain();
+    }
+}
+exports.UsageRecorder = UsageRecorder;
+/** Parse the local usage log into events (for `archmantic usage`). */
+function readUsageLog(root) {
+    try {
+        return (0, node_fs_1.readFileSync)((0, node_path_1.join)(root, exports.USAGE_LOG), "utf8")
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/mcp/usage.js.map

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

package/dist/project/bpmn-parse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * BPMN 2.0 parser — the inverse of `bpmn.ts`. Turns a (human-edited) BPMN
+ * diagram back into an ordered process so canvas edits can flow into the IR
+ * (the "edit" half of edit-then-build).
+ *
+ * Dependency-free: BPMN here comes from bpmn-js (consistent structure). We read
+ * the flow elements and order tasks by following sequenceFlows from the start
+ * event, falling back to document order.
+ */
+export interface ParsedProcess {
+    name: string;
+    tasks: {
+        name: string;
+    }[];
+}
+export declare function parseBpmnProcess(xml: string): ParsedProcess | null;
+//# sourceMappingURL=bpmn-parse.d.ts.map

package/dist/project/bpmn-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn-parse.d.ts","sourceRoot":"","sources":["../../src/project/bpmn-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3B;AAKD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA0ClE"}

package/dist/project/bpmn-parse.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * BPMN 2.0 parser — the inverse of `bpmn.ts`. Turns a (human-edited) BPMN
+ * diagram back into an ordered process so canvas edits can flow into the IR
+ * (the "edit" half of edit-then-build).
+ *
+ * Dependency-free: BPMN here comes from bpmn-js (consistent structure). We read
+ * the flow elements and order tasks by following sequenceFlows from the start
+ * event, falling back to document order.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBpmnProcess = parseBpmnProcess;
+const attr = (tag, name) => new RegExp(`\\b${name}="([^"]*)"`).exec(tag)?.[1];
+function parseBpmnProcess(xml) {
+    if (!xml || !/<\w*:?process\b/.test(xml))
+        return null;
+    const procName = (() => {
+        const t = /<\w*:?process\b[^>]*>/.exec(xml)?.[0];
+        return (t && attr(t, "name")) || "Process";
+    })();
+    const tasks = new Map(); // id → name
+    const flowNext = new Map(); // sourceRef → targetRef (first wins)
+    let startId;
+    const re = /<(\w*:?)(task|userTask|serviceTask|scriptTask|startEvent|endEvent|sequenceFlow)\b([^>]*?)\/?>/g;
+    let m;
+    while ((m = re.exec(xml))) {
+        const kind = m[2];
+        const body = `<x ${m[3]} >`;
+        const id = attr(body, "id");
+        if (kind === "startEvent") {
+            startId = id;
+        }
+        else if (kind === "sequenceFlow") {
+            const from = attr(body, "sourceRef");
+            const to = attr(body, "targetRef");
+            if (from && to && !flowNext.has(from))
+                flowNext.set(from, to);
+        }
+        else if (kind.toLowerCase().includes("task")) {
+            if (id)
+                tasks.set(id, attr(body, "name") ?? id);
+        }
+    }
+    // Order by walking the flow chain from the start event.
+    const ordered = [];
+    const seen = new Set();
+    let cur = startId;
+    while (cur && !seen.has(cur)) {
+        seen.add(cur);
+        if (tasks.has(cur))
+            ordered.push({ name: tasks.get(cur) });
+        cur = flowNext.get(cur);
+    }
+    // Fallback: document order if the chain didn't yield tasks.
+    if (!ordered.length)
+        for (const name of tasks.values())
+            ordered.push({ name });
+    return { name: procName, tasks: ordered };
+}
+//# sourceMappingURL=bpmn-parse.js.map

package/dist/project/bpmn-parse.js.map

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

package/dist/project/bpmn.d.ts

@@ -0,0 +1,11 @@
+/**
+ * BPMN 2.0 projection (USP 2: auto business-process view — white space nobody
+ * in the code-graph crowd occupies).
+ *
+ * Emits standards-compliant BPMN 2.0 XML *with* DI (diagram interchange)
+ * coordinates, so it renders directly in `bpmn-js` and any BPMN tool. v1 lays a
+ * Process out as a linear lane: startEvent → task* → endEvent.
+ */
+import { type Process } from "../ir/types.js";
+export declare function bpmnXml(process: Process): string;
+//# sourceMappingURL=bpmn.d.ts.map

package/dist/project/bpmn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn.d.ts","sourceRoot":"","sources":["../../src/project/bpmn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAiB9C,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmFhD"}

package/dist/project/bpmn.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bpmnXml = bpmnXml;
+function esc(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+// Layout constants (left-to-right).
+const EVENT = 36;
+const TASK_W = 110;
+const TASK_H = 80;
+const GAP = 50;
+const Y = 120;
+function bpmnXml(process) {
+    const tasks = process.tasks;
+    const startId = "StartEvent_1";
+    const endId = "EndEvent_1";
+    const taskIds = tasks.map((_, i) => `Activity_${i + 1}`);
+    const nodeOrder = [startId, ...taskIds, endId];
+    // Flow elements.
+    const flowEls = [];
+    const flows = [];
+    for (let i = 0; i < nodeOrder.length - 1; i++) {
+        flows.push({ id: `Flow_${i + 1}`, from: nodeOrder[i], to: nodeOrder[i + 1] });
+    }
+    const outgoing = (id) => flows.filter((f) => f.from === id).map((f) => `      <bpmn:outgoing>${f.id}</bpmn:outgoing>`).join("\n");
+    const incoming = (id) => flows.filter((f) => f.to === id).map((f) => `      <bpmn:incoming>${f.id}</bpmn:incoming>`).join("\n");
+    flowEls.push(`    <bpmn:startEvent id="${startId}" name="Start">\n${outgoing(startId)}\n    </bpmn:startEvent>`);
+    tasks.forEach((t, i) => {
+        const id = taskIds[i];
+        flowEls.push(`    <bpmn:task id="${id}" name="${esc(t.name)}">\n${incoming(id)}\n${outgoing(id)}\n    </bpmn:task>`);
+    });
+    flowEls.push(`    <bpmn:endEvent id="${endId}" name="End">\n${incoming(endId)}\n    </bpmn:endEvent>`);
+    for (const f of flows) {
+        flowEls.push(`    <bpmn:sequenceFlow id="${f.id}" sourceRef="${f.from}" targetRef="${f.to}" />`);
+    }
+    // DI: compute x positions left→right; events are small circles, tasks are boxes.
+    const bounds = new Map();
+    let x = 160;
+    for (const id of nodeOrder) {
+        const isEvent = id === startId || id === endId;
+        const w = isEvent ? EVENT : TASK_W;
+        const h = isEvent ? EVENT : TASK_H;
+        const y = isEvent ? Y + (TASK_H - EVENT) / 2 : Y;
+        bounds.set(id, { x, y, w, h, cx: x + w / 2, cy: y + h / 2 });
+        x += w + GAP;
+    }
+    const shapes = nodeOrder
+        .map((id) => {
+        const b = bounds.get(id);
+        return (`      <bpmndi:BPMNShape id="${id}_di" bpmnElement="${id}">\n` +
+            `        <dc:Bounds x="${b.x}" y="${b.y}" width="${b.w}" height="${b.h}" />\n` +
+            `      </bpmndi:BPMNShape>`);
+    })
+        .join("\n");
+    const edges = flows
+        .map((f) => {
+        const a = bounds.get(f.from);
+        const b = bounds.get(f.to);
+        return (`      <bpmndi:BPMNEdge id="${f.id}_di" bpmnElement="${f.id}">\n` +
+            `        <di:waypoint x="${a.x + a.w}" y="${a.cy}" />\n` +
+            `        <di:waypoint x="${b.x}" y="${b.cy}" />\n` +
+            `      </bpmndi:BPMNEdge>`);
+    })
+        .join("\n");
+    const procId = `Process_${process.id.replace(/[^A-Za-z0-9]/g, "_")}`;
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL"
+                  xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
+                  xmlns:dc="http://www.omg.org/spec/DD/20100524/DC"
+                  xmlns:di="http://www.omg.org/spec/DD/20100524/DI"
+                  id="Definitions_archmantic"
+                  targetNamespace="http://archmantic/bpmn">
+  <bpmn:process id="${procId}" name="${esc(process.name)}" isExecutable="false">
+${flowEls.join("\n")}
+  </bpmn:process>
+  <bpmndi:BPMNDiagram id="BPMNDiagram_1">
+    <bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="${procId}">
+${shapes}
+${edges}
+    </bpmndi:BPMNPlane>
+  </bpmndi:BPMNDiagram>
+</bpmn:definitions>
+`;
+}
+//# sourceMappingURL=bpmn.js.map

package/dist/project/bpmn.js.map

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

package/dist/project/capability.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Capability map (USP 1: plain-English "what can this system do?").
+ *
+ * Groups the derived Capabilities by the folder of their implementing component,
+ * so a PM/architect/new-hire reads areas of the system, not a symbol dump. Each
+ * capability keeps its trust badge (USP 3).
+ */
+import { type ArchitectureModel, type Capability } from "../ir/types.js";
+export interface CapabilityGroup {
+    area: string;
+    capabilities: Capability[];
+}
+export declare function groupCapabilities(model: ArchitectureModel): CapabilityGroup[];
+/** Plain-text capability map for the terminal. */
+export declare function capabilityMapText(model: ArchitectureModel): string;
+//# sourceMappingURL=capability.d.ts.map

package/dist/project/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/project/capability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGzE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAUD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAS7E;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAYlE"}

package/dist/project/capability.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupCapabilities = groupCapabilities;
+exports.capabilityMapText = capabilityMapText;
+const trust_js_1 = require("./trust.js");
+function areaOf(cap) {
+    const compId = cap.componentIds[0] ?? "";
+    const rel = compId.slice("comp:".length);
+    const parts = rel.split("/");
+    // Folder of the file (drop the filename); fall back to repo root.
+    return parts.length > 1 ? parts.slice(0, -1).join("/") : "(root)";
+}
+function groupCapabilities(model) {
+    const byArea = new Map();
+    for (const cap of model.capabilities) {
+        const area = areaOf(cap);
+        (byArea.get(area) ?? byArea.set(area, []).get(area)).push(cap);
+    }
+    return [...byArea.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([area, capabilities]) => ({ area, capabilities }));
+}
+/** Plain-text capability map for the terminal. */
+function capabilityMapText(model) {
+    const groups = groupCapabilities(model);
+    if (!groups.length)
+        return "  (no capabilities derived yet)";
+    const out = [];
+    for (const g of groups) {
+        out.push(`  ${g.area}/`);
+        for (const cap of g.capabilities) {
+            const flag = (0, trust_js_1.isLowConfidence)(cap) ? " ⚠" : "";
+            out.push(`    • ${cap.name}${flag}  —  ${(0, trust_js_1.badge)(cap)}`);
+        }
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=capability.js.map

package/dist/project/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/project/capability.ts"],"names":[],"mappings":";;AAuBA,8CASC;AAGD,8CAYC;AAvCD,yCAAoD;AAOpD,SAAS,MAAM,CAAC,GAAe;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,kEAAkE;IAClE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpE,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAwB;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,kDAAkD;AAClD,SAAgB,iBAAiB,CAAC,KAAwB;IACxD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,iCAAiC,CAAC;IAC7D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAA,0BAAe,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,QAAQ,IAAA,gBAAK,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/project/erd.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ERD projection — the data model rendered as a Mermaid `erDiagram`.
+ * Entities become attribute blocks; relation fields become cardinality edges.
+ * Pure function over the IR (see docs/ARCHITECTURE.md §1).
+ */
+import { type ArchitectureModel, type DataEntity } from "../ir/types.js";
+/**
+ * Derive cardinality edges from relation fields, deduped by unordered pair.
+ * Per pair we track, for each side, whether it points at the other with a
+ * to-many (list) field or a to-one (single/FK) field. A list field means that
+ * side is the parent ("one"); a single field means that side is the child
+ * ("many"). This reads both Prisma (which has an inverse list field) and
+ * Drizzle/SQL (FK-only, no inverse) correctly.
+ */
+export declare function relationshipEdges(entities: DataEntity[], byId: Map<string, DataEntity>): string[];
+export declare function erDiagram(model: ArchitectureModel): string;
+//# sourceMappingURL=erd.d.ts.map

package/dist/project/erd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erd.d.ts","sourceRoot":"","sources":["../../src/project/erd.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOzE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAkCjG;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAqB1D"}

package/dist/project/erd.js.map

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

package/dist/project/html.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Static HTML viewer — a single self-contained file that renders every
+ * projection (context + component + sequence via Mermaid, the process via
+ * bpmn-js, the capability map, and the trust layer). Dependency-light: pulls
+ * Mermaid + bpmn-js from a CDN at view time, so the CLI ships no renderer.
+ *
+ * Per docs/ARCHITECTURE.md the CLI degrades to "open in browser"; this is that
+ * artifact, written to .archmantic/view.html.
+ */
+import { type ArchitectureModel } from "../ir/types.js";
+export declare function renderHtml(model: ArchitectureModel): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/project/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/project/html.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA8ExD,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAgG3D"}

package/dist/project/html.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderHtml = renderHtml;
+const mermaid_js_1 = require("./mermaid.js");
+const erd_js_1 = require("./erd.js");
+const bpmn_js_1 = require("./bpmn.js");
+const capability_js_1 = require("./capability.js");
+const trust_js_1 = require("./trust.js");
+function esc(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function allGrounded(model) {
+    return [
+        ...model.systems,
+        ...model.components,
+        ...model.relations,
+        ...model.capabilities,
+        ...model.flows,
+        ...model.processes,
+        ...(model.dataEntities ?? []),
+        ...(model.endpoints ?? []),
+    ];
+}
+function apiSection(model) {
+    const eps = model.endpoints ?? [];
+    if (!eps.length)
+        return "";
+    const rows = eps
+        .map((e) => `<tr><td class="method m-${esc(e.method.toLowerCase())}">${esc(e.method)}</td>` +
+        `<td class="path">${esc(e.path)}</td><td class="proto">${esc(e.protocol)}</td></tr>`)
+        .join("\n");
+    return `
+  <h2>API surface — ${eps.length} endpoints</h2>
+  <div class="card"><table class="api">
+    <thead><tr><th>Method</th><th>Path / operation</th><th>Protocol</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table></div>`;
+}
+function trustBanner(model) {
+    const s = (0, trust_js_1.summarize)(allGrounded(model));
+    const pct = Math.round(s.meanConfidence * 100);
+    return `
+  <section class="trust">
+    <div class="stat"><span class="num">${s.total}</span> grounded elements</div>
+    <div class="stat"><span class="num">${s.totalRefs}</span> code references</div>
+    <div class="stat"><span class="num">${pct}%</span> mean confidence</div>
+    <div class="bands">
+      <span class="b high">${s.high} high</span>
+      <span class="b medium">${s.medium} medium</span>
+      <span class="b low">${s.low} low ⚠</span>
+    </div>
+  </section>`;
+}
+function capabilitySection(model) {
+    const groups = (0, capability_js_1.groupCapabilities)(model);
+    if (!groups.length)
+        return "<p class='empty'>No capabilities derived yet.</p>";
+    const blocks = groups.map((g) => {
+        const items = g.capabilities
+            .map((c) => `<li class="${(0, trust_js_1.isLowConfidence)(c) ? "lowconf" : ""}"><span class="cap">${esc(c.name)}</span>` +
+            `<span class="badge ${(0, trust_js_1.band)(c.confidence)}">${esc((0, trust_js_1.badge)(c))}</span></li>`)
+            .join("\n");
+        return `<div class="area"><h3>${esc(g.area)}/</h3><ul>${items}</ul></div>`;
+    });
+    return blocks.join("\n");
+}
+function mermaidBlock(src) {
+    return `<pre class="mermaid">${esc(src)}</pre>`;
+}
+function renderHtml(model) {
+    const ctx = mermaidBlock((0, mermaid_js_1.contextDiagram)(model));
+    const comp = mermaidBlock((0, mermaid_js_1.componentDiagram)(model));
+    const flow = model.flows[0];
+    const seq = flow ? mermaidBlock((0, mermaid_js_1.sequenceDiagram)(flow, model)) : "<p class='empty'>No flow derived.</p>";
+    const proc = model.processes[0];
+    const bpmn = proc ? (0, bpmn_js_1.bpmnXml)(proc) : "";
+    const erd = model.dataEntities?.length ? mermaidBlock((0, erd_js_1.erDiagram)(model)) : "";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Archmantic — ${esc(model.project)}</title>
+<style>
+  :root { color-scheme: light dark; }
+  * { box-sizing: border-box; }
+  body { font: 15px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; margin: 0; background: #0f1115; color: #e6e9ef; }
+  header { padding: 28px 32px 8px; }
+  header h1 { margin: 0; font-size: 22px; }
+  header .sub { color: #8b93a7; font-size: 13px; margin-top: 4px; }
+  main { padding: 8px 32px 64px; max-width: 1100px; }
+  section.trust { display: flex; gap: 24px; align-items: center; flex-wrap: wrap; background: #171a21; border: 1px solid #232734; border-radius: 12px; padding: 16px 20px; margin: 16px 0 8px; }
+  .stat { font-size: 13px; color: #8b93a7; } .stat .num { font-size: 20px; color: #e6e9ef; font-weight: 600; margin-right: 6px; }
+  .bands { margin-left: auto; display: flex; gap: 8px; }
+  .b { font-size: 12px; padding: 3px 9px; border-radius: 999px; }
+  .b.high { background: #14331f; color: #4ade80; } .b.medium { background: #33300f; color: #facc15; } .b.low { background: #331616; color: #f87171; }
+  h2 { font-size: 16px; margin: 32px 0 12px; padding-bottom: 8px; border-bottom: 1px solid #232734; }
+  .card { background: #171a21; border: 1px solid #232734; border-radius: 12px; padding: 18px; overflow: auto; }
+  .capgrid { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 16px; }
+  .area h3 { margin: 0 0 8px; font-size: 13px; color: #8b93a7; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+  .area ul { list-style: none; margin: 0; padding: 0; }
+  .area li { display: flex; justify-content: space-between; align-items: baseline; gap: 12px; padding: 6px 0; border-bottom: 1px solid #1f232e; }
+  .area li.lowconf .cap::after { content: " ⚠"; }
+  .cap { font-weight: 500; }
+  .badge { font-size: 11px; color: #8b93a7; white-space: nowrap; }
+  .badge.low { color: #f87171; } .badge.medium { color: #facc15; } .badge.high { color: #4ade80; }
+  .empty { color: #8b93a7; font-style: italic; }
+  table.api { width: 100%; border-collapse: collapse; font-size: 13px; }
+  table.api th { text-align: left; color: #8b93a7; font-weight: 600; padding: 6px 10px; border-bottom: 1px solid #232734; }
+  table.api td { padding: 6px 10px; border-bottom: 1px solid #1f232e; }
+  table.api td.path { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+  table.api td.proto { color: #8b93a7; }
+  td.method { font-family: ui-monospace, monospace; font-weight: 600; white-space: nowrap; }
+  td.method.m-get { color: #4ade80; } td.method.m-post { color: #facc15; }
+  td.method.m-put, td.method.m-patch { color: #60a5fa; } td.method.m-delete { color: #f87171; }
+  td.method.m-query { color: #4ade80; } td.method.m-mutation { color: #facc15; }
+  #bpmn { height: 420px; background: #fff; border-radius: 12px; }
+  footer { color: #5a6172; font-size: 12px; padding: 0 32px 40px; }
+</style>
+</head>
+<body>
+<header>
+  <h1>${esc(model.project)}</h1>
+  <div class="sub">Living architecture model · generated ${esc(model.generatedAt ?? "")} · every element grounded in code</div>
+</header>
+<main>
+  ${trustBanner(model)}
+
+  <h2>Capability map — what can this system do?</h2>
+  <div class="capgrid">${capabilitySection(model)}</div>
+
+  <h2>Context</h2>
+  <div class="card">${ctx}</div>
+
+  <h2>Components &amp; dependencies</h2>
+  <div class="card">${comp}</div>
+
+  ${erd ? `<h2>Data model — ${model.dataEntities.length} entities</h2>\n  <div class="card">${erd}</div>` : ""}
+
+  ${apiSection(model)}
+
+  <h2>Sequence — ${esc(flow?.name ?? "")}</h2>
+  <div class="card">${seq}</div>
+
+  <h2>Process (BPMN) — ${esc(proc?.name ?? "")}</h2>
+  <div class="card"><div id="bpmn"></div></div>
+</main>
+<footer>Archmantic · diagrams are projections of one grounded model · ⚠ = low confidence, flagged for review</footer>
+
+<script type="module">
+  import mermaid from "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs";
+  mermaid.initialize({ startOnLoad: true, theme: "dark", securityLevel: "loose" });
+</script>
+<script src="https://unpkg.com/bpmn-js@17/dist/bpmn-navigated-viewer.development.js"></script>
+<script>
+  const BPMN_XML = ${JSON.stringify(bpmn)};
+  if (BPMN_XML && window.BpmnJS) {
+    const viewer = new BpmnJS({ container: "#bpmn" });
+    viewer.importXML(BPMN_XML).then(() => viewer.get("canvas").zoom("fit-viewport")).catch(console.error);
+  }
+</script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=html.js.map

package/dist/project/html.js.map

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