fluncle 0.35.0 → 0.37.0

package/bin/fluncle.mjs

@@ -3789,7 +3789,7 @@ function parseVersion(version) {
 var currentVersion, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.35.0".trim() ? "0.35.0".trim() : "0.1.0";
+  currentVersion = "0.37.0".trim() ? "0.37.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -3799,6 +3799,7 @@ __export(exports_track, {
   trackUpdateCommand: () => trackUpdateCommand,
   trackSocialUpdateCommand: () => trackSocialUpdateCommand,
   trackSocialShowCommand: () => trackSocialShowCommand,
+  trackObserveCommand: () => trackObserveCommand,
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand
 });
@@ -3892,6 +3893,25 @@ async function trackUpdateCommand(trackId, options) {
   }
   return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
+async function trackObserveCommand(idOrLogId, options) {
+  const body = { script: options.script };
+  if (options.voiceId !== undefined) {
+    body.voiceId = options.voiceId;
+  }
+  if (options.model !== undefined) {
+    body.model = options.model;
+  }
+  if (options.durationMs !== undefined) {
+    body.durationMs = options.durationMs;
+  }
+  if (options.durationTargetSec !== undefined) {
+    body.durationTargetSec = options.durationTargetSec;
+  }
+  if (options.contextNote !== undefined) {
+    body.contextNote = options.contextNote;
+  }
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/observe`, body);
+}
 var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE = "https://found.fluncle.com", VIDEO_FIELDS;
 var init_track = __esm(() => {
   init_api();
@@ -3938,10 +3958,12 @@ var init_add = __esm(() => {
 var exports_admin_tracks = {};
 __export(exports_admin_tracks, {
   vehiclesCommand: () => vehiclesCommand,
-  queueCommand: () => queueCommand
+  queueCommand: () => queueCommand,
+  enrichSweepCommand: () => enrichSweepCommand,
+  enrichQueueCommand: () => enrichQueueCommand
 });
 async function fetchAdminTracks(options) {
-  const { hasVideo, max, order } = options;
+  const { hasVideo, max, order, status } = options;
   const results = [];
   let cursor;
   do {
@@ -3949,6 +3971,9 @@ async function fetchAdminTracks(options) {
     if (hasVideo !== undefined) {
       params.set("hasVideo", String(hasVideo));
     }
+    if (status !== undefined) {
+      params.set("status", status);
+    }
     if (cursor) {
       params.set("cursor", cursor);
     }
@@ -3970,6 +3995,12 @@ async function fetchAdminTracks(options) {
 async function queueCommand(limit) {
   return fetchAdminTracks({ hasVideo: false, max: limit, order: "asc" });
 }
+async function enrichQueueCommand(limit) {
+  return fetchAdminTracks({ max: limit, order: "asc", status: "queue" });
+}
+async function enrichSweepCommand(limit) {
+  return adminApiPost(`/api/admin/enrich-sweep?limit=${limit}`);
+}
 async function vehiclesCommand(limit) {
   const tracks = await fetchAdminTracks({ hasVideo: true, max: limit, order: "desc" });
   return tracks.map((track) => ({
@@ -4929,7 +4960,7 @@ function trackDetailLines(track) {
 var COORD_FALLBACK2 = "—";
 
 // src/cli.ts
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import path from "path";
 
 // ../../node_modules/.bun/commander@14.0.3/node_modules/commander/esm.mjs
@@ -5127,6 +5158,14 @@ function addAdminCommands(program2) {
     const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminQueue(options, queueCommand2);
   });
+  admin.command("enrich-queue").description("Findings needing (re-)enrichment: pending, failed, or stuck processing").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+    const { enrichQueueCommand: enrichQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEnrichQueue(options, enrichQueueCommand2);
+  });
+  admin.command("enrich-sweep").description("Re-fire enrichment for everything in the enrich-queue (idempotent self-heal)").option("--limit <limit>", "Max findings to re-trigger", "25").option("--json", "Print JSON", false).action(async (options) => {
+    const { enrichSweepCommand: enrichSweepCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEnrichSweep(options, enrichSweepCommand2);
+  });
   admin.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);
@@ -5155,6 +5194,10 @@ function addAdminCommands(program2) {
     const { previewArchiveUploadCommand: previewArchiveUploadCommand2 } = await Promise.resolve().then(() => (init_preview_archive(), exports_preview_archive));
     await runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2);
   });
+  adminTrack.command("observe").description("Render Fluncle's spoken field observation for a track (ElevenLabs, Worker-side)").argument("[idOrLogId]").option("--script <text>", "The voice-gated observation script (the spoken text)").option("--script-file <file>", "Read the observation script from a file (e.g. observation.txt)").option("--voice-id <id>", "Override the configured ElevenLabs voice id").option("--model <model>", "TTS model (eleven_multilingual_v2 | eleven_v3)").option("--duration-ms <ms>", "Probed audio duration in ms (the agent runs ffprobe)").option("--duration-target-sec <sec>", "Target observation length in seconds (20\u201345)").option("--context-note <text>", "Pre-fetched factual context (else the Worker firecrawls)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackObserveCommand: trackObserveCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackObserve(idOrLogId, options, trackObserveCommand2);
+  });
   const adminMixtapes = configureCommand(admin.command("mixtapes").description("Mixtape admin commands"));
   adminMixtapes.action(() => {
     adminMixtapes.outputHelp();
@@ -5265,6 +5308,36 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  source: ${result.source}`);
   console.log(`  mime: ${result.mime}`);
 }
+async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
+  const script = options.scriptFile ? readFileSync2(options.scriptFile, "utf8") : options.script;
+  if (!idOrLogId || !script || !script.trim()) {
+    throw new Error("Usage: fluncle admin track observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--model <model>] [--duration-ms <ms>] [--context-note <text>] [--json]");
+  }
+  const durationMs = options.durationMs === undefined ? undefined : Number.parseInt(options.durationMs, 10);
+  if (durationMs !== undefined && (!Number.isInteger(durationMs) || durationMs < 1)) {
+    throw new Error("--duration-ms must be a positive integer");
+  }
+  const durationTargetSec = options.durationTargetSec === undefined ? undefined : Number.parseInt(options.durationTargetSec, 10);
+  if (durationTargetSec !== undefined && (!Number.isInteger(durationTargetSec) || durationTargetSec < 1)) {
+    throw new Error("--duration-target-sec must be a positive integer");
+  }
+  const result = await trackObserveCommand2(idOrLogId, {
+    contextNote: options.contextNote,
+    durationMs,
+    durationTargetSec,
+    model: options.model,
+    script: script.trim(),
+    voiceId: options.voiceId
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Recorded observation for ${result.logId}`);
+  console.log(`  audio: ${result.audioUrl}`);
+  console.log(`  length: ${Math.round(result.durationMs / 1000)}s`);
+  console.log(`  voice: ${result.voiceId}`);
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {
@@ -5653,6 +5726,52 @@ async function runAdminQueue(options, queueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+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(() => exports_format);
+  const noun = tracks.length === 1 ? "finding" : "findings";
+  console.log(`${tracks.length} ${noun} needing (re-)enrichment, oldest first:`);
+  console.log(trackRows2(tracks).join(`
+`));
+}
+async function runAdminEnrichSweep(options, enrichSweepCommand2) {
+  const limit = parseListLimit(options.limit);
+  const result = await enrichSweepCommand2(limit);
+  if (options.json) {
+    printJson({
+      ok: true,
+      reEnriched: result.reEnriched,
+      reEnrichedCount: result.reEnrichedCount,
+      skipped: result.skipped,
+      skippedCount: result.skippedCount
+    });
+    return;
+  }
+  if (result.reEnrichedCount === 0 && result.skippedCount === 0) {
+    console.log("Nothing to sweep. The enrich-queue is empty.");
+    return;
+  }
+  const noun = result.reEnrichedCount === 1 ? "finding" : "findings";
+  console.log(`Re-fired enrichment for ${result.reEnrichedCount} ${noun}.`);
+  for (const entry of result.reEnriched) {
+    console.log(`  ${entry.logId || entry.trackId} (was ${entry.status})`);
+  }
+  if (result.skippedCount > 0) {
+    console.log(`Skipped ${result.skippedCount} with no Log ID yet.`);
+  }
+}
 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.35.0"
+  "version": "0.37.0"
 }