fluncle 0.136.0 → 0.138.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.136.0".trim() ? "0.136.0".trim() : "0.1.0";
+  currentVersion = "0.138.0".trim() ? "0.138.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2189,7 +2189,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.136.0".trim() ? "0.136.0".trim() : "0.1.0";
+  currentVersion2 = "0.138.0".trim() ? "0.138.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2247,11 +2247,11 @@ var init_src = __esm(() => {
     },
     {
       exposedContent: [
-        "the mixability set-builder — chain a set from Fluncle's findings that mixes clean, share it as a link"
+        "the free mixing tool — name artists you like, and Fluncle ranks what mixes in clean next from the whole archive; chain a set and share it as a link"
       ],
       kind: "web_route",
       name: "web.mix",
-      operatorNotes: "ADMIN-GATED at launch (RFC mixability-engine, Decision 1): the full /mix set-builder ships behind admin auth until the archive clears the ~250-finding floor. Registered here as `pending` (dark to every public consumer — the dev-row, llms.txt, the sitemap, /status) so going public is one flip: remove `pending` + set a web weight + announce. The `list_mixable_tracks` API op already ships at its final public tier, so the flip needs no rebuild. No probeConfig — the admin gate 302s a bare GET to /admin/login, which would read as a false 'down'.",
+      operatorNotes: "PUBLIC-CAPABLE, gated by a SELF-LIFTING DEPTH MEASUREMENT (not admin auth). The old ~250-finding / admin gate is gone: `/mix` now measures the live archive on every load (`getMixChainDepth` — can the median track reach a full set + rail by a named harmonic move?) and opens to the world on its own the day the catalogue lands enough keyed depth. Until then a stranger is redirected home and the operator still gets in to dogfood. This entry stays `pending` (dark to the dev-row, llms.txt, the sitemap, /status) ONLY so we do not advertise a URL that still redirects — the flip is: confirm the depth gate has opened in prod, remove `pending`, announce. The web weight is pre-set, so the flip needs no other change. No probeConfig — a closed gate 302s a bare GET, which would read as a false 'down'.",
       pending: true,
       route: "/mix",
       url: `${SITE}/mix`,
@@ -3654,7 +3654,8 @@ __export(exports_admin_tracks, {
   contextQueueCommand: () => contextQueueCommand,
   captureQueueCommand: () => captureQueueCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
-  backfillDiscogsCommand: () => backfillDiscogsCommand
+  backfillDiscogsCommand: () => backfillDiscogsCommand,
+  backfillAppleMusicCommand: () => backfillAppleMusicCommand
 });
 async function fetchAdminTracks(options) {
   const {
@@ -3827,6 +3828,13 @@ async function backfillDiscogsCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/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()}`);
+}
 async function vehiclesCommand(limit) {
   const tracks = await fetchAdminTracks({ hasVideo: true, max: limit, order: "desc" });
   return tracks.map((track) => ({
@@ -5746,6 +5754,22 @@ var init_admin_artists = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-labels.ts
+var exports_admin_labels = {};
+__export(exports_admin_labels, {
+  backfillLabelImagesCommand: () => backfillLabelImagesCommand
+});
+async function backfillLabelImagesCommand(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-images?${params.toString()}`);
+}
+var init_admin_labels = __esm(() => {
+  init_api();
+});
+
 // src/commands/preview-migration.ts
 var exports_preview_migration = {};
 __export(exports_preview_migration, {
@@ -8754,6 +8778,10 @@ function addAdminCommands(program2) {
     const { backfillDiscogsCommand: backfillDiscogsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillDiscogs(options, backfillDiscogsCommand2);
   });
+  backfill.command("apple-music").description("Resolve missing Apple Music URLs for published findings (exact ISRC match)").option("--dry-run", "Report the eligible set without resolving or writing", false).option("--limit <limit>", "Max findings to resolve", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillAppleMusicCommand: backfillAppleMusicCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillAppleMusic(options, backfillAppleMusicCommand2);
+  });
   backfill.command("artists").description("Back-fill the artist entity (artists + track_artists) for existing findings").option("--dry-run", "Report which findings would be upserted without touching the DB", false).option("--limit <limit>", "Max findings to process", "50").option("--json", "Print JSON", false).action(async (options) => {
     const { backfillArtistsCommand: backfillArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runBackfillArtists(options, backfillArtistsCommand2);
@@ -8762,6 +8790,10 @@ function addAdminCommands(program2) {
     const { backfillArtistImagesCommand: backfillArtistImagesCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runBackfillArtistImages(options, backfillArtistImagesCommand2);
   });
+  backfill.command("label-images").description("Resolve label logos (Discogs \u2192 Wikidata) into R2 for existing labels").option("--dry-run", "Report the eligible worklist without any vendor call or write", false).option("--limit <limit>", "Max labels to process", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillLabelImagesCommand: backfillLabelImagesCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    await runBackfillLabelImages(options, backfillLabelImagesCommand2);
+  });
   artists.command("resolve").description("Resolve an artist's social identity (MB url-rels + Firecrawl gap-fill)").argument("[artistId]").option("--queue", "Show the resolve worklist (artists awaiting resolution), oldest first", false).option("--limit <limit>", "Number of artists to show with --queue", "50").option("--json", "Print JSON", false).allowExcessArguments().action(async (artistId, options) => {
     if (options.queue) {
       const { listArtistsCommand: listArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
@@ -9161,6 +9193,72 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
     console.log(`  ${item.logId}: release ${item.releaseId}${master}`);
   }
 }
+async function runBackfillAppleMusic(options, backfillAppleMusicCommand2) {
+  const limit = parseListLimit(options.limit);
+  const resolved = [];
+  const unresolved = [];
+  const failed = [];
+  const skipped = [];
+  let cursor;
+  let dryRun = options.dryRun;
+  let throttled = false;
+  let configured = true;
+  while (resolved.length + unresolved.length + failed.length < limit) {
+    const remaining = limit - (resolved.length + unresolved.length + failed.length);
+    const result = await backfillAppleMusicCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    configured = result.configured;
+    resolved.push(...result.resolved);
+    unresolved.push(...result.unresolved);
+    failed.push(...result.failed);
+    skipped.push(...result.skipped);
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would resolve" : "resolved";
+      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.unresolvedCount} unresolved; ${result.failedCount} failed; ${result.skippedCount} skipped`);
+    }
+    if (!result.configured) {
+      break;
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printSweepJson({
+      configured,
+      dryRun,
+      failed,
+      rateLimited: throttled,
+      resolved,
+      resolvedCount: resolved.length,
+      skipped,
+      skippedCount: skipped.length,
+      unresolved,
+      unresolvedCount: unresolved.length
+    }, failed.length);
+    return;
+  }
+  if (!configured) {
+    console.log("Apple Music backfill is not configured (the Worker's MusicKit secrets are unset) \u2014 nothing resolved.");
+    return;
+  }
+  const verb = dryRun ? "Would resolve" : "Resolved";
+  console.log(`${verb} ${resolved.length} Apple Music URL(s); ${unresolved.length} unresolved; ${failed.length} failed; ${skipped.length} skipped.`);
+  for (const item of resolved) {
+    console.log(`  ${item.logId}: ${item.url}`);
+  }
+  for (const item of failed) {
+    console.log(`  ${item.logId}: ${item.error}`);
+  }
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+}
 async function runBackfillArtists(options, backfillArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const upserted = [];
@@ -9253,6 +9351,63 @@ async function runBackfillArtistImages(options, backfillArtistImagesCommand2) {
     process.exitCode = 1;
   }
 }
+async function runBackfillLabelImages(options, backfillLabelImagesCommand2) {
+  const limit = parseListLimit(options.limit);
+  const resolved = [];
+  const none = [];
+  const failed = [];
+  let cursor;
+  let dryRun = options.dryRun;
+  let throttled = false;
+  while (resolved.length + none.length + failed.length < limit) {
+    const remaining = limit - (resolved.length + none.length + failed.length);
+    const result = await backfillLabelImagesCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    resolved.push(...result.resolved);
+    none.push(...result.none);
+    failed.push(...result.failed);
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would resolve" : "resolved";
+      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.noneCount} without an image; ${result.failedCount} failed`);
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      dryRun,
+      failed,
+      failedCount: failed.length,
+      none,
+      noneCount: none.length,
+      ok: true,
+      rateLimited: throttled,
+      resolved,
+      resolvedCount: resolved.length
+    });
+    if (failed.length > 0) {
+      process.exitCode = 1;
+    }
+    return;
+  }
+  const verb = dryRun ? "Would resolve" : "Resolved";
+  console.log(`${verb} ${resolved.length} label logo(s); ${none.length} without an image; ${failed.length} failed.`);
+  for (const slug of resolved) {
+    console.log(`  ${slug}`);
+  }
+  for (const item of failed) {
+    console.log(`  ${item.slug}: ${item.error}`);
+  }
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+}
 async function runArtistResolveQueue(options, listArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const result = await listArtistsCommand2(limit ?? 50);

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.136.0"
+  "version": "0.138.0"
 }