test(commands): add unit tests for session and server commands

Solution-ID: SOL-1735386000001

Issue-ID: ISS-1766921318981-15

Task-ID: T4

ccw/tests/view-command.test.ts

@@ -0,0 +1,99 @@
+/**
+ * Unit tests for View command module (ccw view)
+ *
+ * Notes:
+ * - Targets the runtime implementation shipped in `ccw/dist`.
+ * - Uses Node's built-in test runner (node:test).
+ * - Mocks fetch + SIGINT handling to avoid opening browsers and leaving servers running.
+ */
+
+import { afterEach, before, describe, it, mock } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+class ExitError extends Error {
+  code?: number;
+
+  constructor(code?: number) {
+    super(`process.exit(${code ?? 'undefined'})`);
+    this.code = code;
+  }
+}
+
+const viewCommandPath = new URL('../dist/commands/view.js', import.meta.url).href;
+
+describe('view command module', async () => {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let viewModule: any;
+
+  before(async () => {
+    viewModule = await import(viewCommandPath);
+  });
+
+  afterEach(() => {
+    mock.restoreAll();
+  });
+
+  it('opens URL without launching browser when server is running', async () => {
+    const logs: string[] = [];
+    mock.method(console, 'log', (...args: any[]) => logs.push(args.map(String).join(' ')));
+    mock.method(console, 'error', (...args: any[]) => logs.push(args.map(String).join(' ')));
+    mock.method(process as any, 'exit', (code?: number) => {
+      throw new ExitError(code);
+    });
+
+    mock.method(globalThis as any, 'fetch', async (url: string) => {
+      if (url.includes('/api/health')) {
+        return { ok: true };
+      }
+      if (url.includes('/api/switch-path')) {
+        return {
+          ok: true,
+          json: async () => ({ success: true, path: 'C:\\test-workspace' }),
+        };
+      }
+      throw new Error(`Unexpected fetch: ${url}`);
+    });
+
+    await viewModule.viewCommand({ port: 3456, browser: false });
+    assert.ok(logs.some((l) => l.includes('Server already running')));
+    assert.ok(logs.some((l) => l.includes('URL: http://localhost:3456/')));
+  });
+
+  it('starts server when not running (browser disabled) and can be shut down via captured SIGINT handler', async () => {
+    const workspace = mkdtempSync(join(tmpdir(), 'ccw-view-workspace-'));
+
+    try {
+      let sigintHandler: (() => void) | null = null;
+
+      mock.method(console, 'log', () => {});
+      mock.method(console, 'error', () => {});
+      mock.method(process as any, 'exit', (_code?: number) => {});
+
+      const originalOn = process.on.bind(process);
+      mock.method(process as any, 'on', (event: string, handler: any) => {
+        if (event === 'SIGINT') {
+          sigintHandler = handler;
+          return process;
+        }
+        return originalOn(event, handler);
+      });
+
+      mock.method(globalThis as any, 'fetch', async (_url: string) => {
+        // Make health check fail so viewCommand triggers serveCommand
+        throw new Error('Server not running');
+      });
+
+      await viewModule.viewCommand({ port: 56789, browser: false, path: workspace });
+      assert.ok(sigintHandler, 'Expected serveCommand to register SIGINT handler');
+
+      sigintHandler?.();
+      await new Promise((resolve) => setTimeout(resolve, 200));
+    } finally {
+      rmSync(workspace, { recursive: true, force: true });
+    }
+  });
+});
+