projscan 0.14.0 → 0.16.0

package/dist/tool-manifest.json

@@ -1,9 +1,9 @@
 {
   "name": "projscan",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "mcpProtocolVersion": "2025-03-26",
-  "generatedAt": "2026-04-26T14:13:37.446Z",
-  "toolCount": 19,
+  "generatedAt": "2026-04-30T20:20:22.001Z",
+  "toolCount": 20,
   "tools": [
     {
       "name": "projscan_analyze",
@@ -395,6 +395,39 @@
         ]
       }
     },
+    {
+      "name": "projscan_impact",
+      "description": "Transitive blast-radius analysis. Given a `file` (repo-relative path), returns every file that transitively imports it, ranked by BFS distance (1 = direct importer). Given a `symbol` (export name), returns the symbol's definition file(s), the files that directly call it, and their transitive importers. Use this BEFORE renaming or deleting to see what breaks. Cycle-safe; depth-bounded by `max_distance` (default 10).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "file": {
+            "type": "string",
+            "description": "Repo-relative file path. Mutually exclusive with `symbol`."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Symbol (export) name. Mutually exclusive with `file`."
+          },
+          "max_distance": {
+            "type": "number",
+            "description": "Maximum BFS hops from the target. Default 10. Reports `truncated: true` when exceeded."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Opaque cursor from a previous response."
+          },
+          "page_size": {
+            "type": "number",
+            "description": "Items per page (default 50, max 500)."
+          },
+          "max_tokens": {
+            "type": "number",
+            "description": "Cap response to roughly this many tokens."
+          }
+        }
+      }
+    },
     {
       "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).",
@@ -424,6 +457,10 @@
               "hybrid"
             ]
           },
+          "sub_file": {
+            "type": "boolean",
+            "description": "0.15.0+: when true, build the semantic index per-function instead of per-file (where the language adapter extracted functions). Hits return a `function` field with name + line range. Ignored in lexical mode. Default false."
+          },
           "limit": {
             "type": "number",
             "description": "Max matches returned (default 30)."

package/dist/types.d.ts

@@ -246,7 +246,7 @@ export interface DiffResult {
     resolvedIssues: string[];
     hotspotDiff?: HotspotDiffSummary;
 }
-export type ReportFormat = 'console' | 'json' | 'markdown' | 'sarif';
+export type ReportFormat = 'console' | 'json' | 'markdown' | 'sarif' | 'html';
 export type SemverDrift = 'patch' | 'minor' | 'major' | 'same' | 'unknown';
 export interface OutdatedPackage {
     name: string;
@@ -601,6 +601,47 @@ export interface ReviewReport {
     /** One-line bullets explaining the verdict. */
     summary: string[];
 }
+/**
+ * One reachable file in an impact analysis. `distance` is BFS-hops from the
+ * input target (1 = direct dependent, 2 = dependent-of-dependent, etc).
+ * `target` itself is not included in the reachable list.
+ */
+export interface ImpactNode {
+    file: string;
+    distance: number;
+}
+export interface ImpactReport {
+    available: boolean;
+    reason?: string;
+    /** What was queried. */
+    target: {
+        kind: 'file' | 'symbol';
+        value: string;
+    };
+    /**
+     * For symbol mode: every file the graph claims defines the symbol. Empty
+     * for file mode. Useful when an agent needs to know whether a name is
+     * defined in multiple places before treating impact as authoritative.
+     */
+    definitionFiles: string[];
+    /**
+     * For symbol mode: files that directly call the symbol (their callSites
+     * contains the name). The reachable set is computed from these as roots.
+     * Empty for file mode.
+     */
+    directCallers: string[];
+    /** Sorted by distance asc, then file asc. */
+    reachable: ImpactNode[];
+    /** Convenience count of reachable files (== reachable.length). */
+    totalReachable: number;
+    /**
+     * True when traversal hit `maxDistance` before exhausting the graph.
+     * Items beyond the limit are omitted from `reachable`.
+     */
+    truncated: boolean;
+    /** The maxDistance value used for the traversal. */
+    maxDistance: number;
+}
 export interface FileInspection {
     relativePath: string;
     exists: boolean;
@@ -639,6 +680,12 @@ export interface FunctionDetail {
     /** 1-based end line. */
     endLine: number;
     cyclomaticComplexity: number;
+    /**
+     * Approximate fan-in (0.15.0+): count of other files whose `callSites`
+     * include this function's bare name. Name-based and approximate; absent
+     * when the graph couldn't compute it.
+     */
+    fanIn?: number;
 }
 export interface McpToolDefinition {
     name: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "projscan",
-  "version": "0.14.0",
-  "description": "Agent-first code intelligence. MCP server (2025-03-26) with AST parsing for JavaScript, TypeScript, Python, Go, Java, and Ruby; code graph, file + per-function AST cyclomatic complexity, coupling + cycle detection, structural PR diff, one-call PR review (projscan_review), rule-driven fix suggestions (projscan_fix_suggest, projscan_explain_issue) closing the diagnose-fix loop, monorepo workspace awareness with cross-package import policy + per-package dependencies / outdated / audit, BM25 + optional semantic search, cursor pagination, progress notifications, context-budgeted output, and a stable-surface CI guard. CLI on the side.",
+  "version": "0.16.0",
+  "description": "Agent-first code intelligence. MCP server (2025-03-26) with AST parsing for JavaScript, TypeScript, Python, Go, Java, and Ruby; code graph, file + per-function AST cyclomatic complexity, per-function fan-in, coupling + cycle detection, structural PR diff, one-call PR review (projscan_review), rule-driven fix suggestions (projscan_fix_suggest, projscan_explain_issue) closing the diagnose-fix loop, transitive blast-radius analysis (projscan_impact for files and symbols), per-function semantic search chunks (sub-file embeddings), monorepo workspace awareness with cross-package import policy + per-package dependencies / outdated / audit, BM25 + optional semantic search, cursor pagination, progress notifications, context-budgeted output, and a stable-surface CI guard. CLI on the side.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",