Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions content/docs/contracts/context-ingest-recovery-pending.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
{
"availability": "pending",
"apiSourceCommit": "1fff5274fdab922aadbc254b23bfc96b0a2cb4d0",
"evidence": "Exact three-module pure failure formatter source only; no handlers, provider imports, requests or database operations.",
"sourceHashes": {
"lib/context/ContextIngestFailure.ts": "b4688375fb48e89f6558b8ebaa289ebaf70eb9b43957d9d4b19e86909ee9d92e",
"lib/context/classifyContextIngestFailure.ts": "587a66c75056d92fabee996248b90b6f92a758c68e7af1e451cc6db8e9b77e09",
"lib/context/describeContextIngestFailure.ts": "8e89ce4ee28f9770a2f20da5cd7e101735f9d326ae377e7d3b63e88a49123231"
},
"failures": [
{
"code": "unsupported_input",
"text": "unsupported_input: Track ingestion requires a single Spotify track URL. Use ingest_release for an album locator; playlists and artist pages are not track inputs. YouTube ingestion is not enabled."
},
{
"code": "recording_unavailable",
"text": "recording_unavailable: Spotify did not return this track for this request. Check the URL and availability before deciding whether to retry or submit a different track as a new request."
},
{
"code": "provider_outage",
"text": "provider_outage: The Spotify metadata request was interrupted, unavailable or rate limited. Check saved state and wait for recovery before an authorized retry with unchanged input and the same idempotency key."
},
{
"code": "provider_rejected",
"text": "provider_rejected: Spotify rejected the metadata request. Check provider access configuration and saved state before deciding whether to retry with unchanged input and the same idempotency key."
},
{
"code": "provider_response_invalid",
"text": "provider_response_invalid: The Spotify response could not be validated as the requested recording metadata. Review the source and saved state before retrying; do not infer an accepted identity from this failure."
},
{
"code": "identity_conflict",
"text": "identity_conflict: The returned recording or saved identity disagrees with this request. Review the conflict and saved state before retrying; do not substitute a relinked recording or guess artist identity."
},
{
"code": "unknown",
"text": "unknown: The extraction outcome could not be classified. Check saved state and current workspace access before deciding whether to retry. An error does not establish whether a commit completed; do not automatically resubmit with a new key."
}
],
"classificationExamples": [
{
"input": "Context storage operation failed: Recording mismatch",
"code": "identity_conflict"
},
{
"input": "Context storage operation failed: Worker no longer owns request",
"code": "unknown"
},
{
"input": "Access denied to context owner",
"code": "unknown"
},
{
"input": "private Conflicting artist identity suffix",
"code": "unknown"
}
]
}
Loading
Loading