fluncle 0.261.0 → 0.263.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.261.0".trim() ? "0.261.0".trim() : "0.1.0";
+  currentVersion = "0.263.0".trim() ? "0.263.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.261.0".trim() ? "0.261.0".trim() : "0.1.0";
+  currentVersion2 = "0.263.0".trim() ? "0.263.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3459,12 +3459,12 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.label-releases",
-      operatorNotes: "daily at 07:20 Amsterdam, run by a Hermes host systemd timer (docs/agents/hermes/label-releases-timer/). The FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Spotify has it day one, so this mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) for each ENABLED seed label's fresh releases with their real dates — closing the /fresh lag cliff. The WORKER does all of it (`backfill_label_releases`, agent tier): it searches the official Spotify API (`label:\"<name>\" tag:new`), reads each hit as a SINGLE `GET /albums/{id}` then `GET /tracks/{id}` (the batch endpoints are 403 at our tier), and mints. The box sweep is a thin HTTP TRIGGER that POSTs bounded passes with the agent token — no vendor token, no CLI dependency (a pinned box CLI missing a flag broke an earlier run). The gate, both required: artist-grounding (an album's Spotify artist already in `artists.spotify_artist_id` — the PRIMARY anchor that stops cross-genre homonym junk) AND an EXACT fold-match of the seed name in the ℗/© copyright; an album with no release_date is dropped outright (/fresh could never show it). BUDGET: the tap shares the official app's per-app window with the user-facing paths, so it paces itself against the shared call meter and stops at a FRACTION of the window (its own ceiling) — user write paths get the window, the tap takes only slack. Hitting that ceiling ends the pass cleanly and the durable per-label cadence stamps resume it next tick. It certifies nothing, publishes nothing, never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (Spotify id/uri/ISRC + same-album title fold). No vendor spend and zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
+      operatorNotes: "every 15 minutes from 03:00 through 08:45 UTC, run by a Hermes host systemd timer (docs/agents/hermes/label-releases-timer/). The FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Spotify has it day one, so this mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) for each ENABLED seed label's fresh releases with their real dates — closing the /fresh lag cliff. The WORKER does all of it (`backfill_label_releases`, agent tier): it searches the official Spotify API (`label:\"<name>\" tag:new`), reads each hit as a SINGLE `GET /albums/{id}` then `GET /tracks/{id}` (the batch endpoints are 403 at our tier), and mints. The box sweep is a thin HTTP TRIGGER that POSTs bounded passes with the agent token — no vendor token, no CLI dependency (a pinned box CLI missing a flag broke an earlier run). The gate, both required: artist-grounding (an album's Spotify artist already in `artists.spotify_artist_id` — the PRIMARY anchor that stops cross-genre homonym junk) AND an EXACT fold-match of the seed name in the ℗/© copyright; an album with no release_date is dropped outright (/fresh could never show it). BUDGET: the tap shares the official app's per-app window with the user-facing paths, so it paces itself against the shared call meter and stops at a FRACTION of the window (its own ceiling) — user write paths get the window, the tap takes only slack. Hitting that ceiling ends the pass cleanly and the durable per-label cadence stamps resume it next tick. It certifies nothing, publishes nothing, never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (Spotify id/uri/ISRC + same-album title fold). No vendor spend and zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-label-releases",
         kind: "cron",
-        schedule: { time: "07:20", tz: "Europe/Amsterdam" }
+        schedule: { time: "03:00", tz: "UTC" }
       },
       statusDescription: "taps day-one releases from the enabled labels",
       title: "Freshness tap",
@@ -10193,7 +10193,7 @@ var init_zod = __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, CrawlPipelineSummarySchema, PipelineWatchBoundedCountSchema, getPipeline, 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, recordAnchorFailure, 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 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, CrawlPipelineSummarySchema, PipelineWatchBoundedCountSchema, getPipeline, 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, recordAnchorFailure, DEEZER_CANDIDATE_LIMIT = 5, DEEZER_TEXT_MAX = 300, DEEZER_ISRC_MAX = 64, DEEZER_TRACK_ID_MAX = 32, DeezerIsrcCandidateSchema, AnchorResolveResultSchema, AnchorCommitResultSchema, prepareAnchor, AnchorPhaseBatchItemFailureSchema, prepareAnchorBatch, resolveAnchorCandidate, commitAnchor, commitAnchorBatch, getAnchorReceipt, getAnchorPaidToken, cancelAnchorPaidResult, resolveAnchorPaidResult, resolveAnchor, resolveAnchorReview, setAnchorSearch, setAnchorApify, CaptureBudgetStateSchema, getCaptureBudget, setCaptureBudget, AnchorApifyBudgetSchema, getAnchorApifyBudget, setAnchorApifyBudget, SpotifyAnchorBreakerStateSchema, AnchorRungFlagsSchema, getSpotifyAnchorBreaker, LabelReleasesBudgetSchema, getLabelReleasesBudget, setLabelReleasesBudget, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
@@ -10320,9 +10320,12 @@ var init_admin_catalogue = __esm(() => {
     method: "POST",
     operationId: "requeueAnchor",
     path: "/admin/catalogue/anchor/requeue",
-    summary: "Clear named rows' anchor re-ask backoff or terminal validation error (operator)",
+    summary: "Requeue named anchor rows and optionally reconcile pending paid receipts (operator)",
     tags: ["Admin"]
-  }).input(object({ trackIds: array(string2().min(1)).min(1).max(250) })).output(object({ ok: literal(true), requeued: number2() }));
+  }).input(object({
+    clearPaid: boolean2().optional(),
+    trackIds: array(string2().min(1)).min(1).max(250)
+  })).output(object({ ok: literal(true), paidCleared: number2(), requeued: number2() }));
   requeueIsrcRecovery = oc.route({
     method: "POST",
     operationId: "requeueIsrcRecovery",
@@ -10660,6 +10663,7 @@ var init_admin_catalogue = __esm(() => {
     tags: ["Admin"]
   }).input(object({
     candidates: array(AnchorCandidateSchema).max(ANCHOR_CANDIDATE_LIMIT).default([]),
+    paidResultToken: string2().max(32 * 1024).optional(),
     trackId: string2().min(1)
   })).output(object({
     anchored: boolean2(),
@@ -10680,22 +10684,12 @@ var init_admin_catalogue = __esm(() => {
     isrc: string2().max(DEEZER_ISRC_MAX),
     title: string2().max(DEEZER_TEXT_MAX)
   }).meta({ id: "DeezerIsrcCandidate" });
-  resolveAnchor = oc.route({
-    method: "POST",
-    operationId: "resolveAnchor",
-    path: "/admin/catalogue/anchor/resolve",
-    summary: "Resolve a catalogue row's Spotify anchor from the free rungs (ListenBrainz + dark Spotify search)",
-    tags: ["Admin"]
-  }).input(object({
-    deezerCandidates: array(DeezerIsrcCandidateSchema).max(DEEZER_CANDIDATE_LIMIT).optional(),
-    spotifySearch: boolean2().optional(),
-    trackId: string2().min(1)
-  })).output(object({
+  AnchorResolveResultSchema = object({
     anchored: boolean2(),
     apifyBudgetRemaining: number2().int().nonnegative(),
     apifyEligible: boolean2(),
     apifyEnabled: boolean2(),
-    apifyIneligibleReason: _enum(["apify_budget_spent", "awaiting_free_ask"]).nullable(),
+    apifyIneligibleReason: _enum(["apify_budget_spent", "awaiting_free_ask", "awaiting_paid_result"]).nullable(),
     freeDurationMsOmitted: number2().int().nonnegative(),
     isrcRecoveredByDeezer: boolean2(),
     listenbrainzOutcome: _enum([
@@ -10710,6 +10704,7 @@ var init_admin_catalogue = __esm(() => {
       "yielded-on-breaker"
     ]),
     ok: literal(true),
+    paidResultToken: string2().optional(),
     source: _enum(["listenbrainz", "spotify-isrc", "spotify-search"]).nullable(),
     spotifyIsrcAsked: boolean2(),
     spotifySearchDone: boolean2(),
@@ -10717,7 +10712,140 @@ var init_admin_catalogue = __esm(() => {
     spotifyThrottled: boolean2(),
     stamped: boolean2(),
     verifiedBy: _enum(["isrc", "search", "search-subset"]).nullable()
+  });
+  AnchorCommitResultSchema = AnchorResolveResultSchema.extend({
+    paidReceiptPending: boolean2()
+  });
+  prepareAnchor = oc.route({
+    method: "POST",
+    operationId: "prepareAnchor",
+    path: "/admin/catalogue/anchor/prepare",
+    summary: "Prepare one anchor row for provider lookup",
+    tags: ["Admin"]
+  }).input(object({
+    deezerCandidates: array(DeezerIsrcCandidateSchema).max(DEEZER_CANDIDATE_LIMIT).optional(),
+    trackId: string2().min(1)
+  })).output(object({ ok: literal(true), prepared: string2(), receiptAt: string2() }));
+  AnchorPhaseBatchItemFailureSchema = object({
+    elapsedMs: number2().nonnegative(),
+    error: string2().optional(),
+    httpStatus: number2().int().optional(),
+    status: _enum(["deferred", "error"]),
+    trackId: string2()
+  });
+  prepareAnchorBatch = oc.route({
+    method: "POST",
+    operationId: "prepareAnchorBatch",
+    path: "/admin/catalogue/anchor/prepares",
+    summary: "Prepare a bounded batch of anchor rows",
+    tags: ["Admin"]
+  }).input(object({
+    items: array(object({
+      deezerCandidates: array(DeezerIsrcCandidateSchema).max(DEEZER_CANDIDATE_LIMIT).optional(),
+      trackId: string2().min(1)
+    })).min(1).max(15)
+  })).output(object({
+    items: array(union([
+      object({
+        elapsedMs: number2().nonnegative(),
+        prepared: string2(),
+        receiptAt: string2(),
+        status: literal("done"),
+        trackId: string2()
+      }),
+      AnchorPhaseBatchItemFailureSchema
+    ])),
+    ok: literal(true)
+  }));
+  resolveAnchorCandidate = oc.route({
+    method: "POST",
+    operationId: "resolveAnchorCandidate",
+    path: "/admin/catalogue/anchor/candidates/resolve",
+    summary: "Look up free anchor candidates from providers",
+    tags: ["Admin"]
+  }).input(object({ prepared: string2().max(32 * 1024), spotifySearch: boolean2().optional() })).output(object({ evidence: string2(), ok: literal(true) }));
+  commitAnchor = oc.route({
+    method: "POST",
+    operationId: "commitAnchor",
+    path: "/admin/catalogue/anchor/commit",
+    summary: "Verify provider evidence and settle one anchor row",
+    tags: ["Admin"]
+  }).input(object({
+    allowPaid: boolean2().optional(),
+    evidence: string2().max(32 * 1024),
+    prepared: string2().max(32 * 1024)
+  })).output(AnchorCommitResultSchema);
+  commitAnchorBatch = oc.route({
+    method: "POST",
+    operationId: "commitAnchorBatch",
+    path: "/admin/catalogue/anchor/commits",
+    summary: "Settle a bounded batch of anchor rows",
+    tags: ["Admin"]
+  }).input(object({
+    items: array(object({
+      allowPaid: boolean2().optional(),
+      evidence: string2().max(32 * 1024),
+      prepared: string2().max(32 * 1024),
+      trackId: string2().min(1)
+    })).min(1).max(15)
+  })).output(object({
+    items: array(union([
+      AnchorCommitResultSchema.extend({
+        elapsedMs: number2().nonnegative(),
+        status: literal("done"),
+        trackId: string2()
+      }),
+      AnchorPhaseBatchItemFailureSchema
+    ])),
+    ok: literal(true)
+  }));
+  getAnchorReceipt = oc.route({
+    method: "POST",
+    operationId: "getAnchorReceipt",
+    path: "/admin/catalogue/anchor/receipt",
+    summary: "Read exact paid admission receipt status",
+    tags: ["Admin"]
+  }).input(object({ receiptAt: string2().min(1), trackId: string2().min(1) })).output(object({
+    admitted: boolean2(),
+    ok: literal(true),
+    paidState: string2().nullable()
   }));
+  getAnchorPaidToken = oc.route({
+    method: "POST",
+    operationId: "getAnchorPaidToken",
+    path: "/admin/catalogue/anchor/paid-result/token",
+    summary: "Read a fresh token for an exact pending paid anchor receipt",
+    tags: ["Admin"]
+  }).input(object({ receiptAt: string2().min(1), trackId: string2().min(1) })).output(object({ ok: literal(true), paidResultToken: string2() }));
+  cancelAnchorPaidResult = oc.route({
+    method: "POST",
+    operationId: "cancelAnchorPaidResult",
+    path: "/admin/catalogue/anchor/paid-result/cancel",
+    summary: "Settle a paid admission when its actor never started",
+    tags: ["Admin"]
+  }).input(object({
+    paidResultToken: string2().max(32 * 1024),
+    refundCap: boolean2().optional(),
+    trackId: string2().min(1)
+  })).output(object({ ok: literal(true), settled: literal(true) }));
+  resolveAnchorPaidResult = oc.route({
+    method: "POST",
+    operationId: "resolveAnchorPaidResult",
+    path: "/admin/catalogue/anchor/paid-result/resolve",
+    summary: "Settle a paid receipt for a track no longer available to anchor",
+    tags: ["Admin"]
+  }).input(object({ receiptAt: string2().min(1), trackId: string2().min(1) })).output(object({ ok: literal(true), reason: _enum(["missing", "settled", "unavailable"]) }));
+  resolveAnchor = oc.route({
+    method: "POST",
+    operationId: "resolveAnchor",
+    path: "/admin/catalogue/anchor/resolve",
+    summary: "Resolve a catalogue row's Spotify anchor from the free rungs (ListenBrainz + dark Spotify search)",
+    tags: ["Admin"]
+  }).input(object({
+    deezerCandidates: array(DeezerIsrcCandidateSchema).max(DEEZER_CANDIDATE_LIMIT).optional(),
+    spotifySearch: boolean2().optional(),
+    trackId: string2().min(1)
+  })).output(AnchorResolveResultSchema);
   resolveAnchorReview = oc.route({
     method: "POST",
     operationId: "resolveAnchorReview",
@@ -10826,7 +10954,30 @@ var init_admin_catalogue = __esm(() => {
     path: "/admin/catalogue/anchor/breaker",
     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), rungs: AnchorRungFlagsSchema }));
+  }).input(object({})).output(SpotifyAnchorBreakerStateSchema.extend({
+    ok: literal(true),
+    rungs: AnchorRungFlagsSchema,
+    spotifyDailyCalls: number2().int().nullable()
+  }));
+  LabelReleasesBudgetSchema = object({
+    callsSpent: number2().int().nonnegative(),
+    dailyBudget: number2().int().nonnegative(),
+    spotifyDailyCalls: number2().int().nonnegative()
+  });
+  getLabelReleasesBudget = oc.route({
+    method: "GET",
+    operationId: "getLabelReleasesBudget",
+    path: "/admin/catalogue/label-releases-budget",
+    summary: "Read the label releases tap daily budget and Spotify usage",
+    tags: ["Admin"]
+  }).input(object({})).output(LabelReleasesBudgetSchema.extend({ ok: literal(true) }));
+  setLabelReleasesBudget = oc.route({
+    method: "PUT",
+    operationId: "setLabelReleasesBudget",
+    path: "/admin/catalogue/label-releases-budget",
+    summary: "Set the label releases tap daily budget (operator)",
+    tags: ["Admin"]
+  }).input(object({ dailyBudget: number2().int().min(0).max(1e6) })).output(LabelReleasesBudgetSchema.extend({ ok: literal(true) }));
   resetSpotifyAnchorBreaker = oc.route({
     method: "POST",
     operationId: "resetSpotifyAnchorBreaker",
@@ -10849,19 +11000,27 @@ var init_admin_catalogue = __esm(() => {
   }).input(object({})).output(AppleBreakerStateSchema.extend({ ok: literal(true) }));
   adminCatalogueContract = {
     anchor_track: anchorTrack,
+    cancel_anchor_paid_result: cancelAnchorPaidResult,
     certify_track: certifyTrack,
     clear_wrong_audio: clearWrongAudio,
+    commit_anchor: commitAnchor,
+    commit_anchor_batch: commitAnchorBatch,
     commit_crawl_nodes: commitCrawlNodes,
     crawl_catalogue: crawlCatalogue,
     flag_wrong_audio: flagWrongAudio,
     force_capture: forceCapture,
     get_anchor_apify_budget: getAnchorApifyBudget,
+    get_anchor_paid_token: getAnchorPaidToken,
+    get_anchor_receipt: getAnchorReceipt,
     get_capture_budget: getCaptureBudget,
     get_crawl_status: getCrawlStatus,
+    get_label_releases_budget: getLabelReleasesBudget,
     get_pipeline: getPipeline,
     get_spotify_anchor_breaker: getSpotifyAnchorBreaker,
     list_catalogue_tracks: listCatalogueTracks,
     list_unverified_captures: listUnverifiedCaptures,
+    prepare_anchor: prepareAnchor,
+    prepare_anchor_batch: prepareAnchorBatch,
     rank_catalogue: rankCatalogue,
     record_anchor_failure: recordAnchorFailure,
     record_demand: recordDemand,
@@ -10871,11 +11030,14 @@ var init_admin_catalogue = __esm(() => {
     reset_apple_breaker: resetAppleBreaker,
     reset_spotify_anchor_breaker: resetSpotifyAnchorBreaker,
     resolve_anchor: resolveAnchor,
+    resolve_anchor_candidate: resolveAnchorCandidate,
+    resolve_anchor_paid_result: resolveAnchorPaidResult,
     resolve_anchor_review: resolveAnchorReview,
     set_anchor_apify: setAnchorApify,
     set_anchor_apify_budget: setAnchorApifyBudget,
     set_anchor_search: setAnchorSearch,
     set_capture_budget: setCaptureBudget,
+    set_label_releases_budget: setLabelReleasesBudget,
     set_track_dismissed: setTrackDismissed,
     verify_capture: verifyCapture
   };
@@ -11928,6 +12090,13 @@ var init_admin_backfills = __esm(() => {
   })).output(object({
     albumsMatched: number2(),
     albumsSeen: number2(),
+    blockedReason: _enum([
+      "spotify_breaker",
+      "spotify_budget",
+      "spotify_budget_spent",
+      "spotify_quota",
+      "spotify_throttle"
+    ]).nullable(),
     budgetPaused: boolean2(),
     configured: boolean2(),
     dryRun: boolean2(),
@@ -11935,14 +12104,20 @@ var init_admin_backfills = __esm(() => {
     failedLabels: array(string2()),
     fetchCeilingHit: boolean2(),
     labelSlugs: array(string2()),
+    labelsDue: number2(),
     labelsProbed: number2(),
+    neverChecked: number2(),
     newRows: number2(),
     newTrackIds: array(string2()),
     ok: literal(true),
+    quotaExceeded: boolean2(),
     rateLimited: boolean2(),
+    retryAfterMs: number2(),
     skippedKnown: number2(),
     skippedUndated: number2(),
     skippedUngrounded: number2(),
+    tapDailyBudget: number2().int(),
+    tapDailyCallsSpent: number2().int(),
     tracksSkippedArtistRule: number2().optional()
   }));
   LabelImagesBackfillFailedSchema = object({
@@ -13602,7 +13777,7 @@ var init_admin_hub_counts = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-labels.ts
-var LabelSeedStateSchema, LabelTriageVerdictSchema, LabelAdminItemSchema, listLabelsAdmin, updateLabel, listLabelArtistRules, replaceLabelArtistRules, MergeLabelResultSchema, mergeLabel, MB_LABEL_MBID_PATTERN, MintLabelOutcomeSchema, LabelTakeOverResultSchema, mintLabel, LabelAliasSourceSchema, LabelAliasKindSchema, LabelAliasCandidateSchema, listLabelAliases, confirmLabelAlias, rejectLabelAlias, DescribeLabelBodySchema, describeLabel, draftLabelBio, LabelBioWorkItemSchema, listLabelsMissingBio, TriageRuleProposalSchema, RecordLabelTriageBodySchema, recordLabelTriage, adminLabelsContract;
+var LabelSeedStateSchema, LabelTriageVerdictSchema, LabelAdminItemSchema, listLabelsAdmin, updateLabel, listLabelArtistRules, LABEL_ARTIST_RULES_MAX = 100, LABEL_TRIAGE_RULE_PROPOSALS_MAX, replaceLabelArtistRules, MergeLabelResultSchema, mergeLabel, MB_LABEL_MBID_PATTERN, MintLabelOutcomeSchema, LabelTakeOverResultSchema, mintLabel, LabelAliasSourceSchema, LabelAliasKindSchema, LabelAliasCandidateSchema, listLabelAliases, confirmLabelAlias, rejectLabelAlias, DescribeLabelBodySchema, describeLabel, draftLabelBio, LabelBioWorkItemSchema, listLabelsMissingBio, TriageRuleProposalSchema, RecordLabelTriageBodySchema, recordLabelTriage, adminLabelsContract;
 var init_admin_labels = __esm(() => {
   init_dist3();
   init_zod();
@@ -13655,6 +13830,7 @@ var init_admin_labels = __esm(() => {
     summary: "List one label's artist rules for future catalogue acquisition",
     tags: ["Admin"]
   }).input(object({ id: string2() })).output(object({ ok: literal(true), rules: array(ArtistRuleSchema) }));
+  LABEL_TRIAGE_RULE_PROPOSALS_MAX = LABEL_ARTIST_RULES_MAX * 2;
   replaceLabelArtistRules = oc.route({
     method: "PUT",
     operationId: "replaceLabelArtistRules",
@@ -13663,7 +13839,7 @@ var init_admin_labels = __esm(() => {
     tags: ["Admin"]
   }).input(object({
     id: string2(),
-    rules: array(ArtistRuleInputSchema).max(100).superRefine((rules, context) => {
+    rules: array(ArtistRuleInputSchema).max(LABEL_ARTIST_RULES_MAX).superRefine((rules, context) => {
       const seen = new Set;
       for (const [index, rule] of rules.entries()) {
         if (seen.has(rule.artistMbid)) {
@@ -13820,7 +13996,7 @@ var init_admin_labels = __esm(() => {
     reason: string2().optional(),
     residualOffLaneShare: number2().min(0).max(1).optional(),
     roundId: string2(),
-    rules: array(TriageRuleProposalSchema).optional(),
+    rules: array(TriageRuleProposalSchema).max(LABEL_TRIAGE_RULE_PROPOSALS_MAX).optional(),
     verdict: LabelTriageVerdictSchema,
     verifyAgrees: boolean2().optional(),
     verifyEvidence: string2().optional()
@@ -15435,7 +15611,7 @@ var init_admin_tracks = __esm(() => {
     debtAware: string2().optional(),
     kind: TrackWorkKindSchema,
     limit: number3().int().min(1).max(250).default(50),
-    paidMode: _enum(["quota", "prior"]).optional(),
+    paidMode: _enum(["quota", "prior", "unasked"]).optional(),
     scope: TrackWorkScopeSchema.default("all")
   })).output(object({
     capabilities: TrackWorkCapabilitiesSchema.optional(),
@@ -19289,14 +19465,18 @@ async function clearWrongAudioCommand(trackId) {
 async function requeueUnmatchedCommand() {
   return adminApiPost("/api/v1/admin/catalogue/captures/requeue-unmatched", {});
 }
-async function requeueAnchorCommand(trackIds) {
-  return adminApiPost("/api/v1/admin/catalogue/anchor/requeue", {
-    trackIds
-  });
+async function requeueAnchorCommand(trackIds, clearPaid = false) {
+  return adminApiPost("/api/v1/admin/catalogue/anchor/requeue", { clearPaid, trackIds });
 }
 async function requeueIsrcRecoveryCommand(input) {
   return adminApiPost("/api/v1/admin/catalogue/isrc-recovery/requeue", input);
 }
+async function labelReleasesBudgetCommand() {
+  return adminApiGet("/api/v1/admin/catalogue/label-releases-budget");
+}
+async function setLabelReleasesBudgetCommand(dailyBudget) {
+  return adminApiPut("/api/v1/admin/catalogue/label-releases-budget", { dailyBudget });
+}
 async function anchorApifyBudgetCommand() {
   return adminApiGet("/api/v1/admin/catalogue/anchor/apify-budget");
 }
@@ -23079,14 +23259,40 @@ JSON field reference:
     }
     console.log(cleared ? `Kept ${trackId}. Its audio re-embeds and rejoins the ranking on the next sweep.` : `${trackId} was not quarantined \u2014 nothing to clear.`);
   });
-  catalogue.command("requeue-anchor").description("Clear rows' anchor re-ask backoff so the next tick retries them (operator)").argument("<trackIds...>", "The catalogue track id(s) to requeue (up to 250)").option("--json", "Print JSON", false).action(async (trackIds, options) => {
+  catalogue.command("requeue-anchor").description("Clear rows' anchor re-ask backoff so the next tick retries them (operator)").argument("<trackIds...>", "The catalogue track id(s) to requeue (up to 250)").option("--clear-paid", "Settle a reconciled pending paid receipt; keeps its spend (operator)", false).option("--json", "Print JSON", false).action(async (trackIds, options) => {
     await Promise.resolve().then(() => init_admin_catalogue2());
-    const { requeued } = await requeueAnchorCommand(trackIds);
+    const { paidCleared, requeued } = await requeueAnchorCommand(trackIds, options.clearPaid);
     if (options.json) {
-      printJson({ ok: true, requeued });
+      printJson({ ok: true, paidCleared, requeued });
       return;
     }
     console.log(`Re-queued ${requeued} of ${trackIds.length} row(s) \u2014 the next anchor tick picks them up at their real priority.`);
+    if (options.clearPaid) {
+      console.log(`Settled ${paidCleared} pending paid receipt(s); recorded spend remains charged.`);
+    }
+  });
+  const labelReleasesBudget = catalogue.command("label-releases-budget").description("Read or set the label releases tap daily Spotify call budget");
+  labelReleasesBudget.option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    const state = await labelReleasesBudgetCommand();
+    if (options.json) {
+      printJson({ ...state, ok: true });
+      return;
+    }
+    console.log(`LABEL RELEASES BUDGET \u2014 ${state.callsSpent}/${state.dailyBudget} tap calls today \xB7 ${state.spotifyDailyCalls} Spotify calls total`);
+  });
+  labelReleasesBudget.command("set").requiredOption("--calls <count>", "Daily tap Spotify call budget").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    const calls = Number(options.calls);
+    if (!Number.isSafeInteger(calls) || calls < 0 || calls > 1e6) {
+      throw new Error("--calls must be an integer from 0 to 1000000");
+    }
+    const state = await setLabelReleasesBudgetCommand(calls);
+    if (options.json) {
+      printJson({ ...state, ok: true });
+      return;
+    }
+    console.log(`LABEL RELEASES BUDGET \u2014 ${state.callsSpent}/${state.dailyBudget} tap calls today \xB7 ${state.spotifyDailyCalls} Spotify calls total`);
   });
   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());
@@ -26432,6 +26638,7 @@ var stringOptions = new Set([
   "--bpm",
   "--bpm-confidence",
   "--bpm-source",
+  "--calls",
   "--composition",
   "--consumer-digest",
   "--consumer-item-count",

package/package.json

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