clickhouse: commit exit-leg/reconstruction/maras DDLs + UV/violet DDLs (M1 vendor reconcile, upstream-first)

prod/clickhouse/uv/prime_decisions.sql

@@ -0,0 +1,42 @@
+-- PASS4_UV_WIRE.5 — PRIME proceedings journal DDL
+-- ============================================================================
+-- Namespace: dolphin_uv (NOT dolphin.* — that's BLUE's live namespace,
+-- polluting it is FORBIDDEN). Create the table, then journal.py writes into
+-- it via HTTP INSERT JSONEachRow. MergeTree ordered by (scan_number, ts)
+-- so parity diff against dolphin.trade_events is a fast scan-order join.
+-- ============================================================================
+
+CREATE DATABASE IF NOT EXISTS dolphin_uv;
+
+CREATE TABLE IF NOT EXISTS dolphin_uv.prime_decisions
+(
+    -- identity
+    ts               DateTime64(3, 'UTC')    COMMENT 'wall-clock timestamp of the scan',
+    scan_number      UInt32                  COMMENT 'scan number (joins to trade_events)',
+    mono_ns          Int64                   COMMENT 'monotonic ns since epoch for ordering',
+
+    -- inputs (from ScanContext)
+    vel_div          Float64                 COMMENT 'velocity divergence (non-finite -> 0)',
+    posture          LowCardinality(String)  COMMENT 'APEX | TURTLE | HIBERNATE | STALKER | ...',
+    esof_json        String                  COMMENT 'esof_payload as JSON (might be None)',
+    vol_ok           UInt8                   COMMENT 'vol_ok flag (0/1)',
+    trade_direction  Int8                    COMMENT '-1 SHORT / 0 flat / 1 LONG',
+    efsm_pending_slots UInt8                COMMENT 'EFSM pending slot count (>=0)',
+
+    -- 11 hook effects (from HookRunner frame)
+    hooks_json       String                  COMMENT 'HookEffect list: name, ok, note, mutations, elapsed_us',
+
+    -- decision (from step_bar)
+    has_entry        UInt8                   COMMENT '1 = entry generated',
+    asset            LowCardinality(String)  COMMENT 'traded asset symbol',
+    side             LowCardinality(String)  COMMENT 'BUY | SELL | ...',
+    leverage         Float64                 COMMENT 'applied leverage',
+    bar_idx          Int32                   COMMENT 'bar index when entry fired',
+    entry_json       String                  COMMENT 'full entry dict as JSON',
+
+    -- deps status
+    deps_json        String                  COMMENT 'dep status map as JSON'
+)
+ENGINE = MergeTree()
+ORDER BY (scan_number, ts)
+COMMENT 'PRIME proceedings -- parity-diff sink against dolphin.trade_events';