BITESIZE READING LIBRARY V4.5.1
==============================

PRODUCT ID RECONCILIATION RELEASE
17 September 2026

WHAT CHANGED
------------
1. Presentation Builder Product IDs
   - Reading Library now reads product_id from formatVersion 5 .bitesizepresentation projects inside an installed resource ZIP.
   - If the ZIP has no separate manifest Product ID, the Presentation Builder ID is promoted into the installed resource metadata.
   - If a manifest Product ID and embedded Presentation Builder Product ID disagree, installation stops with a clear warning rather than linking the wrong catalogue product.
   - If multiple presentation editions in one ZIP contain different Product IDs, installation stops safely.

2. Catalogue Manager V3.8.7 compatibility
   - catalog.json product_id remains canonical.
   - legacy_product_ids / legacyProductIds are retained by the catalogue adapter.
   - Every published legacy alias is indexed as an exact alias to the canonical product.
   - Verified standards are still stored and counted against the canonical Product ID only.

3. Existing / older installed resources
   - Existing exact resource IDs can now resolve through catalog.json legacy_product_ids.
   - If an installed resource still cannot be resolved, a Link Catalogue Product action is available.
   - Suggested catalogue products are shown for teacher confirmation, but standards are never inferred automatically from title similarity.
   - Once confirmed, Reading Library stores the canonical product_id locally for that installed resource.

4. Discover ownership
   - Discover recognises canonical IDs and published legacy aliases when deciding whether a product is already installed.

5. Standards Coverage
   - Canonical Product ID -> verified Catalogue Manager alignment remains the only route to official standards coverage.
   - Not Reviewed alignment still contributes zero official coverage.
   - Unknown or missing standards data continues to fail safely without blocking normal resource use.

COMPATIBILITY
-------------
- Storage keys and the imported-resource database are unchanged from V4.5.0.
- Existing classes, assessment data and installed resource packages are not intentionally reset by this release.
- Older resources remain usable even when no catalogue match exists.
- V4.5.0 catalogue fields remain supported.

RECOMMENDED END-TO-END WORKFLOW
-------------------------------
Presentation Builder V2.16.1 Product ID Edition
  -> permanent product_id embedded in .bitesizepresentation
Catalogue Manager V3.8.7
  -> same product_id becomes canonical
  -> thumbnail + verified standards attached
  -> catalog.json publishes canonical product_id + legacy_product_ids
Reading Library V4.5.1
  -> reads embedded product_id or exact legacy alias
  -> matches catalogue record
  -> shows verified standards automatically
