fluncle 0.262.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.262.0".trim() ? "0.262.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.262.0".trim() ? "0.262.0".trim() : "0.1.0";
+  currentVersion2 = "0.263.0".trim() ? "0.263.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -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, 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, 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",
@@ -10872,13 +11000,18 @@ 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,
@@ -10886,6 +11019,8 @@ var init_admin_catalogue = __esm(() => {
     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,
@@ -10895,6 +11030,8 @@ 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,
@@ -19328,10 +19465,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 +23259,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.263.0"
 }