log_decision
Append a suggested investment decision to a local ledger, recording the alternative considered for later measurement of decision quality.
Instructions
Append a suggested decision to the local decision ledger (data/private, git-ignored). Records what was decided and the shadow alternative so it can be measured later.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | No | ||
| score | No | ||
| theme | No | personal_edge grouping fallback used only when category is not set | |
| action | Yes | BUY|BUY_SMALL|HOLD|WATCH|REDUCE|SELL|NO_BUY | |
| reason | Yes | ||
| symbol | Yes | ||
| cap_eur | No | Per-position EUR cap this amount was checked against, for decision_quality's amount_within_cap criterion | |
| sources | No | ||
| category | No | Free-form grouping used by personal_edge, e.g. a sector or strategy | |
| red_team | No | ||
| amount_eur | No | ||
| candidates | No | The full ranking shown at decision time (e.g. capital_auction's 'candidates_for_ledger'): [{'symbol','kind','utility','price','price_symbol'}, ...]. Stored so portfolio.opportunity can later measure regret against every option that was on the table, not just the single recorded 'alternative'. | |
| confidence | No | ||
| alternative | No | what you would buy instead | |
| decision_kind | No | 'bucket' for a bucket/index fill (no red team, no alternative, no per-stock cap by design -- decision_quality scores it on the criteria that actually apply); omit for an ordinary single-stock decision | |
| thesis_status | No | STABLE|STRENGTHENING|WEAKENING|BROKEN|UNVERIFIABLE if check_thesis was run at decision time; feeds decision_quality's thesis_status criterion | |
| alternative_price | No |