shadowgraph_record_outcome
Record how a decision turned out, adjust its confidence by evidence weight, and store lessons. Re-recording replaces the prior outcome, restamps it, and commits a revision.
Instructions
Record how a decision turned out and move its confidence by an evidence-weighted amount. shadowgraph_confidence_evidence records evidence short of an outcome, shadowgraph_update_status changes the lifecycle state. One outcome contribution per decision, so re-recording replaces rather than stacking, restamps it, and commits a revision.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outcome | Yes | The outcome to record. | |
| decisionId | Yes | Identifier of an existing decision, as returned by shadowgraph_record_decision, shadowgraph_search, or shadowgraph_retrieve. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Stable entity identifier. | |
| goal | No | What the decision was trying to achieve. | |
| kind | Yes | Entity kind: decision, attempt, memory, fact, relation, review, or alternative. | |
| actor | No | Who performed the write. | |
| title | No | Short name of the decision. | |
| chosen | No | The option that was chosen. | |
| client | No | Which client performed the write. | |
| status | No | Lifecycle state. Legacy records may carry a value this build does not recognise; shadowgraph_validate reports those. | |
| outcome | No | The recorded outcome, or null until one is recorded. | |
| project | No | Project namespace; records imported from a schema that predates projects may carry null. | |
| evidence | No | Normalised evidence entries: source, type, sourceClass, confidence, observedAt, detail. | |
| createdAt | No | ISO 8601 creation time. | |
| migration | No | Present only on migrated records; records the legacy value a field was mapped from. | |
| sessionId | No | Session identifier recorded with the write. | |
| sourceRaw | No | The original origin label when it differed from sourceClass. Audit only; never evidence. | |
| updatedAt | No | ISO 8601 time of the last change. | |
| confidence | No | Auditable confidence: initial, current (0-1), policy, a history entry per move, and a basis summarising the contributions it was folded from. Legacy records may lack basis. | |
| supersedes | No | Identifiers of decisions this one replaced. | |
| assumptions | No | Assumptions the decision rests on. Searchable content. | |
| reviewAfter | No | ISO 8601 instant after which shadowgraph_maintain marks this decision stale. | |
| sourceClass | No | Claimed origin class recorded with the write. A claim, never proof. | |
| alternatives | No | Rejected alternatives, each with id, label, reasonRejected, status, and the reopenWhen rules that make it reconsiderable. | |
| supersededBy | No | Identifier of the decision that replaced this one. | |
| schemaVersion | No | Storage schema version this entity was written under. A value above the build’s own version is preserved rather than downgraded. | |
| failedAttempts | No | Attempt identifiers or notes attached to this decision. |