fluncle 0.237.0 → 0.239.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.237.0".trim() ? "0.237.0".trim() : "0.1.0";
+  currentVersion = "0.239.0".trim() ? "0.239.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2335,7 +2335,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.237.0".trim() ? "0.237.0".trim() : "0.1.0";
+  currentVersion2 = "0.239.0".trim() ? "0.239.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -10415,11 +10415,12 @@ var init_admin_artifacts = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-artist-rules.ts
-var ArtistRuleVerdictSchema, ArtistRuleSourceSchema, ArtistMbidSchema, ArtistNameSchema, ArtistRuleSchema, ArtistRuleInputSchema, AddArtistRuleInputSchema, listArtistRules, addArtistRule, updateArtistRule, removeArtistRule, adminArtistRulesContract;
+var ArtistRuleVerdictSchema, LabelArtistRuleVerdictSchema, ArtistRuleSourceSchema, ArtistMbidSchema, ArtistNameSchema, ArtistRuleSchema, ArtistRuleInputSchema, AddArtistRuleInputSchema, listArtistRules, addArtistRule, updateArtistRule, removeArtistRule, adminArtistRulesContract;
 var init_admin_artist_rules = __esm(() => {
   init_dist3();
   init_zod();
-  ArtistRuleVerdictSchema = _enum(["allow", "block"]).meta({ id: "ArtistRuleVerdict" });
+  ArtistRuleVerdictSchema = _enum(["allow", "block", "unlisted"]).meta({ id: "ArtistRuleVerdict" });
+  LabelArtistRuleVerdictSchema = _enum(["allow", "block"]).meta({ id: "LabelArtistRuleVerdict" });
   ArtistRuleSourceSchema = _enum(["operator", "triage"]).meta({ id: "ArtistRuleSource" });
   ArtistMbidSchema = string2().uuid();
   ArtistNameSchema = string2().trim().min(1, "Artist name cannot be blank");
@@ -10438,10 +10439,11 @@ var init_admin_artist_rules = __esm(() => {
   ArtistRuleInputSchema = object({
     artistMbid: ArtistMbidSchema,
     artistName: ArtistNameSchema,
-    verdict: ArtistRuleVerdictSchema
+    verdict: LabelArtistRuleVerdictSchema
   }).meta({ id: "ArtistRuleInput" });
   AddArtistRuleInputSchema = ArtistRuleInputSchema.extend({
-    artistName: ArtistNameSchema.optional()
+    artistName: ArtistNameSchema.optional(),
+    verdict: ArtistRuleVerdictSchema
   }).meta({ id: "AddArtistRuleInput" });
   listArtistRules = oc.route({
     method: "GET",
@@ -11433,7 +11435,7 @@ var init_admin_bios = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-catalogue.ts
-var CatalogueLensSchema, CapturePriorityReasonSchema, CatalogueMatchSchema, CatalogueTrackItemSchema, CatalogueSummarySchema, listCatalogueTracks, rankCatalogue, recordDemand, clearWrongAudio, requeueUnmatchedCaptures, requeueAnchor, requeueIsrcRecovery, flagWrongAudio, forceCapture, certifyTrack, setTrackDismissed, CaptureVerifyItemSchema, listUnverifiedCaptures, verifyCapture, CrawlPassSchema, CrawlPhaseInitializationSchema, MAX_CRAWL_PREPARE_LIMIT = 6, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, getCrawlStatus, ANCHOR_CANDIDATE_LIMIT = 100, ANCHOR_ARTIST_LIMIT = 20, ANCHOR_TEXT_MAX = 300, ANCHOR_ISRC_MAX = 64, ANCHOR_ID_MAX = 64, ANCHOR_URL_MAX = 2048, AnchorCandidateSchema, anchorTrack, DEEZER_CANDIDATE_LIMIT = 5, DEEZER_TEXT_MAX = 300, DEEZER_ISRC_MAX = 64, DEEZER_TRACK_ID_MAX = 32, DeezerIsrcCandidateSchema, resolveAnchor, resolveAnchorReview, setAnchorSearch, setAnchorApify, CaptureBudgetStateSchema, getCaptureBudget, setCaptureBudget, SpotifyAnchorBreakerStateSchema, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
+var CatalogueLensSchema, CapturePriorityReasonSchema, CatalogueMatchSchema, CatalogueTrackItemSchema, CatalogueSummarySchema, listCatalogueTracks, rankCatalogue, recordDemand, clearWrongAudio, requeueUnmatchedCaptures, requeueAnchor, requeueIsrcRecovery, flagWrongAudio, forceCapture, certifyTrack, setTrackDismissed, CaptureVerifyItemSchema, listUnverifiedCaptures, verifyCapture, CrawlPassSchema, CrawlPhaseInitializationSchema, MAX_CRAWL_PREPARE_LIMIT = 6, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, getCrawlStatus, ANCHOR_CANDIDATE_LIMIT = 100, ANCHOR_ARTIST_LIMIT = 20, ANCHOR_TEXT_MAX = 300, ANCHOR_ISRC_MAX = 64, ANCHOR_ID_MAX = 64, ANCHOR_URL_MAX = 2048, AnchorCandidateSchema, anchorTrack, DEEZER_CANDIDATE_LIMIT = 5, DEEZER_TEXT_MAX = 300, DEEZER_ISRC_MAX = 64, DEEZER_TRACK_ID_MAX = 32, DeezerIsrcCandidateSchema, resolveAnchor, resolveAnchorReview, setAnchorSearch, setAnchorApify, CaptureBudgetStateSchema, getCaptureBudget, setCaptureBudget, SpotifyAnchorBreakerStateSchema, AnchorRungFlagsSchema, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
@@ -11839,7 +11841,9 @@ var init_admin_catalogue = __esm(() => {
     source: _enum(["listenbrainz", "spotify-isrc", "spotify-search"]).nullable(),
     spotifyIsrcAsked: boolean2(),
     spotifySearchDone: boolean2(),
+    spotifySearchEnabled: boolean2(),
     spotifyThrottled: boolean2(),
+    stamped: boolean2(),
     verifiedBy: _enum(["isrc", "search", "search-subset"]).nullable()
   }));
   resolveAnchorReview = oc.route({
@@ -11908,13 +11912,17 @@ var init_admin_catalogue = __esm(() => {
     tripped: boolean2(),
     trippedAt: string2().nullable()
   }).meta({ id: "SpotifyAnchorBreakerState" });
+  AnchorRungFlagsSchema = object({
+    apifyEnabled: boolean2(),
+    spotifySearchEnabled: boolean2()
+  }).meta({ id: "AnchorRungFlags" });
   getSpotifyAnchorBreaker = oc.route({
     method: "GET",
     operationId: "getSpotifyAnchorBreaker",
     path: "/admin/catalogue/anchor/breaker",
-    summary: "The Spotify anchor-search throttle breaker: tripped, why, and how long left",
+    summary: "The Spotify anchor-search throttle breaker: tripped, why, how long left, and the rungs",
     tags: ["Admin"]
-  }).input(object({})).output(SpotifyAnchorBreakerStateSchema.extend({ ok: literal(true) }));
+  }).input(object({})).output(SpotifyAnchorBreakerStateSchema.extend({ ok: literal(true), rungs: AnchorRungFlagsSchema }));
   resetSpotifyAnchorBreaker = oc.route({
     method: "POST",
     operationId: "resetSpotifyAnchorBreaker",
@@ -18530,6 +18538,9 @@ async function requeueAnchorCommand(trackIds) {
 async function requeueIsrcRecoveryCommand(input) {
   return adminApiPost("/api/v1/admin/catalogue/isrc-recovery/requeue", input);
 }
+async function anchorBreakerCommand() {
+  return adminApiGet("/api/v1/admin/catalogue/anchor/breaker");
+}
 async function forceCaptureCommand(trackId) {
   return adminApiPost("/api/v1/admin/catalogue/force-capture", {
     trackId
@@ -18598,8 +18609,8 @@ function artistRuleInput(artistMbid, verdict, artistName) {
   if (!MBID_PATTERN.test(cleanMbid)) {
     throw new Error("Artist MBID must be a MusicBrainz artist MBID");
   }
-  if (verdict !== "allow" && verdict !== "block") {
-    throw new Error("Pass --verdict allow|block");
+  if (verdict !== "allow" && verdict !== "block" && verdict !== "unlisted") {
+    throw new Error("Pass --verdict allow|block|unlisted");
   }
   const cleanName = artistName?.trim();
   if (artistName !== undefined && !cleanName) {
@@ -21230,8 +21241,9 @@ function labelUpdateLines(label, options) {
   return lines;
 }
 var ARTIST_RULE_BOUNDARY = "Rules change what the next crawl takes. Everything already here stays.";
-function artistRuleWriteLine(prefix) {
-  return `${prefix} \u2014 ${ARTIST_RULE_BOUNDARY.replace(/^R/, "r")}`;
+var UNLISTED_RULE_BOUNDARY = "Unlisted takes the artist page down. The crawl and everything already here stay.";
+function artistRuleWriteLine(prefix, boundary = ARTIST_RULE_BOUNDARY) {
+  return `${prefix} \u2014 ${boundary.charAt(0).toLowerCase()}${boundary.slice(1)}`;
 }
 function artistRuleLines(rules) {
   if (rules.length === 0) {
@@ -22186,6 +22198,20 @@ JSON field reference:
     }
     console.log(`Re-queued ${requeued} of ${trackIds.length} row(s) \u2014 the next anchor tick picks them up at their real priority.`);
   });
+  catalogue.command("anchor-breaker").description("Why the anchor rungs are quiet: the throttle breaker, and which rungs are armed").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    const state = await anchorBreakerCommand();
+    if (options.json) {
+      printJson({ ...state, ok: true });
+      return;
+    }
+    const minutes = Math.ceil(state.cooldownRemainingMs / 60000);
+    console.log(state.tripped ? `BREAKER TRIPPED \u2014 ${state.reason ?? "unknown"}, ~${minutes}m left (${state.throttlesInWindow} throttle(s) in window)` : `BREAKER CLEAR \u2014 ${state.throttlesInWindow} throttle(s) in window`);
+    console.log(`RUNGS \u2014 spotify search ${state.rungs.spotifySearchEnabled ? "ARMED" : "OFF"} \xB7 apify fallback ${state.rungs.apifyEnabled ? "ARMED" : "OFF"}`);
+    if (!state.rungs.spotifySearchEnabled && !state.rungs.apifyEnabled) {
+      console.log("No rung can conclude \u2014 ListenBrainz still runs and can win, but its miss settles nothing.");
+    }
+  });
   catalogue.command("requeue-isrc-recovery").description("Clear Deezer-empty ISRC-recovery stamps from a window (dry-run; --apply to take)").requiredOption("--since <iso>", "Inclusive lower bound on the stamp (2026-09-09)").option("--apply", "Actually clear the stamps (default is a dry-run count)", false).option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_admin_catalogue2());
     const result = await requeueIsrcRecoveryCommand({
@@ -22406,14 +22432,14 @@ JSON field reference:
     await Promise.resolve().then(() => init_admin_artists2());
     await runArtistsRank(options, rankArtistsCommand);
   });
-  artists.command("rule").description("Always or never take one MusicBrainz artist's records (operator)").argument("<artist-mbid>", "The MusicBrainz artist MBID").requiredOption("--verdict <verdict>", "The ruling: allow or block").option("--name <name>", "Artist name (optional; the server resolves it when omitted)").option("--json", "Print JSON", false).action(async (artistMbid, options) => {
+  artists.command("rule").description("Rule one MusicBrainz artist: what the crawl takes, or whether they get a page").argument("<artist-mbid>", "The MusicBrainz artist MBID").requiredOption("--verdict <verdict>", "The ruling: allow, block, or unlisted (no public artist page)").option("--name <name>", "Artist name (optional; the server resolves it when omitted)").option("--json", "Print JSON", false).action(async (artistMbid, options) => {
     await Promise.resolve().then(() => init_admin_artists2());
     const rule = await addArtistRuleCommand(artistRuleInput(artistMbid, options.verdict, options.name));
     if (options.json) {
       printJson({ ok: true, rule });
       return;
     }
-    console.log(artistRuleWriteLine(`Rule set for ${rule.resolvedName ?? rule.artistName}: ${rule.verdict.toUpperCase()}`));
+    console.log(artistRuleWriteLine(`Rule set for ${rule.resolvedName ?? rule.artistName}: ${rule.verdict.toUpperCase()}`, rule.verdict === "unlisted" ? UNLISTED_RULE_BOUNDARY : ARTIST_RULE_BOUNDARY));
   });
   artists.command("rules").description("List the global artist crawl rules").option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_admin_artists2());
@@ -25548,6 +25574,7 @@ if (__require.main == __require.module) {
 }
 export {
   ARTIST_RULE_BOUNDARY,
+  UNLISTED_RULE_BOUNDARY,
   artistRuleLines,
   createProgram,
   labelUpdateLines,

package/package.json

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