@bridge_gpt/mcp-server 0.2.27 → 0.2.29

package/build/setup-epic.js

@@ -24,8 +24,29 @@
  */
 import { readFile as fsReadFile, stat as fsStat } from "node:fs/promises";
 import os from "node:os";
+import readline from "node:readline";
 import { approveEpicPlan, createEpicRun, fetchEpicRunState, resolveConductorBridgeApiAccess, storeEpicPlan, ConductorBridgeApiError, } from "./conductor/bridge-api-client.js";
+import { validateBranchName } from "./base-ref.js";
 import { hashPlan } from "./conductor/plan.js";
+/** Echoed single-line prompt on stderr (mirrors connect-github's helper). */
+function defaultPromptLine(promptText) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+        // `rl.close()` emits `close` SYNCHRONOUSLY, so without this guard the close
+        // handler would settle the promise empty and discard a real answer. EOF must
+        // also resolve rather than deadlock a top-level await.
+        let answered = false;
+        rl.on("close", () => {
+            if (!answered)
+                resolve("");
+        });
+        rl.question(promptText, (answer) => {
+            answered = true;
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
 export function createDefaultSetupEpicDeps() {
     return {
         env: process.env,
@@ -37,6 +58,8 @@ export function createDefaultSetupEpicDeps() {
         fetch: globalThis.fetch,
         log: (m) => console.log(m),
         errorLog: (m) => console.error(m),
+        isTTY: Boolean(process.stdin.isTTY),
+        promptLine: defaultPromptLine,
     };
 }
 /** User-facing usage text. */
@@ -54,6 +77,11 @@ export function getSetupEpicUsage() {
         "Options:",
         "  --repo <name>          Repo name (default: BAPI_REPO_NAME or .bridge/config)",
         "  --plan-version <n>     Assert the sidecar's plan_version equals <n>",
+        "  --feature-branch <name>  Run the epic on a dedicated feature branch.",
+        "                         The branch is created from the repository base branch",
+        "                         on origin, and every child-ticket PR targets it.",
+        "                         Omit (the default) to continue on the repository base",
+        "                         branch. Interactive runs are offered a proposal.",
         "  --dry-run              Validate and preview; make no mutating calls",
         "  --json                 Emit a single JSON result object on stdout",
         "  -h, --help             Show this help",
@@ -69,6 +97,24 @@ function takeValue(argv, i, flag) {
         return null;
     return next;
 }
+/**
+ * Normalize + validate a raw `--feature-branch` value.
+ *
+ * Trims the value; an explicitly blank value normalizes to `undefined` (no
+ * option), matching "omit to continue on the base branch". A nonblank value is
+ * validated with the shared {@link validateBranchName}; a malformed value yields
+ * a flag-specific error. Returns a discriminated result so the caller can report
+ * the error without consuming a following flag.
+ */
+function parseFeatureBranchValue(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return { ok: true, value: undefined };
+    const reason = validateBranchName(trimmed);
+    if (reason)
+        return { ok: false, error: `Invalid --feature-branch value: ${reason}` };
+    return { ok: true, value: trimmed };
+}
 export function parseSetupEpicArgs(argv) {
     if (argv.includes("-h") || argv.includes("--help")) {
         return { status: "help", usage: getSetupEpicUsage() };
@@ -77,11 +123,32 @@ export function parseSetupEpicArgs(argv) {
     let planFile;
     let repo;
     let planVersion;
+    let featureBranch;
     let dryRun = false;
     let json = false;
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
+        // `--feature-branch=<name>` inline form (handled before the exact-match switch).
+        if (arg.startsWith("--feature-branch=")) {
+            const parsedFb = parseFeatureBranchValue(arg.slice("--feature-branch=".length));
+            if (!parsedFb.ok)
+                return { status: "error", message: parsedFb.error };
+            featureBranch = parsedFb.value;
+            continue;
+        }
         switch (arg) {
+            case "--feature-branch": {
+                // Do not consume a following flag as the value (Step 2.5).
+                const v = takeValue(argv, i, arg);
+                if (v === null)
+                    return { status: "error", message: "--feature-branch requires a value." };
+                const parsedFb = parseFeatureBranchValue(v);
+                if (!parsedFb.ok)
+                    return { status: "error", message: parsedFb.error };
+                featureBranch = parsedFb.value;
+                i++;
+                break;
+            }
             case "--epic-key": {
                 const v = takeValue(argv, i, arg);
                 if (v === null)
@@ -139,7 +206,7 @@ export function parseSetupEpicArgs(argv) {
         return { status: "error", message: "setup-epic requires --plan-file <path>." };
     return {
         status: "ok",
-        options: { epicKey, planFile, repo, planVersion, dryRun, json },
+        options: { epicKey, planFile, repo, planVersion, featureBranch, dryRun, json },
     };
 }
 /**
@@ -258,6 +325,55 @@ function findCycle(keys, adjacency) {
     }
     return null;
 }
+/** Propose a conductor epic feature branch name for an epic key (BAPI-655). */
+function proposeFeatureBranchName(epicKey) {
+    return `epic/${epicKey}`;
+}
+/**
+ * Resolve the epic feature branch selection for this invocation.
+ *
+ * Returns a validated branch name, or `undefined` to continue on the repository
+ * base branch. Precedence:
+ *
+ *   - An explicit `--feature-branch <name>` is already confirmed + validated at
+ *     parse time and is returned unchanged (no prompt).
+ *   - A non-interactive (piped/CI) run or a `--json` run never prompts and never
+ *     blocks — it retains the absent-branch behavior.
+ *   - An interactive run is shown the proposal (branch name, "create from the
+ *     repository base branch" strategy, and the child-PR-targeting consequence)
+ *     and may accept it, type a custom name, or decline to use the base branch.
+ *     An edited nonblank value is re-validated; an invalid value is redisplayed
+ *     for correction rather than silently rewritten.
+ */
+async function resolveFeatureBranchSelection(opts, repoName, deps) {
+    if (opts.featureBranch !== undefined)
+        return opts.featureBranch;
+    if (!deps.isTTY || opts.json)
+        return undefined;
+    const proposed = proposeFeatureBranchName(opts.epicKey);
+    deps.errorLog("");
+    deps.errorLog(`Feature branch (optional) for epic ${opts.epicKey} on ${repoName}:`);
+    deps.errorLog(`  Proposed:  ${proposed}`);
+    deps.errorLog(`  Strategy:  create a new branch from the repository base branch`);
+    deps.errorLog(`  Effect:    every child-ticket PR will target this branch`);
+    for (;;) {
+        const answer = (await deps.promptLine(`Use feature branch? 'y' = ${proposed}, a name = custom, Enter = base branch: `)).trim();
+        if (answer === "")
+            return undefined; // decline → repository base branch
+        const lowered = answer.toLowerCase();
+        if (lowered === "n" || lowered === "no")
+            return undefined;
+        if (lowered === "y" || lowered === "yes")
+            return proposed;
+        // Otherwise the answer is an edited branch name.
+        const reason = validateBranchName(answer);
+        if (reason) {
+            deps.errorLog(`  Invalid branch name: ${reason} Try again, or press Enter for the base branch.`);
+            continue; // redisplay for correction; never silently rewrite the value
+        }
+        return answer;
+    }
+}
 function errorDetail(err) {
     if (err instanceof ConductorBridgeApiError) {
         const status = err.status !== undefined ? ` (HTTP ${err.status})` : "";
@@ -334,14 +450,35 @@ export async function runSetupEpicCli(argv, overrides = {}) {
     say(`Local hash: ${localHash}`);
     for (const w of warnings)
         say(`  [warn] ${w}`);
+    // --- Feature branch selection (BAPI-655) --------------------------------
+    // Resolved AFTER local/access context is known but BEFORE any run-state read
+    // or mutating request, so malformed interactive input fails before network
+    // dispatch. Returns undefined to continue on the repository base branch.
+    const promptedInteractively = opts.featureBranch === undefined && deps.isTTY && !opts.json;
+    const featureBranch = await resolveFeatureBranchSelection(opts, access.repoName, deps);
+    if (featureBranch !== undefined) {
+        say(`Feature:    ${featureBranch} (create from repository base branch on origin)`);
+    }
+    else if (promptedInteractively) {
+        // Ordinary, non-warning notice — only when an interactive operator declined.
+        say("Feature:    none — continue using the repository base branch");
+    }
     // --- Step 0: pre-check ---------------------------------------------------
     // Never create on an ambiguous read. A wrong answer here mints a duplicate run.
     let existingRunId = null;
     let existingStatus = null;
+    let existingBaseBranch = null;
     try {
         const state = await fetchEpicRunState(access, opts.epicKey, deps.fetch);
         existingRunId = state.epic_run?.epic_run_id ?? null;
         existingStatus = state.epic_run?.status ?? null;
+        const existingPolicy = state.epic_run?.policy_json;
+        const existingBase = existingPolicy && typeof existingPolicy === "object"
+            ? existingPolicy.base_branch
+            : undefined;
+        existingBaseBranch = typeof existingBase === "string" && existingBase.trim() !== ""
+            ? existingBase
+            : null;
     }
     catch (err) {
         if (err instanceof ConductorBridgeApiError && err.status === 404) {
@@ -361,6 +498,19 @@ export async function runSetupEpicCli(argv, overrides = {}) {
             return 1;
         }
     }
+    // --- Feature-branch conflict guard against an existing live run ----------
+    // A selected branch that disagrees with the existing run's stored base branch
+    // must fail closed rather than patch or silently change that run. A matching
+    // branch is allowed (the rerun re-validates remote provisioning at approval);
+    // supplying no branch preserves the existing run's policy untouched.
+    if (existingRunId && featureBranch !== undefined && existingBaseBranch !== featureBranch) {
+        deps.errorLog(`Epic ${opts.epicKey} already has a live run (${existingRunId}) whose feature ` +
+            `branch is ${existingBaseBranch ? `'${existingBaseBranch}'` : "unset (base branch)"}, ` +
+            `which conflicts with the requested '${featureBranch}'. setup-epic will not ` +
+            `retarget or rebuild an existing run. Re-run without --feature-branch to reuse ` +
+            `it unchanged, or abandon the run to start over on a new branch.`);
+        return 1;
+    }
     if (opts.dryRun) {
         say("");
         say("[dry-run] No changes made. Would:");
@@ -370,6 +520,9 @@ export async function runSetupEpicCli(argv, overrides = {}) {
         else {
             say(`  - POST /jira/epic-runs/runs  (create run for ${opts.epicKey})`);
         }
+        if (featureBranch !== undefined) {
+            say(`  - feature branch: ${featureBranch} (create from repository base branch; no request made in dry-run)`);
+        }
         say(`  - POST /jira/epic-runs/runs/${opts.epicKey}/plan          (v${plan.plan_version})`);
         say(`  - POST /jira/epic-runs/runs/${opts.epicKey}/approve-plan  (v${plan.plan_version})`);
         if (opts.json) {
@@ -380,6 +533,8 @@ export async function runSetupEpicCli(argv, overrides = {}) {
                 plan_version: plan.plan_version,
                 local_plan_hash: localHash,
                 existing_run_id: existingRunId,
+                // Only present for a feature-branch run — no-feature JSON is unchanged.
+                ...(featureBranch !== undefined ? { feature_branch: featureBranch } : {}),
                 warnings,
             }, null, 2));
         }
@@ -398,13 +553,20 @@ export async function runSetupEpicCli(argv, overrides = {}) {
         plan_approved: false,
         warnings,
     };
+    if (featureBranch !== undefined)
+        result.feature_branch = featureBranch;
     // --- Step 1: create (only when there is no live run) ---------------------
     if (existingRunId) {
         say(`Run:        reusing ${existingRunId} (status: ${existingStatus})`);
     }
     else {
         try {
-            const run = await createEpicRun(access, { epicKey: opts.epicKey }, deps.fetch);
+            // Persist the confirmed feature branch as policy_json.base_branch ONLY when
+            // one was selected; otherwise keep the exact legacy create request shape.
+            const createRequest = featureBranch !== undefined
+                ? { epicKey: opts.epicKey, policyJson: { base_branch: featureBranch } }
+                : { epicKey: opts.epicKey };
+            const run = await createEpicRun(access, createRequest, deps.fetch);
             result.epic_run_id = run.epic_run_id;
             result.status = run.status;
             result.run_created = true;
@@ -439,9 +601,29 @@ export async function runSetupEpicCli(argv, overrides = {}) {
         deps.errorLog(`Failed to store the plan: ${errorDetail(err)}`);
         return 1;
     }
-    // --- Step 4: approve -----------------------------------------------------
+    // --- Step 4: approve (also provisions the feature branch server-side) -----
+    // For a feature-branch run the backend creates/validates the branch on origin
+    // as an approval prerequisite. Provisioning runs and completes BEFORE the
+    // approval (ticket-seeding + CAS activation) step server-side, so only a
+    // failure the backend tags with the structured FEATURE_BRANCH_PROVISIONING
+    // error_code is actually a branch/credentials problem — key the distinct
+    // message off that code, not merely off whether --feature-branch was passed,
+    // so an unrelated approval failure (e.g. ticket-seeding, a masked 500) is not
+    // misattributed to provisioning.
+    if (featureBranch !== undefined) {
+        say(`Branch:     creating or validating ${featureBranch} on origin…`);
+    }
     const approval = await approveEpicPlan(access, { epicKey: opts.epicKey, planVersion: plan.plan_version }, deps.fetch).catch((err) => {
-        deps.errorLog(`Failed to approve the plan: ${errorDetail(err)}`);
+        if (featureBranch !== undefined &&
+            err instanceof ConductorBridgeApiError &&
+            err.errorCode === "FEATURE_BRANCH_PROVISIONING") {
+            deps.errorLog(`Failed to provision the feature branch '${featureBranch}' — child-ticket ` +
+                `dispatch has NOT started. Correct repository access or the branch ` +
+                `configuration, then re-run setup-epic.\nDetail: ${errorDetail(err)}`);
+        }
+        else {
+            deps.errorLog(`Failed to approve the plan: ${errorDetail(err)}`);
+        }
         return null;
     });
     if (approval === null)
@@ -451,6 +633,18 @@ export async function runSetupEpicCli(argv, overrides = {}) {
         result.plan_hash = approval.plan_hash;
         result.status = "active";
         say(`Plan:       approved v${plan.plan_version}`);
+        const prov = approval.featureBranchProvisioning;
+        if (prov) {
+            result.feature_branch_provisioning = prov;
+            if (prov.status === "created") {
+                say(`Branch:     ready on origin — created '${prov.feature_branch}' from ` +
+                    `'${prov.source_branch}' at ${prov.source_sha}`);
+            }
+            else {
+                say(`Branch:     '${prov.feature_branch}' already exists — validated, unchanged ` +
+                    `(the remote ref was not moved or reset); head ${prov.remote_head_sha}`);
+            }
+        }
     }
     else if (approval.reason === "multiple_active_runs") {
         deps.errorLog(`Epic ${opts.epicKey} has MULTIPLE active runs — the plan could not be approved ` +

package/build/start-tickets.js

@@ -1064,10 +1064,13 @@ export function buildAgentPrompt(key, opts = {}) {
 }
 /**
  * Build the ordered argv for an agent invocation:
- * `[command, (--model, alias)?, prompt]`. The model flag+alias are appended ONLY
- * when the agent supports a model override AND `modelAlias` is a non-empty valid
- * alias; otherwise they are omitted entirely (fail-open). The prompt is always
- * the final argument. Pure and never throws on an invalid alias.
+ * `[command, (--model, alias)?, ...interactiveLaunchArgs, prompt]`. The model
+ * flag+alias are appended ONLY when the agent supports a model override AND
+ * `modelAlias` is a non-empty valid alias; otherwise they are omitted entirely
+ * (fail-open) without suppressing `interactiveLaunchArgs`. Any registry-declared
+ * `agent.interactiveLaunchArgs` (e.g. cursor-agent's `--trust`) are spread in
+ * next, before the prompt. The prompt is always the final argument. Pure and
+ * never throws on an invalid alias.
  */
 export function buildAgentInvocationArgv(agent, prompt, modelAlias) {
     const argv = [agent.command];
@@ -1076,14 +1079,16 @@ export function buildAgentInvocationArgv(agent, prompt, modelAlias) {
         isValidModelAlias(modelAlias)) {
         argv.push(agent.modelFlag, modelAlias);
     }
+    argv.push(...(agent.interactiveLaunchArgs ?? []));
     argv.push(prompt);
     return argv;
 }
 /**
  * Build the agent invocation string for the agent's prompt style, from the
  * validated argv array. The registry-controlled command head stays unquoted
- * (it is never untrusted input); every following argument (the optional
- * `--model <alias>` and the prompt) is run through the platform-correct `quote`.
+ * (it is never untrusted input); every following argument — the optional
+ * `--model <alias>` pair, any registry-declared interactive launch arguments,
+ * and the prompt — is run through the platform-correct `quote`.
  */
 export function buildAgentInvocation(agent, prompt, quote, modelAlias) {
     switch (agent.promptArgStyle) {
@@ -1098,12 +1103,12 @@ export function buildAgentInvocation(agent, prompt, quote, modelAlias) {
         }
     }
 }
-/** POSIX agent shell command: `cd '<path>' && <agent> [--model '<alias>'] '<prompt>'`. */
+/** POSIX agent shell command: `cd '<path>' && <agent> [--model '<alias>'] [...interactiveLaunchArgs] '<prompt>'`. */
 export function buildPosixAgentShellCommand(agent, key, worktreePath, autoApprove = false, modelAlias, conductorEnabled = false, resumeMode = false, workflow = "implement", reviewRounds, baseBranch) {
     const invocation = buildAgentInvocation(agent, buildAgentPrompt(key, { autoApprove, conductorEnabled, resumeMode, workflow, reviewRounds, baseBranch }), (p) => `'${shSquoteInner(p)}'`, modelAlias);
     return `cd '${shSquoteInner(worktreePath)}' && ${invocation}`;
 }
-/** PowerShell agent shell command: `Set-Location -LiteralPath '<path>'; <agent> [--model '<alias>'] '<prompt>'`. */
+/** PowerShell agent shell command: `Set-Location -LiteralPath '<path>'; <agent> [--model '<alias>'] [...interactiveLaunchArgs] '<prompt>'`. */
 export function buildPowerShellAgentShellCommand(agent, key, worktreePath, autoApprove = false, modelAlias, conductorEnabled = false, resumeMode = false, workflow = "implement", reviewRounds, baseBranch) {
     const invocation = buildAgentInvocation(agent, buildAgentPrompt(key, { autoApprove, conductorEnabled, resumeMode, workflow, reviewRounds, baseBranch }), powershellSquote, modelAlias);
     return `Set-Location -LiteralPath ${powershellSquote(worktreePath)}; ${invocation}`;
@@ -1130,7 +1135,12 @@ export function buildAgentShellCommand(agent, key, worktreePath, platform = "dar
  * everywhere else. The directory-change and agent invocation are quoted with the
  * platform-correct quoter (`Set-Location -LiteralPath …;` on Windows, `cd '…' &&`
  * on POSIX). An optional validated `modelAlias` is injected as `--model` at the
- * spawn boundary, exactly like `buildAgentShellCommand`.
+ * spawn boundary, exactly like `buildAgentShellCommand`. Any registry-declared
+ * `agent.interactiveLaunchArgs` (e.g. cursor-agent's `--trust`) are included
+ * automatically via the shared `buildAgentInvocation` call below — this covers
+ * both `start-tickets` (via its platform shell-command functions) and
+ * `install-bridge` (which reaches this function through its `buildShellCommand`
+ * dependency) without any caller-specific logic.
  */
 export function buildGenericAgentShellCommand(agent, prompt, cwd, platform = "darwin", modelAlias) {
     if (platform === "win32") {
@@ -1233,9 +1243,13 @@ export function buildITermAppleScript(shellCommand, title, badgeText) {
  * failure for expected spawn errors (never throws).
  */
 export async function spawnMacOSTerminalTab(deps, terminal, shellCommand, context) {
-    const title = terminalTitleForTicket(context?.key ?? "");
+    // BAPI-657: an explicit `context.title` overrides the key-derived title; absent it,
+    // real ticket tabs keep `<KEY> Implementation`. The iTerm badge follows the same
+    // rule — the override when supplied, otherwise the existing key-based badge.
+    const title = context?.title ?? terminalTitleForTicket(context?.key ?? "");
+    const badgeText = context?.title ?? (context?.key || undefined);
     const script = terminal === "iterm"
-        ? buildITermAppleScript(shellCommand, title, context?.key || undefined)
+        ? buildITermAppleScript(shellCommand, title, badgeText)
         : buildTerminalAppleScript(shellCommand, title);
     const result = await deps.runCommand("osascript", ["-e", script]);
     if (commandSucceeded(result))
@@ -1309,7 +1323,9 @@ export async function spawnWindowsTerminalTab(deps, _terminal, shellCommand, con
             error: "Windows spawner requires a worktreePath context to open a tab.",
         };
     }
-    const title = terminalTitleForTicket(context?.key ?? "");
+    // BAPI-657: honor an explicit title override for both the Windows Terminal tab and
+    // the PowerShell fallback window; absent it, keep the key-derived ticket title.
+    const title = context?.title ?? terminalTitleForTicket(context?.key ?? "");
     if (await isCommandOnPath(deps, WINDOWS_TERMINAL_COMMAND)) {
         const args = buildWindowsTerminalArgs(worktreePath, shellCommand, title);
         const result = await deps.runCommand(WINDOWS_TERMINAL_COMMAND, args);
@@ -1365,6 +1381,17 @@ export function sanitizeTmuxName(value) {
 export function tmuxWindowNameForTicket(key) {
     return terminalTitleForTicket(sanitizeTmuxName(key));
 }
+/**
+ * A tmux WINDOW label derived from an explicit `context.title` override (BAPI-657).
+ * Unlike a session identifier, a tmux window name may contain spaces, so this keeps
+ * them (`"Bridge Install"` stays `"Bridge Install"`) while stripping only the
+ * tmux-target-hostile `.`/`:` and collapsing whitespace runs. Falls back to
+ * `"session"` if the title reduces to empty.
+ */
+export function tmuxWindowLabelFromTitle(title) {
+    const cleaned = title.replace(/[.:]+/g, " ").replace(/\s+/g, " ").trim();
+    return cleaned.length > 0 ? cleaned : "session";
+}
 /** Resolve the tmux session-name prefix (env override, else the default). */
 export function tmuxSessionPrefix(deps) {
     const override = deps.env[TMUX_SESSION_OVERRIDE_ENV];
@@ -1418,7 +1445,11 @@ export async function spawnLinuxTmuxTerminalTab(deps, _terminal, shellCommand, c
         };
     }
     const session = tmuxSessionNameForTicket(deps, key);
-    const window = tmuxWindowNameForTicket(key);
+    // BAPI-657: an explicit title overrides only the WINDOW label; the SESSION
+    // identifier stays key-derived so `tmux attach -t <session>` is unchanged.
+    const window = context?.title
+        ? tmuxWindowLabelFromTitle(context.title)
+        : tmuxWindowNameForTicket(key);
     const paneCommand = buildTmuxPaneCommand(shellCommand);
     const hasSession = await deps.runCommand(TMUX_COMMAND, ["has-session", "-t", session]);
     const args = commandSucceeded(hasSession)

package/build/tool-surface-gating.js

@@ -36,8 +36,19 @@ import { getMethodLiteral } from "@modelcontextprotocol/sdk/server/zod-json-sche
 export const RECOGNIZED_TOOL_SURFACE_SCHEMA_VERSIONS = new Set([1]);
 /** The single recognized schema version (convenience export for tests). */
 export const TOOL_SURFACE_SCHEMA_VERSION = 1;
-/** Absolute end-to-end deadline for one probe (header resolve + fetch + parse). */
-export const TOOL_SURFACE_PROBE_DEADLINE_MS = 500;
+/**
+ * Absolute end-to-end deadline for one probe (header resolve + fetch + parse).
+ *
+ * The server handler does a catalog read plus two sequential Postgres round-trips
+ * and routinely lands at 600-900ms on Heroku, so a 500ms deadline aborted nearly
+ * every probe mid-response — the socket teardown surfaced as a continuous stream
+ * of Heroku `H27 "Client Request Interrupted"` router warnings, and the gating
+ * feature never took effect because the client always fell open on timeout. The
+ * deadline sits comfortably above observed server p99 with headroom, while
+ * staying well under the 12-18s poll interval so a slow probe never overlaps the
+ * next one.
+ */
+export const TOOL_SURFACE_PROBE_DEADLINE_MS = 2_500;
 /** Inclusive lower bound of the recurring-poll jitter window. */
 export const TOOL_SURFACE_POLL_MIN_MS = 12_000;
 /** Inclusive upper bound of the recurring-poll jitter window. */

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.27";
+export const VERSION = "0.2.29";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge_gpt/mcp-server",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "Bridge API MCP server — exposes Jira endpoints as MCP tools for Claude Code agents",
   "license": "MIT",
   "type": "module",
@@ -25,8 +25,8 @@
     "check:version-generated": "node scripts/bundle-version.js && node scripts/check-version-generated.js",
     "postbuild": "node scripts/prepend-shebang.cjs",
     "start": "node build/index.js",
-    "test": "node --test --test-force-exit build/pipeline-utils.test.js build/backend-warnings.test.js build/update-check.test.js build/cli-upgrade.test.js build/decision-page-schema.test.js build/decision-page-template.test.js build/bundle-pipelines.test.js build/instructions-contract.test.js build/pipeline-orchestrator-persistence.test.js build/pipeline-orchestrator-execution.test.js build/pipeline-orchestrator-integration.test.js build/index-static.test.js build/config-fields.static.test.js build/request-brainstorm.static.test.js build/execute-plan-instructions.static.test.js build/index-resolvers.test.js build/index-project-root.test.js build/index-pipelines.test.js build/index.test.js build/bridge-config.test.js build/credential-store.test.js build/agent-config-credential-migration.test.js build/mcp-invoke.test.js build/mcp-provisioning.test.js build/mcp-server-invocation.test.js build/third-party-mcp-targets.test.js build/git-ignore-utils.test.js build/credential-materialization.test.js build/mcp-registration-doctor.test.js build/mcp-host-targets.test.js build/mcp-install-state.test.js build/mcp-host-config.test.js build/secret-safety.test.js build/base-ref.test.js build/pr-base-contract.test.js build/start-tickets.test.js build/review-tickets.test.js build/start-tickets-base-branch.test.js build/agent-registry.test.js build/agent-registry.model-routing.test.js build/start-tickets.shell-model-routing.test.js build/start-tickets.bridge-api-model-routing.test.js build/start-tickets.tier-fetch-model-routing.test.js build/start-tickets.resolve-model-routing.test.js build/start-tickets.orchestrate-model-routing.test.js build/start-tickets.routing-diagnostics.test.js build/start-tickets-repo.test.js build/start-tickets-credential-invariants.static.test.js build/credentials-cli.test.js build/start-tickets-prereqs.test.js build/regression-check.test.js build/doctor.test.js build/install-doctor.test.js build/install-bridge.test.js build/install-bridge-invite.test.js build/install-bridge-prompt.test.js build/install-bridge-tools.test.js build/init.test.js build/init-docs.test.js build/resolveUploadAttachment.test.js build/package-static.test.js build/chain-utils.test.js build/chain-orchestrator.test.js build/scheduler-backends/types.test.js build/scheduler-backends/escaping.test.js build/scheduler-backends/launchd.test.js build/scheduler-backends/task-scheduler.test.js build/scheduler-backends/systemd-user.test.js build/scheduler-backends/at-fallback.test.js build/scheduler-backends/index.test.js build/command-catalog.test.js build/scheduled-prompt.test.js build/agent-launchers/claude.test.js build/agent-launchers/cursor.test.js build/agent-launchers/index.test.js build/schedule-store.test.js build/schedule-run.test.js build/setup-epic.test.js build/conductor-bundle-artifacts.test.js build/conductor-bundle-cli.test.js build/agent-capabilities/cli.test.js build/agent-capabilities/runner.test.js build/agent-capabilities/probes.test.js build/agent-capabilities/probe-context.test.js build/agent-capabilities/reporter.test.js build/conductor/taxonomy-and-errors.test.js build/conductor/github-mergeability.test.js build/conductor/merge-conflict-routing.test.js build/conductor/redaction-normalization.test.js build/conductor/claude-hook.test.js build/conductor/git-ci-types.test.js build/conductor/done-gate.test.js build/conductor/git-ci-taxonomy-payload.test.js build/conductor/bridge-api-client.test.js build/conductor/plan.test.js build/conductor/producer-ledger.test.js build/conductor/spec-review-producer.test.js build/conductor/git-producer.test.js build/conductor/git-hooks.test.js build/conductor/store-migration.test.js build/conductor/pr-discovery.test.js build/conductor/pr-ci-producer.test.js build/conductor/pr-review-producer.test.js build/conductor/doctor.test.js build/conductor/deny-enforcement-preflight.test.js build/conductor/errors.test.js build/conductor/store.test.js build/conductor/index-poll-ci-producer.test.js build/start-tickets-conductor.test.js build/start-tickets-conductor.spawn.test.js build/start-tickets-conductor-node-propagation.test.js build/start-tickets.non-mutating-base.test.js build/start-tickets-live-source-guard.test.js build/conductor/worker-ledger-cli.test.js build/conductor/supervisor-config.test.js build/conductor/supervisor-ledger.test.js build/conductor/supervisor-state-reducer.test.js build/conductor/supervisor-housekeeping-projection.test.js build/conductor/supervisor-escalation.test.js build/conductor/supervisor-retired-judgment.static.test.js build/conductor/supervisor-runtime.test.js build/conductor/supervisor-store-projection.test.js build/conductor/supervisor-cli.test.js build/conductor/supervisor-start-tickets.test.js build/conductor/supervisor-message-relay.test.js build/conductor/supervisor-state-message-events.test.js build/conductor/store-message-relay.test.js build/start-tickets-message-relay.test.js build/conductor/event-accessors.test.js build/conductor/merge-ledger.test.js build/conductor/deterministic-completion.static.test.js build/conductor/deterministic-completion.integration.test.js build/conductor/local-merge.test.js build/conductor/local-merge.static.test.js build/conductor/supervisor-merge.test.js build/conductor/bridge-api-merge-client.test.js build/conductor/bridge-api-epic-client.test.js build/conductor/supervisor-merge-runtime-state.test.js build/conductor/epic-state.test.js build/executor/claude-settings.test.js build/executor/cli.test.js build/executor/credentials.test.js build/executor/echo-acceptance.test.js build/executor/env.test.js build/executor/base-branch.test.js build/executor/heartbeat.test.js build/executor/http-client.test.js build/executor/job-runner.test.js build/executor/job-runner.payload-timeout.test.js build/executor/worker-finalization.test.js build/executor/job-runner.static.test.js build/executor/prompt-spec.test.js build/executor/job-types.test.js build/executor/recovery-job.static.test.js build/executor/observation.test.js build/executor/permissions.test.js build/executor/preflight.test.js build/executor/process.test.js build/executor/results.test.js build/executor/runner.test.js build/executor/terminal-mutation.test.js build/executor/worker-command.test.js build/executor/worktree-core.test.js build/executor/worktree.test.js build/executor/job-errors.test.js build/executor/worktree-inspection.test.js build/executor/resume-pre-spawn.test.js build/executor/verdict-artifact.test.js build/executor/worker-log.test.js build/executor/job-log-registry.test.js build/executor/viewer-tabs.test.js build/executor/watch-cli.test.js build/executor/merge-job.test.js build/executor/job-runner.merge.test.js build/executor/worktree-gc.test.js build/executor/runner.job-behaviors.test.js build/conductor/cli-freeze.test.js build/conductor/epic-reconcile.test.js build/conductor/epic-runtime.test.js build/conductor/epic-tick-sequence.test.js build/conductor/epic-runtime-post-action.test.js build/conductor/file-scope-guard.test.js build/conductor/file-scope-guard.integration.test.js build/mcp-profile.test.js build/mcp-profile-registration.test.js build/env-flags.test.js build/bridge-api-urls.test.js build/tool-surface-gating.test.js build/tools-budget.test.js build/visual-diff-worker.test.js build/visual-diff.test.js build/estimate-epic.test.js build/integration/measure-tools.test.js build/sfcc/config.test.js build/sfcc/ocapi-shape.test.js build/sfcc/output.test.js build/sfcc/credentials.test.js build/sfcc/ocapi-write-faults.test.js build/sfcc/write-guard.test.js build/sfcc/write-grants.test.js build/sfcc/write-result.test.js build/sfcc/writes.test.js build/sfcc/writes-system-object-payloads.test.js build/sfcc/writes-payloads.test.js build/sfcc/log-gate.test.js build/sfcc/log-query.test.js && node --experimental-test-module-mocks --test --test-force-exit build/index-heavy-read-truncation.test.js build/index-artifacts.test.js build/automation-progress.test.js build/index.review-rounds.test.js build/index-brainstorm-filenames.test.js build/index-output-path.test.js build/index-generate-decision-page.test.js build/index-generate-decision-page.integration.test.js build/visual-diff.registration.test.js build/visual-diff.attachment-adapter.test.js build/attachment-download.test.js build/attachment-upload.test.js build/conductor/paths.test.js build/conductor/store-lifecycle.test.js build/conductor/store-queries.test.js build/conductor/tools.test.js build/conductor/cli.test.js build/conductor/security-regressions.test.js build/conductor/git-inspection.test.js build/conductor/tools-done-gate.test.js build/conductor/pr-ci-producer-emit-seam.test.js build/conductor/cli-git-hooks.test.js build/sfcc/client.test.js build/sfcc/tool-wrapper.test.js build/sfcc/setup-status.test.js build/sfcc/permissions.test.js build/sfcc/register.test.js build/sfcc/reads-system-object.test.js build/sfcc/reads-custom-object-def.test.js build/sfcc/reads-site-preference.test.js build/sfcc/writes-system-object.test.js build/sfcc/writes-custom-object-def.test.js build/sfcc/writes-site-preference.test.js build/connect-github.test.js",
-    "test:integration": "node --test build/integration/refresh-main.integration.test.js build/integration/start-tickets.integration.test.js build/integration/start-tickets-tier-handoff.integration.test.js build/integration/doctor.integration.test.js build/integration/agent-capabilities.integration.test.js build/integration/conductor-producer.integration.test.js build/integration/conductor-message-relay.integration.test.js build/integration/executor-http-runner.integration.test.js build/integration/executor-job-behaviors.integration.test.js build/integration/executor-recovery-jobs.integration.test.js build/integration/executor-spec-review-prompt.integration.test.js build/integration/resume-pre-spawn.git.integration.test.js build/integration/worker-finalization-origin.integration.test.js build/integration/post-remediation-merge-ci-wait.integration.test.js build/integration/executor-merge-supervision.integration.test.js build/integration/attachment-binary-roundtrip.integration.test.js build/integration/dependent-ticket-fresh-base.integration.test.js build/integration/execute-plan-instructions.integration.test.js build/integration/conductor-bundle-artifacts.integration.test.js build/integration/install-bridge-repo-resolution.integration.test.js build/integration/capability-report-contract.integration.test.js build/integration/request-brainstorm-general.integration.test.js",
+    "test": "node --test --test-force-exit build/pipeline-utils.test.js build/backend-warnings.test.js build/update-check.test.js build/cli-upgrade.test.js build/decision-page-schema.test.js build/decision-page-template.test.js build/bundle-pipelines.test.js build/instructions-contract.test.js build/pipeline-orchestrator-persistence.test.js build/pipeline-orchestrator-execution.test.js build/pipeline-orchestrator-integration.test.js build/index-static.test.js build/config-fields.static.test.js build/request-brainstorm.static.test.js build/execute-plan-instructions.static.test.js build/index-resolvers.test.js build/index-project-root.test.js build/index-pipelines.test.js build/index.test.js build/bridge-config.test.js build/credential-store.test.js build/agent-config-credential-migration.test.js build/mcp-invoke.test.js build/mcp-provisioning.test.js build/mcp-server-invocation.test.js build/third-party-mcp-targets.test.js build/git-ignore-utils.test.js build/credential-materialization.test.js build/mcp-registration-doctor.test.js build/mcp-host-targets.test.js build/mcp-install-state.test.js build/mcp-host-config.test.js build/secret-safety.test.js build/base-ref.test.js build/pr-base-contract.test.js build/start-tickets.test.js build/review-tickets.test.js build/start-tickets-base-branch.test.js build/agent-registry.test.js build/agent-registry.model-routing.test.js build/start-tickets.shell-model-routing.test.js build/start-tickets.bridge-api-model-routing.test.js build/start-tickets.tier-fetch-model-routing.test.js build/start-tickets.resolve-model-routing.test.js build/start-tickets.orchestrate-model-routing.test.js build/start-tickets.routing-diagnostics.test.js build/start-tickets-repo.test.js build/start-tickets-credential-invariants.static.test.js build/credentials-cli.test.js build/start-tickets-prereqs.test.js build/regression-check.test.js build/doctor.test.js build/install-doctor.test.js build/install-bridge.test.js build/install-bridge-invite.test.js build/install-bridge-prompt.test.js build/install-bridge-tools.test.js build/init.test.js build/init-docs.test.js build/resolveUploadAttachment.test.js build/package-static.test.js build/chain-utils.test.js build/chain-orchestrator.test.js build/scheduler-backends/types.test.js build/scheduler-backends/escaping.test.js build/scheduler-backends/launchd.test.js build/scheduler-backends/task-scheduler.test.js build/scheduler-backends/systemd-user.test.js build/scheduler-backends/at-fallback.test.js build/scheduler-backends/index.test.js build/command-catalog.test.js build/scheduled-prompt.test.js build/agent-launchers/claude.test.js build/agent-launchers/cursor.test.js build/agent-launchers/index.test.js build/schedule-store.test.js build/schedule-run.test.js build/setup-epic.test.js build/conductor-bundle-artifacts.test.js build/conductor-bundle-cli.test.js build/agent-capabilities/cli.test.js build/agent-capabilities/runner.test.js build/agent-capabilities/probes.test.js build/agent-capabilities/probe-context.test.js build/agent-capabilities/reporter.test.js build/conductor/taxonomy-and-errors.test.js build/conductor/github-mergeability.test.js build/conductor/merge-conflict-routing.test.js build/conductor/redaction-normalization.test.js build/conductor/claude-hook.test.js build/conductor/git-ci-types.test.js build/conductor/done-gate.test.js build/conductor/git-ci-taxonomy-payload.test.js build/conductor/bridge-api-client.test.js build/conductor/plan.test.js build/conductor/producer-ledger.test.js build/conductor/spec-review-producer.test.js build/conductor/git-producer.test.js build/conductor/git-hooks.test.js build/conductor/store-migration.test.js build/conductor/pr-discovery.test.js build/conductor/pr-ci-producer.test.js build/conductor/pr-review-producer.test.js build/conductor/doctor.test.js build/conductor/deny-enforcement-preflight.test.js build/conductor/errors.test.js build/conductor/store.test.js build/conductor/index-poll-ci-producer.test.js build/start-tickets-conductor.test.js build/start-tickets-conductor.spawn.test.js build/start-tickets-conductor-node-propagation.test.js build/start-tickets.non-mutating-base.test.js build/start-tickets-live-source-guard.test.js build/conductor/worker-ledger-cli.test.js build/conductor/supervisor-config.test.js build/conductor/supervisor-ledger.test.js build/conductor/supervisor-state-reducer.test.js build/conductor/supervisor-housekeeping-projection.test.js build/conductor/supervisor-escalation.test.js build/conductor/supervisor-retired-judgment.static.test.js build/conductor/supervisor-runtime.test.js build/conductor/supervisor-store-projection.test.js build/conductor/supervisor-cli.test.js build/conductor/supervisor-start-tickets.test.js build/conductor/supervisor-message-relay.test.js build/conductor/supervisor-state-message-events.test.js build/conductor/store-message-relay.test.js build/start-tickets-message-relay.test.js build/conductor/event-accessors.test.js build/conductor/merge-ledger.test.js build/conductor/deterministic-completion.static.test.js build/conductor/deterministic-completion.integration.test.js build/conductor/local-merge.test.js build/conductor/local-merge.static.test.js build/conductor/supervisor-merge.test.js build/conductor/bridge-api-merge-client.test.js build/conductor/bridge-api-epic-client.test.js build/conductor/supervisor-merge-runtime-state.test.js build/conductor/epic-state.test.js build/executor/claude-settings.test.js build/executor/cli.test.js build/executor/credentials.test.js build/executor/echo-acceptance.test.js build/executor/env.test.js build/executor/base-branch.test.js build/executor/heartbeat.test.js build/executor/http-client.test.js build/executor/job-runner.test.js build/executor/job-runner.payload-timeout.test.js build/executor/worker-finalization.test.js build/executor/job-runner.static.test.js build/executor/prompt-spec.test.js build/executor/job-types.test.js build/executor/recovery-job.static.test.js build/executor/observation.test.js build/executor/permissions.test.js build/executor/preflight.test.js build/executor/process.test.js build/executor/results.test.js build/executor/runner.test.js build/executor/terminal-mutation.test.js build/executor/worker-command.test.js build/executor/worktree-core.test.js build/executor/worktree.test.js build/executor/job-errors.test.js build/executor/worktree-inspection.test.js build/executor/resume-pre-spawn.test.js build/executor/verdict-artifact.test.js build/executor/worker-log.test.js build/executor/job-log-registry.test.js build/executor/viewer-tabs.test.js build/executor/watch-cli.test.js build/executor/merge-job.test.js build/executor/job-runner.merge.test.js build/executor/worktree-gc.test.js build/executor/runner.job-behaviors.test.js build/conductor/cli-freeze.test.js build/conductor/epic-reconcile.test.js build/conductor/epic-runtime.test.js build/conductor/epic-tick-sequence.test.js build/conductor/epic-runtime-post-action.test.js build/conductor/file-scope-guard.test.js build/conductor/file-scope-guard.integration.test.js build/mcp-profile.test.js build/mcp-profile-registration.test.js build/env-flags.test.js build/bridge-api-urls.test.js build/tool-surface-gating.test.js build/tools-budget.test.js build/visual-diff-worker.test.js build/visual-diff.test.js build/estimate-epic.test.js build/integration/measure-tools.test.js build/sfcc/config.test.js build/sfcc/ocapi-shape.test.js build/sfcc/output.test.js build/sfcc/credentials.test.js build/sfcc/ocapi-write-faults.test.js build/sfcc/write-guard.test.js build/sfcc/write-grants.test.js build/sfcc/write-result.test.js build/sfcc/writes.test.js build/sfcc/writes-system-object-payloads.test.js build/sfcc/writes-payloads.test.js build/sfcc/log-gate.test.js build/sfcc/log-query.test.js && node --experimental-test-module-mocks --test --test-force-exit build/index-heavy-read-truncation.test.js build/index-artifacts.test.js build/automation-progress.test.js build/recovery-formatting.test.js build/wait-for-result.test.js build/ticket-wait-recovery.test.js build/council-wait-recovery.test.js build/index.review-rounds.test.js build/index-brainstorm-filenames.test.js build/index-output-path.test.js build/index-generate-decision-page.test.js build/index-generate-decision-page.integration.test.js build/visual-diff.registration.test.js build/visual-diff.attachment-adapter.test.js build/attachment-download.test.js build/attachment-upload.test.js build/conductor/paths.test.js build/conductor/store-lifecycle.test.js build/conductor/store-queries.test.js build/conductor/tools.test.js build/conductor/cli.test.js build/conductor/security-regressions.test.js build/conductor/git-inspection.test.js build/conductor/tools-done-gate.test.js build/conductor/pr-ci-producer-emit-seam.test.js build/conductor/cli-git-hooks.test.js build/sfcc/client.test.js build/sfcc/tool-wrapper.test.js build/sfcc/setup-status.test.js build/sfcc/permissions.test.js build/sfcc/register.test.js build/sfcc/reads-system-object.test.js build/sfcc/reads-custom-object-def.test.js build/sfcc/reads-site-preference.test.js build/sfcc/writes-system-object.test.js build/sfcc/writes-custom-object-def.test.js build/sfcc/writes-site-preference.test.js build/connect-github.test.js build/connect-github-api.test.js",
+    "test:integration": "node --test build/integration/refresh-main.integration.test.js build/integration/start-tickets.integration.test.js build/integration/start-tickets-tier-handoff.integration.test.js build/integration/doctor.integration.test.js build/integration/agent-capabilities.integration.test.js build/integration/conductor-producer.integration.test.js build/integration/conductor-message-relay.integration.test.js build/integration/executor-http-runner.integration.test.js build/integration/executor-job-behaviors.integration.test.js build/integration/executor-recovery-jobs.integration.test.js build/integration/executor-spec-review-prompt.integration.test.js build/integration/resume-pre-spawn.git.integration.test.js build/integration/worker-finalization-origin.integration.test.js build/integration/post-remediation-merge-ci-wait.integration.test.js build/integration/executor-merge-supervision.integration.test.js build/integration/attachment-binary-roundtrip.integration.test.js build/integration/dependent-ticket-fresh-base.integration.test.js build/integration/execute-plan-instructions.integration.test.js build/integration/conductor-bundle-artifacts.integration.test.js build/integration/install-bridge-repo-resolution.integration.test.js build/integration/capability-report-contract.integration.test.js build/integration/request-brainstorm-general.integration.test.js build/integration/request-council-trigger-drop.integration.test.js",
     "test:smoke": "node --test build/integration/packaged-cli-smoke.test.js",
     "prepublishOnly": "node scripts/bundle-assets.js && npm run build && node scripts/verify-shebang.cjs"
   },