wiggum-cli 0.15.0 → 0.16.0

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

@@ -97,8 +97,8 @@ if [ "$REVIEW_MODE" != "manual" ] && [ "$REVIEW_MODE" != "auto" ] && [ "$REVIEW_
 fi
 
 # Build claude commands
-CLAUDE_CMD_OPUS="claude -p --dangerously-skip-permissions --model ${PLANNING_MODEL}"
-CLAUDE_CMD_IMPL="claude -p --dangerously-skip-permissions --model ${MODEL:-$DEFAULT_MODEL}"
+CLAUDE_CMD_OPUS="claude -p --output-format json --dangerously-skip-permissions --model ${PLANNING_MODEL}"
+CLAUDE_CMD_IMPL="claude -p --output-format json --dangerously-skip-permissions --model ${MODEL:-$DEFAULT_MODEL}"
 
 # Token tracking
 TOKENS_FILE="/tmp/ralph-loop-${1}.tokens"
@@ -107,35 +107,130 @@ 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"
+SESSIONS_FILE="/tmp/ralph-loop-${1}.sessions"
+LOG_FILE="/tmp/ralph-loop-${1}.log"
 
-# Initialize token tracking
+# Initialize token tracking (4-field format: input|output|cache_create|cache_read)
 init_tokens() {
-    echo "0|0" > "$TOKENS_FILE"
+    echo "0|0|0|0" > "$TOKENS_FILE"
+    > "$SESSIONS_FILE"
+    > "$LOG_FILE"
 }
 
-# Parse and accumulate tokens
-parse_and_accumulate_tokens() {
-    local output_file="$1"
-    local input_tokens=$({ grep -oE "input[^0-9]*([0-9,]+)" "$output_file" 2>/dev/null || true; } | { grep -oE "[0-9,]+" || true; } | tr -d ',' | tail -1)
-    local output_tokens=$({ grep -oE "output[^0-9]*([0-9,]+)" "$output_file" 2>/dev/null || true; } | { grep -oE "[0-9,]+" || true; } | tr -d ',' | tail -1)
+# Extract session result from JSON output.
+# Writes human-readable result text to the .log file and captures session_id.
+# Usage: extract_session_result <raw_json_file>
+# Sets: LAST_SESSION_ID variable
+extract_session_result() {
+    local raw_file="$1"
+    LAST_SESSION_ID=""
+    if [ ! -f "$raw_file" ]; then return; fi
+
+    local result
+    result=$(python3 -c "
+import json, sys
+try:
+    data = json.load(open(sys.argv[1]))
+    if not isinstance(data, list): data = [data]
+    for entry in reversed(data):
+        if isinstance(entry, dict) and entry.get('type') == 'result':
+            print(entry.get('session_id', ''))
+            break
+except Exception:
+    pass
+" "$raw_file" 2>/dev/null) || true
+
+    LAST_SESSION_ID="$result"
+
+    if [ -n "$LAST_SESSION_ID" ]; then
+        echo "$LAST_SESSION_ID" >> "$SESSIONS_FILE"
+    fi
+
+    # Extract human-readable result text and append to log
+    python3 -c "
+import json, sys
+try:
+    data = json.load(open(sys.argv[1]))
+    if not isinstance(data, list): data = [data]
+    for entry in data:
+        if isinstance(entry, dict) and entry.get('type') == 'result':
+            text = entry.get('result', '')
+            if text:
+                print(text)
+except Exception:
+    pass
+" "$raw_file" >> "$LOG_FILE" 2>/dev/null || true
+}
+
+# Accumulate tokens from a session JSONL file into the .tokens file.
+# Usage: accumulate_tokens_from_session <session_id>
+accumulate_tokens_from_session() {
+    local session_id="$1"
+    if [ -z "$session_id" ]; then return; fi
+
+    # Find the JSONL file for this session
+    local jsonl_file=""
+    for f in ~/.claude/projects/*/"${session_id}.jsonl"; do
+        if [ -f "$f" ]; then
+            jsonl_file="$f"
+            break
+        fi
+    done
 
-    input_tokens=${input_tokens:-0}
-    output_tokens=${output_tokens:-0}
+    if [ -z "$jsonl_file" ]; then
+        echo "WARNING: Could not find JSONL for session $session_id" >&2
+        return
+    fi
 
+    # Extract and sum token usage from all assistant messages
+    local session_tokens
+    session_tokens=$(python3 -c "
+import json, sys
+totals = {'input': 0, 'output': 0, 'cache_create': 0, 'cache_read': 0}
+for line in open(sys.argv[1]):
+    try:
+        obj = json.loads(line)
+        if obj.get('type') != 'assistant':
+            continue
+        usage = obj.get('message', {}).get('usage', {})
+        if not usage:
+            continue
+        totals['input'] += usage.get('input_tokens', 0)
+        totals['output'] += usage.get('output_tokens', 0)
+        totals['cache_create'] += usage.get('cache_creation_input_tokens', 0)
+        totals['cache_read'] += usage.get('cache_read_input_tokens', 0)
+    except (json.JSONDecodeError, AttributeError):
+        continue
+print(f\"{totals['input']}|{totals['output']}|{totals['cache_create']}|{totals['cache_read']}\")
+" "$jsonl_file" 2>/dev/null) || true
+
+    if [ -z "$session_tokens" ]; then return; fi
+
+    # Parse session tokens
+    local s_input s_output s_cache_create s_cache_read
+    s_input=$(echo "$session_tokens" | cut -d'|' -f1)
+    s_output=$(echo "$session_tokens" | cut -d'|' -f2)
+    s_cache_create=$(echo "$session_tokens" | cut -d'|' -f3)
+    s_cache_read=$(echo "$session_tokens" | cut -d'|' -f4)
+
+    # Read current totals
+    local current c_input c_output c_cache_create c_cache_read
     if [ -f "$TOKENS_FILE" ]; then
-        local current=$(cat "$TOKENS_FILE")
-        local current_input=$(echo "$current" | cut -d'|' -f1)
-        local current_output=$(echo "$current" | cut -d'|' -f2)
-        [[ "$current_input" =~ ^[0-9]+$ ]] || current_input=0
-        [[ "$current_output" =~ ^[0-9]+$ ]] || current_output=0
+        current=$(cat "$TOKENS_FILE")
+        c_input=$(echo "$current" | cut -d'|' -f1)
+        c_output=$(echo "$current" | cut -d'|' -f2)
+        c_cache_create=$(echo "$current" | cut -d'|' -f3)
+        c_cache_read=$(echo "$current" | cut -d'|' -f4)
+        [[ "$c_input" =~ ^[0-9]+$ ]] || c_input=0
+        [[ "$c_output" =~ ^[0-9]+$ ]] || c_output=0
+        [[ "$c_cache_create" =~ ^[0-9]+$ ]] || c_cache_create=0
+        [[ "$c_cache_read" =~ ^[0-9]+$ ]] || c_cache_read=0
     else
-        current_input=0
-        current_output=0
+        c_input=0; c_output=0; c_cache_create=0; c_cache_read=0
     fi
 
-    local new_input=$((current_input + input_tokens))
-    local new_output=$((current_output + output_tokens))
-    echo "${new_input}|${new_output}" > "$TOKENS_FILE"
+    # Accumulate
+    echo "$((c_input + s_input))|$((c_output + s_output))|$((c_cache_create + s_cache_create))|$((c_cache_read + s_cache_read))" > "$TOKENS_FILE"
 }
 
 # Action inbox: write request file if not already present
@@ -299,12 +394,13 @@ 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" || {
+    cat "$PROMPTS_DIR/PROMPT_feature.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || {
         echo "ERROR: Planning phase failed"
         write_phase_end "planning" "failed"
         exit 1
     }
-    parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+    extract_session_result "${CLAUDE_OUTPUT}.raw"
+    accumulate_tokens_from_session "$LAST_SESSION_ID"
     write_phase_end "planning" "success"
 else
     echo "Plan file exists, skipping planning phase"
@@ -337,8 +433,9 @@ while true; do
 
     echo "Pending implementation tasks: $PENDING_IMPL"
     export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
-    cat "$PROMPTS_DIR/PROMPT.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "$CLAUDE_OUTPUT" || true
-    parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+    cat "$PROMPTS_DIR/PROMPT.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+    extract_session_result "${CLAUDE_OUTPUT}.raw"
+    accumulate_tokens_from_session "$LAST_SESSION_ID"
 
     sleep 2
 done
@@ -362,8 +459,9 @@ else
         echo "------------------------ E2E Attempt $E2E_ATTEMPT of $MAX_E2E_ATTEMPTS ------------------------"
 
         export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
-        cat "$PROMPTS_DIR/PROMPT_e2e.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "$CLAUDE_OUTPUT" || true
-        parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+        cat "$PROMPTS_DIR/PROMPT_e2e.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+        extract_session_result "${CLAUDE_OUTPUT}.raw"
+        accumulate_tokens_from_session "$LAST_SESSION_ID"
 
         # Check if all E2E tests passed
         E2E_FAILED=$({ grep "^- \[ \].*E2E:.*FAILED" "$PLAN_FILE" 2>/dev/null || true; } | wc -l | tr -d ' ')
@@ -377,8 +475,9 @@ else
 
         if [ $E2E_ATTEMPT -lt $MAX_E2E_ATTEMPTS ]; then
             echo "E2E tests have failures. Running fix iteration..."
-            cat "$PROMPTS_DIR/PROMPT.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "$CLAUDE_OUTPUT" || true
-            parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+            cat "$PROMPTS_DIR/PROMPT.md" | envsubst | $CLAUDE_CMD_IMPL 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+            extract_session_result "${CLAUDE_OUTPUT}.raw"
+            accumulate_tokens_from_session "$LAST_SESSION_ID"
         fi
     done
 
@@ -394,10 +493,11 @@ echo "======================== SPEC VERIFICATION PHASE ========================"
 write_phase_start "verification"
 export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
 VERIFY_STATUS="success"
-if ! cat "$PROMPTS_DIR/PROMPT_verify.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT"; then
+if ! cat "$PROMPTS_DIR/PROMPT_verify.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "${CLAUDE_OUTPUT}.raw"; then
     VERIFY_STATUS="failed"
 fi
-parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+extract_session_result "${CLAUDE_OUTPUT}.raw"
+accumulate_tokens_from_session "$LAST_SESSION_ID"
 write_phase_end "verification" "$VERIFY_STATUS"
 
 # Phase 7: PR and Review
@@ -407,11 +507,37 @@ export FEATURE APP_DIR SPEC_DIR PROMPTS_DIR
 PR_STATUS="success"
 MAX_REVIEW_ATTEMPTS=3
 
+# Check for review approval in stdout or latest PR comment.
+# Returns 0 (true) if approved, 1 (false) otherwise.
+check_review_approved() {
+    local output_file="$1"
+
+    # Primary: check stdout for explicit verdict line
+    if grep -qi "VERDICT:.*APPROVED" "$output_file" 2>/dev/null; then
+        # Make sure it's not "NOT APPROVED"
+        if ! grep -qi "VERDICT:.*NOT APPROVED" "$output_file" 2>/dev/null; then
+            return 0
+        fi
+    fi
+
+    # Fallback: check the latest PR comment for approval signal
+    local latest_comment
+    latest_comment=$(gh pr view "$BRANCH" --json comments --jq '.comments[-1].body' 2>/dev/null || echo "")
+    if echo "$latest_comment" | grep -qi "VERDICT:.*APPROVED\|Verdict:.*APPROVED" 2>/dev/null; then
+        if ! echo "$latest_comment" | grep -qi "NOT APPROVED" 2>/dev/null; then
+            return 0
+        fi
+    fi
+
+    return 1
+}
+
 if [ "$REVIEW_MODE" = "manual" ]; then
-    if ! cat "$PROMPTS_DIR/PROMPT_review_manual.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT"; then
+    if ! cat "$PROMPTS_DIR/PROMPT_review_manual.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "${CLAUDE_OUTPUT}.raw"; then
         PR_STATUS="failed"
     fi
-    parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+    extract_session_result "${CLAUDE_OUTPUT}.raw"
+    accumulate_tokens_from_session "$LAST_SESSION_ID"
 
 elif [ "$REVIEW_MODE" = "merge" ]; then
     # Merge mode: create PR, iterate review+fixes until approved, then merge
@@ -420,11 +546,12 @@ elif [ "$REVIEW_MODE" = "merge" ]; then
     while [ $REVIEW_ATTEMPT -lt $MAX_REVIEW_ATTEMPTS ]; do
         REVIEW_ATTEMPT=$((REVIEW_ATTEMPT + 1))
         echo "--- Review attempt $REVIEW_ATTEMPT of $MAX_REVIEW_ATTEMPTS ---"
-        cat "$PROMPTS_DIR/PROMPT_review_merge.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || true
-        parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+        cat "$PROMPTS_DIR/PROMPT_review_merge.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+        extract_session_result "${CLAUDE_OUTPUT}.raw"
+        accumulate_tokens_from_session "$LAST_SESSION_ID"
 
-        # Check if output contains APPROVED
-        if grep -qi "APPROVED" "$CLAUDE_OUTPUT" 2>/dev/null; then
+        # Check stdout and PR comment for approval
+        if check_review_approved "${CLAUDE_OUTPUT}.raw"; then
             echo "Review approved!"
             REVIEW_APPROVED=true
             break
@@ -436,8 +563,9 @@ elif [ "$REVIEW_MODE" = "merge" ]; then
 1. Fix each issue referenced in the review
 2. Run tests: npm test
 3. Commit and push the fixes
-Do NOT propose completion options or ask interactive questions. Just fix, test, commit, push." | $CLAUDE_CMD_IMPL 2>&1 | tee "$CLAUDE_OUTPUT" || true
-            parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+Do NOT propose completion options or ask interactive questions. Just fix, test, commit, push." | $CLAUDE_CMD_IMPL 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+            extract_session_result "${CLAUDE_OUTPUT}.raw"
+            accumulate_tokens_from_session "$LAST_SESSION_ID"
         fi
     done
     if [ "$REVIEW_APPROVED" != true ]; then
@@ -452,11 +580,12 @@ else
     while [ $REVIEW_ATTEMPT -lt $MAX_REVIEW_ATTEMPTS ]; do
         REVIEW_ATTEMPT=$((REVIEW_ATTEMPT + 1))
         echo "--- Review attempt $REVIEW_ATTEMPT of $MAX_REVIEW_ATTEMPTS ---"
-        cat "$PROMPTS_DIR/PROMPT_review_auto.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "$CLAUDE_OUTPUT" || true
-        parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+        cat "$PROMPTS_DIR/PROMPT_review_auto.md" | envsubst | $CLAUDE_CMD_OPUS 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+        extract_session_result "${CLAUDE_OUTPUT}.raw"
+        accumulate_tokens_from_session "$LAST_SESSION_ID"
 
-        # Check if output contains APPROVED
-        if grep -qi "APPROVED" "$CLAUDE_OUTPUT" 2>/dev/null; then
+        # Check stdout and PR comment for approval
+        if check_review_approved "${CLAUDE_OUTPUT}.raw"; then
             echo "Review approved!"
             REVIEW_APPROVED=true
             break
@@ -468,8 +597,9 @@ else
 1. Fix each issue referenced in the review
 2. Run tests: npm test
 3. Commit and push the fixes
-Do NOT propose completion options or ask interactive questions. Just fix, test, commit, push." | $CLAUDE_CMD_IMPL 2>&1 | tee "$CLAUDE_OUTPUT" || true
-            parse_and_accumulate_tokens "$CLAUDE_OUTPUT"
+Do NOT propose completion options or ask interactive questions. Just fix, test, commit, push." | $CLAUDE_CMD_IMPL 2>&1 | tee "${CLAUDE_OUTPUT}.raw" || true
+            extract_session_result "${CLAUDE_OUTPUT}.raw"
+            accumulate_tokens_from_session "$LAST_SESSION_ID"
         fi
     done
     if [ "$REVIEW_APPROVED" != true ]; then
@@ -513,16 +643,30 @@ fi
 # Cleanup temp files
 rm -f "$STATUS_FILE" 2>/dev/null || true
 rm -f "/tmp/ralph-loop-${FEATURE}.output" 2>/dev/null || true
+rm -f "/tmp/ralph-loop-${FEATURE}.output.raw" 2>/dev/null || true
 
 # Print final token usage
 if [ -f "/tmp/ralph-loop-${FEATURE}.tokens" ]; then
     echo ""
     echo "=========================================="
     echo "Final Token Usage:"
-    cat "/tmp/ralph-loop-${FEATURE}.tokens" | awk -F'|' '{printf "  Input: %s tokens\n  Output: %s tokens\n  Total: %s tokens\n", $1, $2, $1+$2}'
+    awk -F'|' '{
+        printf "  Input:        %d tokens\n", $1
+        printf "  Output:       %d tokens\n", $2
+        printf "  Cache create: %d tokens\n", $3
+        printf "  Cache read:   %d tokens\n", $4
+        printf "  Total:        %d tokens\n", $1+$2+$3+$4
+    }' "/tmp/ralph-loop-${FEATURE}.tokens"
     echo "=========================================="
 fi
 
+# Print session IDs
+if [ -f "/tmp/ralph-loop-${FEATURE}.sessions" ]; then
+    SESSION_COUNT=$(wc -l < "/tmp/ralph-loop-${FEATURE}.sessions" | tr -d ' ')
+    echo "Sessions: $SESSION_COUNT"
+    cat "/tmp/ralph-loop-${FEATURE}.sessions"
+fi
+
 echo "=========================================="
 echo "Ralph loop completed: $FEATURE"
 echo "=========================================="

package/dist/tui/app.d.ts

@@ -32,6 +32,17 @@ export interface InterviewAppProps {
     /** Optional scan result with detected tech stack */
     scanResult?: ScanResult;
 }
+/**
+ * Props for the run/monitor screen when launched directly from CLI
+ */
+export interface RunAppProps {
+    /** Name of the feature to run or monitor */
+    featureName: string;
+    /** If true, opens in monitor-only (read-only) mode — no loop is spawned */
+    monitorOnly?: boolean;
+    /** Review mode override */
+    reviewMode?: 'manual' | 'auto';
+}
 /**
  * Props for the main App component
  */
@@ -44,6 +55,8 @@ export interface AppProps {
     version?: string;
     /** Props for the interview screen (required when screen is 'interview') */
     interviewProps?: InterviewAppProps;
+    /** Props for the run/monitor screen (required when screen is 'run') */
+    runProps?: RunAppProps;
     /** Called when the screen completes successfully */
     onComplete?: (result: string) => void;
     /** Called when the user exits/cancels */
@@ -56,7 +69,7 @@ export interface AppProps {
  * and receives a shared headerElement prop.
  */
 export declare function App({ screen: initialScreen, initialSessionState, version, // Fallback if package.json read fails (keep in sync with index.ts)
-interviewProps, onComplete, onExit, }: AppProps): React.ReactElement | null;
+interviewProps, runProps, onComplete, onExit, }: AppProps): React.ReactElement | null;
 /**
  * Render options for renderApp
  */
@@ -69,6 +82,8 @@ export interface RenderAppOptions {
     version?: string;
     /** Props for interview screen (if starting directly on interview) */
     interviewProps?: InterviewAppProps;
+    /** Props for run/monitor screen (if starting directly on run screen) */
+    runProps?: RunAppProps;
     /** Called when spec generation completes */
     onComplete?: (result: string) => void;
     /** Called when user exits */

package/dist/tui/app.js

@@ -29,9 +29,17 @@ import { useBackgroundRuns } from './hooks/useBackgroundRuns.js';
  * and receives a shared headerElement prop.
  */
 export function App({ screen: initialScreen, initialSessionState, version = '0.12.1', // Fallback if package.json read fails (keep in sync with index.ts)
-interviewProps, onComplete, onExit, }) {
+interviewProps, runProps, onComplete, onExit, }) {
     const [currentScreen, setCurrentScreen] = useState(initialScreen);
-    const [screenProps, setScreenProps] = useState(interviewProps ? { featureName: interviewProps.featureName } : null);
+    const [screenProps, setScreenProps] = useState(() => {
+        if (initialScreen === 'run' && runProps) {
+            return { featureName: runProps.featureName, monitorOnly: runProps.monitorOnly, reviewMode: runProps.reviewMode };
+        }
+        if (interviewProps) {
+            return { featureName: interviewProps.featureName };
+        }
+        return null;
+    });
     const [sessionState, setSessionState] = useState(initialSessionState);
     // Background run tracking
     const { runs: backgroundRuns, background, dismiss } = useBackgroundRuns();
@@ -216,5 +224,5 @@ interviewProps, onComplete, onExit, }) {
  * Render the App component to the terminal
  */
 export function renderApp(options) {
-    return render(_jsx(App, { screen: options.screen, initialSessionState: options.initialSessionState, version: options.version, interviewProps: options.interviewProps, onComplete: options.onComplete, onExit: options.onExit }));
+    return render(_jsx(App, { screen: options.screen, initialSessionState: options.initialSessionState, version: options.version, interviewProps: options.interviewProps, runProps: options.runProps, onComplete: options.onComplete, onExit: options.onExit }));
 }

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

@@ -0,0 +1,18 @@
+/**
+ * ActivityFeed - Live activity feed for RunScreen
+ *
+ * Renders the last N activity events derived from the loop log and phase changes.
+ * Each row shows a relative timestamp, a status icon, and the event message.
+ * Color-coded by status: green (success), red/pink (error), yellow (in-progress).
+ */
+import React from 'react';
+import { type ActivityEvent } from '../utils/loop-status.js';
+export interface ActivityFeedProps {
+    /** Activity events to display (newest last) */
+    events: ActivityEvent[];
+    /** Maximum number of events to show (default: 10) */
+    maxEvents?: number;
+    /** Commit range string to display as footer (e.g., "b425c40 → 6efaf80") */
+    latestCommit?: string;
+}
+export declare function ActivityFeed({ events, maxEvents, latestCommit }: ActivityFeedProps): React.ReactElement;

package/dist/tui/components/ActivityFeed.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { colors, phase } from '../theme.js';
+import { formatRelativeTime } from '../utils/loop-status.js';
+const MAX_MESSAGE_LENGTH = 90;
+const STATUS_COLOR = {
+    success: colors.green,
+    error: colors.pink,
+    'in-progress': colors.yellow,
+};
+const STATUS_ICON = {
+    success: phase.complete, // ✓
+    error: phase.error, // ✗
+    'in-progress': phase.active, // ◐
+};
+function truncateMessage(message, maxLen) {
+    if (message.length <= maxLen)
+        return message;
+    return message.slice(0, maxLen - 1) + '\u2026';
+}
+export function ActivityFeed({ events, maxEvents = 10, latestCommit }) {
+    const visible = events.slice(-maxEvents);
+    if (visible.length === 0) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "No activity yet" }), latestCommit && _jsxs(Text, { dimColor: true, children: ["Commit: ", latestCommit] })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [visible.map((event, idx) => {
+                const color = STATUS_COLOR[event.status];
+                const icon = STATUS_ICON[event.status];
+                return (_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { dimColor: true, children: formatRelativeTime(event.timestamp) }), _jsx(Text, { color: color, children: icon }), _jsx(Text, { color: color, children: truncateMessage(event.message, MAX_MESSAGE_LENGTH) })] }, idx));
+            }), latestCommit && _jsxs(Text, { dimColor: true, children: ["Commit: ", latestCommit] })] }));
+}

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

@@ -5,7 +5,33 @@
  * commits, and PR/issue links after a feature loop completes.
  */
 import React from 'react';
-import type { RunSummary } from '../screens/RunScreen.js';
+import type { RunSummary, FileChangeStat } from '../screens/RunScreen.js';
+/**
+ * Formatted file change row for aligned display in the Changes section.
+ */
+export interface FormattedFileChange {
+    /** Path, possibly truncated with prefix ellipsis, padded to path column width */
+    displayPath: string;
+    /** Insertions string, e.g. "+10" or "+ 3", right-aligned within fixed width */
+    addedStr: string;
+    /** Deletions string, e.g. "-5" or "-18", right-aligned within fixed width */
+    removedStr: string;
+}
+/**
+ * Truncate a file path to fit within maxWidth characters.
+ * If the path exceeds maxWidth, truncates from the start and prefixes with '…'.
+ */
+export declare function truncatePath(path: string, maxWidth: number): string;
+/**
+ * Truncate text from the end to fit within maxWidth characters.
+ * Appends '…' if truncated.
+ */
+export declare function truncateEnd(text: string, maxWidth: number): string;
+/**
+ * Format a list of file change stats into fixed-width, aligned display rows.
+ * Stats columns are always fully visible; the path column shrinks to fill remaining space.
+ */
+export declare function formatChangesFiles(files: FileChangeStat[], contentWidth: number): FormattedFileChange[];
 /**
  * Props for RunCompletionSummary component
  */

package/dist/tui/components/RunCompletionSummary.js

@@ -1,7 +1,50 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Box, Text } from 'ink';
-import { SummaryBox, SummaryBoxSection } from './SummaryBox.js';
+import { Box, Text, useStdout } from 'ink';
+import { SummaryBox, SummaryBoxSection, MAX_BOX_WIDTH, BOX_BORDER_OVERHEAD } from './SummaryBox.js';
 import { colors, phase } from '../theme.js';
+import { formatNumber } from '../utils/loop-status.js';
+const MIN_BOX_WIDTH = 60;
+/**
+ * Truncate a file path to fit within maxWidth characters.
+ * If the path exceeds maxWidth, truncates from the start and prefixes with '…'.
+ */
+export function truncatePath(path, maxWidth) {
+    if (path.length <= maxWidth)
+        return path;
+    if (maxWidth <= 1)
+        return '…';
+    return '…' + path.slice(-(maxWidth - 1));
+}
+/**
+ * Truncate text from the end to fit within maxWidth characters.
+ * Appends '…' if truncated.
+ */
+export function truncateEnd(text, maxWidth) {
+    if (text.length <= maxWidth)
+        return text;
+    if (maxWidth <= 1)
+        return '…';
+    return text.slice(0, maxWidth - 1) + '…';
+}
+/**
+ * Format a list of file change stats into fixed-width, aligned display rows.
+ * Stats columns are always fully visible; the path column shrinks to fill remaining space.
+ */
+export function formatChangesFiles(files, contentWidth) {
+    if (files.length === 0)
+        return [];
+    const GAP = 2;
+    const maxAddedDigits = Math.max(...files.map((f) => String(f.added).length));
+    const maxRemovedDigits = Math.max(...files.map((f) => String(f.removed).length));
+    // statsBlockWidth: "+NNN -NNN"
+    const statsBlockWidth = (1 + maxAddedDigits) + 1 + (1 + maxRemovedDigits);
+    const pathColWidth = Math.max(1, contentWidth - GAP - statsBlockWidth);
+    return files.map((file) => ({
+        displayPath: truncatePath(file.path, pathColWidth).padEnd(pathColWidth),
+        addedStr: '+' + String(file.added).padStart(maxAddedDigits),
+        removedStr: '-' + String(file.removed).padStart(maxRemovedDigits),
+    }));
+}
 /**
  * Format milliseconds to human-readable duration (e.g., "12m 34s", "1h 15m 0s")
  */
@@ -26,6 +69,10 @@ function formatDurationMs(ms) {
  */
 const stoppedCodes = new Set([130, 143]);
 export function RunCompletionSummary({ summary, }) {
+    const { stdout } = useStdout();
+    const terminalWidth = stdout?.columns ?? 80;
+    const boxWidth = Math.min(Math.max(MIN_BOX_WIDTH, terminalWidth), MAX_BOX_WIDTH);
+    const contentWidth = boxWidth - BOX_BORDER_OVERHEAD;
     // Determine final status and color
     const exitStatus = summary.exitCode === 0
         ? { label: 'Complete', color: colors.green }
@@ -48,11 +95,29 @@ export function RunCompletionSummary({ summary, }) {
     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 :
+    // Status icon for subtitle
+    const statusIcon = summary.exitCode === 0
+        ? phase.complete
+        : stoppedCodes.has(summary.exitCode) ? phase.active : phase.error;
+    // Total tokens across all categories
+    const totalTokens = summary.tokensInput + summary.tokensOutput + summary.cacheCreate + summary.cacheRead;
+    // Build compact subtitle parts
+    const subtitleParts = [];
+    if (summary.totalDurationMs !== undefined) {
+        subtitleParts.push(formatDurationMs(summary.totalDurationMs));
+    }
+    subtitleParts.push(`${iterationsTotal} iter`);
+    if (tasksCompleted !== null && tasksTotal !== null) {
+        subtitleParts.push(`${tasksCompleted}/${tasksTotal} tasks`);
+    }
+    if (totalTokens > 0) {
+        subtitleParts.push(`${formatNumber(totalTokens)} tokens`);
+    }
+    return (_jsxs(SummaryBox, { minWidth: 60, children: [_jsx(Text, { bold: true, children: summary.feature }), _jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsxs(Text, { bold: true, color: exitStatus.color, children: [statusIcon, " ", exitStatus.label] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: subtitleParts.join(' · ') })] }), _jsxs(SummaryBoxSection, { children: [_jsx(Text, { bold: true, children: "Phases" }), summary.phases && summary.phases.length > 0 ? (summary.phases.map((phaseInfo) => {
+                        const phaseIcon = phaseInfo.status === 'success' ? phase.complete :
                             phaseInfo.status === 'failed' ? phase.error :
                                 phase.pending;
-                        const statusColor = phaseInfo.status === 'success' ? colors.green :
+                        const phaseColor = phaseInfo.status === 'success' ? colors.green :
                             phaseInfo.status === 'failed' ? colors.pink :
                                 colors.gray;
                         const durationText = phaseInfo.durationMs !== undefined
@@ -63,6 +128,31 @@ export function RunCompletionSummary({ summary, }) {
                             : '';
                         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" }))] })] }));
+                        return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: phaseColor, children: [phaseIcon, " "] }), _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 ? (_jsxs(Text, { children: [summary.changes.totalFilesChanged, " file", summary.changes.totalFilesChanged !== 1 ? 's' : '', " changed"] })) : !summary.changes.files ? (_jsx(Text, { children: "Changes: Could not compute diff" })) : null, (() => {
+                        const files = summary.changes?.available ? summary.changes.files : undefined;
+                        if (!files || files.length === 0)
+                            return null;
+                        return formatChangesFiles(files, contentWidth).map((fmt, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { children: fmt.displayPath }), _jsx(Text, { children: '  ' }), _jsx(Text, { color: colors.green, children: fmt.addedStr }), _jsx(Text, { children: " " }), _jsx(Text, { color: colors.pink, children: fmt.removedStr })] }, files[i].path)));
+                    })(), (() => {
+                        if (!summary.commits || !summary.commits.available) {
+                            return _jsx(Text, { children: "Commit: Not available" });
+                        }
+                        if (summary.commits.commitList && summary.commits.commitList.length > 0) {
+                            // hash (7) + space (1) = 8 chars reserved for prefix
+                            const titleMaxWidth = contentWidth - 8;
+                            return [
+                                _jsx(Text, { children: ' ' }, "commit-spacer"),
+                                _jsx(Text, { bold: true, children: "Commits" }, "commit-label"),
+                                ...summary.commits.commitList.map((commit) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: commit.hash }), _jsxs(Text, { children: [" ", truncateEnd(commit.title, titleMaxWidth)] })] }, commit.hash))),
+                            ];
+                        }
+                        if (summary.commits.fromHash && summary.commits.toHash) {
+                            return (_jsxs(Text, { children: ["Commit: ", summary.commits.fromHash, " \u2192 ", summary.commits.toHash, summary.commits.mergeType === 'squash' && ' (squash-merged)', summary.commits.mergeType === 'normal' && ' (merged)'] }));
+                        }
+                        if (summary.commits.toHash) {
+                            return _jsxs(Text, { children: ["Commit: ", summary.commits.toHash] });
+                        }
+                        return _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" }))] })] }));
 }