projscan 0.10.0 → 0.12.0

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

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

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

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

package/dist/mcp/tools/outdated.js

@@ -0,0 +1,36 @@
+import { detectOutdated } from '../../core/outdatedDetector.js';
+import { detectWorkspaces } from '../../core/monorepo.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { PACKAGE_ARG_SCHEMA } from './_shared.js';
+export const outdatedTool = {
+    name: 'projscan_outdated',
+    description: 'Compare declared vs installed versions of every package. Reports drift (patch/minor/major). Workspace-aware in monorepos: each package.json is scanned, and each entry is tagged with the workspace it came from. Pass `package` to scope to a single workspace. Offline - does not hit the npm registry. Supports cursor pagination.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: PACKAGE_ARG_SCHEMA,
+            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) => {
+        const workspaces = await detectWorkspaces(rootPath);
+        const report = await detectOutdated(rootPath, {
+            workspaces,
+            ...(typeof args.package === 'string' ? { workspaceFilter: args.package } : {}),
+        });
+        if (!report.available)
+            return report;
+        const page = paginate(report.packages, readPageParams(args), listChecksum(report.packages));
+        return {
+            available: true,
+            totalPackages: report.totalPackages,
+            packages: page.items,
+            byWorkspace: report.byWorkspace,
+            total: page.total,
+            nextCursor: page.nextCursor,
+        };
+    },
+};
+//# sourceMappingURL=outdated.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outdated.js","sourceRoot":"","sources":["../../../src/mcp/tools/outdated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAEhE,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,uUAAuU;IACzU,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,kBAAkB;YAC3B,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,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE;YAC5C,UAAU;YACV,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/E,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5F,OAAO;YACL,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,IAAI,CAAC,KAAK;YACpB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF,CAAC"}

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

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

package/dist/mcp/tools/prDiff.js

@@ -0,0 +1,38 @@
+import { computePrDiff } from '../../core/prDiff.js';
+import { emitProgress } from '../progress.js';
+import { PACKAGE_ARG_SCHEMA, resolvePackageFilter } from './_shared.js';
+export const prDiffTool = {
+    name: 'projscan_pr_diff',
+    description: 'Structural (AST) diff between two refs - what changed in exports, imports, call sites, cyclomatic complexity, and fan-in. Not a text diff: this surfaces the symbols and edges that an agent reviewing a PR actually cares about. Defaults: base=origin/main (falls back to main/master/HEAD~1), head=HEAD. Spins up a throwaway git worktree at the base ref to get a clean second graph.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            base: {
+                type: 'string',
+                description: 'Base ref (branch, tag, sha). Default: origin/main, falling back to main/master/HEAD~1.',
+            },
+            head: { type: 'string', description: 'Head ref. Default: HEAD.' },
+            max_tokens: { type: 'number', description: 'Cap the response to roughly this many tokens.' },
+            package: PACKAGE_ARG_SCHEMA,
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 3, 'resolving refs');
+        const base = typeof args.base === 'string' ? args.base : undefined;
+        const head = typeof args.head === 'string' ? args.head : undefined;
+        emitProgress(1, 3, 'building base + head graphs');
+        const report = await computePrDiff(rootPath, { base, head });
+        emitProgress(2, 3, 'diffing');
+        const passes = await resolvePackageFilter(rootPath, args);
+        if (passes) {
+            report.filesAdded = report.filesAdded.filter(passes);
+            report.filesRemoved = report.filesRemoved.filter(passes);
+            report.filesModified = report.filesModified.filter((f) => passes(f.relativePath));
+            report.totalFilesChanged =
+                report.filesAdded.length + report.filesRemoved.length + report.filesModified.length;
+        }
+        emitProgress(3, 3, 'done');
+        return report;
+    },
+};
+//# sourceMappingURL=prDiff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prDiff.js","sourceRoot":"","sources":["../../../src/mcp/tools/prDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAgB,MAAM,cAAc,CAAC;AAEtF,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,4XAA4X;IAC9X,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wFAAwF;aACtG;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACjE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YAC5F,OAAO,EAAE,kBAAkB;SAC5B;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzD,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAClF,MAAM,CAAC,iBAAiB;gBACtB,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC;QACxF,CAAC;QACD,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

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

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

package/dist/mcp/tools/search.js

@@ -0,0 +1,167 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { buildCodeGraph } from '../../core/codeGraph.js';
+import { loadCachedGraph, saveCachedGraph } from '../../core/indexCache.js';
+import { buildSearchIndex, search as searchIndex, attachExcerpts, expandQuery, } from '../../core/searchIndex.js';
+import { buildSemanticIndex, semanticSearch, reciprocalRankFusion, } from '../../core/semanticSearch.js';
+import { isSemanticAvailable } from '../../core/embeddings.js';
+import { paginate, listChecksum, readPageParams } from '../pagination.js';
+import { PACKAGE_ARG_SCHEMA, resolvePackageFilter } from './_shared.js';
+export const searchTool = {
+    name: 'projscan_search',
+    description: 'Ranked search across the project. Lexical (BM25) by default; optional semantic (vector) and hybrid (RRF fusion) modes available when the @xenova/transformers peer dependency is installed. Scope controls what to search: "auto"/"content" (ranked content matches with excerpts), "symbols" (exported names), "files" (path substring).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search string. Multi-word queries are treated as OR across BM25 terms; semantic mode embeds the full query.',
+            },
+            scope: {
+                type: 'string',
+                description: 'What to search over: "auto" (= content), "symbols", "files", "content".',
+                enum: ['auto', 'symbols', 'files', 'content'],
+            },
+            mode: {
+                type: 'string',
+                description: '"lexical" (default, BM25) | "semantic" (embeddings, requires peer dep) | "hybrid" (BM25 + semantic via reciprocal rank fusion). Ignored for "symbols" and "files" scopes.',
+                enum: ['lexical', 'semantic', 'hybrid'],
+            },
+            limit: { type: 'number', description: 'Max matches returned (default 30).' },
+            max_tokens: { type: 'number', description: 'Cap the response to roughly this many tokens.' },
+            package: PACKAGE_ARG_SCHEMA,
+        },
+        required: ['query'],
+    },
+    handler: async (args, rootPath) => {
+        const query = String(args.query ?? '').trim();
+        if (!query)
+            throw new Error('query argument is required and must be non-empty');
+        const scope = String(args.scope ?? 'auto');
+        const limit = Math.max(1, Math.min(500, typeof args.limit === 'number' ? args.limit : 30));
+        const scan = await scanRepository(rootPath);
+        const cached = await loadCachedGraph(rootPath);
+        const graph = await buildCodeGraph(rootPath, scan.files, cached);
+        await saveCachedGraph(rootPath, graph);
+        const passes = await resolvePackageFilter(rootPath, args);
+        if (scope === 'files') {
+            const q = query.toLowerCase();
+            const all = scan.files
+                .filter((f) => f.relativePath.toLowerCase().includes(q))
+                .filter((f) => !passes || passes(f.relativePath))
+                .map((f) => ({ file: f.relativePath, sizeBytes: f.sizeBytes }));
+            const page = paginate(all, readPageParams(args), listChecksum(all));
+            return { scope, query, matches: page.items, total: page.total, nextCursor: page.nextCursor };
+        }
+        if (scope === 'symbols') {
+            const q = query.toLowerCase();
+            const rawMatches = [];
+            for (const [file, entry] of graph.files) {
+                if (passes && !passes(file))
+                    continue;
+                for (const exp of entry.exports) {
+                    const name = exp.name.toLowerCase();
+                    if (!name.includes(q))
+                        continue;
+                    const rank = name === q ? 0 : name.startsWith(q) ? 1 : 2;
+                    rawMatches.push({ symbol: exp.name, kind: exp.kind, file, line: exp.line, rank });
+                }
+            }
+            rawMatches.sort((a, b) => a.rank - b.rank);
+            const cleaned = rawMatches.map((m) => ({
+                symbol: m.symbol,
+                kind: m.kind,
+                file: m.file,
+                line: m.line,
+            }));
+            const page = paginate(cleaned, readPageParams(args), listChecksum(cleaned));
+            return { scope, query, matches: page.items, total: page.total, nextCursor: page.nextCursor };
+        }
+        const mode = String(args.mode ?? 'lexical');
+        const index = await buildSearchIndex(rootPath, scan.files, graph);
+        const lexicalHitsAll = searchIndex(index, query, { limit });
+        const lexicalHits = passes ? lexicalHitsAll.filter((h) => passes(h.file)) : lexicalHitsAll;
+        const tokens = expandQuery(query);
+        if (mode === 'lexical') {
+            const withExcerpts = await attachExcerpts(rootPath, lexicalHits, tokens);
+            const page = paginate(withExcerpts, readPageParams(args), listChecksum(withExcerpts));
+            return {
+                scope: scope === 'auto' ? 'content' : scope,
+                mode: 'lexical',
+                query,
+                queryTokens: tokens,
+                matches: page.items,
+                total: page.total,
+                nextCursor: page.nextCursor,
+            };
+        }
+        const hasSemantic = await isSemanticAvailable();
+        if (!hasSemantic) {
+            return {
+                scope: scope === 'auto' ? 'content' : scope,
+                mode,
+                query,
+                error: 'Semantic search requires the optional peer dependency @xenova/transformers. Install it with: npm install @xenova/transformers',
+                available: false,
+                matches: [],
+                total: 0,
+            };
+        }
+        const semIndex = await buildSemanticIndex(rootPath, scan.files);
+        if (!semIndex) {
+            return {
+                scope: scope === 'auto' ? 'content' : scope,
+                mode,
+                query,
+                error: 'Semantic index build failed (peer loaded but model not usable).',
+                available: false,
+                matches: [],
+                total: 0,
+            };
+        }
+        const semHitsAll = await semanticSearch(semIndex, query, { limit });
+        const semHits = passes ? semHitsAll.filter((h) => passes(h.file)) : semHitsAll;
+        if (mode === 'semantic') {
+            const enriched = await attachExcerpts(rootPath, semHits.map((h) => ({
+                file: h.file,
+                score: h.score,
+                matched: [],
+                symbolMatch: false,
+                pathMatch: false,
+                excerpt: '',
+                line: 0,
+            })), tokens);
+            const page = paginate(enriched, readPageParams(args), listChecksum(enriched));
+            return {
+                scope: scope === 'auto' ? 'content' : scope,
+                mode: 'semantic',
+                query,
+                model: semIndex.model,
+                matches: page.items,
+                total: page.total,
+                nextCursor: page.nextCursor,
+            };
+        }
+        const fused = reciprocalRankFusion([lexicalHits, semHits]).slice(0, limit);
+        const enriched = await attachExcerpts(rootPath, fused.map((f) => ({
+            file: f.file,
+            score: f.score,
+            matched: [],
+            symbolMatch: false,
+            pathMatch: false,
+            excerpt: '',
+            line: 0,
+        })), tokens);
+        const page = paginate(enriched, readPageParams(args), listChecksum(enriched));
+        return {
+            scope: scope === 'auto' ? 'content' : scope,
+            mode: 'hybrid',
+            query,
+            queryTokens: tokens,
+            model: semIndex.model,
+            matches: page.items,
+            total: page.total,
+            nextCursor: page.nextCursor,
+        };
+    },
+};
+//# sourceMappingURL=search.js.map

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

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

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

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

package/dist/mcp/tools/structure.js

@@ -0,0 +1,34 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { detectWorkspaces } from '../../core/monorepo.js';
+import { PACKAGE_ARG_SCHEMA, sliceTree } from './_shared.js';
+export const structureTool = {
+    name: 'projscan_structure',
+    description: 'Return the project directory tree with file counts.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: PACKAGE_ARG_SCHEMA,
+        },
+    },
+    handler: async (args, rootPath) => {
+        const scan = await scanRepository(rootPath);
+        const pkgName = typeof args.package === 'string' && args.package.length > 0 ? args.package : null;
+        if (!pkgName) {
+            return { structure: scan.directoryTree, totalFiles: scan.totalFiles };
+        }
+        const ws = await detectWorkspaces(rootPath);
+        const pkg = ws.packages.find((p) => p.name === pkgName);
+        if (!pkg || pkg.isRoot || !pkg.relativePath) {
+            return { structure: scan.directoryTree, totalFiles: scan.totalFiles };
+        }
+        const sliced = sliceTree(scan.directoryTree, pkg.relativePath);
+        if (!sliced) {
+            return {
+                structure: { name: pkg.name, path: pkg.relativePath, children: [], fileCount: 0, totalFileCount: 0 },
+                totalFiles: 0,
+            };
+        }
+        return { structure: sliced, totalFiles: sliced.totalFileCount };
+    },
+};
+//# sourceMappingURL=structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/mcp/tools/structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAgB,MAAM,cAAc,CAAC;AAE3E,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qDAAqD;IAClE,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,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAClG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACxE,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC5C,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACxE,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE;gBACpG,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;IAClE,CAAC;CACF,CAAC"}

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

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

package/dist/mcp/tools/upgrade.js

@@ -0,0 +1,38 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { previewUpgrade } from '../../core/upgradePreview.js';
+import { isPythonDominated } from './_shared.js';
+export const upgradeTool = {
+    name: 'projscan_upgrade',
+    description: 'Preview the impact of upgrading a package: semver drift, breaking-change markers from the local CHANGELOG, and the files in your repo that import it. Offline.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: {
+                type: 'string',
+                description: 'Name of the package to preview.',
+            },
+        },
+        required: ['package'],
+    },
+    handler: async (args, rootPath) => {
+        const pkgName = typeof args.package === 'string' ? args.package : '';
+        if (!pkgName)
+            throw new Error('package argument is required');
+        const scan = await scanRepository(rootPath);
+        if (await isPythonDominated(rootPath, scan.files)) {
+            return {
+                available: false,
+                reason: 'Upgrade preview is currently supported only for Node.js packages. Python support is planned for a future release.',
+                name: pkgName,
+                declared: null,
+                installed: null,
+                latest: null,
+                drift: 'unknown',
+                breakingMarkers: [],
+                importers: [],
+            };
+        }
+        return await previewUpgrade(rootPath, pkgName, scan.files);
+    },
+};
+//# sourceMappingURL=upgrade.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/mcp/tools/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAgB,MAAM,cAAc,CAAC;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,gKAAgK;IAClK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,MAAM,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,MAAM,EACJ,mHAAmH;gBACrH,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,SAAS;gBAChB,eAAe,EAAE,EAAE;gBACnB,SAAS,EAAE,EAAE;aACd,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

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

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

package/dist/mcp/tools/workspaces.js

@@ -0,0 +1,13 @@
+import { detectWorkspaces } from '../../core/monorepo.js';
+export const workspacesTool = {
+    name: 'projscan_workspaces',
+    description: 'List monorepo workspace packages (npm/yarn workspaces, pnpm-workspace.yaml, Nx/Turbo/Lerna fallback). Returns one row per package with name, relative path, and version. Use the package `name` as the `package` argument on projscan_hotspots / projscan_coupling to scope those tools to a single package.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    handler: async (_args, rootPath) => {
+        return await detectWorkspaces(rootPath);
+    },
+};
+//# sourceMappingURL=workspaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../src/mcp/tools/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,8SAA8S;IAChT,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjC,OAAO,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC"}

package/dist/mcp/tools.d.ts

@@ -1,9 +1,15 @@
+/**
+ * MCP tool registry - barrel that aggregates the per-tool modules under
+ * `src/mcp/tools/`. New tools live in their own file under that directory and
+ * are added to the `tools` array below.
+ *
+ * The shape exposed here (`getToolDefinitions`, `getToolHandler`,
+ * `McpToolHandler`) is consumed by `src/mcp/server.ts`. Re-export `McpTool`
+ * + `McpToolHandler` so external callers don't need to know about the
+ * directory split.
+ */
 import type { McpToolDefinition } from '../types.js';
-export interface McpToolHandler {
-    (args: Record<string, unknown>, rootPath: string): Promise<unknown>;
-}
-export interface McpTool extends McpToolDefinition {
-    handler: McpToolHandler;
-}
+import type { McpTool, McpToolHandler } from './tools/_shared.js';
+export type { McpTool, McpToolHandler };
 export declare function getToolDefinitions(): McpToolDefinition[];
 export declare function getToolHandler(name: string): McpToolHandler | undefined;