projscan 3.8.0 → 4.1.0

package/dist/tool-manifest.json

@@ -1,9 +1,9 @@
 {
   "name": "projscan",
-  "version": "3.8.0",
+  "version": "4.1.0",
   "mcpProtocolVersion": "2025-03-26",
-  "generatedAt": "2026-06-05T16:37:40.687Z",
-  "toolCount": 47,
+  "generatedAt": "2026-06-09T11:31:15.828Z",
+  "toolCount": 45,
   "tools": [
     {
       "name": "projscan_analyze",
@@ -76,22 +76,6 @@
         }
       }
     },
-    {
-      "name": "projscan_explain",
-      "description": "[DEPRECATED since 3.8.0, removed in 4.0 — use projscan_file] 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"
-        ]
-      }
-    },
     {
       "name": "projscan_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.",
@@ -226,57 +210,50 @@
       }
     },
     {
-      "name": "projscan_graph",
-      "description": "[DEPRECATED since 3.8.0, removed in 4.0 — use projscan_semantic_graph] Query the AST-based code graph directly. Returns imports, exports, importers, or symbol definitions for a file or symbol. Agents should prefer this over analyze/doctor/explain for targeted structural questions - it is much cheaper and more accurate.",
+      "name": "projscan_semantic_graph",
+      "description": "The code graph, two ways. With no `query`: returns the stable v3 semantic graph (file/function/package/symbol nodes plus imports, exports, defines, and calls edges). With `query`: answers one cheap, targeted question instead of serializing the whole graph — who imports a file, what a file imports/exports, where a symbol is defined, or which files import a package. (The targeted mode subsumes the former projscan_graph tool, removed in 4.0.)",
       "inputSchema": {
         "type": "object",
         "properties": {
-          "file": {
-            "type": "string",
-            "description": "File path (relative to project root) to query."
-          },
-          "symbol": {
-            "type": "string",
-            "description": "Symbol name to query (e.g. a function or class). Use instead of `file` to find where a symbol is defined."
-          },
-          "direction": {
-            "type": "string",
-            "description": "What to return: \"imports\" (what the file imports), \"exports\" (what the file exports), \"importers\" (who imports the file), \"symbol_defs\" (files defining the symbol), \"package_importers\" (files importing a package by name).",
-            "enum": [
-              "imports",
-              "exports",
-              "importers",
-              "symbol_defs",
-              "package_importers"
+          "query": {
+            "type": "object",
+            "description": "Optional. Ask one targeted question instead of returning the whole graph.",
+            "properties": {
+              "direction": {
+                "type": "string",
+                "enum": [
+                  "imports",
+                  "exports",
+                  "importers",
+                  "symbol_defs",
+                  "package_importers"
+                ],
+                "description": "\"imports\" (what the file imports), \"exports\" (what the file exports), \"importers\" (who imports the file), \"symbol_defs\" (files defining the symbol), \"package_importers\" (files importing a package by name)."
+              },
+              "file": {
+                "type": "string",
+                "description": "Repo-relative file path (for imports/exports/importers)."
+              },
+              "symbol": {
+                "type": "string",
+                "description": "Symbol or package name (for symbol_defs/package_importers)."
+              },
+              "limit": {
+                "type": "number",
+                "description": "Max entries returned (default 50, max 500)."
+              }
+            },
+            "required": [
+              "direction"
             ]
           },
-          "limit": {
-            "type": "number",
-            "description": "Max entries returned (default 50)."
-          },
-          "max_tokens": {
-            "type": "number",
-            "description": "Cap the response to roughly this many tokens."
-          }
-        },
-        "required": [
-          "direction"
-        ]
-      }
-    },
-    {
-      "name": "projscan_semantic_graph",
-      "description": "Return the stable v3 semantic graph: file/function/package/symbol nodes plus imports, exports, defines, and calls edges. Use when an agent needs one normalized graph contract instead of several targeted graph queries.",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
           "max_nodes": {
             "type": "number",
-            "description": "Maximum graph nodes to return. Default 10000."
+            "description": "Full-graph mode only. Maximum graph nodes to return. Default 10000."
           },
           "max_edges": {
             "type": "number",
-            "description": "Maximum graph edges to return. Default 25000."
+            "description": "Full-graph mode only. Maximum graph edges to return. Default 25000."
           },
           "max_tokens": {
             "type": "number",
@@ -1070,6 +1047,10 @@
             ],
             "description": "Workflow mode to orient around. Default: before_edit."
           },
+          "intent": {
+            "type": "string",
+            "description": "Plain-language goal to route into the next best action and proof commands."
+          },
           "max_tasks": {
             "type": "number",
             "description": "Maximum workplan tasks to inspect. Default: 5, max: 12."

package/dist/types.d.ts

@@ -54,6 +54,8 @@ export interface DependencyReport {
     dependencies: Record<string, string>;
     devDependencies: Record<string, string>;
     risks: DependencyRisk[];
+    licenses?: DependencyLicenseSummary;
+    sizes?: DependencySizeSummary;
     /**
      * Per-workspace breakdown when scanning a monorepo (0.13.0+). Absent for
      * single-package repos. The top-level `totalDependencies`,
@@ -70,6 +72,36 @@ export interface DependencyReport {
         risks: DependencyRisk[];
     }>;
 }
+export interface DependencyLicenseEntry {
+    name: string;
+    version: string;
+    scope: 'production' | 'development';
+    license: string | null;
+    workspace?: string;
+}
+export interface DependencyLicenseSummary {
+    packages: DependencyLicenseEntry[];
+    byLicense: Record<string, number>;
+    unknown: string[];
+    copyleft: DependencyLicenseEntry[];
+    noticeCandidates: DependencyLicenseEntry[];
+}
+export interface DependencySizeEntry {
+    name: string;
+    version: string;
+    scope: 'production' | 'development';
+    bytes: number | null;
+    formatted: string;
+    installed: boolean;
+    workspace?: string;
+}
+export interface DependencySizeSummary {
+    packages: DependencySizeEntry[];
+    largest: DependencySizeEntry[];
+    totalBytes: number;
+    formattedTotal: string;
+    missing: string[];
+}
 export interface DependencyRisk {
     name: string;
     reason: string;
@@ -668,11 +700,61 @@ export interface StartFirstTenMinutes {
     outcome: string;
     commands: StartFirstTenMinutesStep[];
 }
+export type StartModeSource = 'explicit' | 'intent' | 'default';
+export type StartMissionControlStatus = 'ready' | 'needs_setup' | 'needs_attention' | 'blocked';
+export interface StartRoutedIntent {
+    intent: string;
+    category: string;
+    tool: string;
+    cli: string;
+    why: string;
+    example: string;
+    confidence: 'high' | 'medium' | 'low';
+    rank: number;
+    score: number;
+    matchedKeywords: string[];
+}
+export interface StartUnresolvedInput {
+    name: string;
+    placeholder: string;
+    sourceAction: string;
+    instruction: string;
+}
+export interface StartMissionHandoff {
+    nextAction: PreflightSuggestedAction;
+    readyActions: PreflightSuggestedAction[];
+    needsInput: StartUnresolvedInput[];
+    doneWhen: string[];
+    readyProof: {
+        summary: string;
+        commands: string[];
+    };
+}
+export interface StartMissionControl {
+    intent?: string;
+    status: StartMissionControlStatus;
+    headline: string;
+    whyNow: string;
+    primaryAction: PreflightSuggestedAction;
+    actionPlan: PreflightSuggestedAction[];
+    readyActions: PreflightSuggestedAction[];
+    routedIntent?: StartRoutedIntent;
+    alternatives?: StartRoutedIntent[];
+    unresolvedInputs: StartUnresolvedInput[];
+    guardrails: PreflightSuggestedAction[];
+    successCriteria: string[];
+    proofSummary: string;
+    proofCommands: string[];
+    handoff: StartMissionHandoff;
+    handoffPrompt: string;
+}
 export interface StartReport {
     schemaVersion: 1;
     readOnly: true;
     rootPath: string;
     mode: WorkplanMode;
+    modeSource: StartModeSource;
+    modeReason: string;
     summary: string;
     setup: {
         overall: 'pass' | 'warn' | 'fail' | 'info';
@@ -687,6 +769,7 @@ export interface StartReport {
     };
     recommendedWorkflow: StartWorkflowRecommendation;
     firstTenMinutes: StartFirstTenMinutes;
+    missionControl: StartMissionControl;
     coordinationHints: SessionCoordinationHint[];
     evidence: {
         workplanVerdict: PreflightVerdict;