Add bd exec bridge and mutation API routes with tests

tests/lib/bridge.test.ts

@@ -0,0 +1,86 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { runBdCommand } from '../../src/lib/bridge';
+
+test('runBdCommand returns structured success payload from execFile output', async () => {
+  const result = await runBdCommand(
+    {
+      projectRoot: 'C:/repo/project',
+      args: ['list', '--json'],
+      timeoutMs: 2000,
+      explicitBdPath: 'C:/tools/bd.exe',
+    },
+    {
+      resolveBdExecutable: async () => ({ executable: 'C:/tools/bd.exe', source: 'config' }),
+      execFile: async (command, args, options) => {
+        assert.equal(command, 'C:/tools/bd.exe');
+        assert.deepEqual(args, ['list', '--json']);
+        assert.equal(options.cwd, 'C:/repo/project');
+        return { stdout: '[{"id":"bb-1"}]\r\n', stderr: '' };
+      },
+    },
+  );
+
+  assert.equal(result.success, true);
+  assert.equal(result.classification, null);
+  assert.equal(result.stdout, '[{"id":"bb-1"}]');
+});
+
+test('runBdCommand classifies missing executable as not_found', async () => {
+  const result = await runBdCommand(
+    { projectRoot: 'C:/repo/project', args: ['list'] },
+    {
+      resolveBdExecutable: async () => ({ executable: 'C:/tools/bd.exe', source: 'config' }),
+      execFile: async () => {
+        const error = new Error('spawn ENOENT') as NodeJS.ErrnoException;
+        error.code = 'ENOENT';
+        throw error;
+      },
+    },
+  );
+
+  assert.equal(result.success, false);
+  assert.equal(result.classification, 'not_found');
+});
+
+test('runBdCommand classifies timeout failures', async () => {
+  const result = await runBdCommand(
+    { projectRoot: 'C:/repo/project', args: ['list'], timeoutMs: 5 },
+    {
+      resolveBdExecutable: async () => ({ executable: 'C:/tools/bd.exe', source: 'config' }),
+      execFile: async () => {
+        const error = new Error('timed out') as NodeJS.ErrnoException & { killed?: boolean; signal?: string };
+        error.code = 'ETIMEDOUT';
+        error.killed = true;
+        error.signal = 'SIGTERM';
+        throw error;
+      },
+    },
+  );
+
+  assert.equal(result.success, false);
+  assert.equal(result.classification, 'timeout');
+});
+
+test('runBdCommand classifies non-zero bad-argument exits', async () => {
+  const result = await runBdCommand(
+    { projectRoot: 'C:/repo/project', args: ['update', '--bad-flag'] },
+    {
+      resolveBdExecutable: async () => ({ executable: 'C:/tools/bd.exe', source: 'config' }),
+      execFile: async () => {
+        const error = new Error('exit code 1') as NodeJS.ErrnoException & {
+          stdout?: string;
+          stderr?: string;
+        };
+        (error as any).code = 1;
+        error.stderr = 'unknown flag: --bad-flag';
+        error.stdout = '';
+        throw error;
+      },
+    },
+  );
+
+  assert.equal(result.success, false);
+  assert.equal(result.classification, 'bad_args');
+});