Trade Intents - Charan Signal API

Trade intents are deterministic projections of SignalEvent records. They exist so a bot can consume one stable payload shape before routing into Vertex Quant, NautilusTrader, or an IBKR adapter.

Readiness states

State	Meaning
`ready_for_sizing`	The signal has a known order side and enough contract fields for routing. Quantity is still `null`.
`needs_review`	The signal implies an order, but a required contract field is missing or unknown.
`observe_only`	The source signal is informational, such as `hold`, and should not create an order.

Safety defaults

Every intent is paper-first:

safeguards.mode is paper.
safeguards.submit is always false.
order.totalQuantity is null.
order.transmit is false.
idempotencyKey is stable for the source signal event.

The downstream router must dedupe by idempotencyKey, size the order, apply risk limits, check the kill switch, and require operator or strategy approval before submission.

Action mapping

Signal action	Intent	IBKR order action
`open`	`enter`	`BUY`
`add`	`increase`	`BUY`
`trim`	`reduce`	`SELL`
`close`	`exit`	`SELL`
`hold`	`observe`	none