fluncle 0.170.0 → 0.172.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.170.0".trim() ? "0.170.0".trim() : "0.1.0";
+  currentVersion = "0.172.0".trim() ? "0.172.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.170.0".trim() ? "0.170.0".trim() : "0.1.0";
+  currentVersion2 = "0.172.0".trim() ? "0.172.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");
@@ -6389,11 +6412,14 @@ var exports_admin_covers = {};
 __export(exports_admin_covers, {
   backfillCoverMastersCommand: () => backfillCoverMastersCommand
 });
-async function backfillCoverMastersCommand(kind, limit, dryRun, cursor) {
+async function backfillCoverMastersCommand(kind, limit, dryRun, cursor, retryNone = false) {
   const params = new URLSearchParams({ dryRun: String(dryRun), kind, limit: String(limit) });
   if (cursor) {
     params.set("cursor", cursor);
   }
+  if (retryNone) {
+    params.set("retry", "none");
+  }
   return adminApiPost(`/api/admin/backfill/cover-masters?${params.toString()}`);
 }
 var init_admin_covers = __esm(() => {
@@ -9467,6 +9493,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);
@@ -9632,7 +9671,7 @@ function addAdminCommands(program2) {
     const { backfillRecordingMbidsCommand: backfillRecordingMbidsCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillRecordingMbids(options, backfillRecordingMbidsCommand2);
   });
-  backfill.command("cover-masters").description("Resolve owned \u22641200\xB2 cover masters (album/artist) into R2").option("--kind <kind>", "Which entity to drain: album | artist", "album").option("--dry-run", "Report the eligible worklist without any fetch or write", false).option("--limit <limit>", "Max entities to process", "50").option("--json", "Print JSON", false).action(async (options) => {
+  backfill.command("cover-masters").description("Resolve owned \u22641200\xB2 cover masters (album/artist) into R2").option("--kind <kind>", "Which entity to drain: album | artist", "album").option("--dry-run", "Report the eligible worklist without any fetch or write", false).option("--retry-none", "First re-queue a bounded batch of terminal none rows to pending, then run the pass", false).option("--limit <limit>", "Max entities to process", "50").option("--json", "Print JSON", false).action(async (options) => {
     const { backfillCoverMastersCommand: backfillCoverMastersCommand2 } = await Promise.resolve().then(() => (init_admin_covers(), exports_admin_covers));
     await runBackfillCoverMasters(options, backfillCoverMastersCommand2);
   });
@@ -10396,17 +10435,20 @@ async function runBackfillArtistImages(options, backfillArtistImagesCommand2) {
 async function runBackfillCoverMasters(options, backfillCoverMastersCommand2) {
   const limit = parseListLimit(options.limit);
   const kind = options.kind === "artist" ? "artist" : "album";
+  const retryNone = options.retryNone ?? false;
   const resolved = [];
   const none = [];
+  const requeued = [];
   const failed = [];
   let cursor;
   let dryRun = options.dryRun;
   while (resolved.length + none.length + failed.length < limit) {
     const remaining = limit - (resolved.length + none.length + failed.length);
-    const result = await backfillCoverMastersCommand2(kind, remaining, options.dryRun, cursor);
+    const result = await backfillCoverMastersCommand2(kind, remaining, options.dryRun, cursor, retryNone && cursor === undefined);
     dryRun = result.dryRun;
     resolved.push(...result.resolved);
     none.push(...result.none);
+    requeued.push(...result.requeued ?? []);
     failed.push(...result.failed);
     if (!options.json) {
       const verb2 = result.dryRun ? "would resolve" : "resolved";
@@ -10427,6 +10469,8 @@ async function runBackfillCoverMasters(options, backfillCoverMastersCommand2) {
       noneCount: none.length,
       ok: true,
       rateLimited: false,
+      requeued,
+      requeuedCount: requeued.length,
       resolved,
       resolvedCount: resolved.length
     });
@@ -10436,7 +10480,8 @@ async function runBackfillCoverMasters(options, backfillCoverMastersCommand2) {
     return;
   }
   const verb = dryRun ? "Would resolve" : "Resolved";
-  console.log(`${verb} ${resolved.length} ${kind} cover master(s); ${none.length} without a source; ${failed.length} failed.`);
+  const requeuedNote = retryNone ? ` (${dryRun ? "would re-queue" : "re-queued"} ${requeued.length} from none)` : "";
+  console.log(`${verb} ${resolved.length} ${kind} cover master(s); ${none.length} without a source; ${failed.length} failed${requeuedNote}.`);
   for (const slug of resolved) {
     console.log(`  ${slug}`);
   }

package/package.json

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