rafcode 1.0.0

package/dist/prompts/planning.js

@@ -0,0 +1,163 @@
+/**
+ * Generate the planning prompt with system instructions and user message separated.
+ * - systemPrompt: RAF planning conventions, file structure, interview process (via --append-system-prompt)
+ * - userMessage: Reference to input.md file (via positional argument, triggers Claude to start)
+ */
+export function getPlanningPrompt(params) {
+    const { projectPath } = params;
+    const systemPrompt = `You are a project planning assistant for RAF (Ralph's Automation Framework). Your task is to analyze the user's project description and create detailed task plans.
+
+## Your Goals
+
+1. **Analyze the input** and identify 3-8 distinct, actionable tasks
+2. **Interview the user** about EACH task to gather specific requirements
+3. **Create plan files** for each task with clear instructions
+
+## Project Location
+
+Project folder: ${projectPath}
+
+## Instructions
+
+### Step 1: Identify and Order Tasks
+
+Based on the project description, identify 3-8 distinct tasks. Each task should:
+- Be independently completable
+- Have a clear outcome
+- Take roughly 10-30 minutes of work for Claude
+
+**CRITICAL: Order tasks by logical execution order.** Lower-numbered tasks should be completed before higher-numbered ones. Consider:
+- Setup/foundation tasks come first (e.g., defining schemas, creating interfaces)
+- Core implementation tasks come next
+- Integration and extension tasks come later
+- Testing and validation tasks typically come last
+
+### Step 2: Interview the User
+
+For EACH task you identify, you MUST use the AskUserQuestion tool to gather:
+- Specific requirements and constraints
+- Technology preferences
+- Any existing code or patterns to follow
+- Edge cases to handle
+
+DO NOT skip the interview step. The quality of your plans depends on understanding the user's exact needs.
+
+### Step 2.5: Record Decisions
+
+After EACH interview question is answered, record the Q&A pair in the decisions file:
+- ${projectPath}/decisions.md
+
+Use this format:
+\`\`\`markdown
+# Project Decisions
+
+## [Question asked]
+[User's answer]
+
+## [Question asked]
+[User's answer]
+\`\`\`
+
+This file serves as documentation of design choices made during planning. Append each new Q&A pair as you conduct the interview.
+
+### Step 3: Create Plan Files
+
+After interviewing the user about all tasks, create plan files in the plans folder:
+- ${projectPath}/plans/001-task-name.md
+- ${projectPath}/plans/002-task-name.md
+- etc.
+
+Each plan file should follow this structure:
+
+\`\`\`markdown
+# Task: [Task Name]
+
+## Objective
+[Clear, one-sentence description of what this task accomplishes]
+
+## Context
+[Why this task is needed, how it fits into the larger project]
+
+## Dependencies
+[Optional section - omit if task has no dependencies]
+[Comma-separated list of task IDs this task depends on, e.g., "001, 002"]
+[If a dependency fails, this task will be automatically blocked]
+
+## Requirements
+[Specific requirements gathered from the user interview]
+- Requirement 1
+- Requirement 2
+- ...
+
+## Implementation Steps
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+...
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] All tests pass
+
+## Notes
+[Any additional context, warnings, or considerations]
+\`\`\`
+
+### Step 4: Infer Task Dependencies
+
+For each task, analyze which other tasks must complete successfully before it can begin. Add a \`## Dependencies\` section to plan files that have prerequisites.
+
+**How to identify dependencies:**
+- If task B uses output/artifacts from task A → B depends on A
+- If task B modifies code created by task A → B depends on A
+- If task B tests functionality from task A → B depends on A
+- If task B extends or builds upon task A → B depends on A
+
+**Dependency format examples:**
+\`\`\`markdown
+## Dependencies
+001
+\`\`\`
+or for multiple dependencies:
+\`\`\`markdown
+## Dependencies
+001, 002
+\`\`\`
+
+**Rules for dependencies:**
+- Only reference lower-numbered tasks (tasks are ordered by execution order)
+- Omit the Dependencies section entirely if a task has no prerequisites
+- Keep dependency lists minimal - only direct dependencies, not transitive ones
+- Never create circular dependencies (impossible if you only reference lower-numbered tasks)
+
+### Step 5: Confirm Completion
+
+After creating all plan files:
+1. Provide a summary of the tasks you've created
+2. Display this exit message to the user:
+
+\`\`\`
+Planning complete! To exit this session and run your tasks:
+  1. Press Ctrl-C twice to exit
+  2. Then run: raf do <project>
+\`\`\`
+
+## Important Rules
+
+1. ALWAYS interview the user before creating plans
+2. Create plans in numbered order (001, 002, 003, etc.) reflecting logical execution order
+3. Use descriptive, kebab-case names for plan files
+4. Each plan should be self-contained with all context needed
+5. Infer dependencies automatically - analyze task relationships, don't ask the user about dependencies
+6. Only add Dependencies section when a task genuinely requires another to complete first
+7. Dependencies must only reference lower-numbered tasks to prevent circular dependencies
+8. Be specific - vague plans lead to poor execution`;
+    const userMessage = `Here is my project description:
+
+${params.inputContent}
+
+Please analyze this and start the planning interview.`;
+    return { systemPrompt, userMessage };
+}
+//# sourceMappingURL=planning.js.map

package/dist/prompts/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/prompts/planning.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA4B;IAC5D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE/B,MAAM,YAAY,GAAG;;;;;;;;;;kBAUL,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BzB,WAAW;;;;;;;;;;;;;;;;;;IAkBX,WAAW;IACX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDAwFqC,CAAC;IAEnD,MAAM,WAAW,GAAG;;EAEpB,MAAM,CAAC,YAAY;;sDAEiC,CAAC;IAErD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,26 @@
+export interface RafConfig {
+    defaultTimeout: number;
+    defaultMaxRetries: number;
+    autoCommit: boolean;
+    claudeCommand: string;
+    editor?: string;
+}
+export declare const DEFAULT_RAF_CONFIG: RafConfig;
+export type ClaudeModelName = 'sonnet' | 'haiku' | 'opus';
+export interface PlanCommandOptions {
+    projectName?: string;
+    model?: ClaudeModelName;
+    sonnet?: boolean;
+}
+export interface DoCommandOptions {
+    timeout?: number;
+    verbose?: boolean;
+    debug?: boolean;
+    force?: boolean;
+    model?: ClaudeModelName;
+    sonnet?: boolean;
+}
+export interface StatusCommandOptions {
+    json?: boolean;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,SAKhC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/types/config.js

@@ -0,0 +1,7 @@
+export const DEFAULT_RAF_CONFIG = {
+    defaultTimeout: 60,
+    defaultMaxRetries: 3,
+    autoCommit: true,
+    claudeCommand: 'claude',
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,CAAC;IACpB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,QAAQ;CACxB,CAAC"}

package/dist/types/state.d.ts

@@ -0,0 +1,33 @@
+export type ProjectStatus = 'planning' | 'ready' | 'executing' | 'completed' | 'failed';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+export interface TaskState {
+    id: string;
+    planFile: string;
+    status: TaskStatus;
+    attempts: number;
+    startedAt?: string;
+    completedAt?: string;
+    failureReason?: string;
+    commitHash?: string;
+    filesBeforeTask?: string[];
+}
+export interface ProjectConfig {
+    timeout: number;
+    maxRetries: number;
+    autoCommit: boolean;
+}
+export interface ProjectState {
+    version: 1;
+    projectName: string;
+    createdAt: string;
+    updatedAt: string;
+    inputFile: string;
+    status: ProjectStatus;
+    tasks: TaskState[];
+    currentTaskIndex: number;
+    config: ProjectConfig;
+}
+export declare const DEFAULT_PROJECT_CONFIG: ProjectConfig;
+export declare function createInitialState(projectName: string, inputFile: string): ProjectState;
+export declare function createTask(id: string, planFile: string): TaskState;
+//# sourceMappingURL=state.d.ts.map

package/dist/types/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAavF;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAOlE"}

package/dist/types/state.js

@@ -0,0 +1,28 @@
+export const DEFAULT_PROJECT_CONFIG = {
+    timeout: 60,
+    maxRetries: 3,
+    autoCommit: true,
+};
+export function createInitialState(projectName, inputFile) {
+    const now = new Date().toISOString();
+    return {
+        version: 1,
+        projectName,
+        createdAt: now,
+        updatedAt: now,
+        inputFile,
+        status: 'planning',
+        tasks: [],
+        currentTaskIndex: 0,
+        config: { ...DEFAULT_PROJECT_CONFIG },
+    };
+}
+export function createTask(id, planFile) {
+    return {
+        id,
+        planFile,
+        status: 'pending',
+        attempts: 0,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/types/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,SAAiB;IACvE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,WAAW;QACX,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,SAAS;QACT,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,MAAM,EAAE,EAAE,GAAG,sBAAsB,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,QAAgB;IACrD,OAAO;QACL,EAAE;QACF,QAAQ;QACR,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC"}

package/dist/ui/name-picker-subprocess.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Subprocess script for running the name picker.
+ * This isolates @inquirer/prompts from the main process to prevent
+ * stdin corruption that affects subsequent node-pty usage.
+ *
+ * Usage: node name-picker-subprocess.js <json-encoded-names-array> <output-file>
+ * Output: Selected name written to output file
+ */
+export {};
+//# sourceMappingURL=name-picker-subprocess.d.ts.map

package/dist/ui/name-picker-subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-picker-subprocess.d.ts","sourceRoot":"","sources":["../../src/ui/name-picker-subprocess.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/ui/name-picker-subprocess.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Subprocess script for running the name picker.
+ * This isolates @inquirer/prompts from the main process to prevent
+ * stdin corruption that affects subsequent node-pty usage.
+ *
+ * Usage: node name-picker-subprocess.js <json-encoded-names-array> <output-file>
+ * Output: Selected name written to output file
+ */
+import { select, input } from '@inquirer/prompts';
+import * as fs from 'node:fs';
+const OTHER_OPTION_VALUE = '__OTHER__';
+async function main() {
+    // Get names from command line argument
+    const namesJson = process.argv[2];
+    const outputFile = process.argv[3];
+    if (!namesJson || !outputFile) {
+        console.error('Usage: name-picker-subprocess <json-encoded-names-array> <output-file>');
+        process.exit(1);
+    }
+    let names;
+    try {
+        names = JSON.parse(namesJson);
+    }
+    catch {
+        console.error('Invalid JSON input');
+        process.exit(1);
+    }
+    const result = await pickProjectName(names);
+    // Write result to output file
+    fs.writeFileSync(outputFile, result, 'utf-8');
+}
+async function pickProjectName(names) {
+    if (names.length === 0) {
+        return promptForCustomName();
+    }
+    const choices = [
+        ...names.map((name) => ({
+            name: name,
+            value: name,
+        })),
+        {
+            name: 'Other (enter custom name)',
+            value: OTHER_OPTION_VALUE,
+        },
+    ];
+    const selected = await select({
+        message: 'Select a project name:',
+        choices,
+    });
+    if (selected === OTHER_OPTION_VALUE) {
+        return promptForCustomName();
+    }
+    return selected;
+}
+async function promptForCustomName() {
+    const customName = await input({
+        message: 'Enter project name:',
+        validate: (value) => {
+            const trimmed = value.trim();
+            if (!trimmed) {
+                return 'Project name cannot be empty';
+            }
+            if (trimmed.length > 50) {
+                return 'Project name must be 50 characters or less';
+            }
+            if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(trimmed)) {
+                return 'Project name can only contain letters, numbers, hyphens, and underscores';
+            }
+            return true;
+        },
+    });
+    return customName.trim().toLowerCase();
+}
+main().catch((error) => {
+    // Check if user cancelled with Ctrl+C
+    if (error.message?.includes('User force closed') || error.name === 'ExitPromptError') {
+        process.exit(130); // Standard SIGINT exit code
+    }
+    console.error('Error:', error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=name-picker-subprocess.js.map

package/dist/ui/name-picker-subprocess.js.map

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

package/dist/ui/name-picker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Enable direct mode for testing (bypasses subprocess).
+ * This should only be called in test setup.
+ */
+export declare function enableDirectMode(): Promise<void>;
+/**
+ * Disable direct mode (use subprocess).
+ */
+export declare function disableDirectMode(): void;
+/**
+ * Display an interactive name picker with arrow-key navigation.
+ * Runs in a PTY subprocess to completely isolate @inquirer/prompts
+ * stdin manipulation from the main process.
+ *
+ * @param names - Array of generated name suggestions (3-5 names)
+ * @returns The selected or custom project name
+ */
+export declare function pickProjectName(names: string[]): Promise<string>;
+//# sourceMappingURL=name-picker.d.ts.map

package/dist/ui/name-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-picker.d.ts","sourceRoot":"","sources":["../../src/ui/name-picker.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgGtE"}

package/dist/ui/name-picker.js

@@ -0,0 +1,173 @@
+import { fileURLToPath } from 'node:url';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as pty from 'node-pty';
+// For testing: allow direct import of @inquirer/prompts functions
+let directSelect = null;
+let directInput = null;
+const OTHER_OPTION_VALUE = '__OTHER__';
+/**
+ * Enable direct mode for testing (bypasses subprocess).
+ * This should only be called in test setup.
+ */
+export async function enableDirectMode() {
+    const inquirer = await import('@inquirer/prompts');
+    directSelect = inquirer.select;
+    directInput = inquirer.input;
+}
+/**
+ * Disable direct mode (use subprocess).
+ */
+export function disableDirectMode() {
+    directSelect = null;
+    directInput = null;
+}
+/**
+ * Display an interactive name picker with arrow-key navigation.
+ * Runs in a PTY subprocess to completely isolate @inquirer/prompts
+ * stdin manipulation from the main process.
+ *
+ * @param names - Array of generated name suggestions (3-5 names)
+ * @returns The selected or custom project name
+ */
+export async function pickProjectName(names) {
+    // Use direct mode if enabled (for testing)
+    if (directSelect) {
+        return pickProjectNameDirect(names);
+    }
+    // Get path to the subprocess script
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = path.dirname(currentFile);
+    // Use the compiled js file
+    const subprocessScript = path.join(currentDir, 'name-picker-subprocess.js');
+    // Create temp file for result
+    const tempFile = path.join(os.tmpdir(), `raf-name-picker-${process.pid}.txt`);
+    return new Promise((resolve, reject) => {
+        // Spawn subprocess in its own PTY (completely isolates stdin)
+        const ptyProcess = pty.spawn('node', [subprocessScript, JSON.stringify(names), tempFile], {
+            name: 'xterm-256color',
+            cols: process.stdout.columns ?? 80,
+            rows: process.stdout.rows ?? 24,
+            cwd: process.cwd(),
+            env: process.env,
+        });
+        // Set raw mode on our stdin to pass through keypresses
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        // Forward input from our stdin to the PTY
+        const onData = (data) => {
+            ptyProcess.write(data.toString());
+        };
+        process.stdin.on('data', onData);
+        // Forward output from PTY to our stdout
+        ptyProcess.onData((data) => {
+            process.stdout.write(data);
+        });
+        ptyProcess.onExit(({ exitCode }) => {
+            // Cleanup stdin
+            process.stdin.off('data', onData);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+            process.stdin.pause();
+            if (exitCode === 130) {
+                // SIGINT - user cancelled
+                process.exit(130);
+            }
+            if (exitCode !== 0) {
+                // Clean up temp file
+                try {
+                    if (fs.existsSync(tempFile)) {
+                        fs.unlinkSync(tempFile);
+                    }
+                }
+                catch {
+                    // Ignore
+                }
+                reject(new Error(`Name picker subprocess failed with code ${exitCode}`));
+                return;
+            }
+            // Read the result from temp file
+            try {
+                if (!fs.existsSync(tempFile)) {
+                    reject(new Error('Name picker did not write a selection'));
+                    return;
+                }
+                const selectedName = fs.readFileSync(tempFile, 'utf-8').trim();
+                // Clean up temp file
+                try {
+                    fs.unlinkSync(tempFile);
+                }
+                catch {
+                    // Ignore
+                }
+                if (!selectedName) {
+                    reject(new Error('Name picker returned empty selection'));
+                    return;
+                }
+                resolve(selectedName);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    });
+}
+/**
+ * Direct implementation for testing (uses @inquirer/prompts in-process).
+ */
+async function pickProjectNameDirect(names) {
+    if (!directSelect || !directInput) {
+        throw new Error('Direct mode not enabled');
+    }
+    if (names.length === 0) {
+        return promptForCustomNameDirect();
+    }
+    const choices = [
+        ...names.map((name) => ({
+            name: name,
+            value: name,
+        })),
+        {
+            name: 'Other (enter custom name)',
+            value: OTHER_OPTION_VALUE,
+        },
+    ];
+    const selected = await directSelect({
+        message: 'Select a project name:',
+        choices,
+    });
+    if (selected === OTHER_OPTION_VALUE) {
+        return promptForCustomNameDirect();
+    }
+    return selected;
+}
+/**
+ * Prompt user to enter a custom project name (direct mode).
+ */
+async function promptForCustomNameDirect() {
+    if (!directInput) {
+        throw new Error('Direct mode not enabled');
+    }
+    const customName = await directInput({
+        message: 'Enter project name:',
+        validate: (value) => {
+            const trimmed = value.trim();
+            if (!trimmed) {
+                return 'Project name cannot be empty';
+            }
+            if (trimmed.length > 50) {
+                return 'Project name must be 50 characters or less';
+            }
+            if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(trimmed)) {
+                return 'Project name can only contain letters, numbers, hyphens, and underscores';
+            }
+            return true;
+        },
+    });
+    return customName.trim().toLowerCase();
+}
+//# sourceMappingURL=name-picker.js.map

package/dist/ui/name-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-picker.js","sourceRoot":"","sources":["../../src/ui/name-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,kEAAkE;AAClE,IAAI,YAAY,GAAqD,IAAI,CAAC;AAC1E,IAAI,WAAW,GAAoD,IAAI,CAAC;AAExE,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACnD,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,YAAY,GAAG,IAAI,CAAC;IACpB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAe;IACnD,2CAA2C;IAC3C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7C,2BAA2B;IAC3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC;IAE5E,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAE9E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,8DAA8D;QAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE;YACxF,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;YAClC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,GAAG,EAAE,OAAO,CAAC,GAA6B;SAC3C,CAAC,CAAC;QAEH,uDAAuD;QACvD,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEvB,0CAA0C;QAC1C,MAAM,MAAM,GAAG,CAAC,IAAY,EAAQ,EAAE;YACpC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEjC,wCAAwC;QACxC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACjC,gBAAgB;YAChB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAEtB,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;gBACrB,0BAA0B;gBAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;YAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACnB,qBAAqB;gBACrB,IAAI,CAAC;oBACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACzE,OAAO;YACT,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;oBAC3D,OAAO;gBACT,CAAC;gBAED,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAE/D,qBAAqB;gBACrB,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;oBAC1D,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,YAAY,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAAC,KAAe;IAClD,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAG;QACd,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH;YACE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,kBAAkB;SAC1B;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;QAClC,OAAO,EAAE,wBAAwB;QACjC,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;QACpC,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,yBAAyB;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC;QACnC,OAAO,EAAE,qBAAqB;QAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,8BAA8B,CAAC;YACxC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACxB,OAAO,4CAA4C,CAAC;YACtD,CAAC;YACD,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjD,OAAO,0EAA0E,CAAC;YACpF,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC"}

package/dist/ui/project-picker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Information about a pending project for display in the picker.
+ */
+export interface PendingProjectInfo {
+    folder: string;
+    number: number;
+    name: string;
+    path: string;
+    completedTasks: number;
+    totalTasks: number;
+}
+/**
+ * Get all projects that have pending tasks (not fully completed).
+ * Returns projects sorted by number (oldest first).
+ */
+export declare function getPendingProjects(rafDir: string): PendingProjectInfo[];
+/**
+ * Format a project for display in the picker.
+ * Example: "001 fix-auth-bug (2/5 tasks)"
+ */
+export declare function formatProjectChoice(project: PendingProjectInfo): string;
+/**
+ * Display an interactive project picker for pending projects.
+ * Returns the selected project folder name or null if no projects or cancelled.
+ */
+export declare function pickPendingProject(rafDir: string): Promise<string | null>;
+//# sourceMappingURL=project-picker.d.ts.map

package/dist/ui/project-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-picker.d.ts","sourceRoot":"","sources":["../../src/ui/project-picker.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA0BvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAGvE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB/E"}