fluncle 0.167.0 → 0.168.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.167.0".trim() ? "0.167.0".trim() : "0.1.0";
+  currentVersion = "0.168.0".trim() ? "0.168.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2229,7 +2229,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.167.0".trim() ? "0.167.0".trim() : "0.1.0";
+  currentVersion2 = "0.168.0".trim() ? "0.168.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3119,6 +3119,19 @@ var init_src = __esm(() => {
       title: "Recording MBIDs",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills label-lineage",
+      exposedContent: [
+        "resolve each label's founding date + place + parent imprint from MusicBrainz → the labels row"
+      ],
+      kind: "cron",
+      name: "cron.label-lineage",
+      operatorNotes: "every 60m, run by a rave-02 HOST systemd timer (docs/agents/hermes/label-lineage-timer/). The label entity's LINEAGE half (RFC label-lineage-remixer, U1): gives each label its founding facts + its place in the imprint hierarchy from MusicBrainz — `life-span.begin` → `founding_date`, `area.name` → `founded_location`, and the `backward` `label ownership` / `imprint` label-rels → `parent_label_id` (matched to an EXISTING label by MBID; NEVER minted — an unmatched parent is only counted). A dedicated sweep, not a rider on the label-image sweep, because that one is terminal per label and a logo-resolved label would never get its lineage: this carries its OWN `lineage_state` machine so it reaches every label once. METADATA ONLY — it certifies nothing, mints nothing, 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, reusing the shared MB client + exact-fold identity search. The `labels` row carries the durable reliability state (lineage_state/lineage_attempted_at/lineage_failures), so a resolved/none label is terminal. Emitted as the `/label/<slug>` Organization's `foundingDate` / `location` / `parentOrganization` / `subOrganization`. Zero LLM tokens. Source: docs/agents/hermes/scripts/label-lineage-sweep.*. See docs/label-entity.md.",
+      probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-label-lineage", kind: "cron" },
+      statusDescription: "resolves each label's founding and imprint",
+      title: "Label lineage",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin backfills cover-masters",
       exposedContent: [
@@ -6250,6 +6263,7 @@ __export(exports_admin_labels, {
   labelsBioQueueCommand: () => labelsBioQueueCommand,
   draftLabelBioCommand: () => draftLabelBioCommand,
   describeLabelCommand: () => describeLabelCommand,
+  backfillLabelLineageCommand: () => backfillLabelLineageCommand,
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
 async function describeLabelCommand(slug, options) {
@@ -6269,6 +6283,13 @@ async function backfillLabelImagesCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/admin/backfill/label-images?${params.toString()}`);
 }
+async function backfillLabelLineageCommand(limit, dryRun, cursor) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
+  if (cursor) {
+    params.set("cursor", cursor);
+  }
+  return adminApiPost(`/api/admin/backfill/label-lineage?${params.toString()}`);
+}
 var init_admin_labels = __esm(() => {
   init_api();
   init_admin_artists2();
@@ -9510,6 +9531,10 @@ function addAdminCommands(program2) {
     const { backfillLabelImagesCommand: backfillLabelImagesCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runBackfillLabelImages(options, backfillLabelImagesCommand2);
   });
+  backfill.command("label-lineage").description("Resolve label lineage (founding date, place, parent imprint) from MusicBrainz").option("--dry-run", "Report the eligible worklist without any vendor call or write", false).option("--limit <limit>", "Max labels to process", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillLabelLineageCommand: backfillLabelLineageCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    await runBackfillLabelLineage(options, backfillLabelLineageCommand2);
+  });
   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);
@@ -10308,6 +10333,66 @@ async function runBackfillCoverMasters(options, backfillCoverMastersCommand2) {
     process.exitCode = 1;
   }
 }
+async function runBackfillLabelLineage(options, backfillLabelLineageCommand2) {
+  const limit = parseListLimit(options.limit);
+  const resolved = [];
+  const none = [];
+  const failed = [];
+  let cursor;
+  let dryRun = options.dryRun;
+  let throttled = false;
+  let unmatchedParents = 0;
+  while (resolved.length + none.length + failed.length < limit) {
+    const remaining = limit - (resolved.length + none.length + failed.length);
+    const result = await backfillLabelLineageCommand2(remaining, options.dryRun, cursor);
+    dryRun = result.dryRun;
+    resolved.push(...result.resolved);
+    none.push(...result.none);
+    failed.push(...result.failed);
+    unmatchedParents += result.unmatchedParents;
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would walk" : "walked";
+      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.noneCount} with no MusicBrainz identity; ${result.failedCount} failed; ${result.unmatchedParents} unmatched parent(s)`);
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      dryRun,
+      failed,
+      failedCount: failed.length,
+      none,
+      noneCount: none.length,
+      ok: true,
+      rateLimited: throttled,
+      resolved,
+      resolvedCount: resolved.length,
+      unmatchedParents
+    });
+    if (failed.length > 0) {
+      process.exitCode = 1;
+    }
+    return;
+  }
+  const verb = dryRun ? "Would walk" : "Walked";
+  console.log(`${verb} ${resolved.length} label lineage(s); ${none.length} with no MusicBrainz identity; ${failed.length} failed; ${unmatchedParents} unmatched parent(s).`);
+  for (const slug of resolved) {
+    console.log(`  ${slug}`);
+  }
+  for (const item of failed) {
+    console.log(`  ${item.slug}: ${item.error}`);
+  }
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+}
 async function runBackfillLabelImages(options, backfillLabelImagesCommand2) {
   const limit = parseListLimit(options.limit);
   const resolved = [];

package/package.json

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