fluncle 0.88.0 → 0.90.0

package/bin/fluncle.mjs

@@ -538,7 +538,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.88.0".trim() ? "0.88.0".trim() : "0.1.0";
+  currentVersion = "0.90.0".trim() ? "0.90.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2168,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.88.0".trim() ? "0.88.0".trim() : "0.1.0";
+  currentVersion2 = "0.90.0".trim() ? "0.90.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2894,16 +2894,58 @@ __export(exports_track, {
   trackNoteCommand: () => trackNoteCommand,
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand,
-  trackContextCommand: () => trackContextCommand
+  trackContextCommand: () => trackContextCommand,
+  isPlatesOnlyUpload: () => isPlatesOnlyUpload,
+  checkBundleCompleteness: () => checkBundleCompleteness
 });
 async function trackGetCommand(idOrLogId) {
   return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
 }
-async function trackVideoCommand(idOrLogId, files, onProgress) {
+function isPlatesOnlyUpload(files) {
+  const hasPlate = PLATE_FIELDS.some((option) => Boolean(files[option]));
+  if (!hasPlate) {
+    return false;
+  }
+  return Object.keys(files).every((option) => !files[option] || PLATE_FIELDS.includes(option) || NON_FILE_OPTIONS.includes(option));
+}
+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) : [];
+  const plateWarnings = [];
+  if (files.plateBackground && !files.plate) {
+    plateWarnings.push("plate.background.png without plate.png — the background is the parallax layer OF a plate; pass --plate (or drop it in the --dir) too");
+  }
+  return {
+    missingAdvisory: missingFrom(RERENDER_ADVISORY_FIELDS),
+    missingContract: missingFrom(RERENDER_CONTRACT_FIELDS),
+    plateWarnings,
+    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`);
+    }
+  }
+  for (const warning of completeness.plateWarnings) {
+    onProgress?.(`warning: ${warning}`);
+  }
   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 platesOnly = isPlatesOnlyUpload(files);
   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 = {};
@@ -2924,6 +2966,10 @@ async function trackVideoCommand(idOrLogId, files, onProgress) {
     }
     urls[spec.field] = `${FOUND_BASE}/${upload.key}`;
   }
+  if (platesOnly) {
+    onProgress?.(`plate pre-upload complete — compose against ${FOUND_BASE}/${presign.logId}/plate.png; finalize is deferred to the footage ship`);
+    return { logId: presign.logId, ok: true, trackId: presign.trackId, urls };
+  }
   const manifest = files.render ? await readManifestFields(files.render) : {};
   const videoModel = files.model?.trim().slice(0, 120) || manifest.model || DEFAULT_VIDEO_MODEL;
   const videoModelReasoning = files.reasoning?.trim().slice(0, 120) || manifest.reasoning || DEFAULT_VIDEO_REASONING;
@@ -3033,7 +3079,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, PLATE_FIELDS, NON_FILE_OPTIONS;
 var init_track = __esm(() => {
   init_api();
   init_output();
@@ -3045,13 +3091,35 @@ var init_track = __esm(() => {
     { field: "footage-landscape-social", option: "footageLandscapeSocial" },
     { field: "poster", option: "poster" },
     { field: "cover", option: "cover" },
+    { field: "plate", option: "plate" },
+    { field: "plate-background", option: "plateBackground" },
     { field: "note", option: "note" },
     { field: "composition", option: "composition" },
     { 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"
+  ];
+  PLATE_FIELDS = ["plate", "plateBackground"];
+  NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
 // src/commands/add.ts
@@ -7229,7 +7297,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("--plate <file>", "Plate-lane photographic plate (plate.png; uploadable pre-render)").option("--plate-background <file>", "The plate's subject-removed background (plate.background.png, optional)").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);
   });
@@ -7654,7 +7722,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>] | --plate <file> [--plate-background <file>]) [--allow-partial]");
   }
   const dir = options.dir ? path2.resolve(process.cwd(), options.dir) : undefined;
   const fromDir = (name) => {
@@ -7682,16 +7750,22 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
     metrics: resolveFile(options.metrics, "metrics.json"),
     model: options.model,
     note: resolveFile(options.note, "note.txt"),
+    plate: resolveFile(options.plate, "plate.png"),
+    plateBackground: resolveFile(options.plateBackground, "plate.background.png"),
     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)");
+  const { isPlatesOnlyUpload: isPlatesOnlyUpload2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+  if (!files.footage && !options.allowPartial && !isPlatesOnlyUpload2(files)) {
+    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), or upload plates alone (--plate/--plate-background) for the plate-lane pre-upload.");
   }
   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;
@@ -8485,12 +8559,15 @@ var stringOptions = new Set([
   "--metrics",
   "--mime",
   "--note",
+  "--plate",
+  "--plate-background",
   "--platform",
   "--poster",
   "--props",
   "--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.88.0"
+  "version": "0.90.0"
 }