@howlil/ez-agents 3.4.1 → 3.4.2

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 (102) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +7 -18
  3. package/bin/install.js +52 -10
  4. package/commands/ez/join-discord.md +18 -18
  5. package/ez-agents/bin/lib/assistant-adapter.cjs +264 -264
  6. package/ez-agents/bin/lib/audit-exec.cjs +7 -2
  7. package/ez-agents/bin/lib/circuit-breaker.cjs +118 -118
  8. package/ez-agents/bin/lib/config.cjs +190 -190
  9. package/ez-agents/bin/lib/file-lock.cjs +236 -236
  10. package/ez-agents/bin/lib/frontmatter.cjs +299 -299
  11. package/ez-agents/bin/lib/fs-utils.cjs +153 -153
  12. package/ez-agents/bin/lib/git-utils.cjs +203 -203
  13. package/ez-agents/bin/lib/index.cjs +113 -113
  14. package/ez-agents/bin/lib/init.cjs +757 -757
  15. package/ez-agents/bin/lib/logger.cjs +47 -17
  16. package/ez-agents/bin/lib/milestone.cjs +241 -241
  17. package/ez-agents/bin/lib/model-provider.cjs +241 -241
  18. package/ez-agents/bin/lib/phase.cjs +925 -925
  19. package/ez-agents/bin/lib/planning-write.cjs +107 -107
  20. package/ez-agents/bin/lib/retry.cjs +119 -119
  21. package/ez-agents/bin/lib/roadmap.cjs +306 -306
  22. package/ez-agents/bin/lib/safe-exec.cjs +90 -4
  23. package/ez-agents/bin/lib/safe-path.cjs +130 -130
  24. package/ez-agents/bin/lib/state.cjs +736 -736
  25. package/ez-agents/bin/lib/temp-file.cjs +239 -239
  26. package/ez-agents/bin/lib/template.cjs +223 -223
  27. package/ez-agents/bin/lib/test-file-lock.cjs +112 -112
  28. package/ez-agents/bin/lib/test-graceful.cjs +93 -93
  29. package/ez-agents/bin/lib/test-logger.cjs +60 -60
  30. package/ez-agents/bin/lib/test-safe-exec.cjs +38 -38
  31. package/ez-agents/bin/lib/test-safe-path.cjs +33 -33
  32. package/ez-agents/bin/lib/test-temp-file.cjs +125 -125
  33. package/ez-agents/bin/lib/timeout-exec.cjs +63 -63
  34. package/ez-agents/bin/lib/verify.cjs +15 -1
  35. package/ez-agents/references/checkpoints.md +776 -776
  36. package/ez-agents/references/continuation-format.md +249 -249
  37. package/ez-agents/references/questioning.md +162 -162
  38. package/ez-agents/references/tdd.md +263 -263
  39. package/ez-agents/templates/codebase/concerns.md +310 -310
  40. package/ez-agents/templates/codebase/conventions.md +307 -307
  41. package/ez-agents/templates/codebase/integrations.md +280 -280
  42. package/ez-agents/templates/codebase/stack.md +186 -186
  43. package/ez-agents/templates/codebase/testing.md +480 -480
  44. package/ez-agents/templates/config.json +37 -37
  45. package/ez-agents/templates/continue-here.md +78 -78
  46. package/ez-agents/templates/milestone-archive.md +123 -123
  47. package/ez-agents/templates/milestone.md +115 -115
  48. package/ez-agents/templates/requirements.md +231 -231
  49. package/ez-agents/templates/research-project/ARCHITECTURE.md +204 -204
  50. package/ez-agents/templates/research-project/FEATURES.md +147 -147
  51. package/ez-agents/templates/research-project/PITFALLS.md +200 -200
  52. package/ez-agents/templates/research-project/STACK.md +120 -120
  53. package/ez-agents/templates/research-project/SUMMARY.md +170 -170
  54. package/ez-agents/templates/retrospective.md +54 -54
  55. package/ez-agents/templates/roadmap.md +202 -202
  56. package/ez-agents/templates/summary-minimal.md +41 -41
  57. package/ez-agents/templates/summary-standard.md +48 -48
  58. package/ez-agents/templates/summary.md +248 -248
  59. package/ez-agents/templates/user-setup.md +311 -311
  60. package/ez-agents/templates/verification-report.md +322 -322
  61. package/ez-agents/workflows/add-phase.md +112 -112
  62. package/ez-agents/workflows/add-tests.md +351 -351
  63. package/ez-agents/workflows/add-todo.md +158 -158
  64. package/ez-agents/workflows/audit-milestone.md +332 -332
  65. package/ez-agents/workflows/autonomous.md +743 -743
  66. package/ez-agents/workflows/check-todos.md +177 -177
  67. package/ez-agents/workflows/cleanup.md +152 -152
  68. package/ez-agents/workflows/complete-milestone.md +766 -766
  69. package/ez-agents/workflows/diagnose-issues.md +219 -219
  70. package/ez-agents/workflows/discovery-phase.md +289 -289
  71. package/ez-agents/workflows/discuss-phase.md +762 -762
  72. package/ez-agents/workflows/execute-phase.md +468 -468
  73. package/ez-agents/workflows/execute-plan.md +483 -483
  74. package/ez-agents/workflows/health.md +159 -159
  75. package/ez-agents/workflows/help.md +492 -492
  76. package/ez-agents/workflows/insert-phase.md +130 -130
  77. package/ez-agents/workflows/list-phase-assumptions.md +178 -178
  78. package/ez-agents/workflows/map-codebase.md +316 -316
  79. package/ez-agents/workflows/new-milestone.md +384 -384
  80. package/ez-agents/workflows/new-project.md +1113 -1113
  81. package/ez-agents/workflows/node-repair.md +92 -92
  82. package/ez-agents/workflows/pause-work.md +122 -122
  83. package/ez-agents/workflows/plan-milestone-gaps.md +274 -274
  84. package/ez-agents/workflows/plan-phase.md +651 -651
  85. package/ez-agents/workflows/progress.md +382 -382
  86. package/ez-agents/workflows/quick.md +610 -610
  87. package/ez-agents/workflows/remove-phase.md +155 -155
  88. package/ez-agents/workflows/research-phase.md +74 -74
  89. package/ez-agents/workflows/resume-project.md +307 -307
  90. package/ez-agents/workflows/set-profile.md +81 -81
  91. package/ez-agents/workflows/settings.md +242 -242
  92. package/ez-agents/workflows/stats.md +57 -57
  93. package/ez-agents/workflows/transition.md +544 -544
  94. package/ez-agents/workflows/ui-phase.md +290 -290
  95. package/ez-agents/workflows/ui-review.md +157 -157
  96. package/ez-agents/workflows/update.md +320 -320
  97. package/ez-agents/workflows/validate-phase.md +167 -167
  98. package/ez-agents/workflows/verify-phase.md +243 -243
  99. package/ez-agents/workflows/verify-work.md +584 -584
  100. package/package.json +2 -3
  101. package/scripts/build-hooks.js +43 -43
  102. package/scripts/run-tests.cjs +29 -29
@@ -1,112 +1,112 @@
1
- <purpose>
2
- Add a new integer phase to the end of the current milestone in the roadmap. Automatically calculates next phase number, creates phase directory, and updates roadmap structure.
3
- </purpose>
4
-
5
- <required_reading>
6
- Read all files referenced by the invoking prompt's execution_context before starting.
7
- </required_reading>
8
-
9
- <process>
10
-
11
- <step name="parse_arguments">
12
- Parse the command arguments:
13
- - All arguments become the phase description
14
- - Example: `/ez:add-phase Add authentication` → description = "Add authentication"
15
- - Example: `/ez:add-phase Fix critical performance issues` → description = "Fix critical performance issues"
16
-
17
- If no arguments provided:
18
-
19
- ```
20
- ERROR: Phase description required
21
- Usage: /ez:add-phase <description>
22
- Example: /ez:add-phase Add authentication system
23
- ```
24
-
25
- Exit.
26
- </step>
27
-
28
- <step name="init_context">
29
- Load phase operation context:
30
-
31
- ```bash
32
- INIT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" init phase-op "0")
33
- if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
34
- ```
35
-
36
- Check `roadmap_exists` from init JSON. If false:
37
- ```
38
- ERROR: No roadmap found (.planning/ROADMAP.md)
39
- Run /ez:new-project to initialize.
40
- ```
41
- Exit.
42
- </step>
43
-
44
- <step name="add_phase">
45
- **Delegate the phase addition to ez-tools:**
46
-
47
- ```bash
48
- RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase add "${description}")
49
- ```
50
-
51
- The CLI handles:
52
- - Finding the highest existing integer phase number
53
- - Calculating next phase number (max + 1)
54
- - Generating slug from description
55
- - Creating the phase directory (`.planning/phases/{NN}-{slug}/`)
56
- - Inserting the phase entry into ROADMAP.md with Goal, Depends on, and Plans sections
57
-
58
- Extract from result: `phase_number`, `padded`, `name`, `slug`, `directory`.
59
- </step>
60
-
61
- <step name="update_project_state">
62
- Update STATE.md to reflect the new phase:
63
-
64
- 1. Read `.planning/STATE.md`
65
- 2. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
66
- ```
67
- - Phase {N} added: {description}
68
- ```
69
-
70
- If "Roadmap Evolution" section doesn't exist, create it.
71
- </step>
72
-
73
- <step name="completion">
74
- Present completion summary:
75
-
76
- ```
77
- Phase {N} added to current milestone:
78
- - Description: {description}
79
- - Directory: .planning/phases/{phase-num}-{slug}/
80
- - Status: Not planned yet
81
-
82
- Roadmap updated: .planning/ROADMAP.md
83
-
84
- ---
85
-
86
- ## ▶ Next Up
87
-
88
- **Phase {N}: {description}**
89
-
90
- `/ez:plan-phase {N}`
91
-
92
- <sub>`/clear` first → fresh context window</sub>
93
-
94
- ---
95
-
96
- **Also available:**
97
- - `/ez:add-phase <description>` — add another phase
98
- - Review roadmap
99
-
100
- ---
101
- ```
102
- </step>
103
-
104
- </process>
105
-
106
- <success_criteria>
107
- - [ ] `ez-tools phase add` executed successfully
108
- - [ ] Phase directory created
109
- - [ ] Roadmap updated with new phase entry
110
- - [ ] STATE.md updated with roadmap evolution note
111
- - [ ] User informed of next steps
112
- </success_criteria>
1
+ <purpose>
2
+ Add a new integer phase to the end of the current milestone in the roadmap. Automatically calculates next phase number, creates phase directory, and updates roadmap structure.
3
+ </purpose>
4
+
5
+ <required_reading>
6
+ Read all files referenced by the invoking prompt's execution_context before starting.
7
+ </required_reading>
8
+
9
+ <process>
10
+
11
+ <step name="parse_arguments">
12
+ Parse the command arguments:
13
+ - All arguments become the phase description
14
+ - Example: `/ez:add-phase Add authentication` → description = "Add authentication"
15
+ - Example: `/ez:add-phase Fix critical performance issues` → description = "Fix critical performance issues"
16
+
17
+ If no arguments provided:
18
+
19
+ ```
20
+ ERROR: Phase description required
21
+ Usage: /ez:add-phase <description>
22
+ Example: /ez:add-phase Add authentication system
23
+ ```
24
+
25
+ Exit.
26
+ </step>
27
+
28
+ <step name="init_context">
29
+ Load phase operation context:
30
+
31
+ ```bash
32
+ INIT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" init phase-op "0")
33
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
34
+ ```
35
+
36
+ Check `roadmap_exists` from init JSON. If false:
37
+ ```
38
+ ERROR: No roadmap found (.planning/ROADMAP.md)
39
+ Run /ez:new-project to initialize.
40
+ ```
41
+ Exit.
42
+ </step>
43
+
44
+ <step name="add_phase">
45
+ **Delegate the phase addition to ez-tools:**
46
+
47
+ ```bash
48
+ RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase add "${description}")
49
+ ```
50
+
51
+ The CLI handles:
52
+ - Finding the highest existing integer phase number
53
+ - Calculating next phase number (max + 1)
54
+ - Generating slug from description
55
+ - Creating the phase directory (`.planning/phases/{NN}-{slug}/`)
56
+ - Inserting the phase entry into ROADMAP.md with Goal, Depends on, and Plans sections
57
+
58
+ Extract from result: `phase_number`, `padded`, `name`, `slug`, `directory`.
59
+ </step>
60
+
61
+ <step name="update_project_state">
62
+ Update STATE.md to reflect the new phase:
63
+
64
+ 1. Read `.planning/STATE.md`
65
+ 2. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
66
+ ```
67
+ - Phase {N} added: {description}
68
+ ```
69
+
70
+ If "Roadmap Evolution" section doesn't exist, create it.
71
+ </step>
72
+
73
+ <step name="completion">
74
+ Present completion summary:
75
+
76
+ ```
77
+ Phase {N} added to current milestone:
78
+ - Description: {description}
79
+ - Directory: .planning/phases/{phase-num}-{slug}/
80
+ - Status: Not planned yet
81
+
82
+ Roadmap updated: .planning/ROADMAP.md
83
+
84
+ ---
85
+
86
+ ## ▶ Next Up
87
+
88
+ **Phase {N}: {description}**
89
+
90
+ `/ez:plan-phase {N}`
91
+
92
+ <sub>`/clear` first → fresh context window</sub>
93
+
94
+ ---
95
+
96
+ **Also available:**
97
+ - `/ez:add-phase <description>` — add another phase
98
+ - Review roadmap
99
+
100
+ ---
101
+ ```
102
+ </step>
103
+
104
+ </process>
105
+
106
+ <success_criteria>
107
+ - [ ] `ez-tools phase add` executed successfully
108
+ - [ ] Phase directory created
109
+ - [ ] Roadmap updated with new phase entry
110
+ - [ ] STATE.md updated with roadmap evolution note
111
+ - [ ] User informed of next steps
112
+ </success_criteria>