@the-open-engine/zeroshot 6.39.0 → 6.39.1

package/README.md

@@ -106,6 +106,7 @@ zeroshot run <input>             # issue, URL, markdown file, or inline text
 zeroshot run 123 --docker        # container isolation
 zeroshot run 123 --pr            # worktree + pull request
 zeroshot run 123 --ship          # worktree + PR + merge after approval
+zeroshot run 123 --pr --pr-body $'## Summary\n\nCustom text\n\n{{issue_reference}}'
 zeroshot run 123 -d              # background run
 
 zeroshot list                    # tasks and clusters (--json)
@@ -120,6 +121,11 @@ zeroshot settings                # effective settings
 zeroshot agents list             # available agents
 ```
 
+`--pr-body` supplies a deterministic pull-request body for `--pr` and `--ship` runs. The
+template supports `{{issue_number}}`, `{{issue_title}}`, and `{{issue_reference}}`; all three
+expand to empty text for tasks without an issue, so manual runs never emit `Closes #unknown`.
+The unrendered template is retained for detached and resumed runs.
+
 </details>
 
 <details>

package/cli/index.js

@@ -107,6 +107,8 @@ const {
   runLegacyUpdateIfRequested,
 } = require('./lib/update-checker');
 const { checkBinDirOnPath, printPathWarning } = require('../lib/path-check');
+const { quoteShellArgument } = require('../lib/git-remote-utils');
+const { renderPullRequestBody, resolveIssueContext } = require('../src/pr-body-template');
 const { StatusFooter, AGENT_STATE, ACTIVE_STATES } = require('../src/status-footer');
 const { EVENT_COPY, formatMergeStatus } = require('./event-copy');
 
@@ -2012,9 +2014,25 @@ function buildContextSummary({
   return contextSummary;
 }
 
-function buildCompletionPrompt({ contextSummary, taskText, issueNumber, issueTitle }) {
-  const mergeGoal = 'CREATE PR AND MERGE IT';
-  const mergeStep = `
+function buildDefaultFinishPrBody({ taskText, issueNumber, issueTitle }) {
+  const issueReference = renderPullRequestBody(undefined, { issueNumber, issueTitle });
+  return [
+    issueReference,
+    issueReference ? '' : null,
+    '## Summary',
+    `${String(taskText || 'Unknown task').slice(0, 200)}...`,
+    '',
+    '## Changes',
+    '- Implementation complete',
+    '- All validations addressed',
+    '',
+    '🤖 Generated with zeroshot finish',
+  ]
+    .filter((line) => line !== null)
+    .join('\n');
+}
+
+const FINISH_MERGE_STEP = `
 8. MERGE THE PR - THIS IS MANDATORY:
    \`\`\`bash
    gh pr merge --merge --auto
@@ -2029,7 +2047,29 @@ function buildCompletionPrompt({ contextSummary, taskText, issueNumber, issueTit
 
    REPEAT UNTIL MERGED. DO NOT GIVE UP.`;
 
-  return `# YOUR MISSION: ${mergeGoal}
+function buildFinishCommandArguments({ taskText, issueNumber, issueTitle, prBody }) {
+  const issueContext = resolveIssueContext({ issueNumber, issueTitle });
+  const resolvedTitle = issueContext.issueTitle;
+  const resolvedBody =
+    typeof prBody === 'string'
+      ? renderPullRequestBody(prBody, { issueNumber, issueTitle: resolvedTitle })
+      : buildDefaultFinishPrBody({ taskText, issueNumber, issueTitle: resolvedTitle });
+  return {
+    commitMessage: quoteShellArgument(resolvedTitle || 'feat: implement task'),
+    branch: quoteShellArgument(
+      issueContext.issueNumber !== 'unknown'
+        ? `issue-${issueContext.issueNumber}`
+        : 'feature/implementation'
+    ),
+    prTitle: quoteShellArgument(resolvedTitle),
+    prBody: quoteShellArgument(resolvedBody),
+  };
+}
+
+function buildCompletionPrompt({ contextSummary, taskText, issueNumber, issueTitle, prBody }) {
+  const args = buildFinishCommandArguments({ taskText, issueNumber, issueTitle, prBody });
+
+  return `# YOUR MISSION: CREATE PR AND MERGE IT
 
 ${contextSummary}
 
@@ -2050,12 +2090,12 @@ You are the FINISHER. Your ONLY job is to take this cluster's work and push it a
 2. COMMIT ALL CHANGES - Stage and commit everything:
    \`\`\`bash
    git add .
-   git commit -m "${issueTitle || 'feat: implement task'}"
+   git commit -m ${args.commitMessage}
    \`\`\`
 
 3. CREATE BRANCH - Use issue number if available:
    \`\`\`bash
-   ${issueNumber ? `git checkout -b issue-${issueNumber}` : 'git checkout -b feature/implementation'}
+   git checkout -b ${args.branch}
    \`\`\`
 
 4. PUSH TO REMOTE:
@@ -2065,16 +2105,7 @@ You are the FINISHER. Your ONLY job is to take this cluster's work and push it a
 
 5. CREATE PULL REQUEST:
    \`\`\`bash
-   gh pr create --title "${issueTitle || 'Implementation'}" --body "Closes #${issueNumber || 'N/A'}
-
-## Summary
-${taskText.slice(0, 200)}...
-
-## Changes
-- Implementation complete
-- All validations addressed
-
-🤖 Generated with zeroshot finish"
+   gh pr create --title ${args.prTitle} --body ${args.prBody}
    \`\`\`
 
 6. GET PR URL:
@@ -2083,7 +2114,7 @@ ${taskText.slice(0, 200)}...
    \`\`\`
 
 7. OUTPUT THE PR URL - Print it clearly so user can see it
-${mergeStep}
+${FINISH_MERGE_STEP}
 
 ## RULES
 
@@ -2707,6 +2738,10 @@ program
     'Full automation: worktree isolation + PR + auto-merge (use --docker for Docker)'
   )
   .option('--pr-base <branch>', 'Target branch for PRs (default: repo default branch)')
+  .option(
+    '--pr-body <template>',
+    'PR body template; supports {{issue_number}}, {{issue_title}}, and {{issue_reference}}'
+  )
   .option('--merge-queue', 'Use GitHub merge queue instead of direct merge')
   .option(
     '--close-issue <mode>',
@@ -3714,6 +3749,10 @@ program
   .helpGroup('Control:')
   .description('Take existing cluster and create completion-focused task (creates PR and merges)')
   .option('-y, --yes', 'Skip confirmation if cluster is running')
+  .option(
+    '--pr-body <template>',
+    'PR body template; supports {{issue_number}}, {{issue_title}}, and {{issue_reference}}'
+  )
   .action(async (id, options) => {
     try {
       const orchestrator = await getOrchestrator();
@@ -3732,6 +3771,7 @@ program
         taskText: context.taskText,
         issueNumber: context.issueNumber,
         issueTitle: context.issueTitle,
+        prBody: options.prBody ?? cluster.prOptions?.prBody,
       });
       printCompletionPromptPreview(completionPrompt);
 
@@ -6190,6 +6230,9 @@ module.exports = {
   isStartupUpdateEligible,
   handleNoArgumentInvocation,
   shouldRunInitialSetup,
+  extractFinishContext,
+  buildDefaultFinishPrBody,
+  buildCompletionPrompt,
   resolveRunMode,
   killRunningClusters,
 };

package/lib/detached-startup.d.ts

@@ -5,6 +5,7 @@ interface RunOptions extends Record<string, unknown> {
     mergeQueue?: unknown;
     pr?: unknown;
     prBase?: unknown;
+    prBody?: unknown;
     ship?: unknown;
     worktree?: unknown;
 }

package/lib/detached-startup.js

@@ -117,9 +117,10 @@ async function registerDetachedSetupCluster({ clusterId, pid, storageDir, logPat
             setupStartedAt: Date.now(),
             setupStage: 'starting',
             autoPr: plan.delivery !== 'none',
-            prOptions: runOptions.prBase
+            prOptions: plan.delivery !== 'none'
                 ? {
                     prBase: runOptions.prBase,
+                    prBody: typeof runOptions.prBody === 'string' ? runOptions.prBody : null,
                     mergeQueue: runOptions.mergeQueue || false,
                     closeIssue: runOptions.closeIssue || null,
                     autoMerge: plan.autoMerge,

package/lib/start-cluster-environment.d.ts

@@ -7,6 +7,7 @@ interface RunOptions extends Record<string, unknown> {
     mount?: readonly string[] | null;
     noIsolation?: unknown;
     prBase?: unknown;
+    prBody?: unknown;
 }
 interface MountSpec {
     host: string;

package/lib/start-cluster-run-options.d.ts

@@ -25,6 +25,7 @@ interface RunOptions extends Record<string, unknown> {
     noMounts?: unknown;
     pr?: unknown;
     prBase?: unknown;
+    prBody?: unknown;
     preparedWorktree?: unknown;
     requiredQualityGates?: unknown;
     ship?: unknown;

package/lib/start-cluster-run-options.js

@@ -89,6 +89,7 @@ function buildStartOptionsFromPlan({ clusterId, plan, options, settings, provide
         containerHome: optionalValue(options.containerHome),
         forceProvider: optionalValue(forceProvider),
         prBase: environment ? resolvePrBase(options) : optionalValue(options.prBase),
+        prBody: typeof options.prBody === 'string' ? options.prBody : undefined,
         mergeQueue: environment ? resolveMergeQueue(options) : optionalValue(options.mergeQueue),
         closeIssue: environment ? resolveCloseIssue(options) : optionalValue(options.closeIssue),
         ship: plan.delivery === 'ship',

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@the-open-engine/zeroshot",
-  "version": "6.39.0",
+  "version": "6.39.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@the-open-engine/zeroshot",
-      "version": "6.39.0",
+      "version": "6.39.1",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
@@ -17,6 +17,7 @@
         "bun": "1.3.14",
         "chalk": "^4.1.2",
         "commander": "^14.0.2",
+        "js-yaml": "^4.3.1",
         "node-pty": "^1.1.0",
         "omelette": "^0.4.17",
         "open": "^10.1.0",
@@ -43,7 +44,6 @@
         "eslint-plugin-sonarjs": "^3.0.5",
         "eslint-plugin-unused-imports": "^4.3.0",
         "husky": "^9.1.7",
-        "js-yaml": "^4.2.0",
         "jscpd": "^3.5.10",
         "lint-staged": "^16.2.7",
         "mocha": "^11.7.5",
@@ -5155,7 +5155,6 @@
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
       "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-      "dev": true,
       "license": "Python-2.0"
     },
     "node_modules/argv-formatter": {
@@ -9177,10 +9176,9 @@
       "license": "MIT"
     },
     "node_modules/js-yaml": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.2.0.tgz",
-      "integrity": "sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==",
-      "dev": true,
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.1.tgz",
+      "integrity": "sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==",
       "funding": [
         {
           "type": "github",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-open-engine/zeroshot",
-  "version": "6.39.0",
+  "version": "6.39.1",
   "description": "Independent executor–verifier orchestration for software changes.",
   "main": "src/orchestrator.js",
   "bin": {
@@ -204,6 +204,7 @@
     "bun": "1.3.14",
     "chalk": "^4.1.2",
     "commander": "^14.0.2",
+    "js-yaml": "^4.3.1",
     "node-pty": "^1.1.0",
     "omelette": "^0.4.17",
     "open": "^10.1.0",
@@ -229,7 +230,6 @@
     "eslint-plugin-sonarjs": "^3.0.5",
     "eslint-plugin-unused-imports": "^4.3.0",
     "husky": "^9.1.7",
-    "js-yaml": "^4.2.0",
     "jscpd": "^3.5.10",
     "lint-staged": "^16.2.7",
     "mocha": "^11.7.5",
@@ -244,7 +244,7 @@
   },
   "overrides": {
     "cosmiconfig": {
-      "js-yaml": "4.2.0"
+      "js-yaml": "4.3.1"
     },
     "adm-zip": "0.6.0",
     "sharp": "0.35.3",

package/scripts/rust-distribution.js

@@ -325,10 +325,7 @@ function stagedLockDependencies(cargoLock, workspaceCargoToml) {
 
 function stageCargoLock(cargoLock, version, workspaceCargoToml) {
   const targetPackage = workspaceLockPackage(cargoLock);
-  let stagedPackage = targetPackage.text.replace(
-    /^(version = ")[^"]+(")$/m,
-    `$1${version}$2`
-  );
+  let stagedPackage = targetPackage.text.replace(/^(version = ")[^"]+(")$/m, `$1${version}$2`);
   for (const dependency of stagedLockDependencies(cargoLock, workspaceCargoToml)) {
     const dependencyPattern = new RegExp(
       `^(\\s*")${escapeRegExp(dependency.name)}(?: [^"]+)?(",\\r?)$`,
@@ -339,10 +336,7 @@ function stageCargoLock(cargoLock, version, workspaceCargoToml) {
         `RUST_VERSION_STAGE_FAILED: Cargo.lock zeroshot-rust entry has no ${dependency.name} dependency`
       );
     }
-    stagedPackage = stagedPackage.replace(
-      dependencyPattern,
-      `$1${dependency.reference}$2`
-    );
+    stagedPackage = stagedPackage.replace(dependencyPattern, `$1${dependency.reference}$2`);
   }
   return (
     cargoLock.slice(0, targetPackage.start) +
@@ -359,10 +353,7 @@ function verifyStagedCargoLock(cargoLock, version, workspaceCargoToml) {
     );
   }
   for (const dependency of stagedLockDependencies(cargoLock, workspaceCargoToml)) {
-    const dependencyPattern = new RegExp(
-      `^\\s*"${escapeRegExp(dependency.reference)}",\\r?$`,
-      'm'
-    );
+    const dependencyPattern = new RegExp(`^\\s*"${escapeRegExp(dependency.reference)}",\\r?$`, 'm');
     if (!dependencyPattern.test(targetPackage.text)) {
       throw new Error(
         `${VERSION_ERROR}: Cargo.lock zeroshot-rust dependency ${dependency.name} is not coupled to ${dependency.version}`
@@ -400,8 +391,7 @@ function stageVersion(
 function checkVersionCoupling(tag, cargoToml, cargoLock, workspaceCargoToml) {
   const useRepositoryFiles = cargoToml === undefined;
   const manifest =
-    cargoToml ??
-    fs.readFileSync(path.join(repositoryRoot, 'zeroshot-rust', 'Cargo.toml'), 'utf8');
+    cargoToml ?? fs.readFileSync(path.join(repositoryRoot, 'zeroshot-rust', 'Cargo.toml'), 'utf8');
   const releaseVersion = normalizeVersion(tag);
   const manifestVersion = cargoVersion(manifest);
   if (releaseVersion !== manifestVersion) {
@@ -416,8 +406,7 @@ function checkVersionCoupling(tag, cargoToml, cargoLock, workspaceCargoToml) {
       : undefined);
   if (lock !== undefined) {
     const workspace =
-      workspaceCargoToml ??
-      fs.readFileSync(path.join(repositoryRoot, 'Cargo.toml'), 'utf8');
+      workspaceCargoToml ?? fs.readFileSync(path.join(repositoryRoot, 'Cargo.toml'), 'utf8');
     verifyStagedCargoLock(lock, releaseVersion, workspace);
   }
   return releaseVersion;
@@ -483,9 +472,7 @@ const SCRIPT_INSTALL_CONTRACTS = Object.freeze([
 ]);
 
 function invokesRustDistribution(step) {
-  return (
-    typeof step.run === 'string' && RUST_DISTRIBUTION_INVOCATION.test(step.run)
-  );
+  return typeof step.run === 'string' && RUST_DISTRIBUTION_INVOCATION.test(step.run);
 }
 
 function checkScriptInstall(job, { jobName, installName, command, checkoutRef }) {
@@ -507,9 +494,7 @@ function checkScriptInstall(job, { jobName, installName, command, checkoutRef })
       checkout.with.repository !== '${{ github.repository }}') ||
     checkout.with?.ref !== checkoutRef
   ) {
-    failIntegrity(
-      `${jobName} must checkout expected current repository source at workspace root`
-    );
+    failIntegrity(`${jobName} must checkout expected current repository source at workspace root`);
   }
   const installIndex = job.steps.indexOf(install);
   const checkoutIndex = job.steps.indexOf(checkout);
@@ -745,11 +730,12 @@ function hasValidSri(integrity) {
 }
 
 function checkScriptDependencies(packageManifest, packageLock) {
-  const directSpec = packageManifest.devDependencies?.['js-yaml'];
+  // js-yaml is a runtime dependency: lib/compose-utils.js requires it from the published package.
+  const directSpec = packageManifest.dependencies?.['js-yaml'];
   if (typeof directSpec !== 'string' || directSpec.length === 0) {
-    failIntegrity('rust-distribution.js requires a direct js-yaml devDependency');
+    failIntegrity('rust-distribution.js requires a direct js-yaml dependency');
   }
-  const lockSpec = packageLock.packages?.['']?.devDependencies?.['js-yaml'];
+  const lockSpec = packageLock.packages?.['']?.dependencies?.['js-yaml'];
   if (lockSpec !== directSpec) {
     failIntegrity('package-lock root js-yaml spec must match package.json');
   }
@@ -773,12 +759,8 @@ function checkRepository(
   shimTargets = JSON.parse(
     fs.readFileSync(path.join(repositoryRoot, 'npm', 'zeroshot-rust', 'targets.json'), 'utf8')
   ),
-  packageManifest = JSON.parse(
-    fs.readFileSync(path.join(repositoryRoot, 'package.json'), 'utf8')
-  ),
-  packageLock = JSON.parse(
-    fs.readFileSync(path.join(repositoryRoot, 'package-lock.json'), 'utf8')
-  )
+  packageManifest = JSON.parse(fs.readFileSync(path.join(repositoryRoot, 'package.json'), 'utf8')),
+  packageLock = JSON.parse(fs.readFileSync(path.join(repositoryRoot, 'package-lock.json'), 'utf8'))
 ) {
   let document;
   try {

package/src/agents/git-pusher-template.js

@@ -277,6 +277,7 @@ return hasSufficientEvidence;`;
 const { readRepoSettings } = require('../../lib/repo-settings');
 const { normalizeGitRemoteName, quoteShellArgument } = require('../../lib/git-remote-utils');
 const { resolveRequiredQualityGates } = require('../quality-gates');
+const { renderPullRequestBody, resolveIssueContext } = require('../pr-body-template');
 
 function getSafeBranchName(value) {
   if (typeof value !== 'string') {
@@ -314,35 +315,6 @@ function normalizeCloseIssueMode(value) {
   return null;
 }
 
-function normalizeIssueNumber(value) {
-  const candidate = typeof value === 'number' ? String(value) : value;
-  if (typeof candidate !== 'string') return 'unknown';
-  const trimmed = candidate.trim();
-  return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(trimmed) ? trimmed : 'unknown';
-}
-
-function normalizeIssueTitle(value) {
-  if (typeof value !== 'string' || value.trim() === '') return 'Implementation';
-  const normalized = [...value]
-    .map((character) => {
-      const codePoint = character.codePointAt(0);
-      return codePoint < 0x20 || codePoint === 0x7f ? ' ' : character;
-    })
-    .join('')
-    .trim();
-  return normalized || 'Implementation';
-}
-
-function resolveIssueContext(options) {
-  const issueNumber = normalizeIssueNumber(options.issueNumber);
-  const issueTitle = normalizeIssueTitle(options.issueTitle);
-  const issueReference =
-    options.includeIssueReference === false || issueNumber === 'unknown'
-      ? ''
-      : `Closes #${issueNumber}`;
-  return { issueNumber, issueTitle, issueReference };
-}
-
 /**
  * Resolve GitHub configuration from CLI options and repo settings.
  * Priority: CLI options > repo settings (.zeroshot/settings.json) > defaults
@@ -355,6 +327,7 @@ function resolveIssueContext(options) {
  * @param {string|number} [options.issueNumber] - Typed issue identifier for prompt commands
  * @param {string} [options.issueTitle] - Typed issue title for prompt commands
  * @param {boolean} [options.includeIssueReference] - Include the closing reference in PR text
+ * @param {string} [options.prBody] - Literal PR body template with supported issue tokens
  * @returns {Object} Resolved configuration
  */
 function resolveGitHubConfig(options = {}) {
@@ -385,16 +358,23 @@ function resolveGitHubConfig(options = {}) {
     options.autoMerge === true ||
     (options.autoMerge !== false && parseBool(repoGithub.autoMerge) === true);
 
+  const issueContext = resolveIssueContext(options);
+
   return {
     prBase,
     useMergeQueue,
     closeIssueMode,
     autoMerge,
     gitRemote,
-    issueContext: resolveIssueContext(options),
+    issueContext,
+    prBody: renderPullRequestBody(options.prBody, options),
   };
 }
 
+function resolvedPrBody(config, issueContext) {
+  return typeof config.prBody === 'string' ? config.prBody : issueContext.issueReference;
+}
+
 /**
  * Generate platform-specific configuration based on resolved GitHub config.
  *
@@ -406,13 +386,15 @@ function getPlatformConfig(platform, config = {}) {
   const { prBase, useMergeQueue, closeIssueMode, autoMerge, gitRemote } = config;
   const issueContext = config.issueContext || resolveIssueContext({});
   const issueTitleArgument = quoteShellArgument(`feat: ${issueContext.issueTitle}`);
-  const issueReferenceArgument = quoteShellArgument(issueContext.issueReference);
+  const prBodyArgument = quoteShellArgument(resolvedPrBody(config, issueContext));
 
   const PLATFORM_CONFIGS = {
     github: {
       prName: 'PR',
       prNameLower: 'pull request',
-      createCmd: `gh pr create${prBase ? ` --base ${prBase}` : ''} --title ${issueTitleArgument} --body ${issueReferenceArgument}`,
+      createCmd:
+        `gh pr create${prBase ? ` --base ${prBase}` : ''} ` +
+        `--title ${issueTitleArgument} --body ${prBodyArgument}`,
       mergeCmd: useMergeQueue
         ? `PR_ID="$(timeout 30 gh pr view --json id --jq .id)"
 gh api graphql -f query='mutation($id:ID!){enqueuePullRequest(input:{pullRequestId:$id}){mergeQueueEntry{state}}}' -f id="$PR_ID"
@@ -434,7 +416,7 @@ for i in $(seq 1 90); do if timeout 30 gh pr view --json mergedAt --jq .mergedAt
     gitlab: {
       prName: 'MR',
       prNameLower: 'merge request',
-      createCmd: `glab mr create --title ${issueTitleArgument} --description ${issueReferenceArgument}`,
+      createCmd: `glab mr create --title ${issueTitleArgument} --description ${prBodyArgument}`,
       mergeCmd: 'glab mr merge --auto-merge',
       mergeFallbackCmd: 'glab mr merge',
       prUrlExample: 'https://gitlab.com/owner/repo/-/merge_requests/123',
@@ -447,7 +429,7 @@ for i in $(seq 1 90); do if timeout 30 gh pr view --json mergedAt --jq .mergedAt
     'azure-devops': {
       prName: 'PR',
       prNameLower: 'pull request',
-      createCmd: `az repos pr create --title ${issueTitleArgument} --description ${issueReferenceArgument}`,
+      createCmd: `az repos pr create --title ${issueTitleArgument} --description ${prBodyArgument}`,
       mergeCmd: 'az repos pr update --id <PR_ID> --auto-complete true',
       mergeFallbackCmd: 'az repos pr update --id <PR_ID> --status completed',
       prUrlExample: 'https://dev.azure.com/org/project/_git/repo/pullrequest/123',
@@ -803,6 +785,7 @@ If blocked before creating a ${prName}, output:
  * @param {string|number} [options.issueNumber] - Typed issue identifier for prompt commands
  * @param {string} [options.issueTitle] - Typed issue title for prompt commands
  * @param {boolean} [options.includeIssueReference] - Include the closing reference in PR text
+ * @param {string} [options.prBody] - Literal PR body template with supported issue tokens
  * @param {Array} [options.requiredQualityGates] - Required handoff quality gates
  * @param {boolean} [options.autoMerge] - Merge the PR (--ship). False stops after PR creation (--pr).
  * @returns {Object} Agent configuration object