fluncle 0.43.0 → 0.45.0

package/bin/fluncle.mjs

@@ -2539,7 +2539,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.43.0".trim() ? "0.43.0".trim() : "0.1.0";
+  currentVersion = "0.45.0".trim() ? "0.45.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.43.0".trim() ? "0.43.0".trim() : "0.1.0";
+  currentVersion2 = "0.45.0".trim() ? "0.45.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -4216,7 +4216,7 @@ async function enrichQueueCommand(limit) {
   return fetchAdminTracks({ max: limit, order: "asc", status: "queue" });
 }
 async function enrichSweepCommand(limit) {
-  return adminApiPost(`/api/admin/enrich-sweep?limit=${limit}`);
+  return adminApiPost(`/api/admin/tracks/enrich?limit=${limit}`);
 }
 async function backfillLastfmCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
@@ -5383,30 +5383,55 @@ function addAdminCommands(program2) {
   admin.command("help", { hidden: true }).description("display help for command").action(() => {
     admin.outputHelp();
   });
-  admin.command("add").description("Publish a Spotify track").argument("[spotifyUrl]").option("--note <text>", "Operator note").option("--dry-run", "Preview without publishing", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (spotifyUrl, options) => {
+  const adminTracks = configureCommand(admin.command("tracks").alias("track").description("Track admin commands"));
+  adminTracks.action(() => {
+    adminTracks.outputHelp();
+  });
+  adminTracks.command("publish").description("Publish a Spotify track").argument("[spotifyUrl]").option("--note <text>", "Operator note").option("--dry-run", "Preview without publishing", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (spotifyUrl, options) => {
     const { addCommand: addCommand3 } = await Promise.resolve().then(() => (init_add(), exports_add));
     await runAdd(spotifyUrl, options, addCommand3);
   });
-  admin.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) => {
+  admin.command("add", { hidden: true }).description("Publish a Spotify track (alias of `admin tracks publish`)").argument("[spotifyUrl]").option("--note <text>", "Operator note").option("--dry-run", "Preview without publishing", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (spotifyUrl, options) => {
+    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) => {
     const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminQueue(options, queueCommand2);
   });
-  admin.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) => {
+  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) => {
+    const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminQueue(options, queueCommand2);
+  });
+  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-sweep").description("Re-fire enrichment for everything in the enrich-queue (idempotent self-heal)").option("--limit <limit>", "Max findings to re-trigger", "25").option("--json", "Print JSON", false).action(async (options) => {
+  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) => {
+    const { enrichQueueCommand: enrichQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEnrichQueue(options, enrichQueueCommand2);
+  });
+  adminTracks.command("enrich").description("Re-fire enrichment for everything in the enrich-queue (--all; idempotent self-heal)").option("--all", "Sweep the whole enrich-queue (required)", false).option("--limit <limit>", "Max findings to re-trigger", "25").option("--json", "Print JSON", false).action(async (options) => {
+    const { enrichSweepCommand: enrichSweepCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEnrich(options, enrichSweepCommand2);
+  });
+  adminTracks.command("enrich-sweep", { hidden: true }).description("Enrich sweep (alias of `admin tracks enrich --all`)").option("--limit <limit>", "Max findings to re-trigger", "25").option("--json", "Print JSON", false).action(async (options) => {
+    const { enrichSweepCommand: enrichSweepCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminEnrich({ ...options, all: true }, enrichSweepCommand2);
+  });
+  admin.command("enrich-sweep", { hidden: true }).description("Enrich sweep (alias of `admin tracks enrich --all`)").option("--limit <limit>", "Max findings to re-trigger", "25").option("--json", "Print JSON", false).action(async (options) => {
     const { enrichSweepCommand: enrichSweepCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
-    await runAdminEnrichSweep(options, enrichSweepCommand2);
+    await runAdminEnrich({ ...options, all: true }, enrichSweepCommand2);
   });
-  admin.command("vehicles").description("Recent video vehicles, newest first (the style ledger for diversity)").option("--limit <limit>", "Number of vehicles to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("vehicles").description("Recent video vehicles, newest first (the style ledger for diversity)").option("--limit <limit>", "Number of vehicles to show", "10").option("--json", "Print JSON", false).action(async (options) => {
     const { vehiclesCommand: vehiclesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminVehicles(options, vehiclesCommand2);
   });
-  const adminTrack = configureCommand(admin.command("track").description("Track admin commands"));
-  adminTrack.action(() => {
-    adminTrack.outputHelp();
+  admin.command("vehicles", { hidden: true }).description("Video vehicles (alias of `admin tracks vehicles`)").option("--limit <limit>", "Number of vehicles to show", "10").option("--json", "Print JSON", false).action(async (options) => {
+    const { vehiclesCommand: vehiclesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminVehicles(options, vehiclesCommand2);
   });
+  const adminTrack = adminTracks;
   adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--bpm <number>", "Track BPM").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
     const { trackUpdateCommand: trackUpdateCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackUpdate(trackId, options, trackUpdateCommand2);
@@ -5423,7 +5448,7 @@ 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-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").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) => {
     const { previewArchiveUploadCommand: previewArchiveUploadCommand2 } = await Promise.resolve().then(() => (init_preview_archive(), exports_preview_archive));
     await runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2);
   });
@@ -5514,7 +5539,7 @@ function addAdminCommands(program2) {
     const { authLastfmCommand: authLastfmCommand2 } = await Promise.resolve().then(() => (init_auth_lastfm(), exports_auth_lastfm));
     await authLastfmCommand2(options);
   });
-  const backfill = configureCommand(admin.command("backfill").description("Backfill operator-only archives"));
+  const backfill = configureCommand(admin.command("backfills").alias("backfill").description("Backfill operator-only archives"));
   backfill.action(() => {
     backfill.outputHelp();
   });
@@ -5533,7 +5558,7 @@ function addAdminCommands(program2) {
 }
 async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2) {
   if (!idOrLogId || !options.file || !options.source || !options.mime) {
-    throw new Error("Usage: fluncle admin track preview-archive <track_id|log_id> --file <file> --source <source> --mime <mime> [--json]");
+    throw new Error("Usage: fluncle admin tracks preview <track_id|log_id> --file <file> --source <source> --mime <mime> [--json]");
   }
   const result = await previewArchiveUploadCommand2(idOrLogId, {
     file: options.file,
@@ -5552,7 +5577,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
   const script = options.scriptFile ? readFileSync2(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !script || !script.trim()) {
-    throw new Error("Usage: fluncle admin track observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--model <model>] [--duration-ms <ms>] [--context-note <text>] [--json]");
+    throw new Error("Usage: fluncle admin tracks observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--model <model>] [--duration-ms <ms>] [--context-note <text>] [--json]");
   }
   const durationMs = options.durationMs === undefined ? undefined : Number.parseInt(options.durationMs, 10);
   if (durationMs !== undefined && (!Number.isInteger(durationMs) || durationMs < 1)) {
@@ -5681,7 +5706,7 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
 }
 async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
   if (!idOrLogId) {
-    throw new Error("Missing id. Usage: fluncle admin track video <track_id|log_id> (--dir <dir> | --footage <file> [--footage-social <file>] [--footage-silent <file>] [--poster <file>] [--cover <file>] [--note <file>] [--composition <file>] [--props <file>] [--render <file>])");
+    throw new Error("Missing id. Usage: fluncle admin tracks video <track_id|log_id> (--dir <dir> | --footage <file> [--footage-social <file>] [--footage-silent <file>] [--poster <file>] [--cover <file>] [--note <file>] [--composition <file>] [--props <file>] [--render <file>])");
   }
   const dir = options.dir ? path.resolve(process.cwd(), options.dir) : undefined;
   const fromDir = (name) => {
@@ -5726,7 +5751,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
 }
 async function runTrackDraft(idOrLogId, options, trackDraftCommand2) {
   if (!idOrLogId) {
-    throw new Error("Missing id. Usage: fluncle admin track draft <track_id|log_id> [--platform tiktok]");
+    throw new Error("Missing id. Usage: fluncle admin tracks draft <track_id|log_id> [--platform tiktok]");
   }
   const platform2 = options.platform ?? "tiktok";
   const result = await trackDraftCommand2(idOrLogId, platform2);
@@ -5738,7 +5763,7 @@ async function runTrackDraft(idOrLogId, options, trackDraftCommand2) {
 }
 async function runTrackSocial(idOrLogId, options, trackSocialShowCommand2, trackSocialUpdateCommand2) {
   if (!idOrLogId) {
-    throw new Error("Missing id. Usage: fluncle admin track social <track_id|log_id> [--platform tiktok] [--status scheduled|published [--url <url>]]");
+    throw new Error("Missing id. Usage: fluncle admin tracks social <track_id|log_id> [--platform tiktok] [--status scheduled|published [--url <url>]]");
   }
   if (!options.status) {
     const result2 = await trackSocialShowCommand2(idOrLogId);
@@ -5801,7 +5826,7 @@ async function runTrackGet(idOrLogId, options, trackGetCommand2) {
 }
 async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   if (!trackId) {
-    throw new Error("Missing track id. Usage: fluncle admin track update <track_id>");
+    throw new Error("Missing track id. Usage: fluncle admin tracks update <track_id>");
   }
   const bpm = options.bpm === undefined ? undefined : Number(options.bpm);
   if (bpm !== undefined && !Number.isFinite(bpm)) {
@@ -6068,7 +6093,10 @@ async function runAdminEnrichQueue(options, enrichQueueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
-async function runAdminEnrichSweep(options, enrichSweepCommand2) {
+async function runAdminEnrich(options, enrichSweepCommand2) {
+  if (!options.all) {
+    throw new Error("Usage: fluncle admin tracks enrich --all [--limit 25] [--json] (sweeps the whole enrich-queue)");
+  }
   const limit = parseListLimit(options.limit);
   const result = await enrichSweepCommand2(limit);
   if (options.json) {

package/package.json

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