@bugsbunnycodes1998/cartographer-core 0.1.0

package/dist/analysis/git/churn.js

@@ -0,0 +1,127 @@
+import fs from "node:fs";
+import git from "isomorphic-git";
+import { logger } from "../../logger.js";
+/**
+ * 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 async function computeChurn(gitDir, filePaths) {
+    const result = new Map();
+    const now = Math.floor(Date.now() / 1000);
+    const ninetyDaysAgo = now - 90 * 24 * 60 * 60;
+    // Gather per-file commit data
+    for (const filePath of filePaths) {
+        try {
+            const commits = await getFileCommits(gitDir, filePath);
+            const authors = commits.map((c) => c.author);
+            const distinctAuthors = new Set(authors).size;
+            const totalCommits = commits.length;
+            const commitsLast90d = commits.filter((c) => c.timestamp >= ninetyDaysAgo).length;
+            // Find primary author (most frequent committer)
+            const authorCounts = new Map();
+            for (const a of authors) {
+                authorCounts.set(a, (authorCounts.get(a) ?? 0) + 1);
+            }
+            let primaryAuthor = null;
+            let maxCount = 0;
+            for (const [author, count] of authorCounts) {
+                if (count > maxCount) {
+                    maxCount = count;
+                    primaryAuthor = author;
+                }
+            }
+            // Sort by timestamp to find first and last
+            const sorted = [...commits].sort((a, b) => a.timestamp - b.timestamp);
+            const createdAt = sorted.length > 0
+                ? new Date(sorted[0].timestamp * 1000).toISOString()
+                : null;
+            const lastModified = sorted.length > 0
+                ? new Date(sorted[sorted.length - 1].timestamp * 1000).toISOString()
+                : null;
+            result.set(filePath, {
+                distinctAuthors,
+                totalCommits,
+                commitsLast90d,
+                linesChangedLast90d: commitsLast90d,
+                churnScore: 0,
+                createdAt,
+                lastModified,
+                primaryAuthor,
+            });
+        }
+        catch (err) {
+            logger.debug(`Churn: skipping ${filePath} — ${err instanceof Error ? err.message : err}`);
+            result.set(filePath, {
+                distinctAuthors: 0,
+                totalCommits: 0,
+                commitsLast90d: 0,
+                linesChangedLast90d: 0,
+                churnScore: 0,
+                createdAt: null,
+                lastModified: null,
+                primaryAuthor: null,
+            });
+        }
+    }
+    // Compute raw churn scores and normalize
+    normalizeChurnScores(result);
+    return result;
+}
+async function getFileCommits(gitDir, filePath) {
+    try {
+        const logs = await git.log({
+            fs,
+            dir: gitDir,
+            filepath: filePath,
+            depth: 500, // limit for performance
+        });
+        return logs.map((entry) => ({
+            oid: entry.oid,
+            author: entry.commit.author.name,
+            timestamp: entry.commit.author.timestamp,
+        }));
+    }
+    catch {
+        // File may not exist in git history (untracked)
+        return [];
+    }
+}
+function normalizeChurnScores(churnMap) {
+    if (churnMap.size === 0)
+        return;
+    // Find max values across all files for normalization
+    let maxAuthors = 1;
+    for (const data of churnMap.values()) {
+        if (data.distinctAuthors > maxAuthors)
+            maxAuthors = data.distinctAuthors;
+    }
+    // Compute raw scores
+    const rawScores = new Map();
+    let maxRaw = 0;
+    for (const [path, data] of churnMap) {
+        const authorComponent = (data.distinctAuthors / maxAuthors) * 0.3;
+        const recentCommitRatio = data.commitsLast90d / Math.max(data.totalCommits, 1);
+        const activityComponent = recentCommitRatio * 0.3;
+        const changeComponent = recentCommitRatio * 0.4; // simplified proxy
+        const raw = authorComponent + activityComponent + changeComponent;
+        rawScores.set(path, raw);
+        if (raw > maxRaw)
+            maxRaw = raw;
+    }
+    // Normalize to 0-1
+    for (const [path, data] of churnMap) {
+        const raw = rawScores.get(path) ?? 0;
+        data.churnScore = maxRaw > 0 ? raw / maxRaw : 0;
+    }
+}
+//# sourceMappingURL=churn.js.map

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

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

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

@@ -0,0 +1,14 @@
+export interface ContributorInfo {
+    name: string;
+    email: string;
+    commits: number;
+    avatarUrl: string;
+}
+/**
+ * Extract deduplicated contributor list from git history.
+ *
+ * Deduplicates by email address (case-insensitive, trimmed).
+ * Generates Gravatar URLs using MD5 hash of the email.
+ */
+export declare function getContributors(gitDir: string): Promise<ContributorInfo[]>;
+//# sourceMappingURL=contributors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contributors.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/contributors.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA2ChF"}

package/dist/analysis/git/contributors.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import { createHash } from "node:crypto";
+import git from "isomorphic-git";
+import { logger } from "../../logger.js";
+/**
+ * Extract deduplicated contributor list from git history.
+ *
+ * Deduplicates by email address (case-insensitive, trimmed).
+ * Generates Gravatar URLs using MD5 hash of the email.
+ */
+export async function getContributors(gitDir) {
+    try {
+        const logs = await git.log({ fs, dir: gitDir, depth: 500 });
+        // Aggregate by email (lowercase, trimmed)
+        const contributorMap = new Map();
+        for (const entry of logs) {
+            const { name, email } = entry.commit.author;
+            const normalizedEmail = email.trim().toLowerCase();
+            const existing = contributorMap.get(normalizedEmail);
+            if (existing) {
+                existing.commits++;
+                // Keep the most recent name (first seen, since log is reverse chronological)
+            }
+            else {
+                contributorMap.set(normalizedEmail, {
+                    name,
+                    email: normalizedEmail,
+                    commits: 1,
+                });
+            }
+        }
+        // Convert to array, sort by commit count descending
+        const contributors = [];
+        for (const data of contributorMap.values()) {
+            contributors.push({
+                name: data.name,
+                email: data.email,
+                commits: data.commits,
+                avatarUrl: gravatarUrl(data.email),
+            });
+        }
+        contributors.sort((a, b) => b.commits - a.commits);
+        return contributors;
+    }
+    catch (err) {
+        logger.warn(`Contributors: failed to read git log — ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+}
+/**
+ * Generate a Gravatar URL from an email address.
+ * Uses MD5 hash of the trimmed, lowercase email.
+ */
+function gravatarUrl(email) {
+    const hash = createHash("md5")
+        .update(email.trim().toLowerCase())
+        .digest("hex");
+    return `https://www.gravatar.com/avatar/${hash}?d=identicon&s=64`;
+}
+//# sourceMappingURL=contributors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contributors.js","sourceRoot":"","sources":["../../../src/analysis/git/contributors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,GAAG,MAAM,gBAAgB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AASzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAE5D,0CAA0C;QAC1C,MAAM,cAAc,GAAG,IAAI,GAAG,EAA4D,CAAC;QAE3F,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC5C,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAEnD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACrD,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,6EAA6E;YAC/E,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,GAAG,CAAC,eAAe,EAAE;oBAClC,IAAI;oBACJ,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,CAAC;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,MAAM,YAAY,GAAsB,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC;QACL,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CACrF,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;SAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAClC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,mCAAmC,IAAI,mBAAmB,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { EvolutionSnapshot } from "../../types/index.js";
+/**
+ * Build an evolution timeline by sampling commits at regular intervals.
+ *
+ * We aim for 20-50 snapshots. For each sampled commit, we list the files
+ * present in that commit's tree and compare against the previous sample
+ * to compute nodesAdded, nodesRemoved, nodesModified.
+ */
+export declare function buildEvolutionTimeline(gitDir: string, filePaths: string[]): Promise<EvolutionSnapshot[]>;
+//# sourceMappingURL=evolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/evolution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2G9B"}

package/dist/analysis/git/evolution.js

@@ -0,0 +1,127 @@
+import fs from "node:fs";
+import git from "isomorphic-git";
+import { logger } from "../../logger.js";
+/**
+ * Build an evolution timeline by sampling commits at regular intervals.
+ *
+ * We aim for 20-50 snapshots. For each sampled commit, we list the files
+ * present in that commit's tree and compare against the previous sample
+ * to compute nodesAdded, nodesRemoved, nodesModified.
+ */
+export async function buildEvolutionTimeline(gitDir, filePaths) {
+    try {
+        // Get all commits (limited for perf)
+        const logs = await git.log({ fs, dir: gitDir, depth: 500 });
+        if (logs.length === 0) {
+            return [];
+        }
+        // logs are in reverse chronological order (newest first)
+        // Reverse so we process oldest first
+        const chronological = [...logs].reverse();
+        // Compute sampling interval: aim for ~30 snapshots
+        const targetSnapshots = 30;
+        const step = Math.max(1, Math.floor(chronological.length / targetSnapshots));
+        // Always include first and last
+        const sampleIndices = [];
+        for (let i = 0; i < chronological.length; i += step) {
+            sampleIndices.push(i);
+        }
+        // Ensure last commit is included
+        const lastIdx = chronological.length - 1;
+        if (sampleIndices[sampleIndices.length - 1] !== lastIdx) {
+            sampleIndices.push(lastIdx);
+        }
+        // Build the known file set for matching
+        const knownFiles = new Set(filePaths);
+        const snapshots = [];
+        let previousFiles = new Set();
+        for (const idx of sampleIndices) {
+            const entry = chronological[idx];
+            try {
+                // List files in this commit's tree
+                const treeFiles = await listFilesAtCommit(gitDir, entry.oid);
+                // Filter to known file paths (those the analysis cares about)
+                const currentFiles = new Set();
+                for (const f of treeFiles) {
+                    if (knownFiles.has(f)) {
+                        currentFiles.add(f);
+                    }
+                }
+                // Compare with previous snapshot
+                const nodesAdded = [];
+                const nodesRemoved = [];
+                const nodesModified = [];
+                for (const f of currentFiles) {
+                    if (!previousFiles.has(f)) {
+                        nodesAdded.push(`file:${f}`);
+                    }
+                }
+                for (const f of previousFiles) {
+                    if (!currentFiles.has(f)) {
+                        nodesRemoved.push(`file:${f}`);
+                    }
+                    else {
+                        // File existed in both — mark as modified (simplification;
+                        // we don't actually diff, but the file survived between samples
+                        // so it may have been modified in the intervening commits)
+                    }
+                }
+                // For modified: files that exist in both but were likely changed
+                // We'll mark files that had commits between this sample and the previous
+                // as "modified". For simplicity, only non-newly-added files that exist
+                // in both snapshots are candidates.
+                if (snapshots.length > 0) {
+                    for (const f of currentFiles) {
+                        if (previousFiles.has(f) && !nodesAdded.includes(`file:${f}`)) {
+                            nodesModified.push(`file:${f}`);
+                        }
+                    }
+                }
+                snapshots.push({
+                    commitHash: entry.oid,
+                    timestamp: new Date(entry.commit.author.timestamp * 1000).toISOString(),
+                    author: entry.commit.author.name,
+                    nodesAdded,
+                    nodesRemoved,
+                    nodesModified,
+                    summary: entry.commit.message.split("\n")[0] ?? "",
+                });
+                previousFiles = currentFiles;
+            }
+            catch (err) {
+                logger.debug(`Evolution: skipping commit ${entry.oid.slice(0, 7)} — ${err instanceof Error ? err.message : err}`);
+            }
+        }
+        return snapshots;
+    }
+    catch (err) {
+        logger.warn(`Evolution: failed to build timeline — ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+}
+/**
+ * List all file paths in a commit's tree using TREE walk.
+ */
+async function listFilesAtCommit(gitDir, oid) {
+    const files = [];
+    await git.walk({
+        fs,
+        dir: gitDir,
+        trees: [git.TREE({ ref: oid })],
+        map: async (filepath, entries) => {
+            if (!entries || entries.length === 0)
+                return undefined;
+            const entry = entries[0];
+            if (!entry)
+                return undefined;
+            const type = await entry.type();
+            if (type === "blob" && filepath !== ".") {
+                files.push(filepath);
+            }
+            // Return filepath to continue walking into subdirectories
+            return filepath;
+        },
+    });
+    return files;
+}
+//# sourceMappingURL=evolution.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { analyzeGitHistory, type GitArchaeologyResult } from "./archaeology.js";
+export { computeChurn, type ChurnData } from "./churn.js";
+export { computeBusFactors, type BusFactorData } from "./bus-factor.js";
+export { getContributors, type ContributorInfo } from "./contributors.js";
+export { buildEvolutionTimeline } from "./evolution.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysis/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/analysis/git/index.js

@@ -0,0 +1,6 @@
+export { analyzeGitHistory } from "./archaeology.js";
+export { computeChurn } from "./churn.js";
+export { computeBusFactors } from "./bus-factor.js";
+export { getContributors } from "./contributors.js";
+export { buildEvolutionTimeline } from "./evolution.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA6B,MAAM,kBAAkB,CAAC;AAChF,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"}

package/dist/analysis/go-visitor.d.ts

@@ -0,0 +1,4 @@
+import type Parser from "web-tree-sitter";
+import type { FileAnalysis } from "../types/index.js";
+export declare function visitFile(content: string, tree: Parser.Tree, filePath: string): FileAnalysis;
+//# sourceMappingURL=go-visitor.d.ts.map

package/dist/analysis/go-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-visitor.d.ts","sourceRoot":"","sources":["../../src/analysis/go-visitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAA2E,MAAM,mBAAmB,CAAC;AAuS/H,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,QAAQ,EAAE,MAAM,GACf,YAAY,CAgBd"}