@opengsd/gsd-pi 1.8.1 → 1.9.0-dev.5c1a3ff2

package/packages/gsd-cloud/dist/executors/executor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A project advertised to the cloud gateway. Matches the shape the daemon's
+ * LocalToolExecutor.advertisedProjects() produced and that the gateway's
+ * `hello` message expects.
+ */
+export interface AdvertisedProject {
+    alias: string;
+    path: string;
+    repoIdentity: string;
+    remoteLabel?: string;
+    markers: string[];
+}
+/**
+ * The behaviour CloudRuntime requires from a local execution backend.
+ *
+ * - `execute` runs a single GSD workflow tool call and returns its result
+ *   (typically MCP `{ content: [...] }`), which CloudRuntime relays back to the
+ *   gateway verbatim as a `tool_result`.
+ * - `advertisedProjects` lists the projects this runtime is willing to act on;
+ *   CloudRuntime sends them in the `hello` message on every (re)connect.
+ */
+export interface Executor {
+    execute(toolName: string, rawArgs: Record<string, unknown>, projectAlias?: string): Promise<unknown>;
+    advertisedProjects(): Promise<AdvertisedProject[]>;
+    /** Optional teardown hook (e.g. kill a spawned child process). */
+    close?(): Promise<void> | void;
+}
+//# sourceMappingURL=executor.d.ts.map

package/packages/gsd-cloud/dist/executors/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/executors/executor.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEnD,kEAAkE;IAClE,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC"}

package/packages/gsd-cloud/dist/executors/executor.js

@@ -0,0 +1,11 @@
+// Project/App: Open GSD
+// File Purpose: The Executor seam — the contract CloudRuntime drives to run GSD
+//               work locally, decoupled from any particular backend engine.
+//
+// The daemon shipped one concrete implementation (LocalToolExecutor, which linked
+// @opengsd/mcp-server directly). This package instead depends only on this
+// INTERFACE, so the standalone agent stays free of the internal `@gsd/*` scope.
+// Concrete adapters (gsd-pi shell-out, and later codex / claude -p) live beside
+// this file and are chosen by selectExecutor().
+export {};
+//# sourceMappingURL=executor.js.map

package/packages/gsd-cloud/dist/executors/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/executors/executor.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,kFAAkF;AAClF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,gDAAgD","sourcesContent":["// Project/App: Open GSD\n// File Purpose: The Executor seam — the contract CloudRuntime drives to run GSD\n//               work locally, decoupled from any particular backend engine.\n//\n// The daemon shipped one concrete implementation (LocalToolExecutor, which linked\n// @opengsd/mcp-server directly). This package instead depends only on this\n// INTERFACE, so the standalone agent stays free of the internal `@gsd/*` scope.\n// Concrete adapters (gsd-pi shell-out, and later codex / claude -p) live beside\n// this file and are chosen by selectExecutor().\n\n/**\n * A project advertised to the cloud gateway. Matches the shape the daemon's\n * LocalToolExecutor.advertisedProjects() produced and that the gateway's\n * `hello` message expects.\n */\nexport interface AdvertisedProject {\n  alias: string;\n  path: string;\n  repoIdentity: string;\n  remoteLabel?: string;\n  markers: string[];\n}\n\n/**\n * The behaviour CloudRuntime requires from a local execution backend.\n *\n * - `execute` runs a single GSD workflow tool call and returns its result\n *   (typically MCP `{ content: [...] }`), which CloudRuntime relays back to the\n *   gateway verbatim as a `tool_result`.\n * - `advertisedProjects` lists the projects this runtime is willing to act on;\n *   CloudRuntime sends them in the `hello` message on every (re)connect.\n */\nexport interface Executor {\n  execute(toolName: string, rawArgs: Record<string, unknown>, projectAlias?: string): Promise<unknown>;\n  advertisedProjects(): Promise<AdvertisedProject[]>;\n\n  /** Optional teardown hook (e.g. kill a spawned child process). */\n  close?(): Promise<void> | void;\n}\n"]}

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.d.ts

@@ -0,0 +1,34 @@
+import type { Logger } from "../logger.js";
+import type { AdvertisedProject, Executor } from "./executor.js";
+export interface GsdPiExecutorOptions {
+    /** Path to the `gsd` binary. Defaults to GSD_CLI_PATH env, else `gsd` on PATH. */
+    gsdBinary?: string;
+    /**
+     * Explicit list of project directories to advertise. Defaults to
+     * GSD_CLOUD_PROJECTS (path-delimiter separated), else [cwd].
+     */
+    projectDirs?: string[];
+}
+export declare class GsdPiExecutor implements Executor {
+    private readonly logger;
+    private readonly gsdBinary;
+    private readonly projectDirs;
+    /** Lazily-created MCP clients, keyed by resolved absolute project path. */
+    private readonly projects;
+    /** In-flight project client creation, keyed by resolved absolute project path. */
+    private readonly projectInit;
+    constructor(logger: Logger, opts?: GsdPiExecutorOptions);
+    /**
+     * Advertised aliases are directory basenames, so two projects that share a
+     * folder name collide. Warn up front — such an alias can only be routed by an
+     * absolute `projectDir` (see resolveProjectPath).
+     */
+    private warnDuplicateAliases;
+    execute(toolName: string, rawArgs: Record<string, unknown>, projectAlias?: string): Promise<unknown>;
+    advertisedProjects(): Promise<AdvertisedProject[]>;
+    close(): Promise<void>;
+    private resolveProject;
+    private createProjectEntry;
+    private resolveProjectPath;
+}
+//# sourceMappingURL=gsd-pi-executor.d.ts.map

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd-pi-executor.d.ts","sourceRoot":"","sources":["../../src/executors/gsd-pi-executor.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGjE,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAQD,qBAAa,aAAc,YAAW,QAAQ;IAQhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;gBAE3C,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAQ5E;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAgBtB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAalD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKd,cAAc;YAcd,kBAAkB;IAiBhC,OAAO,CAAC,kBAAkB;CA0B3B"}

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.js

@@ -0,0 +1,179 @@
+// Project/App: Open GSD
+// File Purpose: Executor adapter that drives the installed `gsd` CLI headlessly.
+//
+// MECHANISM
+// ---------
+// The `gsd` CLI exposes every registered workflow tool over the Model Context
+// Protocol when started with `gsd --mode mcp` (see src/cli.ts in gsd-pi: mode
+// 'mcp' flips the active tool set to the full registry and serves MCP over
+// stdin/stdout). This adapter spawns ONE long-lived `gsd --mode mcp` child per
+// project and issues `tools/call` requests for each `execute()` — the same
+// gsd_* tool names the cloud gateway forwards (gsd_execute, gsd_status,
+// gsd_graph, gsd_cancel, gsd_query, …). No GSD package is linked; the only
+// contract is the MCP wire protocol.
+//
+// DOCUMENTED GAPS (see report):
+//  1. Project discovery. The daemon's LocalToolExecutor scanned filesystem roots
+//     via a dedicated ProjectScanner. This standalone package has no scanner, so
+//     it advertises an EXPLICIT project list from `GSD_CLOUD_PROJECTS` (a
+//     path-list separated by the OS path delimiter) or, if unset, the current
+//     working directory. Each advertised project's `repoIdentity` is computed
+//     exactly as the daemon did (sha256 of the git origin remote, else
+//     basename:path), so gateway-side identity matching is preserved.
+//  2. One MCP server per project. `gsd --mode mcp` is project-scoped (it resolves
+//     the GSD root from its cwd). A `tool_call` carrying a `projectAlias` is
+//     routed to that project's dedicated child; the `projectDir` arg the daemon
+//     injected is not needed because cwd already scopes the server. Tool args are
+//     forwarded verbatim otherwise.
+import { createHash } from "node:crypto";
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { basename, delimiter, resolve } from "node:path";
+import { McpStdioClient } from "./mcp-stdio-client.js";
+export class GsdPiExecutor {
+    logger;
+    gsdBinary;
+    projectDirs;
+    /** Lazily-created MCP clients, keyed by resolved absolute project path. */
+    projects = new Map();
+    /** In-flight project client creation, keyed by resolved absolute project path. */
+    projectInit = new Map();
+    constructor(logger, opts = {}) {
+        this.logger = logger;
+        this.gsdBinary = opts.gsdBinary
+            ?? process.env["GSD_CLI_PATH"]
+            ?? "gsd";
+        this.projectDirs = (opts.projectDirs ?? defaultProjectDirs()).map((p) => resolve(p));
+        this.warnDuplicateAliases();
+    }
+    /**
+     * Advertised aliases are directory basenames, so two projects that share a
+     * folder name collide. Warn up front — such an alias can only be routed by an
+     * absolute `projectDir` (see resolveProjectPath).
+     */
+    warnDuplicateAliases() {
+        const counts = new Map();
+        for (const p of this.projectDirs) {
+            const alias = basename(p);
+            counts.set(alias, (counts.get(alias) ?? 0) + 1);
+        }
+        for (const [alias, count] of counts) {
+            if (count > 1) {
+                this.logger.warn("duplicate project alias advertised; route by absolute projectDir", {
+                    alias,
+                    count,
+                });
+            }
+        }
+    }
+    async execute(toolName, rawArgs, projectAlias) {
+        const routingKey = projectAlias
+            ?? (typeof rawArgs.projectDir === "string" ? rawArgs.projectDir : undefined)
+            ?? (typeof rawArgs.projectAlias === "string" ? rawArgs.projectAlias : undefined);
+        const entry = await this.resolveProject(routingKey);
+        const { projectAlias: _pa, ...args } = rawArgs;
+        void _pa;
+        return entry.client.callTool(toolName, { ...args, projectDir: entry.path });
+    }
+    async advertisedProjects() {
+        return this.projectDirs.map((path) => {
+            const remoteLabel = gitRemote(path);
+            return {
+                alias: basename(path),
+                path,
+                repoIdentity: identityFor(path, remoteLabel),
+                ...(remoteLabel ? { remoteLabel } : {}),
+                markers: detectMarkers(path),
+            };
+        });
+    }
+    async close() {
+        for (const entry of this.projects.values())
+            entry.client.close();
+        this.projects.clear();
+    }
+    async resolveProject(aliasOrPath) {
+        const path = this.resolveProjectPath(aliasOrPath);
+        const existing = this.projects.get(path);
+        if (existing)
+            return existing;
+        let init = this.projectInit.get(path);
+        if (!init) {
+            init = this.createProjectEntry(path);
+            this.projectInit.set(path, init);
+            void init.finally(() => this.projectInit.delete(path));
+        }
+        return init;
+    }
+    async createProjectEntry(path) {
+        const existing = this.projects.get(path);
+        if (existing)
+            return existing;
+        // `gsd --mode mcp` resolves its GSD root from cwd, so spawn the child in the
+        // project directory. GSD_PROJECT_ROOT is also set as a belt-and-suspenders
+        // hint for gsd's root resolution.
+        const client = new McpStdioClient(this.gsdBinary, ["--mode", "mcp"], this.logger, { env: { ...process.env, GSD_PROJECT_ROOT: path }, cwd: path });
+        const entry = { alias: basename(path), path, client };
+        this.projects.set(path, entry);
+        return entry;
+    }
+    resolveProjectPath(aliasOrPath) {
+        if (!aliasOrPath) {
+            if (this.projectDirs.length === 0) {
+                throw new Error("No project advertised by the standalone GSD runtime");
+            }
+            if (this.projectDirs.length > 1) {
+                throw new Error("Project routing is ambiguous: multiple projects are advertised — projectDir or projectAlias is required");
+            }
+            return this.projectDirs[0];
+        }
+        const resolved = resolve(aliasOrPath);
+        // Prefer an exact absolute-path match — always unambiguous.
+        const exact = this.projectDirs.find((p) => p === resolved);
+        if (exact)
+            return exact;
+        // Otherwise match by advertised alias (basename). If more than one advertised
+        // directory shares that basename the alias is ambiguous, so fail loudly rather
+        // than silently routing work to whichever entry happens to come first.
+        const byBasename = this.projectDirs.filter((p) => basename(p) === aliasOrPath);
+        if (byBasename.length > 1) {
+            throw new Error(`Project alias is ambiguous: ${aliasOrPath}`);
+        }
+        if (byBasename.length === 1)
+            return byBasename[0];
+        throw new Error(`Project is not advertised by the standalone GSD runtime: ${aliasOrPath}`);
+    }
+}
+function defaultProjectDirs() {
+    const env = process.env["GSD_CLOUD_PROJECTS"];
+    if (env && env.trim()) {
+        return env.split(delimiter).map((p) => p.trim()).filter(Boolean);
+    }
+    return [process.cwd()];
+}
+function detectMarkers(path) {
+    const markers = [];
+    if (existsSync(resolve(path, ".git")))
+        markers.push("git");
+    if (existsSync(resolve(path, "package.json")))
+        markers.push("node");
+    if (existsSync(resolve(path, ".gsd")))
+        markers.push("gsd");
+    return markers;
+}
+function gitRemote(projectPath) {
+    try {
+        return execFileSync("git", ["remote", "get-url", "origin"], {
+            cwd: projectPath,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function identityFor(projectPath, remote) {
+    return createHash("sha256").update(remote || `${basename(projectPath)}:${projectPath}`).digest("hex").slice(0, 12);
+}
+//# sourceMappingURL=gsd-pi-executor.js.map

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd-pi-executor.js","sourceRoot":"","sources":["../../src/executors/gsd-pi-executor.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,iFAAiF;AACjF,EAAE;AACF,YAAY;AACZ,YAAY;AACZ,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,wEAAwE;AACxE,2EAA2E;AAC3E,qCAAqC;AACrC,EAAE;AACF,gCAAgC;AAChC,iFAAiF;AACjF,iFAAiF;AACjF,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AACvE,sEAAsE;AACtE,kFAAkF;AAClF,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkBvD,MAAM,OAAO,aAAa;IAQK;IAPZ,SAAS,CAAS;IAClB,WAAW,CAAW;IACvC,2EAA2E;IAC1D,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5D,kFAAkF;IACjE,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAC;IAExE,YAA6B,MAAc,EAAE,OAA6B,EAAE;QAA/C,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;eAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;eAC3B,KAAK,CAAC;QACX,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACK,oBAAoB;QAC1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACpC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;oBACnF,KAAK;oBACL,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAgC,EAAE,YAAqB;QACrF,MAAM,UAAU,GAAG,YAAY;eAC1B,CAAC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;eACzE,CAAC,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAC/C,KAAK,GAAG,CAAC;QACT,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACnC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO;gBACL,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACrB,IAAI;gBACJ,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;gBAC5C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;aAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,WAAoB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,IAAI,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAAY;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,6EAA6E;QAC7E,2EAA2E;QAC3E,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,IAAI,CAAC,SAAS,EACd,CAAC,QAAQ,EAAE,KAAK,CAAC,EACjB,IAAI,CAAC,MAAM,EACX,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAC/D,CAAC;QACF,MAAM,KAAK,GAAiB,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,kBAAkB,CAAC,WAAoB;QAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAC9B,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,4DAA4D;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC3D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,8EAA8E;QAC9E,+EAA+E;QAC/E,uEAAuE;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC;QAC/E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,4DAA4D,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF;AAED,SAAS,kBAAkB;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC9C,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC1D,GAAG,EAAE,WAAW;YAChB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,MAAe;IACvD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrH,CAAC","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Executor adapter that drives the installed `gsd` CLI headlessly.\n//\n// MECHANISM\n// ---------\n// The `gsd` CLI exposes every registered workflow tool over the Model Context\n// Protocol when started with `gsd --mode mcp` (see src/cli.ts in gsd-pi: mode\n// 'mcp' flips the active tool set to the full registry and serves MCP over\n// stdin/stdout). This adapter spawns ONE long-lived `gsd --mode mcp` child per\n// project and issues `tools/call` requests for each `execute()` — the same\n// gsd_* tool names the cloud gateway forwards (gsd_execute, gsd_status,\n// gsd_graph, gsd_cancel, gsd_query, …). No GSD package is linked; the only\n// contract is the MCP wire protocol.\n//\n// DOCUMENTED GAPS (see report):\n//  1. Project discovery. The daemon's LocalToolExecutor scanned filesystem roots\n//     via a dedicated ProjectScanner. This standalone package has no scanner, so\n//     it advertises an EXPLICIT project list from `GSD_CLOUD_PROJECTS` (a\n//     path-list separated by the OS path delimiter) or, if unset, the current\n//     working directory. Each advertised project's `repoIdentity` is computed\n//     exactly as the daemon did (sha256 of the git origin remote, else\n//     basename:path), so gateway-side identity matching is preserved.\n//  2. One MCP server per project. `gsd --mode mcp` is project-scoped (it resolves\n//     the GSD root from its cwd). A `tool_call` carrying a `projectAlias` is\n//     routed to that project's dedicated child; the `projectDir` arg the daemon\n//     injected is not needed because cwd already scopes the server. Tool args are\n//     forwarded verbatim otherwise.\n\nimport { createHash } from \"node:crypto\";\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { basename, delimiter, resolve } from \"node:path\";\nimport type { Logger } from \"../logger.js\";\nimport type { AdvertisedProject, Executor } from \"./executor.js\";\nimport { McpStdioClient } from \"./mcp-stdio-client.js\";\n\nexport interface GsdPiExecutorOptions {\n  /** Path to the `gsd` binary. Defaults to GSD_CLI_PATH env, else `gsd` on PATH. */\n  gsdBinary?: string;\n  /**\n   * Explicit list of project directories to advertise. Defaults to\n   * GSD_CLOUD_PROJECTS (path-delimiter separated), else [cwd].\n   */\n  projectDirs?: string[];\n}\n\ninterface ProjectEntry {\n  alias: string;\n  path: string;\n  client: McpStdioClient;\n}\n\nexport class GsdPiExecutor implements Executor {\n  private readonly gsdBinary: string;\n  private readonly projectDirs: string[];\n  /** Lazily-created MCP clients, keyed by resolved absolute project path. */\n  private readonly projects = new Map<string, ProjectEntry>();\n  /** In-flight project client creation, keyed by resolved absolute project path. */\n  private readonly projectInit = new Map<string, Promise<ProjectEntry>>();\n\n  constructor(private readonly logger: Logger, opts: GsdPiExecutorOptions = {}) {\n    this.gsdBinary = opts.gsdBinary\n      ?? process.env[\"GSD_CLI_PATH\"]\n      ?? \"gsd\";\n    this.projectDirs = (opts.projectDirs ?? defaultProjectDirs()).map((p) => resolve(p));\n    this.warnDuplicateAliases();\n  }\n\n  /**\n   * Advertised aliases are directory basenames, so two projects that share a\n   * folder name collide. Warn up front — such an alias can only be routed by an\n   * absolute `projectDir` (see resolveProjectPath).\n   */\n  private warnDuplicateAliases(): void {\n    const counts = new Map<string, number>();\n    for (const p of this.projectDirs) {\n      const alias = basename(p);\n      counts.set(alias, (counts.get(alias) ?? 0) + 1);\n    }\n    for (const [alias, count] of counts) {\n      if (count > 1) {\n        this.logger.warn(\"duplicate project alias advertised; route by absolute projectDir\", {\n          alias,\n          count,\n        });\n      }\n    }\n  }\n\n  async execute(toolName: string, rawArgs: Record<string, unknown>, projectAlias?: string): Promise<unknown> {\n    const routingKey = projectAlias\n      ?? (typeof rawArgs.projectDir === \"string\" ? rawArgs.projectDir : undefined)\n      ?? (typeof rawArgs.projectAlias === \"string\" ? rawArgs.projectAlias : undefined);\n    const entry = await this.resolveProject(routingKey);\n    const { projectAlias: _pa, ...args } = rawArgs;\n    void _pa;\n    return entry.client.callTool(toolName, { ...args, projectDir: entry.path });\n  }\n\n  async advertisedProjects(): Promise<AdvertisedProject[]> {\n    return this.projectDirs.map((path) => {\n      const remoteLabel = gitRemote(path);\n      return {\n        alias: basename(path),\n        path,\n        repoIdentity: identityFor(path, remoteLabel),\n        ...(remoteLabel ? { remoteLabel } : {}),\n        markers: detectMarkers(path),\n      };\n    });\n  }\n\n  async close(): Promise<void> {\n    for (const entry of this.projects.values()) entry.client.close();\n    this.projects.clear();\n  }\n\n  private async resolveProject(aliasOrPath?: string): Promise<ProjectEntry> {\n    const path = this.resolveProjectPath(aliasOrPath);\n    const existing = this.projects.get(path);\n    if (existing) return existing;\n\n    let init = this.projectInit.get(path);\n    if (!init) {\n      init = this.createProjectEntry(path);\n      this.projectInit.set(path, init);\n      void init.finally(() => this.projectInit.delete(path));\n    }\n    return init;\n  }\n\n  private async createProjectEntry(path: string): Promise<ProjectEntry> {\n    const existing = this.projects.get(path);\n    if (existing) return existing;\n    // `gsd --mode mcp` resolves its GSD root from cwd, so spawn the child in the\n    // project directory. GSD_PROJECT_ROOT is also set as a belt-and-suspenders\n    // hint for gsd's root resolution.\n    const client = new McpStdioClient(\n      this.gsdBinary,\n      [\"--mode\", \"mcp\"],\n      this.logger,\n      { env: { ...process.env, GSD_PROJECT_ROOT: path }, cwd: path },\n    );\n    const entry: ProjectEntry = { alias: basename(path), path, client };\n    this.projects.set(path, entry);\n    return entry;\n  }\n\n  private resolveProjectPath(aliasOrPath?: string): string {\n    if (!aliasOrPath) {\n      if (this.projectDirs.length === 0) {\n        throw new Error(\"No project advertised by the standalone GSD runtime\");\n      }\n      if (this.projectDirs.length > 1) {\n        throw new Error(\n          \"Project routing is ambiguous: multiple projects are advertised — projectDir or projectAlias is required\",\n        );\n      }\n      return this.projectDirs[0]!;\n    }\n    const resolved = resolve(aliasOrPath);\n    // Prefer an exact absolute-path match — always unambiguous.\n    const exact = this.projectDirs.find((p) => p === resolved);\n    if (exact) return exact;\n    // Otherwise match by advertised alias (basename). If more than one advertised\n    // directory shares that basename the alias is ambiguous, so fail loudly rather\n    // than silently routing work to whichever entry happens to come first.\n    const byBasename = this.projectDirs.filter((p) => basename(p) === aliasOrPath);\n    if (byBasename.length > 1) {\n      throw new Error(`Project alias is ambiguous: ${aliasOrPath}`);\n    }\n    if (byBasename.length === 1) return byBasename[0]!;\n    throw new Error(`Project is not advertised by the standalone GSD runtime: ${aliasOrPath}`);\n  }\n}\n\nfunction defaultProjectDirs(): string[] {\n  const env = process.env[\"GSD_CLOUD_PROJECTS\"];\n  if (env && env.trim()) {\n    return env.split(delimiter).map((p) => p.trim()).filter(Boolean);\n  }\n  return [process.cwd()];\n}\n\nfunction detectMarkers(path: string): string[] {\n  const markers: string[] = [];\n  if (existsSync(resolve(path, \".git\"))) markers.push(\"git\");\n  if (existsSync(resolve(path, \"package.json\"))) markers.push(\"node\");\n  if (existsSync(resolve(path, \".gsd\"))) markers.push(\"gsd\");\n  return markers;\n}\n\nfunction gitRemote(projectPath: string): string | undefined {\n  try {\n    return execFileSync(\"git\", [\"remote\", \"get-url\", \"origin\"], {\n      cwd: projectPath,\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim() || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction identityFor(projectPath: string, remote?: string): string {\n  return createHash(\"sha256\").update(remote || `${basename(projectPath)}:${projectPath}`).digest(\"hex\").slice(0, 12);\n}\n"]}

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gsd-pi-executor.test.d.ts.map

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd-pi-executor.test.d.ts","sourceRoot":"","sources":["../../src/executors/gsd-pi-executor.test.ts"],"names":[],"mappings":""}

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.test.js

@@ -0,0 +1,44 @@
+// Project/App: Open GSD
+// File Purpose: Regression tests for GsdPiExecutor project routing — a bare alias
+// (directory basename) shared by two advertised projects must fail loudly instead
+// of silently routing cloud work to whichever entry comes first.
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { GsdPiExecutor } from "./gsd-pi-executor.js";
+const warnings = [];
+const logger = {
+    info: () => undefined,
+    warn: (msg, meta) => warnings.push({ msg, meta }),
+    error: () => undefined,
+    debug: () => undefined,
+};
+test("ambiguous alias across colliding basenames rejects instead of mis-routing", async () => {
+    const exec = new GsdPiExecutor(logger, {
+        projectDirs: ["/tmp/team-a/web", "/tmp/team-b/web"],
+    });
+    await assert.rejects(exec.execute("gsd_status", {}, "web"), /ambiguous/i);
+});
+test("constructing with colliding aliases warns once", () => {
+    warnings.length = 0;
+    // eslint-disable-next-line no-new
+    new GsdPiExecutor(logger, { projectDirs: ["/tmp/team-a/web", "/tmp/team-b/web"] });
+    const dupWarn = warnings.filter((w) => /duplicate project alias/i.test(w.msg));
+    assert.equal(dupWarn.length, 1);
+});
+test("missing alias with several projects rejects instead of using the first", async () => {
+    const exec = new GsdPiExecutor(logger, {
+        projectDirs: ["/tmp/alpha", "/tmp/beta"],
+    });
+    await assert.rejects(exec.execute("gsd_status", {}), /ambiguous/i);
+});
+test("an alias that is not advertised rejects", async () => {
+    const exec = new GsdPiExecutor(logger, { projectDirs: ["/tmp/solo/app"] });
+    await assert.rejects(exec.execute("gsd_status", {}, "nope"), /not advertised/i);
+});
+test("advertised alias is the directory basename", async () => {
+    const exec = new GsdPiExecutor(logger, { projectDirs: ["/tmp/solo/app"] });
+    const projects = await exec.advertisedProjects();
+    assert.equal(projects.length, 1);
+    assert.equal(projects[0]?.alias, "app");
+});
+//# sourceMappingURL=gsd-pi-executor.test.js.map

package/packages/gsd-cloud/dist/executors/gsd-pi-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd-pi-executor.test.js","sourceRoot":"","sources":["../../src/executors/gsd-pi-executor.test.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,kFAAkF;AAClF,kFAAkF;AAClF,iEAAiE;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,QAAQ,GAA0C,EAAE,CAAC;AAC3D,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACnE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAC;AAEF,IAAI,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;IAC3F,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,MAAe,EAAE;QAC9C,WAAW,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;KACpD,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC1D,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,kCAAkC;IAClC,IAAI,aAAa,CAAC,MAAe,EAAE,EAAE,WAAW,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;IACxF,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,MAAe,EAAE;QAC9C,WAAW,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;KACzC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,MAAe,EAAE,EAAE,WAAW,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,MAAe,EAAE,EAAE,WAAW,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACjD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Regression tests for GsdPiExecutor project routing — a bare alias\n// (directory basename) shared by two advertised projects must fail loudly instead\n// of silently routing cloud work to whichever entry comes first.\nimport { test } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { GsdPiExecutor } from \"./gsd-pi-executor.js\";\n\nconst warnings: Array<{ msg: string; meta: unknown }> = [];\nconst logger = {\n  info: () => undefined,\n  warn: (msg: string, meta?: unknown) => warnings.push({ msg, meta }),\n  error: () => undefined,\n  debug: () => undefined,\n};\n\ntest(\"ambiguous alias across colliding basenames rejects instead of mis-routing\", async () => {\n  const exec = new GsdPiExecutor(logger as never, {\n    projectDirs: [\"/tmp/team-a/web\", \"/tmp/team-b/web\"],\n  });\n  await assert.rejects(exec.execute(\"gsd_status\", {}, \"web\"), /ambiguous/i);\n});\n\ntest(\"constructing with colliding aliases warns once\", () => {\n  warnings.length = 0;\n  // eslint-disable-next-line no-new\n  new GsdPiExecutor(logger as never, { projectDirs: [\"/tmp/team-a/web\", \"/tmp/team-b/web\"] });\n  const dupWarn = warnings.filter((w) => /duplicate project alias/i.test(w.msg));\n  assert.equal(dupWarn.length, 1);\n});\n\ntest(\"missing alias with several projects rejects instead of using the first\", async () => {\n  const exec = new GsdPiExecutor(logger as never, {\n    projectDirs: [\"/tmp/alpha\", \"/tmp/beta\"],\n  });\n  await assert.rejects(exec.execute(\"gsd_status\", {}), /ambiguous/i);\n});\n\ntest(\"an alias that is not advertised rejects\", async () => {\n  const exec = new GsdPiExecutor(logger as never, { projectDirs: [\"/tmp/solo/app\"] });\n  await assert.rejects(exec.execute(\"gsd_status\", {}, \"nope\"), /not advertised/i);\n});\n\ntest(\"advertised alias is the directory basename\", async () => {\n  const exec = new GsdPiExecutor(logger as never, { projectDirs: [\"/tmp/solo/app\"] });\n  const projects = await exec.advertisedProjects();\n  assert.equal(projects.length, 1);\n  assert.equal(projects[0]?.alias, \"app\");\n});\n"]}

package/packages/gsd-cloud/dist/executors/index.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from "../logger.js";
+import type { Executor } from "./executor.js";
+import { type GsdPiExecutorOptions } from "./gsd-pi-executor.js";
+export type ExecutorKind = "gsd-pi" | "codex" | "claude";
+export interface SelectExecutorOptions extends GsdPiExecutorOptions {
+    kind?: ExecutorKind;
+}
+/**
+ * Resolve the execution backend. Defaults to the gsd-pi shell-out adapter, which
+ * drives the installed `gsd` CLI over MCP. Selection can also be overridden with
+ * the GSD_CLOUD_EXECUTOR env var.
+ */
+export declare function selectExecutor(logger: Logger, opts?: SelectExecutorOptions): Executor;
+export type { Executor, AdvertisedProject } from "./executor.js";
+export { GsdPiExecutor } from "./gsd-pi-executor.js";
+export type { GsdPiExecutorOptions } from "./gsd-pi-executor.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/gsd-cloud/dist/executors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIhF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,QAAQ,CAYzF;AAED,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/gsd-cloud/dist/executors/index.js

@@ -0,0 +1,29 @@
+// Project/App: Open GSD
+// File Purpose: Executor selection seam — pick a backend adapter by name.
+//
+// The gsd-pi shell-out adapter is the only implemented backend today. `codex`
+// and `claude` are stubbed so the seam is visible; selecting them throws until
+// their behaviour is designed.
+import { GsdPiExecutor } from "./gsd-pi-executor.js";
+import { CodexExecutor } from "./codex-executor.js";
+import { ClaudeExecutor } from "./claude-executor.js";
+/**
+ * Resolve the execution backend. Defaults to the gsd-pi shell-out adapter, which
+ * drives the installed `gsd` CLI over MCP. Selection can also be overridden with
+ * the GSD_CLOUD_EXECUTOR env var.
+ */
+export function selectExecutor(logger, opts = {}) {
+    const kind = opts.kind ?? process.env["GSD_CLOUD_EXECUTOR"] ?? "gsd-pi";
+    switch (kind) {
+        case "gsd-pi":
+            return new GsdPiExecutor(logger, opts);
+        case "codex":
+            return new CodexExecutor();
+        case "claude":
+            return new ClaudeExecutor();
+        default:
+            throw new Error(`Unknown executor kind: ${String(kind)}`);
+    }
+}
+export { GsdPiExecutor } from "./gsd-pi-executor.js";
+//# sourceMappingURL=index.js.map

package/packages/gsd-cloud/dist/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+BAA+B;AAI/B,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAA8B,EAAE;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAK,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAA8B,IAAI,QAAQ,CAAC;IACtG,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,KAAK,OAAO;YACV,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAGD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Executor selection seam — pick a backend adapter by name.\n//\n// The gsd-pi shell-out adapter is the only implemented backend today. `codex`\n// and `claude` are stubbed so the seam is visible; selecting them throws until\n// their behaviour is designed.\n\nimport type { Logger } from \"../logger.js\";\nimport type { Executor } from \"./executor.js\";\nimport { GsdPiExecutor, type GsdPiExecutorOptions } from \"./gsd-pi-executor.js\";\nimport { CodexExecutor } from \"./codex-executor.js\";\nimport { ClaudeExecutor } from \"./claude-executor.js\";\n\nexport type ExecutorKind = \"gsd-pi\" | \"codex\" | \"claude\";\n\nexport interface SelectExecutorOptions extends GsdPiExecutorOptions {\n  kind?: ExecutorKind;\n}\n\n/**\n * Resolve the execution backend. Defaults to the gsd-pi shell-out adapter, which\n * drives the installed `gsd` CLI over MCP. Selection can also be overridden with\n * the GSD_CLOUD_EXECUTOR env var.\n */\nexport function selectExecutor(logger: Logger, opts: SelectExecutorOptions = {}): Executor {\n  const kind = opts.kind ?? (process.env[\"GSD_CLOUD_EXECUTOR\"] as ExecutorKind | undefined) ?? \"gsd-pi\";\n  switch (kind) {\n    case \"gsd-pi\":\n      return new GsdPiExecutor(logger, opts);\n    case \"codex\":\n      return new CodexExecutor();\n    case \"claude\":\n      return new ClaudeExecutor();\n    default:\n      throw new Error(`Unknown executor kind: ${String(kind)}`);\n  }\n}\n\nexport type { Executor, AdvertisedProject } from \"./executor.js\";\nexport { GsdPiExecutor } from \"./gsd-pi-executor.js\";\nexport type { GsdPiExecutorOptions } from \"./gsd-pi-executor.js\";\n"]}

package/packages/gsd-cloud/dist/executors/mcp-stdio-client.d.ts

@@ -0,0 +1,36 @@
+import type { Logger } from "../logger.js";
+/**
+ * Long-lived MCP client bound to a single spawned server process.
+ * Lazily starts and initializes the server on first use; subsequent calls reuse
+ * the same connection.
+ */
+export declare class McpStdioClient {
+    private readonly command;
+    private readonly args;
+    private readonly logger;
+    private readonly options;
+    private child;
+    private rl;
+    private nextId;
+    private readonly pending;
+    private initPromise;
+    private closed;
+    constructor(command: string, args: string[], logger: Logger, options?: {
+        env?: NodeJS.ProcessEnv;
+        cwd?: string;
+    });
+    /** Ensure the server is spawned and `initialize` has completed. Idempotent. */
+    ensureReady(): Promise<void>;
+    private awaitReadyProcess;
+    /** Invoke an MCP tool and return its raw result object. */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    close(): void;
+    private startAndInitialize;
+    private request;
+    private notify;
+    private handleLine;
+    private failAll;
+    private isProcessAlive;
+    private resetConnection;
+}
+//# sourceMappingURL=mcp-stdio-client.d.ts.map

package/packages/gsd-cloud/dist/executors/mcp-stdio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-client.d.ts","sourceRoot":"","sources":["../../src/executors/mcp-stdio-client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAmB3C;;;;GAIG;AACH,qBAAa,cAAc;IASvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAS;gBAGJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;IAG1E,+EAA+E;IACzE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,iBAAiB;IAwBzB,2DAA2D;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7E,KAAK,IAAI,IAAI;YAKC,kBAAkB;IAwChC,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,eAAe;CAUxB"}

package/packages/gsd-cloud/dist/executors/mcp-stdio-client.js

@@ -0,0 +1,176 @@
+// Project/App: Open GSD
+// File Purpose: Minimal MCP JSON-RPC 2.0 client over a child process's stdio.
+//
+// Zero external deps — just enough of the Model Context Protocol to `initialize`
+// a server and issue `tools/call` requests. Used by the gsd-pi shell-out adapter
+// to drive `gsd --mode mcp` without linking any GSD package.
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+const PROTOCOL_VERSION = "2024-11-05";
+const INIT_TIMEOUT_MS = 60_000;
+const CALL_TIMEOUT_MS = 30 * 60_000; // GSD tool calls (e.g. gsd_execute) can be long-running.
+/**
+ * Long-lived MCP client bound to a single spawned server process.
+ * Lazily starts and initializes the server on first use; subsequent calls reuse
+ * the same connection.
+ */
+export class McpStdioClient {
+    command;
+    args;
+    logger;
+    options;
+    child;
+    rl;
+    nextId = 1;
+    pending = new Map();
+    initPromise;
+    closed = false;
+    constructor(command, args, logger, options = {}) {
+        this.command = command;
+        this.args = args;
+        this.logger = logger;
+        this.options = options;
+    }
+    /** Ensure the server is spawned and `initialize` has completed. Idempotent. */
+    async ensureReady() {
+        await this.awaitReadyProcess();
+    }
+    awaitReadyProcess() {
+        if (this.closed) {
+            return Promise.reject(new Error("MCP client closed"));
+        }
+        if (!this.initPromise) {
+            this.initPromise = this.startAndInitialize().catch((err) => {
+                this.resetConnection();
+                throw err;
+            });
+        }
+        return this.initPromise.then(async () => {
+            if (this.closed)
+                throw new Error("MCP client closed");
+            if (this.isProcessAlive())
+                return;
+            this.resetConnection();
+            throw new Error("gsd MCP process is not running after initialize");
+        }, (err) => {
+            if (this.closed)
+                throw new Error("MCP client closed");
+            throw err;
+        });
+    }
+    /** Invoke an MCP tool and return its raw result object. */
+    async callTool(name, args) {
+        await this.ensureReady();
+        return this.request("tools/call", { name, arguments: args }, CALL_TIMEOUT_MS);
+    }
+    close() {
+        this.closed = true;
+        this.resetConnection(new Error("MCP client closed"));
+    }
+    async startAndInitialize() {
+        const child = spawn(this.command, this.args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: this.options.env ?? process.env,
+            ...(this.options.cwd ? { cwd: this.options.cwd } : {}),
+        });
+        this.child = child;
+        child.on("error", (err) => {
+            this.logger.error("gsd MCP process error", { error: err.message });
+            this.resetConnection(new Error(`gsd MCP process error: ${err.message}`));
+        });
+        child.on("exit", (code, signal) => {
+            this.logger.warn("gsd MCP process exited", { code, signal });
+            this.resetConnection(new Error(`gsd MCP process exited (code=${code ?? "null"}, signal=${signal ?? "null"})`));
+        });
+        // MCP servers commonly log human-readable startup noise on stderr; forward at debug.
+        child.stderr.on("data", (chunk) => {
+            this.logger.debug("gsd MCP stderr", { text: chunk.toString("utf8").trimEnd() });
+        });
+        this.rl = createInterface({ input: child.stdout });
+        this.rl.on("line", (line) => this.handleLine(line));
+        await this.request("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "@opengsd/gsd-cloud", version: "1.7.1" },
+        }, INIT_TIMEOUT_MS);
+        // Per MCP spec, the client sends an `initialized` notification (no id, no response).
+        this.notify("notifications/initialized");
+    }
+    request(method, params, timeoutMs) {
+        const child = this.child;
+        if (!child || !child.stdin.writable) {
+            return Promise.reject(new Error("gsd MCP process is not running"));
+        }
+        const id = this.nextId++;
+        const payload = JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n";
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`gsd MCP request '${method}' timed out after ${timeoutMs}ms`));
+                this.resetConnection();
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            child.stdin.write(payload, (err) => {
+                if (err) {
+                    clearTimeout(timer);
+                    this.pending.delete(id);
+                    reject(new Error(`Failed to write MCP request: ${err.message}`));
+                    this.resetConnection();
+                }
+            });
+        });
+    }
+    notify(method) {
+        const child = this.child;
+        if (!child || !child.stdin.writable)
+            return;
+        child.stdin.write(JSON.stringify({ jsonrpc: "2.0", method }) + "\n");
+    }
+    handleLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let message;
+        try {
+            message = JSON.parse(trimmed);
+        }
+        catch {
+            // Non-JSON line (stray log). Ignore.
+            return;
+        }
+        if (message.id === undefined || message.id === null)
+            return; // notification/request from server — ignored.
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if (message.error) {
+            pending.reject(new Error(message.error.message || `MCP error ${message.error.code}`));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    failAll(err) {
+        for (const [, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    isProcessAlive() {
+        const child = this.child;
+        return child !== undefined && child.exitCode === null && child.signalCode === null;
+    }
+    resetConnection(reason = new Error("MCP connection reset")) {
+        this.failAll(reason);
+        this.rl?.close();
+        this.rl = undefined;
+        if (this.child && this.child.exitCode === null && this.child.signalCode === null) {
+            this.child.kill();
+        }
+        this.child = undefined;
+        this.initPromise = undefined;
+    }
+}
+//# sourceMappingURL=mcp-stdio-client.js.map