@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,115 +1,115 @@
1
- # Milestone Entry Template
2
-
3
- Add this entry to `.planning/MILESTONES.md` when completing a milestone:
4
-
5
- ```markdown
6
- ## v[X.Y] [Name] (Shipped: YYYY-MM-DD)
7
-
8
- **Delivered:** [One sentence describing what shipped]
9
-
10
- **Phases completed:** [X-Y] ([Z] plans total)
11
-
12
- **Key accomplishments:**
13
- - [Major achievement 1]
14
- - [Major achievement 2]
15
- - [Major achievement 3]
16
- - [Major achievement 4]
17
-
18
- **Stats:**
19
- - [X] files created/modified
20
- - [Y] lines of code (primary language)
21
- - [Z] phases, [N] plans, [M] tasks
22
- - [D] days from start to ship (or milestone to milestone)
23
-
24
- **Git range:** `feat(XX-XX)` → `feat(YY-YY)`
25
-
26
- **What's next:** [Brief description of next milestone goals, or "Project complete"]
27
-
28
- ---
29
- ```
30
-
31
- <structure>
32
- If MILESTONES.md doesn't exist, create it with header:
33
-
34
- ```markdown
35
- # Project Milestones: [Project Name]
36
-
37
- [Entries in reverse chronological order - newest first]
38
- ```
39
- </structure>
40
-
41
- <guidelines>
42
- **When to create milestones:**
43
- - Initial v1.0 MVP shipped
44
- - Major version releases (v2.0, v3.0)
45
- - Significant feature milestones (v1.1, v1.2)
46
- - Before archiving planning (capture what was shipped)
47
-
48
- **Don't create milestones for:**
49
- - Individual phase completions (normal workflow)
50
- - Work in progress (wait until shipped)
51
- - Minor bug fixes that don't constitute a release
52
-
53
- **Stats to include:**
54
- - Count modified files: `git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1`
55
- - Count LOC: `find . -name "*.swift" -o -name "*.ts" | xargs wc -l` (or relevant extension)
56
- - Phase/plan/task counts from ROADMAP
57
- - Timeline from first phase commit to last phase commit
58
-
59
- **Git range format:**
60
- - First commit of milestone → last commit of milestone
61
- - Example: `feat(01-01)` → `feat(04-01)` for phases 1-4
62
- </guidelines>
63
-
64
- <example>
65
- ```markdown
66
- # Project Milestones: WeatherBar
67
-
68
- ## v1.1 Security & Polish (Shipped: 2025-12-10)
69
-
70
- **Delivered:** Security hardening with Keychain integration and comprehensive error handling
71
-
72
- **Phases completed:** 5-6 (3 plans total)
73
-
74
- **Key accomplishments:**
75
- - Migrated API key storage from plaintext to macOS Keychain
76
- - Implemented comprehensive error handling for network failures
77
- - Added Sentry crash reporting integration
78
- - Fixed memory leak in auto-refresh timer
79
-
80
- **Stats:**
81
- - 23 files modified
82
- - 650 lines of Swift added
83
- - 2 phases, 3 plans, 12 tasks
84
- - 8 days from v1.0 to v1.1
85
-
86
- **Git range:** `feat(05-01)` → `feat(06-02)`
87
-
88
- **What's next:** v2.0 SwiftUI redesign with widget support
89
-
90
- ---
91
-
92
- ## v1.0 MVP (Shipped: 2025-11-25)
93
-
94
- **Delivered:** Menu bar weather app with current conditions and 3-day forecast
95
-
96
- **Phases completed:** 1-4 (7 plans total)
97
-
98
- **Key accomplishments:**
99
- - Menu bar app with popover UI (AppKit)
100
- - OpenWeather API integration with auto-refresh
101
- - Current weather display with conditions icon
102
- - 3-day forecast list with high/low temperatures
103
- - Code signed and notarized for distribution
104
-
105
- **Stats:**
106
- - 47 files created
107
- - 2,450 lines of Swift
108
- - 4 phases, 7 plans, 28 tasks
109
- - 12 days from start to ship
110
-
111
- **Git range:** `feat(01-01)` → `feat(04-01)`
112
-
113
- **What's next:** Security audit and hardening for v1.1
114
- ```
115
- </example>
1
+ # Milestone Entry Template
2
+
3
+ Add this entry to `.planning/MILESTONES.md` when completing a milestone:
4
+
5
+ ```markdown
6
+ ## v[X.Y] [Name] (Shipped: YYYY-MM-DD)
7
+
8
+ **Delivered:** [One sentence describing what shipped]
9
+
10
+ **Phases completed:** [X-Y] ([Z] plans total)
11
+
12
+ **Key accomplishments:**
13
+ - [Major achievement 1]
14
+ - [Major achievement 2]
15
+ - [Major achievement 3]
16
+ - [Major achievement 4]
17
+
18
+ **Stats:**
19
+ - [X] files created/modified
20
+ - [Y] lines of code (primary language)
21
+ - [Z] phases, [N] plans, [M] tasks
22
+ - [D] days from start to ship (or milestone to milestone)
23
+
24
+ **Git range:** `feat(XX-XX)` → `feat(YY-YY)`
25
+
26
+ **What's next:** [Brief description of next milestone goals, or "Project complete"]
27
+
28
+ ---
29
+ ```
30
+
31
+ <structure>
32
+ If MILESTONES.md doesn't exist, create it with header:
33
+
34
+ ```markdown
35
+ # Project Milestones: [Project Name]
36
+
37
+ [Entries in reverse chronological order - newest first]
38
+ ```
39
+ </structure>
40
+
41
+ <guidelines>
42
+ **When to create milestones:**
43
+ - Initial v1.0 MVP shipped
44
+ - Major version releases (v2.0, v3.0)
45
+ - Significant feature milestones (v1.1, v1.2)
46
+ - Before archiving planning (capture what was shipped)
47
+
48
+ **Don't create milestones for:**
49
+ - Individual phase completions (normal workflow)
50
+ - Work in progress (wait until shipped)
51
+ - Minor bug fixes that don't constitute a release
52
+
53
+ **Stats to include:**
54
+ - Count modified files: `git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1`
55
+ - Count LOC: `find . -name "*.swift" -o -name "*.ts" | xargs wc -l` (or relevant extension)
56
+ - Phase/plan/task counts from ROADMAP
57
+ - Timeline from first phase commit to last phase commit
58
+
59
+ **Git range format:**
60
+ - First commit of milestone → last commit of milestone
61
+ - Example: `feat(01-01)` → `feat(04-01)` for phases 1-4
62
+ </guidelines>
63
+
64
+ <example>
65
+ ```markdown
66
+ # Project Milestones: WeatherBar
67
+
68
+ ## v1.1 Security & Polish (Shipped: 2025-12-10)
69
+
70
+ **Delivered:** Security hardening with Keychain integration and comprehensive error handling
71
+
72
+ **Phases completed:** 5-6 (3 plans total)
73
+
74
+ **Key accomplishments:**
75
+ - Migrated API key storage from plaintext to macOS Keychain
76
+ - Implemented comprehensive error handling for network failures
77
+ - Added Sentry crash reporting integration
78
+ - Fixed memory leak in auto-refresh timer
79
+
80
+ **Stats:**
81
+ - 23 files modified
82
+ - 650 lines of Swift added
83
+ - 2 phases, 3 plans, 12 tasks
84
+ - 8 days from v1.0 to v1.1
85
+
86
+ **Git range:** `feat(05-01)` → `feat(06-02)`
87
+
88
+ **What's next:** v2.0 SwiftUI redesign with widget support
89
+
90
+ ---
91
+
92
+ ## v1.0 MVP (Shipped: 2025-11-25)
93
+
94
+ **Delivered:** Menu bar weather app with current conditions and 3-day forecast
95
+
96
+ **Phases completed:** 1-4 (7 plans total)
97
+
98
+ **Key accomplishments:**
99
+ - Menu bar app with popover UI (AppKit)
100
+ - OpenWeather API integration with auto-refresh
101
+ - Current weather display with conditions icon
102
+ - 3-day forecast list with high/low temperatures
103
+ - Code signed and notarized for distribution
104
+
105
+ **Stats:**
106
+ - 47 files created
107
+ - 2,450 lines of Swift
108
+ - 4 phases, 7 plans, 28 tasks
109
+ - 12 days from start to ship
110
+
111
+ **Git range:** `feat(01-01)` → `feat(04-01)`
112
+
113
+ **What's next:** Security audit and hardening for v1.1
114
+ ```
115
+ </example>