projscan 0.1.11 → 0.2.0

package/dist/mcp/server.js

@@ -0,0 +1,205 @@
+import readline from 'node:readline';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getToolDefinitions, getToolHandler } from './tools.js';
+import { getPromptDefinitions, getPrompt } from './prompts.js';
+import { getResourceDefinitions, readResource } from './resources.js';
+const PROTOCOL_VERSION = '2024-11-05';
+const JSONRPC_ERROR = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+};
+function readPackageVersion() {
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '../../package.json'), 'utf-8'));
+        return String(pkg.version ?? '0.0.0');
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+export function createMcpServer(rootPath) {
+    const serverVersion = readPackageVersion();
+    let initialized = false;
+    async function dispatch(request) {
+        const id = request.id ?? null;
+        // Notifications (no id) — no response expected.
+        const isNotification = request.id === undefined || request.id === null;
+        try {
+            switch (request.method) {
+                case 'initialize': {
+                    const params = (request.params ?? {});
+                    initialized = true;
+                    return ok(id, {
+                        protocolVersion: params.protocolVersion ?? PROTOCOL_VERSION,
+                        serverInfo: {
+                            name: 'projscan',
+                            version: serverVersion,
+                        },
+                        capabilities: {
+                            tools: {},
+                            prompts: {},
+                            resources: {},
+                        },
+                    });
+                }
+                case 'notifications/initialized':
+                case 'initialized':
+                    return null;
+                case 'ping':
+                    return ok(id, {});
+                case 'shutdown':
+                    return ok(id, null);
+                case 'tools/list': {
+                    return ok(id, { tools: getToolDefinitions() });
+                }
+                case 'tools/call': {
+                    const params = (request.params ?? {});
+                    const name = params.name;
+                    if (!name) {
+                        return fail(id, JSONRPC_ERROR.InvalidParams, 'Missing tool name');
+                    }
+                    const handler = getToolHandler(name);
+                    if (!handler) {
+                        return fail(id, JSONRPC_ERROR.MethodNotFound, `Unknown tool: ${name}`);
+                    }
+                    try {
+                        const result = await handler(params.arguments ?? {}, rootPath);
+                        return ok(id, {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: safeStringify(result),
+                                },
+                            ],
+                            isError: false,
+                        });
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return ok(id, {
+                            content: [{ type: 'text', text: `Error: ${message}` }],
+                            isError: true,
+                        });
+                    }
+                }
+                case 'prompts/list': {
+                    return ok(id, { prompts: getPromptDefinitions() });
+                }
+                case 'prompts/get': {
+                    const params = (request.params ?? {});
+                    if (!params.name) {
+                        return fail(id, JSONRPC_ERROR.InvalidParams, 'Missing prompt name');
+                    }
+                    try {
+                        const result = await getPrompt(params.name, params.arguments ?? {}, rootPath);
+                        return ok(id, result);
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return fail(id, JSONRPC_ERROR.InvalidParams, message);
+                    }
+                }
+                case 'resources/list': {
+                    return ok(id, { resources: getResourceDefinitions() });
+                }
+                case 'resources/read': {
+                    const params = (request.params ?? {});
+                    if (!params.uri) {
+                        return fail(id, JSONRPC_ERROR.InvalidParams, 'Missing resource uri');
+                    }
+                    try {
+                        const content = await readResource(params.uri, rootPath);
+                        return ok(id, { contents: [content] });
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return fail(id, JSONRPC_ERROR.InvalidParams, message);
+                    }
+                }
+                default:
+                    if (isNotification)
+                        return null;
+                    return fail(id, JSONRPC_ERROR.MethodNotFound, `Method not found: ${request.method}`);
+            }
+        }
+        catch (err) {
+            if (isNotification)
+                return null;
+            const message = err instanceof Error ? err.message : String(err);
+            return fail(id, JSONRPC_ERROR.InternalError, message);
+        }
+        finally {
+            void initialized;
+        }
+    }
+    async function handleMessage(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return null;
+        let request;
+        try {
+            request = JSON.parse(trimmed);
+        }
+        catch {
+            return JSON.stringify(fail(null, JSONRPC_ERROR.ParseError, 'Invalid JSON'));
+        }
+        if (!request || typeof request !== 'object' || request.jsonrpc !== '2.0' || typeof request.method !== 'string') {
+            return JSON.stringify(fail(request?.id ?? null, JSONRPC_ERROR.InvalidRequest, 'Invalid JSON-RPC request'));
+        }
+        const response = await dispatch(request);
+        if (!response)
+            return null;
+        return JSON.stringify(response);
+    }
+    return { handleMessage };
+}
+function ok(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+function fail(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: { code, message, data },
+    };
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+export async function runMcpServer(rootPath) {
+    const server = createMcpServer(rootPath);
+    process.stderr.write(`[projscan-mcp] listening on stdio (root=${rootPath})\n`);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        crlfDelay: Infinity,
+    });
+    rl.on('line', (line) => {
+        server
+            .handleMessage(line)
+            .then((response) => {
+            if (response !== null) {
+                process.stdout.write(response + '\n');
+            }
+        })
+            .catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[projscan-mcp] error: ${message}\n`);
+        });
+    });
+    await new Promise((resolve) => {
+        rl.on('close', resolve);
+        process.stdin.on('end', resolve);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,9 @@
+import type { McpToolDefinition } from '../types.js';
+export interface McpToolHandler {
+    (args: Record<string, unknown>, rootPath: string): Promise<unknown>;
+}
+export interface McpTool extends McpToolDefinition {
+    handler: McpToolHandler;
+}
+export declare function getToolDefinitions(): McpToolDefinition[];
+export declare function getToolHandler(name: string): McpToolHandler | undefined;

package/dist/mcp/tools.js

@@ -0,0 +1,176 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+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 { analyzeHotspots } from '../core/hotspotAnalyzer.js';
+import { inspectFile, extractImports, extractExports, inferPurpose, detectFileIssues, } from '../core/fileInspector.js';
+import { calculateScore } from '../utils/scoreCalculator.js';
+const tools = [
+    {
+        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: {},
+        },
+        handler: async (_args, rootPath) => {
+            const scan = await scanRepository(rootPath);
+            const languages = detectLanguages(scan.files);
+            const frameworks = await detectFrameworks(rootPath, scan.files);
+            const dependencies = await analyzeDependencies(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const health = calculateScore(issues);
+            const report = {
+                projectName: path.basename(rootPath),
+                rootPath,
+                scan: { ...scan, files: [], directoryTree: scan.directoryTree },
+                languages,
+                frameworks,
+                dependencies,
+                issues,
+                timestamp: new Date().toISOString(),
+                health,
+            };
+            return report;
+        },
+    },
+    {
+        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: {},
+        },
+        handler: async (_args, rootPath) => {
+            const scan = await scanRepository(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const health = calculateScore(issues);
+            return {
+                health,
+                issues,
+            };
+        },
+    },
+    {
+        name: 'projscan_hotspots',
+        description: 'Rank files by risk using git churn × complexity × open issues. Returns the most dangerous files to touch. Use this to decide where to focus refactoring, testing, or review effort.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'How many hotspots to return (default: 10, max: 100).',
+                },
+                since: {
+                    type: 'string',
+                    description: 'Git history window. Examples: "12 months ago", "2024-01-01". Default: "12 months ago".',
+                },
+            },
+        },
+        handler: async (args, rootPath) => {
+            const scan = await scanRepository(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const limit = typeof args.limit === 'number' ? args.limit : undefined;
+            const since = typeof args.since === 'string' ? args.since : undefined;
+            return await analyzeHotspots(rootPath, scan.files, issues, { limit, since });
+        },
+    },
+    {
+        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);
+        },
+    },
+    {
+        name: 'projscan_file',
+        description: 'Drill into a single file: purpose, imports, exports, AND its churn/risk/ownership plus any related health issues. 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);
+        },
+    },
+    {
+        name: 'projscan_structure',
+        description: 'Return the project directory tree with file counts.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: async (_args, rootPath) => {
+            const scan = await scanRepository(rootPath);
+            return { structure: scan.directoryTree, totalFiles: scan.totalFiles };
+        },
+    },
+    {
+        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 };
+        },
+    },
+];
+export function getToolDefinitions() {
+    return tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema }));
+}
+export function getToolHandler(name) {
+    return tools.find((t) => t.name === name)?.handler;
+}
+// ── File Explanation (used by projscan_explain) ──────────
+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=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/reporters/consoleReporter.d.ts

@@ -1,4 +1,4 @@
-import type { AnalysisReport, Issue, Fix, FixResult, FileExplanation, ArchitectureLayer, DirectoryNode, DependencyReport, DiffResult } from '../types.js';
+import type { AnalysisReport, Issue, Fix, FixResult, FileExplanation, FileInspection, ArchitectureLayer, DirectoryNode, DependencyReport, DiffResult, HotspotReport } from '../types.js';
 export declare function reportAnalysis(report: AnalysisReport): void;
 export declare function reportHealth(issues: Issue[], scanTimeMs?: number): void;
 export declare function reportCi(issues: Issue[], threshold: number): void;
@@ -9,3 +9,5 @@ export declare function reportExplanation(explanation: FileExplanation): void;
 export declare function reportDiagram(layers: ArchitectureLayer[]): void;
 export declare function reportStructure(tree: DirectoryNode, projectName?: string): void;
 export declare function reportDependencies(report: DependencyReport): void;
+export declare function reportHotspots(report: HotspotReport): void;
+export declare function reportFileInspection(insp: FileInspection): void;

package/dist/reporters/consoleReporter.js

@@ -156,6 +156,37 @@ export function reportDiff(diff) {
     if (diff.resolvedIssues.length === 0 && diff.newIssues.length === 0) {
         console.log(`\n  ${chalk.dim('No change in issues.')}`);
     }
+    if (diff.hotspotDiff) {
+        const hd = diff.hotspotDiff;
+        const total = hd.rose.length + hd.fell.length + hd.appeared.length + hd.resolved.length;
+        if (total > 0) {
+            console.log(header('Hotspot Changes'));
+            if (hd.rose.length > 0) {
+                console.log(`\n  ${chalk.red('▲')} Worsening (${hd.rose.length}):`);
+                for (const delta of hd.rose.slice(0, 10)) {
+                    console.log(`    ${chalk.red('+' + delta.scoreDelta.toFixed(1))}  ${delta.relativePath}  ${chalk.dim(`${delta.beforeScore?.toFixed(1)} → ${delta.afterScore?.toFixed(1)}`)}`);
+                }
+            }
+            if (hd.appeared.length > 0) {
+                console.log(`\n  ${chalk.yellow('●')} Newly risky (${hd.appeared.length}):`);
+                for (const delta of hd.appeared.slice(0, 10)) {
+                    console.log(`    ${chalk.yellow(delta.afterScore?.toFixed(1) ?? '?')}  ${delta.relativePath}`);
+                }
+            }
+            if (hd.fell.length > 0) {
+                console.log(`\n  ${chalk.green('▼')} Improving (${hd.fell.length}):`);
+                for (const delta of hd.fell.slice(0, 10)) {
+                    console.log(`    ${chalk.green(delta.scoreDelta.toFixed(1))}  ${delta.relativePath}  ${chalk.dim(`${delta.beforeScore?.toFixed(1)} → ${delta.afterScore?.toFixed(1)}`)}`);
+                }
+            }
+            if (hd.resolved.length > 0) {
+                console.log(`\n  ${chalk.green('✓')} No longer tracked (${hd.resolved.length}):`);
+                for (const delta of hd.resolved.slice(0, 5)) {
+                    console.log(`    ${chalk.green('—')}  ${delta.relativePath}`);
+                }
+            }
+        }
+    }
     console.log(`\n  Baseline: ${chalk.dim(diff.before.timestamp)}`);
     console.log('');
 }
@@ -279,4 +310,100 @@ export function reportDependencies(report) {
     }
     console.log('');
 }
+// ── Report: hotspots ──────────────────────────────────────
+export function reportHotspots(report) {
+    console.log(header('Project Hotspots'));
+    if (!report.available) {
+        console.log(`\n  ${chalk.yellow('⚠')} ${report.reason ?? 'Hotspot analysis unavailable.'}\n`);
+        return;
+    }
+    if (report.hotspots.length === 0) {
+        console.log(`\n  ${chalk.green('✓')} No hotspots detected.`);
+        console.log(chalk.dim(`  Scanned ${report.window.commitsScanned} commit${report.window.commitsScanned === 1 ? '' : 's'} since ${report.window.since}.\n`));
+        return;
+    }
+    console.log(chalk.dim(`\n  ${report.window.commitsScanned} commit${report.window.commitsScanned === 1 ? '' : 's'} since ${report.window.since} · ${report.totalFilesRanked} file${report.totalFilesRanked === 1 ? '' : 's'} ranked\n`));
+    const maxScore = report.hotspots[0]?.riskScore ?? 1;
+    for (let i = 0; i < report.hotspots.length; i++) {
+        const h = report.hotspots[i];
+        const rank = chalk.bold(String(i + 1).padStart(2, ' ') + '.');
+        const scoreLabel = chalk.bold(h.riskScore.toFixed(1).padStart(5, ' '));
+        const barPct = Math.min(100, Math.round((h.riskScore / maxScore) * 100));
+        console.log(`  ${rank} ${scoreLabel}  ${bar(barPct, 14)}  ${chalk.cyan(h.relativePath)}`);
+        const reasonStr = h.reasons.length > 0 ? h.reasons.join(', ') : 'ranked by risk';
+        console.log(`       ${chalk.dim(reasonStr)}`);
+    }
+    console.log(chalk.dim(`\n  Tip: run ${chalk.bold.cyan('projscan file <file>')} to drill into a hotspot.\n`));
+}
+// ── Report: file (drill-down) ─────────────────────────────
+export function reportFileInspection(insp) {
+    console.log(header('File Report'));
+    if (!insp.exists) {
+        console.log(`\n  ${chalk.red('✗')} ${insp.reason ?? 'File unavailable.'}\n`);
+        return;
+    }
+    console.log(`\n  ${chalk.bold('File:')}     ${insp.relativePath}`);
+    console.log(`  ${chalk.bold('Purpose:')}  ${insp.purpose}`);
+    console.log(`  ${chalk.bold('Lines:')}    ${insp.lineCount}`);
+    console.log(`  ${chalk.bold('Size:')}     ${formatSize(insp.sizeBytes)}`);
+    if (insp.hotspot) {
+        const h = insp.hotspot;
+        console.log(header('Risk'));
+        console.log(`  ${chalk.bold('Risk Score:')}  ${chalk.bold(h.riskScore.toFixed(1))}`);
+        console.log(`  ${chalk.bold('Commits:')}     ${h.churn}`);
+        console.log(`  ${chalk.bold('Authors:')}     ${h.distinctAuthors}${h.primaryAuthor ? ` (primary: ${formatAuthorEmail(h.primaryAuthor)}, ${Math.round(h.primaryAuthorShare * 100)}%)` : ''}`);
+        if (h.daysSinceLastChange !== null) {
+            console.log(`  ${chalk.bold('Last change:')} ${h.daysSinceLastChange} days ago`);
+        }
+        if (h.busFactorOne) {
+            console.log(`  ${chalk.red('⚠')} Bus factor 1 — only one author has touched this.`);
+        }
+        if (h.reasons.length > 0) {
+            console.log(`  ${chalk.dim(h.reasons.join(', '))}`);
+        }
+    }
+    else {
+        console.log(chalk.dim('\n  No hotspot data (file is untouched in git window or outside analysis scope).'));
+    }
+    if (insp.issues.length > 0) {
+        console.log(header('Related Issues'));
+        for (const issue of insp.issues) {
+            console.log(`  ${severityIcon(issue.severity)} ${issue.title}`);
+        }
+    }
+    if (insp.potentialIssues.length > 0) {
+        console.log(header('Potential Issues'));
+        for (const issue of insp.potentialIssues) {
+            console.log(`  ${chalk.yellow('⚠')} ${issue}`);
+        }
+    }
+    if (insp.imports.length > 0) {
+        console.log(header('Dependencies'));
+        for (const imp of insp.imports.slice(0, 20)) {
+            const prefix = imp.isRelative ? chalk.dim('(local)') : chalk.cyan('(package)');
+            console.log(`  ${prefix} ${imp.source}`);
+        }
+        if (insp.imports.length > 20) {
+            console.log(chalk.dim(`  ... and ${insp.imports.length - 20} more`));
+        }
+    }
+    if (insp.exports.length > 0) {
+        console.log(header('Exports'));
+        for (const exp of insp.exports) {
+            console.log(`  ${chalk.dim('•')} ${chalk.bold(exp.name)} ${chalk.dim(`(${exp.type})`)}`);
+        }
+    }
+    console.log('');
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function formatAuthorEmail(email) {
+    const at = email.indexOf('@');
+    return at > 0 ? email.slice(0, at) : email;
+}
 //# sourceMappingURL=consoleReporter.js.map