fluncle 0.168.0 → 0.170.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.168.0".trim() ? "0.168.0".trim() : "0.1.0";
+  currentVersion = "0.170.0".trim() ? "0.170.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1013,20 +1013,50 @@ function freshRows(tracks) {
     return `${coordinate(track).padEnd(coordWidth)}  ${released}  ${label}`;
   });
 }
+function albumRows(albums) {
+  return albums.map((album) => {
+    const released = album.releaseDate.slice(0, 10);
+    return `${released}  ${album.artists.join(", ")} — ${album.name}`;
+  });
+}
 async function freshCommand({
   json,
-  limit
+  limit,
+  view
 }) {
   const response = await publicApiGet(`/api/v1/tracks/fresh?limit=${limit}`);
+  const showTracks = view !== "albums";
+  const showAlbums = view !== "tracks";
   if (json) {
-    printJson2({ ok: true, ...response });
+    const payload = { ok: true, windowDays: response.windowDays };
+    if (showAlbums) {
+      payload.albums = response.albums;
+    }
+    if (showTracks) {
+      payload.tracks = response.tracks;
+    }
+    printJson2(payload);
     return;
   }
-  if (response.tracks.length === 0) {
+  const blocks = [];
+  if (showTracks && response.tracks.length > 0) {
+    const rows = freshRows(response.tracks).join(`
+`);
+    blocks.push(view === "all" ? `Tracks
+${rows}` : rows);
+  }
+  if (showAlbums && response.albums.length > 0) {
+    const rows = albumRows(response.albums).join(`
+`);
+    blocks.push(view === "all" ? `Albums & EPs
+${rows}` : rows);
+  }
+  if (blocks.length === 0) {
     console.log(`Nothing new out in the last ${response.windowDays} days.`);
     return;
   }
-  console.log(freshRows(response.tracks).join(`
+  console.log(blocks.join(`
+
 `));
 }
 var COORD_FALLBACK = "—";
@@ -2229,7 +2259,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.168.0".trim() ? "0.168.0".trim() : "0.1.0";
+  currentVersion2 = "0.170.0".trim() ? "0.170.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2439,6 +2469,19 @@ var init_src = __esm(() => {
       url: `${SITE}/fresh`,
       weights: { web: "secondary" }
     },
+    {
+      discoveryUrl: `${SITE}/llms.txt`,
+      exposedContent: [
+        "/tracks — the whole list: every track Fluncle holds (certified findings + the wider catalogue), newest release first, filterable by release year, tempo, key, label, and galaxy"
+      ],
+      kind: "web_route",
+      name: "web.tracks",
+      operatorNotes: "The top-level track index — the whole archive as one browse list, findings in full voice and the catalogue rows in the unlit register (DESIGN.md). Ordered by tracks.release_date (what came out), never findings.added_at (the Found Rule), keyset-paginated over the tracks_release_date_idx btree so it stays a bounded reverse scan as the catalogue grows (lib/server/tracks-hub.ts). The filter params MIRROR the search vocabulary verbatim (yearMin/yearMax, bpmMin/bpmMax, key, label; galaxy is the one extension). The bare HUB is always indexable + in the sitemap; ANY filter param present flips it to noindex, and the canonical is always the bare /tracks. The INDEX is always-200, so it is HTTP-probeable.",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/tracks",
+      url: `${SITE}/tracks`,
+      weights: { web: "secondary" }
+    },
     {
       exposedContent: [
         "/galaxies — the browse-by-feel lens: the archive grouped into operator-named sonic galaxies (k-means over the MuQ audio embedding space)",
@@ -2731,6 +2774,30 @@ var init_src = __esm(() => {
       url: `${SITE}/fresh.json`,
       weights: { web: "secondary" }
     },
+    {
+      apiFormat: "application/rss+xml",
+      exposedContent: [
+        "one artist's newest releases over a 30-day window, as RSS (release-dated, that artist only)"
+      ],
+      kind: "feed",
+      name: "feed.fresh.artist.rss",
+      operatorNotes: "Slug-parameterized (/artist/:slug/fresh.xml), so there is no fixed URL to health-probe — no probeConfig, like web.artist. An unknown slug 404s; a known artist with nothing in the window serves a valid empty feed. Source: apps/web/src/routes/artist.$slug.fresh[.]xml.ts + src/lib/server/fresh-entity.ts.",
+      route: "/artist/:slug/fresh.xml",
+      url: `${SITE}/artist/:slug/fresh.xml`,
+      weights: { web: "tertiary" }
+    },
+    {
+      apiFormat: "application/rss+xml",
+      exposedContent: [
+        "one label's newest releases over a 30-day window, as RSS (release-dated, that label only)"
+      ],
+      kind: "feed",
+      name: "feed.fresh.label.rss",
+      operatorNotes: "Slug-parameterized (/label/:slug/fresh.xml), so there is no fixed URL to health-probe — no probeConfig, like web.artist. An unknown slug 404s; a known label with nothing in the window serves a valid empty feed. Source: apps/web/src/routes/label.$slug.fresh[.]xml.ts + src/lib/server/fresh-entity.ts.",
+      route: "/label/:slug/fresh.xml",
+      url: `${SITE}/label/:slug/fresh.xml`,
+      weights: { web: "tertiary" }
+    },
     {
       apiFormat: "application/rss+xml",
       exposedContent: ["the mixtapes as a podcast feed (episode audio on found.fluncle.com)"],
@@ -2856,7 +2923,7 @@ var init_src = __esm(() => {
       apiFormat: "application/json",
       discoveryUrl: `${SITE}/.well-known/mcp/server-card.json`,
       exposedContent: [
-        "the archive as MCP tools (Streamable HTTP, no auth): list_tracks, list_fresh, get_track, get_random_track, get_status, search_tracks, submit_track, subscribe_newsletter",
+        "the archive as MCP tools (Streamable HTTP, no auth): list_tracks, list_fresh, get_track, get_random_track, get_status, search_archive, get_artist, get_label, build_set, get_similar_artists, list_album_catalogue, list_artist_catalogue, list_label_catalogue, search_tracks, submit_track, subscribe_newsletter",
         "the archive as MCP resources: each finding/mixtape at fluncle://finding/<logId> or fluncle://mixtape/<logId> (its public record)",
         "Fluncle-voiced MCP prompts: recommend_finding, walk_recent_night, decode_coordinate"
       ],
@@ -3432,6 +3499,23 @@ var init_src = __esm(() => {
       title: "Reach snapshot",
       weights: { status: "secondary" }
     },
+    {
+      exposedContent: [
+        "daily catalogue-funnel snapshot — one row per UTC day of stage totals + queue depths + frontier counts behind /admin/funnel (--no-agent)"
+      ],
+      kind: "cron",
+      name: "cron.funnel-snapshot",
+      operatorNotes: "23:45 UTC daily (end of the UTC day the snapshot is keyed on). A bare trigger (the reach/anchor shape): fires the AGENT-tier record_catalogue_snapshot op once — the Worker computes every stage total + queue depth + frontier count through the SAME predicates the sweeps run (lib/server/funnel.ts) and UPSERTS one idempotent row per UTC day (a same-day re-run overwrites, never doubles a bar). Zero LLM tokens; the box's agent token drives it and calls the oRPC HTTP endpoint directly (no new CLI command the pinned box CLI would lack), so no new secret. Source: docs/agents/hermes/scripts/funnel-snapshot-sweep.*. See docs/rfcs/catalogue-funnel-rfc.md.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-funnel-snapshot",
+        kind: "cron",
+        schedule: { time: "23:45", tz: "UTC" }
+      },
+      statusDescription: "records the catalogue pipeline's daily numbers",
+      title: "Funnel snapshot",
+      weights: { status: "hidden" }
+    },
     {
       exposedContent: [
         "nightly codebase audit — one domain/night on a 7-day rotation; opens a PR the reviewer merges (claude -p, subscription auth)"
@@ -6260,12 +6344,17 @@ var init_admin_artists2 = __esm(() => {
 // src/commands/admin-labels.ts
 var exports_admin_labels = {};
 __export(exports_admin_labels, {
+  mergeLabelCommand: () => mergeLabelCommand,
   labelsBioQueueCommand: () => labelsBioQueueCommand,
   draftLabelBioCommand: () => draftLabelBioCommand,
   describeLabelCommand: () => describeLabelCommand,
   backfillLabelLineageCommand: () => backfillLabelLineageCommand,
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
+async function mergeLabelCommand(losingSlug, canonicalSlug) {
+  const response = await adminApiPost(`/api/admin/labels/${encodeURIComponent(losingSlug)}/merge`, { canonicalSlug });
+  return response.result;
+}
 async function describeLabelCommand(slug, options) {
   return adminApiPost(`/api/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
@@ -8815,9 +8904,13 @@ function addListenCommands(program2) {
     const { recentCommand: recentCommand3 } = await Promise.resolve().then(() => (init_recent(), exports_recent));
     await runRecent(options, recentCommand3);
   });
-  program2.command("fresh").description("What just came out, newest release first").option("--limit <limit>", "Number of releases to fetch").option("--json", "Print JSON", false).action(async (options) => {
+  program2.command("fresh").description("What just came out, newest release first").option("--limit <limit>", "Number of releases to fetch").option("--view <view>", "Which cut to show: all, tracks, or albums", "all").option("--json", "Print JSON", false).action(async (options) => {
     const { freshCommand: freshCommand2 } = await Promise.resolve().then(() => (init_fresh(), exports_fresh));
-    await freshCommand2({ json: options.json, limit: parseListLimit(options.limit) });
+    await freshCommand2({
+      json: options.json,
+      limit: parseListLimit(options.limit),
+      view: parseFreshView(options.view)
+    });
   });
   program2.command("artists").description("Browse artists in Fluncle's archive").argument("[slug]", "Artist slug (omit for the full list)").option("--json", "Print JSON", false).action(async (slug, options) => {
     const { artistsListCommand: artistsListCommand2, artistsGetCommand: artistsGetCommand2 } = await Promise.resolve().then(() => (init_artists(), exports_artists));
@@ -9565,7 +9658,7 @@ function addAdminCommands(program2) {
     const { draftArtistBioCommand: draftArtistBioCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runEntityBioDraft("artist", slug, options, draftArtistBioCommand2);
   });
-  const labels = configureCommand(admin.command("labels").description("Label entity commands (the voiced bio)"));
+  const labels = configureCommand(admin.command("labels").description("Label entity commands (voiced bio + slug-split merge)"));
   labels.action(() => {
     labels.outputHelp();
   });
@@ -9582,6 +9675,27 @@ function addAdminCommands(program2) {
     const { draftLabelBioCommand: draftLabelBioCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runEntityBioDraft("label", slug, options, draftLabelBioCommand2);
   });
+  labels.command("merge").description("Merge a slug-split label into its canonical row (operator; re-points + redirects)").argument("<losingSlug>", "The duplicate label to fold away").argument("<canonicalSlug>", "The label to keep \u2014 everything re-points onto it").option("--json", "Print JSON", false).action(async (losingSlug, canonicalSlug, options) => {
+    const { mergeLabelCommand: mergeLabelCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    const result = await mergeLabelCommand2(losingSlug, canonicalSlug);
+    if (options.json) {
+      printJson({ ok: true, result });
+      return;
+    }
+    const {
+      aliasWritten,
+      canonicalSlug: canon,
+      losingSlug: loser,
+      reconciled,
+      repointed
+    } = result;
+    console.log(`Merged ${loser} \u2192 ${canon}.`);
+    console.log(`  Re-pointed: ${repointed.tracks} track(s), ${repointed.childLabels} sublabel(s), ${repointed.aliases} alias(es).`);
+    console.log(reconciled.length > 0 ? `  Filled onto ${canon} (was empty): ${reconciled.join(", ")}.` : `  Nothing to fill \u2014 ${canon} already carried every fact.`);
+    console.log(`  Seed state resolved to: ${result.seedState}.`);
+    console.log(`  Alias written: "${aliasWritten.alias}" (${aliasWritten.aliasSlug}) \u2192 confirmed, so it can never re-mint.`);
+    console.log(`  /label/${loser} now 301s to /label/${canon}.`);
+  });
   const albums = configureCommand(admin.command("albums").description("Album entity commands (the voiced bio)"));
   albums.action(() => {
     albums.outputHelp();
@@ -11544,6 +11658,13 @@ function parseListLimit(value) {
   }
   return limit;
 }
+function parseFreshView(value) {
+  const view = value ?? "all";
+  if (view !== "all" && view !== "tracks" && view !== "albums") {
+    throw new Error("View must be one of: all, tracks, albums");
+  }
+  return view;
+}
 function resolveHasKey(options) {
   if (options.key === false) {
     return false;
@@ -12133,6 +12254,7 @@ var stringOptions = new Set([
   "--verdict-file",
   "--video",
   "--video-url",
+  "--view",
   "--voice-id",
   "--window-since",
   "--window-until"

package/package.json

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