fluncle 0.88.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.88.0".trim() ? "0.88.0".trim() : "0.1.0";
+  currentVersion = "0.89.0".trim() ? "0.89.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.89.0".trim() ? "0.89.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2894,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 = {};
@@ -3033,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();
@@ -3050,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"
   ];
 });
 
@@ -7229,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);
   });
@@ -7654,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) => {
@@ -7685,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;
@@ -8491,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.88.0"
+  "version": "0.89.0"
 }