fluncle 0.156.0 → 0.158.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.156.0".trim() ? "0.156.0".trim() : "0.1.0";
+  currentVersion = "0.158.0".trim() ? "0.158.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2189,7 +2189,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.156.0".trim() ? "0.156.0".trim() : "0.1.0";
+  currentVersion2 = "0.158.0".trim() ? "0.158.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2913,6 +2913,8 @@ var init_src = __esm(() => {
       name: "cron.enrich",
       operatorNotes: "every 5m. Pure compute, zero LLM tokens. Source: docs/agents/hermes/scripts/enrich-sweep.*",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-enrich", kind: "cron" },
+      statusDescription: "BPM, key, and the spectral fingerprint",
+      title: "Audio enrichment",
       weights: { status: "hidden" }
     },
     {
@@ -2924,6 +2926,8 @@ var init_src = __esm(() => {
       name: "cron.embed",
       operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-embed", kind: "cron" },
+      statusDescription: "MuQ vectors for sonic similarity",
+      title: "Audio embeddings",
       weights: { status: "hidden" }
     },
     {
@@ -2935,6 +2939,8 @@ var init_src = __esm(() => {
       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.",
       probeConfig: { cadenceMs: 24 * 60 * MINUTE_MS, cronName: "fluncle-cluster", kind: "cron" },
+      statusDescription: "groups the archive into sonic galaxies",
+      title: "Sonic galaxies",
       weights: { status: "hidden" }
     },
     {
@@ -2946,6 +2952,8 @@ var init_src = __esm(() => {
       name: "cron.crawl",
       operatorNotes: "every 10m, run by a rave-02 HOST systemd timer (docs/agents/hermes/crawl-timer/). METADATA ONLY — it writes a `tracks` row with no `findings` row, so it certifies nothing (no Log ID, no note, no video, no public surface) and it captures no audio. Worker-paced (the box holds no MusicBrainz budget): one bounded pass per tick over the durable `crawl_frontier`, so a crawl is a marathon the SCHEDULE finishes and a reboot mid-label costs one node, not one crawl. The boundary gate is the operator's seed-label allowlist + graph distance (hop 0-2), never genre inference; a label the walk discovers enters `undecided` and is NOT crawled until he rules on it. Zero LLM tokens. Source: docs/agents/hermes/scripts/crawl-sweep.*. See docs/catalogue-crawler.md.",
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-crawl", kind: "cron" },
+      statusDescription: "charts new tracks from the wider label graph",
+      title: "Track crawler",
       weights: { status: "hidden" }
     },
     {
@@ -2957,6 +2965,8 @@ var init_src = __esm(() => {
       name: "cron.rank",
       operatorNotes: "every 30m, run by a rave-02 HOST systemd timer (docs/agents/hermes/rank-timer/). THE EAR's schedule, and it lands with the crawler on purpose: a timer ranking an empty table would be a /status row that means nothing, and the crawler is what creates rows. All the vector arithmetic runs in SQL inside the Worker; the sweep DRAINS (it loops while `remaining > 0` up to a tick budget), so a crawl that just landed 700 rows is ranked by the next tick. Self-healing: staleness is a fingerprint of the finding corpus, so logging or embedding a finding re-ranks the catalogue with no invalidation call. Writes DERIVED columns on catalogue rows only — it cannot certify. Zero LLM tokens. Source: docs/agents/hermes/scripts/rank-sweep.*. See docs/the-ear.md.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-rank", kind: "cron" },
+      statusDescription: "ranks unvisited tracks by nearness to the archive",
+      title: "Track ranking",
       weights: { status: "hidden" }
     },
     {
@@ -2968,6 +2978,8 @@ var init_src = __esm(() => {
       name: "cron.label-images",
       operatorNotes: "every 60m, run by a rave-02 HOST systemd timer (docs/agents/hermes/label-images-timer/). The DURABLE other half of the label entity: the crawler MINTS new labels every few minutes (each `image_state='pending'`) and the one-shot operator backfill only seeded the labels that already existed, so this cron is what gives every freshly-minted label its OWN logo instead of a borrowed album cover. METADATA ONLY — a label logo is internal, reversible, nominative-use trademark (the album-art posture); it certifies nothing and publishes nothing (agent tier, the `backfill_discogs` precedent). Worker-paced (the box holds no Discogs key / MusicBrainz budget): one bounded batch per tick walks each label's MB identity → its curated Discogs/Wikidata url-rels → downloads the logo once into R2, up the ladder Discogs → Wikidata → none (the freshest-cover floor). The `labels` row carries the durable reliability state (image_state/image_attempted_at/image_failures), so a resolved/none label is terminal and a vendor throttle just circuit-breaks and resumes next tick. Zero LLM tokens. Source: docs/agents/hermes/scripts/label-images-sweep.*. See docs/label-entity.md.",
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-label-images", kind: "cron" },
+      statusDescription: "resolves each label's own mark",
+      title: "Label logos",
       weights: { status: "hidden" }
     },
     {
@@ -2979,6 +2991,8 @@ var init_src = __esm(() => {
       name: "cron.cover-masters",
       operatorNotes: "every 60m, run by a rave-02 HOST systemd timer (docs/agents/hermes/cover-masters-timer/). The DURABLE other half of the album/artist cover (RFC musickit-second-authority U3b): the publish path + catalogue crawl MINT albums/artists (each `image_state='pending'`) and this cron gives each its OWN ≤1200²-capped cover derivative in R2 (found.fluncle.com, `albums/<slug>.<ext>` / `artists/<slug>.<ext>`) instead of hotlinking a third party — the label-logo posture, two entities over. IMAGE ONLY — a downscaled display derivative, reversible, the REF-05-conscious 1200 line (docs/album-artwork.md); it certifies nothing and publishes nothing (agent tier, the `backfill_label_images` precedent). Worker-paced: one bounded batch of albums (Apple template → Cover Art Archive → Spotify floor), then one of artists (Spotify floor), per tick; every rung requests a ≤1200 rendition and a byte read enforces the cap before the R2 put, so no un-downscaled original is ever stored. The `albums`/`artists` row carries the durable reliability state (image_state/image_attempted_at/image_failures), so a resolved/none entity is terminal. Served via Cloudflare Images `/cdn-cgi/image/…` (decision B). Zero LLM tokens. Source: docs/agents/hermes/scripts/cover-masters-sweep.*. See docs/album-artwork.md.",
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-cover-masters", kind: "cron" },
+      statusDescription: "owns each album and artist its cover master",
+      title: "Cover masters",
       weights: { status: "hidden" }
     },
     {
@@ -2990,6 +3004,8 @@ var init_src = __esm(() => {
       name: "cron.capture",
       operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-capture", kind: "cron" },
+      statusDescription: "captures each finding's full song once",
+      title: "Full-song capture",
       weights: { status: "hidden" }
     },
     {
@@ -3001,6 +3017,8 @@ var init_src = __esm(() => {
       name: "cron.verify-captures",
       operatorNotes: "every 30m, run by a rave-02 HOST systemd timer (docs/agents/hermes/verify-captures-timer/). The HISTORIC half of the capture verification gate (docs/the-ear.md § Wrong audio): the capture sweep verifies every NEW download at ingest, and this sweep walks every capture that landed before the gate existed and gives each the same Chromaprint check against the track's ISRC-resolved official preview. The box only MEASURES (fpcalc + the sliding-window match) and reports a plain verdict; the Worker ROUTES it — match/no-preview stamp `capture_verification`, a CATALOGUE mismatch quarantines for re-capture, a FINDING mismatch only raises the `capture-suspect` /admin attention item (a machine never rewinds a public finding; the operator rules with flag_wrong_audio). Resumable by construction (a stamped row leaves the worklist); degrades honestly without fpcalc (pre-rebake: `fpcalc_missing`, nothing stamped). Zero LLM tokens. Source: docs/agents/hermes/scripts/verify-captures.* + fingerprint-match.ts. See docs/the-ear.md.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-verify-captures", kind: "cron" },
+      statusDescription: "checks each captured song against its official preview",
+      title: "Capture verification",
       weights: { status: "hidden" }
     },
     {
@@ -3012,6 +3030,8 @@ var init_src = __esm(() => {
       name: "cron.context-note",
       operatorNotes: "every 5m. --no-agent trigger; the Worker does the Firecrawl + Haiku distill. Zero on-box tokens.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-context-note", kind: "cron" },
+      statusDescription: "distills the facts behind each finding",
+      title: "Context notes",
       weights: { status: "hidden" }
     },
     {
@@ -3023,6 +3043,8 @@ var init_src = __esm(() => {
       name: "cron.note",
       operatorNotes: "every 10m. Hybrid --no-agent; one claude -p authors the line. Never clobbers an operator note.",
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-note", kind: "cron" },
+      statusDescription: "writes each finding's editorial note",
+      title: "Editorial notes",
       weights: { status: "hidden" }
     },
     {
@@ -3032,8 +3054,10 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.artist-bio",
-      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph off best-effort Firecrawl facts + identity. Never clobbers an operator bio. Box activation operator-gated. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,artist-bio-sweep.sh}.",
+      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph, its grounding assembled WORKER-side (Firecrawl facts + the artist's finding titles) via the draft-bio op. Never clobbers an operator bio. Live. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,artist-bio-sweep.sh}.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-artist-bio", kind: "cron" },
+      statusDescription: "writes each artist's voiced bio",
+      title: "Artist bios",
       weights: { status: "hidden" }
     },
     {
@@ -3043,8 +3067,23 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.label-bio",
-      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph off best-effort Firecrawl facts + identity. Never clobbers an operator bio. Box activation operator-gated. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,label-bio-sweep.sh}.",
+      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph, its grounding assembled WORKER-side (Firecrawl facts + the label's finding titles) via the draft-bio op. Never clobbers an operator bio. Live. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,label-bio-sweep.sh}.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-label-bio", kind: "cron" },
+      statusDescription: "writes each label's voiced bio",
+      title: "Label bios",
+      weights: { status: "hidden" }
+    },
+    {
+      command: "fluncle admin albums describe --queue",
+      exposedContent: [
+        "auto-author the /album/<slug> voiced bio, fill-empty-only (hybrid: one claude -p call)"
+      ],
+      kind: "cron",
+      name: "cron.album-bio",
+      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph, its grounding assembled WORKER-side (Firecrawl facts + the album's finding titles) via the draft-bio op. Never clobbers an operator bio. Live. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,album-bio-sweep.sh}.",
+      probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-album-bio", kind: "cron" },
+      statusDescription: "writes each album's voiced bio",
+      title: "Album bios",
       weights: { status: "hidden" }
     },
     {
@@ -3056,6 +3095,8 @@ var init_src = __esm(() => {
       name: "cron.triage",
       operatorNotes: "every 15m. Hybrid --no-agent; a deterministic archive dedupe + DnB-plausibility heuristic feeds one claude -p phrasing, length-gated. Writes the verdict onto a PENDING submission so it lands in the /admin attention queue already assessed; approve/reject stays operator tier. Source: docs/agents/hermes/scripts/triage-sweep.{sh,ts}.",
       probeConfig: { cadenceMs: 15 * MINUTE_MS, cronName: "fluncle-triage", kind: "cron" },
+      statusDescription: "pre-chews each crew submission's verdict",
+      title: "Submission triage",
       weights: { status: "hidden" }
     },
     {
@@ -3072,6 +3113,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "00:40", tz: "Europe/Amsterdam" }
       },
+      statusDescription: "writes each sector-day up in the Logbook",
+      title: "Logbook author",
       weights: { status: "hidden" }
     },
     {
@@ -3083,6 +3126,8 @@ var init_src = __esm(() => {
       name: "cron.observation",
       operatorNotes: "every 60m. Hybrid --no-agent; one claude -p authors the script, the Worker voice-gates + renders.",
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-observation", kind: "cron" },
+      statusDescription: "Fluncle's spoken field observations",
+      title: "Audio observations",
       weights: { status: "hidden" }
     },
     {
@@ -3092,6 +3137,8 @@ var init_src = __esm(() => {
       name: "cron.backfill",
       operatorNotes: "every 30m. Pure HTTP driving, zero LLM tokens. Agent tier.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-backfill", kind: "cron" },
+      statusDescription: "repairs Discogs ids and Last.fm loves",
+      title: "Metadata backfill",
       weights: { status: "hidden" }
     },
     {
@@ -3102,6 +3149,8 @@ var init_src = __esm(() => {
       name: "cron.artist-sweep",
       operatorNotes: "every 60m. --no-agent trigger; the Worker does the MB walk + Firecrawl /v2/extract + YouTube channel resolution. Zero on-box tokens. MB rows land as status=auto (trusted); Firecrawl rows as status=candidate (operator-confirm before public). Source: docs/agents/hermes/scripts/artist-sweep.*",
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-artist-sweep", kind: "cron" },
+      statusDescription: "resolves each artist's socials and identity links",
+      title: "Artist resolution",
       weights: { status: "hidden" }
     },
     {
@@ -3113,6 +3162,8 @@ var init_src = __esm(() => {
       name: "cron.social-capture",
       operatorNotes: "every 10m. Pure HTTP trigger, zero LLM tokens. Agent tier (fills the public URL only — publishes nothing). The box's baked CLI predates the `--capture` verb, so the cron curls POST /api/admin/social/posts/capture directly; the Worker polls Postiz and writes back. Source: docs/agents/hermes/scripts/social-capture-sweep.sh. Probed on /status as cron.social-capture.",
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-social-capture", kind: "cron" },
+      statusDescription: "the live YouTube and TikTok URLs for each posted video",
+      title: "Social links",
       weights: { status: "hidden" }
     },
     {
@@ -3123,6 +3174,8 @@ var init_src = __esm(() => {
       name: "cron.studio-clip",
       operatorNotes: "every 15m. Pure-trigger, zero LLM tokens: a deterministic ffmpeg cut driven by the fluncle CLI (`admin clips list` → `admin clips cut`), agent-scoped (list_clips + the agent-tier presign_clip_upload / finalize_clip_cut). Cuts the operator-framed 9:16 clips from the /admin/studio editor (keyed by Log ID) out of the set video → ships `<clipId>/footage.mp4` to R2 for the /admin/clips library + the clip drip-feed. The box runs the standalone bun BINARY (the npm thin client can't spawn ffmpeg). Source: docs/agents/hermes/scripts/clip-sweep.sh. Probed on /status as cron.studio-clip.",
       probeConfig: { cadenceMs: 15 * MINUTE_MS, cronName: "fluncle-studio-clip", kind: "cron" },
+      statusDescription: "cuts set videos into 9:16 clips",
+      title: "Studio clips",
       weights: { status: "hidden" }
     },
     {
@@ -3134,6 +3187,8 @@ var init_src = __esm(() => {
       name: "cron.clip-drip",
       operatorNotes: "every 20m. Pure HTTP trigger, zero LLM tokens. Admin tier (needs the Worker's Postiz key, which the box never sees — the box only triggers; the `finalize_clip_cut` / `record_health` precedent). The Worker checks the global kill switch FIRST (paused → no-op), then posts due clips bounded by a per-tick cap AND a rolling-24h IG cap. Every clip auto-enters the schedule at a jittered ~23-25h after the queue tail. The operator pauses/resumes with `fluncle admin clips drip-pause` / `drip-resume`. Source: docs/agents/hermes/scripts/clip-drip-sweep.sh. Probed on /status as cron.clip-drip.",
       probeConfig: { cadenceMs: 20 * MINUTE_MS, cronName: "fluncle-clip-drip", kind: "cron" },
+      statusDescription: "drip-feeds set clips to Instagram",
+      title: "Clip drip-feed",
       weights: { status: "hidden" }
     },
     {
@@ -3145,6 +3200,8 @@ var init_src = __esm(() => {
       name: "cron.publish-advance",
       operatorNotes: "every 30m. Pure HTTP trigger, zero LLM tokens. The last autonomy gap: render finishes → this pushes, with no operator beat between. Admin tier (needs the Worker's Postiz key, which the box never sees — the box only triggers; the `drip_clips` / `capture_post_urls` precedent). SHIPS DARK: the Worker's kill switch is DEFAULT-DENY (only an explicit `false` in the `publish_advance_paused` setting runs it), so the timer ticks and posts nothing until `fluncle admin publish resume`. The Worker reads the switch FIRST, then advances at most ONE ready finding — both masters finalized, 15m settled, the whole bundle served on R2, the (track, platform) row CLAIMED atomically before any Postiz call, a rolling-24h cap of 6 pushes. A failed push is left `failed` for the operator and never auto-retried. Source: docs/agents/hermes/scripts/publish-advance-sweep.sh. Probed on /status as cron.publish-advance.",
       probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-publish-advance", kind: "cron" },
+      statusDescription: "advances the publish queue on his own clock",
+      title: "Publish advance",
       weights: { status: "hidden" }
     },
     {
@@ -3156,6 +3213,8 @@ var init_src = __esm(() => {
       name: "cron.render",
       operatorNotes: "every 60m. A conductor: triggers a detached @fluncle-video render on a scale-to-zero box.ascii box (rave-03). Never posts to social (operator-tier 403). Probed on /status as service `cron.render` (its own last-run freshness); the box's reachability is the SEPARATE `render-box` probe (the conductor state file).",
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-render", kind: "cron" },
+      statusDescription: "the conductor's last run",
+      title: "Render cron",
       weights: { status: "hidden" }
     },
     {
@@ -3166,6 +3225,8 @@ var init_src = __esm(() => {
       name: "cron.healthcheck",
       operatorNotes: "every 10m, run by a rave-02 host systemd timer (docs/agents/hermes/healthcheck-timer/) — decoupled from the Hermes cron gateway so the prober isn't starved by the scheduler it monitors. Pure probing, zero LLM tokens. POSTs to the agent-tier record_health op that /status reads.",
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-healthcheck", kind: "cron" },
+      statusDescription: "the prober behind this very page",
+      title: "Healthcheck prober",
       weights: { status: "hidden" }
     },
     {
@@ -3182,6 +3243,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "15:00", tz: "Europe/Amsterdam", weekday: 5 }
       },
+      statusDescription: "drafts the Friday edition",
+      title: "Weekly newsletter",
       weights: { status: "secondary" }
     },
     {
@@ -3197,6 +3260,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "03:00", tz: "Europe/Amsterdam" }
       },
+      statusDescription: "a daily off-site snapshot of the archive",
+      title: "Database backup",
       weights: { status: "secondary" }
     },
     {
@@ -3213,6 +3278,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "04:00", tz: "Europe/Amsterdam" }
       },
+      statusDescription: "counts the crew and how far the probes reached",
+      title: "Reach snapshot",
       weights: { status: "secondary" }
     },
     {
@@ -3228,6 +3295,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "01:00", tz: "Europe/Amsterdam" }
       },
+      statusDescription: "nightly one-domain codebase audit → a PR",
+      title: "Nightly audit",
       weights: { status: "secondary" }
     },
     {
@@ -3243,6 +3312,8 @@ var init_src = __esm(() => {
         kind: "cron",
         schedule: { time: "05:00", tz: "Europe/Amsterdam" }
       },
+      statusDescription: "reviews + merges the nightly audit PR",
+      title: "Audit reviewer",
       weights: { status: "secondary" }
     }
   ];
@@ -5832,7 +5903,7 @@ __export(exports_admin_catalogue, {
 async function catalogueRankCommand(options) {
   const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
   const response = await adminApiPost("/api/admin/catalogue/rank", limit ? { limit } : {});
-  return response.summary;
+  return { summary: response.summary, telescope: response.telescope };
 }
 async function catalogueListCommand(options) {
   const params = new URLSearchParams;
@@ -6034,6 +6105,28 @@ var init_admin_covers = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-albums.ts
+var exports_admin_albums = {};
+__export(exports_admin_albums, {
+  draftAlbumBioCommand: () => draftAlbumBioCommand,
+  describeAlbumCommand: () => describeAlbumCommand,
+  albumsBioQueueCommand: () => albumsBioQueueCommand
+});
+async function describeAlbumCommand(slug, options) {
+  return adminApiPost(`/api/admin/albums/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
+}
+async function draftAlbumBioCommand(slug) {
+  return adminApiGet(`/api/admin/albums/${encodeURIComponent(slug)}/bio-draft`);
+}
+async function albumsBioQueueCommand(limit) {
+  const response = await adminApiGet(`/api/admin/albums/bio-queue?limit=${limit}`);
+  return response.albums;
+}
+var init_admin_albums = __esm(() => {
+  init_api();
+  init_admin_artists2();
+});
+
 // src/commands/preview-migration.ts
 var exports_preview_migration = {};
 __export(exports_preview_migration, {
@@ -9226,6 +9319,23 @@ function addAdminCommands(program2) {
     const { draftLabelBioCommand: draftLabelBioCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runEntityBioDraft("label", slug, options, draftLabelBioCommand2);
   });
+  const albums = configureCommand(admin.command("albums").description("Album entity commands (the voiced bio)"));
+  albums.action(() => {
+    albums.outputHelp();
+  });
+  albums.command("describe").description("Author the voiced bio for an album (fills an empty bio only)").argument("[slug]").option("--queue", "Show the bio worklist (albums with findings but no bio), oldest first", false).option("--limit <limit>", "Number of albums to show with --queue", "50").option("--bio <text>", "The voice-gated bio paragraph").option("--bio-file <file>", "Read the bio from a file").option("--prompt-version <n>", "The prompt-registry version that authored the bio (the sweep sends this; it is the bio's provenance)").option("--dry-run", "Run the voice gate and report the verdict without storing anything", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    if (options.queue) {
+      const { albumsBioQueueCommand: albumsBioQueueCommand2 } = await Promise.resolve().then(() => (init_admin_albums(), exports_admin_albums));
+      await runEntityBioQueue("album", options, albumsBioQueueCommand2);
+      return;
+    }
+    const { describeAlbumCommand: describeAlbumCommand2 } = await Promise.resolve().then(() => (init_admin_albums(), exports_admin_albums));
+    await runEntityDescribe("album", slug, options, describeAlbumCommand2);
+  });
+  albums.command("draft-bio").description("Assemble the Worker-grounded bio prompt for an album (the sweep's trigger)").argument("<slug>").option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    const { draftAlbumBioCommand: draftAlbumBioCommand2 } = await Promise.resolve().then(() => (init_admin_albums(), exports_admin_albums));
+    await runEntityBioDraft("album", slug, options, draftAlbumBioCommand2);
+  });
   const migrations = configureCommand(admin.command("migrations").description("One-off operator data migrations"));
   migrations.action(() => {
     migrations.outputHelp();
@@ -10891,14 +11001,17 @@ async function runGalaxies(slug, options, commands) {
   }
 }
 async function runCatalogueRank(options, catalogueRankCommand2) {
-  const summary = await catalogueRankCommand2({ limit: options.limit });
+  const { summary, telescope } = await catalogueRankCommand2({ limit: options.limit });
   if (options.json) {
-    printJson({ ok: true, summary });
+    printJson({ ok: true, summary, telescope });
     return;
   }
   const quarantine = summary.quarantined > 0 ? ` Quarantined ${summary.quarantined} as wrong audio.` : "";
   const deduped = summary.catalogueDuplicates > 0 ? ` Marked ${summary.catalogueDuplicates} as catalogue duplicates.` : "";
   console.log(`Ranked ${summary.scored} against ${summary.embeddedFindings} embedded findings; prioritized ${summary.prioritized} for capture.${quarantine}${deduped} ${summary.remaining} still stale.`);
+  if (telescope) {
+    console.log(telescope.ok ? `Telescope: ${telescope.size} aboard${telescope.changed ? " (updated)" : ""}.` : `Telescope: sync failed \u2014 ${telescope.reason}`);
+  }
 }
 async function runCatalogueList(options, catalogueListCommand2) {
   const { summary, tracks } = await catalogueListCommand2({

package/package.json

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