projscan 0.10.0 → 0.12.0

package/dist/mcp/tools/_shared.js

@@ -0,0 +1,82 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { extractImports, extractExports, inferPurpose, detectFileIssues, } from '../../core/fileInspector.js';
+import { detectWorkspaces } from '../../core/monorepo.js';
+/**
+ * A repo is "Python-dominated" if it has a pyproject.toml OR setup.py AND
+ * either no node_modules directory or no package.json.
+ */
+export async function isPythonDominated(rootPath, files) {
+    const hasPython = files.some((f) => f.extension === '.py' || f.extension === '.pyw');
+    if (!hasPython)
+        return false;
+    const manifests = ['pyproject.toml', 'setup.py', 'setup.cfg'];
+    let hasPyManifest = false;
+    for (const m of manifests) {
+        try {
+            await fs.access(path.join(rootPath, m));
+            hasPyManifest = true;
+            break;
+        }
+        catch {
+            // next
+        }
+    }
+    if (!hasPyManifest)
+        return false;
+    try {
+        await fs.access(path.join(rootPath, 'package.json'));
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Resolve the `package` arg to a (file -> boolean) filter, or null when
+ * scoping wasn't requested.
+ */
+export async function resolvePackageFilter(rootPath, args) {
+    const name = typeof args.package === 'string' && args.package.length > 0 ? args.package : null;
+    if (!name)
+        return null;
+    const ws = await detectWorkspaces(rootPath);
+    const pkg = ws.packages.find((p) => p.name === name);
+    if (!pkg)
+        return () => false;
+    if (pkg.isRoot)
+        return () => true;
+    const prefix = pkg.relativePath + '/';
+    return (file) => file === pkg.relativePath || file.startsWith(prefix);
+}
+export const PACKAGE_ARG_SCHEMA = {
+    type: 'string',
+    description: 'Optional. Workspace package name (from projscan_workspaces) to scope results to one package only.',
+};
+/** Walk a DirectoryNode tree to find the node whose `path` equals targetPath. */
+export function sliceTree(node, targetPath) {
+    if (node.path === targetPath)
+        return node;
+    for (const child of node.children) {
+        const hit = sliceTree(child, targetPath);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+export function explainFile(absolutePath, content, rootPath) {
+    const lines = content.split('\n');
+    const imports = extractImports(content);
+    const exports = extractExports(content);
+    const purpose = inferPurpose(absolutePath, exports);
+    const potentialIssues = detectFileIssues(content, lines.length);
+    return {
+        filePath: path.relative(rootPath, absolutePath),
+        purpose,
+        imports,
+        exports,
+        potentialIssues,
+        lineCount: lines.length,
+    };
+}
+//# sourceMappingURL=_shared.js.map

package/dist/mcp/tools/_shared.js.map

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

package/dist/mcp/tools/analyze.d.ts

@@ -0,0 +1,2 @@
+import { type McpTool } from './_shared.js';
+export declare const analyzeTool: McpTool;

package/dist/mcp/tools/analyze.js

@@ -0,0 +1,55 @@
+import path from 'node:path';
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { detectLanguages } from '../../core/languageDetector.js';
+import { detectFrameworks } from '../../core/frameworkDetector.js';
+import { analyzeDependencies } from '../../core/dependencyAnalyzer.js';
+import { collectIssues } from '../../core/issueEngine.js';
+import { calculateScore } from '../../utils/scoreCalculator.js';
+import { emitProgress } from '../progress.js';
+import { PACKAGE_ARG_SCHEMA, resolvePackageFilter } from './_shared.js';
+export const analyzeTool = {
+    name: 'projscan_analyze',
+    description: 'Run a full projscan analysis of the project: languages, frameworks, dependencies, issues, and health score. Use this to understand a codebase before making changes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: PACKAGE_ARG_SCHEMA,
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 5, 'scanning repository');
+        const scan = await scanRepository(rootPath);
+        emitProgress(1, 5, 'detecting languages + frameworks');
+        const languages = detectLanguages(scan.files);
+        const frameworks = await detectFrameworks(rootPath, scan.files);
+        emitProgress(2, 5, 'analyzing dependencies');
+        const dependencies = await analyzeDependencies(rootPath);
+        emitProgress(3, 5, 'running analyzers');
+        let issues = await collectIssues(rootPath, scan.files);
+        const passes = await resolvePackageFilter(rootPath, args);
+        if (passes) {
+            issues = issues.filter((i) => {
+                const locs = i.locations ?? [];
+                if (locs.length === 0)
+                    return false;
+                return locs.some((l) => l.file && passes(l.file));
+            });
+        }
+        emitProgress(4, 5, 'scoring');
+        const health = calculateScore(issues);
+        emitProgress(5, 5, 'done');
+        const report = {
+            projectName: path.basename(rootPath),
+            rootPath,
+            scan: { ...scan, files: [], directoryTree: scan.directoryTree },
+            languages,
+            frameworks,
+            dependencies,
+            issues,
+            timestamp: new Date().toISOString(),
+            health,
+        };
+        return report;
+    },
+};
+//# sourceMappingURL=analyze.js.map

package/dist/mcp/tools/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/mcp/tools/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAgB,MAAM,cAAc,CAAC;AAGtF,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,sKAAsK;IACxK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,kBAAkB;SAC5B;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,kCAAkC,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACzD,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxC,IAAI,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACpC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAE3B,MAAM,MAAM,GAA+C;YACzD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACpC,QAAQ;YACR,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE;YAC/D,SAAS;YACT,UAAU;YACV,YAAY;YACZ,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;SACP,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/mcp/tools/audit.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const auditTool: McpTool;

package/dist/mcp/tools/audit.js

@@ -0,0 +1,32 @@
+import { runAudit } from '../../core/auditRunner.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { emitProgress } from '../progress.js';
+export const auditTool = {
+    name: 'projscan_audit',
+    description: 'Run `npm audit` and return a normalized summary of vulnerabilities (critical / high / moderate / low / info). Requires package-lock.json. Supports cursor pagination on the findings array.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            cursor: { type: 'string', description: 'Opaque cursor from a previous response.' },
+            page_size: { type: 'number', description: 'Items per page (default 50).' },
+            max_tokens: { type: 'number', description: 'Cap response size.' },
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 2, 'running npm audit');
+        const report = await runAudit(rootPath);
+        if (!report.available)
+            return report;
+        emitProgress(1, 2, 'normalizing findings');
+        const page = paginate(report.findings, readPageParams(args), listChecksum(report.findings));
+        emitProgress(2, 2, 'done');
+        return {
+            available: true,
+            summary: report.summary,
+            findings: page.items,
+            total: page.total,
+            nextCursor: page.nextCursor,
+        };
+    },
+};
+//# sourceMappingURL=audit.js.map

package/dist/mcp/tools/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/mcp/tools/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,6LAA6L;IAC/L,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;YAClF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YAC1E,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;SAClE;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QACrC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5F,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,IAAI,CAAC,KAAK;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/coupling.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const couplingTool: McpTool;

package/dist/mcp/tools/coupling.js

@@ -0,0 +1,67 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { buildCodeGraph } from '../../core/codeGraph.js';
+import { loadCachedGraph, saveCachedGraph } from '../../core/indexCache.js';
+import { computeCoupling, filterCoupling } from '../../core/couplingAnalyzer.js';
+import { detectWorkspaces, filterFilesByPackage } from '../../core/monorepo.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { emitProgress } from '../progress.js';
+export const couplingTool = {
+    name: 'projscan_coupling',
+    description: 'Per-file coupling metrics (fan-in, fan-out, instability) and circular-import cycles, derived from the AST code graph. Use `direction` to focus the result: "all" returns every file sorted by fan-in; "high_fan_in" / "high_fan_out" sort accordingly; "cycles_only" returns just the files participating in import cycles. Cycles are reported separately as strongly-connected components of size >= 2.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: {
+                type: 'string',
+                description: "Optional. When set, the response includes only this file's coupling row (cycles list still returned in full).",
+            },
+            direction: {
+                type: 'string',
+                description: 'Filter/sort applied to `files`. Default "all".',
+                enum: ['all', 'high_fan_in', 'high_fan_out', 'cycles_only'],
+            },
+            limit: { type: 'number', description: 'Max file rows returned (default 25, max 500).' },
+            max_tokens: { type: 'number', description: 'Cap the response to roughly this many tokens.' },
+            package: {
+                type: 'string',
+                description: 'Optional. Workspace package name (from projscan_workspaces) to scope coupling rows to one package only.',
+            },
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 3, 'building code graph');
+        const scan = await scanRepository(rootPath);
+        const cached = await loadCachedGraph(rootPath);
+        const graph = await buildCodeGraph(rootPath, scan.files, cached);
+        await saveCachedGraph(rootPath, graph);
+        emitProgress(1, 3, 'computing coupling + cycles');
+        const ws = await detectWorkspaces(rootPath);
+        const report = computeCoupling(graph, ws);
+        const direction = (typeof args.direction === 'string' ? args.direction : 'all');
+        const limit = Math.max(1, Math.min(500, typeof args.limit === 'number' ? args.limit : 25));
+        const file = typeof args.file === 'string' ? args.file : undefined;
+        let files = filterCoupling(report, direction);
+        if (file)
+            files = files.filter((f) => f.relativePath === file);
+        if (typeof args.package === 'string' && args.package.length > 0) {
+            const ws2 = await detectWorkspaces(rootPath);
+            const allowed = new Set(filterFilesByPackage(ws2, args.package, files.map((f) => f.relativePath)));
+            files = files.filter((f) => allowed.has(f.relativePath));
+        }
+        files = files.slice(0, limit);
+        emitProgress(2, 3, 'paginating');
+        const page = paginate(files, readPageParams(args), listChecksum(files));
+        emitProgress(3, 3, 'done');
+        return {
+            files: page.items,
+            cycles: report.cycles,
+            crossPackageEdges: report.crossPackageEdges,
+            totalFiles: report.totalFiles,
+            totalCycles: report.totalCycles,
+            totalCrossPackageEdges: report.totalCrossPackageEdges,
+            nextCursor: page.nextCursor,
+            total: page.total,
+        };
+    },
+};
+//# sourceMappingURL=coupling.js.map

package/dist/mcp/tools/coupling.js.map

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

package/dist/mcp/tools/coverage.d.ts

@@ -0,0 +1,2 @@
+import { type McpTool } from './_shared.js';
+export declare const coverageTool: McpTool;

package/dist/mcp/tools/coverage.js

@@ -0,0 +1,53 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { collectIssues } from '../../core/issueEngine.js';
+import { analyzeHotspots } from '../../core/hotspotAnalyzer.js';
+import { parseCoverage, coverageMap } from '../../core/coverageParser.js';
+import { joinCoverageWithHotspots } from '../../core/coverageJoin.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { PACKAGE_ARG_SCHEMA, resolvePackageFilter } from './_shared.js';
+export const coverageTool = {
+    name: 'projscan_coverage',
+    description: 'Join test coverage with hotspot risk. Returns files ranked by "risk × uncovered fraction" - the scariest untested files. Requires a coverage file at coverage/lcov.info, coverage/coverage-final.json, or coverage/coverage-summary.json.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'How many entries to return (default: 30, max: 200).',
+            },
+            max_tokens: {
+                type: 'number',
+                description: 'Cap the response size to roughly this many tokens (~4 chars/token). Truncates the entries array to fit.',
+            },
+            package: PACKAGE_ARG_SCHEMA,
+        },
+    },
+    handler: async (args, rootPath) => {
+        const coverage = await parseCoverage(rootPath);
+        const scan = await scanRepository(rootPath);
+        const issues = await collectIssues(rootPath, scan.files);
+        const rawLimit = typeof args.limit === 'number' ? args.limit : 200;
+        const limit = Math.max(1, Math.min(500, rawLimit));
+        const hotspots = await analyzeHotspots(rootPath, scan.files, issues, {
+            limit,
+            coverage: coverage.available ? coverageMap(coverage) : undefined,
+        });
+        const joined = joinCoverageWithHotspots(hotspots, coverage);
+        if (!joined.available)
+            return joined;
+        const passes = await resolvePackageFilter(rootPath, args);
+        const filteredEntries = passes
+            ? joined.entries.filter((e) => passes(e.relativePath))
+            : joined.entries;
+        const page = paginate(filteredEntries, readPageParams(args), listChecksum(filteredEntries));
+        return {
+            available: true,
+            coverageSource: joined.coverageSource,
+            coverageSourceFile: joined.coverageSourceFile,
+            entries: page.items,
+            total: page.total,
+            nextCursor: page.nextCursor,
+        };
+    },
+};
+//# sourceMappingURL=coverage.js.map

package/dist/mcp/tools/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../../src/mcp/tools/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAgB,MAAM,cAAc,CAAC;AAEtF,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,2OAA2O;IAC7O,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yGAAyG;aACvH;YACD,OAAO,EAAE,kBAAkB;SAC5B;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE;YACnE,KAAK;YACL,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,MAAM;YAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YACtD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC;QAC5F,OAAO;YACL,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/dependencies.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const dependenciesTool: McpTool;

package/dist/mcp/tools/dependencies.js

@@ -0,0 +1,16 @@
+import { analyzeDependencies } from '../../core/dependencyAnalyzer.js';
+export const dependenciesTool = {
+    name: 'projscan_dependencies',
+    description: 'Analyze package.json dependencies and return counts and risks (deprecated packages, wildcard versions, etc.).',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    handler: async (_args, rootPath) => {
+        const report = await analyzeDependencies(rootPath);
+        if (!report)
+            return { available: false, reason: 'No package.json found' };
+        return { available: true, ...report };
+    },
+};
+//# sourceMappingURL=dependencies.js.map

package/dist/mcp/tools/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/mcp/tools/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,+GAA+G;IAC5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QAC1E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACxC,CAAC;CACF,CAAC"}

package/dist/mcp/tools/doctor.d.ts

@@ -0,0 +1,2 @@
+import { type McpTool } from './_shared.js';
+export declare const doctorTool: McpTool;

package/dist/mcp/tools/doctor.js

@@ -0,0 +1,30 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { collectIssues } from '../../core/issueEngine.js';
+import { calculateScore } from '../../utils/scoreCalculator.js';
+import { PACKAGE_ARG_SCHEMA, resolvePackageFilter } from './_shared.js';
+export const doctorTool = {
+    name: 'projscan_doctor',
+    description: 'Run a health check on the project. Returns a 0-100 score, letter grade, and the list of issues (linting, formatting, tests, security, architecture).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: PACKAGE_ARG_SCHEMA,
+        },
+    },
+    handler: async (args, rootPath) => {
+        const scan = await scanRepository(rootPath);
+        let issues = await collectIssues(rootPath, scan.files);
+        const passes = await resolvePackageFilter(rootPath, args);
+        if (passes) {
+            issues = issues.filter((i) => {
+                const locs = i.locations ?? [];
+                if (locs.length === 0)
+                    return false;
+                return locs.some((l) => l.file && passes(l.file));
+            });
+        }
+        const health = calculateScore(issues);
+        return { health, issues };
+    },
+};
+//# sourceMappingURL=doctor.js.map

package/dist/mcp/tools/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/mcp/tools/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAgB,MAAM,cAAc,CAAC;AAEtF,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,sJAAsJ;IACxJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,kBAAkB;SAC5B;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACpC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF,CAAC"}

package/dist/mcp/tools/explain.d.ts

@@ -0,0 +1,2 @@
+import { type McpTool } from './_shared.js';
+export declare const explainTool: McpTool;

package/dist/mcp/tools/explain.js

@@ -0,0 +1,30 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { explainFile } from './_shared.js';
+export const explainTool = {
+    name: 'projscan_explain',
+    description: 'Explain a single file: purpose, imports, exports, and potential issues. Useful for understanding unfamiliar code before editing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: {
+                type: 'string',
+                description: 'Path to the file relative to the project root.',
+            },
+        },
+        required: ['file'],
+    },
+    handler: async (args, rootPath) => {
+        const rel = typeof args.file === 'string' ? args.file : '';
+        if (!rel)
+            throw new Error('file argument is required');
+        const absolutePath = path.resolve(rootPath, rel);
+        const resolvedRoot = path.resolve(rootPath);
+        if (!absolutePath.startsWith(resolvedRoot + path.sep) && absolutePath !== resolvedRoot) {
+            throw new Error('file must be inside the project root');
+        }
+        const content = await fs.readFile(absolutePath, 'utf-8');
+        return explainFile(absolutePath, content, rootPath);
+    },
+};
+//# sourceMappingURL=explain.js.map

package/dist/mcp/tools/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/mcp/tools/explain.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,kIAAkI;IACpI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,WAAW,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;CACF,CAAC"}

package/dist/mcp/tools/file.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const fileTool: McpTool;

package/dist/mcp/tools/file.js

@@ -0,0 +1,22 @@
+import { inspectFile } from '../../core/fileInspector.js';
+export const fileTool = {
+    name: 'projscan_file',
+    description: 'Drill into a single file: purpose, imports, exports, churn/risk/ownership, related health issues, AST cyclomatic complexity, and coupling (fan-in / fan-out). Use this after projscan_hotspots when deciding how to approach a specific risky file.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: {
+                type: 'string',
+                description: 'Path to the file relative to the project root.',
+            },
+        },
+        required: ['file'],
+    },
+    handler: async (args, rootPath) => {
+        const rel = typeof args.file === 'string' ? args.file : '';
+        if (!rel)
+            throw new Error('file argument is required');
+        return await inspectFile(rootPath, rel);
+    },
+};
+//# sourceMappingURL=file.js.map

package/dist/mcp/tools/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/mcp/tools/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,qPAAqP;IACvP,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACvD,OAAO,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC"}

package/dist/mcp/tools/graph.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const graphTool: McpTool;

package/dist/mcp/tools/graph.js

@@ -0,0 +1,69 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { buildCodeGraph, filesImportingFile, filesImportingPackage, filesDefiningSymbol, exportsOf, importsOf, } from '../../core/codeGraph.js';
+import { loadCachedGraph, saveCachedGraph } from '../../core/indexCache.js';
+export const graphTool = {
+    name: 'projscan_graph',
+    description: 'Query the AST-based code graph directly. Returns imports, exports, importers, or symbol definitions for a file or symbol. Agents should prefer this over analyze/doctor/explain for targeted structural questions - it is much cheaper and more accurate.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: {
+                type: 'string',
+                description: 'File path (relative to project root) to query.',
+            },
+            symbol: {
+                type: 'string',
+                description: 'Symbol name to query (e.g. a function or class). Use instead of `file` to find where a symbol is defined.',
+            },
+            direction: {
+                type: 'string',
+                description: 'What to return: "imports" (what the file imports), "exports" (what the file exports), "importers" (who imports the file), "symbol_defs" (files defining the symbol), "package_importers" (files importing a package by name).',
+                enum: ['imports', 'exports', 'importers', 'symbol_defs', 'package_importers'],
+            },
+            limit: { type: 'number', description: 'Max entries returned (default 50).' },
+            max_tokens: { type: 'number', description: 'Cap the response to roughly this many tokens.' },
+        },
+        required: ['direction'],
+    },
+    handler: async (args, rootPath) => {
+        const scan = await scanRepository(rootPath);
+        const cached = await loadCachedGraph(rootPath);
+        const graph = await buildCodeGraph(rootPath, scan.files, cached);
+        await saveCachedGraph(rootPath, graph);
+        const direction = String(args.direction);
+        const file = typeof args.file === 'string' ? args.file : undefined;
+        const symbol = typeof args.symbol === 'string' ? args.symbol : undefined;
+        const limit = Math.max(1, Math.min(500, typeof args.limit === 'number' ? args.limit : 50));
+        switch (direction) {
+            case 'imports': {
+                if (!file)
+                    throw new Error('file argument is required for direction=imports');
+                return { file, imports: importsOf(graph, file).slice(0, limit) };
+            }
+            case 'exports': {
+                if (!file)
+                    throw new Error('file argument is required for direction=exports');
+                return { file, exports: exportsOf(graph, file).slice(0, limit) };
+            }
+            case 'importers': {
+                if (!file)
+                    throw new Error('file argument is required for direction=importers');
+                return { file, importers: filesImportingFile(graph, file).slice(0, limit) };
+            }
+            case 'symbol_defs': {
+                if (!symbol)
+                    throw new Error('symbol argument is required for direction=symbol_defs');
+                return { symbol, definedIn: filesDefiningSymbol(graph, symbol).slice(0, limit) };
+            }
+            case 'package_importers': {
+                const pkg = symbol ?? file;
+                if (!pkg)
+                    throw new Error('symbol (or file) argument is required for direction=package_importers');
+                return { package: pkg, importers: filesImportingPackage(graph, pkg).slice(0, limit) };
+            }
+            default:
+                throw new Error(`unknown direction: ${direction}`);
+        }
+    },
+};
+//# sourceMappingURL=graph.js.map

package/dist/mcp/tools/graph.js.map

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

package/dist/mcp/tools/hotspots.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const hotspotsTool: McpTool;

package/dist/mcp/tools/hotspots.js

@@ -0,0 +1,64 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { collectIssues } from '../../core/issueEngine.js';
+import { analyzeHotspots } from '../../core/hotspotAnalyzer.js';
+import { buildCodeGraph } from '../../core/codeGraph.js';
+import { loadCachedGraph, saveCachedGraph } from '../../core/indexCache.js';
+import { detectWorkspaces, filterFilesByPackage } from '../../core/monorepo.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { emitProgress } from '../progress.js';
+export const hotspotsTool = {
+    name: 'projscan_hotspots',
+    description: 'Rank files by risk using git churn × AST cyclomatic complexity × open issues. Returns the most dangerous files to touch. Each hotspot includes `cyclomaticComplexity` (null for non-AST languages, where line count is used as fallback). Supports cursor-based pagination: pass the `nextCursor` from a previous response back as `cursor` to fetch the next page.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'Cap on total hotspots ranked (default 100). For paging the returned set, use `page_size` + `cursor` instead.',
+            },
+            since: {
+                type: 'string',
+                description: 'Git history window. Examples: "12 months ago", "2024-01-01". Default: "12 months ago".',
+            },
+            cursor: { type: 'string', description: 'Opaque cursor from a previous response. Omit for the first page.' },
+            page_size: { type: 'number', description: 'Items per page (default 50, max 500).' },
+            max_tokens: { type: 'number', description: 'Cap response to roughly this many tokens.' },
+            package: {
+                type: 'string',
+                description: 'Optional. Workspace package name (from projscan_workspaces) to scope hotspots to one package only.',
+            },
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 5, 'scanning repository');
+        const scan = await scanRepository(rootPath);
+        emitProgress(1, 5, 'collecting issues');
+        const issues = await collectIssues(rootPath, scan.files);
+        const limit = typeof args.limit === 'number' ? args.limit : 100;
+        const since = typeof args.since === 'string' ? args.since : undefined;
+        emitProgress(2, 5, 'building code graph');
+        const cached = await loadCachedGraph(rootPath);
+        const graph = await buildCodeGraph(rootPath, scan.files, cached);
+        await saveCachedGraph(rootPath, graph);
+        emitProgress(3, 5, 'analyzing git churn + risk');
+        const report = await analyzeHotspots(rootPath, scan.files, issues, { limit, since, graph });
+        if (typeof args.package === 'string' && args.package.length > 0) {
+            const ws = await detectWorkspaces(rootPath);
+            const allowed = new Set(filterFilesByPackage(ws, args.package, report.hotspots.map((h) => h.relativePath)));
+            report.hotspots = report.hotspots.filter((h) => allowed.has(h.relativePath));
+        }
+        emitProgress(4, 5, 'paginating');
+        const page = paginate(report.hotspots, readPageParams(args), listChecksum(report.hotspots));
+        emitProgress(5, 5, 'done');
+        return {
+            available: report.available,
+            reason: report.reason,
+            window: report.window,
+            hotspots: page.items,
+            totalFilesRanked: report.totalFilesRanked,
+            nextCursor: page.nextCursor,
+            total: page.total,
+        };
+    },
+};
+//# sourceMappingURL=hotspots.js.map