fluncle 0.262.0 → 0.264.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.262.0".trim() ? "0.262.0".trim() : "0.1.0";
+  currentVersion = "0.264.0".trim() ? "0.264.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.262.0".trim() ? "0.262.0".trim() : "0.1.0";
+  currentVersion2 = "0.264.0".trim() ? "0.264.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -4476,6 +4476,7 @@ var init_admin_attention = __esm(() => {
     "attach-cues": "cues",
     "bio-review": "bio gate",
     "capture-suspect": "capture check",
+    "crawl-hold": "held release",
     distribute: "distribute",
     "drip-empty": "clip drip",
     "label-review": "label",
@@ -10193,7 +10194,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, LabelReleasesBudgetSchema, getLabelReleasesBudget, setLabelReleasesBudget, 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, CrawlHoldReasonSchema, CrawlHoldStateSchema, CrawlHoldSchema, listCrawlHolds, resolveCrawlHold, 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();
@@ -10222,6 +10223,7 @@ var init_admin_catalogue = __esm(() => {
     hasCapturedAudio: boolean2(),
     hasPreview: boolean2(),
     hiddenFromPublic: boolean2(),
+    hiddenReason: _enum(["long_form", "spoken_word"]).nullable(),
     isrc: string2().nullable(),
     key: string2().nullable(),
     label: string2().nullable(),
@@ -10320,9 +10322,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",
@@ -10426,6 +10431,7 @@ var init_admin_catalogue = __esm(() => {
     seedsRearmed: number2(),
     tracksAllowedIn: number2().optional(),
     tracksFound: number2(),
+    tracksHeldImplausible: number2().optional(),
     tracksSkipped: number2(),
     tracksSkippedArtistRule: number2().optional(),
     tracksSkippedHeld: number2().optional(),
@@ -10660,6 +10666,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 +10687,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 +10707,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 +10715,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",
@@ -10735,6 +10866,48 @@ var init_admin_catalogue = __esm(() => {
       spotifyTrackId: string2().optional()
     })
   }));
+  CrawlHoldReasonSchema = _enum(["before_founding", "before_label_era"]).meta({ id: "CrawlHoldReason" });
+  CrawlHoldStateSchema = _enum(["held", "kept_out", "released"]).meta({ id: "CrawlHoldState" });
+  CrawlHoldSchema = object({
+    artists: array(string2()),
+    createdAt: string2(),
+    labelId: string2(),
+    labelName: string2().nullable(),
+    labelSlug: string2().nullable(),
+    reason: CrawlHoldReasonSchema,
+    releaseDate: string2().nullable(),
+    releaseMbid: string2(),
+    releaseTitle: string2().nullable(),
+    state: CrawlHoldStateSchema,
+    thresholdYear: number2().int(),
+    trackCount: number2().int()
+  }).meta({ id: "CrawlHold" });
+  listCrawlHolds = oc.route({
+    method: "GET",
+    operationId: "listCrawlHolds",
+    path: "/admin/catalogue/holds",
+    summary: "Releases the crawl held back because their label credit looks implausible",
+    tags: ["Admin"]
+  }).input(object({
+    cursor: string2().min(1).max(512).optional(),
+    limit: number3().int().min(1).max(100).optional(),
+    state: CrawlHoldStateSchema.optional()
+  })).output(object({
+    holds: array(CrawlHoldSchema),
+    nextCursor: string2().optional(),
+    ok: literal(true),
+    total: number2().int()
+  }));
+  resolveCrawlHold = oc.route({
+    method: "POST",
+    operationId: "resolveCrawlHold",
+    path: "/admin/catalogue/holds/{releaseMbid}/resolve",
+    summary: "Rule on a held release: store it on the next crawl tick, or keep it out (operator)",
+    tags: ["Admin"]
+  }).input(object({
+    decision: _enum(["keep_out", "store"]),
+    releaseMbid: string2().min(1)
+  })).output(object({ ok: literal(true), state: CrawlHoldStateSchema }));
   setAnchorSearch = oc.route({
     method: "PUT",
     operationId: "setAnchorSearch",
@@ -10872,20 +11045,28 @@ 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_crawl_holds: listCrawlHolds,
     list_unverified_captures: listUnverifiedCaptures,
+    prepare_anchor: prepareAnchor,
+    prepare_anchor_batch: prepareAnchorBatch,
     rank_catalogue: rankCatalogue,
     record_anchor_failure: recordAnchorFailure,
     record_demand: recordDemand,
@@ -10895,7 +11076,10 @@ 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,
+    resolve_crawl_hold: resolveCrawlHold,
     set_anchor_apify: setAnchorApify,
     set_anchor_apify_budget: setAnchorApifyBudget,
     set_anchor_search: setAnchorSearch,
@@ -11527,6 +11711,7 @@ var init_admin_attention2 = __esm(() => {
     "attach-cues",
     "bio-review",
     "capture-suspect",
+    "crawl-hold",
     "distribute",
     "drip-empty",
     "label-review",
@@ -16145,6 +16330,7 @@ var init_me_recs = __esm(() => {
     label: string2().optional(),
     logId: string2(),
     note: string2().optional(),
+    previewable: boolean2(),
     similarity: number2(),
     spotifyUri: string2().optional(),
     spotifyUrl: string2().optional(),
@@ -16230,6 +16416,7 @@ var init_me_saved = __esm(() => {
     imageUrl: string2().optional(),
     logId: string2().optional(),
     note: string2().optional(),
+    previewable: boolean2(),
     savedAt: string2(),
     title: string2(),
     trackId: string2()
@@ -17353,6 +17540,7 @@ async function advanceProjectionCommand(input) {
   let scheduled = response.scheduled;
   let wallStopped = false;
   let rebuildRowsWalked = response.rebuildRowsWalked ?? 0;
+  let rebuildReported = response.rebuildStaleFamilies !== undefined;
   while (!response.complete && steps < maxSteps) {
     if (wallMs !== undefined && now() - startedAt >= wallMs) {
       wallStopped = true;
@@ -17363,8 +17551,9 @@ async function advanceProjectionCommand(input) {
     processed += response.processed;
     scheduled += response.scheduled;
     rebuildRowsWalked += response.rebuildRowsWalked ?? 0;
+    rebuildReported ||= response.rebuildStaleFamilies !== undefined;
   }
-  const rebuild = response.rebuildStaleFamilies === undefined ? {} : { rebuildRowsWalked, rebuildStaleFamilies: response.rebuildStaleFamilies };
+  const rebuild = rebuildReported ? { rebuildRowsWalked, rebuildStaleFamilies: response.rebuildStaleFamilies ?? 0 } : {};
   if (!includeTerminalStatus) {
     const { status: _status, ...withoutStatus } = response;
     return { ...withoutStatus, ...rebuild, processed, scheduled, steps, wallStopped };
@@ -19328,10 +19517,8 @@ 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);
@@ -23124,14 +23311,17 @@ 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) => {

package/package.json

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