fluncle 0.56.0 → 0.58.0

package/bin/fluncle.mjs

@@ -423,7 +423,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.56.0".trim() ? "0.56.0".trim() : "0.1.0";
+  currentVersion = "0.58.0".trim() ? "0.58.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -782,6 +782,7 @@ function mapTrack(track) {
     title: track.title,
     trackId: track.trackId,
     type: "finding",
+    videoGrain: track.videoGrain,
     videoModel: track.videoModel,
     videoModelReasoning: track.videoModelReasoning,
     videoUrl: track.videoUrl,
@@ -1531,6 +1532,7 @@ function mapTrack2(track) {
     title: track.title,
     trackId: track.trackId,
     type: "finding",
+    videoGrain: track.videoGrain,
     videoModel: track.videoModel,
     videoModelReasoning: track.videoModelReasoning,
     videoUrl: track.videoUrl,
@@ -1912,7 +1914,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.56.0".trim() ? "0.56.0".trim() : "0.1.0";
+  currentVersion2 = "0.58.0".trim() ? "0.58.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -1922,7 +1924,10 @@ __export(exports_track, {
   trackUpdateCommand: () => trackUpdateCommand,
   trackSocialUpdateCommand: () => trackSocialUpdateCommand,
   trackSocialShowCommand: () => trackSocialShowCommand,
+  trackRequeueVideoCommand: () => trackRequeueVideoCommand,
+  trackPurgeVideoCommand: () => trackPurgeVideoCommand,
   trackObserveCommand: () => trackObserveCommand,
+  trackNoteCommand: () => trackNoteCommand,
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand,
   trackContextCommand: () => trackContextCommand
@@ -1963,7 +1968,8 @@ async function trackVideoCommand(idOrLogId, files, onProgress) {
     videoModel,
     videoModelReasoning,
     ...squared ? { squared: true } : {},
-    ...manifest.vehicle ? { videoVehicle: manifest.vehicle } : {}
+    ...manifest.vehicle ? { videoVehicle: manifest.vehicle } : {},
+    ...manifest.grain ? { videoGrain: manifest.grain } : {}
   });
   return { logId: finalize.logId, ok: true, trackId: finalize.trackId, urls };
 }
@@ -1971,7 +1977,7 @@ async function readManifestFields(renderPath) {
   try {
     const manifest = await Bun.file(renderPath).json();
     const result = {};
-    for (const key of ["vehicle", "model", "reasoning"]) {
+    for (const key of ["vehicle", "grain", "model", "reasoning"]) {
       const value = manifest[key];
       if (typeof value === "string" && value.trim()) {
         result[key] = value.trim().slice(0, 120);
@@ -2019,6 +2025,12 @@ async function trackUpdateCommand(trackId, options) {
   }
   return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
+async function trackRequeueVideoCommand(idOrLogId) {
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/requeue`);
+}
+async function trackPurgeVideoCommand(idOrLogId) {
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/purge`);
+}
 async function trackObserveCommand(idOrLogId, options) {
   const body = { script: options.script };
   if (options.voiceId !== undefined) {
@@ -2043,8 +2055,15 @@ async function trackContextCommand(idOrLogId, options = {}) {
   if (options.query !== undefined) {
     body.query = options.query;
   }
+  if (options.refresh) {
+    body.refresh = true;
+  }
   return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/context`, body);
 }
+async function trackNoteCommand(idOrLogId, options) {
+  const body = { note: options.note };
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/note`, 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();
@@ -2094,6 +2113,7 @@ __export(exports_admin_tracks, {
   vehiclesCommand: () => vehiclesCommand,
   queueCommand: () => queueCommand,
   observeQueueCommand: () => observeQueueCommand,
+  noteQueueCommand: () => noteQueueCommand,
   enrichQueueCommand: () => enrichQueueCommand,
   contextQueueCommand: () => contextQueueCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
@@ -2101,7 +2121,7 @@ __export(exports_admin_tracks, {
   backfillAlignmentCommand: () => backfillAlignmentCommand
 });
 async function fetchAdminTracks(options) {
-  const { hasContext, hasObservation, hasVideo, max, order, status } = options;
+  const { hasContext, hasNote, hasObservation, hasVideo, max, order, status } = options;
   const results = [];
   let cursor;
   do {
@@ -2112,6 +2132,9 @@ async function fetchAdminTracks(options) {
     if (hasContext !== undefined) {
       params.set("hasContext", String(hasContext));
     }
+    if (hasNote !== undefined) {
+      params.set("hasNote", String(hasNote));
+    }
     if (hasObservation !== undefined) {
       params.set("hasObservation", String(hasObservation));
     }
@@ -2159,6 +2182,14 @@ async function observeQueueCommand(limit) {
     order: "asc"
   });
 }
+async function noteQueueCommand(limit) {
+  return fetchAdminTracks({
+    hasContext: true,
+    hasNote: false,
+    max: limit,
+    order: "asc"
+  });
+}
 async function backfillLastfmCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -2185,6 +2216,7 @@ async function vehiclesCommand(limit) {
   return tracks.map((track) => ({
     addedAt: track.addedAt,
     artists: track.artists,
+    grain: track.videoGrain,
     logId: track.logId,
     title: track.title,
     vehicle: track.videoVehicle
@@ -5470,6 +5502,14 @@ function addAdminCommands(program2) {
     const { trackVideoCommand: trackVideoCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackVideo(idOrLogId, options, trackVideoCommand2);
   });
+  adminTrack.command("requeue-video").description("Clear a finding's video so it re-enters the render queue (operator)").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackRequeueVideoCommand: trackRequeueVideoCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackRequeueVideo(idOrLogId, options, trackRequeueVideoCommand2);
+  });
+  adminTrack.command("purge-video").description("Purge a finding's stale Cloudflare video renditions from the edge (operator)").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackPurgeVideoCommand: trackPurgeVideoCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand2);
+  });
   adminTrack.command("draft").description("Push the video to a platform as a draft").argument("[idOrLogId]").option("--json", "Print JSON", false).option("--platform <platform>", "Publishing platform").allowExcessArguments().action(async (idOrLogId, options) => {
     const { trackDraftCommand: trackDraftCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackDraft(idOrLogId, options, trackDraftCommand2);
@@ -5491,7 +5531,7 @@ 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("--queue", "Show the context worklist (findings missing field notes), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--query <text>", "Override the fact-search query (else the Worker builds one)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  adminTrack.command("context").description("Gather the field notes for a finding (facts only; observe speaks from them)").argument("[idOrLogId]").option("--queue", "Show the context worklist (findings missing field notes), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--query <text>", "Override the fact-search query (else the Worker builds one)").option("--refresh", "Re-run the fetch even if a note exists (backfill/sharpen)", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     if (options.queue) {
       const { contextQueueCommand: contextQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
       await runAdminContextQueue(options, contextQueueCommand2);
@@ -5500,6 +5540,15 @@ function addAdminCommands(program2) {
     const { trackContextCommand: trackContextCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackContext(idOrLogId, options, trackContextCommand2);
   });
+  adminTrack.command("note").description("Author the editorial note for a finding (fills an empty note only)").argument("[idOrLogId]").option("--queue", "Show the note worklist (context'd findings with no note yet), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--script <text>", "The voice-gated editorial note").option("--script-file <file>", "Read the editorial note from a file").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    if (options.queue) {
+      const { noteQueueCommand: noteQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+      await runAdminNoteQueue(options, noteQueueCommand2);
+      return;
+    }
+    const { trackNoteCommand: trackNoteCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackNote(idOrLogId, options, trackNoteCommand2);
+  });
   const adminMixtapes = configureCommand(admin.command("mixtapes").description("Mixtape admin commands"));
   adminMixtapes.action(() => {
     adminMixtapes.outputHelp();
@@ -5674,9 +5723,12 @@ async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
 }
 async function runTrackContext(idOrLogId, options, trackContextCommand2) {
   if (!idOrLogId) {
-    throw new Error("Usage: fluncle admin tracks context <track_id|log_id> [--query <text>] [--json]");
+    throw new Error("Usage: fluncle admin tracks context <track_id|log_id> [--query <text>] [--refresh] [--json]");
   }
-  const result = await trackContextCommand2(idOrLogId, { query: options.query });
+  const result = await trackContextCommand2(idOrLogId, {
+    query: options.query,
+    refresh: options.refresh
+  });
   if (options.json) {
     printJson(result);
     return;
@@ -5695,6 +5747,23 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
     console.log(`  sources: ${result.sources.join(", ")}`);
   }
 }
+async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
+  const note = options.scriptFile ? readFileSync3(options.scriptFile, "utf8") : options.script;
+  if (!idOrLogId || !note || !note.trim()) {
+    throw new Error("Usage: fluncle admin tracks note <track_id|log_id> (--script <text> | --script-file <file>) [--json]");
+  }
+  const result = await trackNoteCommand2(idOrLogId, { note: note.trim() });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  if (result.skipped) {
+    console.log(`A note is already on file for ${result.logId}. The operator's note stands.`);
+    return;
+  }
+  console.log(`Authored the note for ${result.logId}:`);
+  console.log(`  ${result.note}`);
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {
@@ -5990,6 +6059,28 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   }
   console.log(`Updated ${result.trackId}: ${result.fields.join(", ")}`);
 }
+async function runTrackRequeueVideo(idOrLogId, options, trackRequeueVideoCommand2) {
+  if (!idOrLogId) {
+    throw new Error("Missing id. Usage: fluncle admin tracks requeue-video <track_id|log_id>");
+  }
+  const result = await trackRequeueVideoCommand2(idOrLogId);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(result.alreadyClear ? `${result.logId} already had no video \u2014 nothing to clear.` : `Cleared the video for ${result.logId}. It's back on the render queue (and off radio until re-rendered).`);
+}
+async function runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand2) {
+  if (!idOrLogId) {
+    throw new Error("Missing id. Usage: fluncle admin tracks purge-video <track_id|log_id>");
+  }
+  const result = await trackPurgeVideoCommand2(idOrLogId);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(result.noVideo ? `${result.logId} has no video \u2014 nothing to purge.` : `Purging the stale renditions for ${result.logId} from the edge. The next play picks up the fresh render.`);
+}
 async function runMixtapeCreate(options, mixtapeCreateCommand2) {
   const result = await mixtapeCreateCommand2(options);
   if (options.json) {
@@ -6307,6 +6398,26 @@ async function runAdminObserveQueue(options, observeQueueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+async function runAdminNoteQueue(options, noteQueueCommand2) {
+  const limit = parseListLimit(options.limit);
+  const tracks = await noteQueueCommand2(limit);
+  if (options.json) {
+    printJson({
+      ok: true,
+      tracks
+    });
+    return;
+  }
+  if (tracks.length === 0) {
+    console.log("Every context'd finding has a note. Nothing waiting on the uncle's words.");
+    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 a note, oldest first:`);
+  console.log(trackRows2(tracks).join(`
+`));
+}
 async function runAdminEnrichQueue(options, enrichQueueCommand2) {
   const limit = parseListLimit(options.limit);
   const tracks = await enrichQueueCommand2(limit);

package/package.json

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