Decisions
The decision log is the unit that Overseer exposes for audit. A client asking "why did the Marketing AI pick LinkedIn for that launch?" is answered by retrieving the corresponding decision record — not by re-querying an LLM.
Data wire-up is pending a later sprint. The table below documents what will appear once the REST client lands.
| Field | Type |
|---|---|
decision_id | UUID |
trace_id | Text (Mastra/Langfuse link) |
proposing_agent_id | FK → agents |
proposing_agent_spec_version_id | FK → agent_spec_versions |
decision_type | Text |
required_authority | Single select (none|low|medium|high) |
scope_namespace | Text |
lifecycle_state | Single select (proposal|review|approved|executing|completed|outcome|rejected|suspended_awaiting_clarification) |
proposed_at | Date |
rationale | Long text |
confidence | Number (0..1) |
approver_id | FK → principals (nullable) |
rejection_reason | Long text (nullable) |