docs(site): document target-branches and infer-target-from-checkout-ref for create-pull-request

[github-actions]

Summary

• Users configuring multi-repo agents with per-repo PR target branches had no site docs to guide them. The target-branches and infer-target-from-checkout-ref fields introduced in feat(compile): decouple create-pull-request diff base from checkout depth #1425 were referenced in a prose paragraph but absent from the Configuration options list.

Changes

• site/src/content/docs/reference/safe-outputs.mdx — expanded the create-pull-request configuration options:
  • target-branch description clarified to mention override precedence
  • New target-branches entry with map-syntax example
  • New infer-target-from-checkout-ref entry with semantics, tag-ref warning, and resolution precedence chain

Accuracy checks

• target_branches: HashMap<String, String> and infer_target_from_checkout_ref: bool confirmed in src/safe_outputs/create_pull_request.rs (CreatePrConfig, lines 404–415)
• Resolution precedence confirmed in resolve_target_branch() (same file, lines 504–534)
• Tag-ref compile-time warning confirmed in src/compile/common.rs (warn when infer-target-from-checkout-ref and a checkout repo is at a refs/tags/* ref)
• Field descriptions aligned with docs/safe-outputs.md (agent-facing docs), which already had these entries

Validation

• cd site && npm run build:astro — 38 pages built, all internal links valid

---

Created by the docs-writer workflow.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• cdn.playwright.dev

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "cdn.playwright.dev"

See Network Configuration for more information.

Generated by Docs Writer · 52.3 AIC · ⌖ 9.32 AIC · ⊞ 7.7K · ◷