maistro 1.0.390

package/dist/ui.d.ts

@@ -0,0 +1,272 @@
+import { EventEmitter } from 'node:events';
+export interface MenuItem {
+    key: string;
+    label: string;
+    description?: string;
+}
+/**
+ * Interface for injectable streams (for testing)
+ */
+export interface TestableStream {
+    write: (data: string) => boolean;
+    columns?: number;
+}
+export interface TestableInput extends EventEmitter {
+    isTTY?: boolean;
+    setRawMode?: (mode: boolean) => void;
+    resume?: () => void;
+    pause?: () => void;
+}
+export declare class InteractiveUI extends EventEmitter {
+    private rl;
+    private isRawMode;
+    private _stdin;
+    private _stdout;
+    constructor(stdin?: TestableInput, stdout?: TestableStream);
+    /**
+     * Get the stdin stream (for testing access)
+     */
+    get stdin(): TestableInput;
+    /**
+     * Get the stdout stream (for testing access)
+     */
+    get stdout(): TestableStream;
+    /**
+     * Initialize the UI
+     */
+    init(): void;
+    /**
+     * Enable raw mode for key-by-key input
+     */
+    enableRawMode(): void;
+    /**
+     * Disable raw mode
+     */
+    disableRawMode(): void;
+    /**
+     * Clear the screen and scrollback buffer
+     */
+    clear(): void;
+    /**
+     * Move cursor up N lines
+     */
+    cursorUp(n: number): void;
+    /**
+     * Clear from cursor to end of screen
+     */
+    clearToEnd(): void;
+    /**
+     * Print styled text
+     */
+    print(text: string): void;
+    /**
+     * Print with color
+     */
+    printColored(text: string, color: 'green' | 'yellow' | 'red' | 'cyan' | 'gray' | 'bold'): void;
+    /**
+     * Show a quick-pick menu with command input support
+     * @param items Menu items to display
+     * @param prompt Header text for the menu
+     * @param commandParser Optional callback for custom command parsing
+     * @param options Additional options
+     * @param options.showInput Whether to show the text input field (default: true if commandParser provided, false otherwise)
+     */
+    quickPick(items: MenuItem[], prompt?: string, commandParser?: (input: string) => string | null, options?: {
+        showInput?: boolean;
+    }): Promise<string | null>;
+    /**
+     * Prompt for text input
+     */
+    prompt(question: string): Promise<string>;
+    /**
+     * Prompt for text input with Escape support
+     * Returns null if Escape is pressed
+     * @param prefix - The prompt prefix to display
+     * @param placeholder - Optional placeholder text shown when input is empty (displayed in gray)
+     */
+    promptWithEscape(prefix: string, placeholder?: string): Promise<string | null>;
+    /**
+     * Listen for escape key during execution
+     */
+    onEscape(callback: () => void): () => void;
+    /**
+     * Show a spinner during async operation
+     */
+    spinner(message: string): {
+        stop: (finalMessage?: string) => void;
+    };
+    /**
+     * Wait for any key press
+     */
+    waitForKey(message?: string): Promise<void>;
+    /**
+     * Close the UI
+     */
+    close(): void;
+}
+/**
+ * Format task status with symbol.
+ * For failed/skipped tasks, optionally accepts failureType to show different symbols:
+ * - execution failure: red (code was never written)
+ * - acceptance failure: yellow/orange (code written but validation failed)
+ */
+/**
+ * Get the status icon only (for task lists where name is shown separately)
+ */
+export declare function formatTaskStatusIcon(status: string, failureType?: string): string;
+/**
+ * Get the human-readable status name with color
+ */
+export declare function formatStatusName(status: string, failureType?: string): string;
+/**
+ * Format task status with icon and name (for status detail views)
+ */
+export declare function formatTaskStatus(status: string, failureType?: string): string;
+/**
+ * Format blocked task status symbol
+ */
+export declare function formatBlockedStatus(): string;
+/**
+ * Format progress bar with optional skipped tasks display
+ * @param completed Number of completed tasks
+ * @param total Total number of tasks
+ * @param width Width of the progress bar
+ * @param skipped Number of skipped tasks (shown in yellow)
+ */
+export declare function progressBar(completed: number, total: number, width?: number, skipped?: number): string;
+/**
+ * Task info for planning mode
+ */
+export interface PlanningTask {
+    id: string;
+    title: string;
+    status: string;
+    failureType?: string;
+}
+/**
+ * Callback for plan modifications during execution
+ */
+export interface PlanModificationCallback {
+    /** Called when user wants to skip a pending task */
+    onSkipTask?: (taskId: string) => Promise<void>;
+    /** Called when user wants to move a task up in the queue */
+    onMoveTaskUp?: (taskId: string) => Promise<void>;
+    /** Called when user wants to move a task down in the queue */
+    onMoveTaskDown?: (taskId: string) => Promise<void>;
+    /** Called when user wants to edit a task description */
+    onEditTask?: (taskId: string, newDescription: string) => Promise<void>;
+    /** Called to get current task list */
+    getTasks?: () => Promise<PlanningTask[]>;
+}
+/**
+ * Animated progress display for task execution with output streaming and input bar
+ */
+export declare class ProgressDisplay {
+    private interval;
+    private startTime;
+    private taskStartTime;
+    private spinnerFrames;
+    private frameIndex;
+    private lineCount;
+    private maxLineCount;
+    private isFirstRender;
+    private bouncePos;
+    private bounceDir;
+    private bounceWidth;
+    private currentTask;
+    private currentTaskId;
+    private currentTaskIndex;
+    private totalTasks;
+    private completedTasks;
+    private skippedTasks;
+    private phase;
+    private isRunning;
+    private completedDurationMs;
+    private lastOutputLines;
+    private maxOutputLines;
+    private inputBuffer;
+    private inputCursorIndex;
+    private onInputCallback;
+    private keyHandler;
+    private resizeHandler;
+    private escPendingPause;
+    private escTimeout;
+    private planningMode;
+    private planningTasks;
+    private planningSelectedIndex;
+    private planModificationCallback;
+    private planningMessage;
+    private headerRenderer;
+    /**
+     * Set a header renderer callback that will be called on each render
+     * @param renderer Function that writes header content to stdout
+     */
+    setHeaderRenderer(renderer: () => void): void;
+    /**
+     * Start the animated display
+     * @param totalTasks Total number of tasks
+     * @param onInput Callback for user input
+     * @param initialCompletedDurationMs Duration of already-completed tasks (from previous runs)
+     * @param initialSkippedTasks Number of already-skipped tasks
+     * @param planModification Optional callbacks for concurrent plan modification
+     */
+    start(totalTasks: number, onInput?: (input: string) => void, initialCompletedDurationMs?: number, initialSkippedTasks?: number, planModification?: PlanModificationCallback): void;
+    /**
+     * Add output line from Claude Code
+     */
+    addOutput(line: string): void;
+    /**
+     * Update when starting a new task
+     */
+    startTask(taskName: string, taskIndex: number, taskId?: string): void;
+    /**
+     * Update phase (executing -> validating -> committing)
+     */
+    setPhase(phase: 'executing' | 'validating' | 'committing'): void;
+    /**
+     * Mark a task as complete
+     * @param durationMs Optional duration of the completed task in milliseconds.
+     *                   If not provided, calculates from taskStartTime.
+     */
+    completeTask(durationMs?: number): void;
+    /**
+     * Stop the animated display
+     */
+    stop(finalMessage?: string): void;
+    /**
+     * Enter planning mode - show task list overlay while execution continues
+     */
+    private enterPlanningMode;
+    /**
+     * Exit planning mode and return to normal execution view
+     */
+    private exitPlanningMode;
+    /**
+     * Handle keyboard input in planning mode
+     */
+    private handlePlanningKey;
+    /**
+     * Execute a planning command
+     */
+    private executePlanningCommand;
+    private clearLines;
+    private formatTime;
+    /**
+     * Get the total working time (sum of completed task durations + current task elapsed)
+     */
+    getElapsedTime(): string;
+    /**
+     * Get the total working time in milliseconds
+     */
+    getTotalDurationMs(): number;
+    /**
+     * Estimate task progress based on phase and elapsed time
+     */
+    private getTaskPercent;
+    private render;
+    /**
+     * Log a message without disrupting the display
+     */
+    log(message: string): void;
+}
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

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