projscan 0.1.11 → 0.2.0

package/dist/core/hotspotAnalyzer.js

@@ -0,0 +1,342 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+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;
+const DEFAULT_SINCE = '12 months ago';
+export async function analyzeHotspots(rootPath, files, issues, options = {}) {
+    const limit = Math.max(1, Math.min(100, options.limit ?? 10));
+    const since = options.since ?? DEFAULT_SINCE;
+    const isRepo = await isGitRepository(rootPath);
+    if (!isRepo) {
+        return {
+            available: false,
+            reason: 'Not a git repository — hotspot analysis requires git history',
+            window: { since: null, commitsScanned: 0 },
+            hotspots: [],
+            totalFilesRanked: 0,
+        };
+    }
+    const churnMap = await collectGitChurn(rootPath, since);
+    const candidates = files.filter((f) => CODE_EXTENSIONS.has(f.extension) && f.sizeBytes <= MAX_LINE_READ_BYTES);
+    const candidatesByScore = [...candidates].sort((a, b) => {
+        const ca = churnMap.get(a.relativePath)?.churn ?? 0;
+        const cb = churnMap.get(b.relativePath)?.churn ?? 0;
+        if (cb !== ca)
+            return cb - ca;
+        return b.sizeBytes - a.sizeBytes;
+    });
+    const readTargets = candidatesByScore.slice(0, MAX_LINE_READS);
+    const lineCounts = new Map();
+    await Promise.all(readTargets.map(async (f) => {
+        const lines = await countLines(f.absolutePath);
+        if (lines !== null)
+            lineCounts.set(f.relativePath, lines);
+    }));
+    const issueIndex = indexIssuesByFile(issues, files);
+    const now = Date.now();
+    const hotspots = candidates.map((file) => {
+        const churnEntry = churnMap.get(file.relativePath);
+        const churn = churnEntry?.churn ?? 0;
+        const authors = churnEntry?.authors.size ?? 0;
+        const lastTs = churnEntry?.lastTimestampMs ?? null;
+        const daysSinceLastChange = lastTs === null ? null : Math.max(0, Math.floor((now - lastTs) / (1000 * 60 * 60 * 24)));
+        const lines = lineCounts.get(file.relativePath) ?? estimateLines(file.sizeBytes);
+        const issueIds = issueIndex.get(file.relativePath) ?? [];
+        const topAuthors = rankAuthors(churnEntry?.authorCommits);
+        const primaryAuthor = topAuthors[0]?.author ?? null;
+        const primaryAuthorShare = topAuthors[0]?.share ?? 0;
+        const busFactorOne = churn >= 3 && primaryAuthorShare >= 0.8;
+        const riskScore = computeRiskScore({
+            churn,
+            lines,
+            authors,
+            daysSinceLastChange,
+            issueCount: issueIds.length,
+            busFactorOne,
+        });
+        const reasons = buildReasons({
+            churn,
+            lines,
+            authors,
+            daysSinceLastChange,
+            issueCount: issueIds.length,
+            busFactorOne,
+            primaryAuthor,
+        });
+        return {
+            relativePath: file.relativePath,
+            churn,
+            distinctAuthors: authors,
+            daysSinceLastChange,
+            lineCount: lines,
+            sizeBytes: file.sizeBytes,
+            issueCount: issueIds.length,
+            issueIds,
+            riskScore,
+            reasons,
+            primaryAuthor,
+            primaryAuthorShare,
+            busFactorOne,
+            topAuthors,
+        };
+    });
+    hotspots.sort((a, b) => b.riskScore - a.riskScore);
+    const ranked = hotspots.filter((h) => h.riskScore > 0);
+    return {
+        available: true,
+        window: {
+            since,
+            commitsScanned: countCommits(churnMap),
+        },
+        hotspots: ranked.slice(0, limit),
+        totalFilesRanked: ranked.length,
+    };
+}
+async function isGitRepository(rootPath) {
+    try {
+        const { code } = await runGit(rootPath, ['rev-parse', '--is-inside-work-tree']);
+        return code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function collectGitChurn(rootPath, since) {
+    const map = new Map();
+    const args = [
+        'log',
+        `--since=${since}`,
+        '--no-merges',
+        '--name-only',
+        '--pretty=format:COMMIT|%H|%ae|%at',
+    ];
+    let stdout;
+    try {
+        const result = await runGit(rootPath, args, { timeoutMs: 15_000 });
+        if (result.code !== 0)
+            return map;
+        stdout = result.stdout;
+    }
+    catch {
+        return map;
+    }
+    let currentHash = null;
+    let currentAuthor = null;
+    let currentTsMs = null;
+    for (const rawLine of stdout.split('\n')) {
+        const line = rawLine.trimEnd();
+        if (!line)
+            continue;
+        if (line.startsWith('COMMIT|')) {
+            const parts = line.split('|');
+            currentHash = parts[1] ?? null;
+            currentAuthor = parts[2] ?? null;
+            const tsSec = parseInt(parts[3] ?? '', 10);
+            currentTsMs = Number.isFinite(tsSec) ? tsSec * 1000 : null;
+            continue;
+        }
+        if (!currentHash)
+            continue;
+        const filePath = normalizeFilePath(line);
+        if (!filePath)
+            continue;
+        let entry = map.get(filePath);
+        if (!entry) {
+            entry = {
+                churn: 0,
+                authors: new Set(),
+                authorCommits: new Map(),
+                lastTimestampMs: null,
+                commitHashes: new Set(),
+            };
+            map.set(filePath, entry);
+        }
+        if (!entry.commitHashes.has(currentHash)) {
+            entry.commitHashes.add(currentHash);
+            entry.churn++;
+            if (currentAuthor) {
+                entry.authorCommits.set(currentAuthor, (entry.authorCommits.get(currentAuthor) ?? 0) + 1);
+            }
+        }
+        if (currentAuthor)
+            entry.authors.add(currentAuthor);
+        if (currentTsMs !== null && (entry.lastTimestampMs === null || currentTsMs > entry.lastTimestampMs)) {
+            entry.lastTimestampMs = currentTsMs;
+        }
+    }
+    return map;
+}
+function normalizeFilePath(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    return trimmed.split(path.sep).join('/').replace(/^\.\//, '');
+}
+function countCommits(churnMap) {
+    const hashes = new Set();
+    for (const entry of churnMap.values()) {
+        for (const h of entry.commitHashes)
+            hashes.add(h);
+    }
+    return hashes.size;
+}
+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', (d) => {
+            stdout += d.toString();
+        });
+        child.stderr.on('data', (d) => {
+            stderr += d.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 });
+        });
+    });
+}
+// ── Line Counting ─────────────────────────────────────────
+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;
+    }
+}
+function estimateLines(sizeBytes) {
+    return Math.max(1, Math.round(sizeBytes / 40));
+}
+// ── Issue → File Mapping ──────────────────────────────────
+function indexIssuesByFile(issues, files) {
+    const index = new Map();
+    const filePaths = new Set(files.map((f) => f.relativePath));
+    for (const issue of issues) {
+        const haystack = `${issue.title}\n${issue.description}`;
+        for (const filePath of filePaths) {
+            if (!filePath)
+                continue;
+            if (haystack.includes(filePath)) {
+                const list = index.get(filePath) ?? [];
+                if (!list.includes(issue.id))
+                    list.push(issue.id);
+                index.set(filePath, list);
+            }
+        }
+    }
+    return index;
+}
+export function computeRiskScore(i) {
+    const churnWeight = Math.log2(1 + i.churn) * 20;
+    const complexityWeight = Math.log2(1 + i.lines) * 4;
+    const hotChurnXComplexity = Math.log2(1 + i.churn) * Math.log2(1 + i.lines) * 3;
+    const authorWeight = Math.log2(1 + i.authors) * 5;
+    const issueWeight = i.issueCount * 12;
+    const busFactorPenalty = i.busFactorOne ? 15 : 0;
+    let recencyBoost = 0;
+    if (i.daysSinceLastChange !== null) {
+        if (i.daysSinceLastChange <= 7)
+            recencyBoost = 10;
+        else if (i.daysSinceLastChange <= 30)
+            recencyBoost = 6;
+        else if (i.daysSinceLastChange <= 90)
+            recencyBoost = 3;
+    }
+    const raw = churnWeight +
+        complexityWeight +
+        hotChurnXComplexity +
+        authorWeight +
+        issueWeight +
+        recencyBoost +
+        busFactorPenalty;
+    if (i.churn === 0 && i.issueCount === 0)
+        return 0;
+    return Math.round(raw * 10) / 10;
+}
+function buildReasons(i) {
+    const reasons = [];
+    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'}`);
+    if (i.lines >= 500)
+        reasons.push(`large file (${i.lines} lines)`);
+    else if (i.lines >= 250)
+        reasons.push(`${i.lines} lines`);
+    if (i.authors >= 5)
+        reasons.push(`${i.authors} contributors`);
+    else if (i.authors >= 2)
+        reasons.push(`${i.authors} contributors`);
+    if (i.issueCount > 0) {
+        reasons.push(`${i.issueCount} open issue${i.issueCount === 1 ? '' : 's'}`);
+    }
+    if (i.daysSinceLastChange !== null && i.daysSinceLastChange <= 7) {
+        reasons.push('changed this week');
+    }
+    if (i.busFactorOne && i.primaryAuthor) {
+        reasons.push(`bus factor 1 (${formatAuthor(i.primaryAuthor)})`);
+    }
+    return reasons;
+}
+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=hotspotAnalyzer.js.map

package/dist/core/hotspotAnalyzer.js.map

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

package/dist/index.d.ts

@@ -3,5 +3,11 @@ export { detectLanguages } from './core/languageDetector.js';
 export { detectFrameworks } from './core/frameworkDetector.js';
 export { analyzeDependencies } from './core/dependencyAnalyzer.js';
 export { collectIssues } from './core/issueEngine.js';
+export { analyzeHotspots, computeRiskScore } from './core/hotspotAnalyzer.js';
+export { inspectFile } from './core/fileInspector.js';
 export { walkFiles } from './utils/fileWalker.js';
-export type { ScanResult, FileEntry, DirectoryNode, LanguageBreakdown, LanguageStat, FrameworkResult, DetectedFramework, DependencyReport, DependencyRisk, Issue, IssueSeverity, Fix, FixResult, FileExplanation, ImportInfo, ExportInfo, ArchitectureLayer, AnalysisReport, ReportFormat, } from './types.js';
+export { createMcpServer, runMcpServer } from './mcp/server.js';
+export { getToolDefinitions } from './mcp/tools.js';
+export { getPromptDefinitions } from './mcp/prompts.js';
+export { getResourceDefinitions } from './mcp/resources.js';
+export type { ScanResult, FileEntry, DirectoryNode, LanguageBreakdown, LanguageStat, FrameworkResult, DetectedFramework, DependencyReport, DependencyRisk, Issue, IssueSeverity, Fix, FixResult, FileExplanation, FileInspection, ImportInfo, ExportInfo, ArchitectureLayer, AnalysisReport, ReportFormat, FileHotspot, HotspotReport, AuthorShare, BaselineHotspot, HotspotDelta, HotspotDiffSummary, McpToolDefinition, McpPromptDefinition, McpResourceDefinition, } from './types.js';

package/dist/index.js

@@ -3,5 +3,11 @@ export { detectLanguages } from './core/languageDetector.js';
 export { detectFrameworks } from './core/frameworkDetector.js';
 export { analyzeDependencies } from './core/dependencyAnalyzer.js';
 export { collectIssues } from './core/issueEngine.js';
+export { analyzeHotspots, computeRiskScore } from './core/hotspotAnalyzer.js';
+export { inspectFile } from './core/fileInspector.js';
 export { walkFiles } from './utils/fileWalker.js';
+export { createMcpServer, runMcpServer } from './mcp/server.js';
+export { getToolDefinitions } from './mcp/tools.js';
+export { getPromptDefinitions } from './mcp/prompts.js';
+export { getResourceDefinitions } from './mcp/resources.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,14 @@
+import type { McpPromptDefinition } from '../types.js';
+export interface McpPromptMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+export interface McpPromptResult {
+    description: string;
+    messages: McpPromptMessage[];
+}
+export declare function getPromptDefinitions(): McpPromptDefinition[];
+export declare function getPrompt(name: string, args: Record<string, unknown>, rootPath: string): Promise<McpPromptResult>;

package/dist/mcp/prompts.js

@@ -0,0 +1,126 @@
+import { scanRepository } from '../core/repositoryScanner.js';
+import { collectIssues } from '../core/issueEngine.js';
+import { analyzeHotspots } from '../core/hotspotAnalyzer.js';
+import { inspectFile } from '../core/fileInspector.js';
+import { calculateScore } from '../utils/scoreCalculator.js';
+const promptDefinitions = [
+    {
+        name: 'prioritize_refactoring',
+        description: "Produce a ranked refactoring plan grounded in this project's current churn-weighted hotspots and open health issues.",
+        arguments: [
+            {
+                name: 'limit',
+                description: 'How many hotspots to include (default: 10)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'investigate_file',
+        description: "Produce a senior-engineer investigation of a specific file, grounded in its churn, ownership, related issues, and structure.",
+        arguments: [
+            {
+                name: 'file',
+                description: 'Path to the file (relative to project root)',
+                required: true,
+            },
+        ],
+    },
+];
+export function getPromptDefinitions() {
+    return promptDefinitions;
+}
+export async function getPrompt(name, args, rootPath) {
+    switch (name) {
+        case 'prioritize_refactoring':
+            return await prioritizeRefactoringPrompt(args, rootPath);
+        case 'investigate_file':
+            return await investigateFilePrompt(args, rootPath);
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+}
+async function prioritizeRefactoringPrompt(args, rootPath) {
+    const limit = coerceLimit(args.limit, 10);
+    const scan = await scanRepository(rootPath);
+    const issues = await collectIssues(rootPath, scan.files);
+    const hotspots = await analyzeHotspots(rootPath, scan.files, issues, { limit });
+    const { score, grade } = calculateScore(issues);
+    const hotspotLines = hotspots.available && hotspots.hotspots.length > 0
+        ? hotspots.hotspots
+            .map((h, i) => {
+            const reasons = h.reasons.length > 0 ? h.reasons.join(', ') : 'ranked by risk';
+            const ownership = h.busFactorOne && h.primaryAuthor
+                ? ` [BUS FACTOR 1: ${h.primaryAuthor}]`
+                : '';
+            return `${i + 1}. ${h.relativePath} — risk ${h.riskScore.toFixed(1)} (${reasons})${ownership}`;
+        })
+            .join('\n')
+        : '(no hotspots available — project may not be a git repository)';
+    const topIssues = issues
+        .slice(0, 15)
+        .map((issue) => `- [${issue.severity}] ${issue.title}`)
+        .join('\n');
+    const text = [
+        'You are a senior engineer reviewing a codebase. Produce a concrete, prioritized refactoring plan.',
+        '',
+        `Current health: ${grade} (${score}/100). Issues: ${issues.length}.`,
+        '',
+        'Top hotspots (ranked by churn × complexity × open issues × recency):',
+        hotspotLines,
+        '',
+        'Top health issues:',
+        topIssues || '(none)',
+        '',
+        'For each of the top 3 hotspots, output:',
+        '1. Why it is risky (in one sentence, citing the evidence above)',
+        '2. A specific refactoring or investigation action',
+        '3. Estimated effort (S / M / L)',
+        '',
+        'Then propose an ordering that maximizes risk reduction per unit of effort.',
+    ].join('\n');
+    return {
+        description: 'Prioritized refactoring plan grounded in live project data',
+        messages: [
+            { role: 'user', content: { type: 'text', text } },
+        ],
+    };
+}
+async function investigateFilePrompt(args, rootPath) {
+    const file = typeof args.file === 'string' ? args.file : '';
+    if (!file)
+        throw new Error('investigate_file requires a "file" argument');
+    const insp = await inspectFile(rootPath, file);
+    const body = JSON.stringify(insp, null, 2);
+    const text = [
+        `You are a senior engineer investigating \`${file}\`.`,
+        '',
+        "Here is the file report from projscan (purpose, risk score, ownership, related health issues, imports, exports):",
+        '',
+        '```json',
+        body,
+        '```',
+        '',
+        'Explain in order:',
+        '1. What this file does and how it fits in the codebase.',
+        '2. What is risky about it right now (cite evidence from the report).',
+        '3. Concrete next actions — questions to ask, tests to add, or refactors to attempt.',
+        '4. Who to involve (based on ownership, if available).',
+    ].join('\n');
+    return {
+        description: `Investigation brief for ${file}`,
+        messages: [{ role: 'user', content: { type: 'text', text } }],
+    };
+}
+function coerceLimit(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return Math.max(1, Math.min(100, Math.floor(value)));
+    }
+    if (typeof value === 'string') {
+        const parsed = parseInt(value, 10);
+        if (Number.isFinite(parsed))
+            return Math.max(1, Math.min(100, parsed));
+    }
+    return fallback;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,8 @@
+import type { McpResourceDefinition } from '../types.js';
+export interface McpResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function getResourceDefinitions(): McpResourceDefinition[];
+export declare function readResource(uri: string, rootPath: string): Promise<McpResourceContent>;

package/dist/mcp/resources.js

@@ -0,0 +1,57 @@
+import { scanRepository } from '../core/repositoryScanner.js';
+import { collectIssues } from '../core/issueEngine.js';
+import { analyzeHotspots } from '../core/hotspotAnalyzer.js';
+import { calculateScore } from '../utils/scoreCalculator.js';
+const resourceDefinitions = [
+    {
+        uri: 'projscan://health',
+        name: 'Project Health Report',
+        description: 'Live projscan doctor output: score, grade, and open issues.',
+        mimeType: 'application/json',
+    },
+    {
+        uri: 'projscan://hotspots',
+        name: 'Risk Hotspots',
+        description: 'Files ranked by git-churn × complexity × open issues × recency. Includes ownership data.',
+        mimeType: 'application/json',
+    },
+    {
+        uri: 'projscan://structure',
+        name: 'Project Directory Tree',
+        description: 'File/directory layout of the project with counts.',
+        mimeType: 'application/json',
+    },
+];
+export function getResourceDefinitions() {
+    return resourceDefinitions;
+}
+export async function readResource(uri, rootPath) {
+    switch (uri) {
+        case 'projscan://health': {
+            const scan = await scanRepository(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const health = calculateScore(issues);
+            return jsonResource(uri, { health, issues });
+        }
+        case 'projscan://hotspots': {
+            const scan = await scanRepository(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const hotspots = await analyzeHotspots(rootPath, scan.files, issues, { limit: 20 });
+            return jsonResource(uri, hotspots);
+        }
+        case 'projscan://structure': {
+            const scan = await scanRepository(rootPath);
+            return jsonResource(uri, { structure: scan.directoryTree, totalFiles: scan.totalFiles });
+        }
+        default:
+            throw new Error(`Unknown resource URI: ${uri}`);
+    }
+}
+function jsonResource(uri, data) {
+    return {
+        uri,
+        mimeType: 'application/json',
+        text: JSON.stringify(data, null, 2),
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQ7D,MAAM,mBAAmB,GAA4B;IACnD;QACE,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0FAA0F;QAC5F,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,sBAAsB;QAC3B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,kBAAkB;KAC7B;CACF,CAAC;AAEF,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,QAAgB;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACpF,OAAO,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC5C,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAa;IAC9C,OAAO;QACL,GAAG;QACH,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,5 @@
+export interface McpServerHandle {
+    handleMessage(line: string): Promise<string | null>;
+}
+export declare function createMcpServer(rootPath: string): McpServerHandle;
+export declare function runMcpServer(rootPath: string): Promise<void>;