fluncle 0.235.0 → 0.237.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.235.0".trim() ? "0.235.0".trim() : "0.1.0";
+  currentVersion = "0.237.0".trim() ? "0.237.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.235.0".trim() ? "0.235.0".trim() : "0.1.0";
+  currentVersion2 = "0.237.0".trim() ? "0.237.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -11433,7 +11433,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, flagWrongAudio, forceCapture, certifyTrack, setTrackDismissed, CaptureVerifyItemSchema, listUnverifiedCaptures, verifyCapture, CrawlPassSchema, CrawlPhaseInitializationSchema, 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, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
@@ -11562,6 +11562,21 @@ var init_admin_catalogue = __esm(() => {
     summary: "Clear named rows' anchor re-ask backoff so the next tick retries them (operator)",
     tags: ["Admin"]
   }).input(object({ trackIds: array(string2().min(1)).min(1).max(250) })).output(object({ ok: literal(true), requeued: number2() }));
+  requeueIsrcRecovery = oc.route({
+    method: "POST",
+    operationId: "requeueIsrcRecovery",
+    path: "/admin/catalogue/isrc-recovery/requeue",
+    summary: "Clear Deezer-empty ISRC-recovery stamps from a named window (operator)",
+    tags: ["Admin"]
+  }).input(object({
+    dryRun: boolean2().default(true),
+    since: string2().regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{1,3})?Z)?$/, "since must be an ISO date (2026-09-09) or instant (2026-09-09T00:00:00.000Z)")
+  })).output(object({
+    dryRun: boolean2(),
+    matched: number2(),
+    ok: literal(true),
+    requeued: number2()
+  }));
   flagWrongAudio = oc.route({
     method: "POST",
     operationId: "flagWrongAudio",
@@ -11663,7 +11678,7 @@ var init_admin_catalogue = __esm(() => {
   CrawlPhaseInputSchema = discriminatedUnion("phase", [
     object({ phase: literal("initialize") }),
     object({
-      limit: number2().int().min(1).max(2).default(2),
+      limit: number2().int().min(1).max(MAX_CRAWL_PREPARE_LIMIT).default(2),
       maxHop: number2().int().min(0).max(3).default(2),
       phase: literal("prepare")
     }),
@@ -11686,7 +11701,7 @@ var init_admin_catalogue = __esm(() => {
     object({
       frontierPending: number2(),
       initialization: CrawlPhaseInitializationSchema,
-      items: array(object({ nodeId: string2(), preparedToken: string2() })).max(2),
+      items: array(object({ nodeId: string2(), preparedToken: string2() })).max(MAX_CRAWL_PREPARE_LIMIT),
       kind: _enum(["drained", "prepared", "unavailable"]),
       ok: literal(true),
       phase: literal("prepare")
@@ -11733,7 +11748,8 @@ var init_admin_catalogue = __esm(() => {
       release: number2()
     }),
     labelsUndecided: number2(),
-    seedLabels: array(string2())
+    seedLabels: array(string2()),
+    storablePending: number2()
   }).meta({ id: "CrawlStatus" });
   crawlCatalogue = oc.route({
     inputStructure: "detailed",
@@ -11934,6 +11950,7 @@ var init_admin_catalogue = __esm(() => {
     rank_catalogue: rankCatalogue,
     record_demand: recordDemand,
     requeue_anchor: requeueAnchor,
+    requeue_isrc_recovery: requeueIsrcRecovery,
     requeue_unmatched_captures: requeueUnmatchedCaptures,
     reset_apple_breaker: resetAppleBreaker,
     reset_spotify_anchor_breaker: resetSpotifyAnchorBreaker,
@@ -17235,10 +17252,10 @@ async function resolveDeezerSearch(track) {
     return;
   }
   try {
-    const query = `artist:"${artist}" track:"${stripVersionSuffix(track.title.trim())}"`;
+    const query = `${artist} ${stripVersionSuffix(track.title.trim())}`;
     const response = await fetch(`https://api.deezer.com/search?q=${encodeURIComponent(query)}`);
     const body = await response.json();
-    const hit = (body.data ?? []).find((item) => item.preview && versionMatches(track.title, item.title ?? "") && baseTitleMatches(track.title, item.title ?? "") && durationAgrees(track.durationMs, item.duration));
+    const hit = (body.data ?? []).find((item) => item.preview && normalize(item.artist?.name ?? "").includes(normalize(artist)) && versionMatches(track.title, item.title ?? "") && baseTitleMatches(track.title, item.title ?? "") && durationAgrees(track.durationMs, item.duration));
     return downloadPreview(hit?.preview, "deezer:search");
   } catch {
     return;
@@ -18510,6 +18527,9 @@ async function requeueAnchorCommand(trackIds) {
     trackIds
   });
 }
+async function requeueIsrcRecoveryCommand(input) {
+  return adminApiPost("/api/v1/admin/catalogue/isrc-recovery/requeue", input);
+}
 async function forceCaptureCommand(trackId) {
   return adminApiPost("/api/v1/admin/catalogue/force-capture", {
     trackId
@@ -22166,6 +22186,18 @@ 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("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({
+      dryRun: options.apply !== true,
+      since: options.since
+    });
+    if (options.json) {
+      printJson({ ok: true, ...result });
+      return;
+    }
+    console.log(result.dryRun ? `DRY RUN \u2014 ${result.matched} row(s) stamped Deezer-empty since ${options.since}. Re-run with --apply to clear them.` : `Cleared ${result.requeued} of ${result.matched} row(s) \u2014 the next isrc-recovery tick asks them again.`);
+  });
   catalogue.command("requeue-unmatched").description("Re-queue terminal-unmatched captures after a matcher improvement (operator)").option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_admin_catalogue2());
     const { requeued, skippedVetoed } = await requeueUnmatchedCommand();
@@ -22904,6 +22936,7 @@ async function runCrawlStatus(options, crawlStatusCommand) {
   const { frontier, frontierByKind } = result;
   console.log(`Catalogue: ${result.catalogueTracks} uncertified track(s); ${result.anchorsPending} awaiting a Spotify anchor.`);
   console.log(`Frontier: ${frontier.pending} pending, ${frontier.done} done, ${frontier.failed} failed, ${frontier.skipped} skipped (${frontierByKind.label} label, ${frontierByKind.artist} artist, ${frontierByKind.release} release).`);
+  console.log(`Ready to write: ${result.storablePending} storable release node(s) claimable now.`);
   console.log(`Seeds (${result.seedLabels.length}): ${result.seedLabels.join(", ") || "none enabled"}.`);
   console.log(`Awaiting your ruling: ${result.labelsUndecided} label(s).`);
 }

package/package.json

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