wiggum-cli 0.13.1 → 0.14.0

package/dist/templates/scripts/feature-loop.sh.tmpl

@@ -105,6 +105,8 @@ TOKENS_FILE="/tmp/ralph-loop-${1}.tokens"
 CLAUDE_OUTPUT="/tmp/ralph-loop-${1}.output"
 STATUS_FILE="/tmp/ralph-loop-${1}.status"
 FINAL_STATUS_FILE="/tmp/ralph-loop-${1}.final"
+PHASES_FILE="/tmp/ralph-loop-${1}.phases"
+BASELINE_FILE="/tmp/ralph-loop-${1}.baseline"
 
 # Initialize token tracking
 init_tokens() {
@@ -139,6 +141,33 @@ parse_and_accumulate_tokens() {
 # Initialize tokens
 init_tokens
 
+# Phase tracking helpers
+write_phase_start() {
+    local phase_id="$1"
+    local timestamp=$(date +%s)
+    echo "${phase_id}|started|${timestamp}|" >> "$PHASES_FILE"
+}
+
+write_phase_end() {
+    local phase_id="$1"
+    local status="$2"  # success, failed, skipped
+    local timestamp=$(date +%s)
+
+    # Find the last line for this phase and update it
+    if [ -f "$PHASES_FILE" ]; then
+        # Get all lines except the last matching phase line
+        grep -v "^${phase_id}|started|" "$PHASES_FILE" > "${PHASES_FILE}.tmp" 2>/dev/null || true
+        # Find the start timestamp from the original file
+        local start_ts=$(grep "^${phase_id}|started|" "$PHASES_FILE" | tail -1 | cut -d'|' -f3)
+        # Write updated line
+        echo "${phase_id}|${status}|${start_ts}|${timestamp}" >> "${PHASES_FILE}.tmp"
+        mv "${PHASES_FILE}.tmp" "$PHASES_FILE"
+    fi
+}
+
+# Initialize phase tracking
+> "$PHASES_FILE"
+
 FEATURE="${1:?Usage: ./feature-loop.sh <feature-name> [max-iterations] [max-e2e-attempts] [--worktree] [--resume] [--model MODEL]}"
 MAX_ITERATIONS="${2:-$DEFAULT_MAX_ITERATIONS}"
 MAX_E2E_ATTEMPTS="${3:-$DEFAULT_MAX_E2E}"
@@ -194,22 +223,42 @@ fi
 # Create output file for monitoring
 touch "$CLAUDE_OUTPUT"
 
+# Record baseline commit
+if git rev-parse --git-dir > /dev/null 2>&1; then
+    BASELINE_COMMIT=$(git rev-parse HEAD 2>/dev/null || echo "")
+    if [ -n "$BASELINE_COMMIT" ]; then
+        echo "$BASELINE_COMMIT" > "$BASELINE_FILE"
+        echo "Baseline commit: $BASELINE_COMMIT"
+    fi
+fi
+
 # Phase 3: Planning (if no implementation plan exists)
 if [ ! -f "$PLAN_FILE" ]; then
     echo "======================== PLANNING PHASE ========================"
+    write_phase_start "planning"
     export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
     cat "$PROMPTS_DIR/PROMPT_feature.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || {
         echo "ERROR: Planning phase failed"
+        write_phase_end "planning" "failed"
         exit 1
     }
     parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+    write_phase_end "planning" "success"
+else
+    echo "Plan file exists, skipping planning phase"
+    write_phase_start "planning"
+    write_phase_end "planning" "skipped"
 fi
 
 # Phase 4: Implementation loop
 echo "======================== IMPLEMENTATION PHASE ========================"
+write_phase_start "implementation"
+IMPL_SUCCESS=true
 while true; do
     if [ $ITERATION -ge $MAX_ITERATIONS ]; then
         echo "Reached max iterations: $MAX_ITERATIONS"
+        IMPL_SUCCESS=false
+        write_phase_end "implementation" "failed"
         exit 1
     fi
 
@@ -231,13 +280,20 @@ while true; do
 
     sleep 2
 done
+if [ "$IMPL_SUCCESS" = true ]; then
+    write_phase_end "implementation" "success"
+fi
 
 # Phase 5: E2E Testing
 echo "======================== E2E TESTING PHASE ========================"
 E2E_TOTAL=$({ grep "^- \[.\].*E2E:" "$PLAN_FILE" 2>/dev/null || true; } | wc -l | tr -d ' ')
 if [ "$E2E_TOTAL" -eq 0 ]; then
     echo "No E2E scenarios defined, skipping E2E phase."
+    write_phase_start "e2e_testing"
+    write_phase_end "e2e_testing" "skipped"
 else
+    write_phase_start "e2e_testing"
+    E2E_SUCCESS=false
     E2E_ATTEMPT=0
     while [ $E2E_ATTEMPT -lt $MAX_E2E_ATTEMPTS ]; do
         E2E_ATTEMPT=$((E2E_ATTEMPT + 1))
@@ -253,6 +309,7 @@ else
 
         if [ "$E2E_FAILED" -eq 0 ] && [ "$E2E_PENDING" -eq 0 ]; then
             echo "All E2E tests passed!"
+            E2E_SUCCESS=true
             break
         fi
 
@@ -262,26 +319,46 @@ else
             parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
         fi
     done
+
+    if [ "$E2E_SUCCESS" = true ]; then
+        write_phase_end "e2e_testing" "success"
+    else
+        write_phase_end "e2e_testing" "failed"
+    fi
 fi
 
 # Phase 6: Spec Verification
 echo "======================== SPEC VERIFICATION PHASE ========================"
+write_phase_start "verification"
 export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
-cat "$PROMPTS_DIR/PROMPT_verify.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || true
+VERIFY_STATUS="success"
+if ! cat "$PROMPTS_DIR/PROMPT_verify.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT"; then
+    VERIFY_STATUS="failed"
+fi
 parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+write_phase_end "verification" "$VERIFY_STATUS"
 
 # Phase 7: PR and Review
 echo "======================== PR & REVIEW PHASE ========================"
+write_phase_start "pr_review"
 export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
+PR_STATUS="success"
 if [ "$REVIEW_MODE" = "manual" ]; then
-    cat "$PROMPTS_DIR/PROMPT_review_manual.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || true
+    if ! cat "$PROMPTS_DIR/PROMPT_review_manual.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT"; then
+        PR_STATUS="failed"
+    fi
 else
-    cat "$PROMPTS_DIR/PROMPT_review_auto.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || true
+    if ! cat "$PROMPTS_DIR/PROMPT_review_auto.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT"; then
+        PR_STATUS="failed"
+    fi
 fi
 parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+write_phase_end "pr_review" "$PR_STATUS"
 
 # Persist final status for TUI summaries
-echo "$ITERATION|$MAX_ITERATIONS|$(date +%s)|done" > "$FINAL_STATUS_FILE" 2>/dev/null || true
+if ! echo "$ITERATION|$MAX_ITERATIONS|$(date +%s)|done" > "$FINAL_STATUS_FILE"; then
+    echo "WARNING: Failed to write final status file: $FINAL_STATUS_FILE" >&2
+fi
 
 # Cleanup temp files
 rm -f "$STATUS_FILE" 2>/dev/null || true

package/dist/tui/app.js

@@ -182,7 +182,8 @@ interviewProps, onComplete, onExit, }) {
             if (!featureName || typeof featureName !== 'string') {
                 return null; // useEffect will redirect to shell
             }
-            return (_jsx(RunScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, sessionState: sessionState, monitorOnly: monitorOnly, onComplete: handleRunComplete, onBackground: handleRunBackground, onCancel: () => navigate('shell') }));
+            const reviewMode = screenProps?.reviewMode;
+            return (_jsx(RunScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, sessionState: sessionState, monitorOnly: monitorOnly, reviewMode: reviewMode, onComplete: handleRunComplete, onBackground: handleRunBackground, onCancel: () => navigate('shell') }));
         }
         default: {
             // Return fallback UI instead of calling navigate() during render (which would be setState during render).

package/dist/tui/components/ChatInput.js

@@ -18,7 +18,7 @@ import { Box, Text, useInput } from 'ink';
 import { theme } from '../theme.js';
 import { CommandDropdown, DEFAULT_COMMANDS } from './CommandDropdown.js';
 import { useCommandHistory } from '../hooks/useCommandHistory.js';
-import { normalizePastedText, insertTextAtCursor, deleteCharBefore, deleteCharAfter, moveCursorByWordLeft, moveCursorByWordRight, } from '../utils/input-utils.js';
+import { normalizePastedText, insertTextAtCursor, deleteCharBefore, deleteWordBefore, moveCursorByWordLeft, moveCursorByWordRight, } from '../utils/input-utils.js';
 /**
  * ChatInput component
  *
@@ -113,21 +113,39 @@ export function ChatInput({ onSubmit, placeholder = 'Type your message...', disa
             handleSubmit(value);
             return;
         }
-        const isBackspace = key.backspace ||
-            input === '\x7f' ||
-            input === '\b' ||
-            (key.ctrl && input === 'h');
-        if (isBackspace) {
+        // Backspace: Ink v5 maps macOS Backspace (\x7f) to key.delete, not
+        // key.backspace.  Since there is no reliable way to distinguish it from
+        // forward-Delete (\u001b[3~] — also key.delete), treat both as backspace,
+        // matching ink-text-input's approach.
+        const isBackspaceOrDelete = key.backspace || key.delete;
+        if (isBackspaceOrDelete) {
             const { newValue, newCursorIndex } = deleteCharBefore(value, cursorOffset);
             updateValue(newValue, newCursorIndex);
             return;
         }
-        const isDelete = key.delete || input === '\u001b[3~';
-        if (isDelete) {
-            const { newValue, newCursorIndex } = deleteCharAfter(value, cursorOffset);
+        // Readline keybindings (before the blanket ctrl guard)
+        if (key.ctrl && input === 'a') {
+            updateValue(value, 0, true);
+            return;
+        }
+        if (key.ctrl && input === 'e') {
+            updateValue(value, value.length, true);
+            return;
+        }
+        if (key.ctrl && input === 'w') {
+            const { newValue, newCursorIndex } = deleteWordBefore(value, cursorOffset);
             updateValue(newValue, newCursorIndex);
             return;
         }
+        if (key.ctrl && input === 'u') {
+            updateValue(value.slice(cursorOffset), 0);
+            return;
+        }
+        if (key.ctrl && input === 'k') {
+            updateValue(value.slice(0, cursorOffset), cursorOffset, true);
+            return;
+        }
+        // Blanket guard for remaining unhandled ctrl combos
         if (key.ctrl) {
             return;
         }

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

@@ -1,8 +1,8 @@
 /**
- * RunCompletionSummary - Displays run loop completion recap
+ * RunCompletionSummary - Displays enhanced run loop completion recap
  *
- * Shows the feature, iterations, tasks, tokens, branch, exit status,
- * log tail, and "what's next" section after a feature loop completes.
+ * Shows a bordered summary box with timing, phases, iterations, tasks, code changes,
+ * commits, and PR/issue links after a feature loop completes.
  */
 import React from 'react';
 import type { RunSummary } from '../screens/RunScreen.js';
@@ -13,10 +13,4 @@ export interface RunCompletionSummaryProps {
     /** Run summary data */
     summary: RunSummary;
 }
-/**
- * RunCompletionSummary component
- *
- * Renders the run loop completion recap inline within the
- * RunScreen content area.
- */
 export declare function RunCompletionSummary({ summary, }: RunCompletionSummaryProps): React.ReactElement;

package/dist/tui/components/RunCompletionSummary.js

@@ -1,23 +1,68 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
-import { StatusLine } from './StatusLine.js';
-import { colors, theme } from '../theme.js';
-import { formatNumber } from '../utils/loop-status.js';
+import { SummaryBox, SummaryBoxSection } from './SummaryBox.js';
+import { colors, phase } from '../theme.js';
+/**
+ * Format milliseconds to human-readable duration (e.g., "12m 34s", "1h 15m 0s")
+ */
+function formatDurationMs(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return 'Unknown';
+    const totalSeconds = Math.floor(ms / 1000);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (hours > 0)
+        return `${hours}h ${minutes}m ${seconds}s`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds}s`;
+    return `${seconds}s`;
+}
 /**
  * RunCompletionSummary component
  *
- * Renders the run loop completion recap inline within the
- * RunScreen content area.
+ * Renders the enhanced run loop completion summary using SummaryBox.
+ * Displays header, timing/iterations/tasks, phases, changes/commits, and PR/issue links.
  */
+const stoppedCodes = new Set([130, 143]);
 export function RunCompletionSummary({ summary, }) {
-    const totalTokens = summary.tokensInput + summary.tokensOutput;
-    const stoppedCodes = new Set([130, 143]);
-    const exitState = summary.exitCode === 0
-        ? { label: 'Complete', color: colors.green, message: 'Done. Feature loop completed successfully.' }
+    // Determine final status and color
+    const exitStatus = summary.exitCode === 0
+        ? { label: 'Complete', color: colors.green }
         : stoppedCodes.has(summary.exitCode)
-            ? { label: 'Stopped', color: colors.orange, message: 'Stopped. Feature loop interrupted.' }
+            ? { label: 'Stopped', color: colors.orange }
             : summary.exitCodeInferred
-                ? { label: 'Unknown', color: colors.orange, message: `Done. Exit status uncertain (inferred code ${summary.exitCode}). Check logs for details.` }
-                : { label: 'Failed', color: colors.pink, message: `Done. Feature loop exited with code ${summary.exitCode}.` };
-    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(StatusLine, { action: "Run Loop", phase: exitState.label, path: summary.feature }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Summary" }), _jsxs(Text, { children: ["- Feature: ", summary.feature] }), _jsxs(Text, { children: ["- Iterations: ", summary.iterations, "/", summary.maxIterations] }), _jsxs(Text, { children: ["- Tasks: ", summary.tasksDone, "/", summary.tasksTotal] }), _jsxs(Text, { children: ["- Tokens: ", formatNumber(totalTokens), " (in:", formatNumber(summary.tokensInput), " out:", formatNumber(summary.tokensOutput), ")"] }), summary.branch && summary.branch !== '-' && (_jsxs(Text, { children: ["- Branch: ", summary.branch] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsxs(Text, { color: exitState.color, children: [theme.chars.bullet, " "] }), _jsx(Text, { children: exitState.message })] }), (summary.errorTail || summary.logPath) && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [summary.logPath && (_jsxs(Text, { dimColor: true, children: ["Log: ", summary.logPath] })), summary.errorTail && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Last output:" }), summary.errorTail.split('\n').map((line, idx) => (_jsx(Text, { dimColor: true, children: line }, `${line}-${idx}`)))] }))] })), _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 }), _jsx(Text, { dimColor: true, children: "Review changes and open a PR if needed" })] }), _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 another feature specification" })] }), _jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: colors.green, children: theme.chars.prompt }), _jsx(Text, { color: colors.blue, children: "/help" }), _jsx(Text, { dimColor: true, children: "See all commands" })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Press Enter or Esc to return to shell" }) })] }));
+                ? { label: 'Unknown', color: colors.orange }
+                : { label: 'Failed', color: colors.pink };
+    // Use enhanced iteration data if available, fallback to legacy
+    const iterationsTotal = summary.iterationBreakdown?.total ?? summary.iterations;
+    const iterationsImpl = summary.iterationBreakdown?.implementation;
+    const iterationsResumes = summary.iterationBreakdown?.resumes;
+    // Format iterations with breakdown if available
+    const iterationsDisplay = iterationsImpl !== undefined && iterationsResumes !== undefined
+        ? `${iterationsTotal} (${iterationsImpl} impl + ${iterationsResumes} resume)`
+        : String(iterationsTotal);
+    // Tasks: use enhanced field if available, fallback to legacy
+    const tasksCompleted = summary.tasks?.completed ?? summary.tasksDone;
+    const tasksTotal = summary.tasks?.total ?? summary.tasksTotal;
+    const tasksDisplay = tasksCompleted !== null && tasksTotal !== null
+        ? `${tasksCompleted}/${tasksTotal} completed`
+        : 'Not available';
+    return (_jsxs(SummaryBox, { minWidth: 60, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(Text, { bold: true, children: summary.feature }), _jsx(Text, { bold: true, color: exitStatus.color, children: exitStatus.label })] }), _jsxs(SummaryBoxSection, { children: [summary.totalDurationMs !== undefined ? (_jsxs(Text, { children: ["Duration: ", formatDurationMs(summary.totalDurationMs)] })) : (_jsx(Text, { children: "Duration: Not available" })), _jsxs(Text, { children: ["Iterations: ", iterationsDisplay] }), _jsxs(Text, { children: ["Tasks: ", tasksDisplay] })] }), _jsxs(SummaryBoxSection, { children: [_jsx(Text, { bold: true, children: "Phases" }), summary.phases && summary.phases.length > 0 ? (summary.phases.map((phaseInfo) => {
+                        const statusIcon = phaseInfo.status === 'success' ? phase.complete :
+                            phaseInfo.status === 'failed' ? phase.error :
+                                phase.pending;
+                        const statusColor = phaseInfo.status === 'success' ? colors.green :
+                            phaseInfo.status === 'failed' ? colors.pink :
+                                colors.gray;
+                        const durationText = phaseInfo.durationMs !== undefined
+                            ? formatDurationMs(phaseInfo.durationMs)
+                            : 'Not available';
+                        const iterationsText = phaseInfo.iterations !== undefined && phaseInfo.iterations > 0
+                            ? ` (${phaseInfo.iterations} iterations)`
+                            : '';
+                        const statusText = phaseInfo.status === 'skipped' ? ' skipped' :
+                            phaseInfo.status === 'failed' ? ' failed' : '';
+                        return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: statusColor, children: [statusIcon, " "] }), _jsxs(Text, { children: [phaseInfo.label, " ", durationText, iterationsText, statusText] })] }, phaseInfo.id));
+                    })) : (_jsx(Text, { children: "No phase information available" }))] }), _jsxs(SummaryBoxSection, { children: [_jsx(Text, { bold: true, children: "Changes" }), summary.changes ? (!summary.changes.available ? (_jsx(Text, { children: "Changes: Not available" })) : summary.changes.totalFilesChanged === 0 || (summary.changes.files && summary.changes.files.length === 0) ? (_jsx(Text, { children: "No changes" })) : summary.changes.totalFilesChanged !== undefined || summary.changes.files ? (_jsxs(_Fragment, { children: [summary.changes.totalFilesChanged !== undefined && (_jsxs(Text, { children: [summary.changes.totalFilesChanged, " file", summary.changes.totalFilesChanged !== 1 ? 's' : '', " changed"] })), summary.changes.files && summary.changes.files.map((file) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { children: [file.path, "  "] }), _jsxs(Text, { color: colors.green, children: ["+", file.added, " "] }), _jsxs(Text, { color: colors.pink, children: ["-", file.removed] }), _jsx(Text, { children: " lines" })] }, file.path)))] })) : (_jsx(Text, { children: "Changes: Could not compute diff" }))) : (_jsx(Text, { children: "Changes: Not available" })), summary.commits ? (!summary.commits.available ? (_jsx(Text, { children: "Commit: Not available" })) : summary.commits.fromHash && summary.commits.toHash ? (_jsxs(Text, { children: ["Commit: ", summary.commits.fromHash, " \u2192 ", summary.commits.toHash, summary.commits.mergeType === 'squash' && ' (squash-merged)', summary.commits.mergeType === 'normal' && ' (merged)'] })) : summary.commits.toHash ? (_jsxs(Text, { children: ["Commit: ", summary.commits.toHash] })) : (_jsx(Text, { children: "Commit: Not available" }))) : (_jsx(Text, { children: "Commit: Not available" }))] }), _jsxs(SummaryBoxSection, { children: [summary.pr ? (_jsx(_Fragment, { children: !summary.pr.available ? (_jsx(Text, { children: "PR: Not available" })) : summary.pr.created && summary.pr.number && summary.pr.url ? (_jsxs(Text, { children: ["PR #", summary.pr.number, ": ", summary.pr.url] })) : (_jsx(Text, { children: "PR: Not created" })) })) : (_jsx(Text, { children: "PR: Not available" })), summary.issue ? (_jsx(_Fragment, { children: !summary.issue.available ? (_jsx(Text, { children: "Issue: Not available" })) : summary.issue.linked && summary.issue.number ? (_jsxs(Text, { children: ["Issue #", summary.issue.number, ": ", summary.issue.status || 'Linked', summary.issue.url && ` (${summary.issue.url})`] })) : (_jsx(Text, { children: "Issue: Not linked" })) })) : (_jsx(Text, { children: "Issue: Not available" }))] })] }));
 }

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

@@ -0,0 +1,59 @@
+/**
+ * SummaryBox - Bordered box wrapper for enhanced run summary
+ *
+ * Draws a bordered box using box-drawing characters that adapts to
+ * terminal width. Provides section separators and content padding.
+ */
+import React from 'react';
+/**
+ * Props for SummaryBox component
+ */
+export interface SummaryBoxProps {
+    /** Child content to render inside the box */
+    children: React.ReactNode;
+    /** Minimum box width in columns (default: 60) */
+    minWidth?: number;
+}
+/**
+ * Props for SummaryBoxSection component
+ */
+export interface SummaryBoxSectionProps {
+    /** Section content */
+    children: React.ReactNode;
+}
+/**
+ * SummaryBox component
+ *
+ * Renders a bordered box with top/bottom borders and section separators.
+ * Adapts to terminal width while respecting minimum width.
+ *
+ * @example
+ * ```tsx
+ * <SummaryBox>
+ *   <Text>Header content</Text>
+ *   <SummaryBoxSection>
+ *     <Text>Section 1</Text>
+ *   </SummaryBoxSection>
+ * </SummaryBox>
+ * ```
+ */
+export declare function SummaryBox({ children, minWidth, }: SummaryBoxProps): React.ReactElement;
+/**
+ * SummaryBoxSection component
+ *
+ * Marks a section boundary within a SummaryBox. The parent SummaryBox
+ * will render a separator line (├─────┤) before this section's content.
+ *
+ * This is a marker component - the actual rendering is handled by SummaryBox.
+ *
+ * @example
+ * ```tsx
+ * <SummaryBox>
+ *   <Text>Header</Text>
+ *   <SummaryBoxSection>
+ *     <Text>Section content</Text>
+ *   </SummaryBoxSection>
+ * </SummaryBox>
+ * ```
+ */
+export declare function SummaryBoxSection({ children, }: SummaryBoxSectionProps): React.ReactElement;

package/dist/tui/components/SummaryBox.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * SummaryBox - Bordered box wrapper for enhanced run summary
+ *
+ * Draws a bordered box using box-drawing characters that adapts to
+ * terminal width. Provides section separators and content padding.
+ */
+import React from 'react';
+import { Box, Text, useStdout } from 'ink';
+import { box, colors } from '../theme.js';
+/**
+ * SummaryBox component
+ *
+ * Renders a bordered box with top/bottom borders and section separators.
+ * Adapts to terminal width while respecting minimum width.
+ *
+ * @example
+ * ```tsx
+ * <SummaryBox>
+ *   <Text>Header content</Text>
+ *   <SummaryBoxSection>
+ *     <Text>Section 1</Text>
+ *   </SummaryBoxSection>
+ * </SummaryBox>
+ * ```
+ */
+export function SummaryBox({ children, minWidth = 60, }) {
+    const { stdout } = useStdout();
+    const terminalWidth = stdout?.columns ?? 80;
+    // Use terminal width, but respect minimum width
+    const boxWidth = Math.max(minWidth, terminalWidth);
+    const contentWidth = boxWidth - 4; // Account for borders and padding
+    // Top border: ┌─────┐
+    const topBorder = box.topLeft + box.horizontal.repeat(boxWidth - 2) + box.topRight;
+    // Bottom border: └─────┘
+    const bottomBorder = box.bottomLeft + box.horizontal.repeat(boxWidth - 2) + box.bottomRight;
+    // Section separator: ├─────┤
+    const leftJunction = '\u251c'; // ├
+    const rightJunction = '\u2524'; // ┤
+    const sectionSeparator = leftJunction + box.horizontal.repeat(boxWidth - 2) + rightJunction;
+    const elements = [];
+    React.Children.forEach(children, (child) => {
+        if (!child)
+            return;
+        // Check if this is a SummaryBoxSection
+        if (React.isValidElement(child) &&
+            child.type === SummaryBoxSection) {
+            // Add section separator line
+            elements.push(_jsx(Text, { color: colors.separator, children: sectionSeparator }, `sep-${elements.length}`));
+            // Add the section content (children of SummaryBoxSection)
+            const sectionChildren = child.props.children;
+            React.Children.forEach(sectionChildren, (sectionChild) => {
+                if (sectionChild) {
+                    elements.push(sectionChild);
+                }
+            });
+        }
+        else {
+            // Regular content
+            elements.push(child);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", width: boxWidth, children: [_jsx(Text, { color: colors.separator, children: topBorder }), _jsx(Box, { flexDirection: "column", children: elements.map((child, index) => {
+                    // Check if this is a separator line (Text with the separator)
+                    if (React.isValidElement(child) &&
+                        child.type === Text &&
+                        typeof child.props.children === 'string' &&
+                        child.props.children.startsWith(leftJunction)) {
+                        // Render separator without side borders
+                        return _jsx(React.Fragment, { children: child }, index);
+                    }
+                    // Wrap regular content with vertical borders
+                    return (_jsxs(Box, { flexDirection: "row", width: boxWidth, children: [_jsxs(Text, { color: colors.separator, children: [box.vertical, " "] }), _jsx(Box, { width: contentWidth, flexShrink: 0, overflow: "hidden", children: child }), _jsxs(Text, { color: colors.separator, children: [" ", box.vertical] })] }, index));
+                }) }), _jsx(Text, { color: colors.separator, children: bottomBorder })] }));
+}
+/**
+ * SummaryBoxSection component
+ *
+ * Marks a section boundary within a SummaryBox. The parent SummaryBox
+ * will render a separator line (├─────┤) before this section's content.
+ *
+ * This is a marker component - the actual rendering is handled by SummaryBox.
+ *
+ * @example
+ * ```tsx
+ * <SummaryBox>
+ *   <Text>Header</Text>
+ *   <SummaryBoxSection>
+ *     <Text>Section content</Text>
+ *   </SummaryBoxSection>
+ * </SummaryBox>
+ * ```
+ */
+export function SummaryBoxSection({ children, }) {
+    // This component is just a marker - actual rendering happens in SummaryBox
+    return _jsx(_Fragment, { children: children });
+}

package/dist/tui/screens/MainShell.js

@@ -116,8 +116,29 @@ export function MainShell({ header, sessionState, onNavigate, backgroundRuns, in
             addSystemMessage('Project not initialized. Run /init first.');
             return;
         }
-        const featureName = args[0];
-        onNavigate('run', { featureName });
+        // Parse optional flags, separating them from positional args
+        let reviewMode;
+        const positional = [];
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] === '--review-mode') {
+                if (i + 1 < args.length) {
+                    reviewMode = args[i + 1];
+                    i++; // skip the value
+                }
+                continue;
+            }
+            positional.push(args[i]);
+        }
+        if (reviewMode !== undefined && reviewMode !== 'manual' && reviewMode !== 'auto') {
+            addSystemMessage(`Invalid --review-mode value '${reviewMode}'. Use 'manual' or 'auto'.`);
+            return;
+        }
+        const featureName = positional[0];
+        if (!featureName) {
+            addSystemMessage('Feature name required. Usage: /run <feature-name> [--review-mode auto|manual]');
+            return;
+        }
+        onNavigate('run', { featureName, reviewMode });
     }, [sessionState.initialized, addSystemMessage, onNavigate]);
     const handleMonitor = useCallback((args) => {
         if (args.length === 0) {