projscan 4.4.0 → 4.6.0

package/dist/core/hotspotCandidates.js

@@ -0,0 +1,63 @@
+import { countLines } from './hotspotLines.js';
+const CODE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.py',
+    '.rb',
+    '.go',
+    '.java',
+    '.rs',
+    '.php',
+    '.c',
+    '.cc',
+    '.cpp',
+    '.h',
+    '.hpp',
+    '.cs',
+    '.swift',
+    '.kt',
+    '.kts',
+    '.scala',
+    '.vue',
+    '.svelte',
+]);
+const MAX_LINE_READS = 400;
+const MAX_LINE_READ_BYTES = 512 * 1024;
+export async function collectHotspotCandidateEvidence(files, churnMap) {
+    const candidates = selectHotspotCandidates(files);
+    const readTargets = rankLineReadTargets(candidates, churnMap).slice(0, MAX_LINE_READS);
+    const lineCounts = await collectLineCounts(readTargets);
+    return { candidates, lineCounts };
+}
+export function selectHotspotCandidates(files) {
+    return files.filter(isSizedCodeFile);
+}
+export function rankLineReadTargets(candidates, churnMap) {
+    return [...candidates].sort(compareChurnThenSize(churnMap));
+}
+function isSizedCodeFile(file) {
+    return CODE_EXTENSIONS.has(file.extension) && file.sizeBytes <= MAX_LINE_READ_BYTES;
+}
+function compareChurnThenSize(churnMap) {
+    return (a, b) => {
+        const aChurn = churnMap.get(a.relativePath)?.churn ?? 0;
+        const bChurn = churnMap.get(b.relativePath)?.churn ?? 0;
+        if (bChurn !== aChurn)
+            return bChurn - aChurn;
+        return b.sizeBytes - a.sizeBytes;
+    };
+}
+async function collectLineCounts(readTargets) {
+    const lineCounts = new Map();
+    await Promise.all(readTargets.map(async (file) => {
+        const lines = await countLines(file.absolutePath);
+        if (lines !== null)
+            lineCounts.set(file.relativePath, lines);
+    }));
+    return lineCounts;
+}
+//# sourceMappingURL=hotspotCandidates.js.map

package/dist/core/hotspotCandidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspotCandidates.js","sourceRoot":"","sources":["../../src/core/hotspotCandidates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC;AAOvC,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAAkB,EAClB,QAAiC;IAEjC,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAkB;IACxD,OAAO,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAuB,EACvB,QAAiC;IAEjC,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CAAC,IAAe;IACtC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC;AACtF,CAAC;AAED,SAAS,oBAAoB,CAC3B,QAAiC;IAEjC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,MAAM,GAAG,MAAM,CAAC;QAC9C,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,WAAwB;IACvD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,IAAI;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CACH,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/hotspotGit.d.ts

@@ -0,0 +1,10 @@
+export interface ChurnEntry {
+    churn: number;
+    authors: Set<string>;
+    authorCommits: Map<string, number>;
+    lastTimestampMs: number | null;
+    commitHashes: Set<string>;
+}
+export declare function isGitRepository(rootPath: string): Promise<boolean>;
+export declare function collectGitChurn(rootPath: string, since: string): Promise<Map<string, ChurnEntry>>;
+export declare function countCommits(churnMap: Map<string, ChurnEntry>): number;

package/dist/core/hotspotGit.js

@@ -0,0 +1,152 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+export async function isGitRepository(rootPath) {
+    try {
+        const { code } = await runGit(rootPath, ['rev-parse', '--is-inside-work-tree']);
+        return code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function collectGitChurn(rootPath, since) {
+    const stdout = await readGitLog(rootPath, since);
+    return stdout ? parseGitChurn(stdout) : new Map();
+}
+export function countCommits(churnMap) {
+    const hashes = new Set();
+    for (const entry of churnMap.values()) {
+        for (const hash of entry.commitHashes)
+            hashes.add(hash);
+    }
+    return hashes.size;
+}
+async function readGitLog(rootPath, since) {
+    try {
+        const result = await runGit(rootPath, gitLogArgs(since), { timeoutMs: 15_000 });
+        return result.code === 0 ? result.stdout : null;
+    }
+    catch {
+        return null;
+    }
+}
+function gitLogArgs(since) {
+    return [
+        'log',
+        `--since=${since}`,
+        '--no-merges',
+        '--name-only',
+        '--pretty=format:COMMIT|%H|%ae|%at',
+    ];
+}
+function parseGitChurn(stdout) {
+    const map = new Map();
+    let commit = { hash: null, author: null, timestampMs: null };
+    for (const rawLine of stdout.split('\n')) {
+        const line = rawLine.trimEnd();
+        if (!line)
+            continue;
+        if (line.startsWith('COMMIT|')) {
+            commit = parseCommitLine(line);
+            continue;
+        }
+        recordFileChange(map, commit, line);
+    }
+    return map;
+}
+function parseCommitLine(line) {
+    const parts = line.split('|');
+    const timestampSeconds = parseInt(parts[3] ?? '', 10);
+    return {
+        hash: parts[1] ?? null,
+        author: parts[2] ?? null,
+        timestampMs: Number.isFinite(timestampSeconds) ? timestampSeconds * 1000 : null,
+    };
+}
+function recordFileChange(map, commit, rawPath) {
+    if (!commit.hash)
+        return;
+    const filePath = normalizeFilePath(rawPath);
+    if (!filePath)
+        return;
+    const entry = getOrCreateChurnEntry(map, filePath);
+    recordCommit(entry, commit);
+}
+function getOrCreateChurnEntry(map, filePath) {
+    const existing = map.get(filePath);
+    if (existing)
+        return existing;
+    const entry = {
+        churn: 0,
+        authors: new Set(),
+        authorCommits: new Map(),
+        lastTimestampMs: null,
+        commitHashes: new Set(),
+    };
+    map.set(filePath, entry);
+    return entry;
+}
+function recordCommit(entry, commit) {
+    if (commit.hash && !entry.commitHashes.has(commit.hash)) {
+        entry.commitHashes.add(commit.hash);
+        entry.churn++;
+        incrementAuthorCommit(entry, commit.author);
+    }
+    if (commit.author)
+        entry.authors.add(commit.author);
+    if (commit.timestampMs !== null &&
+        (entry.lastTimestampMs === null || commit.timestampMs > entry.lastTimestampMs)) {
+        entry.lastTimestampMs = commit.timestampMs;
+    }
+}
+function incrementAuthorCommit(entry, author) {
+    if (!author)
+        return;
+    entry.authorCommits.set(author, (entry.authorCommits.get(author) ?? 0) + 1);
+}
+function normalizeFilePath(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    return trimmed.split(path.sep).join('/').replace(/^\.\//, '');
+}
+function runGit(cwd, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, { cwd, env: process.env });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const timeout = opts.timeoutMs
+            ? setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                child.kill('SIGKILL');
+                reject(new Error('git command timed out'));
+            }, opts.timeoutMs)
+            : null;
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', (err) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            resolve({ code: code ?? 1, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=hotspotGit.js.map

package/dist/core/hotspotGit.js.map

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

package/dist/core/hotspotIssues.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function indexIssuesByFile(issues: Issue[], files: FileEntry[]): Map<string, string[]>;

package/dist/core/hotspotIssues.js

@@ -0,0 +1,83 @@
+export function indexIssuesByFile(issues, files) {
+    const index = new Map();
+    const filePathSet = new Set(files.map((f) => f.relativePath));
+    for (const issue of issues) {
+        if (issue.locations && issue.locations.length > 0) {
+            indexLocatedIssue(index, filePathSet, issue);
+        }
+        else {
+            indexLegacyIssue(index, filePathSet, issue);
+        }
+    }
+    return index;
+}
+function indexLocatedIssue(index, filePathSet, issue) {
+    // Prefer explicit locations when the analyzer supplied them - this is exact
+    // and avoids substring false positives such as src/a.ts matching src/ab.ts.
+    for (const loc of issue.locations ?? []) {
+        if (loc.file && filePathSet.has(loc.file))
+            addIssueFile(index, loc.file, issue.id);
+    }
+}
+function indexLegacyIssue(index, filePathSet, issue) {
+    // Fall back to substring scan for legacy issues with no locations.
+    // Use word-boundary-ish guards: require the match to start at the
+    // beginning of title/description OR be preceded/followed by non-path chars.
+    const haystack = `${issue.title}\n${issue.description}`;
+    for (const filePath of filePathSet) {
+        if (!legacyIssueMentionsPath(haystack, filePath))
+            continue;
+        addIssueFile(index, filePath, issue.id);
+    }
+}
+function legacyIssueMentionsPath(haystack, filePath) {
+    return Boolean(filePath && haystack.includes(filePath) && hasPathBoundaries(haystack, filePath));
+}
+function addIssueFile(index, file, issueId) {
+    const list = index.get(file) ?? [];
+    if (!list.includes(issueId))
+        list.push(issueId);
+    index.set(file, list);
+}
+function hasPathBoundaries(haystack, filePath) {
+    let startIdx = 0;
+    while (startIdx < haystack.length) {
+        const idx = haystack.indexOf(filePath, startIdx);
+        if (idx === -1)
+            return false;
+        const before = idx > 0 ? haystack.charCodeAt(idx - 1) : -1;
+        const after = idx + filePath.length < haystack.length ? haystack.charCodeAt(idx + filePath.length) : -1;
+        // Good boundary = start-of-string, whitespace, quote, paren, comma, colon, or end-of-string.
+        if (isPathBoundary(before) && isPathBoundary(after))
+            return true;
+        startIdx = idx + 1;
+    }
+    return false;
+}
+const PATH_BOUNDARY_CODES = new Set([
+    0x20, // space
+    0x09, // tab
+    0x0a, // \n
+    0x0d, // \r
+    0x22, // "
+    0x27, // '
+    0x60, // `
+    0x28, // (
+    0x29, // )
+    0x5b, // [
+    0x5d, // ]
+    0x7b, // {
+    0x7d, // }
+    0x3a, // :
+    0x2c, // ,
+    0x3b, // ;
+    0x2e, // . (e.g., "src/a.ts." end of sentence)
+    0x3f, // ?
+    0x21, // !
+    0x3e, // >
+    0x3c, // <
+]);
+function isPathBoundary(code) {
+    return code === -1 || PATH_BOUNDARY_CODES.has(code);
+}
+//# sourceMappingURL=hotspotIssues.js.map

package/dist/core/hotspotIssues.js.map

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

package/dist/core/hotspotLines.d.ts

@@ -0,0 +1,2 @@
+export declare function countLines(absolutePath: string): Promise<number | null>;
+export declare function lineCountOrEstimate(lineCount: number | undefined, sizeBytes: number): number;

package/dist/core/hotspotLines.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs/promises';
+export async function countLines(absolutePath) {
+    try {
+        const content = await fs.readFile(absolutePath, 'utf-8');
+        if (!content)
+            return 0;
+        let lines = 1;
+        for (let i = 0; i < content.length; i++) {
+            if (content.charCodeAt(i) === 10)
+                lines++;
+        }
+        return lines;
+    }
+    catch {
+        return null;
+    }
+}
+export function lineCountOrEstimate(lineCount, sizeBytes) {
+    return lineCount ?? estimateLines(sizeBytes);
+}
+function estimateLines(sizeBytes) {
+    return Math.max(1, Math.round(sizeBytes / 40));
+}
+//# sourceMappingURL=hotspotLines.js.map

package/dist/core/hotspotLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspotLines.js","sourceRoot":"","sources":["../../src/core/hotspotLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,YAAoB;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC;QACvB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE;gBAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAA6B,EAAE,SAAiB;IAClF,OAAO,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/core/hotspotMemory.d.ts

@@ -0,0 +1,2 @@
+import type { FileHotspot } from '../types.js';
+export declare function markAcceptedHotspots(rootPath: string, top: FileHotspot[]): Promise<void>;

package/dist/core/hotspotMemory.js

@@ -0,0 +1,21 @@
+export async function markAcceptedHotspots(rootPath, top) {
+    try {
+        const { loadMemory, saveMemory, recordHotspots, findAcceptedHotspots } = await import('./memory.js');
+        const memory = await loadMemory(rootPath);
+        recordHotspots(memory, top.map((h) => ({
+            file: h.relativePath,
+            cc: h.cyclomaticComplexity,
+            churn: h.churn,
+        })));
+        const accepted = new Set(findAcceptedHotspots(memory).map((o) => o.file));
+        for (const h of top) {
+            if (accepted.has(h.relativePath))
+                h.accepted = true;
+        }
+        await saveMemory(rootPath, memory);
+    }
+    catch {
+        // Best-effort: memory tagging should never break hotspot analysis.
+    }
+}
+//# sourceMappingURL=hotspotMemory.js.map

package/dist/core/hotspotMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspotMemory.js","sourceRoot":"","sources":["../../src/core/hotspotMemory.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB,EAAE,GAAkB;IAC7E,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,GACpE,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,cAAc,CACZ,MAAM,EACN,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,YAAY;YACpB,EAAE,EAAE,CAAC,CAAC,oBAAoB;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CACJ,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;gBAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtD,CAAC;QACD,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC"}

package/dist/core/hotspotRanking.d.ts

@@ -0,0 +1,13 @@
+import type { FileEntry, FileHotspot } from '../types.js';
+import type { CodeGraph } from './codeGraph.js';
+import type { ChurnEntry } from './hotspotGit.js';
+export interface RankHotspotFilesInput {
+    candidates: FileEntry[];
+    churnMap: Map<string, ChurnEntry>;
+    lineCounts: Map<string, number>;
+    issueIndex: Map<string, string[]>;
+    nowMs: number;
+    coverage?: Map<string, number>;
+    graph?: CodeGraph;
+}
+export declare function rankHotspotFiles(input: RankHotspotFilesInput): FileHotspot[];

package/dist/core/hotspotRanking.js

@@ -0,0 +1,44 @@
+import { buildFileHotspot } from './hotspotBuilder.js';
+export function rankHotspotFiles(input) {
+    return input.candidates
+        .map((file) => buildRankedFileHotspot(file, input))
+        .sort((a, b) => b.riskScore - a.riskScore)
+        .filter((hotspot) => hotspot.riskScore > 0);
+}
+function buildRankedFileHotspot(file, input) {
+    const churn = rankedChurnEvidence(input.churnMap.get(file.relativePath));
+    return buildFileHotspot({
+        file,
+        churn: churn.churn,
+        distinctAuthors: churn.distinctAuthors,
+        authorCommits: churn.authorCommits,
+        lastTimestampMs: churn.lastTimestampMs,
+        lineCount: input.lineCounts.get(file.relativePath),
+        issueIds: input.issueIndex.get(file.relativePath) ?? [],
+        nowMs: input.nowMs,
+        coverage: input.coverage?.get(file.relativePath),
+        complexity: parsedGraphComplexity(input.graph, file.relativePath),
+    });
+}
+function rankedChurnEvidence(churnEntry) {
+    if (!churnEntry) {
+        return {
+            churn: 0,
+            distinctAuthors: 0,
+            lastTimestampMs: null,
+        };
+    }
+    return {
+        churn: churnEntry.churn,
+        distinctAuthors: churnEntry.authors.size,
+        authorCommits: churnEntry.authorCommits,
+        lastTimestampMs: churnEntry.lastTimestampMs,
+    };
+}
+function parsedGraphComplexity(graph, relativePath) {
+    const graphEntry = graph?.files.get(relativePath);
+    if (!graphEntry?.parseOk)
+        return null;
+    return graphEntry.cyclomaticComplexity;
+}
+//# sourceMappingURL=hotspotRanking.js.map

package/dist/core/hotspotRanking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspotRanking.js","sourceRoot":"","sources":["../../src/core/hotspotRanking.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAoBvD,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,OAAO,KAAK,CAAC,UAAU;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SACzC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAe,EACf,KAA4B;IAE5B,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzE,OAAO,gBAAgB,CAAC;QACtB,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;QAClD,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;QACvD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;QAChD,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAkC;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,CAAC;YACR,eAAe,EAAE,CAAC;YAClB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI;QACxC,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,eAAe,EAAE,UAAU,CAAC,eAAe;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAA4B,EAAE,YAAoB;IAC/E,MAAM,UAAU,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE,OAAO;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,UAAU,CAAC,oBAAoB,CAAC;AACzC,CAAC"}

package/dist/core/hotspotScoring.d.ts

@@ -0,0 +1,23 @@
+import type { AuthorShare } from '../types.js';
+interface ScoreInputs {
+    churn: number;
+    lines: number;
+    /**
+     * AST cyclomatic complexity. When null (no adapter parsed this file or
+     * parse failed), the score falls back to `lines` so non-AST languages
+     * like Ruby/Go/Java still rank.
+     */
+    complexity?: number | null;
+    authors: number;
+    daysSinceLastChange: number | null;
+    issueCount: number;
+    busFactorOne?: boolean;
+    coverage?: number | null;
+}
+export declare function computeRiskScore(i: ScoreInputs): number;
+interface ReasonInputs extends ScoreInputs {
+    primaryAuthor?: string | null;
+}
+export declare function buildReasons(i: ReasonInputs): string[];
+export declare function rankAuthors(authorCommits: Map<string, number> | undefined): AuthorShare[];
+export {};

package/dist/core/hotspotScoring.js

@@ -0,0 +1,128 @@
+export function computeRiskScore(i) {
+    // 0.11: complexity replaces LOC as the second-axis "scariness" signal.
+    // CC is a tighter proxy for control-flow risk than raw line count, but a
+    // 200-line file might score CC=15 instead of LOC=200, so absolute scores
+    // shift down for adapter-parsed files. Rankings are what matter.
+    const cx = complexityAxis(i);
+    const churnWeight = Math.log2(1 + i.churn) * 20;
+    const complexityWeight = Math.log2(1 + cx) * 4;
+    const hotChurnXComplexity = Math.log2(1 + i.churn) * Math.log2(1 + cx) * 3;
+    const authorWeight = Math.log2(1 + i.authors) * 5;
+    const issueWeight = i.issueCount * 12;
+    const busFactorPenalty = i.busFactorOne ? 15 : 0;
+    const raw = churnWeight +
+        complexityWeight +
+        hotChurnXComplexity +
+        authorWeight +
+        issueWeight +
+        recencyBoost(i.daysSinceLastChange) +
+        busFactorPenalty +
+        coveragePenalty(i.coverage, i.churn);
+    if (i.churn === 0 && i.issueCount === 0)
+        return 0;
+    return Math.round(raw * 10) / 10;
+}
+function complexityAxis(i) {
+    return typeof i.complexity === 'number' ? i.complexity : i.lines;
+}
+function recencyBoost(daysSinceLastChange) {
+    if (daysSinceLastChange === null)
+        return 0;
+    if (daysSinceLastChange <= 7)
+        return 10;
+    if (daysSinceLastChange <= 30)
+        return 6;
+    if (daysSinceLastChange <= 90)
+        return 3;
+    return 0;
+}
+function coveragePenalty(coverage, churn) {
+    if (typeof coverage !== 'number' || churn === 0)
+        return 0;
+    const uncoveredFraction = Math.max(0, (100 - coverage) / 100);
+    return uncoveredFraction * Math.log2(1 + churn) * 4;
+}
+export function buildReasons(i) {
+    const reasons = [];
+    pushChurnReason(reasons, i);
+    pushSizeReason(reasons, i);
+    pushAuthorsReason(reasons, i);
+    pushIssuesReason(reasons, i);
+    pushRecencyReason(reasons, i);
+    pushBusFactorReason(reasons, i);
+    pushCoverageReason(reasons, i);
+    return reasons;
+}
+function pushChurnReason(reasons, i) {
+    if (i.churn >= 20)
+        reasons.push(`high churn (${i.churn} commits)`);
+    else if (i.churn >= 8)
+        reasons.push(`frequent changes (${i.churn} commits)`);
+    else if (i.churn > 0)
+        reasons.push(`${i.churn} commit${i.churn === 1 ? '' : 's'}`);
+}
+/**
+ * When CC is available, prefer it over raw line count - it's the more
+ * honest signal. Fall back to "large file (lines)" for non-AST
+ * languages.
+ */
+function pushSizeReason(reasons, i) {
+    if (typeof i.complexity === 'number') {
+        if (i.complexity >= 30)
+            reasons.push(`high complexity (CC ${i.complexity})`);
+        else if (i.complexity >= 15)
+            reasons.push(`moderate complexity (CC ${i.complexity})`);
+        return;
+    }
+    if (i.lines >= 500)
+        reasons.push(`large file (${i.lines} lines)`);
+    else if (i.lines >= 250)
+        reasons.push(`${i.lines} lines`);
+}
+function pushAuthorsReason(reasons, i) {
+    if (i.authors >= 2)
+        reasons.push(`${i.authors} contributors`);
+}
+function pushIssuesReason(reasons, i) {
+    if (i.issueCount > 0) {
+        reasons.push(`${i.issueCount} open issue${i.issueCount === 1 ? '' : 's'}`);
+    }
+}
+function pushRecencyReason(reasons, i) {
+    if (i.daysSinceLastChange !== null && i.daysSinceLastChange <= 7) {
+        reasons.push('changed this week');
+    }
+}
+function pushBusFactorReason(reasons, i) {
+    if (i.busFactorOne && i.primaryAuthor) {
+        reasons.push(`bus factor 1 (${formatAuthor(i.primaryAuthor)})`);
+    }
+}
+function pushCoverageReason(reasons, i) {
+    if (typeof i.coverage !== 'number' || i.churn === 0)
+        return;
+    if (i.coverage < 40)
+        reasons.push(`low coverage (${Math.round(i.coverage)}%)`);
+    else if (i.coverage < 70)
+        reasons.push(`moderate coverage (${Math.round(i.coverage)}%)`);
+}
+export function rankAuthors(authorCommits) {
+    if (!authorCommits || authorCommits.size === 0)
+        return [];
+    const total = [...authorCommits.values()].reduce((sum, n) => sum + n, 0);
+    if (total === 0)
+        return [];
+    return [...authorCommits.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([author, commits]) => ({
+        author,
+        commits,
+        share: Math.round((commits / total) * 1000) / 1000,
+    }));
+}
+function formatAuthor(email) {
+    const atIdx = email.indexOf('@');
+    return atIdx > 0 ? email.slice(0, atIdx) : email;
+}
+//# sourceMappingURL=hotspotScoring.js.map

package/dist/core/hotspotScoring.js.map

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

package/dist/core/indexCache.js

@@ -17,7 +17,10 @@ const CACHE_FILE = 'graph.json';
 // be distinguished from ordinary req-shaped helpers.
 // v8: added `directCallSites` and `memberAliases` so bare imported DB
 // helpers stay visible without treating cache.query() as a raw SQL sink.
-const CACHE_VERSION = 8;
+// v9: added `memberReferences` for precise qualified framework request reads.
+// v10: preserves `contextualCallSite` through object-argument handlers such
+// as Fastify `app.route({ handler })`.
+const CACHE_VERSION = 10;
 /**
  * Load a previously cached code graph, if present and valid. Returns undefined
  * when there's no cache or the cache is incompatible - caller should rebuild.