fluncle 0.77.0 → 0.79.0

package/bin/fluncle.mjs

@@ -482,6 +482,20 @@ function resolveClipTracks(options) {
     startMs: member.startMs
   }));
 }
+function mixcloudSections(members) {
+  return members.filter((member) => member.startMs != null).sort((a, b) => a.startMs - b.startMs).map((member) => ({
+    artist: member.artists.join(", "),
+    song: member.title,
+    start_time: Math.floor(member.startMs / 1000)
+  }));
+}
+function mixcloudSectionFields(sections) {
+  return sections.flatMap((section, index) => [
+    [`sections-${index}-artist`, section.artist],
+    [`sections-${index}-song`, section.song],
+    [`sections-${index}-start_time`, String(section.start_time)]
+  ]);
+}
 function baseTitleMatches(findingTitle, candidateTitle) {
   const want = new Set(tokenize(stripVersionSuffix(findingTitle)));
   const have = new Set(tokenize(stripVersionSuffix(candidateTitle)));
@@ -544,7 +558,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.77.0".trim() ? "0.77.0".trim() : "0.1.0";
+  currentVersion = "0.79.0".trim() ? "0.79.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1196,9 +1210,6 @@ var exports_mixtape_mixcloud = {};
 __export(exports_mixtape_mixcloud, {
   resyncMixcloud: () => resyncMixcloud,
   mixtapeDescription: () => mixtapeDescription,
-  mixcloudSections: () => mixcloudSections,
-  mixcloudSectionFields: () => mixcloudSectionFields,
-  mixcloudEditUrl: () => mixcloudEditUrl,
   distributeMixcloud: () => distributeMixcloud,
   authMixcloudCommand: () => authMixcloudCommand
 });
@@ -1259,34 +1270,9 @@ async function distributeMixcloud(mixtapeId, audioPath, onProgress, unlisted = f
   });
   return { url };
 }
-async function resyncMixcloud(mixtapeId, onProgress) {
-  const token = await fetchMixcloudToken();
-  const mixtape = await mixtapeGetCommand(mixtapeId);
-  const sections = mixcloudSections(mixtape.members);
-  if (sections.length === 0) {
-    throw new CliError2("mixcloud_no_cues", "No cued members to sync — mark cues on the mixtape first.");
-  }
-  const social = await adminApiGet(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/social`);
-  const mixcloud = social.posts.find((post) => post.platform === "mixcloud");
-  const key = mixcloud?.externalId;
-  if (!key) {
-    throw new CliError2("mixcloud_not_distributed", "No Mixcloud cloudcast to re-sync — distribute the mixtape first.");
-  }
-  const form = new FormData;
-  for (const [name, value] of mixcloudSectionFields(sections)) {
-    form.append(name, value);
-  }
-  onProgress?.(`Mixcloud: re-syncing ${sections.length} sections (no re-upload)…`);
-  const response = await fetch(`${mixcloudEditUrl(key)}?access_token=${encodeURIComponent(token)}`, { body: form, method: "POST" });
-  const text = await response.text();
-  if (!response.ok) {
-    throwMixcloudError(response.status, text);
-  }
-  const result = parseUploadResult(text);
-  if (!result.success) {
-    throw new CliError2("mixcloud_edit_rejected", `Mixcloud rejected the section edit: ${result.message ?? text.slice(0, 300)}`);
-  }
-  return { url: mixcloud?.url ?? `https://www.mixcloud.com${key}` };
+async function resyncMixcloud(mixtapeId) {
+  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
+  return { url: response.url };
 }
 async function authMixcloudCommand() {
   const response = await adminApiGet("/api/admin/mixcloud/auth/start");
@@ -1311,25 +1297,6 @@ ${breadcrumb}` : breadcrumb;
 
 ${breadcrumb}` : breadcrumb;
 }
-function mixcloudSections(members) {
-  return members.filter((member) => typeof member.startMs === "number").sort((a, b) => a.startMs - b.startMs).map((member) => ({
-    artist: member.artists.join(", "),
-    song: member.title,
-    start_time: Math.floor(member.startMs / 1000)
-  }));
-}
-function mixcloudSectionFields(sections) {
-  return sections.flatMap((section, index) => [
-    [`sections-${index}-artist`, section.artist],
-    [`sections-${index}-song`, section.song],
-    [`sections-${index}-start_time`, String(section.start_time)]
-  ]);
-}
-function mixcloudEditUrl(key) {
-  const withLeading = key.startsWith("/") ? key : `/${key}`;
-  const path2 = withLeading.endsWith("/") ? withLeading : `${withLeading}/`;
-  return `${MIXCLOUD_API}/upload${path2}edit/`;
-}
 function mixtapeTags(_mixtape) {
   return ["Drum & Bass", "Fluncle"];
 }
@@ -1374,6 +1341,7 @@ function throwMixcloudError(status, body) {
 }
 var MIXCLOUD_API = "https://api.mixcloud.com", DESCRIPTION_MAX = 1000, PICTURE_MAX_BYTES, COVER_BASE = "https://www.fluncle.com/api/mixtape-cover";
 var init_mixtape_mixcloud = __esm(() => {
+  init_util();
   init_api();
   init_output();
   init_mixtape_api();
@@ -1383,6 +1351,7 @@ var init_mixtape_mixcloud = __esm(() => {
 // src/commands/mixtape-set-video.ts
 var exports_mixtape_set_video = {};
 __export(exports_mixtape_set_video, {
+  uploadRenditionMultipart: () => uploadRenditionMultipart,
   stageSetVideo: () => stageSetVideo,
   renditionFfmpegArgs: () => renditionFfmpegArgs,
   planMultipart: () => planMultipart,
@@ -1449,7 +1418,7 @@ function renditionFfmpegArgs(inputPath, outputPath) {
     outputPath
   ];
 }
-async function stageSetVideo(mixtapeId, masterPath, onProgress = () => {}) {
+async function uploadRenditionMultipart(masterPath, presignPath, onProgress = () => {}) {
   if (!existsSync(masterPath)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${masterPath}`);
   }
@@ -1461,7 +1430,9 @@ async function stageSetVideo(mixtapeId, masterPath, onProgress = () => {}) {
     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(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/set-video/presign`, { partCount: plan.partCount });
+    const presign = await adminApiPost(presignPath, {
+      partCount: plan.partCount
+    });
     const urlByPart = new Map(presign.parts.map((part) => [part.partNumber, part.url]));
     const completed = [];
     try {
@@ -1479,13 +1450,19 @@ async function stageSetVideo(mixtapeId, masterPath, onProgress = () => {}) {
       await abortUpload(presign.abortUrl).catch(() => {});
       throw error;
     }
-    await adminApiPatch(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}`, { setVideoAt: new Date().toISOString() });
-    onProgress("Set video: flipped setVideoAt — the /log player + video SEO are live.");
     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),
@@ -1695,7 +1672,7 @@ async function mixtapeResyncCommand(idOrLogId, options, onProgress = () => {}) {
   if (doMixcloud) {
     onProgress("Mixcloud: re-syncing sections…");
     const { resyncMixcloud: resyncMixcloud2 } = await Promise.resolve().then(() => (init_mixtape_mixcloud(), exports_mixtape_mixcloud));
-    const result = await resyncMixcloud2(mixtapeId, onProgress);
+    const result = await resyncMixcloud2(mixtapeId);
     results.push({ platform: "mixcloud", url: result.url });
     onProgress(`Mixcloud: ${result.url}`);
   }
@@ -2487,7 +2464,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.77.0".trim() ? "0.77.0".trim() : "0.1.0";
+  currentVersion2 = "0.79.0".trim() ? "0.79.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3874,6 +3851,145 @@ var init_mixtape_youtube2 = __esm(() => {
   init_output();
 });
 
+// src/commands/recordings.ts
+var exports_recordings = {};
+__export(exports_recordings, {
+  recordingsListCommand: () => recordingsListCommand,
+  recordingUpdateCommand: () => recordingUpdateCommand,
+  recordingPromoteCommand: () => recordingPromoteCommand,
+  recordingGetCommand: () => recordingGetCommand,
+  recordingGet: () => recordingGet,
+  recordingDeleteCommand: () => recordingDeleteCommand,
+  recordingCreateCommand: () => recordingCreateCommand
+});
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+async function recordingGet(id) {
+  const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  return response.recording;
+}
+function formatRecordingSummary(recording) {
+  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"}]`;
+}
+async function recordingsListCommand(options = {}) {
+  const response = await adminApiGet("/api/admin/recordings");
+  if (options.json) {
+    printJson2({ ok: true, recordings: response.recordings });
+    return;
+  }
+  if (response.recordings.length === 0) {
+    console.log("No recordings yet.");
+    return;
+  }
+  console.log(response.recordings.map(formatRecordingSummary).join(`
+`));
+}
+async function recordingGetCommand(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: get");
+  }
+  const recording = await recordingGet(id);
+  if (options.json) {
+    printJson2({ ok: true, recording });
+    return;
+  }
+  console.log(formatRecordingSummary(recording));
+  console.log(`  r2Key: ${recording.r2Key}`);
+  for (const cue of recording.tracklist) {
+    const at = cue.startMs === undefined ? "—" : `${(cue.startMs / 1000).toFixed(1)}s`;
+    console.log(`  ${at}  ${cue.artists.join(", ")} — ${cue.title}`);
+  }
+}
+async function recordingCreateCommand(options = {}) {
+  const title = options.title?.trim();
+  if (!title) {
+    throw new CliError2("missing_title", "A recording needs a --title");
+  }
+  if (!options.video) {
+    throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
+  }
+  if (!existsSync3(options.video)) {
+    throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
+  }
+  const created = await adminApiPost("/api/admin/recordings", {
+    recordedAt: options.recordedAt,
+    title
+  });
+  const recording = created.recording;
+  const log = (message) => {
+    if (!options.json) {
+      console.log(message);
+    }
+  };
+  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 });
+    return;
+  }
+  console.log(`Recording ${recording.id} staged → ${upload.url}`);
+}
+async function recordingUpdateCommand(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: update");
+  }
+  const body = {};
+  if (options.title !== undefined) {
+    body.title = options.title;
+  }
+  if (options.recordedAt !== undefined) {
+    body.recordedAt = options.recordedAt;
+  }
+  if (options.tracklistFile !== undefined) {
+    if (!existsSync3(options.tracklistFile)) {
+      throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
+    }
+    try {
+      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, or --tracklist-file");
+  }
+  const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
+  if (options.json) {
+    printJson2({ ok: true, recording: response.recording });
+    return;
+  }
+  console.log(`Updated ${formatRecordingSummary(response.recording)}`);
+}
+async function recordingDeleteCommand(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: delete");
+  }
+  await adminApiDelete(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  if (options.json) {
+    printJson2({ ok: true });
+    return;
+  }
+  console.log(`Deleted recording ${id} (and its clips).`);
+}
+async function recordingPromoteCommand(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: promote");
+  }
+  const response = await adminApiPost(`/api/admin/recordings/${encodeURIComponent(id)}/promote`);
+  const recording = response.recording;
+  if (options.json) {
+    printJson2({ ok: true, recording });
+    return;
+  }
+  console.log(recording.logId ? `Promoted recording ${id} → mixtape fluncle://${recording.logId}` : `Promoted recording ${id}`);
+}
+var init_recordings = __esm(() => {
+  init_api();
+  init_output();
+  init_mixtape_set_video();
+});
+
 // src/commands/mixtapes.ts
 var exports_mixtapes2 = {};
 __export(exports_mixtapes2, {
@@ -3888,7 +4004,7 @@ __export(exports_mixtapes2, {
   mixtapeDeleteCommand: () => mixtapeDeleteCommand2,
   mixtapeCreateCommand: () => mixtapeCreateCommand2
 });
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
 async function mixtapesCommand2() {
   const response = await publicApiGet("/api/mixtapes");
   return response.mixtapes;
@@ -4018,7 +4134,7 @@ async function mixtapeResyncCommand2(idOrLogId, options, onProgress = () => {})
   if (doMixcloud) {
     onProgress("Mixcloud: re-syncing sections…");
     const { resyncMixcloud: resyncMixcloud2 } = await Promise.resolve().then(() => (init_mixtape_mixcloud(), exports_mixtape_mixcloud));
-    const result = await resyncMixcloud2(mixtapeId, onProgress);
+    const result = await resyncMixcloud2(mixtapeId);
     results.push({ platform: "mixcloud", url: result.url });
     onProgress(`Mixcloud: ${result.url}`);
   }
@@ -4056,10 +4172,10 @@ function buildBody2(options) {
   return body;
 }
 function parseCueFile2(filePath) {
-  if (!existsSync3(filePath)) {
+  if (!existsSync4(filePath)) {
     throw new CliError2("file_not_found", `Cue file not found: ${filePath}`);
   }
-  const text = readFileSync3(filePath, "utf-8");
+  const text = readFileSync4(filePath, "utf-8");
   const trimmed = text.trim();
   if (trimmed.startsWith("[") || trimmed.startsWith("{")) {
     try {
@@ -4156,7 +4272,7 @@ __export(exports_clips, {
   BOX_CLIP_FONT_FILE: () => BOX_CLIP_FONT_FILE
 });
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { existsSync as existsSync4, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync5, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join5 } from "node:path";
 function clipFootageKey(clipId) {
@@ -4167,7 +4283,7 @@ function resolveFontFile(envVar, bakedPath) {
   if (explicit) {
     return explicit;
   }
-  return existsSync4(bakedPath) ? bakedPath : undefined;
+  return existsSync5(bakedPath) ? bakedPath : undefined;
 }
 function resolveClipFontFile() {
   return resolveFontFile("CLIP_FONT_FILE", BOX_CLIP_FONT_FILE);
@@ -4217,24 +4333,32 @@ function resolveTitleLines(options, y) {
 function clipCutFilterComplex(options) {
   const xOffset = Math.max(0, Math.round(options.xOffset));
   const crop = `crop=ih*9/16:ih:${xOffset}:0,scale=${CLIP_WIDTH}:${CLIP_HEIGHT}`;
+  const logId = options.logId?.trim();
+  const hasCoordinate = Boolean(logId);
   const coordinateBox = Math.round(CLIP_COORDINATE_SIZE * 1.18);
-  const titleBottomOffset = CLIP_SAFE_BOTTOM + coordinateBox + CLIP_LINE_GAP;
+  const titleBottomOffset = hasCoordinate ? CLIP_SAFE_BOTTOM + coordinateBox + CLIP_LINE_GAP : CLIP_SAFE_BOTTOM;
   const titleY = `h-${titleBottomOffset}-th`;
   const titleLines = resolveTitleLines(options, titleY);
-  const coordinate2 = {
+  const coordinate2 = hasCoordinate ? {
     fontFile: options.oxaniumFontFile,
     size: CLIP_COORDINATE_SIZE,
-    text: `fluncle://${options.logId}`,
+    text: `fluncle://${logId}`,
     x: CLIP_MARGIN_X,
     y: `h-${CLIP_SAFE_BOTTOM}-th`
-  };
+  } : undefined;
   const haloGlyphs = [
     ...titleLines.map((line) => brandDrawtext({ ...line, color: CLIP_HALO_COLOR })),
-    brandDrawtext({ ...coordinate2, color: CLIP_HALO_COLOR })
+    ...coordinate2 ? [brandDrawtext({ ...coordinate2, color: CLIP_HALO_COLOR })] : []
   ].join(",");
   const sharpGlyphs = [
     ...titleLines.map((line) => brandDrawtext({ ...line, borderw: CLIP_SHARP_BORDERW, color: CLIP_TITLE_COLOR })),
-    brandDrawtext({ ...coordinate2, borderw: CLIP_SHARP_BORDERW, color: CLIP_COORDINATE_COLOR })
+    ...coordinate2 ? [
+      brandDrawtext({
+        ...coordinate2,
+        borderw: CLIP_SHARP_BORDERW,
+        color: CLIP_COORDINATE_COLOR
+      })
+    ] : []
   ].join(",");
   return [
     `[0:v]${crop},setsar=1[base]`,
@@ -4288,6 +4412,9 @@ function clipCutFfmpegArgs(options) {
 }
 async function clipsListCommand(filter = {}) {
   const params = new URLSearchParams;
+  if (filter.recordingId) {
+    params.set("recordingId", filter.recordingId);
+  }
   if (filter.mixtapeId) {
     params.set("mixtapeId", filter.mixtapeId);
   }
@@ -4298,11 +4425,27 @@ async function clipsListCommand(filter = {}) {
   const response = await adminApiGet(`/api/admin/clips${query ? `?${query}` : ""}`);
   return response.clips;
 }
-async function clipCutCommand(clipId, onProgress = () => {}) {
-  const clips = await clipsListCommand();
-  const clip = clips.find((candidate) => candidate.id === clipId);
-  if (!clip) {
-    throw new CliError2("clip_not_found", `No clip with id ${clipId}`);
+async function resolveClipSource(clip) {
+  if (clip.recordingId) {
+    const { recordingGet: recordingGet2 } = await Promise.resolve().then(() => (init_recordings(), exports_recordings));
+    const recording = await recordingGet2(clip.recordingId);
+    if (!recording.r2Key) {
+      throw new CliError2("recording_not_staged", `Recording ${clip.recordingId} has no staged set video`);
+    }
+    return {
+      logId: recording.logId,
+      members: recording.tracklist.map((cue) => ({
+        artists: cue.artists,
+        startMs: cue.startMs,
+        title: cue.title
+      })),
+      setDurationMs: recording.durationMs ?? 0,
+      setUrl: `${FOUND_BASE3}/${recording.r2Key.split("/").map(encodeURIComponent).join("/")}`,
+      title: recording.title
+    };
+  }
+  if (!clip.mixtapeId) {
+    throw new CliError2("clip_unlinked", `Clip ${clip.id} is linked to neither a recording nor a mixtape`);
   }
   const { mixtapeGetCommand: mixtapeGetCommand2 } = await Promise.resolve().then(() => (init_mixtapes2(), exports_mixtapes2));
   const mixtape = await mixtapeGetCommand2(clip.mixtapeId);
@@ -4312,22 +4455,36 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
   if (!mixtape.setVideoAt) {
     throw new CliError2("set_not_staged", `Mixtape ${mixtape.logId} has no staged set video — run \`distribute --set-video\` first`);
   }
+  return {
+    logId: mixtape.logId,
+    members: mixtape.members,
+    setDurationMs: mixtape.durationMs ?? 0,
+    setUrl: setVideoUrl(mixtape.logId),
+    title: mixtape.title
+  };
+}
+async function clipCutCommand(clipId, onProgress = () => {}) {
+  const clips = await clipsListCommand();
+  const clip = clips.find((candidate) => candidate.id === clipId);
+  if (!clip) {
+    throw new CliError2("clip_not_found", `No clip with id ${clipId}`);
+  }
+  const source = await resolveClipSource(clip);
   await assertFfmpeg2();
-  const setUrl = setVideoUrl(mixtape.logId);
   const outputPath = join5(tmpdir2(), `fluncle-clip-${randomUUID2()}.mp4`);
   try {
-    onProgress(`Clip ${clipId}: cutting [${clip.inMs}–${clip.outMs}ms] from ${mixtape.logId}…`);
+    onProgress(`Clip ${clipId}: cutting [${clip.inMs}–${clip.outMs}ms]${source.logId ? ` from ${source.logId}` : ""}…`);
     await runClipCut({
       inMs: clip.inMs,
-      logId: mixtape.logId,
-      members: mixtape.members,
+      logId: source.logId,
+      members: source.members,
       outMs: clip.outMs,
       outputPath,
       oxaniumFontFile: resolveClipFontFile(),
       sansFontFile: resolveClipSansFontFile(),
-      setDurationMs: mixtape.durationMs ?? 0,
-      setUrl,
-      title: mixtape.title,
+      setDurationMs: source.setDurationMs,
+      setUrl: source.setUrl,
+      title: source.title,
       xOffset: clip.xOffset
     });
     const sizeBytes = statSync4(outputPath).size;
@@ -4342,7 +4499,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
     return {
       clipId,
       key: presign.key,
-      logId: mixtape.logId,
+      logId: source.logId,
       sizeBytes,
       url: `${FOUND_BASE3}/${presign.key}`
     };
@@ -4394,6 +4551,145 @@ var init_clips = __esm(() => {
   MAX_CLIP_BYTES = 100 * 1024 * 1024;
 });
 
+// src/commands/recordings.ts
+var exports_recordings2 = {};
+__export(exports_recordings2, {
+  recordingsListCommand: () => recordingsListCommand2,
+  recordingUpdateCommand: () => recordingUpdateCommand2,
+  recordingPromoteCommand: () => recordingPromoteCommand2,
+  recordingGetCommand: () => recordingGetCommand2,
+  recordingGet: () => recordingGet2,
+  recordingDeleteCommand: () => recordingDeleteCommand2,
+  recordingCreateCommand: () => recordingCreateCommand2
+});
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "node:fs";
+async function recordingGet2(id) {
+  const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  return response.recording;
+}
+function formatRecordingSummary2(recording) {
+  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"}]`;
+}
+async function recordingsListCommand2(options = {}) {
+  const response = await adminApiGet("/api/admin/recordings");
+  if (options.json) {
+    printJson2({ ok: true, recordings: response.recordings });
+    return;
+  }
+  if (response.recordings.length === 0) {
+    console.log("No recordings yet.");
+    return;
+  }
+  console.log(response.recordings.map(formatRecordingSummary2).join(`
+`));
+}
+async function recordingGetCommand2(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: get");
+  }
+  const recording = await recordingGet2(id);
+  if (options.json) {
+    printJson2({ ok: true, recording });
+    return;
+  }
+  console.log(formatRecordingSummary2(recording));
+  console.log(`  r2Key: ${recording.r2Key}`);
+  for (const cue of recording.tracklist) {
+    const at = cue.startMs === undefined ? "—" : `${(cue.startMs / 1000).toFixed(1)}s`;
+    console.log(`  ${at}  ${cue.artists.join(", ")} — ${cue.title}`);
+  }
+}
+async function recordingCreateCommand2(options = {}) {
+  const title = options.title?.trim();
+  if (!title) {
+    throw new CliError2("missing_title", "A recording needs a --title");
+  }
+  if (!options.video) {
+    throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
+  }
+  if (!existsSync6(options.video)) {
+    throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
+  }
+  const created = await adminApiPost("/api/admin/recordings", {
+    recordedAt: options.recordedAt,
+    title
+  });
+  const recording = created.recording;
+  const log = (message) => {
+    if (!options.json) {
+      console.log(message);
+    }
+  };
+  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 });
+    return;
+  }
+  console.log(`Recording ${recording.id} staged → ${upload.url}`);
+}
+async function recordingUpdateCommand2(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: update");
+  }
+  const body = {};
+  if (options.title !== undefined) {
+    body.title = options.title;
+  }
+  if (options.recordedAt !== undefined) {
+    body.recordedAt = options.recordedAt;
+  }
+  if (options.tracklistFile !== undefined) {
+    if (!existsSync6(options.tracklistFile)) {
+      throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
+    }
+    try {
+      body.tracklistJson = JSON.parse(readFileSync5(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, or --tracklist-file");
+  }
+  const response = await adminApiPatch(`/api/admin/recordings/${encodeURIComponent(id)}`, body);
+  if (options.json) {
+    printJson2({ ok: true, recording: response.recording });
+    return;
+  }
+  console.log(`Updated ${formatRecordingSummary2(response.recording)}`);
+}
+async function recordingDeleteCommand2(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: delete");
+  }
+  await adminApiDelete(`/api/admin/recordings/${encodeURIComponent(id)}`);
+  if (options.json) {
+    printJson2({ ok: true });
+    return;
+  }
+  console.log(`Deleted recording ${id} (and its clips).`);
+}
+async function recordingPromoteCommand2(id, options = {}) {
+  if (!id) {
+    throw new CliError2("missing_id", "Missing recording id for: promote");
+  }
+  const response = await adminApiPost(`/api/admin/recordings/${encodeURIComponent(id)}/promote`);
+  const recording = response.recording;
+  if (options.json) {
+    printJson2({ ok: true, recording });
+    return;
+  }
+  console.log(recording.logId ? `Promoted recording ${id} → mixtape fluncle://${recording.logId}` : `Promoted recording ${id}`);
+}
+var init_recordings2 = __esm(() => {
+  init_api();
+  init_output();
+  init_mixtape_set_video();
+});
+
 // src/commands/newsletter.ts
 var exports_newsletter = {};
 __export(exports_newsletter, {
@@ -4403,7 +4699,7 @@ __export(exports_newsletter, {
   newsletterDraftCommand: () => newsletterDraftCommand,
   newsletterDeleteCommand: () => newsletterDeleteCommand
 });
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
 function buildBody3(options, { requireContent }) {
   const body = {};
   if (options.contentFile !== undefined) {
@@ -4423,10 +4719,10 @@ function buildBody3(options, { requireContent }) {
   return body;
 }
 function readContentFile(filePath) {
-  if (!existsSync5(filePath)) {
+  if (!existsSync7(filePath)) {
     throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
   }
-  const text = readFileSync4(filePath, "utf-8");
+  const text = readFileSync6(filePath, "utf-8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -4612,9 +4908,6 @@ var exports_mixtape_mixcloud2 = {};
 __export(exports_mixtape_mixcloud2, {
   resyncMixcloud: () => resyncMixcloud2,
   mixtapeDescription: () => mixtapeDescription2,
-  mixcloudSections: () => mixcloudSections2,
-  mixcloudSectionFields: () => mixcloudSectionFields2,
-  mixcloudEditUrl: () => mixcloudEditUrl2,
   distributeMixcloud: () => distributeMixcloud2,
   authMixcloudCommand: () => authMixcloudCommand2
 });
@@ -4641,8 +4934,8 @@ async function distributeMixcloud2(mixtapeId, audioPath, onProgress, unlisted =
   for (const [index, tag] of mixtapeTags2(mixtape).entries()) {
     form.append(`tags-${index}-tag`, tag);
   }
-  const sections = mixcloudSections2(mixtape.members);
-  for (const [name, value] of mixcloudSectionFields2(sections)) {
+  const sections = mixcloudSections(mixtape.members);
+  for (const [name, value] of mixcloudSectionFields(sections)) {
     form.append(name, value);
   }
   if (unlisted) {
@@ -4675,34 +4968,9 @@ async function distributeMixcloud2(mixtapeId, audioPath, onProgress, unlisted =
   });
   return { url };
 }
-async function resyncMixcloud2(mixtapeId, onProgress) {
-  const token = await fetchMixcloudToken2();
-  const mixtape = await mixtapeGetCommand(mixtapeId);
-  const sections = mixcloudSections2(mixtape.members);
-  if (sections.length === 0) {
-    throw new CliError2("mixcloud_no_cues", "No cued members to sync — mark cues on the mixtape first.");
-  }
-  const social = await adminApiGet(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/social`);
-  const mixcloud = social.posts.find((post) => post.platform === "mixcloud");
-  const key = mixcloud?.externalId;
-  if (!key) {
-    throw new CliError2("mixcloud_not_distributed", "No Mixcloud cloudcast to re-sync — distribute the mixtape first.");
-  }
-  const form = new FormData;
-  for (const [name, value] of mixcloudSectionFields2(sections)) {
-    form.append(name, value);
-  }
-  onProgress?.(`Mixcloud: re-syncing ${sections.length} sections (no re-upload)…`);
-  const response = await fetch(`${mixcloudEditUrl2(key)}?access_token=${encodeURIComponent(token)}`, { body: form, method: "POST" });
-  const text = await response.text();
-  if (!response.ok) {
-    throwMixcloudError2(response.status, text);
-  }
-  const result = parseUploadResult2(text);
-  if (!result.success) {
-    throw new CliError2("mixcloud_edit_rejected", `Mixcloud rejected the section edit: ${result.message ?? text.slice(0, 300)}`);
-  }
-  return { url: mixcloud?.url ?? `https://www.mixcloud.com${key}` };
+async function resyncMixcloud2(mixtapeId) {
+  const response = await adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(mixtapeId)}/mixcloud/resync`);
+  return { url: response.url };
 }
 async function authMixcloudCommand2() {
   const response = await adminApiGet("/api/admin/mixcloud/auth/start");
@@ -4727,25 +4995,6 @@ ${breadcrumb}` : breadcrumb;
 
 ${breadcrumb}` : breadcrumb;
 }
-function mixcloudSections2(members) {
-  return members.filter((member) => typeof member.startMs === "number").sort((a, b) => a.startMs - b.startMs).map((member) => ({
-    artist: member.artists.join(", "),
-    song: member.title,
-    start_time: Math.floor(member.startMs / 1000)
-  }));
-}
-function mixcloudSectionFields2(sections) {
-  return sections.flatMap((section, index) => [
-    [`sections-${index}-artist`, section.artist],
-    [`sections-${index}-song`, section.song],
-    [`sections-${index}-start_time`, String(section.start_time)]
-  ]);
-}
-function mixcloudEditUrl2(key) {
-  const withLeading = key.startsWith("/") ? key : `/${key}`;
-  const path2 = withLeading.endsWith("/") ? withLeading : `${withLeading}/`;
-  return `${MIXCLOUD_API2}/upload${path2}edit/`;
-}
 function mixtapeTags2(_mixtape) {
   return ["Drum & Bass", "Fluncle"];
 }
@@ -4790,6 +5039,7 @@ function throwMixcloudError2(status, body) {
 }
 var MIXCLOUD_API2 = "https://api.mixcloud.com", DESCRIPTION_MAX2 = 1000, PICTURE_MAX_BYTES2, COVER_BASE2 = "https://www.fluncle.com/api/mixtape-cover";
 var init_mixtape_mixcloud2 = __esm(() => {
+  init_util();
   init_api();
   init_output();
   init_mixtape_api();
@@ -5107,7 +5357,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7475,7 +7725,7 @@ function addAdminCommands(program2) {
   adminClips.action(() => {
     adminClips.outputHelp();
   });
-  adminClips.command("list").description("List clips (filter by --status pending|done and/or --mixtape <id>)").option("--status <status>", "Filter by cut status (pending|done)").option("--mixtape <id>", "Filter by mixtape id").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminClips.command("list").description("List clips (filter by --status pending|done, --recording <id>, and/or --mixtape <id>)").option("--status <status>", "Filter by cut status (pending|done)").option("--recording <id>", "Filter by recording id").option("--mixtape <id>", "Filter by mixtape id").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { clipsListCommand: clipsListCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
     await runClipsList(options, clipsListCommand2);
   });
@@ -7483,6 +7733,34 @@ function addAdminCommands(program2) {
     const { clipCutCommand: clipCutCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
     await runClipsCut(clipId, options, clipCutCommand2);
   });
+  const adminRecordings = configureCommand(admin.command("recordings").description("Recording (unpublished set) commands"));
+  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) => {
+    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) => {
+    const { recordingsListCommand: recordingsListCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
+    await recordingsListCommand3(options);
+  });
+  adminRecordings.command("get").description("Show one recording by id").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    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) => {
+    const { recordingUpdateCommand: recordingUpdateCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
+    await recordingUpdateCommand3(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);
+  });
+  adminRecordings.command("promote").description("Promote a recording to a published mixtape (mint-or-reuse; idempotent)").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { recordingPromoteCommand: recordingPromoteCommand3 } = await Promise.resolve().then(() => (init_recordings2(), exports_recordings2));
+    await recordingPromoteCommand3(id, options);
+  });
   const adminNewsletter = configureCommand(admin.command("newsletter").description("Newsletter edition commands"));
   adminNewsletter.action(() => {
     adminNewsletter.outputHelp();
@@ -7586,7 +7864,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync7(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]");
   }
@@ -7642,7 +7920,7 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
   }
 }
 async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
-  const note = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  const note = options.scriptFile ? readFileSync7(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]");
   }
@@ -7788,7 +8066,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync6(candidate) ? candidate : undefined;
+    return existsSync8(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {
@@ -8076,7 +8354,11 @@ async function runMixtapeList(options, mixtapeListCommand2) {
   }
 }
 async function runClipsList(options, clipsListCommand2) {
-  const clips = await clipsListCommand2({ mixtapeId: options.mixtape, status: options.status });
+  const clips = await clipsListCommand2({
+    mixtapeId: options.mixtape,
+    recordingId: options.recording,
+    status: options.status
+  });
   if (options.json) {
     printJson({ clips, ok: true });
     return;
@@ -8086,7 +8368,8 @@ async function runClipsList(options, clipsListCommand2) {
     return;
   }
   for (const clip of clips) {
-    console.log(`${clip.id}	${clip.status}	${clip.mixtapeId}	${clip.inMs}-${clip.outMs}ms	x=${clip.xOffset}`);
+    const source = clip.recordingId ?? clip.mixtapeId ?? "\u2014";
+    console.log(`${clip.id}	${clip.status}	${source}	${clip.inMs}-${clip.outMs}ms	x=${clip.xOffset}`);
   }
 }
 async function runClipsCut(clipId, options, clipCutCommand2) {

package/package.json

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