bmalph 2.7.5 โ†’ 2.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +20 -5
  2. package/dist/commands/doctor-runtime-checks.js +104 -86
  3. package/dist/commands/doctor-runtime-checks.js.map +1 -1
  4. package/dist/commands/run.js +11 -2
  5. package/dist/commands/run.js.map +1 -1
  6. package/dist/commands/watch.js +5 -0
  7. package/dist/commands/watch.js.map +1 -1
  8. package/dist/installer/bmad-assets.js +182 -0
  9. package/dist/installer/bmad-assets.js.map +1 -0
  10. package/dist/installer/commands.js +324 -0
  11. package/dist/installer/commands.js.map +1 -0
  12. package/dist/installer/install.js +42 -0
  13. package/dist/installer/install.js.map +1 -0
  14. package/dist/installer/metadata.js +56 -0
  15. package/dist/installer/metadata.js.map +1 -0
  16. package/dist/installer/project-files.js +169 -0
  17. package/dist/installer/project-files.js.map +1 -0
  18. package/dist/installer/ralph-assets.js +91 -0
  19. package/dist/installer/ralph-assets.js.map +1 -0
  20. package/dist/installer/template-files.js +187 -0
  21. package/dist/installer/template-files.js.map +1 -0
  22. package/dist/installer/types.js +2 -0
  23. package/dist/installer/types.js.map +1 -0
  24. package/dist/installer.js +5 -843
  25. package/dist/installer.js.map +1 -1
  26. package/dist/run/run-dashboard.js +20 -6
  27. package/dist/run/run-dashboard.js.map +1 -1
  28. package/dist/transition/artifact-loading.js +91 -0
  29. package/dist/transition/artifact-loading.js.map +1 -0
  30. package/dist/transition/context-output.js +85 -0
  31. package/dist/transition/context-output.js.map +1 -0
  32. package/dist/transition/context.js +11 -3
  33. package/dist/transition/context.js.map +1 -1
  34. package/dist/transition/fix-plan-sync.js +119 -0
  35. package/dist/transition/fix-plan-sync.js.map +1 -0
  36. package/dist/transition/orchestration.js +25 -362
  37. package/dist/transition/orchestration.js.map +1 -1
  38. package/dist/transition/specs-sync.js +78 -2
  39. package/dist/transition/specs-sync.js.map +1 -1
  40. package/dist/utils/ralph-runtime-state.js +222 -0
  41. package/dist/utils/ralph-runtime-state.js.map +1 -0
  42. package/dist/utils/state.js +17 -16
  43. package/dist/utils/state.js.map +1 -1
  44. package/dist/utils/validate.js +16 -0
  45. package/dist/utils/validate.js.map +1 -1
  46. package/dist/watch/dashboard.js +25 -21
  47. package/dist/watch/dashboard.js.map +1 -1
  48. package/dist/watch/frame-writer.js +83 -0
  49. package/dist/watch/frame-writer.js.map +1 -0
  50. package/dist/watch/renderer.js +214 -49
  51. package/dist/watch/renderer.js.map +1 -1
  52. package/dist/watch/state-reader.js +87 -44
  53. package/dist/watch/state-reader.js.map +1 -1
  54. package/package.json +1 -1
  55. package/ralph/RALPH-REFERENCE.md +34 -14
  56. package/ralph/drivers/claude-code.sh +27 -0
  57. package/ralph/drivers/codex.sh +11 -0
  58. package/ralph/drivers/copilot.sh +11 -0
  59. package/ralph/drivers/cursor.sh +11 -0
  60. package/ralph/lib/circuit_breaker.sh +3 -3
  61. package/ralph/lib/date_utils.sh +28 -9
  62. package/ralph/lib/enable_core.sh +10 -2
  63. package/ralph/lib/response_analyzer.sh +252 -40
  64. package/ralph/ralph_import.sh +9 -1
  65. package/ralph/ralph_loop.sh +548 -128
  66. package/ralph/templates/PROMPT.md +20 -5
  67. package/ralph/templates/ralphrc.template +14 -4
@@ -9,16 +9,24 @@ You are Ralph, an autonomous AI development agent working on a [YOUR PROJECT NAM
9
9
  3. Implement the highest priority item using best practices
10
10
  4. Use parallel subagents for complex tasks (max 100 concurrent)
11
11
  5. Run tests after each implementation
12
- 6. Update documentation and @fix_plan.md
12
+ 6. Update documentation and the completed story checkbox in @fix_plan.md
13
13
 
14
14
  ## Key Principles
15
15
  - ONE task per loop - focus on the most important thing
16
16
  - Search the codebase before assuming something isn't implemented
17
17
  - Use subagents for expensive operations (file searching, analysis)
18
18
  - Write comprehensive tests with clear documentation
19
- - Update .ralph/@fix_plan.md with your learnings
19
+ - Toggle completed story checkboxes in .ralph/@fix_plan.md without rewriting story lines
20
20
  - Commit working changes with descriptive messages
21
21
 
22
+ ## Progress Tracking (CRITICAL)
23
+ - Ralph tracks progress by counting story checkboxes in .ralph/@fix_plan.md
24
+ - When you complete a story, change `- [ ]` to `- [x]` on that exact story line
25
+ - Do NOT remove, rewrite, or reorder story lines in .ralph/@fix_plan.md
26
+ - Update the checkbox before committing so the monitor updates immediately
27
+ - Set `TASKS_COMPLETED_THIS_LOOP` to the exact number of story checkboxes toggled this loop
28
+ - Only valid values: 0 or 1
29
+
22
30
  ## ๐Ÿงช Testing Guidelines (CRITICAL)
23
31
  - LIMIT testing to ~20% of your total effort per loop
24
32
  - PRIORITIZE: Implementation > Documentation > Tests
@@ -35,6 +43,13 @@ You are Ralph, an autonomous AI development agent working on a [YOUR PROJECT NAM
35
43
  - Document the WHY behind tests and implementations
36
44
  - No placeholder implementations - build it properly
37
45
 
46
+ ## Autonomous Mode (CRITICAL)
47
+ - do not ask the user questions during loop execution
48
+ - do not use AskUserQuestion, EnterPlanMode, or ExitPlanMode during loop execution
49
+ - make the safest reasonable assumption and continue
50
+ - prefer small, reversible changes when requirements are ambiguous
51
+ - surface blockers in the Ralph status block instead of starting a conversation
52
+
38
53
  ## ๐ŸŽฏ Status Reporting (CRITICAL - Ralph needs this!)
39
54
 
40
55
  **IMPORTANT**: At the end of your response, ALWAYS include this status block:
@@ -42,7 +57,7 @@ You are Ralph, an autonomous AI development agent working on a [YOUR PROJECT NAM
42
57
  ```
43
58
  ---RALPH_STATUS---
44
59
  STATUS: IN_PROGRESS | COMPLETE | BLOCKED
45
- TASKS_COMPLETED_THIS_LOOP: <number>
60
+ TASKS_COMPLETED_THIS_LOOP: 0 | 1
46
61
  FILES_MODIFIED: <number>
47
62
  TESTS_STATUS: PASSING | FAILING | NOT_RUN
48
63
  WORK_TYPE: IMPLEMENTATION | TESTING | DOCUMENTATION | REFACTORING
@@ -66,7 +81,7 @@ Set EXIT_SIGNAL to **true** when ALL of these conditions are met:
66
81
  ```
67
82
  ---RALPH_STATUS---
68
83
  STATUS: IN_PROGRESS
69
- TASKS_COMPLETED_THIS_LOOP: 2
84
+ TASKS_COMPLETED_THIS_LOOP: 1
70
85
  FILES_MODIFIED: 5
71
86
  TESTS_STATUS: PASSING
72
87
  WORK_TYPE: IMPLEMENTATION
@@ -229,7 +244,7 @@ RECOMMENDATION: No remaining work, all .ralph/specs implemented
229
244
  ```
230
245
  ---RALPH_STATUS---
231
246
  STATUS: IN_PROGRESS
232
- TASKS_COMPLETED_THIS_LOOP: 3
247
+ TASKS_COMPLETED_THIS_LOOP: 1
233
248
  FILES_MODIFIED: 7
234
249
  TESTS_STATUS: PASSING
235
250
  WORK_TYPE: IMPLEMENTATION
@@ -40,10 +40,20 @@ CLAUDE_OUTPUT_FORMAT="json"
40
40
  # TOOL PERMISSIONS
41
41
  # =============================================================================
42
42
 
43
- # Comma-separated list of allowed tools for Claude
44
- # Common tools: Write, Read, Edit, Grep, Glob
45
- # Bash patterns: Bash(git *), Bash(npm *), Bash(pytest)
46
- ALLOWED_TOOLS="Write,Read,Edit,Bash(git *),Bash(npm *),Bash(pytest)"
43
+ # Comma-separated list of allowed tools for Claude Code only.
44
+ # Ignored by the codex, cursor, and copilot drivers.
45
+ # Opt in to interactive pauses by adding AskUserQuestion manually.
46
+ ALLOWED_TOOLS="Write,Read,Edit,MultiEdit,Glob,Grep,Task,TodoWrite,WebFetch,WebSearch,EnterPlanMode,ExitPlanMode,NotebookEdit,Bash"
47
+
48
+ # Permission mode for Claude Code CLI (default: bypassPermissions)
49
+ # Options: auto, acceptEdits, bypassPermissions, default, dontAsk, plan
50
+ CLAUDE_PERMISSION_MODE="bypassPermissions"
51
+
52
+ # How Ralph responds when a driver reports permission denials:
53
+ # - continue: log the denial and keep looping (default for unattended mode)
54
+ # - halt: stop immediately and show recovery guidance
55
+ # - threshold: continue until the permission-denial circuit breaker trips
56
+ PERMISSION_DENIAL_MODE="continue"
47
57
 
48
58
  # =============================================================================
49
59
  # SESSION MANAGEMENT