M3 epic: SDK + examples + tutorial + QA validation#23

Closed

brunota20 wants to merge 74 commits into

nullislabs:mainfrom

bleu:dev/m3-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