maistro 1.0.390

package/dist/types.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Task status in the execution pipeline
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+/**
+ * Project execution status
+ */
+export type ProjectStatus = 'idle' | 'planning' | 'ready' | 'executing' | 'paused' | 'completed' | 'failed';
+/**
+ * Action to take when a task fails after all retries
+ * - retry: Keep retrying (up to maxRetries)
+ * - skip: Skip this task and continue with next tasks
+ * - stop: Stop execution and wait for human intervention
+ */
+export type FailureAction = 'retry' | 'skip' | 'stop';
+/**
+ * Type of failure when a task fails
+ * - execution: Claude Code execution failed (code not written or error during implementation)
+ * - acceptance: Code was implemented but failed acceptance criteria validation
+ */
+export type FailureType = 'execution' | 'acceptance';
+/**
+ * Record of a single retry attempt
+ */
+export interface RetryAttempt {
+    /** Which attempt this was (1-based) */
+    attempt: number;
+    /** When the attempt was made */
+    timestamp: string;
+    /** Type of failure */
+    failureType: FailureType;
+    /** Brief description of what went wrong */
+    reason: string;
+    /** Full error output (for detailed view) */
+    fullError?: string;
+    /** Duration of this attempt in milliseconds */
+    durationMs?: number;
+}
+/**
+ * Metadata for an image associated with a task
+ */
+export interface ImageMetadata {
+    /** Unique identifier used in placeholders [image:id] */
+    id: string;
+    /** Original filename */
+    originalName: string;
+    /** Path relative to .maistro/images/ */
+    storagePath: string;
+    /** MIME type (e.g., "image/png") */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+    /** Optional description provided by user */
+    description?: string;
+    /** Source: 'file', 'url', or 'paste' */
+    source: 'file' | 'url' | 'paste';
+    /** Original URL if downloaded from web */
+    sourceUrl?: string;
+    /** Timestamp when added */
+    createdAt: string;
+}
+/**
+ * A single task to be executed by Claude Code
+ */
+export interface Task {
+    /** Unique identifier for the task */
+    id: string;
+    /** Short title describing the task */
+    title: string;
+    /** Detailed description of what needs to be done */
+    description: string;
+    /** Acceptance criteria - short, validatable conditions for task completion */
+    acceptanceCriteria?: string[];
+    /** Current status of the task */
+    status: TaskStatus;
+    /** IDs of tasks that must complete before this one */
+    dependencies: string[];
+    /** Glob patterns for files relevant to this task */
+    contextPatterns: string[];
+    /** Test command to run for validation (optional) */
+    testCommand?: string;
+    /** Number of retry attempts made */
+    retryCount: number;
+    /** Maximum retries before failing (default: 3) */
+    maxRetries: number;
+    /** Action to take when task fails after all retries (default: 'skip') */
+    ifFailed: FailureAction;
+    /** Per-task timeout in milliseconds (default: 60 minutes) */
+    timeout: number;
+    /** Error message if task failed */
+    error?: string;
+    /** Type of failure if task failed (execution vs acceptance criteria) */
+    failureType?: FailureType;
+    /** Brief summary of why task failed (e.g., "Test assertions failed", "Build error") */
+    failureReason?: string;
+    /** History of retry attempts with detailed error info */
+    retryHistory?: RetryAttempt[];
+    /** Timestamp when task was created */
+    createdAt: string;
+    /** Timestamp when task was last updated */
+    updatedAt: string;
+    /** Execution duration in milliseconds (set when task completes) */
+    durationMs?: number;
+    /** Brief summary of what was accomplished (2 lines, set after successful completion) */
+    resultSummary?: string;
+    /** Image IDs referenced in this task's description (e.g., from [image:id] placeholders) */
+    imageRefs?: string[];
+    /** Results from acceptance criteria validation (set after validation runs) */
+    acceptanceCriteriaResults?: AcceptanceCriterionResult[];
+}
+/**
+ * Overall project state
+ */
+export interface ProjectState {
+    /** The original goal/PRD provided by the user */
+    goal: string;
+    /** Name of the project */
+    projectName: string;
+    /** Path to the project directory */
+    projectPath: string;
+    /** Current status of the project */
+    status: ProjectStatus;
+    /** All tasks for this project */
+    tasks: Task[];
+    /** Index of the current task being executed */
+    currentTaskIndex: number;
+    /** Timestamp when project was created */
+    createdAt: string;
+    /** Timestamp when project was last updated */
+    updatedAt: string;
+    /** Image metadata for all project images (keyed by image ID) */
+    images?: Record<string, ImageMetadata>;
+    /** Input history for the TUI (max 20 entries, persisted across sessions) */
+    inputHistory?: string[];
+}
+/**
+ * Result from executing a task
+ */
+export interface ExecutionResult {
+    /** Whether the execution succeeded */
+    success: boolean;
+    /** Output from Claude Code */
+    output: string;
+    /** Error output if any */
+    error?: string;
+    /** Exit code from the process */
+    exitCode: number;
+}
+/**
+ * Result for a single acceptance criterion validation
+ */
+export interface AcceptanceCriterionResult {
+    /** The criterion text that was validated */
+    criterion: string;
+    /** Whether the criterion passed */
+    passed: boolean;
+    /** Explanation of why it passed or failed */
+    explanation: string;
+}
+/**
+ * Result from validation
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    passed: boolean;
+    /** Details about what was checked */
+    details: string;
+    /** Test output if tests were run */
+    testOutput?: string;
+    /** Review feedback if AI review was used */
+    reviewFeedback?: string;
+    /** Per-criterion results from acceptance criteria validation */
+    acceptanceCriteriaResults?: AcceptanceCriterionResult[];
+    /** Brief summary of what was accomplished (2 lines) */
+    resultSummary?: string;
+}
+/**
+ * Configuration for Maistro
+ */
+export interface MaistroConfig {
+    /** Path to store project state */
+    statePath: string;
+    /** Default test command */
+    defaultTestCommand?: string;
+    /** Maximum retries per task (default: 3) */
+    maxRetries: number;
+    /** Delay between retry attempts in milliseconds (default: 60000 = 1 minute) */
+    retryDelayMs: number;
+    /** Default timeout for Claude Code execution in milliseconds (default: 3600000 = 1 hour) */
+    executionTimeout: number;
+    /** Default action when task fails after all retries (default: 'skip') */
+    defaultIfFailed: FailureAction;
+    /** Whether to use AI review for validation */
+    useAIReview: boolean;
+}
+/**
+ * Question type for discovery phase
+ */
+export type DiscoveryQuestionType = 'choice' | 'text' | 'multi-choice';
+/**
+ * A single question to ask during project discovery
+ */
+export interface DiscoveryQuestion {
+    /** Unique identifier for the question */
+    id: string;
+    /** The question to ask the user */
+    question: string;
+    /** Type of input expected */
+    type: DiscoveryQuestionType;
+    /** Options for choice/multi-choice questions */
+    options?: string[];
+    /** Default value or selection */
+    default?: string;
+    /** Reason why this question is being asked */
+    reason?: string;
+}
+/**
+ * Result from the discovery phase
+ */
+export interface DiscoveryResult {
+    /** Brief summary of understanding of the goal */
+    summary: string;
+    /** Questions that were asked */
+    questions: DiscoveryQuestion[];
+    /** Assumptions made about the project */
+    assumptions: string[];
+    /** User's answers to the questions (keyed by question id) */
+    answers: Record<string, string>;
+    /** Whether the user confirmed the discovery results */
+    confirmed: boolean;
+}
+/**
+ * Context built from discovery to inform task decomposition
+ */
+export interface ProjectContext {
+    /** Original goal */
+    goal: string;
+    /** Summary from discovery */
+    summary: string;
+    /** User's preferences and answers */
+    preferences: Record<string, string>;
+    /** Confirmed assumptions */
+    assumptions: string[];
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_CONFIG: MaistroConfig;
+/**
+ * Create a new task with default values
+ */
+export declare function createTask(partial: Partial<Task> & Pick<Task, 'id' | 'title' | 'description'>): Task;
+/**
+ * Create a new project state with default values
+ */
+export declare function createProjectState(goal: string, projectName: string, projectPath: string): ProjectState;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,46 @@
+/**
+ * Default configuration
+ */
+export const DEFAULT_CONFIG = {
+    statePath: '.maistro/state.json',
+    maxRetries: 3,
+    retryDelayMs: 60 * 1000, // 1 minute between retries
+    executionTimeout: 60 * 60 * 1000, // 1 hour per task
+    defaultIfFailed: 'skip',
+    useAIReview: false,
+};
+/**
+ * Create a new task with default values
+ */
+export function createTask(partial) {
+    const now = new Date().toISOString();
+    return {
+        status: 'pending',
+        dependencies: [],
+        contextPatterns: [],
+        retryCount: 0,
+        maxRetries: DEFAULT_CONFIG.maxRetries,
+        ifFailed: DEFAULT_CONFIG.defaultIfFailed,
+        timeout: DEFAULT_CONFIG.executionTimeout,
+        createdAt: now,
+        updatedAt: now,
+        ...partial,
+    };
+}
+/**
+ * Create a new project state with default values
+ */
+export function createProjectState(goal, projectName, projectPath) {
+    const now = new Date().toISOString();
+    return {
+        goal,
+        projectName,
+        projectPath,
+        status: 'idle',
+        tasks: [],
+        currentTaskIndex: 0,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoQA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,2BAA2B;IACpD,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,kBAAkB;IACpD,eAAe,EAAE,MAAM;IACvB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAmE;IAC5F,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,EAAE;QACnB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,QAAQ,EAAE,cAAc,CAAC,eAAe;QACxC,OAAO,EAAE,cAAc,CAAC,gBAAgB;QACxC,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,WAAmB,EACnB,WAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,IAAI;QACJ,WAAW;QACX,WAAW;QACX,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/ui-visual-test.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env npx tsx
+/**
+ * UI Visual Test Script
+ *
+ * Renders UI components in terminal for visual verification.
+ * Run with: npx tsx src/ui-visual-test.ts
+ *
+ * This script tests:
+ * - Input box rendering with placeholder and various input lengths
+ * - Cursor block positioning
+ * - Border alignment
+ * - Indeterminate progress bar animation
+ */
+export {};
+//# sourceMappingURL=ui-visual-test.d.ts.map

package/dist/ui-visual-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-visual-test.d.ts","sourceRoot":"","sources":["../src/ui-visual-test.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/ui-visual-test.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env npx tsx
+/**
+ * UI Visual Test Script
+ *
+ * Renders UI components in terminal for visual verification.
+ * Run with: npx tsx src/ui-visual-test.ts
+ *
+ * This script tests:
+ * - Input box rendering with placeholder and various input lengths
+ * - Cursor block positioning
+ * - Border alignment
+ * - Indeterminate progress bar animation
+ */
+// ============================================================================
+// Constants matching app.ts planViewInput implementation
+// ============================================================================
+const HINT = 'Enter send';
+const PLACEHOLDER = 'type command...';
+// ANSI escape sequences
+const ANSI = {
+    RESET: '\x1b[0m',
+    DIM: '\x1b[90m',
+    CYAN: '\x1b[36m',
+    REVERSE: '\x1b[7m',
+    HIDE_CURSOR: '\x1b[?25l',
+    SHOW_CURSOR: '\x1b[?25h',
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function visualWidth(str) {
+    return str.replace(/\x1b\[[0-9;]*m/g, '').length;
+}
+function renderInputLine(inputBuffer, termWidth) {
+    const contentWidth = termWidth - 2;
+    const hintLen = HINT.length;
+    if (inputBuffer) {
+        const usedWidth = 2 + inputBuffer.length + 1 + hintLen;
+        const padding = Math.max(1, contentWidth - usedWidth);
+        return `${ANSI.DIM}>${ANSI.RESET} ${inputBuffer}${ANSI.REVERSE} ${ANSI.RESET}${' '.repeat(padding)}${ANSI.DIM}${HINT}${ANSI.RESET}`;
+    }
+    else {
+        const usedWidth = 2 + 1 + PLACEHOLDER.length + hintLen;
+        const padding = Math.max(1, contentWidth - usedWidth);
+        return `${ANSI.DIM}> ${ANSI.RESET}${ANSI.REVERSE} ${ANSI.RESET}${ANSI.DIM}${PLACEHOLDER}${' '.repeat(padding)}${HINT}${ANSI.RESET}`;
+    }
+}
+function renderInputBox(inputBuffer, termWidth) {
+    const border = `${ANSI.DIM}${'─'.repeat(termWidth)}${ANSI.RESET}`;
+    return [border, renderInputLine(inputBuffer, termWidth), border];
+}
+function renderProgressBar(pos, barWidth, bounceWidth) {
+    let bar = '';
+    for (let i = 0; i < barWidth; i++) {
+        if (i >= pos && i < pos + bounceWidth) {
+            bar += `${ANSI.CYAN}█${ANSI.RESET}`;
+        }
+        else {
+            bar += `${ANSI.DIM}░${ANSI.RESET}`;
+        }
+    }
+    return bar;
+}
+// ============================================================================
+// Visual Tests
+// ============================================================================
+function runVisualTests() {
+    const termWidth = process.stdout.columns || 80;
+    console.log('\n' + '='.repeat(termWidth));
+    console.log('UI VISUAL TESTS');
+    console.log('='.repeat(termWidth));
+    console.log(`Terminal width: ${termWidth}`);
+    console.log(`Content width: ${termWidth - 2}`);
+    // Test 1: Placeholder mode
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 1: Placeholder Mode');
+    console.log('-'.repeat(40));
+    const placeholderLines = renderInputBox('', termWidth);
+    process.stdout.write(ANSI.HIDE_CURSOR);
+    console.log(placeholderLines.join('\n'));
+    process.stdout.write(ANSI.SHOW_CURSOR);
+    console.log(`Line width: ${visualWidth(placeholderLines[1])} (expected: ${termWidth - 2})`);
+    // Test 2: Short input
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 2: Short Input ("run")');
+    console.log('-'.repeat(40));
+    const shortLines = renderInputBox('run', termWidth);
+    process.stdout.write(ANSI.HIDE_CURSOR);
+    console.log(shortLines.join('\n'));
+    process.stdout.write(ANSI.SHOW_CURSOR);
+    console.log(`Line width: ${visualWidth(shortLines[1])} (expected: ${termWidth - 2})`);
+    // Test 3: Medium input
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 3: Medium Input ("expand")');
+    console.log('-'.repeat(40));
+    const mediumLines = renderInputBox('expand', termWidth);
+    process.stdout.write(ANSI.HIDE_CURSOR);
+    console.log(mediumLines.join('\n'));
+    process.stdout.write(ANSI.SHOW_CURSOR);
+    console.log(`Line width: ${visualWidth(mediumLines[1])} (expected: ${termWidth - 2})`);
+    // Test 4: Long input
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 4: Long Input');
+    console.log('-'.repeat(40));
+    const longInput = 'modify add new task for testing the long input case';
+    const longLines = renderInputBox(longInput, termWidth);
+    process.stdout.write(ANSI.HIDE_CURSOR);
+    console.log(longLines.join('\n'));
+    process.stdout.write(ANSI.SHOW_CURSOR);
+    console.log(`Line width: ${visualWidth(longLines[1])} (expected: ${termWidth - 2})`);
+    // Test 5: Indeterminate progress bar
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 5: Indeterminate Progress Bar Animation');
+    console.log('-'.repeat(40));
+    const barWidth = 30;
+    const bounceWidth = 6;
+    const positions = [0, 4, 8, 12, 16, 20, 24, 20, 16, 12, 8, 4, 0];
+    for (const pos of positions) {
+        const bar = renderProgressBar(pos, barWidth, bounceWidth);
+        console.log(`${bar}       📋 Task 1  ${ANSI.CYAN}Executing${ANSI.RESET}  ${ANSI.DIM}(5s)${ANSI.RESET}`);
+    }
+    // Test 6: Verify cursor is inside box
+    console.log('\n' + '-'.repeat(40));
+    console.log('Test 6: Cursor Position Verification');
+    console.log('-'.repeat(40));
+    console.log('The cursor block (inverted space) should appear:');
+    console.log('- In placeholder mode: After "> "');
+    console.log('- In input mode: After the typed text\n');
+    const verifyLines = renderInputBox('test', termWidth);
+    process.stdout.write(ANSI.HIDE_CURSOR);
+    console.log(verifyLines.join('\n'));
+    process.stdout.write(ANSI.SHOW_CURSOR);
+    console.log('\nCursor should be visible as inverted block after "test"');
+    console.log('\n' + '='.repeat(termWidth));
+    console.log('VISUAL TESTS COMPLETE');
+    console.log('='.repeat(termWidth) + '\n');
+}
+// Run tests
+runVisualTests();
+export {};
+//# sourceMappingURL=ui-visual-test.js.map

package/dist/ui-visual-test.js.map

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