bmalph 2.7.2 → 2.7.3

package/ralph/drivers/cursor.sh

@@ -16,7 +16,15 @@ driver_display_name() {
 }
 
 driver_cli_binary() {
-    echo "agent"
+    local binary
+    binary=$(driver_resolve_cli_binary)
+
+    if [[ -n "$binary" ]]; then
+        echo "$binary"
+        return 0
+    fi
+
+    echo "cursor-agent"
 }
 
 driver_min_version() {
@@ -24,7 +32,14 @@ driver_min_version() {
 }
 
 driver_check_available() {
-    command -v "$(driver_cli_binary)" &>/dev/null
+    local cli_binary
+    cli_binary=$(driver_cli_binary)
+
+    if [[ -f "$cli_binary" ]]; then
+        return 0
+    fi
+
+    command -v "$cli_binary" &>/dev/null
 }
 
 # Cursor CLI tool names
@@ -46,14 +61,21 @@ driver_build_command() {
     local prompt_file=$1
     local loop_context=$2
     local session_id=$3
-
-    CLAUDE_CMD_ARGS=("$(driver_cli_binary)")
+    local cli_binary
+    cli_binary=$(driver_cli_binary)
 
     if [[ ! -f "$prompt_file" ]]; then
         echo "ERROR: Prompt file not found: $prompt_file" >&2
         return 1
     fi
 
+    CLAUDE_CMD_ARGS=()
+    if [[ "$cli_binary" == *.cmd ]]; then
+        CLAUDE_CMD_ARGS+=("$(driver_wrapper_path)" "$cli_binary")
+    else
+        CLAUDE_CMD_ARGS+=("$cli_binary")
+    fi
+
     # Headless mode
     CLAUDE_CMD_ARGS+=("--print")
 
@@ -70,11 +92,15 @@ driver_build_command() {
 
     # Build prompt with context prepended
     local prompt_content
-    prompt_content=$(cat "$prompt_file")
-    if [[ -n "$loop_context" ]]; then
-        prompt_content="$loop_context
+    if driver_running_on_windows; then
+        prompt_content=$(driver_build_windows_bootstrap_prompt "$loop_context" "$prompt_file")
+    else
+        prompt_content=$(cat "$prompt_file")
+        if [[ -n "$loop_context" ]]; then
+            prompt_content="$loop_context
 
 $prompt_content"
+        fi
     fi
 
     CLAUDE_CMD_ARGS+=("$prompt_content")
@@ -88,3 +114,138 @@ driver_supports_sessions() {
 driver_stream_filter() {
     echo 'select(.type == "text") | .content // empty'
 }
+
+driver_running_on_windows() {
+    [[ "${OS:-}" == "Windows_NT" || "${OSTYPE:-}" == msys* || "${OSTYPE:-}" == cygwin* || "${OSTYPE:-}" == win32* ]]
+}
+
+driver_resolve_cli_binary() {
+    local candidate
+    local resolved
+    local fallback
+    local candidates=(
+        "cursor-agent"
+        "cursor-agent.cmd"
+        "agent"
+        "agent.cmd"
+    )
+
+    for candidate in "${candidates[@]}"; do
+        resolved=$(driver_lookup_cli_candidate "$candidate")
+        if [[ -n "$resolved" ]]; then
+            echo "$resolved"
+            return 0
+        fi
+    done
+
+    fallback=$(driver_localappdata_cli_binary)
+    if [[ -n "$fallback" ]]; then
+        echo "$fallback"
+        return 0
+    fi
+
+    echo ""
+}
+
+driver_lookup_cli_candidate() {
+    local candidate=$1
+    local resolved
+
+    resolved=$(command -v "$candidate" 2>/dev/null || true)
+    if [[ -n "$resolved" ]]; then
+        echo "$resolved"
+        return 0
+    fi
+
+    if ! driver_running_on_windows; then
+        return 0
+    fi
+
+    driver_find_windows_path_candidate "$candidate"
+}
+
+driver_find_windows_path_candidate() {
+    local candidate=$1
+    local path_entry
+    local normalized_entry
+    local resolved_candidate
+    local path_entries="${PATH:-}"
+    local -a path_parts=()
+
+    if [[ "$path_entries" == *";"* ]]; then
+        IFS=';' read -r -a path_parts <<< "$path_entries"
+    else
+        IFS=':' read -r -a path_parts <<< "$path_entries"
+    fi
+
+    for path_entry in "${path_parts[@]}"; do
+        [[ -z "$path_entry" ]] && continue
+
+        normalized_entry=$path_entry
+        if command -v cygpath &>/dev/null && [[ "$normalized_entry" =~ ^[A-Za-z]:\\ ]]; then
+            normalized_entry=$(cygpath -u "$normalized_entry")
+        fi
+
+        resolved_candidate="$normalized_entry/$candidate"
+        if [[ -f "$resolved_candidate" ]]; then
+            echo "$resolved_candidate"
+            return 0
+        fi
+    done
+}
+
+driver_localappdata_cli_binary() {
+    local local_app_data="${LOCALAPPDATA:-}"
+
+    if [[ -z "$local_app_data" ]] || ! driver_running_on_windows; then
+        return 0
+    fi
+
+    if command -v cygpath &>/dev/null && [[ "$local_app_data" =~ ^[A-Za-z]:\\ ]]; then
+        local_app_data=$(cygpath -u "$local_app_data")
+    fi
+
+    local candidate="$local_app_data/cursor-agent/agent.cmd"
+    if [[ -f "$candidate" ]]; then
+        echo "$candidate"
+    fi
+}
+
+driver_wrapper_path() {
+    local driver_dir
+    driver_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    echo "$driver_dir/cursor-agent-wrapper.sh"
+}
+
+driver_build_windows_bootstrap_prompt() {
+    local loop_context=$1
+    local prompt_file=$2
+
+    cat <<EOF
+Read these Ralph workspace files before taking action:
+- .ralph/PROMPT.md
+- .ralph/PROJECT_CONTEXT.md
+- .ralph/SPECS_INDEX.md
+- .ralph/@fix_plan.md
+- .ralph/@AGENT.md
+- relevant files under .ralph/specs/
+
+Then follow the Ralph instructions from those files and continue the next task.
+EOF
+
+    if [[ -n "$loop_context" ]]; then
+        cat <<EOF
+
+Current loop context:
+$loop_context
+EOF
+    fi
+
+    if [[ "$prompt_file" != ".ralph/PROMPT.md" ]]; then
+        cat <<EOF
+
+Also read the active prompt file if it differs:
+- $prompt_file
+EOF
+    fi
+}

package/ralph/lib/circuit_breaker.sh

@@ -463,16 +463,16 @@ should_halt_execution() {
         echo -e "${YELLOW}Ralph has detected that no progress is being made.${NC}"
         echo ""
         echo -e "${YELLOW}Possible reasons:${NC}"
-        echo "  • Project may be complete (check .ralph/fix_plan.md)"
-        echo "  • Claude may be stuck on an error"
+        echo "  • Project may be complete (check .ralph/@fix_plan.md)"
+        echo "  • The active driver may be stuck on an error"
         echo "  • .ralph/PROMPT.md may need clarification"
         echo "  • Manual intervention may be required"
         echo ""
         echo -e "${YELLOW}To continue:${NC}"
         echo "  1. Review recent logs: tail -20 .ralph/logs/ralph.log"
-        echo "  2. Check Claude output: ls -lt .ralph/logs/claude_output_*.log | head -1"
-        echo "  3. Update .ralph/fix_plan.md if needed"
-        echo "  4. Reset circuit breaker: ralph --reset-circuit"
+        echo "  2. Check recent driver output: ls -lt .ralph/logs/claude_output_*.log | head -1"
+        echo "  3. Update .ralph/@fix_plan.md if needed"
+        echo "  4. Reset circuit breaker: bash .ralph/ralph_loop.sh --reset-circuit"
         echo ""
         return 0  # Signal to halt
     else

package/ralph/lib/enable_core.sh

@@ -83,8 +83,8 @@ check_existing_ralph() {
     # Check for required files
     local required_files=(
         ".ralph/PROMPT.md"
-        ".ralph/fix_plan.md"
-        ".ralph/AGENT.md"
+        ".ralph/@fix_plan.md"
+        ".ralph/@AGENT.md"
     )
 
     local missing=()
@@ -505,7 +505,7 @@ generate_prompt_md() {
         objectives_section="$objectives"
     else
         objectives_section="- Review the codebase and understand the current state
-- Follow tasks in fix_plan.md
+- Follow tasks in @fix_plan.md
 - Implement one task per loop
 - Write tests for new functionality
 - Update documentation as needed"
@@ -527,7 +527,7 @@ ${objectives_section}
 - ONE task per loop - focus on the most important thing
 - Search the codebase before assuming something isn't implemented
 - Write comprehensive tests with clear documentation
-- Update fix_plan.md with your learnings
+- Update @fix_plan.md with your learnings
 - Commit working changes with descriptive messages
 
 ## Testing Guidelines
@@ -536,7 +536,7 @@ ${objectives_section}
 - Only write tests for NEW functionality you implement
 
 ## Build & Run
-See AGENT.md for build and run instructions.
+See @AGENT.md for build and run instructions.
 
 ## Status Reporting (CRITICAL)
 
@@ -555,11 +555,11 @@ RECOMMENDATION: <one line summary of what to do next>
 \`\`\`
 
 ## Current Task
-Follow fix_plan.md and choose the most important item to implement next.
+Follow @fix_plan.md and choose the most important item to implement next.
 PROMPTEOF
 }
 
-# generate_agent_md - Generate AGENT.md with detected build commands
+# generate_agent_md - Generate @AGENT.md with detected build commands
 #
 # Parameters:
 #   $1 (build_cmd) - Build command
@@ -604,7 +604,7 @@ ${run_cmd}
 AGENTEOF
 }
 
-# generate_fix_plan_md - Generate fix_plan.md with imported tasks
+# generate_fix_plan_md - Generate @fix_plan.md with imported tasks
 #
 # Parameters:
 #   $1 (tasks) - Tasks to include (newline-separated, markdown checkbox format)
@@ -768,11 +768,11 @@ enable_ralph_in_directory() {
 
     local agent_content
     agent_content=$(generate_agent_md "$DETECTED_BUILD_CMD" "$DETECTED_TEST_CMD" "$DETECTED_RUN_CMD")
-    safe_create_file ".ralph/AGENT.md" "$agent_content"
+    safe_create_file ".ralph/@AGENT.md" "$agent_content"
 
     local fix_plan_content
     fix_plan_content=$(generate_fix_plan_md "$task_content")
-    safe_create_file ".ralph/fix_plan.md" "$fix_plan_content"
+    safe_create_file ".ralph/@fix_plan.md" "$fix_plan_content"
 
     # Detect task sources for .ralphrc
     detect_task_sources

package/ralph/ralph_import.sh

@@ -272,11 +272,14 @@ Supported formats:
     - PDFs (.pdf)
     - Any text-based format
 
+This legacy helper is kept for standalone Ralph compatibility.
+If you are using bmalph, use `bmalph implement` instead.
+
 The command will:
 1. Create a new Ralph project
 2. Use Claude Code to intelligently convert your PRD into:
    - .ralph/PROMPT.md (Ralph instructions)
-   - .ralph/fix_plan.md (prioritized tasks)
+   - .ralph/@fix_plan.md (prioritized tasks)
    - .ralph/specs/ (technical specifications)
 
 HELPEOF
@@ -320,7 +323,7 @@ convert_prd() {
     cat > "$CONVERSION_PROMPT_FILE" << 'PROMPTEOF'
 # PRD to Ralph Conversion Task
 
-You are tasked with converting a Product Requirements Document (PRD) or specification into Ralph for Claude Code format.
+You are tasked with converting a Product Requirements Document (PRD) or specification into Ralph's autonomous implementation format.
 
 ## Input Analysis
 Analyze the provided specification file and extract:
@@ -350,7 +353,7 @@ You are Ralph, an autonomous AI development agent working on a [PROJECT NAME] pr
 - Search the codebase before assuming something isn't implemented
 - Use subagents for expensive operations (file searching, analysis)
 - Write comprehensive tests with clear documentation
-- Update fix_plan.md with your learnings
+- Update @fix_plan.md with your learnings
 - Commit working changes with descriptive messages
 
 ## 🧪 Testing Guidelines (CRITICAL)
@@ -370,10 +373,10 @@ You are Ralph, an autonomous AI development agent working on a [PROJECT NAME] pr
 [Define what "done" looks like based on the PRD]
 
 ## Current Task
-Follow fix_plan.md and choose the most important item to implement next.
+Follow @fix_plan.md and choose the most important item to implement next.
 ```
 
-### 2. .ralph/fix_plan.md
+### 2. .ralph/@fix_plan.md
 Convert requirements into a prioritized task list:
 ```markdown
 # Ralph Fix Plan
@@ -416,7 +419,7 @@ Create detailed technical specifications:
 2. Create the three files above with content derived from the PRD
 3. Ensure all requirements are captured and properly prioritized
 4. Make the PROMPT.md actionable for autonomous development
-5. Structure fix_plan.md with clear, implementable tasks
+5. Structure @fix_plan.md with clear, implementable tasks
 
 PROMPTEOF
 
@@ -527,7 +530,7 @@ PROMPTEOF
     # Use PARSED_FILES_CREATED from JSON if available, otherwise check filesystem
     local missing_files=()
     local created_files=()
-    local expected_files=(".ralph/PROMPT.md" ".ralph/fix_plan.md" ".ralph/specs/requirements.md")
+    local expected_files=(".ralph/PROMPT.md" ".ralph/@fix_plan.md" ".ralph/specs/requirements.md")
 
     # If JSON provided files_created, use that to inform verification
     if [[ "$json_parsed" == "true" && -n "$PARSED_FILES_CREATED" && "$PARSED_FILES_CREATED" != "[]" ]]; then
@@ -632,10 +635,11 @@ main() {
     echo "Next steps:"
     echo "  1. Review and edit the generated files:"
     echo "     - .ralph/PROMPT.md (Ralph instructions)"
-    echo "     - .ralph/fix_plan.md (task priorities)"
+    echo "     - .ralph/@fix_plan.md (task priorities)"
     echo "     - .ralph/specs/requirements.md (technical specs)"
     echo "  2. Start autonomous development:"
-    echo "     ralph --monitor"
+    echo "     ralph --monitor   # standalone Ralph"
+    echo "     bmalph run       # bmalph-managed projects"
     echo ""
     echo "Project created in: $(pwd)"
 }
@@ -649,4 +653,4 @@ case "${1:-}" in
     *)
         main "$@"
         ;;
-esac
+esac