reelforge 0.10.1 → 0.11.0

package/dist/commands/create.js

@@ -155,6 +155,8 @@ function optsToBody(opts) {
         out.topic = opts.topic;
     if (opts.script !== undefined)
         out.script = opts.script;
+    if (opts.title !== undefined)
+        out.title = opts.title;
     if (opts.duration !== undefined)
         out.duration = opts.duration;
     if (opts.pace !== undefined)
@@ -344,6 +346,7 @@ export function registerCreate(program) {
         // --- Content (exactly one of --topic / --script) ---
         .option("-t, --topic <text>", "video topic; AI writes the script (mode=generate). Prefix with @file to read from disk.")
         .option("--script <text>", "your own master script text; AI just plans scenes + visuals (mode=fixed). Prefix with @file to read from disk.")
+        .option("--title <text>", "hard-override video title; LLM will NOT auto-summarize. Useful for compliance-sensitive content (e.g. financial). Prefix with @file to read from disk. Pass --title '' (empty string) to explicitly suppress title rendering. Omit to keep LLM auto-title.")
         .option("-d, --duration <sec>", "target video duration in seconds (generate mode only; default 45). LLM aims for ~duration × 5 chars of narration.", (v) => parseInt(v, 10))
         .option("-p, --pace <pace>", "visual rhythm hint passed to the LLM: slow | normal | fast (default normal). LLM still decides the actual scene count from semantic structure.")
         // --- Visual ---
@@ -569,6 +572,11 @@ export function registerCreate(program) {
         if (typeof body.script === "string") {
             body.script = await resolveTextOrFile(body.script);
         }
+        // Title: resolve @file when present. Empty string is a legit value (=
+        // suppress rendering) and must pass through verbatim, never as @file.
+        if (typeof body.title === "string" && body.title.startsWith("@")) {
+            body.title = await resolveTextOrFile(body.title);
+        }
         // Resolve character ref: local file path → data: URI (RelayX accepts
         // both https:// and data: in image_urls). Done after layering so a
         // recipe can carry the ref by path too.

package/dist/commands/pipelines.js

@@ -45,6 +45,7 @@ export function registerPipelines(program) {
         .helpOption("-h, --help", "show help")
         .option("-t, --topic <text>", "video topic (mode=generate). Use @file to read from disk.")
         .option("--script <text>", "your own master script text (mode=fixed). Use @file to read from disk.")
+        .option("--title <text>", "hard-override video title; LLM will NOT auto-summarize. Useful for compliance-sensitive content. Use @file to read from disk. Pass --title '' (empty) to explicitly suppress title rendering. Omit to keep LLM auto-title.")
         .option("-d, --duration <sec>", "target video duration in seconds (generate mode; default 45)", (v) => parseInt(v, 10))
         .option("-p, --pace <pace>", "visual rhythm hint: slow | normal | fast (default normal)")
         .option("--motion <preset>", "per-scene image animation: off | lite (default) | max")
@@ -108,10 +109,15 @@ export function registerPipelines(program) {
         }
         let topic = opts.topic;
         let script = opts.script;
+        let title = opts.title;
         if (topic?.startsWith("@"))
             topic = await fs.readFile(topic.slice(1), "utf-8");
         if (script?.startsWith("@"))
             script = await fs.readFile(script.slice(1), "utf-8");
+        // Title: resolve @file only when prefix present. Empty "" is a legit value
+        // (= suppress title) and must pass through verbatim.
+        if (title?.startsWith("@"))
+            title = await fs.readFile(title.slice(1), "utf-8");
         // --frame-template can be a preset key OR a local .html — same heuristic
         // as 0.7.x. Local path is read and sent as frame_template_html inline.
         let frame_template;
@@ -134,6 +140,7 @@ export function registerPipelines(program) {
         await submitAndMaybeWait("/api/v1/pipelines/standard", {
             topic,
             script,
+            title,
             duration: opts.duration,
             pace: opts.pace,
             motion: opts.motion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelforge",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "CLI for ReelForge Studio — AI video engine. Installs as both `reelforge` and the short alias `rf`. Every REST API exposed as a command, with --help on every level.",
   "license": "Apache-2.0",
   "type": "module",