KB-4A87

P3D Pack 1 Phase 5A — Semantic Registry Disambiguation Patch Report

3 min read Revision 1
p3dpack1phase5adisambiguationsemantic-registrypatch-report

P3D Pack 1 Phase 5A — Semantic Registry Disambiguation Patch Report

Date: 2026-05-11 Author: Opus 4.7


Status flags

phase5a_status=PATCHED
mode=PROMPT_PATCH_ONLY
migration_allowed=false
seed_allowed=false
backfill_allowed=false
nesting_decision_locked=false
semantic_registry_updated=true
rerun_required=true
rerun_scope=FULL_G1_G11_RECOMMENDED
requires_GPT_User_review_before_agent_dispatch=true

Paths

Artifact Path
Design addendum ...design/p3d-pack1-phase5a-semantic-registry-disambiguation-addendum.md
Prompt rev5 ...prompts/p3d-pack1-phase5-readonly-dryrun-tac-to-iu-migration-prompt.md (rev 19)
This report ...reports/p3d-pack1-phase5a-semantic-registry-disambiguation-patch-report.md

Top 5 semantic registry changes

  1. publication_linkpublication_ref + logical_unit_ref — tac_publication_member has TWO FKs; old concept captured both. Split by semantic role: publication FK vs logical unit FK.

  2. Added publication_render_orderrender_order on tac_publication_member was UNREGISTERED (FIELD_ABSENT on sort_order). New concept with candidates: render_order, pub_order, display_order, render_sequence.

  3. provenance_profileprovenance_json_profile + provenance_text_note — unit_version has content_profile (jsonb, structured provenance carrier per Phase 4B §7) AND provenance (text, editor note). Different types, different purposes.

  4. collection_keycollection_table_key + collection_display_name — collection_registry has collection_name (PG table name, FK key) AND name (display label). Split by role.

  5. Concept migration note in §2 — explicit mapping from old to new concept names so goals referencing old names (G10/G11) can substitute correctly. Agent reads the note before goal execution.

Rerun recommendation

Full G1-G11 rerun (not selective). Rationale: read-only = zero risk; registry change affects resolved field map across all tables; one clean pass produces complete evidence for nesting/species/pilot decisions.

Confirmation

phase5a_prompt=REV5_READY_FOR_GPT_REVIEW
next_action=GPT_REVIEW_THEN_AGENT_RERUN_G1_G11
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/reports/p3d-pack1-phase5a-semantic-registry-disambiguation-patch-report.md