Bundles & Promotions

Bundles are versioned, deployable packages that capture an algo (or policy) along with its research artifacts, risk limits, and lineage. The promotion system enforces a deployment ladder so nothing reaches production without proper evaluation.

Bundle Types

Type	What it contains	CLI command
Edge Algo	WASM binary + risk limits + strategy metadata	`bundle compile-edge`
SOR Policy	Routing model + impact model + slicing config	`bundle compile-sor`
Assignment Policy	Edge vs. SOR routing thresholds	`bundle compile-assignment`

Compile an Edge Algo Bundle

Package a WASM algo with its metadata and risk limits.

bash

sequence bundle compile-edge \
  --wasm target/wasm32-unknown-unknown/release/my_algo.wasm \
  --artifact art_abc123 \
  --strategy mm-pro \
  --risk-version v1

Flag	Default	Description
`--wasm <path>`	required	Path to compiled WASM file
`--artifact <id>`	required	Research artifact ID
`--strategy <name>`	`mm-pro`	Strategy family identifier
`--risk-version <ver>`	`v1`	Risk limits version

Output:

code

Bundle ID:   bun_e4f2a1...
WASM Hash:   sha256:8f3c...
Artifact:    art_abc123
Manifest:    bun_e4f2a1.bundle.json

The CLI auto-registers the bundle with the Central Coordinator. If CC is unreachable, saves the manifest locally as a .bundle.json file.

Compile a SOR Policy Bundle

Package a smart order routing policy.

bash

sequence bundle compile-sor \
  --routing-model art_routing_v3 \
  --impact-model art_impact_v2 \
  --slicing-policy vwap

Flag	Default	Description
`--routing-model <ref>`	required	Routing model artifact reference
`--impact-model <ref>`	required	Market impact model artifact reference
`--slicing-policy <name>`	`vwap`	Order slicing strategy

Compile an Assignment Policy Bundle

Package edge-vs-SOR routing thresholds.

bash

sequence bundle compile-assignment \
  --artifact art_assign_v1 \
  --edge-threshold 1000000000000 \
  --sor-threshold 1000000000000 \
  --min-venues 2

Flag	Default	Description
`--artifact <id>`	required	Artifact ID
`--edge-threshold <1e9>`	`1000000000000`	Edge notional threshold
`--sor-threshold <1e9>`	`1000000000000`	SOR notional threshold
`--min-venues <n>`	`2`	Minimum venues required for SOR

List Bundles

List compiled bundles in the current directory.

bash

sequence bundle list

Output:

code

BUNDLE_ID            STRATEGY    WASM_HASH
bun_e4f2a1...        mm-pro      sha256:8f3c...
bun_b7d3c2...        mm-pro      sha256:a2e1...

Promote a Bundle

Move a bundle through the deployment ladder. Each promotion requires an evaluation run and approver.

bash

sequence bundle promote \
  --bundle bun_e4f2a1 \
  --target edge \
  --stage replay \
  --eval-run eval_run_001 \
  --approver "jane@sequencemkts.com" \
  --notes "Passed replay with Sharpe 2.1"

Flag	Default	Description
`--bundle <id>`	required	Bundle ID to promote
`--target <type>`	required	`edge`, `sor`, or `assignment`
`--stage <stage>`	required	Target stage (see ladder below)
`--eval-run <id>`	required	Evaluation run ID that justifies promotion
`--approver <name>`	required	Who is approving
`--break-glass`	`false`	Emergency bypass - skips ladder enforcement
`--notes <text>`	`""`	Reason / context for the promotion

Promotion Ladder

Bundles must progress through stages in order. Each stage requires a passing evaluation run.

Edge Algos

code

Research → Replay → Shadow → Live → Scaled

SOR & Assignment Policies

code

Research → Replay → Sandbox → Live → Scaled

Warning

You cannot skip stages unless --break-glass is set. Break-glass promotions require non-empty --approver and --notes.

Deploy from a Bundle

Once a bundle is registered, deploy it directly without rebuilding:

bash

sequence deploy BTC-USD --bundle bun_e4f2a1 --start

This skips the WASM build step and uses the pre-compiled, registered bundle.

End-to-End Example

bash

# 1. Build the algo
sequence build
 
# 2. Compile into a bundle
sequence bundle compile-edge \
  --wasm target/wasm32-unknown-unknown/release/my_algo.wasm \
  --artifact art_research_v4
 
# 3. Run a replay evaluation (via backtest)
sequence backtest BTC-USD --start 2026-02-01 --end 2026-02-28 \
  --bundle bun_e4f2a1
 
# 4. Promote through the ladder
sequence bundle promote \
  --bundle bun_e4f2a1 --target edge --stage replay \
  --eval-run eval_001 --approver "you@company.com"
 
sequence bundle promote \
  --bundle bun_e4f2a1 --target edge --stage shadow \
  --eval-run eval_002 --approver "you@company.com"
 
sequence bundle promote \
  --bundle bun_e4f2a1 --target edge --stage live \
  --eval-run eval_003 --approver "you@company.com"
 
# 5. Deploy the promoted bundle
sequence deploy BTC-USD --bundle bun_e4f2a1 --start