fluncle 0.242.0 → 0.244.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.242.0".trim() ? "0.242.0".trim() : "0.1.0";
+  currentVersion = "0.244.0".trim() ? "0.244.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.242.0".trim() ? "0.242.0".trim() : "0.1.0";
+  currentVersion2 = "0.244.0".trim() ? "0.244.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3909,7 +3909,7 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin projections get --json; fluncle admin projections advance --target <track_due_work|crawl_due_work> --action repair --limit 500 --max-steps 20 --no-terminal-status --json; fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps 4 --no-terminal-status --json",
+      command: "fluncle admin projections get --json; fluncle admin projections advance --target <track_due_work|crawl_due_work> --action repair --limit 500 --max-steps <adaptive> --no-terminal-status --json; fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps <adaptive> --no-terminal-status --json",
       exposedContent: [
         "keep all four runtime projection families converged after their cutovers with one-read, serial, bounded repair (--no-agent)"
       ],
@@ -11435,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, CrawlFetchPlanSchema, SuppliedCrawlBodySchema, MAX_CRAWL_COMMIT_BATCH, CRAWL_COMMIT_TOKEN_MAX_BYTES, CRAWL_COMMIT_BATCH_MAX_TOTAL_BYTES, CrawlCommitItemSchema, CrawlCommitReceiptSchema, CrawlPhaseCapabilitiesSchema, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, commitCrawlNodes, 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 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, CrawlFetchPlanSchema, SuppliedCrawlBodySchema, MAX_CRAWL_COMMIT_BATCH, CRAWL_COMMIT_TOKEN_MAX_BYTES, CRAWL_COMMIT_BATCH_MAX_TOTAL_BYTES, CrawlCommitItemSchema, CrawlCommitReceiptSchema, CrawlPhaseCapabilitiesSchema, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, commitCrawlNodes, 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, AnchorApifyBudgetSchema, getAnchorApifyBudget, setAnchorApifyBudget, SpotifyAnchorBreakerStateSchema, AnchorRungFlagsSchema, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
@@ -11896,7 +11896,10 @@ var init_admin_catalogue = __esm(() => {
     trackId: string2().min(1)
   })).output(object({
     anchored: boolean2(),
+    apifyBudgetRemaining: number2().int().nonnegative(),
+    apifyEligible: boolean2(),
     apifyEnabled: boolean2(),
+    apifyIneligibleReason: _enum(["apify_budget_spent", "awaiting_free_ask"]).nullable(),
     freeDurationMsOmitted: number2().int().nonnegative(),
     isrcRecoveredByDeezer: boolean2(),
     listenbrainzOutcome: _enum([
@@ -11978,6 +11981,27 @@ var init_admin_catalogue = __esm(() => {
     dailyTracks: number2().int().min(0).optional(),
     paused: boolean2().optional()
   })).output(CaptureBudgetStateSchema.extend({ ok: literal(true) }));
+  AnchorApifyBudgetSchema = object({
+    dailyRows: number2(),
+    day: string2(),
+    remainingRows: number2(),
+    rowsSent: number2(),
+    spent: boolean2()
+  }).meta({ id: "AnchorApifyBudget" });
+  getAnchorApifyBudget = oc.route({
+    method: "GET",
+    operationId: "getAnchorApifyBudget",
+    path: "/admin/catalogue/anchor/apify-budget",
+    summary: "The metered Apify anchor rung's daily row cap, today's spend, and what is left",
+    tags: ["Admin"]
+  }).input(object({})).output(AnchorApifyBudgetSchema.extend({ ok: literal(true) }));
+  setAnchorApifyBudget = oc.route({
+    method: "PUT",
+    operationId: "setAnchorApifyBudget",
+    path: "/admin/catalogue/anchor/apify-budget",
+    summary: "Set the metered Apify anchor rung's daily row cap (operator)",
+    tags: ["Admin"]
+  }).input(object({ dailyRows: number2().int().min(0) })).output(AnchorApifyBudgetSchema.extend({ ok: literal(true) }));
   SpotifyAnchorBreakerStateSchema = object({
     cooldownRemainingMs: number2(),
     reason: string2().nullable(),
@@ -11986,6 +12010,7 @@ var init_admin_catalogue = __esm(() => {
     trippedAt: string2().nullable()
   }).meta({ id: "SpotifyAnchorBreakerState" });
   AnchorRungFlagsSchema = object({
+    apifyBudget: AnchorApifyBudgetSchema,
     apifyEnabled: boolean2(),
     spotifySearchEnabled: boolean2()
   }).meta({ id: "AnchorRungFlags" });
@@ -12024,6 +12049,7 @@ var init_admin_catalogue = __esm(() => {
     crawl_catalogue: crawlCatalogue,
     flag_wrong_audio: flagWrongAudio,
     force_capture: forceCapture,
+    get_anchor_apify_budget: getAnchorApifyBudget,
     get_capture_budget: getCaptureBudget,
     get_crawl_status: getCrawlStatus,
     get_spotify_anchor_breaker: getSpotifyAnchorBreaker,
@@ -12039,6 +12065,7 @@ var init_admin_catalogue = __esm(() => {
     resolve_anchor: resolveAnchor,
     resolve_anchor_review: resolveAnchorReview,
     set_anchor_apify: setAnchorApify,
+    set_anchor_apify_budget: setAnchorApifyBudget,
     set_anchor_search: setAnchorSearch,
     set_capture_budget: setCaptureBudget,
     set_track_dismissed: setTrackDismissed,
@@ -15167,11 +15194,13 @@ var init_admin_tracks = __esm(() => {
     tags: ["Admin"]
   }).input(object({
     count: string2().optional(),
+    debtAware: string2().optional(),
     kind: TrackWorkKindSchema,
     limit: number3().int().min(1).max(250).default(50),
     scope: TrackWorkScopeSchema.default("all")
   })).output(object({
     capabilities: TrackWorkCapabilitiesSchema.optional(),
+    debtPending: boolean2().optional(),
     ok: literal(true),
     queued: number2().optional(),
     tracks: array(TrackWorkItemSchema)
@@ -17183,9 +17212,14 @@ async function trackWorkCommand(options) {
   });
   if (options.count) {
     params.set("count", "true");
+    params.set("debtAware", "true");
   }
   const response = await adminApiGet(`/api/v1/admin/tracks/work?${params.toString()}`);
-  return { queued: response.queued, tracks: response.tracks ?? [] };
+  return {
+    debtPending: response.debtPending,
+    queued: response.queued,
+    tracks: response.tracks ?? []
+  };
 }
 async function requeueAnalysisCommand(options) {
   const findings = await fetchAdminTracks({ max: options.max, order: "asc" });
@@ -18735,6 +18769,12 @@ async function requeueAnchorCommand(trackIds) {
 async function requeueIsrcRecoveryCommand(input) {
   return adminApiPost("/api/v1/admin/catalogue/isrc-recovery/requeue", input);
 }
+async function anchorApifyBudgetCommand() {
+  return adminApiGet("/api/v1/admin/catalogue/anchor/apify-budget");
+}
+async function setAnchorApifyBudgetCommand(dailyRows) {
+  return adminApiPut("/api/v1/admin/catalogue/anchor/apify-budget", { dailyRows });
+}
 async function anchorBreakerCommand() {
   return adminApiGet("/api/v1/admin/catalogue/anchor/breaker");
 }
@@ -22420,10 +22460,24 @@ JSON field reference:
     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"}`);
+    const budget = state.rungs.apifyBudget;
+    console.log(`APIFY BUDGET \u2014 ${budget.rowsSent}/${budget.dailyRows} rows today \xB7 ${budget.remainingRows} left${budget.spent ? " \xB7 SPENT" : ""}`);
     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.");
     }
   });
+  const anchorApifyBudget = catalogue.command("anchor-apify-budget").description("The paid Apify anchor rung's daily row cap, today's spend, and what is left").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    printAnchorApifyBudget(await anchorApifyBudgetCommand(), options);
+  });
+  anchorApifyBudget.command("set").description("Set the paid Apify anchor rung's daily row cap (operator)").requiredOption("--rows <n>", "Max catalogue rows sent to the Apify actor per UTC day").option("--json", "Print JSON", false).action(async (options) => {
+    const dailyRows = Number(options.rows);
+    if (!Number.isInteger(dailyRows) || dailyRows < 0) {
+      throw new Error("--rows must be a non-negative whole number of rows");
+    }
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    printAnchorApifyBudget(await setAnchorApifyBudgetCommand(dailyRows), options);
+  });
   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({
@@ -24472,6 +24526,15 @@ async function runPublishAdvance(options, publishAdvanceCommand) {
     console.log(`Failed ${failure.platform} for ${failure.trackId} \u2014 left for the operator.`);
   }
 }
+function printAnchorApifyBudget(state, options) {
+  if (options.json) {
+    printJson({ ...state, ok: true });
+    return;
+  }
+  console.log(state.spent ? `APIFY ROWS SPENT for ${state.day} \u2014 the paid anchor rung sends nothing more today.` : `APIFY ROWS OPEN for ${state.day} \u2014 the paid anchor rung may still be sent rows.`);
+  console.log(`  Today:   ${state.rowsSent} of ${state.dailyRows} row(s)`);
+  console.log(`  Left:    ${state.remainingRows} row(s)`);
+}
 var GB = 1073741824;
 function formatGb(bytes) {
   return `${(bytes / GB).toFixed(2)} GB`;
@@ -25335,14 +25398,18 @@ async function runAdminTrackWork(options, trackWorkCommand) {
     process.exitCode = 1;
     return;
   }
-  const { queued, tracks } = await trackWorkCommand({
+  const { debtPending, queued, tracks } = await trackWorkCommand({
     count: options.count,
     kind,
     limit: parseListLimit(options.limit),
     scope
   });
   if (options.json) {
-    printJson({ ok: true, queued, tracks });
+    printJson({ debtPending, ok: true, queued, tracks });
+    return;
+  }
+  if (debtPending === true) {
+    console.log(`${queued ?? 0} queued to ${kind} (${scope}) \u2014 page held back, due-work repair is still converging.`);
     return;
   }
   if (tracks.length === 0) {
@@ -25720,6 +25787,7 @@ var stringOptions = new Set([
   "--reasoning",
   "--recorded-at",
   "--recording",
+  "--rows",
   "--rules-file",
   "--render",
   "--scene",

package/package.json

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