fluncle 0.107.0 → 0.110.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.107.0".trim() ? "0.107.0".trim() : "0.1.0";
+  currentVersion = "0.110.0".trim() ? "0.110.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1100,12 +1100,12 @@ async function distributeYoutube(mixtapeId, videoPath, onProgress) {
       continue;
     }
     if (result.kind === "reauth") {
-      onProgress?.("Access token expired — re-minting and resuming");
+      onProgress?.("Access token expired, re-minting and resuming");
       session = { accessToken: await mintToken(), sessionUri: session.sessionUri };
       offset = await queryOffset(session.sessionUri, session.accessToken, contentLength);
       continue;
     }
-    onProgress?.("Upload session expired — re-initiating");
+    onProgress?.("Upload session expired, re-initiating");
     session = await initiate(mixtapeId, contentLength, contentType);
     offset = 0;
   }
@@ -1401,7 +1401,7 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
   const mixtapeId = mixtape.id;
   const logId = mixtape.logId;
   if (!logId) {
-    throw new CliError2("mixtape_not_promoted", `${mixtapeId} has no coordinate yet — promote its recording first:
+    throw new CliError2("mixtape_not_promoted", `${mixtapeId} has no coordinate yet. Promote its recording first:
 ` + "  fluncle admin recordings promote <recordingId>");
   }
   if (!mixtape.durationMs) {
@@ -1415,7 +1415,7 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
   if (mixtape.status === "published") {
     onProgress(`Already published (${logId}); re-distributing.`);
   } else {
-    onProgress(`Distributing ${logId} (promoted — coordinate already minted).`);
+    onProgress(`Distributing ${logId} (promoted, coordinate already minted).`);
   }
   const results = [];
   if (doYoutube) {
@@ -1446,7 +1446,7 @@ async function mixtapeResyncCommand(idOrLogId, options, onProgress = () => {}) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
   }
   if (!mixtape.logId) {
-    throw new CliError2("mixtape_no_log_id", "The mixtape isn't published yet — distribute it before re-syncing.");
+    throw new CliError2("mixtape_no_log_id", "The mixtape isn't published yet. Distribute it before re-syncing.");
   }
   const mixtapeId = mixtape.id;
   const explicit = Boolean(options.youtube) || Boolean(options.mixcloud);
@@ -1917,7 +1917,7 @@ async function loginCommand() {
   try {
     await openExternal(verificationUrl);
   } catch {
-    console.log("Couldn't open a browser automatically — visit the URL above to approve.");
+    console.log("Couldn't open a browser automatically. Visit the URL above to approve.");
   }
   const token = await pollForToken(baseUrl, device);
   const user = await fetchSessionUser(baseUrl, token.access_token);
@@ -1939,7 +1939,7 @@ async function logoutCommand() {
     });
   }
   const cleared = clearUserToken();
-  console.log(cleared ? "Signed out. This device is no longer linked to your account." : "Not signed in — nothing to do.");
+  console.log(cleared ? "Signed out. This device is no longer linked to your account." : "Not signed in. Nothing to do.");
 }
 async function requestDeviceCode(baseUrl) {
   const response = await fetch(`${baseUrl}/api/auth/device/code`, {
@@ -2207,7 +2207,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.107.0".trim() ? "0.107.0".trim() : "0.1.0";
+  currentVersion2 = "0.110.0".trim() ? "0.110.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2679,7 +2679,7 @@ var init_src = __esm(() => {
     {
       command: "ssh rave.fluncle.com",
       exposedContent: [
-        "the rave terminal TUI: Enter the Galaxy, Latest bangers, Mixtape archive, Submit, Subscribe, Install CLI, About",
+        "the rave terminal TUI: Latest bangers, Mixtape archive, Submit, Subscribe, Install CLI, About",
         "deep-register one-shots: `ssh rave.fluncle.com latest|random`"
       ],
       kind: "ssh",
@@ -2797,7 +2797,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.embed",
-      operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/rfcs/audio-embedding-rfc.md.",
+      operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-embed", kind: "cron" },
       weights: { status: "hidden" }
     },
@@ -2808,7 +2808,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.capture",
-      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/rfcs/full-audio-rfc.md § Unit 1.",
+      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-capture", kind: "cron" },
       weights: { status: "hidden" }
     },
@@ -2928,7 +2928,8 @@ var init_src = __esm(() => {
       probeConfig: {
         cadenceMs: 7 * 24 * 60 * MINUTE_MS,
         cronName: "fluncle-newsletter",
-        kind: "cron"
+        kind: "cron",
+        schedule: { time: "15:00", tz: "Europe/Amsterdam", weekday: 5 }
       },
       weights: { status: "secondary" }
     },
@@ -2939,7 +2940,42 @@ var init_src = __esm(() => {
       kind: "cron",
       name: "cron.backup",
       operatorNotes: "daily. An OWNED, off-Cloudflare backup: dumps prod Turso over the libSQL HTTP pipeline → gzip → a PRIVATE R2 bucket (never fluncle-videos, which is world-served at found.fluncle.com) + prune. Zero LLM tokens; talks to Turso + R2 directly (no fluncle CLI, no agent token). Turso's managed PITR is the belt; this is the braces. Restore is proven by apps/web/scripts/restore-drill.ts. Source: docs/agents/hermes/scripts/backup-sweep.*",
-      probeConfig: { cadenceMs: 24 * 60 * MINUTE_MS, cronName: "fluncle-backup", kind: "cron" },
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-backup",
+        kind: "cron",
+        schedule: { time: "03:00", tz: "Europe/Amsterdam" }
+      },
+      weights: { status: "secondary" }
+    },
+    {
+      exposedContent: [
+        "nightly codebase audit — one domain/night on a 7-day rotation; opens a PR the reviewer merges (claude -p, subscription auth)"
+      ],
+      kind: "cron",
+      name: "cron.audit",
+      operatorNotes: "01:00 Amsterdam, a rave-02 host systemd timer (docs/agents/hermes/audit-timer/). A full agentic claude -p session: audits the day's domain, fixes what's safe, files the rest to docs/audit-backlog.md, opens a PR. Subscription auth (CLAUDE_CODE_OAUTH_TOKEN), zero OpenRouter tokens. Source: docs/agents/hermes/scripts/audit-sweep.sh. Probed on /status as service `cron.audit`.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-audit",
+        kind: "cron",
+        schedule: { time: "01:00", tz: "Europe/Amsterdam" }
+      },
+      weights: { status: "secondary" }
+    },
+    {
+      exposedContent: [
+        "05:00 reviewer for the nightly audit PR — fix-small-and-merge on green CI, else comment + hold (claude -p)"
+      ],
+      kind: "cron",
+      name: "cron.audit-review",
+      operatorNotes: "05:00 Amsterdam, a rave-02 host systemd timer (docs/agents/hermes/audit-review-timer/). Reviews the newest open audit/* PR adversarially; merges when required checks are green and nothing high-impact remains, else comments and leaves it for the operator. Source: docs/agents/hermes/scripts/audit-review-sweep.sh. Probed on /status as service `cron.audit-review`.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-audit-review",
+        kind: "cron",
+        schedule: { time: "05:00", tz: "Europe/Amsterdam" }
+      },
       weights: { status: "secondary" }
     }
   ];
@@ -3052,7 +3088,7 @@ function checkBundleCompleteness(files) {
   const missingFrom = (specs) => uploadingFootage ? specs.filter((spec) => !files[spec.option]).map((spec) => spec.file) : [];
   const plateWarnings = [];
   if (files.plateBackground && !files.plate) {
-    plateWarnings.push("plate.background.png without plate.png — the background is the parallax layer OF a plate; pass --plate (or drop it in the --dir) too");
+    plateWarnings.push("plate.background.png without plate.png. The background is the parallax layer OF a plate; pass --plate (or drop it in the --dir) too");
   }
   return {
     missingAdvisory: missingFrom(RERENDER_ADVISORY_FIELDS),
@@ -3068,10 +3104,10 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
   }
   if (completeness.uploadingFootage) {
     if (completeness.missingContract.length > 0) {
-      onProgress?.(`warning: --allow-partial — uploading WITHOUT the re-render contract (${completeness.missingContract.join(", ")}); the R2 bundle will NOT be re-renderable`);
+      onProgress?.(`warning: --allow-partial, uploading WITHOUT the re-render contract (${completeness.missingContract.join(", ")}); the R2 bundle will NOT be re-renderable`);
     }
     for (const missing of completeness.missingAdvisory) {
-      onProgress?.(`warning: ${missing} missing (provenance/eval only) — shipping without it`);
+      onProgress?.(`warning: ${missing} missing (provenance/eval only), shipping without it`);
     }
   }
   for (const warning of completeness.plateWarnings) {
@@ -3106,7 +3142,7 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
     urls[spec.field] = `${FOUND_BASE}/${upload.key}`;
   }
   if (platesOnly) {
-    onProgress?.(`plate pre-upload complete — compose against ${FOUND_BASE}/${presign.logId}/plate.png; finalize is deferred to the footage ship`);
+    onProgress?.(`plate pre-upload complete. Compose against ${FOUND_BASE}/${presign.logId}/plate.png; finalize is deferred to the footage ship`);
     return { logId: presign.logId, ok: true, trackId: presign.trackId, urls };
   }
   const manifest = files.render ? await readManifestFields(files.render) : {};
@@ -3264,246 +3300,6 @@ var init_track = __esm(() => {
   NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
-// src/commands/helm.ts
-var exports_helm = {};
-__export(exports_helm, {
-  resolveHelmDir: () => resolveHelmDir,
-  helmUninstallCommand: () => helmUninstallCommand,
-  helmOpenCommand: () => helmOpenCommand,
-  helmInstallCommand: () => helmInstallCommand,
-  buildLaunchAgentPlist: () => buildLaunchAgentPlist
-});
-import { existsSync, mkdirSync as mkdirSync2, openSync, rmSync as rmSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync2 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { dirname as dirname3, join as join4, resolve } from "node:path";
-function launchAgentPlistPath() {
-  return join4(homedir4(), "Library/LaunchAgents", `${LAUNCH_AGENT_LABEL}.plist`);
-}
-function helmLogPath() {
-  return join4(homedir4(), "Library/Logs/fluncle-helm.log");
-}
-function walkUpForHelm(start) {
-  let dir = start;
-  for (let depth = 0;depth < 8; depth++) {
-    const candidate = join4(dir, "apps/helm");
-    if (existsSync(join4(candidate, "src/server.ts"))) {
-      return candidate;
-    }
-    const parent = dirname3(dir);
-    if (parent === dir) {
-      break;
-    }
-    dir = parent;
-  }
-  return null;
-}
-function persistHelmDir(dir) {
-  try {
-    mkdirSync2(dirname3(HELM_DIR_FILE), { recursive: true });
-    writeFileSync2(HELM_DIR_FILE, `${dir}
-`, { mode: 384 });
-  } catch {}
-}
-function resolveHelmDir() {
-  const fromEnv = process.env.FLUNCLE_HELM_DIR;
-  if (fromEnv) {
-    if (!existsSync(join4(fromEnv, "src/server.ts"))) {
-      throw new CliError2("helm_not_found", `FLUNCLE_HELM_DIR points at ${fromEnv}, but there's no helm there (src/server.ts missing).`);
-    }
-    return resolve(fromEnv);
-  }
-  const found = walkUpForHelm(process.cwd()) ?? walkUpForHelm(import.meta.dir);
-  if (found) {
-    persistHelmDir(found);
-    return found;
-  }
-  try {
-    const remembered = readFileSync2(HELM_DIR_FILE, "utf8").trim();
-    if (remembered && existsSync(join4(remembered, "src/server.ts"))) {
-      return remembered;
-    }
-  } catch {}
-  throw new CliError2("helm_not_found", "No helm aboard. Run this once from the fluncle repo (the helm remembers the way after that), or set FLUNCLE_HELM_DIR.");
-}
-function resolveBun() {
-  const bun = Bun.which("bun");
-  if (!bun) {
-    throw new CliError2("no_bun", "No bun on the PATH. The helm daemon runs under bun.");
-  }
-  return bun;
-}
-async function daemonHealthy() {
-  try {
-    const response = await fetch(`${HELM_URL}/api/health`, {
-      signal: AbortSignal.timeout(1500)
-    });
-    return response.ok;
-  } catch {
-    return false;
-  }
-}
-async function ensureBuilt(helmDir) {
-  if (existsSync(join4(helmDir, "dist/index.html"))) {
-    return;
-  }
-  console.log("The glass isn't built yet. Building it once…");
-  const proc = Bun.spawn([resolveBun(), "run", "build"], {
-    cwd: helmDir,
-    stderr: "inherit",
-    stdin: "ignore",
-    stdout: "inherit"
-  });
-  const exitCode = await proc.exited;
-  if (exitCode !== 0) {
-    throw new CliError2("helm_build_failed", `The glass build failed (exit ${exitCode}).`);
-  }
-}
-function bootDaemon(helmDir) {
-  const logPath = helmLogPath();
-  mkdirSync2(dirname3(logPath), { recursive: true });
-  const logFd = openSync(logPath, "a");
-  const proc = Bun.spawn([resolveBun(), "src/server.ts"], {
-    cwd: helmDir,
-    stderr: logFd,
-    stdin: "ignore",
-    stdout: logFd
-  });
-  proc.unref();
-}
-async function waitForHealth(timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await daemonHealthy()) {
-      return true;
-    }
-    await Bun.sleep(250);
-  }
-  return false;
-}
-async function openAppWindow() {
-  if (process.platform === "darwin" && chromeInstalled()) {
-    const proc = Bun.spawn(["open", "-na", "Google Chrome", "--args", `--app=${HELM_URL}`], {
-      stderr: "ignore",
-      stdin: "ignore",
-      stdout: "ignore"
-    });
-    if (await proc.exited === 0) {
-      return;
-    }
-  }
-  await openExternal(HELM_URL);
-}
-function chromeInstalled() {
-  return existsSync("/Applications/Google Chrome.app") || existsSync(join4(homedir4(), "Applications/Google Chrome.app"));
-}
-async function helmOpenCommand() {
-  if (await daemonHealthy()) {
-    console.log(`The helm holds on :${HELM_PORT}. Opening the window.`);
-    await openAppWindow();
-    return;
-  }
-  const helmDir = resolveHelmDir();
-  await ensureBuilt(helmDir);
-  bootDaemon(helmDir);
-  if (!await waitForHealth(15000)) {
-    throw new CliError2("helm_no_answer", `The daemon didn't answer on :${HELM_PORT}. Its log is at ${helmLogPath()}.`);
-  }
-  console.log(`Helm raised on :${HELM_PORT}. Opening the window.`);
-  await openAppWindow();
-}
-function xmlEscape(text) {
-  return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
-}
-function buildLaunchAgentPlist(helmDir, bunPath, logPath) {
-  const path2 = `${dirname3(bunPath)}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin`;
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PATH</key>
-    <string>${xmlEscape(path2)}</string>
-  </dict>
-  <key>KeepAlive</key>
-  <dict>
-    <key>SuccessfulExit</key>
-    <false/>
-  </dict>
-  <key>Label</key>
-  <string>${LAUNCH_AGENT_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${xmlEscape(bunPath)}</string>
-    <string>src/server.ts</string>
-  </array>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>StandardErrorPath</key>
-  <string>${xmlEscape(logPath)}</string>
-  <key>StandardOutPath</key>
-  <string>${xmlEscape(logPath)}</string>
-  <key>WorkingDirectory</key>
-  <string>${xmlEscape(helmDir)}</string>
-</dict>
-</plist>
-`;
-}
-function currentUid() {
-  const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
-  if (uid === undefined) {
-    throw new CliError2("no_uid", "Couldn't read the user id — launchd needs a gui domain.");
-  }
-  return uid;
-}
-async function launchctl(args) {
-  const proc = Bun.spawn(["launchctl", ...args], {
-    stderr: "ignore",
-    stdin: "ignore",
-    stdout: "ignore"
-  });
-  return proc.exited;
-}
-async function helmInstallCommand() {
-  if (process.platform !== "darwin") {
-    throw new CliError2("unsupported_platform", "launchd is a macOS thing. Nothing to install here.");
-  }
-  const helmDir = resolveHelmDir();
-  await ensureBuilt(helmDir);
-  const plistPath = launchAgentPlistPath();
-  mkdirSync2(dirname3(plistPath), { recursive: true });
-  mkdirSync2(dirname3(helmLogPath()), { recursive: true });
-  writeFileSync2(plistPath, buildLaunchAgentPlist(helmDir, resolveBun(), helmLogPath()));
-  const uid = currentUid();
-  await launchctl(["bootout", `gui/${uid}/${LAUNCH_AGENT_LABEL}`]);
-  const exitCode = await launchctl(["bootstrap", `gui/${uid}`, plistPath]);
-  if (exitCode !== 0) {
-    throw new CliError2("launchctl_refused", `launchctl bootstrap refused (exit ${exitCode}). The plist is at ${plistPath}.`);
-  }
-  console.log(`LaunchAgent installed (${LAUNCH_AGENT_LABEL}).`);
-  console.log(`The daemon rises at login and holds :${HELM_PORT}. Log: ${helmLogPath()}`);
-}
-async function helmUninstallCommand() {
-  if (process.platform !== "darwin") {
-    throw new CliError2("unsupported_platform", "launchd is a macOS thing. Nothing to remove here.");
-  }
-  const plistPath = launchAgentPlistPath();
-  await launchctl(["bootout", `gui/${currentUid()}/${LAUNCH_AGENT_LABEL}`]);
-  if (existsSync(plistPath)) {
-    rmSync2(plistPath);
-    console.log("LaunchAgent removed and the daemon stood down.");
-    return;
-  }
-  console.log("No LaunchAgent on file. Nothing stood down.");
-}
-var HELM_PORT = 4190, HELM_URL, LAUNCH_AGENT_LABEL = "com.fluncle.helm", HELM_DIR_FILE;
-var init_helm = __esm(() => {
-  init_open_external();
-  init_output();
-  HELM_URL = `http://127.0.0.1:${HELM_PORT}`;
-  HELM_DIR_FILE = join4(homedir4(), ".config/fluncle/helm-dir");
-});
-
 // src/commands/add.ts
 var exports_add = {};
 __export(exports_add, {
@@ -3925,12 +3721,12 @@ async function distributeYoutube2(mixtapeId, videoPath, onProgress) {
       continue;
     }
     if (result.kind === "reauth") {
-      onProgress?.("Access token expired — re-minting and resuming");
+      onProgress?.("Access token expired, re-minting and resuming");
       session = { accessToken: await mintToken2(), sessionUri: session.sessionUri };
       offset = await queryOffset2(session.sessionUri, session.accessToken, contentLength);
       continue;
     }
-    onProgress?.("Upload session expired — re-initiating");
+    onProgress?.("Upload session expired, re-initiating");
     session = await initiate2(mixtapeId, contentLength, contentType);
     offset = 0;
   }
@@ -4085,9 +3881,9 @@ var init_multipart = __esm(() => {
 
 // src/commands/mixtape-set-video.ts
 import { randomUUID } from "node:crypto";
-import { existsSync as existsSync2, rmSync as rmSync3, statSync as statSync3 } from "node:fs";
+import { existsSync, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join4 } from "node:path";
 function renditionFfmpegArgs(inputPath, outputPath) {
   return [
     "-y",
@@ -4115,11 +3911,11 @@ function renditionFfmpegArgs(inputPath, outputPath) {
   ];
 }
 async function uploadRenditionMultipart(masterPath, presignPath, onProgress = () => {}) {
-  if (!existsSync2(masterPath)) {
+  if (!existsSync(masterPath)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${masterPath}`);
   }
   await assertFfmpeg();
-  const renditionPath = join5(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
+  const renditionPath = join4(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
   onProgress("Set video: deriving the 1080p faststart rendition (ffmpeg)…");
   await deriveRendition(masterPath, renditionPath);
   try {
@@ -4148,7 +3944,7 @@ async function uploadRenditionMultipart(masterPath, presignPath, onProgress = ()
     }
     return { key: presign.key, url: `${FOUND_BASE2}/${presign.key}` };
   } finally {
-    rmSync3(renditionPath, { force: true });
+    rmSync2(renditionPath, { force: true });
   }
 }
 async function putPart(url, path2, part, onProgress = () => {}) {
@@ -4164,8 +3960,8 @@ async function putPart(url, path2, part, onProgress = () => {}) {
         throw new CliError2("r2_part_failed", `Part ${part.partNumber} failed after ${MAX_PART_ATTEMPTS} attempts: ${error instanceof Error ? error.message : String(error)}`);
       }
       const backoffMs = 500 * 2 ** (attempt - 1);
-      onProgress(`Set video: part ${part.partNumber} dropped — retry ${attempt}/${MAX_PART_ATTEMPTS - 1} in ${backoffMs}ms…`);
-      await new Promise((resolve2) => setTimeout(resolve2, backoffMs));
+      onProgress(`Set video: part ${part.partNumber} dropped, retry ${attempt}/${MAX_PART_ATTEMPTS - 1} in ${backoffMs}ms…`);
+      await new Promise((resolve) => setTimeout(resolve, backoffMs));
     }
   }
 }
@@ -4245,7 +4041,7 @@ __export(exports_recordings, {
   recordingDeleteCommand: () => recordingDeleteCommand,
   recordingCreateCommand: () => recordingCreateCommand
 });
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 async function recordingGet(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -4304,7 +4100,7 @@ async function recordingCreateCommand(options = {}) {
       printJson2({ ok: true, recording: recording2 });
       return;
     }
-    console.log(`Plan ${recording2.id} created — handle "${recording2.title}"`);
+    console.log(`Plan ${recording2.id} created, handle "${recording2.title}"`);
     return;
   }
   const title = options.title?.trim();
@@ -4314,7 +4110,7 @@ async function recordingCreateCommand(options = {}) {
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
   }
-  if (!existsSync3(options.video)) {
+  if (!existsSync2(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
   const created = await adminApiPost("/api/admin/recordings", {
@@ -4327,7 +4123,7 @@ async function recordingCreateCommand(options = {}) {
       console.log(message);
     }
   };
-  log(`Recording ${recording.id} created — staging the set video…`);
+  log(`Recording ${recording.id} created, staging the set video…`);
   const upload = await uploadRenditionMultipart(options.video, `/api/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
   if (options.json) {
     printJson2({ key: upload.key, ok: true, recording, url: upload.url });
@@ -4350,17 +4146,17 @@ async function recordingUpdateCommand(id, options = {}) {
     body.parentId = options.parentId;
   }
   if (options.tracklistFile !== undefined) {
-    if (!existsSync3(options.tracklistFile)) {
+    if (!existsSync2(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
-      body.tracklistJson = JSON.parse(readFileSync3(options.tracklistFile, "utf8"));
+      body.tracklistJson = JSON.parse(readFileSync2(options.tracklistFile, "utf8"));
     } catch {
       throw new CliError2("invalid_tracklist", `Tracklist file is not valid JSON: ${options.tracklistFile}`);
     }
   }
   if (Object.keys(body).length === 0) {
-    throw new CliError2("no_fields", "Nothing to update — pass --title, --recorded-at, --parent-id, or --tracklist-file");
+    throw new CliError2("no_fields", "Nothing to update. Pass --title, --recorded-at, --parent-id, or --tracklist-file");
   }
   const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
   if (options.json) {
@@ -4399,12 +4195,12 @@ async function recordingReplaceCuesCommand(id, options = {}) {
   if (!options.cuesFile) {
     throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
   }
-  if (!existsSync3(options.cuesFile)) {
+  if (!existsSync2(options.cuesFile)) {
     throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
   }
   let cues;
   try {
-    cues = JSON.parse(readFileSync3(options.cuesFile, "utf8"));
+    cues = JSON.parse(readFileSync2(options.cuesFile, "utf8"));
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
@@ -4442,9 +4238,9 @@ __export(exports_clips, {
   CLIP_AUDIO_BITRATE: () => CLIP_AUDIO_BITRATE
 });
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { rmSync as rmSync4, statSync as statSync4 } from "node:fs";
+import { rmSync as rmSync3, statSync as statSync4 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join5 } from "node:path";
 function clipFootageKey(clipId) {
   return `${clipId}/footage.mp4`;
 }
@@ -4541,7 +4337,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
   }
   const source = await resolveClipSource(clip);
   await assertFfmpeg2();
-  const outputPath = join6(tmpdir2(), `fluncle-clip-${randomUUID2()}.mp4`);
+  const outputPath = join5(tmpdir2(), `fluncle-clip-${randomUUID2()}.mp4`);
   try {
     onProgress(`Clip ${clipId}: cutting [${clip.inMs}–${clip.outMs}ms]…`);
     await runClipCut({
@@ -4553,7 +4349,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
     });
     const sizeBytes = statSync4(outputPath).size;
     if (sizeBytes > MAX_CLIP_BYTES) {
-      throw new CliError2("clip_too_large", `The cut is ${(sizeBytes / 1e6).toFixed(1)} MB (> 100 MB Cloudflare MT ceiling) — shorten the window or lower the bitrate cap`);
+      throw new CliError2("clip_too_large", `The cut is ${(sizeBytes / 1e6).toFixed(1)} MB (> 100 MB Cloudflare MT ceiling). Shorten the window or lower the bitrate cap`);
     }
     onProgress(`Clip ${clipId}: uploading ${(sizeBytes / 1e6).toFixed(1)} MB…`);
     const presign = await adminApiPost(`/api/admin/clips/${encodeURIComponent(clipId)}/cut/presign`, { contentType: "video/mp4" });
@@ -4567,7 +4363,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
       url: `${FOUND_BASE3}/${presign.key}`
     };
   } finally {
-    rmSync4(outputPath, { force: true });
+    rmSync3(outputPath, { force: true });
   }
 }
 async function putClip(url, contentType, path2) {
@@ -4625,7 +4421,7 @@ __export(exports_recordings2, {
   recordingDeleteCommand: () => recordingDeleteCommand2,
   recordingCreateCommand: () => recordingCreateCommand2
 });
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 async function recordingGet2(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -4684,7 +4480,7 @@ async function recordingCreateCommand2(options = {}) {
       printJson2({ ok: true, recording: recording2 });
       return;
     }
-    console.log(`Plan ${recording2.id} created — handle "${recording2.title}"`);
+    console.log(`Plan ${recording2.id} created, handle "${recording2.title}"`);
     return;
   }
   const title = options.title?.trim();
@@ -4694,7 +4490,7 @@ async function recordingCreateCommand2(options = {}) {
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
   }
-  if (!existsSync4(options.video)) {
+  if (!existsSync3(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
   const created = await adminApiPost("/api/admin/recordings", {
@@ -4707,7 +4503,7 @@ async function recordingCreateCommand2(options = {}) {
       console.log(message);
     }
   };
-  log(`Recording ${recording.id} created — staging the set video…`);
+  log(`Recording ${recording.id} created, staging the set video…`);
   const upload = await uploadRenditionMultipart(options.video, `/api/admin/recordings/${encodeURIComponent(recording.id)}/set-video/presign`, log);
   if (options.json) {
     printJson2({ key: upload.key, ok: true, recording, url: upload.url });
@@ -4730,17 +4526,17 @@ async function recordingUpdateCommand2(id, options = {}) {
     body.parentId = options.parentId;
   }
   if (options.tracklistFile !== undefined) {
-    if (!existsSync4(options.tracklistFile)) {
+    if (!existsSync3(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
-      body.tracklistJson = JSON.parse(readFileSync4(options.tracklistFile, "utf8"));
+      body.tracklistJson = JSON.parse(readFileSync3(options.tracklistFile, "utf8"));
     } catch {
       throw new CliError2("invalid_tracklist", `Tracklist file is not valid JSON: ${options.tracklistFile}`);
     }
   }
   if (Object.keys(body).length === 0) {
-    throw new CliError2("no_fields", "Nothing to update — pass --title, --recorded-at, --parent-id, or --tracklist-file");
+    throw new CliError2("no_fields", "Nothing to update. Pass --title, --recorded-at, --parent-id, or --tracklist-file");
   }
   const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
   if (options.json) {
@@ -4779,12 +4575,12 @@ async function recordingReplaceCuesCommand2(id, options = {}) {
   if (!options.cuesFile) {
     throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
   }
-  if (!existsSync4(options.cuesFile)) {
+  if (!existsSync3(options.cuesFile)) {
     throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
   }
   let cues;
   try {
-    cues = JSON.parse(readFileSync4(options.cuesFile, "utf8"));
+    cues = JSON.parse(readFileSync3(options.cuesFile, "utf8"));
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
@@ -4810,7 +4606,7 @@ __export(exports_newsletter, {
   newsletterDraftCommand: () => newsletterDraftCommand,
   newsletterDeleteCommand: () => newsletterDeleteCommand
 });
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
 function buildBody2(options, { requireContent }) {
   const body = {};
   if (options.contentFile !== undefined) {
@@ -4830,10 +4626,10 @@ function buildBody2(options, { requireContent }) {
   return body;
 }
 function readContentFile(filePath) {
-  if (!existsSync5(filePath)) {
+  if (!existsSync4(filePath)) {
     throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
   }
-  const text = readFileSync5(filePath, "utf-8");
+  const text = readFileSync4(filePath, "utf-8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -5217,6 +5013,26 @@ var init_admin_artists = __esm(() => {
   init_api();
 });
 
+// src/commands/preview-migration.ts
+var exports_preview_migration = {};
+__export(exports_preview_migration, {
+  migratePreviewArchiveCommand: () => migratePreviewArchiveCommand
+});
+async function migratePreviewArchiveCommand(args) {
+  const params = new URLSearchParams({
+    dryRun: String(args.dryRun),
+    limit: String(args.limit),
+    mode: args.mode
+  });
+  if (args.cursor) {
+    params.set("cursor", args.cursor);
+  }
+  return adminApiPost(`/api/admin/migrations/preview-archive?${params.toString()}`);
+}
+var init_preview_migration = __esm(() => {
+  init_api();
+});
+
 // src/interactive.ts
 var exports_interactive = {};
 __export(exports_interactive, {
@@ -5250,7 +5066,7 @@ async function selectWithKeyboard2(items, options) {
   let renderedLines = 0;
   let done = false;
   const wasRaw = stdin.isRaw === true;
-  return await new Promise((resolve2) => {
+  return await new Promise((resolve) => {
     function cleanup() {
       if (done) {
         return;
@@ -5265,14 +5081,14 @@ async function selectWithKeyboard2(items, options) {
       cleanup();
       stdout.write(renderedLines > 0 ? `
 ` : "");
-      resolve2(item);
+      resolve(item);
     }
     function cancel() {
       cleanup();
       clearRendered2(stdout, renderedLines);
       stdout.write(`Cancelled.
 `);
-      resolve2(undefined);
+      resolve(undefined);
     }
     function render() {
       clearRendered2(stdout, renderedLines);
@@ -5328,7 +5144,7 @@ async function paginateWithKeyboard(options) {
   let busy = false;
   let done = false;
   const wasRaw = stdin.isRaw === true;
-  return await new Promise((resolve2) => {
+  return await new Promise((resolve) => {
     function cleanup() {
       if (done) {
         return;
@@ -5343,7 +5159,7 @@ async function paginateWithKeyboard(options) {
       cleanup();
       stdout.write(`
 `);
-      resolve2();
+      resolve();
     }
     function render() {
       clearRendered2(stdout, renderedLines);
@@ -5496,7 +5312,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7642,7 +7458,6 @@ ${fluncleAsciiLogo}
   addMetaCommands(program2);
   addTrackCommands(program2);
   addAdminCommands(program2);
-  addHelmCommands(program2);
   return program2;
 }
 async function main(args = process.argv.slice(2)) {
@@ -7680,7 +7495,7 @@ function addListenCommands(program2) {
     const { recentCommand: recentCommand3 } = await Promise.resolve().then(() => (init_recent(), exports_recent));
     await runRecent(options, recentCommand3);
   });
-  program2.command("artists").description("Browse artists in Fluncle's archive").argument("[slug]", "Artist slug \u2014 omit for the full list").option("--json", "Print JSON", false).action(async (slug, options) => {
+  program2.command("artists").description("Browse artists in Fluncle's archive").argument("[slug]", "Artist slug (omit for the full list)").option("--json", "Print JSON", false).action(async (slug, options) => {
     const { artistsListCommand: artistsListCommand2, artistsGetCommand: artistsGetCommand2 } = await Promise.resolve().then(() => (init_artists(), exports_artists));
     await runArtists(slug, options, { artistsGetCommand: artistsGetCommand2, artistsListCommand: artistsListCommand2 });
   });
@@ -7745,21 +7560,6 @@ function addTrackCommands(program2) {
     await runTrackGet(idOrLogId, options, trackGetCommand2);
   });
 }
-function addHelmCommands(program2) {
-  const helm = configureCommand(program2.command("helm", { hidden: true }).description("Fluncle's Helm \u2014 the operator's mission control"));
-  helm.action(async () => {
-    const { helmOpenCommand: helmOpenCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
-    await helmOpenCommand2();
-  });
-  helm.command("install").description("Install the launchd LaunchAgent (the daemon rises at login)").action(async () => {
-    const { helmInstallCommand: helmInstallCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
-    await helmInstallCommand2();
-  });
-  helm.command("uninstall").description("Remove the LaunchAgent and stand the daemon down").action(async () => {
-    const { helmUninstallCommand: helmUninstallCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
-    await helmUninstallCommand2();
-  });
-}
 function addAdminCommands(program2) {
   const admin = configureCommand(program2.command("admin", { hidden: true }).description("Operator commands"));
   admin.action(() => {
@@ -7784,27 +7584,27 @@ function addAdminCommands(program2) {
     const { listCommand: listCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminTracksList(options, listCommand2);
   });
-  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) => {
+  adminTracks.command("enrich").description("Enrichment worklist (pending, failed, or stuck processing). 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.");
+      console.error("`tracks enrich` is a worklist view. 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);
   });
-  adminTracks.command("embed").description("Audio-embedding worklist (findings with no MuQ vector yet) \u2014 use --queue").option("--queue", "Show the embedding worklist, oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("embed").description("Audio-embedding worklist (findings with no MuQ vector yet). Use --queue").option("--queue", "Show the embedding 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 embed` is a worklist view \u2014 embedding runs on the on-box `fluncle-embed` cron.\nUse `tracks embed --queue` to see findings needing an audio embedding.");
+      console.error("`tracks embed` is a worklist view. Embedding runs on the on-box `fluncle-embed` cron.\nUse `tracks embed --queue` to see findings needing an audio embedding.");
       process.exitCode = 1;
       return;
     }
     const { embedQueueCommand: embedQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminEmbedQueue(options, embedQueueCommand2);
   });
-  adminTracks.command("capture-audio").description("Full-song capture worklist (findings with no source audio yet) \u2014 use --queue").option("--queue", "Show the capture worklist, newest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("capture-audio").description("Full-song capture worklist (findings with no source audio yet). Use --queue").option("--queue", "Show the capture worklist, newest 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 capture-audio` is a worklist view \u2014 capture runs on the on-box `fluncle-capture` cron.\nUse `tracks capture-audio --queue` to see findings needing a full-song capture.");
+      console.error("`tracks capture-audio` is a worklist view. Capture runs on the on-box `fluncle-capture` cron.\nUse `tracks capture-audio --queue` to see findings needing a full-song capture.");
       process.exitCode = 1;
       return;
     }
@@ -7896,7 +7696,7 @@ function addAdminCommands(program2) {
     const { mixtapeGetCommand: mixtapeGetCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeGet(idOrLogId, options, mixtapeGetCommand2);
   });
-  adminMixtapes.command("distribute").description("Push a promoted mixtape to YouTube (video) and Mixcloud (audio). The mixtape must already be promoted (`recordings promote`) \u2014 distribute is push-only.").argument("[idOrLogId]").option("--video <file>", "Video file for YouTube").option("--audio <file>", "Audio file for Mixcloud").option("--youtube", "Only distribute to YouTube").option("--mixcloud", "Only distribute to Mixcloud").option("--unlisted", "Keep Mixcloud private too (YouTube is always unlisted until publish-youtube)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  adminMixtapes.command("distribute").description("Push a promoted mixtape to YouTube (video) and Mixcloud (audio). The mixtape must already be promoted (`recordings promote`). Distribute is push-only.").argument("[idOrLogId]").option("--video <file>", "Video file for YouTube").option("--audio <file>", "Audio file for Mixcloud").option("--youtube", "Only distribute to YouTube").option("--mixcloud", "Only distribute to Mixcloud").option("--unlisted", "Keep Mixcloud private too (YouTube is always unlisted until publish-youtube)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     const { mixtapeDistributeCommand: mixtapeDistributeCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeDistribute(idOrLogId, options, mixtapeDistributeCommand2);
   });
@@ -7920,11 +7720,11 @@ function addAdminCommands(program2) {
     const { clipScheduleCommand: clipScheduleCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
     await runClipsSchedule(clipId, options, clipScheduleCommand2);
   });
-  adminClips.command("drip-pause").description("Pause the whole Instagram drip-feed \u2014 the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminClips.command("drip-pause").description("Pause the whole Instagram drip-feed, the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { clipDripPauseCommand: clipDripPauseCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
     await runClipsDripPause(true, options, clipDripPauseCommand2);
   });
-  adminClips.command("drip-resume").description("Resume the Instagram drip-feed \u2014 clear the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminClips.command("drip-resume").description("Resume the Instagram drip-feed, clear the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { clipDripPauseCommand: clipDripPauseCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
     await runClipsDripPause(false, options, clipDripPauseCommand2);
   });
@@ -7976,7 +7776,7 @@ function addAdminCommands(program2) {
     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) => {
+  adminNewsletter.command("send").description("Send an edition, 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);
   });
@@ -7984,7 +7784,7 @@ function addAdminCommands(program2) {
     const { newsletterListCommand: newsletterListCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
     await runNewsletterList(options, newsletterListCommand2);
   });
-  adminNewsletter.command("delete").description("Delete an edition (draft or sent) \u2014 OPERATOR only; reopens the send window").argument("[id]").option("--yes", "Confirm the delete", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+  adminNewsletter.command("delete").description("Delete an edition (draft or sent). OPERATOR only; reopens the send window").argument("[id]").option("--yes", "Confirm the delete", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
     const { newsletterDeleteCommand: newsletterDeleteCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
     await runNewsletterDelete(id, options, newsletterDeleteCommand2);
   });
@@ -8064,6 +7864,14 @@ function addAdminCommands(program2) {
     const { resolveArtistCommand: resolveArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runArtistResolve(artistId, options, resolveArtistCommand2);
   });
+  const migrations = configureCommand(admin.command("migrations").description("One-off operator data migrations"));
+  migrations.action(() => {
+    migrations.outputHelp();
+  });
+  migrations.command("preview-archive").description("Move archived 30s previews from the public bucket to the private one (REF-05)").option("--execute", "Actually perform the migration (default is a dry run)", false).option("--delete-public", "Delete phase: sweep the whole public analysis/previews/ prefix (run only after a full copy)", false).option("--verify", "Read-only: count the objects still under the public analysis/previews/ prefix", false).option("--limit <limit>", "Max findings/objects to process per pass", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { migratePreviewArchiveCommand: migratePreviewArchiveCommand2 } = await Promise.resolve().then(() => (init_preview_migration(), exports_preview_migration));
+    await runMigratePreviewArchive(options, migratePreviewArchiveCommand2);
+  });
 }
 async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2) {
   if (!idOrLogId || !options.file || !options.source || !options.mime) {
@@ -8084,7 +7892,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync5(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>] [--duration-ms <ms>] [--context-note <text>] [--json]");
   }
@@ -8140,7 +7948,7 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
   }
 }
 async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
-  const note = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
+  const note = options.scriptFile ? readFileSync5(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]");
   }
@@ -8156,6 +7964,88 @@ async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
   console.log(`Authored the note for ${result.logId}:`);
   console.log(`  ${result.note}`);
 }
+async function runMigratePreviewArchive(options, migratePreviewArchiveCommand2) {
+  const limit = options.limit === undefined ? 50 : Number.parseInt(options.limit, 10);
+  if (!Number.isInteger(limit) || limit < 1) {
+    throw new Error("Limit must be a positive integer");
+  }
+  const mode = options.verify ? "verify" : options.deletePublic ? "delete" : "copy";
+  const dryRun = mode === "verify" ? true : !options.execute;
+  if (mode === "verify") {
+    const result = await migratePreviewArchiveCommand2({ dryRun: true, limit, mode });
+    if (options.json) {
+      printJson({ mode, ok: true, remaining: result.remaining, sampleKeys: result.sampleKeys });
+      return;
+    }
+    console.log(`${result.remaining} object(s) remain under the public analysis/previews/ prefix.`);
+    for (const key of result.sampleKeys) {
+      console.log(`  ${key}`);
+    }
+    return;
+  }
+  const copied = [];
+  const deleted = [];
+  const skipped = [];
+  const failed = [];
+  let cursor;
+  let remaining = 0;
+  let blocked = null;
+  for (;; ) {
+    const result = await migratePreviewArchiveCommand2({ cursor, dryRun, limit, mode });
+    if (result.blocked) {
+      blocked = result.blocked;
+      remaining = result.remaining;
+      break;
+    }
+    copied.push(...result.copied);
+    deleted.push(...result.deleted);
+    skipped.push(...result.skipped);
+    failed.push(...result.failed);
+    remaining = result.remaining;
+    if (!options.json) {
+      const verb = dryRun ? "would" : "did";
+      console.log(`  \u2026${mode} pass (${verb}): +${result.copiedCount} copied, +${result.deletedCount} deleted, ${result.skippedCount} skipped, ${result.failedCount} failed; ${result.remaining} remaining`);
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      blocked,
+      copied,
+      copiedCount: copied.length,
+      deleted,
+      deletedCount: deleted.length,
+      dryRun,
+      failed,
+      failedCount: failed.length,
+      mode,
+      ok: true,
+      remaining,
+      skipped,
+      skippedCount: skipped.length
+    });
+    return;
+  }
+  if (blocked) {
+    console.log(`REFUSED (${blocked}): ${remaining} legacy row(s) still need copying first.`);
+    return;
+  }
+  const done = mode === "delete" ? deleted.length : copied.length;
+  const noun = mode === "delete" ? "public object(s) deleted" : "preview(s) copied to the private bucket";
+  const prefix = dryRun ? "DRY RUN \u2014 would have: " : "";
+  console.log(`${prefix}${done} ${noun}; ${skipped.length} skipped; ${failed.length} failed; ${remaining} still under the prefix.`);
+  for (const item of skipped) {
+    if (item.reason === "private_copy_absent") {
+      console.log(`  LEFT (no private copy) ${item.trackId}`);
+    }
+  }
+  for (const item of failed) {
+    console.log(`  FAILED ${item.trackId}: ${item.error}`);
+  }
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {
@@ -8329,7 +8219,7 @@ async function runArtistResolveQueue(options, listArtistsCommand2) {
     return;
   }
   if (result.artists.length === 0) {
-    console.log("Every artist has been resolved. Nothing waiting on the sweep.");
+    console.log("Resolved every artist. Nothing waiting on the sweep.");
     return;
   }
   const noun = result.artists.length === 1 ? "artist" : "artists";
@@ -8371,7 +8261,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync6(candidate) ? candidate : undefined;
+    return existsSync5(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {
@@ -8555,7 +8445,7 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   if (bpm !== undefined && !Number.isFinite(bpm)) {
     throw new Error(`Invalid --bpm: ${options.bpm}`);
   }
-  const embeddingRaw = options.embeddingFile ? readFileSync6(options.embeddingFile, "utf8") : options.embedding;
+  const embeddingRaw = options.embeddingFile ? readFileSync5(options.embeddingFile, "utf8") : options.embedding;
   const embedding = parseEmbeddingArg(embeddingRaw);
   const result = await trackUpdateCommand2(trackId, {
     bpm,
@@ -8581,7 +8471,7 @@ async function runTrackRequeueVideo(idOrLogId, options, trackRequeueVideoCommand
     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).`);
+  console.log(result.alreadyClear ? `${result.logId} already had no video. 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) {
@@ -8592,7 +8482,7 @@ async function runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand2) {
     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.`);
+  console.log(result.noVideo ? `${result.logId} has no video. Nothing to purge.` : `Purging the stale renditions for ${result.logId} from the edge. The next play picks up the fresh render.`);
 }
 async function runMixtapeUpdate(id, options, mixtapeUpdateCommand2) {
   if (!id) {
@@ -8780,14 +8670,14 @@ async function runNewsletterSend(id, options, newsletterSendCommand2) {
     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.`);
+  console.log(number === undefined ? `Sent edition ${result.edition.id}.` : `Sent edition #${number}. It's out to the list and in the archive.`);
 }
 async function runNewsletterDelete(id, options, newsletterDeleteCommand2) {
   if (!id) {
     throw new Error("Missing edition id. Usage: fluncle admin newsletter delete <id> --yes");
   }
   if (!options.yes) {
-    throw new Error("Pass --yes to confirm \u2014 this hard-deletes the edition (draft or sent).");
+    throw new Error("Pass --yes to confirm. This hard-deletes the edition (draft or sent).");
   }
   const result = await newsletterDeleteCommand2(id);
   if (options.json) {

package/package.json

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