@yalehwang/archguard 0.1.23 → 0.1.31

package/dist/analysis/git-history/git-log-reader.d.ts

@@ -0,0 +1,24 @@
+export interface FileChange {
+    path: string;
+    added: number;
+    deleted: number;
+}
+export interface CommitRecord {
+    sha: string;
+    authorEmail: string;
+    date: string;
+    files: FileChange[];
+}
+export interface ReadGitLogOptions {
+    sinceDays: number;
+    maxCommits: number;
+    includeMerges: boolean;
+    pathFilter?: string;
+}
+export declare function readGitLog(repoRoot: string, options: ReadGitLogOptions): CommitRecord[];
+export declare function parseGitLogOutput(raw: string): CommitRecord[];
+export declare function getHeadRef(repoRoot: string): string;
+export declare function getCurrentBranch(repoRoot: string): string;
+export declare function isGitRepo(dir: string): boolean;
+export declare function getGitRoot(dir: string): string | null;
+//# sourceMappingURL=git-log-reader.d.ts.map

package/dist/analysis/git-history/git-log-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-log-reader.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-history/git-log-reader.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgBD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAkCvF;AAuCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CA8C7D;AAUD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUnD;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzD;AAKD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW9C;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrD"}

package/dist/analysis/git-history/git-log-reader.js

@@ -0,0 +1,117 @@
+import { execSync } from 'child_process';
+export function readGitLog(repoRoot, options) {
+    const { sinceDays, maxCommits, includeMerges, pathFilter } = options;
+    const mergeFlag = includeMerges ? '--merges' : '--no-merges';
+    const parts = [
+        'git',
+        'log',
+        '--numstat',
+        mergeFlag,
+        `--format=COMMIT_START%n%H%n%ae%n%cd`,
+        '--date=short',
+        `--since=${sinceDays}.days.ago`,
+        `--max-count=${maxCommits}`,
+    ];
+    if (pathFilter) {
+        parts.push('--', pathFilter);
+    }
+    const cmd = parts.join(' ');
+    let rawOutput;
+    try {
+        rawOutput = execSync(cmd, {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`git log failed in ${repoRoot}: ${message}`);
+    }
+    return parseGitLogOutput(rawOutput);
+}
+export function parseGitLogOutput(raw) {
+    const commits = [];
+    const blocks = raw.split(/^COMMIT_START\s*$/m).filter((b) => b.trim().length > 0);
+    for (const block of blocks) {
+        const lines = block.split('\n');
+        let i = 0;
+        while (i < lines.length && lines[i].trim() === '')
+            i++;
+        const sha = lines[i++]?.trim() ?? '';
+        if (!sha || sha.length < 7)
+            continue;
+        const authorEmail = lines[i++]?.trim() ?? '';
+        const date = lines[i++]?.trim() ?? '';
+        if (!date.match(/^\d{4}-\d{2}-\d{2}$/))
+            continue;
+        const files = [];
+        for (; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.trim() === '')
+                continue;
+            const numstatMatch = line.match(/^(\d+|-)\t(\d+|-)\t(.+)$/);
+            if (numstatMatch) {
+                const added = numstatMatch[1] === '-' ? 0 : parseInt(numstatMatch[1], 10);
+                const deleted = numstatMatch[2] === '-' ? 0 : parseInt(numstatMatch[2], 10);
+                const filePath = numstatMatch[3].trim();
+                if (filePath && !filePath.includes('{')) {
+                    files.push({ path: filePath, added, deleted });
+                }
+            }
+        }
+        commits.push({ sha, authorEmail, date, files });
+    }
+    return commits;
+}
+export function getHeadRef(repoRoot) {
+    try {
+        return execSync('git rev-parse --short HEAD', {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function getCurrentBranch(repoRoot) {
+    try {
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return branch || 'HEAD';
+    }
+    catch {
+        return 'HEAD';
+    }
+}
+export function isGitRepo(dir) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: dir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getGitRoot(dir) {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            cwd: dir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-log-reader.js.map

package/dist/analysis/git-history/git-log-reader.js.map

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

package/dist/analysis/git-history/history-aggregator.d.ts

@@ -0,0 +1,19 @@
+import type { CommitRecord } from './git-log-reader.js';
+import type { FileHistoryMetrics, PackageHistoryMetrics, CochangeEdge, RiskFactors } from '../../types/git-history.js';
+export declare function aggregateFileMetrics(commits: CommitRecord[], depth?: number): FileHistoryMetrics[];
+export declare function aggregatePackageMetrics(fileMetrics: FileHistoryMetrics[], depth?: number): PackageHistoryMetrics[];
+export declare function buildCochangeIndex(commits: CommitRecord[], topN?: number): Map<string, CochangeEdge[]>;
+export interface RiskInput {
+    commitCount: number;
+    authorCount: number;
+    primaryOwnerShare: number;
+    lastChangedAt: string;
+    topCochangeNeighbors: CochangeEdge[];
+}
+export interface RiskNorms {
+    maxCommitCount: number;
+    maxAuthorCount: number;
+}
+export declare function computeRiskFactors(input: RiskInput, norms: RiskNorms, referenceDate?: Date): RiskFactors;
+export declare function extractPackagePath(filePath: string, depth?: number): string;
+//# sourceMappingURL=history-aggregator.d.ts.map

package/dist/analysis/git-history/history-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-aggregator.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-history/history-aggregator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EAEZ,MAAM,wBAAwB,CAAC;AA8BhC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,GAAE,MAAU,GAChB,kBAAkB,EAAE,CA4GtB;AAYD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,EAAE,EACjC,KAAK,GAAE,MAAU,GAChB,qBAAqB,EAAE,CAsJzB;AAeD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,GAAE,MAAW,GAChB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CA+D7B;AAMD,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,YAAY,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,aAAa,GAAE,IAAiB,GAC/B,WAAW,CA0Cb;AAaD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAI9E"}

package/dist/analysis/git-history/history-aggregator.js

@@ -0,0 +1,291 @@
+export function aggregateFileMetrics(commits, depth = 1) {
+    const accMap = new Map();
+    for (const commit of commits) {
+        for (const fc of commit.files) {
+            let acc = accMap.get(fc.path);
+            if (!acc) {
+                acc = {
+                    path: fc.path,
+                    commits: [],
+                    shaSet: new Set(),
+                    dates: new Set(),
+                    authors: new Map(),
+                    authorShas: new Map(),
+                    addedLines: 0,
+                    deletedLines: 0,
+                    lastDate: commit.date,
+                };
+                accMap.set(fc.path, acc);
+            }
+            acc.commits.push(commit.sha);
+            acc.shaSet.add(commit.sha);
+            acc.dates.add(commit.date);
+            acc.authors.set(commit.authorEmail, (acc.authors.get(commit.authorEmail) ?? 0) + 1);
+            if (!acc.authorShas.has(commit.authorEmail))
+                acc.authorShas.set(commit.authorEmail, new Set());
+            acc.authorShas.get(commit.authorEmail).add(commit.sha);
+            acc.addedLines += fc.added;
+            acc.deletedLines += fc.deleted;
+            if (commit.date > acc.lastDate) {
+                acc.lastDate = commit.date;
+            }
+        }
+    }
+    if (accMap.size === 0)
+        return [];
+    const maxCommitCount = Math.max(...[...accMap.values()].map((a) => a.commits.length));
+    const maxAuthorCount = Math.max(...[...accMap.values()].map((a) => a.authors.size));
+    const cochangeIndex = buildCochangeIndex(commits);
+    const results = [];
+    for (const acc of accMap.values()) {
+        const commitCount = acc.commits.length;
+        const authorCount = acc.authors.size;
+        let primaryOwner = '';
+        let primaryOwnerCommits = 0;
+        for (const [email, count] of acc.authors) {
+            if (count > primaryOwnerCommits) {
+                primaryOwnerCommits = count;
+                primaryOwner = email;
+            }
+        }
+        const primaryOwnerShare = commitCount > 0 ? primaryOwnerCommits / commitCount : 0;
+        const topCochangeNeighbors = cochangeIndex.get(acc.path) ?? [];
+        const riskFactors = computeRiskFactors({
+            commitCount,
+            authorCount,
+            primaryOwnerShare,
+            lastChangedAt: acc.lastDate,
+            topCochangeNeighbors,
+        }, { maxCommitCount, maxAuthorCount });
+        const sortedAuthors = [...acc.authors.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
+        const topContributors = sortedAuthors.map(([email, count]) => ({
+            email,
+            commitCount: count,
+            share: commitCount > 0 ? count / commitCount : 0,
+        }));
+        const contributorShas = {};
+        for (const [email, shas] of acc.authorShas) {
+            contributorShas[email] = [...shas];
+        }
+        results.push({
+            path: acc.path,
+            packagePath: extractPackagePath(acc.path, depth),
+            commitCount,
+            activeDays: acc.dates.size,
+            addedLines: acc.addedLines,
+            deletedLines: acc.deletedLines,
+            authorCount,
+            primaryOwner,
+            primaryOwnerShare,
+            lastChangedAt: acc.lastDate,
+            topCochangeNeighbors,
+            riskFactors,
+            commitShas: [...acc.shaSet],
+            topContributors,
+            contributorShas,
+        });
+    }
+    return results;
+}
+export function aggregatePackageMetrics(fileMetrics, depth = 1) {
+    const pkgMap = new Map();
+    for (const fm of fileMetrics) {
+        const pkg = extractPackagePath(fm.path, depth);
+        let acc = pkgMap.get(pkg);
+        if (!acc) {
+            acc = {
+                addedLines: 0,
+                deletedLines: 0,
+                lastDate: fm.lastChangedAt,
+                files: [],
+            };
+            pkgMap.set(pkg, acc);
+        }
+        acc.addedLines += fm.addedLines;
+        acc.deletedLines += fm.deletedLines;
+        acc.files.push(fm);
+        if (fm.lastChangedAt > acc.lastDate)
+            acc.lastDate = fm.lastChangedAt;
+    }
+    if (pkgMap.size === 0)
+        return [];
+    const pkgCommitCounts = [...pkgMap.values()].map((a) => {
+        const allShas = new Set(a.files.flatMap((f) => f.commitShas ?? []));
+        return allShas.size > 0 ? allShas.size : a.files.reduce((s, f) => s + f.commitCount, 0);
+    });
+    const maxCommitCount = Math.max(...pkgCommitCounts, 1);
+    const pkgAuthorCounts = [...pkgMap.values()].map((a) => a.files.reduce((mx, f) => Math.max(mx, f.authorCount), 0));
+    const maxAuthorCount = Math.max(...pkgAuthorCounts, 1);
+    const results = [];
+    for (const [pkg, acc] of pkgMap) {
+        const allShas = new Set(acc.files.flatMap((f) => f.commitShas ?? []));
+        const commitCount = allShas.size > 0 ? allShas.size : acc.files.reduce((s, f) => s + f.commitCount, 0);
+        const authorCount = acc.files.reduce((mx, f) => Math.max(mx, f.authorCount), 0);
+        const mostChangedFile = acc.files.reduce((best, f) => (f.commitCount > best.commitCount ? f : best), acc.files[0]);
+        const primaryOwner = mostChangedFile?.primaryOwner ?? '';
+        const primaryOwnerShare = mostChangedFile?.primaryOwnerShare ?? 0;
+        const activeDays = acc.files.reduce((mx, f) => Math.max(mx, f.activeDays), 0);
+        const neighborPkgCounts = new Map();
+        for (const fm of acc.files) {
+            for (const edge of fm.topCochangeNeighbors) {
+                const neighborPkg = extractPackagePath(edge.target, depth);
+                if (neighborPkg === pkg)
+                    continue;
+                const existing = neighborPkgCounts.get(neighborPkg) ?? { joint: 0, ownCount: 0 };
+                existing.joint += edge.jointChangeCount;
+                existing.ownCount += fm.commitCount;
+                neighborPkgCounts.set(neighborPkg, existing);
+            }
+        }
+        const topCochangeNeighbors = [...neighborPkgCounts.entries()]
+            .map(([target, { joint, ownCount }]) => ({
+            target,
+            jointChangeCount: joint,
+            strength: ownCount > 0 ? Math.min(joint / ownCount, 1) : 0,
+            windowCoverage: ownCount > 0 ? Math.min(joint / ownCount, 1) : 0,
+        }))
+            .sort((a, b) => b.strength - a.strength)
+            .slice(0, 10);
+        const riskFactors = computeRiskFactors({
+            commitCount,
+            authorCount,
+            primaryOwnerShare,
+            lastChangedAt: acc.lastDate,
+            topCochangeNeighbors,
+        }, { maxCommitCount, maxAuthorCount });
+        const pkgAuthorShas = new Map();
+        for (const fm of acc.files) {
+            if (fm.contributorShas) {
+                for (const [email, shas] of Object.entries(fm.contributorShas)) {
+                    if (!pkgAuthorShas.has(email))
+                        pkgAuthorShas.set(email, new Set());
+                    const authorSet = pkgAuthorShas.get(email);
+                    for (const sha of shas)
+                        authorSet.add(sha);
+                }
+            }
+            else {
+                for (const contributor of fm.topContributors ?? []) {
+                    pkgAuthorShas.set(contributor.email, new Set([
+                        ...(pkgAuthorShas.get(contributor.email) ?? []),
+                        contributor.email + '_count_' + contributor.commitCount,
+                    ]));
+                }
+            }
+        }
+        const sortedPkgAuthors = [...pkgAuthorShas.entries()]
+            .map(([email, shas]) => [email, shas.size])
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        const topContributors = sortedPkgAuthors.map(([email, count]) => ({
+            email,
+            commitCount: count,
+            share: commitCount > 0 ? count / commitCount : 0,
+        }));
+        results.push({
+            path: pkg,
+            commitCount,
+            activeDays,
+            addedLines: acc.addedLines,
+            deletedLines: acc.deletedLines,
+            authorCount,
+            primaryOwner,
+            primaryOwnerShare,
+            lastChangedAt: acc.lastDate,
+            topCochangeNeighbors,
+            riskFactors,
+            topContributors,
+        });
+    }
+    return results;
+}
+export function buildCochangeIndex(commits, topN = 10) {
+    const fileCommitCounts = new Map();
+    const pairCounts = new Map();
+    for (const commit of commits) {
+        const paths = commit.files.map((f) => f.path);
+        for (const p of paths) {
+            fileCommitCounts.set(p, (fileCommitCounts.get(p) ?? 0) + 1);
+        }
+        if (paths.length < 2)
+            continue;
+        const sorted = [...paths].sort();
+        for (let a = 0; a < sorted.length; a++) {
+            for (let b = a + 1; b < sorted.length; b++) {
+                const key = `${sorted[a]}\x00${sorted[b]}`;
+                pairCounts.set(key, (pairCounts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    const adjacency = new Map();
+    for (const [key, joint] of pairCounts) {
+        const sep = key.indexOf('\x00');
+        const a = key.slice(0, sep);
+        const b = key.slice(sep + 1);
+        if (!adjacency.has(a))
+            adjacency.set(a, new Map());
+        if (!adjacency.has(b))
+            adjacency.set(b, new Map());
+        adjacency.get(a).set(b, joint);
+        adjacency.get(b).set(a, joint);
+    }
+    const result = new Map();
+    for (const [file, neighbors] of adjacency) {
+        const ownCount = fileCommitCounts.get(file) ?? 1;
+        const edges = [];
+        for (const [neighbor, joint] of neighbors) {
+            if (neighbor === file)
+                continue;
+            const neighborCount = fileCommitCounts.get(neighbor) ?? 1;
+            const union = ownCount + neighborCount - joint;
+            const strength = union > 0 ? joint / union : 0;
+            const windowCoverage = ownCount > 0 ? joint / ownCount : 0;
+            edges.push({
+                target: neighbor,
+                jointChangeCount: joint,
+                strength,
+                windowCoverage,
+            });
+        }
+        edges.sort((a, b) => b.strength - a.strength);
+        result.set(file, edges.slice(0, topN));
+    }
+    return result;
+}
+export function computeRiskFactors(input, norms, referenceDate = new Date()) {
+    const { commitCount, authorCount, primaryOwnerShare, lastChangedAt, topCochangeNeighbors } = input;
+    const { maxCommitCount, maxAuthorCount } = norms;
+    const churn = maxCommitCount > 0 ? Math.log1p(commitCount) / Math.log1p(maxCommitCount) : 0;
+    const authorCountRisk = maxAuthorCount > 0 ? Math.log1p(authorCount) / Math.log1p(maxAuthorCount) : 0;
+    const ownerConcentration = 1 - primaryOwnerShare;
+    const cochangeBreadth = Math.min(topCochangeNeighbors.length / 10, 1);
+    const lastDate = new Date(lastChangedAt);
+    const daysSinceLastChange = Math.max(0, Math.floor((referenceDate.getTime() - lastDate.getTime()) / (1000 * 60 * 60 * 24)));
+    let recency;
+    if (daysSinceLastChange <= 7) {
+        recency = 1.0;
+    }
+    else if (daysSinceLastChange <= 30) {
+        recency = 0.7;
+    }
+    else if (daysSinceLastChange <= 90) {
+        recency = 0.4;
+    }
+    else {
+        recency = 0.1;
+    }
+    return {
+        churn,
+        authorCount: authorCountRisk,
+        ownerConcentration,
+        cochangeBreadth,
+        recency,
+    };
+}
+export function extractPackagePath(filePath, depth = 1) {
+    const parts = filePath.split('/');
+    if (parts.length <= 1)
+        return '.';
+    return parts.slice(0, depth).join('/') || '.';
+}
+//# sourceMappingURL=history-aggregator.js.map

package/dist/analysis/git-history/history-aggregator.js.map

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

package/dist/analysis/git-history/history-query.d.ts

@@ -0,0 +1,111 @@
+import type { CochangeEdge, RiskFactors } from '../../types/git-history.js';
+import type { LoadedHistoryData } from '../../cli/git-history/history-loader.js';
+export interface CochangeResult {
+    target: string;
+    targetType: 'package' | 'file';
+    neighbors: CochangeEdge[];
+    analyzedWindow: {
+        sinceDays: number;
+        totalCommits: number;
+        generatedAt: string;
+    };
+    limitation: string;
+}
+export interface OwnershipContributor {
+    email: string;
+    commitCount: number;
+    share: number;
+}
+export interface OwnershipResult {
+    target: string;
+    targetType: 'package' | 'file';
+    contributors: OwnershipContributor[];
+    primaryOwner: string;
+    primaryOwnerShare: number;
+    activeMaintainers: number;
+    busFactor: number;
+    analyzedWindow: {
+        sinceDays: number;
+        totalCommits: number;
+        generatedAt: string;
+    };
+}
+export interface ChangeRiskResult {
+    target: string;
+    targetType: 'package' | 'file';
+    riskScore: number;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    factors: RiskFactors;
+    factorExplanations: {
+        churn: string;
+        authorCount: string;
+        ownerConcentration: string;
+        cochangeBreadth: number;
+        recency: string;
+    };
+    currentlyExists: boolean;
+    limitation: string;
+}
+export interface EvidencePackEntry {
+    target: string;
+    targetType: 'package' | 'file';
+    riskScore: number;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    topFactor: string;
+}
+export interface EvidencePackNotFound {
+    target: string;
+    targetType: 'package' | 'file';
+    reason: string;
+}
+export interface EvidencePackResult {
+    results: EvidencePackEntry[];
+    hotspots: EvidencePackEntry[];
+    notFound: EvidencePackNotFound[];
+}
+export interface ChangeContextResult {
+    target: string;
+    targetType: 'package' | 'file';
+    summary: {
+        commitCount: number;
+        activeDays: number;
+        primaryOwner: string;
+        lastChangedAt: string;
+    };
+    recentChurn: {
+        addedLines: number;
+        deletedLines: number;
+        commitCount: number;
+    };
+    ownerConcentration: {
+        primaryOwner: string;
+        primaryOwnerShare: number;
+    };
+    topCochangeNeighbors: CochangeEdge[];
+    risk: {
+        riskScore: number;
+        riskLevel: string;
+        topFactor: string;
+    };
+    analyzedWindow: {
+        sinceDays: number;
+        totalCommits: number;
+        generatedAt: string;
+    };
+    stalePathWarning?: string;
+}
+export declare class HistoryQuery {
+    private data;
+    constructor(data: LoadedHistoryData);
+    private getMetrics;
+    private analyzedWindow;
+    getCochange(targetType: 'package' | 'file', target: string, topN?: number): CochangeResult;
+    getOwnership(targetType: 'package' | 'file', target: string): OwnershipResult;
+    getChangeRisk(targetType: 'package' | 'file', target: string): ChangeRiskResult;
+    getEvidencePack(targets: Array<{
+        targetType: 'file' | 'package';
+        target: string;
+    }>): EvidencePackResult;
+    getChangeContext(targetType: 'package' | 'file', target: string): ChangeContextResult;
+}
+//# sourceMappingURL=history-query.d.ts.map

package/dist/analysis/git-history/history-query.d.ts.map

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