juicebox-upgrade-migration

# Juicebox Upgrade & Migration ## Overview Juicebox is an AI-powered people search and analysis platform used for recruiting and market research. The API provides endpoints for dataset management, people searches, and AI-generated analyses. Tracking API versions is essential because Juicebox evolves its search query syntax, dataset schema, and analysis output format — upgrading without testing can break saved search filters, corrupt dataset imports, and change the structure of AI-generated candidate profiles that downstream systems consume. ## Version Detection ```typescript const JUICEBOX_BASE = "https://api.juicebox.work/v1"; async function detectJuiceboxVersion(apiKey: string): Promise<void> { const res = await fetch(`${JUICEBOX_BASE}/datasets`, { headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, }); const version = res.headers.get("x-juicebox-api-version") ?? "v1"; console.log(`Juicebox API version: ${version}`); // Check for deprecated search parameters const searchRes = await fetch(`${JUICEBOX_BASE}/search`, { method: "POST", headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, body: JSON.stringify({ query: "test", limit: 1 }), }); const deprecation = searchRes.headers.get("x-deprecated-params"); if (deprecation) console.warn(`Deprecated search params: ${deprecation}`); } ``` ## Migration Checklist - [ ] Review Juicebox changelog for API breaking changes - [ ] Audi...