fluncle 0.185.0 → 0.187.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.185.0".trim() ? "0.185.0".trim() : "0.1.0";
+  currentVersion = "0.187.0".trim() ? "0.187.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -965,7 +965,7 @@ async function fetchRecentPage(cursor, limit = 10) {
   if (cursor) {
     params.set("cursor", cursor);
   }
-  const response = await publicApiGet(`/api/tracks?${params.toString()}`);
+  const response = await publicApiGet(`/api/v1/findings?${params.toString()}`);
   return {
     nextCursor: response.nextCursor,
     totalCount: response.totalCount,
@@ -980,7 +980,7 @@ async function recentCommand(limit) {
     if (cursor) {
       params.set("cursor", cursor);
     }
-    const response = await publicApiGet(`/api/tracks?${params.toString()}`);
+    const response = await publicApiGet(`/api/v1/findings?${params.toString()}`);
     for (const apiTrack of response.tracks) {
       results.push(mapTrack(apiTrack));
       if (results.length >= limit) {
@@ -1287,7 +1287,7 @@ async function galaxyGetCommand(slug) {
   return { findings: response.findings, galaxy: response.galaxy };
 }
 async function galaxyMapReadCommand() {
-  const response = await adminApiGet("/api/admin/galaxies");
+  const response = await adminApiGet("/api/v1/admin/galaxies");
   return response.galaxies;
 }
 async function galaxyEmbeddingsCommand(options) {
@@ -1299,10 +1299,10 @@ async function galaxyEmbeddingsCommand(options) {
     params.set("limit", options.limit);
   }
   const query = params.toString();
-  return adminApiGet(`/api/admin/tracks/embeddings${query ? `?${query}` : ""}`);
+  return adminApiGet(`/api/v1/admin/tracks/embeddings${query ? `?${query}` : ""}`);
 }
 async function galaxyMapWriteCommand(clusters) {
-  const response = await adminApiPut("/api/admin/galaxies/map", {
+  const response = await adminApiPut("/api/v1/admin/galaxies/map", {
     clusters
   });
   return response.galaxies;
@@ -1313,7 +1313,7 @@ var init_galaxies = __esm(() => {
 
 // src/commands/mixtape-api.ts
 async function mixtapeListCommand() {
-  const response = await adminApiGet("/api/admin/mixtapes");
+  const response = await adminApiGet("/api/v1/admin/mixtapes");
   return response.mixtapes;
 }
 async function mixtapeGetCommand(idOrLogId) {
@@ -1380,20 +1380,20 @@ async function distributeYoutube(mixtapeId, videoPath, onProgress) {
     offset = 0;
   }
   onProgress?.("Recording the YouTube link");
-  await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/finalize`, { videoId });
+  await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/finalize`, { videoId });
   return { url: `https://youtu.be/${videoId}`, videoId };
 }
 async function publishYoutubeCommand(idOrLogId) {
   const mixtapeId = await resolveMixtapeId(idOrLogId);
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/publish`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/publish`);
   return { url: response.url };
 }
 async function resyncYoutube(mixtapeId) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/resync`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/resync`);
   return { url: response.url, videoId: response.videoId };
 }
 async function authYoutubeCommand() {
-  const response = await adminApiGet("/api/admin/youtube/auth/start");
+  const response = await adminApiGet("/api/v1/admin/youtube/auth/start");
   console.log(`Open this YouTube authorization URL:
 
 ${response.authUrl}
@@ -1401,11 +1401,11 @@ ${response.authUrl}
 After approving access, Google returns to the Fluncle admin callback and stores the refresh token server-side.`);
 }
 async function initiate(mixtapeId, contentLength, contentType) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/initiate`, { contentLength, contentType });
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/initiate`, { contentLength, contentType });
   return { accessToken: response.accessToken, sessionUri: response.sessionUri };
 }
 async function mintToken() {
-  const response = await adminApiPost("/api/admin/youtube/token");
+  const response = await adminApiPost("/api/v1/admin/youtube/token");
   return response.accessToken;
 }
 async function putChunk(args) {
@@ -1465,7 +1465,7 @@ function nextOffset(rangeHeader, fallback) {
   return Number(match[1]) + 1;
 }
 async function resolveMixtapeId(idOrLogId) {
-  const response = await adminApiGet("/api/admin/mixtapes");
+  const response = await adminApiGet("/api/v1/admin/mixtapes");
   const match = response.mixtapes.find((mixtape) => mixtape.id === idOrLogId || mixtape.logId === idOrLogId);
   if (!match?.id) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or Log ID ${idOrLogId}`);
@@ -1553,18 +1553,18 @@ async function distributeMixcloud(mixtapeId, audioPath, onProgress, unlisted = f
   const externalId = result.key;
   const url = `https://www.mixcloud.com${result.key}`;
   onProgress?.("Mixcloud: recording the link…");
-  await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/finalize`, {
+  await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/finalize`, {
     externalId,
     url
   });
   return { url };
 }
 async function resyncMixcloud(mixtapeId) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
   return { url: response.url };
 }
 async function authMixcloudCommand() {
-  const response = await adminApiGet("/api/admin/mixcloud/auth/start");
+  const response = await adminApiGet("/api/v1/admin/mixcloud/auth/start");
   console.log(`Open this Mixcloud authorization URL:
 
 ${response.authUrl}
@@ -1591,7 +1591,7 @@ function mixtapeTags(_mixtape) {
 }
 async function fetchMixcloudToken() {
   try {
-    const response = await adminApiPost("/api/admin/mixcloud/token");
+    const response = await adminApiPost("/api/v1/admin/mixcloud/token");
     return response.accessToken;
   } catch {
     throw new CliError2("mixcloud_not_connected", "Mixcloud is not connected. Run `fluncle admin auth mixcloud` to authorize it.");
@@ -1648,11 +1648,11 @@ __export(exports_mixtapes, {
   mixtapeDistributeCommand: () => mixtapeDistributeCommand
 });
 async function mixtapesCommand() {
-  const response = await publicApiGet("/api/mixtapes");
+  const response = await publicApiGet("/api/v1/mixtapes");
   return response.mixtapes;
 }
 async function mixtapeUpdateCommand(id, options) {
-  return adminApiPatch(`/api/admin/mixtapes/${encodeURIComponent(id)}`, buildBody(options));
+  return adminApiPatch(`/api/v1/admin/mixtapes/${encodeURIComponent(id)}`, buildBody(options));
 }
 async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {}) {
   const mixtape = await mixtapeGetCommand(idOrLogId);
@@ -1723,7 +1723,7 @@ async function mixtapeResyncCommand(idOrLogId, options, onProgress = () => {}) {
   let doYoutube = Boolean(options.youtube);
   let doMixcloud = Boolean(options.mixcloud);
   if (!explicit) {
-    const social = await adminApiGet(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/social`);
+    const social = await adminApiGet(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/social`);
     const platforms = new Set(social.posts.map((post) => post.platform));
     doYoutube = platforms.has("youtube");
     doMixcloud = platforms.has("mixcloud");
@@ -1942,7 +1942,7 @@ async function recentCommand2(limit) {
     if (cursor) {
       params.set("cursor", cursor);
     }
-    const response = await publicApiGet(`/api/tracks?${params.toString()}`);
+    const response = await publicApiGet(`/api/v1/findings?${params.toString()}`);
     for (const apiTrack of response.tracks) {
       results.push(mapTrack2(apiTrack));
       if (results.length >= limit) {
@@ -2031,7 +2031,7 @@ __export(exports_random, {
   randomCommand: () => randomCommand
 });
 async function randomCommand() {
-  const response = await publicApiGet("/api/tracks/random");
+  const response = await publicApiGet("/api/v1/tracks/random");
   return response.track;
 }
 var init_random = __esm(() => {
@@ -2048,7 +2048,7 @@ async function subscribeCommand(email, json) {
   if (!address) {
     throw new CliError2("invalid_email", "Enter a valid email address.");
   }
-  await publicApiPost("/api/newsletter", {
+  await publicApiPost("/api/v1/newsletter", {
     email: address
   });
   if (json) {
@@ -2076,7 +2076,7 @@ async function submitCommand(input) {
   if (!query) {
     throw new CliError2("missing_query", "Missing search input");
   }
-  const response = await publicApiGet(`/api/search?q=${encodeURIComponent(query)}`);
+  const response = await publicApiGet(`/api/v1/search?q=${encodeURIComponent(query)}`);
   if (response.results.length === 0) {
     throw new CliError2("no_results", "No Spotify tracks found.");
   }
@@ -2086,7 +2086,7 @@ async function submitCommand(input) {
   }
   const note = await promptLine("Note (optional): ", PROMPT_NON_INTERACTIVE_MESSAGE2);
   const contact = await promptLine("Contact (optional): ", PROMPT_NON_INTERACTIVE_MESSAGE2);
-  await publicApiPost("/api/submissions", {
+  await publicApiPost("/api/v1/submissions", {
     album: selected.album,
     artists: selected.artists,
     artworkUrl: selected.artworkUrl,
@@ -2229,7 +2229,7 @@ async function pollForToken(baseUrl, device) {
   throw new CliError2("expired_token", "The login request timed out. Run `fluncle login` again.");
 }
 async function fetchSessionUser(baseUrl, token) {
-  const response = await fetch(`${baseUrl}/api/me`, {
+  const response = await fetch(`${baseUrl}/api/v1/me`, {
     headers: { Authorization: `Bearer ${token}` }
   });
   if (!response.ok) {
@@ -2264,8 +2264,8 @@ __export(exports_me, {
 });
 async function meCommand() {
   const [me, progress] = await Promise.all([
-    userApiGet("/api/me"),
-    userApiGet("/api/me/galaxy-progress")
+    userApiGet("/api/v1/me"),
+    userApiGet("/api/v1/me/galaxy-progress")
   ]);
   if (!me.user) {
     throw new Error("Your sign-in expired. Run `fluncle login` to link this device again.");
@@ -2442,7 +2442,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.185.0".trim() ? "0.185.0".trim() : "0.1.0";
+  currentVersion2 = "0.187.0".trim() ? "0.187.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2761,7 +2761,22 @@ var init_src = __esm(() => {
     {
       apiFormat: "application/json",
       discoveryUrl: `${SITE}/api/v1/openapi.json`,
-      exposedContent: ["the archive as JSON, cursor-paginated (limit max 48, cursor)"],
+      exposedContent: [
+        "the feed as JSON — findings and published mixtapes, newest found first, cursor-paginated (limit max 48, cursor)"
+      ],
+      kind: "api",
+      name: "api.findings",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/api/v1/findings",
+      url: `${SITE}/api/v1/findings`,
+      weights: { status: "secondary", web: "primary" }
+    },
+    {
+      apiFormat: "application/json",
+      discoveryUrl: `${SITE}/api/v1/openapi.json`,
+      exposedContent: [
+        "every track Fluncle holds as JSON, newest release first, numbered pages (page); certified=true narrows to findings, certified=false to the rest, omitted returns both"
+      ],
       kind: "api",
       name: "api.tracks",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
@@ -2940,8 +2955,8 @@ var init_src = __esm(() => {
       name: "api.health",
       operatorNotes: "Linked as the `status` relation from /.well-known/api-catalog. Service `web` on /status.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
-      route: "/api/health",
-      url: `${SITE}/api/health`,
+      route: "/api/v1/health",
+      url: `${SITE}/api/v1/health`,
       weights: { status: "tertiary", web: "tertiary" }
     },
     {
@@ -3144,7 +3159,7 @@ var init_src = __esm(() => {
       apiFormat: "application/json",
       discoveryUrl: `${SITE}/.well-known/mcp/server-card.json`,
       exposedContent: [
-        "the archive as MCP tools (Streamable HTTP, no auth): list_tracks, list_fresh, get_track, get_random_track, get_status, search_archive, get_artist, get_label, build_set, get_similar_artists, list_album_catalogue, list_artist_catalogue, list_label_catalogue, search_tracks, submit_track, subscribe_newsletter",
+        "the archive as MCP tools (Streamable HTTP, no auth): list_findings, list_tracks, list_fresh, get_track, get_random_track, get_status, search_archive, get_artist, get_label, build_set, list_similar_artists, list_album_catalogue, list_artist_catalogue, list_label_catalogue, search_tracks, submit_track, subscribe_newsletter",
         "the archive as MCP resources: each finding/mixtape at fluncle://finding/<logId> or fluncle://mixtape/<logId> (its public record)",
         "Fluncle-voiced MCP prompts: recommend_finding, walk_recent_night, decode_coordinate"
       ],
@@ -3457,6 +3472,19 @@ var init_src = __esm(() => {
       title: "Artist edges",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills artist-credits",
+      exposedContent: [
+        "mint identity-true artists from MusicBrainz credits for slice 0's zero-matched residual → track_artists edges"
+      ],
+      kind: "cron",
+      name: "cron.artist-credits",
+      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/artist-credits-timer/). The MB CREDIT SWEEP (RFC artist-primary-capture, slice 1b): the sibling that completes what `backfill_artist_edges` (slice 0) could not. Slice 0's name-fold left a ~14.3k ZERO-MATCHED residual (a track it stamped but wrote no edge — no credited name folded to an existing identity), and those are exactly the tracks capture-authorization (slice 1) cannot reason about, since it matches BY IDENTITY through the `track_artists` graph. This sweep picks up that residual: for each zero-matched track carrying a MusicBrainz recording identity (`mb_recording_id`, or the `mb_<recording-mbid>` PK a crawler-born row carries), ONE paced `/recording/<mbid>?inc=artist-credits` lookup through the shared MusicBrainz client names its credited artists WITH their MB artist ids, and each resolves down a three-rung ladder: an EXACT `mbid` match, else an ADOPT (the credit name folds unambiguously onto an existing artist with no mbid — the common case, since the residual is dominated by compound credit strings like 'Sub Focus & Dimension' whose members Fluncle already holds as Spotify-keyed rows; adopting `coalesce`s the mbid onto that row instead of minting a duplicate, the split-identity guard), else a MINT of a fresh identity-true row (`mintArtistByMbid` — a real MBID is identity, the licence slice 0 lacked). Fail-closed on any ambiguity (a shared fold, or a fold whose row carries a different mbid) → mint, never a wrong merge. Then the `track_artists` edges are written. A zero-matched track with NO MB identity is TERMINALLY SKIPPED (stamped, never retried). METADATA / GRAPH IDENTITY ONLY — it certifies nothing and publishes nothing (agent tier, the `backfill_recording_mbids` precedent). Worker-paced (the box holds no MusicBrainz budget): a SMALL bounded batch per tick (each row is one ~1.1s MB call), 1 req/s, circuit-broken on a throttle, with a 60s response budget that pauses mid-page and resumes on the next request. The `tracks` row carries the durable per-row reliability state — its OWN `artist_credits_backfilled_at` stamp, DISTINCT from slice 0's `artist_edges_backfilled_at` (never disturbed). The ~14.3k residual drains at ~40/tick over ~a day and a half. Zero LLM tokens. Source: docs/agents/hermes/scripts/artist-credits-sweep.*. See docs/artist-relationship.md.",
+      probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-artist-credits", kind: "cron" },
+      statusDescription: "mints artists from MusicBrainz credits for the residual",
+      title: "Artist credits",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin backfills label-lineage",
       exposedContent: [
@@ -3883,7 +3911,7 @@ __export(exports_status, {
   statusCommand: () => statusCommand
 });
 async function statusCommand() {
-  return publicApiGet("/api/status");
+  return publicApiGet("/api/v1/status");
 }
 function ago(seconds) {
   if (seconds < 60) {
@@ -3967,14 +3995,14 @@ __export(exports_track, {
   checkBundleCompleteness: () => checkBundleCompleteness
 });
 async function trackGetCommand(idOrLogId) {
-  return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
+  return publicApiGet(`/api/v1/tracks/${encodeURIComponent(idOrLogId)}`);
 }
 async function trackSimilarCommand(idOrLogId, limit) {
   const query = limit === undefined ? "" : `?limit=${encodeURIComponent(String(limit))}`;
-  return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}/similar${query}`);
+  return publicApiGet(`/api/v1/tracks/${encodeURIComponent(idOrLogId)}/similar${query}`);
 }
 async function trackGetAdminCommand(idOrLogId) {
-  return adminApiGet(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}`);
+  return adminApiGet(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}`);
 }
 function isPlatesOnlyUpload(files) {
   const hasPlate = PLATE_FIELDS.some((option) => Boolean(files[option]));
@@ -4021,7 +4049,7 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
     throw new CliError2("nothing_to_upload", "No bundle files resolved to upload (pass --dir <bundle> or explicit file flags).");
   }
   const platesOnly = isPlatesOnlyUpload(files);
-  const presign = await adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/uploads`, { fields: present.map((spec) => spec.field) });
+  const presign = await adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/video/uploads`, { fields: present.map((spec) => spec.field) });
   const byField = new Map(presign.uploads.map((upload) => [upload.field, upload]));
   const urls = {};
   const STREAM_THRESHOLD_BYTES = 8 * 1024 * 1024;
@@ -4052,7 +4080,7 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
   const videoModel = files.model?.trim().slice(0, 120) || manifest.model || DEFAULT_VIDEO_MODEL;
   const videoModelReasoning = files.reasoning?.trim().slice(0, 120) || manifest.reasoning || DEFAULT_VIDEO_REASONING;
   const squared = Boolean(urls["footage"] && urls["footage-social"]);
-  const finalize = await adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/finalize`, {
+  const finalize = await adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/video/finalize`, {
     videoModel,
     videoModelReasoning,
     ...squared ? { squared: true } : {},
@@ -4083,7 +4111,7 @@ async function readManifestFields(renderPath) {
   return result;
 }
 async function trackDraftCommand(idOrLogId, platform2) {
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/social/${platform2}/draft`);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/social/${platform2}/draft`);
 }
 async function trackSocialUpdateCommand(idOrLogId, platform2, options) {
   const body = { status: options.status };
@@ -4093,14 +4121,14 @@ async function trackSocialUpdateCommand(idOrLogId, platform2, options) {
   if (options.scheduledFor !== undefined) {
     body.scheduledFor = options.scheduledFor;
   }
-  return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/social/${platform2}`, body);
+  return adminApiPatch(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/social/${platform2}`, body);
 }
 async function trackSocialShowCommand(idOrLogId) {
-  return adminApiGet(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/social`);
+  return adminApiGet(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/social`);
 }
 async function trackSocialCaptureCommand(limit) {
   const body = limit === undefined ? {} : { limit: String(limit) };
-  return adminApiPost(`/api/admin/social/posts/capture`, body);
+  return adminApiPost(`/api/v1/admin/social/posts/capture`, body);
 }
 async function trackUpdateCommand(trackId, options) {
   const body = {};
@@ -4146,13 +4174,13 @@ async function trackUpdateCommand(trackId, options) {
   if (options.analyzedAt !== undefined) {
     body.analyzedAt = options.analyzedAt;
   }
-  return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
+  return adminApiPatch(`/api/v1/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
 async function trackRequeueVideoCommand(idOrLogId) {
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/requeue`);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/video/requeue`);
 }
 async function trackPurgeVideoCommand(idOrLogId) {
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/purge`);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/video/purge`);
 }
 async function trackObserveCommand(idOrLogId, options) {
   const body = { script: options.script };
@@ -4174,7 +4202,7 @@ async function trackObserveCommand(idOrLogId, options) {
   if (options.force) {
     body.force = true;
   }
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/observe`, body);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/observe`, body);
 }
 async function trackContextCommand(idOrLogId, options = {}) {
   const body = {};
@@ -4184,7 +4212,7 @@ async function trackContextCommand(idOrLogId, options = {}) {
   if (options.refresh) {
     body.refresh = true;
   }
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/context`, body);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/context`, body);
 }
 async function trackNoteCommand(idOrLogId, options) {
   const body = { note: options.note };
@@ -4194,7 +4222,7 @@ async function trackNoteCommand(idOrLogId, options) {
   if (typeof options.promptVersion === "number") {
     body.promptVersion = options.promptVersion;
   }
-  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/note`, body);
+  return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/note`, body);
 }
 var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE = "https://found.fluncle.com", VIDEO_FIELDS, RERENDER_CONTRACT_FIELDS, RERENDER_ADVISORY_FIELDS, FOOTAGE_FIELDS, PLATE_FIELDS, NON_FILE_OPTIONS, DIVERSITY_LEDGER_FIELDS;
 var init_track = __esm(() => {
@@ -4247,7 +4275,7 @@ __export(exports_admin_attention, {
   attentionQueueCommand: () => attentionQueueCommand
 });
 async function attentionQueueCommand() {
-  const response = await adminApiGet("/api/admin/attention");
+  const response = await adminApiGet("/api/v1/admin/attention");
   return response.attention;
 }
 function attentionQueueLines(queue) {
@@ -4291,7 +4319,7 @@ __export(exports_add, {
   addCommand: () => addCommand
 });
 async function addCommand(spotifyUrl, options) {
-  const result = await adminApiPost("/api/admin/tracks", {
+  const result = await adminApiPost("/api/v1/admin/tracks", {
     dryRun: options.dryRun,
     note: options.note,
     spotifyUrl
@@ -4356,7 +4384,7 @@ async function trackUpdateCommand2(trackId, options) {
   if (options.analyzedAt !== undefined) {
     body.analyzedAt = options.analyzedAt;
   }
-  return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
+  return adminApiPatch(`/api/v1/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
 var init_track2 = __esm(() => {
   init_api();
@@ -4382,6 +4410,7 @@ __export(exports_admin_tracks, {
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillArtistEdgesCommand: () => backfillArtistEdgesCommand,
+  backfillArtistCreditsCommand: () => backfillArtistCreditsCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
 });
@@ -4433,7 +4462,7 @@ async function fetchAdminTracks(options) {
     if (cursor) {
       params.set("cursor", cursor);
     }
-    const response = await adminApiGet(`/api/admin/tracks?${params.toString()}`);
+    const response = await adminApiGet(`/api/v1/admin/tracks?${params.toString()}`);
     for (const apiTrack of response.tracks) {
       const track = mapTrack2(apiTrack);
       if (track.type === "mixtape") {
@@ -4482,7 +4511,7 @@ async function trackWorkCommand(options) {
   if (options.count) {
     params.set("count", "true");
   }
-  const response = await adminApiGet(`/api/admin/tracks/work?${params.toString()}`);
+  const response = await adminApiGet(`/api/v1/admin/tracks/work?${params.toString()}`);
   return { queued: response.queued, tracks: response.tracks ?? [] };
 }
 async function requeueAnalysisCommand(options) {
@@ -4547,39 +4576,46 @@ async function backfillLastfmCommand(limit, dryRun, cursor) {
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/lastfm?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/lastfm?${params.toString()}`);
 }
 async function backfillDiscogsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/discogs?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/discogs?${params.toString()}`);
 }
 async function backfillAppleMusicCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/apple-music?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/apple-music?${params.toString()}`);
 }
 async function backfillAppleCatalogueCommand(limit, dryRun) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
-  return adminApiPost(`/api/admin/backfill/apple-catalogue?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/apple-catalogue?${params.toString()}`);
 }
 async function backfillRecordingMbidsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/recording-mbids?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/recording-mbids?${params.toString()}`);
 }
 async function backfillArtistEdgesCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/artist-edges?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/artist-edges?${params.toString()}`);
+}
+async function backfillArtistCreditsCommand(limit, dryRun, cursor) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
+  if (cursor) {
+    params.set("cursor", cursor);
+  }
+  return adminApiPost(`/api/v1/admin/backfill/artist-credits?${params.toString()}`);
 }
 async function vehiclesCommand(limit) {
   const tracks = await fetchAdminTracks({ hasVideo: true, max: limit, order: "desc" });
@@ -4599,7 +4635,7 @@ async function mixableOrderCommand(logIds, seed) {
   if (seed) {
     params.set("seed", seed);
   }
-  return adminApiGet(`/api/admin/tracks/mixable-order?${params.toString()}`);
+  return adminApiGet(`/api/v1/admin/tracks/mixable-order?${params.toString()}`);
 }
 var pageSize3 = 48;
 var init_admin_tracks = __esm(() => {
@@ -4620,7 +4656,7 @@ async function previewArchiveUploadCommand(idOrLogId, options) {
   form.append("preview", Bun.file(options.file), basename(options.file));
   form.append("source", options.source);
   form.append("mime", options.mime);
-  return adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/preview`, form);
+  return adminApiPostForm(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/preview`, form);
 }
 async function previewArchiveBackfillCommand(options) {
   const result = {
@@ -4631,7 +4667,7 @@ async function previewArchiveBackfillCommand(options) {
   };
   let cursor;
   while (result.archived.length < (options.limit ?? Number.POSITIVE_INFINITY)) {
-    const page = await publicApiGet(`/api/tracks?limit=48${cursor ? `&cursor=${encodeURIComponent(cursor)}` : ""}`);
+    const page = await publicApiGet(`/api/v1/findings?limit=48${cursor ? `&cursor=${encodeURIComponent(cursor)}` : ""}`);
     for (const track of page.tracks) {
       if (result.archived.length >= (options.limit ?? Number.POSITIVE_INFINITY)) {
         break;
@@ -4643,7 +4679,7 @@ async function previewArchiveBackfillCommand(options) {
         result.skipped.push({ reason: "no_log_id", trackId: track.trackId });
         continue;
       }
-      const status = await adminApiGet(`/api/admin/tracks/${encodeURIComponent(track.trackId)}/preview`);
+      const status = await adminApiGet(`/api/v1/admin/tracks/${encodeURIComponent(track.trackId)}/preview`);
       if (status.archived) {
         result.skipped.push({ reason: "already_archived", trackId: track.trackId });
         continue;
@@ -4682,7 +4718,7 @@ async function uploadResolvedPreview(trackId, preview) {
   form.append("preview", new Blob([preview.bytes], { type: preview.mime }), `preview.${extension}`);
   form.append("source", preview.source);
   form.append("mime", preview.mime);
-  await adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(trackId)}/preview`, form);
+  await adminApiPostForm(`/api/v1/admin/tracks/${encodeURIComponent(trackId)}/preview`, form);
 }
 async function resolvePreview(track) {
   const stored = await downloadPreview(track.previewUrl, "deezer:stored");
@@ -4862,20 +4898,20 @@ async function distributeYoutube2(mixtapeId, videoPath, onProgress) {
     offset = 0;
   }
   onProgress?.("Recording the YouTube link");
-  await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/finalize`, { videoId });
+  await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/finalize`, { videoId });
   return { url: `https://youtu.be/${videoId}`, videoId };
 }
 async function publishYoutubeCommand2(idOrLogId) {
   const mixtapeId = await resolveMixtapeId2(idOrLogId);
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/publish`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/publish`);
   return { url: response.url };
 }
 async function resyncYoutube2(mixtapeId) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/resync`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/resync`);
   return { url: response.url, videoId: response.videoId };
 }
 async function authYoutubeCommand2() {
-  const response = await adminApiGet("/api/admin/youtube/auth/start");
+  const response = await adminApiGet("/api/v1/admin/youtube/auth/start");
   console.log(`Open this YouTube authorization URL:
 
 ${response.authUrl}
@@ -4883,11 +4919,11 @@ ${response.authUrl}
 After approving access, Google returns to the Fluncle admin callback and stores the refresh token server-side.`);
 }
 async function initiate2(mixtapeId, contentLength, contentType) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/initiate`, { contentLength, contentType });
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/youtube/initiate`, { contentLength, contentType });
   return { accessToken: response.accessToken, sessionUri: response.sessionUri };
 }
 async function mintToken2() {
-  const response = await adminApiPost("/api/admin/youtube/token");
+  const response = await adminApiPost("/api/v1/admin/youtube/token");
   return response.accessToken;
 }
 async function putChunk2(args) {
@@ -4947,7 +4983,7 @@ function nextOffset2(rangeHeader, fallback) {
   return Number(match[1]) + 1;
 }
 async function resolveMixtapeId2(idOrLogId) {
-  const response = await adminApiGet("/api/admin/mixtapes");
+  const response = await adminApiGet("/api/v1/admin/mixtapes");
   const match = response.mixtapes.find((mixtape) => mixtape.id === idOrLogId || mixtape.logId === idOrLogId);
   if (!match?.id) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or Log ID ${idOrLogId}`);
@@ -4983,10 +5019,10 @@ __export(exports_publish, {
   publishAdvanceCommand: () => publishAdvanceCommand
 });
 async function publishAdvanceCommand() {
-  return adminApiPost("/api/admin/social/publish/advance", {});
+  return adminApiPost("/api/v1/admin/social/publish/advance", {});
 }
 async function publishAdvancePauseCommand(paused) {
-  const response = await adminApiPut("/api/admin/social/publish/advance/state", { paused });
+  const response = await adminApiPut("/api/v1/admin/social/publish/advance/state", { paused });
   return response.paused;
 }
 var init_publish = __esm(() => {
@@ -5000,10 +5036,10 @@ __export(exports_capture, {
   captureBudgetCommand: () => captureBudgetCommand
 });
 async function captureBudgetCommand() {
-  return adminApiGet("/api/admin/catalogue/capture-budget");
+  return adminApiGet("/api/v1/admin/catalogue/capture-budget");
 }
 async function setCaptureBudgetCommand(input) {
-  return adminApiPut("/api/admin/catalogue/capture-budget", input);
+  return adminApiPut("/api/v1/admin/catalogue/capture-budget", input);
 }
 var init_capture = __esm(() => {
   init_api();
@@ -5207,7 +5243,7 @@ __export(exports_recordings, {
 });
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 async function recordingGet(id) {
-  const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  const response = await adminApiGet(`/api/v1/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
 }
 function formatRecordingSummary(recording) {
@@ -5225,7 +5261,7 @@ async function recordingsListCommand(options = {}) {
     query.set("parentId", options.parentId);
   }
   const suffix = query.toString() ? `?${query.toString()}` : "";
-  const response = await adminApiGet(`/api/admin/recordings${suffix}`);
+  const response = await adminApiGet(`/api/v1/admin/recordings${suffix}`);
   if (options.json) {
     printJson2({ ok: true, recordings: response.recordings });
     return;
@@ -5255,7 +5291,7 @@ async function recordingGetCommand(id, options = {}) {
 }
 async function recordingCreateCommand(options = {}) {
   if (options.plan) {
-    const created2 = await adminApiPost("/api/admin/recordings", {
+    const created2 = await adminApiPost("/api/v1/admin/recordings", {
       kind: "plan",
       recordedAt: options.recordedAt
     });
@@ -5277,7 +5313,7 @@ async function recordingCreateCommand(options = {}) {
   if (!existsSync2(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
-  const created = await adminApiPost("/api/admin/recordings", {
+  const created = await adminApiPost("/api/v1/admin/recordings", {
     recordedAt: options.recordedAt,
     title
   });
@@ -5288,7 +5324,7 @@ async function recordingCreateCommand(options = {}) {
     }
   };
   log(`Recording ${recording.id} created, staging the set video…`);
-  const upload = await uploadRenditionMultipart(options.video, `/api/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
+  const upload = await uploadRenditionMultipart(options.video, `/api/v1/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
   if (options.json) {
     printJson2({ key: upload.key, ok: true, recording, url: upload.url });
     return;
@@ -5322,7 +5358,7 @@ async function recordingUpdateCommand(id, options = {}) {
   if (Object.keys(body).length === 0) {
     throw new CliError2("no_fields", "Nothing to update. Pass --title, --recorded-at, --parent-id, or --tracklist-file");
   }
-  const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
+  const response = await adminApiPatch(`/api/v1/admin/recordings/${encodeURIComponent(id)}`, body);
   if (options.json) {
     printJson2({ ok: true, recording: response.recording });
     return;
@@ -5333,7 +5369,7 @@ async function recordingDeleteCommand(id, options = {}) {
   if (!id) {
     throw new CliError2("missing_id", "Missing recording id for: delete");
   }
-  await adminApiDelete(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  await adminApiDelete(`/api/v1/admin/recordings/${encodeURIComponent(id)}`);
   if (options.json) {
     printJson2({ ok: true });
     return;
@@ -5344,7 +5380,7 @@ async function recordingPromoteCommand(id, options = {}) {
   if (!id) {
     throw new CliError2("missing_id", "Missing recording id for: promote");
   }
-  const response = await adminApiPost(`/api/admin/recordings/${encodeURIComponent(id)}/promote`);
+  const response = await adminApiPost(`/api/v1/admin/recordings/${encodeURIComponent(id)}/promote`);
   const recording = response.recording;
   if (options.json) {
     printJson2({ ok: true, recording });
@@ -5368,7 +5404,7 @@ async function recordingReplaceCuesCommand(id, options = {}) {
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
-  const response = await adminApiPut(`/api/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
+  const response = await adminApiPut(`/api/v1/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
   if (options.json) {
     printJson2({ ok: true, recording: response.recording });
     return;
@@ -5463,19 +5499,19 @@ async function clipsListCommand(filter = {}) {
     params.set("status", filter.status);
   }
   const query = params.toString();
-  const response = await adminApiGet(`/api/admin/clips${query ? `?${query}` : ""}`);
+  const response = await adminApiGet(`/api/v1/admin/clips${query ? `?${query}` : ""}`);
   return response.clips;
 }
 async function clipPostsListCommand() {
-  const response = await adminApiGet("/api/admin/clips/social");
+  const response = await adminApiGet("/api/v1/admin/clips/social");
   return response.posts;
 }
 async function clipScheduleCommand(clipId, scheduledFor) {
-  const response = await adminApiPatch(`/api/admin/clips/${encodeURIComponent(clipId)}/schedule`, { scheduledFor });
+  const response = await adminApiPatch(`/api/v1/admin/clips/${encodeURIComponent(clipId)}/schedule`, { scheduledFor });
   return response.post;
 }
 async function clipDripPauseCommand(paused) {
-  const response = await adminApiPut("/api/admin/clips/drip/state", {
+  const response = await adminApiPut("/api/v1/admin/clips/drip/state", {
     paused
   });
   return response.paused;
@@ -5516,9 +5552,9 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
       throw new CliError2("clip_too_large", `The cut is ${(sizeBytes / 1e6).toFixed(1)} MB (> 100 MB Cloudflare MT ceiling). Shorten the window or lower the bitrate cap`);
     }
     onProgress(`Clip ${clipId}: uploading ${(sizeBytes / 1e6).toFixed(1)} MB…`);
-    const presign = await adminApiPost(`/api/admin/clips/${encodeURIComponent(clipId)}/cut/presign`, { contentType: "video/mp4" });
+    const presign = await adminApiPost(`/api/v1/admin/clips/${encodeURIComponent(clipId)}/cut/presign`, { contentType: "video/mp4" });
     await putClip(presign.url, presign.contentType, outputPath);
-    await adminApiPost(`/api/admin/clips/${encodeURIComponent(clipId)}/cut/finalize`);
+    await adminApiPost(`/api/v1/admin/clips/${encodeURIComponent(clipId)}/cut/finalize`);
     onProgress(`Clip ${clipId}: done → ${FOUND_BASE3}/${presign.key}`);
     return {
       clipId,
@@ -5588,7 +5624,7 @@ __export(exports_recordings2, {
 });
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 async function recordingGet2(id) {
-  const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  const response = await adminApiGet(`/api/v1/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
 }
 function formatRecordingSummary2(recording) {
@@ -5606,7 +5642,7 @@ async function recordingsListCommand2(options = {}) {
     query.set("parentId", options.parentId);
   }
   const suffix = query.toString() ? `?${query.toString()}` : "";
-  const response = await adminApiGet(`/api/admin/recordings${suffix}`);
+  const response = await adminApiGet(`/api/v1/admin/recordings${suffix}`);
   if (options.json) {
     printJson2({ ok: true, recordings: response.recordings });
     return;
@@ -5636,7 +5672,7 @@ async function recordingGetCommand2(id, options = {}) {
 }
 async function recordingCreateCommand2(options = {}) {
   if (options.plan) {
-    const created2 = await adminApiPost("/api/admin/recordings", {
+    const created2 = await adminApiPost("/api/v1/admin/recordings", {
       kind: "plan",
       recordedAt: options.recordedAt
     });
@@ -5658,7 +5694,7 @@ async function recordingCreateCommand2(options = {}) {
   if (!existsSync3(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
-  const created = await adminApiPost("/api/admin/recordings", {
+  const created = await adminApiPost("/api/v1/admin/recordings", {
     recordedAt: options.recordedAt,
     title
   });
@@ -5669,7 +5705,7 @@ async function recordingCreateCommand2(options = {}) {
     }
   };
   log(`Recording ${recording.id} created, staging the set video…`);
-  const upload = await uploadRenditionMultipart(options.video, `/api/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
+  const upload = await uploadRenditionMultipart(options.video, `/api/v1/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
   if (options.json) {
     printJson2({ key: upload.key, ok: true, recording, url: upload.url });
     return;
@@ -5703,7 +5739,7 @@ async function recordingUpdateCommand2(id, options = {}) {
   if (Object.keys(body).length === 0) {
     throw new CliError2("no_fields", "Nothing to update. Pass --title, --recorded-at, --parent-id, or --tracklist-file");
   }
-  const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
+  const response = await adminApiPatch(`/api/v1/admin/recordings/${encodeURIComponent(id)}`, body);
   if (options.json) {
     printJson2({ ok: true, recording: response.recording });
     return;
@@ -5714,7 +5750,7 @@ async function recordingDeleteCommand2(id, options = {}) {
   if (!id) {
     throw new CliError2("missing_id", "Missing recording id for: delete");
   }
-  await adminApiDelete(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  await adminApiDelete(`/api/v1/admin/recordings/${encodeURIComponent(id)}`);
   if (options.json) {
     printJson2({ ok: true });
     return;
@@ -5725,7 +5761,7 @@ async function recordingPromoteCommand2(id, options = {}) {
   if (!id) {
     throw new CliError2("missing_id", "Missing recording id for: promote");
   }
-  const response = await adminApiPost(`/api/admin/recordings/${encodeURIComponent(id)}/promote`);
+  const response = await adminApiPost(`/api/v1/admin/recordings/${encodeURIComponent(id)}/promote`);
   const recording = response.recording;
   if (options.json) {
     printJson2({ ok: true, recording });
@@ -5749,7 +5785,7 @@ async function recordingReplaceCuesCommand2(id, options = {}) {
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
-  const response = await adminApiPut(`/api/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
+  const response = await adminApiPut(`/api/v1/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
   if (options.json) {
     printJson2({ ok: true, recording: response.recording });
     return;
@@ -5805,20 +5841,20 @@ function readContentFile(filePath) {
   }
 }
 async function newsletterDraftCommand(options) {
-  return adminApiPost("/api/admin/newsletter/editions", buildBody2(options, { requireContent: true }));
+  return adminApiPost("/api/v1/admin/newsletter/editions", buildBody2(options, { requireContent: true }));
 }
 async function newsletterUpdateCommand(id, options) {
-  return adminApiPatch(`/api/admin/newsletter/editions/${encodeURIComponent(id)}`, buildBody2(options, { requireContent: false }));
+  return adminApiPatch(`/api/v1/admin/newsletter/editions/${encodeURIComponent(id)}`, buildBody2(options, { requireContent: false }));
 }
 async function newsletterSendCommand(id) {
-  return adminApiPost(`/api/admin/newsletter/editions/${encodeURIComponent(id)}/send`);
+  return adminApiPost(`/api/v1/admin/newsletter/editions/${encodeURIComponent(id)}/send`);
 }
 async function newsletterListCommand() {
-  const response = await adminApiGet("/api/admin/newsletter/editions");
+  const response = await adminApiGet("/api/v1/admin/newsletter/editions");
   return response.editions;
 }
 async function newsletterDeleteCommand(id) {
-  return adminApiDelete(`/api/admin/newsletter/editions/${encodeURIComponent(id)}`);
+  return adminApiDelete(`/api/v1/admin/newsletter/editions/${encodeURIComponent(id)}`);
 }
 var init_newsletter = __esm(() => {
   init_api();
@@ -5835,7 +5871,7 @@ __export(exports_admin_logbook, {
 import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
 async function logbookGapsCommand(limit) {
   const query = typeof limit === "number" ? `?limit=${encodeURIComponent(String(limit))}` : "";
-  const response = await adminApiGet(`/api/admin/logbook/gaps${query}`);
+  const response = await adminApiGet(`/api/v1/admin/logbook/gaps${query}`);
   return { gaps: response.gaps, spent: response.spent };
 }
 function resolveBody(options) {
@@ -5857,14 +5893,14 @@ function requireTitle(options) {
   return options.title;
 }
 async function logbookCreateCommand(sector, options) {
-  return adminApiPost(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+  return adminApiPost(`/api/v1/admin/logbook/${encodeURIComponent(sector)}`, {
     body: resolveBody(options),
     ...typeof options.promptVersion === "number" ? { promptVersion: options.promptVersion } : {},
     title: requireTitle(options)
   });
 }
 async function logbookUpdateCommand(sector, options) {
-  return adminApiPatch(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+  return adminApiPatch(`/api/v1/admin/logbook/${encodeURIComponent(sector)}`, {
     body: resolveBody(options),
     title: requireTitle(options)
   });
@@ -5894,11 +5930,11 @@ __export(exports_admin_prompts, {
 });
 import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
 async function promptsListCommand() {
-  const response = await adminApiGet("/api/admin/prompts");
+  const response = await adminApiGet("/api/v1/admin/prompts");
   return response.prompts;
 }
 async function promptGetCommand(slug) {
-  return adminApiGet(`/api/admin/prompts/${encodeURIComponent(slug)}`);
+  return adminApiGet(`/api/v1/admin/prompts/${encodeURIComponent(slug)}`);
 }
 async function promptDetailCommand(slug) {
   const prompts = await promptsListCommand();
@@ -5924,7 +5960,7 @@ function resolveBody2(options) {
 async function promptUpdateCommand(slug, options) {
   const body = resolveBody2(options);
   const note = options.note?.trim();
-  const response = await adminApiPost(`/api/admin/prompts/${encodeURIComponent(slug)}`, note ? { body, note } : { body });
+  const response = await adminApiPost(`/api/v1/admin/prompts/${encodeURIComponent(slug)}`, note ? { body, note } : { body });
   return { slug, version: response.version };
 }
 async function promptRollbackCommand(slug, version) {
@@ -5948,7 +5984,7 @@ async function restore(detail, input) {
   if (input.body.trim() === detail.activeBody.trim()) {
     return { from: input.from, skipped: true, slug: detail.slug, version: detail.activeVersion };
   }
-  const response = await adminApiPost(`/api/admin/prompts/${encodeURIComponent(detail.slug)}`, { body: input.body, note: input.note });
+  const response = await adminApiPost(`/api/v1/admin/prompts/${encodeURIComponent(detail.slug)}`, { body: input.body, note: input.note });
   return { from: input.from, skipped: false, slug: detail.slug, version: response.version };
 }
 function parseAgainst(value) {
@@ -6063,7 +6099,7 @@ var init_admin_prompts = __esm(() => {
 
 // src/commands/add.ts
 async function addCommand2(spotifyUrl, options) {
-  const result = await adminApiPost("/api/admin/tracks", {
+  const result = await adminApiPost("/api/v1/admin/tracks", {
     dryRun: options.dryRun,
     note: options.note,
     spotifyUrl
@@ -6094,7 +6130,7 @@ __export(exports_submissions, {
 });
 import { createInterface as createInterface2 } from "node:readline/promises";
 async function listSubmissionsCommand(options = {}) {
-  const response = await adminApiGet("/api/admin/submissions");
+  const response = await adminApiGet("/api/v1/admin/submissions");
   if (options.json) {
     printJson2({ ok: true, submissions: response.submissions });
     return;
@@ -6116,7 +6152,7 @@ async function reviewSubmissionCommand(submissionId, options = {}) {
   console.log(formatSubmissionDetail(submission));
 }
 async function rejectSubmissionCommand(submissionId, options = {}) {
-  const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submissionId)}/reject`);
+  const response = await adminApiPost(`/api/v1/admin/submissions/${encodeURIComponent(submissionId)}/reject`);
   if (options.json) {
     printJson2({ ok: true, submission: response.submission });
     return;
@@ -6141,7 +6177,7 @@ async function approveSubmissionCommand(submissionId, options = {}) {
     json: options.json,
     note: submission.note
   });
-  const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submission.id)}/approve`);
+  const response = await adminApiPost(`/api/v1/admin/submissions/${encodeURIComponent(submission.id)}/approve`);
   if (options.json) {
     printJson2({ ok: true, submission: response.submission });
     return;
@@ -6149,7 +6185,7 @@ async function approveSubmissionCommand(submissionId, options = {}) {
   console.log(`Approved ${formatTrackLine(submission)}.`);
 }
 async function triageSubmissionCommand(submissionId, verdict, options = {}) {
-  const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submissionId)}/triage`, {
+  const response = await adminApiPost(`/api/v1/admin/submissions/${encodeURIComponent(submissionId)}/triage`, {
     ...typeof options.promptVersion === "number" ? { promptVersion: options.promptVersion } : {},
     verdict
   });
@@ -6160,7 +6196,7 @@ async function triageSubmissionCommand(submissionId, verdict, options = {}) {
   console.log(`Triaged ${formatTrackLine(response.submission)}: ${response.submission.triageVerdict ?? ""}`);
 }
 async function fetchSubmission(submissionId) {
-  const response = await adminApiGet(`/api/admin/submissions/${encodeURIComponent(submissionId)}`);
+  const response = await adminApiGet(`/api/v1/admin/submissions/${encodeURIComponent(submissionId)}`);
   return response.submission;
 }
 async function confirm(label) {
@@ -6215,7 +6251,7 @@ __export(exports_auth, {
   authSpotifyCommand: () => authSpotifyCommand
 });
 async function authSpotifyCommand() {
-  const response = await adminApiGet("/api/admin/spotify/auth/start");
+  const response = await adminApiGet("/api/v1/admin/spotify/auth/start");
   console.log(`Open this Spotify authorization URL:
 
 ${response.authUrl}
@@ -6285,18 +6321,18 @@ async function distributeMixcloud2(mixtapeId, audioPath, onProgress, unlisted =
   const externalId = result.key;
   const url = `https://www.mixcloud.com${result.key}`;
   onProgress?.("Mixcloud: recording the link…");
-  await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/finalize`, {
+  await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/finalize`, {
     externalId,
     url
   });
   return { url };
 }
 async function resyncMixcloud2(mixtapeId) {
-  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
+  const response = await adminApiPost(`/api/v1/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
   return { url: response.url };
 }
 async function authMixcloudCommand2() {
-  const response = await adminApiGet("/api/admin/mixcloud/auth/start");
+  const response = await adminApiGet("/api/v1/admin/mixcloud/auth/start");
   console.log(`Open this Mixcloud authorization URL:
 
 ${response.authUrl}
@@ -6323,7 +6359,7 @@ function mixtapeTags2(_mixtape) {
 }
 async function fetchMixcloudToken2() {
   try {
-    const response = await adminApiPost("/api/admin/mixcloud/token");
+    const response = await adminApiPost("/api/v1/admin/mixcloud/token");
     return response.accessToken;
   } catch {
     throw new CliError2("mixcloud_not_connected", "Mixcloud is not connected. Run `fluncle admin auth mixcloud` to authorize it.");
@@ -6375,7 +6411,7 @@ __export(exports_auth_tiktok, {
   authTikTokCommand: () => authTikTokCommand
 });
 async function authTikTokCommand() {
-  const response = await adminApiGet("/api/admin/tiktok/auth/start");
+  const response = await adminApiGet("/api/v1/admin/tiktok/auth/start");
   console.log(`Open this TikTok authorization URL:
 
 ${response.authUrl}
@@ -6393,7 +6429,7 @@ __export(exports_auth_lastfm, {
 });
 async function authLastfmCommand(options) {
   if (options.token?.trim()) {
-    const response2 = await adminApiPost("/api/admin/lastfm/auth/session", { token: options.token.trim() });
+    const response2 = await adminApiPost("/api/v1/admin/lastfm/auth/session", { token: options.token.trim() });
     console.log(`Last.fm connected as ${response2.name || "fluncle"}.
 
 Set this as the Worker secret LASTFM_SESSION_KEY (it does not expire):
@@ -6405,7 +6441,7 @@ ${response2.sessionKey}
 Also store it in 1Password (Fluncle vault) alongside the API key + shared secret.`);
     return;
   }
-  const response = await adminApiGet("/api/admin/lastfm/auth/start");
+  const response = await adminApiGet("/api/v1/admin/lastfm/auth/start");
   console.log(`Open this Last.fm authorization URL (logged in as fluncle) and click "Yes, allow access":
 
 ${response.authUrl}
@@ -6426,7 +6462,7 @@ __export(exports_admin_notes, {
 });
 async function noteHeldCommand(options) {
   const query = options.settled ? "?open=false" : "";
-  return adminApiGet(`/api/admin/note-rejections${query}`);
+  return adminApiGet(`/api/v1/admin/note-rejections${query}`);
 }
 async function noteGateCommand(options) {
   const patch = {};
@@ -6437,10 +6473,10 @@ async function noteGateCommand(options) {
     patch.maxOverlap = options.maxOverlap;
   }
   if (Object.keys(patch).length === 0) {
-    const response2 = await adminApiGet("/api/admin/note-rejections");
+    const response2 = await adminApiGet("/api/v1/admin/note-rejections");
     return response2.gate;
   }
-  const response = await adminApiPatch("/api/admin/note-gate", patch);
+  const response = await adminApiPatch("/api/v1/admin/note-gate", patch);
   return response.gate;
 }
 var init_admin_notes = __esm(() => {
@@ -6455,7 +6491,7 @@ __export(exports_admin_observations, {
 });
 async function observationHeldCommand(options) {
   const query = options.settled ? "?open=false" : "";
-  return adminApiGet(`/api/admin/observation-rejections${query}`);
+  return adminApiGet(`/api/v1/admin/observation-rejections${query}`);
 }
 async function observationGateCommand(options) {
   const patch = {};
@@ -6466,10 +6502,10 @@ async function observationGateCommand(options) {
     patch.maxOverlap = options.maxOverlap;
   }
   if (Object.keys(patch).length === 0) {
-    const response2 = await adminApiGet("/api/admin/observation-rejections");
+    const response2 = await adminApiGet("/api/v1/admin/observation-rejections");
     return response2.gate;
   }
-  const response = await adminApiPatch("/api/admin/observation-gate", patch);
+  const response = await adminApiPatch("/api/v1/admin/observation-gate", patch);
   return response.gate;
 }
 var init_admin_observations = __esm(() => {
@@ -6485,13 +6521,13 @@ __export(exports_admin_frontier, {
 });
 async function frontierRefreshCommand(options) {
   const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
-  return adminApiPost("/api/admin/frontier-playlists/refresh", limit ? { limit } : {});
+  return adminApiPost("/api/v1/admin/frontier-playlists/refresh", limit ? { limit } : {});
 }
 async function frontierStatusCommand() {
-  return adminApiGet("/api/admin/frontier/minting");
+  return adminApiGet("/api/v1/admin/frontier/minting");
 }
 async function frontierSetMintingCommand(open) {
-  return adminApiPut("/api/admin/frontier/minting", { open });
+  return adminApiPut("/api/v1/admin/frontier/minting", { open });
 }
 var init_admin_frontier = __esm(() => {
   init_api();
@@ -6516,11 +6552,11 @@ __export(exports_admin_catalogue, {
 });
 async function catalogueRankCommand(options) {
   const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
-  const response = await adminApiPost("/api/admin/catalogue/rank", limit ? { limit } : {});
+  const response = await adminApiPost("/api/v1/admin/catalogue/rank", limit ? { limit } : {});
   return { summary: response.summary, telescope: response.telescope };
 }
 async function catalogueDemandCommand() {
-  const response = await adminApiPost("/api/admin/catalogue/demand", {});
+  const response = await adminApiPost("/api/v1/admin/catalogue/demand", {});
   return response.summary;
 }
 async function catalogueListCommand(options) {
@@ -6529,34 +6565,34 @@ async function catalogueListCommand(options) {
   if (options.limit) {
     params.set("limit", options.limit);
   }
-  return adminApiGet(`/api/admin/catalogue?${params.toString()}`);
+  return adminApiGet(`/api/v1/admin/catalogue?${params.toString()}`);
 }
 async function clearWrongAudioCommand(trackId) {
-  return adminApiPost("/api/admin/catalogue/wrong-audio/clear", {
+  return adminApiPost("/api/v1/admin/catalogue/wrong-audio/clear", {
     trackId
   });
 }
 async function requeueUnmatchedCommand() {
-  return adminApiPost("/api/admin/catalogue/captures/requeue-unmatched", {});
+  return adminApiPost("/api/v1/admin/catalogue/captures/requeue-unmatched", {});
 }
 async function forceCaptureCommand(trackId) {
-  return adminApiPost("/api/admin/catalogue/force-capture", {
+  return adminApiPost("/api/v1/admin/catalogue/force-capture", {
     trackId
   });
 }
 async function flagWrongAudioCommand(trackId) {
-  return adminApiPost("/api/admin/catalogue/wrong-audio/flag", {
+  return adminApiPost("/api/v1/admin/catalogue/wrong-audio/flag", {
     trackId
   });
 }
 async function certifyTrackCommand(trackId, note) {
-  return adminApiPost("/api/admin/catalogue/certify", {
+  return adminApiPost("/api/v1/admin/catalogue/certify", {
     ...note ? { note } : {},
     trackId
   });
 }
 async function setTrackDismissedCommand(trackId, dismissed) {
-  return adminApiPut("/api/admin/catalogue/dismissed", {
+  return adminApiPut("/api/v1/admin/catalogue/dismissed", {
     dismissed,
     trackId
   });
@@ -6566,10 +6602,10 @@ async function listUnverifiedCapturesCommand(options) {
   if (options.limit) {
     params.set("limit", options.limit);
   }
-  return adminApiGet(`/api/admin/catalogue/captures/unverified?${params.toString()}`);
+  return adminApiGet(`/api/v1/admin/catalogue/captures/unverified?${params.toString()}`);
 }
 async function verifyCaptureCommand(trackId, verdict) {
-  return adminApiPost("/api/admin/catalogue/captures/verify", {
+  return adminApiPost("/api/v1/admin/catalogue/captures/verify", {
     trackId,
     verdict
   });
@@ -6579,10 +6615,10 @@ async function crawlCatalogueCommand(limit, maxHop, dryRun) {
   if (dryRun) {
     params.set("dryRun", "true");
   }
-  return adminApiPost(`/api/admin/catalogue/crawl?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/catalogue/crawl?${params.toString()}`);
 }
 async function crawlStatusCommand() {
-  return adminApiGet("/api/admin/catalogue/crawl");
+  return adminApiGet("/api/v1/admin/catalogue/crawl");
 }
 var CATALOGUE_LENSES;
 var init_admin_catalogue = __esm(() => {
@@ -6596,7 +6632,7 @@ __export(exports_admin_reach, {
   reachCollectCommand: () => reachCollectCommand
 });
 async function reachCollectCommand() {
-  return adminApiPost("/api/admin/reach/collect", {});
+  return adminApiPost("/api/v1/admin/reach/collect", {});
 }
 var init_admin_reach = __esm(() => {
   init_api();
@@ -6626,13 +6662,13 @@ function buildBioBody(options) {
   return body;
 }
 async function describeArtistCommand(slug, options) {
-  return adminApiPost(`/api/admin/artists/${encodeURIComponent(slug)}/bio`, buildBioBody(options));
+  return adminApiPost(`/api/v1/admin/artists/${encodeURIComponent(slug)}/bio`, buildBioBody(options));
 }
 async function draftArtistBioCommand(slug) {
-  return adminApiGet(`/api/admin/artists/${encodeURIComponent(slug)}/bio-draft`);
+  return adminApiGet(`/api/v1/admin/artists/${encodeURIComponent(slug)}/bio-draft`);
 }
 async function artistsBioQueueCommand(limit) {
-  const response = await adminApiGet(`/api/admin/artists/bio-queue?limit=${limit}`);
+  const response = await adminApiGet(`/api/v1/admin/artists/bio-queue?limit=${limit}`);
   return response.artists;
 }
 async function listArtistsCommand(limit, cursor) {
@@ -6640,14 +6676,14 @@ async function listArtistsCommand(limit, cursor) {
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiGet(`/api/admin/artists?${params.toString()}`);
+  return adminApiGet(`/api/v1/admin/artists?${params.toString()}`);
 }
 async function resolveArtistCommand(artistId) {
-  return adminApiPost(`/api/admin/artists/${encodeURIComponent(artistId)}/resolve`);
+  return adminApiPost(`/api/v1/admin/artists/${encodeURIComponent(artistId)}/resolve`);
 }
 async function rankArtistsCommand(options) {
   const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
-  const response = await adminApiPost("/api/admin/artists/rank", limit ? { limit } : {});
+  const response = await adminApiPost("/api/v1/admin/artists/rank", limit ? { limit } : {});
   return { summary: response.summary };
 }
 async function backfillArtistImagesCommand(limit, dryRun, cursor) {
@@ -6655,14 +6691,14 @@ async function backfillArtistImagesCommand(limit, dryRun, cursor) {
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/artist-images?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/artist-images?${params.toString()}`);
 }
 async function backfillArtistsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/artists?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/artists?${params.toString()}`);
 }
 var init_admin_artists = __esm(() => {
   init_api();
@@ -6694,17 +6730,17 @@ __export(exports_admin_labels, {
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
 async function mergeLabelCommand(losingSlug, canonicalSlug) {
-  const response = await adminApiPost(`/api/admin/labels/${encodeURIComponent(losingSlug)}/merge`, { canonicalSlug });
+  const response = await adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(losingSlug)}/merge`, { canonicalSlug });
   return response.result;
 }
 async function describeLabelCommand(slug, options) {
-  return adminApiPost(`/api/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
+  return adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
 async function draftLabelBioCommand(slug) {
-  return adminApiGet(`/api/admin/labels/${encodeURIComponent(slug)}/bio-draft`);
+  return adminApiGet(`/api/v1/admin/labels/${encodeURIComponent(slug)}/bio-draft`);
 }
 async function labelsBioQueueCommand(limit) {
-  const response = await adminApiGet(`/api/admin/labels/bio-queue?limit=${limit}`);
+  const response = await adminApiGet(`/api/v1/admin/labels/bio-queue?limit=${limit}`);
   return response.labels;
 }
 async function backfillLabelImagesCommand(limit, dryRun, cursor) {
@@ -6712,14 +6748,14 @@ async function backfillLabelImagesCommand(limit, dryRun, cursor) {
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/label-images?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/label-images?${params.toString()}`);
 }
 async function backfillLabelLineageCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
-  return adminApiPost(`/api/admin/backfill/label-lineage?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/label-lineage?${params.toString()}`);
 }
 var init_admin_labels = __esm(() => {
   init_api();
@@ -6739,7 +6775,7 @@ async function backfillCoverMastersCommand(kind, limit, dryRun, cursor, retryNon
   if (retryNone) {
     params.set("retry", "none");
   }
-  return adminApiPost(`/api/admin/backfill/cover-masters?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/backfill/cover-masters?${params.toString()}`);
 }
 var init_admin_covers = __esm(() => {
   init_api();
@@ -6753,13 +6789,13 @@ __export(exports_admin_albums, {
   albumsBioQueueCommand: () => albumsBioQueueCommand
 });
 async function describeAlbumCommand(slug, options) {
-  return adminApiPost(`/api/admin/albums/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
+  return adminApiPost(`/api/v1/admin/albums/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
 async function draftAlbumBioCommand(slug) {
-  return adminApiGet(`/api/admin/albums/${encodeURIComponent(slug)}/bio-draft`);
+  return adminApiGet(`/api/v1/admin/albums/${encodeURIComponent(slug)}/bio-draft`);
 }
 async function albumsBioQueueCommand(limit) {
-  const response = await adminApiGet(`/api/admin/albums/bio-queue?limit=${limit}`);
+  const response = await adminApiGet(`/api/v1/admin/albums/bio-queue?limit=${limit}`);
   return response.albums;
 }
 var init_admin_albums = __esm(() => {
@@ -6781,7 +6817,7 @@ async function migratePreviewArchiveCommand(args) {
   if (args.cursor) {
     params.set("cursor", args.cursor);
   }
-  return adminApiPost(`/api/admin/migrations/preview-archive?${params.toString()}`);
+  return adminApiPost(`/api/v1/admin/migrations/preview-archive?${params.toString()}`);
 }
 var init_preview_migration = __esm(() => {
   init_api();
@@ -10014,6 +10050,10 @@ function addAdminCommands(program2) {
     const { backfillArtistEdgesCommand: backfillArtistEdgesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillArtistEdges(options, backfillArtistEdgesCommand2);
   });
+  backfill.command("artist-credits").description("Mint identity-true artists from MusicBrainz credits for the zero-matched residual").option("--dry-run", "Report the eligible worklist without any vendor call or write", false).option("--limit <limit>", "Max worklist rows to visit", "40").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillArtistCreditsCommand: backfillArtistCreditsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillArtistCredits(options, backfillArtistCreditsCommand2);
+  });
   backfill.command("cover-masters").description("Resolve owned \u22641200\xB2 cover masters (album/artist) into R2").option("--kind <kind>", "Which entity to drain: album | artist", "album").option("--dry-run", "Report the eligible worklist without any fetch or write", false).option("--retry-none", "First re-queue a bounded batch of terminal none rows to pending, then run the pass", false).option("--limit <limit>", "Max entities to process", "50").option("--json", "Print JSON", false).action(async (options) => {
     const { backfillCoverMastersCommand: backfillCoverMastersCommand2 } = await Promise.resolve().then(() => (init_admin_covers(), exports_admin_covers));
     await runBackfillCoverMasters(options, backfillCoverMastersCommand2);
@@ -11061,6 +11101,57 @@ async function runBackfillArtistEdges(options, backfillArtistEdgesCommand2) {
   const verb = dryRun ? "Would write" : "Wrote";
   console.log(`${verb} ${edgesWritten} track_artists edge(s) over ${scanned} track(s): ${fullyMatched.length} fully matched, ${partiallyMatched.length} partially, ${zeroMatched.length} with none; ${unmatchedNames} credited name(s) left unmatched.`);
 }
+async function runBackfillArtistCredits(options, backfillArtistCreditsCommand2) {
+  const limit = parseListLimit(options.limit) ?? 40;
+  let cursor;
+  let dryRun = options.dryRun;
+  let scanned = 0;
+  let mintedArtists = 0;
+  let matchedArtists = 0;
+  let adoptedArtists = 0;
+  let edgesWritten = 0;
+  let skippedNoIdentity = 0;
+  let throttled = false;
+  while (scanned < limit) {
+    const remaining = limit - scanned;
+    const result = await backfillArtistCreditsCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    scanned += result.scanned;
+    mintedArtists += result.mintedArtists;
+    matchedArtists += result.matchedArtists;
+    adoptedArtists += result.adoptedArtists;
+    edgesWritten += result.edgesWritten;
+    skippedNoIdentity += result.skippedNoIdentity;
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would visit" : "visited";
+      console.log(`  \u2026${verb2} ${result.scanned}; minted ${result.mintedArtists}, adopted ${result.adoptedArtists}, matched ${result.matchedArtists} artist(s); wrote ${result.edgesWritten} edge(s); ${result.skippedNoIdentity} without a MusicBrainz identity`);
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      adoptedArtists,
+      dryRun,
+      edgesWritten,
+      matchedArtists,
+      mintedArtists,
+      ok: true,
+      rateLimited: throttled,
+      scanned,
+      skippedNoIdentity
+    });
+    return;
+  }
+  const verb = dryRun ? "Would visit" : "Visited";
+  console.log(`${verb} ${scanned} track(s): minted ${mintedArtists}, adopted ${adoptedArtists}, matched ${matchedArtists} artist(s); wrote ${edgesWritten} track_artists edge(s); ${skippedNoIdentity} carried no MusicBrainz identity.`);
+}
 async function runArtistResolveQueue(options, listArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const result = await listArtistsCommand2(limit ?? 50);