projscan 4.5.0 → 4.7.0

package/dist/core/fileInspectionEvidence.js

@@ -0,0 +1,14 @@
+import { indexIssuesByFile } from './hotspotIssues.js';
+export function collectFileInspectionEvidence(input) {
+    const relatedIssueIds = new Set(indexIssuesByFile(input.issues, input.files).get(input.relativePath) ?? []);
+    return {
+        hotspot: findHotspotForFile(input.hotspots, input.relativePath),
+        issues: input.issues.filter((issue) => relatedIssueIds.has(issue.id)),
+    };
+}
+function findHotspotForFile(report, relativePath) {
+    if (!report || !report.available)
+        return null;
+    return report.hotspots.find((h) => h.relativePath === relativePath) ?? null;
+}
+//# sourceMappingURL=fileInspectionEvidence.js.map

package/dist/core/fileInspectionEvidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileInspectionEvidence.js","sourceRoot":"","sources":["../../src/core/fileInspectionEvidence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAcvD,MAAM,UAAU,6BAA6B,CAC3C,KAAkC;IAElC,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAC3E,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;QAC/D,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAiC,EACjC,YAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,CAAC,IAAI,IAAI,CAAC;AAC9E,CAAC"}

package/dist/core/fileInspectionGraph.d.ts

@@ -0,0 +1,5 @@
+import type { ExportInfo, FileEntry, ImportInfo } from '../types.js';
+import { type CodeGraph, type GraphFile } from './codeGraph.js';
+export declare function resolveInspectionGraph(resolvedRoot: string, files: FileEntry[], graph: CodeGraph | undefined): Promise<CodeGraph>;
+export declare function importsFromGraphFile(graphFile: GraphFile | undefined): ImportInfo[];
+export declare function exportsFromGraphFile(graphFile: GraphFile | undefined): ExportInfo[];

package/dist/core/fileInspectionGraph.js

@@ -0,0 +1,29 @@
+import { buildCodeGraph } from './codeGraph.js';
+import { mapExportType } from './fileExportTypes.js';
+import { loadCachedGraph, saveCachedGraph } from './indexCache.js';
+export async function resolveInspectionGraph(resolvedRoot, files, graph) {
+    if (graph)
+        return graph;
+    const cached = await loadCachedGraph(resolvedRoot);
+    const built = await buildCodeGraph(resolvedRoot, files, cached);
+    await saveCachedGraph(resolvedRoot, built);
+    return built;
+}
+export function importsFromGraphFile(graphFile) {
+    if (!graphFile)
+        return [];
+    return graphFile.imports.map((i) => ({
+        source: i.source,
+        specifiers: i.specifiers,
+        isRelative: i.source.startsWith('.') || i.source.startsWith('/'),
+    }));
+}
+export function exportsFromGraphFile(graphFile) {
+    if (!graphFile)
+        return [];
+    return graphFile.exports.map((e) => ({
+        name: e.name,
+        type: mapExportType(e.kind),
+    }));
+}
+//# sourceMappingURL=fileInspectionGraph.js.map

package/dist/core/fileInspectionGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileInspectionGraph.js","sourceRoot":"","sources":["../../src/core/fileInspectionGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkC,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,YAAoB,EACpB,KAAkB,EAClB,KAA4B;IAE5B,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAgC;IACnE,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;KACjE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAgC;IACnE,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/core/fileInspectionReport.d.ts

@@ -0,0 +1,13 @@
+import type { FileEntry, FileInspection, HotspotReport, Issue } from '../types.js';
+import type { ProjectFileRead } from './fileAccess.js';
+import type { CodeGraph } from './codeGraph.js';
+export interface InspectOptions {
+    scan?: {
+        files: FileEntry[];
+    };
+    issues?: Issue[];
+    hotspots?: HotspotReport;
+    /** If provided, prefer graph-derived imports/exports over regex parsing. */
+    graph?: CodeGraph;
+}
+export declare function inspectExistingProjectFile(file: ProjectFileRead, options?: InspectOptions): Promise<FileInspection>;

package/dist/core/fileInspectionReport.js

@@ -0,0 +1,49 @@
+import { scanRepository } from './repositoryScanner.js';
+import { collectIssues } from './issueEngine.js';
+import { analyzeHotspots } from './hotspotAnalyzer.js';
+import { getAdapterFor } from './languages/registry.js';
+import { exportsFromGraphFile, importsFromGraphFile, resolveInspectionGraph, } from './fileInspectionGraph.js';
+import { collectFileInspectionEvidence } from './fileInspectionEvidence.js';
+import { deriveFileGraphMetrics } from './fileGraphMetrics.js';
+import { detectFileIssues } from './fileIssues.js';
+import { inferPurpose } from './filePurpose.js';
+export async function inspectExistingProjectFile(file, options = {}) {
+    const { resolvedRoot, absolutePath, relativePath, content, sizeBytes } = file;
+    const lines = content.split('\n');
+    const adapter = getAdapterFor(relativePath);
+    const language = adapter?.id;
+    const files = options.scan?.files ?? (await scanRepository(resolvedRoot)).files;
+    const issues = options.issues ?? (await collectIssues(resolvedRoot, files));
+    const graph = await resolveInspectionGraph(resolvedRoot, files, options.graph);
+    const graphFile = graph.files.get(relativePath);
+    const imports = importsFromGraphFile(graphFile);
+    const exports = exportsFromGraphFile(graphFile);
+    const purpose = inferPurpose(absolutePath, exports);
+    const potentialIssues = detectFileIssues(content, lines.length);
+    const hotspotReport = options.hotspots ?? (await analyzeHotspots(resolvedRoot, files, issues, { limit: 100, graph }));
+    const relatedEvidence = collectFileInspectionEvidence({
+        files,
+        issues,
+        hotspots: hotspotReport,
+        relativePath,
+    });
+    const graphMetrics = deriveFileGraphMetrics(graph, relativePath);
+    return {
+        relativePath,
+        exists: true,
+        purpose,
+        lineCount: lines.length,
+        sizeBytes,
+        imports,
+        exports,
+        potentialIssues,
+        hotspot: relatedEvidence.hotspot,
+        issues: relatedEvidence.issues,
+        cyclomaticComplexity: graphMetrics.cyclomaticComplexity,
+        fanIn: graphMetrics.fanIn,
+        fanOut: graphMetrics.fanOut,
+        language,
+        functions: graphMetrics.functions,
+    };
+}
+//# sourceMappingURL=fileInspectionReport.js.map

package/dist/core/fileInspectionReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileInspectionReport.js","sourceRoot":"","sources":["../../src/core/fileInspectionReport.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAqB,EACrB,UAA0B,EAAE;IAE5B,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,EAAE,EAAE,CAAC;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAChF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEhE,MAAM,aAAa,GACjB,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,eAAe,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAElG,MAAM,eAAe,GAAG,6BAA6B,CAAC;QACpD,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,aAAa;QACvB,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAEjE,OAAO;QACL,YAAY;QACZ,MAAM,EAAE,IAAI;QACZ,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,SAAS;QACT,OAAO;QACP,OAAO;QACP,eAAe;QACf,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;QACvD,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,QAAQ;QACR,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC"}

package/dist/core/fileInspector.d.ts

@@ -1,15 +1,7 @@
-import type { ExportInfo, FileEntry, FileExplanation, FileInspection, HotspotReport, Issue } from '../types.js';
-import { type CodeGraph } from './codeGraph.js';
-export interface InspectOptions {
-    scan?: {
-        files: FileEntry[];
-    };
-    issues?: Issue[];
-    hotspots?: HotspotReport;
-    /** If provided, prefer graph-derived imports/exports over regex parsing. */
-    graph?: CodeGraph;
-}
+import type { FileExplanation, FileInspection } from '../types.js';
+import { type InspectOptions } from './fileInspectionReport.js';
+export { inferPurpose } from './filePurpose.js';
+export { detectFileIssues } from './fileIssues.js';
+export type { InspectOptions } from './fileInspectionReport.js';
 export declare function explainFile(rootPath: string, relOrAbsFile: string, options?: InspectOptions): Promise<FileExplanation>;
 export declare function inspectFile(rootPath: string, relOrAbsFile: string, options?: InspectOptions): Promise<FileInspection>;
-export declare function inferPurpose(filePath: string, exports: ExportInfo[]): string;
-export declare function detectFileIssues(content: string, lineCount: number): string[];

package/dist/core/fileInspector.js

@@ -1,11 +1,7 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { scanRepository } from './repositoryScanner.js';
-import { collectIssues } from './issueEngine.js';
-import { analyzeHotspots } from './hotspotAnalyzer.js';
-import { getAdapterFor } from './languages/registry.js';
-import { buildCodeGraph } from './codeGraph.js';
-import { loadCachedGraph, saveCachedGraph } from './indexCache.js';
+import { readProjectFile } from './fileAccess.js';
+import { inspectExistingProjectFile } from './fileInspectionReport.js';
+export { inferPurpose } from './filePurpose.js';
+export { detectFileIssues } from './fileIssues.js';
 export async function explainFile(rootPath, relOrAbsFile, options = {}) {
     const inspection = await inspectFile(rootPath, relOrAbsFile, options);
     if (!inspection.exists) {
@@ -21,157 +17,11 @@ export async function explainFile(rootPath, relOrAbsFile, options = {}) {
     };
 }
 export async function inspectFile(rootPath, relOrAbsFile, options = {}) {
-    // Reject absolute paths up-front. The MCP `projscan_file` tool's docs
-    // describe `path` as "relative to the project root", but the prior
-    // implementation silently honored absolute paths. Refusing them removes
-    // an attack vector where a hostile MCP client passes /etc/passwd directly.
-    if (path.isAbsolute(relOrAbsFile)) {
-        return makeEmpty(relOrAbsFile, 'Absolute paths are not accepted; pass a path relative to the project root.');
-    }
-    // Canonicalize BOTH the root and the target via realpath before the
-    // inside-root check. macOS's tmpdir lives at `/var/folders/...` which
-    // is itself a symlink to `/private/var/folders/...`; without canonical-
-    // izing the root, the resolved target's `/private/...` form would fail
-    // the prefix check. Realpath of the root fails ENOENT only if the user
-    // pointed at a non-existent root (caller error); fall back to the
-    // resolved-without-realpath form in that case so the user gets a clear
-    // downstream "File not found" error rather than a misleading "outside
-    // the project root".
-    const resolvedRoot = path.resolve(rootPath);
-    let canonicalRoot = resolvedRoot;
-    try {
-        canonicalRoot = await fs.realpath(resolvedRoot);
-    }
-    catch {
-        // root doesn't exist; use the unresolved form
-    }
-    const absolutePath = path.resolve(canonicalRoot, relOrAbsFile);
-    // Resolve symlinks on the target. Without this, a symlink under the repo
-    // (e.g. `cache/keys.pem` → `/etc/passwd`) passes the prefix check but
-    // reads attacker-chosen content. realpath collapses the symlink so the
-    // inside-root check sees the real target. ENOENT (path doesn't exist)
-    // → fall back to the unresolved path; downstream stat will surface the
-    // real error.
-    let realPath = absolutePath;
-    try {
-        realPath = await fs.realpath(absolutePath);
-    }
-    catch {
-        // missing path; use the unresolved form for the inside-root check.
-        // path.resolve already collapsed any '..' so we won't admit traversal.
-    }
-    if (!isInsideRoot(realPath, canonicalRoot)) {
-        return makeEmpty(relOrAbsFile, 'File is outside the project root');
-    }
-    let content;
-    let sizeBytes;
-    try {
-        const stat = await fs.stat(realPath);
-        if (!stat.isFile()) {
-            return makeEmpty(relOrAbsFile, 'Path is not a file');
-        }
-        sizeBytes = stat.size;
-        content = await fs.readFile(realPath, 'utf-8');
-    }
-    catch (err) {
-        const msg = err.code === 'ENOENT' ? 'File not found' : String(err);
-        return makeEmpty(relOrAbsFile, msg);
-    }
-    const relativePath = path.relative(canonicalRoot, absolutePath).split(path.sep).join('/');
-    const lines = content.split('\n');
-    const adapter = getAdapterFor(relativePath);
-    const language = adapter?.id;
-    const files = options.scan?.files ?? (await scanRepository(resolvedRoot)).files;
-    const issues = options.issues ?? (await collectIssues(resolvedRoot, files));
-    // Build the graph before deriving imports/exports. The removed regex
-    // extractors only understood JS/TS and emitted misleading metadata for
-    // other languages.
-    let graph = options.graph;
-    if (!graph) {
-        const cached = await loadCachedGraph(resolvedRoot);
-        graph = await buildCodeGraph(resolvedRoot, files, cached);
-        await saveCachedGraph(resolvedRoot, graph);
-    }
-    let imports = [];
-    let exports = [];
-    const graphFile = graph.files.get(relativePath);
-    if (graphFile) {
-        imports = graphFile.imports.map((i) => ({
-            source: i.source,
-            specifiers: i.specifiers,
-            isRelative: i.source.startsWith('.') || i.source.startsWith('/'),
-        }));
-        exports = graphFile.exports.map((e) => ({
-            name: e.name,
-            type: mapExportType(e.kind),
-        }));
-    }
-    const purpose = inferPurpose(absolutePath, exports);
-    const potentialIssues = detectFileIssues(content, lines.length);
-    const hotspotReport = options.hotspots ?? (await analyzeHotspots(resolvedRoot, files, issues, { limit: 100, graph }));
-    const hotspot = findHotspotForFile(hotspotReport, relativePath);
-    const relatedIssues = issues.filter((issue) => (issue.title + '\n' + issue.description).includes(relativePath));
-    // Coupling: fan-in is direct from the graph; fan-out scans localImporters
-    // for entries where this file is the importer. O(N) over local edges, fine
-    // for a single-file inspection.
-    let cyclomaticComplexity = null;
-    let fanIn = null;
-    let fanOut = null;
-    let functions;
-    const graphFileEntry = graph.files.get(relativePath);
-    if (graphFileEntry) {
-        cyclomaticComplexity = graphFileEntry.parseOk ? graphFileEntry.cyclomaticComplexity : null;
-        fanIn = graph.localImporters.get(relativePath)?.size ?? 0;
-        let fo = 0;
-        for (const importers of graph.localImporters.values()) {
-            if (importers.has(relativePath))
-                fo++;
-        }
-        fanOut = fo;
-        if (graphFileEntry.functions && graphFileEntry.functions.length > 0) {
-            functions = [...graphFileEntry.functions]
-                .sort((a, b) => b.cyclomaticComplexity - a.cyclomaticComplexity)
-                .map((f) => ({
-                name: f.name,
-                line: f.line,
-                endLine: f.endLine,
-                cyclomaticComplexity: f.cyclomaticComplexity,
-                fanIn: f.fanIn,
-            }));
-        }
-    }
-    return {
-        relativePath,
-        exists: true,
-        purpose,
-        lineCount: lines.length,
-        sizeBytes,
-        imports,
-        exports,
-        potentialIssues,
-        hotspot,
-        issues: relatedIssues,
-        cyclomaticComplexity,
-        fanIn,
-        fanOut,
-        language,
-        functions,
-    };
-}
-function mapExportType(kind) {
-    switch (kind) {
-        case 'function':
-        case 'class':
-        case 'variable':
-        case 'type':
-        case 'interface':
-        case 'default':
-            return kind;
-        case 'enum':
-            return 'type';
-        default:
-            return 'unknown';
+    const fileRead = await readProjectFile(rootPath, relOrAbsFile);
+    if (!fileRead.ok) {
+        return makeEmpty(fileRead.relativePath, fileRead.reason);
     }
+    return inspectExistingProjectFile(fileRead.file, options);
 }
 function makeEmpty(relativePath, reason) {
     return {
@@ -188,85 +38,4 @@ function makeEmpty(relativePath, reason) {
         issues: [],
     };
 }
-function isInsideRoot(absolutePath, resolvedRoot) {
-    return absolutePath === resolvedRoot || absolutePath.startsWith(resolvedRoot + path.sep);
-}
-function findHotspotForFile(report, relativePath) {
-    if (!report || !report.available)
-        return null;
-    return report.hotspots.find((h) => h.relativePath === relativePath) ?? null;
-}
-/**
- * Filename-keyword rules. Order matters — first match wins. Each pred
- * runs against the lowercase basename (without extension).
- */
-const NAME_RULES = [
-    { pred: (n) => n.includes('test') || n.includes('spec'), label: 'Test file' },
-    { pred: (n) => n.includes('config') || n.includes('rc'), label: 'Configuration file' },
-    { pred: (n) => n === 'index', label: 'Module entry point / barrel file' },
-    { pred: (n) => n === 'main' || n === 'app', label: 'Application entry point' },
-    { pred: (n) => n.includes('route') || n.includes('router'), label: 'Route definitions' },
-    { pred: (n) => n.includes('middleware'), label: 'Middleware handler' },
-    { pred: (n) => n.includes('controller'), label: 'Request controller' },
-    { pred: (n) => n.includes('service'), label: 'Service layer logic' },
-    {
-        pred: (n) => n.includes('model') || n.includes('schema'),
-        label: 'Data model / schema definition',
-    },
-    { pred: (n) => n.includes('util') || n.includes('helper'), label: 'Utility functions' },
-    { pred: (n) => n.includes('hook'), label: 'Custom hook' },
-    {
-        pred: (n) => n.includes('context') || n.includes('provider'),
-        label: 'Context / state provider',
-    },
-    { pred: (n) => n.includes('type') || n.includes('interface'), label: 'Type definitions' },
-    { pred: (n) => n.includes('constant'), label: 'Constants / configuration' },
-    { pred: (n) => n.includes('migration'), label: 'Database migration' },
-    { pred: (n) => n.includes('seed'), label: 'Database seed data' },
-    { pred: (n) => n.includes('auth'), label: 'Authentication logic' },
-    { pred: (n) => n.includes('api'), label: 'API endpoint handler' },
-];
-/** Directory-segment rules. Same first-match-wins semantics. */
-const DIR_RULES = [
-    { pred: (d) => d.includes('component') || d.includes('pages'), label: 'UI component' },
-    { pred: (d) => d.includes('service'), label: 'Service module' },
-    { pred: (d) => d.includes('model'), label: 'Data model' },
-    { pred: (d) => d.includes('util') || d.includes('lib'), label: 'Library / utility module' },
-];
-export function inferPurpose(filePath, exports) {
-    const name = path.basename(filePath, path.extname(filePath)).toLowerCase();
-    const dir = path.dirname(filePath).toLowerCase();
-    for (const rule of NAME_RULES)
-        if (rule.pred(name))
-            return rule.label;
-    for (const rule of DIR_RULES)
-        if (rule.pred(dir))
-            return rule.label;
-    return inferPurposeFromExports(exports);
-}
-function inferPurposeFromExports(exports) {
-    const exportTypes = exports.map((e) => e.type);
-    if (exportTypes.includes('class'))
-        return 'Class-based module';
-    if (exportTypes.filter((t) => t === 'function').length > 2)
-        return 'Function library';
-    return 'Source module';
-}
-export function detectFileIssues(content, lineCount) {
-    const issues = [];
-    if (lineCount > 500)
-        issues.push(`Large file (${lineCount} lines) - consider splitting`);
-    if (lineCount > 1000)
-        issues.push('Very large file - strongly consider refactoring');
-    if (/console\.(log|warn|error|debug)\s*\(/.test(content)) {
-        issues.push('Contains console.log statements - consider using a proper logger');
-    }
-    if (/TODO|FIXME|HACK|XXX/i.test(content)) {
-        issues.push('Contains TODO/FIXME comments');
-    }
-    if (/:\s*any\b/.test(content) && /\.tsx?$/.test(content)) {
-        issues.push('Uses "any" type - consider using proper types');
-    }
-    return issues;
-}
 //# sourceMappingURL=fileInspector.js.map

package/dist/core/fileInspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileInspector.js","sourceRoot":"","sources":["../../src/core/fileInspector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fileInspector.js","sourceRoot":"","sources":["../../src/core/fileInspector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAuB,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,YAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,YAAY;QACjC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe;QAC3C,SAAS,EAAE,UAAU,CAAC,SAAS;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,YAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,0BAA0B,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,SAAS,CAAC,YAAoB,EAAE,MAAc;IACrD,OAAO;QACL,YAAY;QACZ,MAAM,EAAE,KAAK;QACb,MAAM;QACN,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,EAAE;QACnB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

package/dist/core/fileIssues.d.ts

@@ -0,0 +1 @@
+export declare function detectFileIssues(content: string, lineCount: number): string[];

package/dist/core/fileIssues.js

@@ -0,0 +1,18 @@
+export function detectFileIssues(content, lineCount) {
+    const issues = [];
+    if (lineCount > 500)
+        issues.push(`Large file (${lineCount} lines) - consider splitting`);
+    if (lineCount > 1000)
+        issues.push('Very large file - strongly consider refactoring');
+    if (/console\.(log|warn|error|debug)\s*\(/.test(content)) {
+        issues.push('Contains console.log statements - consider using a proper logger');
+    }
+    if (/TODO|FIXME|HACK|XXX/i.test(content)) {
+        issues.push('Contains TODO/FIXME comments');
+    }
+    if (/:\s*any\b/.test(content) && /\.tsx?$/.test(content)) {
+        issues.push('Uses "any" type - consider using proper types');
+    }
+    return issues;
+}
+//# sourceMappingURL=fileIssues.js.map

package/dist/core/fileIssues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileIssues.js","sourceRoot":"","sources":["../../src/core/fileIssues.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,SAAiB;IACjE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,SAAS,GAAG,GAAG;QAAE,MAAM,CAAC,IAAI,CAAC,eAAe,SAAS,8BAA8B,CAAC,CAAC;IACzF,IAAI,SAAS,GAAG,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAErF,IAAI,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/filePurpose.d.ts

@@ -0,0 +1,2 @@
+import type { ExportInfo } from '../types.js';
+export declare function inferPurpose(filePath: string, exports: ExportInfo[]): string;

package/dist/core/filePurpose.js

@@ -0,0 +1,61 @@
+import path from 'node:path';
+/**
+ * Filename-keyword rules. Order matters: first match wins. Each predicate
+ * runs against the lowercase basename without extension.
+ */
+const NAME_RULES = [
+    { pred: isTestFileName, label: 'Test file' },
+    { pred: (name) => name.includes('config') || name.includes('rc'), label: 'Configuration file' },
+    { pred: (name) => name === 'index', label: 'Module entry point / barrel file' },
+    { pred: (name) => name === 'main' || name === 'app', label: 'Application entry point' },
+    { pred: (name) => name.includes('route') || name.includes('router'), label: 'Route definitions' },
+    { pred: (name) => name.includes('middleware'), label: 'Middleware handler' },
+    { pred: (name) => name.includes('controller'), label: 'Request controller' },
+    { pred: (name) => name.includes('service'), label: 'Service layer logic' },
+    {
+        pred: (name) => name.includes('model') || name.includes('schema'),
+        label: 'Data model / schema definition',
+    },
+    { pred: (name) => name.includes('util') || name.includes('helper'), label: 'Utility functions' },
+    { pred: (name) => name.includes('hook'), label: 'Custom hook' },
+    {
+        pred: (name) => name.includes('context') || name.includes('provider'),
+        label: 'Context / state provider',
+    },
+    { pred: (name) => name.includes('type') || name.includes('interface'), label: 'Type definitions' },
+    { pred: (name) => name.includes('constant'), label: 'Constants / configuration' },
+    { pred: (name) => name.includes('migration'), label: 'Database migration' },
+    { pred: (name) => name.includes('seed'), label: 'Database seed data' },
+    { pred: (name) => name.includes('auth'), label: 'Authentication logic' },
+    { pred: (name) => name.includes('api'), label: 'API endpoint handler' },
+];
+const TEST_NAME_TOKENS = new Set(['test', 'tests', 'spec', 'specs']);
+const DIR_RULES = [
+    { pred: (dir) => dir.includes('component') || dir.includes('pages'), label: 'UI component' },
+    { pred: (dir) => dir.includes('service'), label: 'Service module' },
+    { pred: (dir) => dir.includes('model'), label: 'Data model' },
+    { pred: (dir) => dir.includes('util') || dir.includes('lib'), label: 'Library / utility module' },
+];
+export function inferPurpose(filePath, exports) {
+    const name = path.basename(filePath, path.extname(filePath)).toLowerCase();
+    const dir = path.dirname(filePath).toLowerCase();
+    for (const rule of NAME_RULES)
+        if (rule.pred(name))
+            return rule.label;
+    for (const rule of DIR_RULES)
+        if (rule.pred(dir))
+            return rule.label;
+    return inferPurposeFromExports(exports);
+}
+function isTestFileName(name) {
+    return name.split(/[\W_]+/).some((part) => TEST_NAME_TOKENS.has(part));
+}
+function inferPurposeFromExports(exports) {
+    const exportTypes = exports.map((item) => item.type);
+    if (exportTypes.includes('class'))
+        return 'Class-based module';
+    if (exportTypes.filter((type) => type === 'function').length > 2)
+        return 'Function library';
+    return 'Source module';
+}
+//# sourceMappingURL=filePurpose.js.map

package/dist/core/filePurpose.js.map

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

package/dist/core/fixSuggest.d.ts

@@ -1,5 +1,6 @@
 import type { Issue, IssueLocation, FixSuggestion } from '../types.js';
 import type { ApplyPlan } from './applyFix.js';
+export { previewSuggestionForIssue } from './fixSuggestPreview.js';
 /**
  * Pick a template for the issue. Always returns a suggestion - the fallback
  * catches anything without a tailored template. Async because some templates
@@ -12,15 +13,6 @@ export declare function suggestFixForIssue(issue: Issue, rootPath: string): Prom
  * matching template declares apply support.
  */
 export declare function buildApplyPlanForIssue(issue: Issue, rootPath: string): Promise<ApplyPlan | null>;
-/**
- * Synchronous one-line preview for inline use in projscan_doctor output.
- * Returns the headline a template would render. We can't run the full
- * template synchronously (some are async-shaped); the headline is a
- * lightweight projection that doesn't need IO.
- */
-export declare function previewSuggestionForIssue(issue: Issue): {
-    summary: string;
-} | null;
 /**
  * Locate an issue in a doctor result by id. The MCP tool calls this to
  * resolve a fix-suggest request; the issue payload comes from