fluncle 0.214.0 → 0.216.0

package/bin/fluncle.mjs

@@ -610,7 +610,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.214.0".trim() ? "0.214.0".trim() : "0.1.0";
+  currentVersion = "0.216.0".trim() ? "0.216.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2452,7 +2452,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.214.0".trim() ? "0.214.0".trim() : "0.1.0";
+  currentVersion2 = "0.216.0".trim() ? "0.216.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3550,6 +3550,22 @@ var init_src = __esm(() => {
       title: "Spotify anchors",
       weights: { status: "hidden" }
     },
+    {
+      exposedContent: [
+        "mirror the anchored, explicitly allowlisted public catalogue into the shared read-only device replica"
+      ],
+      kind: "cron",
+      name: "cron.device-mirror",
+      operatorNotes: "hourly, run by a host systemd timer (docs/agents/hermes/device-mirror-timer/). Reads one consistent anchored-cut snapshot through a read-only source credential, diffs every whitelisted tuple against the shared device database, then applies dependent-first deletes and parent-first upserts in bounded parameterized batches. The target is mutated IN PLACE: rebuilding it would reset the libSQL replication log and force every device to bootstrap the full database again. A schema-version mismatch stops for an operator migration; the content fingerprint and derived timestamp update only after a verified zero-drift tick. Zero LLM tokens. Source: docs/agents/hermes/scripts/device-mirror.*. See docs/planning/offline-first-mobile-research.md.",
+      probeConfig: {
+        cadenceMs: 60 * MINUTE_MS,
+        cronName: "fluncle-device-mirror",
+        kind: "cron"
+      },
+      statusDescription: "keeps the offline catalogue replica in step",
+      title: "Device catalogue mirror",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin frontier refresh",
       exposedContent: [
@@ -3781,9 +3797,9 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin backfills discogs && fluncle admin backfills lastfm && fluncle admin backfills apple-music && fluncle admin backfills apple-catalogue",
+      command: "fluncle admin backfills discogs && fluncle admin backfills lastfm && fluncle admin backfills apple-music && fluncle admin backfills apple-catalogue && fluncle admin backfills beatport && fluncle admin backfills discogs-facts",
       exposedContent: [
-        "Discogs id + Last.fm love + Apple Music link repair, findings then catalogue (--no-agent, Worker HTTP)"
+        "Discogs id + Last.fm love + Apple Music link + Beatport link repair, findings then catalogue, then each record's catalogue number (--no-agent, Worker HTTP)"
       ],
       kind: "cron",
       name: "cron.backfill",
@@ -4712,6 +4728,7 @@ __export(exports_admin_tracks, {
   captureQueueCommand: () => captureQueueCommand,
   backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
+  backfillDiscogsFactsCommand: () => backfillDiscogsFactsCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillBeatportCommand: () => backfillBeatportCommand,
   backfillArtistEdgesCommand: () => backfillArtistEdgesCommand,
@@ -4897,6 +4914,10 @@ async function backfillAppleMusicCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/v1/admin/backfill/apple-music?${params.toString()}`);
 }
+async function backfillDiscogsFactsCommand(limit, dryRun) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
+  return adminApiPost(`/api/v1/admin/backfill/discogs-facts?${params.toString()}`);
+}
 async function backfillBeatportCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -10470,6 +10491,10 @@ JSON field reference:
     const { backfillDiscogsCommand: backfillDiscogsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillDiscogs(options, backfillDiscogsCommand2);
   });
+  backfill.command("discogs-facts").description("Read album catalogue numbers + styles from already-resolved Discogs releases").option("--dry-run", "Report the eligible albums without reading Discogs or writing", false).option("--limit <limit>", "Max albums to read", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { backfillDiscogsFactsCommand: backfillDiscogsFactsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runBackfillDiscogsFacts(options, backfillDiscogsFactsCommand2);
+  });
   backfill.command("apple-music").description("Resolve missing Apple Music URLs for published findings (exact ISRC match)").option("--dry-run", "Report the eligible set without resolving or writing", false).option("--limit <limit>", "Max findings to resolve", "50").option("--json", "Print JSON", false).action(async (options) => {
     const { backfillAppleMusicCommand: backfillAppleMusicCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillAppleMusic(options, backfillAppleMusicCommand2);
@@ -11267,6 +11292,63 @@ async function runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2
     process.exitCode = 1;
   }
 }
+async function runBackfillDiscogsFacts(options, backfillDiscogsFactsCommand2) {
+  const limit = parseListLimit(options.limit);
+  const resolved = [];
+  const none = [];
+  const failed = [];
+  let dryRun = options.dryRun;
+  let throttled = false;
+  let configured = true;
+  while (resolved.length + none.length + failed.length < limit) {
+    const remaining = limit - (resolved.length + none.length + failed.length);
+    const result = await backfillDiscogsFactsCommand2(remaining, options.dryRun);
+    dryRun = result.dryRun;
+    configured = result.configured;
+    resolved.push(...result.resolved);
+    none.push(...result.none);
+    failed.push(...result.failed);
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would read" : "read";
+      console.log(`  \u2026${verb2} ${result.resolvedCount} catalogue number(s); ${result.noneCount} with none; ${result.failedCount} failed`);
+    }
+    if (!result.configured) {
+      break;
+    }
+    if (result.rateLimited) {
+      throttled = true;
+      break;
+    }
+    if (result.resolvedCount === 0 && result.noneCount === 0 && result.failedCount === 0) {
+      break;
+    }
+  }
+  if (options.json) {
+    printSweepJson({
+      configured,
+      dryRun,
+      failed,
+      none,
+      noneCount: none.length,
+      rateLimited: throttled,
+      resolved,
+      resolvedCount: resolved.length
+    }, failed.length);
+    return;
+  }
+  if (!configured) {
+    console.log("Discogs facts backfill is not configured (the Worker's DISCOGS_USER_TOKEN is unset) \u2014 nothing read.");
+    return;
+  }
+  const verb = dryRun ? "Would read" : "Read";
+  console.log(`${verb} ${resolved.length} catalogue number(s); ${none.length} release(s) carry none; ${failed.length} failed.`);
+  for (const item of failed) {
+    console.log(`  ${item.slug}: ${item.error}`);
+  }
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+}
 async function runBackfillArtists(options, backfillArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const upserted = [];
@@ -11608,6 +11690,7 @@ async function runBackfillArtistEdges(options, backfillArtistEdgesCommand2) {
   let cursor;
   let dryRun = options.dryRun;
   let edgesWritten = 0;
+  let queueDepth = 0;
   let scanned = 0;
   let unmatchedNames = 0;
   while (scanned < limit) {
@@ -11620,6 +11703,7 @@ async function runBackfillArtistEdges(options, backfillArtistEdgesCommand2) {
     fullyMatched.push(...result.fullyMatched);
     partiallyMatched.push(...result.partiallyMatched);
     zeroMatched.push(...result.zeroMatched);
+    queueDepth = result.queueDepth;
     if (!options.json) {
       const verb2 = result.dryRun ? "would write" : "wrote";
       console.log(`  \u2026visited ${result.scanned}; ${verb2} ${result.edgesWritten} edge(s); ${result.fullyMatchedCount} full, ${result.partiallyMatchedCount} partial, ${result.zeroMatchedCount} zero; ${result.unmatchedNames} name(s) unmatched`);
@@ -11638,6 +11722,7 @@ async function runBackfillArtistEdges(options, backfillArtistEdgesCommand2) {
       ok: true,
       partiallyMatched,
       partiallyMatchedCount: partiallyMatched.length,
+      queueDepth,
       scanned,
       unmatchedNames,
       zeroMatched,

package/package.json

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