lucidchart-upgrade-migration

# Lucidchart Upgrade & Migration ## Overview Lucidchart (Lucid) provides a diagramming and visual collaboration platform with APIs for document management, shape manipulation, and data linking. The API uses version headers and evolves its document schema, shape library definitions, and permission models. Tracking API versions is critical because Lucid's document format changes affect embedded diagram exports, shape coordinate systems shift between API versions, and breaking changes to the data linking API can corrupt live-data diagrams connected to external databases. ## Version Detection ```typescript const LUCID_BASE = "https://api.lucid.co/v1"; async function detectLucidApiVersion(apiKey: string): Promise<void> { const res = await fetch(`${LUCID_BASE}/documents`, { headers: { Authorization: `Bearer ${apiKey}`, "Lucid-Api-Version": "2", "Content-Type": "application/json", }, }); const serverVersion = res.headers.get("x-lucid-api-version") ?? "unknown"; const minSupported = res.headers.get("x-lucid-min-version"); console.log(`Lucid API version: ${serverVersion}, min supported: ${minSupported}`); // Check if current version header is being accepted or forced up const requestedVersion = "2"; if (serverVersion !== requestedVersion) { console.warn(`Requested v${requestedVersion} but server responded with v${serverVersion}`); } const deprecation = res.headers.get("x-lucid-deprecation-notice"); if (deprecation) console.war...