pm-orchestrator-runner 1.0.7 → 1.0.9

package/dist/repl/two-pane-renderer.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Two-Pane Renderer for CLI
+ * Per spec/18_CLI_TWO_PANE.md
+ *
+ * Provides 2-pane layout:
+ * - Upper pane: Log display (scrollable)
+ * - Lower pane: Input line (always 1 line, never interrupted by logs)
+ *
+ * Critical requirement: Input line must NEVER be disrupted by log output
+ * - Cursor position maintained
+ * - Input string maintained
+ * - Prompt display maintained
+ */
+/**
+ * Running task display info
+ * Per spec/18: RUNNING task-1234 | 12.3s | processing
+ */
+export interface RunningInfo {
+    taskId: string;
+    elapsedMs: number;
+    status: string;
+}
+/**
+ * Complete task display info
+ * Per spec/18: Result summary, files modified, next operations
+ */
+export interface CompleteInfo {
+    taskId: string;
+    elapsedMs: number;
+    filesModified: string[];
+    nextOperations: string;
+}
+/**
+ * Two-Pane Renderer Configuration
+ */
+export interface TwoPaneRendererConfig {
+    /** Prompt string (default: 'pm> ') */
+    prompt?: string;
+    /** Output stream (default: process.stdout) */
+    output?: NodeJS.WriteStream;
+    /** Enable 2-pane mode (default: true if TTY) */
+    enabled?: boolean;
+}
+/**
+ * Two-Pane Renderer
+ *
+ * Maintains separation between log output (upper pane) and input (lower pane).
+ * Ensures input line is never disrupted by log output.
+ */
+export declare class TwoPaneRenderer {
+    private readonly output;
+    private prompt;
+    private readonly enabled;
+    private inputBuffer;
+    private inputCursorPos;
+    private pendingLogs;
+    private flushTimeout;
+    private readonly FLUSH_DELAY_MS;
+    constructor(config?: TwoPaneRendererConfig);
+    /**
+     * Check if 2-pane mode is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Write log message to upper pane
+     * Per spec/18: Logs flow in upper pane, never disrupting input line
+     *
+     * @param message - Log message to write
+     */
+    writeLog(message: string): void;
+    /**
+     * Generate visual separator line
+     * Per spec: Visual separation between log pane and input pane
+     */
+    private getSeparator;
+    /**
+     * Format a log line with visual prefix
+     * Adds dim pipe character to distinguish log output from input
+     */
+    private formatLogLine;
+    /**
+     * Flush pending logs to output
+     * Preserves input line state
+     */
+    private flushLogs;
+    /**
+     * Render the input line (prompt + buffer)
+     * Called after log output to restore input state
+     * Includes visual separator for 2-pane distinction
+     */
+    private renderInputLine;
+    /**
+     * Update input state
+     * Called by readline integration to sync input buffer
+     *
+     * @param buffer - Current input buffer content
+     * @param cursorPos - Cursor position within buffer
+     */
+    updateInput(buffer: string, cursorPos: number): void;
+    /**
+     * Clear input state (e.g., after command execution)
+     */
+    clearInput(): void;
+    /**
+     * Set prompt string
+     */
+    setPrompt(prompt: string): void;
+    /**
+     * Get current prompt
+     */
+    getPrompt(): string;
+    /**
+     * Format RUNNING display
+     * Per spec/18: RUNNING task-1234 | 12.3s | processing
+     * Yellow color for visibility
+     *
+     * @param info - Running task info
+     * @returns Formatted string
+     */
+    formatRunning(info: RunningInfo): string;
+    /**
+     * Show RUNNING status
+     * Per spec/18: 1 line only display
+     *
+     * @param info - Running task info
+     */
+    showRunning(info: RunningInfo): void;
+    /**
+     * Format COMPLETE display
+     * Per spec/18:
+     * - Result summary (green for success)
+     * - Files modified list
+     * - Next operations
+     *
+     * @param info - Complete task info
+     * @returns Formatted lines
+     */
+    formatComplete(info: CompleteInfo): string[];
+    /**
+     * Show COMPLETE status
+     * Per spec/18: Result summary, files modified, next operations
+     *
+     * @param info - Complete task info
+     */
+    showComplete(info: CompleteInfo): void;
+    /**
+     * Force flush any pending logs immediately
+     * Used before exit or when immediate output is needed
+     */
+    flush(): void;
+    /**
+     * Get current input buffer (for testing)
+     */
+    getInputBuffer(): string;
+    /**
+     * Get current cursor position (for testing)
+     */
+    getInputCursorPos(): number;
+}
+//# sourceMappingURL=two-pane-renderer.d.ts.map

package/dist/repl/two-pane-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"two-pane-renderer.d.ts","sourceRoot":"","sources":["../../src/repl/two-pane-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsCH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAGlC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAa;IAGnC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;gBAEzB,MAAM,GAAE,qBAA0B;IAY9C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAoB/B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,SAAS;IA8BjB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAKxC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIpC;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE;IAoB5C;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAOtC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}

package/dist/repl/two-pane-renderer.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * Two-Pane Renderer for CLI
+ * Per spec/18_CLI_TWO_PANE.md
+ *
+ * Provides 2-pane layout:
+ * - Upper pane: Log display (scrollable)
+ * - Lower pane: Input line (always 1 line, never interrupted by logs)
+ *
+ * Critical requirement: Input line must NEVER be disrupted by log output
+ * - Cursor position maintained
+ * - Input string maintained
+ * - Prompt display maintained
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwoPaneRenderer = void 0;
+/**
+ * ANSI escape sequences for terminal control
+ */
+const ANSI = {
+    // Cursor control
+    SAVE_CURSOR: '\x1b[s',
+    RESTORE_CURSOR: '\x1b[u',
+    MOVE_TO_COL: (col) => `\x1b[${col}G`,
+    MOVE_UP: (n) => `\x1b[${n}A`,
+    MOVE_DOWN: (n) => `\x1b[${n}B`,
+    MOVE_TO: (row, col) => `\x1b[${row};${col}H`,
+    // Line control
+    CLEAR_LINE: '\x1b[2K',
+    CLEAR_TO_END: '\x1b[K',
+    // Screen control
+    SCROLL_UP: '\x1b[S',
+    // Colors and styles
+    RESET: '\x1b[0m',
+    DIM: '\x1b[2m',
+    BOLD: '\x1b[1m',
+    CYAN: '\x1b[36m',
+    GREEN: '\x1b[32m',
+    YELLOW: '\x1b[33m',
+    BLUE: '\x1b[34m',
+};
+/**
+ * Visual separator between log pane and input pane
+ * Default width: 60 characters
+ */
+const SEPARATOR_CHAR = '\u2500'; // Box drawing character: ─
+const SEPARATOR_WIDTH = 60;
+/**
+ * Two-Pane Renderer
+ *
+ * Maintains separation between log output (upper pane) and input (lower pane).
+ * Ensures input line is never disrupted by log output.
+ */
+class TwoPaneRenderer {
+    output;
+    prompt;
+    enabled;
+    // Input state (preserved across log writes)
+    inputBuffer = '';
+    inputCursorPos = 0;
+    // Debounce for high-frequency log output
+    pendingLogs = [];
+    flushTimeout = null;
+    FLUSH_DELAY_MS = 16; // ~60fps
+    constructor(config = {}) {
+        this.output = config.output || process.stdout;
+        this.prompt = config.prompt || 'pm> ';
+        // Enable 2-pane mode only if TTY
+        if (config.enabled !== undefined) {
+            this.enabled = config.enabled;
+        }
+        else {
+            this.enabled = this.output.isTTY === true;
+        }
+    }
+    /**
+     * Check if 2-pane mode is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Write log message to upper pane
+     * Per spec/18: Logs flow in upper pane, never disrupting input line
+     *
+     * @param message - Log message to write
+     */
+    writeLog(message) {
+        if (!this.enabled) {
+            // Fallback: use console.log for non-TTY
+            // This maintains compatibility with test mocks that capture console.log
+            // eslint-disable-next-line no-console
+            console.log(message);
+            return;
+        }
+        // Add to pending logs for batched output
+        this.pendingLogs.push(message);
+        // Schedule flush
+        if (!this.flushTimeout) {
+            this.flushTimeout = setTimeout(() => {
+                this.flushLogs();
+            }, this.FLUSH_DELAY_MS);
+        }
+    }
+    /**
+     * Generate visual separator line
+     * Per spec: Visual separation between log pane and input pane
+     */
+    getSeparator() {
+        // Use terminal width if available, otherwise default
+        const width = this.output.columns || SEPARATOR_WIDTH;
+        return ANSI.DIM + SEPARATOR_CHAR.repeat(Math.min(width, 120)) + ANSI.RESET;
+    }
+    /**
+     * Format a log line with visual prefix
+     * Adds dim pipe character to distinguish log output from input
+     */
+    formatLogLine(message) {
+        // Add dim gray prefix to log lines for visual distinction
+        return `${ANSI.DIM}|${ANSI.RESET} ${message}`;
+    }
+    /**
+     * Flush pending logs to output
+     * Preserves input line state
+     */
+    flushLogs() {
+        this.flushTimeout = null;
+        if (this.pendingLogs.length === 0) {
+            return;
+        }
+        const logs = this.pendingLogs;
+        this.pendingLogs = [];
+        // 1. Save cursor position and clear input line
+        this.output.write(ANSI.SAVE_CURSOR);
+        this.output.write(ANSI.MOVE_TO_COL(1));
+        this.output.write(ANSI.CLEAR_LINE);
+        // 2. Move cursor up to log area (if input is on screen)
+        // We write logs, then move back down and redraw input
+        // 3. Output all logs with visual prefix
+        for (const log of logs) {
+            this.output.write(this.formatLogLine(log) + '\n');
+        }
+        // 4. Redraw input line at current position (with separator)
+        this.renderInputLine();
+        // 5. Restore cursor to correct position in input
+        this.output.write(ANSI.MOVE_TO_COL(this.prompt.length + this.inputCursorPos + 1));
+    }
+    /**
+     * Render the input line (prompt + buffer)
+     * Called after log output to restore input state
+     * Includes visual separator for 2-pane distinction
+     */
+    renderInputLine() {
+        // Show separator line above input
+        this.output.write(this.getSeparator() + '\n');
+        // Colorized prompt for visual distinction
+        const coloredPrompt = `${ANSI.BOLD}${ANSI.CYAN}${this.prompt}${ANSI.RESET}`;
+        this.output.write(coloredPrompt + this.inputBuffer);
+        this.output.write(ANSI.CLEAR_TO_END);
+    }
+    /**
+     * Update input state
+     * Called by readline integration to sync input buffer
+     *
+     * @param buffer - Current input buffer content
+     * @param cursorPos - Cursor position within buffer
+     */
+    updateInput(buffer, cursorPos) {
+        this.inputBuffer = buffer;
+        this.inputCursorPos = cursorPos;
+    }
+    /**
+     * Clear input state (e.g., after command execution)
+     */
+    clearInput() {
+        this.inputBuffer = '';
+        this.inputCursorPos = 0;
+    }
+    /**
+     * Set prompt string
+     */
+    setPrompt(prompt) {
+        this.prompt = prompt;
+    }
+    /**
+     * Get current prompt
+     */
+    getPrompt() {
+        return this.prompt;
+    }
+    /**
+     * Format RUNNING display
+     * Per spec/18: RUNNING task-1234 | 12.3s | processing
+     * Yellow color for visibility
+     *
+     * @param info - Running task info
+     * @returns Formatted string
+     */
+    formatRunning(info) {
+        const elapsed = (info.elapsedMs / 1000).toFixed(1);
+        return `${ANSI.YELLOW}RUNNING${ANSI.RESET} ${info.taskId} | ${elapsed}s | ${info.status}`;
+    }
+    /**
+     * Show RUNNING status
+     * Per spec/18: 1 line only display
+     *
+     * @param info - Running task info
+     */
+    showRunning(info) {
+        this.writeLog(this.formatRunning(info));
+    }
+    /**
+     * Format COMPLETE display
+     * Per spec/18:
+     * - Result summary (green for success)
+     * - Files modified list
+     * - Next operations
+     *
+     * @param info - Complete task info
+     * @returns Formatted lines
+     */
+    formatComplete(info) {
+        const elapsed = (info.elapsedMs / 1000).toFixed(1);
+        const lines = [];
+        lines.push(`${ANSI.GREEN}COMPLETE${ANSI.RESET} ${info.taskId} | ${elapsed}s`);
+        lines.push('');
+        if (info.filesModified.length > 0) {
+            lines.push(`${ANSI.BOLD}Files modified:${ANSI.RESET}`);
+            for (const file of info.filesModified) {
+                lines.push(`  ${ANSI.DIM}-${ANSI.RESET} ${file}`);
+            }
+            lines.push('');
+        }
+        lines.push(`${ANSI.BLUE}Next:${ANSI.RESET} ${info.nextOperations}`);
+        return lines;
+    }
+    /**
+     * Show COMPLETE status
+     * Per spec/18: Result summary, files modified, next operations
+     *
+     * @param info - Complete task info
+     */
+    showComplete(info) {
+        const lines = this.formatComplete(info);
+        for (const line of lines) {
+            this.writeLog(line);
+        }
+    }
+    /**
+     * Force flush any pending logs immediately
+     * Used before exit or when immediate output is needed
+     */
+    flush() {
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        if (this.pendingLogs.length > 0) {
+            this.flushLogs();
+        }
+    }
+    /**
+     * Get current input buffer (for testing)
+     */
+    getInputBuffer() {
+        return this.inputBuffer;
+    }
+    /**
+     * Get current cursor position (for testing)
+     */
+    getInputCursorPos() {
+        return this.inputCursorPos;
+    }
+}
+exports.TwoPaneRenderer = TwoPaneRenderer;
+//# sourceMappingURL=two-pane-renderer.js.map

package/dist/repl/two-pane-renderer.js.map

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

package/dist/trace/trace-pack.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Trace Pack - Minimal JSONL logging for session/task state transitions
+ *
+ * Per spec:
+ * - JSONL format (one JSON object per line)
+ * - Records: session_id, task_group_id, task_id, state transitions, verification results
+ * - Verify function for output format compliance
+ */
+/**
+ * Trace entry types
+ */
+export type TraceEventType = 'SESSION_START' | 'SESSION_END' | 'TASK_GROUP_START' | 'TASK_GROUP_END' | 'TASK_START' | 'TASK_STATE_CHANGE' | 'TASK_END' | 'EXECUTOR_CALL' | 'EXECUTOR_RESULT' | 'VERIFICATION_START' | 'VERIFICATION_RESULT' | 'ERROR' | 'WARNING';
+/**
+ * Base trace entry structure
+ */
+export interface TraceEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Event type */
+    event: TraceEventType;
+    /** Session identifier */
+    session_id: string;
+    /** Task group identifier (optional) */
+    task_group_id?: string;
+    /** Task identifier (optional) */
+    task_id?: string;
+    /** Previous state (for state transitions) */
+    from_state?: string;
+    /** New state (for state transitions) */
+    to_state?: string;
+    /** Additional data */
+    data?: Record<string, unknown>;
+    /** Verification result (for verification events) */
+    verification_result?: {
+        passed: boolean;
+        checks: Array<{
+            name: string;
+            passed: boolean;
+            message?: string;
+        }>;
+    };
+    /** Error information */
+    error?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+}
+/**
+ * Trace Pack configuration
+ */
+export interface TracePackConfig {
+    /** Output directory for trace files */
+    outputDir: string;
+    /** Session ID */
+    sessionId: string;
+    /** Whether to buffer writes */
+    buffered?: boolean;
+    /** Max buffer size before flush */
+    maxBufferSize?: number;
+}
+/**
+ * Trace Pack - JSONL logger for session/task state transitions
+ */
+export declare class TracePack {
+    private config;
+    private outputPath;
+    private buffer;
+    private writeStream;
+    constructor(config: TracePackConfig);
+    /**
+     * Get the output file path
+     */
+    getOutputPath(): string;
+    /**
+     * Log a trace entry
+     */
+    log(entry: Omit<TraceEntry, 'timestamp' | 'session_id'>): void;
+    /**
+     * Log session start
+     */
+    sessionStart(data?: Record<string, unknown>): void;
+    /**
+     * Log session end
+     */
+    sessionEnd(data?: Record<string, unknown>): void;
+    /**
+     * Log task group start
+     */
+    taskGroupStart(taskGroupId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task group end
+     */
+    taskGroupEnd(taskGroupId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task start
+     */
+    taskStart(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task state change
+     */
+    taskStateChange(taskGroupId: string, taskId: string, fromState: string, toState: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task end
+     */
+    taskEnd(taskGroupId: string, taskId: string, finalState: string, data?: Record<string, unknown>): void;
+    /**
+     * Log executor call
+     */
+    executorCall(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log executor result
+     */
+    executorResult(taskGroupId: string, taskId: string, status: string, data?: Record<string, unknown>): void;
+    /**
+     * Log verification start
+     */
+    verificationStart(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log verification result
+     */
+    verificationResult(taskGroupId: string, taskId: string, passed: boolean, checks: Array<{
+        name: string;
+        passed: boolean;
+        message?: string;
+    }>, data?: Record<string, unknown>): void;
+    /**
+     * Log error
+     */
+    error(message: string, code?: string, taskGroupId?: string, taskId?: string): void;
+    /**
+     * Log warning
+     */
+    warning(message: string, taskGroupId?: string, taskId?: string): void;
+    /**
+     * Flush buffer to file
+     */
+    flush(): void;
+    /**
+     * Write single entry to file
+     */
+    private writeEntry;
+    /**
+     * Close the trace pack
+     */
+    close(): void;
+}
+/**
+ * Verify trace file format compliance
+ */
+export interface VerifyResult {
+    valid: boolean;
+    entryCount: number;
+    errors: Array<{
+        line: number;
+        error: string;
+    }>;
+    warnings: Array<{
+        line: number;
+        warning: string;
+    }>;
+    summary: {
+        sessionStarts: number;
+        sessionEnds: number;
+        taskGroupStarts: number;
+        taskGroupEnds: number;
+        taskStarts: number;
+        taskEnds: number;
+        stateChanges: number;
+        verificationResults: number;
+        errors: number;
+    };
+}
+/**
+ * Verify a trace file for format compliance
+ */
+export declare function verifyTraceFile(filePath: string): VerifyResult;
+/**
+ * Read and parse a trace file
+ */
+export declare function readTraceFile(filePath: string): TraceEntry[];
+//# sourceMappingURL=trace-pack.d.ts.map

package/dist/trace/trace-pack.d.ts.map

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