wiggum-cli 0.12.0 → 0.13.0

package/dist/tui/components/WiggumBanner.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Text, Box } from 'ink';
+import { Text, Box, useStdout } from 'ink';
 import { colors } from '../theme.js';
 /**
  * ASCII art banner for Wiggum CLI
@@ -12,6 +12,8 @@ const BANNER = `██╗    ██╗██╗ ██████╗  ███
 ╚███╔███╔╝██║╚██████╔╝╚██████╔╝╚██████╔╝██║ ╚═╝ ██║
  ╚══╝╚══╝ ╚═╝ ╚═════╝  ╚═════╝  ╚═════╝ ╚═╝     ╚═╝
 `;
+/** Minimum terminal columns needed to display the banner without wrapping */
+const BANNER_MIN_WIDTH = 55;
 /**
  * WiggumBanner component
  *
@@ -25,9 +27,11 @@ const BANNER = `██╗    ██╗██╗ ██████╗  ███
  * ```
  */
 export function WiggumBanner({ color = colors.yellow, compact = false, }) {
-    if (compact) {
+    const { stdout } = useStdout();
+    const columns = stdout?.columns ?? 80;
+    // Auto-compact when terminal is too narrow for the ASCII art
+    if (compact || columns < BANNER_MIN_WIDTH) {
         return (_jsx(Box, { children: _jsx(Text, { color: color, bold: true, children: "WIGGUM CLI" }) }));
     }
-    return (_jsx(Box, { flexDirection: "column", children: _jsx(Text, { color: color, children: BANNER }) }));
+    return (_jsx(Box, { flexDirection: "column", overflow: "hidden", children: _jsx(Text, { color: color, wrap: "truncate", children: BANNER }) }));
 }
-//# sourceMappingURL=WiggumBanner.js.map

package/dist/tui/components/WorkingIndicator.d.ts

@@ -48,4 +48,3 @@ export interface WorkingIndicatorProps {
  * ```
  */
 export declare function WorkingIndicator({ state, showElapsedTime, variant, }: WorkingIndicatorProps): React.ReactElement | null;
-//# sourceMappingURL=WorkingIndicator.d.ts.map

package/dist/tui/components/WorkingIndicator.js

@@ -68,4 +68,3 @@ export function WorkingIndicator({ state, showElapsedTime = true, variant = 'act
     }
     return (_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: indicatorColor, children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { color: indicatorColor, children: status }), showElapsedTime && elapsedMs >= 1000 && (_jsxs(Text, { dimColor: true, children: ["(", formatElapsedTime(elapsedMs), ")"] })), hint && (_jsxs(Text, { color: colors.brown, dimColor: true, children: ["(", hint, ")"] }))] }));
 }
-//# sourceMappingURL=WorkingIndicator.js.map

package/dist/tui/components/index.d.ts

@@ -29,4 +29,3 @@ export { ActionOutput, ActionList } from './ActionOutput.js';
 export type { ActionOutputProps, ActionListProps, ActionStatus } from './ActionOutput.js';
 export { ErrorCard, CommonErrors } from './ErrorCard.js';
 export type { ErrorCardProps, ErrorSuggestion } from './ErrorCard.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/tui/components/index.js

@@ -15,4 +15,3 @@ export { PasswordInput } from './PasswordInput.js';
 export { Confirm } from './Confirm.js';
 export { ActionOutput, ActionList } from './ActionOutput.js';
 export { ErrorCard, CommonErrors } from './ErrorCard.js';
-//# sourceMappingURL=index.js.map

package/dist/tui/hooks/index.d.ts

@@ -11,4 +11,3 @@ export { useCommandHistory } from './useCommandHistory.js';
 export type { UseCommandHistoryReturn } from './useCommandHistory.js';
 export { useSync } from './useSync.js';
 export type { SyncStatus, UseSyncReturn } from './useSync.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/tui/hooks/index.js

@@ -7,4 +7,3 @@ export { useInit } from './useInit.js';
 export { INIT_PHASE_CONFIGS, INIT_TOTAL_PHASES } from './useInit.js';
 export { useCommandHistory } from './useCommandHistory.js';
 export { useSync } from './useSync.js';
-//# sourceMappingURL=index.js.map

package/dist/tui/hooks/useBackgroundRuns.d.ts

@@ -0,0 +1,52 @@
+/**
+ * useBackgroundRuns - Hook for tracking background run processes
+ *
+ * Manages a list of backgrounded feature loop runs, polling their
+ * status files periodically to track completion.
+ */
+import { type LoopStatus } from '../utils/loop-status.js';
+/**
+ * A backgrounded feature loop run
+ */
+export interface BackgroundRun {
+    /** Feature name being implemented */
+    featureName: string;
+    /** Timestamp when backgrounded */
+    backgroundedAt: number;
+    /** Path to the log file */
+    logPath: string;
+    /** Last polled status */
+    lastStatus: LoopStatus;
+    /** Whether the run has completed */
+    completed: boolean;
+    /** If polling was stopped due to repeated failures, the error reason */
+    pollError?: string;
+}
+/**
+ * Return type for useBackgroundRuns hook
+ */
+export interface UseBackgroundRunsReturn {
+    /** Current list of background runs */
+    runs: BackgroundRun[];
+    /** Add a feature to background tracking. Reads initial status and starts polling. */
+    background: (featureName: string) => void;
+    /** Remove a completed run from tracking */
+    dismiss: (featureName: string) => void;
+    /** Get a specific run by feature name */
+    getRun: (featureName: string) => BackgroundRun | undefined;
+}
+/**
+ * Hook to track background feature loop runs
+ *
+ * @example
+ * ```tsx
+ * const { runs, background, dismiss, getRun } = useBackgroundRuns();
+ *
+ * // When user presses Esc on RunScreen
+ * background('my-feature');
+ *
+ * // Check if a feature is running in background
+ * const run = getRun('my-feature');
+ * ```
+ */
+export declare function useBackgroundRuns(): UseBackgroundRunsReturn;

package/dist/tui/hooks/useBackgroundRuns.js

@@ -0,0 +1,121 @@
+/**
+ * useBackgroundRuns - Hook for tracking background run processes
+ *
+ * Manages a list of backgrounded feature loop runs, polling their
+ * status files periodically to track completion.
+ */
+import { useState, useCallback, useEffect, useRef } from 'react';
+import { readLoopStatus, getLoopLogPath } from '../utils/loop-status.js';
+import { logger } from '../../utils/logger.js';
+const POLL_INTERVAL_MS = 5000;
+/**
+ * Hook to track background feature loop runs
+ *
+ * @example
+ * ```tsx
+ * const { runs, background, dismiss, getRun } = useBackgroundRuns();
+ *
+ * // When user presses Esc on RunScreen
+ * background('my-feature');
+ *
+ * // Check if a feature is running in background
+ * const run = getRun('my-feature');
+ * ```
+ */
+export function useBackgroundRuns() {
+    const [runs, setRuns] = useState([]);
+    const pollTimers = useRef(new Map());
+    const startPolling = useCallback((featureName) => {
+        // Clear existing timer if any
+        const existing = pollTimers.current.get(featureName);
+        if (existing)
+            clearInterval(existing);
+        let consecutiveFailures = 0;
+        const MAX_FAILURES = 3;
+        const timer = setInterval(() => {
+            try {
+                const status = readLoopStatus(featureName);
+                consecutiveFailures = 0;
+                const nowCompleted = !status.running;
+                setRuns((prev) => prev.map((run) => {
+                    if (run.featureName !== featureName)
+                        return run;
+                    return {
+                        ...run,
+                        lastStatus: status,
+                        completed: nowCompleted,
+                    };
+                }));
+                // Stop polling once the run completes
+                if (nowCompleted) {
+                    clearInterval(timer);
+                    pollTimers.current.delete(featureName);
+                }
+            }
+            catch (err) {
+                consecutiveFailures++;
+                logger.error(`Failed to poll status for ${featureName} (attempt ${consecutiveFailures}): ${err instanceof Error ? err.message : String(err)}`);
+                if (consecutiveFailures >= MAX_FAILURES) {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    logger.error(`Stopping polling for ${featureName} after ${consecutiveFailures} consecutive failures`);
+                    clearInterval(timer);
+                    pollTimers.current.delete(featureName);
+                    setRuns((prev) => prev.map((run) => run.featureName === featureName
+                        ? { ...run, pollError: `Status polling failed: ${reason}` }
+                        : run));
+                }
+            }
+        }, POLL_INTERVAL_MS);
+        pollTimers.current.set(featureName, timer);
+    }, []);
+    const background = useCallback((featureName) => {
+        let status;
+        try {
+            status = readLoopStatus(featureName);
+        }
+        catch (err) {
+            logger.error(`Failed to read initial status for ${featureName}: ${err instanceof Error ? err.message : String(err)}`);
+            // Assume still running so polling can discover truth — if truly dead, polling will detect it
+            status = { running: true, iteration: 0, maxIterations: 0, phase: 'unknown', tokensInput: 0, tokensOutput: 0 };
+        }
+        const logPath = getLoopLogPath(featureName);
+        setRuns((prev) => {
+            // Don't add duplicates
+            if (prev.some((r) => r.featureName === featureName)) {
+                return prev;
+            }
+            return [...prev, {
+                    featureName,
+                    backgroundedAt: Date.now(),
+                    logPath,
+                    lastStatus: status,
+                    completed: !status.running,
+                }];
+        });
+        if (status.running) {
+            startPolling(featureName);
+        }
+    }, [startPolling]);
+    const dismiss = useCallback((featureName) => {
+        // Clear poll timer
+        const timer = pollTimers.current.get(featureName);
+        if (timer) {
+            clearInterval(timer);
+            pollTimers.current.delete(featureName);
+        }
+        setRuns((prev) => prev.filter((r) => r.featureName !== featureName));
+    }, []);
+    const getRun = useCallback((featureName) => {
+        return runs.find((r) => r.featureName === featureName);
+    }, [runs]);
+    // Cleanup all poll timers on unmount
+    useEffect(() => {
+        return () => {
+            for (const timer of pollTimers.current.values()) {
+                clearInterval(timer);
+            }
+            pollTimers.current.clear();
+        };
+    }, []);
+    return { runs, background, dismiss, getRun };
+}

package/dist/tui/hooks/useCommandHistory.d.ts

@@ -50,4 +50,3 @@ export interface UseCommandHistoryReturn {
  * ```
  */
 export declare function useCommandHistory(): UseCommandHistoryReturn;
-//# sourceMappingURL=useCommandHistory.d.ts.map

package/dist/tui/hooks/useCommandHistory.js

@@ -113,4 +113,3 @@ export function useCommandHistory() {
         getHistory,
     };
 }
-//# sourceMappingURL=useCommandHistory.js.map

package/dist/tui/hooks/useInit.d.ts

@@ -143,4 +143,3 @@ export declare function useInit(): UseInitReturn;
  * This is a workaround since we don't store API key in state
  */
 export declare function getApiKeyFromRef(): string | null;
-//# sourceMappingURL=useInit.d.ts.map

package/dist/tui/hooks/useInit.js

@@ -365,4 +365,3 @@ export function getApiKeyFromRef() {
     // This will be managed by the screen component directly
     return null;
 }
-//# sourceMappingURL=useInit.js.map

package/dist/tui/hooks/useSpecGenerator.d.ts

@@ -185,4 +185,3 @@ export interface UseSpecGeneratorReturn {
  * ```
  */
 export declare function useSpecGenerator(): UseSpecGeneratorReturn;
-//# sourceMappingURL=useSpecGenerator.d.ts.map

package/dist/tui/hooks/useSpecGenerator.js

@@ -484,4 +484,3 @@ export function useSpecGenerator() {
         setWorking,
     };
 }
-//# sourceMappingURL=useSpecGenerator.js.map

package/dist/tui/hooks/useSync.d.ts

@@ -12,4 +12,3 @@ export interface UseSyncReturn {
     sync: (projectRoot: string, provider: AIProvider, model: string) => Promise<void>;
 }
 export declare function useSync(): UseSyncReturn;
-//# sourceMappingURL=useSync.d.ts.map

package/dist/tui/hooks/useSync.js

@@ -49,4 +49,3 @@ export function useSync() {
     }, []);
     return { status, error, sync };
 }
-//# sourceMappingURL=useSync.js.map

package/dist/tui/index.d.ts

@@ -11,4 +11,3 @@ export * from './theme.js';
 export * from './components/index.js';
 export * from './hooks/index.js';
 export * from './screens/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/tui/index.js

@@ -15,4 +15,3 @@ export * from './components/index.js';
 export * from './hooks/index.js';
 // Screen components
 export * from './screens/index.js';
-//# sourceMappingURL=index.js.map

package/dist/tui/orchestration/index.d.ts

@@ -3,4 +3,3 @@
  * Exports orchestration classes that bridge TUI components to AI services
  */
 export { InterviewOrchestrator, type InterviewOrchestratorOptions, type SessionContext, } from './interview-orchestrator.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/tui/orchestration/index.js

@@ -3,4 +3,3 @@
  * Exports orchestration classes that bridge TUI components to AI services
  */
 export { InterviewOrchestrator, } from './interview-orchestrator.js';
-//# sourceMappingURL=index.js.map

package/dist/tui/orchestration/interview-orchestrator.d.ts

@@ -164,4 +164,3 @@ export declare class InterviewOrchestrator {
      */
     getSpec(): string;
 }
-//# sourceMappingURL=interview-orchestrator.d.ts.map

package/dist/tui/orchestration/interview-orchestrator.js

@@ -385,7 +385,7 @@ export class InterviewOrchestrator {
         try {
             // Set initial phase
             this.onPhaseChange('context');
-            this.onMessage('system', `Spec Generator initialized for feature: ${this.featureName}`);
+            this.onMessage('system', `Phase 1: Context - New spec for feature: ${this.featureName}`);
             // Ready for context input
             this.onReady();
         }
@@ -619,4 +619,3 @@ Today's date is ${new Date().toISOString().split('T')[0]}.`;
         return this.generatedSpec;
     }
 }
-//# sourceMappingURL=interview-orchestrator.js.map

package/dist/tui/screens/InitScreen.d.ts

@@ -1,12 +1,16 @@
 /**
  * InitScreen - Full Ink-based init workflow
  *
- * Handles the complete project initialization flow within the TUI:
+ * Handles the complete project initialization flow within the TUI.
+ * High-level steps (some may be skipped if already configured):
  * 1. Scanning project structure
- * 2. API key collection (if needed)
- * 3. Model selection
- * 4. AI analysis
- * 5. File generation
+ * 2. Provider selection
+ * 3. API key collection (if needed) + optional save
+ * 4. Model selection
+ * 5. AI analysis (agentic)
+ * 6. Confirmation + file generation
+ *
+ * Wrapped in AppShell for consistent layout.
  */
 import React from 'react';
 import type { SessionState } from '../../repl/session-state.js';
@@ -14,6 +18,8 @@ import type { SessionState } from '../../repl/session-state.js';
  * Props for the InitScreen component
  */
 export interface InitScreenProps {
+    /** Pre-built header element from App */
+    header: React.ReactNode;
     /** Project root directory */
     projectRoot: string;
     /** Current session state */
@@ -26,8 +32,6 @@ export interface InitScreenProps {
 /**
  * InitScreen component
  *
- * The complete Ink-based init workflow. Replaces the readline-based
- * init flow with native Ink components.
+ * The complete Ink-based init workflow wrapped in AppShell.
  */
-export declare function InitScreen({ projectRoot, sessionState, onComplete, onCancel, }: InitScreenProps): React.ReactElement;
-//# sourceMappingURL=InitScreen.d.ts.map
+export declare function InitScreen({ header, projectRoot, sessionState, onComplete, onCancel, }: InitScreenProps): React.ReactElement;