shadowgraph_update_status
Move a decision to a new lifecycle state to record its progress, outcome, or abandonment.
Instructions
Move one decision to another lifecycle state. shadowgraph_supersede replaces a decision, shadowgraph_maintain alone produces stale, shadowgraph_record_outcome records the result. stale and superseded are system-owned and rejected. Setting the current state writes nothing but still commits a revision.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Target state. Legal moves are proposed to planned/in_progress/abandoned/archived; planned to in_progress/abandoned/archived; in_progress to executed/failed/abandoned/archived; executed to validated/failed/reconsidered/archived; validated to reconsidered/archived; failed to reconsidered/abandoned/archived; reconsidered to planned/in_progress/abandoned/archived; stale to reconsidered/archived; abandoned to archived. stale and superseded cannot be set by a caller. | |
| 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. |