fluncle 0.162.0 → 0.164.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.162.0".trim() ? "0.162.0".trim() : "0.1.0";
+  currentVersion = "0.164.0".trim() ? "0.164.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.162.0".trim() ? "0.162.0".trim() : "0.1.0";
+  currentVersion2 = "0.164.0".trim() ? "0.164.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2513,6 +2513,18 @@ var init_src = __esm(() => {
       url: `${SITE}/api/v1/tracks/random`,
       weights: { web: "secondary" }
     },
+    {
+      apiFormat: "application/json",
+      discoveryUrl: `${SITE}/api/v1/openapi.json`,
+      exposedContent: [
+        "what just came out — newest drum & bass releases over a 30-day window, flat (limit max 100)"
+      ],
+      kind: "api",
+      name: "api.fresh",
+      route: "/api/v1/tracks/fresh",
+      url: `${SITE}/api/v1/tracks/fresh`,
+      weights: { web: "secondary" }
+    },
     {
       apiFormat: "application/json",
       discoveryUrl: `${SITE}/api/v1/openapi.json`,
@@ -3024,6 +3036,19 @@ var init_src = __esm(() => {
       title: "Label logos",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills recording-mbids",
+      exposedContent: [
+        "fill each track's canonical MusicBrainz recording MBID (crawler PK strip + ISRC resolve)"
+      ],
+      kind: "cron",
+      name: "cron.recording-mbids",
+      operatorNotes: "every 60m, run by a rave-02 HOST systemd timer (docs/agents/hermes/recording-mbids-timer/). The MusicBrainz identity layer: gives every track its canonical MusicBrainz recording MBID — the one identifier that reconciles a track to the wider open music graph (MusicBrainz, Wikidata) and the anchor the `/log` MusicRecording emits as a `sameAs` + a KG `identifier`. Two fill paths: a FREE SQL strip of crawler-born rows' PK (`mb_<recording-mbid>` → the `mb_recording_id` column, no vendor call), then an ISRC→recording resolve of the findings/Spotify-born tail through the shared MusicBrainz client (`/isrc/<isrc>`). New crawler rows already carry the MBID at mint time, so this cron catches history up + drains the ISRC tail. METADATA IDENTITY ONLY — it certifies nothing and publishes nothing (agent tier, the `backfill_label_images` precedent). Worker-paced (the box holds no MusicBrainz budget): one bounded batch per tick, 1 req/s, circuit-broken on a throttle. The `tracks` row carries the durable reliability state (`mb_recording_id` + the `mb_recording_id_attempted_at` stamp, a miss stamped so it is not re-queried forever). Zero LLM tokens. Source: docs/agents/hermes/scripts/recording-mbids-sweep.*. See docs/catalogue-crawler.md.",
+      probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-recording-mbids", kind: "cron" },
+      statusDescription: "fills each track's MusicBrainz recording id",
+      title: "Recording MBIDs",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin backfills cover-masters",
       exposedContent: [
@@ -3879,6 +3904,7 @@ __export(exports_admin_tracks, {
   embedQueueCommand: () => embedQueueCommand,
   contextQueueCommand: () => contextQueueCommand,
   captureQueueCommand: () => captureQueueCommand,
+  backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
@@ -4066,6 +4092,13 @@ 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 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()}`);
+}
 async function vehiclesCommand(limit) {
   const tracks = await fetchAdminTracks({ hasVideo: true, max: limit, order: "desc" });
   return tracks.map((track) => ({
@@ -5320,7 +5353,7 @@ import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:f
 async function logbookGapsCommand(limit) {
   const query = typeof limit === "number" ? `?limit=${encodeURIComponent(String(limit))}` : "";
   const response = await adminApiGet(`/api/admin/logbook/gaps${query}`);
-  return response.gaps;
+  return { gaps: response.gaps, spent: response.spent };
 }
 function resolveBody(options) {
   if (options.body !== undefined) {
@@ -9400,6 +9433,10 @@ function addAdminCommands(program2) {
     const { backfillLabelImagesCommand: backfillLabelImagesCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runBackfillLabelImages(options, backfillLabelImagesCommand2);
   });
+  backfill.command("recording-mbids").description("Fill MusicBrainz recording MBIDs (crawler PK strip + ISRC resolve) over tracks").option("--dry-run", "Report the eligible worklist without any vendor call or write", false).option("--limit <limit>", "Max ISRC lookups to process", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillRecordingMbidsCommand: backfillRecordingMbidsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillRecordingMbids(options, backfillRecordingMbidsCommand2);
+  });
   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("--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);
@@ -10251,6 +10288,63 @@ async function runBackfillLabelImages(options, backfillLabelImagesCommand2) {
     process.exitCode = 1;
   }
 }
+async function runBackfillRecordingMbids(options, backfillRecordingMbidsCommand2) {
+  const limit = parseListLimit(options.limit);
+  const resolved = [];
+  const missed = [];
+  const failed = [];
+  let cursor;
+  let dryRun = options.dryRun;
+  let prefixStripped = 0;
+  let throttled = false;
+  while (resolved.length + missed.length + failed.length < limit) {
+    const remaining = limit - (resolved.length + missed.length + failed.length);
+    const result = await backfillRecordingMbidsCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    prefixStripped += result.prefixStripped;
+    resolved.push(...result.resolved);
+    missed.push(...result.missed);
+    failed.push(...result.failed);
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would resolve" : "resolved";
+      console.log(`  \u2026stripped ${result.prefixStripped} from PK; ${verb2} ${result.resolvedCount} by ISRC; ${result.missedCount} not in MusicBrainz; ${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,
+      missed,
+      missedCount: missed.length,
+      ok: true,
+      prefixStripped,
+      rateLimited: throttled,
+      resolved,
+      resolvedCount: resolved.length
+    });
+    if (failed.length > 0) {
+      process.exitCode = 1;
+    }
+    return;
+  }
+  const verb = dryRun ? "Would fill" : "Filled";
+  console.log(`${verb} ${prefixStripped} recording MBID(s) from crawler PKs; ${resolved.length} by ISRC; ${missed.length} not in MusicBrainz; ${failed.length} failed.`);
+  for (const item of failed) {
+    console.log(`  ${item.trackId}: ${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);
@@ -10866,9 +10960,9 @@ async function runNewsletterList(options, newsletterListCommand2) {
 }
 async function runLogbookGaps(options, logbookGapsCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
-  const gaps = await logbookGapsCommand2(limit !== undefined && Number.isFinite(limit) ? limit : undefined);
+  const { gaps, spent } = await logbookGapsCommand2(limit !== undefined && Number.isFinite(limit) ? limit : undefined);
   if (options.json) {
-    printJson({ gaps, ok: true });
+    printJson({ gaps, ok: true, spent });
     return;
   }
   if (gaps.length === 0) {

package/package.json

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