@bridge_gpt/mcp-server 0.2.55 → 0.2.56

package/build/init.js

@@ -13,6 +13,7 @@ import { writeFile, mkdir, readFile, stat } from "fs/promises";
 import path from "path";
 import os from "os";
 import { COMMANDS } from "./commands.generated.js";
+import { renderCommandForHost } from "./command-host.js";
 import { CODEX_SKILLS_DIR, codexSkillAssets } from "./codex-skill-adapter.js";
 import { AGENTS } from "./agents.generated.js";
 import { DOCS } from "./docs.generated.js";
@@ -770,7 +771,7 @@ export async function runInit(cwd, options = {}) {
         await mkdir(dir, { recursive: true });
         // Per-file read/compare/write runs concurrently; outcomes are applied to the
         // Sets afterward in entry order so the summary counts are unchanged.
-        const outcomes = await Promise.all(commandEntries.map(([filename, content]) => scaffoldFile(path.join(dir, filename), content)));
+        const outcomes = await Promise.all(commandEntries.map(([filename, content]) => scaffoldFile(path.join(dir, filename), renderCommandForHost(filename, content, dir === path.join(cwd, ".cursor", "commands") ? "cursor" : "claude-code"))));
         commandEntries.forEach(([filename], i) => {
             const outcome = outcomes[i];
             if (outcome === "skipped") {

package/build/install-bridge.js

@@ -530,7 +530,7 @@ export function getInstallBridgeUsage(baseUrl = DEFAULT_BAPI_BASE_URL) {
         "                                prompting, or spawning anything. With --invite it",
         "                                also never calls the exchange endpoint and never",
         "                                generates or stores a secret.",
-        "  --agent claude|cursor-agent   Explicit launch override for the post-install",
+        "  --agent claude|cursor-agent|codex  Explicit agent choice for post-install",
         "                                session — it always wins, and there is NO Claude",
         "                                default. Without it the launch tool is derived",
         "                                from your selection: Claude Code opens `claude`.",
@@ -539,9 +539,11 @@ export function getInstallBridgeUsage(baseUrl = DEFAULT_BAPI_BASE_URL) {
         "                                session); selecting Cursor writes .cursor/mcp.json",
         "                                and prints how to finish by running /install-bridge",
         "                                in a new Cursor session. A selection whose tools have",
-        "                                no agentic CLI (e.g. Copilot) likewise opens nothing",
+        "                                no supported auto-launch path (e.g. Copilot) opens nothing",
         "                                and prints how to finish configuring later. Passing",
-        "                                --agent cursor-agent still force-spawns it.",
+        "                                --agent cursor-agent still force-spawns it. Codex",
+        "                                is accepted only for manual continuation: neither",
+        "                                this bootstrap nor start-tickets launches it yet.",
         "  -h, --help                    Show this help.",
         "",
         "Subcommands:",
@@ -2057,7 +2059,7 @@ async function resolveDryRunHostPlatforms(deps, options) {
  * Launch agents install-bridge will NEVER auto-spawn from a host SELECTION, even
  * though their CLI exists and the host's MCP config is still written normally.
  *
- * `cursor-agent` is excluded: its FIRST-RUN workspace-trust handshake collapses
+ * `cursor-agent` and `codex` are excluded. Cursor's FIRST-RUN workspace-trust handshake collapses
  * under our osascript-spawned launch — the "Workspace Trust Required" dialog
  * renders, then the process exits before a selection registers, so configuration
  * never runs (reproduced on a pristine, never-trusted workspace; the identical
@@ -2065,16 +2067,20 @@ async function resolveDryRunHostPlatforms(deps, options) {
  * cursor-agent's own behavior on an untrusted workspace and is not something our
  * launch can drive, so we treat Cursor as a no-auto-launch host: selecting it
  * still writes `.cursor/mcp.json`, then prints the manual `/install-bridge`
- * continuation (same path as Copilot/Codex/Windsurf, which have no agentic CLI).
+ * continuation. Codex does have an agentic CLI, but this workflow is a Claude
+ * `/install-bridge` command and its native skill is not available until after
+ * the bootstrap it would be asked to run completes.
  * An explicit `--agent cursor-agent` override still spawns it — a deliberate,
  * documented power-user opt-in that bypasses this selection guard.
  */
-const SELECTION_NON_LAUNCHABLE_AGENTS = new Set(["cursor-agent"]);
+const SELECTION_NON_LAUNCHABLE_AGENTS = new Set(["cursor-agent", "codex"]);
+/** Agents whose interactive command surface cannot run the post-install recipe yet. */
+const INSTALL_BRIDGE_UNSUPPORTED_AGENTS = new Set(["codex"]);
 /**
  * Resolve the post-install launch decision from the selected host platforms and an
  * OPTIONAL explicit `--agent` override (BAPI-657). Pure and total:
  *
- *  - An explicit `--agent` is an ABSOLUTE override (ratified AC-4): a valid explicit
+ *  - An explicit supported `--agent` is an ABSOLUTE override: a valid explicit
  *    agent always returns `spawn(agent)`, regardless of which tools were selected —
  *    the flag is honored even for a host outside the selection, and it bypasses the
  *    {@link SELECTION_NON_LAUNCHABLE_AGENTS} guard below.
@@ -2089,6 +2095,9 @@ const SELECTION_NON_LAUNCHABLE_AGENTS = new Set(["cursor-agent"]);
  */
 export function resolveInstallBridgeLaunchDecision(selectedPlatforms, explicitAgent) {
     if (explicitAgent) {
+        if (INSTALL_BRIDGE_UNSUPPORTED_AGENTS.has(explicitAgent)) {
+            return { kind: "manual", reason: "unsupported-agent-workflow" };
+        }
         return { kind: "spawn", agent: explicitAgent };
     }
     if (selectedPlatforms.length === 0) {
@@ -3871,7 +3880,9 @@ function describePlannedLaunchAgent(launch) {
     }
     return launch.reason === "empty-selection"
         ? "none — no tools selected"
-        : "none — no launchable tool selected; manual continuation is printed";
+        : launch.reason === "unsupported-agent-workflow"
+            ? "none — selected agent cannot run the install-bridge workflow; manual continuation is printed"
+            : "none — no launchable tool selected; manual continuation is printed";
 }
 /**
  * The Step 5 preview lines, shared by both previews so the launch description
@@ -3923,7 +3934,9 @@ function buildLaunchStepPreview(launch) {
         ...githubLines,
         launch.reason === "empty-selection"
             ? "Step 5 — no agent session: no tools were selected, so nothing is configured or opened; re-run and select at least one tool."
-            : "Step 5 — no automatic launch: no selected tool has an agentic CLI. The deterministic setup completes and copy-pasteable /install-bridge continuation is printed (your Bridge MCP tools stay limited until configured).",
+            : launch.reason === "unsupported-agent-workflow"
+                ? "Step 5 — no automatic launch: the selected agent cannot run the install-bridge workflow. The deterministic setup completes and manual continuation is printed."
+                : "Step 5 — no automatic launch: no selected tool can auto-launch this workflow. The deterministic setup completes and copy-pasteable /install-bridge continuation is printed (your Bridge MCP tools stay limited until configured).",
     ];
 }
 /**

package/build/mcp-host-targets.js

@@ -73,7 +73,7 @@ export const MCP_HOST_TARGETS = {
         hostKind: "claude-code-json",
         vendorCli: { bin: "claude", kind: "claude-add-json" },
         launchAgent: "claude",
-        worktreeSupported: true,
+        capabilities: { mcpConfiguration: true, customCommands: true, worktreeProvisioning: true, sessionSpawning: true },
         writeStrategy: "vendor-first",
         // Claude Code is always a candidate default.
         detect: () => true,
@@ -86,7 +86,7 @@ export const MCP_HOST_TARGETS = {
         displayPath: ".cursor/mcp.json",
         hostKind: "cursor-json",
         launchAgent: "cursor-agent",
-        worktreeSupported: true,
+        capabilities: { mcpConfiguration: true, customCommands: true, worktreeProvisioning: true, sessionSpawning: true },
         writeStrategy: "direct",
         detect: (ctx) => ctx.exists(joinPath(ctx.cwd, ".cursor")) ||
             typeof ctx.env.CURSOR_TRACE_DIR === "string" &&
@@ -99,7 +99,7 @@ export const MCP_HOST_TARGETS = {
         relPath: ".vscode/mcp.json",
         displayPath: ".vscode/mcp.json",
         hostKind: "vscode-json",
-        worktreeSupported: false,
+        capabilities: { mcpConfiguration: true, customCommands: true, worktreeProvisioning: false, sessionSpawning: false },
         writeStrategy: "direct",
         detect: (ctx) => ctx.exists(joinPath(ctx.cwd, ".vscode")),
     },
@@ -111,7 +111,10 @@ export const MCP_HOST_TARGETS = {
         displayPath: "~/.codex/config.toml",
         hostKind: "codex-toml",
         vendorCli: { bin: "codex", kind: "codex-add" },
-        worktreeSupported: false,
+        launchAgent: "codex",
+        // The launcher injects a per-process, worktree-bound MCP table. The global
+        // registration remains the ordinary interactive default.
+        capabilities: { mcpConfiguration: true, customCommands: true, worktreeProvisioning: true, sessionSpawning: true },
         writeStrategy: "vendor-first",
         detect: (ctx) => ctx.exists(joinPath(ctx.homedir, ".codex")),
     },
@@ -122,7 +125,7 @@ export const MCP_HOST_TARGETS = {
         absPathResolver: (homedir) => joinPath(homedir, ".codeium/windsurf/mcp_config.json"),
         displayPath: "~/.codeium/windsurf/mcp_config.json",
         hostKind: "claude-code-json", // Windsurf uses the Claude-compatible JSON shape.
-        worktreeSupported: false,
+        capabilities: { mcpConfiguration: true, customCommands: false, worktreeProvisioning: false, sessionSpawning: false },
         // Preserve current behavior: never auto-modify the global Windsurf file.
         writeStrategy: "manual-instructions",
         detect: (ctx) => ctx.exists(joinPath(ctx.cwd, ".windsurf")) ||
@@ -153,18 +156,22 @@ export function getHostTarget(id) {
     return isHostPlatformId(id) ? MCP_HOST_TARGETS[id] : undefined;
 }
 /**
- * The centrally-registered launchable agent for a host platform, or `undefined`
- * when the platform has no supported agentic CLI (Copilot / Codex / Windsurf).
+ * The centrally-registered agent identity for a host platform, or `undefined`
+ * when the platform has no registered agent (Copilot / Windsurf).
  * Pure projection of the registry's {@link HostTargetDefinition.launchAgent}
- * metadata — the single source of truth for which selected tools can open a
- * post-install configuration session (BAPI-657).
+ * metadata. Callers must check workflow-specific capabilities before launching.
  */
 export function agentForPlatform(id) {
     return MCP_HOST_TARGETS[id].launchAgent;
 }
-/** The two worktree-supported targets, in stable order (Claude, Cursor). */
+/** Hosts whose declared workflow capability permits worktree provisioning. */
 export function getWorktreeHostTargets() {
-    return allHostTargets().filter((t) => t.worktreeSupported);
+    return allHostTargets().filter((t) => t.capabilities.worktreeProvisioning);
+}
+/** True only when a host has every capability needed for a spawned workflow. */
+export function isRunnableHostTarget(target) {
+    const c = target.capabilities;
+    return c.mcpConfiguration && c.customCommands && c.worktreeProvisioning && c.sessionSpawning && target.launchAgent !== undefined;
 }
 /** Project-scoped JSON targets (used by init, launcher-token merge, doctor). */
 export function getProjectJsonTargets() {

package/build/mcp-provisioning.js

@@ -138,7 +138,7 @@ export function buildMcpServerEntriesForManifest(manifest, absoluteWorktreePath,
 /** Both registration files written for every provisioned worktree. */
 export function getWorktreeMcpRegistrationTargets(worktreePath, platform) {
     const api = pathApiForProvisioningPlatform(platform);
-    return getWorktreeHostTargets().map((target) => ({
+    return getWorktreeHostTargets().filter((target) => target.scope === "project").map((target) => ({
         filePath: api.join(worktreePath, target.relPath),
         topLevelKey: hostAdapterForTarget(target).topLevelKey,
     }));

package/build/mcp-registration-doctor.js

@@ -104,7 +104,7 @@ export function isBridgeApiShimEntry(entry, worktreeRoot) {
  * to validate.
  */
 export async function probeWorktreeMcpRegistration(worktreeRoot, deps) {
-    const targets = getWorktreeHostTargets().map((target) => ({
+    const targets = getWorktreeHostTargets().filter((target) => target.scope === "project").map((target) => ({
         filePath: path.join(worktreeRoot, target.relPath),
         topLevelKey: hostAdapterForTarget(target).topLevelKey,
     }));