archmantic 1.0.0

package/dist/analyze/tier0.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRUCTURAL_CONFIDENCE = void 0;
+exports.componentFor = componentFor;
+exports.tier0 = tier0;
+/**
+ * Tier 0 — cheapest analysis: repo structure + manifests.
+ * Produces the internal System + one Component per source file, each grounded
+ * with provenance. No code parsing yet (that's Tier 1).
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_js_1 = require("../ir/types.js");
+/** Confidence for deterministic structural facts (Tier 0/1). */
+exports.STRUCTURAL_CONFIDENCE = 0.95;
+/** One Component per source file (reused by Tier 0 and the incremental updater). */
+function componentFor(rel, systemId) {
+    return {
+        id: `comp:${rel}`,
+        name: rel,
+        kind: "module",
+        systemId,
+        provenance: [{ source: "code", ref: `${rel}:1`, confidence: exports.STRUCTURAL_CONFIDENCE }],
+        confidence: exports.STRUCTURAL_CONFIDENCE,
+    };
+}
+function tier0(root, sourceFiles) {
+    const pkgPath = (0, node_path_1.join)(root, "package.json");
+    const hasPkg = (0, node_fs_1.existsSync)(pkgPath);
+    let pkg = {};
+    if (hasPkg) {
+        try {
+            pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
+        }
+        catch {
+            /* leave pkg empty on malformed package.json */
+        }
+    }
+    const projectName = pkg.name ?? (0, node_path_1.basename)(root);
+    const model = (0, types_js_1.createEmptyModel)(projectName);
+    const systemId = `sys:${projectName}`;
+    model.systems.push({
+        id: systemId,
+        name: projectName,
+        kind: "internal",
+        description: pkg.description ?? (hasPkg ? "Project root" : "Project root (inferred from folder name)"),
+        provenance: [
+            { source: "repo", ref: hasPkg ? "package.json:1" : ".", confidence: exports.STRUCTURAL_CONFIDENCE },
+        ],
+        confidence: exports.STRUCTURAL_CONFIDENCE,
+    });
+    for (const rel of sourceFiles) {
+        model.components.push(componentFor(rel, systemId));
+    }
+    return model;
+}
+//# sourceMappingURL=tier0.js.map

package/dist/analyze/tier0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier0.js","sourceRoot":"","sources":["../../src/analyze/tier0.ts"],"names":[],"mappings":";;;AAaA,oCASC;AAOD,sBAgCC;AA7DD;;;;GAIG;AACH,qCAAmD;AACnD,yCAA2C;AAC3C,6CAA0F;AAE1F,gEAAgE;AACnD,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAE1C,oFAAoF;AACpF,SAAgB,YAAY,CAAC,GAAW,EAAE,QAAgB;IACxD,OAAO;QACL,EAAE,EAAE,QAAQ,GAAG,EAAE;QACjB,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,EAAE,UAAU,EAAE,6BAAqB,EAAE,CAAC;QACpF,UAAU,EAAE,6BAAqB;KAClC,CAAC;AACJ,CAAC;AAOD,SAAgB,KAAK,CAAC,IAAY,EAAE,WAAqB;IACvD,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAA,oBAAU,EAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,GAAgB,EAAE,CAAC;IAC1B,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAgB,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,IAAI,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAA,2BAAgB,EAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,WAAW,EAAE,CAAC;IAEtC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACjB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,0CAA0C,CAAC;QACtG,UAAU,EAAE;YACV,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,6BAAqB,EAAE;SAC5F;QACD,UAAU,EAAE,6BAAqB;KAClC,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/analyze/tier1.d.ts

@@ -0,0 +1,13 @@
+import { type ArchitectureModel, type Relation, type System } from "../ir/types.js";
+/** Build the System node for an external dependency (bare or `node:` specifier). */
+export declare function buildExternalSystem(name: string, builtin: boolean): System;
+export interface FileEdges {
+    /** Outgoing depends_on relations from this file. */
+    edges: Relation[];
+    /** External systems this file references (deduped within the file). */
+    externals: System[];
+}
+/** Extract one file's outgoing import edges + referenced external systems. */
+export declare function extractFileEdges(root: string, rel: string, fileSet: Set<string>): FileEdges;
+export declare function tier1(root: string, sourceFiles: string[], model: ArchitectureModel): void;
+//# sourceMappingURL=tier1.d.ts.map

package/dist/analyze/tier1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier1.d.ts","sourceRoot":"","sources":["../../src/analyze/tier1.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAmBrG,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAS1E;AAiBD,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,uEAAuE;IACvE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CA4D3F;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAUzF"}

package/dist/analyze/tier1.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExternalSystem = buildExternalSystem;
+exports.extractFileEdges = extractFileEdges;
+exports.tier1 = tier1;
+/**
+ * Tier 1 — deterministic static analysis (TS/JS).
+ *
+ * v1 uses the TypeScript compiler API (we already depend on `typescript`) rather
+ * than tree-sitter: more accurate for TS/JS, zero extra deps. tree-sitter is
+ * introduced when we add other languages (post-MVP).
+ *
+ * Extracts module-level import/re-export edges → `depends_on` relations, each
+ * grounded with `file:line` provenance. Internal imports resolve to Components;
+ * bare/builtin imports become external Systems. The per-file extractor
+ * (`extractFileEdges`) is reused by the incremental updater (M6).
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const typescript_1 = __importDefault(require("typescript"));
+const tier0_js_1 = require("./tier0.js");
+const NODE_BUILTINS = new Set([
+    "fs", "path", "os", "http", "https", "crypto", "events", "stream", "util",
+    "url", "child_process", "net", "tls", "zlib", "buffer", "process", "assert",
+    "readline", "worker_threads", "dns", "module",
+]);
+function scriptKindFor(rel) {
+    if (rel.endsWith(".tsx"))
+        return typescript_1.default.ScriptKind.TSX;
+    if (rel.endsWith(".ts"))
+        return typescript_1.default.ScriptKind.TS;
+    if (rel.endsWith(".jsx"))
+        return typescript_1.default.ScriptKind.JSX;
+    return typescript_1.default.ScriptKind.JS;
+}
+const compId = (rel) => `comp:${rel}`;
+const isBuiltin = (pkg) => NODE_BUILTINS.has(pkg);
+/** Build the System node for an external dependency (bare or `node:` specifier). */
+function buildExternalSystem(name, builtin) {
+    return {
+        id: `sys:ext:${name}`,
+        name,
+        kind: "external",
+        description: builtin ? "Node.js runtime/builtin module" : "External dependency",
+        provenance: [{ source: "code", ref: name, confidence: tier0_js_1.STRUCTURAL_CONFIDENCE }],
+        confidence: tier0_js_1.STRUCTURAL_CONFIDENCE,
+    };
+}
+/** Resolve a relative import specifier to a known source file (component). */
+function resolveInternal(importerRel, spec, fileSet) {
+    const base = (0, node_path_1.join)((0, node_path_1.dirname)(importerRel), spec).split("\\").join("/");
+    // NodeNext/ESM imports carry a `.js`-family extension that maps to the `.ts`
+    // source on disk (`./walk.js` → `walk.ts`); also try the extensionless stem.
+    const stem = base.replace(/\.(js|jsx|mjs|cjs)$/, "");
+    const candidates = [
+        base,
+        `${stem}.ts`, `${stem}.tsx`, `${stem}.js`, `${stem}.jsx`, `${stem}.mjs`, `${stem}.cjs`,
+        `${stem}/index.ts`, `${stem}/index.tsx`, `${stem}/index.js`,
+    ];
+    for (const c of candidates)
+        if (fileSet.has(c))
+            return c;
+    return undefined;
+}
+/** Extract one file's outgoing import edges + referenced external systems. */
+function extractFileEdges(root, rel, fileSet) {
+    const edges = new Map();
+    const externals = new Map();
+    const fromId = compId(rel);
+    let text;
+    try {
+        text = (0, node_fs_1.readFileSync)((0, node_path_1.join)(root, rel), "utf8");
+    }
+    catch {
+        return { edges: [], externals: [] };
+    }
+    const sf = typescript_1.default.createSourceFile(rel, text, typescript_1.default.ScriptTarget.Latest, true, scriptKindFor(rel));
+    const addRelation = (toId, prov) => {
+        const existing = edges.get(toId);
+        if (existing) {
+            existing.provenance.push(prov);
+            return;
+        }
+        edges.set(toId, {
+            id: `rel:${fromId}=>${toId}`,
+            name: `${fromId} → ${toId}`,
+            kind: "depends_on",
+            from: fromId,
+            to: toId,
+            provenance: [prov],
+            confidence: tier0_js_1.STRUCTURAL_CONFIDENCE,
+        });
+    };
+    const ensureExternal = (name, builtin) => {
+        const sys = buildExternalSystem(name, builtin);
+        if (!externals.has(sys.id))
+            externals.set(sys.id, sys);
+        return sys.id;
+    };
+    const handle = (spec, node) => {
+        const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+        const prov = { source: "code", ref: `${rel}:${line}`, confidence: tier0_js_1.STRUCTURAL_CONFIDENCE };
+        if (spec.startsWith(".")) {
+            const target = resolveInternal(rel, spec, fileSet);
+            if (target)
+                addRelation(compId(target), prov);
+            // unresolved relative imports (e.g. ../package.json) are skipped in v1
+        }
+        else if (spec.startsWith("node:")) {
+            addRelation(ensureExternal(spec, true), prov);
+        }
+        else {
+            const pkg = spec.startsWith("@") ? spec.split("/").slice(0, 2).join("/") : spec.split("/")[0];
+            addRelation(ensureExternal(pkg, isBuiltin(pkg)), prov);
+        }
+    };
+    sf.forEachChild((node) => {
+        if (typescript_1.default.isImportDeclaration(node) && typescript_1.default.isStringLiteral(node.moduleSpecifier)) {
+            handle(node.moduleSpecifier.text, node);
+        }
+        else if (typescript_1.default.isExportDeclaration(node) && node.moduleSpecifier && typescript_1.default.isStringLiteral(node.moduleSpecifier)) {
+            handle(node.moduleSpecifier.text, node);
+        }
+    });
+    return { edges: [...edges.values()], externals: [...externals.values()] };
+}
+function tier1(root, sourceFiles, model) {
+    const fileSet = new Set(sourceFiles);
+    const externals = new Map();
+    for (const rel of sourceFiles) {
+        const { edges, externals: exts } = extractFileEdges(root, rel, fileSet);
+        for (const e of edges)
+            model.relations.push(e);
+        for (const s of exts)
+            if (!externals.has(s.id))
+                externals.set(s.id, s);
+    }
+    for (const s of externals.values())
+        model.systems.push(s);
+}
+//# sourceMappingURL=tier1.js.map

package/dist/analyze/tier1.js.map

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

package/dist/analyze/tier2.d.ts

@@ -0,0 +1,14 @@
+import { type ArchitectureModel } from "../ir/types.js";
+export interface Tier2Result {
+    ran: boolean;
+    reason?: string;
+    capabilitiesRefined: number;
+    componentsRefined: number;
+    processRefined: boolean;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    estCostUsd: number;
+}
+export declare function tier2(root: string, model: ArchitectureModel): Promise<Tier2Result>;
+//# sourceMappingURL=tier2.d.ts.map

package/dist/analyze/tier2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier2.d.ts","sourceRoot":"","sources":["../../src/analyze/tier2.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAexD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA+BD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkMxF"}

package/dist/analyze/tier2.js

@@ -0,0 +1,231 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tier2 = tier2;
+/**
+ * Tier 2 — LLM semantic pass (SA-quality prose). Opt-in, BYOK, gated on
+ * ANTHROPIC_API_KEY. See docs/ARCHITECTURE.md §7.
+ *
+ * Model tiering (locked): Haiku 4.5 for high-volume capability/component
+ * summaries; Opus 4.8 for flow/process synthesis.
+ *
+ * Provenance invariant: the LLM only *refines prose and raises confidence* on
+ * elements that the deterministic tiers already grounded with `file:line`. It
+ * never invents new elements, edges, or capabilities — so every element stays
+ * traceable to code. Each refined element gets a provenance entry recording
+ * which model touched it.
+ */
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const auth_js_1 = require("../auth.js");
+const HAIKU = "claude-haiku-4-5";
+const OPUS = "claude-opus-4-8";
+/** Confidence we assign once an element's prose is LLM-refined (high band). */
+const LLM_CONFIDENCE = 0.85;
+/** USD per 1M tokens, [input, output]. Cached 2026-05; for the est-cost report. */
+const PRICING = {
+    [HAIKU]: [1.0, 5.0],
+    [OPUS]: [5.0, 25.0],
+};
+const emptyResult = (reason) => ({
+    ran: false,
+    reason,
+    capabilitiesRefined: 0,
+    componentsRefined: 0,
+    processRefined: false,
+    calls: 0,
+    inputTokens: 0,
+    outputTokens: 0,
+    estCostUsd: 0,
+});
+/** Read one source line (1-based) for the LLM's grounding context. */
+function lineAt(root, ref, cache) {
+    const m = /^(.*):(\d+)$/.exec(ref);
+    if (!m)
+        return "";
+    const [, rel, lineStr] = m;
+    let lines = cache.get(rel);
+    if (!lines) {
+        try {
+            lines = (0, node_fs_1.readFileSync)((0, node_path_1.join)(root, rel), "utf8").split("\n");
+        }
+        catch {
+            lines = [];
+        }
+        cache.set(rel, lines);
+    }
+    return (lines[Number(lineStr) - 1] ?? "").trim();
+}
+async function tier2(root, model) {
+    if (!(0, auth_js_1.hasAnthropicCredentials)()) {
+        return emptyResult(`${auth_js_1.NO_CREDENTIAL_HINT} (Tier-2 LLM pass skipped)`);
+    }
+    // SDK resolves ANTHROPIC_API_KEY, else ANTHROPIC_AUTH_TOKEN (OAuth via ant login).
+    const client = new sdk_1.default();
+    const result = { ...emptyResult(""), ran: true, reason: undefined };
+    const fileCache = new Map();
+    /** One structured-output call; accumulates usage + cost. */
+    async function callJSON(modelId, system, user, schema, adaptiveThinking) {
+        const params = {
+            model: modelId,
+            max_tokens: 8192,
+            system,
+            messages: [{ role: "user", content: user }],
+            output_config: { format: { type: "json_schema", schema } },
+            ...(adaptiveThinking ? { thinking: { type: "adaptive" } } : {}),
+        };
+        const resp = await client.messages.create(params);
+        const block = resp.content.find((b) => b.type === "text");
+        const usage = resp.usage;
+        result.calls++;
+        result.inputTokens += usage.input_tokens;
+        result.outputTokens += usage.output_tokens;
+        const [pin, pout] = PRICING[modelId] ?? [0, 0];
+        result.estCostUsd += (usage.input_tokens * pin + usage.output_tokens * pout) / 1_000_000;
+        return JSON.parse(block?.text ?? "{}");
+    }
+    const llmProv = (modelId) => ({ source: "code", ref: `llm:${modelId}`, confidence: LLM_CONFIDENCE });
+    try {
+        // --- Capabilities (Haiku, batched) ---
+        if (model.capabilities.length) {
+            const items = model.capabilities.map((c) => ({
+                id: c.id,
+                name: c.name,
+                code: lineAt(root, c.provenance[0]?.ref ?? "", fileCache),
+            }));
+            const schema = {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    items: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            additionalProperties: false,
+                            properties: { id: { type: "string" }, description: { type: "string" } },
+                            required: ["id", "description"],
+                        },
+                    },
+                },
+                required: ["items"],
+            };
+            const out = await callJSON(HAIKU, "You describe software capabilities in plain English for a non-engineer audience (PMs, architects). One sentence each, present tense, no code identifiers or file names. Describe what the system can DO, not how it's implemented.", "Write a capability description for each item (the `code` is the exported declaration):\n" +
+                JSON.stringify(items), schema, false);
+            const byId = new Map(out.items.map((i) => [i.id, i.description]));
+            for (const cap of model.capabilities) {
+                const desc = byId.get(cap.id);
+                if (!desc)
+                    continue;
+                cap.description = desc;
+                cap.confidence = Math.max(cap.confidence, LLM_CONFIDENCE);
+                cap.provenance.push(llmProv(HAIKU));
+                result.capabilitiesRefined++;
+            }
+        }
+        // --- Component responsibilities (Haiku, batched) ---
+        if (model.components.length) {
+            const targetName = (id) => {
+                if (id.startsWith("comp:"))
+                    return id.slice("comp:".length).split("/").pop() ?? id;
+                if (id.startsWith("sys:ext:"))
+                    return id.slice("sys:ext:".length);
+                return id;
+            };
+            const items = model.components.map((c) => ({
+                id: c.id,
+                file: c.id.slice("comp:".length),
+                dependsOn: model.relations.filter((r) => r.from === c.id).map((r) => targetName(r.to)),
+            }));
+            const schema = {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    items: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            additionalProperties: false,
+                            properties: { id: { type: "string" }, responsibility: { type: "string" } },
+                            required: ["id", "responsibility"],
+                        },
+                    },
+                },
+                required: ["items"],
+            };
+            const out = await callJSON(HAIKU, "You write one-line responsibility statements for code modules, in the style of a senior architect's component catalog. Infer the role from the file path and its dependencies. One concise clause, no trailing period needed.", "State each module's single responsibility:\n" + JSON.stringify(items), schema, false);
+            const byId = new Map(out.items.map((i) => [i.id, i.responsibility]));
+            for (const comp of model.components) {
+                const resp = byId.get(comp.id);
+                if (!resp)
+                    continue;
+                comp.responsibility = resp;
+                comp.description = resp;
+                comp.confidence = Math.max(comp.confidence, LLM_CONFIDENCE);
+                comp.provenance.push(llmProv(HAIKU));
+                result.componentsRefined++;
+            }
+        }
+        // --- Process + flow synthesis (Opus 4.8) ---
+        const process = model.processes[0];
+        if (process && process.tasks.length) {
+            const respById = new Map(model.components.map((c) => [c.id, c.responsibility ?? ""]));
+            const steps = process.tasks.map((t) => {
+                const compId = t.id.replace(/^task:/, "");
+                return { id: t.id, module: t.name, responsibility: respById.get(compId) ?? "" };
+            });
+            const schema = {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    name: { type: "string" },
+                    description: { type: "string" },
+                    tasks: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            additionalProperties: false,
+                            properties: { id: { type: "string" }, name: { type: "string" } },
+                            required: ["id", "name"],
+                        },
+                    },
+                },
+                required: ["name", "description", "tasks"],
+            };
+            const out = await callJSON(OPUS, "You are a senior solution architect. Given the ordered modules a process orchestrates (with each module's responsibility), name the business process and rewrite each step as a concise business-meaningful action (verb phrase). Preserve the given order and the task ids exactly. Output strict JSON matching the schema.", "Synthesize the process from these ordered steps:\n" +
+                JSON.stringify({ currentName: process.name, steps }), schema, true);
+            process.name = out.name || process.name;
+            process.description = out.description || process.description;
+            process.confidence = Math.max(process.confidence, LLM_CONFIDENCE);
+            process.provenance.push(llmProv(OPUS));
+            const taskNameById = new Map(out.tasks.map((t) => [t.id, t.name]));
+            for (const task of process.tasks) {
+                const nm = taskNameById.get(task.id);
+                if (nm) {
+                    task.name = nm;
+                    task.provenance.push(llmProv(OPUS));
+                }
+            }
+            // Mirror onto the matching flow's name/description if present.
+            const flow = model.flows[0];
+            if (flow) {
+                flow.name = out.name ? `${out.name} sequence` : flow.name;
+                flow.confidence = Math.max(flow.confidence, LLM_CONFIDENCE);
+                flow.provenance.push(llmProv(OPUS));
+            }
+            result.processRefined = true;
+        }
+    }
+    catch (err) {
+        if (err instanceof sdk_1.default.AuthenticationError) {
+            return emptyResult(`Anthropic authentication failed — ${auth_js_1.NO_CREDENTIAL_HINT}`);
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        // Surface partial progress: keep ran=true, attach the error reason.
+        result.reason = `Tier-2 stopped early: ${msg}`;
+    }
+    return result;
+}
+//# sourceMappingURL=tier2.js.map

package/dist/analyze/tier2.js.map

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

package/dist/analyze/walk.d.ts

@@ -0,0 +1,3 @@
+/** Returns repo-relative, forward-slashed source file paths, sorted. */
+export declare function walkSourceFiles(root: string): string[];
+//# sourceMappingURL=walk.d.ts.map

package/dist/analyze/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/analyze/walk.ts"],"names":[],"mappings":"AAiBA,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA2BtD"}

package/dist/analyze/walk.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkSourceFiles = walkSourceFiles;
+/** Tier 0 helper: walk the repo and return relative paths of source files. */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const IGNORE_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    ".archmantic",
+    "coverage",
+    ".next",
+    "build",
+    ".vercel",
+]);
+const SOURCE_RE = /\.(ts|tsx|js|jsx|mjs|cjs)$/;
+/** Returns repo-relative, forward-slashed source file paths, sorted. */
+function walkSourceFiles(root) {
+    const out = [];
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = (0, node_fs_1.readdirSync)(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = (0, node_path_1.join)(dir, e.name);
+            if (e.isDirectory()) {
+                if (IGNORE_DIRS.has(e.name) || e.name.startsWith("."))
+                    continue;
+                // A nested package (its own package.json) is a separate model — skip it,
+                // so analysis stays scoped to the package rooted at `root` (e.g. don't
+                // pull a sibling Next.js app in `web/` into the CLI's self-model).
+                if ((0, node_fs_1.existsSync)((0, node_path_1.join)(full, "package.json")))
+                    continue;
+                stack.push(full);
+            }
+            else if (e.isFile() && SOURCE_RE.test(e.name) && !e.name.endsWith(".d.ts")) {
+                out.push((0, node_path_1.relative)(root, full).split("\\").join("/"));
+            }
+        }
+    }
+    return out.sort();
+}
+//# sourceMappingURL=walk.js.map

package/dist/analyze/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/analyze/walk.ts"],"names":[],"mappings":";;AAkBA,0CA2BC;AA7CD,8EAA8E;AAC9E,qCAAkD;AAClD,yCAA2C;AAE3C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,cAAc;IACd,MAAM;IACN,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACP,OAAO;IACP,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,wEAAwE;AACxE,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAa,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QACzB,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,qBAAW,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAChE,yEAAyE;gBACzE,uEAAuE;gBACvE,mEAAmE;gBACnE,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;oBAAE,SAAS;gBACrD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7E,GAAG,CAAC,IAAI,CAAC,IAAA,oBAAQ,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Best-effort: if no key/token is in the env, try to hydrate one from an
+ * `ant auth login` session. No-op if `ant` isn't installed or isn't logged in.
+ * Never overrides an existing credential (and never sets both key + token,
+ * which the API rejects).
+ */
+export declare function ensureAnthropicAuth(): void;
+/** Whether any Anthropic credential is available (after attempting CLI login). */
+export declare function hasAnthropicCredentials(): boolean;
+/** Shared, user-facing message for when no credential is found. */
+export declare const NO_CREDENTIAL_HINT = "no Anthropic credential \u2014 set ANTHROPIC_API_KEY in .env.local, or run `ant auth login` (CLI OAuth).";
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAuB1C;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD;AAED,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,6GACwE,CAAC"}

package/dist/auth.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NO_CREDENTIAL_HINT = void 0;
+exports.ensureAnthropicAuth = ensureAnthropicAuth;
+exports.hasAnthropicCredentials = hasAnthropicCredentials;
+/**
+ * Anthropic credential resolution (BYOK). Two ways to authenticate the Tier-2
+ * LLM pass and `bench --exact`:
+ *   1. An API key / auth token in the environment or .env.local
+ *      (ANTHROPIC_API_KEY, or ANTHROPIC_AUTH_TOKEN for OAuth).
+ *   2. `ant auth login` — the Anthropic CLI stores an OAuth profile; we pull a
+ *      short-lived token from it via `ant auth print-credentials --env`.
+ *
+ * The SDK already resolves these on its own in most cases; this just makes the
+ * CLI-login path explicit and lets us gate gracefully (skip with a clear note)
+ * when no credential is available — without ever making a failed API call.
+ */
+const node_child_process_1 = require("node:child_process");
+/**
+ * Best-effort: if no key/token is in the env, try to hydrate one from an
+ * `ant auth login` session. No-op if `ant` isn't installed or isn't logged in.
+ * Never overrides an existing credential (and never sets both key + token,
+ * which the API rejects).
+ */
+function ensureAnthropicAuth() {
+    if (process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN)
+        return;
+    let out;
+    try {
+        out = (0, node_child_process_1.execFileSync)("ant", ["auth", "print-credentials", "--env"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+    }
+    catch {
+        return; // ant not installed, or not logged in
+    }
+    for (const raw of out.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 (!process.env[key])
+            process.env[key] = val;
+    }
+}
+/** Whether any Anthropic credential is available (after attempting CLI login). */
+function hasAnthropicCredentials() {
+    ensureAnthropicAuth();
+    return Boolean(process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN);
+}
+/** Shared, user-facing message for when no credential is found. */
+exports.NO_CREDENTIAL_HINT = "no Anthropic credential — set ANTHROPIC_API_KEY in .env.local, or run `ant auth login` (CLI OAuth).";
+//# sourceMappingURL=auth.js.map