KB-1705

Handoff — P3D Pack 1 Phase 5 Dry-Run PASS — Decisions Pending

5 min read Revision 1
p3dpack1phase5handoffdecisions-pendingnestingspecies

Handoff — P3D Pack 1 Phase 5 Dry-Run PASS — Nesting/Species/Pilot Decisions Pending

Date: 2026-05-11 Author: Opus 4.7 For: Next Opus session / GPT / User Status: Phase 5 evidence COMPLETE. 3 architectural decisions pending.


1. One-line summary

Phase 5 dry-run gathered ALL evidence for TAC→IU migration. Semantic field registry (31 concepts) proven. Zero ambiguity remaining. GPT/User must decide nesting (D1/D2/D3), species/composition, and pilot document before executable migration begins.


2. What's been done (Phases 1–5 dry-run)

Phase Status Key outcome
Phase 1-2 DONE IU schema extended, inventory complete
Phase 3 DONE Hash/planner/birth investigated; TAC vs IU differences cataloged
Phase 4 vocab PASS 14 vocab keys committed; planner resolves law_unit=plan_ok
Phase 4B discovery PASS 40 species, 153 mappings, IU unmapped, fn_birth_registry_auto documented, discriminator dormant
Phase 4C dry-run PASS 8 PLAUSIBLE species (5 atom, 3 molecule), deterministic labels
Phase 4D decision memo ACCEPTED Option 2 chosen: defer species to Phase 5
Phase 5 dry-run rev6 PASS Full evidence: 86 TAC units, 3 pubs (Đ35=36, Đ32=23, Đ28=27), nesting depth=2, 0 collisions, hash divergence confirmed, birth gates satisfied, provenance carrier available

3. Three decisions pending GPT/User

Decision 1: Nesting

Option What Consequence
D1 preserve parent_or_container_ref populated Mixed composition (parent=compound, leaf=atom)
D2 flatten All IU independent, render_order only Uniform atom composition
D3 hybrid Edges/metadata for nesting Atom composition, moderate complexity

Evidence: depth=2 shallow, render_order contiguous per pub, fn_iu_create accepts p_parent_ref.

Decision 2: Species/composition

Follows from nesting. 4 atom + 4 molecule PLAUSIBLE (management_mode=observed). No existing species semantically matches "law_unit" — new species likely. Composition = atom (if D2/D3) or mixed (if D1).

Decision 3: Pilot document

DIEU-35 (36 members, 12 section_types, depth 2) is most structurally diverse. All candidate_not_approved.


4. Key technical facts

  • Semantic field registry: 31 concepts, proven across 2 dry-runs (rev4 PARTIAL caught ambiguity, rev6 PASS resolved all)
  • fn_birth_registry_auto: reads species_collection_map WHERE is_primary=true LIMIT 1. Does NOT read discriminators.
  • fn_iu_create: 9 args including p_parent_ref uuid. Returns jsonb.
  • Hash: TAC = sha256(title|body|description|content_profile). IU = sha256(body only). Migration MUST recompute.
  • Provenance: content_profile (jsonb) is the carrier per Phase 4B addendum §7.
  • Birth gates layer1/layer2: all fields SATISFIED on information_unit.
  • Species_collection_map: 0 rows for IU/UV. Discriminator dormant (0/153 rows).
  • Birth_registry: 12 IU rows, all NULL species/composition. 0 UV rows.

5. What comes next

Sub-phase Content Blocked by
5B Species resolution + species_collection_map seed + QT-001 backfill Nesting decision (D1/D2/D3)
5C Pilot migration (one publication) 5B + pilot selection
5D Full batch migration 5C verified
5E Post-implementation design 5D complete

6. Key file paths

Design:           knowledge/dev/laws/dieu44-trien-khai/design/p3d-pack1-phase5-tac-to-iu-migration-design.md
Prompt rev6:      knowledge/dev/laws/dieu44-trien-khai/prompts/p3d-pack1-phase5-readonly-dryrun-tac-to-iu-migration-prompt.md
Dry-run report:   knowledge/dev/laws/dieu44-trien-khai/reports/p3d-pack1-phase5-tac-to-iu-migration-dryrun-report.md
Decision memo:    knowledge/dev/laws/dieu44-trien-khai/design/p3d-pack1-phase4d-species-mapping-decision-memo.md
Legal addendum:   knowledge/dev/laws/dieu44-trien-khai/design/p3d-pack1-phase4b-legal-alignment-addendum.md
Registry addendum: knowledge/dev/laws/dieu44-trien-khai/design/p3d-pack1-phase5a-semantic-registry-disambiguation-addendum.md
Opus review:      knowledge/dev/laws/dieu44-trien-khai/reviews/opus-review-p3d-pack1-phase5-dryrun-pass-full-evidence-2026-05-11.md

7. Status

phase5_dryrun=PASS_COMPLETE
evidence=FULL
nesting_decision=PENDING_GPT_USER
species_decision=PENDING_NESTING
pilot_selection=PENDING_GPT_USER
migration_allowed=false
seed_allowed=false
next_action=GPT_USER_DECIDE_NESTING_SPECIES_PILOT_THEN_PHASE5B
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/handoffs/handoff-p3d-pack1-phase5-dryrun-pass-decisions-pending-2026-05-11.md