# R6 Documentation, Packaging, CI, And Operations Evidence

Date: 2026-07-16

Clean archive source commit: `267bd39`

R6 review correction commit: `57acb58` (test and documentation only; no
runtime source changed after the clean archive gate)

## Results

| Gate | Evidence | Result |
|---|---|---|
| PR release tier | `python3 scripts/run_release.py --tier pr --evidence todo/measurements/2026-07-16-r6-pr-evidence.json` | PASS: script contracts, documentation drift/rendering, and strict Clippy |
| Script contracts | Release runner and playground unit suites plus maintained-entry-point and unsafe-block inventories | PASS: 81 maintained scripts, 10 reviewed unsafe blocks, 2 runner tests, and 6 playground tests |
| Public documentation | `cd docs && npm run check`; `scripts/check_docs_drift.sh`; `python3 scripts/check_external_links.py` | PASS: 42 MDX/README files compiled, rendered, and spell-checked with zero issues; 27 external URLs and all local/API/source-map links passed |
| Rust documentation | Strict `cargo rustdoc`, `cargo doc`, and doctests for `pg17 development` | PASS: no warnings, missing public docs, broken intra-doc links, or doctest failures |
| Clean source package matrix | `cd graph && PG_VERSIONS='14 15 16 17 18' ./tests/heavy/source_archive_smoke.sh` | PASS: exact release archive packaged and installed for PostgreSQL 14, 15, 16, 17, and 18; every major passed `CREATE EXTENSION`, build, traversal, and search smoke |
| Alpha migration | Source-archive gate builds the signature-bearing `v0.1.8` producer source, installs it, removes generated sync objects with `DROP EXTENSION ... CASCADE`, preserves source rows/checksum, installs 1.0.0, re-registers, and rebuilds | PASS: source checksum `7597c464628b5c2e0674ea849bd8337a` and extension version `1.0.0` verified |
| Packaged quickstart | Public `scripts/quickstart.sh quickstart` against the archive-built runtime image | PASS: discovery/build, relational query, search, traversal, and shortest path returned the documented results |
| Packaged playground | Public playground release gate against the archive-built runtime image and pinned Panama dataset | PASS: 40 CSR and 41 mutable catalog queries, including operational build/sync/vacuum/maintenance and mutable GQL examples |
| Discovery production regression | PG17 production install followed by `graph.auto_discover('public')` and `graph.status()`; `PG_VERSION_FEATURE=pg17 DBNAME=pggraph_build_lock_r6_discovery ./tests/heavy/build_lock_regression.sh` | PASS: 2 nodes and 2 edges built; caller-owned mapping-catalog writes cause `auto_discover(..., build => true)` to fail with `55P03`/`PG006` and roll back registration; trusted discovery accepts only its own catalog locks |
| Focused Rust assurance | Formatting, strict all-target Clippy, build-snapshot unit tests, and focused pgrx discovery test | PASS |
| Independent review | Fresh `rust-reviewing` review of final R6 tree and correction | PASS: reviewer-required production discovery-lock regression added; no remaining correctness, security, packaging, CI, or documentation blocker |

## Gate Corrections Found By Clean Artifacts

The clean archive gate exposed and closed three harness/product integration
defects before R6 completion: absolute archive output handling, alpha generated
trigger removal and writable transition targets, and the production
`auto_discover(..., build => true)` catalog-lock boundary. The final gate was
rerun from the clean committed tree after all corrections.

## Deviations

No R6 release-gate waiver is recorded. Package execution used the supported
Linux container path on Apple Silicon; R7 retains the cross-platform RC artifact
and publication evidence requirements.