krflol · Oct 1, 2026 · Oct 1, 2026
diff --git a/README.md b/README.md
@@ -16,7 +16,7 @@ Changes to `main` build, check internal links and metadata, then deploy through
 Reference pages come from the engine repository's release tag. Keep hand-authored introductions and guides here; import API, CLI, CSS, architecture, print, and performance references with:
 
 ```bash
-python tools/sync_reference.py --source /path/to/fullbleed-official --ref v2.4.0
+python tools/sync_reference.py --source /path/to/fullbleed-official --ref v2.5.0
 ```
 
 `docs/reference-source.json` records the exact source commit. Use a built, installed release wheel to rerun examples and review the final PDFs and previews before replacing downloadable artifacts. `docs/assets/examples/verification.json` records the checks performed on published examples.

diff --git a/docs/cli/commands.md b/docs/cli/commands.md
@@ -1,6 +1,6 @@
 # CLI Reference
 
-Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/v2.5.0/docs/cli.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/cli.md). Check the installed runtime for your exact version.
 
 Executable entrypoint:
 
@@ -96,14 +96,14 @@ High-value options:
 
 - input: `--html` / `--html-str`, `--css`, `--css-str`
 - output: `--out`
-- development (2.5.0+): `--watch`, repeatable `--watch-path`, `--watch-interval`, `--watch-debounce`; see [automatic rebuilds](../guides/render-watch.md)
 - assets: `--asset`, `--asset-kind`, `--asset-name`, `--asset-trusted`
 - template compose (auto-finalize): `--template-binding`, `--templates`, `--template-dx`, `--template-dy`
 - page/pdf: `--page-size`, `--page-width`, `--page-height`, `--margin`, `--pdf-version`, `--pdf-profile`
 - diagnostics: `--emit-jit`, `--emit-perf`, `--emit-glyph-report`, `--emit-page-data`, `--emit-compose-plan`
 - image artifacts: `--emit-image`, `--image-dpi`
 - policy: `--profile`, `--fail-on`, `--allow-fallbacks`, budget flags
 - reproducibility: `--deterministic-hash`, `--repro-record`, `--repro-check`
+- development (2.5.0+): `--watch`, repeatable `--watch-path`, `--watch-interval`, `--watch-debounce`; see [automatic rebuilds](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/render-watch.md)
 
 Template auto-compose notes:
 - When `--templates` is set on `render`, CLI renders overlay, resolves template bindings, and finalizes via Rust compose in one command.

diff --git a/docs/css-coverage.md b/docs/css-coverage.md
@@ -1,6 +1,6 @@
 # CSS Coverage and Parity Status
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/css-coverage.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/css-coverage.md). Check the installed runtime for your exact version.
 
 This document is the canonical statement of validated CSS coverage for Fullbleed's deterministic HTML/CSS-to-PDF engine.
 

diff --git a/docs/engine/overview.md b/docs/engine/overview.md
@@ -1,6 +1,6 @@
 # Engine Architecture
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/engine.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/engine.md). Check the installed runtime for your exact version.
 
 This document describes the Rust engine layer in `src/` and how it maps to the Python and CLI interfaces.
 

diff --git a/docs/engine/pdf-engine.md b/docs/engine/pdf-engine.md
@@ -1,6 +1,6 @@
 # Python API Reference
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/python-api.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/python-api.md). Check the installed runtime for your exact version.
 
 Primary import:
 

diff --git a/docs/engine/template-composition.md b/docs/engine/template-composition.md
@@ -1,6 +1,6 @@
 # PDF Templates and XObjects
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/pdf-templates.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/pdf-templates.md). Check the installed runtime for your exact version.
 
 This document defines the Fullbleed template-composition path for source PDF workflows.
 

diff --git a/docs/guides/performance.md b/docs/guides/performance.md
@@ -1,6 +1,6 @@
 # Performance pass results: 2026-08-04
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/performance-pass-2026-08-04.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/performance-pass-2026-08-04.md). Check the installed runtime for your exact version.
 
 This report compares the Fullbleed 2.1.0 release source with the independently measured Fullbleed
 2.0.0 baseline on the same Windows AMD64 host. The independent Python harness used 20 latency

diff --git a/docs/guides/print-output.md b/docs/guides/print-output.md
@@ -1,6 +1,6 @@
 # PDF/VT composition and print identity
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/pdf-vt.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/pdf-vt.md). Check the installed runtime for your exact version.
 
 `pdfx4` and `pdfvt1` force PDF 1.6 and require a nonempty document title,
 an explicit timestamp, a structurally valid embedded ICC output intent, and
@@ -142,4 +142,4 @@ The optional dedicated-validator job uses repository variables `PDFVT_VALIDATOR_
 already have a licensed or otherwise usable dedicated validator. With no
 dedicated runner configured, that additional job is skipped; the required
 engineering gate still runs. A configured dedicated job must pass. See the
-[2.4.0 runbook](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/release/2.4.0-runbook.md) for evidence and publication requirements.
+[2.4.0 runbook](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/release/2.4.0-runbook.md) for evidence and publication requirements.
diff --git a/docs/reference-source.json b/docs/reference-source.json
@@ -1,6 +1,6 @@
 {
-  "release": "v2.4.0",
-  "commit": "56850a6536f9369e17b2344cbf62848c1c783e10",
+  "release": "v2.5.0",
+  "commit": "c2f14da5b475d721e48a648462ca7852e26c5aec",
   "pages": {
     "docs/python-api.md": "engine/pdf-engine.md",
     "docs/engine.md": "engine/overview.md",

diff --git a/docs/ui/overview.md b/docs/ui/overview.md
@@ -1,6 +1,6 @@
 # `fullbleed.ui` Accessibility Authoring
 
-Reference imported from [v2.4.0](https://github.com/fullbleed-engine/fullbleed-official/blob/56850a6536f9369e17b2344cbf62848c1c783e10/docs/ui-accessibility.md). Check the installed runtime for your exact version.
+Reference imported from [v2.5.0](https://github.com/fullbleed-engine/fullbleed-official/blob/c2f14da5b475d721e48a648462ca7852e26c5aec/docs/ui-accessibility.md). Check the installed runtime for your exact version.
 
 This guide covers the component-first HTML authoring helpers in `fullbleed.ui`,
 with a focus on `fullbleed.ui.accessibility` for remediation-oriented document