{"$id":"https://cumulativewebinc.github.io/cwi-sonic-search/results.schema.json","$schema":"https://json-schema.org/draft/2020-12/schema","description":"Machine-readable output of a Sonic Search query (cwi.sonic-result/1.0). Every scored result carries its score breakdown and a reason string citing actual measured values. Tracks without audio features carry match_label 'no audio features on file — tag match only' and score numeric criteria as null (never estimated).","properties":{"app":{"const":"Sonic Search"},"clearance":{"description":"Sync clearance contact line","type":"string"},"coverage":{"properties":{"source":{"description":"Audio feature provenance","type":"string"},"total":{"description":"Total tracks in the searchable catalog (currently 35)","type":"integer"},"with_audio_features":{"description":"Tracks carrying measured audio features (currently 6)","type":"integer"}},"required":["with_audio_features","total","source"],"type":"object"},"deep_link":{"description":"Shareable ?q= deep link reproducing this result set","type":"string"},"honest_limits":{"description":"Verbatim honest-limits wording; must be surfaced wherever results are shown","type":"string"},"parsed":{"description":"Structured intent extracted from the query","properties":{"artists":{"description":"Artist lanes requested","items":{"type":"string"},"type":"array"},"danceability":{"properties":{"label":{"type":"string"},"min":{"type":"number"}},"type":["object","null"]},"energy":{"properties":{"label":{"type":"string"},"max":{"type":"number"},"min":{"type":"number"}},"type":["object","null"]},"key":{"properties":{"name":{"type":"string"},"pitchClass":{"maximum":11,"minimum":0,"type":"integer"}},"type":["object","null"]},"mode":{"enum":["minor","major",null],"type":["string","null"]},"moods":{"description":"Editorial mood tags requested","items":{"type":"string"},"type":"array"},"tempo":{"properties":{"label":{"type":"string"},"max":{"type":"number"},"min":{"type":"number"}},"type":["object","null"]},"valence":{"properties":{"label":{"type":"string"},"max":{"type":"number"},"min":{"type":"number"}},"type":["object","null"]}},"type":"object"},"query":{"description":"Raw natural-language query as submitted","type":"string"},"result_count":{"type":"integer"},"results":{"items":{"properties":{"artist":{"type":"string"},"audio_features":{"description":"Measured values; null means absent, never estimated","properties":{"acousticness":{"type":"number"},"danceability":{"type":"number"},"energy":{"type":"number"},"fetched":{"type":"string"},"instrumentalness":{"type":"number"},"key":{"type":"integer"},"key_pitch_class":{"type":"string"},"liveness":{"type":"number"},"loudness_db":{"type":"number"},"mode":{"type":"string"},"source":{"type":"string"},"speechiness":{"type":"number"},"tempo_bpm":{"type":"number"},"valence":{"type":"number"}},"type":["object","null"]},"audio_features_present":{"type":"boolean"},"breakdown":{"description":"Per-criterion transparent scoring. score=null means the criterion could not be evaluated (no data) — its weight is excluded.","items":{"properties":{"criterion":{"enum":["tempo","energy","danceability","valence","mode","key","mood","lane"],"type":"string"},"note":{"description":"Human-readable clause citing actual values","type":"string"},"score":{"maximum":1,"minimum":0,"type":["number","null"]},"weight":{"type":"number"}},"required":["criterion","weight","score","note"],"type":"object"},"type":"array"},"match_label":{"description":"'audio + tag match' or 'no audio features on file — tag match only'","type":"string"},"mood_tags":{"description":"EDITORIAL tags, title-derived only","items":{"type":"string"},"type":"array"},"rank":{"minimum":1,"type":"integer"},"reason":{"description":"Why this track ranked where it did, in plain language with real values","type":"string"},"score":{"maximum":100,"minimum":0,"type":"number"},"spotify_id":{"type":["string","null"]},"spotify_url":{"type":["string","null"]},"track":{"type":"string"},"track_id":{"type":"string"}},"required":["rank","track","artist","track_id","spotify_id","spotify_url","score","audio_features_present","match_label","mood_tags","audio_features","breakdown","reason"],"type":"object"},"type":"array"},"schema":{"const":"cwi.sonic-result/1.0"}},"required":["schema","app","query","deep_link","parsed","coverage","honest_limits","clearance","results","result_count"],"title":"CWI Sonic Search result payload","type":"object"}