@howlil/ez-agents 3.4.1 → 3.5.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.
- package/LICENSE +21 -21
- package/README.md +84 -20
- package/agents/ez-observer-agent.md +260 -0
- package/agents/ez-release-agent.md +333 -0
- package/agents/ez-requirements-agent.md +377 -0
- package/agents/ez-scrum-master-agent.md +242 -0
- package/agents/ez-tech-lead-agent.md +267 -0
- package/bin/install.js +3221 -3230
- package/commands/ez/arch-review.md +102 -0
- package/commands/ez/execute-phase.md +11 -0
- package/commands/ez/export-session.md +79 -0
- package/commands/ez/gather-requirements.md +117 -0
- package/commands/ez/git-workflow.md +72 -0
- package/commands/ez/hotfix.md +120 -0
- package/commands/ez/import-session.md +82 -0
- package/commands/ez/join-discord.md +18 -18
- package/commands/ez/list-sessions.md +96 -0
- package/commands/ez/package-manager.md +316 -0
- package/commands/ez/plan-phase.md +9 -1
- package/commands/ez/preflight.md +79 -0
- package/commands/ez/progress.md +13 -1
- package/commands/ez/release.md +153 -0
- package/commands/ez/resume.md +107 -0
- package/commands/ez/standup.md +85 -0
- package/ez-agents/bin/ez-tools.cjs +1095 -716
- package/ez-agents/bin/lib/assistant-adapter.cjs +264 -264
- package/ez-agents/bin/lib/audit-exec.cjs +7 -2
- package/ez-agents/bin/lib/bdd-validator.cjs +622 -0
- package/ez-agents/bin/lib/circuit-breaker.cjs +118 -118
- package/ez-agents/bin/lib/config.cjs +190 -190
- package/ez-agents/bin/lib/content-scanner.cjs +238 -0
- package/ez-agents/bin/lib/context-cache.cjs +154 -0
- package/ez-agents/bin/lib/context-errors.cjs +71 -0
- package/ez-agents/bin/lib/context-manager.cjs +220 -0
- package/ez-agents/bin/lib/discussion-synthesizer.cjs +458 -0
- package/ez-agents/bin/lib/file-access.cjs +207 -0
- package/ez-agents/bin/lib/file-lock.cjs +236 -236
- package/ez-agents/bin/lib/frontmatter.cjs +299 -299
- package/ez-agents/bin/lib/fs-utils.cjs +153 -153
- package/ez-agents/bin/lib/git-errors.cjs +83 -0
- package/ez-agents/bin/lib/git-utils.cjs +118 -0
- package/ez-agents/bin/lib/git-workflow-engine.cjs +1157 -0
- package/ez-agents/bin/lib/index.cjs +157 -113
- package/ez-agents/bin/lib/init.cjs +757 -757
- package/ez-agents/bin/lib/lockfile-validator.cjs +227 -0
- package/ez-agents/bin/lib/logger.cjs +124 -124
- package/ez-agents/bin/lib/memory-compression.cjs +256 -0
- package/ez-agents/bin/lib/metrics-tracker.cjs +406 -0
- package/ez-agents/bin/lib/milestone.cjs +241 -241
- package/ez-agents/bin/lib/model-provider.cjs +241 -241
- package/ez-agents/bin/lib/package-manager-detector.cjs +203 -0
- package/ez-agents/bin/lib/package-manager-executor.cjs +385 -0
- package/ez-agents/bin/lib/package-manager-service.cjs +216 -0
- package/ez-agents/bin/lib/phase.cjs +925 -925
- package/ez-agents/bin/lib/planning-write.cjs +107 -107
- package/ez-agents/bin/lib/release-validator.cjs +614 -0
- package/ez-agents/bin/lib/retry.cjs +119 -119
- package/ez-agents/bin/lib/roadmap.cjs +306 -306
- package/ez-agents/bin/lib/safe-exec.cjs +128 -128
- package/ez-agents/bin/lib/safe-path.cjs +130 -130
- package/ez-agents/bin/lib/session-chain.cjs +304 -0
- package/ez-agents/bin/lib/session-errors.cjs +81 -0
- package/ez-agents/bin/lib/session-export.cjs +251 -0
- package/ez-agents/bin/lib/session-import.cjs +262 -0
- package/ez-agents/bin/lib/session-manager.cjs +280 -0
- package/ez-agents/bin/lib/state.cjs +736 -736
- package/ez-agents/bin/lib/temp-file.cjs +239 -239
- package/ez-agents/bin/lib/template.cjs +223 -223
- package/ez-agents/bin/lib/test-file-lock.cjs +112 -112
- package/ez-agents/bin/lib/test-graceful.cjs +93 -93
- package/ez-agents/bin/lib/test-logger.cjs +60 -60
- package/ez-agents/bin/lib/test-safe-exec.cjs +38 -38
- package/ez-agents/bin/lib/test-safe-path.cjs +33 -33
- package/ez-agents/bin/lib/test-temp-file.cjs +125 -125
- package/ez-agents/bin/lib/tier-manager.cjs +428 -0
- package/ez-agents/bin/lib/timeout-exec.cjs +63 -63
- package/ez-agents/bin/lib/url-fetch.cjs +170 -0
- package/ez-agents/bin/lib/verify.cjs +15 -1
- package/ez-agents/references/checkpoints.md +776 -776
- package/ez-agents/references/continuation-format.md +249 -249
- package/ez-agents/references/metrics-schema.md +118 -0
- package/ez-agents/references/planning-config.md +140 -0
- package/ez-agents/references/questioning.md +162 -162
- package/ez-agents/references/tdd.md +263 -263
- package/ez-agents/references/tier-strategy.md +103 -0
- package/ez-agents/templates/bdd-feature.md +173 -0
- package/ez-agents/templates/codebase/concerns.md +310 -310
- package/ez-agents/templates/codebase/conventions.md +307 -307
- package/ez-agents/templates/codebase/integrations.md +280 -280
- package/ez-agents/templates/codebase/stack.md +186 -186
- package/ez-agents/templates/codebase/testing.md +480 -480
- package/ez-agents/templates/config.json +37 -37
- package/ez-agents/templates/continue-here.md +78 -78
- package/ez-agents/templates/discussion.md +68 -0
- package/ez-agents/templates/incident-runbook.md +205 -0
- package/ez-agents/templates/milestone-archive.md +123 -123
- package/ez-agents/templates/milestone.md +115 -115
- package/ez-agents/templates/release-checklist.md +133 -0
- package/ez-agents/templates/requirements.md +231 -231
- package/ez-agents/templates/research-project/ARCHITECTURE.md +204 -204
- package/ez-agents/templates/research-project/FEATURES.md +147 -147
- package/ez-agents/templates/research-project/PITFALLS.md +200 -200
- package/ez-agents/templates/research-project/STACK.md +120 -120
- package/ez-agents/templates/research-project/SUMMARY.md +170 -170
- package/ez-agents/templates/retrospective.md +54 -54
- package/ez-agents/templates/roadmap.md +202 -202
- package/ez-agents/templates/rollback-plan.md +201 -0
- package/ez-agents/templates/summary-minimal.md +41 -41
- package/ez-agents/templates/summary-standard.md +48 -48
- package/ez-agents/templates/summary.md +248 -248
- package/ez-agents/templates/user-setup.md +311 -311
- package/ez-agents/templates/verification-report.md +322 -322
- package/ez-agents/workflows/add-phase.md +112 -112
- package/ez-agents/workflows/add-tests.md +351 -351
- package/ez-agents/workflows/add-todo.md +158 -158
- package/ez-agents/workflows/arch-review.md +54 -0
- package/ez-agents/workflows/audit-milestone.md +332 -332
- package/ez-agents/workflows/autonomous.md +131 -30
- package/ez-agents/workflows/check-todos.md +177 -177
- package/ez-agents/workflows/cleanup.md +152 -152
- package/ez-agents/workflows/complete-milestone.md +766 -766
- package/ez-agents/workflows/diagnose-issues.md +219 -219
- package/ez-agents/workflows/discovery-phase.md +289 -289
- package/ez-agents/workflows/discuss-phase.md +762 -762
- package/ez-agents/workflows/execute-phase.md +513 -468
- package/ez-agents/workflows/execute-plan.md +483 -483
- package/ez-agents/workflows/export-session.md +255 -0
- package/ez-agents/workflows/gather-requirements.md +206 -0
- package/ez-agents/workflows/health.md +159 -159
- package/ez-agents/workflows/help.md +584 -492
- package/ez-agents/workflows/hotfix.md +291 -0
- package/ez-agents/workflows/import-session.md +303 -0
- package/ez-agents/workflows/insert-phase.md +130 -130
- package/ez-agents/workflows/list-phase-assumptions.md +178 -178
- package/ez-agents/workflows/map-codebase.md +316 -316
- package/ez-agents/workflows/new-milestone.md +339 -10
- package/ez-agents/workflows/new-project.md +293 -299
- package/ez-agents/workflows/node-repair.md +92 -92
- package/ez-agents/workflows/pause-work.md +122 -122
- package/ez-agents/workflows/plan-milestone-gaps.md +274 -274
- package/ez-agents/workflows/plan-phase.md +673 -651
- package/ez-agents/workflows/progress.md +372 -382
- package/ez-agents/workflows/quick.md +610 -610
- package/ez-agents/workflows/release.md +253 -0
- package/ez-agents/workflows/remove-phase.md +155 -155
- package/ez-agents/workflows/research-phase.md +74 -74
- package/ez-agents/workflows/resume-project.md +307 -307
- package/ez-agents/workflows/resume-session.md +215 -0
- package/ez-agents/workflows/set-profile.md +81 -81
- package/ez-agents/workflows/settings.md +242 -242
- package/ez-agents/workflows/standup.md +64 -0
- package/ez-agents/workflows/stats.md +57 -57
- package/ez-agents/workflows/transition.md +544 -544
- package/ez-agents/workflows/ui-phase.md +290 -290
- package/ez-agents/workflows/ui-review.md +157 -157
- package/ez-agents/workflows/update.md +320 -320
- package/ez-agents/workflows/validate-phase.md +167 -167
- package/ez-agents/workflows/verify-phase.md +243 -243
- package/ez-agents/workflows/verify-work.md +584 -584
- package/package.json +10 -4
- package/scripts/build-hooks.js +43 -43
- package/scripts/run-tests.cjs +29 -29
|
@@ -1,107 +1,107 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Planning Write — lock/temp-safe writer for .planning mutations
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
const fs = require('fs');
|
|
6
|
-
const path = require('path');
|
|
7
|
-
const os = require('os');
|
|
8
|
-
const { Worker } = require('worker_threads');
|
|
9
|
-
const { withLock } = require('./file-lock.cjs');
|
|
10
|
-
const { createTempFile, cleanupTemp } = require('./temp-file.cjs');
|
|
11
|
-
|
|
12
|
-
function normalizeTimeoutError(err, filePath) {
|
|
13
|
-
if (!err) return err;
|
|
14
|
-
const message = err.message || '';
|
|
15
|
-
if (message.includes('File locked:')) {
|
|
16
|
-
return err;
|
|
17
|
-
}
|
|
18
|
-
if (message.includes('timed out') || err.code === 'ELOCKED') {
|
|
19
|
-
return new Error(`File locked: ${filePath}`);
|
|
20
|
-
}
|
|
21
|
-
return err;
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
async function safePlanningWrite(filePath, content, options = {}) {
|
|
25
|
-
const {
|
|
26
|
-
timeoutMs = 30000,
|
|
27
|
-
tempPrefix = 'ez-write-',
|
|
28
|
-
} = options;
|
|
29
|
-
|
|
30
|
-
let tempPath = null;
|
|
31
|
-
|
|
32
|
-
try {
|
|
33
|
-
await withLock(filePath, async () => {
|
|
34
|
-
tempPath = await createTempFile(tempPrefix, path.dirname(filePath), content);
|
|
35
|
-
await fs.promises.rename(tempPath, filePath);
|
|
36
|
-
}, { timeout: timeoutMs });
|
|
37
|
-
} catch (err) {
|
|
38
|
-
throw normalizeTimeoutError(err, filePath);
|
|
39
|
-
} finally {
|
|
40
|
-
if (tempPath) {
|
|
41
|
-
try {
|
|
42
|
-
await cleanupTemp(tempPath);
|
|
43
|
-
} catch {
|
|
44
|
-
// best effort cleanup only
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
function safePlanningWriteSync(filePath, content, options = {}) {
|
|
51
|
-
const signalBuffer = new SharedArrayBuffer(4);
|
|
52
|
-
const signal = new Int32Array(signalBuffer);
|
|
53
|
-
const errorPath = path.join(os.tmpdir(), `ez-planning-write-error-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}.log`);
|
|
54
|
-
const modulePath = __filename;
|
|
55
|
-
|
|
56
|
-
const workerCode = `
|
|
57
|
-
const fs = require('fs');
|
|
58
|
-
const { workerData } = require('worker_threads');
|
|
59
|
-
const signal = new Int32Array(workerData.signalBuffer);
|
|
60
|
-
const { safePlanningWrite } = require(workerData.modulePath);
|
|
61
|
-
(async () => {
|
|
62
|
-
try {
|
|
63
|
-
await safePlanningWrite(workerData.filePath, workerData.content, workerData.options);
|
|
64
|
-
Atomics.store(signal, 0, 1);
|
|
65
|
-
} catch (err) {
|
|
66
|
-
try {
|
|
67
|
-
fs.writeFileSync(workerData.errorPath, err && (err.stack || err.message) ? (err.stack || err.message) : String(err), 'utf-8');
|
|
68
|
-
} catch {}
|
|
69
|
-
Atomics.store(signal, 0, 2);
|
|
70
|
-
} finally {
|
|
71
|
-
Atomics.notify(signal, 0);
|
|
72
|
-
}
|
|
73
|
-
})();
|
|
74
|
-
`;
|
|
75
|
-
|
|
76
|
-
const worker = new Worker(workerCode, {
|
|
77
|
-
eval: true,
|
|
78
|
-
workerData: { modulePath, filePath, content, options, signalBuffer, errorPath },
|
|
79
|
-
});
|
|
80
|
-
|
|
81
|
-
try {
|
|
82
|
-
while (Atomics.load(signal, 0) === 0) {
|
|
83
|
-
Atomics.wait(signal, 0, 0, 100);
|
|
84
|
-
}
|
|
85
|
-
} finally {
|
|
86
|
-
worker.terminate().catch(() => {});
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
const status = Atomics.load(signal, 0);
|
|
90
|
-
if (status === 2) {
|
|
91
|
-
let message = `safePlanningWriteSync failed for ${filePath}`;
|
|
92
|
-
try {
|
|
93
|
-
if (fs.existsSync(errorPath)) {
|
|
94
|
-
message = fs.readFileSync(errorPath, 'utf-8') || message;
|
|
95
|
-
}
|
|
96
|
-
} catch {}
|
|
97
|
-
try { fs.rmSync(errorPath, { force: true }); } catch {}
|
|
98
|
-
throw new Error(message);
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
try { fs.rmSync(errorPath, { force: true }); } catch {}
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
module.exports = {
|
|
105
|
-
safePlanningWrite,
|
|
106
|
-
safePlanningWriteSync,
|
|
107
|
-
};
|
|
1
|
+
/**
|
|
2
|
+
* Planning Write — lock/temp-safe writer for .planning mutations
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
const fs = require('fs');
|
|
6
|
+
const path = require('path');
|
|
7
|
+
const os = require('os');
|
|
8
|
+
const { Worker } = require('worker_threads');
|
|
9
|
+
const { withLock } = require('./file-lock.cjs');
|
|
10
|
+
const { createTempFile, cleanupTemp } = require('./temp-file.cjs');
|
|
11
|
+
|
|
12
|
+
function normalizeTimeoutError(err, filePath) {
|
|
13
|
+
if (!err) return err;
|
|
14
|
+
const message = err.message || '';
|
|
15
|
+
if (message.includes('File locked:')) {
|
|
16
|
+
return err;
|
|
17
|
+
}
|
|
18
|
+
if (message.includes('timed out') || err.code === 'ELOCKED') {
|
|
19
|
+
return new Error(`File locked: ${filePath}`);
|
|
20
|
+
}
|
|
21
|
+
return err;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
async function safePlanningWrite(filePath, content, options = {}) {
|
|
25
|
+
const {
|
|
26
|
+
timeoutMs = 30000,
|
|
27
|
+
tempPrefix = 'ez-write-',
|
|
28
|
+
} = options;
|
|
29
|
+
|
|
30
|
+
let tempPath = null;
|
|
31
|
+
|
|
32
|
+
try {
|
|
33
|
+
await withLock(filePath, async () => {
|
|
34
|
+
tempPath = await createTempFile(tempPrefix, path.dirname(filePath), content);
|
|
35
|
+
await fs.promises.rename(tempPath, filePath);
|
|
36
|
+
}, { timeout: timeoutMs });
|
|
37
|
+
} catch (err) {
|
|
38
|
+
throw normalizeTimeoutError(err, filePath);
|
|
39
|
+
} finally {
|
|
40
|
+
if (tempPath) {
|
|
41
|
+
try {
|
|
42
|
+
await cleanupTemp(tempPath);
|
|
43
|
+
} catch {
|
|
44
|
+
// best effort cleanup only
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function safePlanningWriteSync(filePath, content, options = {}) {
|
|
51
|
+
const signalBuffer = new SharedArrayBuffer(4);
|
|
52
|
+
const signal = new Int32Array(signalBuffer);
|
|
53
|
+
const errorPath = path.join(os.tmpdir(), `ez-planning-write-error-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}.log`);
|
|
54
|
+
const modulePath = __filename;
|
|
55
|
+
|
|
56
|
+
const workerCode = `
|
|
57
|
+
const fs = require('fs');
|
|
58
|
+
const { workerData } = require('worker_threads');
|
|
59
|
+
const signal = new Int32Array(workerData.signalBuffer);
|
|
60
|
+
const { safePlanningWrite } = require(workerData.modulePath);
|
|
61
|
+
(async () => {
|
|
62
|
+
try {
|
|
63
|
+
await safePlanningWrite(workerData.filePath, workerData.content, workerData.options);
|
|
64
|
+
Atomics.store(signal, 0, 1);
|
|
65
|
+
} catch (err) {
|
|
66
|
+
try {
|
|
67
|
+
fs.writeFileSync(workerData.errorPath, err && (err.stack || err.message) ? (err.stack || err.message) : String(err), 'utf-8');
|
|
68
|
+
} catch {}
|
|
69
|
+
Atomics.store(signal, 0, 2);
|
|
70
|
+
} finally {
|
|
71
|
+
Atomics.notify(signal, 0);
|
|
72
|
+
}
|
|
73
|
+
})();
|
|
74
|
+
`;
|
|
75
|
+
|
|
76
|
+
const worker = new Worker(workerCode, {
|
|
77
|
+
eval: true,
|
|
78
|
+
workerData: { modulePath, filePath, content, options, signalBuffer, errorPath },
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
try {
|
|
82
|
+
while (Atomics.load(signal, 0) === 0) {
|
|
83
|
+
Atomics.wait(signal, 0, 0, 100);
|
|
84
|
+
}
|
|
85
|
+
} finally {
|
|
86
|
+
worker.terminate().catch(() => {});
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const status = Atomics.load(signal, 0);
|
|
90
|
+
if (status === 2) {
|
|
91
|
+
let message = `safePlanningWriteSync failed for ${filePath}`;
|
|
92
|
+
try {
|
|
93
|
+
if (fs.existsSync(errorPath)) {
|
|
94
|
+
message = fs.readFileSync(errorPath, 'utf-8') || message;
|
|
95
|
+
}
|
|
96
|
+
} catch {}
|
|
97
|
+
try { fs.rmSync(errorPath, { force: true }); } catch {}
|
|
98
|
+
throw new Error(message);
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
try { fs.rmSync(errorPath, { force: true }); } catch {}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
module.exports = {
|
|
105
|
+
safePlanningWrite,
|
|
106
|
+
safePlanningWriteSync,
|
|
107
|
+
};
|