🔥 Release Readiness
Historical record — 2026-07-30
Preserved as observed against database schema 1.6.5; current schema is 1.6.8 (
masterplan.md:21). Current truth: Program Masterplan.
Raw chronology: 2026-07-30 release readiness log
One-line truth: The bench’s printable-download metric is deliberately per successful download; release remains a hard NO-GO until the release owner accepts a canonical-pipeline port.
🎯 Mission
| Field | Truth |
|---|---|
| Outcome | Evidence-only canonical-port handoff plus reconciled present-tense bench documentation. |
| User | Bench owner and release owner. |
| Success | Reviewable manifest/hashes/reproduction/verification packet; no bench-local work mistaken for release work. |
| Constraints | Bench-only, releaseEligible: false; no publish, release, migration, package install, canonical port, or compiled-asset edit. |
| Non-goals | Reimplementing verified features, signing, packaging, publishing, or claiming release readiness. |
✅ Confirmed truth
| ID | Fact | Grade | Evidence | Implication |
|---|---|---|---|---|
| F-001 | The stored schema marker and Installer::SCHEMA_VERSION are both 1.6.5; Installer will treat the marker as current. | E3 | Safe WP-CLI option read; includes/Installer.php:15,53-55. | The physical user_id column/index was not independently inspected in this BBQ pass. |
| F-002 | The German gate has its required .mo and nine named per-handle JSON catalogs; fr/es remain unavailable and stored unavailable choices fall back to auto. | E2 | includes/{ExposureSettings,UiLanguage}.php; language inventory. | File presence proves gating, not exhaustive rendered-string proof or release authorization. |
| F-003 | Successful PDF attachment downloads use PlayEvents::increment(), so every repeat GET to a valid 15-minute artifact URL increments the printable-sheet counter; the seven-day guard is used by share only. | E2 | includes/Pdf/PdfArtifact.php:44-85,150-187; includes/PlayEvents.php:13-42; includes/Frontend/UserSurfaces.php:155-163. | User decision D-001 confirms this intentional per-successful-download metric; correct only the false idempotency documentation claim. |
| F-004 | Cache-versioning is partial: 24 enqueue calls use asset_version(), six current Dashboard/MetaBoxes calls use QUIZWIZZ_VERSION directly, and one player enqueue inherits its registered version. | E2 | Source traces plus a fresh public response at https://wrdp.loca.zone/?page_id=57, which emitted mtime-derived ?ver= URLs for observed asset-versioned CSS/JS. | Do not claim universal coverage, response-cache headers, warm-browser behavior, effective invalidation, or direct/inherited-path behavior. |
| F-005 | Release is a hard NO-GO from this bench. | E2 | release blockers; BUILDING.md; SOURCE-PROVENANCE.md. | Canonical repo/commit, locked toolchain/CI, provenance, compatibility gates, and signing remain release-owner-only. |
🧭 Decisions
| ID | Status | Choice / next decision | Depends on | Unlocks |
|---|---|---|---|---|
| D-001 | settled | Count every successful printable-sheet download, including repeat GETs to a valid artifact URL. | User decision. | Documentation correction only; no event-counter code change. |
| D-002 | settled | Prepare an evidence-only canonical-port handoff and reconcile present-tense bench truth. | User decision. | A reviewable packet, never a bench release. |
⚠️ Assumptions, conflicts, risks
| ID | Type | Statement | Owner/check | Impact |
|---|---|---|---|---|
| R-001 | authorization | Bench-local source and generated catalog artifacts require release-owner review and regeneration in the canonical protected pipeline. | Release owner. | Hard release NO-GO. |
| C-001 | resolved | Localization claims now distinguish observed German catalog/gate remediation from unperformed exhaustive forced-DE rendering and required release-owner regeneration. | Documentation repair slice. | Handoff accuracy. |
| C-002 | resolved | Replace the universal cache claim with callsite-scoped source truth and disclose the narrow fresh-public URL observation without overclaiming warm-cache behavior. | Documentation repair + observation slice. | Handoff accuracy. |
| C-003 | resolved | Current truth now states the selected per-successful-download metric and share-only idempotency. | Documentation repair slice. | Handoff accuracy. |
🐝 Swarm digest
| Wave | Domains | New truth | Remaining gap | Why next wave? |
|---|---|---|---|---|
| 1 | Runtime, documentation, release boundary, residual risk | Schema 1.6.5 confirmed; release hard NO-GO; three current documentation/semantics conflicts found. | Actual cache URL behavior; printable-download metric decision. | Narrowed source traces required. |
| 2 | Schema option, enqueue scope, PDF event trace | Schema matches target marker; print is intentionally per delivered GET; cache helper is partial. | User-owned print metric semantics. | The next uncertainty is not recoverable from system truth. |
| 3 | User decision | Every successful printable-sheet download counts. | Whether to prepare an evidence-only canonical-port handoff. | No print-counter code change. |
| 4 | User authorization | Evidence-only handoff plus truth repair authorized. | None. | Launch packet accepted. |
📦 Launch packet
objective: "Prepare an evidence-only canonical-port handoff and reconcile current bench documentation."
non_goals:
- "Canonical source port, build, signing, package, release, or wiki publish"
- "Compiled build/ edits and fr/es catalog creation"
confirmed_facts:
- "Schema version marker is 1.6.5; physical user_id/index not re-inspected in this BBQ pass"
- "German gate has its required MO plus nine named handle catalogs; fr/es remain dormant"
- "Printable-sheet metric counts every successful download; share alone uses the seven-day guard"
- "asset_version coverage is partial; fresh public asset-versioned URLs were observed, but effective warm-cache invalidation remains unproven"
- "Release is a hard NO-GO without canonical source and locked pipeline"
decisions:
- id: D-001
choice: "Count every successful printable-sheet download"
- id: D-002
choice: "Prepare evidence-only canonical-port handoff plus present-tense truth repair"
acceptance_criteria:
- "Current truth pages describe print/share, localization, and cache scope accurately"
- "A packet inventories handoff inputs, hashes exact review artifacts, and gives reproducible verification steps"
- "Quartz check-only passes; no publication occurs"
implementation_constraints:
- "Bench-local documentation and evidence only"
- "No claim of release authorization or release readiness"
verification:
- "Static source evidence plus targeted non-mutating cache observation where available"
- "/home/loca/dev/wikis/build.sh wrdp --check-only"
rollback:
- "Revert only the documentation/packet files; no runtime source is changed"
open_deferred:
- "Canonical port, protected release pipeline, provenance/signing, compiled block fixes, fr/es, publication, pruning"✅ Completion evidence
- Canonical-owner packet: 2026-07-30 Canonical-Port Evidence Packet.
- Exact finite catalog snapshot:
q5vault/audits/qwizz/2026-07-30-catalog-manifest.sha256; all 14 entries passedsha256sum --checkfrom the WRDP repository root. - Final vault validation:
/home/loca/dev/wikis/build.sh wrdp --check-onlycompleted successfully after parsing 32 Markdown inputs and emitting 284 files. No publication occurred.