@opengsd/gsd-pi 1.9.0-dev.e10b60d4 → 1.10.0-dev.a5e42e99

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

@@ -0,0 +1,325 @@
+// Project/App: Open GSD
+// File Purpose: Acceptance coverage for the detached gsd-cloud runtime lifecycle.
+import { spawn } from "node:child_process";
+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";
+import { fileURLToPath } from "node:url";
+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 = {}) {
+    return new Promise((resolveResult, reject) => {
+        const child = spawn(process.execPath, [cliPath, ...args], {
+            cwd,
+            env: { ...process.env, GSD_CLOUD_PROJECTS: undefined, ...extraEnv },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => { stdout += chunk; });
+        child.stderr.on("data", (chunk) => { stderr += chunk; });
+        const timeout = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error(`gsd-cloud did not return within ${timeoutMs}ms`));
+        }, timeoutMs);
+        child.once("error", (error) => {
+            clearTimeout(timeout);
+            reject(error);
+        });
+        child.once("exit", (code) => {
+            clearTimeout(timeout);
+            resolveResult({ code, stdout, stderr });
+        });
+    });
+}
+// Spawn a long-lived CLI process (e.g. `--foreground`) without waiting for exit,
+// so the test can inspect its state and then stop it.
+function spawnForegroundCli(args, cwd) {
+    const child = spawn(process.execPath, [cliPath, ...args], {
+        cwd,
+        env: { ...process.env, GSD_CLOUD_PROJECTS: undefined },
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    const exited = new Promise((resolveExit) => {
+        child.once("exit", (code) => resolveExit(code));
+    });
+    return { child, exited };
+}
+async function createTestGateway(deviceFlow = false) {
+    let baseUrl = "";
+    const server = createServer((req, res) => {
+        if (!deviceFlow) {
+            res.writeHead(404).end();
+            return;
+        }
+        res.setHeader("content-type", "application/json");
+        if (req.url === "/api/device/code") {
+            res.end(JSON.stringify({
+                userCode: "TEST-CODE",
+                deviceCode: "test-device",
+                verificationUriComplete: `${baseUrl}/approve-device?code=TEST-CODE`,
+                expiresIn: 30,
+            }));
+            return;
+        }
+        if (req.url === "/api/device/token") {
+            res.end(JSON.stringify({
+                status: "approved",
+                token: "test",
+                runtimeId: "fixture-runtime",
+                gateway_url: baseUrl,
+            }));
+            return;
+        }
+        res.writeHead(404).end();
+    });
+    const wss = new WebSocketServer({ server });
+    await new Promise((resolveListen, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", resolveListen);
+    });
+    const address = server.address();
+    assert.ok(address && typeof address === "object");
+    baseUrl = `http://127.0.0.1:${address.port}`;
+    let helloTimeout;
+    const hello = new Promise((resolveHello, reject) => {
+        helloTimeout = setTimeout(() => reject(new Error("background runtime did not advertise its project")), 8_000);
+        wss.once("connection", (socket) => {
+            socket.once("message", (data) => {
+                clearTimeout(helloTimeout);
+                resolveHello(JSON.parse(data.toString("utf8")));
+            });
+        });
+    });
+    return {
+        baseUrl,
+        hello,
+        close: async () => {
+            clearTimeout(helloTimeout);
+            for (const client of wss.clients)
+                client.terminate();
+            await new Promise((resolveClose) => wss.close(() => server.close(() => resolveClose())));
+        },
+    };
+}
+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,
+    });
+    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 (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);
+    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 (t) => {
+    const root = realpathSync(mkdtempSync(join(tmpdir(), "gsd-cloud-symlink-")));
+    const realProject = join(root, "real-project");
+    mkdirSync(join(realProject, ".gsd"), { recursive: true });
+    const linkProject = join(root, "link-project");
+    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,
+    });
+    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("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,
+        device_token: "test",
+        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);
+    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

@@ -0,0 +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 { 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":"AAqBA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FhB;AAkCD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA8BtD"}
+{"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

@@ -5,12 +5,16 @@
 // no dependency on any Daemon or Orchestrator class; the only cloud behaviour is
 // the WS relay client driving the local GSD runtime through the Executor seam.
 import { parseArgs } from "node:util";
+import { realpathSync } from "node:fs";
+import { delimiter, resolve } from "node:path";
 import { resolveConfigPath, loadConfig } from "./config.js";
 import { Logger } from "./logger.js";
 import { clearCloudConfig, exchangePairingCode, redactedCloudStatus, saveCloudConfig, } from "./cloud-config.js";
 import { runDeviceFlow } from "./device-flow.js";
 import { CloudRuntime } from "./cloud-runtime.js";
 import { selectExecutor } from "./executors/index.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));
@@ -25,6 +29,7 @@ export async function handleCloudCommand(argv, opts) {
             code: { type: "string" },
             "runtime-name": { type: "string" },
             verbose: { type: "boolean", short: "v", default: false },
+            foreground: { type: "boolean", default: false },
             help: { type: "boolean", short: "h", default: false },
         },
         strict: true,
@@ -35,12 +40,27 @@ export async function handleCloudCommand(argv, opts) {
     }
     const configPath = resolveConfigPath(values.config);
     if (command === "status") {
-        process.stdout.write(`${JSON.stringify(redactedCloudStatus(loadConfig(configPath)), null, 2)}\n`);
+        const config = loadConfig(configPath);
+        process.stdout.write(`${JSON.stringify({
+            ...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);
-        process.stdout.write(`${opts.binaryName}: cloud runtime disconnected locally.\n`);
+        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") {
@@ -54,15 +74,20 @@ export async function handleCloudCommand(argv, opts) {
             runtimeName,
             binaryName: opts.binaryName,
         });
+        const projectDirs = selectedProjectDirs([]);
         const config = saveCloudConfig(configPath, {
             gateway_url: gatewayUrl,
             device_token: deviceToken,
             runtime_id: runtimeId,
             ...(runtimeName ? { runtime_name: runtimeName } : {}),
             enabled: true,
-        });
+        }, projectDirs);
         process.stdout.write(`${opts.binaryName}: cloud runtime ${runtimeId} paired — connecting...\n`);
-        await runCloudRuntime(config, opts.binaryName, values.verbose);
+        if (values.foreground) {
+            await runForegroundCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs);
+            return;
+        }
+        await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);
         return;
     }
     if (command === "pair") {
@@ -86,21 +111,53 @@ export async function handleCloudCommand(argv, opts) {
         return;
     }
     if (command === "connect") {
+        let config = loadConfig(configPath);
+        if (!config.cloud?.device_token || !config.cloud.runtime_id) {
+            throw new Error("cloud runtime is not paired; run `login` first");
+        }
+        const projectDirs = selectedProjectDirs(config.projects.scan_roots);
+        config = saveCloudConfig(configPath, config.cloud, projectDirs);
+        if (values.foreground) {
+            await runForegroundCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs);
+            return;
+        }
+        await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);
+        return;
+    }
+    if (command === "_run") {
         const config = loadConfig(configPath);
         if (!config.cloud?.device_token || !config.cloud.runtime_id) {
             throw new Error("cloud runtime is not paired; run `login` first");
         }
-        await runCloudRuntime(config, opts.binaryName, values.verbose);
+        const projectDirs = selectedProjectDirs(config.projects.scan_roots);
+        await runCloudRuntime(config, configPath, opts.binaryName, values.verbose, projectDirs, {
+            onConnected: () => {
+                process.send?.({ type: "ready" });
+            },
+        });
         return;
     }
     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) {
+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) {
@@ -111,12 +168,34 @@ async function runCloudRuntime(config, binaryName, verbose) {
         level: config.log.level,
         verbose,
     });
-    const executor = selectExecutor(logger);
-    const runtime = new CloudRuntime(config.cloud, executor, logger);
-    await runtime.start();
+    const executor = selectExecutor(logger, { projectDirs });
+    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
+    // do not register here; their launcher records the child PID instead.
+    if (opts.registerConfigPath) {
+        writeRuntimeState(opts.registerConfigPath, process.pid, projectDirs);
+    }
+    try {
+        await runtime.start();
+    }
+    catch (error) {
+        if (opts.registerConfigPath)
+            clearRuntimeState(opts.registerConfigPath);
+        throw error;
+    }
+    opts.onConnected?.();
     process.stdout.write(`${binaryName}: connected to ${config.cloud.gateway_url}. Press Ctrl+C to stop.\n`);
     await new Promise((resolve) => {
         const shutdown = () => {
+            if (opts.registerConfigPath)
+                clearRuntimeState(opts.registerConfigPath);
             runtime.stop();
             void Promise.resolve(executor.close?.()).finally(() => {
                 void logger.close().finally(() => resolve());
@@ -126,21 +205,71 @@ async function runCloudRuntime(config, binaryName, verbose) {
         process.once("SIGTERM", shutdown);
     });
 }
+async function startAndReportBackgroundRuntime(configPath, projectDirs, binaryName, verbose = false) {
+    const binaryPath = process.argv[1];
+    if (!binaryPath)
+        throw new Error("could not resolve the gsd-cloud executable path");
+    const status = await startBackgroundRuntime({ binaryPath, configPath, projectDirs, verbose });
+    process.stdout.write(`${binaryName}: connected in the background (PID ${status.pid}).\n`);
+    for (const project of projectDirs)
+        process.stdout.write(`${binaryName}: project ${project}\n`);
+    process.stdout.write(`${binaryName}: logs ${status.log_file}\n`);
+}
+function selectedProjectDirs(savedProjectDirs) {
+    const configured = process.env["GSD_CLOUD_PROJECTS"];
+    if (configured?.trim()) {
+        const configuredPaths = uniqueResolvedPaths(configured.split(delimiter));
+        if (configuredPaths.length > 0)
+            return configuredPaths;
+    }
+    if (savedProjectDirs.length > 0) {
+        const savedPaths = uniqueResolvedPaths(savedProjectDirs);
+        if (savedPaths.length > 0)
+            return savedPaths;
+    }
+    return [canonicalizePath(process.cwd())];
+}
+function uniqueResolvedPaths(paths) {
+    const resolved = paths
+        .map((path) => path.trim())
+        .filter(Boolean)
+        .map((path) => canonicalizePath(path));
+    return [...new Set(resolved)];
+}
+/**
+ * Resolve a project path to its canonical, symlink-free absolute form. The
+ * executor advertises project paths via `resolve()` alone, so canonicalizing
+ * here keeps the saved `scan_roots` and the advertised hello paths identical to
+ * the real directory (e.g. when the cwd or GSD_CLOUD_PROJECTS points through a
+ * symlink). Falls back to the plain resolved path when the target does not yet
+ * exist on disk.
+ */
+function canonicalizePath(path) {
+    const resolved = resolve(path);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
 export function formatUsage(binaryName) {
-    return `Usage: ${binaryName} login [--gateway <url>] [--runtime-name <name>] [--config <path>]
+    return `Usage: ${binaryName} login [--gateway <url>] [--runtime-name <name>] [--config <path>] [--foreground]
        ${binaryName} status [--config <path>]
        ${binaryName} pair --gateway <url> --code <code> [--runtime-name <name>] [--config <path>]
-       ${binaryName} connect [--config <path>] [--verbose]
+       ${binaryName} connect [--config <path>] [--verbose] [--foreground]
+       ${binaryName} stop [--config <path>]
        ${binaryName} disconnect [--config <path>]
 
 Commands:
-  login      (Recommended) Browser-based pairing — opens an approval URL in the
-             terminal, polls for authorization, then auto-connects. Defaults to
-             the public GSD Cloud gateway.
+  login      (Recommended) Browser-based pairing — opens an approval URL, then
+             connects the current project in the background. Defaults to the
+             public GSD Cloud gateway.
   status     Show current cloud runtime configuration and connection status.
   pair       Exchange a pairing code for a device token (headless/CI environments).
-  connect    Connect using a previously paired device token.
-  disconnect Remove cloud runtime configuration from the local config file.
+  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:
   --config <path>        Path to YAML config file (default: ~/.gsd/daemon.yaml)
@@ -148,6 +277,7 @@ Options:
   --code <code>          Pairing code from the gateway (pair only)
   --runtime-name <name>  Friendly name for this local GSD runtime
   --verbose              Print log entries to stderr in addition to the log file
+  --foreground           Keep login/connect attached to this terminal (debugging)
   --help                 Show this help message and exit
 
 Environment: