fluncle 0.260.0 → 0.261.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.260.0".trim() ? "0.260.0".trim() : "0.1.0";
+  currentVersion = "0.261.0".trim() ? "0.261.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.260.0".trim() ? "0.260.0".trim() : "0.1.0";
+  currentVersion2 = "0.261.0".trim() ? "0.261.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3434,7 +3434,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.cluster",
-      operatorNotes: "nightly (02:20 Amsterdam), run by a rave-02 HOST systemd timer (docs/agents/hermes/cluster-timer/). Assignment-ONLY + idempotent (a no-op on an unchanged corpus): assign each finding to its nearest stored centroid, recompute centroids as members' means, retire an emptied galaxy, consume an operator split_requested_at (a k=2 fit). Zero LLM tokens; sub-second CPU. A full k=9 fit is an OPERATOR act (--cold-start / --remint), never scheduled. Source: docs/agents/hermes/scripts/cluster-sweep.* + cluster.py. See docs/agents/cluster-engine.md.",
+      operatorNotes: "nightly (03:20 Amsterdam), run by a Hermes host systemd timer (docs/agents/hermes/cluster-timer/). Assignment-ONLY + idempotent (a no-op on an unchanged corpus): assign each finding to its nearest stored centroid, recompute centroids as members' means, retire an emptied galaxy, consume an operator split_requested_at (a k=2 fit). Zero LLM tokens; sub-second CPU. A full k=9 fit is an OPERATOR act (--cold-start / --remint), never scheduled. Source: docs/agents/hermes/scripts/cluster-sweep.* + cluster.py. See docs/agents/cluster-engine.md.",
       probeConfig: { cadenceMs: 24 * 60 * MINUTE_MS, cronName: "fluncle-cluster", kind: "cron" },
       statusDescription: "groups the archive into sonic galaxies",
       title: "Sonic galaxies",
@@ -3459,11 +3459,12 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.label-releases",
-      operatorNotes: "every 24h, run by a rave-02 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: "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.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-label-releases",
-        kind: "cron"
+        kind: "cron",
+        schedule: { time: "07:20", tz: "Europe/Amsterdam" }
       },
       statusDescription: "taps day-one releases from the enabled labels",
       title: "Freshness tap",
@@ -10192,11 +10193,11 @@ 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, 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, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
-  CatalogueLensSchema = _enum(["capture", "dismissed", "ear", "failed", "quarantine", "unmatched"]).meta({ id: "CatalogueLens" });
+  CatalogueLensSchema = _enum(["capture", "dismissed", "ear", "failed", "long", "quarantine", "unmatched"]).meta({ id: "CatalogueLens" });
   CapturePriorityReasonSchema = object({
     kind: _enum(["artist", "label", "none", "seed-label", "skipped-label", "unauthorized"]),
     name: string2().nullable()
@@ -10220,6 +10221,7 @@ var init_admin_catalogue = __esm(() => {
     duplicateOf: CatalogueMatchSchema.nullable(),
     hasCapturedAudio: boolean2(),
     hasPreview: boolean2(),
+    hiddenFromPublic: boolean2(),
     isrc: string2().nullable(),
     key: string2().nullable(),
     label: string2().nullable(),
@@ -10582,6 +10584,21 @@ var init_admin_catalogue = __esm(() => {
     summary: literal(true),
     unstorablePending: number2()
   }).meta({ id: "CrawlPipelineSummary" });
+  PipelineWatchBoundedCountSchema = object({ atLeast: boolean2(), count: number2().int().nonnegative() }).meta({ id: "PipelineWatchBoundedCount" });
+  getPipeline = oc.route({
+    method: "GET",
+    operationId: "getPipeline",
+    path: "/admin/catalogue/pipeline",
+    summary: "Bounded pipeline counts for the box watchdog",
+    tags: ["Admin"]
+  }).input(object({})).output(object({
+    anchors: PipelineWatchBoundedCountSchema,
+    capture: PipelineWatchBoundedCountSchema.nullable(),
+    frontier: PipelineWatchBoundedCountSchema,
+    ok: literal(true),
+    storable: PipelineWatchBoundedCountSchema,
+    unstorable: PipelineWatchBoundedCountSchema
+  }));
   crawlCatalogue = oc.route({
     inputStructure: "detailed",
     method: "POST",
@@ -10841,6 +10858,7 @@ var init_admin_catalogue = __esm(() => {
     get_anchor_apify_budget: getAnchorApifyBudget,
     get_capture_budget: getCaptureBudget,
     get_crawl_status: getCrawlStatus,
+    get_pipeline: getPipeline,
     get_spotify_anchor_breaker: getSpotifyAnchorBreaker,
     list_catalogue_tracks: listCatalogueTracks,
     list_unverified_captures: listUnverifiedCaptures,
@@ -12484,7 +12502,10 @@ var init_admin_projections = __esm(() => {
     projections: object({
       artistQualification: ProjectionFamilyStatusSchema,
       crawlDueWork: ProjectionFamilyStatusSchema,
-      publicAggregates: ProjectionFamilyStatusSchema.extend({ anchorsReady: boolean2() }),
+      publicAggregates: ProjectionFamilyStatusSchema.extend({
+        anchorsReady: boolean2(),
+        durationGenerationReady: boolean2()
+      }),
       trackDueWork: ProjectionFamilyStatusSchema.extend({
         catalogueRankMarkerAgeMs: CountSchema.nullable().optional()
       })
@@ -15789,7 +15810,8 @@ var init_follow_digest = __esm(() => {
     sent: number2(),
     skipped: number2(),
     unknown: number2(),
-    weekKey: string2()
+    weekKey: string2(),
+    windowClosed: boolean2()
   }));
   getFollowDigestState = oc.route({
     method: "GET",
@@ -22715,6 +22737,8 @@ JSON field reference:
     });
     if (options.json) {
       printJson(result);
+    } else if (result.windowClosed && !result.dryRun) {
+      console.log("Follow digest sends open Friday at 17:00 Amsterdam.");
     } else {
       console.log(`Considered ${result.considered}; sent ${result.sent}; empty ${result.empty}; next ${result.nextCursor ?? "done"}.`);
     }

package/package.json

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