@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,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 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,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 };