fluncle 0.174.0 → 0.176.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.174.0".trim() ? "0.174.0".trim() : "0.1.0";
+  currentVersion = "0.176.0".trim() ? "0.176.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2259,7 +2259,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.174.0".trim() ? "0.174.0".trim() : "0.1.0";
+  currentVersion2 = "0.176.0".trim() ? "0.176.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3119,16 +3119,16 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin backfills apple-releases",
+      command: "fluncle admin backfills label-releases",
       exposedContent: [
-        "tap Apple Music's latest releases for the operator's enabled seed labels → day-one uncertified catalogue rows"
+        "tap Spotify's fresh releases for the operator's enabled seed labels → day-one uncertified catalogue rows"
       ],
       kind: "cron",
-      name: "cron.apple-releases",
-      operatorNotes: "every 24h, run by a rave-02 HOST systemd timer (docs/agents/hermes/apple-releases-timer/). The MusicKit FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Apple has it day one, so this taps each ENABLED seed label's latest releases and mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) with their real release dates — closing the /fresh lag cliff. It certifies nothing, publishes nothing, and never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (ISRC + same-album title fold). Worker-paced (the three APPLE_MUSIC_* secrets live on the Worker); a NO-OP until they are provisioned. Zero LLM tokens. Source: docs/agents/hermes/scripts/apple-releases-sweep.*. See docs/catalogue-crawler.md.",
+      name: "cron.label-releases",
+      operatorNotes: "every 24h, run by a rave-02 HOST systemd timer (docs/agents/hermes/label-releases-timer/). The FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Spotify has it day one, so this searches each ENABLED seed label's fresh releases (`label:\"<name>\" tag:new`, copyright-filtered — the fuzzy `label:` search is post-filtered on the album's ℗/© strings) and mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) with their real release dates — closing the /fresh lag cliff. It certifies nothing, publishes nothing, and never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (Spotify id/uri/ISRC + same-album title fold). Worker-paced, reusing the publish path's Spotify OAuth (no new secret; Apple was a measured 2/99 seed-label dead end). Zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
-        cronName: "fluncle-apple-releases",
+        cronName: "fluncle-label-releases",
         kind: "cron"
       },
       statusDescription: "taps day-one releases from the enabled labels",
@@ -4109,8 +4109,8 @@ __export(exports_admin_tracks, {
   captureQueueCommand: () => captureQueueCommand,
   backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
+  backfillLabelReleasesCommand: () => backfillLabelReleasesCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
-  backfillAppleReleasesCommand: () => backfillAppleReleasesCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
 });
@@ -4296,9 +4296,9 @@ async function backfillAppleCatalogueCommand(limit, dryRun) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   return adminApiPost(`/api/admin/backfill/apple-catalogue?${params.toString()}`);
 }
-async function backfillAppleReleasesCommand(limit, dryRun) {
+async function backfillLabelReleasesCommand(limit, dryRun) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
-  return adminApiPost(`/api/admin/backfill/apple-releases?${params.toString()}`);
+  return adminApiPost(`/api/admin/backfill/label-releases?${params.toString()}`);
 }
 async function backfillRecordingMbidsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
@@ -9679,9 +9679,9 @@ function addAdminCommands(program2) {
     const { backfillAppleCatalogueCommand: backfillAppleCatalogueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2);
   });
-  backfill.command("apple-releases").description("Tap Apple's latest releases for enabled seed labels into catalogue rows").option("--dry-run", "Report the labels that would be probed without any Apple call", false).option("--limit <limit>", "Max enabled seed labels to probe per pass", "5").option("--json", "Print JSON", false).action(async (options) => {
-    const { backfillAppleReleasesCommand: backfillAppleReleasesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
-    await runBackfillAppleReleases(options, backfillAppleReleasesCommand2);
+  backfill.command("label-releases").description("Tap Spotify's fresh releases for enabled seed labels into catalogue rows").option("--dry-run", "Report the labels that would be probed without any Spotify call", false).option("--limit <limit>", "Max enabled seed labels to probe per pass", "5").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillLabelReleasesCommand: backfillLabelReleasesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillLabelReleases(options, backfillLabelReleasesCommand2);
   });
   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));
@@ -10376,42 +10376,43 @@ async function runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2
     process.exitCode = 1;
   }
 }
-async function runBackfillAppleReleases(options, backfillAppleReleasesCommand2) {
+async function runBackfillLabelReleases(options, backfillLabelReleasesCommand2) {
   const perPass = parseListLimit(options.limit);
   const newTrackIds = [];
-  const resolvedLabels = [];
-  const unresolvedLabels = [];
+  const labelSlugs = [];
+  const failedLabels = [];
   let dryRun = options.dryRun;
   let throttled = false;
-  let breakerTripped = false;
   let configured = true;
   let labelsProbed = 0;
   let albumsSeen = 0;
+  let albumsMatched = 0;
   let newRows = 0;
   let skippedKnown = 0;
+  let failedFetches = 0;
+  let fetchCeilingHit = false;
   const MAX_PASSES = 100;
   for (let pass = 0;pass < MAX_PASSES; pass += 1) {
-    const result = await backfillAppleReleasesCommand2(perPass, options.dryRun);
+    const result = await backfillLabelReleasesCommand2(perPass, options.dryRun);
     dryRun = result.dryRun;
     configured = result.configured;
     labelsProbed += result.labelsProbed;
     albumsSeen += result.albumsSeen;
+    albumsMatched += result.albumsMatched;
     newRows += result.newRows;
     skippedKnown += result.skippedKnown;
+    failedFetches += result.failedFetches;
+    fetchCeilingHit = fetchCeilingHit || result.fetchCeilingHit;
     newTrackIds.push(...result.newTrackIds);
-    resolvedLabels.push(...result.resolvedLabels);
-    unresolvedLabels.push(...result.unresolvedLabels);
+    labelSlugs.push(...result.labelSlugs);
+    failedLabels.push(...result.failedLabels);
     if (!options.json) {
       const verb2 = result.dryRun ? "would probe" : "probed";
-      console.log(`  \u2026${verb2} ${result.dryRun ? result.resolvedLabels.length : result.labelsProbed} label(s); ${result.newRows} new; ${result.skippedKnown} known; ${result.unresolvedLabels.length} unresolved`);
+      console.log(`  \u2026${verb2} ${result.labelSlugs.length} label(s); ${result.albumsMatched} matched album(s); ${result.newRows} new; ${result.skippedKnown} known; ${result.failedFetches} fetch-fail; ${result.failedLabels.length} search-fail`);
     }
     if (!result.configured) {
       break;
     }
-    if (result.breakerTripped) {
-      breakerTripped = true;
-      break;
-    }
     if (result.rateLimited) {
       throttled = true;
       break;
@@ -10419,35 +10420,40 @@ async function runBackfillAppleReleases(options, backfillAppleReleasesCommand2)
     if (result.dryRun) {
       break;
     }
-    if (result.labelsProbed === 0 && result.resolvedLabels.length === 0) {
+    if (result.labelsProbed === 0) {
       break;
     }
   }
   if (options.json) {
     printSweepJson({
+      albumsMatched,
       albumsSeen,
-      breakerTripped,
       configured,
       dryRun,
+      failedFetches,
+      failedLabels,
+      fetchCeilingHit,
+      labelSlugs,
       labelsProbed,
       newRows,
       newTrackIds,
       rateLimited: throttled,
-      resolvedLabels,
-      skippedKnown,
-      unresolvedLabels
+      skippedKnown
     }, 0);
     return;
   }
   if (!configured) {
-    console.log("Apple releases tap is not configured (the Worker's MusicKit secrets are unset) \u2014 nothing probed.");
+    console.log("Label-releases tap is a no-op \u2014 the Worker's Spotify grant is gone; reconnect Spotify.");
     return;
   }
   const verb = dryRun ? "Would probe" : "Probed";
-  const probedCount = dryRun ? resolvedLabels.length : labelsProbed;
-  console.log(`${verb} ${probedCount} enabled seed label(s); ${newRows} new catalogue row(s); ${skippedKnown} already known; ${resolvedLabels.length} resolved; ${unresolvedLabels.length} unresolved.`);
-  for (const slug of unresolvedLabels) {
-    console.log(`  no exact Apple label match: ${slug}`);
+  const probedCount = dryRun ? labelSlugs.length : labelsProbed;
+  console.log(`${verb} ${probedCount} enabled seed label(s); ${albumsMatched} matched album(s); ${newRows} new catalogue row(s); ${skippedKnown} already known; ${failedFetches} fetch-fail; ${failedLabels.length} search-fail.`);
+  if (fetchCeilingHit) {
+    console.log("  (a pass ended early on the single-fetch ceiling \u2014 resumes next tick)");
+  }
+  for (const slug of failedLabels) {
+    console.log(`  search error: ${slug}`);
   }
 }
 async function runBackfillArtists(options, backfillArtistsCommand2) {

package/package.json

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