fluncle 0.87.0 → 0.89.0

package/bin/fluncle.mjs

@@ -538,7 +538,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.87.0".trim() ? "0.87.0".trim() : "0.1.0";
+  currentVersion = "0.89.0".trim() ? "0.89.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1335,47 +1335,22 @@ __export(exports_mixtapes, {
   mixtapesCommand: () => mixtapesCommand,
   mixtapeUpdateCommand: () => mixtapeUpdateCommand,
   mixtapeResyncCommand: () => mixtapeResyncCommand,
-  mixtapePublishCommand: () => mixtapePublishCommand,
-  mixtapeMembersCommand: () => mixtapeMembersCommand,
   mixtapeListCommand: () => mixtapeListCommand,
   mixtapeGetCommand: () => mixtapeGetCommand,
-  mixtapeDistributeCommand: () => mixtapeDistributeCommand,
-  mixtapeDeleteCommand: () => mixtapeDeleteCommand,
-  mixtapeCreateCommand: () => mixtapeCreateCommand
+  mixtapeDistributeCommand: () => mixtapeDistributeCommand
 });
-import { existsSync, readFileSync as readFileSync2 } from "node:fs";
 async function mixtapesCommand() {
   const response = await publicApiGet("/api/mixtapes");
   return response.mixtapes;
 }
-async function mixtapeCreateCommand(options) {
-  return adminApiPost("/api/admin/mixtapes", buildBody(options));
-}
 async function mixtapeUpdateCommand(id, options) {
   return adminApiPatch(`/api/admin/mixtapes/${encodeURIComponent(id)}`, buildBody(options));
 }
-async function mixtapeMembersCommand(id, refs, options) {
-  const members = refs.map((ref) => ({ ref }));
-  if (options.from) {
-    members.push(...parseCueFile(options.from));
-  }
-  return adminApiPut(`/api/admin/mixtapes/${encodeURIComponent(id)}/members`, { members });
-}
-async function mixtapePublishCommand(id) {
-  return adminApiPost(`/api/admin/mixtapes/${encodeURIComponent(id)}/publish`);
-}
-async function mixtapeDeleteCommand(id) {
-  return adminApiDelete(`/api/admin/mixtapes/${encodeURIComponent(id)}`);
-}
 async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {}) {
   const mixtape = await mixtapeGetCommand(idOrLogId);
   if (!mixtape.id) {
     throw new CliError2("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
   }
-  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);
@@ -1388,7 +1363,8 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
   const mixtapeId = mixtape.id;
   const logId = mixtape.logId;
   if (!logId) {
-    throw new CliError2("missing_log_id", "The mixtape has no Log ID — was it promoted successfully?");
+    throw new CliError2("mixtape_not_promoted", `${mixtapeId} has no coordinate yet — promote its recording first:
+` + "  fluncle admin recordings promote <recordingId>");
   }
   if (!mixtape.durationMs) {
     const source = options.audio ?? options.video;
@@ -1495,65 +1471,6 @@ function buildBody(options) {
   }
   return body;
 }
-function parseCueFile(filePath) {
-  if (!existsSync(filePath)) {
-    throw new CliError2("file_not_found", `Cue file not found: ${filePath}`);
-  }
-  const text = readFileSync2(filePath, "utf-8");
-  const trimmed = text.trim();
-  if (trimmed.startsWith("[") || trimmed.startsWith("{")) {
-    try {
-      const parsed = JSON.parse(trimmed);
-      if (!Array.isArray(parsed)) {
-        throw new Error("not an array");
-      }
-      return parsed.map((entry, index) => {
-        if (typeof entry === "string") {
-          return { ref: entry.trim() };
-        }
-        const obj = entry;
-        if (typeof obj?.ref !== "string") {
-          throw new CliError2("invalid_cue_json", `Entry ${index + 1} missing "ref" string`);
-        }
-        const cue = { ref: obj.ref.trim() };
-        if (typeof obj.startMs === "number" && Number.isInteger(obj.startMs) && obj.startMs >= 0) {
-          cue.startMs = obj.startMs;
-        }
-        return cue;
-      });
-    } catch (error) {
-      if (error instanceof CliError2) {
-        throw error;
-      }
-      throw new CliError2("invalid_cue_json", `Cue JSON parse failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-  return parseCueSheet(text);
-}
-function parseCueSheet(text) {
-  const entries = [];
-  for (const line of text.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) {
-      continue;
-    }
-    const match = trimmed.match(/^(\d{1,2}:\d{2}(?::\d{2})?)\s+(.+)$/);
-    if (match) {
-      const [, time, ref] = match;
-      if (time === undefined || ref === undefined) {
-        continue;
-      }
-      const startMs = parseDuration(time);
-      if (startMs === null) {
-        continue;
-      }
-      entries.push({ ref: ref.trim(), startMs });
-    } else {
-      entries.push({ ref: trimmed });
-    }
-  }
-  return entries;
-}
 var init_mixtapes = __esm(() => {
   init_util();
   init_api();
@@ -2251,7 +2168,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.87.0".trim() ? "0.87.0".trim() : "0.1.0";
+  currentVersion2 = "0.89.0".trim() ? "0.89.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2773,7 +2690,7 @@ var init_src = __esm(() => {
     {
       command: "fluncle admin",
       exposedContent: [
-        "the operator/agent command group (hidden): tracks publish|update|enrich|video|draft|social|preview|observe|context|note, mixtapes create|update|members|publish|delete, newsletter draft|update|send|list, backfills, auth"
+        "the operator/agent command group (hidden): tracks publish|update|enrich|video|draft|social|preview|observe|context|note, recordings create|promote, mixtapes update|distribute|resync, newsletter draft|update|send|list, backfills, auth"
       ],
       kind: "cli",
       name: "cli.admin",
@@ -2977,16 +2894,41 @@ __export(exports_track, {
   trackNoteCommand: () => trackNoteCommand,
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand,
-  trackContextCommand: () => trackContextCommand
+  trackContextCommand: () => trackContextCommand,
+  checkBundleCompleteness: () => checkBundleCompleteness
 });
 async function trackGetCommand(idOrLogId) {
   return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
 }
-async function trackVideoCommand(idOrLogId, files, onProgress) {
+function checkBundleCompleteness(files) {
+  const uploadingFootage = FOOTAGE_FIELDS.some((option) => Boolean(files[option]));
+  const missingFrom = (specs) => uploadingFootage ? specs.filter((spec) => !files[spec.option]).map((spec) => spec.file) : [];
+  return {
+    missingAdvisory: missingFrom(RERENDER_ADVISORY_FIELDS),
+    missingContract: missingFrom(RERENDER_CONTRACT_FIELDS),
+    uploadingFootage
+  };
+}
+async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
+  const completeness = checkBundleCompleteness(files);
+  if (completeness.uploadingFootage && completeness.missingContract.length > 0 && !options.allowPartial) {
+    throw new CliError2("bundle_incomplete", `Refusing to upload a PARTIAL bundle: footage is being uploaded but the re-render contract is missing ${completeness.missingContract.join(", ")}. ` + `A footage-only upload leaves composition.tsx/props.json/render.json stale on R2 and desyncs the render.json from the DB ledger. ` + `Ship the complete bundle (re-run \`ship\` and upload with --dir), or pass --allow-partial for a deliberate partial refresh (e.g. poster-only).`);
+  }
+  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`);
+    }
+    for (const missing of completeness.missingAdvisory) {
+      onProgress?.(`warning: ${missing} missing (provenance/eval only) — shipping without it`);
+    }
+  }
   const present = VIDEO_FIELDS.map((spec) => ({
     field: spec.field,
     path: files[spec.option]
   })).filter((spec) => Boolean(spec.path));
+  if (present.length === 0) {
+    throw new CliError2("nothing_to_upload", "No bundle files resolved to upload (pass --dir <bundle> or explicit file flags).");
+  }
   const presign = await adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/video/uploads`, { fields: present.map((spec) => spec.field) });
   const byField = new Map(presign.uploads.map((upload) => [upload.field, upload]));
   const urls = {};
@@ -3116,7 +3058,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_BASE = "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, RERENDER_CONTRACT_FIELDS, RERENDER_ADVISORY_FIELDS, FOOTAGE_FIELDS;
 var init_track = __esm(() => {
   init_api();
   init_output();
@@ -3133,7 +3075,25 @@ var init_track = __esm(() => {
     { field: "props", option: "props" },
     { field: "render", option: "render" },
     { field: "intent", option: "intent" },
-    { field: "metrics", option: "metrics" }
+    { field: "metrics", option: "metrics" },
+    { field: "scene", option: "scene" }
+  ];
+  RERENDER_CONTRACT_FIELDS = [
+    { file: "composition.tsx", option: "composition" },
+    { file: "props.json", option: "props" },
+    { file: "render.json", option: "render" }
+  ];
+  RERENDER_ADVISORY_FIELDS = [
+    { file: "intent.json", option: "intent" },
+    { file: "metrics.json", option: "metrics" },
+    { file: "scene.json", option: "scene" }
+  ];
+  FOOTAGE_FIELDS = [
+    "footage",
+    "footageSocial",
+    "footageNotext",
+    "footageLandscape",
+    "footageLandscapeSocial"
   ];
 });
 
@@ -3668,7 +3628,7 @@ var init_mixtape_youtube2 = __esm(() => {
 
 // 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 { existsSync, 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) {
@@ -3725,7 +3685,7 @@ 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();
@@ -3838,7 +3798,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;
@@ -3907,7 +3867,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", {
@@ -3943,11 +3903,11 @@ 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}`);
     }
@@ -3992,12 +3952,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}`);
   }
@@ -4201,7 +4161,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;
@@ -4270,7 +4230,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", {
@@ -4306,11 +4266,11 @@ 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}`);
     }
@@ -4355,12 +4315,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}`);
   }
@@ -4386,7 +4346,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) {
@@ -4406,10 +4366,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) {
@@ -5044,7 +5004,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
@@ -7312,7 +7272,7 @@ function addAdminCommands(program2) {
     const { trackUpdateCommand: trackUpdateCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackUpdate(trackId, options, trackUpdateCommand2);
   });
-  adminTrack.command("video").description("Upload a track's video bundle to R2 and link it").argument("[idOrLogId]").option("--composition <file>", "Composition source file").option("--cover <file>", "Cover image").option("--dir <dir>", "Bundle directory").option("--footage <file>", "Video footage (square crop source)").option("--footage-landscape <file>", "Clean landscape cut (optional escape hatch)").option("--footage-landscape-social <file>", "Landscape cut with baked text (optional)").option("--footage-notext <file>", "Portrait cut without the type layer (optional)").option("--footage-social <file>", "Portrait social cut (baked text)").option("--intent <file>", "Render-intent JSON (optional)").option("--json", "Print JSON", false).option("--metrics <file>", "Gate metrics JSON (optional)").option("--model <model>", "Authoring AI model (<provider>/<model>)").option("--note <file>", "Note file").option("--poster <file>", "Poster image").option("--props <file>", "Render props JSON").option("--reasoning <level>", "Authoring model reasoning effort (e.g. high)").option("--render <file>", "Render metadata JSON").allowExcessArguments().action(async (idOrLogId, options) => {
+  adminTrack.command("video").description("Upload a track's video bundle to R2 and link it").argument("[idOrLogId]").option("--allow-partial", "Allow an intentionally partial upload (skip the re-render-contract check; e.g. poster-only)", false).option("--composition <file>", "Composition source file").option("--cover <file>", "Cover image").option("--dir <dir>", "Bundle directory").option("--footage <file>", "Video footage (square crop source)").option("--footage-landscape <file>", "Clean landscape cut (optional escape hatch)").option("--footage-landscape-social <file>", "Landscape cut with baked text (optional)").option("--footage-notext <file>", "Portrait cut without the type layer (optional)").option("--footage-social <file>", "Portrait social cut (baked text)").option("--intent <file>", "Render-intent JSON (optional)").option("--json", "Print JSON", false).option("--metrics <file>", "Gate metrics JSON (optional)").option("--model <model>", "Authoring AI model (<provider>/<model>)").option("--note <file>", "Note file").option("--poster <file>", "Poster image").option("--props <file>", "Render props JSON").option("--reasoning <level>", "Authoring model reasoning effort (e.g. high)").option("--render <file>", "Render metadata JSON").option("--scene <file>", "Scene replay manifest JSON (fluncle.scene/1, optional)").allowExcessArguments().action(async (idOrLogId, options) => {
     const { trackVideoCommand: trackVideoCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackVideo(idOrLogId, options, trackVideoCommand2);
   });
@@ -7372,27 +7332,11 @@ function addAdminCommands(program2) {
   adminMixtapes.action(() => {
     adminMixtapes.outputHelp();
   });
-  adminMixtapes.command("create").description("Log a new mixtape draft").option("--duration-ms <duration>", "Duration (mm:ss, h:mm:ss, or ms)").option("--json", "Print JSON", false).option("--note <text>", "Operator note").option("--recorded-at <date>", "Recorded date (ISO)").option("--soundcloud-url <url>", "SoundCloud URL (manual; YouTube + Mixcloud come from distribute)").allowExcessArguments().action(async (options) => {
-    const { mixtapeCreateCommand: mixtapeCreateCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
-    await runMixtapeCreate(options, mixtapeCreateCommand2);
-  });
   adminMixtapes.command("update").description("Update a mixtape's fields").argument("[id]").option("--duration-ms <duration>", "Duration (mm:ss, h:mm:ss, or ms)").option("--json", "Print JSON", false).option("--note <text>", "Operator note").option("--recorded-at <date>", "Recorded date (ISO)").option("--soundcloud-url <url>", "SoundCloud URL (manual; YouTube + Mixcloud come from distribute)").allowExcessArguments().action(async (id, options) => {
     const { mixtapeUpdateCommand: mixtapeUpdateCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeUpdate(id, options, mixtapeUpdateCommand2);
   });
-  adminMixtapes.command("members").description("Set a mixtape's tracklist (refs and/or a cue-sheet file)").argument("[id]").argument("[refs...]").option("--from <file>", "Cue-sheet or JSON file with members").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, refs, options) => {
-    const { mixtapeMembersCommand: mixtapeMembersCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
-    await runMixtapeMembers(id, refs, options, mixtapeMembersCommand2);
-  });
-  adminMixtapes.command("publish").description("Publish a mixtape draft").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
-    const { mixtapePublishCommand: mixtapePublishCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
-    await runMixtapePublish(id, options, mixtapePublishCommand2);
-  });
-  adminMixtapes.command("delete").description("Discard a mixtape draft (published mixtapes can't be deleted)").argument("[id]").option("--json", "Print JSON", false).option("--yes", "Skip confirmation", false).allowExcessArguments().action(async (id, options) => {
-    const { mixtapeDeleteCommand: mixtapeDeleteCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
-    await runMixtapeDelete(id, options, mixtapeDeleteCommand2);
-  });
-  adminMixtapes.command("list").description("List all mixtapes (including drafts)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+  adminMixtapes.command("list").description("List all mixtapes (including distributing)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
     const { mixtapeListCommand: mixtapeListCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapeList(options, mixtapeListCommand2);
   });
@@ -7559,7 +7503,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]");
   }
@@ -7615,7 +7559,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]");
   }
@@ -7753,7 +7697,7 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
 }
 async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
   if (!idOrLogId) {
-    throw new Error("Missing id. Usage: fluncle admin tracks video <track_id|log_id> (--dir <dir> | --footage <file> [--footage-social <file>] [--footage-notext <file>] [--footage-landscape <file>] [--footage-landscape-social <file>] [--poster <file>] [--cover <file>] [--note <file>] [--composition <file>] [--props <file>] [--render <file>] [--intent <file>] [--metrics <file>])");
+    throw new Error("Missing id. Usage: fluncle admin tracks video <track_id|log_id> (--dir <dir> | --footage <file> [--footage-social <file>] [--footage-notext <file>] [--footage-landscape <file>] [--footage-landscape-social <file>] [--poster <file>] [--cover <file>] [--note <file>] [--composition <file>] [--props <file>] [--render <file>] [--intent <file>] [--metrics <file>] [--scene <file>]) [--allow-partial]");
   }
   const dir = options.dir ? path2.resolve(process.cwd(), options.dir) : undefined;
   const fromDir = (name) => {
@@ -7761,7 +7705,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) {
@@ -7784,13 +7728,16 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
     poster: resolveFile(options.poster, "poster.jpg"),
     props: resolveFile(options.props, "props.json"),
     reasoning: options.reasoning,
-    render: resolveFile(options.render, "render.json")
+    render: resolveFile(options.render, "render.json"),
+    scene: resolveFile(options.scene, "scene.json")
   };
-  if (!files.footage) {
-    throw new Error("A footage cut is required (--footage <file>, or --dir containing footage.mp4)");
+  if (!files.footage && !options.allowPartial) {
+    throw new Error("A footage cut is required (--footage <file>, or --dir containing footage.mp4). Pass --allow-partial for a deliberate partial refresh (e.g. poster-only).");
   }
   const onProgress = options.json ? undefined : (message) => console.log(message);
-  const result = await trackVideoCommand2(idOrLogId, files, onProgress);
+  const result = await trackVideoCommand2(idOrLogId, files, onProgress, {
+    allowPartial: options.allowPartial
+  });
   if (options.json) {
     printJson(result);
     return;
@@ -7938,14 +7885,6 @@ async function runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand2) {
   }
   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.`);
 }
-async function runMixtapeCreate(options, mixtapeCreateCommand2) {
-  const result = await mixtapeCreateCommand2(options);
-  if (options.json) {
-    printJson(result);
-    return;
-  }
-  console.log(`Logged draft ${result.mixtape.id}. It stays a draft until you publish it.`);
-}
 async function runMixtapeUpdate(id, options, mixtapeUpdateCommand2) {
   if (!id) {
     throw new Error("Missing mixtape id. Usage: fluncle admin mixtapes update <id>");
@@ -7957,31 +7896,6 @@ async function runMixtapeUpdate(id, options, mixtapeUpdateCommand2) {
   }
   console.log(`Saved ${result.mixtape.id}.`);
 }
-async function runMixtapeMembers(id, refs, options, mixtapeMembersCommand2) {
-  if (!id) {
-    throw new Error("Missing mixtape id. Usage: fluncle admin mixtapes members <id> [refs...]");
-  }
-  if (refs.length === 0 && !options.from) {
-    throw new Error("Provide refs as arguments or a cue-sheet file with --from");
-  }
-  const result = await mixtapeMembersCommand2(id, refs, options);
-  if (options.json) {
-    printJson(result);
-    return;
-  }
-  console.log(`Saved the tracklist: ${result.mixtape.memberCount} bangers on ${result.mixtape.id}.`);
-}
-async function runMixtapePublish(id, options, mixtapePublishCommand2) {
-  if (!id) {
-    throw new Error("Missing mixtape id. Usage: fluncle admin mixtapes publish <id>");
-  }
-  const result = await mixtapePublishCommand2(id);
-  if (options.json) {
-    printJson(result);
-    return;
-  }
-  console.log(`Minted ${result.mixtape.logId} (fluncle://${result.mixtape.logId}) \u2014 distributing. ` + "Run `distribute` to push it to the platforms.");
-}
 async function runMixtapeDistribute(idOrLogId, options, mixtapeDistributeCommand2) {
   if (!idOrLogId) {
     throw new Error("Missing mixtape id. Usage: fluncle admin mixtapes distribute <idOrLogId> --video <mp4> --audio <file>");
@@ -8023,20 +7937,6 @@ async function runMixtapeResync(idOrLogId, options, mixtapeResyncCommand2) {
   console.log(`Re-synced ${result.logId} (fluncle://${result.logId}).
 ${links}`);
 }
-async function runMixtapeDelete(id, options, mixtapeDeleteCommand2) {
-  if (!id) {
-    throw new Error("Missing mixtape id. Usage: fluncle admin mixtapes delete <id> --yes");
-  }
-  if (!options.yes) {
-    throw new Error("Pass --yes to confirm the discard. Published mixtapes can't be deleted.");
-  }
-  await mixtapeDeleteCommand2(id);
-  if (options.json) {
-    printJson({ id, ok: true });
-    return;
-  }
-  console.log(`Discarded draft ${id}.`);
-}
 async function runMixtapeList(options, mixtapeListCommand2) {
   const mixtapes = await mixtapeListCommand2();
   if (options.json) {
@@ -8048,8 +7948,8 @@ async function runMixtapeList(options, mixtapeListCommand2) {
     return;
   }
   for (const mixtape of mixtapes) {
-    const status = mixtape.status ?? "draft";
-    const coordinate3 = mixtape.logId ?? "draft";
+    const status = mixtape.status ?? "distributing";
+    const coordinate3 = mixtape.logId ?? "unminted";
     console.log(`${coordinate3}	${status}	${mixtape.memberCount} bangers	${mixtape.title}`);
   }
 }
@@ -8092,8 +7992,8 @@ async function runMixtapeGet(idOrLogId, options, mixtapeGetCommand2) {
     printJson(mixtape);
     return;
   }
-  const coordinate3 = mixtape.logId ?? "draft";
-  const status = mixtape.status ?? "draft";
+  const coordinate3 = mixtape.logId ?? "unminted";
+  const status = mixtape.status ?? "distributing";
   console.log(`${mixtape.title}`);
   console.log(`  ${coordinate3} \xB7 ${status} \xB7 ${mixtape.memberCount} bangers`);
   if (mixtape.note) {
@@ -8637,6 +8537,7 @@ var stringOptions = new Set([
   "--query",
   "--recorded-at",
   "--render",
+  "--scene",
   "--scheduled-for",
   "--soundcloud-url",
   "--source",

package/package.json

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