openevidence-upgrade-migration

# OpenEvidence Upgrade & Migration ## Overview OpenEvidence is a clinical AI platform that provides evidence-based medical answers and clinical decision support. The API exposes endpoints for clinical queries, evidence retrieval, and citation management. Tracking API changes is critical because OpenEvidence evolves its evidence grading schema, citation format, and clinical query response structure — and breaking changes in a healthcare context can surface outdated medical evidence, alter confidence scores, or remove critical safety disclaimers that downstream clinical applications depend on. ## Version Detection ```typescript const OPENEVIDENCE_BASE = "https://api.openevidence.com/v1"; async function detectOpenEvidenceVersion(apiKey: string): Promise<void> { const res = await fetch(`${OPENEVIDENCE_BASE}/status`, { headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, }); const version = res.headers.get("x-openevidence-api-version") ?? "v1"; console.log(`OpenEvidence API version: ${version}`); // Test clinical query response schema const queryRes = await fetch(`${OPENEVIDENCE_BASE}/query`, { method: "POST", headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, body: JSON.stringify({ question: "What is the recommended treatment for hypertension?", max_citations: 1 }), }); const data = await queryRes.json(); const hasStructuredCitations = data.citations?.[0]?.evidence_grade !== un...