fluncle 0.172.0 → 0.174.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.172.0".trim() ? "0.172.0".trim() : "0.1.0";
+  currentVersion = "0.174.0".trim() ? "0.174.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.172.0".trim() ? "0.172.0".trim() : "0.1.0";
+  currentVersion2 = "0.174.0".trim() ? "0.174.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2476,7 +2476,7 @@ var init_src = __esm(() => {
       ],
       kind: "web_route",
       name: "web.tracks",
-      operatorNotes: "The top-level track index — the whole archive as one browse list, findings in full voice and the catalogue rows in the unlit register (DESIGN.md). Ordered by tracks.release_date (what came out), never findings.added_at (the Found Rule), keyset-paginated over the tracks_release_date_idx btree so it stays a bounded reverse scan as the catalogue grows (lib/server/tracks-hub.ts). The filter params MIRROR the search vocabulary verbatim (yearMin/yearMax, bpmMin/bpmMax, key, label; galaxy is the one extension). The bare HUB is always indexable + in the sitemap; ANY filter param present flips it to noindex, and the canonical is always the bare /tracks. The INDEX is always-200, so it is HTTP-probeable.",
+      operatorNotes: "The top-level track index — the whole archive as one browse list, findings in full voice and the catalogue rows in the unlit register (DESIGN.md). Ordered by tracks.release_date (what came out), never findings.added_at (the Found Rule), numbered-paginated (?page=N) over the tracks_release_date_idx btree with a quiet YEAR fast lane, so a crawler with no JS walks the whole list (lib/server/tracks-hub.ts). The filter params MIRROR the search vocabulary verbatim (yearMin/yearMax, bpmMin/bpmMax, key, label; galaxy is the one extension). The bare HUB is always indexable + in the sitemap, each page self-canonical; ANY filter param present flips it to noindex, and paged bare URLs stay out of the sitemap. The INDEX is always-200, so it is HTTP-probeable.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/tracks",
       url: `${SITE}/tracks`,
@@ -3118,6 +3118,23 @@ var init_src = __esm(() => {
       title: "Track crawler",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills apple-releases",
+      exposedContent: [
+        "tap Apple Music's latest 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.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-apple-releases",
+        kind: "cron"
+      },
+      statusDescription: "taps day-one releases from the enabled labels",
+      title: "Freshness tap",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin catalogue rank",
       exposedContent: [
@@ -4093,6 +4110,7 @@ __export(exports_admin_tracks, {
   backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
+  backfillAppleReleasesCommand: () => backfillAppleReleasesCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
 });
@@ -4278,6 +4296,10 @@ 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) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
+  return adminApiPost(`/api/admin/backfill/apple-releases?${params.toString()}`);
+}
 async function backfillRecordingMbidsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -6293,6 +6315,7 @@ var init_admin_reach = __esm(() => {
 var exports_admin_artists = {};
 __export(exports_admin_artists, {
   resolveArtistCommand: () => resolveArtistCommand,
+  rankArtistsCommand: () => rankArtistsCommand,
   listArtistsCommand: () => listArtistsCommand,
   draftArtistBioCommand: () => draftArtistBioCommand,
   describeArtistCommand: () => describeArtistCommand,
@@ -6331,6 +6354,11 @@ async function listArtistsCommand(limit, cursor) {
 async function resolveArtistCommand(artistId) {
   return adminApiPost(`/api/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 } : {});
+  return { summary: response.summary };
+}
 async function backfillArtistImagesCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -9651,6 +9679,10 @@ 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("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);
@@ -9693,6 +9725,10 @@ function addAdminCommands(program2) {
     const { describeArtistCommand: describeArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runEntityDescribe("artist", slug, options, describeArtistCommand2);
   });
+  artists.command("rank").description("Run one tick of the similar-artists sweep (artist centroids + nearest neighbours)").option("--limit <limit>", "Stale artists per tick (default 100)").option("--json", "Print JSON", false).action(async (options) => {
+    const { rankArtistsCommand: rankArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    await runArtistsRank(options, rankArtistsCommand2);
+  });
   artists.command("draft-bio").description("Assemble the Worker-grounded bio prompt for an artist (the sweep's trigger)").argument("<slug>").option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
     const { draftArtistBioCommand: draftArtistBioCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runEntityBioDraft("artist", slug, options, draftArtistBioCommand2);
@@ -10340,6 +10376,80 @@ async function runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2
     process.exitCode = 1;
   }
 }
+async function runBackfillAppleReleases(options, backfillAppleReleasesCommand2) {
+  const perPass = parseListLimit(options.limit);
+  const newTrackIds = [];
+  const resolvedLabels = [];
+  const unresolvedLabels = [];
+  let dryRun = options.dryRun;
+  let throttled = false;
+  let breakerTripped = false;
+  let configured = true;
+  let labelsProbed = 0;
+  let albumsSeen = 0;
+  let newRows = 0;
+  let skippedKnown = 0;
+  const MAX_PASSES = 100;
+  for (let pass = 0;pass < MAX_PASSES; pass += 1) {
+    const result = await backfillAppleReleasesCommand2(perPass, options.dryRun);
+    dryRun = result.dryRun;
+    configured = result.configured;
+    labelsProbed += result.labelsProbed;
+    albumsSeen += result.albumsSeen;
+    newRows += result.newRows;
+    skippedKnown += result.skippedKnown;
+    newTrackIds.push(...result.newTrackIds);
+    resolvedLabels.push(...result.resolvedLabels);
+    unresolvedLabels.push(...result.unresolvedLabels);
+    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`);
+    }
+    if (!result.configured) {
+      break;
+    }
+    if (result.breakerTripped) {
+      breakerTripped = true;
+      break;
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.dryRun) {
+      break;
+    }
+    if (result.labelsProbed === 0 && result.resolvedLabels.length === 0) {
+      break;
+    }
+  }
+  if (options.json) {
+    printSweepJson({
+      albumsSeen,
+      breakerTripped,
+      configured,
+      dryRun,
+      labelsProbed,
+      newRows,
+      newTrackIds,
+      rateLimited: throttled,
+      resolvedLabels,
+      skippedKnown,
+      unresolvedLabels
+    }, 0);
+    return;
+  }
+  if (!configured) {
+    console.log("Apple releases tap is not configured (the Worker's MusicKit secrets are unset) \u2014 nothing probed.");
+    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}`);
+  }
+}
 async function runBackfillArtists(options, backfillArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const upserted = [];
@@ -11521,6 +11631,15 @@ async function runGalaxies(slug, options, commands) {
     console.log(`${galaxy.name.padEnd(40)} ${String(galaxy.memberCount).padStart(3)} finding${galaxy.memberCount === 1 ? "" : "s"}`);
   }
 }
+async function runArtistsRank(options, rankArtistsCommand2) {
+  const { summary } = await rankArtistsCommand2({ limit: options.limit });
+  if (options.json) {
+    printJson({ ok: true, summary });
+    return;
+  }
+  const removed = summary.centroidsRemoved > 0 ? ` Purged ${summary.centroidsRemoved} orphan(s).` : "";
+  console.log(`Ranked ${summary.centroidsComputed} artist(s); wrote ${summary.edgesWritten} edges.${removed} ${summary.remaining} still stale.`);
+}
 async function runCatalogueRank(options, catalogueRankCommand2) {
   const { summary, telescope } = await catalogueRankCommand2({ limit: options.limit });
   if (options.json) {

package/package.json

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