fluncle 0.89.0 → 0.91.0

package/bin/fluncle.mjs

@@ -497,14 +497,32 @@ var init_util = __esm(() => {
 });
 
 // src/output.ts
+import { writeSync as writeSync2 } from "node:fs";
+function writeStdoutSync2(text) {
+  const buf = Buffer.from(text, "utf8");
+  let offset = 0;
+  while (offset < buf.length) {
+    try {
+      offset += writeSync2(1, buf, offset);
+    } catch (error) {
+      if (error.code === "EAGAIN") {
+        Atomics.wait(EAGAIN_WAIT2, 0, 0, 1);
+        continue;
+      }
+      throw error;
+    }
+  }
+}
 function isJsonFailure(value) {
   return typeof value === "object" && value !== null && typeof value.code === "string" && typeof value.message === "string";
 }
 function printJson2(value) {
-  console.log(JSON.stringify(value, null, 2));
+  writeStdoutSync2(JSON.stringify(value, null, 2) + `
+`);
 }
-var CliError2;
+var EAGAIN_WAIT2, CliError2;
 var init_output = __esm(() => {
+  EAGAIN_WAIT2 = new Int32Array(new SharedArrayBuffer(4));
   CliError2 = class CliError2 extends Error {
     code;
     constructor(code, message) {
@@ -538,7 +556,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.91.0".trim() ? "0.91.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2168,7 +2186,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.91.0".trim() ? "0.91.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2895,17 +2913,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 +2953,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 +2963,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 +2984,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 +3097,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 +3109,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 +3136,8 @@ var init_track = __esm(() => {
     "footageLandscape",
     "footageLandscapeSocial"
   ];
+  PLATE_FIELDS = ["plate", "plateBackground"];
+  NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
 // src/commands/add.ts
@@ -7081,6 +7124,23 @@ var spotifyPlaylistUrl = "https://open.spotify.com/playlist/1m5LADqpLjiBERdtqrIi
 var telegramUrl = "https://t.me/fluncle";
 
 // src/output.ts
+import { writeSync } from "node:fs";
+var EAGAIN_WAIT = new Int32Array(new SharedArrayBuffer(4));
+function writeStdoutSync(text) {
+  const buf = Buffer.from(text, "utf8");
+  let offset = 0;
+  while (offset < buf.length) {
+    try {
+      offset += writeSync(1, buf, offset);
+    } catch (error) {
+      if (error.code === "EAGAIN") {
+        Atomics.wait(EAGAIN_WAIT, 0, 0, 1);
+        continue;
+      }
+      throw error;
+    }
+  }
+}
 class CliError extends Error {
   code;
   constructor(code, message) {
@@ -7090,7 +7150,8 @@ class CliError extends Error {
   }
 }
 function printJson(value) {
-  console.log(JSON.stringify(value, null, 2));
+  writeStdoutSync(JSON.stringify(value, null, 2) + `
+`);
 }
 function toJsonFailure(error) {
   if (error instanceof CliError) {
@@ -7250,7 +7311,7 @@ function addAdminCommands(program2) {
     const { queueCommand: queueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminQueue(options, queueCommand2);
   });
-  adminTracks.command("list").description("List findings, filterable by musical-key presence (--no-key / --has-key)").option("--limit <limit>", "Number of findings to show", "50").option("--no-key", "Only findings with NO stored musical key (the key-backfill backlog)").option("--has-key <bool>", "Filter by key presence: true (has key) or false (missing)").option("--order <order>", "Sort: asc (oldest first) or desc (newest first)", "desc").option("--json", "Print JSON", false).action(async (options) => {
+  adminTracks.command("list").description("List findings, filterable by musical-key presence (--no-key / --has-key)").option("--limit <limit>", "Number of findings to show (1-100)", "50").option("--all", "Fetch the ENTIRE catalogue, paginating past the 100-row cap (overrides --limit)", false).option("--no-key", "Only findings with NO stored musical key (the key-backfill backlog)").option("--has-key <bool>", "Filter by key presence: true (has key) or false (missing)").option("--order <order>", "Sort: asc (oldest first) or desc (newest first)", "desc").option("--json", "Print JSON", false).action(async (options) => {
     const { listCommand: listCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminTracksList(options, listCommand2);
   });
@@ -7272,7 +7333,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 +7758,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 +7786,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, {
@@ -8164,7 +8228,7 @@ function resolveHasKey(options) {
   return;
 }
 async function runAdminTracksList(options, listCommand2) {
-  const limit = parseListLimit(options.limit);
+  const limit = options.all ? Number.POSITIVE_INFINITY : parseListLimit(options.limit);
   const order = options.order === "asc" ? "asc" : "desc";
   const hasKey = resolveHasKey(options);
   const tracks = await listCommand2({ hasKey, limit, order });
@@ -8531,6 +8595,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.91.0"
 }