fluncle 0.45.0 → 0.47.0

package/bin/fluncle.mjs

@@ -48,7 +48,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/error.js
+// ../../node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
   class CommanderError extends Error {
     constructor(exitCode, code, message) {
@@ -72,7 +72,7 @@ var require_error = __commonJS((exports) => {
   exports.InvalidArgumentError = InvalidArgumentError;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/argument.js
+// ../../node_modules/commander/lib/argument.js
 var require_argument = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -152,7 +152,7 @@ var require_argument = __commonJS((exports) => {
   exports.humanReadableArgName = humanReadableArgName;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/help.js
+// ../../node_modules/commander/lib/help.js
 var require_help = __commonJS((exports) => {
   var { humanReadableArgName } = require_argument();
 
@@ -509,7 +509,7 @@ ${itemIndentStr}`);
   exports.stripColor = stripColor;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/option.js
+// ../../node_modules/commander/lib/option.js
 var require_option = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -693,7 +693,7 @@ var require_option = __commonJS((exports) => {
   exports.DualOptions = DualOptions;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/suggestSimilar.js
+// ../../node_modules/commander/lib/suggestSimilar.js
 var require_suggestSimilar = __commonJS((exports) => {
   var maxDistance = 3;
   function editDistance(a, b) {
@@ -766,7 +766,7 @@ var require_suggestSimilar = __commonJS((exports) => {
   exports.suggestSimilar = suggestSimilar;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/lib/command.js
+// ../../node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
   var EventEmitter = __require("node:events").EventEmitter;
   var childProcess = __require("node:child_process");
@@ -2121,7 +2121,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
   exports.useColor = useColor;
 });
 
-// ../../node_modules/.bun/commander@14.0.3/node_modules/commander/index.js
+// ../../node_modules/commander/index.js
 var require_commander = __commonJS((exports) => {
   var { Argument } = require_argument();
   var { Command } = require_command();
@@ -2141,7 +2141,7 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// ../../node_modules/.bun/dotenv@16.6.1/node_modules/dotenv/package.json
+// ../../node_modules/dotenv/package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "dotenv",
@@ -2207,7 +2207,7 @@ var require_package = __commonJS((exports, module) => {
   };
 });
 
-// ../../node_modules/.bun/dotenv@16.6.1/node_modules/dotenv/lib/main.js
+// ../../node_modules/dotenv/lib/main.js
 var require_main = __commonJS((exports, module) => {
   var fs = __require("fs");
   var path = __require("path");
@@ -2539,7 +2539,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.45.0".trim() ? "0.45.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.45.0".trim() ? "0.45.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}`);
 }
@@ -4631,8 +4664,12 @@ __export(exports_submissions, {
   approveSubmissionCommand: () => approveSubmissionCommand
 });
 import { createInterface as createInterface2 } from "node:readline/promises";
-async function listSubmissionsCommand() {
+async function listSubmissionsCommand(options = {}) {
   const response = await adminApiGet("/api/admin/submissions");
+  if (options.json) {
+    printJson2({ ok: true, submissions: response.submissions });
+    return;
+  }
   if (response.submissions.length === 0) {
     console.log("No pending submissions.");
     return;
@@ -4641,30 +4678,45 @@ async function listSubmissionsCommand() {
 
 `));
 }
-async function reviewSubmissionCommand(submissionId) {
+async function reviewSubmissionCommand(submissionId, options = {}) {
   const submission = await fetchSubmission(submissionId);
+  if (options.json) {
+    printJson2({ ok: true, submission });
+    return;
+  }
   console.log(formatSubmissionDetail(submission));
 }
-async function rejectSubmissionCommand(submissionId) {
+async function rejectSubmissionCommand(submissionId, options = {}) {
   const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submissionId)}/reject`);
+  if (options.json) {
+    printJson2({ ok: true, submission: response.submission });
+    return;
+  }
   console.log(`Rejected ${formatTrackLine(response.submission)}.`);
 }
-async function approveSubmissionCommand(submissionId) {
+async function approveSubmissionCommand(submissionId, options = {}) {
   const submission = await fetchSubmission(submissionId);
-  console.log(formatSubmissionDetail(submission));
-  console.log("");
-  await addCommand2(submission.spotifyUrl, {
-    dryRun: true
-  });
-  const confirmed = await confirm("Publish this submission? (Y/n) ");
-  if (!confirmed) {
-    console.log("Approval cancelled.");
-    return;
+  if (!options.json) {
+    console.log(formatSubmissionDetail(submission));
+    console.log("");
+    await addCommand2(submission.spotifyUrl, {
+      dryRun: true
+    });
+    const confirmed = await confirm("Publish this submission? (Y/n) ");
+    if (!confirmed) {
+      console.log("Approval cancelled.");
+      return;
+    }
   }
   await addCommand2(submission.spotifyUrl, {
+    json: options.json,
     note: submission.note
   });
-  await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submission.id)}/approve`);
+  const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submission.id)}/approve`);
+  if (options.json) {
+    printJson2({ ok: true, submission: response.submission });
+    return;
+  }
   console.log(`Approved ${formatTrackLine(submission)}.`);
 }
 async function fetchSubmission(submissionId) {
@@ -4673,7 +4725,7 @@ async function fetchSubmission(submissionId) {
 }
 async function confirm(label) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    return false;
+    throw new CliError2("not_interactive", "Approving publishes a submission and needs a yes. Run this in a terminal, or pass --json to approve without the prompt.");
   }
   const rl = createInterface2({
     input: process.stdin,
@@ -4713,6 +4765,7 @@ function formatTrackLine(submission) {
 }
 var init_submissions = __esm(() => {
   init_api();
+  init_output();
   init_add2();
 });
 
@@ -5194,7 +5247,7 @@ var COORD_FALLBACK2 = "—";
 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
+// ../../node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
   program,
@@ -5395,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);
@@ -5456,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();
@@ -5497,30 +5562,30 @@ function addAdminCommands(program2) {
     await runMixtapePublishYoutube(idOrLogId, options, publishYoutubeCommand3);
   });
   const submissions = configureCommand(admin.command("submissions").description("Review listener submissions"));
-  submissions.action(async () => {
+  submissions.option("--json", "Print JSON", false).action(async (options) => {
     const { listSubmissionsCommand: listSubmissionsCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
-    await listSubmissionsCommand2();
+    await listSubmissionsCommand2(options);
   });
-  submissions.command("review").description("Inspect one submission").argument("[submissionId]").action(async (submissionId) => {
+  submissions.command("review").description("Inspect one submission").argument("[submissionId]").option("--json", "Print JSON", false).action(async (submissionId, options) => {
     if (!submissionId) {
       throw new Error("Missing submission id for: review");
     }
     const { reviewSubmissionCommand: reviewSubmissionCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
-    await reviewSubmissionCommand2(submissionId);
+    await reviewSubmissionCommand2(submissionId, options);
   });
-  submissions.command("reject").description("Reject a submission").argument("[submissionId]").action(async (submissionId) => {
+  submissions.command("reject").description("Reject a submission").argument("[submissionId]").option("--json", "Print JSON", false).action(async (submissionId, options) => {
     if (!submissionId) {
       throw new Error("Missing submission id for: reject");
     }
     const { rejectSubmissionCommand: rejectSubmissionCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
-    await rejectSubmissionCommand2(submissionId);
+    await rejectSubmissionCommand2(submissionId, options);
   });
-  submissions.command("approve").description("Approve a submission").argument("[submissionId]").action(async (submissionId) => {
+  submissions.command("approve").description("Approve a submission (--json approves without the confirm prompt)").argument("[submissionId]").option("--json", "Print JSON, skip the confirm prompt", false).action(async (submissionId, options) => {
     if (!submissionId) {
       throw new Error("Missing submission id for: approve");
     }
     const { approveSubmissionCommand: approveSubmissionCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
-    await approveSubmissionCommand2(submissionId);
+    await approveSubmissionCommand2(submissionId, options);
   });
   const auth = configureCommand(admin.command("auth").description("Authentication commands"));
   auth.command("spotify").description("Authorize Spotify access").action(async () => {
@@ -5604,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)) {
@@ -6055,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,
@@ -6073,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);
@@ -6328,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.45.0"
+  "version": "0.47.0"
 }