diff --git a/prod/docs/OMP_TASK__10K_TESTS_EXEC_LIBS.md b/prod/docs/OMP_TASK__10K_TESTS_EXEC_LIBS.md new file mode 100644 index 0000000..0a5f241 --- /dev/null +++ b/prod/docs/OMP_TASK__10K_TESTS_EXEC_LIBS.md @@ -0,0 +1,76 @@ +# 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.