@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/init-overlay.js

@@ -1,7 +1,9 @@
 /**
- * Init Overlay
+ * Init Overlay (Refactored)
  *
  * Modal overlay for the /init wizard - creates new projects with structured workflow.
+ * Uses InlineOverlay base class for consistent lifecycle management.
+ *
  * Steps:
  *   0. Project type (new vs existing)
  *   1. Project name
@@ -10,18 +12,27 @@
  *   4. Tech stack
  *   5. Coding standards
  *   6. Initialize git?
- *   7. Confirmation
+ *   7. Track with project database?
+ *   8. Workflow mode (if tracking enabled)
+ *   9. Confirmation
  */
 import chalk from 'chalk';
 import * as terminal from './terminal.js';
 import { getStyles } from '../themes/index.js';
+import { InlineOverlay } from './base/inline-overlay.js';
 import { TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, generateProject, isValidProjectName, projectExists, } from '../templates/index.js';
+import { getProjectsPath, ensureProjectsDirectory } from '../settings/paths.js';
 // =============================================================================
 // Constants
 // =============================================================================
 const TECH_STACK_OPTIONS = ['react-node-pg', 'react-python-pg', 'vue-node-pg', 'custom'];
 const CODING_STANDARDS_OPTIONS = ['strict', 'relaxed', 'custom'];
 const REPO_PATTERN_OPTIONS = ['single', 'two-repo'];
+const WORKFLOW_MODE_OPTIONS = ['flexible', 'guided'];
+const WORKFLOW_MODE_LABELS = {
+    flexible: 'Flexible (user-driven, exploratory)',
+    guided: 'Guided (structured step-by-step workflow)',
+};
 // =============================================================================
 // Rendering Helpers
 // =============================================================================
@@ -30,7 +41,7 @@ function renderHeader(step) {
     const lines = [];
     const cols = terminal.getTerminalWidth();
     lines.push(s.muted('─'.repeat(Math.max(1, cols - 1))));
-    lines.push(' ' + s.primaryBold('Initialize New Project') + s.muted(` [${String(step)}/7]`));
+    lines.push(' ' + s.primaryBold('Initialize New Project') + s.muted(` [${String(step)}/9]`));
     lines.push('');
     return lines;
 }
@@ -39,13 +50,16 @@ function renderFooter(step) {
     const lines = [];
     lines.push('');
     if (step === 0) {
-        lines.push(s.muted(' ↑↓ Navigate · Enter Select · Esc Cancel'));
+        lines.push(s.muted(' ↑↓/jk Navigate · Enter Select · q/Esc Cancel'));
+    }
+    else if (step === 9) {
+        lines.push(s.muted(' ↑↓/jk Navigate · Enter Confirm · Esc Back'));
     }
-    else if (step === 7) {
-        lines.push(s.muted(' ↑↓ Navigate · Enter Confirm · Esc Go back'));
+    else if (isSelectionStep(step)) {
+        lines.push(s.muted(' ↑↓/jk Navigate · Enter Select · Esc Back'));
     }
     else {
-        lines.push(s.muted(' Enter Confirm · Esc Go back'));
+        lines.push(s.muted(' Enter Confirm · Esc Back'));
     }
     return lines;
 }
@@ -159,6 +173,33 @@ function renderStep6(state) {
     return lines;
 }
 function renderStep7(state) {
+    const s = getStyles();
+    const lines = [];
+    lines.push(chalk.bold(' Track with project database?'));
+    lines.push('');
+    lines.push(renderSelectionOption(0, state.selectedIndex, 'Yes (recommended)'));
+    lines.push(renderSelectionOption(1, state.selectedIndex, 'No'));
+    lines.push('');
+    lines.push(s.muted(' Enables persistent project tracking, backlog management,'));
+    lines.push(s.muted(' and workflow features across sessions.'));
+    return lines;
+}
+function renderStep8(state) {
+    const s = getStyles();
+    const lines = [];
+    lines.push(chalk.bold(' Workflow mode'));
+    lines.push('');
+    for (let i = 0; i < WORKFLOW_MODE_OPTIONS.length; i++) {
+        const mode = WORKFLOW_MODE_OPTIONS[i];
+        const suffix = i === 0 ? ' (recommended)' : '';
+        lines.push(renderSelectionOption(i, state.selectedIndex, `${String(i + 1)}. ${WORKFLOW_MODE_LABELS[mode]}${suffix}`));
+    }
+    lines.push('');
+    lines.push(s.muted(' Flexible: Work at your own pace, agent responds to requests'));
+    lines.push(s.muted(' Guided: Agent suggests next steps, tracks work item progress'));
+    return lines;
+}
+function renderStep9(state) {
     const s = getStyles();
     const lines = [];
     lines.push(chalk.bold(' Ready to create project?'));
@@ -169,6 +210,10 @@ function renderStep7(state) {
     lines.push(` Tech:        ${s.primary(state.techStack ? TECH_STACK_LABELS[state.techStack] : 'Not set')}`);
     lines.push(` Standards:   ${s.primary(state.codingStandards ? CODING_STANDARDS_LABELS[state.codingStandards] : 'Not set')}`);
     lines.push(` Git:         ${s.primary(state.initGit ? 'Yes' : 'No')}`);
+    lines.push(` DB Tracking: ${s.primary(state.trackInDatabase ? 'Yes' : 'No')}`);
+    if (state.trackInDatabase) {
+        lines.push(` Workflow:    ${s.primary(WORKFLOW_MODE_LABELS[state.workflowMode])}`);
+    }
     if (state.repoPattern === 'two-repo') {
         lines.push('');
         lines.push(s.muted(` Docs repo:   ./${state.projectName}-docs/`));
@@ -182,51 +227,15 @@ function renderStep7(state) {
     lines.push(renderSelectionOption(1, state.selectedIndex, 'Cancel'));
     return lines;
 }
-// =============================================================================
-// Unified Rendering
-// =============================================================================
-function buildLines(state) {
+function renderGenerating(state) {
     const lines = [];
-    lines.push(...renderHeader(state.step));
-    switch (state.step) {
-        case 0:
-            lines.push(...renderStep0(state));
-            break;
-        case 1:
-            lines.push(...renderStep1(state));
-            break;
-        case 2:
-            lines.push(...renderStep2(state));
-            break;
-        case 3:
-            lines.push(...renderStep3(state));
-            break;
-        case 4:
-            lines.push(...renderStep4(state));
-            break;
-        case 5:
-            lines.push(...renderStep5(state));
-            break;
-        case 6:
-            lines.push(...renderStep6(state));
-            break;
-        case 7:
-            lines.push(...renderStep7(state));
-            break;
-    }
-    lines.push(...renderFooter(state.step));
+    lines.push('');
+    lines.push(chalk.cyan(` Creating project "${state.projectName}"...`));
+    lines.push('');
     return lines;
 }
-function render(state, prevLineCount) {
-    const lines = buildLines(state);
-    // Clear previous content
-    terminal.clearLinesAbove(prevLineCount);
-    // Write new content
-    terminal.write(lines.join('\n'));
-    return lines.length;
-}
 // =============================================================================
-// Step Navigation
+// Step Helpers
 // =============================================================================
 function getMaxOptionsForStep(step) {
     switch (step) {
@@ -242,284 +251,354 @@ function getMaxOptionsForStep(step) {
             return 2;
         case 7:
             return 2;
+        case 8:
+            return WORKFLOW_MODE_OPTIONS.length;
+        case 9:
+            return 2;
         default:
             return 0;
     }
 }
 function isSelectionStep(step) {
-    return [0, 3, 4, 5, 6, 7].includes(step);
+    return [0, 3, 4, 5, 6, 7, 8, 9].includes(step);
 }
 function isInputStep(step) {
     return [1, 2].includes(step);
 }
-/**
- * Show the init wizard overlay
- */
-export async function showInitOverlay() {
-    const state = {
-        step: 0,
-        projectType: null,
-        projectName: '',
-        description: '',
-        repoPattern: null,
-        techStack: null,
-        codingStandards: null,
-        initGit: true,
-        selectedIndex: 0,
-        inputBuffer: '',
-        error: null,
-    };
-    let lineCount = 0;
-    terminal.writeLine('');
-    terminal.hideCursor();
-    const wasRawMode = process.stdin.isRaw;
-    terminal.enableRawMode();
-    lineCount = render(state, 0);
-    // Navigate to next step
-    const nextStep = () => {
-        switch (state.step) {
+// =============================================================================
+// Init Overlay Implementation
+// =============================================================================
+class InitOverlayImpl extends InlineOverlay {
+    getInitialState() {
+        return {
+            step: 0,
+            projectType: null,
+            projectName: '',
+            description: '',
+            repoPattern: null,
+            techStack: null,
+            codingStandards: null,
+            initGit: true,
+            trackInDatabase: true,
+            workflowMode: 'flexible',
+            selectedIndex: 0,
+            inputBuffer: '',
+            error: null,
+            isGenerating: false,
+        };
+    }
+    render() {
+        // Show generating state if applicable
+        if (this.state.isGenerating) {
+            return renderGenerating(this.state);
+        }
+        const lines = [];
+        lines.push(...renderHeader(this.state.step));
+        switch (this.state.step) {
             case 0:
-                // Only "new" option works (index 0)
-                if (state.selectedIndex === 0) {
-                    state.projectType = 'new';
-                    state.step = 1;
-                    state.inputBuffer = '';
-                    state.selectedIndex = 0;
+                lines.push(...renderStep0(this.state));
+                break;
+            case 1:
+                lines.push(...renderStep1(this.state));
+                break;
+            case 2:
+                lines.push(...renderStep2(this.state));
+                break;
+            case 3:
+                lines.push(...renderStep3(this.state));
+                break;
+            case 4:
+                lines.push(...renderStep4(this.state));
+                break;
+            case 5:
+                lines.push(...renderStep5(this.state));
+                break;
+            case 6:
+                lines.push(...renderStep6(this.state));
+                break;
+            case 7:
+                lines.push(...renderStep7(this.state));
+                break;
+            case 8:
+                lines.push(...renderStep8(this.state));
+                break;
+            case 9:
+                lines.push(...renderStep9(this.state));
+                break;
+        }
+        lines.push(...renderFooter(this.state.step));
+        return lines;
+    }
+    async handleKey(data) {
+        // Ctrl+C always cancels
+        if (this.isCtrlCKey(data)) {
+            return { type: 'close', result: { created: false } };
+        }
+        // q key on step 0 cancels
+        const char = data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f ? String.fromCharCode(data[0]) : null;
+        if (this.state.step === 0 && char === 'q') {
+            return { type: 'close', result: { created: false } };
+        }
+        // Escape on step 0 cancels, otherwise goes back
+        if (this.isEscapeKey(data)) {
+            if (this.state.step === 0) {
+                return { type: 'close', result: { created: false } };
+            }
+            this.prevStep();
+            return { type: 'continue' };
+        }
+        // Handle selection steps
+        if (isSelectionStep(this.state.step)) {
+            const maxOptions = getMaxOptionsForStep(this.state.step);
+            // j/k for vim-style navigation
+            if (char === 'j' && this.state.selectedIndex < maxOptions - 1) {
+                this.state.selectedIndex++;
+                return { type: 'continue' };
+            }
+            if (char === 'k' && this.state.selectedIndex > 0) {
+                this.state.selectedIndex--;
+                return { type: 'continue' };
+            }
+            if (this.isUpArrowKey(data) && this.state.selectedIndex > 0) {
+                this.state.selectedIndex--;
+                return { type: 'continue' };
+            }
+            if (this.isDownArrowKey(data) && this.state.selectedIndex < maxOptions - 1) {
+                this.state.selectedIndex++;
+                return { type: 'continue' };
+            }
+            if (this.isEnterKey(data)) {
+                // Step 0 - only allow "new" option
+                if (this.state.step === 0 && this.state.selectedIndex === 1) {
+                    this.state.error = 'This option is coming soon';
+                    return { type: 'continue' };
+                }
+                // Step 9 - confirmation
+                if (this.state.step === 9) {
+                    if (this.state.selectedIndex === 1) {
+                        // Cancel
+                        return { type: 'close', result: { created: false } };
+                    }
+                    // Verify all required fields are set
+                    if (!this.state.repoPattern || !this.state.techStack || !this.state.codingStandards) {
+                        this.state.error = 'Missing configuration values';
+                        return { type: 'continue' };
+                    }
+                    // Show generating state
+                    this.state.isGenerating = true;
+                    this.requestRender();
+                    // Create project
+                    const config = {
+                        name: this.state.projectName,
+                        description: this.state.description,
+                        repoPattern: this.state.repoPattern,
+                        techStack: this.state.techStack,
+                        codingStandards: this.state.codingStandards,
+                        initGit: this.state.initGit,
+                    };
+                    try {
+                        // Ensure projects directory exists and create project there
+                        ensureProjectsDirectory();
+                        const projectsPath = getProjectsPath();
+                        const result = await generateProject(config, projectsPath);
+                        if (result.success) {
+                            return {
+                                type: 'close',
+                                result: {
+                                    created: true,
+                                    projectPath: result.projectPath,
+                                    docsPath: result.docsPath,
+                                    filesCreated: result.filesCreated,
+                                    trackInDatabase: this.state.trackInDatabase,
+                                    workflowMode: this.state.workflowMode,
+                                    projectName: this.state.projectName,
+                                    description: this.state.description,
+                                },
+                            };
+                        }
+                        else {
+                            this.state.isGenerating = false;
+                            this.state.error = result.error ?? 'Unknown error';
+                            return { type: 'continue' };
+                        }
+                    }
+                    catch (error) {
+                        this.state.isGenerating = false;
+                        this.state.error = error.message;
+                        return { type: 'continue' };
+                    }
+                }
+                this.nextStep();
+                return { type: 'continue' };
+            }
+        }
+        // Handle input steps
+        if (isInputStep(this.state.step)) {
+            if (this.isEnterKey(data)) {
+                if (this.validateInput()) {
+                    this.nextStep();
+                }
+                return { type: 'continue' };
+            }
+            if (this.isBackspaceKey(data)) {
+                this.state.inputBuffer = this.state.inputBuffer.slice(0, -1);
+                this.state.error = null;
+                return { type: 'continue' };
+            }
+            // Regular character input
+            const inputChar = this.getPrintableChar(data);
+            if (inputChar) {
+                this.state.inputBuffer += inputChar;
+                this.state.error = null;
+                return { type: 'continue' };
+            }
+        }
+        return { type: 'continue' };
+    }
+    getCleanupSummary(result) {
+        if (!result.created) {
+            return chalk.yellow(' Init cancelled');
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    nextStep() {
+        switch (this.state.step) {
+            case 0:
+                if (this.state.selectedIndex === 0) {
+                    this.state.projectType = 'new';
+                    this.state.step = 1;
+                    this.state.inputBuffer = '';
+                    this.state.selectedIndex = 0;
                 }
                 break;
             case 1:
-                state.projectName = state.inputBuffer.trim();
-                state.step = 2;
-                state.inputBuffer = '';
+                this.state.projectName = this.state.inputBuffer.trim();
+                this.state.step = 2;
+                this.state.inputBuffer = '';
                 break;
             case 2:
-                state.description = state.inputBuffer.trim();
-                state.step = 3;
-                state.selectedIndex = 0;
+                this.state.description = this.state.inputBuffer.trim();
+                this.state.step = 3;
+                this.state.selectedIndex = 0;
                 break;
             case 3:
-                state.repoPattern = REPO_PATTERN_OPTIONS[state.selectedIndex];
-                state.step = 4;
-                state.selectedIndex = 0;
+                this.state.repoPattern = REPO_PATTERN_OPTIONS[this.state.selectedIndex];
+                this.state.step = 4;
+                this.state.selectedIndex = 0;
                 break;
             case 4:
-                state.techStack = TECH_STACK_OPTIONS[state.selectedIndex];
-                state.step = 5;
-                state.selectedIndex = 0;
+                this.state.techStack = TECH_STACK_OPTIONS[this.state.selectedIndex];
+                this.state.step = 5;
+                this.state.selectedIndex = 0;
                 break;
             case 5:
-                state.codingStandards = CODING_STANDARDS_OPTIONS[state.selectedIndex];
-                state.step = 6;
-                state.selectedIndex = 0;
+                this.state.codingStandards = CODING_STANDARDS_OPTIONS[this.state.selectedIndex];
+                this.state.step = 6;
+                this.state.selectedIndex = 0;
                 break;
             case 6:
-                state.initGit = state.selectedIndex === 0;
-                state.step = 7;
-                state.selectedIndex = 0;
+                this.state.initGit = this.state.selectedIndex === 0;
+                this.state.step = 7;
+                this.state.selectedIndex = 0;
+                break;
+            case 7:
+                this.state.trackInDatabase = this.state.selectedIndex === 0;
+                // If tracking in DB, ask for workflow mode; otherwise skip to confirmation
+                this.state.step = this.state.trackInDatabase ? 8 : 9;
+                this.state.selectedIndex = 0;
+                break;
+            case 8:
+                this.state.workflowMode = WORKFLOW_MODE_OPTIONS[this.state.selectedIndex];
+                this.state.step = 9;
+                this.state.selectedIndex = 0;
                 break;
         }
-        state.error = null;
-    };
-    // Navigate to previous step
-    const prevStep = () => {
-        switch (state.step) {
+        this.state.error = null;
+    }
+    prevStep() {
+        switch (this.state.step) {
             case 1:
-                state.step = 0;
-                state.selectedIndex = 0;
+                this.state.step = 0;
+                this.state.selectedIndex = 0;
                 break;
             case 2:
-                state.step = 1;
-                state.inputBuffer = state.projectName;
+                this.state.step = 1;
+                this.state.inputBuffer = this.state.projectName;
                 break;
             case 3:
-                state.step = 2;
-                state.inputBuffer = state.description;
+                this.state.step = 2;
+                this.state.inputBuffer = this.state.description;
                 break;
             case 4:
-                state.step = 3;
-                state.selectedIndex = state.repoPattern ? REPO_PATTERN_OPTIONS.indexOf(state.repoPattern) : 0;
+                this.state.step = 3;
+                this.state.selectedIndex = this.state.repoPattern ? REPO_PATTERN_OPTIONS.indexOf(this.state.repoPattern) : 0;
                 break;
             case 5:
-                state.step = 4;
-                state.selectedIndex = state.techStack ? TECH_STACK_OPTIONS.indexOf(state.techStack) : 0;
+                this.state.step = 4;
+                this.state.selectedIndex = this.state.techStack ? TECH_STACK_OPTIONS.indexOf(this.state.techStack) : 0;
                 break;
             case 6:
-                state.step = 5;
-                state.selectedIndex = state.codingStandards ? CODING_STANDARDS_OPTIONS.indexOf(state.codingStandards) : 0;
+                this.state.step = 5;
+                this.state.selectedIndex = this.state.codingStandards ? CODING_STANDARDS_OPTIONS.indexOf(this.state.codingStandards) : 0;
                 break;
             case 7:
-                state.step = 6;
-                state.selectedIndex = state.initGit ? 0 : 1;
+                this.state.step = 6;
+                this.state.selectedIndex = this.state.initGit ? 0 : 1;
+                break;
+            case 8:
+                this.state.step = 7;
+                this.state.selectedIndex = this.state.trackInDatabase ? 0 : 1;
+                break;
+            case 9:
+                // Go back to workflow mode if DB tracking is on, otherwise go to DB tracking step
+                this.state.step = this.state.trackInDatabase ? 8 : 7;
+                this.state.selectedIndex = this.state.trackInDatabase
+                    ? WORKFLOW_MODE_OPTIONS.indexOf(this.state.workflowMode)
+                    : 1;
                 break;
         }
-        state.error = null;
-    };
-    // Validate input for current step
-    const validateInput = () => {
-        if (state.step === 1) {
-            const name = state.inputBuffer.trim();
+        this.state.error = null;
+    }
+    validateInput() {
+        if (this.state.step === 1) {
+            const name = this.state.inputBuffer.trim();
             if (!name) {
-                state.error = 'Project name is required';
+                this.state.error = 'Project name is required';
                 return false;
             }
             if (!isValidProjectName(name)) {
-                state.error = 'Invalid name. Use lowercase letters, numbers, hyphens (2-50 chars, start with letter)';
+                this.state.error = 'Invalid name. Use lowercase letters, numbers, hyphens (2-50 chars, start with letter)';
                 return false;
             }
             if (projectExists(name)) {
-                state.error = `Directory "${name}" already exists`;
+                this.state.error = `Directory "${name}" already exists`;
                 return false;
             }
         }
-        if (state.step === 2) {
-            const desc = state.inputBuffer.trim();
+        if (this.state.step === 2) {
+            const desc = this.state.inputBuffer.trim();
             if (!desc) {
-                state.error = 'Description is required';
+                this.state.error = 'Description is required';
                 return false;
             }
             if (desc.length < 10) {
-                state.error = 'Description too short (min 10 characters)';
+                this.state.error = 'Description too short (min 10 characters)';
                 return false;
             }
         }
         return true;
-    };
-    return new Promise((resolve) => {
-        const cleanup = () => {
-            terminal.clearLinesAbove(lineCount);
-            terminal.writeLine('');
-            terminal.showCursor();
-            if (!wasRawMode) {
-                terminal.disableRawMode();
-            }
-            process.stdin.removeListener('data', handleData);
-        };
-        const handleData = (data) => {
-            void onData(data);
-        };
-        const onData = async (data) => {
-            const isEscape = data.length === 1 && data[0] === 0x1b;
-            const isUpArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41;
-            const isDownArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42;
-            const isCtrlC = data.length === 1 && data[0] === 0x03;
-            const isEnter = data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
-            const isBackspace = data.length === 1 && (data[0] === 0x7f || data[0] === 0x08);
-            // Ctrl+C always cancels
-            if (isCtrlC) {
-                cleanup();
-                resolve({ created: false });
-                return;
-            }
-            // Escape on step 0 cancels, otherwise goes back
-            if (isEscape) {
-                if (state.step === 0) {
-                    cleanup();
-                    resolve({ created: false });
-                    return;
-                }
-                prevStep();
-                lineCount = render(state, lineCount);
-                return;
-            }
-            // Handle selection steps
-            if (isSelectionStep(state.step)) {
-                const maxOptions = getMaxOptionsForStep(state.step);
-                if (isUpArrow && state.selectedIndex > 0) {
-                    state.selectedIndex--;
-                    lineCount = render(state, lineCount);
-                    return;
-                }
-                if (isDownArrow && state.selectedIndex < maxOptions - 1) {
-                    state.selectedIndex++;
-                    lineCount = render(state, lineCount);
-                    return;
-                }
-                if (isEnter) {
-                    // Step 0 - only allow "new" option
-                    if (state.step === 0 && state.selectedIndex === 1) {
-                        state.error = 'This option is coming soon';
-                        lineCount = render(state, lineCount);
-                        return;
-                    }
-                    // Step 7 - confirmation
-                    if (state.step === 7) {
-                        if (state.selectedIndex === 1) {
-                            // Cancel
-                            cleanup();
-                            resolve({ created: false });
-                            return;
-                        }
-                        // Verify all required fields are set (they should be by step 7)
-                        if (!state.repoPattern || !state.techStack || !state.codingStandards) {
-                            state.error = 'Missing configuration values';
-                            lineCount = render(state, lineCount);
-                            return;
-                        }
-                        // Create project
-                        const config = {
-                            name: state.projectName,
-                            description: state.description,
-                            repoPattern: state.repoPattern,
-                            techStack: state.techStack,
-                            codingStandards: state.codingStandards,
-                            initGit: state.initGit,
-                        };
-                        cleanup();
-                        // Show "creating..." message
-                        terminal.writeLine(chalk.cyan(' Creating project...'));
-                        try {
-                            const result = await generateProject(config);
-                            if (result.success) {
-                                resolve({
-                                    created: true,
-                                    projectPath: result.projectPath,
-                                    docsPath: result.docsPath,
-                                    filesCreated: result.filesCreated,
-                                });
-                            }
-                            else {
-                                terminal.writeLine(chalk.red(` Error: ${result.error ?? 'Unknown error'}`));
-                                resolve({ created: false });
-                            }
-                        }
-                        catch (error) {
-                            terminal.writeLine(chalk.red(` Error: ${error.message}`));
-                            resolve({ created: false });
-                        }
-                        return;
-                    }
-                    nextStep();
-                    lineCount = render(state, lineCount);
-                    return;
-                }
-            }
-            // Handle input steps
-            if (isInputStep(state.step)) {
-                if (isEnter) {
-                    if (validateInput()) {
-                        nextStep();
-                        lineCount = render(state, lineCount);
-                    }
-                    else {
-                        lineCount = render(state, lineCount);
-                    }
-                    return;
-                }
-                if (isBackspace) {
-                    state.inputBuffer = state.inputBuffer.slice(0, -1);
-                    state.error = null;
-                    lineCount = render(state, lineCount);
-                    return;
-                }
-                // Regular character input
-                const char = data.toString('utf-8');
-                if (char.length === 1 && char.charCodeAt(0) >= 32) {
-                    state.inputBuffer += char;
-                    state.error = null;
-                    lineCount = render(state, lineCount);
-                }
-            }
-        };
-        process.stdin.on('data', handleData);
-    });
+    }
+}
+// =============================================================================
+// Main Export
+// =============================================================================
+/**
+ * Show the init wizard overlay
+ */
+export async function showInitOverlay() {
+    const overlay = new InitOverlayImpl();
+    return overlay.show();
 }