@memnexus-ai/mx-agent-cli 0.1.230 → 0.1.231
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.
- package/dist/__tests__/doctor.test.d.ts +20 -0
- package/dist/__tests__/doctor.test.d.ts.map +1 -0
- package/dist/__tests__/doctor.test.js +849 -0
- package/dist/__tests__/doctor.test.js.map +1 -0
- package/dist/__tests__/fleet-data.test.d.ts +2 -0
- package/dist/__tests__/fleet-data.test.d.ts.map +1 -0
- package/dist/__tests__/fleet-data.test.js +340 -0
- package/dist/__tests__/fleet-data.test.js.map +1 -0
- package/dist/__tests__/fleet-tmux.test.d.ts +2 -0
- package/dist/__tests__/fleet-tmux.test.d.ts.map +1 -0
- package/dist/__tests__/fleet-tmux.test.js +242 -0
- package/dist/__tests__/fleet-tmux.test.js.map +1 -0
- package/dist/__tests__/worker-cap.test.d.ts +14 -0
- package/dist/__tests__/worker-cap.test.d.ts.map +1 -0
- package/dist/__tests__/worker-cap.test.js +97 -0
- package/dist/__tests__/worker-cap.test.js.map +1 -0
- package/dist/agent-config/agents/implementation-engineer.md +8 -0
- package/dist/agent-config/agents/qa-tester.md +13 -5
- package/dist/agent-config/skills/mx-pre-pr-check/SKILL.md +4 -0
- package/dist/commands/doctor.d.ts +203 -0
- package/dist/commands/doctor.d.ts.map +1 -0
- package/dist/commands/doctor.js +688 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/fleet-tmux.d.ts +68 -0
- package/dist/commands/fleet-tmux.d.ts.map +1 -0
- package/dist/commands/fleet-tmux.js +288 -0
- package/dist/commands/fleet-tmux.js.map +1 -0
- package/dist/commands/start.d.ts.map +1 -1
- package/dist/commands/start.js +36 -0
- package/dist/commands/start.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +87 -0
- package/dist/index.js.map +1 -1
- package/dist/lib/fleet-data.d.ts +181 -0
- package/dist/lib/fleet-data.d.ts.map +1 -0
- package/dist/lib/fleet-data.js +375 -0
- package/dist/lib/fleet-data.js.map +1 -0
- package/dist/lib/fleet-render.d.ts +66 -0
- package/dist/lib/fleet-render.d.ts.map +1 -0
- package/dist/lib/fleet-render.js +184 -0
- package/dist/lib/fleet-render.js.map +1 -0
- package/dist/lib/tmux.d.ts +69 -0
- package/dist/lib/tmux.d.ts.map +1 -0
- package/dist/lib/tmux.js +115 -0
- package/dist/lib/tmux.js.map +1 -0
- package/dist/lib/vm-health.d.ts +562 -0
- package/dist/lib/vm-health.d.ts.map +1 -0
- package/dist/lib/vm-health.js +960 -0
- package/dist/lib/vm-health.js.map +1 -0
- 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
|
-
|
|
89
|
+
Start with the tests for the changed area, not the whole suite:
|
|
90
90
|
|
|
91
91
|
```bash
|
|
92
|
-
#
|
|
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
|
|
|
@@ -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
|