archmantic 1.0.0

package/dist/diff/model-diff.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffModels = diffModels;
+exports.hasChanges = hasChanges;
+exports.summarizeChange = summarizeChange;
+exports.renderDiffText = renderDiffText;
+exports.renderDiffMarkdown = renderDiffMarkdown;
+const naming_js_1 = require("../ir/naming.js");
+const firstRef = (el) => el.provenance[0]?.ref;
+/** A short "from → to" label for a dependency relation. */
+function relationLabel(r) {
+    const side = (id) => id.startsWith("comp:") ? (0, naming_js_1.componentLabel)(id) : id.startsWith("sys:ext:") ? id.slice("sys:ext:".length) : id;
+    return `${side(r.from)} → ${side(r.to)}`;
+}
+function group(model) {
+    const components = new Map();
+    for (const c of model.components) {
+        components.set(c.id, { id: c.id, label: (0, naming_js_1.componentLabel)(c.id), ref: firstRef(c) });
+    }
+    const dependencies = new Map();
+    for (const r of model.relations) {
+        dependencies.set(r.id, { id: r.id, label: relationLabel(r), ref: firstRef(r) });
+    }
+    const externalSystems = new Map();
+    for (const s of model.systems) {
+        if (s.kind === "external")
+            externalSystems.set(s.id, { id: s.id, label: s.name, ref: firstRef(s) });
+    }
+    const capabilities = new Map();
+    for (const cap of model.capabilities) {
+        capabilities.set(cap.id, { id: cap.id, label: cap.name, ref: firstRef(cap) });
+    }
+    return { components, dependencies, externalSystems, capabilities };
+}
+function categoryDiff(base, head) {
+    const added = [];
+    const removed = [];
+    for (const [id, el] of head)
+        if (!base.has(id))
+            added.push(el);
+    for (const [id, el] of base)
+        if (!head.has(id))
+            removed.push(el);
+    const byLabel = (a, b) => a.label.localeCompare(b.label);
+    return { added: added.sort(byLabel), removed: removed.sort(byLabel) };
+}
+function diffModels(base, head, baseLabel = "base", headLabel = "head") {
+    const b = group(base);
+    const h = group(head);
+    const components = categoryDiff(b.components, h.components);
+    const dependencies = categoryDiff(b.dependencies, h.dependencies);
+    const externalSystems = categoryDiff(b.externalSystems, h.externalSystems);
+    const capabilities = categoryDiff(b.capabilities, h.capabilities);
+    const cats = [components, dependencies, externalSystems, capabilities];
+    const changedCount = cats.reduce((n, c) => n + c.added.length + c.removed.length, 0);
+    const unionIds = new Set();
+    for (const m of [b, h]) {
+        for (const map of [m.components, m.dependencies, m.externalSystems, m.capabilities]) {
+            for (const id of map.keys())
+                unionIds.add(id);
+        }
+    }
+    const totalCount = unionIds.size;
+    const driftPct = totalCount === 0 ? 0 : Math.round((changedCount / totalCount) * 1000) / 10;
+    return {
+        baseLabel,
+        headLabel,
+        components,
+        dependencies,
+        externalSystems,
+        capabilities,
+        changedCount,
+        totalCount,
+        driftPct,
+    };
+}
+function hasChanges(diff) {
+    return diff.changedCount > 0;
+}
+/** One-line summary like "+3 components, +12 deps, -1 capabilities". */
+function summarizeChange(d) {
+    const parts = [];
+    const add = (cat, label) => {
+        if (d[cat].added.length)
+            parts.push(`+${d[cat].added.length} ${label}`);
+        if (d[cat].removed.length)
+            parts.push(`-${d[cat].removed.length} ${label}`);
+    };
+    add("components", "components");
+    add("dependencies", "deps");
+    add("externalSystems", "ext");
+    add("capabilities", "capabilities");
+    return parts.length ? parts.join(", ") : "no architecture change";
+}
+// ── Renderers ───────────────────────────────────────────────────────────────
+const CATEGORY_TITLES = [
+    ["components", "Components"],
+    ["dependencies", "Dependencies"],
+    ["externalSystems", "External systems"],
+    ["capabilities", "Capabilities"],
+];
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+/** Terminal-friendly diff report. */
+function renderDiffText(diff) {
+    const out = [];
+    const verdict = diff.driftPct === 0 ? "in sync ✓" : `${diff.driftPct}% drift`;
+    out.push(`${BOLD}Architecture diff${RESET} ${DIM}${diff.baseLabel} → ${diff.headLabel}${RESET}`);
+    out.push(`${diff.changedCount} change${diff.changedCount === 1 ? "" : "s"} across ${diff.totalCount} elements — ${verdict}`);
+    for (const [key, title] of CATEGORY_TITLES) {
+        const cat = diff[key];
+        if (!cat.added.length && !cat.removed.length)
+            continue;
+        out.push(`\n${BOLD}${title}${RESET}`);
+        for (const el of cat.added)
+            out.push(`  ${GREEN}+ ${el.label}${RESET}${el.ref ? ` ${DIM}(${el.ref})${RESET}` : ""}`);
+        for (const el of cat.removed)
+            out.push(`  ${RED}- ${el.label}${RESET}${el.ref ? ` ${DIM}(${el.ref})${RESET}` : ""}`);
+    }
+    if (diff.changedCount === 0)
+        out.push(`\n${DIM}No architecture-level changes.${RESET}`);
+    return out.join("\n");
+}
+/** Markdown report — ready to post as a PR comment ("architecture code review"). */
+function renderDiffMarkdown(diff) {
+    const out = [];
+    const verdict = diff.driftPct === 0 ? "**in sync** ✅" : `**${diff.driftPct}% architecture drift**`;
+    out.push(`## 🏛️ Architecture diff — \`${diff.baseLabel}\` → \`${diff.headLabel}\``);
+    out.push("");
+    out.push(`${diff.changedCount} change${diff.changedCount === 1 ? "" : "s"} across ${diff.totalCount} elements — ${verdict}`);
+    for (const [key, title] of CATEGORY_TITLES) {
+        const cat = diff[key];
+        if (!cat.added.length && !cat.removed.length)
+            continue;
+        out.push("");
+        out.push(`### ${title}`);
+        for (const el of cat.added)
+            out.push(`- 🟢 **added** ${el.label}${el.ref ? ` <sub>\`${el.ref}\`</sub>` : ""}`);
+        for (const el of cat.removed)
+            out.push(`- 🔴 **removed** ${el.label}${el.ref ? ` <sub>\`${el.ref}\`</sub>` : ""}`);
+    }
+    if (diff.changedCount === 0) {
+        out.push("");
+        out.push("_No architecture-level changes._");
+    }
+    out.push("");
+    out.push(`<sub>Generated by [Archmantic](https://github.com/mgionas/Archmantic) — diffs the grounded architecture model, not lines.</sub>`);
+    return out.join("\n");
+}
+//# sourceMappingURL=model-diff.js.map

package/dist/diff/model-diff.js.map

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

package/dist/diff/snapshot.d.ts

@@ -0,0 +1,8 @@
+import { type ArchitectureModel } from "../ir/types.js";
+export declare class GitRefError extends Error {
+}
+/** Resolve a ref to its commit sha, throwing a clear error if it doesn't exist. */
+export declare function resolveRef(root: string, ref: string): string;
+/** Analyze the repo tree at `ref` in isolation. Returns the derived model. */
+export declare function analyzeAtRef(root: string, ref: string): ArchitectureModel;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/diff/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/diff/snapshot.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAUzE"}

package/dist/diff/snapshot.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitRefError = void 0;
+exports.resolveRef = resolveRef;
+exports.analyzeAtRef = analyzeAtRef;
+/**
+ * Materialize and analyze the repo *as of a git ref*, without touching the
+ * working tree (no checkout/stash). Used by `archmantic diff <ref>` to compare a
+ * branch/PR base against the current code at the architecture level.
+ *
+ * Strategy: `git archive <ref>` streams the committed tree into a temp dir,
+ * which we analyze with the normal pipeline, then delete.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const index_js_1 = require("../analyze/index.js");
+/** Conservative allow-list so a ref can never inject into the shell pipe. */
+const SAFE_REF = /^[\w./~^@-]+$/;
+class GitRefError extends Error {
+}
+exports.GitRefError = GitRefError;
+/** Resolve a ref to its commit sha, throwing a clear error if it doesn't exist. */
+function resolveRef(root, ref) {
+    if (!SAFE_REF.test(ref))
+        throw new GitRefError(`Unsafe git ref: "${ref}"`);
+    try {
+        return (0, node_child_process_1.execFileSync)("git", ["-C", root, "rev-parse", "--verify", "--quiet", `${ref}^{commit}`], {
+            encoding: "utf8",
+        }).trim();
+    }
+    catch {
+        throw new GitRefError(`Unknown git ref: "${ref}" (no such commit/branch/tag).`);
+    }
+}
+/** Analyze the repo tree at `ref` in isolation. Returns the derived model. */
+function analyzeAtRef(root, ref) {
+    resolveRef(root, ref); // validates + ensures it exists
+    const tmp = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "archmantic-"));
+    try {
+        // ref is validated against SAFE_REF; tmp comes from mkdtemp (no spaces).
+        (0, node_child_process_1.execSync)(`git -C "${root}" archive --format=tar ${ref} | tar -x -C "${tmp}"`, { stdio: "ignore" });
+        return (0, index_js_1.analyzeRepo)(tmp);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(tmp, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/diff/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/diff/snapshot.ts"],"names":[],"mappings":";;;AAqBA,gCASC;AAGD,oCAUC;AA3CD;;;;;;;GAOG;AACH,2DAA4D;AAC5D,qCAA8C;AAC9C,qCAAiC;AACjC,yCAAiC;AAEjC,kDAAkD;AAElD,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,eAAe,CAAC;AAEjC,MAAa,WAAY,SAAQ,KAAK;CAAG;AAAzC,kCAAyC;AAEzC,mFAAmF;AACnF,SAAgB,UAAU,CAAC,IAAY,EAAE,GAAW;IAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,OAAO,IAAA,iCAAY,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,GAAG,WAAW,CAAC,EAAE;YAC9F,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,qBAAqB,GAAG,gCAAgC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAgB,YAAY,CAAC,IAAY,EAAE,GAAW;IACpD,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gCAAgC;IACvD,MAAM,GAAG,GAAG,IAAA,qBAAW,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,yEAAyE;QACzE,IAAA,6BAAQ,EAAC,WAAW,IAAI,0BAA0B,GAAG,iBAAiB,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnG,OAAO,IAAA,sBAAW,EAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,IAAA,gBAAM,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,2 @@
+export declare function loadEnv(root?: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAWA,wBAAgB,OAAO,CAAC,IAAI,GAAE,MAAsB,GAAG,IAAI,CA0B1D"}

package/dist/env.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEnv = loadEnv;
+/**
+ * Minimal, zero-dependency `.env` loader (BYOK). Reads `.env.local` then `.env`
+ * into `process.env` without overriding variables already set in the real
+ * environment. `.env.local` wins over `.env`; both lose to the actual shell env.
+ *
+ * Keeps the local CLI dependency-light — no `dotenv`. Secrets (ANTHROPIC_API_KEY,
+ * DATABASE_URL) live in the gitignored `.env.local`.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function loadEnv(root = process.cwd()) {
+    for (const name of [".env.local", ".env"]) {
+        const path = (0, node_path_1.join)(root, name);
+        if (!(0, node_fs_1.existsSync)(path))
+            continue;
+        let text;
+        try {
+            text = (0, node_fs_1.readFileSync)(path, "utf8");
+        }
+        catch {
+            continue;
+        }
+        for (const raw of text.split("\n")) {
+            const line = raw.trim();
+            if (!line || line.startsWith("#"))
+                continue;
+            const eq = line.indexOf("=");
+            if (eq === -1)
+                continue;
+            const key = line.slice(0, eq).trim();
+            let val = line.slice(eq + 1).trim();
+            if ((val.startsWith('"') && val.endsWith('"')) ||
+                (val.startsWith("'") && val.endsWith("'"))) {
+                val = val.slice(1, -1);
+            }
+            if (!(key in process.env))
+                process.env[key] = val;
+        }
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;AAWA,0BA0BC;AArCD;;;;;;;GAOG;AACH,qCAAmD;AACnD,yCAAiC;AAEjC,SAAgB,OAAO,CAAC,OAAe,OAAO,CAAC,GAAG,EAAE;IAClD,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,SAAS;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,IACE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC1C,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC1C,CAAC;gBACD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Archmantic — library entry point.
+ * An always-on Solution Architect: a living, provenance-grounded architecture
+ * model that serves both humans (visual diagrams) and AI agents (via MCP).
+ */
+export * from "./ir/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"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 });
+/**
+ * Archmantic — library entry point.
+ * An always-on Solution Architect: a living, provenance-grounded architecture
+ * model that serves both humans (visual diagrams) and AI agents (via MCP).
+ */
+__exportStar(require("./ir/types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,6CAA2B"}

package/dist/ir/naming.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Display-name helpers, shared by analysis (derivation) and projection so the
+ * same element reads identically everywhere. Pure string functions, no deps.
+ */
+/** `analyzeRepo` → "Analyze repo", `tier1` → "Tier 1". */
+export declare function humanize(raw: string): string;
+/**
+ * A readable label for a component id or repo-relative path. `index` files take
+ * their folder's name so `src/analyze/index.ts` reads "Analyze", not "Index".
+ */
+export declare function componentLabel(idOrRel: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/ir/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/ir/naming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD"}

package/dist/ir/naming.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Display-name helpers, shared by analysis (derivation) and projection so the
+ * same element reads identically everywhere. Pure string functions, no deps.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanize = humanize;
+exports.componentLabel = componentLabel;
+/** `analyzeRepo` → "Analyze repo", `tier1` → "Tier 1". */
+function humanize(raw) {
+    const stem = raw.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "").split("/").pop() ?? raw;
+    const words = stem
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/([A-Za-z])([0-9])/g, "$1 $2")
+        .replace(/[_-]+/g, " ")
+        .trim();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/**
+ * A readable label for a component id or repo-relative path. `index` files take
+ * their folder's name so `src/analyze/index.ts` reads "Analyze", not "Index".
+ */
+function componentLabel(idOrRel) {
+    const rel = idOrRel.startsWith("comp:") ? idOrRel.slice("comp:".length) : idOrRel;
+    const parts = rel.split("/");
+    const stem = (parts[parts.length - 1] ?? rel).replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "");
+    if (stem === "index" && parts.length >= 2)
+        return humanize(parts[parts.length - 2]);
+    return humanize(stem);
+}
+//# sourceMappingURL=naming.js.map

package/dist/ir/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/ir/naming.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAGH,4BAQC;AAMD,wCAMC;AArBD,0DAA0D;AAC1D,SAAgB,QAAQ,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;IACnF,MAAM,KAAK,GAAG,IAAI;SACf,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,IAAI,EAAE,CAAC;IACV,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACxF,IAAI,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;IACrF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/ir/types.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Archmantic — the Architecture Model (IR).
+ *
+ * The IR is the product. Diagrams (context / sequence / BPMN) are *projections*
+ * of this model; the MCP server answers queries over it. See docs/ARCHITECTURE.md §2.
+ *
+ * Design invariant: every derived element carries `provenance` (where it came
+ * from) and `confidence` (how sure we are). Human-authored elements use
+ * provenance `{ source: "human" }`. Nothing derived is allowed in without a ref.
+ */
+export declare const SCHEMA_VERSION: "0.1.0";
+/** Where a piece of the model was derived from. */
+export type SourceKind = "repo" | "code" | "runtime" | "docs" | "human";
+/** A single grounding for an element: which source, which exact reference. */
+export interface Provenance {
+    source: SourceKind;
+    /** e.g. "src/pay/charge.ts:42", a commit sha, a trace id, or "manual-edit". */
+    ref: string;
+    /** Confidence contributed by this specific source, 0..1. */
+    confidence?: number;
+}
+/** 0..1 — drives the trust surface and tier escalation (low → analyze deeper). */
+export type Confidence = number;
+interface ElementBase {
+    id: string;
+    name: string;
+    description?: string;
+    /** Required on derived elements; `[{ source: "human" }]` for hand edits. */
+    provenance: Provenance[];
+    /** Aggregate confidence for the element, 0..1. */
+    confidence: Confidence;
+}
+export interface System extends ElementBase {
+    kind: "internal" | "external";
+}
+export interface Component extends ElementBase {
+    /** service | module | package | layer | etc. — kept open for now. */
+    kind: string;
+    /** id of the System this belongs to. */
+    systemId?: string;
+    /** One-line statement of what this component is responsible for. */
+    responsibility?: string;
+}
+export interface Actor extends ElementBase {
+    kind: "user" | "external_system" | "scheduler" | "other";
+}
+export type RelationKind = "calls" | "depends_on" | "publishes_to" | "subscribes_to" | "reads" | "writes";
+export interface Relation extends ElementBase {
+    from: string;
+    to: string;
+    kind: RelationKind;
+}
+export interface FlowStep {
+    /** participant element id (component/actor/system). */
+    participant: string;
+    /** what happens at this step. */
+    action: string;
+    /** optional target participant id (for a message/call). */
+    to?: string;
+    provenance: Provenance[];
+}
+/** An ordered sequence — projects to a sequence diagram. */
+export interface Flow extends ElementBase {
+    participants: string[];
+    steps: FlowStep[];
+}
+/** A business process — projects to BPMN 2.0. */
+export interface Process extends ElementBase {
+    /** kept loose for v0; will gain tasks/gateways/events/lanes. */
+    tasks: {
+        id: string;
+        name: string;
+        provenance: Provenance[];
+    }[];
+}
+/** A plain-English feature/capability — the "what can this system do?" layer. */
+export interface Capability extends ElementBase {
+    /** ids of components that implement this capability. */
+    componentIds: string[];
+}
+/** A detected technology/framework — the "what is this built with?" layer. */
+export interface Technology extends ElementBase {
+    /** framework | ui | database | orm | auth | ai | testing | build | language | infra | library */
+    category: string;
+}
+/** One column/field on a DataEntity. */
+export interface DataField {
+    name: string;
+    /** scalar type (String, Int, DateTime…), an enum name, or a related entity's name. */
+    type: string;
+    /** nullable. */
+    optional?: boolean;
+    /** to-many (array). */
+    list?: boolean;
+    /** part of the primary key. */
+    isId?: boolean;
+    /** has a uniqueness constraint. */
+    isUnique?: boolean;
+    /** set when this field is a relation to another entity — the target entity id. */
+    relationTo?: string;
+    /** scalar foreign-key column (named in a relation's `fields: [...]`). */
+    isForeignKey?: boolean;
+}
+/** A persisted data model entity (DB table / ORM model) — projects to an ERD. */
+export interface DataEntity extends ElementBase {
+    fields: DataField[];
+}
+/** An API endpoint — the contract layer (REST route, tRPC procedure, GraphQL field). */
+export interface Endpoint extends ElementBase {
+    /** HTTP verb (GET/POST/PUT/PATCH/DELETE…) or QUERY/MUTATION/SUBSCRIPTION. */
+    method: string;
+    /** Route path (REST) or operation name (tRPC/GraphQL). */
+    path: string;
+    protocol: "rest" | "trpc" | "graphql";
+}
+/** The whole model for one project. */
+export interface ArchitectureModel {
+    schemaVersion: typeof SCHEMA_VERSION;
+    project: string;
+    /** ISO timestamp; stamped by the caller (kept out of pure helpers). */
+    generatedAt?: string;
+    /** Optional: the multi-repo system this project belongs to (from config). */
+    system?: string;
+    /** Optional: sibling services this project calls (declared in config). */
+    consumes?: string[];
+    systems: System[];
+    components: Component[];
+    actors: Actor[];
+    relations: Relation[];
+    flows: Flow[];
+    processes: Process[];
+    capabilities: Capability[];
+    technologies: Technology[];
+    dataEntities: DataEntity[];
+    endpoints: Endpoint[];
+}
+/**
+ * Canonical ordering for serialization: sort element arrays by id so a full
+ * `analyze` and an incremental `update` produce byte-identical `model.json` for
+ * identical code — keeping the committed IR churn-free and PR diffs clean.
+ * Process/flow internal order (tasks, steps) is meaningful, so it's preserved.
+ */
+export declare function sortModel(m: ArchitectureModel): ArchitectureModel;
+/** Canonical, byte-stable serialization of a model for writing to disk. */
+export declare function serializeModel(m: ArchitectureModel): string;
+/** A fresh, empty model for `archmantic init`. */
+export declare function createEmptyModel(project: string): ArchitectureModel;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/ir/types.d.ts.map

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

package/dist/ir/types.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Archmantic — the Architecture Model (IR).
+ *
+ * The IR is the product. Diagrams (context / sequence / BPMN) are *projections*
+ * of this model; the MCP server answers queries over it. See docs/ARCHITECTURE.md §2.
+ *
+ * Design invariant: every derived element carries `provenance` (where it came
+ * from) and `confidence` (how sure we are). Human-authored elements use
+ * provenance `{ source: "human" }`. Nothing derived is allowed in without a ref.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = void 0;
+exports.sortModel = sortModel;
+exports.serializeModel = serializeModel;
+exports.createEmptyModel = createEmptyModel;
+exports.SCHEMA_VERSION = "0.1.0";
+/**
+ * Canonical ordering for serialization: sort element arrays by id so a full
+ * `analyze` and an incremental `update` produce byte-identical `model.json` for
+ * identical code — keeping the committed IR churn-free and PR diffs clean.
+ * Process/flow internal order (tasks, steps) is meaningful, so it's preserved.
+ */
+function sortModel(m) {
+    const byId = (a, b) => a.id.localeCompare(b.id);
+    return {
+        ...m,
+        systems: [...m.systems].sort(byId),
+        components: [...m.components].sort(byId),
+        actors: [...m.actors].sort(byId),
+        relations: [...m.relations].sort(byId),
+        capabilities: [...m.capabilities].sort(byId),
+        technologies: [...m.technologies].sort(byId),
+        dataEntities: [...m.dataEntities].sort(byId),
+        endpoints: [...m.endpoints].sort(byId),
+    };
+}
+/** Recursively sort object keys so serialization is byte-stable regardless of
+ *  source — a fresh analyze, an incremental patch, or a DB round-trip (Postgres
+ *  JSONB reorders keys). Combined with sortModel's array ordering, this makes
+ *  `model.json` deterministic → churn-free committed IR. */
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value && typeof value === "object") {
+        const obj = value;
+        return Object.fromEntries(Object.keys(obj).sort().map((k) => [k, sortKeys(obj[k])]));
+    }
+    return value;
+}
+/** Canonical, byte-stable serialization of a model for writing to disk. */
+function serializeModel(m) {
+    return JSON.stringify(sortKeys(sortModel(m)), null, 2) + "\n";
+}
+/** A fresh, empty model for `archmantic init`. */
+function createEmptyModel(project) {
+    return {
+        schemaVersion: exports.SCHEMA_VERSION,
+        project,
+        systems: [],
+        components: [],
+        actors: [],
+        relations: [],
+        flows: [],
+        processes: [],
+        capabilities: [],
+        technologies: [],
+        dataEntities: [],
+        endpoints: [],
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/ir/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ir/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA2JH,8BAaC;AAgBD,wCAEC;AAGD,4CAeC;AA1MY,QAAA,cAAc,GAAG,OAAgB,CAAC;AAmJ/C;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,CAAoB;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAiB,EAAE,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO;QACL,GAAG,CAAC;QACJ,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;4DAG4D;AAC5D,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,SAAgB,cAAc,CAAC,CAAoB;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChE,CAAC;AAED,kDAAkD;AAClD,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO;QACL,aAAa,EAAE,sBAAc;QAC7B,OAAO;QACP,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC"}