@bridge_gpt/mcp-server 0.2.26 → 0.2.27

package/build/init.js

@@ -33,9 +33,16 @@ export function buildBridgeApiEntry(cwd) {
     // where 0.2.6 persisted despite an upgrade). Pinning keeps the running
     // configuration predictable and visible in version control. The `install-bridge`
     // config write reuses this same entry so both install paths agree.
+    //
+    // `--prefer-offline` makes npx resolve the (immutable, exact-pinned) version
+    // from the local npm cache and skip the redundant registry-metadata round-trip
+    // on every boot, only hitting the network on a genuine cache miss (unlike
+    // `--offline`, it falls back automatically). It cannot resurrect a stale build
+    // — the BAPI-429 hazard above was specific to UNPINNED specs; here the exact
+    // `@${VERSION}` is immutable, so a cache hit is always the right build.
     return {
         command: "npx",
-        args: ["-y", `@bridge_gpt/mcp-server@${VERSION}`],
+        args: ["-y", "--prefer-offline", `@bridge_gpt/mcp-server@${VERSION}`],
         env: {
             BAPI_BASE_URL: "https://bridgegpt-api.com",
             BAPI_REPO_NAME: "YOUR_REPO_NAME",
@@ -143,6 +150,32 @@ async function ensureGitignored(cwd, filePath) {
         mkdir: (p, options) => mkdir(p, options),
     });
 }
+/**
+ * Read-compare-write a single scaffold file. Returns "skipped" when the target
+ * already holds identical bytes (no write), "overwritten" when it existed with
+ * different bytes, and "written" when it was absent. Optionally ensures `mkdirDir`
+ * exists first (used by the DOCS phase, whose targets span different subdirs).
+ *
+ * Extracted so the COMMANDS/DOCS/AGENTS phases can run their per-file work
+ * concurrently via Promise.all instead of one-await-at-a-time: on a slow disk the
+ * sequential syscalls dominated `runInit`. The caller applies each outcome to its
+ * summary Sets AFTER the batch, iterating the ordered results, so behavior and
+ * console output are byte-for-byte identical to the sequential version.
+ */
+async function scaffoldFile(target, content, mkdirDir) {
+    if (mkdirDir !== undefined)
+        await mkdir(mkdirDir, { recursive: true });
+    let existed = false;
+    try {
+        const existing = await readFile(target, "utf-8");
+        if (existing === content)
+            return "skipped";
+        existed = true;
+    }
+    catch { /* file doesn't exist */ }
+    await writeFile(target, content, "utf-8");
+    return existed ? "overwritten" : "written";
+}
 /**
  * Core initialization logic shared by --init and --upgrade.
  * Runs all scaffolding phases without calling process.exit().
@@ -272,22 +305,22 @@ export async function runInit(cwd) {
     const writtenFiles = new Set();
     const skippedFiles = new Set();
     const overwrittenFiles = new Set();
+    const commandEntries = Object.entries(COMMANDS);
     for (const dir of commandDirs) {
         await mkdir(dir, { recursive: true });
-        for (const [filename, content] of Object.entries(COMMANDS)) {
-            const target = path.join(dir, filename);
-            try {
-                const existing = await readFile(target, "utf-8");
-                if (existing === content) {
-                    skippedFiles.add(filename);
-                    continue;
-                }
-                overwrittenFiles.add(filename);
+        // 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)));
+        commandEntries.forEach(([filename], i) => {
+            const outcome = outcomes[i];
+            if (outcome === "skipped") {
+                skippedFiles.add(filename);
+                return;
             }
-            catch { /* file doesn't exist */ }
-            await writeFile(target, content, "utf-8");
+            if (outcome === "overwritten")
+                overwrittenFiles.add(filename);
             writtenFiles.add(filename);
-        }
+        });
     }
     // A file written in any directory takes priority over skipped
     for (const f of writtenFiles)
@@ -312,20 +345,21 @@ export async function runInit(cwd) {
     // project root; content is never secret.
     const docsWritten = new Set();
     const docsSkipped = new Set();
-    for (const [relTarget, content] of Object.entries(DOCS)) {
+    const docEntries = Object.entries(DOCS);
+    // Each doc target may live in a different subdir, so mkdir(dirname) happens
+    // per-file inside scaffoldFile. Outcomes applied in entry order below preserve
+    // the insertion order of the joined summary list.
+    const docOutcomes = await Promise.all(docEntries.map(([relTarget, content]) => {
         const target = path.join(cwd, relTarget);
-        await mkdir(path.dirname(target), { recursive: true });
-        try {
-            const existing = await readFile(target, "utf-8");
-            if (existing === content) {
-                docsSkipped.add(relTarget);
-                continue;
-            }
-        }
-        catch { /* file doesn't exist */ }
-        await writeFile(target, content, "utf-8");
-        docsWritten.add(relTarget);
-    }
+        return scaffoldFile(target, content, path.dirname(target));
+    }));
+    docEntries.forEach(([relTarget], i) => {
+        // DOCS tracks only written vs skipped; an overwrite counts as written.
+        if (docOutcomes[i] === "skipped")
+            docsSkipped.add(relTarget);
+        else
+            docsWritten.add(relTarget);
+    });
     const docsTotal = Object.keys(DOCS).length;
     if (docsTotal > 0) {
         console.log(`\nDocumentation: scaffolded ${docsTotal} doc asset${docsTotal === 1 ? "" : "s"}`);
@@ -341,42 +375,32 @@ export async function runInit(cwd) {
     // Always scaffold to .claude/agents/
     const claudeAgentsDir = path.join(cwd, ".claude", "agents");
     await mkdir(claudeAgentsDir, { recursive: true });
-    for (const [key, agent] of Object.entries(AGENTS)) {
-        const filename = `${key}.md`;
-        const content = reconstructAgentMarkdown(agent.frontmatter, agent.body);
-        const target = path.join(claudeAgentsDir, filename);
-        try {
-            const existing = await readFile(target, "utf-8");
-            if (existing === content) {
+    const agentEntries = Object.entries(AGENTS);
+    // Apply a batch of ordered outcomes to the agent Sets (same branches as the
+    // original per-file loop: skipped → skipped; overwritten → overwritten+written;
+    // written → written).
+    const applyAgentOutcomes = (filenames, outcomes) => {
+        filenames.forEach((filename, i) => {
+            const outcome = outcomes[i];
+            if (outcome === "skipped") {
                 agentSkipped.add(filename);
-                continue;
+                return;
             }
-            agentOverwritten.add(filename);
-        }
-        catch { /* file doesn't exist */ }
-        await writeFile(target, content, "utf-8");
-        agentWritten.add(filename);
-    }
+            if (outcome === "overwritten")
+                agentOverwritten.add(filename);
+            agentWritten.add(filename);
+        });
+    };
+    const claudeAgentFilenames = agentEntries.map(([key]) => `${key}.md`);
+    const claudeAgentOutcomes = await Promise.all(agentEntries.map(([key, agent]) => scaffoldFile(path.join(claudeAgentsDir, `${key}.md`), reconstructAgentMarkdown(agent.frontmatter, agent.body))));
+    applyAgentOutcomes(claudeAgentFilenames, claudeAgentOutcomes);
     // Scaffold to .github/agents/ for VS Code / Copilot
     if (ideDetection.vscode) {
         const copilotAgentsDir = path.join(cwd, ".github", "agents");
         await mkdir(copilotAgentsDir, { recursive: true });
-        for (const [key, agent] of Object.entries(AGENTS)) {
-            const filename = `${key}.agent.md`;
-            const content = translateAgentToCopilot(agent.frontmatter, agent.body);
-            const target = path.join(copilotAgentsDir, filename);
-            try {
-                const existing = await readFile(target, "utf-8");
-                if (existing === content) {
-                    agentSkipped.add(filename);
-                    continue;
-                }
-                agentOverwritten.add(filename);
-            }
-            catch { /* file doesn't exist */ }
-            await writeFile(target, content, "utf-8");
-            agentWritten.add(filename);
-        }
+        const copilotAgentFilenames = agentEntries.map(([key]) => `${key}.agent.md`);
+        const copilotAgentOutcomes = await Promise.all(agentEntries.map(([key, agent]) => scaffoldFile(path.join(copilotAgentsDir, `${key}.agent.md`), translateAgentToCopilot(agent.frontmatter, agent.body))));
+        applyAgentOutcomes(copilotAgentFilenames, copilotAgentOutcomes);
     }
     // TODO: Add Cursor agent scaffolding when Cursor publishes a formal agent spec
     // A file written in any directory takes priority over skipped

package/build/install-bridge.js

@@ -113,7 +113,11 @@ export const MCP_TIMEOUT_GUIDANCE = "Note: if your MCP client has a very short c
     "(the initial npx package resolution/download can exceed a short connect timeout).";
 /** The exact, version-pinned launcher spec the pre-warm spawns (fast-exiting --version). */
 export function buildPrewarmArgs() {
-    return ["-y", `@bridge_gpt/mcp-server@${VERSION}`, "--version"];
+    // `--prefer-offline`: the initial `@latest` bootstrap already populated the npm
+    // cache with the exact tarball this `@${VERSION}`-pinned warm needs, so resolve
+    // from cache and skip the redundant registry-metadata round-trip (falls back to
+    // the network on a genuine miss).
+    return ["-y", "--prefer-offline", `@bridge_gpt/mcp-server@${VERSION}`, "--version"];
 }
 /** Secret-free preview of the pre-warm command (no env, no key). */
 export function buildPrewarmCommandPreview() {
@@ -1942,6 +1946,21 @@ export async function runInstallBridgeCli(argv, overrides = {}) {
             "Check that the system temporary directory is writable so the launch script can be used.");
         return 1;
     }
+    // ---- Step 3b (kickoff) — pre-warm the @${VERSION}-pinned _npx bucket ----
+    // The @${VERSION}-pinned launcher written below lives in a DIFFERENT _npx bucket
+    // than the @latest bucket this `npx … install-bridge` invocation warmed, so the
+    // first real MCP launch would otherwise pay a cold install inline (which can
+    // exceed the client's connect deadline). Nothing before the Step 5 terminal spawn
+    // depends on the warmed bucket — only the spawned session's first MCP launch does
+    // — so START the warm HERE (fire-and-forget) and AWAIT it just before that spawn.
+    // Its multi-second `npx` resolve then overlaps the network round-trips (ping /
+    // exchange), the scaffold, and the config/credential writes instead of adding to
+    // them serially. Strictly fail-open: the default impl always RESOLVES (never
+    // rejects), so a later abort-return that skips the await leaves no unhandled
+    // rejection. Positioned AFTER the launch-command guards above so an aborted run
+    // that never reaches an install side effect also never spawns the pre-warm.
+    log("  pre-warming the version-pinned launcher bucket (in the background)…");
+    const prewarmPromise = deps.spawnPrewarm("npx", buildPrewarmArgs(), deps.env);
     const credentialWriteDeps = {
         env: deps.env,
         homedir: deps.homedir,
@@ -2238,25 +2257,6 @@ export async function runInstallBridgeCli(argv, overrides = {}) {
         // ensureGitignored for the state file can still throw — also advisory.
         errorLog("Warning: could not persist the install-state file (non-fatal).");
     }
-    // ---- Step 3b — pre-warm the @${VERSION}-pinned _npx bucket (BAPI-451 W3) ----
-    // The launcher just written is pinned to @${VERSION}, a DIFFERENT _npx bucket
-    // than the @latest bucket this `npx … install-bridge` invocation warmed. Spawn
-    // the exact pinned launcher once with the fast-exiting `--version` flag so the
-    // first real MCP launch resolves from a warm bucket instead of paying the cold
-    // install inline (which can exceed the client's connect deadline). Strictly
-    // fail-open: a failure warns (secret-free) but never fails the install.
-    log("  pre-warming the version-pinned launcher bucket…");
-    const prewarm = await deps.spawnPrewarm("npx", buildPrewarmArgs(), deps.env);
-    if (prewarm.ok) {
-        log("  launcher bucket warmed (the first MCP launch will not pay a cold install).");
-        log(`  ${MCP_TIMEOUT_GUIDANCE}`);
-    }
-    else {
-        // Escalate to a stronger, still secret-free warning when pre-warm didn't
-        // complete cleanly — but the install itself still succeeds (exit unaffected).
-        errorLog(`Warning: could not pre-warm the version-pinned launcher bucket${prewarm.warning ? ` (${prewarm.warning})` : ""}. ` +
-            `The first MCP launch may pay a one-time cold install and could be slow. ${MCP_TIMEOUT_GUIDANCE}`);
-    }
     // ---- Step 4 — persist the credential ----
     if (bootstrapInviteMode) {
         // FAIL-CLOSED (unlike normal mode below). The pending secret IS the minted admin
@@ -2306,6 +2306,22 @@ export async function runInstallBridgeCli(argv, overrides = {}) {
     // observe GitHub as configured if the user connects it here, and running it after the
     // spawn would put two prompts on the same terminal at once.
     await offerGithubConnection(repoName, deps, log);
+    // ---- Step 3b (await) — settle the background pre-warm before the session opens ----
+    // The warm was kicked off right after the launch-command guards (above); await it
+    // HERE so the bucket is settled before the spawned session's first MCP launch, but
+    // AFTER all the work it overlapped with. Strictly fail-open — the exit code is
+    // never affected, mirroring the original inline Step 3b behavior.
+    const prewarm = await prewarmPromise;
+    if (prewarm.ok) {
+        log("  launcher bucket warmed (the first MCP launch will not pay a cold install).");
+        log(`  ${MCP_TIMEOUT_GUIDANCE}`);
+    }
+    else {
+        // Escalate to a stronger, still secret-free warning when pre-warm didn't
+        // complete cleanly — but the install itself still succeeds (exit unaffected).
+        errorLog(`Warning: could not pre-warm the version-pinned launcher bucket${prewarm.warning ? ` (${prewarm.warning})` : ""}. ` +
+            `The first MCP launch may pay a one-time cold install and could be slow. ${MCP_TIMEOUT_GUIDANCE}`);
+    }
     // ---- Step 5 — spawn a fresh agent session for the agentic remainder ----
     log(`Step 5/5 — opening a ${agent.name} session for /install-bridge configuration + capability report…`);
     const terminal = detectTerminal(undefined, deps.env);

package/build/version.generated.js

@@ -1,2 +1,2 @@
 // AUTO-GENERATED — do not edit manually. Regenerate with: npm run build
-export const VERSION = "0.2.26";
+export const VERSION = "0.2.27";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge_gpt/mcp-server",
-  "version": "0.2.26",
+  "version": "0.2.27",
   "description": "Bridge API MCP server — exposes Jira endpoints as MCP tools for Claude Code agents",
   "license": "MIT",
   "type": "module",
@@ -15,9 +15,7 @@
     "!build/**/*.test.js",
     "!build/integration/**",
     "pipelines/",
-    "smoke-test/",
     "design-assets/",
-    "public/",
     "README.md",
     "docs/",
     "LICENSE"

package/design-assets/favicon/site.webmanifest

@@ -1 +0,0 @@
-{"name":"","short_name":"","icons":[{"src":"/android-chrome-192x192.png","sizes":"192x192","type":"image/png"},{"src":"/android-chrome-512x512.png","sizes":"512x512","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}