wiggum-cli 0.13.1 → 0.14.0

package/dist/tui/utils/pr-summary.js

@@ -0,0 +1,84 @@
+/**
+ * PR and Issue utilities for enhanced run summary.
+ */
+import { execFileSync } from 'node:child_process';
+import { logger } from '../../utils/logger.js';
+/**
+ * Get PR information for a branch.
+ *
+ * @param projectRoot - Root directory of the git repository
+ * @param branchName - Branch name to look up
+ * @returns PR info object, or null if no PR exists for this branch
+ * @throws When gh CLI is unavailable or the command fails
+ */
+export function getPrForBranch(projectRoot, branchName) {
+    // Use gh pr list to find PR for this branch
+    const output = execFileSync('gh', ['pr', 'list', '--head', branchName, '--state', 'all', '--json', 'number,url,state,title', '--limit', '1'], {
+        cwd: projectRoot,
+        encoding: 'utf-8',
+        timeout: 10_000,
+    }).trim();
+    if (!output) {
+        return null;
+    }
+    const prs = JSON.parse(output);
+    if (!Array.isArray(prs) || prs.length === 0) {
+        return null;
+    }
+    const pr = prs[0];
+    return {
+        number: pr.number,
+        url: pr.url,
+        state: pr.state,
+        title: pr.title,
+    };
+}
+/**
+ * Get linked issue for a branch by parsing the PR body for closing keywords
+ * (Closes/Fixes/Resolves #N).
+ *
+ * @param projectRoot - Root directory of the git repository
+ * @param branchName - Branch name to look up
+ * @param prInfo - Optional pre-fetched PR info to avoid redundant gh call
+ * @returns Issue info object, or null if not found or gh not available
+ */
+export function getLinkedIssue(projectRoot, branchName, prInfo) {
+    try {
+        // Use provided PR info or fetch it
+        const pr = prInfo !== undefined ? prInfo : getPrForBranch(projectRoot, branchName);
+        if (!pr) {
+            return null;
+        }
+        // Get the PR body to look for issue references
+        const prBody = execFileSync('gh', ['pr', 'view', String(pr.number), '--json', 'body'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 10_000,
+        }).trim();
+        const prData = JSON.parse(prBody);
+        const body = prData.body || '';
+        // Look for issue references in PR body (e.g., "Closes #123", "Fixes #456")
+        const issueMatch = body.match(/(?:closes|fixes|resolves)\s+#(\d+)/i);
+        if (!issueMatch) {
+            return null;
+        }
+        const issueNumber = parseInt(issueMatch[1], 10);
+        // Fetch the issue details
+        const issueOutput = execFileSync('gh', ['issue', 'view', String(issueNumber), '--json', 'number,url,state,title'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 10_000,
+        }).trim();
+        const issue = JSON.parse(issueOutput);
+        return {
+            number: issue.number,
+            url: issue.url,
+            state: issue.state,
+            title: issue.title,
+        };
+    }
+    catch (err) {
+        logger.warn(`getLinkedIssue failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}

package/dist/utils/summary-file.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Summary File Writer
+ * Persists enhanced run summaries to JSON files for later retrieval
+ */
+import type { RunSummary } from '../tui/screens/RunScreen.js';
+/**
+ * Write enhanced run summary to a JSON file in the temp directory
+ *
+ * @param featureName - The feature name used to construct the file path
+ * @param summary - The complete RunSummary object to persist
+ * @returns Promise that resolves when the file is written, or rejects on error
+ *
+ * Uses RALPH_SUMMARY_TMP_DIR environment variable if set, otherwise os.tmpdir().
+ *
+ * @example
+ * ```ts
+ * await writeRunSummaryFile('my-feature', {
+ *   feature: 'my-feature',
+ *   exitCode: 0,
+ *   // ... other RunSummary fields
+ * });
+ * // Writes to: <tmpdir>/ralph-loop-my-feature.summary.json
+ * ```
+ */
+export declare function writeRunSummaryFile(featureName: string, summary: RunSummary): Promise<void>;

package/dist/utils/summary-file.js

@@ -0,0 +1,37 @@
+/**
+ * Summary File Writer
+ * Persists enhanced run summaries to JSON files for later retrieval
+ */
+import { writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { logger } from './logger.js';
+/**
+ * Write enhanced run summary to a JSON file in the temp directory
+ *
+ * @param featureName - The feature name used to construct the file path
+ * @param summary - The complete RunSummary object to persist
+ * @returns Promise that resolves when the file is written, or rejects on error
+ *
+ * Uses RALPH_SUMMARY_TMP_DIR environment variable if set, otherwise os.tmpdir().
+ *
+ * @example
+ * ```ts
+ * await writeRunSummaryFile('my-feature', {
+ *   feature: 'my-feature',
+ *   exitCode: 0,
+ *   // ... other RunSummary fields
+ * });
+ * // Writes to: <tmpdir>/ralph-loop-my-feature.summary.json
+ * ```
+ */
+export async function writeRunSummaryFile(featureName, summary) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(featureName)) {
+        throw new Error(`Invalid feature name: "${featureName}"`);
+    }
+    const dir = process.env.RALPH_SUMMARY_TMP_DIR ?? tmpdir();
+    const filePath = join(dir, `ralph-loop-${featureName}.summary.json`);
+    const jsonContent = JSON.stringify(summary, null, 2);
+    await writeFile(filePath, jsonContent, 'utf8');
+    logger.debug(`Summary written to ${filePath}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",

package/src/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