fluncle 0.46.0 → 0.48.0

package/bin/fluncle.mjs

@@ -2497,7 +2497,24 @@ var require_main = __commonJS((exports, module) => {
   module.exports = DotenvModule;
 });
 
+// ../../packages/contracts/src/util.ts
+function formatDuration(durationMs) {
+  const totalSeconds = Math.round(durationMs / 1000);
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  return `${minutes}:${seconds.toString().padStart(2, "0")}`;
+}
+function formatError(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+
 // src/output.ts
+function isJsonFailure(value) {
+  return typeof value === "object" && value !== null && typeof value.code === "string" && typeof value.message === "string";
+}
 function printJson2(value) {
   console.log(JSON.stringify(value, null, 2));
 }
@@ -2539,7 +2556,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.48.0".trim() ? "0.48.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2727,11 +2744,20 @@ import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 function loadEnv(keys) {
   loadConfig();
-  const missing = keys.filter((key) => !process.env[key]);
+  const result = {};
+  const missing = [];
+  for (const key of keys) {
+    const value = process.env[key];
+    if (value === undefined) {
+      missing.push(key);
+      continue;
+    }
+    result[key] = value;
+  }
   if (missing.length > 0) {
     throw new Error(`Missing required env vars: ${missing.join(", ")}`);
   }
-  return Object.fromEntries(keys.map((key) => [key, process.env[key]]));
+  return result;
 }
 function getApiBaseUrl() {
   loadConfig();
@@ -2833,7 +2859,7 @@ async function apiRequest(path, init = {}) {
   const text = await response.text();
   const data = parseJson(text);
   if (!response.ok) {
-    const failure = data;
+    const failure = isJsonFailure(data) ? data : undefined;
     throw new CliError2(failure?.code ?? `http_${response.status}`, failure?.message ?? `${response.status} ${response.statusText}`);
   }
   return data;
@@ -3485,6 +3511,7 @@ function artistTitle(track) {
   return `${track.artists.join(", ")} — ${track.title}`;
 }
 var COORD_FALLBACK = "—";
+var init_format = () => {};
 
 // src/interactive.ts
 import { createInterface } from "node:readline/promises";
@@ -3732,6 +3759,7 @@ function buildSelectorLines(tracks, selectedIndex, columns) {
 }
 var TELEGRAM_APP_URI = "tg://resolve?domain=fluncle", SPOTIFY_PLAYLIST_OPEN_URL, SELECT_NON_INTERACTIVE_MESSAGE = "fluncle open requires an interactive terminal. Use fluncle recent to list tracks.";
 var init_open = __esm(() => {
+  init_format();
   init_interactive();
   init_output();
   init_recent2();
@@ -4001,7 +4029,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.48.0".trim() ? "0.48.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -4013,7 +4041,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 +4155,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 +4210,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 +4226,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 +4253,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}`);
 }
@@ -5188,12 +5249,6 @@ function vehicleRows(rows) {
     return `${coordinate2(row).padEnd(coordWidth)}  ${foundDate(row.addedAt)}  ${row.vehicle ?? COORD_FALLBACK2}`;
   });
 }
-function formatDuration(durationMs) {
-  const totalSeconds = Math.round(durationMs / 1000);
-  const minutes = Math.floor(totalSeconds / 60);
-  const seconds = totalSeconds % 60;
-  return `${minutes}:${seconds.toString().padStart(2, "0")}`;
-}
 function trackDetailLines(track) {
   const lines = [`${coordinate2(track)}  ${artistTitle2(track)}`];
   const meta = [];
@@ -5209,6 +5264,7 @@ function trackDetailLines(track) {
   return lines;
 }
 var COORD_FALLBACK2 = "—";
+var init_format2 = () => {};
 
 // src/cli.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
@@ -5292,15 +5348,6 @@ function toJsonFailure(error) {
     ok: false
   };
 }
-
-// src/retry.ts
-function formatError(error) {
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return String(error);
-}
-
 // src/cli.ts
 function createProgram() {
   const program2 = configureCommand(new Command);
@@ -5415,14 +5462,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 +5531,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 +5683,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)) {
@@ -6020,7 +6102,7 @@ async function runRecent(options, recentCommand3) {
   if (options.limit === undefined && !options.json && process.stdout.isTTY === true && process.stdin.isTTY === true) {
     const { fetchRecentPage: fetchRecentPage2 } = await Promise.resolve().then(() => (init_recent(), exports_recent));
     const { paginateWithKeyboard: paginateWithKeyboard2 } = await Promise.resolve().then(() => (init_interactive2(), exports_interactive));
-    const { trackRows: trackRows3 } = await Promise.resolve().then(() => exports_format);
+    const { trackRows: trackRows3 } = await Promise.resolve().then(() => (init_format2(), exports_format));
     await paginateWithKeyboard2({
       emptyMessage: "No findings logged yet.",
       fetchPage: async (cursor) => {
@@ -6048,7 +6130,7 @@ async function runRecent(options, recentCommand3) {
     console.log("No findings logged yet.");
     return;
   }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => exports_format);
+  const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
   console.log(trackRows2(tracks).join(`
 `));
 }
@@ -6062,7 +6144,7 @@ async function runMixtapes(options, mixtapesCommand2) {
     console.log("No mixtapes logged yet.");
     return;
   }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => exports_format);
+  const { trackRows: trackRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
   console.log(trackRows2(mixtapes).join(`
 `));
 }
@@ -6075,7 +6157,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,
@@ -6087,12 +6172,52 @@ async function runAdminQueue(options, queueCommand2) {
     console.log("Every finding has a video. Nothing in the render queue.");
     return;
   }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => exports_format);
+  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 video, oldest first:`);
   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(() => (init_format2(), 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(() => (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(`
+`));
+}
 async function runAdminEnrichQueue(options, enrichQueueCommand2) {
   const limit = parseListLimit(options.limit);
   const tracks = await enrichQueueCommand2(limit);
@@ -6107,7 +6232,7 @@ async function runAdminEnrichQueue(options, enrichQueueCommand2) {
     console.log("Nothing awaiting enrichment. Every finding is enriched.");
     return;
   }
-  const { trackRows: trackRows2 } = await Promise.resolve().then(() => exports_format);
+  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(`
@@ -6156,7 +6281,7 @@ async function runAdminVehicles(options, vehiclesCommand2) {
     console.log("No videos rendered yet.");
     return;
   }
-  const { vehicleRows: vehicleRows2 } = await Promise.resolve().then(() => exports_format);
+  const { vehicleRows: vehicleRows2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
   console.log("Recent video vehicles, newest first:");
   console.log(vehicleRows2(vehicles).join(`
 `));
@@ -6198,7 +6323,7 @@ async function runRandom(options, randomCommand2) {
     });
     return;
   }
-  const { trackDetailLines: trackDetailLines2 } = await Promise.resolve().then(() => exports_format);
+  const { trackDetailLines: trackDetailLines2 } = await Promise.resolve().then(() => (init_format2(), exports_format));
   console.log(trackDetailLines2(track).join(`
 `));
   if (track.note) {
@@ -6348,6 +6473,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.48.0"
 }