@howlil/ez-agents 2.0.0 → 3.0.0

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 (145) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +157 -110
  3. package/README.zh-CN.md +84 -84
  4. package/agents/ez-plan-checker.md +2 -2
  5. package/agents/ez-research-synthesizer.md +1 -1
  6. package/agents/ez-ui-auditor.md +0 -2
  7. package/agents/ez-ui-checker.md +2 -4
  8. package/agents/ez-ui-researcher.md +0 -2
  9. package/agents/ez-verifier.md +1 -1
  10. package/bin/install.js +211 -211
  11. package/commands/ez/debug.md +1 -1
  12. package/commands/ez/map-codebase.md +1 -1
  13. package/commands/ez/reapply-patches.md +3 -3
  14. package/commands/ez/research-phase.md +1 -1
  15. package/{get-shit-done → ez-agents}/bin/ez-tools.cjs +1 -1
  16. package/{get-shit-done → ez-agents}/bin/lib/assistant-adapter.cjs +205 -205
  17. package/{get-shit-done → ez-agents}/bin/lib/audit-exec.cjs +150 -150
  18. package/{get-shit-done → ez-agents}/bin/lib/auth.cjs +175 -175
  19. package/{get-shit-done → ez-agents}/bin/lib/circuit-breaker.cjs +118 -118
  20. package/{get-shit-done → ez-agents}/bin/lib/commands.cjs +666 -666
  21. package/{get-shit-done → ez-agents}/bin/lib/config.cjs +183 -183
  22. package/{get-shit-done → ez-agents}/bin/lib/core.cjs +495 -495
  23. package/{get-shit-done → ez-agents}/bin/lib/file-lock.cjs +236 -236
  24. package/{get-shit-done → ez-agents}/bin/lib/frontmatter.cjs +299 -299
  25. package/{get-shit-done → ez-agents}/bin/lib/fs-utils.cjs +153 -153
  26. package/{get-shit-done → ez-agents}/bin/lib/git-utils.cjs +203 -203
  27. package/{get-shit-done → ez-agents}/bin/lib/health-check.cjs +163 -163
  28. package/{get-shit-done → ez-agents}/bin/lib/index.cjs +113 -113
  29. package/{get-shit-done → ez-agents}/bin/lib/init.cjs +710 -710
  30. package/{get-shit-done → ez-agents}/bin/lib/logger.cjs +117 -117
  31. package/{get-shit-done → ez-agents}/bin/lib/milestone.cjs +241 -241
  32. package/{get-shit-done → ez-agents}/bin/lib/model-provider.cjs +146 -146
  33. package/{get-shit-done → ez-agents}/bin/lib/phase.cjs +908 -908
  34. package/{get-shit-done → ez-agents}/bin/lib/retry.cjs +119 -119
  35. package/{get-shit-done → ez-agents}/bin/lib/roadmap.cjs +305 -305
  36. package/{get-shit-done → ez-agents}/bin/lib/safe-exec.cjs +128 -128
  37. package/{get-shit-done → ez-agents}/bin/lib/safe-path.cjs +130 -130
  38. package/{get-shit-done → ez-agents}/bin/lib/state.cjs +721 -721
  39. package/{get-shit-done → ez-agents}/bin/lib/temp-file.cjs +239 -239
  40. package/{get-shit-done → ez-agents}/bin/lib/template.cjs +222 -222
  41. package/{get-shit-done → ez-agents}/bin/lib/test-file-lock.cjs +112 -112
  42. package/{get-shit-done → ez-agents}/bin/lib/test-graceful.cjs +93 -93
  43. package/{get-shit-done → ez-agents}/bin/lib/test-logger.cjs +60 -60
  44. package/{get-shit-done → ez-agents}/bin/lib/test-safe-exec.cjs +38 -38
  45. package/{get-shit-done → ez-agents}/bin/lib/test-safe-path.cjs +33 -33
  46. package/{get-shit-done → ez-agents}/bin/lib/test-temp-file.cjs +125 -125
  47. package/{get-shit-done → ez-agents}/bin/lib/timeout-exec.cjs +62 -62
  48. package/{get-shit-done → ez-agents}/bin/lib/verify.cjs +820 -820
  49. package/{get-shit-done → ez-agents}/references/checkpoints.md +776 -776
  50. package/{get-shit-done → ez-agents}/references/questioning.md +162 -162
  51. package/{get-shit-done → ez-agents}/references/tdd.md +263 -263
  52. package/{get-shit-done → ez-agents}/templates/codebase/concerns.md +310 -310
  53. package/{get-shit-done → ez-agents}/templates/codebase/conventions.md +307 -307
  54. package/{get-shit-done → ez-agents}/templates/codebase/integrations.md +280 -280
  55. package/{get-shit-done → ez-agents}/templates/codebase/stack.md +186 -186
  56. package/{get-shit-done → ez-agents}/templates/codebase/testing.md +480 -480
  57. package/{get-shit-done → ez-agents}/templates/config.json +37 -37
  58. package/{get-shit-done → ez-agents}/templates/continue-here.md +78 -78
  59. package/{get-shit-done → ez-agents}/templates/milestone-archive.md +123 -123
  60. package/{get-shit-done → ez-agents}/templates/milestone.md +115 -115
  61. package/{get-shit-done → ez-agents}/templates/requirements.md +231 -231
  62. package/{get-shit-done → ez-agents}/templates/research-project/ARCHITECTURE.md +204 -204
  63. package/{get-shit-done → ez-agents}/templates/research-project/FEATURES.md +147 -147
  64. package/{get-shit-done → ez-agents}/templates/research-project/PITFALLS.md +200 -200
  65. package/{get-shit-done → ez-agents}/templates/research-project/STACK.md +120 -120
  66. package/{get-shit-done → ez-agents}/templates/research-project/SUMMARY.md +170 -170
  67. package/{get-shit-done → ez-agents}/templates/retrospective.md +54 -54
  68. package/{get-shit-done → ez-agents}/templates/roadmap.md +202 -202
  69. package/{get-shit-done → ez-agents}/templates/summary-minimal.md +41 -41
  70. package/{get-shit-done → ez-agents}/templates/summary-standard.md +48 -48
  71. package/{get-shit-done → ez-agents}/templates/summary.md +248 -248
  72. package/{get-shit-done → ez-agents}/templates/user-setup.md +311 -311
  73. package/{get-shit-done → ez-agents}/templates/verification-report.md +322 -322
  74. package/{get-shit-done → ez-agents}/workflows/add-phase.md +112 -112
  75. package/{get-shit-done → ez-agents}/workflows/add-tests.md +351 -351
  76. package/{get-shit-done → ez-agents}/workflows/add-todo.md +158 -158
  77. package/{get-shit-done → ez-agents}/workflows/audit-milestone.md +332 -332
  78. package/{get-shit-done → ez-agents}/workflows/autonomous.md +743 -743
  79. package/{get-shit-done → ez-agents}/workflows/check-todos.md +177 -177
  80. package/{get-shit-done → ez-agents}/workflows/cleanup.md +152 -152
  81. package/{get-shit-done → ez-agents}/workflows/complete-milestone.md +766 -766
  82. package/ez-agents/workflows/debug.md +0 -0
  83. package/{get-shit-done → ez-agents}/workflows/diagnose-issues.md +219 -219
  84. package/{get-shit-done → ez-agents}/workflows/discovery-phase.md +289 -289
  85. package/{get-shit-done → ez-agents}/workflows/discuss-phase.md +762 -762
  86. package/{get-shit-done → ez-agents}/workflows/execute-phase.md +468 -468
  87. package/{get-shit-done → ez-agents}/workflows/execute-plan.md +483 -483
  88. package/{get-shit-done → ez-agents}/workflows/health.md +159 -159
  89. package/{get-shit-done → ez-agents}/workflows/help.md +492 -492
  90. package/{get-shit-done → ez-agents}/workflows/insert-phase.md +130 -130
  91. package/{get-shit-done → ez-agents}/workflows/list-phase-assumptions.md +178 -178
  92. package/{get-shit-done → ez-agents}/workflows/map-codebase.md +316 -316
  93. package/{get-shit-done → ez-agents}/workflows/new-milestone.md +384 -384
  94. package/{get-shit-done → ez-agents}/workflows/new-project.md +1111 -1111
  95. package/{get-shit-done → ez-agents}/workflows/node-repair.md +92 -92
  96. package/{get-shit-done → ez-agents}/workflows/pause-work.md +122 -122
  97. package/{get-shit-done → ez-agents}/workflows/plan-milestone-gaps.md +274 -274
  98. package/{get-shit-done → ez-agents}/workflows/plan-phase.md +651 -651
  99. package/{get-shit-done → ez-agents}/workflows/progress.md +382 -382
  100. package/{get-shit-done → ez-agents}/workflows/quick.md +610 -610
  101. package/{get-shit-done → ez-agents}/workflows/remove-phase.md +155 -155
  102. package/{get-shit-done → ez-agents}/workflows/research-phase.md +74 -74
  103. package/{get-shit-done → ez-agents}/workflows/resume-project.md +307 -307
  104. package/{get-shit-done → ez-agents}/workflows/set-profile.md +81 -81
  105. package/{get-shit-done → ez-agents}/workflows/settings.md +242 -242
  106. package/{get-shit-done → ez-agents}/workflows/stats.md +57 -57
  107. package/{get-shit-done → ez-agents}/workflows/transition.md +544 -544
  108. package/{get-shit-done → ez-agents}/workflows/ui-phase.md +290 -290
  109. package/{get-shit-done → ez-agents}/workflows/ui-review.md +157 -157
  110. package/{get-shit-done → ez-agents}/workflows/update.md +320 -320
  111. package/{get-shit-done → ez-agents}/workflows/validate-phase.md +167 -167
  112. package/{get-shit-done → ez-agents}/workflows/verify-phase.md +243 -243
  113. package/{get-shit-done → ez-agents}/workflows/verify-work.md +5 -5
  114. package/hooks/dist/ez-check-update.js +81 -0
  115. package/hooks/dist/ez-context-monitor.js +141 -0
  116. package/hooks/dist/ez-statusline.js +115 -0
  117. package/package.json +13 -3
  118. package/scripts/build-hooks.js +43 -43
  119. package/scripts/run-tests.cjs +29 -29
  120. /package/{get-shit-done → ez-agents}/references/continuation-format.md +0 -0
  121. /package/{get-shit-done → ez-agents}/references/decimal-phase-calculation.md +0 -0
  122. /package/{get-shit-done → ez-agents}/references/git-integration.md +0 -0
  123. /package/{get-shit-done → ez-agents}/references/git-planning-commit.md +0 -0
  124. /package/{get-shit-done → ez-agents}/references/model-profile-resolution.md +0 -0
  125. /package/{get-shit-done → ez-agents}/references/model-profiles.md +0 -0
  126. /package/{get-shit-done → ez-agents}/references/phase-argument-parsing.md +0 -0
  127. /package/{get-shit-done → ez-agents}/references/planning-config.md +0 -0
  128. /package/{get-shit-done → ez-agents}/references/ui-brand.md +0 -0
  129. /package/{get-shit-done → ez-agents}/references/verification-patterns.md +0 -0
  130. /package/{get-shit-done → ez-agents}/templates/DEBUG.md +0 -0
  131. /package/{get-shit-done → ez-agents}/templates/UAT.md +0 -0
  132. /package/{get-shit-done → ez-agents}/templates/UI-SPEC.md +0 -0
  133. /package/{get-shit-done → ez-agents}/templates/VALIDATION.md +0 -0
  134. /package/{get-shit-done → ez-agents}/templates/codebase/architecture.md +0 -0
  135. /package/{get-shit-done → ez-agents}/templates/codebase/structure.md +0 -0
  136. /package/{get-shit-done → ez-agents}/templates/context.md +0 -0
  137. /package/{get-shit-done → ez-agents}/templates/copilot-instructions.md +0 -0
  138. /package/{get-shit-done → ez-agents}/templates/debug-subagent-prompt.md +0 -0
  139. /package/{get-shit-done → ez-agents}/templates/discovery.md +0 -0
  140. /package/{get-shit-done → ez-agents}/templates/phase-prompt.md +0 -0
  141. /package/{get-shit-done → ez-agents}/templates/planner-subagent-prompt.md +0 -0
  142. /package/{get-shit-done → ez-agents}/templates/project.md +0 -0
  143. /package/{get-shit-done → ez-agents}/templates/research.md +0 -0
  144. /package/{get-shit-done → ez-agents}/templates/state.md +0 -0
  145. /package/{get-shit-done → ez-agents}/templates/summary-complex.md +0 -0
@@ -1,118 +1,118 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * GSD Circuit Breaker — Prevent cascading failures
5
- *
6
- * Implements circuit breaker pattern:
7
- * - CLOSED: Normal operation
8
- * - OPEN: Failing, reject requests
9
- * - HALF_OPEN: Testing if service recovered
10
- *
11
- * Usage:
12
- * const CircuitBreaker = require('./circuit-breaker.cjs');
13
- * const breaker = new CircuitBreaker({ failureThreshold: 5 });
14
- * const result = await breaker.execute(() => riskyOperation());
15
- */
16
-
17
- const Logger = require('./logger.cjs');
18
- const logger = new Logger();
19
-
20
- class CircuitBreaker {
21
- /**
22
- * Create circuit breaker
23
- * @param {Object} options - Configuration
24
- */
25
- constructor(options = {}) {
26
- this.failureThreshold = options.failureThreshold || 5;
27
- this.resetTimeout = options.resetTimeout || 60000;
28
- this.state = 'CLOSED';
29
- this.failures = 0;
30
- this.lastFailureTime = null;
31
- this.successes = 0;
32
- }
33
-
34
- /**
35
- * Execute operation with circuit breaker protection
36
- * @param {Function} operation - Async function to execute
37
- * @returns {Promise<any>} - Result of operation
38
- */
39
- async execute(operation) {
40
- // Check if circuit is OPEN
41
- if (this.state === 'OPEN') {
42
- const timeSinceFailure = Date.now() - this.lastFailureTime;
43
-
44
- if (timeSinceFailure > this.resetTimeout) {
45
- // Try to recover
46
- this.state = 'HALF_OPEN';
47
- this.failures = 0;
48
- logger.info('Circuit breaker HALF_OPEN - testing recovery');
49
- } else {
50
- const waitTime = Math.round((this.resetTimeout - timeSinceFailure) / 1000);
51
- logger.warn('Circuit breaker OPEN - rejecting request', { waitTime });
52
- throw new Error(`Circuit breaker is OPEN. Try again in ${waitTime}s`);
53
- }
54
- }
55
-
56
- try {
57
- const result = await operation();
58
-
59
- // Success - reset counters if in HALF_OPEN
60
- if (this.state === 'HALF_OPEN') {
61
- this.state = 'CLOSED';
62
- this.failures = 0;
63
- logger.info('Circuit breaker CLOSED - service recovered');
64
- }
65
-
66
- this.successes++;
67
- return result;
68
- } catch (err) {
69
- this.failures++;
70
- this.lastFailureTime = Date.now();
71
-
72
- // Open circuit if threshold reached
73
- if (this.failures >= this.failureThreshold) {
74
- this.state = 'OPEN';
75
- logger.error('Circuit breaker OPEN - failure threshold reached', {
76
- failures: this.failures
77
- });
78
- }
79
-
80
- throw err;
81
- }
82
- }
83
-
84
- /**
85
- * Get current state
86
- * @returns {string} - CLOSED, OPEN, or HALF_OPEN
87
- */
88
- getState() {
89
- return this.state;
90
- }
91
-
92
- /**
93
- * Get stats
94
- * @returns {Object} - Statistics
95
- */
96
- getStats() {
97
- return {
98
- state: this.state,
99
- failures: this.failures,
100
- successes: this.successes,
101
- failureThreshold: this.failureThreshold,
102
- lastFailureTime: this.lastFailureTime
103
- };
104
- }
105
-
106
- /**
107
- * Reset circuit breaker
108
- */
109
- reset() {
110
- this.state = 'CLOSED';
111
- this.failures = 0;
112
- this.successes = 0;
113
- this.lastFailureTime = null;
114
- logger.info('Circuit breaker reset');
115
- }
116
- }
117
-
118
- module.exports = CircuitBreaker;
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * GSD Circuit Breaker — Prevent cascading failures
5
+ *
6
+ * Implements circuit breaker pattern:
7
+ * - CLOSED: Normal operation
8
+ * - OPEN: Failing, reject requests
9
+ * - HALF_OPEN: Testing if service recovered
10
+ *
11
+ * Usage:
12
+ * const CircuitBreaker = require('./circuit-breaker.cjs');
13
+ * const breaker = new CircuitBreaker({ failureThreshold: 5 });
14
+ * const result = await breaker.execute(() => riskyOperation());
15
+ */
16
+
17
+ const Logger = require('./logger.cjs');
18
+ const logger = new Logger();
19
+
20
+ class CircuitBreaker {
21
+ /**
22
+ * Create circuit breaker
23
+ * @param {Object} options - Configuration
24
+ */
25
+ constructor(options = {}) {
26
+ this.failureThreshold = options.failureThreshold || 5;
27
+ this.resetTimeout = options.resetTimeout || 60000;
28
+ this.state = 'CLOSED';
29
+ this.failures = 0;
30
+ this.lastFailureTime = null;
31
+ this.successes = 0;
32
+ }
33
+
34
+ /**
35
+ * Execute operation with circuit breaker protection
36
+ * @param {Function} operation - Async function to execute
37
+ * @returns {Promise<any>} - Result of operation
38
+ */
39
+ async execute(operation) {
40
+ // Check if circuit is OPEN
41
+ if (this.state === 'OPEN') {
42
+ const timeSinceFailure = Date.now() - this.lastFailureTime;
43
+
44
+ if (timeSinceFailure > this.resetTimeout) {
45
+ // Try to recover
46
+ this.state = 'HALF_OPEN';
47
+ this.failures = 0;
48
+ logger.info('Circuit breaker HALF_OPEN - testing recovery');
49
+ } else {
50
+ const waitTime = Math.round((this.resetTimeout - timeSinceFailure) / 1000);
51
+ logger.warn('Circuit breaker OPEN - rejecting request', { waitTime });
52
+ throw new Error(`Circuit breaker is OPEN. Try again in ${waitTime}s`);
53
+ }
54
+ }
55
+
56
+ try {
57
+ const result = await operation();
58
+
59
+ // Success - reset counters if in HALF_OPEN
60
+ if (this.state === 'HALF_OPEN') {
61
+ this.state = 'CLOSED';
62
+ this.failures = 0;
63
+ logger.info('Circuit breaker CLOSED - service recovered');
64
+ }
65
+
66
+ this.successes++;
67
+ return result;
68
+ } catch (err) {
69
+ this.failures++;
70
+ this.lastFailureTime = Date.now();
71
+
72
+ // Open circuit if threshold reached
73
+ if (this.failures >= this.failureThreshold) {
74
+ this.state = 'OPEN';
75
+ logger.error('Circuit breaker OPEN - failure threshold reached', {
76
+ failures: this.failures
77
+ });
78
+ }
79
+
80
+ throw err;
81
+ }
82
+ }
83
+
84
+ /**
85
+ * Get current state
86
+ * @returns {string} - CLOSED, OPEN, or HALF_OPEN
87
+ */
88
+ getState() {
89
+ return this.state;
90
+ }
91
+
92
+ /**
93
+ * Get stats
94
+ * @returns {Object} - Statistics
95
+ */
96
+ getStats() {
97
+ return {
98
+ state: this.state,
99
+ failures: this.failures,
100
+ successes: this.successes,
101
+ failureThreshold: this.failureThreshold,
102
+ lastFailureTime: this.lastFailureTime
103
+ };
104
+ }
105
+
106
+ /**
107
+ * Reset circuit breaker
108
+ */
109
+ reset() {
110
+ this.state = 'CLOSED';
111
+ this.failures = 0;
112
+ this.successes = 0;
113
+ this.lastFailureTime = null;
114
+ logger.info('Circuit breaker reset');
115
+ }
116
+ }
117
+
118
+ module.exports = CircuitBreaker;