@litmers/cursorflow-orchestrator 0.1.12 → 0.1.14

package/dist/utils/enhanced-logger.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Enhanced Logger - Comprehensive terminal output capture and management
+ *
+ * Features:
+ * - ANSI escape sequence stripping for clean logs
+ * - Automatic timestamps on each line
+ * - Log rotation and size management
+ * - Session headers with context
+ * - Raw and clean log file options
+ * - Structured JSON logs for programmatic access
+ * - Streaming output support for real-time capture
+ */
+import { Transform, TransformCallback } from 'stream';
+import { EnhancedLogConfig } from './types';
+export { EnhancedLogConfig } from './types';
+export declare const DEFAULT_LOG_CONFIG: EnhancedLogConfig;
+/**
+ * Streaming JSON Parser - Parses cursor-agent stream-json output
+ * and combines tokens into readable messages
+ */
+export declare class StreamingMessageParser {
+    private currentMessage;
+    private currentRole;
+    private messageStartTime;
+    private onMessage;
+    constructor(onMessage: (msg: ParsedMessage) => void);
+    /**
+     * Parse a line of JSON output from cursor-agent
+     */
+    parseLine(line: string): void;
+    private handleJsonMessage;
+    /**
+     * Flush accumulated message
+     */
+    flush(): void;
+    private emitMessage;
+}
+export interface ParsedMessage {
+    type: 'system' | 'user' | 'assistant' | 'tool' | 'tool_result' | 'result';
+    role: string;
+    content: string;
+    timestamp: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Strip ANSI escape sequences from text
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Format timestamp based on format preference
+ */
+export declare function formatTimestamp(format: 'iso' | 'relative' | 'short', startTime?: number): string;
+/**
+ * JSON log entry structure
+ */
+export interface JsonLogEntry {
+    timestamp: string;
+    level: 'stdout' | 'stderr' | 'info' | 'error' | 'debug' | 'session';
+    source?: string;
+    task?: string;
+    lane?: string;
+    message: string;
+    raw?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Session context for logging
+ */
+export interface LogSession {
+    id: string;
+    laneName: string;
+    taskName?: string;
+    model?: string;
+    startTime: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Transform stream that strips ANSI and adds timestamps
+ */
+export declare class CleanLogTransform extends Transform {
+    private config;
+    private session;
+    private buffer;
+    constructor(config: EnhancedLogConfig, session: LogSession);
+    _transform(chunk: Buffer, encoding: BufferEncoding, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+}
+/**
+ * Enhanced Log Manager - Manages log files with rotation and multiple outputs
+ */
+export declare class EnhancedLogManager {
+    private config;
+    private session;
+    private logDir;
+    private cleanLogPath;
+    private rawLogPath;
+    private jsonLogPath;
+    private readableLogPath;
+    private cleanLogFd;
+    private rawLogFd;
+    private jsonLogFd;
+    private readableLogFd;
+    private cleanLogSize;
+    private rawLogSize;
+    private cleanTransform;
+    private streamingParser;
+    private lineBuffer;
+    constructor(logDir: string, session: LogSession, config?: Partial<EnhancedLogConfig>);
+    /**
+     * Initialize log files and write session headers
+     */
+    private initLogFiles;
+    /**
+     * Write a parsed message to the readable log
+     */
+    private writeReadableMessage;
+    /**
+     * Indent text with a prefix
+     */
+    private indentText;
+    /**
+     * Write session header to logs
+     */
+    private writeSessionHeader;
+    /**
+     * Rotate log file if it exceeds max size
+     */
+    private rotateIfNeeded;
+    /**
+     * Rotate a log file
+     */
+    private rotateLog;
+    /**
+     * Write to clean log with size tracking
+     */
+    private writeToCleanLog;
+    /**
+     * Write to raw log with size tracking
+     */
+    private writeToRawLog;
+    /**
+     * Write a JSON log entry
+     */
+    private writeJsonEntry;
+    /**
+     * Write stdout data
+     */
+    writeStdout(data: Buffer | string): void;
+    /**
+     * Parse streaming JSON data for readable log
+     */
+    private parseStreamingData;
+    /**
+     * Write stderr data
+     */
+    writeStderr(data: Buffer | string): void;
+    /**
+     * Write a custom log entry
+     */
+    log(level: 'info' | 'error' | 'debug', message: string, metadata?: Record<string, any>): void;
+    /**
+     * Add a section marker
+     */
+    section(title: string): void;
+    /**
+     * Update task context
+     */
+    setTask(taskName: string, model?: string): void;
+    /**
+     * Check if a log line is noise (progress bars, spinners, etc.)
+     */
+    private isNoiseLog;
+    /**
+     * Get paths to all log files
+     */
+    getLogPaths(): {
+        clean: string;
+        raw?: string;
+        json?: string;
+        readable: string;
+    };
+    /**
+     * Create file descriptors for process stdio redirection
+     */
+    getFileDescriptors(): {
+        stdout: number;
+        stderr: number;
+    };
+    /**
+     * Close all log files
+     */
+    close(): void;
+    /**
+     * Format duration for display
+     */
+    private formatDuration;
+}
+/**
+ * Create a log manager for a lane
+ */
+export declare function createLogManager(laneRunDir: string, laneName: string, config?: Partial<EnhancedLogConfig>): EnhancedLogManager;
+/**
+ * Read and parse JSON log file
+ */
+export declare function readJsonLog(logPath: string): JsonLogEntry[];
+/**
+ * Export logs to various formats
+ */
+export declare function exportLogs(laneRunDir: string, format: 'text' | 'json' | 'markdown' | 'html', outputPath?: string): string;