vibe-splain 2.5.0 → 2.7.0

package/dist/mcp/server.js

@@ -11,6 +11,7 @@ import { handleGetStrategicOverview, getStrategicOverviewTool } from './tools/ge
 import { handleInspectPillar, inspectPillarTool } from './tools/inspect_pillar.js';
 import { handleGetWildDiscoveries, getWildDiscoveriesTool } from './tools/get_wild_discoveries.js';
 import { handleMarkStale, markStaleTool } from './tools/mark_stale.js';
+import { handleGetCallChain, getCallChainTool } from './tools/get_call_chain.js';
 // ⚠️ CRITICAL: Never use console.log() anywhere in this codebase.
 // stdout is owned by the MCP SDK for protocol messages.
 // Use console.error() for all diagnostic output.
@@ -19,6 +20,7 @@ const ALL_TOOLS = [
     getProjectMapTool,
     setProjectBriefTool,
     getFileContextTool,
+    getCallChainTool,
     writeDecisionCardTool,
     getStrategicOverviewTool,
     inspectPillarTool,
@@ -30,6 +32,7 @@ const TOOL_HANDLERS = {
     get_project_map: handleGetProjectMap,
     set_project_brief: handleSetProjectBrief,
     get_file_context: handleGetFileContext,
+    get_call_chain: handleGetCallChain,
     write_decision_card: handleWriteDecisionCard,
     get_strategic_overview: handleGetStrategicOverview,
     inspect_pillar: handleInspectPillar,

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

@@ -0,0 +1,42 @@
+export declare const getCallChainTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectRoot: {
+                type: string;
+            };
+            entrypointPath: {
+                type: string;
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                description: string;
+            };
+            targetActionKind: {
+                type: string;
+                description: string;
+            };
+            targetModel: {
+                type: string;
+                description: string;
+            };
+            targetOperation: {
+                type: string;
+                description: string;
+            };
+            targetFunctionName: {
+                type: string;
+                description: string;
+            };
+            includeTests: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetCallChain(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/get_call_chain.js

@@ -0,0 +1,50 @@
+import { traverseCallChain } from '@vibe-splain/brain';
+export const getCallChainTool = {
+    name: 'get_call_chain',
+    description: `Trace how behavior is reached from an entrypoint by following function call edges through the codebase. Returns a step-by-step chain with exact function names, file paths, line numbers, action kinds, and evidence text. Every edge has a confidence level; unresolved edges are listed explicitly.
+
+Use structured filters when you know the target:
+  targetModel + targetOperation: "where does Booking get created?"
+  targetActionKind: "where is auth enforced?"  
+  targetFunctionName: "how is function X reached?"
+No filter returns the full call tree up to maxDepth.
+
+Run scan_project first — this tool reads from the generated action_bindings.json.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectRoot: { type: 'string' },
+            entrypointPath: { type: 'string', description: 'Relative path to the entrypoint file' },
+            maxDepth: { type: 'number', description: 'Max traversal depth. Default 6, max 12.' },
+            targetActionKind: { type: 'string', description: 'Stop at this semantic action kind.' },
+            targetModel: { type: 'string', description: 'Stop at functions touching this model.' },
+            targetOperation: { type: 'string', description: 'Narrow targetModel to this operation.' },
+            targetFunctionName: { type: 'string', description: 'Stop at a specific function name.' },
+            includeTests: { type: 'boolean', description: 'Include test files in traversal. Default false.' },
+        },
+        required: ['projectRoot', 'entrypointPath'],
+    },
+};
+export async function handleGetCallChain(args) {
+    const projectRoot = args.projectRoot;
+    const entrypointPath = args.entrypointPath;
+    if (!projectRoot || !entrypointPath)
+        throw new Error('projectRoot and entrypointPath are required');
+    const getCallChainArgs = {
+        entrypointPath,
+        maxDepth: typeof args.maxDepth === 'number' ? args.maxDepth : undefined,
+        targetActionKind: typeof args.targetActionKind === 'string' ? args.targetActionKind : undefined,
+        targetModel: typeof args.targetModel === 'string' ? args.targetModel : undefined,
+        targetOperation: typeof args.targetOperation === 'string' ? args.targetOperation : undefined,
+        targetFunctionName: typeof args.targetFunctionName === 'string' ? args.targetFunctionName : undefined,
+        includeTests: typeof args.includeTests === 'boolean' ? args.includeTests : undefined,
+    };
+    try {
+        const result = await traverseCallChain(projectRoot, getCallChainArgs);
+        return result;
+    }
+    catch (error) {
+        throw new Error(`get_call_chain failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=get_call_chain.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-splain",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Architectural dossier engine for vibe-coded TypeScript/JavaScript projects. Runs as an MCP server inside your coding agent.",
   "type": "module",
   "license": "MIT",