@bugsbunnycodes1998/cartographer-core 0.1.0

package/dist/__tests__/pipeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.test.d.ts.map

package/dist/__tests__/pipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/pipeline.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/pipeline.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { resolve, join } from "node:path";
+import { existsSync, rmSync } from "node:fs";
+import { analyze } from "../pipeline.js";
+const FIXTURE_DIR = resolve(import.meta.dirname, "..", "..", "..", "..", "test", "fixtures", "tiny-ts");
+const OUTPUT_DIR = join(FIXTURE_DIR, ".cartographer-test");
+afterEach(() => {
+    if (existsSync(OUTPUT_DIR)) {
+        rmSync(OUTPUT_DIR, { recursive: true, force: true });
+    }
+});
+describe("analyze pipeline", () => {
+    it("analyzes the tiny-ts fixture and produces a valid graph", async () => {
+        const graph = await analyze({
+            rootDir: FIXTURE_DIR,
+            outputDir: OUTPUT_DIR,
+        });
+        // Check meta
+        expect(graph.meta.languages).toContain("typescript");
+        expect(graph.meta.totalFiles).toBeGreaterThan(0);
+        expect(graph.meta.totalModules).toBeGreaterThan(0);
+        // Check nodes exist
+        const modules = graph.nodes.filter((n) => n.kind === "module");
+        const files = graph.nodes.filter((n) => n.kind === "file");
+        expect(modules.length).toBeGreaterThanOrEqual(2); // at least auth, utils
+        expect(files.length).toBeGreaterThanOrEqual(5);
+        // Check module names
+        const moduleNames = modules.map((m) => m.name);
+        expect(moduleNames).toContain("auth");
+        expect(moduleNames).toContain("utils");
+        // Check files have LOC > 0
+        for (const file of files) {
+            expect(file.loc).toBeGreaterThan(0);
+        }
+        // Check file-to-module relationships
+        for (const file of files) {
+            expect(file.parentId).toBeTruthy();
+            expect(modules.some((m) => m.id === file.parentId)).toBe(true);
+        }
+        // auth -> utils dependency (login.ts imports hash.ts)
+        expect(graph.edges.length).toBeGreaterThan(0);
+        const authToUtils = graph.edges.find((e) => e.sourceId === "mod:auth" && e.targetId === "mod:utils");
+        expect(authToUtils).toBeDefined();
+        // Check layout: modules have non-zero positions
+        const modulesWithPositions = modules.filter((n) => n.position.x !== 0 || n.position.z !== 0);
+        expect(modulesWithPositions.length).toBeGreaterThan(0);
+        // Check file buildings have dimensions
+        for (const file of files) {
+            expect(file.dimensions.width).toBeGreaterThan(0);
+            expect(file.dimensions.height).toBeGreaterThan(0);
+            expect(file.dimensions.depth).toBeGreaterThan(0);
+        }
+        // Check output files were created
+        expect(existsSync(join(OUTPUT_DIR, "cartographer.db"))).toBe(true);
+        expect(existsSync(join(OUTPUT_DIR, "graph.json"))).toBe(true);
+    }, 30000);
+});
+//# sourceMappingURL=pipeline.test.js.map

package/dist/__tests__/pipeline.test.js.map

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

package/dist/analysis/call-graph.d.ts

@@ -0,0 +1,13 @@
+import type { GraphNode, GraphEdge, FileAnalysis, ModuleInfo } from "../types/index.js";
+export interface CallGraphResult {
+    functionNodes: GraphNode[];
+    callEdges: GraphEdge[];
+}
+/**
+ * Build function-level nodes and call edges from file analyses.
+ *
+ * Creates a `GraphNode` for each function declaration and a `GraphEdge`
+ * for each resolved function-to-function call (same-file and cross-file).
+ */
+export declare function buildCallGraph(analyses: FileAnalysis[], modules: ModuleInfo[], rootDir: string): CallGraphResult;
+//# sourceMappingURL=call-graph.d.ts.map

package/dist/analysis/call-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph.d.ts","sourceRoot":"","sources":["../../src/analysis/call-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOxF,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AA2BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,eAAe,CA+GjB"}

package/dist/analysis/call-graph.js

@@ -0,0 +1,133 @@
+import { relative } from "node:path";
+import { logger } from "../logger.js";
+function normalizePath(p) {
+    return p.replace(/\\/g, "/");
+}
+function makeDefaultNode(id, kind, name) {
+    return {
+        id,
+        kind,
+        name,
+        path: null,
+        parentId: null,
+        loc: 0,
+        complexity: 0,
+        healthScore: 50,
+        createdAt: null,
+        lastModified: null,
+        totalCommits: 0,
+        busFactor: 0,
+        primaryOwner: null,
+        churnScore: 0,
+        summary: null,
+        explanation: null,
+        layer: null,
+        tags: [],
+        position: { x: 0, y: 0, z: 0 },
+        dimensions: { width: 1, height: 1, depth: 1 },
+    };
+}
+/**
+ * Build function-level nodes and call edges from file analyses.
+ *
+ * Creates a `GraphNode` for each function declaration and a `GraphEdge`
+ * for each resolved function-to-function call (same-file and cross-file).
+ */
+export function buildCallGraph(analyses, modules, rootDir) {
+    const functionNodes = [];
+    const callEdgeMap = new Map();
+    // Maps for resolution
+    // relPath -> function name[]
+    const functionsByFile = new Map();
+    // relPath -> Map<importedName, sourceRelPath>
+    const importedNamesByFile = new Map();
+    // Set of all function node IDs for validation
+    const functionNodeIds = new Set();
+    // Pass 1: Create function nodes and build lookup maps
+    for (const analysis of analyses) {
+        const relPath = normalizePath(relative(rootDir, analysis.filePath));
+        const fileId = `file:${relPath}`;
+        // Find parent module for the file
+        let parentModuleId = null;
+        for (const mod of modules) {
+            if (mod.files.includes(relPath)) {
+                parentModuleId = mod.id;
+                break;
+            }
+        }
+        // Track functions declared in this file
+        const fnNames = new Set();
+        for (const fn of analysis.functions) {
+            const fnId = `fn:${relPath}:${fn.name}`;
+            const node = makeDefaultNode(fnId, "function", fn.name);
+            node.path = relPath;
+            node.parentId = fileId;
+            node.loc = fn.endLine - fn.startLine + 1;
+            node.complexity = fn.complexity;
+            // Inherit module's layer if no direct semantic info
+            // (Semantic data would be attached in a later enrichment pass)
+            functionNodes.push(node);
+            fnNames.add(fn.name);
+            functionNodeIds.add(fnId);
+        }
+        functionsByFile.set(relPath, fnNames);
+        // Build imported name -> source file mapping
+        const nameToSource = new Map();
+        for (const imp of analysis.imports) {
+            if (!imp.resolvedPath)
+                continue;
+            const targetRelPath = normalizePath(relative(rootDir, imp.resolvedPath));
+            for (const name of imp.names) {
+                nameToSource.set(name, targetRelPath);
+            }
+        }
+        importedNamesByFile.set(relPath, nameToSource);
+    }
+    // Pass 2: Resolve calls to edges
+    for (const analysis of analyses) {
+        const relPath = normalizePath(relative(rootDir, analysis.filePath));
+        const localFns = functionsByFile.get(relPath) ?? new Set();
+        const importedNames = importedNamesByFile.get(relPath) ?? new Map();
+        for (const fn of analysis.functions) {
+            const callerId = `fn:${relPath}:${fn.name}`;
+            for (const call of fn.calls) {
+                let calleeId = null;
+                // Case 1: callee is a local function in the same file
+                if (localFns.has(call.calleeName)) {
+                    calleeId = `fn:${relPath}:${call.calleeName}`;
+                }
+                // Case 2: callee matches an imported name
+                else if (importedNames.has(call.calleeName)) {
+                    const sourceRelPath = importedNames.get(call.calleeName);
+                    const sourceFns = functionsByFile.get(sourceRelPath);
+                    if (sourceFns?.has(call.calleeName)) {
+                        calleeId = `fn:${sourceRelPath}:${call.calleeName}`;
+                    }
+                }
+                if (!calleeId)
+                    continue;
+                if (calleeId === callerId)
+                    continue; // Skip self-calls (recursion edge not useful here)
+                if (!functionNodeIds.has(calleeId))
+                    continue; // Validate target exists
+                const edgeKey = `${callerId}|${calleeId}`;
+                const existing = callEdgeMap.get(edgeKey);
+                if (existing) {
+                    existing.weight += 1;
+                }
+                else {
+                    callEdgeMap.set(edgeKey, {
+                        sourceId: callerId,
+                        targetId: calleeId,
+                        kind: "calls",
+                        weight: 1,
+                    });
+                }
+            }
+        }
+    }
+    const callEdges = Array.from(callEdgeMap.values());
+    logger.debug(`Call graph: ${functionNodes.length} function nodes, ${callEdges.length} call edges`);
+    return { functionNodes, callEdges };
+}
+//# sourceMappingURL=call-graph.js.map

package/dist/analysis/call-graph.js.map

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

package/dist/analysis/dependency-graph.d.ts

@@ -0,0 +1,8 @@
+import type { FileAnalysis, ModuleInfo, GraphEdge } from "../types/index.js";
+export interface DependencyGraphResult {
+    fileEdges: GraphEdge[];
+    moduleEdges: GraphEdge[];
+    circularDeps: string[][];
+}
+export declare function buildDependencyGraph(analyses: FileAnalysis[], modules: ModuleInfo[], rootDir: string): DependencyGraphResult;
+//# sourceMappingURL=dependency-graph.d.ts.map

package/dist/analysis/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/analysis/dependency-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiB7E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,qBAAqB,CAwDvB"}

package/dist/analysis/dependency-graph.js

@@ -0,0 +1,101 @@
+import { relative } from "node:path";
+import { logger } from "../logger.js";
+function normalizePath(p) {
+    return p.replace(/\\/g, "/");
+}
+function fileToModule(filePath, modules) {
+    const relPath = normalizePath(filePath);
+    for (const mod of modules) {
+        if (mod.files.includes(relPath)) {
+            return mod.id;
+        }
+    }
+    return null;
+}
+export function buildDependencyGraph(analyses, modules, rootDir) {
+    const fileEdges = [];
+    const moduleEdgeMap = new Map();
+    // Build file-to-file edges from resolved imports
+    for (const analysis of analyses) {
+        const sourceRelPath = normalizePath(relative(rootDir, analysis.filePath));
+        const sourceFileId = `file:${sourceRelPath}`;
+        for (const imp of analysis.imports) {
+            if (!imp.resolvedPath)
+                continue;
+            if (imp.isTypeOnly)
+                continue; // Skip type-only imports for dependency edges
+            const targetRelPath = normalizePath(relative(rootDir, imp.resolvedPath));
+            const targetFileId = `file:${targetRelPath}`;
+            if (sourceFileId === targetFileId)
+                continue;
+            fileEdges.push({
+                sourceId: sourceFileId,
+                targetId: targetFileId,
+                kind: "imports",
+                weight: imp.names.length || 1,
+            });
+            // Aggregate to module-level edges
+            const sourceModule = fileToModule(sourceRelPath, modules);
+            const targetModule = fileToModule(targetRelPath, modules);
+            if (sourceModule && targetModule && sourceModule !== targetModule) {
+                const edgeKey = `${sourceModule}→${targetModule}`;
+                moduleEdgeMap.set(edgeKey, (moduleEdgeMap.get(edgeKey) ?? 0) + 1);
+            }
+        }
+    }
+    // Convert module edge map to GraphEdge[]
+    const moduleEdges = [];
+    for (const [key, weight] of moduleEdgeMap) {
+        const [sourceId, targetId] = key.split("→");
+        moduleEdges.push({
+            sourceId,
+            targetId,
+            kind: "imports",
+            weight,
+        });
+    }
+    // Detect circular dependencies at module level
+    const circularDeps = detectCycles(moduleEdges);
+    if (circularDeps.length > 0) {
+        logger.warn(`Circular dependencies detected: ${circularDeps.map((c) => c.join(" → ")).join("; ")}`);
+    }
+    logger.debug(`Dependency graph: ${fileEdges.length} file edges, ${moduleEdges.length} module edges`);
+    return { fileEdges, moduleEdges, circularDeps };
+}
+function detectCycles(edges) {
+    const adj = new Map();
+    for (const edge of edges) {
+        const neighbors = adj.get(edge.sourceId) ?? [];
+        neighbors.push(edge.targetId);
+        adj.set(edge.sourceId, neighbors);
+    }
+    const cycles = [];
+    const visited = new Set();
+    const inStack = new Set();
+    const path = [];
+    function dfs(node) {
+        if (inStack.has(node)) {
+            // Found a cycle
+            const cycleStart = path.indexOf(node);
+            if (cycleStart !== -1) {
+                cycles.push([...path.slice(cycleStart), node]);
+            }
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        inStack.add(node);
+        path.push(node);
+        for (const neighbor of adj.get(node) ?? []) {
+            dfs(neighbor);
+        }
+        path.pop();
+        inStack.delete(node);
+    }
+    for (const node of adj.keys()) {
+        dfs(node);
+    }
+    return cycles;
+}
+//# sourceMappingURL=dependency-graph.js.map

package/dist/analysis/dependency-graph.js.map

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

package/dist/analysis/git/archaeology.d.ts

@@ -0,0 +1,20 @@
+import type { ModuleInfo, EvolutionSnapshot } from "../../types/index.js";
+import { type ChurnData } from "./churn.js";
+import { type BusFactorData } from "./bus-factor.js";
+import { type ContributorInfo } from "./contributors.js";
+export interface GitArchaeologyResult {
+    churnMap: Map<string, ChurnData>;
+    busFactorMap: Map<string, BusFactorData>;
+    contributors: ContributorInfo[];
+    evolution: EvolutionSnapshot[];
+}
+/**
+ * Run all git archaeology analyses on a repository.
+ *
+ * Orchestrates churn computation, bus factor analysis, contributor
+ * extraction, and evolution timeline building. Each sub-module handles
+ * its own errors gracefully — partial results are returned if some
+ * analyses fail.
+ */
+export declare function analyzeGitHistory(gitDir: string, filePaths: string[], modules: ModuleInfo[]): Promise<GitArchaeologyResult>;
+//# sourceMappingURL=archaeology.d.ts.map

package/dist/analysis/git/archaeology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archaeology.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/archaeology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,oBAAoB,CAAC,CA+B/B"}

package/dist/analysis/git/archaeology.js

@@ -0,0 +1,61 @@
+import { logger } from "../../logger.js";
+import { computeChurn } from "./churn.js";
+import { computeBusFactors } from "./bus-factor.js";
+import { getContributors } from "./contributors.js";
+import { buildEvolutionTimeline } from "./evolution.js";
+/**
+ * Run all git archaeology analyses on a repository.
+ *
+ * Orchestrates churn computation, bus factor analysis, contributor
+ * extraction, and evolution timeline building. Each sub-module handles
+ * its own errors gracefully — partial results are returned if some
+ * analyses fail.
+ */
+export async function analyzeGitHistory(gitDir, filePaths, modules) {
+    logger.info(`Git archaeology: analyzing ${filePaths.length} files in ${modules.length} modules`);
+    // Run churn and contributors in parallel (they don't depend on each other)
+    const [churnMap, contributors] = await Promise.all([
+        safeRunMap("churn", () => computeChurn(gitDir, filePaths)),
+        safeRunArray("contributors", () => getContributors(gitDir)),
+    ]);
+    // Bus factor depends on modules
+    const busFactorMap = await safeRunMap("bus-factor", () => computeBusFactors(gitDir, modules));
+    // Evolution timeline
+    const evolution = await safeRunArray("evolution", () => buildEvolutionTimeline(gitDir, filePaths));
+    logger.info(`Git archaeology complete: ${churnMap.size} churn entries, ` +
+        `${busFactorMap.size} bus factors, ${contributors.length} contributors, ` +
+        `${evolution.length} evolution snapshots`);
+    return {
+        churnMap,
+        busFactorMap,
+        contributors,
+        evolution,
+    };
+}
+/**
+ * Run an async function that returns a Map, with error handling.
+ * Returns an empty Map on failure.
+ */
+async function safeRunMap(name, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        logger.warn(`Git archaeology: ${name} failed — ${err instanceof Error ? err.message : err}`);
+        return new Map();
+    }
+}
+/**
+ * Run an async function that returns an array, with error handling.
+ * Returns an empty array on failure.
+ */
+async function safeRunArray(name, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        logger.warn(`Git archaeology: ${name} failed — ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+}
+//# sourceMappingURL=archaeology.js.map

package/dist/analysis/git/archaeology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archaeology.js","sourceRoot":"","sources":["../../../src/analysis/git/archaeology.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAsB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAwB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AASxD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,SAAmB,EACnB,OAAqB;IAErB,MAAM,CAAC,IAAI,CAAC,8BAA8B,SAAS,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;IAEjG,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjD,UAAU,CAAoB,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7E,YAAY,CAAkB,cAAc,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;KAC7E,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,YAAY,GAAG,MAAM,UAAU,CAAwB,YAAY,EAAE,GAAG,EAAE,CAC9E,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CACnC,CAAC;IAEF,qBAAqB;IACrB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAoB,WAAW,EAAE,GAAG,EAAE,CACxE,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAC1C,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,6BAA6B,QAAQ,CAAC,IAAI,kBAAkB;QAC5D,GAAG,YAAY,CAAC,IAAI,iBAAiB,YAAY,CAAC,MAAM,iBAAiB;QACzE,GAAG,SAAS,CAAC,MAAM,sBAAsB,CAC1C,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CACvB,IAAY,EACZ,EAA4B;IAE5B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,oBAAoB,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAChF,CAAC;QACF,OAAO,IAAI,GAAG,EAAQ,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,YAAY,CACzB,IAAY,EACZ,EAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,oBAAoB,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAChF,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/analysis/git/bus-factor.d.ts

@@ -0,0 +1,17 @@
+import type { ModuleInfo } from "../../types/index.js";
+export interface BusFactorData {
+    busFactor: number;
+    primaryOwner: string;
+    ownershipShare: number;
+}
+/**
+ * Compute the bus factor for each module.
+ *
+ * Since isomorphic-git has no blame command, we approximate:
+ * for each commit that touches files in a module, attribute all changes
+ * to the commit author. Then count author commits as a proxy for contribution.
+ *
+ * Bus factor = minimum N such that sum(top N knowledge shares) > 0.70
+ */
+export declare function computeBusFactors(gitDir: string, modules: ModuleInfo[]): Promise<Map<string, BusFactorData>>;
+//# sourceMappingURL=bus-factor.d.ts.map

package/dist/analysis/git/bus-factor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-factor.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/bus-factor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAyFrC"}

package/dist/analysis/git/bus-factor.js

@@ -0,0 +1,90 @@
+import fs from "node:fs";
+import git from "isomorphic-git";
+import { logger } from "../../logger.js";
+/**
+ * Compute the bus factor for each module.
+ *
+ * Since isomorphic-git has no blame command, we approximate:
+ * for each commit that touches files in a module, attribute all changes
+ * to the commit author. Then count author commits as a proxy for contribution.
+ *
+ * Bus factor = minimum N such that sum(top N knowledge shares) > 0.70
+ */
+export async function computeBusFactors(gitDir, modules) {
+    const result = new Map();
+    // First, get full log (limited for perf)
+    let allCommits;
+    try {
+        const logs = await git.log({ fs, dir: gitDir, depth: 500 });
+        allCommits = logs.map((entry) => ({
+            oid: entry.oid,
+            author: entry.commit.author.name,
+            timestamp: entry.commit.author.timestamp,
+        }));
+    }
+    catch (err) {
+        logger.warn(`Bus factor: failed to read git log — ${err instanceof Error ? err.message : err}`);
+        // Return default bus factor for all modules
+        for (const mod of modules) {
+            result.set(mod.id, { busFactor: 0, primaryOwner: "unknown", ownershipShare: 0 });
+        }
+        return result;
+    }
+    // For each module, gather commits that touch its files
+    for (const mod of modules) {
+        try {
+            const authorCommitCounts = new Map();
+            let totalModuleCommits = 0;
+            // Get commits for each file in the module
+            for (const filePath of mod.files) {
+                try {
+                    const fileCommits = await git.log({
+                        fs,
+                        dir: gitDir,
+                        filepath: filePath,
+                        depth: 500,
+                    });
+                    for (const entry of fileCommits) {
+                        const author = entry.commit.author.name;
+                        authorCommitCounts.set(author, (authorCommitCounts.get(author) ?? 0) + 1);
+                        totalModuleCommits++;
+                    }
+                }
+                catch {
+                    // File may not exist in git (untracked); skip silently
+                }
+            }
+            if (totalModuleCommits === 0 || authorCommitCounts.size === 0) {
+                result.set(mod.id, { busFactor: 0, primaryOwner: "unknown", ownershipShare: 0 });
+                continue;
+            }
+            // Sort authors by their share (descending)
+            const shares = [];
+            for (const [author, count] of authorCommitCounts) {
+                shares.push({ author, share: count / totalModuleCommits });
+            }
+            shares.sort((a, b) => b.share - a.share);
+            // Bus factor = min N where sum(top N shares) > 0.70
+            let cumulative = 0;
+            let busFactor = 0;
+            for (const entry of shares) {
+                cumulative += entry.share;
+                busFactor++;
+                if (cumulative > 0.70)
+                    break;
+            }
+            const primary = shares[0];
+            result.set(mod.id, {
+                busFactor,
+                primaryOwner: primary.author,
+                ownershipShare: primary.share,
+            });
+        }
+        catch (err) {
+            logger.debug(`Bus factor: error for module ${mod.id} — ${err instanceof Error ? err.message : err}`);
+            result.set(mod.id, { busFactor: 0, primaryOwner: "unknown", ownershipShare: 0 });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=bus-factor.js.map

package/dist/analysis/git/bus-factor.js.map

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

package/dist/analysis/git/churn.d.ts

@@ -0,0 +1,26 @@
+export interface ChurnData {
+    distinctAuthors: number;
+    totalCommits: number;
+    commitsLast90d: number;
+    linesChangedLast90d: number;
+    churnScore: number;
+    createdAt: string | null;
+    lastModified: string | null;
+    primaryAuthor: string | null;
+}
+/**
+ * Compute churn data for all files in the repository.
+ *
+ * Uses isomorphic-git.log() with filepath to get per-file commit history.
+ * Lines changed is approximated using commit count as a proxy (actual line
+ * diffs are expensive with isomorphic-git).
+ *
+ * Formula:
+ *   rawChurn = (distinctAuthors/maxAuthors * 0.3)
+ *            + (commitsLast90d/max(totalCommits,1) * 0.3)
+ *            + (commitsLast90d/max(totalCommits,1) * 0.4)  // simplified proxy
+ *
+ * Result is then normalized across all files to 0-1 range.
+ */
+export declare function computeChurn(gitDir: string, filePaths: string[]): Promise<Map<string, ChurnData>>;
+//# sourceMappingURL=churn.d.ts.map

package/dist/analysis/git/churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/churn.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAmEjC"}