fluncle 0.46.0 → 0.47.0

package/bin/fluncle.mjs

@@ -2539,7 +2539,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.46.0".trim() ? "0.46.0".trim() : "0.1.0";
+  currentVersion = "0.47.0".trim() ? "0.47.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -4001,7 +4001,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.46.0".trim() ? "0.46.0".trim() : "0.1.0";
+  currentVersion2 = "0.47.0".trim() ? "0.47.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -4013,7 +4013,8 @@ __export(exports_track, {
   trackSocialShowCommand: () => trackSocialShowCommand,
   trackObserveCommand: () => trackObserveCommand,
   trackGetCommand: () => trackGetCommand,
-  trackDraftCommand: () => trackDraftCommand
+  trackDraftCommand: () => trackDraftCommand,
+  trackContextCommand: () => trackContextCommand
 });
 async function trackGetCommand(idOrLogId) {
   return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
@@ -4126,6 +4127,13 @@ async function trackObserveCommand(idOrLogId, options) {
   }
   return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/observe`, body);
 }
+async function trackContextCommand(idOrLogId, options = {}) {
+  const body = {};
+  if (options.query !== undefined) {
+    body.query = options.query;
+  }
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/context`, 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();
@@ -4174,13 +4182,15 @@ var exports_admin_tracks = {};
 __export(exports_admin_tracks, {
   vehiclesCommand: () => vehiclesCommand,
   queueCommand: () => queueCommand,
+  observeQueueCommand: () => observeQueueCommand,
   enrichSweepCommand: () => enrichSweepCommand,
   enrichQueueCommand: () => enrichQueueCommand,
+  contextQueueCommand: () => contextQueueCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand
 });
 async function fetchAdminTracks(options) {
-  const { hasVideo, max, order, status } = options;
+  const { hasContext, hasObservation, hasVideo, max, order, status } = options;
   const results = [];
   let cursor;
   do {
@@ -4188,6 +4198,12 @@ async function fetchAdminTracks(options) {
     if (hasVideo !== undefined) {
       params.set("hasVideo", String(hasVideo));
     }
+    if (hasContext !== undefined) {
+      params.set("hasContext", String(hasContext));
+    }
+    if (hasObservation !== undefined) {
+      params.set("hasObservation", String(hasObservation));
+    }
     if (status !== undefined) {
       params.set("status", status);
     }
@@ -4209,12 +4225,29 @@ async function fetchAdminTracks(options) {
   } while (cursor);
   return results;
 }
-async function queueCommand(limit) {
-  return fetchAdminTracks({ hasVideo: false, max: limit, order: "asc" });
+async function queueCommand(limit, filters = {}) {
+  return fetchAdminTracks({
+    hasContext: filters.hasContext,
+    hasObservation: filters.hasObservation,
+    hasVideo: false,
+    max: limit,
+    order: "asc"
+  });
 }
 async function enrichQueueCommand(limit) {
   return fetchAdminTracks({ max: limit, order: "asc", status: "queue" });
 }
+async function contextQueueCommand(limit) {
+  return fetchAdminTracks({ hasContext: false, max: limit, order: "asc" });
+}
+async function observeQueueCommand(limit) {
+  return fetchAdminTracks({
+    hasContext: true,
+    hasObservation: false,
+    max: limit,
+    order: "asc"
+  });
+}
 async function enrichSweepCommand(limit) {
   return adminApiPost(`/api/admin/tracks/enrich?limit=${limit}`);
 }
@@ -5415,14 +5448,22 @@ function addAdminCommands(program2) {
     const { addCommand: addCommand3 } = await Promise.resolve().then(() => (init_add(), exports_add));
     await runAdd(spotifyUrl, options, addCommand3);
   });
-  adminTracks.command("queue").description("Findings awaiting a video, oldest first (the next to film is first)").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("queue").description("Findings awaiting a video, oldest first (the next to film is first)").option("--limit <limit>", "Number of findings to show", "10").option("--has-context", "Only findings whose field notes are already gathered").option("--has-observation", "Only findings that already have a spoken observation").option("--json", "Print JSON", false).action(async (options) => {
     const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminQueue(options, queueCommand2);
   });
-  admin.command("queue", { hidden: true }).description("Render queue (alias of `admin tracks queue`)").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+  admin.command("queue", { hidden: true }).description("Render queue (alias of `admin tracks queue`)").option("--limit <limit>", "Number of findings to show", "10").option("--has-context", "Only findings whose field notes are already gathered").option("--has-observation", "Only findings that already have a spoken observation").option("--json", "Print JSON", false).action(async (options) => {
     const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminQueue(options, queueCommand2);
   });
+  adminTracks.command("context-queue").description("Findings missing their field notes, oldest first (the context cron's worklist)").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+    const { contextQueueCommand: contextQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminContextQueue(options, contextQueueCommand2);
+  });
+  adminTracks.command("observe-queue").description("Findings with notes but no observation yet, oldest first (the observe cron's worklist)").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+    const { observeQueueCommand: observeQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminObserveQueue(options, observeQueueCommand2);
+  });
   adminTracks.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);
@@ -5476,6 +5517,10 @@ function addAdminCommands(program2) {
     const { trackObserveCommand: trackObserveCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackObserve(idOrLogId, options, trackObserveCommand2);
   });
+  adminTrack.command("context").description("Gather the field notes for a finding (facts only; observe speaks from them)").argument("[idOrLogId]").option("--query <text>", "Override the fact-search query (else the Worker builds one)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackContextCommand: trackContextCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackContext(idOrLogId, options, trackContextCommand2);
+  });
   const adminMixtapes = configureCommand(admin.command("mixtapes").description("Mixtape admin commands"));
   adminMixtapes.action(() => {
     adminMixtapes.outputHelp();
@@ -5624,6 +5669,29 @@ async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
   console.log(`  length: ${Math.round(result.durationMs / 1000)}s`);
   console.log(`  voice: ${result.voiceId}`);
 }
+async function runTrackContext(idOrLogId, options, trackContextCommand2) {
+  if (!idOrLogId) {
+    throw new Error("Usage: fluncle admin tracks context <track_id|log_id> [--query <text>] [--json]");
+  }
+  const result = await trackContextCommand2(idOrLogId, { query: options.query });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  if (result.skipped) {
+    console.log(`Field notes already on file for ${result.logId}. Nothing to gather.`);
+    return;
+  }
+  if (!result.contextNote.trim()) {
+    console.log(`No field notes turned up for ${result.logId}. The queue will swing back around.`);
+    return;
+  }
+  console.log(`Gathered field notes for ${result.logId}:`);
+  console.log(`  ${result.contextNote}`);
+  if (result.sources.length > 0) {
+    console.log(`  sources: ${result.sources.join(", ")}`);
+  }
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {
@@ -6075,7 +6143,10 @@ function parseListLimit(value) {
 }
 async function runAdminQueue(options, queueCommand2) {
   const limit = parseListLimit(options.limit);
-  const tracks = await queueCommand2(limit);
+  const tracks = await queueCommand2(limit, {
+    hasContext: options.hasContext ? true : undefined,
+    hasObservation: options.hasObservation ? true : undefined
+  });
   if (options.json) {
     printJson({
       ok: true,
@@ -6093,6 +6164,46 @@ async function runAdminQueue(options, queueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+async function runAdminContextQueue(options, contextQueueCommand2) {
+  const limit = parseListLimit(options.limit);
+  const tracks = await contextQueueCommand2(limit);
+  if (options.json) {
+    printJson({
+      ok: true,
+      tracks
+    });
+    return;
+  }
+  if (tracks.length === 0) {
+    console.log("Every finding has its field notes. Nothing waiting on context.");
+    return;
+  }
+  const { trackRows: trackRows2 } = await Promise.resolve().then(() => exports_format);
+  const noun = tracks.length === 1 ? "finding" : "findings";
+  console.log(`${tracks.length} ${noun} missing field notes, oldest first:`);
+  console.log(trackRows2(tracks).join(`
+`));
+}
+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(() => exports_format);
+  const noun = tracks.length === 1 ? "finding" : "findings";
+  console.log(`${tracks.length} ${noun} awaiting an observation, oldest first:`);
+  console.log(trackRows2(tracks).join(`
+`));
+}
 async function runAdminEnrichQueue(options, enrichQueueCommand2) {
   const limit = parseListLimit(options.limit);
   const tracks = await enrichQueueCommand2(limit);
@@ -6348,6 +6459,7 @@ var stringOptions = new Set([
   "--platform",
   "--poster",
   "--props",
+  "--query",
   "--recorded-at",
   "--render",
   "--scheduled-for",

package/package.json

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