18b-P1a — Schema Tool Inspection (Read-only)

Controlling: 18a rev4 FINAL + 18b rev3 PASS + P0 report PASS Mode: READ-ONLY. Không DDL, không UPDATE, không INSERT, không DELETE, không script rewrite, không DOT execution (trừ --help nếu có).

---

Mục tiêu

Xác định kênh DDL hợp pháp cho 3 fields mới trên collection_registry:

• birth_code_strategy
• birth_code_column
• birth_identity_source

---

Bước 0: Đọc controlling docs

Đọc trên KB trước khi chạy bất kỳ lệnh nào:

1. knowledge/dev/laws/dieu44-trien-khai/design/18a-dot119-metadata-driven-no-clobber-redesign.md
2. knowledge/dev/laws/dieu44-trien-khai/design/18b-dot119-repair-execution-pack.md
3. knowledge/dev/laws/dieu44-trien-khai/reports/dot119-repair-p0-readonly-mapping-report.md

Xác nhận đã đọc cả 3 trước khi tiếp.

---

Bước 1: Inspect DOT-074 (most topical)

# Read source
cat /opt/incomex/dot/bin/dot-schema-registry-collections-ensure

# Help/usage nếu có
/opt/incomex/dot/bin/dot-schema-registry-collections-ensure --help 2>&1 || true

Trả lời:

• Script này làm gì? (CREATE TABLE? ENSURE columns? ADD COLUMN?)
• Nó có hardcode danh sách columns không?
• Nó có support arbitrary ADD COLUMN không?
• Nó có embedded function body / CREATE OR REPLACE FUNCTION nào không?
• Nó có ghi đè data (DROP + recreate) hay idempotent (ADD IF NOT EXISTS)?
• Dùng nó cho 3 fields mới có an toàn không?

---

Bước 2: Inspect DOT-063 dot-schema-apply

cat /opt/incomex/dot/bin/dot-schema-apply
/opt/incomex/dot/bin/dot-schema-apply --help 2>&1 || true

Trả lời tương tự: support ADD COLUMN? Hardcode? Clobber risk?

---

Bước 3: Inspect DOT-067 dot-schema-diff

cat /opt/incomex/dot/bin/dot-schema-diff
/opt/incomex/dot/bin/dot-schema-diff --help 2>&1 || true

Trả lời: đây là tool read-only (diff only) hay có mutate?

---

Bước 4: Inspect DOT-068 dot-schema-ensure

cat /opt/incomex/dot/bin/dot-schema-ensure
/opt/incomex/dot/bin/dot-schema-ensure --help 2>&1 || true

Trả lời tương tự.

---

Bước 5: Trả lời 5 câu hỏi

In rõ ràng:

Q1: DOT-074 có add columns vào collection_registry được không?
A1: <yes/no/partial — giải thích>

Q2: DOT-063/067/068 có support arbitrary ADD COLUMN an toàn không?
A2: <yes/no — giải thích từng tool>

Q3: Dùng/extend DOT-074 có thấp rủi ro hơn raw DDL không?
A3: <yes/no — so sánh rủi ro>

Q4: Tool nào có embedded assumption cũ có thể clobber schema/data/function?
A4: <list nếu có, hoặc "none found">

Q5: P1 nên dùng kênh nào?
A5: <recommendation: existing tool / extend tool / raw DDL with approval>
Reasoning: <giải thích>

---

Bước 6: Upload P1a report

Upload lên KB qua Agent Data:

Path: knowledge/dev/laws/dieu44-trien-khai/reports/dot119-repair-p1a-schema-tool-inspection-report.md

Title: DOT-119 Repair — P1a Schema Tool Inspection Report

Tags: ['dot-119', 'repair', 'p1a', 'schema-tools', 'inspection', 'read-only']

Report structure:

# DOT-119 Repair — P1a Schema Tool Inspection Report

> Date: <actual runtime date> | Phase: P1a (read-only)
> Controlling: 18a rev4 + 18b rev3 + P0 report

## §1. DOT-074 Inspection
(source summary, capabilities, hardcoded columns, ADD COLUMN support, clobber risk)

## §2. DOT-063 Inspection
(same structure)

## §3. DOT-067 Inspection
(same structure)

## §4. DOT-068 Inspection
(same structure)

## §5. Answers to 5 Questions
(Q1-Q5 with reasoning)

## §6. Recommendation
(which channel for P1 DDL)

## §7. Clobber/Safety Assessment
(any tool that could damage existing schema/data/functions?)

---

Bước 7: HARD STOP

Sau upload report → DỪNG.

• Không DDL.
• Không UPDATE/INSERT/DELETE.
• Không DOT execution (trừ --help đã chạy ở trên).
• Không script rewrite.
• Không function edit.
• Không IU trigger.
• Không IU rows.
• Không Pack 2B.

Chờ GPT/User review P1a report trước khi soạn P1 DDL prompt.

---

18b-P1a prompt | 2026-05-05 | Opus 4.6 | Schema tool inspection. Read-only. Zero mutation.