@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,125 +1,125 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Test script for EZ Temp File Handler
5
- * Run: node ez-agents/bin/lib/test-temp-file.cjs
6
- */
7
-
8
- const os = require('os');
9
- const path = require('path');
10
- const fs = require('fs');
11
-
12
- const {
13
- createTempDir,
14
- createTempFile,
15
- writeToTemp,
16
- readFromTemp,
17
- cleanupTemp,
18
- cleanupAll,
19
- getTrackedTemps,
20
- isPathSafe
21
- } = require('./temp-file.cjs');
22
-
23
- async function testCreateTempDir() {
24
- console.log('\n=== Test 1: Create Temp Directory ===');
25
-
26
- const tempDir = await createTempDir('ez-test-');
27
- console.log('Created temp dir:', tempDir);
28
-
29
- const exists = require('fs').existsSync(tempDir);
30
- console.log('Directory exists:', exists);
31
-
32
- if (!exists) throw new Error('Temp dir was not created');
33
- console.log('✓ Temp directory created successfully');
34
-
35
- return tempDir;
36
- }
37
-
38
- async function testCreateTempFile(tempDir) {
39
- console.log('\n=== Test 2: Create Temp File ===');
40
-
41
- const tempFile = await createTempFile('test-', tempDir, 'Initial content');
42
- console.log('Created temp file:', tempFile);
43
-
44
- const content = await readFromTemp(tempFile, { validateBase: tempDir });
45
- console.log('File content:', content);
46
-
47
- if (content !== 'Initial content') {
48
- throw new Error('File content mismatch');
49
- }
50
- console.log('✓ Temp file created and read successfully');
51
-
52
- return tempFile;
53
- }
54
-
55
- async function testWriteToTemp(tempFile, tempDir) {
56
- console.log('\n=== Test 3: Write to Temp File ===');
57
-
58
- await writeToTemp(tempFile, 'Updated content', { validateBase: tempDir });
59
- const content = await readFromTemp(tempFile, { validateBase: tempDir });
60
-
61
- console.log('Updated content:', content);
62
-
63
- if (content !== 'Updated content') {
64
- throw new Error('Write failed');
65
- }
66
- console.log('✓ Temp file write successful');
67
- }
68
-
69
- async function testPathSafety() {
70
- console.log('\n=== Test 4: Path Safety Validation ===');
71
-
72
- const baseDir = os.tmpdir();
73
-
74
- // Safe paths
75
- console.log('Safe path (same dir):', isPathSafe(baseDir, path.join(baseDir, 'file.txt')));
76
- console.log('Safe path (subdir):', isPathSafe(baseDir, path.join(baseDir, 'sub', 'file.txt')));
77
-
78
- // Unsafe paths (should be false)
79
- const unsafePath = path.resolve(baseDir, '..', '..', 'etc', 'passwd');
80
- console.log('Unsafe path (/etc/passwd):', isPathSafe(baseDir, unsafePath));
81
-
82
- console.log('✓ Path safety validation working');
83
- }
84
-
85
- async function testCleanup(tempFile, tempDir) {
86
- console.log('\n=== Test 5: Cleanup ===');
87
-
88
- console.log('Tracked temps before cleanup:', getTrackedTemps().length);
89
-
90
- await cleanupTemp(tempFile);
91
- console.log('Cleaned up temp file');
92
-
93
- const fileExists = require('fs').existsSync(tempFile);
94
- console.log('Temp file exists after cleanup:', fileExists);
95
-
96
- await cleanupAll();
97
- console.log('Cleaned up all temps');
98
-
99
- const dirExists = require('fs').existsSync(tempDir);
100
- console.log('Temp dir exists after cleanup:', dirExists);
101
-
102
- console.log('✓ Cleanup successful');
103
- }
104
-
105
- async function runTests() {
106
- const os = require('os');
107
- const path = require('path');
108
-
109
- try {
110
- const tempDir = await testCreateTempDir();
111
- const tempFile = await testCreateTempFile(tempDir);
112
- await testWriteToTemp(tempFile, tempDir);
113
- await testPathSafety();
114
- await testCleanup(tempFile, tempDir);
115
-
116
- console.log('\n' + '='.repeat(50));
117
- console.log('Temp File Handler test COMPLETE ✓');
118
- console.log('='.repeat(50));
119
- } catch (err) {
120
- console.error('Test failed:', err);
121
- process.exit(1);
122
- }
123
- }
124
-
125
- runTests();
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Test script for EZ Temp File Handler
5
+ * Run: node ez-agents/bin/lib/test-temp-file.cjs
6
+ */
7
+
8
+ const os = require('os');
9
+ const path = require('path');
10
+ const fs = require('fs');
11
+
12
+ const {
13
+ createTempDir,
14
+ createTempFile,
15
+ writeToTemp,
16
+ readFromTemp,
17
+ cleanupTemp,
18
+ cleanupAll,
19
+ getTrackedTemps,
20
+ isPathSafe
21
+ } = require('./temp-file.cjs');
22
+
23
+ async function testCreateTempDir() {
24
+ console.log('\n=== Test 1: Create Temp Directory ===');
25
+
26
+ const tempDir = await createTempDir('ez-test-');
27
+ console.log('Created temp dir:', tempDir);
28
+
29
+ const exists = require('fs').existsSync(tempDir);
30
+ console.log('Directory exists:', exists);
31
+
32
+ if (!exists) throw new Error('Temp dir was not created');
33
+ console.log('✓ Temp directory created successfully');
34
+
35
+ return tempDir;
36
+ }
37
+
38
+ async function testCreateTempFile(tempDir) {
39
+ console.log('\n=== Test 2: Create Temp File ===');
40
+
41
+ const tempFile = await createTempFile('test-', tempDir, 'Initial content');
42
+ console.log('Created temp file:', tempFile);
43
+
44
+ const content = await readFromTemp(tempFile, { validateBase: tempDir });
45
+ console.log('File content:', content);
46
+
47
+ if (content !== 'Initial content') {
48
+ throw new Error('File content mismatch');
49
+ }
50
+ console.log('✓ Temp file created and read successfully');
51
+
52
+ return tempFile;
53
+ }
54
+
55
+ async function testWriteToTemp(tempFile, tempDir) {
56
+ console.log('\n=== Test 3: Write to Temp File ===');
57
+
58
+ await writeToTemp(tempFile, 'Updated content', { validateBase: tempDir });
59
+ const content = await readFromTemp(tempFile, { validateBase: tempDir });
60
+
61
+ console.log('Updated content:', content);
62
+
63
+ if (content !== 'Updated content') {
64
+ throw new Error('Write failed');
65
+ }
66
+ console.log('✓ Temp file write successful');
67
+ }
68
+
69
+ async function testPathSafety() {
70
+ console.log('\n=== Test 4: Path Safety Validation ===');
71
+
72
+ const baseDir = os.tmpdir();
73
+
74
+ // Safe paths
75
+ console.log('Safe path (same dir):', isPathSafe(baseDir, path.join(baseDir, 'file.txt')));
76
+ console.log('Safe path (subdir):', isPathSafe(baseDir, path.join(baseDir, 'sub', 'file.txt')));
77
+
78
+ // Unsafe paths (should be false)
79
+ const unsafePath = path.resolve(baseDir, '..', '..', 'etc', 'passwd');
80
+ console.log('Unsafe path (/etc/passwd):', isPathSafe(baseDir, unsafePath));
81
+
82
+ console.log('✓ Path safety validation working');
83
+ }
84
+
85
+ async function testCleanup(tempFile, tempDir) {
86
+ console.log('\n=== Test 5: Cleanup ===');
87
+
88
+ console.log('Tracked temps before cleanup:', getTrackedTemps().length);
89
+
90
+ await cleanupTemp(tempFile);
91
+ console.log('Cleaned up temp file');
92
+
93
+ const fileExists = require('fs').existsSync(tempFile);
94
+ console.log('Temp file exists after cleanup:', fileExists);
95
+
96
+ await cleanupAll();
97
+ console.log('Cleaned up all temps');
98
+
99
+ const dirExists = require('fs').existsSync(tempDir);
100
+ console.log('Temp dir exists after cleanup:', dirExists);
101
+
102
+ console.log('✓ Cleanup successful');
103
+ }
104
+
105
+ async function runTests() {
106
+ const os = require('os');
107
+ const path = require('path');
108
+
109
+ try {
110
+ const tempDir = await testCreateTempDir();
111
+ const tempFile = await testCreateTempFile(tempDir);
112
+ await testWriteToTemp(tempFile, tempDir);
113
+ await testPathSafety();
114
+ await testCleanup(tempFile, tempDir);
115
+
116
+ console.log('\n' + '='.repeat(50));
117
+ console.log('Temp File Handler test COMPLETE ✓');
118
+ console.log('='.repeat(50));
119
+ } catch (err) {
120
+ console.error('Test failed:', err);
121
+ process.exit(1);
122
+ }
123
+ }
124
+
125
+ runTests();
@@ -1,63 +1,63 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * EZ Timeout Exec — Command execution with timeout and fallback
5
- *
6
- * Provides safe command execution with configurable timeout
7
- * Logs errors and supports fallback values
8
- *
9
- * Usage:
10
- * const { execWithTimeout } = require('./timeout-exec.cjs');
11
- * const result = await execWithTimeout('node', ['script.js'], { timeout: 5000, fallback: 'default' });
12
- */
13
-
14
- const { execFile } = require('child_process');
15
- const { promisify } = require('util');
16
- const execFileAsync = promisify(execFile);
17
- const Logger = require('./logger.cjs');
18
- const logger = new Logger();
19
-
20
- const DEFAULT_TIMEOUT = 5000; // 5 seconds
21
-
22
- /**
23
- * Execute a command with timeout
24
- * @param {string} cmd - Command to execute
25
- * @param {string[]} args - Command arguments
26
- * @param {Object} options - Execution options
27
- * @param {number} options.timeout - Timeout in milliseconds (default: 5000)
28
- * @param {any} options.fallback - Fallback value if command fails or times out
29
- * @returns {Promise<string>} - Command stdout or fallback value
30
- */
31
- async function execWithTimeout(cmd, args, options = {}) {
32
- const { timeout = DEFAULT_TIMEOUT, fallback = null } = options;
33
- const hasFallback = Object.prototype.hasOwnProperty.call(options, 'fallback');
34
-
35
- return new Promise(async (resolve, reject) => {
36
- const timeoutId = setTimeout(() => {
37
- logger.error(`Command timed out: ${cmd} ${args.join(' ')}`, { timeout });
38
- if (hasFallback) {
39
- logger.info('Using fallback value', { fallback });
40
- resolve(fallback);
41
- } else {
42
- reject(new Error(`Command timed out after ${timeout}ms: ${cmd}`));
43
- }
44
- }, timeout);
45
-
46
- try {
47
- const result = await execFileAsync(cmd, args, { timeout });
48
- clearTimeout(timeoutId);
49
- resolve(result.stdout.trim());
50
- } catch (err) {
51
- clearTimeout(timeoutId);
52
- logger.error(`Command failed: ${cmd}`, { error: err.message, args });
53
- if (hasFallback) {
54
- logger.info('Using fallback value', { fallback });
55
- resolve(fallback);
56
- } else {
57
- reject(err);
58
- }
59
- }
60
- });
61
- }
62
-
63
- module.exports = { execWithTimeout };
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * EZ Timeout Exec — Command execution with timeout and fallback
5
+ *
6
+ * Provides safe command execution with configurable timeout
7
+ * Logs errors and supports fallback values
8
+ *
9
+ * Usage:
10
+ * const { execWithTimeout } = require('./timeout-exec.cjs');
11
+ * const result = await execWithTimeout('node', ['script.js'], { timeout: 5000, fallback: 'default' });
12
+ */
13
+
14
+ const { execFile } = require('child_process');
15
+ const { promisify } = require('util');
16
+ const execFileAsync = promisify(execFile);
17
+ const Logger = require('./logger.cjs');
18
+ const logger = new Logger();
19
+
20
+ const DEFAULT_TIMEOUT = 5000; // 5 seconds
21
+
22
+ /**
23
+ * Execute a command with timeout
24
+ * @param {string} cmd - Command to execute
25
+ * @param {string[]} args - Command arguments
26
+ * @param {Object} options - Execution options
27
+ * @param {number} options.timeout - Timeout in milliseconds (default: 5000)
28
+ * @param {any} options.fallback - Fallback value if command fails or times out
29
+ * @returns {Promise<string>} - Command stdout or fallback value
30
+ */
31
+ async function execWithTimeout(cmd, args, options = {}) {
32
+ const { timeout = DEFAULT_TIMEOUT, fallback = null } = options;
33
+ const hasFallback = Object.prototype.hasOwnProperty.call(options, 'fallback');
34
+
35
+ return new Promise(async (resolve, reject) => {
36
+ const timeoutId = setTimeout(() => {
37
+ logger.error(`Command timed out: ${cmd} ${args.join(' ')}`, { timeout });
38
+ if (hasFallback) {
39
+ logger.info('Using fallback value', { fallback });
40
+ resolve(fallback);
41
+ } else {
42
+ reject(new Error(`Command timed out after ${timeout}ms: ${cmd}`));
43
+ }
44
+ }, timeout);
45
+
46
+ try {
47
+ const result = await execFileAsync(cmd, args, { timeout });
48
+ clearTimeout(timeoutId);
49
+ resolve(result.stdout.trim());
50
+ } catch (err) {
51
+ clearTimeout(timeoutId);
52
+ logger.error(`Command failed: ${cmd}`, { error: err.message, args });
53
+ if (hasFallback) {
54
+ logger.info('Using fallback value', { fallback });
55
+ resolve(fallback);
56
+ } else {
57
+ reject(err);
58
+ }
59
+ }
60
+ });
61
+ }
62
+
63
+ module.exports = { execWithTimeout };
@@ -270,11 +270,25 @@ async function cmdVerifyCommits(cwd, hashes, raw) {
270
270
  const valid = [];
271
271
  const invalid = [];
272
272
  for (const hash of hashes) {
273
+ // Use git cat-file -t which supports both short and full hashes
274
+ // First try with the hash as-is (works for both short and full)
273
275
  const result = await execGit(cwd, ['cat-file', '-t', hash]);
274
276
  if (result.exitCode === 0 && result.stdout.trim() === 'commit') {
275
277
  valid.push(hash);
276
278
  } else {
277
- invalid.push(hash);
279
+ // If that fails, try to resolve to full hash first
280
+ const resolveResult = await execGit(cwd, ['rev-parse', hash]);
281
+ if (resolveResult.exitCode === 0) {
282
+ const fullHash = resolveResult.stdout.trim();
283
+ const result2 = await execGit(cwd, ['cat-file', '-t', fullHash]);
284
+ if (result2.exitCode === 0 && result2.stdout.trim() === 'commit') {
285
+ valid.push(hash);
286
+ } else {
287
+ invalid.push(hash);
288
+ }
289
+ } else {
290
+ invalid.push(hash);
291
+ }
278
292
  }
279
293
  }
280
294