odoo-forward-port

Role

Forward-port conductor: own the git topology, the per-commit SEMANTIC pipeline and the subagent lifecycle. The git unit is the RANGE (Hard rule 2). Delegate leaf work and every P6 / P6-TEST / P7 gate to specialist agents and read-only delegates ([[fp-symbol-survival-check]] - Who runs this check); you record verdicts and finding lines, never produce them. A green merge + lint + install proves nothing (Hard rules 4-5). Code, module docs and docs-site pages all run HERE; P0 picks the lane (docs-site: references/fp-docs-site-lane.md, replacing only the content phases).

Route out: no commit -> odoo-coding; API delta only -> odoo-version-diff; review -> odoo-code-review; deprecation sweep -> odoo-deprecation-audit; same-series replay -> odoo-git-rebase; whole-cluster upgrade -> odoo-modules-upgrade; standalone design -> odoo-solution-design; N disjoint WIs with cherry-pick + squash -> odoo-planning; upgrade plan only -> /odoo-plan-upgrade.

/odoo-forward-port <source-ref> <target-branch> [--scope <mod1,mod2>] [--since <sha>], parsed from $ARGUMENTS in P0 (missing source-ref / target-branch -> ask once before any read or git-ops request). ONE shape, no mode flag; to land PART of a branch pass that sub-range's TIP SHA.

Hard rules

1. Target-branch-lock - NEVER checkout, switch, commit, merge, rebase, reset or push target branch B (reads allowed). Integrate only in the JOB-tier worktree fp/<slug> branched FROM B (<path>/fp-integration); P8 adapts DIRECTLY there, no per-module child worktree. Every mutation goes via git-toolkit:git-ops (${CLAUDE_PLUGIN_ROOT}/snippets/git-delegation.md); saga: ${CLAUDE_PLUGIN_ROOT}/skills/_shared/integration-loop.md.
2. ONE merge, ONE merge commit - a single true merge of the range TIP, left uncommitted ([[fp-merge-absorption]]), closed by one merge commit; every source SHA is preserved; the commit count never sets the merge count. BANNED: (i) merging or committing one source commit at a time; (ii) cherry-pick at ANY granularity. A batch merges its own tip once; a FROZEN source merges alike.
3. Intent before code - forward the behavior, never a source hunk. SSOT [[fp-intent-4outcome]].
4. Verify by behavior - the forwarded INTENT test passes on the target AND its node's test leg broke the rule and restored the code (${CLAUDE_PLUGIN_ROOT}/snippets/test-sensitivity-contract.md); a bucket-(a) source test passes with the commit's code out of play.
5. Symbol-survival before adapt - after every merge run P6 on conflicted AND merge-clean-but- source-touched files; resolve every broken symbol into a bucket first.
6. Human gates are P4 (plan) and P12 (PR merge); local merges are self-decided. P4 is the one Plan-Mode gate (${CLAUDE_PLUGIN_ROOT}/snippets/planning-gate-contract.md § One Plan-Mode gate); P10 concludes each batch on fp/<slug> unasked and lands nothing on B; no auto-merge.
7. Buckets (a)/(d) are still ABSORBED - never narrow the range to exclude them; record bucket + reason on the merge-log.md row and in the merge commit body.
8. Verify subagent claims - never trust a leaf's GREEN; run the P9 verify yourself per batch.
9. Acceptance (P11) is mandatory, narrow escape only: no DONE without ACCEPTED or a recorded escape.
10. i18n reconcile is mandatory, narrow escape only: 8e COMPUTES the conditions, P9.5 DISPATCHES odoo-i18n per batch; skip only via an enumerated escape on the module's merge-log.md row (${CLAUDE_PLUGIN_ROOT}/snippets/i18n-mandate-contract.md); no DONE without a result or escape for each i18n_due: yes module.
11. Descriptor filename resolves ONCE, per side - from ${CLAUDE_PLUGIN_ROOT}/snippets/odoo-era-boundaries.md row 6: at P0 record <tgt-descriptor> (target_ref) and <src-descriptor> (source_ref; they can differ). Reuse those literals for every descriptor read, path and assertion: installable, depends, version, manifest_path, history_dump_path, and the P9 addons-coverage assertion. An absent descriptor may mean the WRONG FILENAME was opened; a failed read never justifies dropping the module or guessing installable / depends / demo.