fluncle 0.140.0 → 0.141.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.140.0".trim() ? "0.140.0".trim() : "0.1.0";
+  currentVersion = "0.141.0".trim() ? "0.141.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.140.0".trim() ? "0.140.0".trim() : "0.1.0";
+  currentVersion2 = "0.141.0".trim() ? "0.141.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2654,7 +2654,7 @@ var init_src = __esm(() => {
       exposedContent: ["the XML sitemap index of every public page"],
       kind: "discovery",
       name: "discovery.sitemap",
-      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml (pages/findings/graph/logbook), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting by kind is also the diagnostic: Search Console reports coverage PER sitemap.",
+      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml, ONE CHILD PER ENTITY TYPE (pages/findings/artists/labels/albums/galaxies/logbook), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting per entity type is also the diagnostic: Search Console reports coverage PER sitemap, so each entity type gets its own submitted/indexed count.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/sitemap.xml",
       url: `${SITE}/sitemap.xml`,
@@ -2662,7 +2662,9 @@ var init_src = __esm(() => {
     },
     {
       apiFormat: "application/xml",
-      exposedContent: ["one child sitemap: the pages / findings / graph / logbook URLs, auto-paged"],
+      exposedContent: [
+        "one child sitemap, per entity type: the pages / findings / artists / labels / albums / galaxies / logbook URLs, auto-paged"
+      ],
       kind: "discovery",
       name: "discovery.sitemap-shard",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
@@ -2956,6 +2958,17 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-label-images", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin backfills cover-masters",
+      exposedContent: [
+        "resolve each pending album/artist its OWN ≤1200² cover master (best source wins) → its own R2 image"
+      ],
+      kind: "cron",
+      name: "cron.cover-masters",
+      operatorNotes: "every 60m, run by a rave-02 HOST systemd timer (docs/agents/hermes/cover-masters-timer/). The DURABLE other half of the album/artist cover (RFC musickit-second-authority U3b): the publish path + catalogue crawl MINT albums/artists (each `image_state='pending'`) and this cron gives each its OWN ≤1200²-capped cover derivative in R2 (found.fluncle.com, `albums/<slug>.<ext>` / `artists/<slug>.<ext>`) instead of hotlinking a third party — the label-logo posture, two entities over. IMAGE ONLY — a downscaled display derivative, reversible, the REF-05-conscious 1200 line (docs/album-artwork.md); it certifies nothing and publishes nothing (agent tier, the `backfill_label_images` precedent). Worker-paced: one bounded batch of albums (Apple template → Cover Art Archive → Spotify floor), then one of artists (Spotify floor), per tick; every rung requests a ≤1200 rendition and a byte read enforces the cap before the R2 put, so no un-downscaled original is ever stored. The `albums`/`artists` row carries the durable reliability state (image_state/image_attempted_at/image_failures), so a resolved/none entity is terminal. Served via Cloudflare Images `/cdn-cgi/image/…` (decision B). Zero LLM tokens. Source: docs/agents/hermes/scripts/cover-masters-sweep.*. See docs/album-artwork.md.",
+      probeConfig: { cadenceMs: 60 * MINUTE_MS, cronName: "fluncle-cover-masters", kind: "cron" },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks capture-audio --queue",
       exposedContent: [
@@ -5792,6 +5805,22 @@ var init_admin_labels = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-covers.ts
+var exports_admin_covers = {};
+__export(exports_admin_covers, {
+  backfillCoverMastersCommand: () => backfillCoverMastersCommand
+});
+async function backfillCoverMastersCommand(kind, limit, dryRun, cursor) {
+  const params = new URLSearchParams({ dryRun: String(dryRun), kind, limit: String(limit) });
+  if (cursor) {
+    params.set("cursor", cursor);
+  }
+  return adminApiPost(`/api/admin/backfill/cover-masters?${params.toString()}`);
+}
+var init_admin_covers = __esm(() => {
+  init_api();
+});
+
 // src/commands/preview-migration.ts
 var exports_preview_migration = {};
 __export(exports_preview_migration, {
@@ -8829,6 +8858,10 @@ function addAdminCommands(program2) {
     const { backfillLabelImagesCommand: backfillLabelImagesCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runBackfillLabelImages(options, backfillLabelImagesCommand2);
   });
+  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) => {
+    const { backfillCoverMastersCommand: backfillCoverMastersCommand2 } = await Promise.resolve().then(() => (init_admin_covers(), exports_admin_covers));
+    await runBackfillCoverMasters(options, backfillCoverMastersCommand2);
+  });
   artists.command("resolve").description("Resolve an artist's social identity (MB url-rels + Firecrawl gap-fill)").argument("[artistId]").option("--queue", "Show the resolve worklist (artists awaiting resolution), oldest first", false).option("--limit <limit>", "Number of artists to show with --queue", "50").option("--json", "Print JSON", false).allowExcessArguments().action(async (artistId, options) => {
     if (options.queue) {
       const { listArtistsCommand: listArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
@@ -9461,6 +9494,60 @@ async function runBackfillArtistImages(options, backfillArtistImagesCommand2) {
     process.exitCode = 1;
   }
 }
+async function runBackfillCoverMasters(options, backfillCoverMastersCommand2) {
+  const limit = parseListLimit(options.limit);
+  const kind = options.kind === "artist" ? "artist" : "album";
+  const resolved = [];
+  const none = [];
+  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);
+    dryRun = result.dryRun;
+    resolved.push(...result.resolved);
+    none.push(...result.none);
+    failed.push(...result.failed);
+    if (!options.json) {
+      const verb2 = result.dryRun ? "would resolve" : "resolved";
+      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.noneCount} without a source; ${result.failedCount} failed`);
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      dryRun,
+      failed,
+      failedCount: failed.length,
+      kind,
+      none,
+      noneCount: none.length,
+      ok: true,
+      rateLimited: false,
+      resolved,
+      resolvedCount: resolved.length
+    });
+    if (failed.length > 0) {
+      process.exitCode = 1;
+    }
+    return;
+  }
+  const verb = dryRun ? "Would resolve" : "Resolved";
+  console.log(`${verb} ${resolved.length} ${kind} cover master(s); ${none.length} without a source; ${failed.length} failed.`);
+  for (const slug of resolved) {
+    console.log(`  ${slug}`);
+  }
+  for (const item of failed) {
+    console.log(`  ${item.slug}: ${item.error}`);
+  }
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+}
 async function runBackfillLabelImages(options, backfillLabelImagesCommand2) {
   const limit = parseListLimit(options.limit);
   const resolved = [];

package/package.json

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