@howlil/ez-agents 2.0.0 → 2.0.1

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 (106) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  3. package/agents/ez-plan-checker.md +2 -2
  4. package/agents/ez-research-synthesizer.md +1 -1
  5. package/agents/ez-ui-researcher.md +1 -1
  6. package/agents/ez-verifier.md +1 -1
  7. package/bin/install.js +132 -132
  8. package/get-shit-done/bin/lib/assistant-adapter.cjs +205 -205
  9. package/get-shit-done/bin/lib/audit-exec.cjs +150 -150
  10. package/get-shit-done/bin/lib/auth.cjs +175 -175
  11. package/get-shit-done/bin/lib/circuit-breaker.cjs +118 -118
  12. package/get-shit-done/bin/lib/commands.cjs +666 -666
  13. package/get-shit-done/bin/lib/config.cjs +183 -183
  14. package/get-shit-done/bin/lib/core.cjs +495 -495
  15. package/get-shit-done/bin/lib/file-lock.cjs +236 -236
  16. package/get-shit-done/bin/lib/frontmatter.cjs +299 -299
  17. package/get-shit-done/bin/lib/fs-utils.cjs +153 -153
  18. package/get-shit-done/bin/lib/git-utils.cjs +203 -203
  19. package/get-shit-done/bin/lib/health-check.cjs +163 -163
  20. package/get-shit-done/bin/lib/index.cjs +113 -113
  21. package/get-shit-done/bin/lib/init.cjs +710 -710
  22. package/get-shit-done/bin/lib/logger.cjs +117 -117
  23. package/get-shit-done/bin/lib/milestone.cjs +241 -241
  24. package/get-shit-done/bin/lib/model-provider.cjs +146 -146
  25. package/get-shit-done/bin/lib/phase.cjs +908 -908
  26. package/get-shit-done/bin/lib/retry.cjs +119 -119
  27. package/get-shit-done/bin/lib/roadmap.cjs +305 -305
  28. package/get-shit-done/bin/lib/safe-exec.cjs +128 -128
  29. package/get-shit-done/bin/lib/safe-path.cjs +130 -130
  30. package/get-shit-done/bin/lib/state.cjs +721 -721
  31. package/get-shit-done/bin/lib/temp-file.cjs +239 -239
  32. package/get-shit-done/bin/lib/template.cjs +222 -222
  33. package/get-shit-done/bin/lib/test-file-lock.cjs +112 -112
  34. package/get-shit-done/bin/lib/test-graceful.cjs +93 -93
  35. package/get-shit-done/bin/lib/test-logger.cjs +60 -60
  36. package/get-shit-done/bin/lib/test-safe-exec.cjs +38 -38
  37. package/get-shit-done/bin/lib/test-safe-path.cjs +33 -33
  38. package/get-shit-done/bin/lib/test-temp-file.cjs +125 -125
  39. package/get-shit-done/bin/lib/timeout-exec.cjs +62 -62
  40. package/get-shit-done/bin/lib/verify.cjs +820 -820
  41. package/get-shit-done/references/checkpoints.md +776 -776
  42. package/get-shit-done/references/questioning.md +162 -162
  43. package/get-shit-done/references/tdd.md +263 -263
  44. package/get-shit-done/templates/codebase/concerns.md +310 -310
  45. package/get-shit-done/templates/codebase/conventions.md +307 -307
  46. package/get-shit-done/templates/codebase/integrations.md +280 -280
  47. package/get-shit-done/templates/codebase/stack.md +186 -186
  48. package/get-shit-done/templates/codebase/testing.md +480 -480
  49. package/get-shit-done/templates/config.json +37 -37
  50. package/get-shit-done/templates/continue-here.md +78 -78
  51. package/get-shit-done/templates/milestone-archive.md +123 -123
  52. package/get-shit-done/templates/milestone.md +115 -115
  53. package/get-shit-done/templates/requirements.md +231 -231
  54. package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -204
  55. package/get-shit-done/templates/research-project/FEATURES.md +147 -147
  56. package/get-shit-done/templates/research-project/PITFALLS.md +200 -200
  57. package/get-shit-done/templates/research-project/STACK.md +120 -120
  58. package/get-shit-done/templates/research-project/SUMMARY.md +170 -170
  59. package/get-shit-done/templates/retrospective.md +54 -54
  60. package/get-shit-done/templates/roadmap.md +202 -202
  61. package/get-shit-done/templates/summary-minimal.md +41 -41
  62. package/get-shit-done/templates/summary-standard.md +48 -48
  63. package/get-shit-done/templates/summary.md +248 -248
  64. package/get-shit-done/templates/user-setup.md +311 -311
  65. package/get-shit-done/templates/verification-report.md +322 -322
  66. package/get-shit-done/workflows/add-phase.md +112 -112
  67. package/get-shit-done/workflows/add-tests.md +351 -351
  68. package/get-shit-done/workflows/add-todo.md +158 -158
  69. package/get-shit-done/workflows/audit-milestone.md +332 -332
  70. package/get-shit-done/workflows/autonomous.md +743 -743
  71. package/get-shit-done/workflows/check-todos.md +177 -177
  72. package/get-shit-done/workflows/cleanup.md +152 -152
  73. package/get-shit-done/workflows/complete-milestone.md +766 -766
  74. package/get-shit-done/workflows/diagnose-issues.md +219 -219
  75. package/get-shit-done/workflows/discovery-phase.md +289 -289
  76. package/get-shit-done/workflows/discuss-phase.md +762 -762
  77. package/get-shit-done/workflows/execute-phase.md +468 -468
  78. package/get-shit-done/workflows/execute-plan.md +483 -483
  79. package/get-shit-done/workflows/health.md +159 -159
  80. package/get-shit-done/workflows/help.md +492 -492
  81. package/get-shit-done/workflows/insert-phase.md +130 -130
  82. package/get-shit-done/workflows/list-phase-assumptions.md +178 -178
  83. package/get-shit-done/workflows/map-codebase.md +316 -316
  84. package/get-shit-done/workflows/new-milestone.md +384 -384
  85. package/get-shit-done/workflows/new-project.md +1111 -1111
  86. package/get-shit-done/workflows/node-repair.md +92 -92
  87. package/get-shit-done/workflows/pause-work.md +122 -122
  88. package/get-shit-done/workflows/plan-milestone-gaps.md +274 -274
  89. package/get-shit-done/workflows/plan-phase.md +651 -651
  90. package/get-shit-done/workflows/progress.md +382 -382
  91. package/get-shit-done/workflows/quick.md +610 -610
  92. package/get-shit-done/workflows/remove-phase.md +155 -155
  93. package/get-shit-done/workflows/research-phase.md +74 -74
  94. package/get-shit-done/workflows/resume-project.md +307 -307
  95. package/get-shit-done/workflows/set-profile.md +81 -81
  96. package/get-shit-done/workflows/settings.md +242 -242
  97. package/get-shit-done/workflows/stats.md +57 -57
  98. package/get-shit-done/workflows/transition.md +544 -544
  99. package/get-shit-done/workflows/ui-phase.md +290 -290
  100. package/get-shit-done/workflows/ui-review.md +157 -157
  101. package/get-shit-done/workflows/update.md +320 -320
  102. package/get-shit-done/workflows/validate-phase.md +167 -167
  103. package/get-shit-done/workflows/verify-phase.md +243 -243
  104. package/package.json +1 -1
  105. package/scripts/build-hooks.js +43 -43
  106. package/scripts/run-tests.cjs +29 -29
@@ -1,125 +1,125 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Test script for GSD Temp File Handler
5
- * Run: node get-shit-done/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('gsd-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 GSD Temp File Handler
5
+ * Run: node get-shit-done/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('gsd-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,62 +1,62 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * GSD 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
-
34
- return new Promise(async (resolve, reject) => {
35
- const timeoutId = setTimeout(() => {
36
- logger.error(`Command timed out: ${cmd} ${args.join(' ')}`, { timeout });
37
- if (fallback) {
38
- logger.info('Using fallback value', { fallback });
39
- resolve(fallback);
40
- } else {
41
- reject(new Error(`Command timed out after ${timeout}ms: ${cmd}`));
42
- }
43
- }, timeout);
44
-
45
- try {
46
- const result = await execFileAsync(cmd, args, { timeout });
47
- clearTimeout(timeoutId);
48
- resolve(result.stdout.trim());
49
- } catch (err) {
50
- clearTimeout(timeoutId);
51
- logger.error(`Command failed: ${cmd}`, { error: err.message, args });
52
- if (fallback) {
53
- logger.info('Using fallback value', { fallback });
54
- resolve(fallback);
55
- } else {
56
- reject(err);
57
- }
58
- }
59
- });
60
- }
61
-
62
- module.exports = { execWithTimeout };
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * GSD 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
+
34
+ return new Promise(async (resolve, reject) => {
35
+ const timeoutId = setTimeout(() => {
36
+ logger.error(`Command timed out: ${cmd} ${args.join(' ')}`, { timeout });
37
+ if (fallback) {
38
+ logger.info('Using fallback value', { fallback });
39
+ resolve(fallback);
40
+ } else {
41
+ reject(new Error(`Command timed out after ${timeout}ms: ${cmd}`));
42
+ }
43
+ }, timeout);
44
+
45
+ try {
46
+ const result = await execFileAsync(cmd, args, { timeout });
47
+ clearTimeout(timeoutId);
48
+ resolve(result.stdout.trim());
49
+ } catch (err) {
50
+ clearTimeout(timeoutId);
51
+ logger.error(`Command failed: ${cmd}`, { error: err.message, args });
52
+ if (fallback) {
53
+ logger.info('Using fallback value', { fallback });
54
+ resolve(fallback);
55
+ } else {
56
+ reject(err);
57
+ }
58
+ }
59
+ });
60
+ }
61
+
62
+ module.exports = { execWithTimeout };