fluncle 0.158.0 → 0.160.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.158.0".trim() ? "0.158.0".trim() : "0.1.0";
+  currentVersion = "0.160.0".trim() ? "0.160.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.158.0".trim() ? "0.158.0".trim() : "0.1.0";
+  currentVersion2 = "0.160.0".trim() ? "0.160.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: [
@@ -5884,6 +5901,27 @@ var init_admin_observations = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-frontier.ts
+var exports_admin_frontier = {};
+__export(exports_admin_frontier, {
+  frontierStatusCommand: () => frontierStatusCommand,
+  frontierSetMintingCommand: () => frontierSetMintingCommand,
+  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 } : {});
+}
+async function frontierStatusCommand() {
+  return adminApiGet("/api/admin/frontier/minting");
+}
+async function frontierSetMintingCommand(open) {
+  return adminApiPut("/api/admin/frontier/minting", { open });
+}
+var init_admin_frontier = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-catalogue.ts
 var exports_admin_catalogue = {};
 __export(exports_admin_catalogue, {
@@ -9111,6 +9149,50 @@ 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.`);
+  });
+  frontier.command("status").description("Whether Frontier minting is open (the kill switch's state)").option("--json", "Print JSON", false).action(async (options) => {
+    const { frontierStatusCommand: frontierStatusCommand2 } = await Promise.resolve().then(() => (init_admin_frontier(), exports_admin_frontier));
+    const state = await frontierStatusCommand2();
+    if (options.json) {
+      printJson(state);
+      return;
+    }
+    console.log(state.open ? "Frontier minting is OPEN." : "Frontier minting is closed.");
+  });
+  frontier.command("open").description("Open Frontier minting \u2014 the kill switch (operator)").option("--json", "Print JSON", false).action(async (options) => {
+    const { frontierSetMintingCommand: frontierSetMintingCommand2 } = await Promise.resolve().then(() => (init_admin_frontier(), exports_admin_frontier));
+    const state = await frontierSetMintingCommand2(true);
+    if (options.json) {
+      printJson(state);
+      return;
+    }
+    console.log("Frontier minting is OPEN.");
+  });
+  frontier.command("close").description("Close Frontier minting \u2014 the kill switch (operator)").option("--json", "Print JSON", false).action(async (options) => {
+    const { frontierSetMintingCommand: frontierSetMintingCommand2 } = await Promise.resolve().then(() => (init_admin_frontier(), exports_admin_frontier));
+    const state = await frontierSetMintingCommand2(false);
+    if (options.json) {
+      printJson(state);
+      return;
+    }
+    console.log("Frontier minting is closed.");
+  });
   const catalogue = configureCommand(admin.command("catalogue").description("The catalogue (uncertified tracks): the crawler + its ranking"));
   catalogue.action(() => {
     catalogue.outputHelp();

package/package.json

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