fluncle 0.259.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.259.0".trim() ? "0.259.0".trim() : "0.1.0";
+  currentVersion = "0.261.0".trim() ? "0.261.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2258,7 +2258,7 @@ var init_about = __esm(() => {
       heading: "For the nerds",
       links: [
         { label: "The Galaxy (game)", url: "https://galaxy.fluncle.com" },
-        { label: "SSH (this terminal)", url: "ssh rave.fluncle.com" },
+        { label: "SSH (the rave terminal)", url: "ssh rave.fluncle.com" },
         { label: "Source", url: "https://github.com/mauricekleine/fluncle" }
       ]
     }
@@ -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.259.0".trim() ? "0.259.0".trim() : "0.1.0";
+  currentVersion2 = "0.261.0".trim() ? "0.261.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3293,7 +3293,7 @@ var init_src = __esm(() => {
     },
     {
       command: "fluncle random",
-      exposedContent: ["the archive throws one back"],
+      exposedContent: ["the archive throws a banger back"],
       kind: "cli",
       name: "cli.random",
       weights: { cli: "secondary" }
@@ -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",
@@ -22056,7 +22078,7 @@ function artistRuleLines(rules) {
 }
 function createProgram() {
   const program = configureCommand(new Command);
-  program.name("fluncle").description(fluncleTagline.toLowerCase()).option("--env <local|production>", "Config profile to load (default: production)").showSuggestionAfterError(false).addHelpCommand("help [command]", "display help for command").hook("preAction", (_thisCommand, actionCommand) => {
+  program.name("fluncle").description(fluncleTagline).option("--env <local|production>", "Config profile to load (default: production)").showSuggestionAfterError(false).addHelpCommand("help [command]", "Display help for command").hook("preAction", (_thisCommand, actionCommand) => {
     const options = actionCommand.optsWithGlobals();
     setEnvProfile(options.env);
   }).addHelpText("before", `
@@ -22097,7 +22119,7 @@ async function main(args = process.argv.slice(2)) {
   await notifyIfUpdateAvailable(args);
 }
 function configureCommand(command) {
-  return command.exitOverride().addHelpCommand(false).configureOutput({
+  return command.exitOverride().helpOption("-h, --help", "Display help for command").addHelpCommand(false).configureOutput({
     writeErr: () => {}
   });
 }
@@ -22146,7 +22168,7 @@ function addListenCommands(program) {
     const openCommands = await Promise.resolve().then(() => (init_open(), exports_open));
     await runOpen(target, [], options, openCommands);
   });
-  program.command("random").description("The archive throws one back").option("--json", "Print JSON", false).action(async (options) => {
+  program.command("random").description("The archive throws a banger back").option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_random());
     await runRandom(options, randomCommand);
   });
@@ -22208,7 +22230,7 @@ function addAdminCommands(program) {
   admin.action(() => {
     admin.outputHelp();
   });
-  admin.command("help", { hidden: true }).description("display help for command").action(() => {
+  admin.command("help", { hidden: true }).description("Display help for command").action(() => {
     admin.outputHelp();
   });
   admin.command("queue").description("The attention queue: what's waiting, and the day's dispatch").option("--json", "Print JSON", false).action(async (options) => {
@@ -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"}.`);
     }
@@ -26521,7 +26545,7 @@ Listen:
   fluncle open [--limit 20] [--browser|--app]   Pick a track, open it in Spotify
   fluncle open playlist [--browser|--app]       Open Fluncle's Findings in Spotify
   fluncle open telegram [--browser|--app]       Open the Telegram feed
-  fluncle random [--json]                       The archive throws one back
+  fluncle random [--json]                       The archive throws a banger back
   fluncle subscribe [email]                     Fresh bangers, every Friday
 
 Browse:

package/package.json

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