vibe-splain 2.7.3 → 3.1.0

package/dist/mcp/server.d.ts

@@ -1 +1 @@
-export declare function startMCPServer(): Promise<void>;
+export declare function startMCPServer(options?: any): Promise<void>;

package/dist/mcp/server.js

@@ -39,11 +39,11 @@ const TOOL_HANDLERS = {
     get_wild_discoveries: handleGetWildDiscoveries,
     mark_stale: handleMarkStale,
 };
-export async function startMCPServer() {
+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: '2.0.0' }, { capabilities: { tools: {}, prompts: {} } });
+    const server = new Server({ name: 'vibe-splain', version: '3.0.0' }, { capabilities: { tools: {}, prompts: {} } });
     // Register prompts
     server.setRequestHandler(ListPromptsRequestSchema, async () => ({
         prompts: [
@@ -143,7 +143,7 @@ When done, share the exact file:// UI link returned by scan_project. Never inven
             };
         }
         try {
-            const result = await handler((args || {}));
+            const result = await handler(args, options);
             return {
                 content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };

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

@@ -19,4 +19,4 @@ export declare const markStaleTool: {
         required: string[];
     };
 };
-export declare function handleMarkStale(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleMarkStale(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/mark_stale.js

@@ -1,4 +1,5 @@
-import { readDossier, writeDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibe-splain/brain';
+import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 export const markStaleTool = {
     name: 'mark_stale',
     description: 'Manually marks Decision Cards as stale when you detect a file has changed. The file watcher does this automatically, but call this if you modify a file yourself during a session.',
@@ -18,7 +19,7 @@ export const markStaleTool = {
         required: ['projectRoot', 'filePaths'],
     },
 };
-export async function handleMarkStale(args) {
+export async function handleMarkStale(args, options = {}) {
     const projectRoot = args.projectRoot;
     const filePaths = args.filePaths;
     if (!projectRoot || !filePaths)
@@ -48,7 +49,12 @@ export async function handleMarkStale(args) {
             dossier.stalePaths.push(filePath);
         }
     }
-    await writeDossier(projectRoot, dossier);
+    const orchestrator = new ExportOrchestrator(projectRoot);
+    await orchestrator.writeBundle(dossier, {
+        format: options.format,
+        budget: options.budget ? parseInt(options.budget, 10) : undefined,
+        scope: options.scope,
+    });
     return {
         success: true,
         staleCardsMarked: staleCount,

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

@@ -12,4 +12,4 @@ export declare const scanProjectTool: {
         required: string[];
     };
 };
-export declare function handleScanProject(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleScanProject(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/scan_project.js

@@ -1,4 +1,6 @@
-import { scanProject, writeDossier, readDossier, startWatcher } from '@vibe-splain/brain';
+import { scanProject, readDossier } from '@vibe-splain/brain';
+import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
+import { startWatcher } from '../../export/Watcher.js';
 export const scanProjectTool = {
     name: 'scan_project',
     description: 'Scans a codebase (TS/JS/Python/Go/Rust/Java) and returns a structural analysis. CALL THIS FIRST, then call get_project_map. Files are scored on two axes: GRAVITY (importance — fan-in + PageRank centrality) and HEAT (smell/tech-debt). Mockups, vendored code, and orphan files are demoted (isRealSource:false) so cards target the real application. After scanning, call get_project_map to get the fixed pillar set, Start-Here (top gravity) and Wild-Discovery (top heat) lists. The uiUrl is a file:// link — share it with the user.',
@@ -13,7 +15,7 @@ export const scanProjectTool = {
         required: ['projectRoot'],
     },
 };
-export async function handleScanProject(args) {
+export async function handleScanProject(args, options = {}) {
     const projectRoot = args.projectRoot;
     if (!projectRoot)
         throw new Error('projectRoot is required');
@@ -26,7 +28,15 @@ export async function handleScanProject(args) {
         version: '2.0.0',
         scannedAt: new Date().toISOString(),
         projectRoot,
-        map: { ...result.map, brief },
+        map: {
+            ...result.map,
+            brief,
+            validation: result.validation ? {
+                passed: result.validation.passed,
+                errors: result.validation.errors,
+                warnings: result.validation.warnings,
+            } : undefined
+        },
         pillars: existing?.pillars ?? [],
         wildDiscoveries: existing?.wildDiscoveries ?? [],
         stalePaths: existing?.stalePaths ?? [],
@@ -37,13 +47,23 @@ export async function handleScanProject(args) {
             dossier.pillars.push({ name: def.name, cardCount: 0, decisions: [] });
         }
     }
-    await writeDossier(projectRoot, dossier);
+    const orchestrator = new ExportOrchestrator(projectRoot);
+    await orchestrator.writeBundle(dossier, {
+        format: options.format,
+        budget: options.budget ? parseInt(options.budget, 10) : undefined,
+        scope: options.scope,
+    }, result.store, result.graph);
     // Watch the real-source files for staleness.
-    startWatcher(projectRoot, result.files.map(f => f.path));
+    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' };
+    let statusMsg = 'Scan complete.';
+    if (!validation.passed) {
+        statusMsg = `SCAN QUALITY WARNING: ${validation.errors} errors and ${validation.warnings} warnings found in validation report. Delta Engine automation may be blocked.`;
+    }
     return {
         ok: true,
+        message: statusMsg,
         validation: {
             passed: validation.passed,
             errors: validation.errors,

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

@@ -16,4 +16,4 @@ export declare const setProjectBriefTool: {
         required: string[];
     };
 };
-export declare function handleSetProjectBrief(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleSetProjectBrief(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/set_project_brief.js

@@ -1,4 +1,5 @@
-import { readDossier, writeDossier } from '@vibe-splain/brain';
+import { readDossier } from '@vibe-splain/brain';
+import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 export const setProjectBriefTool = {
     name: 'set_project_brief',
     description: 'Persists your 3-5 sentence project brief into the dossier (and regenerates the UI). Call this AFTER get_project_map and BEFORE writing any decision card. The brief must say: what this project IS, the real stack, and — critically — which files are the actual application vs. mockups/generated/vendored noise.',
@@ -11,7 +12,7 @@ export const setProjectBriefTool = {
         required: ['projectRoot', 'brief'],
     },
 };
-export async function handleSetProjectBrief(args) {
+export async function handleSetProjectBrief(args, options = {}) {
     const projectRoot = args.projectRoot;
     const brief = args.brief;
     if (!projectRoot || !brief)
@@ -21,7 +22,12 @@ export async function handleSetProjectBrief(args) {
         return { error: 'No project map found. Run scan_project first.' };
     }
     dossier.map.brief = brief;
-    await writeDossier(projectRoot, dossier);
+    const orchestrator = new ExportOrchestrator(projectRoot);
+    await orchestrator.writeBundle(dossier, {
+        format: options.format,
+        budget: options.budget ? parseInt(options.budget, 10) : undefined,
+        scope: options.scope,
+    });
     // Drive the loop: hand back the exact remaining worklist so the agent does
     // not stop and ask the user. Weak models treat "brief saved" as done otherwise.
     const documented = new Set([...dossier.pillars.flatMap(p => p.decisions), ...dossier.wildDiscoveries]

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

@@ -79,4 +79,4 @@ export declare const writeDecisionCardTool: {
         required: string[];
     };
 };
-export declare function handleWriteDecisionCard(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleWriteDecisionCard(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/write_decision_card.js

@@ -1,4 +1,5 @@
-import { readDossier, writeDossier, validateMermaidNodeCount, readAnalysis } from '@vibe-splain/brain';
+import { readDossier, validateMermaidNodeCount, readAnalysis } from '@vibe-splain/brain';
+import { ExportOrchestrator } from '../../export/ExportOrchestrator.js';
 import { v4 as uuidv4 } from 'uuid';
 import { createHash } from 'crypto';
 import { readFile } from 'fs/promises';
@@ -49,7 +50,7 @@ export const writeDecisionCardTool = {
         required: ['projectRoot', 'pillar', 'primaryFile', 'title', 'thesis', 'category', 'severity', 'narrative', 'confidence', 'evidence'],
     },
 };
-export async function handleWriteDecisionCard(args) {
+export async function handleWriteDecisionCard(args, options = {}) {
     const projectRoot = args.projectRoot;
     const pillar = args.pillar;
     const primaryFile = args.primaryFile;
@@ -94,9 +95,14 @@ export async function handleWriteDecisionCard(args) {
             p.decisions = p.decisions.filter(c => c.id !== existing.id);
         dossier.wildDiscoveries = dossier.wildDiscoveries.filter(c => c.id !== existing.id);
     }
-    // Auto-carry gravity/heat from the scan.
+    // ADR-019: machine-derived confidence cap
     const store = await readAnalysis(projectRoot);
     const persisted = store?.files[primaryFile];
+    const machineConfidence = persisted?.confidence || 'low';
+    const confidenceOrder = { low: 0, medium: 1, high: 2 };
+    if (confidenceOrder[confidence] > confidenceOrder[machineConfidence]) {
+        throw new Error(`Requested confidence "${confidence}" exceeds machine-derived confidence "${machineConfidence}" for this file. Ground your narrative in the MRI evidence.`);
+    }
     const gravity = persisted ? Math.round(persisted.gravity) : undefined;
     const heat = persisted ? Math.round(persisted.heat) : undefined;
     // Hash the primaryFile so the watcher can detect staleness per-file.
@@ -126,7 +132,12 @@ export async function handleWriteDecisionCard(args) {
     }
     bucket.decisions.push(card);
     bucket.cardCount = bucket.decisions.length;
-    await writeDossier(projectRoot, dossier);
+    const orchestrator = new ExportOrchestrator(projectRoot);
+    await orchestrator.writeBundle(dossier, {
+        format: options.format,
+        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)' : ''}`);
     // Keep the loop going: compute what is still undocumented.
     const documented = new Set([...dossier.pillars.flatMap(p => p.decisions), ...dossier.wildDiscoveries]