@aiwg/cli 2026.10.15 → 2026.10.18

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 (286) 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 +42 -11
  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/artifacts/query-engine-corpus.js +217 -0
  26. package/dist/src/artifacts/query-engine-discover-output.js +229 -0
  27. package/dist/src/artifacts/query-engine-discover.js +285 -0
  28. package/dist/src/artifacts/query-engine-entries.js +188 -0
  29. package/dist/src/artifacts/query-engine-index.js +249 -0
  30. package/dist/src/artifacts/query-engine-matching.js +143 -0
  31. package/dist/src/artifacts/query-engine-options.js +2 -0
  32. package/dist/src/artifacts/query-engine-rules.js +202 -0
  33. package/dist/src/artifacts/query-engine-scoring.js +436 -0
  34. package/dist/src/artifacts/query-engine-show-card.js +194 -0
  35. package/dist/src/artifacts/query-engine-show-load.js +211 -0
  36. package/dist/src/artifacts/query-engine-show.js +300 -0
  37. package/dist/src/artifacts/query-engine.js +7 -2576
  38. package/dist/src/cli/handlers/daemon.js +17 -1
  39. package/dist/src/cli/handlers/doctor-args.js +10 -5
  40. package/dist/src/cli/handlers/doctor-help.js +4 -1
  41. package/dist/src/cli/handlers/index.js +2 -2
  42. package/dist/src/cli/handlers/mc-agents.js +111 -0
  43. package/dist/src/cli/handlers/mc-args.js +54 -0
  44. package/dist/src/cli/handlers/mc-control.js +227 -0
  45. package/dist/src/cli/handlers/mc-dispatch.js +203 -0
  46. package/dist/src/cli/handlers/mc-help.js +171 -0
  47. package/dist/src/cli/handlers/mc-run.js +343 -0
  48. package/dist/src/cli/handlers/mc-session.js +138 -0
  49. package/dist/src/cli/handlers/mc-status.js +258 -0
  50. package/dist/src/cli/handlers/mc-summary.js +43 -0
  51. package/dist/src/cli/handlers/mc-types.js +3 -0
  52. package/dist/src/cli/handlers/mc-worker.js +205 -0
  53. package/dist/src/cli/handlers/mc.js +12 -1665
  54. package/dist/src/cli/handlers/models-refusal.js +13 -0
  55. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  56. package/dist/src/cli/handlers/models.js +5 -3
  57. package/dist/src/cli/handlers/regenerate.js +8 -16
  58. package/dist/src/cli/handlers/remove-bundled.js +133 -0
  59. package/dist/src/cli/handlers/remove-options.js +31 -0
  60. package/dist/src/cli/handlers/remove-user.js +174 -0
  61. package/dist/src/cli/handlers/remove.js +201 -0
  62. package/dist/src/cli/handlers/sessions.js +7 -7
  63. package/dist/src/cli/handlers/subcommands-bundles.js +257 -0
  64. package/dist/src/cli/handlers/subcommands-discovery.js +165 -0
  65. package/dist/src/cli/handlers/subcommands-list-format.js +129 -0
  66. package/dist/src/cli/handlers/subcommands-list.js +250 -0
  67. package/dist/src/cli/handlers/subcommands-plugins.js +213 -0
  68. package/dist/src/cli/handlers/subcommands-quickref.js +58 -0
  69. package/dist/src/cli/handlers/subcommands-rlm.js +113 -0
  70. package/dist/src/cli/handlers/subcommands-services.js +66 -0
  71. package/dist/src/cli/handlers/subcommands-storage.js +259 -0
  72. package/dist/src/cli/handlers/subcommands.js +18 -1976
  73. package/dist/src/cli/handlers/update.js +157 -0
  74. package/dist/src/cli/handlers/use.js +14 -4
  75. package/dist/src/cli/handlers/utilities.js +3 -560
  76. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  77. package/dist/src/cli/scope-resolver.js +1 -142
  78. package/dist/src/cli/services/deployment-verification.js +0 -1
  79. package/dist/src/cli/user-scope-mirror.js +173 -0
  80. package/dist/src/config/aiwg-config.js +2 -1
  81. package/dist/src/config/authorization-cli.js +7 -3
  82. package/dist/src/config/dispatch-host-thresholds.js +2 -0
  83. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  84. package/dist/src/config/dispatch-thresholds-runtime.mjs +21 -7
  85. package/dist/src/config/framework-aliases.js +12 -0
  86. package/dist/src/config/host-resource-report.d.mts +24 -0
  87. package/dist/src/config/host-resource-report.mjs +110 -0
  88. package/dist/src/config/host-resource-runtime.d.mts +37 -0
  89. package/dist/src/config/host-resource-runtime.mjs +296 -0
  90. package/dist/src/config/installed-selection.js +22 -0
  91. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  92. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  93. package/dist/src/decision/ensemble-study/artifacts.js +7 -0
  94. package/dist/src/decision/ensemble-study/gate-policy.js +58 -0
  95. package/dist/src/decision/ensemble-study/gates.js +78 -0
  96. package/dist/src/decision/ensemble-study/protocol.js +18 -21
  97. package/dist/src/decision/ensemble-study/score.js +3 -2
  98. package/dist/src/decision/ensemble-study/statistics.js +7 -26
  99. package/dist/src/decision/heldout/access.js +74 -0
  100. package/dist/src/decision/heldout/calibration.js +1 -0
  101. package/dist/src/decision/heldout/collector.js +8 -1
  102. package/dist/src/decision/sensitivity/comparative-gates.js +135 -0
  103. package/dist/src/decision/sensitivity/comparative.js +18 -41
  104. package/dist/src/effects/verifiers/file.js +22 -5
  105. package/dist/src/extensions/claude-attribution.js +82 -0
  106. package/dist/src/extensions/claude-hooks-installer.js +133 -69
  107. package/dist/src/extensions/commands/daemon.js +109 -0
  108. package/dist/src/extensions/commands/definitions.js +5 -89
  109. package/dist/src/gates/evaluate.js +2 -358
  110. package/dist/src/gates/heldout.js +17 -7
  111. package/dist/src/gates/observations.js +363 -0
  112. package/dist/src/gates/pack-composition.js +270 -0
  113. package/dist/src/gates/pack-tightening.js +197 -0
  114. package/dist/src/gates/pack-validation.js +262 -0
  115. package/dist/src/gates/registry-error.js +5 -0
  116. package/dist/src/gates/registry.js +13 -685
  117. package/dist/src/lint/check-patterns.js +163 -0
  118. package/dist/src/lint/checks.js +268 -0
  119. package/dist/src/lint/reference-resolution.js +54 -0
  120. package/dist/src/lint/runner.js +3 -465
  121. package/dist/src/mcp/helpers.mjs +11 -1
  122. package/dist/src/mcp/json-document.mjs +29 -0
  123. package/dist/src/mcp/muse-native-config.mjs +1 -28
  124. package/dist/src/memory/project-registry.js +44 -4
  125. package/dist/src/mission-protocol/worker-review-gate.js +7 -0
  126. package/dist/src/models/worker-plan.js +36 -5
  127. package/dist/src/models/wrapper-deployment.js +25 -12
  128. package/dist/src/models/wrapper-enforcement.js +47 -7
  129. package/dist/src/network-analysis/research.js +2 -1
  130. package/dist/src/plugin/command-ownership.js +34 -0
  131. package/dist/src/plugin/skill-command-frontmatter.js +197 -0
  132. package/dist/src/plugin/skill-command-translator.js +6 -232
  133. package/dist/src/policy/hitl-check.js +14 -4
  134. package/dist/src/policy/hitl-consume.js +54 -0
  135. package/dist/src/policy/hitl-receipt.js +2 -0
  136. package/dist/src/policy/hitl.js +11 -3
  137. package/dist/src/providers/context-output-ownership.js +26 -0
  138. package/dist/src/providers/deployment-ownership.d.mts +19 -0
  139. package/dist/src/providers/deployment-ownership.mjs +226 -0
  140. package/dist/src/providers/deployment-removal.js +200 -0
  141. package/dist/src/providers/provider-context-contracts.js +162 -0
  142. package/dist/src/providers/provider-definition-schema.js +136 -0
  143. package/dist/src/providers/provider-definitions.js +8 -1298
  144. package/dist/src/providers/provider-seeds-1.js +360 -0
  145. package/dist/src/providers/provider-seeds-2.js +387 -0
  146. package/dist/src/providers/provider-seeds-3.js +262 -0
  147. package/dist/src/providers/removal-transaction.js +86 -0
  148. package/dist/src/providers/settings-document.d.mts +3 -0
  149. package/dist/src/providers/settings-document.mjs +47 -0
  150. package/dist/src/providers/settings-removal.js +190 -0
  151. package/dist/src/providers/skill-ownership.d.mts +19 -2
  152. package/dist/src/providers/skill-ownership.mjs +12 -4
  153. package/dist/src/providers/transformation-receipt-integration.js +15 -271
  154. package/dist/src/providers/transformation-receipt-outputs.js +99 -0
  155. package/dist/src/providers/transformation-receipt-source.js +194 -0
  156. package/dist/src/research/clients/arxiv.js +4 -30
  157. package/dist/src/research/clients/base.js +48 -22
  158. package/dist/src/research/identity.js +42 -4
  159. package/dist/src/research/query-cli.js +3 -87
  160. package/dist/src/research/query-options.js +87 -0
  161. package/dist/src/research/reference-match.js +105 -24
  162. package/dist/src/research/services/acquisition.js +9 -7
  163. package/dist/src/research/services/citation.js +5 -2
  164. package/dist/src/research/types.js +2 -0
  165. package/dist/src/rules/activation.mjs +15 -6
  166. package/dist/src/rules/core-startup.mjs +2 -2
  167. package/dist/src/serve/mission-conductor.js +52 -4
  168. package/dist/src/serve/mission-summary.js +56 -0
  169. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  170. package/dist/src/sessions/adapters/grok-build.js +14 -7
  171. package/dist/src/sessions/workspace-discovery.js +5 -5
  172. package/dist/src/smiths/context-pipeline/aiwg-md.js +39 -46
  173. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  174. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  175. package/dist/src/smiths/context-pipeline/context-file-safety.js +3 -0
  176. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  177. package/dist/src/smiths/context-pipeline/generator.js +10 -11
  178. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  179. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  180. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  181. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  182. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  183. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  184. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  185. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  186. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  187. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  188. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  189. package/dist/src/smiths/hook-bridge/index.js +9 -0
  190. package/package.json +13 -1
  191. package/schemas/decision/D17StudyProtocol.v1.schema.json +39 -67
  192. package/schemas/decision/D29Study.v10.schema.json +65 -0
  193. package/tools/agents/deploy-agents.mjs +24 -675
  194. package/tools/agents/deploy-command-mirrors.mjs +229 -0
  195. package/tools/agents/deploy-options.mjs +258 -0
  196. package/tools/agents/deploy-support.mjs +165 -0
  197. package/tools/agents/providers/base-addon-discovery.mjs +139 -0
  198. package/tools/agents/providers/base-behaviors.mjs +168 -0
  199. package/tools/agents/providers/base-context.mjs +205 -0
  200. package/tools/agents/providers/base-contract.mjs +116 -0
  201. package/tools/agents/providers/base-files.mjs +252 -0
  202. package/tools/agents/providers/base-flat-artifacts.mjs +233 -0
  203. package/tools/agents/providers/base-framework-discovery.mjs +309 -0
  204. package/tools/agents/providers/base-frontmatter.mjs +196 -0
  205. package/tools/agents/providers/base-inventory.mjs +269 -0
  206. package/tools/agents/providers/base-kernel-skills.mjs +354 -0
  207. package/tools/agents/providers/base-migrations.mjs +258 -0
  208. package/tools/agents/providers/base-models-platforms.mjs +273 -0
  209. package/tools/agents/providers/base-rule-index.mjs +450 -0
  210. package/tools/agents/providers/base-runtime.mjs +60 -0
  211. package/tools/agents/providers/base-skill-copy.mjs +273 -0
  212. package/tools/agents/providers/base.mjs +16 -3364
  213. package/tools/agents/providers/claude-post-deploy.mjs +20 -1
  214. package/tools/agents/providers/context-write.mjs +4 -0
  215. package/tools/agents/providers/hermes-startup.mjs +0 -5
  216. package/tools/agents/providers/muse.mjs +7 -2
  217. package/tools/agents/providers/pi.mjs +3 -1
  218. package/tools/agents/providers/rule-delivery-surface.mjs +359 -0
  219. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  220. package/tools/agents/providers/rule-deployment-commit.mjs +148 -0
  221. package/tools/agents/providers/rule-deployment-prepare.mjs +461 -0
  222. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  223. package/tools/agents/providers/rule-projection.mjs +3 -0
  224. package/tools/daemon/README.md +511 -0
  225. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  226. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  227. package/tools/daemon/agent-supervisor.mjs +299 -0
  228. package/tools/daemon/automation-engine.mjs +310 -0
  229. package/tools/daemon/autonomous-engine.mjs +346 -0
  230. package/tools/daemon/behavior-loader.mjs +316 -0
  231. package/tools/daemon/behavior.mjs +174 -0
  232. package/tools/daemon/concierge/intent-router.mjs +401 -0
  233. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  234. package/tools/daemon/concierge/response-translator.mjs +462 -0
  235. package/tools/daemon/config.mjs +377 -0
  236. package/tools/daemon/cron-scheduler.mjs +178 -0
  237. package/tools/daemon/daemon-main.mjs +1169 -0
  238. package/tools/daemon/event-router.mjs +84 -0
  239. package/tools/daemon/file-watcher.mjs +383 -0
  240. package/tools/daemon/index.mjs +1181 -0
  241. package/tools/daemon/init-profile.mjs +124 -0
  242. package/tools/daemon/ipc-client.mjs +197 -0
  243. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  244. package/tools/daemon/ipc-server.mjs +275 -0
  245. package/tools/daemon/maintenance-owner.mjs +79 -0
  246. package/tools/daemon/memory-manager.mjs +386 -0
  247. package/tools/daemon/message-router.mjs +194 -0
  248. package/tools/daemon/provider-watcher.mjs +585 -0
  249. package/tools/daemon/pty-adapter.mjs +420 -0
  250. package/tools/daemon/repl-chat.mjs +359 -0
  251. package/tools/daemon/resource-bounds.mjs +88 -0
  252. package/tools/daemon/sandbox-transport.mjs +295 -0
  253. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  254. package/tools/daemon/task-store.mjs +450 -0
  255. package/tools/daemon/tmux-manager.mjs +324 -0
  256. package/tools/daemon/update-policy.mjs +517 -0
  257. package/tools/daemon/web-server.mjs +399 -0
  258. package/tools/daemon/web-ui/index.html +585 -0
  259. package/tools/daemon/web-ui/styles.css +156 -0
  260. package/tools/docker/Dockerfile.daemon +35 -0
  261. package/tools/docker/container-manager.mjs +291 -0
  262. package/tools/messaging/adapter-registry.mjs +230 -0
  263. package/tools/messaging/adapters/base.mjs +326 -0
  264. package/tools/messaging/adapters/discord.mjs +462 -0
  265. package/tools/messaging/adapters/slack.mjs +402 -0
  266. package/tools/messaging/adapters/telegram.mjs +552 -0
  267. package/tools/messaging/chat-handler.mjs +297 -0
  268. package/tools/messaging/command-router.mjs +269 -0
  269. package/tools/messaging/event-bus.mjs +199 -0
  270. package/tools/messaging/index.mjs +456 -0
  271. package/tools/messaging/message-formatter.mjs +320 -0
  272. package/tools/messaging/room-manager.mjs +277 -0
  273. package/tools/messaging/types.mjs +94 -0
  274. package/tools/providers/pi-bridge-policy.mjs +4 -0
  275. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  276. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  277. package/tools/ralph-external/lib/worker-invocation-processes.mjs +7 -4
  278. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  279. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  280. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  281. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  282. package/tools/ralph-external/lib/worker-termination.mjs +15 -8
  283. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  284. package/tools/ralph-external/session-launcher.mjs +7 -7
  285. package/tools/scripts/resource-preflight.mjs +3 -242
  286. package/vscode-extension/schemas/aiwg.config.v1.json +2 -4
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Daemon Command Handlers
3
3
  *
4
- * Handlers for daemon-related CLI commands (behavior management, daemon init).
4
+ * Handlers for daemon-related CLI commands (lifecycle, behavior management, daemon init).
5
5
  * Each handler delegates to existing scripts in tools/.
6
6
  *
7
7
  * @tests @test/unit/cli/handlers/coverage.test.ts
@@ -22,6 +22,20 @@ class DaemonHandler {
22
22
  return runner.run(this.scriptPath, ctx.args);
23
23
  }
24
24
  }
25
+ /** Runs the existing daemon CLI without changing its shared lifecycle state. */
26
+ class DaemonControlHandler extends DaemonHandler {
27
+ id = 'daemon';
28
+ name = 'Daemon';
29
+ description = 'Manage the daemon: start, stop, status, chat, attach and scheduled tasks';
30
+ scriptPath = 'tools/daemon/index.mjs';
31
+ async execute(ctx) {
32
+ const runner = createScriptRunner(await getFrameworkRoot());
33
+ return runner.run(this.scriptPath, ctx.args, { cwd: ctx.cwd });
34
+ }
35
+ async help(ctx) {
36
+ return this.execute({ ...ctx, args: ['--help'] });
37
+ }
38
+ }
25
39
  /**
26
40
  * Behavior Handler
27
41
  *
@@ -47,12 +61,14 @@ class DaemonInitHandler extends DaemonHandler {
47
61
  /**
48
62
  * Exported handler instances
49
63
  */
64
+ export const daemonHandler = new DaemonControlHandler();
50
65
  export const behaviorHandler = new BehaviorHandler();
51
66
  export const daemonInitHandler = new DaemonInitHandler();
52
67
  /**
53
68
  * All daemon handlers for registration
54
69
  */
55
70
  export const daemonHandlers = [
71
+ daemonHandler,
56
72
  behaviorHandler,
57
73
  daemonInitHandler,
58
74
  ];
@@ -1,10 +1,10 @@
1
1
  // Validate public doctor flags before routing early-return modes.
2
2
  import { argsTerminatorIndex, hasPositionalOrSwitch, requireFlagValue, valueTokenIndexes } from '../flag-parsing.js';
3
3
  export function parsePublicDoctorFlags(args) {
4
- const valueFlags = ['--provider', '--bundle', '--scope', '--context-baseline', '--context-budget-tokens', '--cli', '--forget-approval'];
4
+ const valueFlags = ['--provider', '--bundle', '--scope', '--context-baseline', '--context-budget-tokens', '--cli', '--forget-approval', '--group'];
5
5
  const knownFlags = new Set([
6
6
  ...valueFlags, '--list-approvals', '--all-providers', '--probe-workers', '--qualify', '--yes', '--dry-run', '--no-budget-check', '--strict-context', '--json',
7
- '--decision-offload', '--deployment', '--user', '--verbose', '-v', '--project-local', '--quiet', '--help', '-h',
7
+ '--resources', '--decision-offload', '--deployment', '--user', '--verbose', '-v', '--project-local', '--quiet', '--help', '-h',
8
8
  ]);
9
9
  const hasSwitch = (name) => hasPositionalOrSwitch(args, name, valueFlags);
10
10
  const values = new Map();
@@ -21,19 +21,24 @@ export function parsePublicDoctorFlags(args) {
21
21
  throw new Error(`Unknown flag: ${name}`);
22
22
  }
23
23
  }
24
+ if (values.get('--group') !== undefined && !hasSwitch('--resources'))
25
+ throw new Error('--group requires --resources');
26
+ if (hasSwitch('--resources') && (['--probe-workers', '--decision-offload', '--deployment', '--user', '--project-local'].some(hasSwitch) || values.get('--scope') !== undefined)) {
27
+ throw new Error('--resources must run separately from other doctor modes');
28
+ }
24
29
  if (hasSwitch('--decision-offload') && (hasSwitch('--probe-workers') || hasSwitch('--deployment') || hasSwitch('--user') || values.get('--scope') !== undefined)) {
25
30
  throw new Error('--decision-offload is a separate offline mode; do not combine it with worker, deployment or user-scope checks');
26
31
  }
27
32
  if (['--list-approvals', '--forget-approval', '--qualify', '--cli', '--yes', '--dry-run'].some(flag => hasSwitch(flag) || values.get(flag)) && !hasSwitch('--probe-workers')) {
28
33
  throw new Error('--list-approvals, --forget-approval, --qualify, --cli, --yes and --dry-run require --probe-workers');
29
34
  }
30
- if ((hasSwitch('--list-approvals') || values.get('--forget-approval')) && ((hasSwitch('--list-approvals') && values.get('--forget-approval')) || ['--qualify', '--dry-run', '--decision-offload', '--deployment', '--user'].some(hasSwitch) || values.get('--scope') !== undefined)) {
35
+ if ((hasSwitch('--list-approvals') || values.get('--forget-approval')) && ((hasSwitch('--list-approvals') && values.get('--forget-approval')) || ['--qualify', '--dry-run', '--resources', '--decision-offload', '--deployment', '--user'].some(hasSwitch) || values.get('--scope') !== undefined)) {
31
36
  throw new Error('Approval management must run separately from other doctor modes');
32
37
  }
33
38
  if (values.get('--forget-approval') && !hasSwitch('--yes'))
34
39
  throw new Error('--forget-approval requires --yes');
35
- if (hasSwitch('--json') && !hasSwitch('--probe-workers') && !hasSwitch('--deployment') && !hasSwitch('--decision-offload')) {
36
- throw new Error('--json requires --probe-workers or --deployment or --decision-offload');
40
+ if (hasSwitch('--json') && !hasSwitch('--probe-workers') && !hasSwitch('--deployment') && !hasSwitch('--decision-offload') && !hasSwitch('--resources')) {
41
+ throw new Error('--json requires --probe-workers or --deployment or --decision-offload or --resources');
37
42
  }
38
43
  return { hasSwitch, values };
39
44
  }
@@ -18,10 +18,12 @@ Options:
18
18
  --yes Confirm worker qualification or approval removal
19
19
  --dry-run With --probe-workers, preview qualification without writes
20
20
  --cli NAME Limit worker probes, qualification, or approvals to one CLI
21
+ --group <name> Apply the named group cap (requires --resources)
22
+ --resources Report live host resources, threshold origins and remaining worker slots (supports --json)
21
23
  --decision-offload Show offline advisory decision readiness and adoption report
22
24
  --probe-workers Run bounded worker CLI version probes (default: config-only, no subprocess)
23
25
  --project-local Include project-local artifact diagnostics
24
- --json Emit machine-readable output (with --probe-workers: one worker-probe record per CLI; with --deployment: deployment verification; with --decision-offload: offline snapshot)
26
+ --json Emit machine-readable output (with --probe-workers: one worker-probe record per CLI; with --deployment: deployment verification; with --decision-offload: offline snapshot; with --resources: host capacity)
25
27
  --verbose, -v Include verbose diagnostics
26
28
  --help, -h Show this help
27
29
 
@@ -29,6 +31,7 @@ Exit status:
29
31
  0 Checks completed; ordinary doctor warnings are advisory.
30
32
  1 Diagnostic errors, failed or partial explicit worker qualification, or blocked recorded invocations.
31
33
  2 Invalid usage.
34
+ --resources exits 1 when slots are zero.
32
35
  --qualify uses the same exit status in text and JSON output.
33
36
  `;
34
37
  //# sourceMappingURL=doctor-help.js.map
@@ -19,7 +19,7 @@ import { statusHandler, wizardHandler, migrateWorkspaceHandler, rollbackWorkspac
19
19
  import { prefillCardsHandler, contributeStartHandler, validateMetadataHandler, doctorHandler, contextFirewallHandler, updateHandler, utilityHandlers, } from './utilities.js';
20
20
  import { skillLintHandler } from './skill-lint.js';
21
21
  import { addAgentHandler, addCommandHandler, addSkillHandler, addBehaviorHandler, addTemplateHandler, scaffoldAddonHandler, scaffoldExtensionHandler, scaffoldFrameworkHandler, scaffoldingHandlers, } from './scaffolding.js';
22
- import { behaviorHandler, daemonInitHandler, daemonHandlers, } from './daemon.js';
22
+ import { behaviorHandler, daemonHandler, daemonInitHandler, daemonHandlers, } from './daemon.js';
23
23
  import { housekeeperHandler, housekeeperHandlers, } from './housekeeper.js';
24
24
  import { ralphHandler, ralphStatusHandler, ralphAbortHandler, ralphResumeHandler, ralphAttachHandler, ralphExternalHandler, ralphMemoryHandler, ralphConfigHandler, ralphHandlers, } from './ralph.js';
25
25
  import { mcpHandler, catalogHandler, listHandler, removeHandler, promoteHandler, newBundleHandler, quickrefHandler, newProjectHandler, installPluginHandler, uninstallPluginHandler, pluginStatusHandler, packagePluginHandler, packageAllPluginsHandler, indexHandler, corpusHandler, discoverHandler, showHandler, featuresHandler, skillsHandler, configHandler, opsHandler, storageHandler, activityLogHandler, kbHandler, memoryHandler, reflectionsHandler, provenanceHandler, researchStoreHandler, researchQueryHandler, chunkHandler, fanoutHandler, rlmPrepHandler, rlmSearchHandler, rlmStatusCliHandler, rlmCacheHandler, subcommandHandlers, } from './subcommands.js';
@@ -98,7 +98,7 @@ installPluginHandler, uninstallPluginHandler, pluginStatusHandler, packagePlugin
98
98
  // Scaffolding
99
99
  addAgentHandler, addCommandHandler, addSkillHandler, addBehaviorHandler, addTemplateHandler, scaffoldAddonHandler, scaffoldExtensionHandler, scaffoldFrameworkHandler,
100
100
  // Daemon
101
- behaviorHandler, daemonInitHandler, housekeeperHandler,
101
+ behaviorHandler, daemonHandler, daemonInitHandler, housekeeperHandler,
102
102
  // Ralph
103
103
  ralphHandler, ralphStatusHandler, ralphAbortHandler, ralphResumeHandler, ralphAttachHandler, ralphExternalHandler, ralphMemoryHandler, ralphConfigHandler,
104
104
  // Mission Control
@@ -0,0 +1,111 @@
1
+ import * as ui from '../ui.js';
2
+ import { hasFlag } from './mc-args.js';
3
+ // ── Agent routing query ──────────────────────────────────────
4
+ /**
5
+ * aiwg mc agents [--filter key=value...] [--json]
6
+ *
7
+ * Queries GET /api/agents/candidates on the local aiwg serve instance and
8
+ * prints a table of agents that match the given routing filter. This is a thin
9
+ * CLI wrapper over the #916 routing endpoint so operators can check routing
10
+ * from a terminal without opening the dashboard.
11
+ *
12
+ * Filter flags:
13
+ * --framework <name> Require a specific AIWG framework (repeatable)
14
+ * --sandbox <id> Restrict to a specific sandbox
15
+ * --agent <id> Restrict to a specific agent ID
16
+ * --name <n> Match by logical name
17
+ * --max-cpu <pct> Reject agents above this CPU %
18
+ * --min-memory <gb> Reject agents below this memory threshold
19
+ * --json Output raw JSON
20
+ */
21
+ export async function mcAgents(ctx) {
22
+ const args = ctx.args;
23
+ const json = hasFlag(args, '--json');
24
+ const port = process.env['AIWG_SERVE_PORT'] ?? '7337';
25
+ const base = `http://127.0.0.1:${port}`;
26
+ const params = new URLSearchParams();
27
+ for (let i = 0; i < args.length; i++) {
28
+ const a = args[i];
29
+ if (a === '--framework' && args[i + 1]) {
30
+ params.append('frameworks', args[++i]);
31
+ }
32
+ else if (a === '--sandbox' && args[i + 1]) {
33
+ params.set('sandbox_id', args[++i]);
34
+ }
35
+ else if (a === '--agent' && args[i + 1]) {
36
+ params.set('agent_id', args[++i]);
37
+ }
38
+ else if (a === '--name' && args[i + 1]) {
39
+ params.set('agent_name', args[++i]);
40
+ }
41
+ else if (a === '--max-cpu' && args[i + 1]) {
42
+ params.set('max_cpu_percent', args[++i]);
43
+ }
44
+ else if (a === '--min-memory' && args[i + 1]) {
45
+ params.set('min_memory_gb', args[++i]);
46
+ }
47
+ }
48
+ // 5s timeout so a wedged serve cannot hang the CLI. Override with
49
+ // AIWG_FETCH_TIMEOUT_MS for slow local environments or integration tests.
50
+ const fetchTimeoutMs = (() => {
51
+ const raw = process.env['AIWG_FETCH_TIMEOUT_MS'];
52
+ const n = raw ? parseInt(raw, 10) : NaN;
53
+ return Number.isFinite(n) && n > 0 ? n : 5_000;
54
+ })();
55
+ let result;
56
+ try {
57
+ // Combine user-cancel (Ctrl-C) with the per-call timeout so the fetch
58
+ // aborts on either. `AbortSignal.any` requires Node 20+.
59
+ const signal = ctx.signal
60
+ ? AbortSignal.any([ctx.signal, AbortSignal.timeout(fetchTimeoutMs)])
61
+ : AbortSignal.timeout(fetchTimeoutMs);
62
+ const resp = await fetch(`${base}/api/agents/candidates?${params.toString()}`, {
63
+ signal,
64
+ });
65
+ if (!resp.ok) {
66
+ ui.error(`aiwg serve returned ${resp.status} — is it running on port ${port}?`);
67
+ return { exitCode: 1 };
68
+ }
69
+ result = await resp.json();
70
+ }
71
+ catch (err) {
72
+ if (err instanceof Error && err.name === 'TimeoutError') {
73
+ ui.error(`aiwg serve on port ${port} timed out after ${fetchTimeoutMs}ms. Is it wedged?`);
74
+ }
75
+ else {
76
+ ui.error(`Cannot reach aiwg serve on port ${port}. Start it with: aiwg serve`);
77
+ }
78
+ return { exitCode: 1 };
79
+ }
80
+ if (json) {
81
+ console.log(JSON.stringify(result, null, 2));
82
+ return { exitCode: 0 };
83
+ }
84
+ ui.blank();
85
+ console.log(` ${ui.brandMark()} ${ui.bold('Agent Routing Candidates')}`);
86
+ ui.rule();
87
+ if (result.candidates.length === 0) {
88
+ ui.info('No matching agents found for the given filter.');
89
+ return { exitCode: 0 };
90
+ }
91
+ for (const c of result.candidates) {
92
+ const agent = c['agent'];
93
+ const agentId = agent?.['agentId'] ?? '?';
94
+ const logicalName = agent?.['logicalName'];
95
+ const sandboxName = c['sandboxName'] ?? '';
96
+ const cpu = agent?.['latestMetrics']?.['cpu_percent'];
97
+ const status = agent?.['status'] ?? '';
98
+ const isSelected = result.selected?.['sandboxName'] === sandboxName &&
99
+ result.selected?.['agent']?.['agentId'] === agentId;
100
+ const label = logicalName ? `${logicalName} (${agentId})` : agentId;
101
+ const cpuStr = cpu !== undefined ? ` cpu:${cpu.toFixed(0)}%` : '';
102
+ const selectedMark = isSelected ? ' ← selected' : '';
103
+ console.log(` • ${ui.bold(label)} sandbox:${sandboxName} status:${status}${cpuStr}${selectedMark}`);
104
+ const reason = c['matchReason'];
105
+ if (reason)
106
+ console.log(` reason: ${reason}`);
107
+ }
108
+ ui.blank();
109
+ return { exitCode: 0 };
110
+ }
111
+ //# sourceMappingURL=mc-agents.js.map
@@ -0,0 +1,54 @@
1
+ // Mission Control args operations, extracted from the shared handler.
2
+ export function parseFlag(args, flag) {
3
+ for (let i = 0; i < args.length; i++) {
4
+ if (args[i] === flag) {
5
+ return i + 1 < args.length ? args[i + 1] : undefined;
6
+ }
7
+ // Support --flag=value — previously silently ignored, which for budget
8
+ // flags meant an unbounded loop the operator believed was capped (#1770)
9
+ if (args[i].startsWith(`${flag}=`)) {
10
+ return args[i].slice(flag.length + 1);
11
+ }
12
+ }
13
+ return undefined;
14
+ }
15
+ export function hasFlag(args, flag) {
16
+ return args.includes(flag);
17
+ }
18
+ /**
19
+ * Parse a numeric flag. A flag that is PRESENT but not a positive number is a
20
+ * usage error collected into `invalidSink` — silently dropping it used to
21
+ * dispatch missions with no ceiling while the operator believed one applied
22
+ * (#1770).
23
+ */
24
+ export function parseNumberFlag(args, flag, invalidSink, integer = false) {
25
+ if (!args.some(arg => arg === flag || arg.startsWith(`${flag}=`)))
26
+ return undefined;
27
+ const raw = parseFlag(args, flag);
28
+ // Presence and validity are distinct: a trailing flag must not silently
29
+ // disappear, and counter limits must not accept fractional/unsafe values.
30
+ const decimal = typeof raw === 'string' && /^[+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/.test(raw);
31
+ const value = decimal ? Number(raw) : NaN;
32
+ if (!Number.isFinite(value) || value <= 0 || (integer && !Number.isSafeInteger(value))) {
33
+ invalidSink?.push(`${flag} (got '${raw}')`);
34
+ return undefined;
35
+ }
36
+ return value;
37
+ }
38
+ export function wantsHelp(args) {
39
+ return args.includes('--help') || args.includes('-h');
40
+ }
41
+ export function getPositionalArgs(args) {
42
+ const positional = [];
43
+ for (let i = 0; i < args.length; i++) {
44
+ if (args[i].startsWith('--')) {
45
+ // Skip flag and its value if it has one
46
+ if (i + 1 < args.length && !args[i + 1].startsWith('--'))
47
+ i++;
48
+ continue;
49
+ }
50
+ positional.push(args[i]);
51
+ }
52
+ return positional;
53
+ }
54
+ //# sourceMappingURL=mc-args.js.map
@@ -0,0 +1,227 @@
1
+ import * as ui from '../ui.js';
2
+ import { createMcAdmissionScheduler } from './mc-admission.js';
3
+ import { readSession, writeSession, appendLog, mutateSession, mutationFlags, mutationFailure, findActiveSession } from './mc-session.js';
4
+ import { hasFlag, getPositionalArgs } from './mc-args.js';
5
+ import { readAdmissionConfig } from './mc-worker.js';
6
+ export async function managedControlScheduler(ctx, missions) {
7
+ const projectRoot = ctx.cwd || process.cwd();
8
+ const cfg = await readAdmissionConfig(projectRoot);
9
+ if (!cfg?.parallelism?.worker_dispatch || cfg.parallelism.worker_mode !== 'managed')
10
+ return undefined;
11
+ const scheduler = await createMcAdmissionScheduler(projectRoot, cfg);
12
+ const snapshot = scheduler.snapshot();
13
+ for (const mission of missions) {
14
+ if (!mission.admissionRequestId)
15
+ continue;
16
+ const record = snapshot.records[mission.admissionRequestId];
17
+ if (!record || !mission.admissionGeneration || record.leaseGeneration !== mission.admissionGeneration) {
18
+ throw new Error('stale managed Mission checkpoint generation');
19
+ }
20
+ }
21
+ return scheduler;
22
+ }
23
+ export function managedControlFailure(error) {
24
+ const message = error instanceof Error ? error.message : String(error);
25
+ ui.error(message);
26
+ return { exitCode: 1, message };
27
+ }
28
+ export async function cancelManagedMission(ctx, scheduler, mission) {
29
+ if (!mission.admissionRequestId)
30
+ return;
31
+ const cancelled = scheduler.cancel(mission.admissionRequestId, mission.admissionGeneration);
32
+ mission.admissionState = cancelled.state;
33
+ mission.admissionLeaseExpiresAt = undefined;
34
+ if (cancelled.state !== 'uncertain' || !mission.ralphLoopId || !mission.admissionExecution)
35
+ return;
36
+ try {
37
+ const { cancelManagedRalph } = await import('./ralph-launcher.js');
38
+ await cancelManagedRalph(ctx.frameworkRoot, ctx.cwd || process.cwd(), mission.ralphLoopId, {
39
+ requestId: mission.admissionRequestId, generation: mission.admissionGeneration, execution: mission.admissionExecution,
40
+ });
41
+ }
42
+ catch {
43
+ // Reservation is already uncertain; unavailable signalling cannot release it.
44
+ }
45
+ }
46
+ export async function mcAbort(ctx) {
47
+ const positional = getPositionalArgs(ctx.args);
48
+ const sessionId = positional[0];
49
+ const missionId = positional[1];
50
+ if (!sessionId || !missionId) {
51
+ ui.error('Usage: aiwg mc abort <session-id> <mission-id>');
52
+ return { exitCode: 1 };
53
+ }
54
+ let managedScheduler;
55
+ try {
56
+ const selected = await readSession(sessionId);
57
+ managedScheduler = await managedControlScheduler(ctx, selected?.missions.filter(mission => mission.id === missionId) ?? []);
58
+ }
59
+ catch (error) {
60
+ return managedControlFailure(error);
61
+ }
62
+ const flags = mutationFlags(ctx.args);
63
+ const result = await mutateSession(sessionId, 'cancel', missionId, flags.expectedUpdatedAt, flags.requestId, session => {
64
+ const mission = session.missions.find(m => m.id === missionId);
65
+ if (!mission)
66
+ return 'target_not_found';
67
+ if (mission.status === 'done' || mission.status === 'failed' || mission.status === 'aborted')
68
+ return 'invalid_state';
69
+ mission.status = 'aborted';
70
+ mission.completedAt = new Date().toISOString();
71
+ return undefined;
72
+ });
73
+ if (!result.ok)
74
+ return mutationFailure(result);
75
+ if (!result.replayed) {
76
+ const mission = result.session.missions.find(candidate => candidate.id === missionId);
77
+ if (mission?.admissionRequestId) {
78
+ try {
79
+ if (managedScheduler) {
80
+ await cancelManagedMission(ctx, managedScheduler, mission);
81
+ await writeSession(result.session);
82
+ }
83
+ else {
84
+ const projectRoot = ctx.cwd || process.cwd();
85
+ const cfg = await readAdmissionConfig(projectRoot);
86
+ const scheduler = await createMcAdmissionScheduler(projectRoot, cfg);
87
+ scheduler.cancel(mission.admissionRequestId);
88
+ }
89
+ }
90
+ catch (error) {
91
+ if (managedScheduler)
92
+ return managedControlFailure(error);
93
+ // Legacy leases keep their existing best-effort cancellation behavior.
94
+ }
95
+ }
96
+ }
97
+ ui.success(`${result.replayed ? 'Replayed' : 'Aborted'} mission: ${missionId}`);
98
+ return { exitCode: 0, message: JSON.stringify({ ok: true, replayed: result.replayed, updated_at: result.session.updatedAt }) };
99
+ }
100
+ export async function mcPause(ctx) {
101
+ const positional = getPositionalArgs(ctx.args);
102
+ const sessionId = positional[0];
103
+ const selected = await findActiveSession(sessionId);
104
+ if (!selected) {
105
+ ui.error('No active session to pause.');
106
+ return { exitCode: 1 };
107
+ }
108
+ let managedScheduler;
109
+ try {
110
+ managedScheduler = await managedControlScheduler(ctx, selected.missions.filter(mission => mission.status === 'running'));
111
+ }
112
+ catch (error) {
113
+ return managedControlFailure(error);
114
+ }
115
+ const flags = mutationFlags(ctx.args);
116
+ const result = await mutateSession(selected.id, 'pause', selected.id, flags.expectedUpdatedAt, flags.requestId, session => {
117
+ if (session.state !== 'active')
118
+ return 'invalid_state';
119
+ session.state = 'paused';
120
+ for (const mission of session.missions)
121
+ if (mission.status === 'running')
122
+ mission.status = 'paused';
123
+ return undefined;
124
+ });
125
+ if (!result.ok)
126
+ return mutationFailure(result);
127
+ if (!result.replayed && managedScheduler) {
128
+ for (const mission of result.session.missions) {
129
+ if (mission.status === 'paused')
130
+ await cancelManagedMission(ctx, managedScheduler, mission);
131
+ }
132
+ await writeSession(result.session);
133
+ }
134
+ ui.success(`${result.replayed ? 'Replayed pause for' : 'Paused'} session: ${selected.id}`);
135
+ return { exitCode: 0, message: JSON.stringify({ ok: true, replayed: result.replayed, updated_at: result.session.updatedAt }) };
136
+ }
137
+ export async function mcResume(ctx) {
138
+ const positional = getPositionalArgs(ctx.args);
139
+ const sessionId = positional[0];
140
+ const selected = await findActiveSession(sessionId);
141
+ if (!selected || selected.state !== 'paused') {
142
+ ui.error('No paused session to resume.');
143
+ return { exitCode: 1 };
144
+ }
145
+ try {
146
+ const cfg = await readAdmissionConfig(ctx.cwd || process.cwd());
147
+ if (cfg?.parallelism?.worker_dispatch && cfg.parallelism.worker_mode === 'managed') {
148
+ const scheduler = await createMcAdmissionScheduler(ctx.cwd || process.cwd(), cfg);
149
+ const snapshot = scheduler.snapshot();
150
+ for (const mission of selected.missions.filter(candidate => candidate.status === 'paused')) {
151
+ if (!mission.admissionRequestId)
152
+ continue;
153
+ const record = snapshot.records[mission.admissionRequestId];
154
+ if (!record || record.leaseGeneration !== mission.admissionGeneration || record.state !== 'admitted') {
155
+ throw new Error('managed resume requires current admission and reconciliation of uncertain work');
156
+ }
157
+ }
158
+ }
159
+ }
160
+ catch (error) {
161
+ const message = error instanceof Error ? error.message : String(error);
162
+ ui.error(message);
163
+ return { exitCode: 1, message };
164
+ }
165
+ const flags = mutationFlags(ctx.args);
166
+ const result = await mutateSession(selected.id, 'resume', selected.id, flags.expectedUpdatedAt, flags.requestId, session => {
167
+ if (session.state !== 'paused')
168
+ return 'invalid_state';
169
+ session.state = 'active';
170
+ for (const mission of session.missions)
171
+ if (mission.status === 'paused')
172
+ mission.status = 'running';
173
+ return undefined;
174
+ });
175
+ if (!result.ok)
176
+ return mutationFailure(result);
177
+ ui.success(`${result.replayed ? 'Replayed resume for' : 'Resumed'} session: ${selected.id}`);
178
+ return { exitCode: 0, message: JSON.stringify({ ok: true, replayed: result.replayed, updated_at: result.session.updatedAt }) };
179
+ }
180
+ export async function mcStop(ctx) {
181
+ const positional = getPositionalArgs(ctx.args);
182
+ const sessionId = positional[0];
183
+ const drain = hasFlag(ctx.args, '--drain');
184
+ const session = await findActiveSession(sessionId);
185
+ if (!session) {
186
+ ui.error('No active session to stop.');
187
+ return { exitCode: 1 };
188
+ }
189
+ let managedScheduler;
190
+ try {
191
+ managedScheduler = await managedControlScheduler(ctx, session.missions.filter(mission => mission.status === 'queued' || (!drain && (mission.status === 'running' || mission.status === 'paused'))));
192
+ }
193
+ catch (error) {
194
+ return managedControlFailure(error);
195
+ }
196
+ if (drain) {
197
+ // Mark queued missions as aborted, let running finish
198
+ for (const m of session.missions) {
199
+ if (m.status === 'queued') {
200
+ m.status = 'aborted';
201
+ m.completedAt = new Date().toISOString();
202
+ }
203
+ }
204
+ ui.info('Draining: queued missions cancelled, running missions will complete.');
205
+ }
206
+ else {
207
+ // Abort all non-completed missions
208
+ for (const m of session.missions) {
209
+ if (m.status === 'running' || m.status === 'queued' || m.status === 'paused') {
210
+ m.status = 'aborted';
211
+ m.completedAt = new Date().toISOString();
212
+ }
213
+ }
214
+ }
215
+ if (managedScheduler) {
216
+ for (const mission of session.missions) {
217
+ if (mission.status === 'aborted')
218
+ await cancelManagedMission(ctx, managedScheduler, mission);
219
+ }
220
+ }
221
+ session.state = 'stopped';
222
+ await writeSession(session);
223
+ await appendLog(session.id, { event: 'session_stopped', drain });
224
+ ui.success(`Stopped session: ${session.id}`);
225
+ return { exitCode: 0 };
226
+ }
227
+ //# sourceMappingURL=mc-control.js.map