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

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

@@ -0,0 +1,248 @@
+// 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 { 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";
+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 () => {
+    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();
+    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 {
+        await runCli(["disconnect", "--config", configPath], projectDir).catch(() => undefined);
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test("login returns after approval and keeps the selected project connected", async () => {
+    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 {
+        await runCli(["disconnect", "--config", configPath], projectDir).catch(() => undefined);
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test("advertised project paths are canonicalized through symlinks", async () => {
+    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();
+    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);
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test("a foreground runtime registers its PID so disconnect can stop it", async () => {
+    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);
+    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 {
+        foreground.child.kill("SIGKILL");
+        await gateway.close();
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+//# 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 { 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"]}

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":"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"}

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

@@ -5,12 +5,15 @@
 // 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 { backgroundRuntimeStatus, clearRuntimeState, startBackgroundRuntime, stopBackgroundRuntime, writeRuntimeState, } from "./runtime-process.js";
 export async function handleCloudCommand(argv, opts) {
     if (argv[0] === "--help" || argv[0] === "-h") {
         process.stdout.write(formatUsage(opts.binaryName));
@@ -25,6 +28,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 +39,18 @@ 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),
+        }, null, 2)}\n`);
         return;
     }
     if (command === "disconnect") {
+        await stopBackgroundRuntime(configPath);
         clearCloudConfig(configPath);
-        process.stdout.write(`${opts.binaryName}: cloud runtime disconnected locally.\n`);
+        process.stdout.write(`${opts.binaryName}: background runtime stopped and cloud credentials removed.\n`);
         return;
     }
     if (command === "login") {
@@ -54,15 +64,23 @@ 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 stopBackgroundRuntime(configPath);
+            await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {
+                registerConfigPath: configPath,
+            });
+            return;
+        }
+        await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);
         return;
     }
     if (command === "pair") {
@@ -86,11 +104,33 @@ 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 stopBackgroundRuntime(configPath);
+            await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {
+                registerConfigPath: configPath,
+            });
+            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, opts.binaryName, values.verbose, projectDirs, {
+            onConnected: () => {
+                process.send?.({ type: "ready" });
+            },
+        });
         return;
     }
     throw new Error(`Unknown cloud runtime command: ${command}`);
@@ -100,7 +140,7 @@ export async function handleCloudCommand(argv, opts) {
  * "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, binaryName, verbose, projectDirs, opts = {}) {
     if (!config.cloud)
         throw new Error("cloud runtime is not configured");
     if (config.cloud.enabled === false) {
@@ -111,12 +151,29 @@ async function runCloudRuntime(config, binaryName, verbose) {
         level: config.log.level,
         verbose,
     });
-    const executor = selectExecutor(logger);
+    const executor = selectExecutor(logger, { projectDirs });
     const runtime = new CloudRuntime(config.cloud, executor, logger);
-    await runtime.start();
+    // 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 +183,69 @@ 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} 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.
+  disconnect Stop the background runtime and remove local cloud credentials.
 
 Options:
   --config <path>        Path to YAML config file (default: ~/.gsd/daemon.yaml)
@@ -148,6 +253,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:

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

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Standalone gsd-cloud CLI — login / status / connect / disconnect.\n//\n// Wires device-flow + CloudRuntime + a selected Executor adapter DIRECTLY. It has\n// no dependency on any Daemon or Orchestrator class; the only cloud behaviour is\n// the WS relay client driving the local GSD runtime through the Executor seam.\n\nimport { parseArgs } from \"node:util\";\nimport { resolveConfigPath, loadConfig } from \"./config.js\";\nimport { Logger } from \"./logger.js\";\nimport {\n  clearCloudConfig,\n  exchangePairingCode,\n  redactedCloudStatus,\n  saveCloudConfig,\n} from \"./cloud-config.js\";\nimport { runDeviceFlow } from \"./device-flow.js\";\nimport { CloudRuntime } from \"./cloud-runtime.js\";\nimport { selectExecutor } from \"./executors/index.js\";\nimport type { DaemonConfig } from \"./types.js\";\n\nexport async function handleCloudCommand(argv: string[], opts: {\n  binaryName: string;\n}): Promise<void> {\n  if (argv[0] === \"--help\" || argv[0] === \"-h\") {\n    process.stdout.write(formatUsage(opts.binaryName));\n    process.exit(0);\n  }\n\n  const command = argv[0];\n  const { values } = parseArgs({\n    args: argv.slice(1),\n    options: {\n      config: { type: \"string\", short: \"c\" },\n      gateway: { type: \"string\" },\n      code: { type: \"string\" },\n      \"runtime-name\": { type: \"string\" },\n      verbose: { type: \"boolean\", short: \"v\", default: false },\n      help: { type: \"boolean\", short: \"h\", default: false },\n    },\n    strict: true,\n  });\n\n  if (values.help || !command) {\n    process.stdout.write(formatUsage(opts.binaryName));\n    process.exit(0);\n  }\n\n  const configPath = resolveConfigPath(values.config);\n\n  if (command === \"status\") {\n    process.stdout.write(`${JSON.stringify(redactedCloudStatus(loadConfig(configPath)), null, 2)}\\n`);\n    return;\n  }\n\n  if (command === \"disconnect\") {\n    clearCloudConfig(configPath);\n    process.stdout.write(`${opts.binaryName}: cloud runtime disconnected locally.\\n`);\n    return;\n  }\n\n  if (command === \"login\") {\n    if (!values.gateway) {\n      throw new Error(\"login requires --gateway\");\n    }\n    const runtimeName = values[\"runtime-name\"];\n    const { deviceToken, runtimeId, gatewayUrl } = await runDeviceFlow({\n      gatewayUrl: values.gateway,\n      configPath,\n      runtimeName,\n      binaryName: opts.binaryName,\n    });\n    const config = saveCloudConfig(configPath, {\n      gateway_url: gatewayUrl,\n      device_token: deviceToken,\n      runtime_id: runtimeId,\n      ...(runtimeName ? { runtime_name: runtimeName } : {}),\n      enabled: true,\n    });\n    process.stdout.write(`${opts.binaryName}: cloud runtime ${runtimeId} paired — connecting...\\n`);\n    await runCloudRuntime(config, opts.binaryName, values.verbose);\n    return;\n  }\n\n  if (command === \"pair\") {\n    if (!values.gateway || !values.code) {\n      throw new Error(\"pair requires --gateway and --code\");\n    }\n    const runtimeName = values[\"runtime-name\"];\n    const result = await exchangePairingCode({\n      gatewayUrl: values.gateway,\n      code: values.code,\n      runtimeName,\n    });\n    saveCloudConfig(configPath, {\n      gateway_url: values.gateway,\n      device_token: result.deviceToken,\n      runtime_id: result.runtimeId,\n      ...(runtimeName ? { runtime_name: runtimeName } : {}),\n      enabled: true,\n    });\n    process.stdout.write(`${opts.binaryName}: paired cloud runtime ${result.runtimeId}.\\n`);\n    return;\n  }\n\n  if (command === \"connect\") {\n    const config = loadConfig(configPath);\n    if (!config.cloud?.device_token || !config.cloud.runtime_id) {\n      throw new Error(\"cloud runtime is not paired; run `login` first\");\n    }\n    await runCloudRuntime(config, opts.binaryName, values.verbose);\n    return;\n  }\n\n  throw new Error(`Unknown cloud runtime command: ${command}`);\n}\n\n/**\n * Start the WS relay and block until the process is signalled. This is the whole\n * \"daemon\" for the standalone agent: one CloudRuntime + one Executor, no Discord,\n * no scanner, no session-manager class.\n */\nasync function runCloudRuntime(config: DaemonConfig, binaryName: string, verbose: boolean): Promise<void> {\n  if (!config.cloud) throw new Error(\"cloud runtime is not configured\");\n  if (config.cloud.enabled === false) {\n    throw new Error(\"cloud runtime is disabled in config; set cloud.enabled to true to connect\");\n  }\n  const logger = new Logger({\n    filePath: config.log.file,\n    level: config.log.level,\n    verbose,\n  });\n  const executor = selectExecutor(logger);\n  const runtime = new CloudRuntime(config.cloud, executor, logger);\n  await runtime.start();\n  process.stdout.write(`${binaryName}: connected to ${config.cloud.gateway_url}. Press Ctrl+C to stop.\\n`);\n\n  await new Promise<void>((resolve) => {\n    const shutdown = () => {\n      runtime.stop();\n      void Promise.resolve(executor.close?.()).finally(() => {\n        void logger.close().finally(() => resolve());\n      });\n    };\n    process.once(\"SIGINT\", shutdown);\n    process.once(\"SIGTERM\", shutdown);\n  });\n}\n\nexport function formatUsage(binaryName: string): string {\n  return `Usage: ${binaryName} login [--gateway <url>] [--runtime-name <name>] [--config <path>]\n       ${binaryName} status [--config <path>]\n       ${binaryName} pair --gateway <url> --code <code> [--runtime-name <name>] [--config <path>]\n       ${binaryName} connect [--config <path>] [--verbose]\n       ${binaryName} disconnect [--config <path>]\n\nCommands:\n  login      (Recommended) Browser-based pairing — opens an approval URL in the\n             terminal, polls for authorization, then auto-connects. Defaults to\n             the public GSD Cloud gateway.\n  status     Show current cloud runtime configuration and connection status.\n  pair       Exchange a pairing code for a device token (headless/CI environments).\n  connect    Connect using a previously paired device token.\n  disconnect Remove cloud runtime configuration from the local config file.\n\nOptions:\n  --config <path>        Path to YAML config file (default: ~/.gsd/daemon.yaml)\n  --gateway <url>        Cloud gateway URL (login defaults to https://cloud.opengsd.net)\n  --code <code>          Pairing code from the gateway (pair only)\n  --runtime-name <name>  Friendly name for this local GSD runtime\n  --verbose              Print log entries to stderr in addition to the log file\n  --help                 Show this help message and exit\n\nEnvironment:\n  GSD_CLOUD_PROJECTS     Path-delimiter separated project dirs to advertise\n                         (default: current working directory)\n  GSD_CLI_PATH           Path to the gsd binary (default: gsd on PATH)\n  GSD_CLOUD_EXECUTOR     Backend adapter: gsd-pi (default), codex, claude\n`;\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Standalone gsd-cloud CLI — login / status / connect / disconnect.\n//\n// Wires device-flow + CloudRuntime + a selected Executor adapter DIRECTLY. It has\n// no dependency on any Daemon or Orchestrator class; the only cloud behaviour is\n// the WS relay client driving the local GSD runtime through the Executor seam.\n\nimport { parseArgs } from \"node:util\";\nimport { realpathSync } from \"node:fs\";\nimport { delimiter, resolve } from \"node:path\";\nimport { resolveConfigPath, loadConfig } from \"./config.js\";\nimport { Logger } from \"./logger.js\";\nimport {\n  clearCloudConfig,\n  exchangePairingCode,\n  redactedCloudStatus,\n  saveCloudConfig,\n} from \"./cloud-config.js\";\nimport { runDeviceFlow } from \"./device-flow.js\";\nimport { CloudRuntime } from \"./cloud-runtime.js\";\nimport { selectExecutor } from \"./executors/index.js\";\nimport {\n  backgroundRuntimeStatus,\n  clearRuntimeState,\n  startBackgroundRuntime,\n  stopBackgroundRuntime,\n  writeRuntimeState,\n} from \"./runtime-process.js\";\nimport type { DaemonConfig } from \"./types.js\";\n\nexport async function handleCloudCommand(argv: string[], opts: {\n  binaryName: string;\n}): Promise<void> {\n  if (argv[0] === \"--help\" || argv[0] === \"-h\") {\n    process.stdout.write(formatUsage(opts.binaryName));\n    process.exit(0);\n  }\n\n  const command = argv[0];\n  const { values } = parseArgs({\n    args: argv.slice(1),\n    options: {\n      config: { type: \"string\", short: \"c\" },\n      gateway: { type: \"string\" },\n      code: { type: \"string\" },\n      \"runtime-name\": { type: \"string\" },\n      verbose: { type: \"boolean\", short: \"v\", default: false },\n      foreground: { type: \"boolean\", default: false },\n      help: { type: \"boolean\", short: \"h\", default: false },\n    },\n    strict: true,\n  });\n\n  if (values.help || !command) {\n    process.stdout.write(formatUsage(opts.binaryName));\n    process.exit(0);\n  }\n\n  const configPath = resolveConfigPath(values.config);\n\n  if (command === \"status\") {\n    const config = loadConfig(configPath);\n    process.stdout.write(`${JSON.stringify({\n      ...redactedCloudStatus(config),\n      projects: config.projects.scan_roots,\n      background: backgroundRuntimeStatus(configPath),\n    }, null, 2)}\\n`);\n    return;\n  }\n\n  if (command === \"disconnect\") {\n    await stopBackgroundRuntime(configPath);\n    clearCloudConfig(configPath);\n    process.stdout.write(`${opts.binaryName}: background runtime stopped and cloud credentials removed.\\n`);\n    return;\n  }\n\n  if (command === \"login\") {\n    if (!values.gateway) {\n      throw new Error(\"login requires --gateway\");\n    }\n    const runtimeName = values[\"runtime-name\"];\n    const { deviceToken, runtimeId, gatewayUrl } = await runDeviceFlow({\n      gatewayUrl: values.gateway,\n      configPath,\n      runtimeName,\n      binaryName: opts.binaryName,\n    });\n    const projectDirs = selectedProjectDirs([]);\n    const config = saveCloudConfig(configPath, {\n      gateway_url: gatewayUrl,\n      device_token: deviceToken,\n      runtime_id: runtimeId,\n      ...(runtimeName ? { runtime_name: runtimeName } : {}),\n      enabled: true,\n    }, projectDirs);\n    process.stdout.write(`${opts.binaryName}: cloud runtime ${runtimeId} paired — connecting...\\n`);\n    if (values.foreground) {\n      await stopBackgroundRuntime(configPath);\n      await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {\n        registerConfigPath: configPath,\n      });\n      return;\n    }\n    await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);\n    return;\n  }\n\n  if (command === \"pair\") {\n    if (!values.gateway || !values.code) {\n      throw new Error(\"pair requires --gateway and --code\");\n    }\n    const runtimeName = values[\"runtime-name\"];\n    const result = await exchangePairingCode({\n      gatewayUrl: values.gateway,\n      code: values.code,\n      runtimeName,\n    });\n    saveCloudConfig(configPath, {\n      gateway_url: values.gateway,\n      device_token: result.deviceToken,\n      runtime_id: result.runtimeId,\n      ...(runtimeName ? { runtime_name: runtimeName } : {}),\n      enabled: true,\n    });\n    process.stdout.write(`${opts.binaryName}: paired cloud runtime ${result.runtimeId}.\\n`);\n    return;\n  }\n\n  if (command === \"connect\") {\n    let config = loadConfig(configPath);\n    if (!config.cloud?.device_token || !config.cloud.runtime_id) {\n      throw new Error(\"cloud runtime is not paired; run `login` first\");\n    }\n    const projectDirs = selectedProjectDirs(config.projects.scan_roots);\n    config = saveCloudConfig(configPath, config.cloud, projectDirs);\n    if (values.foreground) {\n      await stopBackgroundRuntime(configPath);\n      await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {\n        registerConfigPath: configPath,\n      });\n      return;\n    }\n    await startAndReportBackgroundRuntime(configPath, projectDirs, opts.binaryName, values.verbose);\n    return;\n  }\n\n  if (command === \"_run\") {\n    const config = loadConfig(configPath);\n    if (!config.cloud?.device_token || !config.cloud.runtime_id) {\n      throw new Error(\"cloud runtime is not paired; run `login` first\");\n    }\n    const projectDirs = selectedProjectDirs(config.projects.scan_roots);\n    await runCloudRuntime(config, opts.binaryName, values.verbose, projectDirs, {\n      onConnected: () => {\n        process.send?.({ type: \"ready\" });\n      },\n    });\n    return;\n  }\n\n  throw new Error(`Unknown cloud runtime command: ${command}`);\n}\n\n/**\n * Start the WS relay and block until the process is signalled. This is the whole\n * \"daemon\" for the standalone agent: one CloudRuntime + one Executor, no Discord,\n * no scanner, no session-manager class.\n */\nasync function runCloudRuntime(\n  config: DaemonConfig,\n  binaryName: string,\n  verbose: boolean,\n  projectDirs: string[],\n  opts: { onConnected?: () => void; registerConfigPath?: string } = {},\n): Promise<void> {\n  if (!config.cloud) throw new Error(\"cloud runtime is not configured\");\n  if (config.cloud.enabled === false) {\n    throw new Error(\"cloud runtime is disabled in config; set cloud.enabled to true to connect\");\n  }\n  const logger = new Logger({\n    filePath: config.log.file,\n    level: config.log.level,\n    verbose,\n  });\n  const executor = selectExecutor(logger, { projectDirs });\n  const runtime = new CloudRuntime(config.cloud, executor, logger);\n  // A foreground session owns the runtime itself, so it records its own PID in\n  // the shared state file. That lets a later `connect`/`disconnect` find and\n  // stop it, just like a detached background runtime. Background `_run` children\n  // do not register here; their launcher records the child PID instead.\n  if (opts.registerConfigPath) {\n    writeRuntimeState(opts.registerConfigPath, process.pid, projectDirs);\n  }\n  try {\n    await runtime.start();\n  } catch (error) {\n    if (opts.registerConfigPath) clearRuntimeState(opts.registerConfigPath);\n    throw error;\n  }\n  opts.onConnected?.();\n  process.stdout.write(`${binaryName}: connected to ${config.cloud.gateway_url}. Press Ctrl+C to stop.\\n`);\n\n  await new Promise<void>((resolve) => {\n    const shutdown = () => {\n      if (opts.registerConfigPath) clearRuntimeState(opts.registerConfigPath);\n      runtime.stop();\n      void Promise.resolve(executor.close?.()).finally(() => {\n        void logger.close().finally(() => resolve());\n      });\n    };\n    process.once(\"SIGINT\", shutdown);\n    process.once(\"SIGTERM\", shutdown);\n  });\n}\n\nasync function startAndReportBackgroundRuntime(\n  configPath: string,\n  projectDirs: string[],\n  binaryName: string,\n  verbose = false,\n): Promise<void> {\n  const binaryPath = process.argv[1];\n  if (!binaryPath) throw new Error(\"could not resolve the gsd-cloud executable path\");\n  const status = await startBackgroundRuntime({ binaryPath, configPath, projectDirs, verbose });\n  process.stdout.write(`${binaryName}: connected in the background (PID ${status.pid}).\\n`);\n  for (const project of projectDirs) process.stdout.write(`${binaryName}: project ${project}\\n`);\n  process.stdout.write(`${binaryName}: logs ${status.log_file}\\n`);\n}\n\nfunction selectedProjectDirs(savedProjectDirs: string[]): string[] {\n  const configured = process.env[\"GSD_CLOUD_PROJECTS\"];\n  if (configured?.trim()) {\n    const configuredPaths = uniqueResolvedPaths(configured.split(delimiter));\n    if (configuredPaths.length > 0) return configuredPaths;\n  }\n  if (savedProjectDirs.length > 0) {\n    const savedPaths = uniqueResolvedPaths(savedProjectDirs);\n    if (savedPaths.length > 0) return savedPaths;\n  }\n  return [canonicalizePath(process.cwd())];\n}\n\nfunction uniqueResolvedPaths(paths: string[]): string[] {\n  const resolved = paths\n    .map((path) => path.trim())\n    .filter(Boolean)\n    .map((path) => canonicalizePath(path));\n  return [...new Set(resolved)];\n}\n\n/**\n * Resolve a project path to its canonical, symlink-free absolute form. The\n * executor advertises project paths via `resolve()` alone, so canonicalizing\n * here keeps the saved `scan_roots` and the advertised hello paths identical to\n * the real directory (e.g. when the cwd or GSD_CLOUD_PROJECTS points through a\n * symlink). Falls back to the plain resolved path when the target does not yet\n * exist on disk.\n */\nfunction canonicalizePath(path: string): string {\n  const resolved = resolve(path);\n  try {\n    return realpathSync(resolved);\n  } catch {\n    return resolved;\n  }\n}\n\nexport function formatUsage(binaryName: string): string {\n  return `Usage: ${binaryName} login [--gateway <url>] [--runtime-name <name>] [--config <path>] [--foreground]\n       ${binaryName} status [--config <path>]\n       ${binaryName} pair --gateway <url> --code <code> [--runtime-name <name>] [--config <path>]\n       ${binaryName} connect [--config <path>] [--verbose] [--foreground]\n       ${binaryName} disconnect [--config <path>]\n\nCommands:\n  login      (Recommended) Browser-based pairing — opens an approval URL, then\n             connects the current project in the background. Defaults to the\n             public GSD Cloud gateway.\n  status     Show current cloud runtime configuration and connection status.\n  pair       Exchange a pairing code for a device token (headless/CI environments).\n  connect    Start a background connection using saved credentials and projects.\n  disconnect Stop the background runtime and remove local cloud credentials.\n\nOptions:\n  --config <path>        Path to YAML config file (default: ~/.gsd/daemon.yaml)\n  --gateway <url>        Cloud gateway URL (login defaults to https://cloud.opengsd.net)\n  --code <code>          Pairing code from the gateway (pair only)\n  --runtime-name <name>  Friendly name for this local GSD runtime\n  --verbose              Print log entries to stderr in addition to the log file\n  --foreground           Keep login/connect attached to this terminal (debugging)\n  --help                 Show this help message and exit\n\nEnvironment:\n  GSD_CLOUD_PROJECTS     Path-delimiter separated project dirs to advertise\n                         (default: current working directory)\n  GSD_CLI_PATH           Path to the gsd binary (default: gsd on PATH)\n  GSD_CLOUD_EXECUTOR     Backend adapter: gsd-pi (default), codex, claude\n`;\n}\n"]}

package/packages/gsd-cloud/dist/cloud-config.d.ts

@@ -10,7 +10,7 @@ export declare function exchangePairingCode(params: {
     runtimeName?: string;
 }): Promise<PairingExchangeResult>;
 export declare function parseCloudGatewayUrl(value: string): URL;
-export declare function saveCloudConfig(configPath: string, nextCloud: NonNullable<DaemonConfig["cloud"]>): DaemonConfig;
+export declare function saveCloudConfig(configPath: string, nextCloud: NonNullable<DaemonConfig["cloud"]>, projectDirs?: string[]): DaemonConfig;
 export declare function clearCloudConfig(configPath: string): DaemonConfig;
 export declare function redactedCloudStatus(config: DaemonConfig): Record<string, unknown>;
 export declare function validateGatewayNetworkTarget(url: URL): void;

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

@@ -1 +1 @@
-{"version":3,"file":"cloud-config.d.ts","sourceRoot":"","sources":["../src/cloud-config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAUjC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CA2BvD;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY,CAgB/G;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAWjE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWjF;AAeD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAK3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAkC5D;AAiCD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsClC"}
+{"version":3,"file":"cloud-config.d.ts","sourceRoot":"","sources":["../src/cloud-config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAUjC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CA2BvD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,YAAY,CAsBd;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAWjE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWjF;AAeD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAK3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAkC5D;AAiCD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsClC"}