fluncle 0.101.0 → 0.103.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.101.0".trim() ? "0.101.0".trim() : "0.1.0";
+  currentVersion = "0.103.0".trim() ? "0.103.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2205,7 +2205,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.101.0".trim() ? "0.101.0".trim() : "0.1.0";
+  currentVersion2 = "0.103.0".trim() ? "0.103.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2799,6 +2799,17 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-embed", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin tracks capture-audio --queue",
+      exposedContent: [
+        "capture each finding's full song once → private R2 (yt-dlp via a residential proxy)"
+      ],
+      kind: "cron",
+      name: "cron.capture",
+      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/full-audio-rfc.md § Unit 1.",
+      probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-capture", kind: "cron" },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks context --queue",
       exposedContent: [
@@ -3529,11 +3540,13 @@ __export(exports_admin_tracks, {
   enrichQueueCommand: () => enrichQueueCommand,
   embedQueueCommand: () => embedQueueCommand,
   contextQueueCommand: () => contextQueueCommand,
+  captureQueueCommand: () => captureQueueCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand
 });
 async function fetchAdminTracks(options) {
   const {
+    captureQueue,
     hasContext,
     hasEmbedding,
     hasKey,
@@ -3558,6 +3571,9 @@ async function fetchAdminTracks(options) {
     if (hasEmbedding !== undefined) {
       params.set("hasEmbedding", String(hasEmbedding));
     }
+    if (captureQueue) {
+      params.set("captureQueue", "true");
+    }
     if (hasContext !== undefined) {
       params.set("hasContext", String(hasContext));
     }
@@ -3613,6 +3629,9 @@ async function enrichQueueCommand(limit) {
 async function embedQueueCommand(limit) {
   return fetchAdminTracks({ hasEmbedding: false, max: limit, order: "asc" });
 }
+async function captureQueueCommand(limit) {
+  return fetchAdminTracks({ captureQueue: true, max: limit, order: "desc" });
+}
 async function contextQueueCommand(limit, retryEmptyContext = false) {
   return fetchAdminTracks({ hasContext: false, max: limit, order: "asc", retryEmptyContext });
 }
@@ -7787,6 +7806,15 @@ function addAdminCommands(program2) {
     const { embedQueueCommand: embedQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminEmbedQueue(options, embedQueueCommand2);
   });
+  adminTracks.command("capture-audio").description("Full-song capture worklist (findings with no source audio yet) \u2014 use --queue").option("--queue", "Show the capture worklist, newest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--json", "Print JSON", false).action(async (options) => {
+    if (!options.queue) {
+      console.error("`tracks capture-audio` is a worklist view \u2014 capture runs on the on-box `fluncle-capture` cron.\nUse `tracks capture-audio --queue` to see findings needing a full-song capture.");
+      process.exitCode = 1;
+      return;
+    }
+    const { captureQueueCommand: captureQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminCaptureQueue(options, captureQueueCommand2);
+  });
   adminTracks.command("vehicles").description("Recent video vehicles, newest first (the style ledger for diversity)").option("--limit <limit>", "Number of vehicles to show", "10").option("--json", "Print JSON", false).action(async (options) => {
     const { vehiclesCommand: vehiclesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminVehicles(options, vehiclesCommand2);
@@ -8011,7 +8039,7 @@ function addAdminCommands(program2) {
   artists.action(() => {
     artists.outputHelp();
   });
-  artists.command("follow").description("Auto-follow high-confidence artists on Spotify + YouTube (drains the queue)").option("--dry-run", "Report who WOULD be followed without calling the platforms", false).option("--limit <limit>", "Max artists to follow this run", "20").option("--json", "Print JSON", false).action(async (options) => {
+  artists.command("follow").description("Auto-follow high-confidence artists on YouTube (drains the queue)").option("--dry-run", "Report who WOULD be followed without calling the platform", false).option("--limit <limit>", "Max artists to follow this run", "20").option("--json", "Print JSON", false).action(async (options) => {
     const { followArtistsCommand: followArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runFollowArtists(options, followArtistsCommand2);
   });
@@ -9091,6 +9119,26 @@ async function runAdminEmbedQueue(options, embedQueueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+async function runAdminCaptureQueue(options, captureQueueCommand2) {
+  const limit = parseListLimit(options.limit);
+  const tracks = await captureQueueCommand2(limit);
+  if (options.json) {
+    printJson({
+      ok: true,
+      tracks
+    });
+    return;
+  }
+  if (tracks.length === 0) {
+    console.log("Nothing awaiting a capture. Every finding has its full song.");
+    return;
+  }
+  const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
+  const noun = tracks.length === 1 ? "finding" : "findings";
+  console.log(`${tracks.length} ${noun} needing a full-song capture, newest first:`);
+  console.log(trackRows2(tracks).join(`
+`));
+}
 async function runAdminVehicles(options, vehiclesCommand2) {
   const limit = parseListLimit(options.limit);
   const vehicles = await vehiclesCommand2(limit);

package/package.json

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