@esbenwiberg/archmap 0.1.0

package/dist/src/classify.js

@@ -0,0 +1,60 @@
+import { matchOverride } from "./config.js";
+export function classifyFile(file, topology, config, riskScores) {
+    const riskScore = riskScores?.get(file) ?? null;
+    const override = matchOverride(file, config.overrides);
+    if (override) {
+        const node = topology.files[file];
+        const ca = node?.ca ?? 0;
+        const tca = node?.tca ?? 0;
+        const ce = node?.ce ?? 0;
+        const total = ca + ce;
+        return {
+            file,
+            class: override.classification,
+            ca,
+            tca,
+            instability: total === 0 ? 0 : ce / total,
+            risk: riskScore,
+            reason: override.reason,
+            overridden: true,
+        };
+    }
+    const node = topology.files[file];
+    if (!node) {
+        process.stderr.write(`warning: "${file}" not found in dependency graph — treating as leaf\n`);
+        return {
+            file,
+            class: "leaf",
+            ca: 0,
+            tca: 0,
+            instability: 0,
+            risk: riskScore,
+            reason: "not in dependency graph",
+            overridden: false,
+        };
+    }
+    const { ca, tca, ce } = node;
+    const total = ca + ce;
+    const instability = total === 0 ? 0 : ce / total;
+    let klass;
+    if (ca <= config.thresholds.leaf) {
+        klass = "leaf";
+    }
+    else if (ca <= config.thresholds.junction) {
+        klass = "branch";
+    }
+    else {
+        klass = "hub";
+    }
+    return {
+        file,
+        class: klass,
+        ca,
+        tca,
+        instability,
+        risk: riskScore,
+        reason: `Ca=${ca} (${ca} direct, ${tca} transitive)`,
+        overridden: false,
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/src/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/classify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAiB5C,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,QAAkB,EAClB,MAAqB,EACrB,UAAmC;IAEnC,MAAM,SAAS,GAAG,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAEvD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACtB,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,QAAQ,CAAC,cAAc;YAC9B,EAAE;YACF,GAAG;YACH,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK;YACzC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,aAAa,IAAI,sDAAsD,CACxE,CAAC;QACF,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,MAAM;YACb,EAAE,EAAE,CAAC;YACL,GAAG,EAAE,CAAC;YACN,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,yBAAyB;YACjC,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC;IAEjD,IAAI,KAAY,CAAC;IACjB,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACjC,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;SAAM,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC5C,KAAK,GAAG,QAAQ,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK;QACZ,EAAE;QACF,GAAG;QACH,WAAW;QACX,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc;QACpD,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC"}

package/dist/src/commands/check.d.ts

@@ -0,0 +1,5 @@
+export declare function checkCommand(files: string[], opts: {
+    json?: boolean;
+    config?: string;
+}): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/src/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/check.ts"],"names":[],"mappings":"AAQA,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/src/commands/check.js

@@ -0,0 +1,33 @@
+import { resolveProject } from "../config.js";
+import { classifyFile } from "../classify.js";
+import { getFreshTopology, getFreshChurn } from "../cache.js";
+import { buildTopology } from "../graph.js";
+import { buildChurnMap } from "../churn.js";
+import { computeRiskScores } from "../risk.js";
+export async function checkCommand(files, opts) {
+    const { config, entry } = resolveProject(opts.config);
+    const { topology } = await getFreshTopology(entry, buildTopology);
+    const { churn: churnMap } = getFreshChurn(90, buildChurnMap);
+    const riskScores = computeRiskScores(topology, churnMap);
+    const results = files.map((f) => classifyFile(f, topology, config, riskScores));
+    const hubs = results.filter((r) => r.class === "hub");
+    const hasHubs = hubs.length > 0;
+    if (opts.json) {
+        console.log(JSON.stringify({ hasHubs, hubs, all: results }, null, 2));
+    }
+    else {
+        if (hasHubs) {
+            console.log(`load-bearing (hub) files detected:`);
+            for (const h of hubs) {
+                const riskLabel = h.risk ? `  risk=${h.risk.risk}/100` : "";
+                console.log(`  ${h.file}  Ca=${h.ca} (${h.tca} transitive)${riskLabel}`);
+            }
+        }
+        else {
+            console.log("No hub files in changeset.");
+        }
+    }
+    if (hasHubs)
+        process.exit(1);
+}
+//# sourceMappingURL=check.js.map

package/dist/src/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAe,EACf,IAAyC;IAEzC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAqB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChD,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAC9C,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAEhC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,eAAe,SAAS,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/commands/classify.d.ts

@@ -0,0 +1,5 @@
+export declare function classifyCommand(file: string, opts: {
+    json?: boolean;
+    config?: string;
+}): Promise<void>;
+//# sourceMappingURL=classify.d.ts.map

package/dist/src/commands/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/commands/classify.ts"],"names":[],"mappings":"AAQA,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/src/commands/classify.js

@@ -0,0 +1,31 @@
+import { resolveProject } from "../config.js";
+import { classifyFile } from "../classify.js";
+import { getFreshTopology, getFreshChurn } from "../cache.js";
+import { buildTopology } from "../graph.js";
+import { buildChurnMap } from "../churn.js";
+import { computeRiskScores } from "../risk.js";
+export async function classifyCommand(file, opts) {
+    const { config, entry } = resolveProject(opts.config);
+    const { topology, cacheHit } = await getFreshTopology(entry, buildTopology);
+    if (!opts.json) {
+        process.stderr.write(cacheHit ? "(cache hit)\n" : "(topology rebuilt)\n");
+    }
+    const { churn: churnMap } = getFreshChurn(90, buildChurnMap);
+    const riskScores = computeRiskScores(topology, churnMap);
+    const result = classifyFile(file, topology, config, riskScores);
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        const instPct = (result.instability * 100).toFixed(0);
+        console.log(`${result.file}`);
+        console.log(`  class:       ${result.class}${result.overridden ? " (overridden)" : ""}`);
+        console.log(`  ca:          ${result.ca} direct, ${result.tca} transitive`);
+        console.log(`  instability: ${instPct}%`);
+        if (result.risk) {
+            console.log(`  risk:        ${result.risk.risk}/100  (structural=${result.risk.structural}, churn=${result.risk.commits} commits/90d)`);
+        }
+        console.log(`  reason:      ${result.reason}`);
+    }
+}
+//# sourceMappingURL=classify.js.map

package/dist/src/commands/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/commands/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAyC;IAEzC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAE5E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAmB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAEhF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,EAAE,YAAY,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,GAAG,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,IAAI,qBAAqB,MAAM,CAAC,IAAI,CAAC,UAAU,WAAW,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;QAC1I,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/src/commands/explain.d.ts

@@ -0,0 +1,5 @@
+export declare function explainCommand(file: string, opts: {
+    json?: boolean;
+    config?: string;
+}): Promise<void>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/src/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/commands/explain.ts"],"names":[],"mappings":"AAKA,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/src/commands/explain.js

@@ -0,0 +1,34 @@
+import { resolveProject } from "../config.js";
+import { classifyFile } from "../classify.js";
+import { getFreshTopology } from "../cache.js";
+import { buildTopology } from "../graph.js";
+export async function explainCommand(file, opts) {
+    const { config, entry } = resolveProject(opts.config);
+    const { topology } = await getFreshTopology(entry, buildTopology);
+    const node = topology.files[file];
+    const classification = classifyFile(file, topology, config);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            file,
+            classification,
+            dependents: node?.dependents ?? [],
+        }, null, 2));
+    }
+    else {
+        console.log(`${file}`);
+        console.log(`  class:     ${classification.class}${classification.overridden ? " (overridden)" : ""}`);
+        console.log(`  reason:    ${classification.reason}`);
+        console.log(`  ca:        ${classification.ca} (${classification.ca} file${classification.ca === 1 ? "" : "s"} depend on this)`);
+        const deps = node?.dependents ?? [];
+        if (deps.length === 0) {
+            console.log("  dependents: none");
+        }
+        else {
+            console.log("  dependents:");
+            for (const d of deps) {
+                console.log(`    ${d}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=explain.js.map

package/dist/src/commands/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/commands/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAyC;IAEzC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE5D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,IAAI;YACJ,cAAc;YACd,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE;SACnC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,cAAc,CAAC,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvG,OAAO,CAAC,GAAG,CAAC,gBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,gBAAgB,cAAc,CAAC,EAAE,KAAK,cAAc,CAAC,EAAE,QAAQ,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC;QACjI,MAAM,IAAI,GAAG,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/commands/export.d.ts

@@ -0,0 +1,48 @@
+import type { ArchmapConfig } from "../config.js";
+import type { Topology } from "../graph.js";
+import type { RiskScore } from "../risk.js";
+import type { Klass } from "../classify.js";
+/** One file's fully-resolved verdict — everything an external consumer needs. */
+export interface ExportedFile {
+    class: Klass;
+    ca: number;
+    tca: number;
+    instability: number;
+    risk: number | null;
+    overridden: boolean;
+    reason: string;
+    dependents: string[];
+}
+/**
+ * Self-contained artifact for consumers that have no source tree (e.g. a
+ * hosted diff-only review bot). Keyed by `commit` so a consumer can verify it
+ * matches the PR head SHA before trusting the lookups.
+ *
+ * When built with a `scope` (the PR's changed paths), `files` is narrowed to
+ * just those paths — each still carrying its full `dependents` blast radius —
+ * and the `scope` block records which requested paths were not in the graph,
+ * so a missed lookup is loud rather than silent.
+ */
+export interface ExportArtifact {
+    version: 1;
+    commit: string | null;
+    generatedAt: string;
+    scope?: {
+        requested: string[];
+        missing: string[];
+    };
+    files: Record<string, ExportedFile>;
+}
+/**
+ * Pure transform: topology + config + risk → a fully-classified artifact.
+ * No git, no graph build, no I/O — so it is trivially unit-testable.
+ *
+ * If `scope` is given, the graph is still built whole-repo (the caller does
+ * that), but the emitted `files` map is narrowed to the in-scope paths.
+ */
+export declare function buildExportArtifact(topology: Topology, config: ArchmapConfig, riskScores: Map<string, RiskScore>, commit: string | null, scope?: string[], now?: Date): ExportArtifact;
+export declare function exportCommand(opts: {
+    config?: string;
+    scope?: string;
+}): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/src/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/export.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC;AAOD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAClC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,GAAG,GAAE,IAAiB,GACrB,cAAc,CAmChB;AAsBD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5F"}

package/dist/src/commands/export.js

@@ -0,0 +1,82 @@
+import { execSync } from "child_process";
+import { readFileSync } from "fs";
+import { resolveProject } from "../config.js";
+import { classifyFile } from "../classify.js";
+import { getFreshTopology, getFreshChurn } from "../cache.js";
+import { buildTopology } from "../graph.js";
+import { buildChurnMap } from "../churn.js";
+import { computeRiskScores } from "../risk.js";
+/** Normalize an incoming path to the form dependency-cruiser uses as keys. */
+function normalizePath(p) {
+    return p.trim().replace(/^\.\//, "");
+}
+/**
+ * Pure transform: topology + config + risk → a fully-classified artifact.
+ * No git, no graph build, no I/O — so it is trivially unit-testable.
+ *
+ * If `scope` is given, the graph is still built whole-repo (the caller does
+ * that), but the emitted `files` map is narrowed to the in-scope paths.
+ */
+export function buildExportArtifact(topology, config, riskScores, commit, scope, now = new Date()) {
+    const keys = scope === undefined
+        ? Object.keys(topology.files)
+        : scope.map(normalizePath).filter((p) => p in topology.files);
+    const files = {};
+    for (const file of keys) {
+        const c = classifyFile(file, topology, config, riskScores);
+        files[file] = {
+            class: c.class,
+            ca: c.ca,
+            tca: c.tca,
+            instability: c.instability,
+            risk: c.risk?.risk ?? null,
+            overridden: c.overridden,
+            reason: c.reason,
+            dependents: topology.files[file].dependents,
+        };
+    }
+    const artifact = {
+        version: 1,
+        commit,
+        generatedAt: now.toISOString(),
+        files,
+    };
+    if (scope !== undefined) {
+        const requested = scope.map(normalizePath).filter((p) => p.length > 0);
+        artifact.scope = {
+            requested,
+            missing: requested.filter((p) => !(p in topology.files)),
+        };
+    }
+    return artifact;
+}
+function currentCommit() {
+    try {
+        return execSync("git rev-parse HEAD", {
+            encoding: "utf8",
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Read a newline-delimited path list from a file, or from stdin when "-". */
+function readScope(source) {
+    const raw = readFileSync(source === "-" ? 0 : source, "utf8");
+    return raw
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+}
+export async function exportCommand(opts) {
+    const { config, entry } = resolveProject(opts.config);
+    const { topology } = await getFreshTopology(entry, buildTopology);
+    const { churn: churnMap } = getFreshChurn(90, buildChurnMap);
+    const riskScores = computeRiskScores(topology, churnMap);
+    const scope = opts.scope !== undefined ? readScope(opts.scope) : undefined;
+    const artifact = buildExportArtifact(topology, config, riskScores, currentCommit(), scope);
+    // export is inherently machine-readable: always emit JSON on stdout.
+    console.log(JSON.stringify(artifact, null, 2));
+}
+//# sourceMappingURL=export.js.map

package/dist/src/commands/export.js.map

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

package/dist/src/commands/risk.d.ts

@@ -0,0 +1,6 @@
+export declare function riskCommand(opts: {
+    top?: string;
+    json?: boolean;
+    config?: string;
+}): Promise<void>;
+//# sourceMappingURL=risk.d.ts.map

package/dist/src/commands/risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../../../src/commands/risk.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/src/commands/risk.js

@@ -0,0 +1,27 @@
+import { resolveProject } from "../config.js";
+import { getFreshTopology, getFreshChurn } from "../cache.js";
+import { buildTopology } from "../graph.js";
+import { buildChurnMap } from "../churn.js";
+import { computeRiskScores } from "../risk.js";
+export async function riskCommand(opts) {
+    const { entry } = resolveProject(opts.config);
+    const { topology } = await getFreshTopology(entry, buildTopology);
+    const { churn: churnMap } = getFreshChurn(90, buildChurnMap);
+    const riskScores = computeRiskScores(topology, churnMap);
+    const n = opts.top ? parseInt(opts.top, 10) : 10;
+    const sorted = [...riskScores.entries()]
+        .sort((a, b) => b[1].risk - a[1].risk)
+        .slice(0, n);
+    if (opts.json) {
+        console.log(JSON.stringify(sorted.map(([file, score]) => ({ file, ...score })), null, 2));
+    }
+    else {
+        console.log(`Top ${sorted.length} riskiest files:\n`);
+        for (const [file, score] of sorted) {
+            const node = topology.files[file];
+            console.log(`  ${score.risk.toString().padStart(3)}/100  ${file}`);
+            console.log(`         ca=${node?.ca ?? 0}  tca=${score.tca}  churn=${score.commits}c/90d  structural=${score.structural}`);
+        }
+    }
+}
+//# sourceMappingURL=risk.js.map

package/dist/src/commands/risk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.js","sourceRoot":"","sources":["../../../src/commands/risk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAuD;IAEvD,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEzD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;SACrC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEf,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,EACnD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,oBAAoB,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CACtD,CAAC;YACF,OAAO,CAAC,GAAG,CACT,eAAe,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,WAAW,KAAK,CAAC,OAAO,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/commands/scan.d.ts

@@ -0,0 +1,4 @@
+export declare function scanCommand(entry: string, opts: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/src/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/scan.ts"],"names":[],"mappings":"AAOA,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/src/commands/scan.js

@@ -0,0 +1,37 @@
+import { writeFileSync, mkdirSync } from "fs";
+import { buildTopology } from "../graph.js";
+import { writeCache } from "../cache.js";
+import { createHash } from "crypto";
+import { readFileSync } from "fs";
+import { listTypeScriptFiles } from "../files.js";
+export async function scanCommand(entry, opts) {
+    const topology = await buildTopology(entry);
+    mkdirSync(".archmap", { recursive: true });
+    writeFileSync(".archmap/topology.json", JSON.stringify(topology, null, 2));
+    // update cache
+    const hash = computeHash(entry);
+    writeCache(hash, topology);
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, files: Object.keys(topology.files).length }));
+    }
+    else {
+        console.log(`Scanned ${Object.keys(topology.files).length} files → .archmap/topology.json`);
+    }
+}
+function computeHash(entry) {
+    const files = listTypeScriptFiles(entry);
+    const hasher = createHash("sha256");
+    for (const file of files) {
+        hasher.update(file + "\n");
+        try {
+            const src = readFileSync(file, "utf8");
+            const imports = src.match(/^(import|export).*from\s+['"].*['"]/gm) ?? [];
+            hasher.update(imports.join("\n") + "\n");
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return hasher.digest("hex");
+}
+//# sourceMappingURL=scan.js.map

package/dist/src/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,IAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAE5C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE3E,eAAe;IACf,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,iCAAiC,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,IAAI,EAAE,CAAC;YACzE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,43 @@
+import type { Klass } from "./classify.js";
+export interface Override {
+    path: string;
+    classification: Klass;
+    reason: string;
+}
+export interface ArchmapConfig {
+    version: number;
+    thresholds: {
+        leaf: number;
+        junction: number;
+    };
+    overrides: Override[];
+    analyzers: Array<{
+        lang: string;
+        entry: string;
+    }>;
+}
+export declare function loadConfig(configPath?: string): ArchmapConfig;
+/**
+ * Walk up from `startDir` to the filesystem root looking for `.archmap.yaml`.
+ * Returns the absolute path to the nearest config, or null if none is found.
+ */
+export declare function findConfigPath(startDir?: string): string | null;
+export interface ResolvedProject {
+    config: ArchmapConfig;
+    entry: string;
+    root: string;
+    configPath: string | null;
+}
+/**
+ * Resolve the project context for a command.
+ *
+ * - With an explicit `--config` path: legacy behaviour — the config is loaded
+ *   as given and `entry` paths resolve relative to the current working dir.
+ * - Without one: walk up from cwd to discover the nearest `.archmap.yaml`,
+ *   chdir into its directory (the project root), and resolve `entry` paths
+ *   relative to that directory. This lets `archmap` be run from any
+ *   subdirectory of a project and still analyse the whole tree.
+ */
+export declare function resolveProject(explicitConfig?: string): ResolvedProject;
+export declare function matchOverride(file: string, overrides: Override[]): Override | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,KAAK,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AASD,wBAAgB,UAAU,CAAC,UAAU,SAAkB,GAAG,aAAa,CA2BtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAS9E;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe,CAkBvE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,EAAE,GACpB,QAAQ,GAAG,SAAS,CAOtB"}

package/dist/src/config.js

@@ -0,0 +1,87 @@
+import { readFileSync, existsSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { parse } from "yaml";
+import micromatch from "micromatch";
+const DEFAULTS = {
+    version: 1,
+    thresholds: { leaf: 2, junction: 10 },
+    overrides: [],
+    analyzers: [{ lang: "typescript", entry: "src/" }],
+};
+export function loadConfig(configPath = ".archmap.yaml") {
+    let raw = {};
+    try {
+        raw = parse(readFileSync(configPath, "utf8")) ?? {};
+    }
+    catch {
+        // no config file — use defaults
+    }
+    const config = {
+        version: raw.version ?? DEFAULTS.version,
+        thresholds: {
+            leaf: raw.thresholds?.leaf ?? DEFAULTS.thresholds.leaf,
+            junction: raw.thresholds?.junction ?? DEFAULTS.thresholds.junction,
+        },
+        overrides: raw.overrides ?? [],
+        analyzers: raw.analyzers ?? DEFAULTS.analyzers,
+    };
+    for (const ov of config.overrides) {
+        if (!["leaf", "branch", "hub"].includes(ov.classification)) {
+            throw new Error(`Invalid classification "${ov.classification}" in overrides for path "${ov.path}"`);
+        }
+    }
+    return config;
+}
+/**
+ * Walk up from `startDir` to the filesystem root looking for `.archmap.yaml`.
+ * Returns the absolute path to the nearest config, or null if none is found.
+ */
+export function findConfigPath(startDir = process.cwd()) {
+    let dir = resolve(startDir);
+    while (true) {
+        const candidate = join(dir, ".archmap.yaml");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null; // reached filesystem root
+        dir = parent;
+    }
+}
+/**
+ * Resolve the project context for a command.
+ *
+ * - With an explicit `--config` path: legacy behaviour — the config is loaded
+ *   as given and `entry` paths resolve relative to the current working dir.
+ * - Without one: walk up from cwd to discover the nearest `.archmap.yaml`,
+ *   chdir into its directory (the project root), and resolve `entry` paths
+ *   relative to that directory. This lets `archmap` be run from any
+ *   subdirectory of a project and still analyse the whole tree.
+ */
+export function resolveProject(explicitConfig) {
+    let configPath = null;
+    let root = process.cwd();
+    if (explicitConfig) {
+        configPath = explicitConfig;
+    }
+    else {
+        configPath = findConfigPath();
+        if (configPath) {
+            root = dirname(resolve(configPath));
+            if (root !== process.cwd())
+                process.chdir(root);
+        }
+    }
+    const config = loadConfig(configPath ?? undefined);
+    const entry = config.analyzers.find((a) => a.lang === "typescript")?.entry ?? "src/";
+    return { config, entry, root, configPath };
+}
+export function matchOverride(file, overrides) {
+    for (const ov of overrides) {
+        if (micromatch.isMatch(file, ov.path, { dot: true })) {
+            return ov;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/files.d.ts

@@ -0,0 +1,2 @@
+export declare function listTypeScriptFiles(entry: string): string[];
+//# sourceMappingURL=files.d.ts.map

package/dist/src/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/files.ts"],"names":[],"mappings":"AAOA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B3D"}

package/dist/src/files.js

@@ -0,0 +1,31 @@
+import { readdirSync, statSync } from "fs";
+import { join } from "path";
+const TS_FILE = /\.(ts|tsx)$/;
+const TEST_FILE = /\.(test|spec)\.(ts|tsx)$/;
+const SKIP_DIRS = new Set(["node_modules", "dist", ".archmap"]);
+export function listTypeScriptFiles(entry) {
+    const files = [];
+    function walk(path) {
+        let stat;
+        try {
+            stat = statSync(path);
+        }
+        catch {
+            return;
+        }
+        if (stat.isDirectory()) {
+            for (const child of readdirSync(path)) {
+                if (!SKIP_DIRS.has(child)) {
+                    walk(join(path, child));
+                }
+            }
+            return;
+        }
+        if (stat.isFile() && TS_FILE.test(path) && !TEST_FILE.test(path)) {
+            files.push(path);
+        }
+    }
+    walk(entry);
+    return files.sort();
+}
+//# sourceMappingURL=files.js.map