M5 epic: multi-chain deploy + packaging + docs reconciliation#21

Draft

brunota20 wants to merge 129 commits into

nullislabs:mainfrom

bleu:dev/m5-base

Commits on Jun 25, 2026

chore(workspace): hoist [workspace.dependencies] + [workspace.lints]
brunota20
committed
feat(nexum-engine): migrate CLI from hand-rolled parser to clap
brunota20
committed
docs(07-rpc-namespace-design): mark allowlist enforcement as future direction
brunota20
committed
chore(deps): pull cowprotocol, alloy, redb, reqwest, tracing
brunota20
committed
runtime: implement cow-api, chain, local-store host backends
brunota20
committed
runtime: multi-module supervisor + block/log event loop
brunota20
committed
feat(supervisor): apply ADR-0001/0003/0005/0016 and trap-based module death (BLEU-813-817)
brunota20
committed
feat(supervisor): add fuel + memory limits per module store (BLEU-818)
brunota20
committed
docs: rename nexum.toml -> module.toml in example, justfile, and README (BLEU-820)
brunota20
committed
test: fill host backend test gaps — manifest parsing, cow-api, provider-pool, supervisor (BLEU-821)
brunota20
committed
test: E2E supervisor tests + fix wit_import_to_cap to skip type-only interfaces (BLEU-819)
brunota20
committed
style: apply rust-idiomatic rules (em-dashes, #[from] Orderbook, unused_crate_dependencies, drop redundant map_err)
brunota20
committed
review: apply lgahdl feedback on PR #9 (+ rebase PR #8 fixes)
brunota20
committed
refactor(manifest): split into types/load/capabilities/error submodules
brunota20
committed
refactor(main): extract host impls + CLI + event loop + limits
brunota20
committed
refactor: move large #[cfg(test)] modules to sibling files
brunota20
committed
chore(deps): patch cowprotocol to bleu/cow-rs main (post-alpha.3)
brunota20
committed
docs(adr): add 0001-0007 capturing engine and CoW architecture decisions
brunota20
committed
docs(adr): unwrap hard-wrapped paragraphs to single line each
brunota20
committed
docs(adr): revise CoW design and reorder ADRs (0001-0008)
brunota20
committed
fix(docs): reviewed ADRs by bleu
brunota20
committed
fix(docs): revised ADRs and diagrams
brunota20
committed
chore(deps): bump cowprotocol patch to bleu/cow-rs main (BLEU-822 + BLEU-823 in)
brunota20
committed
feat(modules): module.toml for twap-monitor + ethflow-watcher (BLEU-834)
brunota20
committed
review: address jeffersonBastos feedback on PR #54 (BLEU-834 manifests)
brunota20
committed
chore(rust-idiomatic): M2 compliance pass (filtered from M4/M5 compliance)
brunota20
committed
docs(nexum-engine): fix rustdoc intra-doc links after pub(crate) sweep
brunota20
committed
chore(nexum-engine): derive strum::IntoStaticStr on error enums
brunota20
committed
refactor(local-store): extract `local_store_err` map closure helper
brunota20
committed
fix(supervisor): emit nexum.toml deprecation via tracing::warn!
brunota20
committed

Commits on Jun 29, 2026

test(nexum-engine): cover untested error variants and concurrent access (issues 3, 5, 7)
jean-neiverth
committed
Merge pull request #88 from bleu/test/m2-error-variant-coverage
jean-neiverth
authored
feat(twap-monitor): workspace + skeleton (BLEU-825)

brunota20
authored and
jean-neiverth
committed
feat(twap-monitor): index ConditionalOrderCreated → local-store (BLEU-826)

brunota20
authored and
jean-neiverth
committed
feat(twap-monitor): eth_call poll path + PollOutcome decoder (BLEU-827)

brunota20
authored and
jean-neiverth
committed
feat(twap-monitor): build OrderCreation and submit via cow-api (BLEU-828)

brunota20
authored and
jean-neiverth
committed
feat(twap-monitor): wire OrderPostError retry_hint on submit (BLEU-829)

brunota20
authored and
jean-neiverth
committed
feat(twap-monitor): PollOutcome lifecycle dispatch (BLEU-830)

brunota20
authored and
jean-neiverth
committed
feat(ethflow-watcher): workspace + skeleton (BLEU-831)

brunota20
authored and
jean-neiverth
committed
feat(ethflow-watcher): decode CoWSwapEthFlow OrderPlacement (BLEU-832)

brunota20
authored and
jean-neiverth
committed
feat(ethflow-watcher): build OrderCreation, submit, apply retry_hint (BLEU-833)

brunota20
authored and
jean-neiverth
committed
fix(ethflow-watcher): idempotency guard on re-delivered placements

brunota20
authored and
jean-neiverth
committed
feat(shepherd-sdk): workspace + skeleton (BLEU-835)

brunota20
authored and
jean-neiverth
committed
feat(shepherd-sdk): extract shared helpers from M2 modules (BLEU-840)

brunota20
authored and
jean-neiverth
committed
refactor(modules): consume shepherd-sdk helpers (BLEU-843)

brunota20
authored and
jean-neiverth
committed
feat(shepherd-sdk-test): in-memory host mocks for module tests (BLEU-841)

brunota20
authored and
jean-neiverth
committed
docs(shepherd-sdk): rustdoc polish + README + docs/sdk.md (BLEU-844)

brunota20
authored and
jean-neiverth
committed
feat(examples): price-alert Chainlink oracle reader (BLEU-846)

brunota20
authored and
jean-neiverth
committed
feat(examples): balance-tracker example module (BLEU-847)

brunota20
authored and
jean-neiverth
committed
docs(tutorial): first-module walkthrough (BLEU-848)

brunota20
authored and
jean-neiverth
committed
chore: rust-idiomatic compliance pass across M3 + M2 modules

brunota20
authored and
jean-neiverth
committed
refactor(price-alert): port to Host trait + MockHost tests (BLEU-851)

brunota20
authored and
jean-neiverth
committed
feat(examples): stop-loss module + tutorial as guided tour (BLEU-852)

brunota20
authored and
jean-neiverth
committed
refactor(twap-monitor): port to Host trait + MockHost tests (BLEU-854)

brunota20
authored and
jean-neiverth
committed
refactor(ethflow-watcher): port to Host trait + MockHost tests (BLEU-855)

brunota20
authored and
jean-neiverth
committed
chore(qa): workspace cargo fmt sweep + em-dash cleanup (COW-1063)

brunota20
authored and
jean-neiverth
committed
docs(qa): COW-1063 sign-off matrix + architectural findings

brunota20
authored and
jean-neiverth
committed
docs: resolve QA findings - ADR-0009 + doc 05 status callouts

brunota20
authored and
jean-neiverth
committed
ci: build all production module .wasm targets via matrix (COW-1066)

brunota20
authored and
jean-neiverth
committed
ci: gate cargo doc warnings (-D warnings) + fix 3 broken intra-doc links (COW-1069)

brunota20
authored and
jean-neiverth
committed
docs(shepherd-sdk): add 6 doctests covering Host trait + helper API (COW-1067)

brunota20
authored and
jean-neiverth
committed
test(nexum-engine): supervisor integration tests for 5 production modules (COW-1068)

brunota20
authored and
jean-neiverth
committed
docs(m2): testnet runbook + engine.m2.toml + `just run-m2` (validated boot)

brunota20
authored and
jean-neiverth
committed
fix(event_loop): do not bail boot when block / log stream Vec is empty

brunota20
authored and
jean-neiverth
committed
docs(m3): testnet runbook + engine.m3.toml + `just run-m3` (validated 3-module E2E)

brunota20
authored and
jean-neiverth
committed
docs(m3): testnet edge-case validation report - 5 scenarios run, all pass

brunota20
authored and
jean-neiverth
committed
fix(supervisor): mark module alive=false when init returns Err (COW-1070)

brunota20
authored and
jean-neiverth
committed
review: address jeffersonBastos M3 epic feedback (PR #55)

brunota20
authored and
jean-neiverth
committed
chore(rust-idiomatic): M3 compliance pass (filtered from M4/M5 compliance)

brunota20
authored and
jean-neiverth
committed
docs(deployment): operator runbook (BLEU-836) (#17)

brunota20
authored and
jean-neiverth
committed
chore(shepherd-sdk): derive strum::IntoStaticStr + non_exhaustive on host/cow enums

brunota20
authored and
jean-neiverth
committed
chore(twap-monitor): derive strum::IntoStaticStr + non_exhaustive on BuildError

brunota20
authored and
jean-neiverth
committed
fix(balance-tracker): replace Result<_, String> with typed AddressListParseError

brunota20
authored and
jean-neiverth
committed
feat(shepherd-sdk): consolidate AddressParse helper from balance-tracker (audit JC5)

brunota20
authored and
jean-neiverth
committed
feat(sdk): mark HostErrorKind + LogLevel #[non_exhaustive] (COW-1029)

brunota20
authored and
jean-neiverth
committed
test(resource-limits): 2 evil fixtures + 3 trap-isolation tests (COW-1036)

brunota20
authored and
jean-neiverth
committed
feat(logging): JSON formatter + structured dispatch fields (COW-1035)

brunota20
authored and
jean-neiverth
committed
feat(metrics): Prometheus /metrics endpoint + 4 recording sites (COW-1034)

brunota20
authored and
jean-neiverth
committed
feat(supervisor): exponential-backoff restart with component reinstantiation (COW-1033)

brunota20
authored and
jean-neiverth
committed
feat(event-loop): WS reconnect with exponential backoff per stream (COW-1071)

brunota20
authored and
jean-neiverth
committed
feat(supervisor): poison-pill detection + quarantine (COW-1032)

brunota20
authored and
jean-neiverth
committed
feat(event-loop+supervisor): graceful shutdown + last-block persistence (COW-1072)

brunota20
authored and
jean-neiverth
committed
test(supervisor): multi-chain isolation regression tests (COW-1073)

brunota20
authored and
jean-neiverth
committed
feat(ops): E2E testnet integration scaffold (COW-1064)

brunota20
authored and
jean-neiverth
committed
docs(ops): production deployment guide (COW-1030)

brunota20
authored and
jean-neiverth
committed
ops(e2e): pin module configs + run-prep punch list for 2026-06-18 COW-1064 dry run

brunota20
authored and
jean-neiverth
committed
ops(e2e): automation scripts for COW-1064 run (.env-file pattern)

brunota20
authored and
jean-neiverth
committed
fix(scripts): match JSON-shape supervisor-ready log line (COW-1064)

brunota20
authored and
jean-neiverth
committed
fix(scripts): macOS bash 3.2 compatibility (COW-1064)

brunota20
authored and
jean-neiverth
committed
fix(scripts): idempotent on-chain submission + python deps pre-flight (COW-1064)

brunota20
authored and
jean-neiverth
committed
fix(scripts): EthFlow quote uses WETH not native-ETH sentinel (COW-1064)

brunota20
authored and
jean-neiverth
committed
fix(scripts): report-gen handles flat JSON + per-module marker patterns (COW-1064)

brunota20
authored and
jean-neiverth
committed
feat(sdk + twap-monitor): resolve non-empty app_data via orderbook lookup (COW-1074)

brunota20
authored and
jean-neiverth
committed
fix(ethflow-watcher): apply resolve_app_data to submit_placement (COW-1074)

brunota20
authored and
jean-neiverth
committed
ops(e2e): COW-1064 run report 2026-06-18

brunota20
authored and
jean-neiverth
committed
fix(cow-api): forward orderbook ApiError envelope to HostError.data (COW-1075)

brunota20
authored and
jean-neiverth
committed
feat(ethflow-watcher): downgrade ExcessiveValidTo drops to Info (COW-1076)

brunota20
authored and
jean-neiverth
committed
fix(scripts): derive TWAP calldata with t0=now-60 (COW-1077)

brunota20
authored and
jean-neiverth
committed
chore(sdk + twap-monitor): hex helpers via alloy_primitives::hex::encode

brunota20
authored and
jean-neiverth
committed
feat(load-test): Anvil fork + mock orderbook + load-gen (COW-1079)

brunota20
authored and
jean-neiverth
committed
ops(load): baseline 5x5 report - engine clean, load-gen needs calibration (COW-1079)

brunota20
authored and
jean-neiverth
committed
fix(scripts): load-run.sh REPORTS_DIR set after lib.sh source (COW-1079)

brunota20
authored and
jean-neiverth
committed
fix(load-gen): explicit nonce + unique EthFlow sellAmount (COW-1080)

brunota20
authored and
jean-neiverth
committed
ops(load): medium + saturation reports - engine clean at 300 watches (COW-1079)

brunota20
authored and
jean-neiverth
committed
feat(load-gen): --parallel mode + aggressive saturation report (COW-1079)

brunota20
authored and
jean-neiverth
committed
chore(rust-idiomatic): M4 compliance pass (blockers + majors) (#66)

brunota20
authored and
jean-neiverth
committed
fix(shepherd-sdk): add cow_api_request to chainlink StubHost + appData doc link

brunota20
authored and
jean-neiverth
committed
refactor(sdk): replace [u8; 32] with B256 across resolve_app_data surface

brunota20
authored and
jean-neiverth
committed
refactor(cow-orderbook): extract DEFAULT_CHAINS const

brunota20
authored and
jean-neiverth
committed
chore(engine.e2e.toml): replace em-dash with ASCII hyphen

brunota20
authored and
jean-neiverth
committed
feat(ops): baseline tool — EthFlow indexer creationDate semantics (COW-1084)

brunota20
authored and
jean-neiverth
committed
feat(engine): forward eth_call ErrorResp.data into HostError.data (COW-1082)

brunota20
authored and
jean-neiverth
committed
feat(ethflow-watcher): cap backoff: retries at MAX_BACKOFF_RETRIES (COW-1083)

brunota20
authored and
jean-neiverth
committed
feat(backtest): pre-soak EthFlow replay harness (COW-1078)

brunota20
authored and
jean-neiverth
committed
feat(deploy): Dockerfile + compose + ghcr CI for M5 deployment

brunota20
authored and
jean-neiverth
committed
chore(deploy): gitignore /engine.toml to protect operator RPC keys

brunota20
authored and
jean-neiverth
committed
feat(engine): fail-fast on HTTP rpc_url + redact API keys in boot logs

brunota20
authored and
jean-neiverth
committed
feat(engine): ${VAR} env-var substitution in engine.toml for RPC URLs

brunota20
authored and
jean-neiverth
committed
fix(deploy): healthcheck uses bash /dev/tcp (wget not in runtime image)

brunota20
authored and
jean-neiverth
committed
fix(deploy): healthcheck must invoke bash explicitly (CMD-SHELL is dash)

brunota20
authored and
jean-neiverth
committed
deploy: ethflow-watcher observe + verify redesign rebased onto M5

brunota20
authored and
jean-neiverth
committed
fix(twap-monitor): skip submit_order when submitted:{uid} already in store (COW-1085)

brunota20
authored and
jean-neiverth
committed
feat(event-loop): log block stream gap closures from alloy-internal reconnects (COW-1086)

brunota20
authored and
jean-neiverth
committed
chore(rust-idiomatic): M5 compliance pass (cherry-pick M4 + M5 deploy fixes) (#67)

brunota20
authored and
jean-neiverth
committed
chore(docs): reconcile vapor + capability-gating drift across M2-M5 (#68)

brunota20
authored and
jean-neiverth
committed
fix(ethflow-watcher): drop bogus wildcard arm from observe_placement

brunota20
authored and
jean-neiverth
committed
chore(nexum-engine): derive strum::IntoStaticStr on EnvVarError + FilterError

brunota20
authored and
jean-neiverth
committed
chore(engine.*.toml): replace em-dashes with ASCII hyphens

brunota20
authored and
jean-neiverth
committed
refactor(shepherd-backtest): consume shepherd_sdk::address::AddressParse (audit JC5)

brunota20
authored and
jean-neiverth
committed