@bridge_gpt/mcp-server 0.1.16 → 0.1.17

package/build/start-tickets.js

@@ -89,7 +89,8 @@ export function getStartTicketsUsage() {
         "  --terminal terminal|iterm   Override the macOS terminal app (default: auto-detect via $TERM_PROGRAM); honored on macOS only",
         "  --dry-run                   Print intended actions; create no worktrees, open no tabs",
         "  --branch KEY=BRANCH         Use BRANCH instead of feature/KEY for that ticket (repeatable)",
-        "  --no-refresh-main           Skip 'git fetch origin main' + fast-forward of local main",
+        "  --base-branch BRANCH        Cut new worktrees from BRANCH and refresh origin/BRANCH (default: main)",
+        "  --no-refresh-main           Skip refresh of the configured base branch (default main); historical name retained for backward compatibility",
         "  --max-parallel N            Max worktrees to create concurrently (default: 3)",
         "  -h, --help                  Show this help",
         "",
@@ -116,9 +117,11 @@ export function parseStartTicketsArgs(argv) {
     }
     let terminal;
     let dryRun = false;
+    let autoApprove = false;
     let refreshMain = true;
     let maxParallelRaw;
     let agentName = DEFAULT_AGENT_NAME;
+    let baseBranch = "main";
     const branchEntries = [];
     const keys = [];
     for (let i = 0; i < argv.length; i++) {
@@ -198,10 +201,36 @@ export function parseStartTicketsArgs(argv) {
             branchEntries.push(value);
             continue;
         }
+        if (arg === "--base-branch" || arg.startsWith("--base-branch=")) {
+            let value;
+            if (arg.startsWith("--base-branch=")) {
+                value = arg.slice("--base-branch=".length);
+            }
+            else {
+                // For the space-separated form, reject a following option token so we
+                // don't silently consume "--dry-run" (etc.) as the branch value.
+                const next = i + 1 < argv.length ? argv[i + 1] : undefined;
+                if (next === undefined || next.startsWith("-")) {
+                    return { status: "error", message: "--base-branch requires a value (a branch name)." };
+                }
+                value = takeValue();
+            }
+            const trimmed = (value ?? "").trim();
+            const error = validateBranchName(trimmed);
+            if (error) {
+                return { status: "error", message: `Invalid --base-branch value: ${error}` };
+            }
+            baseBranch = trimmed;
+            continue;
+        }
         if (arg === "--dry-run") {
             dryRun = true;
             continue;
         }
+        if (arg === "--auto-approve") {
+            autoApprove = true;
+            continue;
+        }
         if (arg === "--no-refresh-main") {
             refreshMain = false;
             continue;
@@ -277,13 +306,15 @@ export function parseStartTicketsArgs(argv) {
     }
     return {
         status: "ok",
-        options: { keys, terminal, dryRun, refreshMain, maxParallel, branchOverrides, agentName },
+        options: { keys, terminal, dryRun, autoApprove, refreshMain, maxParallel, branchOverrides, agentName, baseBranch },
     };
 }
 /** Returns an error string for an unsafe branch name, or null when valid. */
-function validateBranchName(branch) {
-    if (branch.length === 0)
+export function validateBranchName(branch) {
+    if (branch.trim().length === 0)
         return "branch name must not be empty.";
+    if (branch.length > 255)
+        return "branch name must be 255 characters or fewer.";
     if (branch.startsWith("-"))
         return "branch name must not start with '-'.";
     // Reject ASCII control characters (0x00-0x1F and 0x7F) without embedding
@@ -343,7 +374,7 @@ export function getDefaultSpawnTerminalTabForPlatform(platform) {
  * are always honored). Returns a structured error for unsupported platforms;
  * never throws.
  */
-export function resolveStartTicketsPlatformConfig(deps, agent) {
+export function resolveStartTicketsPlatformConfig(deps, agent, autoApprove = false) {
     if (!isSupportedStartTicketsPlatform(deps.platform)) {
         return { ok: false, error: unsupportedPlatformMessage(deps.platform) };
     }
@@ -353,7 +384,7 @@ export function resolveStartTicketsPlatformConfig(deps, agent) {
         config: {
             platform,
             worktrunkBinary: resolveWorktrunkBinary(platform, deps.env),
-            buildAgentShellCommand: (key, worktreePath) => buildAgentShellCommand(agent, key, worktreePath, platform),
+            buildAgentShellCommand: (key, worktreePath) => buildAgentShellCommand(agent, key, worktreePath, platform, autoApprove),
             spawnTerminalTab: deps.spawnTerminalTab,
         },
     };
@@ -522,84 +553,106 @@ export function parseGitWorktreeList(output) {
         entries.push(current);
     return entries;
 }
-/** Return the worktree path owning branch `main`, or null. */
-export function findMainWorktreePath(entries) {
+/** Return the worktree path owning branch `baseBranch`, or null. */
+export function findBaseWorktreePath(entries, baseBranch) {
     for (const entry of entries) {
-        if (entry.branch === "main")
+        if (entry.branch === baseBranch)
             return entry.path;
     }
     return null;
 }
 /**
- * Fetch origin/main and fast-forward local `main`. No-op when `refreshMain` is
- * false. Handles both checkout states:
+ * Compatibility wrapper: returns the worktree path owning branch `main`, or
+ * null. Defers to {@link findBaseWorktreePath} so the `main` and non-main paths
+ * stay identical.
+ */
+export function findMainWorktreePath(entries) {
+    return findBaseWorktreePath(entries, "main");
+}
+/**
+ * Fetch origin/<baseBranch> and fast-forward the local base branch. No-op when
+ * `refreshMain` is false. (The option key keeps its historical name so the
+ * `--no-refresh-main` user-facing flag remains backward-compatible; the
+ * behavior now follows whatever `baseBranch` resolves to, default `"main"`.)
  *
- *  - `main` IS checked out in a worktree → `git merge --ff-only` inside that
- *    worktree, so its index/working tree stay consistent (git forbids
+ * Handles both checkout states:
+ *
+ *  - `<baseBranch>` IS checked out in a worktree → `git merge --ff-only` inside
+ *    that worktree, so its index/working tree stay consistent (git forbids
  *    force-moving a checked-out branch ref).
- *  - `main` is NOT checked out anywhere (e.g. the primary checkout is on a
- *    feature/chore branch) → fast-forward the ref directly with
+ *  - `<baseBranch>` is NOT checked out anywhere (e.g. the primary checkout is
+ *    on a feature/chore branch) → fast-forward the ref directly with
  *    `git branch --force`, since no working tree depends on it. This is guarded
- *    by an ancestry check so a diverged local `main` is never clobbered, and it
- *    creates `main` from origin/main when no local ref exists yet.
+ *    by an ancestry check so a diverged local base is never clobbered, and it
+ *    creates the local base ref from origin when no local ref exists yet.
  *
  * Returns a structured failure for any expected problem (fetch failure, diverged
- * main, or a failed ref update).
+ * base branch, or a failed ref update).
  */
-export async function refreshMainBranch(deps, options) {
+export async function refreshBaseBranch(deps, options) {
     if (!options.refreshMain)
         return { ok: true };
-    const fetch = await deps.runCommand("git", ["fetch", "origin", "main"], {
+    const baseBranch = options.baseBranch;
+    const originRef = `origin/${baseBranch}`;
+    const fetch = await deps.runCommand("git", ["fetch", "origin", baseBranch], {
         cwd: deps.cwd,
     });
     if (!commandSucceeded(fetch)) {
         return {
             ok: false,
-            error: "git fetch origin main failed. Check your network and 'git remote get-url origin', or pass --no-refresh-main to skip.",
+            error: `git fetch origin ${baseBranch} failed. Check your network and 'git remote get-url origin', or pass --no-refresh-main to skip.`,
         };
     }
     const list = await deps.runCommand("git", ["worktree", "list", "--porcelain"], { cwd: deps.cwd });
     if (!commandSucceeded(list)) {
         return {
             ok: false,
-            error: "git worktree list --porcelain failed; cannot locate the main worktree.",
+            error: `git worktree list --porcelain failed; cannot locate the ${baseBranch} worktree.`,
         };
     }
-    const mainPath = findMainWorktreePath(parseGitWorktreeList(list.stdout));
-    // `main` is checked out somewhere: fast-forward it in place. git refuses to
+    const basePath = findBaseWorktreePath(parseGitWorktreeList(list.stdout), baseBranch);
+    // `<baseBranch>` is checked out somewhere: fast-forward it in place. git refuses to
     // force-move a checked-out branch ref, so we must go through merge.
-    if (mainPath) {
-        const merge = await deps.runCommand("git", ["merge", "--ff-only", "origin/main"], { cwd: mainPath });
+    if (basePath) {
+        const merge = await deps.runCommand("git", ["merge", "--ff-only", originRef], { cwd: basePath });
         if (!commandSucceeded(merge)) {
             return {
                 ok: false,
-                error: `Local main has diverged from origin/main (checked out at ${mainPath}). Resolve the divergence manually, or rerun with --no-refresh-main.`,
+                error: `Local ${baseBranch} has diverged from ${originRef} (checked out at ${basePath}). Resolve the divergence manually, or rerun with --no-refresh-main.`,
             };
         }
         return { ok: true };
     }
-    // `main` is not checked out in any worktree. No working tree depends on the
-    // ref, so fast-forward it directly — but only when it is a true fast-forward,
-    // never clobbering local-only commits. When local `main` does not exist yet,
-    // create it from origin/main.
-    if (await branchExists(deps, "main")) {
-        const ancestor = await deps.runCommand("git", ["merge-base", "--is-ancestor", "main", "origin/main"], { cwd: deps.cwd });
+    // `<baseBranch>` is not checked out in any worktree. No working tree depends
+    // on the ref, so fast-forward it directly — but only when it is a true
+    // fast-forward, never clobbering local-only commits. When the local base ref
+    // does not exist yet, create it from origin.
+    if (await branchExists(deps, baseBranch)) {
+        const ancestor = await deps.runCommand("git", ["merge-base", "--is-ancestor", baseBranch, originRef], { cwd: deps.cwd });
         if (!commandSucceeded(ancestor)) {
             return {
                 ok: false,
-                error: "Local main has diverged from origin/main. Resolve the divergence manually, or rerun with --no-refresh-main.",
+                error: `Local ${baseBranch} has diverged from ${originRef}. Resolve the divergence manually, or rerun with --no-refresh-main.`,
             };
         }
     }
-    const update = await deps.runCommand("git", ["branch", "--force", "main", "origin/main"], { cwd: deps.cwd });
+    const update = await deps.runCommand("git", ["branch", "--force", baseBranch, originRef], { cwd: deps.cwd });
     if (!commandSucceeded(update)) {
         return {
             ok: false,
-            error: "Failed to fast-forward local main to origin/main. Resolve manually, or rerun with --no-refresh-main.",
+            error: `Failed to fast-forward local ${baseBranch} to ${originRef}. Resolve manually, or rerun with --no-refresh-main.`,
         };
     }
     return { ok: true };
 }
+/**
+ * Compatibility wrapper around {@link refreshBaseBranch} that preserves the
+ * historical `refreshMainBranch(deps, { refreshMain })` signature for callers
+ * that target `main` specifically.
+ */
+export async function refreshMainBranch(deps, options) {
+    return refreshBaseBranch(deps, { refreshMain: options.refreshMain, baseBranch: "main" });
+}
 // ---------------------------------------------------------------------------
 // Concurrency + worktree creation
 // ---------------------------------------------------------------------------
@@ -643,11 +696,11 @@ export async function branchExists(deps, branch) {
  * tab spawning separately. The args are platform-agnostic; only the binary
  * differs (`wt` vs `git-wt`).
  */
-export function buildWtSwitchArgs(branch, exists) {
+export function buildWtSwitchArgs(branch, exists, baseBranch = "main") {
     if (exists) {
         return ["switch", "-y", branch, "--format=json"];
     }
-    return ["switch", "--create", "-y", branch, "--format=json"];
+    return ["switch", "--create", "-y", branch, "-b", baseBranch, "--format=json"];
 }
 /** Return the Node `path` API matching a platform (`win32` vs POSIX). */
 export function pathApiForPlatform(platform) {
@@ -698,11 +751,11 @@ function pickWorktreePathField(parsed) {
  * success (with key, branch, path) or a `create-failed` row on any expected
  * failure — never throws for per-ticket problems.
  */
-export async function createWorktreeForTicket(deps, key, branchOverrides, worktrunkBinary) {
+export async function createWorktreeForTicket(deps, key, branchOverrides, worktrunkBinary, baseBranch = "main") {
     const branch = resolveBranchForTicket(key, branchOverrides);
     try {
         const exists = await branchExists(deps, branch);
-        const args = buildWtSwitchArgs(branch, exists);
+        const args = buildWtSwitchArgs(branch, exists, baseBranch);
         const result = await deps.runCommand(worktrunkBinary, args, { cwd: deps.cwd });
         if (!commandSucceeded(result)) {
             const reason = (result.stderr || result.stdout || "").trim();
@@ -728,14 +781,18 @@ export async function createWorktreeForTicket(deps, key, branchOverrides, worktr
  * aborting the run.
  */
 export async function createWorktrees(deps, options, worktrunkBinary) {
-    return runWithConcurrency(options.keys, options.maxParallel, (key) => createWorktreeForTicket(deps, key, options.branchOverrides, worktrunkBinary));
+    return runWithConcurrency(options.keys, options.maxParallel, (key) => createWorktreeForTicket(deps, key, options.branchOverrides, worktrunkBinary, options.baseBranch));
 }
 // ---------------------------------------------------------------------------
 // Per-platform shell-command construction
 // ---------------------------------------------------------------------------
-/** The starter prompt handed to the selected agent. Identical for every agent. */
-export function buildAgentPrompt(key) {
-    return `/implement-ticket ${key}`;
+/**
+ * The starter prompt handed to the selected agent. Identical for every agent.
+ * When `autoApprove` is set, the implementation agent runs hands-off
+ * (`/implement-ticket <KEY> --auto-approve`) — used by full-automation chains.
+ */
+export function buildAgentPrompt(key, opts = {}) {
+    return `/implement-ticket ${key}${opts.autoApprove ? " --auto-approve" : ""}`;
 }
 /**
  * Build the agent invocation (`<command> <quotedPrompt>`) for the agent's prompt
@@ -754,13 +811,13 @@ export function buildAgentInvocation(agent, prompt, quote) {
     }
 }
 /** POSIX agent shell command: `cd '<path>' && <agent> '<prompt>'`. */
-export function buildPosixAgentShellCommand(agent, key, worktreePath) {
-    const invocation = buildAgentInvocation(agent, buildAgentPrompt(key), (p) => `'${shSquoteInner(p)}'`);
+export function buildPosixAgentShellCommand(agent, key, worktreePath, autoApprove = false) {
+    const invocation = buildAgentInvocation(agent, buildAgentPrompt(key, { autoApprove }), (p) => `'${shSquoteInner(p)}'`);
     return `cd '${shSquoteInner(worktreePath)}' && ${invocation}`;
 }
 /** PowerShell agent shell command: `Set-Location -LiteralPath '<path>'; <agent> '<prompt>'`. */
-export function buildPowerShellAgentShellCommand(agent, key, worktreePath) {
-    const invocation = buildAgentInvocation(agent, buildAgentPrompt(key), powershellSquote);
+export function buildPowerShellAgentShellCommand(agent, key, worktreePath, autoApprove = false) {
+    const invocation = buildAgentInvocation(agent, buildAgentPrompt(key, { autoApprove }), powershellSquote);
     return `Set-Location -LiteralPath ${powershellSquote(worktreePath)}; ${invocation}`;
 }
 /**
@@ -769,10 +826,10 @@ export function buildPowerShellAgentShellCommand(agent, key, worktreePath) {
  * dry-run fallback). The selected `agent` (never a module-level constant)
  * determines the launched command.
  */
-export function buildAgentShellCommand(agent, key, worktreePath, platform = "darwin") {
+export function buildAgentShellCommand(agent, key, worktreePath, platform = "darwin", autoApprove = false) {
     if (platform === "win32")
-        return buildPowerShellAgentShellCommand(agent, key, worktreePath);
-    return buildPosixAgentShellCommand(agent, key, worktreePath);
+        return buildPowerShellAgentShellCommand(agent, key, worktreePath, autoApprove);
+    return buildPosixAgentShellCommand(agent, key, worktreePath, autoApprove);
 }
 // ---------------------------------------------------------------------------
 // macOS terminal spawning (behind the injected boundary)
@@ -1048,10 +1105,10 @@ export function buildDryRunResults(keys, overrides) {
  * PowerShell on Windows, `wt` + POSIX on macOS/Linux, and a non-throwing `wt` +
  * POSIX fallback for unsupported platforms.
  */
-export function getDryRunPlatformDetails(agent, platform = process.platform, env = process.env) {
+export function getDryRunPlatformDetails(agent, platform = process.platform, env = process.env, autoApprove = false) {
     return {
         worktrunkBinary: resolveWorktrunkBinary(platform, env),
-        buildAgentShellCommand: (key, worktreePath) => buildAgentShellCommand(agent, key, worktreePath, platform),
+        buildAgentShellCommand: (key, worktreePath) => buildAgentShellCommand(agent, key, worktreePath, platform, autoApprove),
     };
 }
 /**
@@ -1059,9 +1116,9 @@ export function getDryRunPlatformDetails(agent, platform = process.platform, env
  * platform-correct Worktrunk binary and the selected agent's shell command. Pure
  * platform formatting only — no preflight, no routing failures.
  */
-export function buildDryRunDetailLines(agent, key, branch, platform = process.platform, env = process.env) {
-    const { worktrunkBinary, buildAgentShellCommand: build } = getDryRunPlatformDetails(agent, platform, env);
-    const wtArgs = buildWtSwitchArgs(branch, false);
+export function buildDryRunDetailLines(agent, key, branch, platform = process.platform, env = process.env, baseBranch = "main", autoApprove = false) {
+    const { worktrunkBinary, buildAgentShellCommand: build } = getDryRunPlatformDetails(agent, platform, env, autoApprove);
+    const wtArgs = buildWtSwitchArgs(branch, false, baseBranch);
     const agentInvocation = build(key, "<worktree-path>");
     return [
         `DRY-RUN: ${key} -> branch=${branch}`,
@@ -1117,10 +1174,13 @@ export async function orchestrateStartTickets(deps, options) {
     const preflight = await runPreflight(deps, options);
     if (!preflight.ok)
         return { ok: false, error: preflight.error };
-    const platformConfig = resolveStartTicketsPlatformConfig(deps, agent);
+    const platformConfig = resolveStartTicketsPlatformConfig(deps, agent, options.autoApprove);
     if (!platformConfig.ok)
         return { ok: false, error: platformConfig.error };
-    const refresh = await refreshMainBranch(deps, options);
+    const refresh = await refreshBaseBranch(deps, {
+        refreshMain: options.refreshMain,
+        baseBranch: options.baseBranch,
+    });
     if (!refresh.ok)
         return { ok: false, error: refresh.error };
     const created = await createWorktrees(deps, options, platformConfig.config.worktrunkBinary);
@@ -1179,7 +1239,7 @@ export async function runStartTicketsCli(argv, overrides = {}) {
     if (options.dryRun) {
         for (const key of options.keys) {
             const branch = resolveBranchForTicket(key, options.branchOverrides);
-            for (const line of buildDryRunDetailLines(agent, key, branch, deps.platform, deps.env)) {
+            for (const line of buildDryRunDetailLines(agent, key, branch, deps.platform, deps.env, options.baseBranch, options.autoApprove)) {
                 log(line);
             }
         }

package/build/version.generated.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge_gpt/mcp-server",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Bridge API MCP server — exposes Jira endpoints as MCP tools for Claude Code agents",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,7 @@
     "!build/**/*.test.js",
     "!build/integration/**",
     "pipelines/",
+    "smoke-test/",
     "README.md",
     "LICENSE"
   ],
@@ -19,18 +20,17 @@
     "build": "node scripts/bundle-version.js && node scripts/bundle-pipelines.js && node scripts/bundle-commands.js && node scripts/bundle-agents.js && tsc",
     "postbuild": "node scripts/prepend-shebang.cjs",
     "start": "node build/index.js",
-    "test": "node --test build/pipeline-utils.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/start-tickets.test.js build/agent-registry.test.js build/start-tickets-prereqs.test.js build/doctor.test.js build/package-static.test.js",
+    "test": "node --test build/pipeline-utils.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/start-tickets.test.js build/start-tickets-base-branch.test.js build/agent-registry.test.js build/start-tickets-prereqs.test.js build/doctor.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/agent-launchers/claude.test.js build/agent-launchers/index.test.js build/schedule-store.test.js build/schedule-run.test.js",
     "test:integration": "node --test build/integration/refresh-main.integration.test.js build/integration/start-tickets.integration.test.js build/integration/doctor.integration.test.js",
     "prepublishOnly": "npm run build && node scripts/verify-shebang.cjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "zod": "^3.25.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.7.0",
-    "undici": "^6.25.0"
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3"
   },
   "engines": {
     "node": ">=18.0.0"

package/pipelines/full-automation.json

@@ -0,0 +1,47 @@
+{
+  "name": "full-automation",
+  "description": "Drive an idea end-to-end: create ticket(s) (idea-to-ticket), review each ticket (review-ticket fan-out), then hand off to the /start-tickets CLI seam to spawn worktrees.",
+  "variables": [
+    "idea",
+    "auto_approve",
+    "scheduled_at",
+    "max_children",
+    "allow_duplicate",
+    "agent"
+  ],
+  "stages": [
+    {
+      "pipeline_name": "idea-to-ticket",
+      "description": "Convert the idea into one or more Jira tickets.",
+      "variables": {
+        "idea": "{idea}",
+        "max_children": "{max_children}",
+        "allow_duplicate": "{allow_duplicate}",
+        "auto_approve_external": "{auto_approve}"
+      },
+      "outputs": {
+        "created_ticket_keys": "created_ticket_keys"
+      }
+    },
+    {
+      "pipeline_name": "review-ticket",
+      "description": "Review each created ticket (one child pipeline run per ticket).",
+      "fan_out_input": "created_ticket_keys",
+      "fan_out_variable": "ticket_key",
+      "variables": {
+        "ticket_key": "{ticket_key}"
+      },
+      "outputs": {
+        "reviewed_ticket_keys": "reviewed_ticket_keys"
+      }
+    },
+    {
+      "pipeline_name": "start-tickets",
+      "description": "Hand off the reviewed tickets to the /start-tickets CLI seam (agent-task; not a server pipeline).",
+      "fan_out_input": "reviewed_ticket_keys",
+      "outputs": {
+        "started_ticket_keys": "started_ticket_keys"
+      }
+    }
+  ]
+}

package/pipelines/idea-to-ticket.json

@@ -0,0 +1,71 @@
+{
+  "name": "Idea to Ticket",
+  "description": "Convert a short human idea into either a single Jira Task/Spike or a Jira Epic plus decomposed child tickets.",
+  "variables": [
+    "idea",
+    "idea_hash",
+    "slug",
+    "run_id",
+    "docs_dir",
+    "allow_duplicate",
+    "auto_approve_external",
+    "max_children"
+  ],
+  "steps": [
+    {
+      "type": "mcp_call",
+      "tool": "ping",
+      "params": {},
+      "description": "Verify Bridge API connectivity"
+    },
+    {
+      "type": "mcp_call",
+      "tool": "get_docs_dir",
+      "params": {},
+      "description": "Resolve the docs directory for run artifacts"
+    },
+    {
+      "type": "mcp_call",
+      "tool": "get_project_standards",
+      "params": {},
+      "description": "Fetch project standards for screening (optional)",
+      "on_error": "warn_and_continue"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "preflight-and-readiness.md",
+      "description": "Initialize run directory, classify readiness and scope"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "research-decision.md",
+      "description": "Decide which research tools to run for this idea"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "execute-research.md",
+      "description": "Execute the planned research and produce the research pack",
+      "on_error": "warn_and_continue"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "duplicate-and-context-scan.md",
+      "description": "Scan Jira for duplicate/related tickets"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "screen-and-resolve.md",
+      "description": "Build standards checklist and resolve open questions"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "draft-and-critique.md",
+      "description": "Draft the ticket(s) and run a hygiene/critique pass"
+    },
+    {
+      "type": "agent_task",
+      "instruction_file": "upload-and-track.md",
+      "description": "Upload to Jira and track the new ticket(s) idempotently"
+    }
+  ]
+}