Duriin-API/docs/autonomy.md

Duriin autonomy runtime

The autonomy runtime is additive to the existing archive and intelligence tables. It is deliberately disabled until the paper-trading cutover is approved.

Services

• api: HTTP only; no background scheduler when DURIIN_RUN_SCHEDULER=false.
• autonomy: bounded archive reconciliation and live/historical job creation.
• coordinator: LLM proposal extraction only. It cannot create an order.
• autonomy-outcomes: resolves matured predictions against market and benchmark returns.
• calibration: creates empirical calibration snapshots and deterministic decisions.
• intelligence: legacy worker, available only under the legacy Compose profile.

Start only the API by default:

docker compose up -d api

The new runtime is explicitly opt-in:

docker compose --profile autonomy up -d autonomy coordinator autonomy-outcomes calibration

Authority rules

The coordinator may return categorical, evidence-backed proposals. It may not return probabilities, returns, position sizes or trade actions. Proposals must reference existing archive article IDs and instruments in autonomy_instruments with active=1 and tradable=1.

Calibration is computed from resolved market-relative outcomes. The policy engine emits BUY, SELL, HOLD or ABSTAIN; an LLM is not in this path.

Paper order intents use deterministic client IDs and are bounded by the execution validator. A broker adapter must be explicitly configured; the included simulator is the default test adapter.

Database initialization

The autonomy schema is initialized additively by the autonomy workers and maintenance scripts in the intelligence database. To create the initial reconciliation job without starting workers:

npm run autonomy:init

Legacy predictions remain legacy records and are not silently included in calibration. New prospective predictions are the trusted learning set.