@aiwg/cli 2026.10.16 → 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 (128) hide show
  1. package/dist/src/artifacts/corpus-tools/resolve.js +21 -4
  2. package/dist/src/artifacts/query-engine-corpus.js +217 -0
  3. package/dist/src/artifacts/query-engine-discover-output.js +229 -0
  4. package/dist/src/artifacts/query-engine-discover.js +285 -0
  5. package/dist/src/artifacts/query-engine-entries.js +188 -0
  6. package/dist/src/artifacts/query-engine-index.js +249 -0
  7. package/dist/src/artifacts/query-engine-matching.js +143 -0
  8. package/dist/src/artifacts/query-engine-options.js +2 -0
  9. package/dist/src/artifacts/query-engine-rules.js +202 -0
  10. package/dist/src/artifacts/query-engine-scoring.js +436 -0
  11. package/dist/src/artifacts/query-engine-show-card.js +194 -0
  12. package/dist/src/artifacts/query-engine-show-load.js +211 -0
  13. package/dist/src/artifacts/query-engine-show.js +300 -0
  14. package/dist/src/artifacts/query-engine.js +7 -2576
  15. package/dist/src/cli/handlers/mc-agents.js +111 -0
  16. package/dist/src/cli/handlers/mc-args.js +54 -0
  17. package/dist/src/cli/handlers/mc-control.js +227 -0
  18. package/dist/src/cli/handlers/mc-dispatch.js +203 -0
  19. package/dist/src/cli/handlers/mc-help.js +171 -0
  20. package/dist/src/cli/handlers/mc-run.js +343 -0
  21. package/dist/src/cli/handlers/mc-session.js +138 -0
  22. package/dist/src/cli/handlers/mc-status.js +258 -0
  23. package/dist/src/cli/handlers/mc-summary.js +43 -0
  24. package/dist/src/cli/handlers/mc-types.js +3 -0
  25. package/dist/src/cli/handlers/mc-worker.js +205 -0
  26. package/dist/src/cli/handlers/mc.js +12 -1665
  27. package/dist/src/cli/handlers/models-refusal.js +13 -0
  28. package/dist/src/cli/handlers/models.js +2 -1
  29. package/dist/src/cli/handlers/remove-bundled.js +133 -0
  30. package/dist/src/cli/handlers/remove-options.js +31 -0
  31. package/dist/src/cli/handlers/remove-user.js +174 -0
  32. package/dist/src/cli/handlers/remove.js +201 -0
  33. package/dist/src/cli/handlers/subcommands-bundles.js +257 -0
  34. package/dist/src/cli/handlers/subcommands-discovery.js +165 -0
  35. package/dist/src/cli/handlers/subcommands-list-format.js +129 -0
  36. package/dist/src/cli/handlers/subcommands-list.js +250 -0
  37. package/dist/src/cli/handlers/subcommands-plugins.js +213 -0
  38. package/dist/src/cli/handlers/subcommands-quickref.js +58 -0
  39. package/dist/src/cli/handlers/subcommands-rlm.js +113 -0
  40. package/dist/src/cli/handlers/subcommands-services.js +66 -0
  41. package/dist/src/cli/handlers/subcommands-storage.js +259 -0
  42. package/dist/src/cli/handlers/subcommands.js +18 -1984
  43. package/dist/src/cli/scope-resolver.js +1 -142
  44. package/dist/src/cli/user-scope-mirror.js +173 -0
  45. package/dist/src/config/dispatch-host-thresholds.js +2 -0
  46. package/dist/src/config/dispatch-thresholds-runtime.mjs +4 -0
  47. package/dist/src/config/host-resource-report.d.mts +5 -0
  48. package/dist/src/config/host-resource-report.mjs +36 -6
  49. package/dist/src/config/host-resource-runtime.d.mts +3 -0
  50. package/dist/src/config/host-resource-runtime.mjs +9 -6
  51. package/dist/src/decision/ensemble-study/artifacts.js +7 -0
  52. package/dist/src/decision/ensemble-study/gate-policy.js +58 -0
  53. package/dist/src/decision/ensemble-study/gates.js +78 -0
  54. package/dist/src/decision/ensemble-study/protocol.js +18 -21
  55. package/dist/src/decision/ensemble-study/score.js +3 -2
  56. package/dist/src/decision/ensemble-study/statistics.js +7 -26
  57. package/dist/src/decision/sensitivity/comparative-gates.js +135 -0
  58. package/dist/src/decision/sensitivity/comparative.js +18 -41
  59. package/dist/src/extensions/claude-hooks-installer.js +18 -0
  60. package/dist/src/gates/evaluate.js +2 -358
  61. package/dist/src/gates/observations.js +363 -0
  62. package/dist/src/gates/pack-composition.js +270 -0
  63. package/dist/src/gates/pack-tightening.js +197 -0
  64. package/dist/src/gates/pack-validation.js +262 -0
  65. package/dist/src/gates/registry-error.js +5 -0
  66. package/dist/src/gates/registry.js +13 -685
  67. package/dist/src/mcp/json-document.mjs +29 -0
  68. package/dist/src/mcp/muse-native-config.mjs +1 -28
  69. package/dist/src/mission-protocol/worker-review-gate.js +7 -0
  70. package/dist/src/models/worker-plan.js +5 -5
  71. package/dist/src/plugin/command-ownership.js +34 -0
  72. package/dist/src/plugin/skill-command-frontmatter.js +197 -0
  73. package/dist/src/plugin/skill-command-translator.js +6 -232
  74. package/dist/src/providers/context-output-ownership.js +26 -0
  75. package/dist/src/providers/deployment-ownership.d.mts +19 -0
  76. package/dist/src/providers/deployment-ownership.mjs +226 -0
  77. package/dist/src/providers/deployment-removal.js +200 -0
  78. package/dist/src/providers/removal-transaction.js +86 -0
  79. package/dist/src/providers/settings-document.d.mts +3 -0
  80. package/dist/src/providers/settings-document.mjs +47 -0
  81. package/dist/src/providers/settings-removal.js +190 -0
  82. package/dist/src/providers/skill-ownership.d.mts +19 -2
  83. package/dist/src/providers/skill-ownership.mjs +12 -4
  84. package/dist/src/providers/transformation-receipt-integration.js +15 -271
  85. package/dist/src/providers/transformation-receipt-outputs.js +99 -0
  86. package/dist/src/providers/transformation-receipt-source.js +194 -0
  87. package/dist/src/research/identity.js +8 -2
  88. package/dist/src/research/reference-match.js +42 -7
  89. package/dist/src/rules/activation.mjs +15 -6
  90. package/dist/src/rules/core-startup.mjs +2 -2
  91. package/dist/src/serve/mission-conductor.js +4 -0
  92. package/dist/src/serve/mission-summary.js +56 -0
  93. package/dist/src/smiths/context-pipeline/aiwg-md.js +23 -0
  94. package/dist/src/smiths/context-pipeline/context-file-safety.js +3 -0
  95. package/dist/src/smiths/context-pipeline/generator.js +1 -1
  96. package/dist/src/smiths/hook-bridge/index.js +9 -0
  97. package/package.json +4 -1
  98. package/schemas/decision/D17StudyProtocol.v1.schema.json +39 -67
  99. package/tools/agents/deploy-agents.mjs +16 -677
  100. package/tools/agents/deploy-command-mirrors.mjs +229 -0
  101. package/tools/agents/deploy-options.mjs +258 -0
  102. package/tools/agents/deploy-support.mjs +165 -0
  103. package/tools/agents/providers/base-addon-discovery.mjs +139 -0
  104. package/tools/agents/providers/base-behaviors.mjs +168 -0
  105. package/tools/agents/providers/base-context.mjs +205 -0
  106. package/tools/agents/providers/base-contract.mjs +116 -0
  107. package/tools/agents/providers/base-files.mjs +252 -0
  108. package/tools/agents/providers/base-flat-artifacts.mjs +233 -0
  109. package/tools/agents/providers/base-framework-discovery.mjs +309 -0
  110. package/tools/agents/providers/base-frontmatter.mjs +196 -0
  111. package/tools/agents/providers/base-inventory.mjs +269 -0
  112. package/tools/agents/providers/base-kernel-skills.mjs +354 -0
  113. package/tools/agents/providers/base-migrations.mjs +258 -0
  114. package/tools/agents/providers/base-models-platforms.mjs +273 -0
  115. package/tools/agents/providers/base-rule-index.mjs +450 -0
  116. package/tools/agents/providers/base-runtime.mjs +60 -0
  117. package/tools/agents/providers/base-skill-copy.mjs +273 -0
  118. package/tools/agents/providers/base.mjs +16 -3364
  119. package/tools/agents/providers/claude-post-deploy.mjs +10 -2
  120. package/tools/agents/providers/hermes-startup.mjs +0 -5
  121. package/tools/agents/providers/muse.mjs +7 -2
  122. package/tools/agents/providers/rule-delivery-surface.mjs +31 -4
  123. package/tools/agents/providers/rule-deployment-commit.mjs +19 -15
  124. package/tools/agents/providers/rule-deployment-prepare.mjs +11 -2
  125. package/tools/agents/providers/rule-projection.mjs +3 -0
  126. package/tools/ralph-external/lib/worker-invocation-processes.mjs +4 -2
  127. package/tools/ralph-external/lib/worker-termination.mjs +15 -8
  128. package/vscode-extension/schemas/aiwg.config.v1.json +2 -4
@@ -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
@@ -0,0 +1,203 @@
1
+ import * as ui from '../ui.js';
2
+ import { isAbsolute, relative } from 'node:path';
3
+ import { createHash } from 'node:crypto';
4
+ import { assertMissionWorkerHandoff } from '../../mission-protocol/codecs.js';
5
+ import { genId, writeSession, appendLog, mutateSession, mutationFlags, mutationFailure, findActiveSession } from './mc-session.js';
6
+ import { parseFlag, parseNumberFlag, getPositionalArgs } from './mc-args.js';
7
+ import { readAdmissionConfig, mcWorkerSupport, readWorkerJson, resolveMcWorker } from './mc-worker.js';
8
+ import { managedControlFailure } from './mc-control.js';
9
+ // ── Subcommand handlers ──────────────────────────────────────
10
+ export async function mcStart(ctx) {
11
+ const name = parseFlag(ctx.args, '--name') || `Mission ${new Date().toISOString().slice(0, 10)}`;
12
+ const maxMissions = parseInt(parseFlag(ctx.args, '--max-missions') || '10', 10);
13
+ const session = {
14
+ id: genId('mc'),
15
+ name,
16
+ state: 'active',
17
+ maxMissions,
18
+ createdAt: new Date().toISOString(),
19
+ updatedAt: new Date().toISOString(),
20
+ missions: [],
21
+ };
22
+ await writeSession(session);
23
+ await appendLog(session.id, { event: 'session_started', name, maxMissions });
24
+ ui.blank();
25
+ console.log(` ${ui.brandMark()} ${ui.bold('Mission Control')} — ${ui.accent(name)}`);
26
+ ui.rule();
27
+ ui.success(`Session started: ${session.id}`);
28
+ ui.info(`Max missions: ${maxMissions}`);
29
+ // #1439: the lifecycle is start → dispatch → run → status. State this
30
+ // up-front so users don't get stuck wondering why missions never execute.
31
+ ui.info(`Next: \`aiwg mc dispatch ${session.id} "<objective>" --completion "<criteria>"\``);
32
+ ui.info(`Then: \`aiwg mc run ${session.id}\` to drain the queue (missions stay 'queued' until you do).`);
33
+ ui.blank();
34
+ return { exitCode: 0, message: session.id };
35
+ }
36
+ export async function mcDispatch(ctx) {
37
+ const positional = getPositionalArgs(ctx.args);
38
+ const sessionId = positional[0];
39
+ const objective = positional.slice(1).join(' ') || parseFlag(ctx.args, '--objective');
40
+ const completion = parseFlag(ctx.args, '--completion');
41
+ const priority = parseFlag(ctx.args, '--priority') || 'normal';
42
+ const invalidFlags = [];
43
+ const maxIterations = parseNumberFlag(ctx.args, '--max-iterations', invalidFlags, true) ?? 10;
44
+ const maxTotalTokens = parseNumberFlag(ctx.args, '--max-total-tokens', invalidFlags, true);
45
+ const maxOutputTokens = parseNumberFlag(ctx.args, '--max-output-tokens', invalidFlags, true);
46
+ const maxToolCalls = parseNumberFlag(ctx.args, '--max-tool-calls', invalidFlags, true);
47
+ const maxTotalCost = parseNumberFlag(ctx.args, '--max-total-cost', invalidFlags);
48
+ const maxWallClockMinutes = parseNumberFlag(ctx.args, '--max-wall-clock-minutes', invalidFlags);
49
+ const explorationQuota = parseNumberFlag(ctx.args, '--exploration-quota', invalidFlags, true);
50
+ const budgetStopPolicyRaw = parseFlag(ctx.args, '--budget-stop-policy');
51
+ let budgetStopPolicy;
52
+ if (budgetStopPolicyRaw !== undefined) {
53
+ if (budgetStopPolicyRaw === 'completion-wins' || budgetStopPolicyRaw === 'budget-wins') {
54
+ budgetStopPolicy = budgetStopPolicyRaw;
55
+ }
56
+ else {
57
+ invalidFlags.push(`--budget-stop-policy (got '${budgetStopPolicyRaw}', expected completion-wins|budget-wins)`);
58
+ }
59
+ }
60
+ const modeRaw = parseFlag(ctx.args, '--mode') || 'direct';
61
+ const mode = modeRaw === 'pty-orchestrator' ? 'pty-orchestrator' : 'direct';
62
+ const targetAgent = parseFlag(ctx.args, '--target-agent');
63
+ if (!objective) {
64
+ // #1438: keep this in sync with subcommandUsage.dispatch above so 'mc
65
+ // dispatch' with bad args and 'mc dispatch --help' agree on flags.
66
+ ui.error('Usage: aiwg mc dispatch <session-id> "<objective>" [--completion "<criteria>"] [--max-iterations N] [--priority <level>] [--mode pty-orchestrator] [--target-agent <agent-id>]');
67
+ return { exitCode: 1 };
68
+ }
69
+ if (invalidFlags.length > 0) {
70
+ ui.error(`Invalid numeric flag value(s): ${invalidFlags.join(', ')}. Budget/quota flags require positive numbers. Mission not dispatched.`);
71
+ return { exitCode: 1 };
72
+ }
73
+ if (mode === 'pty-orchestrator' && !targetAgent) {
74
+ ui.error('--mode pty-orchestrator requires --target-agent <agent-id>');
75
+ return { exitCode: 1 };
76
+ }
77
+ const selected = await findActiveSession(sessionId);
78
+ if (!selected) {
79
+ ui.error(sessionId ? `Session not found: ${sessionId}` : 'No active session. Run `aiwg mc start` first.');
80
+ return { exitCode: 1 };
81
+ }
82
+ // mission-dispatch accepts only the frozen objective envelope. Worker
83
+ // bindings can arrive through its existing session, so inspect that payload.
84
+ try {
85
+ const cfg = await readAdmissionConfig(ctx.cwd || process.cwd());
86
+ const support = cfg?.parallelism?.worker_dispatch && cfg.parallelism.worker_mode === 'managed' ? mcWorkerSupport() : undefined;
87
+ assertMissionWorkerHandoff(selected, 'mc-cli', support);
88
+ for (const mission of selected.missions)
89
+ assertMissionWorkerHandoff(mission, 'mc-cli', support);
90
+ }
91
+ catch (error) {
92
+ const message = error instanceof Error ? error.message : String(error);
93
+ ui.error(message);
94
+ return { exitCode: 1, message };
95
+ }
96
+ // #1361: Check project-level parallelism cap. Active missions = running or
97
+ // queued; if at cap, warn but still queue (FIFO behavior — the mission goes
98
+ // into the session as 'queued' and will run when a slot frees up).
99
+ let capWarning;
100
+ try {
101
+ const { readAiwgConfig, resolveParallelism } = await import('../../config/aiwg-config.js');
102
+ const cfg = await readAiwgConfig(ctx.cwd || process.cwd());
103
+ if (cfg) {
104
+ const resolved = resolveParallelism(cfg.parallelism, cfg.providers[0]);
105
+ const activeCount = selected.missions.filter(m => m.status === 'running' || m.status === 'queued' || m.status === 'paused').length;
106
+ if (activeCount >= resolved.max_parallel_mc_missions) {
107
+ capWarning = `Active missions (${activeCount}) at or above project parallelism cap (${resolved.max_parallel_mc_missions}). Mission will queue; bump via 'aiwg config set --project parallelism.max_parallel_mc_missions N'.`;
108
+ }
109
+ }
110
+ }
111
+ catch {
112
+ // Non-fatal — config read failure doesn't block dispatch
113
+ }
114
+ const flags = mutationFlags(ctx.args);
115
+ const mission = {
116
+ id: flags.requestId
117
+ ? `m-${createHash('sha256').update(flags.requestId).digest('hex').slice(0, 16)}`
118
+ : genId('m'),
119
+ objective,
120
+ completion,
121
+ status: 'queued',
122
+ loop: 0,
123
+ maxIterations,
124
+ maxTotalTokens,
125
+ maxOutputTokens,
126
+ maxToolCalls,
127
+ maxTotalCost,
128
+ maxWallClockMinutes,
129
+ explorationQuota,
130
+ budgetStopPolicy,
131
+ priority,
132
+ mode,
133
+ targetAgent: targetAgent || undefined,
134
+ };
135
+ const dispatchPath = parseFlag(ctx.args, '--worker-dispatch');
136
+ if (dispatchPath) {
137
+ try {
138
+ const cfg = await readAdmissionConfig(ctx.cwd || process.cwd());
139
+ if (!cfg?.parallelism?.worker_dispatch || cfg.parallelism.worker_mode !== 'managed' || mode !== 'direct') {
140
+ throw new Error('OG_CONTRACT_UNSUPPORTED: worker dispatch requires the managed MC caller');
141
+ }
142
+ if (!isAbsolute(dispatchPath) || relative(ctx.cwd, dispatchPath).startsWith('..'))
143
+ throw new Error('Worker dispatch path must be inside the project');
144
+ const dispatch = await readWorkerJson(dispatchPath);
145
+ mission.extensions = { 'aiwg.worker-dispatch': dispatch };
146
+ assertMissionWorkerHandoff(mission, 'mc-cli', mcWorkerSupport());
147
+ await resolveMcWorker(ctx, selected, mission);
148
+ }
149
+ catch (error) {
150
+ return managedControlFailure(error);
151
+ }
152
+ }
153
+ const result = await mutateSession(selected.id, 'dispatch', mission.id, flags.expectedUpdatedAt, flags.requestId, session => {
154
+ if (session.state !== 'active')
155
+ return 'invalid_state';
156
+ if (session.missions.length >= session.maxMissions)
157
+ return 'capacity';
158
+ session.missions.push(mission);
159
+ return undefined;
160
+ });
161
+ if (!result.ok)
162
+ return mutationFailure(result);
163
+ if (!result.replayed) {
164
+ await appendLog(selected.id, {
165
+ event: 'mission_dispatched',
166
+ missionId: mission.id,
167
+ objective,
168
+ priority,
169
+ mode,
170
+ targetAgent,
171
+ requestId: flags.requestId ?? null,
172
+ lfdBudgets: {
173
+ maxTotalTokens,
174
+ maxOutputTokens,
175
+ maxToolCalls,
176
+ maxTotalCost,
177
+ maxWallClockMinutes,
178
+ explorationQuota,
179
+ },
180
+ });
181
+ }
182
+ if (capWarning)
183
+ ui.warn(capWarning);
184
+ ui.success(`${result.replayed ? 'Replayed dispatch for' : 'Dispatched mission'} ${mission.id}: ${objective}`);
185
+ const modeLabel = mode === 'pty-orchestrator' ? ` | Mode: PTY orchestrator → ${targetAgent}` : '';
186
+ ui.info(`Priority: ${priority} | Max iterations: ${maxIterations}${modeLabel}`);
187
+ const lfdLimits = [
188
+ maxTotalTokens ? `total tokens ${maxTotalTokens}` : null,
189
+ maxOutputTokens ? `output tokens ${maxOutputTokens}` : null,
190
+ maxToolCalls ? `tool calls ${maxToolCalls}` : null,
191
+ maxTotalCost ? `total cost $${maxTotalCost}` : null,
192
+ maxWallClockMinutes ? `wall clock ${maxWallClockMinutes}m` : null,
193
+ explorationQuota ? `exploration quota ${explorationQuota}` : null,
194
+ ].filter(Boolean);
195
+ if (lfdLimits.length > 0) {
196
+ ui.info(`LFD limits: ${lfdLimits.join(' | ')}`);
197
+ }
198
+ // #1439: dispatch alone does NOT execute the mission. Surface the next step
199
+ // so the user knows the queue won't drain on its own.
200
+ ui.info(`Next: run \`aiwg mc run ${selected.id}\` to launch queued missions as ralph loops.`);
201
+ return { exitCode: 0, message: mission.id };
202
+ }
203
+ //# sourceMappingURL=mc-dispatch.js.map