fluncle 0.50.0 → 0.52.0

package/bin/fluncle.mjs

@@ -408,7 +408,7 @@ function compareVersions(left, right) {
   const leftParts = parseVersion(left);
   const rightParts = parseVersion(right);
   for (let index = 0;index < 3; index += 1) {
-    const difference = leftParts[index] - rightParts[index];
+    const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
     if (difference !== 0) {
       return difference;
     }
@@ -417,16 +417,13 @@ function compareVersions(left, right) {
 }
 function parseVersion(version) {
   const parts = version.split(".").map((part) => Number.parseInt(part, 10));
-  return [
-    Number.isInteger(parts[0]) ? parts[0] : 0,
-    Number.isInteger(parts[1]) ? parts[1] : 0,
-    Number.isInteger(parts[2]) ? parts[2] : 0
-  ];
+  const integerOrZero = (value) => value !== undefined && Number.isInteger(value) ? value : 0;
+  return [integerOrZero(parts[0]), integerOrZero(parts[1]), integerOrZero(parts[2])];
 }
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.50.0".trim() ? "0.50.0".trim() : "0.1.0";
+  currentVersion = "0.52.0".trim() ? "0.52.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -483,6 +480,9 @@ function shouldNotify(args) {
 function firstPositional(args) {
   for (let index = 0;index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === undefined) {
+      continue;
+    }
     if (arg === "--env") {
       index += 1;
       continue;
@@ -1237,6 +1237,9 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
   }
   const results = [];
   if (doYoutube) {
+    if (!options.video) {
+      throw new CliError2("missing_video", "YouTube distribution needs --video <mp4>");
+    }
     onProgress("YouTube: uploading video…");
     const { distributeYoutube: distributeYoutube2 } = await Promise.resolve().then(() => (init_mixtape_youtube(), exports_mixtape_youtube));
     const result = await distributeYoutube2(mixtapeId, options.video, onProgress);
@@ -1244,6 +1247,9 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
     onProgress(`YouTube: ${result.url}`);
   }
   if (doMixcloud) {
+    if (!options.audio) {
+      throw new CliError2("missing_audio", "Mixcloud distribution needs --audio <file>");
+    }
     onProgress("Mixcloud: uploading audio…");
     const { distributeMixcloud: distributeMixcloud2 } = await Promise.resolve().then(() => (init_mixtape_mixcloud(), exports_mixtape_mixcloud));
     const result = await distributeMixcloud2(mixtapeId, options.audio, onProgress, options.unlisted);
@@ -1327,11 +1333,15 @@ function parseCueSheet(text) {
     }
     const match = trimmed.match(/^(\d{1,2}:\d{2}(?::\d{2})?)\s+(.+)$/);
     if (match) {
-      const startMs = parseDuration(match[1]);
+      const [, time, ref] = match;
+      if (time === undefined || ref === undefined) {
+        continue;
+      }
+      const startMs = parseDuration(time);
       if (startMs === null) {
         continue;
       }
-      entries.push({ ref: match[2].trim(), startMs });
+      entries.push({ ref: ref.trim(), startMs });
     } else {
       entries.push({ ref: trimmed });
     }
@@ -1354,12 +1364,18 @@ function parseDuration(input) {
     }
     if (parts.length === 3) {
       const [hours, minutes2, seconds2] = nums;
+      if (hours === undefined || minutes2 === undefined || seconds2 === undefined) {
+        return null;
+      }
       if (minutes2 >= 60 || seconds2 >= 60) {
         return null;
       }
       return Math.round((hours * 3600 + minutes2 * 60 + seconds2) * 1000);
     }
     const [minutes, seconds] = nums;
+    if (minutes === undefined || seconds === undefined) {
+      return null;
+    }
     if (seconds >= 60) {
       return null;
     }
@@ -1881,7 +1897,7 @@ function compareVersions2(left, right) {
   const leftParts = parseVersion2(left);
   const rightParts = parseVersion2(right);
   for (let index = 0;index < 3; index += 1) {
-    const difference = leftParts[index] - rightParts[index];
+    const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
     if (difference !== 0) {
       return difference;
     }
@@ -1890,16 +1906,13 @@ function compareVersions2(left, right) {
 }
 function parseVersion2(version) {
   const parts = version.split(".").map((part) => Number.parseInt(part, 10));
-  return [
-    Number.isInteger(parts[0]) ? parts[0] : 0,
-    Number.isInteger(parts[1]) ? parts[1] : 0,
-    Number.isInteger(parts[2]) ? parts[2] : 0
-  ];
+  const integerOrZero = (value) => value !== undefined && Number.isInteger(value) ? value : 0;
+  return [integerOrZero(parts[0]), integerOrZero(parts[1]), integerOrZero(parts[2])];
 }
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.50.0".trim() ? "0.50.0".trim() : "0.1.0";
+  currentVersion2 = "0.52.0".trim() ? "0.52.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -2187,7 +2200,7 @@ async function previewArchiveUploadCommand(idOrLogId, options) {
   form.append("preview", Bun.file(options.file), basename(options.file));
   form.append("source", options.source);
   form.append("mime", options.mime);
-  return adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/preview-archive`, form);
+  return adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/preview`, form);
 }
 async function previewArchiveBackfillCommand(options) {
   const result = {
@@ -2207,7 +2220,7 @@ async function previewArchiveBackfillCommand(options) {
         result.skipped.push({ reason: "no_log_id", trackId: track.trackId });
         continue;
       }
-      const status = await adminApiGet(`/api/admin/tracks/${encodeURIComponent(track.trackId)}/preview-archive`);
+      const status = await adminApiGet(`/api/admin/tracks/${encodeURIComponent(track.trackId)}/preview`);
       if (status.archived) {
         result.skipped.push({ reason: "already_archived", trackId: track.trackId });
         continue;
@@ -2246,7 +2259,7 @@ async function uploadResolvedPreview(trackId, preview) {
   form.append("preview", new Blob([preview.bytes], { type: preview.mime }), `preview.${extension}`);
   form.append("source", preview.source);
   form.append("mime", preview.mime);
-  await adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(trackId)}/preview-archive`, form);
+  await adminApiPostForm(`/api/admin/tracks/${encodeURIComponent(trackId)}/preview`, form);
 }
 async function resolvePreview(track) {
   const stored = await downloadPreview(track.previewUrl, "deezer:stored");
@@ -2992,6 +3005,9 @@ async function paginateWithKeyboard(options) {
       const columns = stdout.columns ?? 80;
       const before = pages.slice(0, index).reduce((count, page2) => count + page2.lines.length, 0);
       const page = pages[index];
+      if (page === undefined) {
+        return;
+      }
       const start = before + 1;
       const end = before + page.lines.length;
       const loading = busy ? "  ·  loading…" : "";
@@ -3003,7 +3019,7 @@ async function paginateWithKeyboard(options) {
 `);
     }
     function loadNext() {
-      const cursor = pages[index].nextCursor;
+      const cursor = pages[index]?.nextCursor;
       if (cursor === undefined) {
         return;
       }
@@ -5330,8 +5346,8 @@ function addMetaCommands(program2) {
   });
 }
 function addTrackCommands(program2) {
-  const track = configureCommand(program2.command("track", { hidden: true }).description("Public track lookups"));
-  track.command("get").description("Look up one finding by id or Log ID").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  const tracks = configureCommand(program2.command("tracks", { hidden: true }).alias("track").description("Public track lookups"));
+  tracks.command("get").description("Look up one finding by id or Log ID").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     const { trackGetCommand: trackGetCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGet(idOrLogId, options, trackGetCommand2);
   });
@@ -5364,19 +5380,12 @@ function addAdminCommands(program2) {
     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);
-  });
-  admin.command("enrich-queue", { hidden: true }).description("Enrich queue (alias of `admin tracks enrich-queue`)").option("--limit <limit>", "Number of findings to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("enrich").description("Enrichment worklist (pending, failed, or stuck processing) \u2014 use --queue").option("--queue", "Show the enrichment worklist, oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--json", "Print JSON", false).action(async (options) => {
+    if (!options.queue) {
+      console.error("`tracks enrich` is a worklist view \u2014 enrichment runs on the on-box `fluncle-enrich` cron.\nUse `tracks enrich --queue` to see findings needing (re-)enrichment.");
+      process.exitCode = 1;
+      return;
+    }
     const { enrichQueueCommand: enrichQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminEnrichQueue(options, enrichQueueCommand2);
   });
@@ -5405,15 +5414,25 @@ function addAdminCommands(program2) {
     const { trackSocialShowCommand: trackSocialShowCommand2, trackSocialUpdateCommand: trackSocialUpdateCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackSocial(idOrLogId, options, trackSocialShowCommand2, trackSocialUpdateCommand2);
   });
-  adminTrack.command("preview").alias("preview-archive").description("Store one official preview at the operator-only archive path for analysis").argument("[idOrLogId]").option("--file <file>", "Preview audio file to archive").option("--mime <mime>", "MIME type of the preview audio").option("--source <source>", "Provenance label for the archived preview").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  adminTrack.command("preview").description("Store one official preview at the operator-only archive path for analysis").argument("[idOrLogId]").option("--file <file>", "Preview audio file to archive").option("--mime <mime>", "MIME type of the preview audio").option("--source <source>", "Provenance label for the archived preview").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     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) => {
+  adminTrack.command("observe").description("Render Fluncle's spoken field observation for a track (ElevenLabs, Worker-side)").argument("[idOrLogId]").option("--queue", "Show the observe worklist (notes but no observation yet), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").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) => {
+    if (options.queue) {
+      const { observeQueueCommand: observeQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+      await runAdminObserveQueue(options, observeQueueCommand2);
+      return;
+    }
     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) => {
+  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) => {
+    if (options.queue) {
+      const { contextQueueCommand: contextQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+      await runAdminContextQueue(options, contextQueueCommand2);
+      return;
+    }
     const { trackContextCommand: trackContextCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackContext(idOrLogId, options, trackContextCommand2);
   });
@@ -5784,7 +5803,7 @@ async function runTrackSocial(idOrLogId, options, trackSocialShowCommand2, track
 }
 async function runTrackGet(idOrLogId, options, trackGetCommand2) {
   if (!idOrLogId) {
-    throw new Error("Missing id. Usage: fluncle track get <track_id|log_id> [--json]");
+    throw new Error("Missing id. Usage: fluncle tracks get <track_id|log_id> [--json]");
   }
   const result = await trackGetCommand2(idOrLogId);
   if (options.json) {
@@ -6224,6 +6243,9 @@ function assertParseArgsCompatibleOptionValues(args) {
   }
   for (let index = 0;index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === undefined) {
+      continue;
+    }
     if (arg === "--") {
       return;
     }
@@ -6253,6 +6275,9 @@ function positionalArgs(args) {
   const positionals = [];
   for (let index = 0;index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === undefined) {
+      continue;
+    }
     if (arg === "--") {
       positionals.push(...args.slice(index + 1));
       return positionals;
@@ -6281,6 +6306,9 @@ function positionalArgs(args) {
 function topLevelCommand(args) {
   for (let index = 0;index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === undefined) {
+      continue;
+    }
     if (arg === "--env") {
       index += 1;
       continue;

package/package.json

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