@opengsd/gsd-pi 1.10.0 → 1.11.0

package/packages/gsd-cloud/dist/background-cli.test.js

@@ -1,7 +1,7 @@
 // Project/App: Open GSD
 // File Purpose: Acceptance coverage for the detached gsd-cloud runtime lifecycle.
 import { spawn } from "node:child_process";
-import { mkdtempSync, mkdirSync, realpathSync, rmSync, symlinkSync } from "node:fs";
+import { existsSync, mkdtempSync, mkdirSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
@@ -10,6 +10,8 @@ import { test } from "node:test";
 import assert from "node:assert/strict";
 import { WebSocketServer } from "ws";
 import { saveCloudConfig } from "./cloud-config.js";
+import { runtimeArtifactPath } from "./runtime-artifacts.js";
+import { startBackgroundRuntime, stopBackgroundRuntime } from "./runtime-process.js";
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const cliPath = join(packageRoot, "bin", "gsd-cloud.js");
 function runCli(args, cwd, timeoutMs = 12_000, extraEnv = {}) {
@@ -109,74 +111,101 @@ async function createTestGateway(deviceFlow = false) {
         },
     };
 }
-test("connect returns while a background runtime advertises the selected project", async () => {
+test("connect returns while a background runtime advertises the selected project", async (t) => {
     const root = mkdtempSync(join(tmpdir(), "gsd-cloud-background-"));
     const projectDir = join(root, "project");
     const expectedProjectDir = join(realpathSync(root), "project");
     const configPath = join(root, "daemon.yaml");
     mkdirSync(join(projectDir, ".gsd"), { recursive: true });
     const gateway = await createTestGateway();
+    t.after(async () => {
+        await runCli(["disconnect", "--config", configPath], projectDir).catch(() => undefined);
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    });
     saveCloudConfig(configPath, {
         gateway_url: gateway.baseUrl,
         device_token: "test",
         runtime_id: "fixture-runtime",
         enabled: true,
     });
-    try {
-        const connect = await runCli(["connect", "--config", configPath], projectDir);
-        assert.equal(connect.code, 0, connect.stderr);
-        assert.match(connect.stdout, /connected in the background/i);
-        const message = await gateway.hello;
-        assert.equal(message.type, "hello");
-        const projects = message.projects;
-        assert.equal(projects.length, 1);
-        assert.equal(projects[0]?.path, expectedProjectDir);
-        const status = await runCli(["status", "--config", configPath], projectDir);
-        assert.equal(status.code, 0, status.stderr);
-        const statusBody = JSON.parse(status.stdout);
-        assert.equal(statusBody.background?.running, true);
-        assert.equal(typeof statusBody.background?.pid, "number");
-        assert.deepEqual(statusBody.projects, [expectedProjectDir]);
-    }
-    finally {
+    const connect = await runCli(["connect", "--config", configPath], projectDir);
+    assert.equal(connect.code, 0, connect.stderr);
+    assert.match(connect.stdout, /connected in the background/i);
+    const message = await gateway.hello;
+    assert.equal(message.type, "hello");
+    const projects = message.projects;
+    assert.equal(projects.length, 1);
+    assert.equal(projects[0]?.path, expectedProjectDir);
+    const status = await runCli(["status", "--config", configPath], projectDir);
+    assert.equal(status.code, 0, status.stderr);
+    const statusBody = JSON.parse(status.stdout);
+    assert.equal(statusBody.background?.running, true);
+    assert.equal(typeof statusBody.background?.pid, "number");
+    assert.deepEqual(statusBody.projects, [expectedProjectDir]);
+});
+test("stop terminates the background runtime without removing pairing", async (t) => {
+    const root = mkdtempSync(join(tmpdir(), "gsd-cloud-stop-command-"));
+    const projectDir = join(root, "project");
+    const configPath = join(root, "daemon.yaml");
+    mkdirSync(join(projectDir, ".gsd"), { recursive: true });
+    const gateway = await createTestGateway();
+    t.after(async () => {
         await runCli(["disconnect", "--config", configPath], projectDir).catch(() => undefined);
         await gateway.close();
         rmSync(root, { recursive: true, force: true });
-    }
+    });
+    saveCloudConfig(configPath, {
+        gateway_url: gateway.baseUrl,
+        device_token: "test",
+        runtime_id: "fixture-runtime",
+        enabled: true,
+    });
+    const connect = await runCli(["connect", "--config", configPath], projectDir);
+    assert.equal(connect.code, 0, connect.stderr);
+    await gateway.hello;
+    const stop = await runCli(["stop", "--config", configPath], projectDir);
+    assert.equal(stop.code, 0, stop.stderr);
+    assert.match(stop.stdout, /background runtime stopped/i);
+    const status = await runCli(["status", "--config", configPath], projectDir);
+    const body = JSON.parse(status.stdout);
+    assert.equal(body.configured, true);
+    assert.equal(body.runtime_id, "fixture-runtime");
+    assert.equal(body.background?.running, false);
+    assert.notEqual(body.telemetry, null);
 });
-test("login returns after approval and keeps the selected project connected", async () => {
+test("login returns after approval and keeps the selected project connected", async (t) => {
     const root = mkdtempSync(join(tmpdir(), "gsd-cloud-login-background-"));
     const projectDir = join(root, "project");
     const expectedProjectDir = join(realpathSync(root), "project");
     const configPath = join(root, "daemon.yaml");
     mkdirSync(join(projectDir, ".gsd"), { recursive: true });
     const gateway = await createTestGateway(true);
-    try {
-        const login = await runCli([
-            "login",
-            "--gateway", gateway.baseUrl,
-            "--config", configPath,
-        ], projectDir, 12_000);
-        assert.equal(login.code, 0, login.stderr);
-        assert.match(login.stdout, /Authorization approved!/);
-        assert.match(login.stdout, /connected in the background/i);
-        const message = await gateway.hello;
-        const projects = message.projects;
-        assert.deepEqual(projects.map((project) => project.path), [expectedProjectDir]);
-        const disconnect = await runCli(["disconnect", "--config", configPath], projectDir);
-        assert.equal(disconnect.code, 0, disconnect.stderr);
-        const status = await runCli(["status", "--config", configPath], projectDir);
-        const statusBody = JSON.parse(status.stdout);
-        assert.equal(statusBody.configured, false);
-        assert.equal(statusBody.background?.running, false);
-    }
-    finally {
+    t.after(async () => {
         await runCli(["disconnect", "--config", configPath], projectDir).catch(() => undefined);
         await gateway.close();
         rmSync(root, { recursive: true, force: true });
-    }
+    });
+    const login = await runCli([
+        "login",
+        "--gateway", gateway.baseUrl,
+        "--config", configPath,
+    ], projectDir, 12_000);
+    assert.equal(login.code, 0, login.stderr);
+    assert.match(login.stdout, /Authorization approved!/);
+    assert.match(login.stdout, /connected in the background/i);
+    const message = await gateway.hello;
+    const projects = message.projects;
+    assert.deepEqual(projects.map((project) => project.path), [expectedProjectDir]);
+    const disconnect = await runCli(["disconnect", "--config", configPath], projectDir);
+    assert.equal(disconnect.code, 0, disconnect.stderr);
+    const status = await runCli(["status", "--config", configPath], projectDir);
+    const statusBody = JSON.parse(status.stdout);
+    assert.equal(statusBody.configured, false);
+    assert.equal(statusBody.background?.running, false);
+    assert.equal(statusBody.telemetry, null);
 });
-test("advertised project paths are canonicalized through symlinks", async () => {
+test("advertised project paths are canonicalized through symlinks", async (t) => {
     const root = realpathSync(mkdtempSync(join(tmpdir(), "gsd-cloud-symlink-")));
     const realProject = join(root, "real-project");
     mkdirSync(join(realProject, ".gsd"), { recursive: true });
@@ -184,35 +213,74 @@ test("advertised project paths are canonicalized through symlinks", async () =>
     symlinkSync(realProject, linkProject);
     const configPath = join(root, "daemon.yaml");
     const gateway = await createTestGateway();
+    t.after(async () => {
+        await runCli(["disconnect", "--config", configPath], realProject).catch(() => undefined);
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    });
+    saveCloudConfig(configPath, {
+        gateway_url: gateway.baseUrl,
+        device_token: "test",
+        runtime_id: "fixture-runtime",
+        enabled: true,
+    });
+    // Point the runtime at the symlink; the advertised path must be the real dir.
+    const connect = await runCli(["connect", "--config", configPath], realProject, 5_000, { GSD_CLOUD_PROJECTS: linkProject });
+    assert.equal(connect.code, 0, connect.stderr);
+    const message = await gateway.hello;
+    const projects = message.projects;
+    assert.equal(projects.length, 1);
+    assert.equal(projects[0]?.path, realProject);
+    const status = await runCli(["status", "--config", configPath], realProject);
+    const statusBody = JSON.parse(status.stdout);
+    assert.deepEqual(statusBody.projects, [realProject]);
+});
+test("a foreground runtime registers its PID so disconnect can stop it", async (t) => {
+    const root = realpathSync(mkdtempSync(join(tmpdir(), "gsd-cloud-foreground-")));
+    const projectDir = join(root, "project");
+    const configPath = join(root, "daemon.yaml");
+    mkdirSync(join(projectDir, ".gsd"), { recursive: true });
+    const gateway = await createTestGateway();
     saveCloudConfig(configPath, {
         gateway_url: gateway.baseUrl,
         device_token: "test",
         runtime_id: "fixture-runtime",
         enabled: true,
     });
-    try {
-        // Point the runtime at the symlink; the advertised path must be the real dir.
-        const connect = await runCli(["connect", "--config", configPath], realProject, 5_000, { GSD_CLOUD_PROJECTS: linkProject });
-        assert.equal(connect.code, 0, connect.stderr);
-        const message = await gateway.hello;
-        const projects = message.projects;
-        assert.equal(projects.length, 1);
-        assert.equal(projects[0]?.path, realProject);
-        const status = await runCli(["status", "--config", configPath], realProject);
-        const statusBody = JSON.parse(status.stdout);
-        assert.deepEqual(statusBody.projects, [realProject]);
-    }
-    finally {
-        await runCli(["disconnect", "--config", configPath], realProject).catch(() => undefined);
+    const foreground = spawnForegroundCli(["connect", "--foreground", "--config", configPath], projectDir);
+    t.after(async () => {
+        foreground.child.kill("SIGKILL");
         await gateway.close();
         rmSync(root, { recursive: true, force: true });
-    }
+    });
+    // Once the foreground runtime advertises its project it is fully connected.
+    await gateway.hello;
+    // The foreground session must record its own PID in the shared runtime state
+    // so status can see it and a later disconnect can find and stop it.
+    const status = await runCli(["status", "--config", configPath], projectDir);
+    const statusBody = JSON.parse(status.stdout);
+    assert.equal(statusBody.background?.running, true);
+    assert.equal(statusBody.background?.pid, foreground.child.pid);
+    const disconnect = await runCli(["disconnect", "--config", configPath], projectDir);
+    assert.equal(disconnect.code, 0, disconnect.stderr);
+    // disconnect must have terminated the foreground process.
+    const exitCode = await foreground.exited;
+    assert.equal(exitCode, 0);
+    const afterStatus = await runCli(["status", "--config", configPath], projectDir);
+    const afterBody = JSON.parse(afterStatus.stdout);
+    assert.equal(afterBody.background?.running, false);
 });
-test("a foreground runtime registers its PID so disconnect can stop it", async () => {
-    const root = realpathSync(mkdtempSync(join(tmpdir(), "gsd-cloud-foreground-")));
+test("foreground connect waits for an in-progress background start", { timeout: 10_000 }, async (t) => {
+    const root = realpathSync(mkdtempSync(join(tmpdir(), "gsd-cloud-foreground-lock-")));
     const projectDir = join(root, "project");
     const configPath = join(root, "daemon.yaml");
+    const delayedRuntimePath = join(root, "delayed-runtime.mjs");
     mkdirSync(join(projectDir, ".gsd"), { recursive: true });
+    writeFileSync(delayedRuntimePath, [
+        'process.on("SIGTERM", () => process.exit(0));',
+        'setTimeout(() => process.send?.({ type: "ready" }), 3_000);',
+        'setInterval(() => undefined, 1_000);',
+    ].join("\n"));
     const gateway = await createTestGateway();
     saveCloudConfig(configPath, {
         gateway_url: gateway.baseUrl,
@@ -220,29 +288,38 @@ test("a foreground runtime registers its PID so disconnect can stop it", async (
         runtime_id: "fixture-runtime",
         enabled: true,
     });
+    const backgroundStart = startBackgroundRuntime({
+        binaryPath: delayedRuntimePath,
+        configPath,
+        projectDirs: [projectDir],
+    });
+    await waitForCondition(() => existsSync(runtimeArtifactPath(configPath, "start.lock")));
+    await waitForCondition(() => existsSync(runtimeArtifactPath(configPath, "state")));
     const foreground = spawnForegroundCli(["connect", "--foreground", "--config", configPath], projectDir);
-    try {
-        // Once the foreground runtime advertises its project it is fully connected.
-        await gateway.hello;
-        // The foreground session must record its own PID in the shared runtime state
-        // so status can see it and a later disconnect can find and stop it.
-        const status = await runCli(["status", "--config", configPath], projectDir);
-        const statusBody = JSON.parse(status.stdout);
-        assert.equal(statusBody.background?.running, true);
-        assert.equal(statusBody.background?.pid, foreground.child.pid);
-        const disconnect = await runCli(["disconnect", "--config", configPath], projectDir);
-        assert.equal(disconnect.code, 0, disconnect.stderr);
-        // disconnect must have terminated the foreground process.
-        const exitCode = await foreground.exited;
-        assert.equal(exitCode, 0);
-        const afterStatus = await runCli(["status", "--config", configPath], projectDir);
-        const afterBody = JSON.parse(afterStatus.stdout);
-        assert.equal(afterBody.background?.running, false);
-    }
-    finally {
+    t.after(async () => {
         foreground.child.kill("SIGKILL");
+        await stopBackgroundRuntime(configPath).catch(() => undefined);
         await gateway.close();
         rmSync(root, { recursive: true, force: true });
-    }
+    });
+    const connectedBeforeBackgroundStartFinished = await Promise.race([
+        gateway.hello.then(() => true),
+        new Promise((resolveDelay) => setTimeout(() => resolveDelay(false), 500)),
+    ]);
+    assert.equal(connectedBeforeBackgroundStartFinished, false);
+    const background = await backgroundStart;
+    assert.equal(background.running, true);
+    await gateway.hello;
+    const disconnect = await runCli(["disconnect", "--config", configPath], projectDir);
+    assert.equal(disconnect.code, 0, disconnect.stderr);
+    assert.equal(await foreground.exited, 0);
 });
+async function waitForCondition(condition, timeoutMs = 2_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (!condition()) {
+        if (Date.now() >= deadline)
+            throw new Error("timed out waiting for test condition");
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    }
+}
 //# sourceMappingURL=background-cli.test.js.map

package/packages/gsd-cloud/dist/background-cli.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-cli.test.js","sourceRoot":"","sources":["../src/background-cli.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Acceptance coverage for the detached gsd-cloud runtime lifecycle.\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdtempSync, mkdirSync, realpathSync, rmSync, symlinkSync } from \"node:fs\";\nimport { createServer } from \"node:http\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { test } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { WebSocketServer } from \"ws\";\nimport { saveCloudConfig } from \"./cloud-config.js\";\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst cliPath = join(packageRoot, \"bin\", \"gsd-cloud.js\");\n\ninterface CliResult {\n  code: number | null;\n  stdout: string;\n  stderr: string;\n}\n\ninterface TestGateway {\n  baseUrl: string;\n  hello: Promise<Record<string, unknown>>;\n  close: () => Promise<void>;\n}\n\nfunction runCli(\n  args: string[],\n  cwd: string,\n  timeoutMs = 12_000,\n  extraEnv: Record<string, string | undefined> = {},\n): Promise<CliResult> {\n  return new Promise((resolveResult, reject) => {\n    const child = spawn(process.execPath, [cliPath, ...args], {\n      cwd,\n      env: { ...process.env, GSD_CLOUD_PROJECTS: undefined, ...extraEnv },\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    let stdout = \"\";\n    let stderr = \"\";\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => { stdout += chunk; });\n    child.stderr.on(\"data\", (chunk: string) => { stderr += chunk; });\n\n    const timeout = setTimeout(() => {\n      child.kill(\"SIGTERM\");\n      reject(new Error(`gsd-cloud did not return within ${timeoutMs}ms`));\n    }, timeoutMs);\n    child.once(\"error\", (error) => {\n      clearTimeout(timeout);\n      reject(error);\n    });\n    child.once(\"exit\", (code) => {\n      clearTimeout(timeout);\n      resolveResult({ code, stdout, stderr });\n    });\n  });\n}\n\ninterface ForegroundCli {\n  child: ChildProcess;\n  exited: Promise<number | null>;\n}\n\n// Spawn a long-lived CLI process (e.g. `--foreground`) without waiting for exit,\n// so the test can inspect its state and then stop it.\nfunction spawnForegroundCli(args: string[], cwd: string): ForegroundCli {\n  const child = spawn(process.execPath, [cliPath, ...args], {\n    cwd,\n    env: { ...process.env, GSD_CLOUD_PROJECTS: undefined },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  const exited = new Promise<number | null>((resolveExit) => {\n    child.once(\"exit\", (code) => resolveExit(code));\n  });\n  return { child, exited };\n}\n\nasync function createTestGateway(deviceFlow = false): Promise<TestGateway> {\n  let baseUrl = \"\";\n  const server = createServer((req, res) => {\n    if (!deviceFlow) {\n      res.writeHead(404).end();\n      return;\n    }\n    res.setHeader(\"content-type\", \"application/json\");\n    if (req.url === \"/api/device/code\") {\n      res.end(JSON.stringify({\n        userCode: \"TEST-CODE\",\n        deviceCode: \"test-device\",\n        verificationUriComplete: `${baseUrl}/approve-device?code=TEST-CODE`,\n        expiresIn: 30,\n      }));\n      return;\n    }\n    if (req.url === \"/api/device/token\") {\n      res.end(JSON.stringify({\n        status: \"approved\",\n        token: \"test\",\n        runtimeId: \"fixture-runtime\",\n        gateway_url: baseUrl,\n      }));\n      return;\n    }\n    res.writeHead(404).end();\n  });\n  const wss = new WebSocketServer({ server });\n  await new Promise<void>((resolveListen, reject) => {\n    server.once(\"error\", reject);\n    server.listen(0, \"127.0.0.1\", resolveListen);\n  });\n  const address = server.address();\n  assert.ok(address && typeof address === \"object\");\n  baseUrl = `http://127.0.0.1:${address.port}`;\n\n  let helloTimeout: ReturnType<typeof setTimeout>;\n  const hello = new Promise<Record<string, unknown>>((resolveHello, reject) => {\n    helloTimeout = setTimeout(() => reject(new Error(\"background runtime did not advertise its project\")), 8_000);\n    wss.once(\"connection\", (socket) => {\n      socket.once(\"message\", (data) => {\n        clearTimeout(helloTimeout);\n        resolveHello(JSON.parse(data.toString(\"utf8\")) as Record<string, unknown>);\n      });\n    });\n  });\n\n  return {\n    baseUrl,\n    hello,\n    close: async () => {\n      clearTimeout(helloTimeout);\n      for (const client of wss.clients) client.terminate();\n      await new Promise<void>((resolveClose) => wss.close(() => server.close(() => resolveClose())));\n    },\n  };\n}\n\ntest(\"connect returns while a background runtime advertises the selected project\", async () => {\n  const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-background-\"));\n  const projectDir = join(root, \"project\");\n  const expectedProjectDir = join(realpathSync(root), \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n\n  const gateway = await createTestGateway();\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  try {\n    const connect = await runCli([\"connect\", \"--config\", configPath], projectDir);\n    assert.equal(connect.code, 0, connect.stderr);\n    assert.match(connect.stdout, /connected in the background/i);\n\n    const message = await gateway.hello;\n    assert.equal(message.type, \"hello\");\n    const projects = message.projects as Array<{ path: string }>;\n    assert.equal(projects.length, 1);\n    assert.equal(projects[0]?.path, expectedProjectDir);\n\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    assert.equal(status.code, 0, status.stderr);\n    const statusBody = JSON.parse(status.stdout) as {\n      background?: { running?: boolean; pid?: number | null };\n      projects?: string[];\n    };\n    assert.equal(statusBody.background?.running, true);\n    assert.equal(typeof statusBody.background?.pid, \"number\");\n    assert.deepEqual(statusBody.projects, [expectedProjectDir]);\n  } finally {\n    await runCli([\"disconnect\", \"--config\", configPath], projectDir).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  }\n});\n\ntest(\"login returns after approval and keeps the selected project connected\", async () => {\n  const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-login-background-\"));\n  const projectDir = join(root, \"project\");\n  const expectedProjectDir = join(realpathSync(root), \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  const gateway = await createTestGateway(true);\n\n  try {\n    const login = await runCli([\n      \"login\",\n      \"--gateway\", gateway.baseUrl,\n      \"--config\", configPath,\n    ], projectDir, 12_000);\n    assert.equal(login.code, 0, login.stderr);\n    assert.match(login.stdout, /Authorization approved!/);\n    assert.match(login.stdout, /connected in the background/i);\n\n    const message = await gateway.hello;\n    const projects = message.projects as Array<{ path: string }>;\n    assert.deepEqual(projects.map((project) => project.path), [expectedProjectDir]);\n\n    const disconnect = await runCli([\"disconnect\", \"--config\", configPath], projectDir);\n    assert.equal(disconnect.code, 0, disconnect.stderr);\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const statusBody = JSON.parse(status.stdout) as {\n      configured?: boolean;\n      background?: { running?: boolean };\n    };\n    assert.equal(statusBody.configured, false);\n    assert.equal(statusBody.background?.running, false);\n  } finally {\n    await runCli([\"disconnect\", \"--config\", configPath], projectDir).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  }\n});\n\ntest(\"advertised project paths are canonicalized through symlinks\", async () => {\n  const root = realpathSync(mkdtempSync(join(tmpdir(), \"gsd-cloud-symlink-\")));\n  const realProject = join(root, \"real-project\");\n  mkdirSync(join(realProject, \".gsd\"), { recursive: true });\n  const linkProject = join(root, \"link-project\");\n  symlinkSync(realProject, linkProject);\n  const configPath = join(root, \"daemon.yaml\");\n  const gateway = await createTestGateway();\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  try {\n    // Point the runtime at the symlink; the advertised path must be the real dir.\n    const connect = await runCli(\n      [\"connect\", \"--config\", configPath],\n      realProject,\n      5_000,\n      { GSD_CLOUD_PROJECTS: linkProject },\n    );\n    assert.equal(connect.code, 0, connect.stderr);\n\n    const message = await gateway.hello;\n    const projects = message.projects as Array<{ path: string }>;\n    assert.equal(projects.length, 1);\n    assert.equal(projects[0]?.path, realProject);\n\n    const status = await runCli([\"status\", \"--config\", configPath], realProject);\n    const statusBody = JSON.parse(status.stdout) as { projects?: string[] };\n    assert.deepEqual(statusBody.projects, [realProject]);\n  } finally {\n    await runCli([\"disconnect\", \"--config\", configPath], realProject).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  }\n});\n\ntest(\"a foreground runtime registers its PID so disconnect can stop it\", async () => {\n  const root = realpathSync(mkdtempSync(join(tmpdir(), \"gsd-cloud-foreground-\")));\n  const projectDir = join(root, \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  const gateway = await createTestGateway();\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  const foreground = spawnForegroundCli([\"connect\", \"--foreground\", \"--config\", configPath], projectDir);\n  try {\n    // Once the foreground runtime advertises its project it is fully connected.\n    await gateway.hello;\n\n    // The foreground session must record its own PID in the shared runtime state\n    // so status can see it and a later disconnect can find and stop it.\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const statusBody = JSON.parse(status.stdout) as {\n      background?: { running?: boolean; pid?: number | null };\n    };\n    assert.equal(statusBody.background?.running, true);\n    assert.equal(statusBody.background?.pid, foreground.child.pid);\n\n    const disconnect = await runCli([\"disconnect\", \"--config\", configPath], projectDir);\n    assert.equal(disconnect.code, 0, disconnect.stderr);\n\n    // disconnect must have terminated the foreground process.\n    const exitCode = await foreground.exited;\n    assert.equal(exitCode, 0);\n\n    const afterStatus = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const afterBody = JSON.parse(afterStatus.stdout) as { background?: { running?: boolean } };\n    assert.equal(afterBody.background?.running, false);\n  } finally {\n    foreground.child.kill(\"SIGKILL\");\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  }\n});\n"]}
+{"version":3,"file":"background-cli.test.js","sourceRoot":"","sources":["../src/background-cli.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Acceptance coverage for the detached gsd-cloud runtime lifecycle.\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { existsSync, mkdtempSync, mkdirSync, realpathSync, rmSync, symlinkSync, writeFileSync } from \"node:fs\";\nimport { createServer } from \"node:http\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { test } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { WebSocketServer } from \"ws\";\nimport { saveCloudConfig } from \"./cloud-config.js\";\nimport { runtimeArtifactPath } from \"./runtime-artifacts.js\";\nimport { startBackgroundRuntime, stopBackgroundRuntime } from \"./runtime-process.js\";\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst cliPath = join(packageRoot, \"bin\", \"gsd-cloud.js\");\n\ninterface CliResult {\n  code: number | null;\n  stdout: string;\n  stderr: string;\n}\n\ninterface TestGateway {\n  baseUrl: string;\n  hello: Promise<Record<string, unknown>>;\n  close: () => Promise<void>;\n}\n\nfunction runCli(\n  args: string[],\n  cwd: string,\n  timeoutMs = 12_000,\n  extraEnv: Record<string, string | undefined> = {},\n): Promise<CliResult> {\n  return new Promise((resolveResult, reject) => {\n    const child = spawn(process.execPath, [cliPath, ...args], {\n      cwd,\n      env: { ...process.env, GSD_CLOUD_PROJECTS: undefined, ...extraEnv },\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    let stdout = \"\";\n    let stderr = \"\";\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => { stdout += chunk; });\n    child.stderr.on(\"data\", (chunk: string) => { stderr += chunk; });\n\n    const timeout = setTimeout(() => {\n      child.kill(\"SIGTERM\");\n      reject(new Error(`gsd-cloud did not return within ${timeoutMs}ms`));\n    }, timeoutMs);\n    child.once(\"error\", (error) => {\n      clearTimeout(timeout);\n      reject(error);\n    });\n    child.once(\"exit\", (code) => {\n      clearTimeout(timeout);\n      resolveResult({ code, stdout, stderr });\n    });\n  });\n}\n\ninterface ForegroundCli {\n  child: ChildProcess;\n  exited: Promise<number | null>;\n}\n\n// Spawn a long-lived CLI process (e.g. `--foreground`) without waiting for exit,\n// so the test can inspect its state and then stop it.\nfunction spawnForegroundCli(args: string[], cwd: string): ForegroundCli {\n  const child = spawn(process.execPath, [cliPath, ...args], {\n    cwd,\n    env: { ...process.env, GSD_CLOUD_PROJECTS: undefined },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  const exited = new Promise<number | null>((resolveExit) => {\n    child.once(\"exit\", (code) => resolveExit(code));\n  });\n  return { child, exited };\n}\n\nasync function createTestGateway(deviceFlow = false): Promise<TestGateway> {\n  let baseUrl = \"\";\n  const server = createServer((req, res) => {\n    if (!deviceFlow) {\n      res.writeHead(404).end();\n      return;\n    }\n    res.setHeader(\"content-type\", \"application/json\");\n    if (req.url === \"/api/device/code\") {\n      res.end(JSON.stringify({\n        userCode: \"TEST-CODE\",\n        deviceCode: \"test-device\",\n        verificationUriComplete: `${baseUrl}/approve-device?code=TEST-CODE`,\n        expiresIn: 30,\n      }));\n      return;\n    }\n    if (req.url === \"/api/device/token\") {\n      res.end(JSON.stringify({\n        status: \"approved\",\n        token: \"test\",\n        runtimeId: \"fixture-runtime\",\n        gateway_url: baseUrl,\n      }));\n      return;\n    }\n    res.writeHead(404).end();\n  });\n  const wss = new WebSocketServer({ server });\n  await new Promise<void>((resolveListen, reject) => {\n    server.once(\"error\", reject);\n    server.listen(0, \"127.0.0.1\", resolveListen);\n  });\n  const address = server.address();\n  assert.ok(address && typeof address === \"object\");\n  baseUrl = `http://127.0.0.1:${address.port}`;\n\n  let helloTimeout: ReturnType<typeof setTimeout>;\n  const hello = new Promise<Record<string, unknown>>((resolveHello, reject) => {\n    helloTimeout = setTimeout(() => reject(new Error(\"background runtime did not advertise its project\")), 8_000);\n    wss.once(\"connection\", (socket) => {\n      socket.once(\"message\", (data) => {\n        clearTimeout(helloTimeout);\n        resolveHello(JSON.parse(data.toString(\"utf8\")) as Record<string, unknown>);\n      });\n    });\n  });\n\n  return {\n    baseUrl,\n    hello,\n    close: async () => {\n      clearTimeout(helloTimeout);\n      for (const client of wss.clients) client.terminate();\n      await new Promise<void>((resolveClose) => wss.close(() => server.close(() => resolveClose())));\n    },\n  };\n}\n\ntest(\"connect returns while a background runtime advertises the selected project\", async (t) => {\n  const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-background-\"));\n  const projectDir = join(root, \"project\");\n  const expectedProjectDir = join(realpathSync(root), \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n\n  const gateway = await createTestGateway();\n  t.after(async () => {\n    await runCli([\"disconnect\", \"--config\", configPath], projectDir).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  const connect = await runCli([\"connect\", \"--config\", configPath], projectDir);\n    assert.equal(connect.code, 0, connect.stderr);\n    assert.match(connect.stdout, /connected in the background/i);\n\n    const message = await gateway.hello;\n    assert.equal(message.type, \"hello\");\n    const projects = message.projects as Array<{ path: string }>;\n    assert.equal(projects.length, 1);\n    assert.equal(projects[0]?.path, expectedProjectDir);\n\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    assert.equal(status.code, 0, status.stderr);\n    const statusBody = JSON.parse(status.stdout) as {\n      background?: { running?: boolean; pid?: number | null };\n      projects?: string[];\n    };\n    assert.equal(statusBody.background?.running, true);\n    assert.equal(typeof statusBody.background?.pid, \"number\");\n  assert.deepEqual(statusBody.projects, [expectedProjectDir]);\n});\n\ntest(\"stop terminates the background runtime without removing pairing\", async (t) => {\n  const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-stop-command-\"));\n  const projectDir = join(root, \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  const gateway = await createTestGateway();\n  t.after(async () => {\n    await runCli([\"disconnect\", \"--config\", configPath], projectDir).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  const connect = await runCli([\"connect\", \"--config\", configPath], projectDir);\n    assert.equal(connect.code, 0, connect.stderr);\n    await gateway.hello;\n\n    const stop = await runCli([\"stop\", \"--config\", configPath], projectDir);\n    assert.equal(stop.code, 0, stop.stderr);\n    assert.match(stop.stdout, /background runtime stopped/i);\n\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const body = JSON.parse(status.stdout) as {\n      configured?: boolean;\n      runtime_id?: string;\n      background?: { running?: boolean };\n      telemetry?: unknown;\n    };\n    assert.equal(body.configured, true);\n    assert.equal(body.runtime_id, \"fixture-runtime\");\n    assert.equal(body.background?.running, false);\n  assert.notEqual(body.telemetry, null);\n});\n\ntest(\"login returns after approval and keeps the selected project connected\", async (t) => {\n  const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-login-background-\"));\n  const projectDir = join(root, \"project\");\n  const expectedProjectDir = join(realpathSync(root), \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  const gateway = await createTestGateway(true);\n  t.after(async () => {\n    await runCli([\"disconnect\", \"--config\", configPath], projectDir).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  const login = await runCli([\n      \"login\",\n      \"--gateway\", gateway.baseUrl,\n      \"--config\", configPath,\n    ], projectDir, 12_000);\n    assert.equal(login.code, 0, login.stderr);\n    assert.match(login.stdout, /Authorization approved!/);\n    assert.match(login.stdout, /connected in the background/i);\n\n    const message = await gateway.hello;\n    const projects = message.projects as Array<{ path: string }>;\n    assert.deepEqual(projects.map((project) => project.path), [expectedProjectDir]);\n\n    const disconnect = await runCli([\"disconnect\", \"--config\", configPath], projectDir);\n    assert.equal(disconnect.code, 0, disconnect.stderr);\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const statusBody = JSON.parse(status.stdout) as {\n      configured?: boolean;\n      background?: { running?: boolean };\n      telemetry?: unknown;\n    };\n    assert.equal(statusBody.configured, false);\n    assert.equal(statusBody.background?.running, false);\n  assert.equal(statusBody.telemetry, null);\n});\n\ntest(\"advertised project paths are canonicalized through symlinks\", async (t) => {\n  const root = realpathSync(mkdtempSync(join(tmpdir(), \"gsd-cloud-symlink-\")));\n  const realProject = join(root, \"real-project\");\n  mkdirSync(join(realProject, \".gsd\"), { recursive: true });\n  const linkProject = join(root, \"link-project\");\n  symlinkSync(realProject, linkProject);\n  const configPath = join(root, \"daemon.yaml\");\n  const gateway = await createTestGateway();\n  t.after(async () => {\n    await runCli([\"disconnect\", \"--config\", configPath], realProject).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  // Point the runtime at the symlink; the advertised path must be the real dir.\n    const connect = await runCli(\n      [\"connect\", \"--config\", configPath],\n      realProject,\n      5_000,\n      { GSD_CLOUD_PROJECTS: linkProject },\n    );\n    assert.equal(connect.code, 0, connect.stderr);\n\n    const message = await gateway.hello;\n    const projects = message.projects as Array<{ path: string }>;\n    assert.equal(projects.length, 1);\n    assert.equal(projects[0]?.path, realProject);\n\n    const status = await runCli([\"status\", \"--config\", configPath], realProject);\n    const statusBody = JSON.parse(status.stdout) as { projects?: string[] };\n  assert.deepEqual(statusBody.projects, [realProject]);\n});\n\ntest(\"a foreground runtime registers its PID so disconnect can stop it\", async (t) => {\n  const root = realpathSync(mkdtempSync(join(tmpdir(), \"gsd-cloud-foreground-\")));\n  const projectDir = join(root, \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  const gateway = await createTestGateway();\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  const foreground = spawnForegroundCli([\"connect\", \"--foreground\", \"--config\", configPath], projectDir);\n  t.after(async () => {\n    foreground.child.kill(\"SIGKILL\");\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  // Once the foreground runtime advertises its project it is fully connected.\n    await gateway.hello;\n\n    // The foreground session must record its own PID in the shared runtime state\n    // so status can see it and a later disconnect can find and stop it.\n    const status = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const statusBody = JSON.parse(status.stdout) as {\n      background?: { running?: boolean; pid?: number | null };\n    };\n    assert.equal(statusBody.background?.running, true);\n    assert.equal(statusBody.background?.pid, foreground.child.pid);\n\n    const disconnect = await runCli([\"disconnect\", \"--config\", configPath], projectDir);\n    assert.equal(disconnect.code, 0, disconnect.stderr);\n\n    // disconnect must have terminated the foreground process.\n    const exitCode = await foreground.exited;\n    assert.equal(exitCode, 0);\n\n    const afterStatus = await runCli([\"status\", \"--config\", configPath], projectDir);\n    const afterBody = JSON.parse(afterStatus.stdout) as { background?: { running?: boolean } };\n  assert.equal(afterBody.background?.running, false);\n});\n\ntest(\"foreground connect waits for an in-progress background start\", { timeout: 10_000 }, async (t) => {\n  const root = realpathSync(mkdtempSync(join(tmpdir(), \"gsd-cloud-foreground-lock-\")));\n  const projectDir = join(root, \"project\");\n  const configPath = join(root, \"daemon.yaml\");\n  const delayedRuntimePath = join(root, \"delayed-runtime.mjs\");\n  mkdirSync(join(projectDir, \".gsd\"), { recursive: true });\n  writeFileSync(delayedRuntimePath, [\n    'process.on(\"SIGTERM\", () => process.exit(0));',\n    'setTimeout(() => process.send?.({ type: \"ready\" }), 3_000);',\n    'setInterval(() => undefined, 1_000);',\n  ].join(\"\\n\"));\n  const gateway = await createTestGateway();\n\n  saveCloudConfig(configPath, {\n    gateway_url: gateway.baseUrl,\n    device_token: \"test\",\n    runtime_id: \"fixture-runtime\",\n    enabled: true,\n  });\n\n  const backgroundStart = startBackgroundRuntime({\n    binaryPath: delayedRuntimePath,\n    configPath,\n    projectDirs: [projectDir],\n  });\n  await waitForCondition(() => existsSync(runtimeArtifactPath(configPath, \"start.lock\")));\n  await waitForCondition(() => existsSync(runtimeArtifactPath(configPath, \"state\")));\n  const foreground = spawnForegroundCli([\"connect\", \"--foreground\", \"--config\", configPath], projectDir);\n  t.after(async () => {\n    foreground.child.kill(\"SIGKILL\");\n    await stopBackgroundRuntime(configPath).catch(() => undefined);\n    await gateway.close();\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  const connectedBeforeBackgroundStartFinished = await Promise.race([\n    gateway.hello.then(() => true),\n    new Promise<false>((resolveDelay) => setTimeout(() => resolveDelay(false), 500)),\n  ]);\n  assert.equal(connectedBeforeBackgroundStartFinished, false);\n  const background = await backgroundStart;\n  assert.equal(background.running, true);\n  await gateway.hello;\n\n  const disconnect = await runCli([\"disconnect\", \"--config\", configPath], projectDir);\n  assert.equal(disconnect.code, 0, disconnect.stderr);\n  assert.equal(await foreground.exited, 0);\n});\n\nasync function waitForCondition(condition: () => boolean, timeoutMs = 2_000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  while (!condition()) {\n    if (Date.now() >= deadline) throw new Error(\"timed out waiting for test condition\");\n    await new Promise((resolve) => setTimeout(resolve, 25));\n  }\n}\n"]}

package/packages/gsd-cloud/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA8BA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkIhB;AA0GD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA+BtD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAgCA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIhB;AAmID,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiCtD"}

package/packages/gsd-cloud/dist/cli.js

@@ -13,7 +13,8 @@ import { clearCloudConfig, exchangePairingCode, redactedCloudStatus, saveCloudCo
 import { runDeviceFlow } from "./device-flow.js";
 import { CloudRuntime } from "./cloud-runtime.js";
 import { selectExecutor } from "./executors/index.js";
-import { backgroundRuntimeStatus, clearRuntimeState, startBackgroundRuntime, stopBackgroundRuntime, writeRuntimeState, } from "./runtime-process.js";
+import { acquireRuntimeStartLock, backgroundRuntimeStatus, clearRuntimeState, startBackgroundRuntime, stopBackgroundRuntime, writeRuntimeState, } from "./runtime-process.js";
+import { clearRuntimeTelemetry, readRuntimeTelemetry, RuntimeTelemetryStore } from "./runtime-telemetry.js";
 export async function handleCloudCommand(argv, opts) {
     if (argv[0] === "--help" || argv[0] === "-h") {
         process.stdout.write(formatUsage(opts.binaryName));
@@ -44,15 +45,24 @@ export async function handleCloudCommand(argv, opts) {
             ...redactedCloudStatus(config),
             projects: config.projects.scan_roots,
             background: backgroundRuntimeStatus(configPath),
+            telemetry: readRuntimeTelemetry(configPath),
         }, null, 2)}\n`);
         return;
     }
     if (command === "disconnect") {
         await stopBackgroundRuntime(configPath);
         clearCloudConfig(configPath);
+        clearRuntimeTelemetry(configPath);
         process.stdout.write(`${opts.binaryName}: background runtime stopped and cloud credentials removed.\n`);
         return;
     }
+    if (command === "stop") {
+        const stopped = await stopBackgroundRuntime(configPath);
+        process.stdout.write(stopped
+            ? `${opts.binaryName}: background runtime stopped.\n`
+            : `${opts.binaryName}: background runtime is not running.\n`);
+        return;
+    }
     if (command === "login") {
         if (!values.gateway) {
             throw new Error("login requires --gateway");
@@ -74,10 +84,7 @@ export async function handleCloudCommand(argv, opts) {
         }, projectDirs);
         process.stdout.write(`${opts.binaryName}: cloud runtime ${runtimeId} paired — connecting...\n`);
         if (values.foreground) {
-            await stopBackgroundRuntime(configPath);
-            await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {
-                registerConfigPath: configPath,
-            });
+            await runForegroundCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs);
             return;
         }
         await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);
@@ -111,10 +118,7 @@ export async function handleCloudCommand(argv, opts) {
         const projectDirs = selectedProjectDirs(config.projects.scan_roots);
         config = saveCloudConfig(configPath, config.cloud, projectDirs);
         if (values.foreground) {
-            await stopBackgroundRuntime(configPath);
-            await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {
-                registerConfigPath: configPath,
-            });
+            await runForegroundCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs);
             return;
         }
         await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);
@@ -126,7 +130,7 @@ export async function handleCloudCommand(argv, opts) {
             throw new Error("cloud runtime is not paired; run `login` first");
         }
         const projectDirs = selectedProjectDirs(config.projects.scan_roots);
-        await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {
+        await runCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs, {
             onConnected: () => {
                 process.send?.({ type: "ready" });
             },
@@ -135,12 +139,25 @@ export async function handleCloudCommand(argv, opts) {
     }
     throw new Error(`Unknown cloud runtime command: ${command}`);
 }
+async function runForegroundCloudRuntime(config, configPath, binaryName, verbose, projectDirs) {
+    const releaseStartLock = await acquireRuntimeStartLock(configPath);
+    try {
+        await stopBackgroundRuntime(configPath);
+        await runCloudRuntime(config, configPath, binaryName, verbose, projectDirs, {
+            registerConfigPath: configPath,
+            onConnected: releaseStartLock,
+        });
+    }
+    finally {
+        releaseStartLock();
+    }
+}
 /**
  * Start the WS relay and block until the process is signalled. This is the whole
  * "daemon" for the standalone agent: one CloudRuntime + one Executor, no Discord,
  * no scanner, no session-manager class.
  */
-async function runCloudRuntime(config, binaryName, verbose, projectDirs, opts = {}) {
+async function runCloudRuntime(config, configPath, binaryName, verbose, projectDirs, opts = {}) {
     if (!config.cloud)
         throw new Error("cloud runtime is not configured");
     if (config.cloud.enabled === false) {
@@ -152,7 +169,12 @@ async function runCloudRuntime(config, binaryName, verbose, projectDirs, opts =
         verbose,
     });
     const executor = selectExecutor(logger, { projectDirs });
-    const runtime = new CloudRuntime(config.cloud, executor, logger);
+    const telemetry = new RuntimeTelemetryStore(configPath, {
+        gatewayUrl: config.cloud.gateway_url,
+        runtimeId: config.cloud.runtime_id,
+        runtimeName: config.cloud.runtime_name,
+    });
+    const runtime = new CloudRuntime(config.cloud, executor, logger, telemetry);
     // A foreground session owns the runtime itself, so it records its own PID in
     // the shared state file. That lets a later `connect`/`disconnect` find and
     // stop it, just like a detached background runtime. Background `_run` children
@@ -236,6 +258,7 @@ export function formatUsage(binaryName) {
        ${binaryName} status [--config <path>]
        ${binaryName} pair --gateway <url> --code <code> [--runtime-name <name>] [--config <path>]
        ${binaryName} connect [--config <path>] [--verbose] [--foreground]
+       ${binaryName} stop [--config <path>]
        ${binaryName} disconnect [--config <path>]
 
 Commands:
@@ -245,6 +268,7 @@ Commands:
   status     Show current cloud runtime configuration and connection status.
   pair       Exchange a pairing code for a device token (headless/CI environments).
   connect    Start a background connection using saved credentials and projects.
+  stop       Stop the background runtime without removing saved credentials.
   disconnect Stop the background runtime and remove local cloud credentials.
 
 Options: