# omp task — 10K test-types for the new exec libs (Flight7UE)

**From:** Fable · **Date:** 2026-07-15 · **Branch:** `tools/pi_wake_agent`

Flight7UE (T1 smart-exec) launched and smoke-passed on MOCK venue. Now it needs a deep test
campaign. Write a **large, comprehensive suite ("10K test-types")** across FOUR dimensions —
**seams, async, typing, bugs** — for every NEW library below.

## THE ONE HARD RULE — read twice

**Every test MUST mock the exchange. NEVER, EVER hit, hammer, poll, or disturb the real
exchange (BingX).** No live venue. No network to a venue. No real API keys. Use
`DITA_V2_VENUE=MOCK` and/or in-process fakes ONLY. A test that reaches a real venue is a
defect worse than no test — it risks the live account AND the running BLUE trader. If you are
unsure whether a code path can touch the venue, stub it at the seam. `venue_mode` is never
`BINGX` in a test.

Corollary: do not touch running processes. BLUE (`nautilus_event_trader.py`, supervised) and
the `dolphin_data:*` services are LIVE. Tests run offline, self-contained, deterministic.

## New libraries to cover (absolute paths)

1. `/mnt/dolphinng5_predict/prod/exec_unified/dialect.py` — BingX venue idiom boundary
   (clientOrderId, dash_symbol, quantize price/size, build_order_payload; PostOnly = timeInForce).
2. `/mnt/dolphinng5_predict/prod/exec_unified/friction.py` — §12 friction telemetry
   (effective-bps, naive-baseline savings, commission-sign flip, side-lane journal that cannot raise).
3. `/mnt/dolphinng5_predict/prod/exec_unified/intent_translator.py` — §7 IntentSpec → dita_v2
   KernelIntent (side inversion on EXIT, size verbatim/no ×leverage, cancel side ignored).
4. `/mnt/dolphinng5_predict/prod/exec_unified/kernel_port.py` — ExecPort over the DITAv2 kernel
   (async pump/submit/cancel, slot_view, exit-size cap).
5. `/mnt/dolphinng5_predict/prod/clean_arch/violet/uv/exec/smart_bridge.py` — T1 SmartExecBridge
   (maker-first entries, MARKET exits, TTL sweep-then-place, fail-soft, friction side-lane).

Supporting exec_unified modules already tested (extend, don't duplicate): `contract.py`,
`router.py`, `working.py`, `drive_loop.py`, `executor.py`, `placer.py`.

## Existing tests — style + baseline (read these first, match the idiom)

- `/mnt/dolphinng5_predict/prod/exec_unified/test_dialect.py`
- `/mnt/dolphinng5_predict/prod/exec_unified/test_friction.py`
- `/mnt/dolphinng5_predict/prod/exec_unified/test_intent_translator.py`
- `/mnt/dolphinng5_predict/prod/exec_unified/test_kernel_port.py`
- `/mnt/dolphinng5_predict/prod/clean_arch/violet/uv/exec/test_smart_bridge.py`

## The four dimensions

- **seams** — boundaries between modules: contract→router→(placer)→kernel_port→translator→
  dialect; smart_bridge→promotion.build_kernel_intent_from_decision→kernel. Assert the data that
  crosses each seam (side, size, order_type, tif, ids) is exactly right. Fake the kernel/venue.
- **async** — `kernel_port` pump/submit/cancel and `process_intent_async` are async: cover
  await ordering, awaitable-vs-sync returns, exceptions mid-await, out-of-order/duplicate venue
  events, latch of last-own-fill. `asyncio.run` per case; no real sleeps/soaks.
- **typing** — money is **Decimal, never float** (catch a float leaking into a price/size);
  V-TYPES are frozen (mutation raises); enums are exhaustive; beartype where the code uses it.
- **bugs** — poison + edges: NaN/inf/negative/zero price & size, dust below step, tick=0,
  side inversion (ENTER vs EXIT), TTL boundary (== vs > ttl), filled-vs-unfilled sweep,
  gate on/off, sink that raises (journal must not), duplicate/after-close, unknown action.

## Litmus (non-negotiable — testing doctrine)

**Mutation test each invariant:** flip a comparison / drop a guard / return a constant — a test
MUST go red. Invariants already proven red (preserve + extend): commission sign
(`fee_cost_from_commission`), side-lane never-raises (`FrictionJournal.record`), EXIT side
inversion (`intent_translator._position_side`), entry-maker policy (`smart_bridge.urgency_for`),
stale-sweep (`smart_bridge._sweep_stale_entry`). No green-by-pollution (restore any
sys.path/env/cwd you touch). Deterministic; seed-pin anything stochastic.

## Run

```
cd /mnt/dolphinng5_predict
/home/dolphin/siloqy_env/bin/python3 -m pytest prod/exec_unified/ -q
/home/dolphin/siloqy_env/bin/python3 -m pytest prod/clean_arch/violet/uv/exec/ -q
```
Current baseline: 143 green in `prod/exec_unified/`, 11 green in `violet/uv/exec/`. Grow it.
Keep everything offline + MOCK. Ping Fable on the bus with questions.