54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
docker compose up -d api
|
|
```
|
|
|
|
The new runtime is explicitly opt-in:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
npm run autonomy:init
|
|
```
|
|
|
|
Legacy predictions remain legacy records and are not silently included in
|
|
calibration. New prospective predictions are the trusted learning set.
|