fluncle 0.89.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.89.0".trim() ? "0.89.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.89.0".trim() ? "0.89.0".trim() : "0.1.0";
+  currentVersion2 = "0.90.0".trim() ? "0.90.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2895,17 +2895,30 @@ __export(exports_track, {
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand,
   trackContextCommand: () => trackContextCommand,
+  isPlatesOnlyUpload: () => isPlatesOnlyUpload,
   checkBundleCompleteness: () => checkBundleCompleteness
 });
 async function trackGetCommand(idOrLogId) {
   return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
 }
+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
   };
 }
@@ -2922,6 +2935,9 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
       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]
@@ -2929,6 +2945,7 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
   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 = {};
@@ -2949,6 +2966,10 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
     }
     urls[spec.field] = `${FOUND_BASE}/${upload.key}`;
   }
+  if (platesOnly) {
+    onProgress?.(`plate pre-upload complete — compose against ${FOUND_BASE}/${presign.logId}/plate.png; finalize is deferred to the footage ship`);
+    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;
@@ -3058,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, RERENDER_CONTRACT_FIELDS, RERENDER_ADVISORY_FIELDS, FOOTAGE_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();
@@ -3070,6 +3091,8 @@ 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" },
@@ -3095,6 +3118,8 @@ var init_track = __esm(() => {
     "footageLandscape",
     "footageLandscapeSocial"
   ];
+  PLATE_FIELDS = ["plate", "plateBackground"];
+  NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
 // src/commands/add.ts
@@ -7272,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("--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) => {
+  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);
   });
@@ -7697,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>] [--scene <file>]) [--allow-partial]");
+    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) => {
@@ -7725,14 +7750,17 @@ 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"),
     scene: resolveFile(options.scene, "scene.json")
   };
-  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 { 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, {
@@ -8531,6 +8559,8 @@ var stringOptions = new Set([
   "--metrics",
   "--mime",
   "--note",
+  "--plate",
+  "--plate-background",
   "--platform",
   "--poster",
   "--props",

package/package.json

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