fluncle 0.84.0 → 0.86.0

package/bin/fluncle.mjs

@@ -538,7 +538,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.84.0".trim() ? "0.84.0".trim() : "0.1.0";
+  currentVersion = "0.86.0".trim() ? "0.86.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1329,186 +1329,6 @@ var init_mixtape_mixcloud = __esm(() => {
   PICTURE_MAX_BYTES = 10 * 1024 * 1024;
 });
 
-// src/commands/mixtape-set-video.ts
-var exports_mixtape_set_video = {};
-__export(exports_mixtape_set_video, {
-  uploadRenditionMultipart: () => uploadRenditionMultipart,
-  stageSetVideo: () => stageSetVideo,
-  renditionFfmpegArgs: () => renditionFfmpegArgs,
-  planMultipart: () => planMultipart,
-  buildCompleteXml: () => buildCompleteXml,
-  SET_VIDEO_RENDITION: () => SET_VIDEO_RENDITION,
-  MIN_PART_SIZE: () => MIN_PART_SIZE,
-  MAX_PARTS: () => MAX_PARTS,
-  DEFAULT_PART_SIZE: () => DEFAULT_PART_SIZE
-});
-import { randomUUID } from "node:crypto";
-import { existsSync, rmSync as rmSync2, statSync as statSync2 } from "node:fs";
-import { tmpdir } from "node:os";
-import { join as join4 } from "node:path";
-function planMultipart(contentLength, partSize = DEFAULT_PART_SIZE) {
-  if (!Number.isInteger(contentLength) || contentLength <= 0) {
-    throw new CliError2("invalid_size", `The rendition size must be a positive integer (got ${contentLength})`);
-  }
-  let effective = Math.max(partSize, MIN_PART_SIZE);
-  if (Math.ceil(contentLength / effective) > MAX_PARTS) {
-    effective = Math.ceil(contentLength / MAX_PARTS);
-  }
-  const parts = [];
-  let start = 0;
-  let partNumber = 1;
-  while (start < contentLength) {
-    const end = Math.min(start + effective, contentLength);
-    parts.push({ end, partNumber, size: end - start, start });
-    start = end;
-    partNumber += 1;
-  }
-  return { partCount: parts.length, partSize: effective, parts };
-}
-function escapeXml(value) {
-  return value.replace(/[<>&'"]/g, (char) => ({ '"': "&quot;", "&": "&amp;", "'": "&apos;", "<": "&lt;", ">": "&gt;" })[char] ?? char);
-}
-function buildCompleteXml(parts) {
-  const ordered = [...parts].sort((a, b) => a.partNumber - b.partNumber);
-  const body = ordered.map((part) => `<Part><PartNumber>${part.partNumber}</PartNumber><ETag>${escapeXml(part.etag)}</ETag></Part>`).join("");
-  return `<CompleteMultipartUpload>${body}</CompleteMultipartUpload>`;
-}
-function renditionFfmpegArgs(inputPath, outputPath) {
-  return [
-    "-y",
-    "-i",
-    inputPath,
-    "-vf",
-    `scale=-2:${SET_VIDEO_RENDITION.height}`,
-    "-c:v",
-    "libx264",
-    "-preset",
-    "medium",
-    "-crf",
-    String(SET_VIDEO_RENDITION.crf),
-    "-force_key_frames",
-    `expr:gte(t,n_forced*${SET_VIDEO_RENDITION.gopSeconds})`,
-    "-pix_fmt",
-    "yuv420p",
-    "-c:a",
-    "aac",
-    "-b:a",
-    SET_VIDEO_RENDITION.audioBitrate,
-    "-movflags",
-    "+faststart",
-    outputPath
-  ];
-}
-async function uploadRenditionMultipart(masterPath, presignPath, onProgress = () => {}) {
-  if (!existsSync(masterPath)) {
-    throw new CliError2("file_not_found", `Set-video master not found: ${masterPath}`);
-  }
-  await assertFfmpeg();
-  const renditionPath = join4(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
-  onProgress("Set video: deriving the 1080p faststart rendition (ffmpeg)…");
-  await deriveRendition(masterPath, renditionPath);
-  try {
-    const size = statSync2(renditionPath).size;
-    const plan = planMultipart(size);
-    onProgress(`Set video: uploading ${(size / 1e9).toFixed(2)} GB in ${plan.partCount} part(s)…`);
-    const presign = await adminApiPost(presignPath, {
-      partCount: plan.partCount
-    });
-    const urlByPart = new Map(presign.parts.map((part) => [part.partNumber, part.url]));
-    const completed = [];
-    try {
-      for (const part of plan.parts) {
-        const url = urlByPart.get(part.partNumber);
-        if (!url) {
-          throw new CliError2("presign_missing", `Worker did not sign part ${part.partNumber} of ${plan.partCount}`);
-        }
-        onProgress(`Set video: part ${part.partNumber}/${plan.partCount}`);
-        const etag = await putPart(url, renditionPath, part);
-        completed.push({ etag, partNumber: part.partNumber });
-      }
-      await completeUpload(presign.completeUrl, completed);
-    } catch (error) {
-      await abortUpload(presign.abortUrl).catch(() => {});
-      throw error;
-    }
-    return { key: presign.key, url: `${FOUND_BASE}/${presign.key}` };
-  } finally {
-    rmSync2(renditionPath, { force: true });
-  }
-}
-async function stageSetVideo(mixtapeId, masterPath, onProgress = () => {}) {
-  const result = await uploadRenditionMultipart(masterPath, `/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/set-video/presign`, onProgress);
-  await adminApiPatch(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}`, {
-    setVideoAt: new Date().toISOString()
-  });
-  onProgress("Set video: flipped setVideoAt — the /log player + video SEO are live.");
-  return result;
-}
-async function putPart(url, path2, part) {
-  const response = await fetch(url, {
-    body: Bun.file(path2).slice(part.start, part.end),
-    method: "PUT"
-  });
-  if (!response.ok) {
-    const detail = (await response.text().catch(() => "")).slice(0, 300);
-    throw new CliError2("r2_part_failed", `R2 rejected part ${part.partNumber} (${response.status} ${response.statusText})${detail ? `: ${detail}` : ""}`);
-  }
-  const etag = response.headers.get("etag");
-  if (!etag) {
-    throw new CliError2("r2_no_etag", `R2 returned no ETag for part ${part.partNumber}`);
-  }
-  return etag;
-}
-async function completeUpload(url, parts) {
-  const response = await fetch(url, {
-    body: buildCompleteXml(parts),
-    headers: { "content-type": "application/xml" },
-    method: "POST"
-  });
-  const text = await response.text().catch(() => "");
-  if (!response.ok || text.includes("<Error>")) {
-    throw new CliError2("r2_complete_failed", `R2 CompleteMultipartUpload failed (${response.status} ${response.statusText})${text ? `: ${text.slice(0, 300)}` : ""}`);
-  }
-}
-async function abortUpload(url) {
-  await fetch(url, { method: "DELETE" });
-}
-async function assertFfmpeg() {
-  try {
-    const proc = Bun.spawn(["ffmpeg", "-version"], { stderr: "ignore", stdout: "ignore" });
-    await proc.exited;
-    if (proc.exitCode !== 0) {
-      throw new Error("ffmpeg -version exited non-zero");
-    }
-  } catch {
-    throw new CliError2("ffmpeg_missing", "--set-video needs ffmpeg to derive the 1080p rendition. Install it (brew install ffmpeg).");
-  }
-}
-async function deriveRendition(inputPath, outputPath) {
-  const proc = Bun.spawn(["ffmpeg", ...renditionFfmpegArgs(inputPath, outputPath)], {
-    stderr: "pipe",
-    stdout: "ignore"
-  });
-  await proc.exited;
-  if (proc.exitCode !== 0) {
-    const detail = (await new Response(proc.stderr).text().catch(() => "")).slice(-400);
-    throw new CliError2("ffmpeg_failed", `ffmpeg failed to derive the set-video rendition${detail ? `: ${detail}` : ""}`);
-  }
-}
-var FOUND_BASE = "https://found.fluncle.com", SET_VIDEO_RENDITION, DEFAULT_PART_SIZE, MIN_PART_SIZE, MAX_PARTS = 1e4;
-var init_mixtape_set_video = __esm(() => {
-  init_api();
-  init_output();
-  SET_VIDEO_RENDITION = {
-    audioBitrate: "192k",
-    crf: 20,
-    gopSeconds: 2,
-    height: 1080
-  };
-  DEFAULT_PART_SIZE = 100 * 1024 * 1024;
-  MIN_PART_SIZE = 5 * 1024 * 1024;
-});
-
 // src/commands/mixtapes.ts
 var exports_mixtapes = {};
 __export(exports_mixtapes, {
@@ -1523,7 +1343,7 @@ __export(exports_mixtapes, {
   mixtapeDeleteCommand: () => mixtapeDeleteCommand,
   mixtapeCreateCommand: () => mixtapeCreateCommand
 });
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync, readFileSync as readFileSync2 } from "node:fs";
 async function mixtapesCommand() {
   const response = await publicApiGet("/api/mixtapes");
   return response.mixtapes;
@@ -1552,21 +1372,24 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
   if (!mixtape.id) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
   }
-  const both = !options.youtube && !options.mixcloud && !options.setVideo;
+  if (mixtape.status === "draft") {
+    throw new CliError2("mixtape_not_promoted", `${mixtape.id} is still a draft — promote its recording first:
+` + "  fluncle admin recordings promote <recordingId>");
+  }
+  const both = !options.youtube && !options.mixcloud;
   const doYoutube = both || Boolean(options.youtube);
   const doMixcloud = both || Boolean(options.mixcloud);
-  const doSetVideo = Boolean(options.setVideo);
   if (doYoutube && !options.video) {
     throw new CliError2("missing_video", "YouTube distribution needs --video <mp4>");
   }
   if (doMixcloud && !options.audio) {
     throw new CliError2("missing_audio", "Mixcloud distribution needs --audio <file>");
   }
-  if (doSetVideo && !options.video) {
-    throw new CliError2("missing_video", "--set-video needs --video <master.mp4>");
-  }
   const mixtapeId = mixtape.id;
-  let logId = mixtape.logId;
+  const logId = mixtape.logId;
+  if (!logId) {
+    throw new CliError2("missing_log_id", "The mixtape has no Log ID — was it promoted successfully?");
+  }
   if (!mixtape.durationMs) {
     const source = options.audio ?? options.video;
     const durationMs = source ? await probeDurationMs(source) : undefined;
@@ -1575,18 +1398,10 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
       onProgress(`Duration: ${Math.round(durationMs / 60000)} min (from the upload).`);
     }
   }
-  if (mixtape.status === "draft") {
-    onProgress("Minting the coordinate…");
-    const published = await mixtapePublishCommand(mixtapeId);
-    logId = published.mixtape.logId;
-    onProgress(`Minted ${logId}.`);
-  } else if (mixtape.status === "published") {
+  if (mixtape.status === "published") {
     onProgress(`Already published (${logId}); re-distributing.`);
   } else {
-    onProgress(`Resuming distribution for ${logId}.`);
-  }
-  if (!logId) {
-    throw new CliError2("mint_failed", "The mixtape has no Log ID after minting");
+    onProgress(`Distributing ${logId} (promoted — coordinate already minted).`);
   }
   const results = [];
   if (doYoutube) {
@@ -1609,16 +1424,6 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
     results.push({ platform: "mixcloud", url: result.url });
     onProgress(`Mixcloud: ${result.url}`);
   }
-  if (doSetVideo) {
-    if (!options.video) {
-      throw new CliError2("missing_video", "--set-video needs --video <master.mp4>");
-    }
-    onProgress("Set video: staging the 1080p rendition…");
-    const { stageSetVideo: stageSetVideo2 } = await Promise.resolve().then(() => (init_mixtape_set_video(), exports_mixtape_set_video));
-    const result = await stageSetVideo2(mixtapeId, options.video, onProgress);
-    results.push({ platform: "set-video", url: result.url });
-    onProgress(`Set video: ${result.url}`);
-  }
   return { logId, mixtapeId, results };
 }
 async function mixtapeResyncCommand(idOrLogId, options, onProgress = () => {}) {
@@ -1691,7 +1496,7 @@ function buildBody(options) {
   return body;
 }
 function parseCueFile(filePath) {
-  if (!existsSync2(filePath)) {
+  if (!existsSync(filePath)) {
     throw new CliError2("file_not_found", `Cue file not found: ${filePath}`);
   }
   const text = readFileSync2(filePath, "utf-8");
@@ -2446,7 +2251,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.84.0".trim() ? "0.84.0".trim() : "0.1.0";
+  currentVersion2 = "0.86.0".trim() ? "0.86.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3200,7 +3005,7 @@ async function trackVideoCommand(idOrLogId, files, onProgress) {
       const detail = (await response.text().catch(() => "")).slice(0, 300);
       throw new CliError2("r2_put_failed", `R2 rejected ${spec.field} with ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}`);
     }
-    urls[spec.field] = `${FOUND_BASE2}/${upload.key}`;
+    urls[spec.field] = `${FOUND_BASE}/${upload.key}`;
   }
   const manifest = files.render ? await readManifestFields(files.render) : {};
   const videoModel = files.model?.trim().slice(0, 120) || manifest.model || DEFAULT_VIDEO_MODEL;
@@ -3311,7 +3116,7 @@ async function trackNoteCommand(idOrLogId, options) {
   const body = { note: options.note };
   return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/note`, body);
 }
-var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE2 = "https://found.fluncle.com", VIDEO_FIELDS;
+var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE = "https://found.fluncle.com", VIDEO_FIELDS;
 var init_track = __esm(() => {
   init_api();
   init_output();
@@ -3705,7 +3510,7 @@ __export(exports_mixtape_youtube2, {
   distributeYoutube: () => distributeYoutube2,
   authYoutubeCommand: () => authYoutubeCommand2
 });
-import { statSync as statSync3 } from "node:fs";
+import { statSync as statSync2 } from "node:fs";
 async function distributeYoutube2(mixtapeId, videoPath, onProgress) {
   const contentLength = fileSize2(videoPath);
   const contentType = "video/mp4";
@@ -3841,7 +3646,7 @@ async function resolveMixtapeId2(idOrLogId) {
 }
 function fileSize2(path2) {
   try {
-    return statSync3(path2).size;
+    return statSync2(path2).size;
   } catch {
     throw new CliError2("video_not_found", `Cannot read video file at ${path2}`);
   }
@@ -3861,11 +3666,172 @@ var init_mixtape_youtube2 = __esm(() => {
   init_output();
 });
 
+// src/commands/mixtape-set-video.ts
+import { randomUUID } from "node:crypto";
+import { existsSync as existsSync2, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
+import { tmpdir } from "node:os";
+import { join as join4 } from "node:path";
+function planMultipart(contentLength, partSize = DEFAULT_PART_SIZE) {
+  if (!Number.isInteger(contentLength) || contentLength <= 0) {
+    throw new CliError2("invalid_size", `The rendition size must be a positive integer (got ${contentLength})`);
+  }
+  let effective = Math.max(partSize, MIN_PART_SIZE);
+  if (Math.ceil(contentLength / effective) > MAX_PARTS) {
+    effective = Math.ceil(contentLength / MAX_PARTS);
+  }
+  const parts = [];
+  let start = 0;
+  let partNumber = 1;
+  while (start < contentLength) {
+    const end = Math.min(start + effective, contentLength);
+    parts.push({ end, partNumber, size: end - start, start });
+    start = end;
+    partNumber += 1;
+  }
+  return { partCount: parts.length, partSize: effective, parts };
+}
+function escapeXml(value) {
+  return value.replace(/[<>&'"]/g, (char) => ({ '"': "&quot;", "&": "&amp;", "'": "&apos;", "<": "&lt;", ">": "&gt;" })[char] ?? char);
+}
+function buildCompleteXml(parts) {
+  const ordered = [...parts].sort((a, b) => a.partNumber - b.partNumber);
+  const body = ordered.map((part) => `<Part><PartNumber>${part.partNumber}</PartNumber><ETag>${escapeXml(part.etag)}</ETag></Part>`).join("");
+  return `<CompleteMultipartUpload>${body}</CompleteMultipartUpload>`;
+}
+function renditionFfmpegArgs(inputPath, outputPath) {
+  return [
+    "-y",
+    "-i",
+    inputPath,
+    "-vf",
+    `scale=-2:${SET_VIDEO_RENDITION.height}`,
+    "-c:v",
+    "libx264",
+    "-preset",
+    "medium",
+    "-crf",
+    String(SET_VIDEO_RENDITION.crf),
+    "-force_key_frames",
+    `expr:gte(t,n_forced*${SET_VIDEO_RENDITION.gopSeconds})`,
+    "-pix_fmt",
+    "yuv420p",
+    "-c:a",
+    "aac",
+    "-b:a",
+    SET_VIDEO_RENDITION.audioBitrate,
+    "-movflags",
+    "+faststart",
+    outputPath
+  ];
+}
+async function uploadRenditionMultipart(masterPath, presignPath, onProgress = () => {}) {
+  if (!existsSync2(masterPath)) {
+    throw new CliError2("file_not_found", `Set-video master not found: ${masterPath}`);
+  }
+  await assertFfmpeg();
+  const renditionPath = join4(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
+  onProgress("Set video: deriving the 1080p faststart rendition (ffmpeg)…");
+  await deriveRendition(masterPath, renditionPath);
+  try {
+    const size = statSync3(renditionPath).size;
+    const plan = planMultipart(size);
+    onProgress(`Set video: uploading ${(size / 1e9).toFixed(2)} GB in ${plan.partCount} part(s)…`);
+    const presign = await adminApiPost(presignPath, {
+      partCount: plan.partCount
+    });
+    const urlByPart = new Map(presign.parts.map((part) => [part.partNumber, part.url]));
+    const completed = [];
+    try {
+      for (const part of plan.parts) {
+        const url = urlByPart.get(part.partNumber);
+        if (!url) {
+          throw new CliError2("presign_missing", `Worker did not sign part ${part.partNumber} of ${plan.partCount}`);
+        }
+        onProgress(`Set video: part ${part.partNumber}/${plan.partCount}`);
+        const etag = await putPart(url, renditionPath, part);
+        completed.push({ etag, partNumber: part.partNumber });
+      }
+      await completeUpload(presign.completeUrl, completed);
+    } catch (error) {
+      await abortUpload(presign.abortUrl).catch(() => {});
+      throw error;
+    }
+    return { key: presign.key, url: `${FOUND_BASE2}/${presign.key}` };
+  } finally {
+    rmSync2(renditionPath, { force: true });
+  }
+}
+async function putPart(url, path2, part) {
+  const response = await fetch(url, {
+    body: Bun.file(path2).slice(part.start, part.end),
+    method: "PUT"
+  });
+  if (!response.ok) {
+    const detail = (await response.text().catch(() => "")).slice(0, 300);
+    throw new CliError2("r2_part_failed", `R2 rejected part ${part.partNumber} (${response.status} ${response.statusText})${detail ? `: ${detail}` : ""}`);
+  }
+  const etag = response.headers.get("etag");
+  if (!etag) {
+    throw new CliError2("r2_no_etag", `R2 returned no ETag for part ${part.partNumber}`);
+  }
+  return etag;
+}
+async function completeUpload(url, parts) {
+  const response = await fetch(url, {
+    body: buildCompleteXml(parts),
+    headers: { "content-type": "application/xml" },
+    method: "POST"
+  });
+  const text = await response.text().catch(() => "");
+  if (!response.ok || text.includes("<Error>")) {
+    throw new CliError2("r2_complete_failed", `R2 CompleteMultipartUpload failed (${response.status} ${response.statusText})${text ? `: ${text.slice(0, 300)}` : ""}`);
+  }
+}
+async function abortUpload(url) {
+  await fetch(url, { method: "DELETE" });
+}
+async function assertFfmpeg() {
+  try {
+    const proc = Bun.spawn(["ffmpeg", "-version"], { stderr: "ignore", stdout: "ignore" });
+    await proc.exited;
+    if (proc.exitCode !== 0) {
+      throw new Error("ffmpeg -version exited non-zero");
+    }
+  } catch {
+    throw new CliError2("ffmpeg_missing", "--set-video needs ffmpeg to derive the 1080p rendition. Install it (brew install ffmpeg).");
+  }
+}
+async function deriveRendition(inputPath, outputPath) {
+  const proc = Bun.spawn(["ffmpeg", ...renditionFfmpegArgs(inputPath, outputPath)], {
+    stderr: "pipe",
+    stdout: "ignore"
+  });
+  await proc.exited;
+  if (proc.exitCode !== 0) {
+    const detail = (await new Response(proc.stderr).text().catch(() => "")).slice(-400);
+    throw new CliError2("ffmpeg_failed", `ffmpeg failed to derive the set-video rendition${detail ? `: ${detail}` : ""}`);
+  }
+}
+var FOUND_BASE2 = "https://found.fluncle.com", SET_VIDEO_RENDITION, DEFAULT_PART_SIZE, MIN_PART_SIZE, MAX_PARTS = 1e4;
+var init_mixtape_set_video = __esm(() => {
+  init_api();
+  init_output();
+  SET_VIDEO_RENDITION = {
+    audioBitrate: "192k",
+    crf: 20,
+    gopSeconds: 2,
+    height: 1080
+  };
+  DEFAULT_PART_SIZE = 100 * 1024 * 1024;
+  MIN_PART_SIZE = 5 * 1024 * 1024;
+});
+
 // src/commands/recordings.ts
 var exports_recordings = {};
 __export(exports_recordings, {
   recordingsListCommand: () => recordingsListCommand,
   recordingUpdateCommand: () => recordingUpdateCommand,
+  recordingReplaceCuesCommand: () => recordingReplaceCuesCommand,
   recordingPromoteCommand: () => recordingPromoteCommand,
   recordingGetCommand: () => recordingGetCommand,
   recordingGet: () => recordingGet,
@@ -3878,12 +3844,21 @@ async function recordingGet(id) {
   return response.recording;
 }
 function formatRecordingSummary(recording) {
+  const kind = recording.hasVideo ? `take v${recording.version}` : "plan";
   const promoted = recording.logId ? ` → fluncle://${recording.logId}` : " (un-promoted)";
   const cues = recording.tracklist.length;
-  return `${recording.id}  ${recording.title}${promoted}  [${cues} cue${cues === 1 ? "" : "s"}]`;
+  return `${recording.id}  [${kind}]  ${recording.title}${promoted}  [${cues} cue${cues === 1 ? "" : "s"}]`;
 }
 async function recordingsListCommand(options = {}) {
-  const response = await adminApiGet("/api/admin/recordings");
+  const query = new URLSearchParams;
+  if (options.kind) {
+    query.set("kind", options.kind);
+  }
+  if (options.parentId) {
+    query.set("parentId", options.parentId);
+  }
+  const suffix = query.toString() ? `?${query.toString()}` : "";
+  const response = await adminApiGet(`/api/admin/recordings${suffix}`);
   if (options.json) {
     printJson2({ ok: true, recordings: response.recordings });
     return;
@@ -3912,9 +3887,22 @@ async function recordingGetCommand(id, options = {}) {
   }
 }
 async function recordingCreateCommand(options = {}) {
+  if (options.plan) {
+    const created2 = await adminApiPost("/api/admin/recordings", {
+      kind: "plan",
+      recordedAt: options.recordedAt
+    });
+    const recording2 = created2.recording;
+    if (options.json) {
+      printJson2({ ok: true, recording: recording2 });
+      return;
+    }
+    console.log(`Plan ${recording2.id} created — handle "${recording2.title}"`);
+    return;
+  }
   const title = options.title?.trim();
   if (!title) {
-    throw new CliError2("missing_title", "A recording needs a --title");
+    throw new CliError2("missing_title", "A recording needs a --title (or --plan for a videoless plan)");
   }
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
@@ -3951,6 +3939,9 @@ async function recordingUpdateCommand(id, options = {}) {
   if (options.recordedAt !== undefined) {
     body.recordedAt = options.recordedAt;
   }
+  if (options.parentId !== undefined) {
+    body.parentId = options.parentId;
+  }
   if (options.tracklistFile !== undefined) {
     if (!existsSync3(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
@@ -3962,7 +3953,7 @@ async function recordingUpdateCommand(id, options = {}) {
     }
   }
   if (Object.keys(body).length === 0) {
-    throw new CliError2("no_fields", "Nothing to update — pass --title, --recorded-at, 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) {
@@ -3994,6 +3985,29 @@ async function recordingPromoteCommand(id, options = {}) {
   }
   console.log(recording.logId ? `Promoted recording ${id} → mixtape fluncle://${recording.logId}` : `Promoted recording ${id}`);
 }
+async function recordingReplaceCuesCommand(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: replace-cues");
+  }
+  if (!options.cuesFile) {
+    throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
+  }
+  if (!existsSync3(options.cuesFile)) {
+    throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
+  }
+  let cues;
+  try {
+    cues = JSON.parse(readFileSync3(options.cuesFile, "utf8"));
+  } catch {
+    throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
+  }
+  const response = await adminApiPut(`/api/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
+  if (options.json) {
+    printJson2({ ok: true, recording: response.recording });
+    return;
+  }
+  console.log(`Replaced cues for ${formatRecordingSummary(response.recording)}`);
+}
 var init_recordings = __esm(() => {
   init_api();
   init_output();
@@ -4043,21 +4057,24 @@ async function mixtapeDistributeCommand2(idOrLogId, options, onProgress = () =>
   if (!mixtape.id) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
   }
-  const both = !options.youtube && !options.mixcloud && !options.setVideo;
+  if (mixtape.status === "draft") {
+    throw new CliError2("mixtape_not_promoted", `${mixtape.id} is still a draft — promote its recording first:
+` + "  fluncle admin recordings promote <recordingId>");
+  }
+  const both = !options.youtube && !options.mixcloud;
   const doYoutube = both || Boolean(options.youtube);
   const doMixcloud = both || Boolean(options.mixcloud);
-  const doSetVideo = Boolean(options.setVideo);
   if (doYoutube && !options.video) {
     throw new CliError2("missing_video", "YouTube distribution needs --video <mp4>");
   }
   if (doMixcloud && !options.audio) {
     throw new CliError2("missing_audio", "Mixcloud distribution needs --audio <file>");
   }
-  if (doSetVideo && !options.video) {
-    throw new CliError2("missing_video", "--set-video needs --video <master.mp4>");
-  }
   const mixtapeId = mixtape.id;
-  let logId = mixtape.logId;
+  const logId = mixtape.logId;
+  if (!logId) {
+    throw new CliError2("missing_log_id", "The mixtape has no Log ID — was it promoted successfully?");
+  }
   if (!mixtape.durationMs) {
     const source = options.audio ?? options.video;
     const durationMs = source ? await probeDurationMs2(source) : undefined;
@@ -4066,18 +4083,10 @@ async function mixtapeDistributeCommand2(idOrLogId, options, onProgress = () =>
       onProgress(`Duration: ${Math.round(durationMs / 60000)} min (from the upload).`);
     }
   }
-  if (mixtape.status === "draft") {
-    onProgress("Minting the coordinate…");
-    const published = await mixtapePublishCommand2(mixtapeId);
-    logId = published.mixtape.logId;
-    onProgress(`Minted ${logId}.`);
-  } else if (mixtape.status === "published") {
+  if (mixtape.status === "published") {
     onProgress(`Already published (${logId}); re-distributing.`);
   } else {
-    onProgress(`Resuming distribution for ${logId}.`);
-  }
-  if (!logId) {
-    throw new CliError2("mint_failed", "The mixtape has no Log ID after minting");
+    onProgress(`Distributing ${logId} (promoted — coordinate already minted).`);
   }
   const results = [];
   if (doYoutube) {
@@ -4100,16 +4109,6 @@ async function mixtapeDistributeCommand2(idOrLogId, options, onProgress = () =>
     results.push({ platform: "mixcloud", url: result.url });
     onProgress(`Mixcloud: ${result.url}`);
   }
-  if (doSetVideo) {
-    if (!options.video) {
-      throw new CliError2("missing_video", "--set-video needs --video <master.mp4>");
-    }
-    onProgress("Set video: staging the 1080p rendition…");
-    const { stageSetVideo: stageSetVideo2 } = await Promise.resolve().then(() => (init_mixtape_set_video(), exports_mixtape_set_video));
-    const result = await stageSetVideo2(mixtapeId, options.video, onProgress);
-    results.push({ platform: "set-video", url: result.url });
-    onProgress(`Set video: ${result.url}`);
-  }
   return { logId, mixtapeId, results };
 }
 async function mixtapeResyncCommand2(idOrLogId, options, onProgress = () => {}) {
@@ -4352,7 +4351,7 @@ async function resolveClipSource(clip) {
     throw new CliError2("mixtape_no_log_id", `Mixtape ${clip.mixtapeId} has no committed Log ID`);
   }
   if (!mixtape.setVideoAt) {
-    throw new CliError2("set_not_staged", `Mixtape ${mixtape.logId} has no staged set video — run \`distribute --set-video\` first`);
+    throw new CliError2("set_not_staged", `Mixtape ${mixtape.logId} has no staged set video — run \`recordings promote <recordingId>\` first`);
   }
   return { setUrl: setVideoUrl(mixtape.logId) };
 }
@@ -4441,6 +4440,7 @@ var exports_recordings2 = {};
 __export(exports_recordings2, {
   recordingsListCommand: () => recordingsListCommand2,
   recordingUpdateCommand: () => recordingUpdateCommand2,
+  recordingReplaceCuesCommand: () => recordingReplaceCuesCommand2,
   recordingPromoteCommand: () => recordingPromoteCommand2,
   recordingGetCommand: () => recordingGetCommand2,
   recordingGet: () => recordingGet2,
@@ -4453,12 +4453,21 @@ async function recordingGet2(id) {
   return response.recording;
 }
 function formatRecordingSummary2(recording) {
+  const kind = recording.hasVideo ? `take v${recording.version}` : "plan";
   const promoted = recording.logId ? ` → fluncle://${recording.logId}` : " (un-promoted)";
   const cues = recording.tracklist.length;
-  return `${recording.id}  ${recording.title}${promoted}  [${cues} cue${cues === 1 ? "" : "s"}]`;
+  return `${recording.id}  [${kind}]  ${recording.title}${promoted}  [${cues} cue${cues === 1 ? "" : "s"}]`;
 }
 async function recordingsListCommand2(options = {}) {
-  const response = await adminApiGet("/api/admin/recordings");
+  const query = new URLSearchParams;
+  if (options.kind) {
+    query.set("kind", options.kind);
+  }
+  if (options.parentId) {
+    query.set("parentId", options.parentId);
+  }
+  const suffix = query.toString() ? `?${query.toString()}` : "";
+  const response = await adminApiGet(`/api/admin/recordings${suffix}`);
   if (options.json) {
     printJson2({ ok: true, recordings: response.recordings });
     return;
@@ -4487,9 +4496,22 @@ async function recordingGetCommand2(id, options = {}) {
   }
 }
 async function recordingCreateCommand2(options = {}) {
+  if (options.plan) {
+    const created2 = await adminApiPost("/api/admin/recordings", {
+      kind: "plan",
+      recordedAt: options.recordedAt
+    });
+    const recording2 = created2.recording;
+    if (options.json) {
+      printJson2({ ok: true, recording: recording2 });
+      return;
+    }
+    console.log(`Plan ${recording2.id} created — handle "${recording2.title}"`);
+    return;
+  }
   const title = options.title?.trim();
   if (!title) {
-    throw new CliError2("missing_title", "A recording needs a --title");
+    throw new CliError2("missing_title", "A recording needs a --title (or --plan for a videoless plan)");
   }
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
@@ -4526,6 +4548,9 @@ async function recordingUpdateCommand2(id, options = {}) {
   if (options.recordedAt !== undefined) {
     body.recordedAt = options.recordedAt;
   }
+  if (options.parentId !== undefined) {
+    body.parentId = options.parentId;
+  }
   if (options.tracklistFile !== undefined) {
     if (!existsSync5(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
@@ -4537,7 +4562,7 @@ async function recordingUpdateCommand2(id, options = {}) {
     }
   }
   if (Object.keys(body).length === 0) {
-    throw new CliError2("no_fields", "Nothing to update — pass --title, --recorded-at, 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) {
@@ -4569,6 +4594,29 @@ async function recordingPromoteCommand2(id, options = {}) {
   }
   console.log(recording.logId ? `Promoted recording ${id} → mixtape fluncle://${recording.logId}` : `Promoted recording ${id}`);
 }
+async function recordingReplaceCuesCommand2(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: replace-cues");
+  }
+  if (!options.cuesFile) {
+    throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
+  }
+  if (!existsSync5(options.cuesFile)) {
+    throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
+  }
+  let cues;
+  try {
+    cues = JSON.parse(readFileSync5(options.cuesFile, "utf8"));
+  } catch {
+    throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
+  }
+  const response = await adminApiPut(`/api/admin/recordings/${encodeURIComponent(id)}/cues`, { cues });
+  if (options.json) {
+    printJson2({ ok: true, recording: response.recording });
+    return;
+  }
+  console.log(`Replaced cues for ${formatRecordingSummary2(response.recording)}`);
+}
 var init_recordings2 = __esm(() => {
   init_api();
   init_output();
@@ -7598,7 +7646,7 @@ function addAdminCommands(program2) {
     const { mixtapeGetCommand: mixtapeGetCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeGet(idOrLogId, options, mixtapeGetCommand2);
   });
-  adminMixtapes.command("distribute").description("Mint + push a mixtape to YouTube (video) and Mixcloud (audio)").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("--set-video", "Also stage a 1080p set-video rendition (from --video) to R2 + flip setVideoAt for the /log player").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`) \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) => {
     const { mixtapeDistributeCommand: mixtapeDistributeCommand3 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeDistribute(idOrLogId, options, mixtapeDistributeCommand3);
   });
@@ -7626,11 +7674,11 @@ function addAdminCommands(program2) {
   adminRecordings.action(() => {
     adminRecordings.outputHelp();
   });
-  adminRecordings.command("create").description("Create a recording + stage its set video (from --video)").option("--title <text>", "Recording title").option("--video <file>", "Set-video master to stage (a 1080p rendition is derived)").option("--recorded-at <date>", "Recorded date (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminRecordings.command("create").description("Create a recording (--video to stage a take, or --plan for a videoless plan)").option("--plan", "Create a videoless PLAN (server mints a Galaxy-vocab handle)", false).option("--title <text>", "Recording title (a take)").option("--video <file>", "Set-video master to stage (a 1080p rendition is derived)").option("--recorded-at <date>", "Recorded date (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { recordingCreateCommand: recordingCreateCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
     await recordingCreateCommand3(options);
   });
-  adminRecordings.command("list").description("List every recording").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminRecordings.command("list").description("List recordings (--kind plan|take, --parent-id <plan> for a plan's takes)").option("--kind <kind>", "Filter by kind: plan | take").option("--parent-id <id>", "List the takes attached to this plan").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { recordingsListCommand: recordingsListCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
     await recordingsListCommand3(options);
   });
@@ -7638,10 +7686,14 @@ function addAdminCommands(program2) {
     const { recordingGetCommand: recordingGetCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
     await recordingGetCommand3(id, options);
   });
-  adminRecordings.command("update").description("Update a recording's title, recorded date, or tracklist (--tracklist-file)").argument("[id]").option("--title <text>", "Recording title").option("--recorded-at <date>", "Recorded date (ISO)").option("--tracklist-file <file>", "JSON file with the whole cue tracklist array").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+  adminRecordings.command("update").description("Update a recording's title/recorded date/tracklist, or attach it to a plan").argument("[id]").option("--title <text>", "Recording title").option("--recorded-at <date>", "Recorded date (ISO)").option("--parent-id <id>", "Attach this take to its plan (assigns the take's version)").option("--tracklist-file <file>", "JSON file with the whole cue tracklist array").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
     const { recordingUpdateCommand: recordingUpdateCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
     await recordingUpdateCommand3(id, options);
   });
+  adminRecordings.command("replace-cues").description("Replace a recording's whole cue tracklist from a JSON file (--cues-file)").argument("[id]").option("--cues-file <file>", "JSON file with the ordered cue array").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { recordingReplaceCuesCommand: recordingReplaceCuesCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
+    await recordingReplaceCuesCommand3(id, options);
+  });
   adminRecordings.command("delete").description("Delete a recording (cascade its clips)").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
     const { recordingDeleteCommand: recordingDeleteCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
     await recordingDeleteCommand3(id, options);

package/package.json

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