fluncle 0.261.0 → 0.262.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.262.0".trim() ? "0.262.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.262.0".trim() ? "0.262.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, 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();
@@ -10826,7 +10826,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",
@@ -10858,6 +10881,7 @@ var init_admin_catalogue = __esm(() => {
     get_anchor_apify_budget: getAnchorApifyBudget,
     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,
@@ -10876,6 +10900,7 @@ var init_admin_catalogue = __esm(() => {
     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 +11953,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 +11967,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 +13640,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 +13693,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 +13702,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 +13859,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 +15474,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(),
@@ -19297,6 +19336,12 @@ async function requeueAnchorCommand(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");
 }
@@ -23088,6 +23133,29 @@ 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.`);
   });
+  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());
     const state = await anchorBreakerCommand();
@@ -26432,6 +26500,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.262.0"
 }