@brutalist/mcp 0.6.0 → 0.6.2

package/dist/streaming/output-parser.js

@@ -0,0 +1,349 @@
+import { logger } from '../logger.js';
+/**
+ * Advanced semantic output parser with boundary detection and content classification
+ *
+ * Key features:
+ * - State machine tracking for CLI phases
+ * - Sentence/paragraph boundary detection
+ * - Content classification (findings vs debug info)
+ * - Streaming tokenization with incomplete sentence handling
+ * - Memory-efficient circular buffering
+ */
+export class SemanticOutputParser {
+    buffer = '';
+    state;
+    // Boundary detection patterns for clean chunking
+    BOUNDARY_PATTERNS = {
+        sentence: /([.!?]+)\s+(?=[A-Z])/g,
+        paragraph: /\n\s*\n/g,
+        codeBlock: /```[\s\S]*?```/g,
+        listItem: /^\s*[-*+]\s+/gm,
+        numberedItem: /^\s*\d+\.\s+/gm
+    };
+    // Content classification patterns
+    CLASSIFICATION_PATTERNS = {
+        finding: {
+            critical: /\b(CRITICAL|SECURITY|VULNERABILITY|EXPLOIT|DANGEROUS)\b/i,
+            high: /\b(ERROR|WARNING|ISSUE|PROBLEM|BUG|FAIL)\b/i,
+            medium: /\b(CONCERN|RISK|POTENTIAL|IMPROVE|OPTIMIZE)\b/i,
+            low: /\b(SUGGESTION|CONSIDER|MINOR|STYLE)\b/i,
+            info: /\b(INFO|NOTE|TIP|FOUND|DETECTED)\b/i
+        },
+        progress: /\b(ANALYZING|SCANNING|PROCESSING|CHECKING|LOADING)\b/i,
+        debug: /\b(DEBUG|TRACE|VERBOSE|LOG)\b/i,
+        error: /\b(FAILED|CRASHED|TIMEOUT|EXCEPTION)\b/i,
+        milestone: /\b(COMPLETED?|FINISHED|DONE|SUCCESS|STARTED?)\b/i
+    };
+    // Phase transition patterns
+    PHASE_PATTERNS = {
+        starting: /\b(starting|initializing|beginning|loading)\b/i,
+        thinking: /\b(thinking|considering|planning|preparing)\b/i,
+        analyzing: /\b(analyzing|examining|reviewing|checking)\b/i,
+        outputting: /\b(found|detected|identified|discovered)\b/i,
+        complete: /\b(complete|finished|done|analysis complete)\b/i
+    };
+    constructor(agent, sessionId) {
+        this.state = {
+            phase: 'starting',
+            agent,
+            sessionId,
+            bufferSize: 0,
+            processedChunks: 0,
+            lastEventTime: Date.now()
+        };
+    }
+    /**
+     * Parse incoming CLI output chunk into semantic streaming events
+     */
+    parse(chunk, agent) {
+        if (!chunk || chunk.trim().length === 0) {
+            return [];
+        }
+        this.buffer += chunk;
+        this.state.bufferSize = this.buffer.length;
+        this.state.processedChunks++;
+        this.state.lastEventTime = Date.now();
+        const events = [];
+        // Update parser state based on content
+        this.updatePhase(chunk);
+        // Extract complete semantic units
+        const boundaries = this.detectBoundaries(this.buffer);
+        for (const segment of boundaries.complete) {
+            const event = this.createEventFromSegment(segment, agent);
+            if (event) {
+                events.push(event);
+            }
+        }
+        // Keep remaining incomplete content in buffer
+        this.buffer = boundaries.remaining;
+        this.state.bufferSize = this.buffer.length;
+        // Prevent buffer overflow
+        if (this.buffer.length > 8192) { // 8KB limit
+            logger.warn(`Parser buffer overflow for ${agent}, flushing incomplete content`);
+            const flushEvents = this.flush();
+            events.push(...flushEvents);
+        }
+        return events;
+    }
+    /**
+     * Flush any remaining content as final events
+     */
+    flush() {
+        if (!this.buffer.trim()) {
+            return [];
+        }
+        logger.debug(`Flushing remaining ${this.buffer.length} chars for ${this.state.agent}`);
+        const event = this.createEventFromSegment(this.buffer, this.state.agent);
+        this.buffer = '';
+        this.state.bufferSize = 0;
+        this.state.phase = 'complete';
+        return event ? [event] : [];
+    }
+    /**
+     * Get current parser state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Reset parser to initial state
+     */
+    reset() {
+        this.buffer = '';
+        this.state = {
+            phase: 'starting',
+            agent: this.state.agent,
+            sessionId: this.state.sessionId,
+            bufferSize: 0,
+            processedChunks: 0,
+            lastEventTime: Date.now()
+        };
+    }
+    /**
+     * Detect semantic boundaries in text for clean chunking
+     */
+    detectBoundaries(text) {
+        const complete = [];
+        let remaining = text;
+        // First, extract complete code blocks (highest priority)
+        const codeBlocks = [];
+        remaining = remaining.replace(this.BOUNDARY_PATTERNS.codeBlock, (match) => {
+            codeBlocks.push(match);
+            return '\n__CODE_BLOCK__\n';
+        });
+        // Extract complete paragraphs
+        const paragraphs = remaining.split(this.BOUNDARY_PATTERNS.paragraph);
+        for (let i = 0; i < paragraphs.length - 1; i++) {
+            const paragraph = paragraphs[i].trim();
+            if (paragraph) {
+                // Restore code blocks
+                const restored = this.restoreCodeBlocks(paragraph, codeBlocks);
+                complete.push(restored);
+            }
+        }
+        // Check if last paragraph is complete (ends with sentence boundary)
+        const lastParagraph = paragraphs[paragraphs.length - 1];
+        if (lastParagraph && this.isCompleteSentence(lastParagraph)) {
+            const restored = this.restoreCodeBlocks(lastParagraph.trim(), codeBlocks);
+            complete.push(restored);
+            remaining = '';
+        }
+        else {
+            remaining = this.restoreCodeBlocks(lastParagraph || '', codeBlocks);
+        }
+        return { complete, remaining };
+    }
+    /**
+     * Check if text ends with complete sentence
+     */
+    isCompleteSentence(text) {
+        const trimmed = text.trim();
+        return /[.!?]$/.test(trimmed) || /```\s*$/.test(trimmed);
+    }
+    /**
+     * Restore code blocks in text
+     */
+    restoreCodeBlocks(text, codeBlocks) {
+        let index = 0;
+        return text.replace(/\n__CODE_BLOCK__\n/g, () => {
+            return codeBlocks[index++] || '';
+        });
+    }
+    /**
+     * Update parser phase based on content analysis
+     */
+    updatePhase(content) {
+        for (const [phase, pattern] of Object.entries(this.PHASE_PATTERNS)) {
+            if (pattern.test(content)) {
+                this.state.phase = phase;
+                break;
+            }
+        }
+    }
+    /**
+     * Create streaming event from text segment
+     */
+    createEventFromSegment(segment, agent) {
+        const trimmed = segment.trim();
+        if (!trimmed) {
+            return null;
+        }
+        const classification = this.classifyContent(trimmed);
+        // Filter out low-value debug content
+        if (classification.type === 'debug' && classification.confidence < 0.5) {
+            return null;
+        }
+        // Determine event type based on classification
+        let eventType = 'agent_progress';
+        if (classification.type === 'finding') {
+            eventType = 'agent_progress'; // Findings are progress updates with metadata
+        }
+        else if (classification.type === 'error') {
+            eventType = 'agent_error';
+        }
+        else if (classification.type === 'milestone') {
+            eventType = this.state.phase === 'complete' ? 'agent_complete' : 'agent_progress';
+        }
+        return {
+            type: eventType,
+            agent: agent,
+            content: trimmed,
+            timestamp: Date.now(),
+            sessionId: this.state.sessionId,
+            metadata: {
+                phase: this.state.phase,
+                severity: classification.severity,
+                contentType: classification.type,
+                confidence: classification.confidence,
+                bufferSize: this.state.bufferSize,
+                processedChunks: this.state.processedChunks
+            }
+        };
+    }
+    /**
+     * Classify content to determine event type and severity
+     */
+    classifyContent(content) {
+        // Check for findings with severity
+        for (const [severity, pattern] of Object.entries(this.CLASSIFICATION_PATTERNS.finding)) {
+            if (pattern.test(content)) {
+                return {
+                    type: 'finding',
+                    severity: severity,
+                    confidence: 0.9
+                };
+            }
+        }
+        // Check for other content types
+        if (this.CLASSIFICATION_PATTERNS.progress.test(content)) {
+            return { type: 'progress', confidence: 0.8 };
+        }
+        if (this.CLASSIFICATION_PATTERNS.error.test(content)) {
+            return { type: 'error', confidence: 0.9 };
+        }
+        if (this.CLASSIFICATION_PATTERNS.milestone.test(content)) {
+            return { type: 'milestone', confidence: 0.7 };
+        }
+        if (this.CLASSIFICATION_PATTERNS.debug.test(content)) {
+            return { type: 'debug', confidence: 0.6 };
+        }
+        // Default classification
+        return { type: 'progress', confidence: 0.5 };
+    }
+}
+/**
+ * Factory for creating parsers optimized for different CLI agents
+ */
+export class ParserFactory {
+    /**
+     * Create parser optimized for specific CLI agent
+     */
+    static createParser(agent, sessionId) {
+        switch (agent) {
+            case 'claude':
+                return new ClaudeOptimizedParser(agent, sessionId);
+            case 'codex':
+                return new CodexOptimizedParser(agent, sessionId);
+            case 'gemini':
+                return new GeminiOptimizedParser(agent, sessionId);
+            default:
+                return new SemanticOutputParser(agent, sessionId);
+        }
+    }
+}
+/**
+ * Claude-optimized parser (handles thinking blocks and stream-json format)
+ */
+class ClaudeOptimizedParser extends SemanticOutputParser {
+    CLAUDE_PATTERNS = {
+        thinking: /<thinking>[\s\S]*?<\/thinking>/g,
+        streamJson: /^data: (.+)$/gm
+    };
+    parse(chunk, agent) {
+        // Handle Claude's stream-json format
+        let processedChunk = chunk;
+        const streamJsonMatches = chunk.match(this.CLAUDE_PATTERNS.streamJson);
+        if (streamJsonMatches) {
+            processedChunk = streamJsonMatches
+                .map(match => {
+                try {
+                    const jsonStr = match.replace(/^data: /, '');
+                    const data = JSON.parse(jsonStr);
+                    return data.content || '';
+                }
+                catch {
+                    return '';
+                }
+            })
+                .join(' ');
+        }
+        // Remove thinking blocks (internal reasoning)
+        processedChunk = processedChunk.replace(this.CLAUDE_PATTERNS.thinking, '');
+        return super.parse(processedChunk, agent);
+    }
+}
+/**
+ * Codex-optimized parser (handles JSON structured output)
+ */
+class CodexOptimizedParser extends SemanticOutputParser {
+    parse(chunk, agent) {
+        // Codex outputs structured JSON, extract assistant messages
+        try {
+            const lines = chunk.split('\n').filter(line => line.trim());
+            let extractedContent = '';
+            for (const line of lines) {
+                try {
+                    const data = JSON.parse(line);
+                    if (data.type === 'assistant' && data.content) {
+                        extractedContent += data.content + '\n';
+                    }
+                }
+                catch {
+                    // Not JSON, treat as raw text
+                    extractedContent += line + '\n';
+                }
+            }
+            return super.parse(extractedContent, agent);
+        }
+        catch {
+            // Fallback to regular parsing
+            return super.parse(chunk, agent);
+        }
+    }
+}
+/**
+ * Gemini-optimized parser (handles markdown and structured output)
+ */
+class GeminiOptimizedParser extends SemanticOutputParser {
+    GEMINI_PATTERNS = {
+        metadata: /^(\*\*|##|\s*-\s*)/gm,
+        thinking: /\[THINKING:[\s\S]*?\]/g
+    };
+    parse(chunk, agent) {
+        // Remove Gemini's thinking annotations
+        let processedChunk = chunk.replace(this.GEMINI_PATTERNS.thinking, '');
+        // Gemini often uses markdown formatting, preserve structure
+        return super.parse(processedChunk, agent);
+    }
+}
+//# sourceMappingURL=output-parser.js.map

package/dist/streaming/output-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.js","sourceRoot":"","sources":["../../src/streaming/output-parser.ts"],"names":[],"mappings":"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"}

package/dist/streaming/progress-tracker.d.ts

@@ -0,0 +1,149 @@
+import { EventEmitter } from 'events';
+import { StreamingEvent } from '../cli-agents.js';
+/**
+ * Analysis progress phases with detailed milestones
+ */
+export declare enum AnalysisPhase {
+    INITIALIZING = "initializing",
+    COLLECTING_DATA = "collecting_data",
+    ANALYZING = "analyzing",
+    PROCESSING_RESULTS = "processing_results",
+    GENERATING_REPORT = "generating_report",
+    COMPLETE = "complete",
+    ERROR = "error"
+}
+/**
+ * Progress milestone definition
+ */
+export interface ProgressMilestone {
+    id: string;
+    phase: AnalysisPhase;
+    name: string;
+    description: string;
+    estimatedDuration?: number;
+    weight: number;
+    dependencies?: string[];
+    optional?: boolean;
+}
+/**
+ * Progress state tracking
+ */
+export interface ProgressState {
+    currentPhase: AnalysisPhase;
+    overallProgress: number;
+    phaseProgress: number;
+    completedMilestones: Set<string>;
+    currentMilestone?: ProgressMilestone;
+    startTime: number;
+    lastUpdate: number;
+    estimatedCompletion?: number;
+    errors: string[];
+}
+/**
+ * Progress event emitted for tracking
+ */
+export interface ProgressEvent {
+    type: 'milestone_started' | 'milestone_completed' | 'phase_changed' | 'progress_updated' | 'analysis_complete' | 'analysis_error';
+    sessionId: string;
+    timestamp: number;
+    phase: AnalysisPhase;
+    milestone?: ProgressMilestone;
+    progress: {
+        overall: number;
+        phase: number;
+    };
+    estimatedCompletion?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Analysis type-specific milestone definitions
+ */
+export declare const ANALYSIS_MILESTONES: Record<string, ProgressMilestone[]>;
+/**
+ * Progress milestone system with intelligent phase detection
+ *
+ * Features:
+ * - Dynamic milestone tracking based on analysis type
+ * - Intelligent progress estimation with dependencies
+ * - Phase transition detection from CLI output
+ * - ETA calculation with adaptive learning
+ * - Progress events for real-time updates
+ */
+export declare class ProgressTracker extends EventEmitter {
+    private state;
+    private milestones;
+    private sessionId;
+    private analysisType;
+    private readonly PHASE_PATTERNS;
+    private readonly MILESTONE_TRIGGERS;
+    constructor(sessionId: string, analysisType: string);
+    /**
+     * Process streaming event and update progress
+     */
+    processEvent(event: StreamingEvent): void;
+    /**
+     * Detect current phase from CLI output content
+     */
+    private detectPhaseFromContent;
+    /**
+     * Detect milestone completion from content
+     */
+    private detectMilestonesFromContent;
+    /**
+     * Transition to new phase
+     */
+    private transitionToPhase;
+    /**
+     * Complete a milestone
+     */
+    private completeMilestone;
+    /**
+     * Check if milestone dependencies are met
+     */
+    private areDependenciesMet;
+    /**
+     * Check if milestone should be auto-completed
+     */
+    private shouldAutoCompleteMilestone;
+    /**
+     * Auto-complete milestones from previous phases
+     */
+    private autoCompletePreviousPhaseMilestones;
+    /**
+     * Update progress calculations
+     */
+    private updateProgress;
+    /**
+     * Update estimated completion time
+     */
+    private updateEstimatedCompletion;
+    /**
+     * Handle error in analysis
+     */
+    private handleError;
+    /**
+     * Mark analysis as complete
+     */
+    markComplete(): void;
+    /**
+     * Emit progress event
+     */
+    private emitProgressEvent;
+    /**
+     * Get current progress state
+     */
+    getState(): ProgressState;
+    /**
+     * Get progress summary for display
+     */
+    getProgressSummary(): {
+        phase: string;
+        overallProgress: number;
+        phaseProgress: number;
+        currentMilestone?: string;
+        estimatedTimeRemaining?: number;
+        completedMilestones: number;
+        totalMilestones: number;
+    };
+}
+//# sourceMappingURL=progress-tracker.d.ts.map

package/dist/streaming/progress-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.d.ts","sourceRoot":"","sources":["../../src/streaming/progress-tracker.ts"],"names":[],"mappings":"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"}