@memnexus-ai/mx-agent-cli 0.1.230 → 0.1.232

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 (52) hide show
  1. package/dist/__tests__/doctor.test.d.ts +20 -0
  2. package/dist/__tests__/doctor.test.d.ts.map +1 -0
  3. package/dist/__tests__/doctor.test.js +849 -0
  4. package/dist/__tests__/doctor.test.js.map +1 -0
  5. package/dist/__tests__/fleet-data.test.d.ts +2 -0
  6. package/dist/__tests__/fleet-data.test.d.ts.map +1 -0
  7. package/dist/__tests__/fleet-data.test.js +340 -0
  8. package/dist/__tests__/fleet-data.test.js.map +1 -0
  9. package/dist/__tests__/fleet-tmux.test.d.ts +2 -0
  10. package/dist/__tests__/fleet-tmux.test.d.ts.map +1 -0
  11. package/dist/__tests__/fleet-tmux.test.js +242 -0
  12. package/dist/__tests__/fleet-tmux.test.js.map +1 -0
  13. package/dist/__tests__/worker-cap.test.d.ts +14 -0
  14. package/dist/__tests__/worker-cap.test.d.ts.map +1 -0
  15. package/dist/__tests__/worker-cap.test.js +97 -0
  16. package/dist/__tests__/worker-cap.test.js.map +1 -0
  17. package/dist/agent-config/agents/implementation-engineer.md +8 -0
  18. package/dist/agent-config/agents/qa-tester.md +13 -5
  19. package/dist/agent-config/shared/eval-tiered-rigor.md +4 -2
  20. package/dist/agent-config/skills/mx-pre-pr-check/SKILL.md +4 -0
  21. package/dist/commands/doctor.d.ts +203 -0
  22. package/dist/commands/doctor.d.ts.map +1 -0
  23. package/dist/commands/doctor.js +688 -0
  24. package/dist/commands/doctor.js.map +1 -0
  25. package/dist/commands/fleet-tmux.d.ts +68 -0
  26. package/dist/commands/fleet-tmux.d.ts.map +1 -0
  27. package/dist/commands/fleet-tmux.js +288 -0
  28. package/dist/commands/fleet-tmux.js.map +1 -0
  29. package/dist/commands/start.d.ts.map +1 -1
  30. package/dist/commands/start.js +36 -0
  31. package/dist/commands/start.js.map +1 -1
  32. package/dist/index.d.ts +1 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +87 -0
  35. package/dist/index.js.map +1 -1
  36. package/dist/lib/fleet-data.d.ts +181 -0
  37. package/dist/lib/fleet-data.d.ts.map +1 -0
  38. package/dist/lib/fleet-data.js +375 -0
  39. package/dist/lib/fleet-data.js.map +1 -0
  40. package/dist/lib/fleet-render.d.ts +66 -0
  41. package/dist/lib/fleet-render.d.ts.map +1 -0
  42. package/dist/lib/fleet-render.js +184 -0
  43. package/dist/lib/fleet-render.js.map +1 -0
  44. package/dist/lib/tmux.d.ts +69 -0
  45. package/dist/lib/tmux.d.ts.map +1 -0
  46. package/dist/lib/tmux.js +115 -0
  47. package/dist/lib/tmux.js.map +1 -0
  48. package/dist/lib/vm-health.d.ts +562 -0
  49. package/dist/lib/vm-health.d.ts.map +1 -0
  50. package/dist/lib/vm-health.js +960 -0
  51. package/dist/lib/vm-health.js.map +1 -0
  52. package/package.json +1 -1
@@ -0,0 +1,242 @@
1
+ /**
2
+ * #4489 — the tmux fleet surface. Covers the pure parts (leader-state parsing,
3
+ * reconciliation planning, status-line building, attention cycling, cost
4
+ * aggregation) and, when a real tmux binary is present, one integration test on
5
+ * a private socket.
6
+ */
7
+ import { describe, it, expect, afterEach } from 'vitest';
8
+ import { join } from 'path';
9
+ import { homedir } from 'os';
10
+ import { spawnSync } from 'child_process';
11
+ import { fleetSessionName, planWindowReconciliation, teamStartCommand, isTmuxAvailable, listWindows, hasSession, OVERVIEW_WINDOW_NAME, } from '../lib/tmux.js';
12
+ import { buildStatusLine, nextAttentionWindow, renderMetaFrame, rowsFromSnapshot, sortRowsByAttention, } from '../lib/fleet-render.js';
13
+ // ── Helpers ──────────────────────────────────────────────────────────────────
14
+ function row(partial) {
15
+ return {
16
+ windowState: 'idle',
17
+ status: 'ok',
18
+ costToday: 0,
19
+ unpricedModel: false,
20
+ ...partial,
21
+ };
22
+ }
23
+ /** A TmuxExec that records calls and replays canned results. */
24
+ function recorder(results = {}) {
25
+ const calls = [];
26
+ const exec = ((args) => {
27
+ calls.push(args);
28
+ const key = args[0];
29
+ const canned = results[key] ?? {};
30
+ return { status: 0, stdout: '', stderr: '', failed: false, ...canned };
31
+ });
32
+ exec.calls = calls;
33
+ return exec;
34
+ }
35
+ // ── Sorting and status line ──────────────────────────────────────────────────
36
+ describe('attention ordering and status line', () => {
37
+ const rows = [
38
+ row({ team: 'alpha', status: 'ok' }),
39
+ row({ team: 'bravo', status: 'needs-human' }),
40
+ row({ team: 'charlie', status: 'unknown' }),
41
+ row({ team: 'delta', status: 'blocked' }),
42
+ ];
43
+ it('floats blocked then needs-human to the top', () => {
44
+ expect(sortRowsByAttention(rows).map((r) => r.team)).toEqual(['delta', 'bravo', 'charlie', 'alpha']);
45
+ });
46
+ it('builds a compact strip with one marker per team', () => {
47
+ const line = buildStatusLine(rows, { color: false });
48
+ expect(line).toBe('delta:⚠ bravo:⚠ charlie:? alpha:●');
49
+ });
50
+ it('marks teams with no window as ○ regardless of async status', () => {
51
+ const line = buildStatusLine([row({ team: 'alpha', status: 'ok', windowState: 'none' })], { color: false });
52
+ expect(line).toBe('alpha:○');
53
+ });
54
+ it('is empty for an empty fleet, never throws', () => {
55
+ expect(buildStatusLine([], { color: false })).toBe('');
56
+ });
57
+ });
58
+ // ── Reconciliation planner ───────────────────────────────────────────────────
59
+ describe('planWindowReconciliation', () => {
60
+ const existing = [
61
+ { index: 0, name: OVERVIEW_WINDOW_NAME },
62
+ { index: 1, name: 'retrieval' },
63
+ { index: 2, name: 'platform' },
64
+ ];
65
+ it('creates only the missing windows', () => {
66
+ const plan = planWindowReconciliation(existing, ['retrieval', 'eval']);
67
+ expect(plan.create).toEqual(['eval']);
68
+ expect(plan.keep).toEqual([{ team: 'retrieval', index: 1 }]);
69
+ });
70
+ it('never plans to remove anything — unrequested windows are reported only', () => {
71
+ const plan = planWindowReconciliation(existing, ['retrieval']);
72
+ expect(plan.foreign.map((w) => w.name)).toEqual(['platform']);
73
+ expect(Object.keys(plan)).toEqual(['create', 'keep', 'foreign']);
74
+ });
75
+ it('creates every window for a fresh session', () => {
76
+ const plan = planWindowReconciliation([], ['a', 'b']);
77
+ expect(plan.create).toEqual(['a', 'b']);
78
+ expect(plan.keep).toEqual([]);
79
+ });
80
+ it('ignores the overview window when reporting foreign windows', () => {
81
+ const plan = planWindowReconciliation(existing, ['retrieval', 'platform']);
82
+ expect(plan.foreign).toEqual([]);
83
+ });
84
+ });
85
+ describe('session naming', () => {
86
+ it('namespaces by project slug when one is configured', () => {
87
+ expect(fleetSessionName()).toBe('mx-fleet');
88
+ expect(fleetSessionName('')).toBe('mx-fleet');
89
+ expect(fleetSessionName('mail-client')).toBe('mx-fleet-mail-client');
90
+ });
91
+ it('types a plain start command with no shell metacharacters', () => {
92
+ expect(teamStartCommand('retrieval')).toBe('mx-agent start retrieval');
93
+ });
94
+ });
95
+ // ── tmux wrapper behaviour ───────────────────────────────────────────────────
96
+ describe('tmux wrapper', () => {
97
+ it('reports tmux missing rather than throwing', () => {
98
+ const exec = recorder({ '-V': { status: -1, failed: true, stderr: 'ENOENT' } });
99
+ expect(isTmuxAvailable(exec)).toBe(false);
100
+ });
101
+ it('parses list-windows output into windows', () => {
102
+ const exec = recorder({ 'list-windows': { stdout: '0\toverview\tbash\n1\tretrieval\tnode\n' } });
103
+ expect(listWindows('mx-fleet', exec)).toEqual([
104
+ { index: 0, name: 'overview', paneCommand: 'bash' },
105
+ { index: 1, name: 'retrieval', paneCommand: 'node' },
106
+ ]);
107
+ });
108
+ it('returns [] when tmux fails, and false for a missing session', () => {
109
+ const failing = recorder({ 'list-windows': { status: 1, failed: true }, 'has-session': { status: 1 } });
110
+ expect(listWindows('mx-fleet', failing)).toEqual([]);
111
+ expect(hasSession('mx-fleet', failing)).toBe(false);
112
+ });
113
+ it('targets sessions with the exact-match "=" prefix', () => {
114
+ const exec = recorder();
115
+ hasSession('mx-fleet', exec);
116
+ expect(exec.calls[0]).toEqual(['has-session', '-t', '=mx-fleet']);
117
+ });
118
+ });
119
+ // ── Attention cycling ────────────────────────────────────────────────────────
120
+ describe('nextAttentionWindow', () => {
121
+ const state = {
122
+ session: 'mx-fleet',
123
+ updatedAt: '',
124
+ teams: [
125
+ { team: 'a', windowIndex: 1, attention: false },
126
+ { team: 'b', windowIndex: 2, attention: true },
127
+ { team: 'c', windowIndex: 4, attention: true },
128
+ ],
129
+ };
130
+ it('cycles forward through flagged windows and wraps', () => {
131
+ expect(nextAttentionWindow(state, 0)).toBe(2);
132
+ expect(nextAttentionWindow(state, 2)).toBe(4);
133
+ expect(nextAttentionWindow(state, 4)).toBe(2);
134
+ });
135
+ it('returns null when nothing needs attention or state is missing', () => {
136
+ expect(nextAttentionWindow({ ...state, teams: [{ team: 'a', windowIndex: 1, attention: false }] }, 0)).toBeNull();
137
+ expect(nextAttentionWindow(null, 0)).toBeNull();
138
+ });
139
+ it('skips flagged teams that have no window', () => {
140
+ const noWindow = { ...state, teams: [{ team: 'b', windowIndex: null, attention: true }] };
141
+ expect(nextAttentionWindow(noWindow, 0)).toBeNull();
142
+ });
143
+ });
144
+ // ── Meta frame rendering ─────────────────────────────────────────────────────
145
+ describe('renderMetaFrame', () => {
146
+ const rows = [
147
+ row({ team: 'alpha', status: 'ok', costToday: 1.5, windowState: 'running', windowIndex: 1 }),
148
+ row({ team: 'bravo', status: 'needs-human', decision: 'approve rollout', costToday: null }),
149
+ ];
150
+ it('renders attention rows first with their decision line', () => {
151
+ const frame = renderMetaFrame(rows, [], { now: new Date('2026-07-24T09:30:00Z'), width: 80 });
152
+ const plain = frame.replace(/\x1b\[[0-9;]*m/g, '');
153
+ expect(plain.indexOf('bravo')).toBeLessThan(plain.indexOf('alpha'));
154
+ expect(plain).toContain('approve rollout');
155
+ expect(plain).toContain('09:30Z');
156
+ });
157
+ it('shows "?" for a cost that could not be read and ≈ for unpriced models', () => {
158
+ const plain = renderMetaFrame([row({ team: 'a', costToday: null }), row({ team: 'b', costToday: 2, unpricedModel: true })], [], { width: 80 }).replace(/\x1b\[[0-9;]*m/g, '');
159
+ expect(plain).toMatch(/\?/);
160
+ expect(plain).toContain('≈$2.00');
161
+ });
162
+ it('renders coordination metadata only — never a message body', () => {
163
+ const plain = renderMetaFrame(rows, [
164
+ { id: '1784811171332-0', from: 'eval', to: 'platform', priority: 'p1', timestamp: '2026-07-24T09:00:00Z' },
165
+ ], { width: 100 }).replace(/\x1b\[[0-9;]*m/g, '');
166
+ expect(plain).toContain('1784811171332-0');
167
+ expect(plain).toContain('eval');
168
+ expect(plain).toContain('P1');
169
+ });
170
+ it('renders an unavailable coordination source as "?" and survives an empty fleet', () => {
171
+ const plain = renderMetaFrame([], null, { width: 60 }).replace(/\x1b\[[0-9;]*m/g, '');
172
+ expect(plain).toContain('? (unavailable)');
173
+ expect(plain).toContain('no teams with worktrees');
174
+ });
175
+ });
176
+ // ── Integration (only when a real tmux exists) ───────────────────────────────
177
+ const tmuxProbe = spawnSync('tmux', ['-V'], { stdio: 'pipe', encoding: 'utf-8' });
178
+ const HAVE_TMUX = !tmuxProbe.error && tmuxProbe.status === 0;
179
+ describe.skipIf(!HAVE_TMUX)('tmux integration (private socket)', () => {
180
+ const socket = `mx-fleet-test-${process.pid}`;
181
+ const session = 'mx-fleet-itest';
182
+ const t = (args) => {
183
+ const r = spawnSync('tmux', ['-L', socket, ...args], { stdio: 'pipe', encoding: 'utf-8', timeout: 5000 });
184
+ return { status: r.status ?? -1, stdout: r.stdout ?? '', stderr: r.stderr ?? '', failed: !!r.error };
185
+ };
186
+ const exec = (args) => t(args);
187
+ afterEach(() => {
188
+ t(['kill-server']);
189
+ });
190
+ it('creates a session with the expected windows and tears it down', () => {
191
+ t(['new-session', '-d', '-s', session, '-n', OVERVIEW_WINDOW_NAME]);
192
+ expect(hasSession(session, exec)).toBe(true);
193
+ const plan = planWindowReconciliation(listWindows(session, exec), ['alpha', 'bravo']);
194
+ expect(plan.create).toEqual(['alpha', 'bravo']);
195
+ for (const team of plan.create) {
196
+ t(['new-window', '-d', '-t', `=${session}`, '-n', team]);
197
+ t(['send-keys', '-t', `=${session}:${team}`, '--', teamStartCommand(team)]);
198
+ }
199
+ const windows = listWindows(session, exec).map((w) => w.name).sort();
200
+ expect(windows).toEqual([OVERVIEW_WINDOW_NAME, 'alpha', 'bravo'].sort());
201
+ // Re-running is additive: nothing new to create, nothing removed.
202
+ const second = planWindowReconciliation(listWindows(session, exec), ['alpha', 'bravo']);
203
+ expect(second.create).toEqual([]);
204
+ expect(second.keep.map((k) => k.team).sort()).toEqual(['alpha', 'bravo']);
205
+ t(['kill-session', '-t', `=${session}`]);
206
+ expect(hasSession(session, exec)).toBe(false);
207
+ });
208
+ });
209
+ // Keep homedir import meaningful for readers: the state file lives under it.
210
+ describe('fleet state file location', () => {
211
+ it('lives under the user home, namespaced by session', async () => {
212
+ const { fleetStatePath } = await import('../lib/fleet-render.js');
213
+ expect(fleetStatePath('mx-fleet')).toBe(join(homedir(), '.mx-agent', 'fleet-mx-fleet.json'));
214
+ });
215
+ });
216
+ describe('rowsFromSnapshot', () => {
217
+ const snapshot = {
218
+ takenAt: '2026-07-24T09:00:00.000Z',
219
+ session: { projectRoot: '/p', projectSlug: '' },
220
+ teams: [
221
+ {
222
+ team: 'alpha', displayName: 'Alpha', worktreePath: '/p/.worktrees/alpha', hasWorktree: true,
223
+ leader: { status: 'needs-human', decision: 'approve rollout', iteration: 'v1 — x', source: 'memnexus-alpha-leader-state' },
224
+ cost: { today: 3.5, unpricedModel: true, models: ['claude-fable-5'] },
225
+ liveness: 'live', lockAgeSeconds: 12, errors: {},
226
+ },
227
+ ],
228
+ coordination: [],
229
+ errors: {},
230
+ };
231
+ it('projects snapshot fields onto renderer rows', () => {
232
+ const [row] = rowsFromSnapshot(snapshot, new Map([['alpha', 3]]));
233
+ expect(row).toMatchObject({
234
+ team: 'alpha', windowIndex: 3, status: 'needs-human',
235
+ decision: 'approve rollout', costToday: 3.5, unpricedModel: true,
236
+ });
237
+ });
238
+ it('falls back to liveness when tmux window state is unknown', () => {
239
+ expect(rowsFromSnapshot(snapshot)[0].windowState).toBe('running');
240
+ });
241
+ });
242
+ //# sourceMappingURL=fleet-tmux.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fleet-tmux.test.js","sourceRoot":"","sources":["../../src/__tests__/fleet-tmux.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Unit tests for testing-tools/worker-cap.cjs (#4498).
3
+ *
4
+ * The worker cap exists because concurrent full-suite runs contributed to the
5
+ * 2026-07-24 VM out-of-memory incident. Security review found it could be
6
+ * silently defeated by an unvalidated environment variable, and that Jest and
7
+ * Vitest disagreed about how. These tests pin the parsing and clamping so a
8
+ * future edit cannot quietly reopen that.
9
+ *
10
+ * The helper is CommonJS so both runner families can consume it; loaded here via
11
+ * createRequire for the same reason a Vitest config would.
12
+ */
13
+ export {};
14
+ //# sourceMappingURL=worker-cap.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-cap.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worker-cap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Unit tests for testing-tools/worker-cap.cjs (#4498).
3
+ *
4
+ * The worker cap exists because concurrent full-suite runs contributed to the
5
+ * 2026-07-24 VM out-of-memory incident. Security review found it could be
6
+ * silently defeated by an unvalidated environment variable, and that Jest and
7
+ * Vitest disagreed about how. These tests pin the parsing and clamping so a
8
+ * future edit cannot quietly reopen that.
9
+ *
10
+ * The helper is CommonJS so both runner families can consume it; loaded here via
11
+ * createRequire for the same reason a Vitest config would.
12
+ */
13
+ import { describe, it, expect } from 'vitest';
14
+ import { createRequire } from 'node:module';
15
+ import { join } from 'node:path';
16
+ const require = createRequire(import.meta.url);
17
+ const workerCap = require(join(import.meta.dirname, '..', '..', '..', '..', 'testing-tools', 'worker-cap.cjs'));
18
+ const { resolveMaxWorkers, parseOverride, DEFAULT_LOCAL_WORKERS } = workerCap;
19
+ describe('parseOverride', () => {
20
+ it('accepts a plain positive integer', () => {
21
+ expect(parseOverride('4')).toBe(4);
22
+ expect(parseOverride(' 8 ')).toBe(8);
23
+ expect(parseOverride('1')).toBe(1);
24
+ });
25
+ it('rejects "0" — the exact value that defeated the Jest form', () => {
26
+ // `JEST_MAX_WORKERS=0` is the truthy string "0", so the old Jest expression
27
+ // passed it straight through, while the Vitest form silently ignored it.
28
+ expect(parseOverride('0')).toBeNull();
29
+ });
30
+ it('rejects empty and whitespace-only values', () => {
31
+ expect(parseOverride('')).toBeNull();
32
+ expect(parseOverride(' ')).toBeNull();
33
+ });
34
+ it('rejects non-numeric junk', () => {
35
+ expect(parseOverride('abc')).toBeNull();
36
+ expect(parseOverride('4 workers')).toBeNull();
37
+ expect(parseOverride('75%')).toBeNull();
38
+ });
39
+ it('rejects negatives, fractions and exponent notation', () => {
40
+ expect(parseOverride('-1')).toBeNull();
41
+ expect(parseOverride('1.5')).toBeNull();
42
+ expect(parseOverride('1e3')).toBeNull();
43
+ });
44
+ it('rejects non-strings, including undefined for an unset variable', () => {
45
+ expect(parseOverride(undefined)).toBeNull();
46
+ expect(parseOverride(null)).toBeNull();
47
+ expect(parseOverride(4)).toBeNull();
48
+ });
49
+ });
50
+ describe('resolveMaxWorkers', () => {
51
+ it('defaults to 4 locally when nothing is set', () => {
52
+ expect(resolveMaxWorkers({ env: {}, isCI: false, cpus: 20 })).toBe(DEFAULT_LOCAL_WORKERS);
53
+ });
54
+ it('takes three quarters of the machine in CI, as an integer', () => {
55
+ expect(resolveMaxWorkers({ env: {}, isCI: true, cpus: 20 })).toBe(15);
56
+ expect(resolveMaxWorkers({ env: {}, isCI: true, cpus: 3 })).toBe(2);
57
+ });
58
+ it('never returns less than 1, even on a single-CPU machine in CI', () => {
59
+ expect(resolveMaxWorkers({ env: {}, isCI: true, cpus: 1 })).toBe(1);
60
+ });
61
+ it('honours a valid override', () => {
62
+ expect(resolveMaxWorkers({ env: { MX_TEST_MAX_WORKERS: '2' }, isCI: false, cpus: 20 })).toBe(2);
63
+ expect(resolveMaxWorkers({ env: { VITEST_MAX_WORKERS: '6' }, isCI: false, cpus: 20 })).toBe(6);
64
+ expect(resolveMaxWorkers({ env: { JEST_MAX_WORKERS: '3' }, isCI: false, cpus: 20 })).toBe(3);
65
+ });
66
+ it('clamps an over-large override to the machine — the exhaustion the cap prevents', () => {
67
+ expect(resolveMaxWorkers({ env: { MX_TEST_MAX_WORKERS: '500' }, isCI: false, cpus: 20 })).toBe(20);
68
+ });
69
+ it('falls back to the default for every invalid override, in BOTH runner variables', () => {
70
+ for (const bad of ['0', '', ' ', 'abc', '-1', '1.5', '75%']) {
71
+ expect(resolveMaxWorkers({ env: { JEST_MAX_WORKERS: bad }, isCI: false, cpus: 20 }), `JEST_MAX_WORKERS=${JSON.stringify(bad)}`).toBe(DEFAULT_LOCAL_WORKERS);
72
+ expect(resolveMaxWorkers({ env: { VITEST_MAX_WORKERS: bad }, isCI: false, cpus: 20 }), `VITEST_MAX_WORKERS=${JSON.stringify(bad)}`).toBe(DEFAULT_LOCAL_WORKERS);
73
+ }
74
+ });
75
+ it('gives Jest and Vitest the SAME answer for the same input — the divergence QA found', () => {
76
+ for (const value of ['0', '', 'abc', '-1', '2', '500']) {
77
+ expect(resolveMaxWorkers({ env: { JEST_MAX_WORKERS: value }, isCI: false, cpus: 20 }), `both runners must agree for ${JSON.stringify(value)}`).toBe(resolveMaxWorkers({ env: { VITEST_MAX_WORKERS: value }, isCI: false, cpus: 20 }));
78
+ }
79
+ });
80
+ it('prefers the runner-agnostic variable when more than one is set', () => {
81
+ const env = { MX_TEST_MAX_WORKERS: '2', VITEST_MAX_WORKERS: '9', JEST_MAX_WORKERS: '9' };
82
+ expect(resolveMaxWorkers({ env, isCI: false, cpus: 20 })).toBe(2);
83
+ });
84
+ it('ignores an invalid higher-priority variable and uses the next valid one', () => {
85
+ const env = { MX_TEST_MAX_WORKERS: 'abc', VITEST_MAX_WORKERS: '6' };
86
+ expect(resolveMaxWorkers({ env, isCI: false, cpus: 20 })).toBe(6);
87
+ });
88
+ it('always returns a usable integer for arbitrary junk', () => {
89
+ for (const bad of ['0', '-5', 'NaN', 'Infinity', '1e400', '\x00']) {
90
+ const n = resolveMaxWorkers({ env: { MX_TEST_MAX_WORKERS: bad }, isCI: false, cpus: 20 });
91
+ expect(Number.isInteger(n)).toBe(true);
92
+ expect(n).toBeGreaterThanOrEqual(1);
93
+ expect(n).toBeLessThanOrEqual(20);
94
+ }
95
+ });
96
+ });
97
+ //# sourceMappingURL=worker-cap.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-cap.test.js","sourceRoot":"","sources":["../../src/__tests__/worker-cap.test.ts"],"names":[],"mappings":"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"}
@@ -338,6 +338,14 @@ npm run lint # Must: no errors
338
338
  npm run typecheck # Must: no errors
339
339
  ```
340
340
 
341
+ **Test-run policy.** Run targeted test files during an iteration; run the full suite
342
+ once before the PR. Repeated full-suite runs by several agents at once are memory-heavy
343
+ and were a contributing cause of the 2026-07-24 VM out-of-memory incident, which froze
344
+ the product owner's editor for two days. If you need the full suite mid-iteration,
345
+ check first that the machine can take it: `mx-agent doctor`.
346
+ Worker counts are capped in every test config; conventions and overrides are in
347
+ mx-agent-system/docs/testing-conventions.md.
348
+
341
349
  If a command doesn't exist yet (e.g., the PRD references a test file you're creating),
342
350
  create it as part of the implementation.
343
351
 
@@ -86,16 +86,24 @@ Before writing or running any test, understand what correct behavior looks like:
86
86
 
87
87
  ### 2. Run Existing Tests
88
88
 
89
- Before doing anything else, run the existing test suite:
89
+ Start with the tests for the changed area, not the whole suite:
90
90
 
91
91
  ```bash
92
- # Run the full suite
93
- npm test # or the project's test command
94
-
95
- # Run tests specific to the changed area
92
+ # Tests specific to the changed area — this is your default
96
93
  npm test -- --grep "[feature]"
94
+
95
+ # Full suite — once, before the PR, not on every iteration
96
+ npm test # or the project's test command
97
97
  ```
98
98
 
99
+ **Test-run policy.** Run targeted test files during an iteration; run the full suite
100
+ once before the PR. Repeated full-suite runs by several agents at once are memory-heavy
101
+ and were a contributing cause of the 2026-07-24 VM out-of-memory incident, which froze
102
+ the product owner's editor for two days. If you need the full suite mid-iteration,
103
+ check first that the machine can take it: `mx-agent doctor`.
104
+ Worker counts are capped in every test config; conventions and overrides are in
105
+ mx-agent-system/docs/testing-conventions.md.
106
+
99
107
  If existing tests fail *before* your changes, that's a pre-existing issue. Note it but
100
108
  don't fix it in this scope.
101
109
 
@@ -2,10 +2,12 @@
2
2
 
3
3
  Reference for all teams requesting or consuming eval measurements. Gate intensity scales with **instrument novelty**, not run size.
4
4
 
5
+ > Updated 2026-07-26: the pre-launch gate (formerly the Bar Raiser Step-6 sign-off) is owned by the independent eval-acceptance-reviewer, which holds the scored-run launch verdict and the final evidence verdict per `mx-agent-system/roleguides/eval-leader-v3.md`. "Acceptance-reviewer launch verdict" below replaces the old "Step-6" gate; Bar Raiser + Red Team plan review is unchanged.
6
+
5
7
  | Tier | When | Gates | Turnaround | Claims |
6
8
  |---|---|---|---|---|
7
- | A | New mechanism/instrument, or claim-grade result | Full: prereg + Bar Raiser + Red Team + mutation-tested Code Review + pre-launch Step-6 | Days | Claim-ledger grade |
8
- | B | Repeat run on a validated harness (model/corpus/config pin swap) | Preflight + runtime canaries + single-reviewer checklist + Step-6 | ~1 day | Claim-ledger grade with Tier-B tag |
9
+ | A | New mechanism/instrument, or claim-grade result | Full: prereg + Bar Raiser + Red Team + mutation-tested Code Review + pre-launch acceptance-reviewer launch verdict | Days | Claim-ledger grade |
10
+ | B | Repeat run on a validated harness (model/corpus/config pin swap) | Preflight + runtime canaries + single-reviewer checklist + acceptance-reviewer launch verdict | ~1 day | Claim-ledger grade with Tier-B tag |
9
11
  | C | Exploratory / diagnostic | Leader judgment + runtime canaries | Hours | NON-CLAIMABLE by construction |
10
12
 
11
13
  Non-negotiable at every tier: the runtime guards (preflight checks, delivery/injection canaries, completeness gates, hard flag/pin checks). They are minutes-cheap and exist because each one's absence once produced a wrong number.
@@ -53,6 +53,10 @@ npm run validate:openapi:local
53
53
 
54
54
  All checks must pass locally before creating the PR. Fix any failures.
55
55
 
56
+ This is the point in the loop where the full test suite runs — once. During the
57
+ iteration itself, run targeted test files only; repeated full-suite runs across several
58
+ agents at once were a contributing cause of the 2026-07-24 VM out-of-memory incident.
59
+
56
60
  ## Step 5: Review Commit History
57
61
 
58
62
  ```bash