fluncle 0.157.0 → 0.159.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.157.0".trim() ? "0.157.0".trim() : "0.1.0";
+  currentVersion = "0.159.0".trim() ? "0.159.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.157.0".trim() ? "0.157.0".trim() : "0.1.0";
+  currentVersion2 = "0.159.0".trim() ? "0.159.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2349,11 +2349,11 @@ var init_src = __esm(() => {
     {
       discoveryUrl: `${SITE}/llms.txt`,
       exposedContent: [
-        "/artist/:slug — one artist's page: every published finding from that artist, plus their identity links"
+        "/artist/:slug — one artist's page: its findings, its identity links, and the rest of its catalogue"
       ],
       kind: "web_route",
       name: "web.artist",
-      operatorNotes: "Slug is real-name kebab-case (e.g. /artist/dbridge). Read-only; only artists with at least one published finding resolve (others 404). No probeConfig — the route is slug-parameterized, so there is no fixed URL to GET-probe.",
+      operatorNotes: "Slug is real-name kebab-case (e.g. /artist/dbridge). Read-only; an artist earns a page on its CONTENT exactly as a label/album does — a row renders (a findings-free discovered artist included), a slug with no row 404s, and a page below the thin-content floor renders noindex + stays out of the sitemap (the ARTIST_INDEX_MIN_FINDINGS precedent). No probeConfig — the route is slug-parameterized, so there is no fixed URL to GET-probe.",
       route: "/artist",
       url: `${SITE}/artist`,
       weights: { ssh: "secondary", web: "secondary" }
@@ -2380,7 +2380,7 @@ var init_src = __esm(() => {
       ],
       kind: "web_route",
       name: "web.albums",
-      operatorNotes: "The album half of the graph, and the node that closes it: the album page carries the album → label edge (a link, plus `albumRelease.recordLabel` in its MusicAlbum JSON-LD). The INDEX is probeable (always 200); the slug page is not. Bounded by the archive, not the catalogue — an album earns a page by carrying a finding (docs/album-entity.md).",
+      operatorNotes: "The album half of the graph, and the node that closes it: the album page carries the album → label edge (a link, plus `albumRelease.recordLabel` in its MusicAlbum JSON-LD). The INDEX is probeable (always 200); the slug page is not. The `/albums` index stays archive-bounded (findings-joined), but a crawl-minted findings-free album is PUBLIC on its content — a row renders its page, a below-floor page renders noindex + stays out of the sitemap, like a discovered label (docs/album-entity.md).",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/albums",
       url: `${SITE}/albums`,
@@ -2969,6 +2969,23 @@ var init_src = __esm(() => {
       title: "Track ranking",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin frontier refresh",
+      exposedContent: [
+        "re-mirror every crew member's Fluncle's Frontier playlist from their current recommendations"
+      ],
+      kind: "cron",
+      name: "cron.frontier-refresh",
+      operatorNotes: "weekly (Fri 07:00 Amsterdam), run by a rave-02 HOST systemd timer (docs/agents/hermes/frontier-refresh-timer/). E2, the public recommendation machine: every verified user can mint ONE public 'Fluncle's Frontier' playlist on Fluncle's OWN Spotify account (no per-user OAuth), holding THEIR recommendations (the E1 blend); this cron is the Discover-Weekly-style refresh that keeps each one current. The walk + the Spotify item replaces all happen inside the Worker; the sweep just fires one `fluncle admin frontier refresh`. It respects the DEFAULT-DENY `frontier.minting` kill switch (a closed switch touches nothing), skips playlists whose recommendation set is unchanged (a per-row URI-hash mirror guard), and creates no new public authority — every playlist it touches already exists, minted by its own owner. `refresh_frontier_playlists` is AGENT tier, so the box's existing agent-scoped token drives it: NO new secret. Zero LLM tokens. Source: docs/agents/hermes/scripts/frontier-refresh-sweep.*. See docs/the-ear.md § Fluncle's Frontier.",
+      probeConfig: {
+        cadenceMs: 7 * 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-frontier-refresh",
+        kind: "cron"
+      },
+      statusDescription: "refreshes every crew member's Frontier playlist",
+      title: "Frontier refresh",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin backfills label-images",
       exposedContent: [
@@ -3073,6 +3090,19 @@ var init_src = __esm(() => {
       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" }
+    },
     {
       command: "fluncle admin submissions triage",
       exposedContent: [
@@ -5871,6 +5901,19 @@ var init_admin_observations = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-frontier.ts
+var exports_admin_frontier = {};
+__export(exports_admin_frontier, {
+  frontierRefreshCommand: () => frontierRefreshCommand
+});
+async function frontierRefreshCommand(options) {
+  const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
+  return adminApiPost("/api/admin/frontier-playlists/refresh", limit ? { limit } : {});
+}
+var init_admin_frontier = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-catalogue.ts
 var exports_admin_catalogue = {};
 __export(exports_admin_catalogue, {
@@ -6092,6 +6135,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, {
@@ -9076,6 +9141,23 @@ function addAdminCommands(program2) {
     const { observationGateCommand: observationGateCommand2 } = await Promise.resolve().then(() => (init_admin_observations(), exports_admin_observations));
     await runObservationGate(options, observationGateCommand2);
   });
+  const frontier = configureCommand(admin.command("frontier").description("The Frontier playlists (per-user recommendations)"));
+  frontier.action(() => {
+    frontier.outputHelp();
+  });
+  frontier.command("refresh").description("Re-mirror every crew member's Frontier playlist from their recommendations").option("--limit <limit>", "Playlists per tick (default 500)").option("--json", "Print JSON", false).action(async (options) => {
+    const { frontierRefreshCommand: frontierRefreshCommand2 } = await Promise.resolve().then(() => (init_admin_frontier(), exports_admin_frontier));
+    const summary = await frontierRefreshCommand2(options);
+    if (options.json) {
+      printJson(summary);
+      return;
+    }
+    if (summary.switchOff) {
+      console.log("Frontier minting is paused (the kill switch is closed). Nothing refreshed.");
+      return;
+    }
+    console.log(`Walked ${summary.total} playlist(s): ${summary.refreshed} refreshed, ${summary.unchanged} unchanged, ${summary.minted} minted, ${summary.skipped} skipped, ${summary.failed} failed.`);
+  });
   const catalogue = configureCommand(admin.command("catalogue").description("The catalogue (uncertified tracks): the crawler + its ranking"));
   catalogue.action(() => {
     catalogue.outputHelp();
@@ -9284,6 +9366,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();

package/package.json

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