wiggum-cli 0.12.1 → 0.13.0

package/dist/tui/screens/RunScreen.js

@@ -3,22 +3,29 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * 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 { useCallback, useEffect, useRef, useState } from 'react';
 import { Box, Text, useInput } from 'ink';
-import { spawn } from 'node:child_process';
+import { execFileSync, spawn } from 'node:child_process';
 import { closeSync, existsSync, openSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { FooterStatusBar } from '../components/FooterStatusBar.js';
 import { Confirm } from '../components/Confirm.js';
+import { AppShell } from '../components/AppShell.js';
+import { RunCompletionSummary } from '../components/RunCompletionSummary.js';
 import { colors, theme } from '../theme.js';
-import { readLoopStatus, parseImplementationPlan, getGitBranch, formatNumber, } from '../utils/loop-status.js';
+import { readLoopStatus, parseImplementationPlan, getGitBranch, formatNumber, getLoopLogPath, } from '../utils/loop-status.js';
 import { loadConfigWithDefaults } from '../../utils/config.js';
+import { logger } from '../../utils/logger.js';
 const POLL_INTERVAL_MS = 2500;
 const ERROR_TAIL_LINES = 12;
-/**
- * Find the feature-loop.sh script.
- */
 function findFeatureLoopScript(projectRoot, scriptsDir) {
     const localScript = join(projectRoot, scriptsDir, 'feature-loop.sh');
     if (existsSync(localScript)) {
@@ -34,9 +41,6 @@ function findFeatureLoopScript(projectRoot, scriptsDir) {
     }
     return null;
 }
-/**
- * Validate that the spec file exists.
- */
 function findSpecFile(projectRoot, feature, specsDir) {
     const possiblePaths = [
         join(projectRoot, specsDir, `${feature}.md`),
@@ -50,9 +54,6 @@ function findSpecFile(projectRoot, feature, specsDir) {
     }
     return null;
 }
-/**
- * Render a simple progress bar.
- */
 function ProgressBar({ percent, width = 18 }) {
     const safePercent = Math.max(0, Math.min(100, percent));
     const filled = Math.round((safePercent / 100) * width);
@@ -75,12 +76,20 @@ function readLogTail(logPath, maxLines) {
             return null;
         return lines.slice(-maxLines).join('\n');
     }
-    catch {
-        return null;
+    catch (err) {
+        return `[Unable to read log: ${err instanceof Error ? err.message : String(err)}]`;
     }
 }
-export function RunScreen({ featureName, projectRoot, sessionState, onComplete, onCancel, }) {
-    const [status, setStatus] = useState(() => readLoopStatus(featureName));
+export function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly = false, onComplete, onBackground, onCancel, }) {
+    const [status, setStatus] = useState(() => {
+        try {
+            return readLoopStatus(featureName);
+        }
+        catch (err) {
+            logger.error(`Failed to read initial loop status: ${err instanceof Error ? err.message : String(err)}`);
+            return { running: false, iteration: 0, maxIterations: 0, phase: 'unknown', tokensInput: 0, tokensOutput: 0 };
+        }
+    });
     const [tasks, setTasks] = useState({
         tasksDone: 0,
         tasksPending: 0,
@@ -89,18 +98,27 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
     });
     const [branch, setBranch] = useState('-');
     const [error, setError] = useState(null);
-    const [isStarting, setIsStarting] = useState(true);
+    const [isStarting, setIsStarting] = useState(!monitorOnly);
     const [showConfirm, setShowConfirm] = useState(false);
+    const [completionSummary, setCompletionSummary] = useState(null);
     const childRef = useRef(null);
     const stopRequestedRef = useRef(false);
     const isMountedRef = useRef(true);
     const startTimeRef = useRef(Date.now());
     const specsDirRef = useRef('.ralph/specs');
+    const completionSentRef = useRef(false);
     const configRootRef = useRef('.ralph');
     const scriptsDirRef = useRef('.ralph/scripts');
     const maxIterationsRef = useRef(0);
     const maxE2eAttemptsRef = useRef(0);
     useInput((input, key) => {
+        // If showing completion summary, Enter or Esc dismisses
+        if (completionSummary) {
+            if (key.return || key.escape) {
+                onComplete(completionSummary);
+            }
+            return;
+        }
         if (showConfirm)
             return;
         if (key.ctrl && input === 'c') {
@@ -108,7 +126,13 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
             return;
         }
         if (key.escape) {
-            onCancel();
+            if (onBackground && !monitorOnly) {
+                // Background the run: don't kill the child, just navigate away
+                onBackground(featureName);
+            }
+            else {
+                onCancel();
+            }
         }
     });
     const refreshStatus = useCallback(async () => {
@@ -123,13 +147,62 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
         if (!isMountedRef.current)
             return;
         setBranch(getGitBranch(projectRoot));
-    }, [featureName, projectRoot]);
+        // In monitor mode, detect completion (only fire once)
+        if (monitorOnly && !nextStatus.running && !completionSentRef.current) {
+            completionSentRef.current = true;
+            const logPath = getLoopLogPath(featureName);
+            const finalMarker = `/tmp/ralph-loop-${featureName}.final`;
+            const exitCode = existsSync(finalMarker) ? 0 : 1;
+            if (exitCode !== 0) {
+                logger.warn(`Monitor mode inferred exit code 1 for ${featureName} (no .final marker). This may be a false negative.`);
+            }
+            const tasksDone = nextTasks.tasksDone + nextTasks.e2eDone;
+            const tasksTotal = tasksDone + nextTasks.tasksPending + nextTasks.e2ePending;
+            const errorTail = exitCode !== 0 ? readLogTail(logPath, ERROR_TAIL_LINES) || undefined : undefined;
+            setCompletionSummary({
+                feature: featureName,
+                iterations: nextStatus.iteration,
+                maxIterations: nextStatus.maxIterations,
+                tasksDone,
+                tasksTotal,
+                tokensInput: nextStatus.tokensInput,
+                tokensOutput: nextStatus.tokensOutput,
+                exitCode,
+                exitCodeInferred: true,
+                branch: getGitBranch(projectRoot),
+                logPath,
+                errorTail,
+            });
+        }
+    }, [featureName, projectRoot, monitorOnly]);
     const stopLoop = useCallback(() => {
         stopRequestedRef.current = true;
         if (childRef.current) {
             childRef.current.kill('SIGINT');
         }
-    }, []);
+        else if (monitorOnly) {
+            // In monitor mode, find and kill the loop process by pattern
+            if (!/^[a-zA-Z0-9_-]+$/.test(featureName)) {
+                logger.error(`Refusing to run pkill with unsafe feature name: ${featureName}`);
+                setError('Feature name contains invalid characters.');
+                return;
+            }
+            try {
+                execFileSync('pkill', ['-INT', '-f', `feature-loop.sh.*${featureName}`]);
+            }
+            catch (err) {
+                // pkill exit code 1 = no matching process (already exited)
+                if (err && typeof err === 'object' && 'status' in err && err.status === 1) {
+                    // Expected — process already exited
+                }
+                else {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    logger.error(`Failed to stop loop process for ${featureName}: ${reason}`);
+                    setError(`Could not stop the loop process (${reason}). You may need to kill it manually.`);
+                }
+            }
+        }
+    }, [monitorOnly, featureName]);
     const handleConfirm = useCallback((value) => {
         setShowConfirm(false);
         if (value) {
@@ -139,6 +212,41 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
     useEffect(() => {
         let cancelled = false;
         let pollTimer = null;
+        if (monitorOnly) {
+            // Monitor mode: load config for correct specs path, then poll
+            const initMonitor = async () => {
+                try {
+                    const config = sessionState.config ?? await loadConfigWithDefaults(projectRoot);
+                    specsDirRef.current = config.paths.specs;
+                }
+                catch (err) {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    logger.error(`Failed to load config for monitor mode: ${reason}`);
+                    // Keep default .ralph/specs but warn user
+                    if (!cancelled)
+                        setError(`Could not load project config (${reason}). Showing status from default paths.`);
+                }
+                if (cancelled)
+                    return;
+                setIsStarting(false);
+                refreshStatus().catch((err) => {
+                    logger.warn(`Status refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+                });
+                pollTimer = setInterval(() => {
+                    refreshStatus().catch((err) => {
+                        logger.warn(`Status refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+                    });
+                }, POLL_INTERVAL_MS);
+            };
+            initMonitor();
+            return () => {
+                cancelled = true;
+                isMountedRef.current = false;
+                if (pollTimer)
+                    clearInterval(pollTimer);
+            };
+        }
+        // Foreground mode: spawn the process
         const startLoop = async () => {
             try {
                 if (!/^[a-zA-Z0-9_-]+$/.test(featureName)) {
@@ -170,66 +278,100 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
                     setIsStarting(false);
                     return;
                 }
-                const logPath = `/tmp/ralph-loop-${featureName}.log`;
+                const logPath = getLoopLogPath(featureName);
                 const logFd = openSync(logPath, 'a');
-                const args = [
-                    featureName,
-                    String(config.loop.maxIterations),
-                    String(config.loop.maxE2eAttempts),
-                    '--review-mode',
-                    reviewMode,
-                ];
-                const child = spawn('bash', [scriptPath, ...args], {
-                    cwd: dirname(scriptPath),
-                    stdio: ['ignore', logFd, logFd],
-                    env: {
-                        ...process.env,
-                        RALPH_CONFIG_ROOT: config.paths.root,
-                        RALPH_SPEC_DIR: config.paths.specs,
-                        RALPH_SCRIPTS_DIR: config.paths.scripts,
-                    },
-                });
-                childRef.current = child;
-                startTimeRef.current = Date.now();
-                setIsStarting(false);
-                if (stopRequestedRef.current) {
-                    child.kill('SIGINT');
-                }
-                pollTimer = setInterval(() => {
-                    refreshStatus();
-                }, POLL_INTERVAL_MS);
-                refreshStatus();
-                child.on('error', (err) => {
-                    if (cancelled)
-                        return;
-                    setError(`Failed to start feature loop: ${err.message}`);
-                });
-                child.on('close', async (code) => {
-                    if (cancelled)
-                        return;
-                    if (pollTimer)
-                        clearInterval(pollTimer);
-                    closeSync(logFd);
-                    const latestStatus = readLoopStatus(featureName);
-                    const latestTasks = await parseImplementationPlan(projectRoot, featureName, specsDirRef.current);
-                    const tasksDone = latestTasks.tasksDone + latestTasks.e2eDone;
-                    const tasksTotal = tasksDone + latestTasks.tasksPending + latestTasks.e2ePending;
-                    const exitCode = typeof code === 'number' ? code : 1;
-                    const errorTail = exitCode === 0 ? undefined : readLogTail(logPath, ERROR_TAIL_LINES) || undefined;
-                    onComplete({
-                        feature: featureName,
-                        iterations: latestStatus.iteration,
-                        maxIterations: latestStatus.maxIterations || config.loop.maxIterations,
-                        tasksDone,
-                        tasksTotal,
-                        tokensInput: latestStatus.tokensInput,
-                        tokensOutput: latestStatus.tokensOutput,
-                        exitCode,
-                        branch: getGitBranch(projectRoot),
-                        logPath,
-                        errorTail,
+                let logFdClosed = false;
+                try {
+                    const args = [
+                        featureName,
+                        String(config.loop.maxIterations),
+                        String(config.loop.maxE2eAttempts),
+                        '--review-mode',
+                        reviewMode,
+                    ];
+                    const child = spawn('bash', [scriptPath, ...args], {
+                        cwd: dirname(scriptPath),
+                        stdio: ['ignore', logFd, logFd],
+                        env: {
+                            ...process.env,
+                            RALPH_CONFIG_ROOT: config.paths.root,
+                            RALPH_SPEC_DIR: config.paths.specs,
+                            RALPH_SCRIPTS_DIR: config.paths.scripts,
+                        },
                     });
-                });
+                    childRef.current = child;
+                    startTimeRef.current = Date.now();
+                    setIsStarting(false);
+                    if (stopRequestedRef.current) {
+                        child.kill('SIGINT');
+                    }
+                    pollTimer = setInterval(() => {
+                        refreshStatus().catch((err) => {
+                            logger.warn(`Status refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+                        });
+                    }, POLL_INTERVAL_MS);
+                    refreshStatus().catch((err) => {
+                        logger.warn(`Status refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+                    });
+                    child.on('error', (err) => {
+                        if (!logFdClosed) {
+                            closeSync(logFd);
+                            logFdClosed = true;
+                        }
+                        if (cancelled)
+                            return;
+                        setError(`Failed to start feature loop: ${err.message}`);
+                    });
+                    child.on('close', async (code) => {
+                        if (cancelled)
+                            return;
+                        if (pollTimer)
+                            clearInterval(pollTimer);
+                        if (!logFdClosed) {
+                            closeSync(logFd);
+                            logFdClosed = true;
+                        }
+                        if (!isMountedRef.current)
+                            return;
+                        let latestStatus;
+                        let latestTasks;
+                        try {
+                            latestStatus = readLoopStatus(featureName);
+                            latestTasks = await parseImplementationPlan(projectRoot, featureName, specsDirRef.current);
+                        }
+                        catch (err) {
+                            logger.error(`Failed to read final run status for ${featureName}: ${err instanceof Error ? err.message : String(err)}`);
+                            latestStatus = { running: false, iteration: 0, maxIterations: config.loop.maxIterations, phase: 'unknown', tokensInput: 0, tokensOutput: 0 };
+                            latestTasks = { tasksDone: 0, tasksPending: 0, e2eDone: 0, e2ePending: 0 };
+                        }
+                        const tasksDone = latestTasks.tasksDone + latestTasks.e2eDone;
+                        const tasksTotal = tasksDone + latestTasks.tasksPending + latestTasks.e2ePending;
+                        const exitCode = typeof code === 'number' ? code : 1;
+                        const errorTail = exitCode === 0 ? undefined : readLogTail(logPath, ERROR_TAIL_LINES) || undefined;
+                        const summary = {
+                            feature: featureName,
+                            iterations: latestStatus.iteration,
+                            maxIterations: latestStatus.maxIterations || config.loop.maxIterations,
+                            tasksDone,
+                            tasksTotal,
+                            tokensInput: latestStatus.tokensInput,
+                            tokensOutput: latestStatus.tokensOutput,
+                            exitCode,
+                            branch: getGitBranch(projectRoot),
+                            logPath,
+                            errorTail,
+                        };
+                        // Show completion summary inline
+                        setCompletionSummary(summary);
+                    });
+                }
+                catch (spawnErr) {
+                    if (!logFdClosed) {
+                        closeSync(logFd);
+                        logFdClosed = true;
+                    }
+                    throw spawnErr;
+                }
             }
             catch (err) {
                 if (cancelled)
@@ -245,7 +387,7 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
             if (pollTimer)
                 clearInterval(pollTimer);
         };
-    }, [featureName, projectRoot, refreshStatus, onComplete, sessionState.config]);
+    }, [featureName, projectRoot, refreshStatus, monitorOnly, sessionState.config]);
     const totalTasks = tasks.tasksDone + tasks.tasksPending;
     const totalE2e = tasks.e2eDone + tasks.e2ePending;
     const totalAll = totalTasks + totalE2e;
@@ -255,5 +397,18 @@ export function RunScreen({ featureName, projectRoot, sessionState, onComplete,
     const percentAll = totalAll > 0 ? Math.round((doneAll / totalAll) * 100) : 0;
     const totalTokens = status.tokensInput + status.tokensOutput;
     const phaseLine = isStarting ? 'Starting...' : status.phase;
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.colors.error, children: ["Error: ", error] }) })), !error && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Phase: " }), _jsx(Text, { color: colors.yellow, children: phaseLine }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Iter: " }), _jsx(Text, { color: colors.green, children: status.iteration }), _jsxs(Text, { dimColor: true, children: ["/", status.maxIterations || maxIterationsRef.current || '-'] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Branch: " }), _jsx(Text, { color: colors.blue, children: branch })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Tokens: " }), _jsx(Text, { color: colors.pink, children: formatNumber(totalTokens) }), _jsxs(Text, { dimColor: true, children: [" (in:", formatNumber(status.tokensInput), " out:", formatNumber(status.tokensOutput), ")"] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { dimColor: true, children: ["Elapsed: ", formatDuration(startTimeRef.current)] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: "Implementation:" }), _jsx(ProgressBar, { percent: percentTasks }), _jsxs(Text, { children: [percentTasks, "%"] }), _jsxs(Text, { color: colors.green, children: ["\u2713 ", tasks.tasksDone] }), _jsxs(Text, { color: colors.yellow, children: ["\u25CB ", tasks.tasksPending] })] }), totalE2e > 0 && (_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: "E2E Tests:" }), _jsx(ProgressBar, { percent: percentE2e }), _jsxs(Text, { children: [percentE2e, "%"] }), _jsxs(Text, { color: colors.green, children: ["\u2713 ", tasks.e2eDone] }), _jsxs(Text, { color: colors.yellow, children: ["\u25CB ", tasks.e2ePending] })] })), _jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, marginTop: 1, children: [_jsx(Text, { bold: true, children: "Overall:" }), _jsx(ProgressBar, { percent: percentAll }), _jsxs(Text, { children: [percentAll, "%"] }), _jsxs(Text, { color: colors.green, children: ["\u2713 ", doneAll] }), _jsxs(Text, { color: colors.yellow, children: ["\u25CB ", totalAll - doneAll] })] })] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["Tip: /monitor ", featureName, " in another terminal for details"] }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: "Press Ctrl+C to stop the loop" }) })] })), showConfirm && (_jsx(Box, { marginTop: 1, children: _jsx(Confirm, { message: stopRequestedRef.current ? 'Stopping loop...' : 'Stop the feature loop?', onConfirm: handleConfirm, onCancel: () => setShowConfirm(false), initialValue: false }) })), _jsx(FooterStatusBar, { action: "Run Loop", phase: phaseLine, path: featureName })] }));
+    const isRunning = !completionSummary && !error;
+    // Tips text
+    const tips = completionSummary
+        ? 'Enter to return to shell'
+        : monitorOnly
+            ? 'Ctrl+C stop, Esc back'
+            : 'Ctrl+C stop, Esc background';
+    // Input element (only show Confirm when stopping)
+    const inputElement = showConfirm ? (_jsx(Confirm, { message: stopRequestedRef.current ? 'Stopping loop...' : 'Stop the feature loop?', onConfirm: handleConfirm, onCancel: () => setShowConfirm(false), initialValue: false })) : null;
+    return (_jsx(AppShell, { header: header, tips: tips, isWorking: isRunning && !isStarting, workingStatus: `${phaseLine} \u2014 ${featureName}`, workingHint: monitorOnly ? 'esc to go back' : 'esc to background', input: inputElement, error: error, footerStatus: {
+            action: 'Run Loop',
+            phase: phaseLine,
+            path: featureName,
+        }, children: completionSummary ? (_jsx(RunCompletionSummary, { summary: completionSummary })) : (!error && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Phase: " }), _jsx(Text, { color: colors.yellow, children: phaseLine }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Iter: " }), _jsx(Text, { color: colors.green, children: status.iteration }), _jsxs(Text, { dimColor: true, children: ["/", status.maxIterations || maxIterationsRef.current || '-'] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Branch: " }), _jsx(Text, { color: colors.blue, children: branch })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Tokens: " }), _jsx(Text, { color: colors.pink, children: formatNumber(totalTokens) }), _jsxs(Text, { dimColor: true, children: [" (in:", formatNumber(status.tokensInput), " out:", formatNumber(status.tokensOutput), ")"] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { dimColor: true, children: ["Elapsed: ", formatDuration(startTimeRef.current)] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: "Implementation:" }), _jsx(ProgressBar, { percent: percentTasks }), _jsxs(Text, { children: [percentTasks, "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.tasksDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.tasksPending] })] }), totalE2e > 0 && (_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: "E2E Tests:" }), _jsx(ProgressBar, { percent: percentE2e }), _jsxs(Text, { children: [percentE2e, "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.e2eDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.e2ePending] })] })), _jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, marginTop: 1, children: [_jsx(Text, { bold: true, children: "Overall:" }), _jsx(ProgressBar, { percent: percentAll }), _jsxs(Text, { children: [percentAll, "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", doneAll] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", totalAll - doneAll] })] })] })] }))) }));
 }

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

@@ -5,8 +5,6 @@ export { InterviewScreen } from './InterviewScreen.js';
 export type { InterviewScreenProps } from './InterviewScreen.js';
 export { InitScreen } from './InitScreen.js';
 export type { InitScreenProps } from './InitScreen.js';
-export { WelcomeScreen } from './WelcomeScreen.js';
-export type { WelcomeScreenProps } from './WelcomeScreen.js';
 export { MainShell } from './MainShell.js';
 export type { MainShellProps, NavigationTarget, NavigationProps } from './MainShell.js';
 export { RunScreen } from './RunScreen.js';

package/dist/tui/screens/index.js

@@ -3,6 +3,5 @@
  */
 export { InterviewScreen } from './InterviewScreen.js';
 export { InitScreen } from './InitScreen.js';
-export { WelcomeScreen } from './WelcomeScreen.js';
 export { MainShell } from './MainShell.js';
 export { RunScreen } from './RunScreen.js';

package/dist/tui/utils/loop-status.d.ts

@@ -16,15 +16,34 @@ export interface TaskCounts {
     e2ePending: number;
 }
 /**
- * Detect current phase of the loop based on active prompt files.
+ * Return the conventional log file path for a feature loop.
+ */
+export declare function getLoopLogPath(feature: string): string;
+/**
+ * Detect current phase of the loop by checking for processes with prompt file patterns in their command line.
+ *
+ * Note: prompt-file checks (PROMPT_feature.md, etc.) are global — they match any
+ * running process, not just the one for `feature`. This is acceptable because
+ * concurrent loops are rare, but callers should be aware of the limitation.
  */
 export declare function detectPhase(feature: string): string;
 /**
- * Read status from temp files.
+ * Read loop status from temp files written by feature-loop.sh.
+ *
+ * Reads `ralph-loop-<feature>.status` (or `.final`) for iteration progress
+ * and `ralph-loop-<feature>.tokens` for token counts. Also runs `pgrep` to
+ * check whether the loop process is still alive.
+ *
+ * @throws {Error} If `feature` contains invalid characters.
  */
 export declare function readLoopStatus(feature: string): LoopStatus;
 /**
- * Parse implementation plan for task counts.
+ * Parse the markdown implementation plan for a feature to extract task/E2E counts.
+ *
+ * Looks for `- [x]` (done) and `- [ ]` (pending) checklist items.
+ * Items containing "E2E:" are counted separately as end-to-end tests.
+ *
+ * @returns Counts of done/pending tasks and E2E tests.
  */
 export declare function parseImplementationPlan(projectRoot: string, feature: string, specsDirOverride?: string): Promise<TaskCounts>;
 /**

package/dist/tui/utils/loop-status.js

@@ -5,20 +5,49 @@ import { execFileSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { loadConfigWithDefaults } from '../../utils/config.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Track whether pgrep is available to avoid repeated failed calls.
+ * null = untested, true = available, false = unavailable
+ */
+let pgrepAvailable = null;
 /**
  * Check if a process matching pattern is running.
  */
 function isProcessRunning(pattern) {
+    if (pgrepAvailable === false)
+        return false;
     try {
         const result = execFileSync('pgrep', ['-f', pattern], { encoding: 'utf-8' });
+        pgrepAvailable = true;
         return result.trim().length > 0;
     }
-    catch {
+    catch (err) {
+        // pgrep exits with code 1 when no processes match — that's expected
+        if (err && typeof err === 'object' && 'status' in err && err.status === 1) {
+            pgrepAvailable = true;
+            return false;
+        }
+        // Any other error (pgrep not installed, permission denied, etc.)
+        if (pgrepAvailable === null) {
+            logger.warn(`Process detection unavailable: ${err instanceof Error ? err.message : String(err)}. Background run status may be inaccurate.`);
+            pgrepAvailable = false;
+        }
         return false;
     }
 }
 /**
- * Detect current phase of the loop based on active prompt files.
+ * Return the conventional log file path for a feature loop.
+ */
+export function getLoopLogPath(feature) {
+    return `/tmp/ralph-loop-${feature}.log`;
+}
+/**
+ * Detect current phase of the loop by checking for processes with prompt file patterns in their command line.
+ *
+ * Note: prompt-file checks (PROMPT_feature.md, etc.) are global — they match any
+ * running process, not just the one for `feature`. This is acceptable because
+ * concurrent loops are rare, but callers should be aware of the limitation.
  */
 export function detectPhase(feature) {
     if (isProcessRunning('PROMPT_feature.md'))
@@ -38,9 +67,18 @@ export function detectPhase(feature) {
     return 'Idle';
 }
 /**
- * Read status from temp files.
+ * Read loop status from temp files written by feature-loop.sh.
+ *
+ * Reads `ralph-loop-<feature>.status` (or `.final`) for iteration progress
+ * and `ralph-loop-<feature>.tokens` for token counts. Also runs `pgrep` to
+ * check whether the loop process is still alive.
+ *
+ * @throws {Error} If `feature` contains invalid characters.
  */
 export function readLoopStatus(feature) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(feature)) {
+        throw new Error(`Invalid feature name: "${feature}". Must contain only letters, numbers, hyphens, and underscores.`);
+    }
     const statusFile = `/tmp/ralph-loop-${feature}.status`;
     const finalStatusFile = `/tmp/ralph-loop-${feature}.final`;
     const tokensFile = `/tmp/ralph-loop-${feature}.tokens`;
@@ -54,8 +92,8 @@ export function readLoopStatus(feature) {
             iteration = parseInt(parts[0] || '0', 10) || 0;
             maxIterations = parseInt(parts[1] || '0', 10) || 0;
         }
-        catch {
-            // Ignore parse errors
+        catch (err) {
+            logger.debug(`Failed to parse status file: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     let tokensInput = 0;
@@ -67,8 +105,8 @@ export function readLoopStatus(feature) {
             tokensInput = parseInt(parts[0] || '0', 10) || 0;
             tokensOutput = parseInt(parts[1] || '0', 10) || 0;
         }
-        catch {
-            // Ignore parse errors
+        catch (err) {
+            logger.debug(`Failed to parse tokens file: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     return {
@@ -81,12 +119,23 @@ export function readLoopStatus(feature) {
     };
 }
 /**
- * Parse implementation plan for task counts.
+ * Parse the markdown implementation plan for a feature to extract task/E2E counts.
+ *
+ * Looks for `- [x]` (done) and `- [ ]` (pending) checklist items.
+ * Items containing "E2E:" are counted separately as end-to-end tests.
+ *
+ * @returns Counts of done/pending tasks and E2E tests.
  */
 export async function parseImplementationPlan(projectRoot, feature, specsDirOverride) {
-    const config = specsDirOverride
-        ? null
-        : await loadConfigWithDefaults(projectRoot);
+    let config = null;
+    if (!specsDirOverride) {
+        try {
+            config = await loadConfigWithDefaults(projectRoot);
+        }
+        catch (err) {
+            logger.debug(`Failed to load config for plan parsing: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
     const specsDir = specsDirOverride || config?.paths.specs || '.ralph/specs';
     const planPath = join(projectRoot, specsDir, `${feature}-implementation-plan.md`);
     let tasksDone = 0;
@@ -117,8 +166,8 @@ export async function parseImplementationPlan(projectRoot, feature, specsDirOver
                 }
             }
         }
-        catch {
-            // Ignore parse errors
+        catch (err) {
+            logger.debug(`Failed to parse implementation plan: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     return { tasksDone, tasksPending, e2eDone, e2ePending };
@@ -131,9 +180,10 @@ export function getGitBranch(projectRoot) {
         return execFileSync('git', ['branch', '--show-current'], {
             cwd: projectRoot,
             encoding: 'utf-8',
-        }).trim();
+        }).trim() || '(detached HEAD)';
     }
-    catch {
+    catch (err) {
+        logger.debug(`getGitBranch failed: ${err instanceof Error ? err.message : String(err)}`);
         return '-';
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -33,6 +33,10 @@
     "code-generation",
     "tech-stack-detection"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/federiconeri/wiggum-cli"
+  },
   "author": "Wiggum CLI Contributors",
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {