shadowgraph_confidence_evidence
Apply one piece of supporting or contradicting evidence to a decision's confidence. A stable key prevents double-counting; reuse restamps the decision, while new observations require new keys.
Instructions
Apply one keyed piece of supporting or contradicting evidence to a decision's confidence. Use shadowgraph_record_outcome once the decision has played out, shadowgraph_record_fact for an observation that can reopen it. Reusing key cannot double-count, but restamps the decision and commits a revision; a new observation needs a new key.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | REQUIRED stable dedupe key. Reuse the same key for the same observation so retries cannot double-count; use a NEW key for a genuinely new observation. There is no default, because a generated one would only be stable within a millisecond. | |
| actor | No | Who performed this write, such as an agent or person name. Stored for audit; never used to grant trust. | |
| client | No | Which client software performed this write, such as the host application name. | |
| reason | Yes | Why this evidence matters. Required, non-empty, and kept in the audit history. | |
| supports | No | Defaults to true. false records contradicting evidence, moving confidence down instead of up. | |
| sessionId | No | Caller-owned identifier that groups related writes in the audit trail. | |
| decisionId | Yes | Identifier of an existing decision, as returned by shadowgraph_record_decision, shadowgraph_search, or shadowgraph_retrieve. | |
| observedAt | No | ISO 8601 time the evidence was observed. Defaults to now. | |
| sourceClass | No | Claimed origin, never proof: agent_claimed (the default), tool_observed, human_confirmed, or production_verified. It weights confidence only. An unrecognised label downgrades to agent_claimed, kept verbatim in sourceRaw. |
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. |