fluncle 0.196.0 → 0.198.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.196.0".trim() ? "0.196.0".trim() : "0.1.0";
+  currentVersion = "0.198.0".trim() ? "0.198.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2443,7 +2443,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.196.0".trim() ? "0.196.0".trim() : "0.1.0";
+  currentVersion2 = "0.198.0".trim() ? "0.198.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3160,7 +3160,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_findings, list_tracks, list_fresh, get_track, get_random_track, get_status, search_archive, get_artist, get_label, build_set, list_similar_artists, list_album_catalogue, list_artist_catalogue, list_label_catalogue, search_tracks, submit_track, subscribe_newsletter",
+        "the archive as MCP tools (Streamable HTTP, no auth): list_findings, list_tracks, list_fresh, get_track, get_random_track, get_status, search_archive, get_artist, get_label, build_set, list_similar_artists, list_album_catalogue, list_artist_catalogue, list_label_catalogue, list_artists, list_albums, list_labels, submit_track, subscribe_newsletter, plus the MCP-only search_tracks (Spotify candidate search, not an archive read)",
         "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"
       ],
@@ -3307,7 +3307,7 @@ var init_src = __esm(() => {
     {
       command: "fluncle admin",
       exposedContent: [
-        "the operator/agent command group (hidden): tracks publish|update|enrich|video|draft|social|preview|observe|context|note, recordings create|promote, mixtapes update|distribute|resync, newsletter draft|update|send|list, backfills, auth"
+        "the operator/agent command group (hidden): a bare `queue` read plus ~22 plural groups — tracks (publish|update|enrich|embed|capture|video|draft|social|preview|observe|context|note|work|get|list|queue|mixable-order|requeue-analysis|vehicles), catalogue (the crawler + The Ear), frontier, labels, artists, albums, galaxies, notes, observations, clips, recordings, publish, capture, mixtapes, newsletter, logbook, prompts, submissions, reach, backfills, migrations, auth"
       ],
       kind: "cli",
       name: "cli.admin",
@@ -3839,7 +3839,7 @@ var init_src = __esm(() => {
       ],
       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.",
+      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/admin-shell.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-funnel-snapshot",
@@ -4317,6 +4317,7 @@ var SOURCE_LABELS;
 var init_admin_attention = __esm(() => {
   init_api();
   SOURCE_LABELS = {
+    "anchor-review": "version check",
     "artist-review": "artist links",
     "attach-cues": "cues",
     "capture-suspect": "capture check",
@@ -12314,10 +12315,14 @@ async function runAdminQueue(options, queueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
-async function runAdminContextQueue(options, contextQueueCommand2) {
+async function runQueueView({
+  emptyMessage,
+  fetch: fetch2,
+  heading,
+  options
+}) {
   const limit = parseListLimit(options.limit);
-  const retryEmpty = options.retryEmpty === true;
-  const tracks = await contextQueueCommand2(limit, retryEmpty);
+  const tracks = await fetch2(limit);
   if (options.json) {
     printJson({
       ok: true,
@@ -12326,115 +12331,64 @@ async function runAdminContextQueue(options, contextQueueCommand2) {
     return;
   }
   if (tracks.length === 0) {
-    console.log("Every finding has its field notes. Nothing waiting on context.");
+    console.log(emptyMessage);
     return;
   }
   const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
   const noun = tracks.length === 1 ? "finding" : "findings";
-  const scope = retryEmpty ? " (incl. empty retries)" : "";
-  console.log(`${tracks.length} ${noun} missing field notes${scope}, oldest first:`);
+  console.log(heading(tracks.length, noun));
   console.log(trackRows2(tracks).join(`
 `));
 }
+async function runAdminContextQueue(options, contextQueueCommand2) {
+  const retryEmpty = options.retryEmpty === true;
+  const scope = retryEmpty ? " (incl. empty retries)" : "";
+  await runQueueView({
+    emptyMessage: "Every finding has its field notes. Nothing waiting on context.",
+    fetch: (limit) => contextQueueCommand2(limit, retryEmpty),
+    heading: (count, noun) => `${count} ${noun} missing field notes${scope}, oldest first:`,
+    options
+  });
+}
 async function runAdminObserveQueue(options, observeQueueCommand2) {
-  const limit = parseListLimit(options.limit);
-  const tracks = await observeQueueCommand2(limit);
-  if (options.json) {
-    printJson({
-      ok: true,
-      tracks
-    });
-    return;
-  }
-  if (tracks.length === 0) {
-    console.log("Every finding with notes has its observation. Nothing waiting on a voice.");
-    return;
-  }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
-  const noun = tracks.length === 1 ? "finding" : "findings";
-  console.log(`${tracks.length} ${noun} awaiting an observation, oldest first:`);
-  console.log(trackRows2(tracks).join(`
-`));
+  await runQueueView({
+    emptyMessage: "Every finding with notes has its observation. Nothing waiting on a voice.",
+    fetch: observeQueueCommand2,
+    heading: (count, noun) => `${count} ${noun} awaiting an observation, oldest first:`,
+    options
+  });
 }
 async function runAdminNoteQueue(options, noteQueueCommand2) {
-  const limit = parseListLimit(options.limit);
-  const tracks = await noteQueueCommand2(limit);
-  if (options.json) {
-    printJson({
-      ok: true,
-      tracks
-    });
-    return;
-  }
-  if (tracks.length === 0) {
-    console.log("Every context'd finding has a note. Nothing waiting on the uncle's words.");
-    return;
-  }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
-  const noun = tracks.length === 1 ? "finding" : "findings";
-  console.log(`${tracks.length} ${noun} awaiting a note, oldest first:`);
-  console.log(trackRows2(tracks).join(`
-`));
+  await runQueueView({
+    emptyMessage: "Every context'd finding has a note. Nothing waiting on the uncle's words.",
+    fetch: noteQueueCommand2,
+    heading: (count, noun) => `${count} ${noun} awaiting a note, oldest first:`,
+    options
+  });
 }
 async function runAdminEnrichQueue(options, enrichQueueCommand2) {
-  const limit = parseListLimit(options.limit);
-  const tracks = await enrichQueueCommand2(limit);
-  if (options.json) {
-    printJson({
-      ok: true,
-      tracks
-    });
-    return;
-  }
-  if (tracks.length === 0) {
-    console.log("Nothing awaiting enrichment. Every finding is enriched.");
-    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 (re-)enrichment, oldest first:`);
-  console.log(trackRows2(tracks).join(`
-`));
+  await runQueueView({
+    emptyMessage: "Nothing awaiting enrichment. Every finding is enriched.",
+    fetch: enrichQueueCommand2,
+    heading: (count, noun) => `${count} ${noun} needing (re-)enrichment, oldest first:`,
+    options
+  });
 }
 async function runAdminEmbedQueue(options, embedQueueCommand2) {
-  const limit = parseListLimit(options.limit);
-  const tracks = await embedQueueCommand2(limit);
-  if (options.json) {
-    printJson({
-      ok: true,
-      tracks
-    });
-    return;
-  }
-  if (tracks.length === 0) {
-    console.log("Nothing awaiting an embedding. Every finding is embedded.");
-    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 an audio embedding, oldest first:`);
-  console.log(trackRows2(tracks).join(`
-`));
+  await runQueueView({
+    emptyMessage: "Nothing awaiting an embedding. Every finding is embedded.",
+    fetch: embedQueueCommand2,
+    heading: (count, noun) => `${count} ${noun} needing an audio embedding, oldest first:`,
+    options
+  });
 }
 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(`
-`));
+  await runQueueView({
+    emptyMessage: "Nothing awaiting a capture. Every finding has its full song.",
+    fetch: captureQueueCommand2,
+    heading: (count, noun) => `${count} ${noun} needing a full-song capture, newest first:`,
+    options
+  });
 }
 var TRACK_WORK_KINDS = new Set(["analyze", "capture", "embed"]);
 var TRACK_WORK_SCOPES = new Set(["all", "catalogue", "findings"]);

package/package.json

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