Memory · Sidecar records
AI annotation records
Persist source-linked AI findings with model revision, confidence and retention policy.
Workflow
- Request AI findingName the source, intended operation and policy without assuming provider availability.
- Validate identity and contractCheck stable identity, supported operations and policy before any write or restore.
- Perform bounded operationExecute only the declared provider operation and preserve partial, offline and retry state.
- Return unavailableThe workflow returns an explicit unavailable or refused outcome without inventing content or mutating unrelated records.
- Return versioned annotation recordReturn a provider-neutral, source-linked outcome that does not hide partial or unavailable work.
Failure boundaries
- No adapter/record implementationProposal-only/unavailable: Do not simulate success
- Provider offlineUnavailable/retryable: Preserve pending state
- Receipt cannot verifyIncomplete: Do not mark complete
memory.sidecar.ai