vibe-splain 3.4.2 → 4.0.0

package/dist/mcp/server.js

@@ -1,7 +1,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { initParser } from '@vibe-splain/brain';
+import { initParser } from '@vibesplain/brain';
 import { handleScanProject, scanProjectTool } from './tools/scan_project.js';
 import { handleGetProjectMap, getProjectMapTool } from './tools/get_project_map.js';
 import { handleSetProjectBrief, setProjectBriefTool } from './tools/set_project_brief.js';
@@ -11,16 +11,6 @@ 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 { handleGetFileSkeleton, getFileSkeletonTool } from './tools/get_file_skeleton.js';
-import { handleReadFile, readFileTool } from './tools/read_file.js';
-import { handleCreateWorkOrder, createWorkOrderTool, handleSpawnWorker, spawnWorkerTool } from './tools/work_orders.js';
-import { handleSetSessionScope, setSessionScopeTool } from './tools/set_session_scope.js';
-import { handleYieldForScopeExpansion, yieldForScopeExpansionTool } from './tools/yield_for_scope_expansion.js';
-import { handleGetStartHere, getStartHereTool } from './tools/hydration/get_start_here.js';
-import { handleGetProjectSummary, getProjectSummaryTool } from './tools/hydration/get_project_summary.js';
-import { handleGetEvidenceSlice, getEvidenceSliceTool } from './tools/hydration/get_evidence_slice.js';
-import { handlePrepareTaskContext, prepareTaskContextTool } from './tools/prepareTaskContext.js';
-import { handleExplainSpecialistScope, explainSpecialistScopeTool } from './tools/explainSpecialistScope.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.
@@ -34,21 +24,6 @@ const ALL_TOOLS = [
     inspectPillarTool,
     getWildDiscoveriesTool,
     markStaleTool,
-    // Phase 2: Skeletons + Hydration
-    getFileSkeletonTool,
-    readFileTool,
-    getStartHereTool,
-    getProjectSummaryTool,
-    getEvidenceSliceTool,
-    // Phase 3: Worker Delegation
-    createWorkOrderTool,
-    spawnWorkerTool,
-    // Phase 4: Scope & Escalation
-    setSessionScopeTool,
-    yieldForScopeExpansionTool,
-    // Specialist Network v0
-    prepareTaskContextTool,
-    explainSpecialistScopeTool,
 ];
 const TOOL_HANDLERS = {
     scan_project: handleScanProject,
@@ -60,33 +35,18 @@ const TOOL_HANDLERS = {
     inspect_pillar: handleInspectPillar,
     get_wild_discoveries: handleGetWildDiscoveries,
     mark_stale: handleMarkStale,
-    // Phase 2
-    get_file_skeleton: handleGetFileSkeleton,
-    read_file: handleReadFile,
-    get_start_here: handleGetStartHere,
-    get_project_summary: handleGetProjectSummary,
-    get_evidence_slice: handleGetEvidenceSlice,
-    // Phase 3
-    create_work_order: handleCreateWorkOrder,
-    spawn_worker: handleSpawnWorker,
-    // Phase 4
-    set_session_scope: handleSetSessionScope,
-    yield_for_scope_expansion: handleYieldForScopeExpansion,
-    // Specialist Network v0
-    vibe_prepare_task_context: handlePrepareTaskContext,
-    vibe_explain_specialist_scope: handleExplainSpecialistScope,
 };
 export async function startMCPServer(options = {}) {
     // Initialize Tree-Sitter WASM once at startup
     await initParser();
-    console.error('[vibe-splain] Tree-Sitter parser initialized');
-    const server = new Server({ name: 'vibe-splain', version: '3.0.0' }, { capabilities: { tools: {}, prompts: {} } });
+    console.error('[vibesplain] Tree-Sitter parser initialized');
+    const server = new Server({ name: 'vibesplain', version: '4.0.0' }, { capabilities: { tools: {}, prompts: {} } });
     // Register prompts
     server.setRequestHandler(ListPromptsRequestSchema, async () => ({
         prompts: [
             {
                 name: 'build_dossier',
-                description: 'Build a full architectural dossier using vibe-splain (replaces the need to copy-paste the README prompt)',
+                description: 'Build a full architectural dossier using vibesplain (replaces the need to copy-paste the README prompt)',
             }
         ]
     }));
@@ -187,7 +147,7 @@ When done, share the exact file:// UI link returned by scan_project. Never inven
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            console.error(`[vibe-splain] Tool ${name} error:`, message);
+            console.error(`[vibesplain] Tool ${name} error:`, message);
             return {
                 content: [{ type: 'text', text: `Error: ${message}` }],
                 isError: true,
@@ -196,7 +156,7 @@ When done, share the exact file:// UI link returned by scan_project. Never inven
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('[vibe-splain] MCP server running on stdio');
+    console.error('[vibesplain] MCP server running on stdio');
     // Process stays alive — do NOT call process.exit() here
 }
 //# sourceMappingURL=server.js.map

package/dist/mcp/tools/get_file_context.js

@@ -1,6 +1,6 @@
 import { readFile } from 'fs/promises';
 import { join, relative, isAbsolute } from 'path';
-import { getFileAnalysis, readAnalysis } from '@vibe-splain/brain';
+import { getFileAnalysis, readAnalysis } from '@vibesplain/brain';
 export const getFileContextTool = {
     name: 'get_file_context',
     description: 'Returns PRE-EXTRACTED evidence for a file so you do not have to read the whole thing and paraphrase its header comment. Returns: gravity/heat scores + signals, importedBy (named fan-in — use this for blastRadius), hotSpans (the gnarliest function bodies, comment-stripped, each with a reason), smellSpans (located tech debt with ±3 lines of context), and signature (the exported API surface). Base your evidence on hotSpans/smellSpans — NEVER on header comments. Pass { full: true } only if you truly need the raw source.',

package/dist/mcp/tools/get_project_map.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 export const getProjectMapTool = {
     name: 'get_project_map',
     description: 'Returns the project map produced by scan_project: the detected stack, entrypoints, the FIXED set of architectural pillars (you may NOT invent others — write_decision_card rejects unknown pillars), the Start-Here files (highest gravity = most depended-upon), and the Wild-Discovery candidates (highest heat = most tech debt). BEFORE writing any card you MUST: read this map, write a 3-5 sentence project brief, and persist it via set_project_brief.',

package/dist/mcp/tools/get_strategic_overview.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 export const getStrategicOverviewTool = {
     name: 'get_strategic_overview',
     description: 'Returns the current state of the dossier without evidence snippets (to save tokens). Use this to see what has already been analyzed and what is stale. Check stalePaths to know which files need re-analysis.',

package/dist/mcp/tools/get_wild_discoveries.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 export const getWildDiscoveriesTool = {
     name: 'get_wild_discoveries',
     description: 'Returns Decision Cards that are both high-heat (heat ≥ 60) AND/OR high-severity (severity ≥ 4) — the files that are load-bearing AND smelly. These are the highest-leverage things to understand and fix first.',

package/dist/mcp/tools/inspect_pillar.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 export const inspectPillarTool = {
     name: 'inspect_pillar',
     description: 'Returns all Decision Cards for a specific pillar including full evidence snippets. Use when you need deep detail on a specific area of the codebase.',

package/dist/mcp/tools/mark_stale.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 export const markStaleTool = {
     name: 'mark_stale',

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

@@ -1,5 +1,5 @@
-import { scanProject } from '@vibe-splain/brain';
-import type { Dossier } from '@vibe-splain/brain';
+import { scanProject } from '@vibesplain/brain';
+import type { Dossier } from '@vibesplain/brain';
 export declare const scanProjectTool: {
     name: string;
     description: string;
@@ -24,7 +24,6 @@ export interface ScanRun {
     result: Awaited<ReturnType<typeof scanProject>>;
     dossier: Dossier;
     scanId: string;
-    manifestPointer: unknown;
 }
 export declare function performScan(projectRoot: string, options?: any): Promise<ScanRun>;
 export declare function handleScanProject(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/scan_project.js

@@ -1,4 +1,4 @@
-import { scanProject, readDossier } from '@vibe-splain/brain';
+import { scanProject, readDossier } from '@vibesplain/brain';
 import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 import { startWatcher } from '../../export/Watcher.js';
 export const scanProjectTool = {
@@ -45,32 +45,31 @@ export async function performScan(projectRoot, options = {}) {
     }
     const scanId = `scan_${Date.now()}`;
     const orchestrator = new ExportOrchestrator(projectRoot);
-    const { manifestPointer } = await orchestrator.writeBundle(dossier, {
+    await orchestrator.writeBundle(dossier, {
         format: options.format,
         budget: options.budget ? parseInt(options.budget, 10) : undefined,
         scope: options.scope,
-    }, result.store, result.graph, scanId);
-    return { result, dossier, scanId, manifestPointer };
+    }, result.store, result.graph);
+    return { result, dossier, scanId };
 }
 export async function handleScanProject(args, options = {}) {
     const projectRoot = args.projectRoot;
     if (!projectRoot)
         throw new Error('projectRoot is required');
-    console.error(`[vibe-splain] Scanning project: ${projectRoot}`);
-    const { result, scanId, manifestPointer } = await performScan(projectRoot, options);
+    console.error(`[vibesplain] Scanning project: ${projectRoot}`);
+    const { result, scanId } = await performScan(projectRoot, options);
     // Watch the real-source files for staleness. MCP serve mode keeps this alive
     // for the session; headless callers pass watch:false so the persistent
     // chokidar watcher never pins the event loop open and the process can exit.
     if (options.watch !== false) {
         await startWatcher(projectRoot, result.files.map(f => f.path));
     }
-    console.error(`[vibe-splain] Scan complete. ${result.totalFilesScanned} files, ${result.realSourceCount} real-source, ${result.wildCandidates.length} wild candidates.`);
-    const validation = result.validation ?? { passed: true, errors: 0, warnings: 0, reportPath: '.vibe-splainer/validation_report.json' };
+    console.error(`[vibesplain] Scan complete. ${result.totalFilesScanned} files, ${result.realSourceCount} real-source, ${result.wildCandidates.length} wild candidates.`);
+    const validation = result.validation ?? { passed: true, errors: 0, warnings: 0, reportPath: '.vibesplain/validation_report.json' };
     return {
         ok: true,
         message: 'Scan complete.',
         scanId,
-        manifestPointer,
         validation: result.fullValidationReport || {
             passed: validation.passed,
             errors: validation.errors,
@@ -78,10 +77,10 @@ export async function handleScanProject(args, options = {}) {
             reportPath: validation.reportPath,
         },
         artifacts: {
-            analysis: '.vibe-splainer/analysis.json',
-            dossier: '.vibe-splainer/dossier.json',
-            graph: '.vibe-splainer/graph.json',
-            html: '.vibe-splainer/ui/index.html',
+            analysis: '.vibesplain/analysis.json',
+            dossier: '.vibesplain/dossier.json',
+            graph: '.vibesplain/graph.json',
+            html: '.vibesplain/ui/index.html',
         },
         projectRoot: result.projectRoot,
         totalFilesScanned: result.totalFilesScanned,

package/dist/mcp/tools/set_project_brief.js

@@ -1,4 +1,4 @@
-import { readDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibesplain/brain';
 import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 export const setProjectBriefTool = {
     name: 'set_project_brief',

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

@@ -1,4 +1,4 @@
-import type { CardCategory } from '@vibe-splain/brain';
+import type { CardCategory } from '@vibesplain/brain';
 export declare const writeDecisionCardTool: {
     name: string;
     description: string;

package/dist/mcp/tools/write_decision_card.js

@@ -1,4 +1,4 @@
-import { readDossier, validateMermaidNodeCount, readAnalysis } from '@vibe-splain/brain';
+import { readDossier, validateMermaidNodeCount, readAnalysis } from '@vibesplain/brain';
 import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 import { v4 as uuidv4 } from 'uuid';
 import { createHash } from 'crypto';
@@ -138,7 +138,7 @@ export async function handleWriteDecisionCard(args, options = {}) {
         budget: options.budget ? parseInt(options.budget, 10) : undefined,
         scope: options.scope,
     });
-    console.error(`[vibe-splain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? ' (Wild Discovery)' : ''}`);
+    console.error(`[vibesplain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? ' (Wild Discovery)' : ''}`);
     // Keep the loop going: compute what is still undocumented.
     const documented = new Set([...dossier.pillars.flatMap(p => p.decisions), ...dossier.wildDiscoveries]
         .map(c => c.primaryFile).filter(Boolean));