bmalph 2.4.0 → 2.6.0

package/dist/watch/state-reader.js

@@ -0,0 +1,200 @@
+import { join } from "node:path";
+import { open, readFile } from "node:fs/promises";
+import { readJsonFile } from "../utils/json.js";
+import { RALPH_DIR } from "../utils/constants.js";
+import { parseFixPlan } from "../transition/fix-plan.js";
+import { debug } from "../utils/logger.js";
+import { formatError } from "../utils/errors.js";
+import { validateCircuitBreakerState, validateRalphSession, normalizeRalphStatus, } from "../utils/validate.js";
+const LOG_LINE_PATTERN = /^\[(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\] \[(\w+)\] (.+)$/;
+const DEFAULT_MAX_LOG_LINES = 8;
+const TAIL_BYTES = 4096;
+export async function readDashboardState(projectDir) {
+    const [loop, circuitBreaker, stories, analysis, execution, session, recentLogs] = await Promise.all([
+        readLoopInfo(projectDir),
+        readCircuitBreakerInfo(projectDir),
+        readStoryProgress(projectDir),
+        readAnalysisInfo(projectDir),
+        readExecutionProgress(projectDir),
+        readSessionInfo(projectDir),
+        readRecentLogs(projectDir),
+    ]);
+    const ralphCompleted = loop !== null && loop.status === "completed";
+    return {
+        loop,
+        circuitBreaker,
+        stories,
+        analysis,
+        execution,
+        session,
+        recentLogs,
+        ralphCompleted,
+        lastUpdated: new Date(),
+    };
+}
+export async function readLoopInfo(projectDir) {
+    try {
+        const data = await readJsonFile(join(projectDir, RALPH_DIR, "status.json"));
+        if (data === null)
+            return null;
+        const normalized = normalizeRalphStatus(data);
+        const lastAction = typeof data.last_action === "string" ? data.last_action : "";
+        const callsMadeThisHour = typeof data.calls_made_this_hour === "number" ? data.calls_made_this_hour : 0;
+        const maxCallsPerHour = typeof data.max_calls_per_hour === "number" ? data.max_calls_per_hour : 0;
+        return {
+            loopCount: normalized.loopCount,
+            status: normalized.status,
+            lastAction,
+            callsMadeThisHour,
+            maxCallsPerHour,
+        };
+    }
+    catch (err) {
+        debug(`Failed to read loop info: ${formatError(err)}`);
+        return null;
+    }
+}
+export async function readCircuitBreakerInfo(projectDir) {
+    try {
+        const data = await readJsonFile(join(projectDir, RALPH_DIR, ".circuit_breaker_state"));
+        if (data === null)
+            return null;
+        const validated = validateCircuitBreakerState(data);
+        const totalOpens = typeof data.total_opens === "number" ? data.total_opens : 0;
+        return {
+            state: validated.state,
+            consecutiveNoProgress: validated.consecutive_no_progress,
+            totalOpens,
+            reason: validated.reason,
+        };
+    }
+    catch (err) {
+        debug(`Failed to read circuit breaker info: ${formatError(err)}`);
+        return null;
+    }
+}
+export async function readStoryProgress(projectDir) {
+    let content;
+    try {
+        content = await readFile(join(projectDir, RALPH_DIR, "@fix_plan.md"), "utf-8");
+    }
+    catch (err) {
+        debug(`Failed to read fix plan: ${formatError(err)}`);
+        return null;
+    }
+    const items = parseFixPlan(content);
+    const completed = items.filter((item) => item.completed).length;
+    const total = items.length;
+    const nextItem = items.find((item) => !item.completed);
+    const nextStory = nextItem ? `Story ${nextItem.id}: ${nextItem.title ?? ""}`.trim() : null;
+    return { completed, total, nextStory };
+}
+export async function readAnalysisInfo(projectDir) {
+    try {
+        const data = await readJsonFile(join(projectDir, RALPH_DIR, ".response_analysis"));
+        if (data === null)
+            return null;
+        const analysis = data.analysis;
+        if (typeof analysis !== "object" || analysis === null)
+            return null;
+        const a = analysis;
+        const filesModified = typeof a.files_modified === "number" ? a.files_modified : 0;
+        const confidenceScore = typeof a.confidence_score === "number" ? a.confidence_score : 0;
+        const isTestOnly = typeof a.is_test_only === "boolean" ? a.is_test_only : false;
+        const isStuck = typeof a.is_stuck === "boolean" ? a.is_stuck : false;
+        const exitSignal = typeof a.exit_signal === "boolean" ? a.exit_signal : false;
+        const hasPermissionDenials = typeof a.has_permission_denials === "boolean" ? a.has_permission_denials : false;
+        const permissionDenialCount = typeof a.permission_denial_count === "number" ? a.permission_denial_count : 0;
+        return {
+            filesModified,
+            confidenceScore,
+            isTestOnly,
+            isStuck,
+            exitSignal,
+            hasPermissionDenials,
+            permissionDenialCount,
+        };
+    }
+    catch (err) {
+        debug(`Failed to read analysis info: ${formatError(err)}`);
+        return null;
+    }
+}
+export async function readExecutionProgress(projectDir) {
+    try {
+        const data = await readJsonFile(join(projectDir, RALPH_DIR, "progress.json"));
+        if (data === null)
+            return null;
+        const status = typeof data.status === "string" ? data.status : "";
+        if (status !== "executing")
+            return null;
+        const elapsedSeconds = typeof data.elapsed_seconds === "number" ? data.elapsed_seconds : 0;
+        return { status, elapsedSeconds };
+    }
+    catch (err) {
+        debug(`Failed to read execution progress: ${formatError(err)}`);
+        return null;
+    }
+}
+export async function readSessionInfo(projectDir) {
+    try {
+        const data = await readJsonFile(join(projectDir, RALPH_DIR, ".ralph_session"));
+        if (data === null)
+            return null;
+        const validated = validateRalphSession(data);
+        return {
+            createdAt: validated.created_at,
+            lastUsed: validated.last_used,
+        };
+    }
+    catch (err) {
+        debug(`Failed to read session info: ${formatError(err)}`);
+        return null;
+    }
+}
+export async function readRecentLogs(projectDir, maxLines = DEFAULT_MAX_LOG_LINES) {
+    const logPath = join(projectDir, RALPH_DIR, "logs", "ralph.log");
+    let content;
+    try {
+        const fh = await open(logPath, "r");
+        try {
+            const stats = await fh.stat();
+            if (stats.size === 0) {
+                return [];
+            }
+            if (stats.size <= TAIL_BYTES) {
+                content = await fh.readFile("utf-8");
+            }
+            else {
+                const position = stats.size - TAIL_BYTES;
+                const buf = Buffer.alloc(TAIL_BYTES);
+                const { bytesRead } = await fh.read(buf, 0, TAIL_BYTES, position);
+                const raw = buf.toString("utf-8", 0, bytesRead);
+                const newlineIdx = raw.indexOf("\n");
+                content = newlineIdx >= 0 ? raw.slice(newlineIdx + 1) : raw;
+            }
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    catch (err) {
+        debug(`Failed to read recent logs: ${formatError(err)}`);
+        return [];
+    }
+    const lines = content.split(/\r?\n/).filter((line) => line.length > 0);
+    const tail = lines.slice(-maxLines);
+    const entries = [];
+    for (const line of tail) {
+        const match = LOG_LINE_PATTERN.exec(line);
+        if (match) {
+            entries.push({
+                timestamp: match[1],
+                level: match[2],
+                message: match[3],
+            });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=state-reader.js.map

package/dist/watch/state-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-reader.js","sourceRoot":"","sources":["../../src/watch/state-reader.ts"],"names":[],"mappings":"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"}

package/dist/watch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/watch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/watch/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,24 +1,23 @@
 {
   "name": "bmalph",
-  "version": "2.4.0",
-  "description": "Unified AI Development Framework - BMAD phases with Ralph execution loop for Claude Code",
+  "version": "2.6.0",
+  "description": "Unified AI Development Framework - BMAD phases with Ralph execution loop",
   "type": "module",
   "bin": {
     "bmalph": "./bin/bmalph.js"
   },
   "scripts": {
-    "prepare": "tsc",
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "vitest run --config vitest.config.e2e.ts",
     "test:coverage": "vitest run --coverage",
-    "test:all": "npm run test && npm run test:e2e",
+    "test:bash": "bash -c 'command -v bats &>/dev/null && bats tests/bash/*.bats tests/bash/drivers/*.bats || echo \"[skip] bats not installed\"'",
+    "test:all": "npm run test && npm run test:e2e && npm run test:bash",
     "check": "npm run lint && npm run build && npm test",
     "dev": "tsc --watch",
     "lint": "eslint src tests",
     "lint:fix": "eslint src tests --fix",
-    "format": "prettier --write .",
     "fmt:check": "prettier --check .",
     "fmt:fix": "prettier --write .",
     "type-check": "tsc --noEmit",
@@ -31,7 +30,11 @@
     "ai",
     "development",
     "framework",
-    "agents"
+    "agents",
+    "bmad",
+    "ralph",
+    "autonomous",
+    "coding-assistant"
   ],
   "author": "Lars Cowe",
   "license": "MIT",
@@ -58,9 +61,9 @@
     "bundled-versions.json"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
     "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "inquirer": "^13.2.1"
+    "commander": "^14.0.2"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/ralph/drivers/copilot.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# GitHub Copilot CLI driver for Ralph (EXPERIMENTAL)
+# Provides platform-specific CLI invocation logic for Copilot CLI.
+#
+# Known limitations:
+# - No session continuity (session IDs not capturable from -p output)
+# - No structured output (plain text only, no --json flag)
+# - Coarse tool permissions (only shell, shell(git:*), shell(npm:*), write)
+# - CLI is new (GA Feb 25, 2026) — scripting interface may change
+
+driver_name() {
+    echo "copilot"
+}
+
+driver_display_name() {
+    echo "GitHub Copilot CLI"
+}
+
+driver_cli_binary() {
+    echo "copilot"
+}
+
+driver_min_version() {
+    echo "0.0.418"
+}
+
+driver_check_available() {
+    command -v "$(driver_cli_binary)" &>/dev/null
+}
+
+# Copilot CLI tool names
+driver_valid_tools() {
+    VALID_TOOL_PATTERNS=(
+        "shell"
+        "shell(git:*)"
+        "shell(npm:*)"
+        "write"
+    )
+}
+
+# Build Copilot CLI command
+# Context is prepended to the prompt (same pattern as Codex driver).
+# Uses --autopilot --yolo for autonomous mode, -s to strip stats, -p for prompt.
+driver_build_command() {
+    local prompt_file=$1
+    local loop_context=$2
+    # $3 (session_id) is intentionally ignored — Copilot CLI does not
+    # expose session IDs in -p output, so resume is not possible.
+
+    CLAUDE_CMD_ARGS=("$(driver_cli_binary)")
+
+    if [[ ! -f "$prompt_file" ]]; then
+        echo "ERROR: Prompt file not found: $prompt_file" >&2
+        return 1
+    fi
+
+    # Autonomous execution flags
+    CLAUDE_CMD_ARGS+=("--autopilot" "--yolo")
+
+    # Limit auto-continuation loops
+    CLAUDE_CMD_ARGS+=("--max-autopilot-continues" "50")
+
+    # Disable interactive prompts
+    CLAUDE_CMD_ARGS+=("--no-ask-user")
+
+    # Strip stats for cleaner output
+    CLAUDE_CMD_ARGS+=("-s")
+
+    # Build prompt with context prepended
+    local prompt_content
+    prompt_content=$(cat "$prompt_file")
+    if [[ -n "$loop_context" ]]; then
+        prompt_content="$loop_context
+
+$prompt_content"
+    fi
+
+    CLAUDE_CMD_ARGS+=("-p" "$prompt_content")
+}
+
+driver_supports_sessions() {
+    return 1  # false — session IDs not capturable from -p output
+}
+
+# Copilot CLI outputs plain text only (no JSON streaming).
+# Passthrough filter — no transformation needed.
+driver_stream_filter() {
+    echo '.'
+}

package/ralph/lib/circuit_breaker.sh

@@ -43,18 +43,19 @@ init_circuit_breaker() {
     fi
 
     if [[ ! -f "$CB_STATE_FILE" ]]; then
-        cat > "$CB_STATE_FILE" << EOF
-{
-    "state": "$CB_STATE_CLOSED",
-    "last_change": "$(get_iso_timestamp)",
-    "consecutive_no_progress": 0,
-    "consecutive_same_error": 0,
-    "consecutive_permission_denials": 0,
-    "last_progress_loop": 0,
-    "total_opens": 0,
-    "reason": ""
-}
-EOF
+        jq -n \
+            --arg state "$CB_STATE_CLOSED" \
+            --arg last_change "$(get_iso_timestamp)" \
+            '{
+                state: $state,
+                last_change: $last_change,
+                consecutive_no_progress: 0,
+                consecutive_same_error: 0,
+                consecutive_permission_denials: 0,
+                last_progress_loop: 0,
+                total_opens: 0,
+                reason: ""
+            }' > "$CB_STATE_FILE"
     fi
 
     # Ensure history file exists before any transition logging
@@ -81,18 +82,20 @@ EOF
             total_opens=$(jq -r '.total_opens // 0' "$CB_STATE_FILE" 2>/dev/null || echo "0")
             log_circuit_transition "$CB_STATE_OPEN" "$CB_STATE_CLOSED" "Auto-reset on startup (CB_AUTO_RESET=true)" "$current_loop"
 
-            cat > "$CB_STATE_FILE" << EOF
-{
-    "state": "$CB_STATE_CLOSED",
-    "last_change": "$(get_iso_timestamp)",
-    "consecutive_no_progress": 0,
-    "consecutive_same_error": 0,
-    "consecutive_permission_denials": 0,
-    "last_progress_loop": 0,
-    "total_opens": $total_opens,
-    "reason": "Auto-reset on startup"
-}
-EOF
+            jq -n \
+                --arg state "$CB_STATE_CLOSED" \
+                --arg last_change "$(get_iso_timestamp)" \
+                --argjson total_opens "$total_opens" \
+                '{
+                    state: $state,
+                    last_change: $last_change,
+                    consecutive_no_progress: 0,
+                    consecutive_same_error: 0,
+                    consecutive_permission_denials: 0,
+                    last_progress_loop: 0,
+                    total_opens: $total_opens,
+                    reason: "Auto-reset on startup"
+                }' > "$CB_STATE_FILE"
         else
             # Cooldown: check if enough time has elapsed to transition to HALF_OPEN
             local opened_at
@@ -296,20 +299,34 @@ record_loop_result() {
         opened_at=$(echo "$state_data" | jq -r '.opened_at // .last_change // ""' 2>/dev/null)
     fi
 
-    cat > "$CB_STATE_FILE" << EOF
-{
-    "state": "$new_state",
-    "last_change": "$(get_iso_timestamp)",
-    "consecutive_no_progress": $consecutive_no_progress,
-    "consecutive_same_error": $consecutive_same_error,
-    "consecutive_permission_denials": $consecutive_permission_denials,
-    "last_progress_loop": $last_progress_loop,
-    "total_opens": $total_opens,
-    "reason": "$reason",
-    "current_loop": $loop_number$(if [[ -n "$opened_at" ]]; then echo ",
-    \"opened_at\": \"$opened_at\""; fi)
-}
-EOF
+    jq -n \
+        --arg state "$new_state" \
+        --arg last_change "$(get_iso_timestamp)" \
+        --argjson consecutive_no_progress "$consecutive_no_progress" \
+        --argjson consecutive_same_error "$consecutive_same_error" \
+        --argjson consecutive_permission_denials "$consecutive_permission_denials" \
+        --argjson last_progress_loop "$last_progress_loop" \
+        --argjson total_opens "$total_opens" \
+        --arg reason "$reason" \
+        --argjson current_loop "$loop_number" \
+        '{
+            state: $state,
+            last_change: $last_change,
+            consecutive_no_progress: $consecutive_no_progress,
+            consecutive_same_error: $consecutive_same_error,
+            consecutive_permission_denials: $consecutive_permission_denials,
+            last_progress_loop: $last_progress_loop,
+            total_opens: $total_opens,
+            reason: $reason,
+            current_loop: $current_loop
+        }' > "$CB_STATE_FILE"
+
+    # Add opened_at if set (entering or staying in OPEN state)
+    if [[ -n "$opened_at" ]]; then
+        local tmp
+        tmp=$(jq --arg opened_at "$opened_at" '. + {opened_at: $opened_at}' "$CB_STATE_FILE")
+        echo "$tmp" > "$CB_STATE_FILE"
+    fi
 
     # Log state transition
     if [[ "$new_state" != "$current_state" ]]; then
@@ -331,15 +348,23 @@ log_circuit_transition() {
     local reason=$3
     local loop_number=$4
 
-    local history=$(cat "$CB_HISTORY_FILE")
-    local transition="{
-        \"timestamp\": \"$(get_iso_timestamp)\",
-        \"loop\": $loop_number,
-        \"from_state\": \"$from_state\",
-        \"to_state\": \"$to_state\",
-        \"reason\": \"$reason\"
-    }"
-
+    local transition
+    transition=$(jq -n -c \
+        --arg timestamp "$(get_iso_timestamp)" \
+        --argjson loop "$loop_number" \
+        --arg from_state "$from_state" \
+        --arg to_state "$to_state" \
+        --arg reason "$reason" \
+        '{
+            timestamp: $timestamp,
+            loop: $loop,
+            from_state: $from_state,
+            to_state: $to_state,
+            reason: $reason
+        }')
+
+    local history
+    history=$(cat "$CB_HISTORY_FILE")
     history=$(echo "$history" | jq ". += [$transition]")
     echo "$history" > "$CB_HISTORY_FILE"
 
@@ -406,18 +431,20 @@ show_circuit_status() {
 reset_circuit_breaker() {
     local reason=${1:-"Manual reset"}
 
-    cat > "$CB_STATE_FILE" << EOF
-{
-    "state": "$CB_STATE_CLOSED",
-    "last_change": "$(get_iso_timestamp)",
-    "consecutive_no_progress": 0,
-    "consecutive_same_error": 0,
-    "consecutive_permission_denials": 0,
-    "last_progress_loop": 0,
-    "total_opens": 0,
-    "reason": "$reason"
-}
-EOF
+    jq -n \
+        --arg state "$CB_STATE_CLOSED" \
+        --arg last_change "$(get_iso_timestamp)" \
+        --arg reason "$reason" \
+        '{
+            state: $state,
+            last_change: $last_change,
+            consecutive_no_progress: 0,
+            consecutive_same_error: 0,
+            consecutive_permission_denials: 0,
+            last_progress_loop: 0,
+            total_opens: 0,
+            reason: $reason
+        }' > "$CB_STATE_FILE"
 
     echo -e "${GREEN}✅ Circuit breaker reset to CLOSED state${NC}"
 }

package/ralph/lib/enable_core.sh

@@ -328,10 +328,9 @@ detect_project_context() {
             DETECTED_TEST_CMD="pnpm test"
             DETECTED_RUN_CMD="pnpm start"
         fi
-    fi
 
     # Detect from pyproject.toml or setup.py (Python)
-    if [[ -f "pyproject.toml" ]] || [[ -f "setup.py" ]]; then
+    elif [[ -f "pyproject.toml" ]] || [[ -f "setup.py" ]]; then
         DETECTED_PROJECT_TYPE="python"
 
         # Extract project name from pyproject.toml
@@ -358,19 +357,17 @@ detect_project_context() {
             DETECTED_TEST_CMD="pytest"
             DETECTED_RUN_CMD="python -m ${DETECTED_PROJECT_NAME:-main}"
         fi
-    fi
 
     # Detect from Cargo.toml (Rust)
-    if [[ -f "Cargo.toml" ]]; then
+    elif [[ -f "Cargo.toml" ]]; then
         DETECTED_PROJECT_TYPE="rust"
         DETECTED_PROJECT_NAME=$(grep -m1 '^name' Cargo.toml | sed 's/.*= *"\([^"]*\)".*/\1/' 2>/dev/null)
         DETECTED_BUILD_CMD="cargo build"
         DETECTED_TEST_CMD="cargo test"
         DETECTED_RUN_CMD="cargo run"
-    fi
 
     # Detect from go.mod (Go)
-    if [[ -f "go.mod" ]]; then
+    elif [[ -f "go.mod" ]]; then
         DETECTED_PROJECT_TYPE="go"
         DETECTED_PROJECT_NAME=$(head -1 go.mod | sed 's/module //' 2>/dev/null)
         DETECTED_BUILD_CMD="go build"

package/ralph/lib/response_analyzer.sh

@@ -829,37 +829,13 @@ should_resume_session() {
     fi
 
     # Calculate session age using date utilities
-    local now=$(get_epoch_seconds)
+    local now
+    now=$(get_epoch_seconds)
     local session_time
+    session_time=$(parse_iso_to_epoch "$timestamp")
 
-    # Parse ISO timestamp to epoch - try multiple formats for cross-platform compatibility
-    # Strip milliseconds if present (e.g., 2026-01-09T10:30:00.123+00:00 → 2026-01-09T10:30:00+00:00)
-    local clean_timestamp="${timestamp}"
-    if [[ "$timestamp" =~ \.[0-9]+[+-Z] ]]; then
-        clean_timestamp=$(echo "$timestamp" | sed 's/\.[0-9]*\([+-Z]\)/\1/')
-    fi
-
-    if command -v gdate &>/dev/null; then
-        # macOS with coreutils
-        session_time=$(gdate -d "$clean_timestamp" +%s 2>/dev/null)
-    elif date --version 2>&1 | grep -q GNU; then
-        # GNU date (Linux)
-        session_time=$(date -d "$clean_timestamp" +%s 2>/dev/null)
-    else
-        # BSD date (macOS without coreutils) - try parsing ISO format
-        # Format: 2026-01-09T10:30:00+00:00 or 2026-01-09T10:30:00Z
-        # Strip timezone suffix for BSD date parsing
-        local date_only="${clean_timestamp%[+-Z]*}"
-        session_time=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$date_only" +%s 2>/dev/null)
-    fi
-
-    # If we couldn't parse the timestamp, consider session expired
-    if [[ -z "$session_time" || ! "$session_time" =~ ^[0-9]+$ ]]; then
-        echo "false"
-        return 1
-    fi
-
-    # Calculate age in seconds
+    # If parse_iso_to_epoch fell back to current epoch, session_time ≈ now → age ≈ 0.
+    # That's a safe default: treat unparseable timestamps as fresh rather than expired.
     local age=$((now - session_time))
 
     # Check if session is still valid (less than expiration time)