repterm 0.1.0

package/dist/runner/worker.js

@@ -0,0 +1,112 @@
+/**
+ * Worker process runner for parallel test execution
+ * Runs tests in isolated worker processes
+ */
+import { fork } from 'child_process';
+import { EventEmitter } from 'events';
+/**
+ * Worker process manager
+ */
+export class Worker extends EventEmitter {
+    process = null;
+    config;
+    busy = false;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Start the worker process
+     */
+    start() {
+        if (this.process) {
+            throw new Error('Worker already started');
+        }
+        // Fork a new process running the worker script
+        this.process = fork(new URL('./worker-runner.js', import.meta.url).pathname, [], {
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        });
+        // Handle messages from worker
+        this.process.on('message', (message) => {
+            this.handleMessage(message);
+        });
+        // Handle worker exit
+        this.process.on('exit', (code) => {
+            this.emit('exit', code);
+        });
+        // Handle worker errors
+        this.process.on('error', (error) => {
+            this.emit('error', error);
+        });
+    }
+    /**
+     * Run a test suite in the worker
+     */
+    runSuite(suite) {
+        if (!this.process) {
+            throw new Error('Worker not started');
+        }
+        if (this.busy) {
+            throw new Error('Worker is busy');
+        }
+        this.busy = true;
+        // Send suite to worker
+        this.process.send({
+            type: 'run',
+            data: {
+                suite,
+                config: this.config.config,
+                artifactBaseDir: this.config.artifactBaseDir,
+            },
+        });
+    }
+    /**
+     * Stop the worker
+     */
+    stop() {
+        if (this.process) {
+            this.process.kill();
+            this.process = null;
+        }
+    }
+    /**
+     * Check if worker is busy
+     */
+    isBusy() {
+        return this.busy;
+    }
+    /**
+     * Get worker ID
+     */
+    getWorkerId() {
+        return this.config.workerId;
+    }
+    /**
+     * Handle message from worker
+     */
+    handleMessage(message) {
+        switch (message.type) {
+            case 'ready':
+                this.emit('ready');
+                break;
+            case 'result':
+                this.emit('result', message.data);
+                break;
+            case 'done':
+                this.busy = false;
+                this.emit('done', message.data);
+                break;
+            case 'error':
+                this.busy = false;
+                this.emit('error', message.data);
+                break;
+        }
+    }
+}
+/**
+ * Create a worker
+ */
+export function createWorker(config) {
+    return new Worker(config);
+}
+//# sourceMappingURL=worker.js.map

package/dist/runner/worker.js.map

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

package/dist/terminal/session.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Terminal session abstraction around bun-pty
+ * Provides core PTY operations for terminal interaction
+ */
+import { EventEmitter } from 'events';
+export interface SessionConfig {
+    cols?: number;
+    rows?: number;
+    env?: Record<string, string>;
+}
+export interface SessionOptions extends SessionConfig {
+    shell?: string;
+    args?: string[];
+}
+/**
+ * Terminal session wrapper around bun-pty
+ */
+export declare class TerminalSession extends EventEmitter {
+    private pty;
+    private outputBuffer;
+    private config;
+    constructor(config?: SessionConfig);
+    /**
+     * Start the terminal session
+     */
+    start(options?: SessionOptions): void;
+    /**
+     * Write data to the terminal
+     */
+    write(data: string): void;
+    /**
+     * Get the current output buffer
+     */
+    getOutput(): string;
+    /**
+     * Clear the output buffer
+     */
+    clearOutput(): void;
+    /**
+     * Resize the terminal
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Kill the terminal process
+     */
+    kill(signal?: string): void;
+    /**
+     * Check if the session is active
+     */
+    isActive(): boolean;
+    /**
+     * Get the process ID
+     */
+    getPid(): number | undefined;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/terminal/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAKD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,aAAkB;IAsBtC;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI;IA0CzC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,MAAM,IAAI,MAAM,GAAG,SAAS;CAG7B"}

package/dist/terminal/session.js

@@ -0,0 +1,126 @@
+/**
+ * Terminal session abstraction around bun-pty
+ * Provides core PTY operations for terminal interaction
+ */
+import { spawn } from 'bun-pty';
+import { EventEmitter } from 'events';
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+/**
+ * Terminal session wrapper around bun-pty
+ */
+export class TerminalSession extends EventEmitter {
+    pty = null;
+    outputBuffer = '';
+    config;
+    constructor(config = {}) {
+        super();
+        // Convert process.env to Record<string, string> by filtering undefined values
+        let env = {};
+        if (config.env) {
+            env = config.env;
+        }
+        else {
+            for (const [key, value] of Object.entries(process.env)) {
+                if (value !== undefined) {
+                    env[key] = value;
+                }
+            }
+        }
+        this.config = {
+            cols: config.cols ?? DEFAULT_COLS,
+            rows: config.rows ?? DEFAULT_ROWS,
+            env,
+        };
+    }
+    /**
+     * Start the terminal session
+     */
+    start(options = {}) {
+        if (this.pty) {
+            throw new Error('Terminal session already started');
+        }
+        const shell = options.shell ?? process.env.SHELL ?? '/bin/bash';
+        const args = options.args ?? [];
+        // Merge environment variables, filtering out undefined values
+        const mergedEnv = { ...this.config.env, ...options.env };
+        const env = {};
+        for (const [key, value] of Object.entries(mergedEnv)) {
+            if (value !== undefined) {
+                env[key] = value;
+            }
+        }
+        // Ensure TERM is set to xterm-256color for proper color support
+        if (!env.TERM) {
+            env.TERM = 'xterm-256color';
+        }
+        this.pty = spawn(shell, args, {
+            name: 'xterm-256color', // Support 256 colors (like simple-example.js)
+            cols: options.cols ?? this.config.cols ?? DEFAULT_COLS,
+            rows: options.rows ?? this.config.rows ?? DEFAULT_ROWS,
+            cwd: process.cwd(),
+            env,
+        });
+        // Capture output
+        this.pty.onData((data) => {
+            this.outputBuffer += data;
+            this.emit('data', data);
+        });
+        // Handle exit
+        this.pty.onExit(({ exitCode, signal }) => {
+            this.emit('exit', { exitCode, signal });
+        });
+    }
+    /**
+     * Write data to the terminal
+     */
+    write(data) {
+        if (!this.pty) {
+            throw new Error('Terminal session not started');
+        }
+        this.pty.write(data);
+    }
+    /**
+     * Get the current output buffer
+     */
+    getOutput() {
+        return this.outputBuffer;
+    }
+    /**
+     * Clear the output buffer
+     */
+    clearOutput() {
+        this.outputBuffer = '';
+    }
+    /**
+     * Resize the terminal
+     */
+    resize(cols, rows) {
+        if (!this.pty) {
+            throw new Error('Terminal session not started');
+        }
+        this.pty.resize(cols, rows);
+    }
+    /**
+     * Kill the terminal process
+     */
+    kill(signal) {
+        if (this.pty) {
+            this.pty.kill(signal);
+            this.pty = null;
+        }
+    }
+    /**
+     * Check if the session is active
+     */
+    isActive() {
+        return this.pty !== null;
+    }
+    /**
+     * Get the process ID
+     */
+    getPid() {
+        return this.pty?.pid;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/terminal/session.js.map

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

package/dist/terminal/terminal.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Terminal API implementation
+ * Provides high-level terminal interaction (start/send/wait/snapshot)
+ *
+ * 执行架构：
+ * - 非录制、非交互模式：使用 Bun.spawn，stdout/stderr 分离，exitCode 精确
+ * - 录制或交互模式：使用 PTY，支持复杂交互，但 exitCode 不可靠
+ */
+import type { TerminalAPI, WaitOptions, RunOptions, PTYProcess, PluginFactory, TerminalWithPlugins, CommandLog } from '../runner/models.js';
+import { TerminalSession } from './session.js';
+import { EventEmitter } from 'events';
+/**
+ * 计算 tmux 输出捕获的行范围
+ * 纯函数，可独立单元测试
+ */
+export declare function calculateOutputRange(beforeCursorY: number, beforeHistorySize: number, afterCursorY: number, afterHistorySize: number, promptLineCount: number): {
+    startLine: number;
+    endLine: number;
+};
+export interface TerminalConfig {
+    cols?: number;
+    rows?: number;
+    recording?: boolean;
+    recordingPath?: string;
+    ptyOnly?: boolean;
+    tmuxSessionName?: string;
+    tmuxPaneId?: string;
+    promptLineCount?: number;
+}
+export interface SharedTerminalState {
+    paneCount: number;
+    currentActivePane?: number;
+    paneOutputs: Map<number, string>;
+}
+/**
+ * High-level Terminal API for test authoring
+ */
+export declare class Terminal extends EventEmitter implements TerminalAPI {
+    private session;
+    private recording;
+    private ptyOnly;
+    private recordingPath?;
+    private closed;
+    private initialized;
+    private tmuxSessionName?;
+    private tmuxPaneId?;
+    private sharedState;
+    private paneIndex?;
+    private nonInteractiveOutput;
+    private commandLogs;
+    private pluginFactory?;
+    plugins?: Record<string, unknown>;
+    private beforeEnterHistorySize;
+    private beforeEnterCursorY;
+    private commandLineCount;
+    private promptLineCount;
+    private promptLineCountConfigured;
+    private detectedPromptPattern?;
+    constructor(config?: TerminalConfig);
+    /**
+     * Get tmux session name (for multi-terminal coordination)
+     */
+    getTmuxSessionName(): string | undefined;
+    /**
+     * Get tmux pane ID (for multi-terminal coordination)
+     */
+    getTmuxPaneId(): string | undefined;
+    /**
+     * Get terminal session (for direct access)
+     */
+    getSession(): TerminalSession;
+    /**
+     * Get shared state (for factory to update pane count)
+     */
+    getSharedState(): SharedTerminalState;
+    /**
+     * Increment pane count (called by factory when creating new panes)
+     */
+    incrementPaneCount(): void;
+    /**
+     * Set parent session (for child terminals that share a session)
+     */
+    setParentSession(session: TerminalSession, sharedState: SharedTerminalState, paneIndex: number): void;
+    /**
+     * Select the tmux pane that this terminal is bound to
+     * Uses arrow key navigation to switch panes without showing pane IDs
+     */
+    private selectPane;
+    /**
+     * 执行命令，返回 PTYProcess
+     *
+     * 执行模式：
+     * - 非录制、非交互（默认）：使用 Bun.spawn，stdout/stderr 分离，exitCode 精确
+     * - 录制或交互：使用 PTY，支持 expect/send，但 exitCode 返回 -1
+     *
+     * 用法：
+     * - 直接 await: 自动调用 wait()，返回 CommandResult
+     * - 不 await: 返回 PTYProcess 控制器，可调用 expect/send/wait 等方法
+     *
+     * @param command - 要执行的命令
+     * @param options - 可选配置，包括 interactive: true 启用交互模式
+     */
+    run(command: string, options?: RunOptions): PTYProcess;
+    /**
+     * Initialize terminal session (recording or non-recording)
+     */
+    private initializeSession;
+    /**
+     * Wait for shell to be ready (detect shell prompt)
+     */
+    private waitForShellReady;
+    /**
+     * Wait for tmux to be ready (detect shell prompt)
+     */
+    private waitForTmuxReady;
+    /**
+     * Send text to the terminal
+     */
+    send(text: string): Promise<void>;
+    /**
+     * Wait for text to appear in terminal output
+     * In recording mode with multi-pane, uses tmux capture-pane for isolation
+     */
+    waitForText(text: string, options?: WaitOptions): Promise<void>;
+    /**
+     * Get snapshot of current terminal output
+     * In recording mode, returns current pane's output (stripped of ANSI)
+     */
+    snapshot(): Promise<string>;
+    /**
+     * Get all output (session + non-interactive commands)
+     */
+    private getAllOutput;
+    /**
+     * Capture output from current pane using tmux capture-pane
+     * Used in recording mode for per-pane output isolation
+     */
+    private capturePaneOutput;
+    /**
+     * Execute a tmux command and return its output
+     */
+    private runTmuxCommand;
+    /**
+     * Strip ANSI escape sequences from text
+     */
+    private stripAnsi;
+    /**
+     * Append output from non-interactive command (internal use)
+     */
+    appendNonInteractiveOutput(output: string): void;
+    /**
+     * Record a command execution result for failure diagnostics
+     */
+    appendCommandLog(log: CommandLog): void;
+    /**
+     * Get command logs captured during the current test
+     */
+    getCommandLogs(): CommandLog[];
+    /**
+     * 设置插件工厂（用于 create() 自动注入插件）
+     * @internal 由插件系统调用
+     */
+    setPluginFactory<TPlugins>(factory: PluginFactory<TPlugins>): void;
+    /**
+     * Create a new terminal instance (for multi-terminal tests)
+     * - Recording mode: splits tmux window (tmux already started via asciinema --command)
+     * - Non-recording mode: creates independent terminal
+     * - If pluginFactory is set, new terminal will have plugins property
+     */
+    create<TPlugins = Record<string, unknown>>(): Promise<TerminalWithPlugins<TPlugins>>;
+    /**
+     * Close the terminal
+     */
+    close(): Promise<void>;
+    /**
+     * Clean up tmux session after recording ends
+     */
+    private cleanupTmuxSession;
+    /**
+     * Check if terminal is active
+     */
+    isActive(): boolean;
+    /**
+     * Check if terminal is in recording mode
+     */
+    isRecording(): boolean;
+    /**
+     * 是否使用 PTY 模式（录制或 pty-only）
+     * PTY 模式支持交互式命令，但打字效果仅在 recording 模式下启用
+     */
+    isPtyMode(): boolean;
+    /**
+     * Get pane index (for tmux commands)
+     */
+    getPaneIndex(): number | undefined;
+    /**
+     * Get session output (for non-recording PTY mode)
+     */
+    getSessionOutput(): string;
+    /**
+     * Get output length at current moment (for range capture)
+     */
+    getOutputLength(): number;
+    /**
+     * Get the state recorded before sending Enter (for output capture)
+     */
+    getBeforeEnterState(): {
+        historySize: number;
+        cursorY: number;
+        commandLineCount: number;
+    };
+    /**
+     * Record state before sending Enter (internal use)
+     * 使用单次 tmux 查询原子获取 history_size 和 cursor_y，避免竞态条件
+     */
+    private recordBeforeEnterState;
+    /**
+     * 在录制开始前检测提示符相关信息
+     * - 提示符占用的行数
+     * - 提示符匹配 pattern
+     * 通过创建临时 tmux session 来测量，检测过程不会出现在录制中
+     */
+    private detectPromptBeforeRecording;
+    /**
+     * 分析提示符行，生成匹配正则
+     */
+    private analyzePromptLine;
+    /**
+     * 获取检测到的提示符行数
+     */
+    getPromptLineCount(): number;
+    /**
+     * 获取检测到的提示符匹配 pattern
+     */
+    getDetectedPromptPattern(): RegExp | undefined;
+    /**
+     * Type text with human-like delays (for recording mode)
+     * @param text - 要打字的文本
+     * @param speed - 每字符延迟 (ms)，默认 80ms
+     * @param variableSpeed - 是否使用变速模式（更自然）
+     */
+    private typeWithDelay;
+    /**
+     * 在录制中显示步骤标题
+     */
+    private displayStepTitle;
+    /**
+     * Wait for command to complete
+     * Uses prompt detection only
+     */
+    private waitForOutputStable;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Wait for output to stabilize (public, for PTYProcessImpl)
+     */
+    waitForOutputStablePublic(timeout?: number): Promise<void>;
+    /**
+     * Execute command in PTY (internal, for PTYProcessImpl)
+     */
+    executeInPty(command: string, options?: {
+        typingSpeed?: number;
+        pauseBefore?: number;
+        showStepTitle?: boolean;
+        stepName?: string;
+    }): Promise<void>;
+    /**
+     * 使用 Bracketed Paste Mode 粘贴多行命令
+     * 避免 shell 显示续行提示符（如 quote>、pipe heredoc>）
+     *
+     * Bracketed Paste Mode 使用转义序列包裹粘贴内容：
+     * - \x1b[200~ 标记粘贴开始
+     * - \x1b[201~ 标记粘贴结束
+     * Shell 会将整个内容作为单个输入块处理，不显示续行提示符
+     */
+    private pasteWithTmux;
+}
+/**
+ * Create a new Terminal instance
+ */
+export declare function createTerminal(config?: TerminalConfig): Terminal;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal/terminal.d.ts.map

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