@aiwg/cli 2026.10.15 → 2026.10.16
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/agentic/code/providers/pi/aiwg-bridge.ts +45 -7
- package/dist/src/artifacts/citation-parser.js +7 -6
- package/dist/src/artifacts/corpus-tools/citation-densify.js +4 -2
- package/dist/src/artifacts/corpus-tools/cli.js +8 -3
- package/dist/src/artifacts/corpus-tools/discovery-log.js +26 -24
- package/dist/src/artifacts/corpus-tools/expand-cli.js +3 -2
- package/dist/src/artifacts/corpus-tools/expand-dates.js +107 -0
- package/dist/src/artifacts/corpus-tools/expand-queue.js +4 -1
- package/dist/src/artifacts/corpus-tools/expand-review.js +104 -0
- package/dist/src/artifacts/corpus-tools/expand-state.js +17 -1
- package/dist/src/artifacts/corpus-tools/expand.js +16 -17
- package/dist/src/artifacts/corpus-tools/induction-audit.js +7 -6
- package/dist/src/artifacts/corpus-tools/integrity-scan.js +3 -3
- package/dist/src/artifacts/corpus-tools/radar-shared.js +7 -9
- package/dist/src/artifacts/corpus-tools/ref-files.js +11 -0
- package/dist/src/artifacts/corpus-tools/resolve-cli.js +11 -3
- package/dist/src/artifacts/corpus-tools/resolve.js +23 -9
- package/dist/src/artifacts/corpus-tools/retrieval-lab.js +2 -1
- package/dist/src/artifacts/corpus-tools/sidecar-lint.js +4 -4
- package/dist/src/artifacts/corpus-tools/sidecar-repair.js +2 -1
- package/dist/src/artifacts/corpus-views/ref-parser.js +3 -17
- package/dist/src/artifacts/graph-query.js +5 -3
- package/dist/src/artifacts/hybrid-query.js +11 -2
- package/dist/src/artifacts/index-refresh.js +2 -0
- package/dist/src/cli/handlers/daemon.js +17 -1
- package/dist/src/cli/handlers/doctor-args.js +10 -5
- package/dist/src/cli/handlers/doctor-help.js +4 -1
- package/dist/src/cli/handlers/index.js +2 -2
- package/dist/src/cli/handlers/models-resource-sample.js +10 -0
- package/dist/src/cli/handlers/models.js +3 -2
- package/dist/src/cli/handlers/regenerate.js +8 -16
- package/dist/src/cli/handlers/sessions.js +7 -7
- package/dist/src/cli/handlers/subcommands.js +8 -0
- package/dist/src/cli/handlers/update.js +157 -0
- package/dist/src/cli/handlers/use.js +14 -4
- package/dist/src/cli/handlers/utilities.js +3 -560
- package/dist/src/cli/handlers/utility-doctor.js +412 -0
- package/dist/src/cli/services/deployment-verification.js +0 -1
- package/dist/src/config/aiwg-config.js +2 -1
- package/dist/src/config/authorization-cli.js +7 -3
- package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
- package/dist/src/config/dispatch-thresholds-runtime.mjs +17 -7
- package/dist/src/config/framework-aliases.js +12 -0
- package/dist/src/config/host-resource-report.d.mts +19 -0
- package/dist/src/config/host-resource-report.mjs +80 -0
- package/dist/src/config/host-resource-runtime.d.mts +34 -0
- package/dist/src/config/host-resource-runtime.mjs +293 -0
- package/dist/src/config/installed-selection.js +22 -0
- package/dist/src/config/worker-invocation-marker.d.mts +1 -0
- package/dist/src/config/worker-invocation-marker.mjs +2 -0
- package/dist/src/decision/heldout/access.js +74 -0
- package/dist/src/decision/heldout/calibration.js +1 -0
- package/dist/src/decision/heldout/collector.js +8 -1
- package/dist/src/effects/verifiers/file.js +22 -5
- package/dist/src/extensions/claude-attribution.js +82 -0
- package/dist/src/extensions/claude-hooks-installer.js +115 -69
- package/dist/src/extensions/commands/daemon.js +109 -0
- package/dist/src/extensions/commands/definitions.js +5 -89
- package/dist/src/gates/heldout.js +17 -7
- package/dist/src/lint/check-patterns.js +163 -0
- package/dist/src/lint/checks.js +268 -0
- package/dist/src/lint/reference-resolution.js +54 -0
- package/dist/src/lint/runner.js +3 -465
- package/dist/src/mcp/helpers.mjs +11 -1
- package/dist/src/memory/project-registry.js +44 -4
- package/dist/src/models/worker-plan.js +36 -5
- package/dist/src/models/wrapper-deployment.js +25 -12
- package/dist/src/models/wrapper-enforcement.js +47 -7
- package/dist/src/network-analysis/research.js +2 -1
- package/dist/src/policy/hitl-check.js +14 -4
- package/dist/src/policy/hitl-consume.js +54 -0
- package/dist/src/policy/hitl-receipt.js +2 -0
- package/dist/src/policy/hitl.js +11 -3
- package/dist/src/providers/provider-context-contracts.js +162 -0
- package/dist/src/providers/provider-definition-schema.js +136 -0
- package/dist/src/providers/provider-definitions.js +8 -1298
- package/dist/src/providers/provider-seeds-1.js +360 -0
- package/dist/src/providers/provider-seeds-2.js +387 -0
- package/dist/src/providers/provider-seeds-3.js +262 -0
- package/dist/src/research/clients/arxiv.js +4 -30
- package/dist/src/research/clients/base.js +48 -22
- package/dist/src/research/identity.js +34 -2
- package/dist/src/research/query-cli.js +3 -87
- package/dist/src/research/query-options.js +87 -0
- package/dist/src/research/reference-match.js +70 -24
- package/dist/src/research/services/acquisition.js +9 -7
- package/dist/src/research/services/citation.js +5 -2
- package/dist/src/research/types.js +2 -0
- package/dist/src/serve/mission-conductor.js +48 -4
- package/dist/src/sessions/adapters/grok-build-native.js +23 -0
- package/dist/src/sessions/adapters/grok-build.js +14 -7
- package/dist/src/sessions/workspace-discovery.js +5 -5
- package/dist/src/smiths/context-pipeline/aiwg-md.js +16 -46
- package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
- package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
- package/dist/src/smiths/context-pipeline/finalization.js +81 -51
- package/dist/src/smiths/context-pipeline/generator.js +9 -10
- package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
- package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
- package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
- package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
- package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
- package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
- package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
- package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
- package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
- package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
- package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
- package/package.json +10 -1
- package/schemas/decision/D29Study.v10.schema.json +65 -0
- package/tools/agents/deploy-agents.mjs +10 -0
- package/tools/agents/providers/claude-post-deploy.mjs +12 -1
- package/tools/agents/providers/context-write.mjs +4 -0
- package/tools/agents/providers/pi.mjs +3 -1
- package/tools/agents/providers/rule-delivery-surface.mjs +332 -0
- package/tools/agents/providers/rule-delivery.mjs +20 -1144
- package/tools/agents/providers/rule-deployment-commit.mjs +144 -0
- package/tools/agents/providers/rule-deployment-prepare.mjs +452 -0
- package/tools/agents/providers/rule-deployment-state.mjs +300 -0
- package/tools/daemon/README.md +511 -0
- package/tools/daemon/adapters/base-adapter.mjs +84 -0
- package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
- package/tools/daemon/agent-supervisor.mjs +299 -0
- package/tools/daemon/automation-engine.mjs +310 -0
- package/tools/daemon/autonomous-engine.mjs +346 -0
- package/tools/daemon/behavior-loader.mjs +316 -0
- package/tools/daemon/behavior.mjs +174 -0
- package/tools/daemon/concierge/intent-router.mjs +401 -0
- package/tools/daemon/concierge/orchestrator.mjs +272 -0
- package/tools/daemon/concierge/response-translator.mjs +462 -0
- package/tools/daemon/config.mjs +377 -0
- package/tools/daemon/cron-scheduler.mjs +178 -0
- package/tools/daemon/daemon-main.mjs +1169 -0
- package/tools/daemon/event-router.mjs +84 -0
- package/tools/daemon/file-watcher.mjs +383 -0
- package/tools/daemon/index.mjs +1181 -0
- package/tools/daemon/init-profile.mjs +124 -0
- package/tools/daemon/ipc-client.mjs +197 -0
- package/tools/daemon/ipc-ops-handlers.mjs +236 -0
- package/tools/daemon/ipc-server.mjs +275 -0
- package/tools/daemon/maintenance-owner.mjs +79 -0
- package/tools/daemon/memory-manager.mjs +386 -0
- package/tools/daemon/message-router.mjs +194 -0
- package/tools/daemon/provider-watcher.mjs +585 -0
- package/tools/daemon/pty-adapter.mjs +420 -0
- package/tools/daemon/repl-chat.mjs +359 -0
- package/tools/daemon/resource-bounds.mjs +88 -0
- package/tools/daemon/sandbox-transport.mjs +295 -0
- package/tools/daemon/scheduled-task-runner.mjs +535 -0
- package/tools/daemon/task-store.mjs +450 -0
- package/tools/daemon/tmux-manager.mjs +324 -0
- package/tools/daemon/update-policy.mjs +517 -0
- package/tools/daemon/web-server.mjs +399 -0
- package/tools/daemon/web-ui/index.html +585 -0
- package/tools/daemon/web-ui/styles.css +156 -0
- package/tools/docker/Dockerfile.daemon +35 -0
- package/tools/docker/container-manager.mjs +291 -0
- package/tools/messaging/adapter-registry.mjs +230 -0
- package/tools/messaging/adapters/base.mjs +326 -0
- package/tools/messaging/adapters/discord.mjs +462 -0
- package/tools/messaging/adapters/slack.mjs +402 -0
- package/tools/messaging/adapters/telegram.mjs +552 -0
- package/tools/messaging/chat-handler.mjs +297 -0
- package/tools/messaging/command-router.mjs +269 -0
- package/tools/messaging/event-bus.mjs +199 -0
- package/tools/messaging/index.mjs +456 -0
- package/tools/messaging/message-formatter.mjs +320 -0
- package/tools/messaging/room-manager.mjs +277 -0
- package/tools/messaging/types.mjs +94 -0
- package/tools/providers/pi-bridge-policy.mjs +4 -0
- package/tools/ralph-external/daemon-supervisor.mjs +394 -0
- package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
- package/tools/ralph-external/lib/worker-invocation-processes.mjs +3 -2
- package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
- package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
- package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
- package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
- package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
- package/tools/ralph-external/session-launcher.mjs +7 -7
- package/tools/scripts/resource-preflight.mjs +3 -242
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agent Supervisor - Task queue and process management for claude -p spawning
|
|
3
|
+
*
|
|
4
|
+
* Manages a pool of concurrent agent subprocesses, tracking their lifecycle,
|
|
5
|
+
* streaming output, and reporting results through the event system.
|
|
6
|
+
*
|
|
7
|
+
* @implements @.aiwg/requirements/use-cases/UC-AGENT-001.md
|
|
8
|
+
* @tests @test/unit/daemon/agent-supervisor.test.js
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { importImpl } from '../_resolve-impl.mjs';
|
|
12
|
+
import { spawn } from 'node:child_process';
|
|
13
|
+
import { EventEmitter } from 'node:events';
|
|
14
|
+
const { signalChild } = await importImpl(import.meta.url, 'process/signal-child.mjs');
|
|
15
|
+
|
|
16
|
+
export class AgentSupervisor extends EventEmitter {
|
|
17
|
+
constructor(options = {}) {
|
|
18
|
+
super();
|
|
19
|
+
this.maxConcurrency = options.maxConcurrency ?? 3;
|
|
20
|
+
this.taskStore = options.taskStore || null;
|
|
21
|
+
this.queue = [];
|
|
22
|
+
this.running = new Map(); // taskId -> { process, task }
|
|
23
|
+
this.shutdownInProgress = false;
|
|
24
|
+
this.agentCommand = options.agentCommand || 'claude';
|
|
25
|
+
this.agentArgs = options.agentArgs || [];
|
|
26
|
+
this.environment = options.environment;
|
|
27
|
+
this.taskTimeout = options.taskTimeout || 120 * 60 * 1000; // 2 hours default
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Submit a task to the queue
|
|
32
|
+
* Returns the task object with assigned ID
|
|
33
|
+
*/
|
|
34
|
+
submit(prompt, options = {}) {
|
|
35
|
+
if (this.shutdownInProgress) {
|
|
36
|
+
throw new Error('Supervisor is shutting down');
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// Create task in store if available
|
|
40
|
+
const task = this.taskStore
|
|
41
|
+
? this.taskStore.createTask({ prompt, agent: options.agent, priority: options.priority || 0, metadata: options.metadata })
|
|
42
|
+
: {
|
|
43
|
+
id: `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
|
|
44
|
+
prompt,
|
|
45
|
+
agent: options.agent || null,
|
|
46
|
+
priority: options.priority || 0,
|
|
47
|
+
state: 'queued',
|
|
48
|
+
createdAt: new Date().toISOString(),
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
this.queue.push(task);
|
|
52
|
+
this.queue.sort((a, b) => (b.priority || 0) - (a.priority || 0));
|
|
53
|
+
|
|
54
|
+
this.emit('task:queued', { taskId: task.id, prompt: prompt.slice(0, 80), queueSize: this.queue.length });
|
|
55
|
+
|
|
56
|
+
this._processQueue();
|
|
57
|
+
return task;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Cancel a task (queued or running)
|
|
62
|
+
*/
|
|
63
|
+
cancel(taskId) {
|
|
64
|
+
// Check queue first
|
|
65
|
+
const queueIdx = this.queue.findIndex(t => t.id === taskId);
|
|
66
|
+
if (queueIdx !== -1) {
|
|
67
|
+
this.queue.splice(queueIdx, 1);
|
|
68
|
+
if (this.taskStore) {
|
|
69
|
+
this.taskStore.cancelTask(taskId);
|
|
70
|
+
}
|
|
71
|
+
this.emit('task:cancelled', { taskId });
|
|
72
|
+
return true;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
// Check running
|
|
76
|
+
const entry = this.running.get(taskId);
|
|
77
|
+
if (entry) {
|
|
78
|
+
try {
|
|
79
|
+
// Cleanup happens in the exit handler; refusal is not delivery.
|
|
80
|
+
return signalChild(entry.process, 'SIGTERM');
|
|
81
|
+
} catch {
|
|
82
|
+
return false;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
return false;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Get status of all tasks
|
|
91
|
+
*/
|
|
92
|
+
getStatus() {
|
|
93
|
+
return {
|
|
94
|
+
running: this.running.size,
|
|
95
|
+
queued: this.queue.length,
|
|
96
|
+
maxConcurrency: this.maxConcurrency,
|
|
97
|
+
tasks: {
|
|
98
|
+
running: Array.from(this.running.entries()).map(([id, entry]) => ({
|
|
99
|
+
id,
|
|
100
|
+
prompt: entry.task.prompt.slice(0, 80),
|
|
101
|
+
agent: entry.task.agent,
|
|
102
|
+
startedAt: entry.task.startedAt,
|
|
103
|
+
pid: entry.process.pid,
|
|
104
|
+
})),
|
|
105
|
+
queued: this.queue.map(t => ({
|
|
106
|
+
id: t.id,
|
|
107
|
+
prompt: t.prompt.slice(0, 80),
|
|
108
|
+
agent: t.agent,
|
|
109
|
+
priority: t.priority,
|
|
110
|
+
})),
|
|
111
|
+
},
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Graceful shutdown - drain queue and wait for running tasks
|
|
117
|
+
*/
|
|
118
|
+
async shutdown(timeoutMs = 30000) {
|
|
119
|
+
this.shutdownInProgress = true;
|
|
120
|
+
|
|
121
|
+
// Reject queued tasks
|
|
122
|
+
while (this.queue.length > 0) {
|
|
123
|
+
const task = this.queue.shift();
|
|
124
|
+
if (this.taskStore) {
|
|
125
|
+
this.taskStore.cancelTask(task.id);
|
|
126
|
+
}
|
|
127
|
+
this.emit('task:cancelled', { taskId: task.id, reason: 'shutdown' });
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
// Wait for running tasks to complete or timeout
|
|
131
|
+
if (this.running.size === 0) {
|
|
132
|
+
this.shutdownInProgress = false;
|
|
133
|
+
return;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
const waitForCompletion = new Promise((resolve) => {
|
|
137
|
+
const checkInterval = setInterval(() => {
|
|
138
|
+
if (this.running.size === 0) {
|
|
139
|
+
clearInterval(checkInterval);
|
|
140
|
+
resolve();
|
|
141
|
+
}
|
|
142
|
+
}, 100);
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
const timeout = new Promise((resolve) => {
|
|
146
|
+
setTimeout(() => {
|
|
147
|
+
// Force kill remaining
|
|
148
|
+
for (const [taskId, entry] of this.running) {
|
|
149
|
+
try {
|
|
150
|
+
signalChild(entry.process, 'SIGKILL');
|
|
151
|
+
} catch {
|
|
152
|
+
// Already dead
|
|
153
|
+
}
|
|
154
|
+
if (this.taskStore) {
|
|
155
|
+
this.taskStore.failTask(taskId, 'Killed during shutdown');
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
this.running.clear();
|
|
159
|
+
resolve();
|
|
160
|
+
}, timeoutMs);
|
|
161
|
+
});
|
|
162
|
+
|
|
163
|
+
await Promise.race([waitForCompletion, timeout]);
|
|
164
|
+
this.shutdownInProgress = false;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Get running task count
|
|
169
|
+
*/
|
|
170
|
+
get runningCount() {
|
|
171
|
+
return this.running.size;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Get queued task count
|
|
176
|
+
*/
|
|
177
|
+
get queuedCount() {
|
|
178
|
+
return this.queue.length;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
// --- Private methods ---
|
|
182
|
+
|
|
183
|
+
_processQueue() {
|
|
184
|
+
while (
|
|
185
|
+
this.running.size < this.maxConcurrency &&
|
|
186
|
+
this.queue.length > 0 &&
|
|
187
|
+
!this.shutdownInProgress
|
|
188
|
+
) {
|
|
189
|
+
const task = this.queue.shift();
|
|
190
|
+
this._runTask(task);
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
_runTask(task) {
|
|
195
|
+
const args = [...this.agentArgs, '-p', task.prompt];
|
|
196
|
+
|
|
197
|
+
if (task.agent) {
|
|
198
|
+
args.push('--agent', task.agent);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
const proc = spawn(this.agentCommand, args, {
|
|
202
|
+
stdio: ['ignore', 'pipe', 'pipe'],
|
|
203
|
+
env: { ...(this.environment ?? process.env) },
|
|
204
|
+
});
|
|
205
|
+
|
|
206
|
+
// Track start time
|
|
207
|
+
task.startedAt = new Date().toISOString();
|
|
208
|
+
task.state = 'running';
|
|
209
|
+
|
|
210
|
+
if (this.taskStore) {
|
|
211
|
+
this.taskStore.startTask(task.id, proc.pid);
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
let stdout = '';
|
|
215
|
+
let stderr = '';
|
|
216
|
+
|
|
217
|
+
proc.stdout.on('data', (chunk) => {
|
|
218
|
+
const text = chunk.toString();
|
|
219
|
+
stdout += text;
|
|
220
|
+
if (this.taskStore) {
|
|
221
|
+
this.taskStore.appendOutput(task.id, text);
|
|
222
|
+
}
|
|
223
|
+
this.emit('task:output', { taskId: task.id, chunk: text, stream: 'stdout' });
|
|
224
|
+
});
|
|
225
|
+
|
|
226
|
+
proc.stderr.on('data', (chunk) => {
|
|
227
|
+
const text = chunk.toString();
|
|
228
|
+
stderr += text;
|
|
229
|
+
this.emit('task:output', { taskId: task.id, chunk: text, stream: 'stderr' });
|
|
230
|
+
});
|
|
231
|
+
|
|
232
|
+
// Timeout handler
|
|
233
|
+
const timeoutTimer = setTimeout(() => {
|
|
234
|
+
try {
|
|
235
|
+
signalChild(proc, 'SIGTERM');
|
|
236
|
+
} catch {
|
|
237
|
+
// Already dead
|
|
238
|
+
}
|
|
239
|
+
if (this.taskStore) {
|
|
240
|
+
this.taskStore.failTask(task.id, `Task timed out after ${this.taskTimeout}ms`);
|
|
241
|
+
}
|
|
242
|
+
this.running.delete(task.id);
|
|
243
|
+
this.emit('task:timeout', { taskId: task.id });
|
|
244
|
+
this._processQueue();
|
|
245
|
+
}, this.taskTimeout);
|
|
246
|
+
|
|
247
|
+
proc.on('exit', (code, signal) => {
|
|
248
|
+
clearTimeout(timeoutTimer);
|
|
249
|
+
this.running.delete(task.id);
|
|
250
|
+
|
|
251
|
+
if (signal === 'SIGTERM' || signal === 'SIGKILL') {
|
|
252
|
+
// Cancelled or killed
|
|
253
|
+
if (this.taskStore && this.taskStore.getTask(task.id)?.state === 'running') {
|
|
254
|
+
this.taskStore.cancelTask(task.id);
|
|
255
|
+
}
|
|
256
|
+
this.emit('task:cancelled', { taskId: task.id, signal });
|
|
257
|
+
} else if (code === 0) {
|
|
258
|
+
if (this.taskStore) {
|
|
259
|
+
this.taskStore.completeTask(task.id, stdout);
|
|
260
|
+
}
|
|
261
|
+
this.emit('task:completed', {
|
|
262
|
+
taskId: task.id,
|
|
263
|
+
result: stdout,
|
|
264
|
+
duration: Date.now() - new Date(task.startedAt).getTime(),
|
|
265
|
+
});
|
|
266
|
+
} else {
|
|
267
|
+
const errorMsg = stderr || `Process exited with code ${code}`;
|
|
268
|
+
if (this.taskStore) {
|
|
269
|
+
this.taskStore.failTask(task.id, errorMsg);
|
|
270
|
+
}
|
|
271
|
+
this.emit('task:failed', {
|
|
272
|
+
taskId: task.id,
|
|
273
|
+
error: errorMsg,
|
|
274
|
+
exitCode: code,
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
this._processQueue();
|
|
279
|
+
});
|
|
280
|
+
|
|
281
|
+
proc.on('error', (err) => {
|
|
282
|
+
clearTimeout(timeoutTimer);
|
|
283
|
+
this.running.delete(task.id);
|
|
284
|
+
|
|
285
|
+
if (this.taskStore) {
|
|
286
|
+
this.taskStore.failTask(task.id, err.message);
|
|
287
|
+
}
|
|
288
|
+
this.emit('task:failed', {
|
|
289
|
+
taskId: task.id,
|
|
290
|
+
error: err.message,
|
|
291
|
+
});
|
|
292
|
+
|
|
293
|
+
this._processQueue();
|
|
294
|
+
});
|
|
295
|
+
|
|
296
|
+
this.running.set(task.id, { process: proc, task });
|
|
297
|
+
this.emit('task:started', { taskId: task.id, pid: proc.pid });
|
|
298
|
+
}
|
|
299
|
+
}
|
|
@@ -0,0 +1,310 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Automation Engine - Trigger-action rules for the daemon
|
|
3
|
+
*
|
|
4
|
+
* Processes configurable rules that map daemon events to agent actions.
|
|
5
|
+
* Supports approval gates, cooldowns, and condition evaluation.
|
|
6
|
+
*
|
|
7
|
+
* @implements @.aiwg/requirements/use-cases/UC-AUTO-001.md
|
|
8
|
+
* @tests @test/unit/daemon/automation-engine.test.js
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { EventEmitter } from 'node:events';
|
|
12
|
+
|
|
13
|
+
export class AutomationEngine extends EventEmitter {
|
|
14
|
+
constructor(options = {}) {
|
|
15
|
+
super();
|
|
16
|
+
this.rules = [];
|
|
17
|
+
this.supervisor = options.supervisor || null;
|
|
18
|
+
this.enabled = options.enabled !== false;
|
|
19
|
+
this.cooldowns = new Map(); // ruleId -> lastFiredAt
|
|
20
|
+
this.executionLog = [];
|
|
21
|
+
this.maxLogEntries = options.maxLogEntries || 500;
|
|
22
|
+
this.approvalHandler = options.approvalHandler || null;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Load rules from configuration
|
|
27
|
+
* @param {Array} rules - Array of rule definitions
|
|
28
|
+
*/
|
|
29
|
+
loadRules(rules) {
|
|
30
|
+
this.rules = [];
|
|
31
|
+
|
|
32
|
+
for (const rule of rules) {
|
|
33
|
+
const validated = this._validateRule(rule);
|
|
34
|
+
if (validated) {
|
|
35
|
+
this.rules.push(validated);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
this.emit('rules:loaded', { count: this.rules.length });
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* Process an incoming event against all rules
|
|
44
|
+
* @param {object} event - Event to process
|
|
45
|
+
*/
|
|
46
|
+
async processEvent(event) {
|
|
47
|
+
if (!this.enabled) return;
|
|
48
|
+
|
|
49
|
+
const matchingRules = this.rules.filter((rule) =>
|
|
50
|
+
this._matchesRule(rule, event)
|
|
51
|
+
);
|
|
52
|
+
|
|
53
|
+
for (const rule of matchingRules) {
|
|
54
|
+
await this._executeRule(rule, event);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Enable/disable the engine
|
|
60
|
+
*/
|
|
61
|
+
setEnabled(enabled) {
|
|
62
|
+
this.enabled = enabled;
|
|
63
|
+
this.emit('engine:toggled', { enabled });
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Get engine status
|
|
68
|
+
*/
|
|
69
|
+
getStatus() {
|
|
70
|
+
return {
|
|
71
|
+
enabled: this.enabled,
|
|
72
|
+
ruleCount: this.rules.length,
|
|
73
|
+
rules: this.rules.map((r) => ({
|
|
74
|
+
id: r.id,
|
|
75
|
+
trigger: r.trigger,
|
|
76
|
+
action: r.action,
|
|
77
|
+
enabled: r.enabled !== false,
|
|
78
|
+
cooldownMs: r.cooldownMs || 0,
|
|
79
|
+
requiresApproval: r.requiresApproval || false,
|
|
80
|
+
})),
|
|
81
|
+
recentExecutions: this.executionLog.slice(-10),
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Get a specific rule by id
|
|
87
|
+
*/
|
|
88
|
+
getRule(id) {
|
|
89
|
+
return this.rules.find((r) => r.id === id) || null;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Enable or disable a specific rule
|
|
94
|
+
*/
|
|
95
|
+
setRuleEnabled(id, enabled) {
|
|
96
|
+
const rule = this.rules.find((r) => r.id === id);
|
|
97
|
+
if (!rule) return false;
|
|
98
|
+
rule.enabled = enabled;
|
|
99
|
+
this.emit('rule:toggled', { id, enabled });
|
|
100
|
+
return true;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* Get execution log
|
|
105
|
+
*/
|
|
106
|
+
getExecutionLog(limit = 50) {
|
|
107
|
+
return this.executionLog.slice(-limit);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Get rule count
|
|
112
|
+
*/
|
|
113
|
+
get ruleCount() {
|
|
114
|
+
return this.rules.length;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// --- Private methods ---
|
|
118
|
+
|
|
119
|
+
_validateRule(rule) {
|
|
120
|
+
if (!rule.id || typeof rule.id !== 'string') {
|
|
121
|
+
this.emit('rule:invalid', { rule, error: 'Missing or invalid rule id' });
|
|
122
|
+
return null;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
if (!rule.trigger) {
|
|
126
|
+
this.emit('rule:invalid', { rule, error: 'Missing trigger' });
|
|
127
|
+
return null;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
if (!rule.action) {
|
|
131
|
+
this.emit('rule:invalid', { rule, error: 'Missing action' });
|
|
132
|
+
return null;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
return {
|
|
136
|
+
id: rule.id,
|
|
137
|
+
trigger: rule.trigger,
|
|
138
|
+
action: rule.action,
|
|
139
|
+
enabled: rule.enabled !== false,
|
|
140
|
+
cooldownMs: rule.cooldownMs || 0,
|
|
141
|
+
requiresApproval: rule.requiresApproval || false,
|
|
142
|
+
conditions: rule.conditions || [],
|
|
143
|
+
description: rule.description || '',
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
_matchesRule(rule, event) {
|
|
148
|
+
if (rule.enabled === false) return false;
|
|
149
|
+
|
|
150
|
+
// Check trigger type match
|
|
151
|
+
if (rule.trigger.type && rule.trigger.type !== event.type) {
|
|
152
|
+
return false;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// Check trigger source match
|
|
156
|
+
if (rule.trigger.source && rule.trigger.source !== event.source) {
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// Check trigger pattern (regex on event type or source)
|
|
161
|
+
if (rule.trigger.pattern) {
|
|
162
|
+
const regex = new RegExp(rule.trigger.pattern);
|
|
163
|
+
const matchTarget = `${event.type || ''}:${event.source || ''}`;
|
|
164
|
+
if (!regex.test(matchTarget)) {
|
|
165
|
+
return false;
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
// Check conditions
|
|
170
|
+
for (const condition of rule.conditions || []) {
|
|
171
|
+
if (!this._evaluateCondition(condition, event)) {
|
|
172
|
+
return false;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// Check cooldown
|
|
177
|
+
if (rule.cooldownMs > 0) {
|
|
178
|
+
const lastFired = this.cooldowns.get(rule.id);
|
|
179
|
+
if (lastFired && Date.now() - lastFired < rule.cooldownMs) {
|
|
180
|
+
return false;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
return true;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
_evaluateCondition(condition, event) {
|
|
188
|
+
const { field, operator, value } = condition;
|
|
189
|
+
|
|
190
|
+
// Navigate to the field value in the event
|
|
191
|
+
const fieldValue = this._getNestedField(event, field);
|
|
192
|
+
|
|
193
|
+
switch (operator) {
|
|
194
|
+
case 'eq':
|
|
195
|
+
case 'equals':
|
|
196
|
+
return fieldValue === value;
|
|
197
|
+
case 'neq':
|
|
198
|
+
case 'not_equals':
|
|
199
|
+
return fieldValue !== value;
|
|
200
|
+
case 'contains':
|
|
201
|
+
return typeof fieldValue === 'string' && fieldValue.includes(value);
|
|
202
|
+
case 'matches':
|
|
203
|
+
return typeof fieldValue === 'string' && new RegExp(value).test(fieldValue);
|
|
204
|
+
case 'gt':
|
|
205
|
+
return typeof fieldValue === 'number' && fieldValue > value;
|
|
206
|
+
case 'lt':
|
|
207
|
+
return typeof fieldValue === 'number' && fieldValue < value;
|
|
208
|
+
case 'gte':
|
|
209
|
+
return typeof fieldValue === 'number' && fieldValue >= value;
|
|
210
|
+
case 'lte':
|
|
211
|
+
return typeof fieldValue === 'number' && fieldValue <= value;
|
|
212
|
+
case 'exists':
|
|
213
|
+
return fieldValue !== undefined && fieldValue !== null;
|
|
214
|
+
case 'not_exists':
|
|
215
|
+
return fieldValue === undefined || fieldValue === null;
|
|
216
|
+
default:
|
|
217
|
+
return false;
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
_getNestedField(obj, path) {
|
|
222
|
+
const parts = path.split('.');
|
|
223
|
+
let current = obj;
|
|
224
|
+
for (const part of parts) {
|
|
225
|
+
if (current === undefined || current === null) return undefined;
|
|
226
|
+
current = current[part];
|
|
227
|
+
}
|
|
228
|
+
return current;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
async _executeRule(rule, event) {
|
|
232
|
+
// Check approval
|
|
233
|
+
if (rule.requiresApproval) {
|
|
234
|
+
if (this.approvalHandler) {
|
|
235
|
+
const approved = await this.approvalHandler(rule, event);
|
|
236
|
+
if (!approved) {
|
|
237
|
+
this._logExecution(rule, event, 'denied');
|
|
238
|
+
return;
|
|
239
|
+
}
|
|
240
|
+
} else {
|
|
241
|
+
// No approval handler, skip rule
|
|
242
|
+
this._logExecution(rule, event, 'skipped_no_approver');
|
|
243
|
+
return;
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
// Update cooldown
|
|
248
|
+
this.cooldowns.set(rule.id, Date.now());
|
|
249
|
+
|
|
250
|
+
try {
|
|
251
|
+
if (rule.action.type === 'agent' && this.supervisor) {
|
|
252
|
+
// Submit to agent supervisor
|
|
253
|
+
const prompt = this._interpolateTemplate(rule.action.prompt, event);
|
|
254
|
+
const task = this.supervisor.submit(prompt, {
|
|
255
|
+
agent: rule.action.agent,
|
|
256
|
+
priority: rule.action.priority || 0,
|
|
257
|
+
metadata: { ruleId: rule.id, eventType: event.type },
|
|
258
|
+
});
|
|
259
|
+
|
|
260
|
+
this._logExecution(rule, event, 'submitted', { taskId: task.id });
|
|
261
|
+
this.emit('rule:executed', { ruleId: rule.id, taskId: task.id, event });
|
|
262
|
+
} else if (rule.action.type === 'notify') {
|
|
263
|
+
this.emit('rule:notify', {
|
|
264
|
+
ruleId: rule.id,
|
|
265
|
+
message: this._interpolateTemplate(rule.action.message, event),
|
|
266
|
+
channel: rule.action.channel,
|
|
267
|
+
event,
|
|
268
|
+
});
|
|
269
|
+
this._logExecution(rule, event, 'notified');
|
|
270
|
+
} else if (rule.action.type === 'webhook') {
|
|
271
|
+
this.emit('rule:webhook', {
|
|
272
|
+
ruleId: rule.id,
|
|
273
|
+
url: rule.action.url,
|
|
274
|
+
payload: event,
|
|
275
|
+
});
|
|
276
|
+
this._logExecution(rule, event, 'webhook_sent');
|
|
277
|
+
} else {
|
|
278
|
+
this._logExecution(rule, event, 'unknown_action_type');
|
|
279
|
+
}
|
|
280
|
+
} catch (err) {
|
|
281
|
+
this._logExecution(rule, event, 'error', { error: err.message });
|
|
282
|
+
this.emit('rule:error', { ruleId: rule.id, error: err.message });
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
_interpolateTemplate(template, event) {
|
|
287
|
+
if (!template) return '';
|
|
288
|
+
|
|
289
|
+
return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
|
|
290
|
+
const value = this._getNestedField(event, path);
|
|
291
|
+
return value !== undefined ? String(value) : match;
|
|
292
|
+
});
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
_logExecution(rule, event, status, extra = {}) {
|
|
296
|
+
const entry = {
|
|
297
|
+
ruleId: rule.id,
|
|
298
|
+
eventType: event.type,
|
|
299
|
+
status,
|
|
300
|
+
timestamp: new Date().toISOString(),
|
|
301
|
+
...extra,
|
|
302
|
+
};
|
|
303
|
+
|
|
304
|
+
this.executionLog.push(entry);
|
|
305
|
+
|
|
306
|
+
if (this.executionLog.length > this.maxLogEntries) {
|
|
307
|
+
this.executionLog.shift();
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
}
|