fluncle 0.185.0 → 0.186.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.185.0".trim() ? "0.185.0".trim() : "0.1.0";
+  currentVersion = "0.186.0".trim() ? "0.186.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2442,7 +2442,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.185.0".trim() ? "0.185.0".trim() : "0.1.0";
+  currentVersion2 = "0.186.0".trim() ? "0.186.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3457,6 +3457,19 @@ var init_src = __esm(() => {
       title: "Artist edges",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills artist-credits",
+      exposedContent: [
+        "mint identity-true artists from MusicBrainz credits for slice 0's zero-matched residual → track_artists edges"
+      ],
+      kind: "cron",
+      name: "cron.artist-credits",
+      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/artist-credits-timer/). The MB CREDIT SWEEP (RFC artist-primary-capture, slice 1b): the sibling that completes what `backfill_artist_edges` (slice 0) could not. Slice 0's name-fold left a ~14.3k ZERO-MATCHED residual (a track it stamped but wrote no edge — no credited name folded to an existing identity), and those are exactly the tracks capture-authorization (slice 1) cannot reason about, since it matches BY IDENTITY through the `track_artists` graph. This sweep picks up that residual: for each zero-matched track carrying a MusicBrainz recording identity (`mb_recording_id`, or the `mb_<recording-mbid>` PK a crawler-born row carries), ONE paced `/recording/<mbid>?inc=artist-credits` lookup through the shared MusicBrainz client names its credited artists WITH their MB artist ids, and each resolves down a three-rung ladder: an EXACT `mbid` match, else an ADOPT (the credit name folds unambiguously onto an existing artist with no mbid — the common case, since the residual is dominated by compound credit strings like 'Sub Focus & Dimension' whose members Fluncle already holds as Spotify-keyed rows; adopting `coalesce`s the mbid onto that row instead of minting a duplicate, the split-identity guard), else a MINT of a fresh identity-true row (`mintArtistByMbid` — a real MBID is identity, the licence slice 0 lacked). Fail-closed on any ambiguity (a shared fold, or a fold whose row carries a different mbid) → mint, never a wrong merge. Then the `track_artists` edges are written. A zero-matched track with NO MB identity is TERMINALLY SKIPPED (stamped, never retried). METADATA / GRAPH IDENTITY ONLY — it certifies nothing and publishes nothing (agent tier, the `backfill_recording_mbids` precedent). Worker-paced (the box holds no MusicBrainz budget): a SMALL bounded batch per tick (each row is one ~1.1s MB call), 1 req/s, circuit-broken on a throttle, with a 60s response budget that pauses mid-page and resumes on the next request. The `tracks` row carries the durable per-row reliability state — its OWN `artist_credits_backfilled_at` stamp, DISTINCT from slice 0's `artist_edges_backfilled_at` (never disturbed). The ~14.3k residual drains at ~40/tick over ~a day and a half. Zero LLM tokens. Source: docs/agents/hermes/scripts/artist-credits-sweep.*. See docs/artist-relationship.md.",
+      probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-artist-credits", kind: "cron" },
+      statusDescription: "mints artists from MusicBrainz credits for the residual",
+      title: "Artist credits",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin backfills label-lineage",
       exposedContent: [
@@ -4382,6 +4395,7 @@ __export(exports_admin_tracks, {
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillArtistEdgesCommand: () => backfillArtistEdgesCommand,
+  backfillArtistCreditsCommand: () => backfillArtistCreditsCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
 });
@@ -4581,6 +4595,13 @@ async function backfillArtistEdgesCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/admin/backfill/artist-edges?${params.toString()}`);
 }
+async function backfillArtistCreditsCommand(limit, dryRun, cursor) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
+  if (cursor) {
+    params.set("cursor", cursor);
+  }
+  return adminApiPost(`/api/admin/backfill/artist-credits?${params.toString()}`);
+}
 async function vehiclesCommand(limit) {
   const tracks = await fetchAdminTracks({ hasVideo: true, max: limit, order: "desc" });
   return tracks.map((track) => ({
@@ -10014,6 +10035,10 @@ function addAdminCommands(program2) {
     const { backfillArtistEdgesCommand: backfillArtistEdgesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillArtistEdges(options, backfillArtistEdgesCommand2);
   });
+  backfill.command("artist-credits").description("Mint identity-true artists from MusicBrainz credits for the zero-matched residual").option("--dry-run", "Report the eligible worklist without any vendor call or write", false).option("--limit <limit>", "Max worklist rows to visit", "40").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillArtistCreditsCommand: backfillArtistCreditsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillArtistCredits(options, backfillArtistCreditsCommand2);
+  });
   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("--retry-none", "First re-queue a bounded batch of terminal none rows to pending, then run the pass", 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);
@@ -11061,6 +11086,57 @@ async function runBackfillArtistEdges(options, backfillArtistEdgesCommand2) {
   const verb = dryRun ? "Would write" : "Wrote";
   console.log(`${verb} ${edgesWritten} track_artists edge(s) over ${scanned} track(s): ${fullyMatched.length} fully matched, ${partiallyMatched.length} partially, ${zeroMatched.length} with none; ${unmatchedNames} credited name(s) left unmatched.`);
 }
+async function runBackfillArtistCredits(options, backfillArtistCreditsCommand2) {
+  const limit = parseListLimit(options.limit) ?? 40;
+  let cursor;
+  let dryRun = options.dryRun;
+  let scanned = 0;
+  let mintedArtists = 0;
+  let matchedArtists = 0;
+  let adoptedArtists = 0;
+  let edgesWritten = 0;
+  let skippedNoIdentity = 0;
+  let throttled = false;
+  while (scanned < limit) {
+    const remaining = limit - scanned;
+    const result = await backfillArtistCreditsCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    scanned += result.scanned;
+    mintedArtists += result.mintedArtists;
+    matchedArtists += result.matchedArtists;
+    adoptedArtists += result.adoptedArtists;
+    edgesWritten += result.edgesWritten;
+    skippedNoIdentity += result.skippedNoIdentity;
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would visit" : "visited";
+      console.log(`  \u2026${verb2} ${result.scanned}; minted ${result.mintedArtists}, adopted ${result.adoptedArtists}, matched ${result.matchedArtists} artist(s); wrote ${result.edgesWritten} edge(s); ${result.skippedNoIdentity} without a MusicBrainz identity`);
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      adoptedArtists,
+      dryRun,
+      edgesWritten,
+      matchedArtists,
+      mintedArtists,
+      ok: true,
+      rateLimited: throttled,
+      scanned,
+      skippedNoIdentity
+    });
+    return;
+  }
+  const verb = dryRun ? "Would visit" : "Visited";
+  console.log(`${verb} ${scanned} track(s): minted ${mintedArtists}, adopted ${adoptedArtists}, matched ${matchedArtists} artist(s); wrote ${edgesWritten} track_artists edge(s); ${skippedNoIdentity} carried no MusicBrainz identity.`);
+}
 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.185.0"
+  "version": "0.186.0"
 }