@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,275 @@
1
+ /**
2
+ * IPC Server - Unix domain socket server with JSON-RPC 2.0
3
+ *
4
+ * Provides live 2-way communication between the daemon process and CLI clients.
5
+ * Uses newline-delimited JSON framing over Unix domain sockets.
6
+ *
7
+ * @implements @.aiwg/requirements/use-cases/UC-IPC-001.md
8
+ * @tests @test/unit/daemon/ipc-server.test.js
9
+ */
10
+
11
+ import net from 'node:net';
12
+ import fs from 'node:fs';
13
+ import path from 'node:path';
14
+ import { EventEmitter } from 'node:events';
15
+
16
+ // JSON-RPC 2.0 error codes
17
+ const PARSE_ERROR = -32700;
18
+ const INVALID_REQUEST = -32600;
19
+ const METHOD_NOT_FOUND = -32601;
20
+ const INVALID_PARAMS = -32602;
21
+ const INTERNAL_ERROR = -32603;
22
+
23
+ export class IPCServer extends EventEmitter {
24
+ constructor(socketPath, options = {}) {
25
+ super();
26
+ this.socketPath = socketPath;
27
+ this.server = null;
28
+ this.clients = new Set();
29
+ this.handlers = new Map();
30
+ this.running = false;
31
+ this.permissions = options.permissions || 0o600;
32
+ }
33
+
34
+ /**
35
+ * Register a method handler for JSON-RPC calls
36
+ */
37
+ registerMethod(method, handler) {
38
+ this.handlers.set(method, handler);
39
+ }
40
+
41
+ /**
42
+ * Register multiple method handlers at once
43
+ */
44
+ registerMethods(methods) {
45
+ for (const [name, handler] of Object.entries(methods)) {
46
+ this.registerMethod(name, handler);
47
+ }
48
+ }
49
+
50
+ /**
51
+ * Start listening on the Unix domain socket
52
+ */
53
+ async start() {
54
+ if (this.running) return;
55
+
56
+ // Ensure parent directory exists
57
+ const dir = path.dirname(this.socketPath);
58
+ if (!fs.existsSync(dir)) {
59
+ fs.mkdirSync(dir, { recursive: true });
60
+ }
61
+
62
+ // Clean up stale socket
63
+ this._cleanupStaleSocket();
64
+
65
+ return new Promise((resolve, reject) => {
66
+ this.server = net.createServer((socket) => {
67
+ this._handleConnection(socket);
68
+ });
69
+
70
+ this.server.on('error', (err) => {
71
+ if (!this.running) {
72
+ reject(err);
73
+ } else {
74
+ this.emit('error', err);
75
+ }
76
+ });
77
+
78
+ this.server.listen(this.socketPath, () => {
79
+ // Set secure permissions on socket file
80
+ try {
81
+ fs.chmodSync(this.socketPath, this.permissions);
82
+ } catch {
83
+ // chmod may not be supported on all platforms
84
+ }
85
+ this.running = true;
86
+ this.emit('listening', this.socketPath);
87
+ resolve();
88
+ });
89
+ });
90
+ }
91
+
92
+ /**
93
+ * Stop the server and disconnect all clients
94
+ */
95
+ async stop() {
96
+ if (!this.running) return;
97
+ this.running = false;
98
+
99
+ // Disconnect all clients
100
+ for (const client of this.clients) {
101
+ try {
102
+ client.end();
103
+ } catch {
104
+ // Ignore errors during shutdown
105
+ }
106
+ }
107
+ this.clients.clear();
108
+
109
+ return new Promise((resolve) => {
110
+ if (this.server) {
111
+ this.server.close(() => {
112
+ this._cleanupStaleSocket();
113
+ this.emit('closed');
114
+ resolve();
115
+ });
116
+ } else {
117
+ resolve();
118
+ }
119
+ });
120
+ }
121
+
122
+ /**
123
+ * Broadcast a notification to all connected clients (no id = notification)
124
+ */
125
+ broadcast(method, params) {
126
+ const notification = JSON.stringify({
127
+ jsonrpc: '2.0',
128
+ method,
129
+ params,
130
+ }) + '\n';
131
+
132
+ for (const client of this.clients) {
133
+ try {
134
+ if (!client.destroyed) {
135
+ client.write(notification);
136
+ }
137
+ } catch {
138
+ // Client may have disconnected
139
+ }
140
+ }
141
+ }
142
+
143
+ /**
144
+ * Get count of connected clients
145
+ */
146
+ get clientCount() {
147
+ return this.clients.size;
148
+ }
149
+
150
+ /**
151
+ * Get list of registered methods
152
+ */
153
+ get methods() {
154
+ return Array.from(this.handlers.keys());
155
+ }
156
+
157
+ // --- Private methods ---
158
+
159
+ _handleConnection(socket) {
160
+ this.clients.add(socket);
161
+ let buffer = '';
162
+
163
+ this.emit('client:connect', { clientCount: this.clients.size });
164
+
165
+ socket.on('data', (chunk) => {
166
+ buffer += chunk.toString();
167
+
168
+ // Process newline-delimited JSON messages
169
+ let newlineIndex;
170
+ while ((newlineIndex = buffer.indexOf('\n')) !== -1) {
171
+ const line = buffer.slice(0, newlineIndex);
172
+ buffer = buffer.slice(newlineIndex + 1);
173
+
174
+ if (line.trim()) {
175
+ this._processMessage(socket, line);
176
+ }
177
+ }
178
+ });
179
+
180
+ socket.on('error', (err) => {
181
+ // ECONNRESET and EPIPE are expected when clients disconnect
182
+ if (err.code !== 'ECONNRESET' && err.code !== 'EPIPE') {
183
+ this.emit('error', err);
184
+ }
185
+ });
186
+
187
+ socket.on('close', () => {
188
+ this.clients.delete(socket);
189
+ this.emit('client:disconnect', { clientCount: this.clients.size });
190
+ });
191
+ }
192
+
193
+ async _processMessage(socket, raw) {
194
+ let request;
195
+ try {
196
+ request = JSON.parse(raw);
197
+ } catch {
198
+ this._sendError(socket, null, PARSE_ERROR, 'Parse error');
199
+ return;
200
+ }
201
+
202
+ // Validate JSON-RPC 2.0
203
+ if (request.jsonrpc !== '2.0') {
204
+ this._sendError(socket, request.id, INVALID_REQUEST, 'Invalid Request: missing jsonrpc 2.0');
205
+ return;
206
+ }
207
+
208
+ if (!request.method || typeof request.method !== 'string') {
209
+ this._sendError(socket, request.id, INVALID_REQUEST, 'Invalid Request: missing method');
210
+ return;
211
+ }
212
+
213
+ // Find handler
214
+ const handler = this.handlers.get(request.method);
215
+ if (!handler) {
216
+ this._sendError(socket, request.id, METHOD_NOT_FOUND, `Method not found: ${request.method}`);
217
+ return;
218
+ }
219
+
220
+ // Execute handler
221
+ try {
222
+ const result = await handler(request.params || {});
223
+
224
+ // Only send response if request has an id (not a notification)
225
+ if (request.id !== undefined && request.id !== null) {
226
+ this._sendResponse(socket, request.id, result);
227
+ }
228
+ } catch (err) {
229
+ if (err.code === 'INVALID_PARAMS') {
230
+ this._sendError(socket, request.id, INVALID_PARAMS, err.message);
231
+ } else {
232
+ this._sendError(socket, request.id, INTERNAL_ERROR, err.message);
233
+ }
234
+ }
235
+ }
236
+
237
+ _sendResponse(socket, id, result) {
238
+ if (socket.destroyed) return;
239
+ const response = JSON.stringify({
240
+ jsonrpc: '2.0',
241
+ result: result !== undefined ? result : null,
242
+ id,
243
+ }) + '\n';
244
+ socket.write(response);
245
+ }
246
+
247
+ _sendError(socket, id, code, message) {
248
+ if (socket.destroyed) return;
249
+ const response = JSON.stringify({
250
+ jsonrpc: '2.0',
251
+ error: { code, message },
252
+ id: id !== undefined ? id : null,
253
+ }) + '\n';
254
+ socket.write(response);
255
+ }
256
+
257
+ _cleanupStaleSocket() {
258
+ try {
259
+ fs.unlinkSync(this.socketPath);
260
+ } catch (err) {
261
+ if (err.code !== 'ENOENT') {
262
+ throw err;
263
+ }
264
+ }
265
+ }
266
+ }
267
+
268
+ // Standard error codes export for clients
269
+ export const ErrorCodes = {
270
+ PARSE_ERROR,
271
+ INVALID_REQUEST,
272
+ METHOD_NOT_FOUND,
273
+ INVALID_PARAMS,
274
+ INTERNAL_ERROR,
275
+ };
@@ -0,0 +1,79 @@
1
+ /** Isolated deterministic owners: no supervisors, prompts, or shell. The only
2
+ * install route is the opt-in `update.install` policy (never redeploys). */
3
+ import { runUpdateInstall, inMaintenanceWindow, validateUpdatePolicy } from './update-policy.mjs';
4
+ import { importImpl } from '../_resolve-impl.mjs';
5
+
6
+ export async function invokeOwner(job, { cwd = process.cwd(), now = Date.now } = {}) {
7
+ const args = job.args || {};
8
+ switch (job.kind) {
9
+ case 'memory.audit':
10
+ case 'memory.recommend':
11
+ case 'memory.apply': {
12
+ const { validateMemoryJobArgs } = await importImpl(import.meta.url, 'housekeeper/daemon-config.js');
13
+ validateMemoryJobArgs(job.kind, args);
14
+ if (job.kind === 'memory.apply') {
15
+ const errors = validateUpdatePolicy({ windows: args.windows });
16
+ if (errors.length) return { exitStatus: 2, uncertain: true, summary: errors.join('; ') };
17
+ const window = inMaintenanceWindow(now(), args.windows, job.timezone || 'UTC');
18
+ if (!window.inside) return { exitStatus: 2, state: 'deferred', reason: 'outside-maintenance-window', summary: window.reason };
19
+ }
20
+ const owner = await importImpl(import.meta.url, 'memory/scheduled.js');
21
+ return job.kind === 'memory.apply' ? owner.applyScheduledMemory(args, cwd)
22
+ : owner.reportScheduledMemory(job.kind, args, cwd, new Date(now()).toISOString());
23
+ }
24
+ case 'index.verify':
25
+ case 'index.freshness': {
26
+ const { probeIndexStatus } = await importImpl(import.meta.url, 'artifacts/index-status.js');
27
+ const report = await probeIndexStatus(args.workspace || cwd, args.index);
28
+ const selected = report.indices || [];
29
+ const failed = selected.some(index => ['stale', 'degraded', 'unavailable'].includes(index.status));
30
+ const unsupported = selected.length > 0 && selected.every(index => index.status === 'unsupported');
31
+ return { exitStatus: failed || report.summary.warnings || (!args.index && report.summary.missing) ? 1 : unsupported ? null : 0,
32
+ state: unsupported ? 'deferred' : undefined,
33
+ summary: `Index status: ${report.summary.built} built, ${report.summary.missing} missing`, detail: report };
34
+ }
35
+ case 'index.reconcile':
36
+ case 'index.refresh': {
37
+ const { runIndexRefresh } = await importImpl(import.meta.url, 'artifacts/index-refresh.js');
38
+ const flags = ['--json'];
39
+ for (const [key, flag] of [['index', '--only'], ['workspace', '--workspace'], ['root', '--root']]) {
40
+ if (args[key]) flags.push(flag, String(args[key]));
41
+ }
42
+ if (args.dryRun === true) flags.push('--dry-run');
43
+ const report = await runIndexRefresh(flags, cwd);
44
+ return { exitStatus: report.totals.errors ? 1 : 0,
45
+ state: report.status === 'deferred' || report.totals.deferred ? 'deferred' : undefined,
46
+ summary: `Index refresh: ${report.status}`, detail: report };
47
+ }
48
+ case 'cache.retention':
49
+ case 'cache.prune': {
50
+ const { cleanWebResourceCache } = await importImpl(import.meta.url, 'resources/cache-cleanup.js');
51
+ const detail = cleanWebResourceCache(cwd, { cacheRoot: args.cacheRoot, dryRun: args.dryRun === true });
52
+ return { exitStatus: 0, summary: `Cache cleanup: ${detail.removed.length} removed, ${detail.preserved.length} protected`, detail };
53
+ }
54
+ case 'update.check': {
55
+ const { checkUpdateStatus } = await importImpl(import.meta.url, 'update/checker.mjs');
56
+ const detail = await checkUpdateStatus({ channel: args.channel || 'stable' });
57
+ return { exitStatus: detail.status === 'unsupported' ? null : 0,
58
+ state: detail.status === 'unsupported' ? 'deferred' : undefined,
59
+ summary: detail.status === 'unsupported' ? 'Update channel unsupported' : `Update check: ${detail.available ? 'available' : 'current'}`,
60
+ detail };
61
+ }
62
+ case 'update.install': {
63
+ // Every gate (opt-in, window, version policy, active work, preflight)
64
+ // lives in update-policy.mjs; a failed gate is a deferred receipt here.
65
+ return runUpdateInstall(job);
66
+ }
67
+ default: throw new Error(`Unsupported maintenance kind: ${job.kind}`);
68
+ }
69
+ }
70
+
71
+ // One bounded worker with an IPC receipt; CLI logs cannot corrupt manual JSON stdout.
72
+ if (process.env.AIWG_MAINTENANCE_WORKER === '1' && process.send) {
73
+ process.once('message', async job => {
74
+ try { process.send(await invokeOwner(job), () => process.disconnect()); }
75
+ catch (error) {
76
+ process.send({ exitStatus: 1, summary: error.message }, () => process.disconnect());
77
+ }
78
+ });
79
+ }