trackfw 6.10.0 → 7.0.0

package/src/i18n/locales/en-US.json

@@ -115,22 +115,6 @@
     "tail": "Number of recent transitions to show",
     "header": "── trackfw log ─────────────────────────"
   },
-  "plugins": {
-    "description": "Manage trackfw plugins",
-    "list": {
-      "description": "List installed plugins",
-      "empty": "No plugins installed. Use `trackfw plugins add <user/repo>` to install one."
-    },
-    "add": {
-      "description": "Install a plugin from GitHub Releases (user/repo or user/repo@tag)",
-      "installing": "Installing plugin from {{repo}}...",
-      "success": "Plugin \"{{name}}\" installed successfully."
-    },
-    "remove": {
-      "description": "Remove an installed plugin",
-      "success": "Plugin \"{{name}}\" removed."
-    }
-  },
   "metrics": {
     "description": "Show delivery metrics",
     "no_data": "No transitions recorded yet.",
@@ -138,8 +122,6 @@
     "export": "Export metrics to CSV file"
   },
   "errors": {
-    "notFound": "Not found: {{path}}",
-    "downloadFailed": "download failed: HTTP {{status}} for {{url}}",
-    "pluginNotFound": "plugin \"{{name}}\" not found"
+    "notFound": "Not found: {{path}}"
   }
 }

package/src/i18n/locales/es-ES.json

@@ -115,22 +115,6 @@
     "tail": "Número de transiciones recientes a mostrar",
     "header": "── trackfw log ─────────────────────────"
   },
-  "plugins": {
-    "description": "Gestionar plugins de trackfw",
-    "list": {
-      "description": "Listar plugins instalados",
-      "empty": "No hay plugins instalados. Usa `trackfw plugins add <user/repo>` para instalar uno."
-    },
-    "add": {
-      "description": "Instalar un plugin desde GitHub Releases (user/repo o user/repo@tag)",
-      "installing": "Instalando plugin desde {{repo}}...",
-      "success": "Plugin \"{{name}}\" instalado correctamente."
-    },
-    "remove": {
-      "description": "Eliminar un plugin instalado",
-      "success": "Plugin \"{{name}}\" eliminado."
-    }
-  },
   "metrics": {
     "description": "Muestra métricas de entrega",
     "no_data": "No hay transiciones registradas aún.",
@@ -138,8 +122,6 @@
     "export": "Exportar métricas a archivo CSV"
   },
   "errors": {
-    "notFound": "No encontrado: {{path}}",
-    "downloadFailed": "fallo en la descarga: HTTP {{status}} para {{url}}",
-    "pluginNotFound": "plugin \"{{name}}\" no encontrado"
+    "notFound": "No encontrado: {{path}}"
   }
 }

package/src/i18n/locales/pt-BR.json

@@ -115,22 +115,6 @@
     "tail": "Número de transições recentes a exibir",
     "header": "── trackfw log ─────────────────────────"
   },
-  "plugins": {
-    "description": "Gerenciar plugins do trackfw",
-    "list": {
-      "description": "Listar plugins instalados",
-      "empty": "Nenhum plugin instalado. Use `trackfw plugins add <user/repo>` para instalar um."
-    },
-    "add": {
-      "description": "Instalar um plugin do GitHub Releases (user/repo ou user/repo@tag)",
-      "installing": "Instalando plugin de {{repo}}...",
-      "success": "Plugin \"{{name}}\" instalado com sucesso."
-    },
-    "remove": {
-      "description": "Remover um plugin instalado",
-      "success": "Plugin \"{{name}}\" removido."
-    }
-  },
   "metrics": {
     "description": "Exibe métricas de delivery",
     "no_data": "Nenhuma transição registrada ainda.",
@@ -138,8 +122,6 @@
     "export": "Exportar métricas para arquivo CSV"
   },
   "errors": {
-    "notFound": "Não encontrado: {{path}}",
-    "downloadFailed": "falha no download: HTTP {{status}} para {{url}}",
-    "pluginNotFound": "plugin \"{{name}}\" não encontrado"
+    "notFound": "Não encontrado: {{path}}"
   }
 }

package/src/integrations/index.js

@@ -8,6 +8,7 @@ const { IntegrationManager } = require('./manager')
 const { legacyHashes } = require('./legacy')
 const identityStore = require('../identity')
 const { injectRulesForTool } = require('../generators/init')
+const { applyThirdPartyReferences } = require('../thirdparty/references')
 
 function parseSurfaces(values = []) {
   const result = {}
@@ -55,7 +56,17 @@ function buildPlans(kind, options = {}) {
       for (const item of selected.itemEntries) {
         for (const installPath of paths) {
           const destination = installPath.path.replace('{{id}}', item.id)
-          const content = render({ target: targetEntry.id, kind, item, content: readAsset(item), capability, destination, identity: identityConfig })
+          let content = render({ target: targetEntry.id, kind, item, content: readAsset(item), capability, destination, identity: identityConfig })
+          // D5/D9 extension point: reproduce any persisted third-party
+          // reference block so regenerating this exact artifact (e.g. a
+          // later `trackfw agents update`) settles at state "current"
+          // instead of treating the attachment as drift. See the doc
+          // comment on applyThirdPartyReferences (../thirdparty/references.js)
+          // for why this cannot live inside render() itself. Mirrors
+          // internal/integrations/plan.go:BuildPlans.
+          if (kind === 'agents' && options.projectRoot) {
+            content = applyThirdPartyReferences(options.projectRoot, content, targetEntry.id, item.id)
+          }
           const claim = { target: targetEntry.id, surface: surface.id, scope, kind, item: item.id }
           plans.push({
             claim,
@@ -100,8 +111,14 @@ function execute(kind, operation, options = {}, roots = {}) {
   // executeIntegrationMutation/executeIntegrationList).
   const homeRoot = roots.homeRoot || os.homedir()
   const identityConfig = options.identity !== undefined ? options.identity : identityStore.load(homeRoot)
-  const plans = buildPlans(kind, { ...options, identity: identityConfig })
   const manager = new IntegrationManager(roots, { onSkip: options.onSkip })
+  // D5/D9: manager.roots.project lets buildPlans reproduce any persisted
+  // third-party reference block (see the projectRoot doc comment above the
+  // applyThirdPartyReferences call in buildPlans) so a plain `agents update`
+  // settles at state "current" after a third-party attachment instead of
+  // reporting drift. Mirrors internal/commands/integrations_flags.go passing
+  // manager.ProjectRoot to BuildPlans at both call sites.
+  const plans = buildPlans(kind, { ...options, identity: identityConfig, projectRoot: options.projectRoot || manager.roots.project })
   let statuses
   if (operation === 'list') statuses = manager.inspect(plans)
   else if (operation === 'install') statuses = manager.install(plans, { force: options.force })

package/src/integrations/manager.js

@@ -10,8 +10,21 @@ const { tildeify } = require('../lib/update-engine')
 
 const SCHEMA_VERSION = 1
 const sha256 = content => crypto.createHash('sha256').update(content).digest('hex')
-const claimKey = claim => [claim.target, claim.surface, claim.scope, claim.kind, claim.item].join('\u0000')
-const cleanClaim = claim => ({ target: claim.target, surface: claim.surface, scope: claim.scope, kind: claim.kind, item: claim.item })
+// claimKey includes origin (ADR-2026-08-15 D11) so a catalog claim and a
+// third-party claim that happen to share target/surface/scope/kind/item are
+// never treated as the same ownership record — mirrors Go's Claim struct
+// equality (`==`), field-by-field, which already includes Origin
+// (internal/integrations/manager.go's claimOwned/appendClaim/removeClaim).
+const claimKey = claim => [claim.target, claim.surface, claim.scope, claim.kind, claim.item, claim.origin || ''].join('\u0000')
+// cleanClaim omits origin entirely when falsy/absent, mirroring Go's
+// `json:"origin,omitempty"` — a catalog claim (origin "") must serialize
+// with NO "origin" key at all, byte-identical to a manifest written before
+// this field existed (retrocompatibility, D11).
+const cleanClaim = claim => {
+  const out = { target: claim.target, surface: claim.surface, scope: claim.scope, kind: claim.kind, item: claim.item }
+  if (claim.origin) out.origin = claim.origin
+  return out
+}
 
 class IntegrationManager {
   constructor({ projectRoot = process.cwd(), homeRoot = os.homedir() } = {}, { onSkip } = {}) {

package/src/lib/unknown-command.js

@@ -0,0 +1,82 @@
+'use strict'
+
+// unknown-command.js — canonical cross-CLI "unknown command" message and the
+// shared suggestion algorithm.
+//
+// ADR-2026-08-15-remocao-do-subsistema-de-plugins-em-vez-de-gate-de-binario-de-
+// terceiro.md (D3): argument dispatch to an external `trackfw-<name>` binary was
+// removed together with the plugin subsystem. An unrecognized top-level command
+// now always produces the message below instead — in all three CLIs.
+//
+// The plain (no-transposition) Levenshtein distance and the suggestion-picking
+// rule here are reimplemented IDENTICALLY in Go (internal/commands/root.go,
+// suggestCommand/levenshteinDistance) and Python (pypi/trackfw/cli.py,
+// _suggest_command/_levenshtein_distance) — deliberately NOT delegated to each
+// framework's own suggestion helper (cobra's Command.SuggestionsFor, commander's
+// suggestSimilar), which use different distance functions/thresholds and would
+// make the three CLIs disagree on whether/what to suggest for the same typo.
+// Parity is enforced by scripts/check-unknown-command-parity.sh.
+
+function levenshteinDistance(a, b) {
+  const la = a.length
+  const lb = b.length
+  const d = []
+  for (let i = 0; i <= la; i++) {
+    d.push(new Array(lb + 1).fill(0))
+    d[i][0] = i
+  }
+  for (let j = 0; j <= lb; j++) {
+    d[0][j] = j
+  }
+  for (let i = 1; i <= la; i++) {
+    for (let j = 1; j <= lb; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1
+      d[i][j] = Math.min(
+        d[i - 1][j] + 1, // deletion
+        d[i][j - 1] + 1, // insertion
+        d[i - 1][j - 1] + cost, // substitution
+      )
+    }
+  }
+  return d[la][lb]
+}
+
+// suggestCommand — a candidate is eligible when its case-insensitive
+// Levenshtein distance to `typed` is <= 2, OR it is a case-insensitive prefix
+// match (candidate starts with the typed text). Among eligible candidates the
+// winner is the one with the lowest distance, alphabetical tie-break, so the
+// pick is deterministic and single — matching Go/Python exactly.
+function suggestCommand(typed, candidates) {
+  const lowerTyped = typed.toLowerCase()
+  let bestDist = -1
+  let best = ''
+  for (const candidate of candidates) {
+    const lowerC = candidate.toLowerCase()
+    const dist = levenshteinDistance(lowerTyped, lowerC)
+    const prefixMatch = lowerTyped.length > 0 && lowerC.startsWith(lowerTyped)
+    if (dist > 2 && !prefixMatch) continue
+    if (bestDist === -1 || dist < bestDist || (dist === bestDist && candidate < best)) {
+      bestDist = dist
+      best = candidate
+    }
+  }
+  return bestDist === -1 ? null : best
+}
+
+// formatUnknownCommandError — canonical message, byte-identical across the
+// three CLIs modulo the typed name and the suggestion (present only when
+// suggestCommand finds an eligible candidate):
+//   Error: unknown command "x" for "trackfw"
+//   Did you mean "validate"?
+//   Run 'trackfw --help' for usage.
+function formatUnknownCommandError(typed, candidates, cmdPath) {
+  const lines = [`Error: unknown command "${typed}" for "${cmdPath}"`]
+  const suggestion = suggestCommand(typed, candidates)
+  if (suggestion) {
+    lines.push(`Did you mean "${suggestion}"?`)
+  }
+  lines.push(`Run '${cmdPath} --help' for usage.`)
+  return lines.join('\n')
+}
+
+module.exports = { levenshteinDistance, suggestCommand, formatUnknownCommandError }

package/src/ship/runner.js

@@ -28,11 +28,26 @@ function isGitWriteCmd(args) {
 }
 
 /**
- * isShipBranch returns true when branch matches feat|fix|refactor/<slug>.
+ * isShipBranch returns true when branch matches feat|fix|refactor|chore|docs/<slug> — the full
+ * vocabulary `trackfw ship` accepts on the branch name. feat/fix/refactor are gated on Step 2's
+ * branch_has_wip_roadmap governance check (a hard gate not affected by lenient mode); chore/docs
+ * are housekeeping types — already exempted from that gate by `trackfw branch new` and
+ * `trackfw commit` — and ship without it too.
  * @param {string} branch
  * @returns {boolean}
  */
 function isShipBranch(branch) {
+  return /^(feat|fix|refactor|chore|docs)\/.+/.test(branch)
+}
+
+/**
+ * isGatedShipBranch returns true when branch matches feat|fix|refactor/<slug> — the subset of
+ * isShipBranch's vocabulary that requires Step 2's branch_has_wip_roadmap governance check.
+ * chore/docs branches satisfy isShipBranch but return false here.
+ * @param {string} branch
+ * @returns {boolean}
+ */
+function isGatedShipBranch(branch) {
   return /^(feat|fix|refactor)\/.+/.test(branch)
 }
 
@@ -78,8 +93,10 @@ function checkShipGovernance() {
   const branchResult = defaultExecGit(['symbolic-ref', '--short', 'HEAD'])
   const branch = branchResult.error ? '' : branchResult.stdout.trim()
 
-  // Check branch has matching roadmap in wip/
-  if (branch && isShipBranch(branch)) {
+  // Check branch has matching roadmap in wip/ — gated types only (feat/fix/refactor); chore/docs
+  // are exempted by the outer runShip Step 2 skip and never reach this function in practice, but
+  // isGatedShipBranch keeps this check correct in isolation too.
+  if (branch && isGatedShipBranch(branch)) {
     const slug = normalizeBranchSlug(branch.split('/').slice(1).join('/'))
     let hasMatch = false
     let wipFiles = []
@@ -217,6 +234,137 @@ function firstLine(s) {
   return idx >= 0 ? s.slice(0, idx) : s
 }
 
+/**
+ * splitNonEmptyLines splits git output (e.g. `diff --cached --name-only`) into an array
+ * of trimmed, non-empty lines.
+ * @param {string} s
+ * @returns {string[]}
+ */
+function splitNonEmptyLines(s) {
+  const trimmed = (s || '').trim()
+  if (!trimmed) return []
+  return trimmed
+    .split('\n')
+    .map((line) => line.trim())
+    .filter((line) => line !== '')
+}
+
+/**
+ * allDocOnly returns true when there is at least one staged file and every staged file is
+ * doc-only: under docs/ or vault/ (path prefix), or has a .md extension. A single file
+ * outside that criterion makes it return false. Mirrors the doc-only exception documented
+ * in CLAUDE.md §7 ("Alteração doc-only (markdown, comentários)").
+ * @param {string[]} files
+ * @returns {boolean}
+ */
+function allDocOnly(files) {
+  if (!files || files.length === 0) return false
+  for (const f of files) {
+    if (f.startsWith('docs/') || f.startsWith('vault/') || f.endsWith('.md')) continue
+    return false
+  }
+  return true
+}
+
+/**
+ * commitMessageSep delimits full commit messages (%B) in the output of gitCommitsSince's
+ * `git log --format=%B<sep>`. Same non-printable separator used by the Go implementation
+ * (internal/commands/ship.go) — cannot appear in a real commit message.
+ */
+const COMMIT_MESSAGE_SEP = '\x1e'
+
+/**
+ * defaultBaseBranch resolves the repository's default branch for `git log <base>..HEAD`.
+ * Tries `git symbolic-ref refs/remotes/origin/HEAD` (format "refs/remotes/origin/main" —
+ * only the name after the last slash is kept) and falls back to "main" when that fails or
+ * yields nothing.
+ * @param {function} execGit
+ * @returns {string}
+ */
+function defaultBaseBranch(execGit) {
+  const { stdout, error } = execGit(['symbolic-ref', 'refs/remotes/origin/HEAD'])
+  if (error) return 'main'
+  const out = (stdout || '').trim()
+  const idx = out.lastIndexOf('/')
+  if (idx < 0 || idx + 1 >= out.length) return 'main'
+  return out.slice(idx + 1)
+}
+
+/**
+ * gitCommitsSince returns the full message (subject + body) of every non-merge commit in
+ * base..HEAD, most-recent-first (git log's natural order). Returns [] on any git error or
+ * when the range is empty.
+ * @param {string} base
+ * @param {function} execGit
+ * @returns {string[]}
+ */
+function gitCommitsSince(base, execGit) {
+  const { stdout, error } = execGit(['log', `${base}..HEAD`, '--no-merges', `--format=%B${COMMIT_MESSAGE_SEP}`])
+  if (error) return []
+  const out = (stdout || '').trim()
+  if (!out) return []
+  const parts = out.split(COMMIT_MESSAGE_SEP)
+  const commits = []
+  for (let p of parts) {
+    p = p.replace(/^\n+|\n+$/g, '')
+    if (p.trim() === '') continue
+    commits.push(p)
+  }
+  return commits
+}
+
+/**
+ * buildPRBody constructs the PR/MR body. With 0 or 1 non-merge commit on the branch (the
+ * trivial case — just the commit `ship` itself made), it keeps the original minimal body,
+ * not a regression. With 2+ commits, it aggregates the branch's commit history:
+ *
+ *   ## Commits
+ *   - <subject of commit 1>
+ *   - <subject of commit 2>
+ *
+ *   ## Detalhes
+ *   <full body of each commit that has one, in blocks>
+ *
+ *   ---
+ *   Branch: <branch>
+ *
+ * @param {string} branch
+ * @param {string[]} commits
+ * @returns {string}
+ */
+function buildPRBody(branch, commits) {
+  if (!commits || commits.length <= 1) {
+    return `Branch: ${branch}\n\nCreated by trackfw ship.`
+  }
+
+  const subjects = []
+  const details = []
+  for (const c of commits) {
+    const nlIdx = c.indexOf('\n')
+    const subject = (nlIdx >= 0 ? c.slice(0, nlIdx) : c).trim()
+    if (subject === '') continue
+    subjects.push(subject)
+    if (nlIdx >= 0) {
+      const bodyText = c.slice(nlIdx + 1).trim()
+      if (bodyText !== '') {
+        details.push(`**${subject}**\n\n${bodyText}`)
+      }
+    }
+  }
+
+  let b = '## Commits\n\n'
+  for (const s of subjects) {
+    b += `- ${s}\n`
+  }
+  if (details.length > 0) {
+    b += '\n## Detalhes\n\n'
+    b += details.join('\n\n')
+    b += '\n'
+  }
+  b += `\n---\nBranch: ${branch}\n`
+  return b
+}
+
 /**
  * buildForgeCreateArgs appends --title and --body (or --description for azure)
  * to a copy of adapter.cliArgs. Never mutates the original array.
@@ -258,6 +406,13 @@ function runShip(opts, deps = {}) {
     return execGit(args)
   }
 
+  // ─── Step 0: staged files ───────────────────────────────────────────────────
+  // Read once, up front, so Steps 1 and 2 can grant a doc-only exception before they run —
+  // and so Step 4 below reuses the same read instead of querying git twice.
+  const { stdout: stagedOut } = execGit(['diff', '--cached', '--name-only'])
+  const stagedFiles = splitNonEmptyLines(stagedOut)
+  const docOnly = allDocOnly(stagedFiles)
+
   // ─── Step 1: Branch validation ─────────────────────────────────────────────
   const branchResult = execGit(['symbolic-ref', '--short', 'HEAD'])
   if (branchResult.error) {
@@ -266,14 +421,15 @@ function runShip(opts, deps = {}) {
   }
   const branch = branchResult.stdout.trim()
 
+  // main/master is blocked unconditionally — the doc-only exception never applies here.
   if (branch === 'main' || branch === 'master') {
     writeln(`error: trackfw ship cannot run on "${branch}" — use a feature branch:\n  git checkout -b feat/<slug>`)
     return 1
   }
 
-  if (!isShipBranch(branch)) {
+  if (!docOnly && !isShipBranch(branch)) {
     writeln(
-      `error: branch "${branch}" does not match the required pattern feat|fix|refactor/<slug>\n` +
+      `error: branch "${branch}" does not match the required pattern feat|fix|refactor|chore|docs/<slug>\n` +
       'Rename your branch or create a new one:\n  git checkout -b feat/<slug>'
     )
     return 1
@@ -282,25 +438,35 @@ function runShip(opts, deps = {}) {
   writeln(`Branch: ${branch}`)
 
   // ─── Step 2: Governance ────────────────────────────────────────────────────
-  const violations = checkGovernanceFn()
-  if (violations.length > 0) {
-    writeln('\nGovernance check failed:')
-    for (const v of violations) {
-      writeln(`  ${v}`)
+  // Doc-only changes (all staged files under docs/, vault/, or *.md) are exempt from
+  // REQ+roadmap governance — mirrors the CLAUDE.md §7 exception for doc-only changes.
+  if (docOnly) {
+    writeln('Governance: skipped (doc-only change)')
+  } else if (isShipBranch(branch) && !isGatedShipBranch(branch)) {
+    // chore/docs: housekeeping types already exempted from this gate by
+    // `trackfw branch new` and `trackfw commit` — ship without it too.
+    writeln('Governance: skipped (chore/docs branch)')
+  } else {
+    const violations = checkGovernanceFn()
+    if (violations.length > 0) {
+      writeln('\nGovernance check failed:')
+      for (const v of violations) {
+        writeln(`  ${v}`)
+      }
+      writeln('\nCreate the required artifacts before running ship:')
+      writeln('  trackfw req new "<title>"')
+      writeln('  trackfw roadmap new "<title>"')
+      writeln('  trackfw roadmap move <name> wip')
+      writeln("\nNote: this governance check is a hard gate — it is not affected by lenient")
+      writeln("mode or per-rule severity configured in trackfw.yaml. If 'trackfw validate'")
+      writeln("passes but 'trackfw ship' aborts here, you likely have lenient mode")
+      writeln("configured — ship always requires REQ + roadmap in wip/.")
+      writeln(`\nerror: governance check failed: ${violations.length} violation(s)`)
+      return 1
     }
-    writeln('\nCreate the required artifacts before running ship:')
-    writeln('  trackfw req new "<title>"')
-    writeln('  trackfw roadmap new "<title>"')
-    writeln('  trackfw roadmap move <name> wip')
-    writeln("\nNote: this governance check is a hard gate — it is not affected by lenient")
-    writeln("mode or per-rule severity configured in trackfw.yaml. If 'trackfw validate'")
-    writeln("passes but 'trackfw ship' aborts here, you likely have lenient mode")
-    writeln("configured — ship always requires REQ + roadmap in wip/.")
-    writeln(`\nerror: governance check failed: ${violations.length} violation(s)`)
-    return 1
-  }
 
-  writeln('Governance: OK')
+    writeln('Governance: OK')
+  }
 
   // ─── Step 3: Squash-merge detection ────────────────────────────────────────
   if (opts.dryRun) {
@@ -323,8 +489,8 @@ function runShip(opts, deps = {}) {
   if (diffStatOut) writeln(diffStatOut)
   writeln('────────────────────────────────────────────────────────\n')
 
-  const { stdout: cachedFiles } = execGit(['diff', '--cached', '--name-only'])
-  if (!cachedFiles.trim()) {
+  // Reuses stagedFiles read at the top of the function (Step 0) — never re-query git here.
+  if (stagedFiles.length === 0) {
     writeln(
       'error: nothing is staged — stage your files explicitly before running ship:\n' +
       '  git add <file1> <file2> ...\n' +
@@ -391,7 +557,23 @@ function runShip(opts, deps = {}) {
     return 0
   }
 
+  // Title/body computed once for every remaining branch below (dry-run and real CLI
+  // invocation alike). git log/diff are read-only — they run in --dry-run mode too, same
+  // as the staged-files read in Step 0.
+  //
+  // Design decision (documented per roadmap ML-1A, mirrored from the Go implementation):
+  // the title is always firstLine(opts.message), the -m message passed to this very `ship`
+  // call, even when the branch carries multiple prior commits. Deriving a distinct "PR
+  // title" from N unrelated commit subjects would need a heuristic with no unambiguous
+  // answer — the simplest, least surprising rule is that -m is the PR's summary.
+  const base = defaultBaseBranch(execGit)
+  const commits = gitCommitsSince(base, execGit)
+  const title = firstLine(opts.message || '')
+  const body = buildPRBody(branch, commits)
+
   if (opts.dryRun) {
+    writeln(`[dry-run] Title: ${title}`)
+    writeln(`[dry-run] Body:\n${body}`)
     if (!adapter.available && resolution.forge !== 'manual') {
       const url = adapter.fallbackURL(remoteURL, branch)
       if (url) {
@@ -423,8 +605,6 @@ function runShip(opts, deps = {}) {
   }
 
   // CLI is available — invoke it.
-  const title = firstLine(opts.message || '')
-  const body = `Branch: ${branch}\n\nCreated by trackfw ship.`
   const cliArgs = buildForgeCreateArgs(adapter, title, body)
   const execForgeCLI = deps.execForgeCLI || defaultExecForgeCLI
   const cliErr = execForgeCLI(adapter.cliName, cliArgs)
@@ -443,6 +623,7 @@ function runShip(opts, deps = {}) {
 module.exports = {
   runShip,
   isShipBranch,
+  isGatedShipBranch,
   isGitWriteCmd,
   normalizeBranchSlug,
   checkShipGovernance,
@@ -451,4 +632,10 @@ module.exports = {
   GIT_WRITE_COMMANDS,
   buildForgeCreateArgs,
   firstLine,
+  allDocOnly,
+  splitNonEmptyLines,
+  defaultBaseBranch,
+  gitCommitsSince,
+  buildPRBody,
+  COMMIT_MESSAGE_SEP,
 }