@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/mascot-overlay.js

@@ -0,0 +1,146 @@
+/**
+ * Mascot Overlay
+ *
+ * Standalone mascot selection overlay.
+ * Accessible via /mascot command or from Config overlay.
+ *
+ * Features:
+ * - All mascot expressions
+ * - Live preview
+ * - Persists selection to settings
+ */
+import * as terminal from './terminal.js';
+import { BaseOverlay, isEscape, isEnter, isSpace, isCtrlC, isNavigateUp, isNavigateDown, isClose, renderBorder, } from './base/index.js';
+import { getSettings, setSetting } from '../settings/index.js';
+import { MASCOT_OPTIONS, MASCOT_LABELS, EXPRESSIONS, } from './mascot/index.js';
+// =============================================================================
+// Mascot Overlay Class
+// =============================================================================
+class MascotOverlay extends BaseOverlay {
+    constructor(options = {}) {
+        const currentMascot = options.currentMascot ?? getSettings().mascot;
+        // Find current mascot in options list
+        let selectedIndex = 0;
+        const mascotIndex = MASCOT_OPTIONS.findIndex(m => m === currentMascot);
+        if (mascotIndex >= 0) {
+            selectedIndex = mascotIndex;
+        }
+        const initialState = {
+            lineCount: 0,
+            maxLineCount: 0,
+            selectedIndex,
+            currentMascot,
+        };
+        super(initialState, { minHeight: 18 });
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const lines = [];
+        // Get preview lines for side-by-side layout
+        const selectedOption = MASCOT_OPTIONS[this.state.selectedIndex];
+        let previewLines = [];
+        let previewLabel = '';
+        if (selectedOption === 'none') {
+            previewLabel = '(No mascot)';
+            previewLines = ['', '', '', '', '', ''];
+        }
+        else if (selectedOption === 'random') {
+            previewLabel = '(Random on startup)';
+            previewLines = EXPRESSIONS.neutral;
+        }
+        else {
+            previewLabel = MASCOT_LABELS[selectedOption];
+            previewLines = EXPRESSIONS[selectedOption];
+        }
+        // Header
+        lines.push(border);
+        lines.push(`  ${s.primaryBold('Select Mascot')}`);
+        lines.push('');
+        // Column widths
+        const listColWidth = 28; // Space for list items
+        const gap = 4; // Gap between columns
+        const previewColStart = listColWidth + gap;
+        // Build side-by-side layout
+        // Options list on left, preview on right
+        const optionCount = MASCOT_OPTIONS.length;
+        const previewHeight = previewLines.length;
+        // Calculate where to start the preview (vertically center it with the list)
+        const previewStartRow = Math.max(0, Math.floor((optionCount - previewHeight) / 2));
+        for (let i = 0; i < Math.max(optionCount, previewStartRow + previewHeight + 1); i++) {
+            let leftPart = '';
+            let rightPart = '';
+            // Left column: option list
+            if (i < optionCount) {
+                const option = MASCOT_OPTIONS[i];
+                const isSelected = i === this.state.selectedIndex;
+                const isCurrent = option === this.state.currentMascot;
+                const prefix = isSelected ? s.primary('❯ ') : '  ';
+                const num = `${(i + 1).toString().padStart(2)}. `;
+                const checkmark = isCurrent ? s.success(' ✓') : '';
+                const label = isSelected ? s.primary(MASCOT_LABELS[option]) : MASCOT_LABELS[option];
+                leftPart = `  ${prefix}${num}${label}${checkmark}`;
+            }
+            // Right column: preview
+            const previewRow = i - previewStartRow;
+            if (previewRow === -1) {
+                // Preview label above the mascot
+                rightPart = s.muted(previewLabel);
+            }
+            else if (previewRow >= 0 && previewRow < previewHeight) {
+                rightPart = s.secondary(previewLines[previewRow]);
+            }
+            // Combine columns with proper spacing
+            // Strip ANSI codes for width calculation
+            // eslint-disable-next-line no-control-regex
+            const leftPlain = leftPart.replace(/\x1b\[[0-9;]*m/g, '');
+            const padding = ' '.repeat(Math.max(0, previewColStart - leftPlain.length));
+            lines.push(leftPart + padding + rightPart);
+        }
+        // Footer
+        lines.push('');
+        lines.push(border);
+        lines.push(`  ${s.muted('↑↓/jk Navigate · Enter/Space Select · q/Esc Close')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        const maxIndex = MASCOT_OPTIONS.length - 1;
+        // Ctrl+C always closes
+        if (isCtrlC(data)) {
+            this.close({});
+            return;
+        }
+        // q or Esc closes
+        if (isEscape(data) || isClose(data)) {
+            this.close({});
+            return;
+        }
+        // Navigation
+        if (isNavigateUp(data) && this.state.selectedIndex > 0) {
+            this.state.selectedIndex--;
+            this.update();
+            return;
+        }
+        if (isNavigateDown(data) && this.state.selectedIndex < maxIndex) {
+            this.state.selectedIndex++;
+            this.update();
+            return;
+        }
+        // Enter/Space to select
+        if (isEnter(data) || isSpace(data)) {
+            const selectedMascot = MASCOT_OPTIONS[this.state.selectedIndex];
+            setSetting('mascot', selectedMascot);
+            this.close({
+                mascotChanged: selectedMascot,
+            });
+        }
+    }
+}
+// =============================================================================
+// Export Function
+// =============================================================================
+export async function showMascotOverlay(options = {}) {
+    return new MascotOverlay(options).show();
+}

package/dist/ui/model-overlay-v2.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Model Overlay V2
+ *
+ * Model selection overlay using TabbedListOverlayV2 for the new Overlay interface.
+ * Works with TerminalUI's overlay management.
+ *
+ * Features:
+ * - Tabs by provider (Claude, OpenAI, Gemini, Ollama)
+ * - Hot-swap detection (same provider = immediate, different = restart)
+ * - API key status checking
+ * - Persists selection to settings
+ */
+import { TabbedListOverlayV2 } from './base/index.js';
+interface ModelOption {
+    id: string;
+    name: string;
+    description: string;
+    provider: string;
+}
+export interface ModelOverlayV2Options {
+    /** Current model ID */
+    currentModel?: string;
+    /** Current provider (for hot-swap detection) */
+    currentProvider?: string;
+}
+export interface ModelOverlayV2Result {
+    /** Selected model ID (if changed) */
+    modelChanged?: string;
+    /** Selected provider */
+    provider?: string;
+    /** Whether restart is required (different provider) */
+    requiresRestart?: boolean;
+}
+/**
+ * Model selection overlay using the new Overlay interface.
+ * Displays available models in a tabbed list by provider.
+ */
+export declare class ModelOverlayV2 extends TabbedListOverlayV2<ModelOption, ModelOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "model-overlay-v2";
+    private readonly currentModel;
+    private readonly currentProvider;
+    constructor(options?: ModelOverlayV2Options);
+    /**
+     * Override to handle model selection on Enter.
+     */
+    protected onItemSelected(item: ModelOption): ModelOverlayV2Result | undefined;
+}
+export {};

package/dist/ui/model-overlay-v2.js

@@ -0,0 +1,118 @@
+/**
+ * Model Overlay V2
+ *
+ * Model selection overlay using TabbedListOverlayV2 for the new Overlay interface.
+ * Works with TerminalUI's overlay management.
+ *
+ * Features:
+ * - Tabs by provider (Claude, OpenAI, Gemini, Ollama)
+ * - Hot-swap detection (same provider = immediate, different = restart)
+ * - API key status checking
+ * - Persists selection to settings
+ */
+import { TabbedListOverlayV2, } from './base/index.js';
+import { setSetting } from '../settings/index.js';
+import { hasApiKey, settingsProviderToCredentialKey } from '../utils/credentials.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PAGE_SIZE = 10;
+const PROVIDER_TABS = [
+    { id: 'claude', label: 'Claude' },
+    { id: 'openai', label: 'OpenAI' },
+    { id: 'gemini', label: 'Gemini' },
+    { id: 'ollama', label: 'Ollama' },
+];
+const MODEL_OPTIONS = [
+    // Claude
+    { id: 'claude-sonnet-4-20250514', name: 'Sonnet 4', description: 'Best for everyday tasks', provider: 'claude' },
+    { id: 'claude-opus-4-20250514', name: 'Opus 4', description: 'Most capable for complex work', provider: 'claude' },
+    { id: 'claude-3-5-haiku-20241022', name: 'Haiku 3.5', description: 'Fastest for quick answers', provider: 'claude' },
+    // OpenAI
+    { id: 'gpt-4o', name: 'GPT-4o', description: 'Best overall', provider: 'openai' },
+    { id: 'gpt-4o-mini', name: 'GPT-4o Mini', description: 'Fast and affordable', provider: 'openai' },
+    // Gemini
+    { id: 'gemini-2.0-flash', name: 'Gemini 2.0 Flash', description: 'Fast multimodal', provider: 'gemini' },
+    { id: 'gemini-2.5-flash', name: 'Gemini 2.5 Flash', description: 'Latest stable flash', provider: 'gemini' },
+    { id: 'gemini-2.5-pro', name: 'Gemini 2.5 Pro', description: 'Most capable Gemini', provider: 'gemini' },
+    // Ollama
+    { id: 'llama3.2', name: 'Llama 3.2', description: 'Local model', provider: 'ollama' },
+    { id: 'mistral', name: 'Mistral', description: 'Local model', provider: 'ollama' },
+    { id: 'codellama', name: 'Code Llama', description: 'Code-focused local model', provider: 'ollama' },
+];
+// =============================================================================
+// Model Overlay V2 Class
+// =============================================================================
+/**
+ * Model selection overlay using the new Overlay interface.
+ * Displays available models in a tabbed list by provider.
+ */
+export class ModelOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'model-overlay-v2';
+    currentModel;
+    currentProvider;
+    constructor(options = {}) {
+        const currentModel = options.currentModel ?? 'claude-sonnet-4-20250514';
+        const currentProvider = options.currentProvider ?? 'claude';
+        // Find the initial tab based on current provider
+        const initialTabIndex = PROVIDER_TABS.findIndex((t) => t.id === currentProvider);
+        super({
+            title: 'Select Model',
+            tabs: PROVIDER_TABS,
+            items: MODEL_OPTIONS,
+            pageSize: PAGE_SIZE,
+            filterByTab: (item, tabId) => item.provider === tabId,
+            getSearchText: (item) => `${item.name} ${item.description} ${item.id}`,
+            renderItem: (item, isSelected, styles) => {
+                const isCurrent = item.id === currentModel;
+                const prefix = isSelected ? styles.primary(' > ') : '   ';
+                // Check API key status for this provider
+                const providerType = item.provider;
+                const credKey = settingsProviderToCredentialKey(providerType);
+                const hasKey = item.provider === 'ollama' || hasApiKey(credKey);
+                const keyIndicator = hasKey ? styles.success('●') : styles.error('○');
+                const name = isSelected
+                    ? styles.primary(item.name.padEnd(18))
+                    : styles.muted(item.name.padEnd(18));
+                const desc = styles.muted(item.description);
+                const currentBadge = isCurrent ? styles.success(' (current)') : '';
+                return `${prefix}${keyIndicator} ${name}${desc}${currentBadge}`;
+            },
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Select · Esc Exit search';
+                }
+                return 'Tab Provider · ↑↓/jk · / Search · Enter Select · q/Esc Close';
+            },
+            emptyMessage: 'No models available for this provider.',
+            noResultsMessage: 'No models match the search.',
+        });
+        this.currentModel = currentModel;
+        this.currentProvider = currentProvider;
+        // Set initial tab based on current provider
+        if (initialTabIndex >= 0) {
+            this.state.currentTab = initialTabIndex;
+            // Re-filter items for the selected tab
+            this.state.filteredItems = MODEL_OPTIONS.filter((item) => item.provider === PROVIDER_TABS[initialTabIndex]?.id);
+        }
+    }
+    /**
+     * Override to handle model selection on Enter.
+     */
+    onItemSelected(item) {
+        if (item.id === this.currentModel) {
+            // Same model, no change
+            return undefined;
+        }
+        // Save to settings
+        setSetting('defaultModel', item.id);
+        setSetting('defaultProvider', item.provider);
+        const requiresRestart = item.provider !== this.currentProvider;
+        return {
+            modelChanged: item.id,
+            provider: item.provider,
+            requiresRestart,
+        };
+    }
+}

package/dist/ui/model-overlay.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Model Overlay
+ *
+ * Standalone model selection overlay with tabbed provider interface.
+ * Accessible via /model command or from Config overlay.
+ *
+ * Features:
+ * - Tabbed by provider (Claude, OpenAI, Gemini, Ollama)
+ * - Hot-swap detection (same provider = immediate, different = restart)
+ * - API key status checking
+ * - Persists selection to settings
+ */
+export interface ModelOverlayOptions {
+    /** Current model ID */
+    currentModel?: string;
+    /** Current provider (for hot-swap detection) */
+    currentProvider?: string;
+}
+export interface ModelOverlayResult {
+    /** Selected model ID (if changed) */
+    modelChanged?: string;
+    /** Selected provider */
+    provider?: string;
+    /** Whether restart is required (different provider) */
+    requiresRestart?: boolean;
+}
+export declare function showModelOverlay(options?: ModelOverlayOptions): Promise<ModelOverlayResult>;

package/dist/ui/model-overlay.js

@@ -0,0 +1,221 @@
+/**
+ * Model Overlay
+ *
+ * Standalone model selection overlay with tabbed provider interface.
+ * Accessible via /model command or from Config overlay.
+ *
+ * Features:
+ * - Tabbed by provider (Claude, OpenAI, Gemini, Ollama)
+ * - Hot-swap detection (same provider = immediate, different = restart)
+ * - API key status checking
+ * - Persists selection to settings
+ */
+import * as terminal from './terminal.js';
+import { BaseOverlay, isEscape, isTab, isShiftTab, isEnter, isCtrlC, isNavigateUp, isNavigateDown, isClose, extractPrintable, renderBorder, } from './base/index.js';
+import { TabFeature } from './features/tab-feature.js';
+import { setSetting } from '../settings/index.js';
+import { hasApiKey, settingsProviderToCredentialKey } from '../utils/credentials.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PROVIDER_TABS = [
+    { id: 'claude', label: 'Claude' },
+    { id: 'openai', label: 'OpenAI' },
+    { id: 'gemini', label: 'Gemini' },
+    { id: 'ollama', label: 'Ollama' },
+];
+const MODEL_OPTIONS = [
+    // Claude
+    { id: 'claude-sonnet-4-20250514', name: 'Sonnet 4', description: 'Best for everyday tasks', provider: 'claude' },
+    { id: 'claude-opus-4-20250514', name: 'Opus 4', description: 'Most capable for complex work', provider: 'claude' },
+    { id: 'claude-3-5-haiku-20241022', name: 'Haiku 3.5', description: 'Fastest for quick answers', provider: 'claude' },
+    // OpenAI
+    { id: 'gpt-4o', name: 'GPT-4o', description: 'Best overall', provider: 'openai' },
+    { id: 'gpt-4o-mini', name: 'GPT-4o Mini', description: 'Fast and affordable', provider: 'openai' },
+    // Gemini
+    { id: 'gemini-2.0-flash', name: 'Gemini 2.0 Flash', description: 'Fast multimodal', provider: 'gemini' },
+    { id: 'gemini-2.5-flash', name: 'Gemini 2.5 Flash', description: 'Latest stable flash', provider: 'gemini' },
+    { id: 'gemini-2.5-pro', name: 'Gemini 2.5 Pro', description: 'Most capable Gemini', provider: 'gemini' },
+    // Ollama
+    { id: 'llama3.2', name: 'Llama 3.2', description: 'Local model', provider: 'ollama' },
+    { id: 'mistral', name: 'Mistral', description: 'Local model', provider: 'ollama' },
+    { id: 'codellama', name: 'Code Llama', description: 'Code-focused local model', provider: 'ollama' },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function getModelsForProvider(providerId) {
+    return MODEL_OPTIONS.filter(m => m.provider === providerId);
+}
+function findModelById(modelId) {
+    return MODEL_OPTIONS.find(m => m.id === modelId);
+}
+function getProviderTabIndex(providerId) {
+    const index = PROVIDER_TABS.findIndex(p => p.id === providerId);
+    return index >= 0 ? index : 0;
+}
+// =============================================================================
+// Model Overlay Class
+// =============================================================================
+class ModelOverlay extends BaseOverlay {
+    tabFeature;
+    constructor(options = {}) {
+        const currentModel = findModelById(options.currentModel ?? '');
+        const currentProvider = options.currentProvider ?? currentModel?.provider ?? 'claude';
+        // Find initial tab and model index
+        const initialTab = getProviderTabIndex(currentProvider);
+        const providerModels = getModelsForProvider(PROVIDER_TABS[initialTab].id);
+        const modelIndex = currentModel
+            ? providerModels.findIndex(m => m.id === currentModel.id)
+            : 0;
+        const initialState = {
+            lineCount: 0,
+            maxLineCount: 0,
+            selectedIndex: modelIndex >= 0 ? modelIndex : 0,
+            currentTab: initialTab,
+            activeProvider: currentProvider,
+            currentModelId: options.currentModel ?? '',
+        };
+        super(initialState, { minHeight: 16 });
+        this.tabFeature = new TabFeature(PROVIDER_TABS, () => {
+            // Reset selection when tab changes
+            this.state.selectedIndex = 0;
+        });
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const lines = [];
+        const currentProviderTab = PROVIDER_TABS[this.state.currentTab];
+        const providerModels = getModelsForProvider(currentProviderTab.id);
+        const isActiveProvider = currentProviderTab.id === this.state.activeProvider;
+        // Header
+        lines.push(border);
+        lines.push(`  ${s.primaryBold('Select Model')}`);
+        lines.push('');
+        // Provider tabs with checkmark on active
+        let tabLine = '  ';
+        for (let i = 0; i < PROVIDER_TABS.length; i++) {
+            const tab = PROVIDER_TABS[i];
+            const isActive = tab.id === this.state.activeProvider;
+            const indicator = isActive ? ' ✓' : '';
+            if (i === this.state.currentTab) {
+                tabLine += s.selected(` ${tab.label}${indicator} `) + ' ';
+            }
+            else {
+                tabLine += s.muted(` ${tab.label}${indicator} `) + ' ';
+            }
+        }
+        tabLine += s.muted('(Tab · 1-4)');
+        lines.push(tabLine);
+        lines.push('');
+        // Provider status message
+        if (isActiveProvider) {
+            lines.push(`  ${s.success('Current provider - changes apply immediately')}`);
+        }
+        else {
+            lines.push(`  ${s.warning('Different provider - restart required to apply')}`);
+        }
+        // API key status (not needed for Ollama)
+        if (currentProviderTab.id !== 'ollama') {
+            const credKey = settingsProviderToCredentialKey(currentProviderTab.id);
+            if (!hasApiKey(credKey)) {
+                lines.push(`  ${s.error('⚠ No API key configured - use /keys to set it')}`);
+            }
+        }
+        lines.push('');
+        // Model list
+        for (let i = 0; i < providerModels.length; i++) {
+            const model = providerModels[i];
+            const isSelected = i === this.state.selectedIndex;
+            const isCurrent = model.id === this.state.currentModelId;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const checkmark = isCurrent ? s.success(' ✓') : '';
+            const label = isSelected ? s.primary(model.name) : model.name;
+            const desc = s.muted(` · ${model.description}`);
+            lines.push(`  ${prefix}${label.padEnd(20)}${desc}${checkmark}`);
+        }
+        // Pad for consistent height
+        const minModelLines = 4;
+        for (let i = providerModels.length; i < minModelLines; i++) {
+            lines.push('');
+        }
+        // Footer
+        lines.push('');
+        lines.push(border);
+        lines.push(`  ${s.muted('Tab/1-4 Provider · ↑↓/jk Model · Enter Select · q/Esc Close')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        const currentProviderTab = PROVIDER_TABS[this.state.currentTab];
+        const providerModels = getModelsForProvider(currentProviderTab.id);
+        const maxModelIndex = providerModels.length - 1;
+        // Ctrl+C always closes
+        if (isCtrlC(data)) {
+            this.close({});
+            return;
+        }
+        // q or Esc closes
+        if (isEscape(data) || isClose(data)) {
+            this.close({});
+            return;
+        }
+        // Tab switching: Tab for next, Shift+Tab for previous
+        if (isTab(data)) {
+            this.state.currentTab = (this.state.currentTab + 1) % PROVIDER_TABS.length;
+            this.state.selectedIndex = 0;
+            this.update();
+            return;
+        }
+        if (isShiftTab(data)) {
+            this.state.currentTab = (this.state.currentTab - 1 + PROVIDER_TABS.length) % PROVIDER_TABS.length;
+            this.state.selectedIndex = 0;
+            this.update();
+            return;
+        }
+        // Number keys 1-4 for provider tabs
+        const char = extractPrintable(data);
+        if (char && char >= '1' && char <= '4') {
+            const tabNum = parseInt(char, 10) - 1;
+            if (tabNum < PROVIDER_TABS.length) {
+                this.state.currentTab = tabNum;
+                this.state.selectedIndex = 0;
+                this.update();
+            }
+            return;
+        }
+        // Navigation (↑↓ or j/k)
+        if (isNavigateUp(data) && this.state.selectedIndex > 0) {
+            this.state.selectedIndex--;
+            this.update();
+            return;
+        }
+        if (isNavigateDown(data) && this.state.selectedIndex < maxModelIndex) {
+            this.state.selectedIndex++;
+            this.update();
+            return;
+        }
+        // Enter - select model
+        if (isEnter(data) && providerModels.length > 0) {
+            const selectedModel = providerModels[this.state.selectedIndex];
+            const isCurrentProvider = selectedModel.provider === this.state.activeProvider;
+            // Persist to settings
+            setSetting('defaultProvider', selectedModel.provider);
+            setSetting('defaultModel', selectedModel.id);
+            this.close({
+                modelChanged: selectedModel.id,
+                provider: selectedModel.provider,
+                requiresRestart: !isCurrentProvider,
+            });
+            return;
+        }
+    }
+}
+// =============================================================================
+// Export Function
+// =============================================================================
+export async function showModelOverlay(options = {}) {
+    return new ModelOverlay(options).show();
+}

package/dist/ui/model-warning-overlay.js

@@ -105,10 +105,9 @@ export async function showModelWarningOverlay(options) {
     let selectedIndex = 0;
     let lineCount = 0;
     let maxLineCount = 0;
-    // Pause footer animation
+    // Pause footer animation (this overlay is called from repl.ts, not agent tools)
     pauseForOverlay();
-    // Clear and prepare
-    terminal.clearToEndOfScreen();
+    // Ensure we start from a fresh line
     terminal.writeLine('');
     terminal.hideCursor();
     const wasRawMode = process.stdin.isRaw;
@@ -116,8 +115,6 @@ export async function showModelWarningOverlay(options) {
     // Initial render
     lineCount = render(options, selectedIndex, 0);
     maxLineCount = Math.max(maxLineCount, lineCount);
-    // Re-render to stabilize
-    lineCount = render(options, selectedIndex, lineCount, lineCount);
     return new Promise((resolve) => {
         const cleanup = () => {
             terminal.clearLinesAbove(maxLineCount);
@@ -127,6 +124,7 @@ export async function showModelWarningOverlay(options) {
                 terminal.disableRawMode();
             }
             process.stdin.removeListener('data', handleData);
+            // Resume footer (this overlay handles its own pause/resume)
             resumeAfterOverlay();
         };
         const handleData = (data) => {

package/dist/ui/new-overlay.d.ts

@@ -0,0 +1,34 @@
+/**
+ * New Project Overlay
+ *
+ * Modal overlay for the /new 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
+ *   2. Description
+ *   3. Repo pattern (single vs two-repo)
+ *   4. Tech stack
+ *   5. Coding standards
+ *   6. Initialize git?
+ *   7. Track with project database?
+ *   8. Workflow mode (if tracking enabled)
+ *   9. Confirmation
+ */
+type WorkflowMode = 'flexible' | 'guided';
+export interface NewProjectResult {
+    created: boolean;
+    projectPath?: string;
+    docsPath?: string;
+    filesCreated?: string[];
+    trackInDatabase?: boolean;
+    workflowMode?: WorkflowMode;
+    projectName?: string;
+    description?: string;
+}
+/**
+ * Show the init wizard overlay
+ */
+export declare function showNewProjectOverlay(): Promise<NewProjectResult>;
+export {};