feat(launcher): add runtime-aware status metadata

tests/scripts/beadboard-launcher-runtime.test.ts

@@ -0,0 +1,15 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+
+const execFileAsync = promisify(execFile);
+const launcherPath = path.resolve('install/beadboard.mjs');
+
+test('status --json reports runtime root and install mode', async () => {
+  const { stdout } = await execFileAsync(process.execPath, [launcherPath, 'status', '--json']);
+  const payload = JSON.parse(stdout);
+  assert.ok(payload.runtimeRoot);
+  assert.ok(payload.installMode);
+});

tests/scripts/beadboard-launcher.test.ts

@@ -0,0 +1,63 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import http from 'node:http';
+
+const execFileAsync = promisify(execFile);
+const launcherPath = path.resolve('install/beadboard.mjs');
+
+function getFreePort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const server = http.createServer();
+    server.listen(0, '127.0.0.1', () => {
+      const address = server.address();
+      if (!address || typeof address === 'string') {
+        reject(new Error('failed to resolve free port'));
+        return;
+      }
+      const { port } = address;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+test('beadboard launcher status --json reports running server', async () => {
+  const port = await getFreePort();
+  const server = http.createServer((_req, res) => {
+    res.writeHead(200, { 'content-type': 'text/plain' });
+    res.end('ok');
+  });
+  await new Promise<void>((resolve) => server.listen(port, '127.0.0.1', () => resolve()));
+
+  try {
+    const { stdout } = await execFileAsync(process.execPath, [launcherPath, 'status', '--json'], {
+      env: { ...process.env, BB_PORT: String(port) },
+    });
+    const payload = JSON.parse(stdout);
+    assert.equal(payload.ok, true);
+    assert.equal(payload.running, true);
+    assert.equal(payload.port, port);
+    assert.ok(payload.runtimeRoot);
+    assert.ok(payload.installMode);
+    assert.ok(payload.shimTarget);
+  } finally {
+    await new Promise<void>((resolve, reject) =>
+      server.close((err) => (err ? reject(err) : resolve())),
+    );
+  }
+});
+
+test('beadboard launcher open --json supports noop mode', async () => {
+  const { stdout } = await execFileAsync(process.execPath, [launcherPath, 'open', '--json'], {
+    env: { ...process.env, BB_OPEN_NOOP: '1', BB_PORT: '3456' },
+  });
+  const payload = JSON.parse(stdout);
+  assert.equal(payload.ok, true);
+  assert.equal(payload.command, 'open');
+  assert.match(payload.url, /3456/);
+});