archmantic 1.0.0

package/dist/project/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Projection layer — turns the one grounded IR into the many views (Mermaid
+ * context/component/sequence, BPMN process, the capability map, the trust
+ * surface) and a self-contained HTML viewer. See docs/ARCHITECTURE.md §1.
+ */
+import { type ArchitectureModel } from "../ir/types.js";
+export { contextDiagram, componentDiagram, sequenceDiagram } from "./mermaid.js";
+export { erDiagram } from "./erd.js";
+export { bpmnXml } from "./bpmn.js";
+export { capabilityMapText, groupCapabilities } from "./capability.js";
+export { renderHtml } from "./html.js";
+export { buildSpecMarkdown, buildSpecJson, type BuildSpecJson } from "./spec.js";
+export { parseBpmnProcess, type ParsedProcess } from "./bpmn-parse.js";
+export * from "./trust.js";
+/** A compact, copy-pasteable preview for the terminal (the `view` default). */
+export declare function terminalPreview(model: ArchitectureModel): string;
+/** Everything the `view` command emits to disk, keyed by relative filename. */
+export declare function projectionArtifacts(model: ArchitectureModel): Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAQxD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvE,cAAc,YAAY,CAAC;AAM3B,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyDhE;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUpF"}

package/dist/project/index.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBpmnProcess = exports.buildSpecJson = exports.buildSpecMarkdown = exports.renderHtml = exports.groupCapabilities = exports.capabilityMapText = exports.bpmnXml = exports.erDiagram = exports.sequenceDiagram = exports.componentDiagram = exports.contextDiagram = void 0;
+exports.terminalPreview = terminalPreview;
+exports.projectionArtifacts = projectionArtifacts;
+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 html_js_1 = require("./html.js");
+const trust_js_1 = require("./trust.js");
+var mermaid_js_2 = require("./mermaid.js");
+Object.defineProperty(exports, "contextDiagram", { enumerable: true, get: function () { return mermaid_js_2.contextDiagram; } });
+Object.defineProperty(exports, "componentDiagram", { enumerable: true, get: function () { return mermaid_js_2.componentDiagram; } });
+Object.defineProperty(exports, "sequenceDiagram", { enumerable: true, get: function () { return mermaid_js_2.sequenceDiagram; } });
+var erd_js_2 = require("./erd.js");
+Object.defineProperty(exports, "erDiagram", { enumerable: true, get: function () { return erd_js_2.erDiagram; } });
+var bpmn_js_2 = require("./bpmn.js");
+Object.defineProperty(exports, "bpmnXml", { enumerable: true, get: function () { return bpmn_js_2.bpmnXml; } });
+var capability_js_2 = require("./capability.js");
+Object.defineProperty(exports, "capabilityMapText", { enumerable: true, get: function () { return capability_js_2.capabilityMapText; } });
+Object.defineProperty(exports, "groupCapabilities", { enumerable: true, get: function () { return capability_js_2.groupCapabilities; } });
+var html_js_2 = require("./html.js");
+Object.defineProperty(exports, "renderHtml", { enumerable: true, get: function () { return html_js_2.renderHtml; } });
+var spec_js_1 = require("./spec.js");
+Object.defineProperty(exports, "buildSpecMarkdown", { enumerable: true, get: function () { return spec_js_1.buildSpecMarkdown; } });
+Object.defineProperty(exports, "buildSpecJson", { enumerable: true, get: function () { return spec_js_1.buildSpecJson; } });
+var bpmn_parse_js_1 = require("./bpmn-parse.js");
+Object.defineProperty(exports, "parseBpmnProcess", { enumerable: true, get: function () { return bpmn_parse_js_1.parseBpmnProcess; } });
+__exportStar(require("./trust.js"), exports);
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+/** A compact, copy-pasteable preview for the terminal (the `view` default). */
+function terminalPreview(model) {
+    const grounded = [
+        ...model.systems,
+        ...model.components,
+        ...model.relations,
+        ...model.capabilities,
+        ...model.flows,
+        ...model.processes,
+        ...(model.dataEntities ?? []),
+        ...(model.endpoints ?? []),
+    ];
+    const s = (0, trust_js_1.summarize)(grounded);
+    const out = [];
+    out.push(`${BOLD}${model.project}${RESET} — living architecture model`);
+    out.push(`${DIM}trust:${RESET} ${s.total} elements · ${s.totalRefs} code refs · ` +
+        `${Math.round(s.meanConfidence * 100)}% mean confidence ` +
+        `(${s.high} high / ${s.medium} medium / ${s.low} low ⚠)`);
+    if (model.technologies?.length) {
+        const byCat = new Map();
+        for (const t of model.technologies)
+            (byCat.get(t.category) ?? byCat.set(t.category, []).get(t.category)).push(t.name);
+        const stack = [...byCat.entries()].sort().map(([c, n]) => `${c}: ${n.join(", ")}`).join(" · ");
+        out.push(`\n${BOLD}Stack${RESET} ${DIM}${stack}${RESET}`);
+    }
+    out.push(`\n${BOLD}Capability map${RESET} ${DIM}— what can this system do?${RESET}`);
+    out.push((0, capability_js_1.capabilityMapText)(model));
+    out.push(`\n${BOLD}Context diagram${RESET} ${DIM}(Mermaid source)${RESET}`);
+    out.push((0, mermaid_js_1.contextDiagram)(model));
+    if (model.dataEntities?.length) {
+        out.push(`\n${BOLD}Data model${RESET} ${DIM}— ${model.dataEntities.length} entities${RESET}`);
+        out.push("  " +
+            model.dataEntities
+                .map((e) => `${e.name} (${e.fields.filter((f) => !f.relationTo).length})`)
+                .join("  ·  "));
+    }
+    if (model.endpoints?.length) {
+        out.push(`\n${BOLD}API surface${RESET} ${DIM}— ${model.endpoints.length} endpoints${RESET}`);
+        for (const e of model.endpoints.slice(0, 12))
+            out.push(`  ${e.method.padEnd(7)} ${e.path} ${DIM}(${e.protocol})${RESET}`);
+        if (model.endpoints.length > 12)
+            out.push(`  ${DIM}… and ${model.endpoints.length - 12} more${RESET}`);
+    }
+    const proc = model.processes[0];
+    if (proc) {
+        out.push(`\n${BOLD}Process${RESET} ${DIM}(BPMN)${RESET} — ${proc.name}`);
+        out.push("  " + proc.tasks.map((t) => t.name).join("  →  "));
+    }
+    return out.join("\n");
+}
+/** Everything the `view` command emits to disk, keyed by relative filename. */
+function projectionArtifacts(model) {
+    const artifacts = {
+        "view.html": (0, html_js_1.renderHtml)(model),
+        "context.mmd": (0, mermaid_js_1.contextDiagram)(model),
+        "components.mmd": (0, mermaid_js_1.componentDiagram)(model),
+    };
+    if (model.flows[0])
+        artifacts["sequence.mmd"] = (0, mermaid_js_1.sequenceDiagram)(model.flows[0], model);
+    if (model.processes[0])
+        artifacts["process.bpmn"] = (0, bpmn_js_1.bpmnXml)(model.processes[0]);
+    if (model.dataEntities?.length)
+        artifacts["data.mmd"] = (0, erd_js_1.erDiagram)(model);
+    return artifacts;
+}
+//# sourceMappingURL=index.js.map

package/dist/project/index.js.map

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

package/dist/project/mermaid.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Mermaid projections (USP 6: one model → many views).
+ *   - contextDiagram:   C4-context level — the system ↔ external systems/actors.
+ *   - componentDiagram: the internal module/dependency graph (Tier-1 edges).
+ *   - sequenceDiagram:  a Flow rendered as a sequence.
+ *
+ * Pure functions over the IR — no I/O, no rendering. Callers turn the source
+ * into SVG (browser/mermaid CLI) or just print it.
+ */
+import { type ArchitectureModel, type Flow } from "../ir/types.js";
+/**
+ * C4 context level: the internal system as one box, with edges to every external
+ * system any component depends on, plus actors. Aggregated, not per-file.
+ */
+export declare function contextDiagram(model: ArchitectureModel): string;
+/** Internal module graph: one node per component, depends_on edges between them. */
+export declare function componentDiagram(model: ArchitectureModel): string;
+/** Render a Flow as a Mermaid sequence diagram. */
+export declare function sequenceDiagram(flow: Flow, model: ArchitectureModel): string;
+//# sourceMappingURL=mermaid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/project/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAanE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyB/D;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyBjE;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiB5E"}

package/dist/project/mermaid.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextDiagram = contextDiagram;
+exports.componentDiagram = componentDiagram;
+exports.sequenceDiagram = sequenceDiagram;
+const naming_js_1 = require("../ir/naming.js");
+/** Mermaid node ids must be alphanumeric-ish; map element ids → safe tokens. */
+function nodeId(id) {
+    return "n_" + id.replace(/[^A-Za-z0-9]/g, "_");
+}
+/** Escape for a Mermaid quoted label. */
+function label(text) {
+    return text.replace(/"/g, "'").replace(/\n/g, " ");
+}
+/**
+ * C4 context level: the internal system as one box, with edges to every external
+ * system any component depends on, plus actors. Aggregated, not per-file.
+ */
+function contextDiagram(model) {
+    const internal = model.systems.find((s) => s.kind === "internal");
+    const lines = ["flowchart LR"];
+    const sysNode = internal ? nodeId(internal.id) : "n_system";
+    lines.push(`  ${sysNode}["${label(internal?.name ?? model.project)}<br/><i>internal system</i>"]`);
+    // External systems referenced by any component → aggregate system→external edges.
+    const externalIds = new Set(model.systems.filter((s) => s.kind === "external").map((s) => s.id));
+    const seenExt = new Set();
+    for (const r of model.relations) {
+        if (!externalIds.has(r.to))
+            continue;
+        if (!seenExt.has(r.to)) {
+            const ext = model.systems.find((s) => s.id === r.to);
+            lines.push(`  ${nodeId(r.to)}["${label(ext.name)}<br/><i>external</i>"]`);
+            seenExt.add(r.to);
+        }
+    }
+    for (const id of seenExt)
+        lines.push(`  ${sysNode} -->|depends on| ${nodeId(id)}`);
+    for (const a of model.actors) {
+        lines.push(`  ${nodeId(a.id)}(["${label(a.name)}<br/><i>${a.kind}</i>"])`);
+        lines.push(`  ${nodeId(a.id)} --> ${sysNode}`);
+    }
+    return lines.join("\n");
+}
+/** Internal module graph: one node per component, depends_on edges between them. */
+function componentDiagram(model) {
+    const lines = ["flowchart TD"];
+    const internal = model.systems.find((s) => s.kind === "internal");
+    lines.push(`  subgraph ${nodeId(internal?.id ?? "sys")}["${label(internal?.name ?? model.project)}"]`);
+    for (const c of model.components) {
+        lines.push(`    ${nodeId(c.id)}["${label((0, naming_js_1.componentLabel)(c.id))}"]`);
+    }
+    lines.push("  end");
+    const compIds = new Set(model.components.map((c) => c.id));
+    const externalIds = new Set(model.systems.filter((s) => s.kind === "external").map((s) => s.id));
+    const drawnExt = new Set();
+    for (const r of model.relations) {
+        if (compIds.has(r.from) && compIds.has(r.to)) {
+            lines.push(`  ${nodeId(r.from)} --> ${nodeId(r.to)}`);
+        }
+        else if (compIds.has(r.from) && externalIds.has(r.to)) {
+            if (!drawnExt.has(r.to)) {
+                const ext = model.systems.find((s) => s.id === r.to);
+                lines.push(`  ${nodeId(r.to)}[/"${label(ext.name)}"/]`);
+                drawnExt.add(r.to);
+            }
+            lines.push(`  ${nodeId(r.from)} -.-> ${nodeId(r.to)}`);
+        }
+    }
+    return lines.join("\n");
+}
+/** Render a Flow as a Mermaid sequence diagram. */
+function sequenceDiagram(flow, model) {
+    const lines = ["sequenceDiagram"];
+    const nameFor = (id) => {
+        const el = model.components.find((c) => c.id === id) ??
+            model.systems.find((s) => s.id === id) ??
+            model.actors.find((a) => a.id === id);
+        return el ? (el.id.startsWith("comp:") ? (0, naming_js_1.componentLabel)(el.id) : el.name) : id;
+    };
+    for (const p of flow.participants) {
+        lines.push(`  participant ${nodeId(p)} as ${label(nameFor(p))}`);
+    }
+    for (const step of flow.steps) {
+        const target = step.to ?? step.participant;
+        lines.push(`  ${nodeId(step.participant)}->>${nodeId(target)}: ${label(step.action)}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/project/mermaid.js.map

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

package/dist/project/spec.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Build-spec emitter — project the architecture model into an agent-consumable
+ * "build spec": what the system should be (capabilities, components,
+ * responsibilities, dependencies, processes), grounded in `file:line`.
+ *
+ * This is the bridge of the edit-then-build loop: edit the model (capabilities,
+ * the BPMN process), emit a spec, and hand it to an external coding agent (e.g.
+ * Claude Code) to implement or verify. Markdown for humans/agents, JSON for
+ * programmatic consumers. Pure projection over the IR.
+ */
+import { type ArchitectureModel } from "../ir/types.js";
+export declare function buildSpecMarkdown(model: ArchitectureModel): string;
+export interface BuildSpecJson {
+    project: string;
+    generatedAt?: string;
+    overview: {
+        components: number;
+        internalDependencies: number;
+        capabilities: number;
+        externals: string[];
+    };
+    technologies: {
+        name: string;
+        category: string;
+    }[];
+    capabilities: {
+        name: string;
+        description?: string;
+        ref: string;
+        components: string[];
+    }[];
+    components: {
+        id: string;
+        label: string;
+        path: string;
+        responsibility?: string;
+        dependsOn: string[];
+        implements: string[];
+    }[];
+    dataModel: {
+        name: string;
+        ref: string;
+        fields: {
+            name: string;
+            type: string;
+            optional?: boolean;
+            list?: boolean;
+            key?: "PK" | "FK" | "UK";
+        }[];
+        relations: {
+            field: string;
+            to: string;
+            list?: boolean;
+        }[];
+    }[];
+    endpoints: {
+        method: string;
+        path: string;
+        protocol: string;
+        ref: string;
+    }[];
+    process?: {
+        name: string;
+        description?: string;
+        steps: string[];
+    };
+}
+export declare function buildSpecJson(model: ArchitectureModel): BuildSpecJson;
+//# sourceMappingURL=spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/project/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAaxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAmGlE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1G,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1F,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC9H,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;SAAE,EAAE,CAAC;QACvG,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAC;KAC5D,EAAE,CAAC;IACJ,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7E,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAqDrE"}

package/dist/project/spec.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSpecMarkdown = buildSpecMarkdown;
+exports.buildSpecJson = buildSpecJson;
+const naming_js_1 = require("../ir/naming.js");
+const capability_js_1 = require("./capability.js");
+const rel = (id) => id.slice(id.indexOf(":") + 1);
+const refOf = (el) => el.provenance[0]?.ref ?? "?";
+function shortTarget(id) {
+    if (id.startsWith("comp:"))
+        return (0, naming_js_1.componentLabel)(id);
+    if (id.startsWith("sys:ext:"))
+        return id.slice("sys:ext:".length);
+    return id;
+}
+function buildSpecMarkdown(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 out = [];
+    out.push(`# Build Spec — ${model.project}`);
+    out.push("");
+    out.push(`> Generated by Archmantic from the architecture model${model.generatedAt ? ` (${model.generatedAt})` : ""}. ` +
+        `Every item is grounded in a code reference. Hand this to a coding agent to implement or verify the system.`);
+    out.push("");
+    out.push("## Overview");
+    out.push("");
+    out.push(`${internal?.description ?? model.project}`);
+    out.push("");
+    out.push(`- **${model.components.length}** components, **${internalDeps}** internal dependencies, ` +
+        `**${model.capabilities.length}** capabilities, **${model.processes.length}** process(es).`);
+    out.push(`- **External systems:** ${externals.map((s) => s.name).join(", ") || "none"}`);
+    if (model.technologies?.length) {
+        out.push("");
+        out.push("## Tech stack");
+        out.push("");
+        const byCat = new Map();
+        for (const t of model.technologies)
+            (byCat.get(t.category) ?? byCat.set(t.category, []).get(t.category)).push(t.name);
+        for (const [cat, names] of [...byCat.entries()].sort())
+            out.push(`- **${cat}:** ${names.join(", ")}`);
+    }
+    if (model.dataEntities?.length) {
+        out.push("");
+        out.push("## Data model");
+        out.push("");
+        for (const e of model.dataEntities) {
+            out.push(`### ${e.name} <sub>\`${refOf(e)}\`</sub>`);
+            for (const f of e.fields) {
+                if (f.relationTo && !f.isForeignKey)
+                    continue; // pure nav field → shown as relation below
+                const tags = [f.isId ? "PK" : "", f.isForeignKey ? "FK" : "", f.isUnique && !f.isId ? "unique" : ""]
+                    .filter(Boolean)
+                    .join(", ");
+                out.push(`- ${f.name}: ${f.type}${f.list ? "[]" : ""}${f.optional ? "?" : ""}${tags ? ` (${tags})` : ""}`);
+            }
+            for (const f of e.fields.filter((f) => f.relationTo)) {
+                out.push(`- → ${f.name}: ${f.type}${f.list ? "[]" : ""} _(relation)_`);
+            }
+            out.push("");
+        }
+    }
+    if (model.endpoints?.length) {
+        out.push("");
+        out.push("## API surface");
+        out.push("");
+        for (const e of model.endpoints) {
+            out.push(`- \`${e.method} ${e.path}\` <sub>${e.protocol} · \`${refOf(e)}\`</sub>`);
+        }
+    }
+    out.push("");
+    out.push("## Capabilities to implement");
+    out.push("");
+    const groups = (0, capability_js_1.groupCapabilities)(model);
+    if (!groups.length)
+        out.push("_None derived._");
+    for (const g of groups) {
+        out.push(`### ${g.area}/`);
+        for (const cap of g.capabilities) {
+            out.push(`- **${cap.name}** — ${cap.description ?? "(no description)"} <sub>\`${refOf(cap)}\`</sub>`);
+        }
+        out.push("");
+    }
+    out.push("## Components");
+    out.push("");
+    for (const c of model.components) {
+        const deps = model.relations.filter((r) => r.from === c.id).map((r) => shortTarget(r.to));
+        const implals = model.capabilities.filter((cap) => cap.componentIds.includes(c.id)).map((cap) => cap.name);
+        out.push(`### ${(0, naming_js_1.componentLabel)(c.id)} \`${rel(c.id)}\``);
+        if (c.responsibility)
+            out.push(`- Responsibility: ${c.responsibility}`);
+        out.push(`- Depends on: ${deps.length ? deps.join(", ") : "—"}`);
+        if (implals.length)
+            out.push(`- Implements: ${implals.join(", ")}`);
+        out.push("");
+    }
+    const proc = model.processes[0];
+    if (proc) {
+        out.push("## Process");
+        out.push("");
+        out.push(`**${proc.name}**${proc.description ? ` — ${proc.description}` : ""}`);
+        out.push("");
+        out.push(proc.tasks.map((t, i) => `${i + 1}. ${t.name}`).join("\n"));
+        out.push("");
+    }
+    out.push("---");
+    out.push(`<sub>Archmantic build spec · ${model.components.length} components · grounded in code.</sub>`);
+    return out.join("\n");
+}
+function buildSpecJson(model) {
+    const externals = model.systems.filter((s) => s.kind === "external");
+    const proc = model.processes[0];
+    return {
+        project: model.project,
+        generatedAt: model.generatedAt,
+        overview: {
+            components: model.components.length,
+            internalDependencies: model.relations.filter((r) => r.to.startsWith("comp:")).length,
+            capabilities: model.capabilities.length,
+            externals: externals.map((s) => s.name),
+        },
+        technologies: (model.technologies ?? []).map((t) => ({ name: t.name, category: t.category })),
+        capabilities: model.capabilities.map((cap) => ({
+            name: cap.name,
+            description: cap.description,
+            ref: refOf(cap),
+            components: cap.componentIds.map(shortTarget),
+        })),
+        components: model.components.map((c) => ({
+            id: c.id,
+            label: (0, naming_js_1.componentLabel)(c.id),
+            path: rel(c.id),
+            responsibility: c.responsibility,
+            dependsOn: model.relations.filter((r) => r.from === c.id).map((r) => shortTarget(r.to)),
+            implements: model.capabilities.filter((cap) => cap.componentIds.includes(c.id)).map((cap) => cap.name),
+        })),
+        dataModel: (model.dataEntities ?? []).map((e) => ({
+            name: e.name,
+            ref: refOf(e),
+            fields: e.fields
+                .filter((f) => !(f.relationTo && !f.isForeignKey))
+                .map((f) => ({
+                name: f.name,
+                type: f.type,
+                optional: f.optional,
+                list: f.list,
+                key: f.isId ? "PK" : f.isForeignKey ? "FK" : f.isUnique ? "UK" : undefined,
+            })),
+            relations: e.fields
+                .filter((f) => f.relationTo)
+                .map((f) => ({ field: f.name, to: f.type, list: f.list })),
+        })),
+        endpoints: (model.endpoints ?? []).map((e) => ({
+            method: e.method,
+            path: e.path,
+            protocol: e.protocol,
+            ref: refOf(e),
+        })),
+        process: proc
+            ? { name: proc.name, description: proc.description, steps: proc.tasks.map((t) => t.name) }
+            : undefined,
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/project/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/project/spec.ts"],"names":[],"mappings":";;AAuBA,8CAmGC;AAmBD,sCAqDC;AAvLD,+CAAiD;AACjD,mDAAoD;AAEpD,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,KAAK,GAAG,CAAC,EAAqC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,CAAC;AAEtF,SAAS,WAAW,CAAC,EAAU;IAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAA,0BAAc,EAAC,EAAE,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAwB;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,GAAG,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CACN,wDAAwD,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QAC5G,4GAA4G,CAC/G,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,WAAW,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CACN,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,oBAAoB,YAAY,4BAA4B;QACxF,KAAK,KAAK,CAAC,YAAY,CAAC,MAAM,sBAAsB,KAAK,CAAC,SAAS,CAAC,MAAM,iBAAiB,CAC9F,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,2BAA2B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAEzF,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY;YAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,YAAY;oBAAE,SAAS,CAAC,2CAA2C;gBAC1F,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;qBACjG,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7G,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YACzE,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,QAAQ,QAAQ,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,IAAA,iCAAiB,EAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACjC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,WAAW,IAAI,kBAAkB,WAAW,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxG,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1F,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3G,GAAG,CAAC,IAAI,CAAC,OAAO,IAAA,0BAAc,EAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,cAAc;YAAE,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,IAAI,EAAE,CAAC;QACT,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,GAAG,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,UAAU,CAAC,MAAM,uCAAuC,CAAC,CAAC;IACzG,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAmBD,SAAgB,aAAa,CAAC,KAAwB;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE;YACR,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;YACnC,oBAAoB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACpF,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM;YACvC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACxC;QACD,YAAY,EAAE,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7F,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;YACf,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;SAC9C,CAAC,CAAC;QACH,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,IAAA,0BAAc,EAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvF,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;SACvG,CAAC,CAAC;QACH,SAAS,EAAE,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,CAAC,CAAC,MAAM;iBACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;iBACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAc,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE,IAAc,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,IAAc,CAAC,CAAC,CAAC,SAAS;aAC5G,CAAC,CAAC;YACL,SAAS,EAAE,CAAC,CAAC,MAAM;iBAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;iBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SAC7D,CAAC,CAAC;QACH,SAAS,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;SACd,CAAC,CAAC;QACH,OAAO,EAAE,IAAI;YACX,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;YAC1F,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/project/trust.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Trust layer (USP 3) — turn provenance + confidence into a verifiable surface.
+ *
+ * Every projected element can show "grounded in N refs" and a confidence band;
+ * low-confidence elements are flagged so a human (or the Tier-2 pass) knows where
+ * to look. This is the differentiator: the rest of the AI-diagram field ships
+ * ungrounded output.
+ */
+import { type Provenance } from "../ir/types.js";
+export interface Grounded {
+    provenance: Provenance[];
+    confidence: number;
+}
+/** Below this, an element is "needs review" and gets flagged in every view. */
+export declare const LOW_CONFIDENCE = 0.6;
+export type ConfidenceBand = "high" | "medium" | "low";
+export declare function band(confidence: number): ConfidenceBand;
+export declare function refCount(el: Grounded): number;
+/** Unique source files/refs backing an element (provenance may repeat a file). */
+export declare function refs(el: Grounded): string[];
+export declare function isLowConfidence(el: Grounded): boolean;
+/** "grounded in 3 refs · medium confidence" */
+export declare function badge(el: Grounded): string;
+export interface TrustSummary {
+    total: number;
+    high: number;
+    medium: number;
+    low: number;
+    /** Mean confidence across the counted elements, 0..1. */
+    meanConfidence: number;
+    /** Total provenance references backing the whole model. */
+    totalRefs: number;
+}
+export declare function summarize(elements: Grounded[]): TrustSummary;
+//# sourceMappingURL=trust.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/project/trust.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAIvD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAE7C;AAED,kFAAkF;AAClF,wBAAgB,IAAI,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,CAE3C;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAG1C;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,YAAY,CAY5D"}

package/dist/project/trust.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOW_CONFIDENCE = void 0;
+exports.band = band;
+exports.refCount = refCount;
+exports.refs = refs;
+exports.isLowConfidence = isLowConfidence;
+exports.badge = badge;
+exports.summarize = summarize;
+/** Below this, an element is "needs review" and gets flagged in every view. */
+exports.LOW_CONFIDENCE = 0.6;
+function band(confidence) {
+    if (confidence >= 0.85)
+        return "high";
+    if (confidence >= exports.LOW_CONFIDENCE)
+        return "medium";
+    return "low";
+}
+function refCount(el) {
+    return el.provenance.length;
+}
+/** Unique source files/refs backing an element (provenance may repeat a file). */
+function refs(el) {
+    return [...new Set(el.provenance.map((p) => p.ref))];
+}
+function isLowConfidence(el) {
+    return el.confidence < exports.LOW_CONFIDENCE;
+}
+/** "grounded in 3 refs · medium confidence" */
+function badge(el) {
+    const n = refCount(el);
+    return `grounded in ${n} ref${n === 1 ? "" : "s"} · ${band(el.confidence)} confidence`;
+}
+function summarize(elements) {
+    const s = { total: 0, high: 0, medium: 0, low: 0, meanConfidence: 0, totalRefs: 0 };
+    if (!elements.length)
+        return s;
+    let sum = 0;
+    for (const el of elements) {
+        s.total++;
+        s[band(el.confidence)]++;
+        s.totalRefs += refCount(el);
+        sum += el.confidence;
+    }
+    s.meanConfidence = sum / s.total;
+    return s;
+}
+//# sourceMappingURL=trust.js.map

package/dist/project/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/project/trust.ts"],"names":[],"mappings":";;;AAoBA,oBAIC;AAED,4BAEC;AAGD,oBAEC;AAED,0CAEC;AAGD,sBAGC;AAaD,8BAYC;AArDD,+EAA+E;AAClE,QAAA,cAAc,GAAG,GAAG,CAAC;AAIlC,SAAgB,IAAI,CAAC,UAAkB;IACrC,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IACtC,IAAI,UAAU,IAAI,sBAAc;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,QAAQ,CAAC,EAAY;IACnC,OAAO,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED,kFAAkF;AAClF,SAAgB,IAAI,CAAC,EAAY;IAC/B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,eAAe,CAAC,EAAY;IAC1C,OAAO,EAAE,CAAC,UAAU,GAAG,sBAAc,CAAC;AACxC,CAAC;AAED,+CAA+C;AAC/C,SAAgB,KAAK,CAAC,EAAY;IAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvB,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;AACzF,CAAC;AAaD,SAAgB,SAAS,CAAC,QAAoB;IAC5C,MAAM,CAAC,GAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAClG,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACzB,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5B,GAAG,IAAI,EAAE,CAAC,UAAU,CAAC;IACvB,CAAC;IACD,CAAC,CAAC,cAAc,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;IACjC,OAAO,CAAC,CAAC;AACX,CAAC"}