wiggum-cli 0.12.1 → 0.13.0

package/dist/tui/screens/MainShell.js

@@ -4,17 +4,19 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * The main interactive shell for Wiggum CLI, replacing the readline REPL.
  * Handles slash commands and provides navigation to other screens.
+ * Wrapped in AppShell for consistent layout.
  */
 import { useState, useCallback, useEffect, useMemo } from 'react';
 import { Box, Text, useInput, useApp } from 'ink';
 import { MessageList } from '../components/MessageList.js';
 import { ChatInput } from '../components/ChatInput.js';
-import { WorkingIndicator } from '../components/WorkingIndicator.js';
 import { ActionOutput } from '../components/ActionOutput.js';
-import { FooterStatusBar } from '../components/FooterStatusBar.js';
-import { colors, theme } from '../theme.js';
+import { AppShell } from '../components/AppShell.js';
+import { colors, theme, phase } from '../theme.js';
 import { loadContext, getContextAge } from '../../context/index.js';
+import { logger } from '../../utils/logger.js';
 import { parseInput, resolveCommandAlias, formatHelpText, } from '../../repl/command-parser.js';
+import { readLoopStatus } from '../utils/loop-status.js';
 import { useSync } from '../hooks/useSync.js';
 import path from 'node:path';
 /**
@@ -28,24 +30,24 @@ function generateId() {
  *
  * The main interactive shell that handles slash commands and navigation.
  * Replaces the readline-based REPL with an Ink-powered TUI.
- *
- * @example
- * ```tsx
- * <MainShell
- *   sessionState={state}
- *   onNavigate={(target, props) => setScreen(target, props)}
- * />
- * ```
  */
-export function MainShell({ sessionState, onNavigate, }) {
+export function MainShell({ header, sessionState, onNavigate, backgroundRuns, initialMessage, initialFiles, }) {
     const { exit } = useApp();
-    const [messages, setMessages] = useState([]);
+    const [messages, setMessages] = useState(() => {
+        const initial = [];
+        if (initialMessage) {
+            initial.push({ id: generateId(), role: 'system', content: initialMessage });
+        }
+        if (initialFiles && initialFiles.length > 0) {
+            for (const file of initialFiles) {
+                initial.push({ id: generateId(), role: 'system', content: `  ${file}` });
+            }
+        }
+        return initial;
+    });
     const [contextAge, setContextAge] = useState(null);
     // Sync hook
     const { status: syncStatus, error: syncError, sync } = useSync();
-    /**
-     * Add a system message to the conversation
-     */
     const addSystemMessage = useCallback((content) => {
         const message = {
             id: generateId(),
@@ -74,9 +76,10 @@ export function MainShell({ sessionState, onNavigate, }) {
                     setContextAge(null);
                 }
             }
-            catch {
+            catch (err) {
+                logger.error(`Failed to load context: ${err instanceof Error ? err.message : String(err)}`);
                 if (!cancelled) {
-                    setContextAge(null);
+                    setContextAge('load error');
                 }
             }
         };
@@ -86,22 +89,12 @@ export function MainShell({ sessionState, onNavigate, }) {
         };
     }, [sessionState.projectRoot, sessionState.initialized, syncStatus]);
     const projectLabel = useMemo(() => path.basename(sessionState.projectRoot), [sessionState.projectRoot]);
-    /**
-     * Handle /help command
-     */
     const handleHelp = useCallback(() => {
         addSystemMessage(formatHelpText());
     }, [addSystemMessage]);
-    /**
-     * Handle /init command
-     */
     const handleInit = useCallback(() => {
-        // Navigate to init screen
         onNavigate('init');
     }, [onNavigate]);
-    /**
-     * Handle /new command
-     */
     const handleNew = useCallback((args) => {
         if (args.length === 0) {
             addSystemMessage('Feature name required. Usage: /new <feature-name>');
@@ -114,9 +107,6 @@ export function MainShell({ sessionState, onNavigate, }) {
         const featureName = args[0];
         onNavigate('interview', { featureName });
     }, [sessionState.initialized, onNavigate, addSystemMessage]);
-    /**
-     * Handle /run command
-     */
     const handleRun = useCallback((args) => {
         if (args.length === 0) {
             addSystemMessage('Feature name required. Usage: /run <feature-name>');
@@ -129,22 +119,38 @@ export function MainShell({ sessionState, onNavigate, }) {
         const featureName = args[0];
         onNavigate('run', { featureName });
     }, [sessionState.initialized, addSystemMessage, onNavigate]);
-    /**
-     * Handle /monitor command
-     */
     const handleMonitor = useCallback((args) => {
         if (args.length === 0) {
             addSystemMessage('Feature name required. Usage: /monitor <feature-name>');
             return;
         }
-        // TODO: Implement monitor screen navigation
-        addSystemMessage(`Monitor command for "${args[0]}" - not yet implemented in TUI mode.`);
-    }, [addSystemMessage]);
-    /**
-     * Handle /config command
-     */
+        const featureName = args[0];
+        if (!/^[a-zA-Z0-9_-]+$/.test(featureName)) {
+            addSystemMessage('Feature name must contain only letters, numbers, hyphens, and underscores.');
+            return;
+        }
+        // Check if it's a tracked background run
+        const bgRun = backgroundRuns?.find((r) => r.featureName === featureName);
+        if (bgRun) {
+            onNavigate('run', { featureName, monitorOnly: true });
+            return;
+        }
+        // Check if the process is running even if not tracked
+        try {
+            const status = readLoopStatus(featureName);
+            if (status.running) {
+                onNavigate('run', { featureName, monitorOnly: true });
+                return;
+            }
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            addSystemMessage(`Could not check loop status for "${featureName}": ${reason}`);
+            return;
+        }
+        addSystemMessage(`No running loop found for "${featureName}".`);
+    }, [addSystemMessage, backgroundRuns, onNavigate]);
     const handleConfig = useCallback((args) => {
-        // TODO: Implement config screen or inline config
         if (args.length === 0) {
             addSystemMessage('Config management - not yet implemented in TUI mode. Use CLI: wiggum config');
         }
@@ -152,19 +158,12 @@ export function MainShell({ sessionState, onNavigate, }) {
             addSystemMessage(`Config: ${args.join(' ')} - not yet implemented in TUI mode.`);
         }
     }, [addSystemMessage]);
-    /**
-     * Handle /exit command
-     */
     const handleExit = useCallback(() => {
         addSystemMessage('Goodbye!');
-        // Small delay to show message before exit
         setTimeout(() => {
             exit();
         }, 100);
     }, [addSystemMessage, exit]);
-    /**
-     * Handle /sync command
-     */
     const handleSync = useCallback(() => {
         if (!sessionState.initialized) {
             addSystemMessage('Project not initialized. Run /init first.');
@@ -180,9 +179,6 @@ export function MainShell({ sessionState, onNavigate, }) {
         }
         sync(sessionState.projectRoot, sessionState.provider, sessionState.model);
     }, [sessionState, syncStatus, addSystemMessage, sync]);
-    /**
-     * Execute a slash command
-     */
     const executeCommand = useCallback((commandName, args) => {
         switch (commandName) {
             case 'help':
@@ -213,21 +209,13 @@ export function MainShell({ sessionState, onNavigate, }) {
                 addSystemMessage(`Unknown command: ${commandName}`);
         }
     }, [handleHelp, handleInit, handleSync, handleNew, handleRun, handleMonitor, handleConfig, handleExit, addSystemMessage]);
-    /**
-     * Handle natural language input
-     */
     const handleNaturalLanguage = useCallback((_text) => {
-        // For now, just show a tip (text parameter reserved for future AI chat)
         addSystemMessage('Tip: Use /help to see available commands, or /new <feature> to create a spec.');
     }, [addSystemMessage]);
-    /**
-     * Handle user input submission
-     */
     const handleSubmit = useCallback((value) => {
         const parsed = parseInput(value);
         switch (parsed.type) {
             case 'empty':
-                // Ignore empty input
                 break;
             case 'slash-command': {
                 const { command } = parsed;
@@ -253,20 +241,28 @@ export function MainShell({ sessionState, onNavigate, }) {
             addSystemMessage('Use /exit to quit');
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [messages.length > 0 && (_jsx(Box, { marginY: 1, flexDirection: "column", children: _jsx(MessageList, { messages: messages }) })), syncStatus !== 'idle' && (_jsxs(Box, { marginY: 1, flexDirection: "column", gap: 1, children: [syncStatus === 'running' && (_jsx(WorkingIndicator, { state: {
-                            isWorking: true,
-                            status: 'Syncing project context…',
-                        } })), _jsx(ActionOutput, { actionName: "Sync", description: "Project context", status: syncStatus === 'running'
+    // Build tips text
+    const tips = sessionState.initialized
+        ? 'Tip: /new <feature> to create spec, /help for commands'
+        : 'Tip: /init to set up, /help for commands';
+    const inputElement = (_jsx(ChatInput, { onSubmit: handleSubmit, disabled: false, placeholder: "Enter command or type /help...", onCommand: (cmd) => handleSubmit(`/${cmd}`) }));
+    return (_jsxs(AppShell, { header: header, tips: tips, isWorking: syncStatus === 'running', workingStatus: syncStatus === 'running' ? 'Syncing project context\u2026' : undefined, input: inputElement, footerStatus: {
+            action: projectLabel || 'Main Shell',
+            phase: sessionState.provider ? `${sessionState.provider}/${sessionState.model}` : 'No provider',
+            path: sessionState.initialized
+                ? contextAge === 'load error'
+                    ? 'Context: unavailable \u2014 /sync to refresh'
+                    : contextAge
+                        ? `Context: cached ${contextAge}`
+                        : 'Context: none \u2014 /sync'
+                : 'Not initialized \u2014 /init',
+        }, children: [messages.length > 0 && (_jsx(Box, { flexDirection: "column", children: _jsx(MessageList, { messages: messages }) })), syncStatus !== 'idle' && (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(ActionOutput, { actionName: "Sync", description: "Project context", status: syncStatus === 'running'
                             ? 'running'
                             : syncStatus === 'success'
                                 ? 'success'
                                 : 'error', output: syncStatus === 'running'
-                            ? 'Scanning + AI analysis…'
+                            ? 'Scanning + AI analysis\u2026'
                             : syncStatus === 'success'
                                 ? 'Updated .ralph/.context.json'
-                                : undefined, error: syncStatus === 'error' ? (syncError?.message || 'Unknown error') : undefined, previewLines: 2 }), syncStatus === 'success' && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: colors.green, children: [theme.chars.bullet, " "] }), _jsx(Text, { children: "Done. Project context updated." })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "What's next:" }), _jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: colors.green, children: "\u203A" }), _jsxs(Text, { color: colors.blue, children: ["/new ", '<feature>'] }), _jsx(Text, { dimColor: true, children: "Create a feature specification" })] })] })] }))] })), _jsx(Box, { marginTop: 1, children: _jsx(ChatInput, { onSubmit: handleSubmit, disabled: false, placeholder: "Enter command or type /help...", onCommand: (cmd) => handleSubmit(`/${cmd}`) }) }), _jsx(FooterStatusBar, { action: projectLabel || 'Main Shell', phase: sessionState.provider ? `${sessionState.provider}/${sessionState.model}` : 'No provider', path: sessionState.initialized
-                    ? contextAge
-                        ? `Context: cached ${contextAge}`
-                        : 'Context: none — /sync'
-                    : 'Not initialized — /init' })] }));
+                                : undefined, error: syncStatus === 'error' ? (syncError?.message || 'Unknown error') : undefined, previewLines: 2 }), syncStatus === 'success' && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: colors.green, children: [phase.complete, " "] }), _jsx(Text, { children: "Done. Project context updated." })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "What's next:" }), _jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: colors.green, children: theme.chars.prompt }), _jsxs(Text, { color: colors.blue, children: ["/new ", '<feature>'] }), _jsx(Text, { dimColor: true, children: "Create a feature specification" })] })] })] }))] }))] }));
 }

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

@@ -2,6 +2,14 @@
  * RunScreen - TUI screen for running feature loop
  *
  * Spawns feature-loop.sh and polls status files for progress.
+ * Wrapped in AppShell for consistent layout.
+ *
+ * Supports two modes:
+ * - Foreground: spawns the process and monitors it
+ * - Monitor-only: polls status files without spawning (for /monitor)
+ *
+ * Esc backgrounds the run in foreground mode; in monitor mode, Esc returns to shell.
+ * On completion, shows RunCompletionSummary inline.
  */
 import React from 'react';
 import type { SessionState } from '../../repl/session-state.js';
@@ -14,15 +22,23 @@ export interface RunSummary {
     tokensInput: number;
     tokensOutput: number;
     exitCode: number;
+    /** True when the exit code was inferred (e.g. monitor mode heuristic) rather than observed directly */
+    exitCodeInferred?: boolean;
     branch?: string;
     logPath?: string;
     errorTail?: string;
 }
 export interface RunScreenProps {
+    /** Pre-built header element from App */
+    header: React.ReactNode;
     featureName: string;
     projectRoot: string;
     sessionState: SessionState;
+    /** Monitor-only mode: don't spawn, just poll status */
+    monitorOnly?: boolean;
     onComplete: (summary: RunSummary) => void;
+    /** Called when user presses Esc to background the run */
+    onBackground?: (featureName: string) => void;
     onCancel: () => void;
 }
-export declare function RunScreen({ featureName, projectRoot, sessionState, onComplete, onCancel, }: RunScreenProps): React.ReactElement;
+export declare function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly, onComplete, onBackground, onCancel, }: RunScreenProps): React.ReactElement;