fluncle 0.51.0 → 0.53.0

package/bin/fluncle.mjs

@@ -423,7 +423,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.51.0".trim() ? "0.51.0".trim() : "0.1.0";
+  currentVersion = "0.53.0".trim() ? "0.53.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1912,7 +1912,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.51.0".trim() ? "0.51.0".trim() : "0.1.0";
+  currentVersion2 = "0.53.0".trim() ? "0.53.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -2200,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 = {
@@ -2220,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;
@@ -2259,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");
@@ -2540,6 +2540,62 @@ var init_mixtape_youtube2 = __esm(() => {
   init_output();
 });
 
+// src/commands/newsletter.ts
+var exports_newsletter = {};
+__export(exports_newsletter, {
+  newsletterUpdateCommand: () => newsletterUpdateCommand,
+  newsletterSendCommand: () => newsletterSendCommand,
+  newsletterListCommand: () => newsletterListCommand,
+  newsletterDraftCommand: () => newsletterDraftCommand
+});
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+function buildBody2(options, { requireContent }) {
+  const body = {};
+  if (options.contentFile !== undefined) {
+    body.contentJson = readContentFile(options.contentFile);
+  } else if (requireContent) {
+    throw new CliError2("missing_content", "A draft needs the structured content payload via --content-file <edition.json>");
+  }
+  if (options.subject !== undefined) {
+    body.subject = options.subject;
+  }
+  if (options.windowSince !== undefined) {
+    body.windowSince = options.windowSince;
+  }
+  if (options.windowUntil !== undefined) {
+    body.windowUntil = options.windowUntil;
+  }
+  return body;
+}
+function readContentFile(filePath) {
+  if (!existsSync2(filePath)) {
+    throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
+  }
+  const text = readFileSync2(filePath, "utf-8");
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    throw new CliError2("invalid_content_json", `Content JSON parse failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function newsletterDraftCommand(options) {
+  return adminApiPost("/api/admin/newsletter/editions", buildBody2(options, { requireContent: true }));
+}
+async function newsletterUpdateCommand(id, options) {
+  return adminApiPatch(`/api/admin/newsletter/editions/${encodeURIComponent(id)}`, buildBody2(options, { requireContent: false }));
+}
+async function newsletterSendCommand(id) {
+  return adminApiPost(`/api/admin/newsletter/editions/${encodeURIComponent(id)}/send`);
+}
+async function newsletterListCommand() {
+  const response = await adminApiGet("/api/admin/newsletter/editions");
+  return response.editions;
+}
+var init_newsletter = __esm(() => {
+  init_api();
+  init_output();
+});
+
 // src/commands/add.ts
 async function addCommand2(spotifyUrl, options) {
   const result = await adminApiPost("/api/admin/tracks", {
@@ -3149,7 +3205,7 @@ var COORD_FALLBACK2 = "—";
 var init_format2 = () => {};
 
 // src/cli.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -5346,8 +5402,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);
   });
@@ -5380,19 +5436,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);
   });
@@ -5421,15 +5470,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);
   });
@@ -5473,6 +5532,26 @@ function addAdminCommands(program2) {
     const { publishYoutubeCommand: publishYoutubeCommand3 } = await Promise.resolve().then(() => (init_mixtape_youtube2(), exports_mixtape_youtube2));
     await runMixtapePublishYoutube(idOrLogId, options, publishYoutubeCommand3);
   });
+  const adminNewsletter = configureCommand(admin.command("newsletter").description("Newsletter edition commands"));
+  adminNewsletter.action(() => {
+    adminNewsletter.outputHelp();
+  });
+  adminNewsletter.command("draft").description("Persist a newsletter edition draft (the agent authors it, you send it)").option("--content-file <file>", "Structured edition content payload (JSON)").option("--subject <text>", "Email subject line").option("--window-since <date>", "Discovery-window start (ISO)").option("--window-until <date>", "Discovery-window end (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { newsletterDraftCommand: newsletterDraftCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterDraft(options, newsletterDraftCommand2);
+  });
+  adminNewsletter.command("update").description("Update a draft edition's payload, subject, or window").argument("[id]").option("--content-file <file>", "Structured edition content payload (JSON)").option("--subject <text>", "Email subject line").option("--window-since <date>", "Discovery-window start (ISO)").option("--window-until <date>", "Discovery-window end (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { newsletterUpdateCommand: newsletterUpdateCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterUpdate(id, options, newsletterUpdateCommand2);
+  });
+  adminNewsletter.command("send").description("Send an edition \u2014 OPERATOR only (Resend broadcast + mint the number)").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { newsletterSendCommand: newsletterSendCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterSend(id, options, newsletterSendCommand2);
+  });
+  adminNewsletter.command("list").description("List every edition including drafts (the cron's miss-recovery read)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { newsletterListCommand: newsletterListCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterList(options, newsletterListCommand2);
+  });
   const submissions = configureCommand(admin.command("submissions").description("Review listener submissions"));
   submissions.option("--json", "Print JSON", false).action(async (options) => {
     const { listSubmissionsCommand: listSubmissionsCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
@@ -5552,7 +5631,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync2(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync3(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !script || !script.trim()) {
     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]");
   }
@@ -5714,7 +5793,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync2(candidate) ? candidate : undefined;
+    return existsSync3(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {
@@ -5800,7 +5879,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) {
@@ -5980,6 +6059,53 @@ function formatCue(ms) {
   }
   return `${minutes}:${seconds.toString().padStart(2, "0")}`;
 }
+async function runNewsletterDraft(options, newsletterDraftCommand2) {
+  const result = await newsletterDraftCommand2(options);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Drafted edition ${result.edition.id}. It stays a draft until the operator sends it.`);
+}
+async function runNewsletterUpdate(id, options, newsletterUpdateCommand2) {
+  if (!id) {
+    throw new Error("Missing edition id. Usage: fluncle admin newsletter update <id>");
+  }
+  const result = await newsletterUpdateCommand2(id, options);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Saved draft ${result.edition.id}.`);
+}
+async function runNewsletterSend(id, options, newsletterSendCommand2) {
+  if (!id) {
+    throw new Error("Missing edition id. Usage: fluncle admin newsletter send <id>");
+  }
+  const result = await newsletterSendCommand2(id);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  const number = result.edition.number;
+  console.log(number === undefined ? `Sent edition ${result.edition.id}.` : `Sent edition #${number} \u2014 it's out to the list and in the archive.`);
+}
+async function runNewsletterList(options, newsletterListCommand2) {
+  const editions = await newsletterListCommand2();
+  if (options.json) {
+    printJson({ editions, ok: true });
+    return;
+  }
+  if (editions.length === 0) {
+    console.log("No editions yet.");
+    return;
+  }
+  for (const edition of editions) {
+    const label = edition.number === undefined ? "draft" : `#${edition.number}`;
+    const subject = edition.subject ?? "(no subject)";
+    console.log(`${label}	${edition.status}	${edition.id}	${subject}`);
+  }
+}
 async function runAdd(spotifyUrl, options, addCommand3) {
   if (!spotifyUrl) {
     throw new Error("Missing Spotify track URL");

package/package.json

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