Tier 17.1: F3.2 sub-tier 1 — fact_option_executions columns (3 cols)

[jamezycesar-collab]

Summary

First sub-tier of WS2 F3.2 follow-on. Adds 3 spec-mapping columns to fact_option_executions across all four dialects.

Files changed

• ddl/option/02_option_gold_delta.sql - add 3 columns
• ddl/option/04_option_gold_hive.sql - add 3 columns
• ddl/option/05_option_silver_fabric_lakehouse.sql - add 3 columns
• ddl/option/06_option_fabric_warehouse.sql - add 3 columns
• ddl/gold/06_cat_field_mapping.csv - 2 section-ref corrections
• guardrails/known_field_mapping_gaps.csv - 92 → 89 rows
• CHANGELOG.md - Tier 17.1 entry + cleanup of leftover merge-conflict markers

Columns added

Gold column	Type	Spec section (PDF-verified)	Event
trade_key_date	TIMESTAMP / DATETIME2(7)	§5.1.11 row 6	MOOT
fill_key_date	TIMESTAMP / DATETIME2(7)	§5.1.12.1 row 6	MOOF/MOOFS
prior_fill_key_date	TIMESTAMP / DATETIME2(7)	§5.1.12.3 row 9	MOFA

Mapping CSV corrections

PDF verification (via verify_cat_im_v3.py against the CAT IM v4.1.0r15 spec PDF) confirmed two pre-existing section-ref errors:

Column	Was	Now (PDF-verified)
fact_option_executions.fill_key_date	§5.1.13.1	§5.1.12.1 (Option Order Fulfillment Event)
fact_option_executions.prior_fill_key_date	§5.1.14	§5.1.12.3 (Option Order Fulfillment Amendment Event)

CHANGELOG cleanup

PR #18 (Tier 16) merged with leftover stash-pop merge-conflict markers (<<<<<<< / ======= / >>>>>>>) in CHANGELOG.md. This sub-tier removes them. Both pre-conflict sections (Tier 15 banner from PR #17 + Tier 16 entry from PR #18) are preserved as legitimate history.

Coverage

All 8 guardrails:                  pass (exit 0)
known_field_mapping_gaps.csv:    89 (was 92; -3)
  F3.1 phantom-table rows:        0 (unchanged - cleared in Tier 13-16)
  F3.2 missing-column rows:      89 (was 92)
DDL files in parity scope:        22 (unchanged)
Tables in 2+ dialects:            42 (unchanged - same tables, new columns)
New parity violations:             0

F3.2 burndown progress

Sub-tier	Host table	Cols	Allowlist	Status
Tier 17.1 (this)	fact_option_executions	3	92 → 89	✅
Tier 17.2	fact_option_allocations	3	89 → 86	next
Tier 17.3	fact_multileg_option_legs	5	86 → 81	queued
Tier 17.4	fact_option_order_events	30	81 → 51	queued
Tier 17.5	fact_multileg_option_events	51	51 → 0	queued

Test plan

• All 8 guardrails pass (exit 0)
• No new parity violations
• 3 fact_option_executions mapping rows now resolve in DDL
• 2 mapping CSV section refs PDF-verified and corrected
• CHANGELOG.md merge-conflict markers removed
• Recurrence-safe precheck in push script