fluncle 0.97.0 → 0.98.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.97.0".trim() ? "0.97.0".trim() : "0.1.0";
+  currentVersion = "0.98.0".trim() ? "0.98.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2187,7 +2187,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.97.0".trim() ? "0.97.0".trim() : "0.1.0";
+  currentVersion2 = "0.98.0".trim() ? "0.98.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2737,6 +2737,17 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-enrich", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin tracks embed --queue",
+      exposedContent: [
+        "MuQ-large audio embedding (1024-d) for sonic similarity + clusters (--no-agent, on-box torch)"
+      ],
+      kind: "cron",
+      name: "cron.embed",
+      operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/audio-embedding-rfc.md.",
+      probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-embed", kind: "cron" },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks context --queue",
       exposedContent: [
@@ -3079,6 +3090,9 @@ async function trackUpdateCommand(trackId, options) {
   if (options.features !== undefined) {
     body.features = options.features;
   }
+  if (options.embedding !== undefined) {
+    body.embedding = options.embedding;
+  }
   if (options.note !== undefined) {
     body.note = options.note;
   }
@@ -3441,6 +3455,7 @@ __export(exports_admin_tracks, {
   noteQueueCommand: () => noteQueueCommand,
   listCommand: () => listCommand,
   enrichQueueCommand: () => enrichQueueCommand,
+  embedQueueCommand: () => embedQueueCommand,
   contextQueueCommand: () => contextQueueCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand
@@ -3448,6 +3463,7 @@ __export(exports_admin_tracks, {
 async function fetchAdminTracks(options) {
   const {
     hasContext,
+    hasEmbedding,
     hasKey,
     hasNote,
     hasObservation,
@@ -3467,6 +3483,9 @@ async function fetchAdminTracks(options) {
     if (hasKey !== undefined) {
       params.set("hasKey", String(hasKey));
     }
+    if (hasEmbedding !== undefined) {
+      params.set("hasEmbedding", String(hasEmbedding));
+    }
     if (hasContext !== undefined) {
       params.set("hasContext", String(hasContext));
     }
@@ -3519,6 +3538,9 @@ async function queueCommand(limit, filters = {}) {
 async function enrichQueueCommand(limit) {
   return fetchAdminTracks({ max: limit, order: "asc", status: "queue" });
 }
+async function embedQueueCommand(limit) {
+  return fetchAdminTracks({ hasEmbedding: false, max: limit, order: "asc" });
+}
 async function contextQueueCommand(limit, retryEmptyContext = false) {
   return fetchAdminTracks({ hasContext: false, max: limit, order: "asc", retryEmptyContext });
 }
@@ -7641,6 +7663,15 @@ function addAdminCommands(program2) {
     const { enrichQueueCommand: enrichQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminEnrichQueue(options, enrichQueueCommand2);
   });
+  adminTracks.command("embed").description("Audio-embedding worklist (findings with no MuQ vector yet) \u2014 use --queue").option("--queue", "Show the embedding worklist, oldest 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 embed` is a worklist view \u2014 embedding runs on the on-box `fluncle-embed` cron.\nUse `tracks embed --queue` to see findings needing an audio embedding.");
+      process.exitCode = 1;
+      return;
+    }
+    const { embedQueueCommand: embedQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEmbedQueue(options, embedQueueCommand2);
+  });
   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);
@@ -7650,7 +7681,7 @@ function addAdminCommands(program2) {
     const { trackGetAdminCommand: trackGetAdminCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2);
   });
-  adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--bpm <number>", "Track BPM").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
+  adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--bpm <number>", "Track BPM").option("--embedding <json>", "MuQ audio embedding as a JSON array of 1024 floats").option("--embedding-file <file>", "Read the MuQ embedding JSON array from a file").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
     const { trackUpdateCommand: trackUpdateCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackUpdate(trackId, options, trackUpdateCommand2);
   });
@@ -8260,6 +8291,21 @@ async function runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2) {
     console.log(`Log: ${t.logPageUrl}`);
   }
 }
+function parseEmbeddingArg(raw) {
+  if (raw === undefined) {
+    return;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error("Invalid --embedding: expected a JSON array of 1024 floats");
+  }
+  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "number" || !Number.isFinite(value))) {
+    throw new Error("Invalid --embedding: expected a JSON array of 1024 finite numbers");
+  }
+  return parsed;
+}
 async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   if (!trackId) {
     throw new Error("Missing track id. Usage: fluncle admin tracks update <track_id>");
@@ -8268,8 +8314,11 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   if (bpm !== undefined && !Number.isFinite(bpm)) {
     throw new Error(`Invalid --bpm: ${options.bpm}`);
   }
+  const embeddingRaw = options.embeddingFile ? readFileSync6(options.embeddingFile, "utf8") : options.embedding;
+  const embedding = parseEmbeddingArg(embeddingRaw);
   const result = await trackUpdateCommand2(trackId, {
     bpm,
+    embedding,
     features: options.features,
     key: options.key,
     note: options.note,
@@ -8732,6 +8781,26 @@ async function runAdminEnrichQueue(options, enrichQueueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+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(`
+`));
+}
 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.97.0"
+  "version": "0.98.0"
 }