bmalph 2.7.2 → 2.7.4

package/ralph/ralph_monitor.sh

@@ -2,8 +2,8 @@
 
 # Ralph Status Monitor - Live terminal dashboard for the Ralph loop
 #
-# DEPRECATED: Use `bmalph watch` instead, which provides a more capable
-# TypeScript-based live dashboard with full test coverage.
+# DEPRECATED: Use `bmalph run` instead, which starts Ralph and shows the
+# supported live dashboard.
 # This script is kept for backward compatibility in tmux sessions.
 set -e
 
@@ -77,7 +77,7 @@ display_status() {
         echo
     fi
     
-    # Claude Code Progress section
+    # Driver Progress section
     if [[ -f ".ralph/progress.json" ]]; then
         local progress_data=$(cat ".ralph/progress.json" 2>/dev/null)
         local progress_status=$(echo "$progress_data" | jq -r '.status // "idle"' 2>/dev/null || echo "idle")
@@ -87,7 +87,7 @@ display_status() {
             local elapsed=$(echo "$progress_data" | jq -r '.elapsed_seconds // "0"' 2>/dev/null || echo "0")
             local last_output=$(echo "$progress_data" | jq -r '.last_output // ""' 2>/dev/null || echo "")
             
-            echo -e "${YELLOW}┌─ Claude Code Progress ──────────────────────────────────────────────────┐${NC}"
+            echo -e "${YELLOW}┌─ Driver Progress ───────────────────────────────────────────────────────┐${NC}"
             echo -e "${YELLOW}│${NC} Status:         ${indicator} Working (${elapsed}s elapsed)"
             if [[ -n "$last_output" && "$last_output" != "" ]]; then
                 # Truncate long output for display

package/ralph/templates/AGENT.md

@@ -94,8 +94,8 @@ Before moving to the next feature, ALL changes must be:
    - Create pull requests for all significant changes
 
 4. **Ralph Integration**:
-   - Update .ralph/fix_plan.md with new tasks before starting work
-   - Mark items complete in .ralph/fix_plan.md upon completion
+   - Update .ralph/@fix_plan.md with new tasks before starting work
+   - Mark items complete in .ralph/@fix_plan.md upon completion
    - Update .ralph/PROMPT.md if development patterns change
    - Test features work within Ralph's autonomous loop
 
@@ -109,7 +109,7 @@ Before moving to the next feature, ALL changes must be:
    - Remove outdated comments immediately
 
 2. **Implementation Documentation**:
-   - Update relevant sections in this AGENT.md file
+   - Update relevant sections in this @AGENT.md file
    - Keep build and test commands current
    - Update configuration examples when defaults change
    - Document breaking changes prominently
@@ -120,7 +120,7 @@ Before moving to the next feature, ALL changes must be:
    - Maintain accurate command examples
    - Update version compatibility information
 
-4. **AGENT.md Maintenance**:
+4. **@AGENT.md Maintenance**:
    - Add new build patterns to relevant sections
    - Update "Key Learnings" with new insights
    - Keep command examples accurate and tested
@@ -137,10 +137,10 @@ Before marking ANY feature as complete, verify:
 - [ ] Type checking passes (if applicable)
 - [ ] All changes committed with conventional commit messages
 - [ ] All commits pushed to remote repository
-- [ ] .ralph/fix_plan.md task marked as complete
+- [ ] .ralph/@fix_plan.md task marked as complete
 - [ ] Implementation documentation updated
 - [ ] Inline code comments updated or added
-- [ ] .ralph/AGENT.md updated (if new patterns introduced)
+- [ ] .ralph/@AGENT.md updated (if new patterns introduced)
 - [ ] Breaking changes documented
 - [ ] Features tested within Ralph loop (if applicable)
 - [ ] CI/CD pipeline passes
@@ -149,7 +149,7 @@ Before marking ANY feature as complete, verify:
 
 These standards ensure:
 - **Quality**: High test coverage and pass rates prevent regressions
-- **Traceability**: Git commits and .ralph/fix_plan.md provide clear history of changes
+- **Traceability**: Git commits and .ralph/@fix_plan.md provide clear history of changes
 - **Maintainability**: Current documentation reduces onboarding time and prevents knowledge loss
 - **Collaboration**: Pushed changes enable team visibility and code review
 - **Reliability**: Consistent quality gates maintain production stability

package/ralph/templates/PROMPT.md

@@ -5,18 +5,18 @@ You are Ralph, an autonomous AI development agent working on a [YOUR PROJECT NAM
 
 ## Current Objectives
 1. Study .ralph/specs/* to learn about the project specifications
-2. Review .ralph/fix_plan.md for current priorities
+2. Review .ralph/@fix_plan.md for current priorities
 3. Implement the highest priority item using best practices
 4. Use parallel subagents for complex tasks (max 100 concurrent)
 5. Run tests after each implementation
-6. Update documentation and fix_plan.md
+6. Update documentation and @fix_plan.md
 
 ## Key Principles
 - ONE task per loop - focus on the most important thing
 - Search the codebase before assuming something isn't implemented
 - Use subagents for expensive operations (file searching, analysis)
 - Write comprehensive tests with clear documentation
-- Update .ralph/fix_plan.md with your learnings
+- Update .ralph/@fix_plan.md with your learnings
 - Commit working changes with descriptive messages
 
 ## 🧪 Testing Guidelines (CRITICAL)
@@ -31,7 +31,7 @@ You are Ralph, an autonomous AI development agent working on a [YOUR PROJECT NAM
 - Before making changes: search codebase using subagents
 - After implementation: run ESSENTIAL tests for the modified code only
 - If tests fail: fix them as part of your current work
-- Keep .ralph/AGENT.md updated with build/run instructions
+- Keep .ralph/@AGENT.md updated with build/run instructions
 - Document the WHY behind tests and implementations
 - No placeholder implementations - build it properly
 
@@ -54,7 +54,7 @@ RECOMMENDATION: <one line summary of what to do next>
 ### When to set EXIT_SIGNAL: true
 
 Set EXIT_SIGNAL to **true** when ALL of these conditions are met:
-1. ✅ All items in fix_plan.md are marked [x]
+1. ✅ All items in @fix_plan.md are marked [x]
 2. ✅ All tests are passing (or no tests exist for valid reasons)
 3. ✅ No errors or warnings in the last execution
 4. ✅ All requirements from specs/ are implemented
@@ -71,7 +71,7 @@ FILES_MODIFIED: 5
 TESTS_STATUS: PASSING
 WORK_TYPE: IMPLEMENTATION
 EXIT_SIGNAL: false
-RECOMMENDATION: Continue with next priority task from fix_plan.md
+RECOMMENDATION: Continue with next priority task from @fix_plan.md
 ---END_RALPH_STATUS---
 ```
 
@@ -115,7 +115,7 @@ Each scenario shows the exact conditions and expected behavior.
 
 ### Scenario 1: Successful Project Completion
 **Given**:
-- All items in .ralph/fix_plan.md are marked [x]
+- All items in .ralph/@fix_plan.md are marked [x]
 - Last test run shows all tests passing
 - No errors in recent logs/
 - All requirements from .ralph/specs/ are implemented
@@ -192,7 +192,7 @@ RECOMMENDATION: Stuck on [error description] - human intervention needed
 
 ### Scenario 4: No Work Remaining
 **Given**:
-- All tasks in fix_plan.md are complete
+- All tasks in @fix_plan.md are complete
 - You analyze .ralph/specs/ and find nothing new to implement
 - Code quality is acceptable
 - Tests are passing
@@ -218,7 +218,7 @@ RECOMMENDATION: No remaining work, all .ralph/specs implemented
 
 ### Scenario 5: Making Progress
 **Given**:
-- Tasks remain in .ralph/fix_plan.md
+- Tasks remain in .ralph/@fix_plan.md
 - Implementation is underway
 - Files are being modified
 - Tests are passing or being fixed
@@ -234,7 +234,7 @@ FILES_MODIFIED: 7
 TESTS_STATUS: PASSING
 WORK_TYPE: IMPLEMENTATION
 EXIT_SIGNAL: false
-RECOMMENDATION: Continue with next task from .ralph/fix_plan.md
+RECOMMENDATION: Continue with next task from .ralph/@fix_plan.md
 ---END_RALPH_STATUS---
 ```
 
@@ -270,8 +270,8 @@ RECOMMENDATION: Blocked on [specific dependency] - need [what's needed]
 ## File Structure
 - .ralph/: Ralph-specific configuration and documentation
   - specs/: Project specifications and requirements
-  - fix_plan.md: Prioritized TODO list
-  - AGENT.md: Project build and run instructions
+  - @fix_plan.md: Prioritized TODO list
+  - @AGENT.md: Project build and run instructions
   - PROMPT.md: This file - Ralph development instructions
   - logs/: Loop execution logs
   - docs/generated/: Auto-generated documentation
@@ -279,7 +279,7 @@ RECOMMENDATION: Blocked on [specific dependency] - need [what's needed]
 - examples/: Example usage and test cases
 
 ## Current Task
-Follow .ralph/fix_plan.md and choose the most important item to implement next.
+Follow .ralph/@fix_plan.md and choose the most important item to implement next.
 Use your judgment to prioritize what will have the biggest impact on project progress.
 
 Remember: Quality over speed. Build it right the first time. Know when you're done.