/** * Unit tests for Stop command module (ccw stop) * * Notes: * - Targets the runtime implementation shipped in `ccw/dist`. * - Uses Node's built-in test runner (node:test). * - Mocks fetch and child_process.exec to avoid real netstat/taskkill. */ import { after, afterEach, before, describe, it, mock } from 'node:test'; import assert from 'node:assert/strict'; import { createRequire } from 'node:module'; const stopCommandPath = new URL('../dist/commands/stop.js', import.meta.url).href; describe('stop command module', async () => { // eslint-disable-next-line @typescript-eslint/no-explicit-any let stopModule: any; const require = createRequire(import.meta.url); const childProcess = require('child_process'); const originalExec = childProcess.exec; const execCalls: string[] = []; const netstatByPort = new Map(); const commandLineByPid = new Map(); before(async () => { // Patch child_process.exec BEFORE importing stop module (it captures exec at module init). childProcess.exec = (command: string, cb: any) => { execCalls.push(command); if (/^netstat -ano/i.test(command)) { const portMatch = command.match(/findstr\s+:([0-9]+)/i); const port = portMatch ? Number(portMatch[1]) : NaN; const stdout = Number.isFinite(port) ? (netstatByPort.get(port) ?? '') : ''; cb(null, stdout, ''); return {} as any; } if (/taskkill\b/i.test(command)) { cb(null, '', ''); return {} as any; } if (/^powershell\b/i.test(command) && /Get-CimInstance\s+Win32_Process/i.test(command)) { const pidMatch = command.match(/ProcessId=([0-9]+)/i); const pid = pidMatch ? pidMatch[1] : ''; const stdout = commandLineByPid.get(pid) ?? ''; cb(null, stdout, ''); return {} as any; } if (/^ps\s+-p\s+/i.test(command)) { const pidMatch = command.match(/^ps\s+-p\s+([0-9]+)/i); const pid = pidMatch ? pidMatch[1] : ''; const stdout = commandLineByPid.get(pid) ?? ''; cb(null, stdout, ''); return {} as any; } if (/^powershell\b/i.test(command) && /Stop-Process\s+-Id/i.test(command)) { cb(null, '', ''); return {} as any; } if (/^kill\s+-/i.test(command)) { cb(null, '', ''); return {} as any; } cb(new Error(`Unexpected exec: ${command}`), '', ''); return {} as any; }; stopModule = await import(stopCommandPath); }); afterEach(() => { execCalls.length = 0; netstatByPort.clear(); commandLineByPid.clear(); mock.restoreAll(); }); after(() => { childProcess.exec = originalExec; }); it('gracefully stops when CCW server responds to health check', async () => { mock.method(console, 'log', () => {}); mock.method(console, 'error', () => {}); const exitCodes: Array = []; mock.method(process as any, 'exit', (code?: number) => { exitCodes.push(code); }); mock.method(globalThis as any, 'fetch', async (url: string, init?: any) => { if (url.includes('/api/health')) { return { ok: true }; } if (url.includes('/api/shutdown')) { return { ok: true }; } throw new Error(`Unexpected fetch: ${url} ${JSON.stringify(init)}`); }); await stopModule.stopCommand({ port: 56792 }); assert.ok(exitCodes.includes(0)); assert.ok(!exitCodes.includes(1)); }); it('force-kills process when port is in use and --force is set (mocked)', async () => { mock.method(console, 'log', () => {}); mock.method(console, 'error', () => {}); const exitCodes: Array = []; mock.method(process as any, 'exit', (code?: number) => { exitCodes.push(code); }); // No server responding, fall back to netstat/taskkill mock.method(globalThis as any, 'fetch', async () => null); netstatByPort.set(56792, 'TCP 0.0.0.0:56792 0.0.0.0:0 LISTENING 4242\r\n'); await stopModule.stopCommand({ port: 56792, force: true }); assert.ok(execCalls.some((c) => /taskkill\b/i.test(c) || /Stop-Process\b/i.test(c) || /^kill\s+-/i.test(c))); assert.ok(exitCodes.includes(0)); assert.ok(!exitCodes.includes(1)); }); it('does not kill process when --force is not set (exits 0 with guidance)', async () => { mock.method(console, 'log', () => {}); mock.method(console, 'error', () => {}); const exitCodes: Array = []; mock.method(process as any, 'exit', (code?: number) => { exitCodes.push(code); }); mock.method(globalThis as any, 'fetch', async () => null); netstatByPort.set(56792, 'TCP 0.0.0.0:56792 0.0.0.0:0 LISTENING 4242\r\n'); await stopModule.stopCommand({ port: 56792, force: false }); assert.ok(execCalls.some((c) => /^netstat -ano/i.test(c))); assert.ok(!execCalls.some((c) => /taskkill\b/i.test(c) || /Stop-Process\b/i.test(c) || /^kill\s+-/i.test(c))); assert.ok(exitCodes.includes(0)); assert.ok(!exitCodes.includes(1)); }); it('auto-cleans Vite on react port when main server is not running (no --force)', async () => { mock.method(console, 'log', () => {}); mock.method(console, 'error', () => {}); const exitCodes: Array = []; mock.method(process as any, 'exit', (code?: number) => { exitCodes.push(code); }); // No server responding, main port free, react port occupied by Vite. mock.method(globalThis as any, 'fetch', async () => null); netstatByPort.set(56792, ''); netstatByPort.set(56793, 'TCP 0.0.0.0:56793 0.0.0.0:0 LISTENING 4242\r\n'); commandLineByPid.set('4242', 'cmd.exe /d /s /c vite --port 56793 --strictPort\r\n'); await stopModule.stopCommand({ port: 56792, force: false }); assert.ok(execCalls.some((c) => (/^powershell\b/i.test(c) && /Get-CimInstance\s+Win32_Process/i.test(c)) || /^ps\s+-p\s+/i.test(c) )); assert.ok(execCalls.some((c) => /taskkill\b/i.test(c) || /Stop-Process\b/i.test(c) || /^kill\s+-/i.test(c))); assert.ok(exitCodes.includes(0)); assert.ok(!exitCodes.includes(1)); }); });