fluncle 0.151.0 → 0.153.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.151.0".trim() ? "0.151.0".trim() : "0.1.0";
+  currentVersion = "0.153.0".trim() ? "0.153.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.151.0".trim() ? "0.151.0".trim() : "0.1.0";
+  currentVersion2 = "0.153.0".trim() ? "0.153.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -5784,7 +5784,7 @@ async function catalogueRankCommand(options) {
 }
 async function catalogueListCommand(options) {
   const params = new URLSearchParams;
-  params.set("lens", options.lens === "capture" ? "capture" : options.lens === "quarantine" ? "quarantine" : "ear");
+  params.set("lens", options.lens && CATALOGUE_LENSES.has(options.lens) ? options.lens : "ear");
   if (options.limit) {
     params.set("limit", options.limit);
   }
@@ -5843,8 +5843,10 @@ async function crawlCatalogueCommand(limit, maxHop, dryRun) {
 async function crawlStatusCommand() {
   return adminApiGet("/api/admin/catalogue/crawl");
 }
+var CATALOGUE_LENSES;
 var init_admin_catalogue = __esm(() => {
   init_api();
+  CATALOGUE_LENSES = new Set(["capture", "dismissed", "failed", "quarantine", "unmatched"]);
 });
 
 // src/commands/admin-reach.ts
@@ -8907,7 +8909,7 @@ function addAdminCommands(program2) {
     const { catalogueRankCommand: catalogueRankCommand2 } = await Promise.resolve().then(() => (init_admin_catalogue(), exports_admin_catalogue));
     await runCatalogueRank(options, catalogueRankCommand2);
   });
-  catalogue.command("list").description("The ranked catalogue: closest to a finding (ear), next to capture, or wrong audio").option("--lens <lens>", "ear (default), capture, or quarantine", "ear").option("--limit <limit>", "Rows (default 50, max 200)").option("--json", "Print JSON", false).action(async (options) => {
+  catalogue.command("list").description("The ranked catalogue: closest to a finding (ear), next to capture, or wrong audio").option("--lens <lens>", "ear (default), capture, quarantine, unmatched, failed, or dismissed", "ear").option("--limit <limit>", "Rows (default 50, max 200)").option("--json", "Print JSON", false).action(async (options) => {
     const { catalogueListCommand: catalogueListCommand2 } = await Promise.resolve().then(() => (init_admin_catalogue(), exports_admin_catalogue));
     await runCatalogueList(options, catalogueListCommand2);
   });
@@ -9383,6 +9385,18 @@ async function runBackfillLastfm(options, backfillLastfmCommand2) {
     process.exitCode = 1;
   }
 }
+function anchorOutcomeSuffix(outcome) {
+  switch (outcome) {
+    case "throttled":
+      return " (Spotify throttled the fill; the anchor breaker is pacing it)";
+    case "unauthorized":
+      return " (Spotify grant is gone \u2014 reconnect Spotify from /admin to resume anchoring)";
+    case "breaker_open":
+      return " (anchor fill PAUSED on its breaker; it resumes after the cooldown)";
+    default:
+      return "";
+  }
+}
 async function runCrawlCatalogue(options, crawlCatalogueCommand2) {
   const limit = parseListLimit(options.limit);
   const maxHop = Number.parseInt(options.maxHop ?? "2", 10);
@@ -9394,7 +9408,7 @@ async function runCrawlCatalogue(options, crawlCatalogueCommand2) {
   } else {
     console.log(`Expanded ${result.expanded} node(s) at hop \u2264 ${result.maxHop}: ${result.tracksFound} track(s) found, ${result.tracksWritten} written, ${result.tracksSkipped} already held.`);
     console.log(`  +${result.seeded} seed(s), +${result.nodesEnqueued} node(s) enqueued, ${result.frontierPending} pending, ${result.failed} failed.`);
-    console.log(`  ${result.anchorsFilled} Spotify anchor(s) filled.`);
+    console.log(`  ${result.anchorsFilled} Spotify anchor(s) filled${anchorOutcomeSuffix(result.anchorOutcome)}.`);
     if (result.labelsDiscovered.length > 0) {
       console.log(`  New labels to rule on: ${result.labelsDiscovered.join(", ")} (they are NOT crawled until enabled).`);
     }
@@ -9414,6 +9428,14 @@ async function runCrawlStatus(options, crawlStatusCommand2) {
   }
   const { frontier, frontierByKind } = result;
   console.log(`Catalogue: ${result.catalogueTracks} uncertified track(s); ${result.anchorsPending} awaiting a Spotify anchor.`);
+  const { spotifyAnchor } = result;
+  if (spotifyAnchor.tripped) {
+    const mins = Math.ceil(spotifyAnchor.cooldownRemainingMs / 60000);
+    const why = spotifyAnchor.reason === "unauthorized" ? "the Spotify grant is gone \u2014 reconnect Spotify from /admin to resume anchoring" : "Spotify is throttling the app \u2014 it self-heals when the throttle lifts";
+    console.log(`  Spotify anchor PAUSED (${why}); breaker cools in ~${mins} min.`);
+  } else if (spotifyAnchor.consecutiveFailures > 0) {
+    console.log(`  Spotify anchor wobbling (${spotifyAnchor.consecutiveFailures} failing pass(es); reason: ${spotifyAnchor.reason ?? "unknown"}).`);
+  }
   console.log(`Frontier: ${frontier.pending} pending, ${frontier.done} done, ${frontier.failed} failed, ${frontier.skipped} skipped (${frontierByKind.label} label, ${frontierByKind.artist} artist, ${frontierByKind.release} release).`);
   console.log(`Seeds (${result.seedLabels.length}): ${result.seedLabels.join(", ") || "none enabled"}.`);
   console.log(`Awaiting your ruling: ${result.labelsUndecided} label(s).`);

package/package.json

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