reelforge 0.10.1 → 0.11.1

package/README.md

@@ -218,7 +218,7 @@ rf llm presets --json | jq '.[].defaultModel'
 # 9. Configure & test LLM (self-hosted)
 rf config set llm.api_key rx-xxxxx          # RelayX key (or your own provider key)
 rf config set llm.base_url https://relayx.timor419.com/v1
-rf config set llm.model anthropic/claude-4-7-sonnet
+rf config set llm.model deepseek-v4-flash       # bare id; the provider/model form (e.g. openai/gpt-5-nano) often returns 'no permission'
 rf llm chat -p 'one-sentence summary of antifragile'
 
 # 10. Use your own HTML template (no PR/release needed)

package/dist/commands/config.js

@@ -23,7 +23,7 @@ export function registerConfig(program) {
         "Examples:",
         "  reelforge config set llm.api_key sk-xxxxxx",
         "  reelforge config set llm.base_url https://relayx.timor419.com/v1",
-        "  reelforge config set llm.model openai/gpt-5-mini",
+        "  reelforge config set llm.model deepseek-v4-flash",
         "  reelforge config set relayx.api_key rx-xxxxxx",
         "  reelforge config set relayx.default_image_model rx-image-flux",
     ].join("\n"))

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/llm.js

@@ -21,8 +21,14 @@ export function registerLlm(program) {
         "",
         "Examples:",
         "  reelforge llm chat -p 'Hello'",
-        "  reelforge llm chat -p @prompt.txt -m anthropic/claude-4-7-sonnet -t 0.4",
+        "  reelforge llm chat -p @prompt.txt -m deepseek-v4-flash -t 0.4",
         "  reelforge llm chat -p 'movie review of Inception' --schema review.json --json",
+        "",
+        "Model IDs:",
+        "  Pass the bare model id (e.g. `deepseek-v4-flash`, `gpt-5-nano`).",
+        "  The provider/model form returned by `rf models` (e.g. `openai/gpt-5-nano`)",
+        "  may need explicit provider access on your RelayX account and is more",
+        "  likely to return 'no permission'.",
     ].join("\n"))
         .action(async (opts) => {
         let prompt = opts.prompt;

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.1",
   "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",