fluncle 0.171.0 → 0.173.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.171.0".trim() ? "0.171.0".trim() : "0.1.0";
+  currentVersion = "0.173.0".trim() ? "0.173.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2259,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.171.0".trim() ? "0.171.0".trim() : "0.1.0";
+  currentVersion2 = "0.173.0".trim() ? "0.173.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3499,6 +3499,24 @@ var init_src = __esm(() => {
       title: "Reach snapshot",
       weights: { status: "secondary" }
     },
+    {
+      command: "fluncle admin catalogue demand",
+      exposedContent: [
+        "nightly demand reorder — reads Simple Analytics pageviews for /artist + /label pages and reorders crawl/capture priority toward what real visitors looked at (--no-agent)"
+      ],
+      kind: "cron",
+      name: "cron.demand",
+      operatorNotes: "04:40 Amsterdam daily (just after the 04:00 reach snapshot — both daily analytics reads in one window). A bare trigger (the reach/rank shape): fires the AGENT-tier record_demand op once — the WORKER reads Simple Analytics for the /artist/<slug> + /label/<slug> pageviews over the trailing 30 days and REWRITES two derived reorder columns, tracks.demand_score (the capture queue's within-tier secondary sort) and crawl_frontier.demand_rank (the frontier pick's within-hop tiebreak). RANK-ORDER ONLY: it reorders within a tier and never overrides the capture_priority veto (a ruled-out label is never resurrected); the seed-allowlist crawl gate is untouched. Clear-then-set, so a same-window re-run is idempotent. Unprovisioned (no SIMPLE_ANALYTICS_API_KEY) it returns configured:false and is a clean no-op. Zero LLM tokens; the box's agent token drives it and the SA key lives Worker-side (no new box secret). Source: docs/agents/hermes/scripts/demand-sweep.*. See docs/catalogue-crawler.md § Demand.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-demand",
+        kind: "cron",
+        schedule: { time: "04:40", tz: "Europe/Amsterdam" }
+      },
+      statusDescription: "leans the catalogue toward what visitors looked at",
+      title: "Demand reorder",
+      weights: { status: "hidden" }
+    },
     {
       exposedContent: [
         "daily catalogue-funnel snapshot — one row per UTC day of stage totals + queue depths + frontier counts behind /admin/funnel (--no-agent)"
@@ -6180,13 +6198,18 @@ __export(exports_admin_catalogue, {
   clearWrongAudioCommand: () => clearWrongAudioCommand,
   certifyTrackCommand: () => certifyTrackCommand,
   catalogueRankCommand: () => catalogueRankCommand,
-  catalogueListCommand: () => catalogueListCommand
+  catalogueListCommand: () => catalogueListCommand,
+  catalogueDemandCommand: () => catalogueDemandCommand
 });
 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 { summary: response.summary, telescope: response.telescope };
 }
+async function catalogueDemandCommand() {
+  const response = await adminApiPost("/api/admin/catalogue/demand", {});
+  return response.summary;
+}
 async function catalogueListCommand(options) {
   const params = new URLSearchParams;
   params.set("lens", options.lens && CATALOGUE_LENSES.has(options.lens) ? options.lens : "ear");
@@ -6270,6 +6293,7 @@ var init_admin_reach = __esm(() => {
 var exports_admin_artists = {};
 __export(exports_admin_artists, {
   resolveArtistCommand: () => resolveArtistCommand,
+  rankArtistsCommand: () => rankArtistsCommand,
   listArtistsCommand: () => listArtistsCommand,
   draftArtistBioCommand: () => draftArtistBioCommand,
   describeArtistCommand: () => describeArtistCommand,
@@ -6308,6 +6332,11 @@ async function listArtistsCommand(limit, cursor) {
 async function resolveArtistCommand(artistId) {
   return adminApiPost(`/api/admin/artists/${encodeURIComponent(artistId)}/resolve`);
 }
+async function rankArtistsCommand(options) {
+  const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
+  const response = await adminApiPost("/api/admin/artists/rank", limit ? { limit } : {});
+  return { summary: response.summary };
+}
 async function backfillArtistImagesCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -9470,6 +9499,19 @@ function addAdminCommands(program2) {
     const { catalogueRankCommand: catalogueRankCommand2 } = await Promise.resolve().then(() => (init_admin_catalogue(), exports_admin_catalogue));
     await runCatalogueRank(options, catalogueRankCommand2);
   });
+  catalogue.command("demand").description("Reorder crawl/capture priority from Simple Analytics pageviews (one tick)").option("--json", "Print JSON", false).action(async (options) => {
+    const { catalogueDemandCommand: catalogueDemandCommand2 } = await Promise.resolve().then(() => (init_admin_catalogue(), exports_admin_catalogue));
+    const summary = await catalogueDemandCommand2();
+    if (options.json) {
+      printJson({ ok: true, summary });
+      return;
+    }
+    if (!summary.configured) {
+      console.log("Simple Analytics is not configured \u2014 demand left untouched (a clean no-op).");
+      return;
+    }
+    console.log(`Read ${summary.pagesRead} page(s) over ${summary.window.start}\u2026${summary.window.end}. Demanded ${summary.demandedArtists} artist(s) + ${summary.demandedLabels} label(s) (${summary.unknownSlugs} unknown skipped); scored ${summary.tracksScored} track(s), promoted ${summary.frontierPromoted} frontier node(s).`);
+  });
   catalogue.command("list").description("The ranked catalogue: closest to a finding (ear), next to capture, or wrong audio").option("--lens <lens>", "ear (default), capture, quarantine, unmatched, failed, or dismissed", "ear").option("--limit <limit>", "Rows (default 50, max 200)").option("--json", "Print JSON", false).action(async (options) => {
     const { catalogueListCommand: catalogueListCommand2 } = await Promise.resolve().then(() => (init_admin_catalogue(), exports_admin_catalogue));
     await runCatalogueList(options, catalogueListCommand2);
@@ -9657,6 +9699,10 @@ function addAdminCommands(program2) {
     const { describeArtistCommand: describeArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runEntityDescribe("artist", slug, options, describeArtistCommand2);
   });
+  artists.command("rank").description("Run one tick of the similar-artists sweep (artist centroids + nearest neighbours)").option("--limit <limit>", "Stale artists per tick (default 100)").option("--json", "Print JSON", false).action(async (options) => {
+    const { rankArtistsCommand: rankArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    await runArtistsRank(options, rankArtistsCommand2);
+  });
   artists.command("draft-bio").description("Assemble the Worker-grounded bio prompt for an artist (the sweep's trigger)").argument("<slug>").option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
     const { draftArtistBioCommand: draftArtistBioCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runEntityBioDraft("artist", slug, options, draftArtistBioCommand2);
@@ -11485,6 +11531,15 @@ async function runGalaxies(slug, options, commands) {
     console.log(`${galaxy.name.padEnd(40)} ${String(galaxy.memberCount).padStart(3)} finding${galaxy.memberCount === 1 ? "" : "s"}`);
   }
 }
+async function runArtistsRank(options, rankArtistsCommand2) {
+  const { summary } = await rankArtistsCommand2({ limit: options.limit });
+  if (options.json) {
+    printJson({ ok: true, summary });
+    return;
+  }
+  const removed = summary.centroidsRemoved > 0 ? ` Purged ${summary.centroidsRemoved} orphan(s).` : "";
+  console.log(`Ranked ${summary.centroidsComputed} artist(s); wrote ${summary.edgesWritten} edges.${removed} ${summary.remaining} still stale.`);
+}
 async function runCatalogueRank(options, catalogueRankCommand2) {
   const { summary, telescope } = await catalogueRankCommand2({ limit: options.limit });
   if (options.json) {

package/package.json

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