projscan 0.12.0 → 0.14.0

package/dist/mcp/tools/file.js

@@ -1,7 +1,7 @@
 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.',
+    description: 'Drill into a single file: purpose, imports, exports, churn/risk/ownership, related health issues, AST cyclomatic complexity, coupling (fan-in / fan-out), and per-function CC ranked by complexity. Use this after projscan_hotspots when deciding how to approach a specific risky file.',
     inputSchema: {
         type: 'object',
         properties: {

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

@@ -1 +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"}
+{"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,2RAA2R;IAC7R,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/fixSuggest.d.ts

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

package/dist/mcp/tools/fixSuggest.js

@@ -0,0 +1,57 @@
+import { scanRepository } from '../../core/repositoryScanner.js';
+import { collectIssues } from '../../core/issueEngine.js';
+import { findIssue, suggestFixForIssue, syntheticIssue, } from '../../core/fixSuggest.js';
+export const fixSuggestTool = {
+    name: 'projscan_fix_suggest',
+    description: 'Given an issue id (from projscan_doctor / projscan_analyze) OR a file + rule pair, return a structured action prompt: headline, why it matters, where to change, one-paragraph instruction the agent can execute, optional suggested test. Rule-driven; no LLM inside projscan. Use this to close the diagnose -> fix loop.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            issue_id: {
+                type: 'string',
+                description: 'Issue id from a previous projscan_doctor / projscan_analyze response.',
+            },
+            file: {
+                type: 'string',
+                description: 'File path (repo-relative). Required when no `issue_id` is given - combined with `rule` to synthesize a fix request.',
+            },
+            rule: {
+                type: 'string',
+                description: 'Rule / issue-id prefix (e.g. "unused-dependency", "cycle-detected"). Required when no `issue_id` is given.',
+            },
+            severity: {
+                type: 'string',
+                enum: ['info', 'warning', 'error'],
+                description: 'Optional. When synthesizing via file+rule, sets the severity for the suggestion. Default: warning.',
+            },
+        },
+    },
+    handler: async (args, rootPath) => {
+        const issueId = typeof args.issue_id === 'string' ? args.issue_id : null;
+        const file = typeof args.file === 'string' ? args.file : null;
+        const rule = typeof args.rule === 'string' ? args.rule : null;
+        const severity = args.severity === 'info' || args.severity === 'warning' || args.severity === 'error'
+            ? args.severity
+            : 'warning';
+        if (issueId) {
+            const scan = await scanRepository(rootPath);
+            const issues = await collectIssues(rootPath, scan.files);
+            const found = findIssue(issues, issueId);
+            if (!found) {
+                return { matched: false, reason: `No open issue with id "${issueId}" in current doctor run.` };
+            }
+            const fix = await suggestFixForIssue(found, rootPath);
+            return { matched: true, fix };
+        }
+        if (file && rule) {
+            const synthetic = syntheticIssue(rule, file, severity);
+            const fix = await suggestFixForIssue(synthetic, rootPath);
+            return { matched: true, fix, synthetic: true };
+        }
+        return {
+            matched: false,
+            reason: 'Provide either `issue_id` or both `file` and `rule`.',
+        };
+    },
+};
+//# sourceMappingURL=fixSuggest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixSuggest.js","sourceRoot":"","sources":["../../../src/mcp/tools/fixSuggest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,6TAA6T;IAC/T,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qHAAqH;aACxH;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4GAA4G;aAC/G;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBAClC,WAAW,EAAE,oGAAoG;aAClH;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;YAClF,CAAC,CAAC,IAAI,CAAC,QAAQ;YACf,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,OAAO,EAAE,CAAC;YACZ,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,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,OAAO,0BAA0B,EAAE,CAAC;YACjG,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,sDAAsD;SAC/D,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/hotspots.js

@@ -8,7 +8,7 @@ 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.',
+    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. Pass `view: "functions"` to flatten results into the top-N riskiest individual functions across all hotspots, ranked by per-function CC.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -27,6 +27,11 @@ export const hotspotsTool = {
                 type: 'string',
                 description: 'Optional. Workspace package name (from projscan_workspaces) to scope hotspots to one package only.',
             },
+            view: {
+                type: 'string',
+                enum: ['files', 'functions'],
+                description: 'Output shape. "files" (default) returns ranked hotspot files. "functions" returns the top-N individual functions across all hotspots, sorted by per-function CC desc.',
+            },
         },
     },
     handler: async (args, rootPath) => {
@@ -47,6 +52,40 @@ export const hotspotsTool = {
             const allowed = new Set(filterFilesByPackage(ws, args.package, report.hotspots.map((h) => h.relativePath)));
             report.hotspots = report.hotspots.filter((h) => allowed.has(h.relativePath));
         }
+        // 0.13.0: function-level view. Flattens per-file `functions` lists into a
+        // single ranked list. Skips files with no per-function CC (e.g. ones the
+        // adapter parsed but found no function definitions, or non-AST languages).
+        if (args.view === 'functions') {
+            const ranked = [];
+            for (const h of report.hotspots) {
+                const gf = graph.files.get(h.relativePath);
+                if (!gf || !gf.functions || gf.functions.length === 0)
+                    continue;
+                for (const fn of gf.functions) {
+                    ranked.push({
+                        file: h.relativePath,
+                        name: fn.name,
+                        line: fn.line,
+                        endLine: fn.endLine,
+                        cyclomaticComplexity: fn.cyclomaticComplexity,
+                        fileRiskScore: h.riskScore,
+                    });
+                }
+            }
+            ranked.sort((a, b) => b.cyclomaticComplexity - a.cyclomaticComplexity);
+            const page = paginate(ranked, readPageParams(args), listChecksum(ranked));
+            emitProgress(5, 5, 'done');
+            return {
+                available: report.available,
+                reason: report.reason,
+                window: report.window,
+                view: 'functions',
+                functions: page.items,
+                totalFunctionsRanked: ranked.length,
+                nextCursor: page.nextCursor,
+                total: page.total,
+            };
+        }
         emitProgress(4, 5, 'paginating');
         const page = paginate(report.hotspots, readPageParams(args), listChecksum(report.hotspots));
         emitProgress(5, 5, 'done');

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

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

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

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

package/dist/mcp/tools/review.js

@@ -0,0 +1,54 @@
+import { computeReview } from '../../core/review.js';
+import { detectWorkspaces, filterFilesByPackage } from '../../core/monorepo.js';
+import { emitProgress } from '../progress.js';
+export const reviewTool = {
+    name: 'projscan_review',
+    description: 'One-call PR review. Combines projscan_pr_diff + per-changed-file risk score + new/expanded import cycles + risky function additions + dependency changes, plus a verdict ("ok" | "review" | "block") with a one-line summary. Use when an agent is asked "is this PR safe to merge?" Defaults: base=origin/main (falls back to main/master/HEAD~1), head=HEAD.',
+    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: {
+                type: 'string',
+                description: 'Optional. Workspace package name to scope all sections of the review to a single package.',
+            },
+        },
+    },
+    handler: async (args, rootPath) => {
+        emitProgress(0, 4, 'resolving refs');
+        const base = typeof args.base === 'string' ? args.base : undefined;
+        const head = typeof args.head === 'string' ? args.head : undefined;
+        emitProgress(1, 4, 'building base + head graphs');
+        const report = await computeReview(rootPath, { base, head });
+        if (typeof args.package === 'string' && args.package.length > 0 && report.available) {
+            emitProgress(2, 4, 'scoping to workspace');
+            const ws = await detectWorkspaces(rootPath);
+            const target = args.package;
+            const allChangedPaths = [
+                ...report.prDiff.filesAdded,
+                ...report.prDiff.filesRemoved,
+                ...report.prDiff.filesModified.map((f) => f.relativePath),
+            ];
+            const allowed = new Set(filterFilesByPackage(ws, target, allChangedPaths));
+            report.prDiff.filesAdded = report.prDiff.filesAdded.filter((f) => allowed.has(f));
+            report.prDiff.filesRemoved = report.prDiff.filesRemoved.filter((f) => allowed.has(f));
+            report.prDiff.filesModified = report.prDiff.filesModified.filter((f) => allowed.has(f.relativePath));
+            report.prDiff.totalFilesChanged =
+                report.prDiff.filesAdded.length +
+                    report.prDiff.filesRemoved.length +
+                    report.prDiff.filesModified.length;
+            report.changedFiles = report.changedFiles.filter((f) => allowed.has(f.relativePath));
+            report.newCycles = report.newCycles.filter((c) => c.files.some((f) => allowed.has(f)));
+            report.riskyFunctions = report.riskyFunctions.filter((f) => allowed.has(f.file));
+            report.dependencyChanges = report.dependencyChanges.filter((d) => d.workspace === target);
+        }
+        emitProgress(4, 4, 'done');
+        return report;
+    },
+};
+//# sourceMappingURL=review.js.map

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

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

package/dist/mcp/tools.js

@@ -23,6 +23,9 @@ import { graphTool } from './tools/graph.js';
 import { couplingTool } from './tools/coupling.js';
 import { workspacesTool } from './tools/workspaces.js';
 import { prDiffTool } from './tools/prDiff.js';
+import { reviewTool } from './tools/review.js';
+import { fixSuggestTool } from './tools/fixSuggest.js';
+import { explainIssueTool } from './tools/explainIssue.js';
 import { searchTool } from './tools/search.js';
 const tools = [
     analyzeTool,
@@ -40,6 +43,9 @@ const tools = [
     couplingTool,
     workspacesTool,
     prDiffTool,
+    reviewTool,
+    fixSuggestTool,
+    explainIssueTool,
     searchTool,
 ];
 export function getToolDefinitions() {

package/dist/mcp/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,MAAM,KAAK,GAAc;IACvB,WAAW;IACX,UAAU;IACV,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,WAAW;IACX,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,cAAc;IACd,UAAU;IACV,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC;AACrD,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,MAAM,KAAK,GAAc;IACvB,WAAW;IACX,UAAU;IACV,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,WAAW;IACX,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,cAAc;IACd,UAAU;IACV,UAAU;IACV,cAAc;IACd,gBAAgB;IAChB,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC;AACrD,CAAC"}

package/dist/reporters/consoleReporter.d.ts

@@ -1,4 +1,4 @@
-import type { AnalysisReport, AuditReport, CoverageJoinedReport, CouplingReport, Issue, Fix, FixResult, FileExplanation, FileInspection, ArchitectureLayer, DirectoryNode, DependencyReport, DiffResult, HotspotReport, OutdatedReport, PrDiffReport, UpgradePreview, WorkspaceInfo } from '../types.js';
+import type { AnalysisReport, AuditReport, CoverageJoinedReport, CouplingReport, Issue, Fix, FixResult, FileExplanation, FileInspection, ArchitectureLayer, DirectoryNode, DependencyReport, DiffResult, HotspotReport, OutdatedReport, PrDiffReport, ReviewReport, FixSuggestion, IssueExplanation, UpgradePreview, WorkspaceInfo } 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;
@@ -17,4 +17,12 @@ export declare function reportUpgrade(preview: UpgradePreview): void;
 export declare function reportCoverage(report: CoverageJoinedReport): void;
 export declare function reportCoupling(report: CouplingReport): void;
 export declare function reportPrDiff(report: PrDiffReport): void;
+export declare function reportFixSuggest(result: {
+    matched: boolean;
+    fix?: FixSuggestion;
+    reason?: string;
+    synthetic?: boolean;
+}): void;
+export declare function reportExplainIssue(e: IssueExplanation): void;
+export declare function reportReview(report: ReviewReport): void;
 export declare function reportWorkspaces(info: WorkspaceInfo): void;

package/dist/reporters/consoleReporter.js

@@ -109,6 +109,9 @@ export function reportHealth(issues, scanTimeMs) {
     for (const issue of issues) {
         console.log(`  ${severityIcon(issue.severity)} ${issue.title}`);
         console.log(`    ${chalk.dim(issue.description)}`);
+        if (issue.suggestedAction) {
+            console.log(`    ${chalk.cyan('→')} ${chalk.dim(issue.suggestedAction.summary)} ${chalk.dim(`(projscan fix-suggest ${issue.id})`)}`);
+        }
     }
     // Recommendations
     const fixable = issues.filter((i) => i.fixAvailable);
@@ -399,6 +402,17 @@ export function reportFileInspection(insp) {
             console.log(`  ${chalk.dim('•')} ${chalk.bold(exp.name)} ${chalk.dim(`(${exp.type})`)}`);
         }
     }
+    if (insp.functions && insp.functions.length > 0) {
+        console.log(header('Functions (top by CC)'));
+        const top = insp.functions.slice(0, 10);
+        for (const fn of top) {
+            const ccColor = fn.cyclomaticComplexity >= 10 ? chalk.red : fn.cyclomaticComplexity >= 5 ? chalk.yellow : chalk.dim;
+            console.log(`  ${ccColor(`CC ${String(fn.cyclomaticComplexity).padStart(3)}`)}  ${chalk.bold(fn.name)} ${chalk.dim(`L${fn.line}-${fn.endLine}`)}`);
+        }
+        if (insp.functions.length > 10) {
+            console.log(chalk.dim(`  ... and ${insp.functions.length - 10} more`));
+        }
+    }
     console.log('');
 }
 function formatSize(bytes) {
@@ -670,6 +684,169 @@ export function reportPrDiff(report) {
 function signed(n) {
     return n >= 0 ? `+${n}` : String(n);
 }
+// ── Report: fix-suggest ───────────────────────────────────
+export function reportFixSuggest(result) {
+    console.log(header('Fix Suggestion'));
+    if (!result.matched || !result.fix) {
+        console.log(`\n  ${chalk.yellow('⚠')} ${result.reason ?? 'No suggestion available.'}\n`);
+        return;
+    }
+    const fix = result.fix;
+    const sevColor = fix.severity === 'error' ? chalk.red : fix.severity === 'warning' ? chalk.yellow : chalk.dim;
+    console.log(`\n  ${chalk.bold(fix.headline)}\n`);
+    console.log(chalk.dim(`  ${sevColor(fix.severity)} · ${fix.category} · ${fix.issueId}${result.synthetic ? ' (synthetic)' : ''}\n`));
+    console.log(chalk.bold('  Why'));
+    for (const line of wrapLines(fix.why, 76))
+        console.log(`  ${line}`);
+    if (fix.where.length > 0) {
+        console.log('\n' + chalk.bold('  Where'));
+        for (const w of fix.where) {
+            const loc = w.line ? `${w.file}:${w.line}` : w.file;
+            console.log(`    ${chalk.cyan(loc)}`);
+        }
+    }
+    console.log('\n' + chalk.bold('  Action'));
+    for (const line of wrapLines(fix.instruction, 76))
+        console.log(`  ${line}`);
+    if (fix.suggestedTest) {
+        console.log('\n' + chalk.bold('  Verify'));
+        for (const line of wrapLines(fix.suggestedTest, 76))
+            console.log(`  ${line}`);
+    }
+    if (fix.relatedFiles && fix.relatedFiles.length > 0) {
+        console.log('\n' + chalk.bold('  Related files'));
+        for (const f of fix.relatedFiles)
+            console.log(`    ${chalk.cyan(f)}`);
+    }
+    console.log('');
+}
+export function reportExplainIssue(e) {
+    console.log(header('Issue Explanation'));
+    console.log(`\n  ${chalk.bold(e.title)} ${chalk.dim(`(${e.issueId})`)}`);
+    console.log(`  ${chalk.dim(`severity: ${e.severity} · category: ${e.category}`)}\n`);
+    console.log(`  ${chalk.bold(e.headline)}\n`);
+    if (e.excerpt) {
+        console.log(chalk.bold(`  Code (${e.excerpt.file} L${e.excerpt.startLine}-${e.excerpt.endLine})`));
+        for (let i = 0; i < e.excerpt.lines.length; i++) {
+            const ln = e.excerpt.startLine + i;
+            console.log(`    ${chalk.dim(String(ln).padStart(4))}  ${e.excerpt.lines[i]}`);
+        }
+        console.log('');
+    }
+    if (e.relatedIssues.length > 0) {
+        console.log(chalk.bold('  Related issues in the same area:'));
+        for (const r of e.relatedIssues)
+            console.log(`    ${chalk.dim('•')} ${r.id}: ${r.title}`);
+        console.log('');
+    }
+    if (e.similarFixes.length > 0) {
+        console.log(chalk.bold('  Past commits referencing this rule:'));
+        for (const f of e.similarFixes)
+            console.log(`    ${chalk.dim(f.sha.slice(0, 7))} ${chalk.dim(`(${f.date})`)} ${f.subject}`);
+        console.log('');
+    }
+    if (e.fix) {
+        console.log(chalk.bold('  Suggested action:'));
+        for (const line of wrapLines(e.fix.instruction, 76))
+            console.log(`  ${line}`);
+        if (e.fix.suggestedTest) {
+            console.log('\n  ' + chalk.bold('Verify:') + ' ' + e.fix.suggestedTest);
+        }
+        console.log('');
+    }
+}
+function wrapLines(text, maxWidth) {
+    const out = [];
+    for (const para of text.split(/\n+/)) {
+        if (para.length <= maxWidth) {
+            out.push(para);
+            continue;
+        }
+        const words = para.split(/\s+/);
+        let cur = '';
+        for (const w of words) {
+            if ((cur + ' ' + w).trim().length > maxWidth) {
+                if (cur)
+                    out.push(cur);
+                cur = w;
+            }
+            else {
+                cur = cur ? `${cur} ${w}` : w;
+            }
+        }
+        if (cur)
+            out.push(cur);
+    }
+    return out;
+}
+// ── Report: review ────────────────────────────────────────
+export function reportReview(report) {
+    console.log(header('PR Review'));
+    if (!report.available) {
+        console.log(`\n  ${chalk.yellow('⚠')} ${report.reason ?? 'Review unavailable.'}\n`);
+        return;
+    }
+    console.log(chalk.dim(`\n  base ${report.base.ref} (${report.base.resolvedSha?.slice(0, 7) ?? '?'}) → head ${report.head.ref} (${report.head.resolvedSha?.slice(0, 7) ?? '?'})\n`));
+    const verdictColor = report.verdict === 'block' ? chalk.red : report.verdict === 'review' ? chalk.yellow : chalk.green;
+    const verdictLabel = report.verdict === 'block' ? '🚫 BLOCK' : report.verdict === 'review' ? '👀 REVIEW' : '✅ OK';
+    console.log(`  ${chalk.bold('Verdict:')} ${verdictColor(verdictLabel)}\n`);
+    for (const s of report.summary) {
+        console.log(`  ${chalk.dim('•')} ${s}`);
+    }
+    if (report.summary.length > 0)
+        console.log('');
+    if (report.changedFiles.length > 0) {
+        console.log(chalk.bold('  Changed files (top by risk):'));
+        for (const f of report.changedFiles.slice(0, 15)) {
+            const risk = f.riskScore !== null ? f.riskScore.toFixed(1).padStart(6) : '   -  ';
+            const cc = f.cyclomaticComplexity !== null ? String(f.cyclomaticComplexity).padStart(3) : '  -';
+            const dcc = f.cyclomaticDelta === null ? '   ' : signed(f.cyclomaticDelta).padStart(3);
+            const statusColor = f.status === 'added' ? chalk.green : f.status === 'removed' ? chalk.red : chalk.yellow;
+            console.log(`    ${statusColor(f.status.padEnd(8))} risk ${risk}  CC ${cc} (Δ${dcc})  ${chalk.cyan(f.relativePath)}`);
+        }
+        if (report.changedFiles.length > 15) {
+            console.log(chalk.dim(`    ... and ${report.changedFiles.length - 15} more`));
+        }
+        console.log('');
+    }
+    if (report.newCycles.length > 0) {
+        console.log(chalk.bold(`  New / expanded cycles (${report.newCycles.length}):`));
+        for (const c of report.newCycles.slice(0, 5)) {
+            const tag = c.classification === 'new' ? chalk.red('NEW') : chalk.yellow('EXP');
+            console.log(`    ${tag} (${c.size}): ${c.files.join(' → ')}`);
+        }
+        if (report.newCycles.length > 5) {
+            console.log(chalk.dim(`    ... and ${report.newCycles.length - 5} more`));
+        }
+        console.log('');
+    }
+    if (report.riskyFunctions.length > 0) {
+        console.log(chalk.bold(`  Risky functions (${report.riskyFunctions.length}):`));
+        for (const fn of report.riskyFunctions.slice(0, 10)) {
+            const cc = fn.cyclomaticComplexity >= 15 ? chalk.red : chalk.yellow;
+            const transition = fn.baseCc === null ? `(new)` : `(${fn.baseCc} → ${fn.cyclomaticComplexity})`;
+            console.log(`    ${cc(`CC ${String(fn.cyclomaticComplexity).padStart(3)}`)} ${chalk.bold(fn.name)}  ${chalk.dim(`${fn.file}:${fn.line}`)} ${chalk.dim(`[${fn.reason}] ${transition}`)}`);
+        }
+        if (report.riskyFunctions.length > 10) {
+            console.log(chalk.dim(`    ... and ${report.riskyFunctions.length - 10} more`));
+        }
+        console.log('');
+    }
+    if (report.dependencyChanges.length > 0) {
+        console.log(chalk.bold('  Dependency changes:'));
+        for (const d of report.dependencyChanges) {
+            const wsLabel = d.workspace ? ` (${d.workspace})` : '';
+            console.log(`    ${chalk.cyan(d.manifestFile)}${chalk.dim(wsLabel)}`);
+            for (const a of d.added)
+                console.log(`      ${chalk.green('+')} ${a.name}@${a.version} ${chalk.dim(`(${a.kind})`)}`);
+            for (const r of d.removed)
+                console.log(`      ${chalk.red('-')} ${r.name}@${r.version} ${chalk.dim(`(${r.kind})`)}`);
+            for (const b of d.bumped)
+                console.log(`      ${chalk.yellow('~')} ${b.name}: ${b.from} → ${b.to} ${chalk.dim(`(${b.kind})`)}`);
+        }
+        console.log('');
+    }
+}
 // ── Report: workspaces ────────────────────────────────────
 export function reportWorkspaces(info) {
     console.log(header('Workspaces'));