/** * Tests for multi-runtime selection in the interactive installer prompt. * Verifies that promptRuntime accepts comma-separated, space-separated, * and single-choice inputs, deduplicates, and falls back to claude. * See issue #1281. * * Per CONTRIBUTING.md "no-source-grep" testing standard, prompt + parser * behavior is asserted via the install module's exported pure functions * (`runtimeMap`, `allRuntimes`, `parseRuntimeInput`, `buildRuntimePromptText`) * instead of regexing bin/install.js source text. * * #1928: Google sunset Gemini CLI (2026-06-18) and the `gemini` runtime was * removed from GSD (Antigravity CLI is the successor). The runtime option * numbering below is renumbered accordingly — option 9 (formerly gemini) is * now hermes, and the "All" shortcut moved from 17 to 16. * * #1925: ZCode (Z.ai) added as option 16; the "All" shortcut moved from 16 to 17. * * #2102: pi added as option 13 (alphabetical slot between opencode and qwen) — * qwen/trae/windsurf/zcode each shift up one slot (14/15/16/17), and the "All" * shortcut moves from 17 to 18. */ process.env.GSD_TEST_MODE = '1'; const { test, describe } = require('node:test'); const assert = require('node:assert/strict'); const { runtimeMap, allRuntimes, selectRuntimesFromArgs, parseRuntimeInput, buildRuntimePromptText, } = require('../bin/install.js'); // Strip ANSI color codes for human-readable assertions on prompt text. function stripAnsi(s) { // eslint-disable-next-line no-control-regex return s.replace(/\x1b\[[0-9;]*m/g, ''); } describe('multi-runtime selection parsing', () => { test('single choice returns single runtime', () => { assert.deepStrictEqual(parseRuntimeInput('1'), ['claude']); assert.deepStrictEqual(parseRuntimeInput('2'), ['antigravity']); assert.deepStrictEqual(parseRuntimeInput('3'), ['augment']); assert.deepStrictEqual(parseRuntimeInput('4'), ['cline']); assert.deepStrictEqual(parseRuntimeInput('5'), ['codebuddy']); assert.deepStrictEqual(parseRuntimeInput('6'), ['codex']); assert.deepStrictEqual(parseRuntimeInput('7'), ['copilot']); assert.deepStrictEqual(parseRuntimeInput('8'), ['cursor']); }); test('comma-separated choices return multiple runtimes', () => { assert.deepStrictEqual(parseRuntimeInput('1,7,9'), ['claude', 'copilot', 'hermes']); assert.deepStrictEqual(parseRuntimeInput('2,3'), ['antigravity', 'augment']); assert.deepStrictEqual(parseRuntimeInput('3,6'), ['augment', 'codex']); }); test('space-separated choices return multiple runtimes', () => { assert.deepStrictEqual(parseRuntimeInput('1 7 9'), ['claude', 'copilot', 'hermes']); assert.deepStrictEqual(parseRuntimeInput('8 12'), ['cursor', 'kilo']); }); test('mixed comma and space separators work', () => { assert.deepStrictEqual(parseRuntimeInput('1, 7, 9'), ['claude', 'copilot', 'hermes']); assert.deepStrictEqual(parseRuntimeInput('2 , 8'), ['antigravity', 'cursor']); }); test('single choice for hermes', () => { assert.deepStrictEqual(parseRuntimeInput('9'), ['hermes']); }); test('single choice for kilo', () => { assert.deepStrictEqual(parseRuntimeInput('12'), ['kilo']); }); test('single choice for opencode', () => { assert.deepStrictEqual(parseRuntimeInput('13'), ['opencode']); }); test('single choice for pi', () => { assert.deepStrictEqual(parseRuntimeInput('14'), ['pi']); }); test('single choice for qwen', () => { assert.deepStrictEqual(parseRuntimeInput('15'), ['qwen']); }); test('single choice for trae', () => { assert.deepStrictEqual(parseRuntimeInput('16'), ['trae']); }); test('single choice for windsurf', () => { assert.deepStrictEqual(parseRuntimeInput('17'), ['windsurf']); }); test('single choice for zcode', () => { assert.deepStrictEqual(parseRuntimeInput('18'), ['zcode']); }); test('single choice for kimi', () => { assert.deepStrictEqual(parseRuntimeInput('10'), ['kimi']); }); test('single choice for kimi-code (#2454)', () => { assert.deepStrictEqual(parseRuntimeInput('11'), ['kimi-code']); }); test('choice 19 returns all runtimes', () => { assert.deepStrictEqual(parseRuntimeInput('19'), allRuntimes); }); test('choice 19 returns all runtimes when mixed with separators or other tokens', () => { // CR feedback: tokenized inputs that include 19 (e.g. trailing comma, or // alongside other choices) must still expand to all-runtimes — previously // only the bare all-runtimes option matched, so "19," or "19 1" silently installed a // subset. assert.deepStrictEqual(parseRuntimeInput('19,'), allRuntimes); assert.deepStrictEqual(parseRuntimeInput('19 1'), allRuntimes); assert.deepStrictEqual(parseRuntimeInput('1,19'), allRuntimes); assert.deepStrictEqual(parseRuntimeInput(' 19 '), allRuntimes); }); test('empty input defaults to claude', () => { assert.deepStrictEqual(parseRuntimeInput(''), ['claude']); assert.deepStrictEqual(parseRuntimeInput(' '), ['claude']); }); test('invalid choices are ignored, falls back to claude if all invalid', () => { assert.deepStrictEqual(parseRuntimeInput('20'), ['claude']); assert.deepStrictEqual(parseRuntimeInput('0'), ['claude']); assert.deepStrictEqual(parseRuntimeInput('abc'), ['claude']); }); test('invalid choices mixed with valid are filtered out', () => { assert.deepStrictEqual(parseRuntimeInput('1,20,7'), ['claude', 'copilot']); assert.deepStrictEqual(parseRuntimeInput('abc 3 xyz'), ['augment']); }); test('duplicate choices are deduplicated', () => { assert.deepStrictEqual(parseRuntimeInput('1,1,1'), ['claude']); assert.deepStrictEqual(parseRuntimeInput('7,7,9,9'), ['copilot', 'hermes']); }); test('preserves selection order', () => { assert.deepStrictEqual(parseRuntimeInput('9,1,7'), ['hermes', 'claude', 'copilot']); assert.deepStrictEqual(parseRuntimeInput('12,2,8'), ['kilo', 'antigravity', 'cursor']); }); }); describe('install.js exports multi-select runtime metadata', () => { const expectedRuntimeMap = { '1': 'claude', '2': 'antigravity', '3': 'augment', '4': 'cline', '5': 'codebuddy', '6': 'codex', '7': 'copilot', '8': 'cursor', '9': 'hermes', '10': 'kimi', '11': 'kimi-code', '12': 'kilo', '13': 'opencode', '14': 'pi', '15': 'qwen', '16': 'trae', '17': 'windsurf', '18': 'zcode', }; const expectedRuntimes = [ 'claude', 'antigravity', 'augment', 'cline', 'codebuddy', 'codex', 'copilot', 'cursor', 'hermes', 'kimi', 'kimi-code', 'kilo', 'opencode', 'pi', 'qwen', 'trae', 'windsurf', 'zcode', ]; test('runtimeMap exports every option key bound to the right runtime', () => { assert.deepStrictEqual(runtimeMap, expectedRuntimeMap, 'exported runtimeMap matches the canonical option list'); }); test('allRuntimes contains every runtime exactly once', () => { assert.strictEqual(allRuntimes.length, expectedRuntimes.length); for (const rt of expectedRuntimes) { assert.ok(allRuntimes.includes(rt), `allRuntimes contains ${rt}`); } assert.strictEqual(new Set(allRuntimes).size, allRuntimes.length, 'allRuntimes has no duplicates'); }); test('"All" shortcut (option 19) selects every runtime', () => { assert.deepStrictEqual(parseRuntimeInput('19'), allRuntimes); }); test('--kimi flag selects Kimi (Python kimi-cli) without interactive prompt', () => { assert.deepStrictEqual(selectRuntimesFromArgs(['--kimi']), ['kimi']); }); test('--kimi-code flag selects Kimi Code (Node CLI) without interactive prompt (#2454)', () => { assert.deepStrictEqual(selectRuntimesFromArgs(['--kimi-code']), ['kimi-code']); }); test('--zcode flag selects ZCode without interactive prompt', () => { assert.deepStrictEqual(selectRuntimesFromArgs(['--zcode']), ['zcode']); }); test('--pi flag selects pi without interactive prompt', () => { assert.deepStrictEqual(selectRuntimesFromArgs(['--pi']), ['pi']); }); test('--all flag includes Kimi exactly once', () => { const selected = selectRuntimesFromArgs(['--all']); assert.ok(selected.includes('kimi'), '--all includes kimi'); assert.strictEqual(selected.filter((runtime) => runtime === 'kimi').length, 1, '--all includes kimi exactly once'); }); test('--all flag includes ZCode exactly once', () => { const selected = selectRuntimesFromArgs(['--all']); assert.ok(selected.includes('zcode'), '--all includes zcode'); assert.strictEqual(selected.filter((runtime) => runtime === 'zcode').length, 1, '--all includes zcode exactly once'); }); test('--all flag includes pi exactly once', () => { const selected = selectRuntimesFromArgs(['--all']); assert.ok(selected.includes('pi'), '--all includes pi'); assert.strictEqual(selected.filter((runtime) => runtime === 'pi').length, 1, '--all includes pi exactly once'); }); test('prompt lists pi (14), ZCode (18), and All (19)', () => { const prompt = stripAnsi(buildRuntimePromptText()); assert.ok(/\b9\)\s*Hermes Agent\b/.test(prompt), 'prompt lists Hermes Agent as option 9'); assert.ok(/\b10\)\s*Kimi\b/.test(prompt), 'prompt lists Kimi as option 10'); assert.ok(/Kimi\s+\(~\/\.config\/agents, then ~\/\.agents if existing\)/.test(prompt), 'prompt shows the Kimi first-existing generic root policy'); assert.ok(/\b11\)\s*Kimi Code\b/.test(prompt), 'prompt lists Kimi Code as option 11 (#2454)'); assert.ok(/\b14\)\s*pi\b/.test(prompt), 'prompt lists pi as option 14'); assert.ok(/\b15\)\s*Qwen Code\b/.test(prompt), 'prompt lists Qwen Code as option 15'); assert.ok(/\b16\)\s*Trae\b/.test(prompt), 'prompt lists Trae as option 16'); assert.ok(/\b18\)\s*ZCode\b/.test(prompt), 'prompt lists ZCode as option 18'); assert.ok(/\b19\)\s*All\b/.test(prompt), 'prompt lists All as option 19'); }); test('prompt does not list Gemini (removed #1928)', () => { const prompt = stripAnsi(buildRuntimePromptText()); assert.ok(!/Gemini/.test(prompt), 'prompt must not mention Gemini'); }); test('prompt text shows multi-select hint', () => { const prompt = stripAnsi(buildRuntimePromptText()); assert.ok(/Select multiple/i.test(prompt), 'prompt includes multi-select instructions'); }); test('parser splits on commas and whitespace and deduplicates', () => { // Behavioral assertion: same set of choices in different separators // produces the same selection, and duplicates collapse. assert.deepStrictEqual( parseRuntimeInput('1,7,9'), parseRuntimeInput('1 7 9'), 'comma- and space-separated input yield identical selections' ); assert.deepStrictEqual(parseRuntimeInput('1,1,7,7'), ['claude', 'copilot'], 'duplicates collapsed in order'); }); });