dot-iu-cutter v0.2 — P0-2 Manifest Design Report

document_path: knowledge/dev/laws/dieu44-trien-khai/v0.2-design/dot-iu-cutter-v0.2-p0-2-design-report-2026-05-16.md
revision: r1
date: 2026-05-16
author: Agent (Claude Code CLI, Opus 4.7 1M)
sovereign: User / anh Huyên
verifier: GPT (P0-2 design review — PENDING)
phase: v0.2 — P0-2 manifest DESIGN CONSOLIDATED REPORT (logical only)
mutation_performed: false
ddl_written: false
dry_run_started: false
production_migration_allowed: false
br_6_status: closed_with_notes (GPT 2026-05-16; Option D)

---

§1 — Files Created (this set, all 2026-05-16, in …/v0.2-design/)

1. dot-iu-cutter-v0.2-p0-2-manifest-design-master-2026-05-16.md
2. dot-iu-cutter-v0.2-p0-2-manifest-envelope-design-2026-05-16.md
3. dot-iu-cutter-v0.2-p0-2-manifest-unit-block-design-2026-05-16.md
4. dot-iu-cutter-v0.2-p0-2-br-6-invariant-integration-2026-05-16.md
5. dot-iu-cutter-v0.2-p0-2-gov-decision-register-2026-05-16.md
6. dot-iu-cutter-v0.2-p0-2-risk-and-dry-run-planning-note-2026-05-16.md
7. (this file) design report

§2 — Recommended Design (summary)

manifest_envelope:
  identity: envelope_id (uuid PK)
  operation_kind: {first_cut, split, merge}  (app-layer enum)
  status: {draft, under_review, accepted, rejected, withdrawn, enacted, superseded}
  soft_refs: escalation_ref→decision_backlog_entry, cut_change_set_ref→cut_change_set,
             superseded_by_envelope_id (self)
  owner/reviewer: created_by/at, reviewer/reviewed_at, rationale
  in_schema_FK: NONE on envelope itself

manifest_unit_block:
  composite_PK: (envelope_id, unit_local_id)
  in_schema_FK: envelope_id → manifest_envelope   (the ONLY PG FK in P0-2)
  block_role: {origin, result}  (app-layer enum)
  source_span: MANDATORY
  render_order: present (recompute = P1)
  soft_refs: target_unit_id→public.tac_logical_unit.id, decision_backlog_ref
  proposal_fields: proposed_canonical_address, proposed_authority (proposal-only)
  jsonb: payload_summary, candidate_edges, report_summary  (X-3; intent only)

constraints_honored:
  - cross-schema refs = soft uuid only; single in-schema FK (block→envelope)
  - no PG CHECK / trigger / DEFAULT-data in P0-2
  - no manifest↔alias coupling; no edge tables
  - tables empty at create (later); rollback = DROP empty tables
  - split/merge EXECUTION remains P1
invariants_carried: INV-1..INV-6 (mapped in file 4)

§3 — Open Questions

GOV-1 address-coining rule        — owner Đ24+GPT  — agent lean: O3 hybrid
GOV-2 authority inheritance       — owner Đ0-G+GPT — agent lean: O1 demote-to-draft
GOV-3 manifest↔alias linkage      — owner GPT      — agent lean: O1 event-backed (no coupling)
design_open_items (non-blocking for design review):
  - source_span concrete form (jsonb vs PG range) — DDL-authoring decision, not frozen here
  - unit_local_id concrete type (text vs smallint) — DDL-authoring decision
  - cardinality enforcement (split 1:N, merge M:1) — application-layer; not P0-2 PG-enforced
all GOV: block DDL freeze; NONE block design start or this design review

§4 — GOV Decision Summary

GOV	Blocks design start	Blocks DDL freeze	Owner	Status
GOV-1	No	Yes	Đ24 + GPT	OPEN
GOV-2	No	Yes	Đ0-G + GPT	OPEN
GOV-3	No	Yes	GPT	OPEN

Agent does not self-close any GOV decision. Leans are for council/GPT consideration.

§5 — Risk Class Estimate

STANDARD (estimate; not ratified here). No HIGH-council escalation expected: additive, empty, single in-schema FK, no live-table/sister-table touch, no CUT/VERIFY, no data mutation. 8 risk surfaces enumerated with mitigation postures (file 6 §2).

§6 — Readiness

p0_2_design_status: ready_for_gpt_review
all_7_docs_authored: TRUE
internally_consistent: TRUE
  - envelope/block fields match the BR-6 absorption binding constraints + GPT review §2
  - INV-1..6 mapped with encode-now / defer-P1 / review-checklist (file 4)
  - GOV-1/2/3 registered, not closed; DDL-freeze gate consistent across all docs
  - risk class STANDARD estimate consistent with v0.1/Phase-α additive precedent
ddl_authoring_allowed: FALSE
  reason: gated on GOV-1/2/3 resolution + this design GPT-reviewed PASS + explicit prompt
mutation_performed: FALSE
dry_run_started: FALSE
production_migration_allowed: FALSE
what_gpt_review_should_decide:
  - approve / revise the 7-doc P0-2 design set
  - confirm Option-D minimum-hook surface is correct (not under/over-built)
  - direct GOV-1/2/3 resolution path + owners
  - (only after GOV closure + this review PASS + explicit prompt) open DDL-authoring lane
agent_self_advance: PROHIBITED

§7 — Negative Confirmations

no_DDL_written: TRUE
no_SQL_executed: TRUE
no_CREATE_TABLE / ALTER / INSERT / UPDATE / DELETE: TRUE
no_migration: TRUE
no_dry_run_started: TRUE
no_dry_run_env_provisioned: TRUE
no_production_touch: TRUE
no_CUT_or_VERIFY: TRUE
no_split_merge_execution: TRUE
no_alias_writes: TRUE
no_P0_6_review_decision_design (dependency note only): TRUE
no_P0_5_remainder_work: TRUE
no_GOV_self_closed: TRUE
protected_dry_run_envs_untouched_this_session: TRUE
output_form: p0_2_manifest_design_consolidated_report

§8 — Cross-References

br_6_absorption_gpt_review: knowledge/dev/laws/dieu44-trien-khai/reviews/dot-iu-cutter-v0.2-br-6-absorption-gpt-review-2026-05-16.md
br_6_absorption_report:     knowledge/dev/laws/dieu44-trien-khai/v0.2-planning/dot-iu-cutter-v0.2-br-6-absorption-report-2026-05-16.md
scope_backlog:              knowledge/dev/laws/dieu44-trien-khai/planning/dot-iu-cutter-v0.2-scope-backlog-2026-05-15.md
phase_alpha_closeout_review:knowledge/dev/laws/dieu44-trien-khai/reviews/dot-iu-cutter-v0.2-phase-alpha-closeout-gpt-review-2026-05-16.md
this_set: knowledge/dev/laws/dieu44-trien-khai/v0.2-design/dot-iu-cutter-v0.2-p0-2-*-2026-05-16.md

End of P0-2 manifest design report.