@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.
Files changed (180) hide show
  1. package/agentic/code/providers/pi/aiwg-bridge.ts +45 -7
  2. package/dist/src/artifacts/citation-parser.js +7 -6
  3. package/dist/src/artifacts/corpus-tools/citation-densify.js +4 -2
  4. package/dist/src/artifacts/corpus-tools/cli.js +8 -3
  5. package/dist/src/artifacts/corpus-tools/discovery-log.js +26 -24
  6. package/dist/src/artifacts/corpus-tools/expand-cli.js +3 -2
  7. package/dist/src/artifacts/corpus-tools/expand-dates.js +107 -0
  8. package/dist/src/artifacts/corpus-tools/expand-queue.js +4 -1
  9. package/dist/src/artifacts/corpus-tools/expand-review.js +104 -0
  10. package/dist/src/artifacts/corpus-tools/expand-state.js +17 -1
  11. package/dist/src/artifacts/corpus-tools/expand.js +16 -17
  12. package/dist/src/artifacts/corpus-tools/induction-audit.js +7 -6
  13. package/dist/src/artifacts/corpus-tools/integrity-scan.js +3 -3
  14. package/dist/src/artifacts/corpus-tools/radar-shared.js +7 -9
  15. package/dist/src/artifacts/corpus-tools/ref-files.js +11 -0
  16. package/dist/src/artifacts/corpus-tools/resolve-cli.js +11 -3
  17. package/dist/src/artifacts/corpus-tools/resolve.js +23 -9
  18. package/dist/src/artifacts/corpus-tools/retrieval-lab.js +2 -1
  19. package/dist/src/artifacts/corpus-tools/sidecar-lint.js +4 -4
  20. package/dist/src/artifacts/corpus-tools/sidecar-repair.js +2 -1
  21. package/dist/src/artifacts/corpus-views/ref-parser.js +3 -17
  22. package/dist/src/artifacts/graph-query.js +5 -3
  23. package/dist/src/artifacts/hybrid-query.js +11 -2
  24. package/dist/src/artifacts/index-refresh.js +2 -0
  25. package/dist/src/cli/handlers/daemon.js +17 -1
  26. package/dist/src/cli/handlers/doctor-args.js +10 -5
  27. package/dist/src/cli/handlers/doctor-help.js +4 -1
  28. package/dist/src/cli/handlers/index.js +2 -2
  29. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  30. package/dist/src/cli/handlers/models.js +3 -2
  31. package/dist/src/cli/handlers/regenerate.js +8 -16
  32. package/dist/src/cli/handlers/sessions.js +7 -7
  33. package/dist/src/cli/handlers/subcommands.js +8 -0
  34. package/dist/src/cli/handlers/update.js +157 -0
  35. package/dist/src/cli/handlers/use.js +14 -4
  36. package/dist/src/cli/handlers/utilities.js +3 -560
  37. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  38. package/dist/src/cli/services/deployment-verification.js +0 -1
  39. package/dist/src/config/aiwg-config.js +2 -1
  40. package/dist/src/config/authorization-cli.js +7 -3
  41. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  42. package/dist/src/config/dispatch-thresholds-runtime.mjs +17 -7
  43. package/dist/src/config/framework-aliases.js +12 -0
  44. package/dist/src/config/host-resource-report.d.mts +19 -0
  45. package/dist/src/config/host-resource-report.mjs +80 -0
  46. package/dist/src/config/host-resource-runtime.d.mts +34 -0
  47. package/dist/src/config/host-resource-runtime.mjs +293 -0
  48. package/dist/src/config/installed-selection.js +22 -0
  49. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  50. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  51. package/dist/src/decision/heldout/access.js +74 -0
  52. package/dist/src/decision/heldout/calibration.js +1 -0
  53. package/dist/src/decision/heldout/collector.js +8 -1
  54. package/dist/src/effects/verifiers/file.js +22 -5
  55. package/dist/src/extensions/claude-attribution.js +82 -0
  56. package/dist/src/extensions/claude-hooks-installer.js +115 -69
  57. package/dist/src/extensions/commands/daemon.js +109 -0
  58. package/dist/src/extensions/commands/definitions.js +5 -89
  59. package/dist/src/gates/heldout.js +17 -7
  60. package/dist/src/lint/check-patterns.js +163 -0
  61. package/dist/src/lint/checks.js +268 -0
  62. package/dist/src/lint/reference-resolution.js +54 -0
  63. package/dist/src/lint/runner.js +3 -465
  64. package/dist/src/mcp/helpers.mjs +11 -1
  65. package/dist/src/memory/project-registry.js +44 -4
  66. package/dist/src/models/worker-plan.js +36 -5
  67. package/dist/src/models/wrapper-deployment.js +25 -12
  68. package/dist/src/models/wrapper-enforcement.js +47 -7
  69. package/dist/src/network-analysis/research.js +2 -1
  70. package/dist/src/policy/hitl-check.js +14 -4
  71. package/dist/src/policy/hitl-consume.js +54 -0
  72. package/dist/src/policy/hitl-receipt.js +2 -0
  73. package/dist/src/policy/hitl.js +11 -3
  74. package/dist/src/providers/provider-context-contracts.js +162 -0
  75. package/dist/src/providers/provider-definition-schema.js +136 -0
  76. package/dist/src/providers/provider-definitions.js +8 -1298
  77. package/dist/src/providers/provider-seeds-1.js +360 -0
  78. package/dist/src/providers/provider-seeds-2.js +387 -0
  79. package/dist/src/providers/provider-seeds-3.js +262 -0
  80. package/dist/src/research/clients/arxiv.js +4 -30
  81. package/dist/src/research/clients/base.js +48 -22
  82. package/dist/src/research/identity.js +34 -2
  83. package/dist/src/research/query-cli.js +3 -87
  84. package/dist/src/research/query-options.js +87 -0
  85. package/dist/src/research/reference-match.js +70 -24
  86. package/dist/src/research/services/acquisition.js +9 -7
  87. package/dist/src/research/services/citation.js +5 -2
  88. package/dist/src/research/types.js +2 -0
  89. package/dist/src/serve/mission-conductor.js +48 -4
  90. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  91. package/dist/src/sessions/adapters/grok-build.js +14 -7
  92. package/dist/src/sessions/workspace-discovery.js +5 -5
  93. package/dist/src/smiths/context-pipeline/aiwg-md.js +16 -46
  94. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  95. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  96. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  97. package/dist/src/smiths/context-pipeline/generator.js +9 -10
  98. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  99. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  100. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  101. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  102. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  103. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  104. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  105. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  106. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  107. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  108. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  109. package/package.json +10 -1
  110. package/schemas/decision/D29Study.v10.schema.json +65 -0
  111. package/tools/agents/deploy-agents.mjs +10 -0
  112. package/tools/agents/providers/claude-post-deploy.mjs +12 -1
  113. package/tools/agents/providers/context-write.mjs +4 -0
  114. package/tools/agents/providers/pi.mjs +3 -1
  115. package/tools/agents/providers/rule-delivery-surface.mjs +332 -0
  116. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  117. package/tools/agents/providers/rule-deployment-commit.mjs +144 -0
  118. package/tools/agents/providers/rule-deployment-prepare.mjs +452 -0
  119. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  120. package/tools/daemon/README.md +511 -0
  121. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  122. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  123. package/tools/daemon/agent-supervisor.mjs +299 -0
  124. package/tools/daemon/automation-engine.mjs +310 -0
  125. package/tools/daemon/autonomous-engine.mjs +346 -0
  126. package/tools/daemon/behavior-loader.mjs +316 -0
  127. package/tools/daemon/behavior.mjs +174 -0
  128. package/tools/daemon/concierge/intent-router.mjs +401 -0
  129. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  130. package/tools/daemon/concierge/response-translator.mjs +462 -0
  131. package/tools/daemon/config.mjs +377 -0
  132. package/tools/daemon/cron-scheduler.mjs +178 -0
  133. package/tools/daemon/daemon-main.mjs +1169 -0
  134. package/tools/daemon/event-router.mjs +84 -0
  135. package/tools/daemon/file-watcher.mjs +383 -0
  136. package/tools/daemon/index.mjs +1181 -0
  137. package/tools/daemon/init-profile.mjs +124 -0
  138. package/tools/daemon/ipc-client.mjs +197 -0
  139. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  140. package/tools/daemon/ipc-server.mjs +275 -0
  141. package/tools/daemon/maintenance-owner.mjs +79 -0
  142. package/tools/daemon/memory-manager.mjs +386 -0
  143. package/tools/daemon/message-router.mjs +194 -0
  144. package/tools/daemon/provider-watcher.mjs +585 -0
  145. package/tools/daemon/pty-adapter.mjs +420 -0
  146. package/tools/daemon/repl-chat.mjs +359 -0
  147. package/tools/daemon/resource-bounds.mjs +88 -0
  148. package/tools/daemon/sandbox-transport.mjs +295 -0
  149. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  150. package/tools/daemon/task-store.mjs +450 -0
  151. package/tools/daemon/tmux-manager.mjs +324 -0
  152. package/tools/daemon/update-policy.mjs +517 -0
  153. package/tools/daemon/web-server.mjs +399 -0
  154. package/tools/daemon/web-ui/index.html +585 -0
  155. package/tools/daemon/web-ui/styles.css +156 -0
  156. package/tools/docker/Dockerfile.daemon +35 -0
  157. package/tools/docker/container-manager.mjs +291 -0
  158. package/tools/messaging/adapter-registry.mjs +230 -0
  159. package/tools/messaging/adapters/base.mjs +326 -0
  160. package/tools/messaging/adapters/discord.mjs +462 -0
  161. package/tools/messaging/adapters/slack.mjs +402 -0
  162. package/tools/messaging/adapters/telegram.mjs +552 -0
  163. package/tools/messaging/chat-handler.mjs +297 -0
  164. package/tools/messaging/command-router.mjs +269 -0
  165. package/tools/messaging/event-bus.mjs +199 -0
  166. package/tools/messaging/index.mjs +456 -0
  167. package/tools/messaging/message-formatter.mjs +320 -0
  168. package/tools/messaging/room-manager.mjs +277 -0
  169. package/tools/messaging/types.mjs +94 -0
  170. package/tools/providers/pi-bridge-policy.mjs +4 -0
  171. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  172. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  173. package/tools/ralph-external/lib/worker-invocation-processes.mjs +3 -2
  174. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  175. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  176. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  177. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  178. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  179. package/tools/ralph-external/session-launcher.mjs +7 -7
  180. 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
+ }