@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,153 +1,153 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * EZ FS Utils — Cross-platform file system utilities
5
- *
6
- * Replaces Unix commands (find, grep, head, tail) with
7
- * cross-platform JavaScript implementations.
8
- *
9
- * Usage:
10
- * const { findFiles, grepContent, readLines } = require('./fs-utils.cjs');
11
- * const files = await findFiles('./src', /\.js$/);
12
- */
13
-
14
- const fs = require('fs');
15
- const path = require('path');
16
- const Logger = require('./logger.cjs');
17
- const logger = new Logger();
18
-
19
- /**
20
- * Find files matching patterns (cross-platform find replacement)
21
- * @param {string} dir - Directory to search
22
- * @param {RegExp[]} patterns - File patterns to match
23
- * @param {Object} options - Search options
24
- * @returns {string[]} - Array of matching file paths
25
- */
26
- function findFiles(dir, patterns, options = {}) {
27
- const { maxDepth = 5, exclude = ['node_modules', '.git', '.planning'] } = options;
28
- const results = [];
29
-
30
- function recurse(currentDir, depth) {
31
- if (depth > maxDepth) return;
32
-
33
- let entries;
34
- try {
35
- entries = fs.readdirSync(currentDir, { withFileTypes: true });
36
- } catch (err) {
37
- logger.warn('Cannot read directory', { dir: currentDir, error: err.message });
38
- return;
39
- }
40
-
41
- for (const entry of entries) {
42
- if (exclude.includes(entry.name)) continue;
43
-
44
- const fullPath = path.join(currentDir, entry.name);
45
-
46
- if (entry.isDirectory()) {
47
- recurse(fullPath, depth + 1);
48
- } else if (patterns.some(p => p.test(entry.name))) {
49
- results.push(fullPath);
50
- }
51
- }
52
- }
53
-
54
- recurse(dir, 0);
55
- return results;
56
- }
57
-
58
- /**
59
- * Search file content (cross-platform grep replacement)
60
- * @param {string} filePath - File to search
61
- * @param {RegExp} pattern - Pattern to match
62
- * @returns {Object[]} - Array of { line, lineNumber, match }
63
- */
64
- function grepContent(filePath, pattern) {
65
- const results = [];
66
-
67
- try {
68
- const content = fs.readFileSync(filePath, 'utf-8');
69
- const lines = content.split('\n');
70
-
71
- lines.forEach((line, index) => {
72
- if (pattern.test(line)) {
73
- results.push({
74
- line: line.trim(),
75
- lineNumber: index + 1,
76
- match: line.match(pattern)?.[0]
77
- });
78
- }
79
- });
80
- } catch (err) {
81
- logger.warn('Cannot read file for grep', { filePath, error: err.message });
82
- }
83
-
84
- return results;
85
- }
86
-
87
- /**
88
- * Read first N lines (cross-platform head replacement)
89
- * @param {string} filePath - File to read
90
- * @param {number} count - Number of lines
91
- * @returns {string[]} - Array of lines
92
- */
93
- function readFirstLines(filePath, count = 10) {
94
- try {
95
- const content = fs.readFileSync(filePath, 'utf-8');
96
- return content.split('\n').slice(0, count);
97
- } catch (err) {
98
- logger.warn('Cannot read file', { filePath, error: err.message });
99
- return [];
100
- }
101
- }
102
-
103
- /**
104
- * Read last N lines (cross-platform tail replacement)
105
- * @param {string} filePath - File to read
106
- * @param {number} count - Number of lines
107
- * @returns {string[]} - Array of lines
108
- */
109
- function readLastLines(filePath, count = 10) {
110
- try {
111
- const content = fs.readFileSync(filePath, 'utf-8');
112
- const lines = content.split('\n');
113
- return lines.slice(-count);
114
- } catch (err) {
115
- logger.warn('Cannot read file', { filePath, error: err.message });
116
- return [];
117
- }
118
- }
119
-
120
- /**
121
- * Count lines in file (cross-platform wc -l replacement)
122
- * @param {string} filePath - File to count
123
- * @returns {number} - Line count
124
- */
125
- function countLines(filePath) {
126
- try {
127
- const content = fs.readFileSync(filePath, 'utf-8');
128
- return content.split('\n').length;
129
- } catch (err) {
130
- logger.warn('Cannot count lines', { filePath, error: err.message });
131
- return 0;
132
- }
133
- }
134
-
135
- /**
136
- * Ensure directory exists
137
- * @param {string} dirPath - Directory path
138
- */
139
- function ensureDir(dirPath) {
140
- if (!fs.existsSync(dirPath)) {
141
- fs.mkdirSync(dirPath, { recursive: true });
142
- logger.debug('Directory created', { dir: dirPath });
143
- }
144
- }
145
-
146
- module.exports = {
147
- findFiles,
148
- grepContent,
149
- readFirstLines,
150
- readLastLines,
151
- countLines,
152
- ensureDir
153
- };
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * EZ FS Utils — Cross-platform file system utilities
5
+ *
6
+ * Replaces Unix commands (find, grep, head, tail) with
7
+ * cross-platform JavaScript implementations.
8
+ *
9
+ * Usage:
10
+ * const { findFiles, grepContent, readLines } = require('./fs-utils.cjs');
11
+ * const files = await findFiles('./src', /\.js$/);
12
+ */
13
+
14
+ const fs = require('fs');
15
+ const path = require('path');
16
+ const Logger = require('./logger.cjs');
17
+ const logger = new Logger();
18
+
19
+ /**
20
+ * Find files matching patterns (cross-platform find replacement)
21
+ * @param {string} dir - Directory to search
22
+ * @param {RegExp[]} patterns - File patterns to match
23
+ * @param {Object} options - Search options
24
+ * @returns {string[]} - Array of matching file paths
25
+ */
26
+ function findFiles(dir, patterns, options = {}) {
27
+ const { maxDepth = 5, exclude = ['node_modules', '.git', '.planning'] } = options;
28
+ const results = [];
29
+
30
+ function recurse(currentDir, depth) {
31
+ if (depth > maxDepth) return;
32
+
33
+ let entries;
34
+ try {
35
+ entries = fs.readdirSync(currentDir, { withFileTypes: true });
36
+ } catch (err) {
37
+ logger.warn('Cannot read directory', { dir: currentDir, error: err.message });
38
+ return;
39
+ }
40
+
41
+ for (const entry of entries) {
42
+ if (exclude.includes(entry.name)) continue;
43
+
44
+ const fullPath = path.join(currentDir, entry.name);
45
+
46
+ if (entry.isDirectory()) {
47
+ recurse(fullPath, depth + 1);
48
+ } else if (patterns.some(p => p.test(entry.name))) {
49
+ results.push(fullPath);
50
+ }
51
+ }
52
+ }
53
+
54
+ recurse(dir, 0);
55
+ return results;
56
+ }
57
+
58
+ /**
59
+ * Search file content (cross-platform grep replacement)
60
+ * @param {string} filePath - File to search
61
+ * @param {RegExp} pattern - Pattern to match
62
+ * @returns {Object[]} - Array of { line, lineNumber, match }
63
+ */
64
+ function grepContent(filePath, pattern) {
65
+ const results = [];
66
+
67
+ try {
68
+ const content = fs.readFileSync(filePath, 'utf-8');
69
+ const lines = content.split('\n');
70
+
71
+ lines.forEach((line, index) => {
72
+ if (pattern.test(line)) {
73
+ results.push({
74
+ line: line.trim(),
75
+ lineNumber: index + 1,
76
+ match: line.match(pattern)?.[0]
77
+ });
78
+ }
79
+ });
80
+ } catch (err) {
81
+ logger.warn('Cannot read file for grep', { filePath, error: err.message });
82
+ }
83
+
84
+ return results;
85
+ }
86
+
87
+ /**
88
+ * Read first N lines (cross-platform head replacement)
89
+ * @param {string} filePath - File to read
90
+ * @param {number} count - Number of lines
91
+ * @returns {string[]} - Array of lines
92
+ */
93
+ function readFirstLines(filePath, count = 10) {
94
+ try {
95
+ const content = fs.readFileSync(filePath, 'utf-8');
96
+ return content.split('\n').slice(0, count);
97
+ } catch (err) {
98
+ logger.warn('Cannot read file', { filePath, error: err.message });
99
+ return [];
100
+ }
101
+ }
102
+
103
+ /**
104
+ * Read last N lines (cross-platform tail replacement)
105
+ * @param {string} filePath - File to read
106
+ * @param {number} count - Number of lines
107
+ * @returns {string[]} - Array of lines
108
+ */
109
+ function readLastLines(filePath, count = 10) {
110
+ try {
111
+ const content = fs.readFileSync(filePath, 'utf-8');
112
+ const lines = content.split('\n');
113
+ return lines.slice(-count);
114
+ } catch (err) {
115
+ logger.warn('Cannot read file', { filePath, error: err.message });
116
+ return [];
117
+ }
118
+ }
119
+
120
+ /**
121
+ * Count lines in file (cross-platform wc -l replacement)
122
+ * @param {string} filePath - File to count
123
+ * @returns {number} - Line count
124
+ */
125
+ function countLines(filePath) {
126
+ try {
127
+ const content = fs.readFileSync(filePath, 'utf-8');
128
+ return content.split('\n').length;
129
+ } catch (err) {
130
+ logger.warn('Cannot count lines', { filePath, error: err.message });
131
+ return 0;
132
+ }
133
+ }
134
+
135
+ /**
136
+ * Ensure directory exists
137
+ * @param {string} dirPath - Directory path
138
+ */
139
+ function ensureDir(dirPath) {
140
+ if (!fs.existsSync(dirPath)) {
141
+ fs.mkdirSync(dirPath, { recursive: true });
142
+ logger.debug('Directory created', { dir: dirPath });
143
+ }
144
+ }
145
+
146
+ module.exports = {
147
+ findFiles,
148
+ grepContent,
149
+ readFirstLines,
150
+ readLastLines,
151
+ countLines,
152
+ ensureDir
153
+ };