fluncle 0.178.0 → 0.180.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.178.0".trim() ? "0.178.0".trim() : "0.1.0";
+  currentVersion = "0.180.0".trim() ? "0.180.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2260,7 +2260,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.178.0".trim() ? "0.178.0".trim() : "0.1.0";
+  currentVersion2 = "0.180.0".trim() ? "0.180.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3121,13 +3121,12 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin backfills label-releases",
       exposedContent: [
-        "tap Spotify's fresh releases for the operator's enabled seed labels → day-one uncertified catalogue rows"
+        "tap day-one fresh releases for the operator's enabled seed labels → uncertified catalogue rows"
       ],
       kind: "cron",
       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`) and mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) with their real release dates — closing the /fresh lag cliff. The fuzzy `label:` search is gated on TWO signals before an album mints onto public /fresh: an album's Spotify artist must already be in our archive (`artists.spotify_artist_id` — the primary identity/genre anchor that stops cross-genre homonym junk) AND the album's ℗/© copyright must EXACTLY match the seed label (a brand-new artist's debut is skipped until the MB crawl backfills them). 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.",
+      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 mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) for each ENABLED seed label's fresh releases with their real dates — closing the /fresh lag cliff. Runs OFF the official (dev-mode) Spotify app, which is rate-limited to death at its tier and must stay for user paths: the box reads the due seed labels (`list_label_releases_work`), runs an Apify Spotify-scraper actor per label (`label:\"<name>\" tag:new`), maps each result album (inline tracks[] + ISRCs + artists[]) to a candidate, and POSTs them to the agent-tier `backfill_label_releases` op — where the WORKER re-runs the FULL gate (the box's verdict is never trusted) and mints. The gate: artist-grounding (an album's Spotify artist already in `artists.spotify_artist_id` — the PRIMARY anchor that stops cross-genre homonym junk, always required) AND, when the actor gives a label signal (album_label/copyright — both null in albums-search mode, so grounding-only there), an exact fold-match to the seed name. It certifies nothing, publishes nothing, 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). Reuses the anchor sweep's APIFY_API_TOKEN (no new secret). Calls the oRPC HTTP endpoints directly (no CLI command the pinned box CLI would lack). Zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-label-releases",
@@ -3169,13 +3168,13 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.frontier-refresh",
-      operatorNotes: "weekly (Fri 07:00 Amsterdam), run by a rave-02 HOST systemd timer (docs/agents/hermes/frontier-refresh-timer/). E2, the public recommendation machine: every verified user can mint ONE public 'Fluncle's Frontier' playlist on Fluncle's OWN Spotify account (no per-user OAuth), holding THEIR recommendations (the E1 blend); this cron is the Discover-Weekly-style refresh that keeps each one current. The walk + the Spotify item replaces all happen inside the Worker; the sweep just fires one `fluncle admin frontier refresh`. It respects the DEFAULT-DENY `frontier.minting` kill switch (a closed switch touches nothing), skips playlists whose recommendation set is unchanged (a per-row URI-hash mirror guard), and creates no new public authority — every playlist it touches already exists, minted by its own owner. `refresh_frontier_playlists` is AGENT tier, so the box's existing agent-scoped token drives it: NO new secret. Zero LLM tokens. Source: docs/agents/hermes/scripts/frontier-refresh-sweep.*. See docs/the-ear.md § Fluncle's Frontier.",
+      operatorNotes: "every ~15 min, run by a rave-02 HOST systemd timer (docs/agents/hermes/frontier-refresh-timer/). E2, the public recommendation machine: every verified user can mint ONE public 'Fluncle's Frontier' playlist on Fluncle's OWN Spotify account (no per-user OAuth), holding THEIR recommendations (the E1 blend); this cron keeps each one current. It is a PACED, RESUMABLE DRAIN, not a weekly burst: each tick fires one `fluncle admin frontier refresh` that processes only a small BATCH of DUE users inside the Worker (pending mints first, then users whose per-user cursor is older than ~6 days), so the whole crew refreshes ~weekly SPREAD across the day instead of one 07:00 pass that collided with Spotify's shared per-app budget and 429'd live user paths. It consults the shared Spotify budget and stops cleanly when the window is spent (`budgetPaused`), respects the DEFAULT-DENY `frontier.minting` kill switch (a closed switch touches nothing on Spotify), skips playlists whose recommendation set is unchanged (a per-row URI-hash mirror guard), and creates no new public authority — every playlist it touches already exists, minted by its own owner. `refresh_frontier_playlists` is AGENT tier, so the box's existing agent-scoped token drives it: NO new secret. Zero LLM tokens. Source: docs/agents/hermes/scripts/frontier-refresh-sweep.*. See docs/the-ear.md § Fluncle's Frontier.",
       probeConfig: {
-        cadenceMs: 7 * 24 * 60 * MINUTE_MS,
+        cadenceMs: 15 * MINUTE_MS,
         cronName: "fluncle-frontier-refresh",
         kind: "cron"
       },
-      statusDescription: "refreshes every crew member's Frontier playlist",
+      statusDescription: "refreshes the crew's Frontier playlists, paced",
       title: "Frontier refresh",
       weights: { status: "hidden" }
     },
@@ -4128,7 +4127,6 @@ __export(exports_admin_tracks, {
   captureQueueCommand: () => captureQueueCommand,
   backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
-  backfillLabelReleasesCommand: () => backfillLabelReleasesCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
@@ -4315,10 +4313,6 @@ 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 backfillLabelReleasesCommand(limit, dryRun) {
-  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
-  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) });
   if (cursor) {
@@ -9698,10 +9692,6 @@ function addAdminCommands(program2) {
     const { backfillAppleCatalogueCommand: backfillAppleCatalogueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2);
   });
-  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));
     await runBackfillArtists(options, backfillArtistsCommand2);
@@ -10395,89 +10385,6 @@ async function runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2
     process.exitCode = 1;
   }
 }
-async function runBackfillLabelReleases(options, backfillLabelReleasesCommand2) {
-  const perPass = parseListLimit(options.limit);
-  const newTrackIds = [];
-  const labelSlugs = [];
-  const failedLabels = [];
-  let dryRun = options.dryRun;
-  let throttled = false;
-  let configured = true;
-  let labelsProbed = 0;
-  let albumsSeen = 0;
-  let albumsMatched = 0;
-  let newRows = 0;
-  let skippedKnown = 0;
-  let skippedUngrounded = 0;
-  let failedFetches = 0;
-  let fetchCeilingHit = false;
-  const MAX_PASSES = 100;
-  for (let pass = 0;pass < MAX_PASSES; pass += 1) {
-    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;
-    skippedUngrounded += result.skippedUngrounded;
-    failedFetches += result.failedFetches;
-    fetchCeilingHit = fetchCeilingHit || result.fetchCeilingHit;
-    newTrackIds.push(...result.newTrackIds);
-    labelSlugs.push(...result.labelSlugs);
-    failedLabels.push(...result.failedLabels);
-    if (!options.json) {
-      const verb2 = result.dryRun ? "would probe" : "probed";
-      console.log(`  \u2026${verb2} ${result.labelSlugs.length} label(s); ${result.albumsMatched} matched album(s); ${result.newRows} new; ${result.skippedKnown} known; ${result.skippedUngrounded} ungrounded; ${result.failedFetches} fetch-fail; ${result.failedLabels.length} search-fail`);
-    }
-    if (!result.configured) {
-      break;
-    }
-    if (result.rateLimited) {
-      throttled = true;
-      break;
-    }
-    if (result.dryRun) {
-      break;
-    }
-    if (result.labelsProbed === 0) {
-      break;
-    }
-  }
-  if (options.json) {
-    printSweepJson({
-      albumsMatched,
-      albumsSeen,
-      configured,
-      dryRun,
-      failedFetches,
-      failedLabels,
-      fetchCeilingHit,
-      labelSlugs,
-      labelsProbed,
-      newRows,
-      newTrackIds,
-      rateLimited: throttled,
-      skippedKnown,
-      skippedUngrounded
-    }, 0);
-    return;
-  }
-  if (!configured) {
-    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 ? labelSlugs.length : labelsProbed;
-  console.log(`${verb} ${probedCount} enabled seed label(s); ${albumsMatched} matched album(s); ${newRows} new catalogue row(s); ${skippedKnown} already known; ${skippedUngrounded} dropped for no known artist; ${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) {
   const limit = parseListLimit(options.limit);
   const upserted = [];

package/package.json

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