reelforge 0.5.5 → 0.7.0

package/dist/commands/pipelines.js

@@ -36,56 +36,74 @@ export function registerPipelines(program) {
     const pl = program
         .command("pipelines")
         .alias("pipeline")
-        .description("End-to-end video pipelines (standard)")
+        .description("End-to-end video pipelines (standard, audio-first)")
         .helpOption("-h, --help", "show help");
     // ---------- standard ----------
     commonOptions(pl
         .command("standard")
-        .description("Topic / script → narration → frames → final MP4")
+        .description("Audio-first pipeline: topic|script → master TTS → ASR → scene/subtitle layers → final MP4")
         .helpOption("-h, --help", "show help")
-        .requiredOption("-t, --text <text>", "topic OR fixed script (use @file)")
-        .option("--mode <mode>", "generate | fixed", "generate")
-        .option("--title <text>", "explicit video title (skip LLM title gen)")
-        .option("-n, --n-scenes <n>", "number of scenes (mode=generate)", parseInt, 5)
-        .option("--split-mode <mode>", "paragraph | line | sentence (mode=fixed)", "paragraph")
-        .option("--frame-template <keyOrPath>", "preset key (e.g. 1080x1920/static_default.html) OR path to a local .html file", "1080x1920/static_default.html")
+        .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("-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("--frame-template <keyOrPath>", "preset key (e.g. 1080x1920/image_default.html) OR path to a local .html file")
         .option("--frame-template-size <wxh>", "size for inline HTML when the file lacks <meta template:width|height>")
-        .option("--frame-template-type <type>", "inline type: image (default) | static | asset. Or set <meta name=\"template:type\"> in the HTML.")
-        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen) — only when template requires AI images")
-        .option("--prompt-prefix <text>", "style prefix prepended to image prompts")
-        .option("--tts-voice <id>", "Edge TTS voice", "zh-CN-YunjianNeural")
-        .option("--tts-speed <n>", "speech speed (0.5..2)", parseFloat, 1.2)
-        .option("--bgm <path>", "BGM file path")
-        .option("--bgm-volume <n>", "BGM volume", parseFloat, 0.2)
+        .option("--frame-template-type <type>", "inline type: image (default) | static | asset")
+        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen)")
+        .option("--prompt-prefix <text>", "style prefix prepended to every image prompt")
+        .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf tts voices`")
+        .option("--tts-speed <n>", "speech speed (0.5..2; default 1.0)", parseFloat)
+        .option("--video-fps <n>", "output video fps (default 30)", (v) => parseInt(v, 10))
+        .option("--subtitle-min-chars <N>", "subtitle line min chars (default 10)", (v) => parseInt(v, 10))
+        .option("--subtitle-hard-max <N>", "subtitle line absolute max chars (default 24)", (v) => parseInt(v, 10))
         .addHelpText("after", [
         "",
-        "Examples:",
-        "  reelforge pipelines standard -t 'why we explore space' -n 5 -o space.mp4",
-        "  reelforge pipelines standard -t @script.txt --mode fixed --split-mode paragraph --title 'My Show' -o out.mp4",
-        "  reelforge pipelines standard -t '宠物' --frame-template 1080x1920/image_default.html --image-model rx-image-flux --prompt-prefix 'cinematic'",
+        "Two content modes (exactly one required):",
+        "  generate    AI writes the script.   --topic / -t <text>  + optional --duration -d",
+        "  fixed       You supply the script.  --script <text-or-@file>",
+        "",
+        "Pace (LLM visual rhythm hint):  slow | normal | fast",
         "",
-        "  Custom HTML template (sent inline; no upload needed):",
-        "  reelforge pipelines standard -t '宠物' --frame-template ./my-brand.html -o final.mp4",
-        "  (declare size via <meta name=\"template:width|height\"> or pass --frame-template-size 1080x1920)",
+        "Examples:",
+        "  rf pipelines standard -t 'why we explore space' -d 60 -o space.mp4",
+        "  rf pipelines standard --script @script.txt -p slow -o out.mp4",
+        "  rf pipelines standard -t '宠物' --frame-template ./my-brand.html -o final.mp4",
     ].join("\n"))).action(async (opts) => {
-        let text = opts.text;
-        if (text.startsWith("@"))
-            text = await fs.readFile(text.slice(1), "utf-8");
-        const tpl = resolveTemplateArg(opts.frameTemplate, opts.frameTemplateSize);
+        const hasTopic = typeof opts.topic === "string" && opts.topic.length > 0;
+        const hasScript = typeof opts.script === "string" && opts.script.length > 0;
+        if (!hasTopic && !hasScript) {
+            throw new Error("either --topic / -t or --script is required");
+        }
+        if (hasTopic && hasScript) {
+            throw new Error("--topic and --script are mutually exclusive");
+        }
+        if (opts.pace && !["slow", "normal", "fast"].includes(opts.pace)) {
+            throw new Error(`--pace must be one of slow|normal|fast (got: ${opts.pace})`);
+        }
+        let topic = opts.topic;
+        let script = opts.script;
+        if (topic?.startsWith("@"))
+            topic = await fs.readFile(topic.slice(1), "utf-8");
+        if (script?.startsWith("@"))
+            script = await fs.readFile(script.slice(1), "utf-8");
+        const tpl = opts.frameTemplate
+            ? resolveTemplateArg(opts.frameTemplate, opts.frameTemplateSize)
+            : {};
         await submitAndMaybeWait("/api/v1/pipelines/standard", {
-            text,
-            mode: opts.mode,
-            title: opts.title,
-            n_scenes: opts.nScenes,
-            split_mode: opts.splitMode,
+            topic,
+            script,
+            duration: opts.duration,
+            pace: opts.pace,
             ...tpl,
             frame_template_type: opts.frameTemplateType,
             image_model: opts.imageModel,
             prompt_prefix: opts.promptPrefix,
-            tts_voice: opts.ttsVoice,
+            voice_id: opts.voiceId,
             tts_speed: opts.ttsSpeed,
-            bgm_path: opts.bgm,
-            bgm_volume: opts.bgmVolume,
+            video_fps: opts.videoFps,
+            subtitle_min_chars: opts.subtitleMinChars,
+            subtitle_hard_max: opts.subtitleHardMax,
         }, { wait: opts.wait, output: opts.output, pollMs: opts.pollMs, timeoutMs: opts.timeoutMs });
     });
 }

package/dist/commands/subtitles.js

@@ -0,0 +1,40 @@
+import fs from "node:fs/promises";
+import { post } from "../client.js";
+import { print } from "../utils/output.js";
+export function registerSubtitles(program) {
+    const sub = program
+        .command("subtitles")
+        .alias("subtitle")
+        .description("Subtitle atomics — deterministic line splitter (no LLM, no billing)")
+        .helpOption("-h, --help", "show help");
+    sub
+        .command("split")
+        .description("Split a chunk of text into subtitle-sized lines using tiered punctuation priority")
+        .helpOption("-h, --help", "show help")
+        .requiredOption("-t, --text <text>", "text to split. Use @file to read from disk.")
+        .option("--min <N>", "minimum line length in chars (default 10)", (v) => parseInt(v, 10))
+        .option("--hard-max <N>", "absolute maximum line length in chars (default 24)", (v) => parseInt(v, 10))
+        .addHelpText("after", [
+        "",
+        "Rule:",
+        "  Within [min, hard-max], pick the highest-tier punctuation; same tier → latest position.",
+        "  Tier 1 (。！？) > Tier 2 (；：) > Tier 3 (，、)",
+        "  No punctuation in window → force-cut at hard-max.",
+        "",
+        "Examples:",
+        "  rf subtitles split -t '雨水缓缓滑落在玻璃窗上，像是无声的泪珠。'",
+        "  rf subtitles split -t @./narration.txt --min 8 --hard-max 20",
+    ].join("\n"))
+        .action(async (opts) => {
+        let text = opts.text;
+        if (text.startsWith("@"))
+            text = (await fs.readFile(text.slice(1), "utf-8")).trim();
+        const body = { text };
+        if (opts.min !== undefined)
+            body.min_chars = opts.min;
+        if (opts.hardMax !== undefined)
+            body.hard_max = opts.hardMax;
+        const r = await post("/api/v1/subtitles/split", body);
+        print({ count: r.count, lines: r.lines });
+    });
+}

package/dist/index.js

@@ -19,6 +19,8 @@ import { registerModels } from "./commands/models.js";
 import { registerTts } from "./commands/tts.js";
 import { registerImages } from "./commands/images.js";
 import { registerContent } from "./commands/content.js";
+import { registerAudio } from "./commands/audio.js";
+import { registerSubtitles } from "./commands/subtitles.js";
 import { registerTemplates } from "./commands/templates.js";
 import { registerFrames } from "./commands/frames.js";
 import { registerCompositions } from "./commands/compositions.js";
@@ -70,7 +72,7 @@ program.addHelpText("afterAll", [
     "  rf llm chat --prompt 'explain antifragile in 3 sentences'",
     "  rf tts edge --text 'hello world' --voice en-US-AriaNeural -o out.mp3",
     "  rf images generate --prompt 'a cat' --model rx-image-flux -o cat.png",
-    "  rf pipelines standard --text 'why we explore space' --tts-voice zh-CN-YunjianNeural",
+    "  rf pipelines standard -t 'why we explore space' -d 60",
     "  rf tasks list --status running",
     "  rf config get",
 ].join("\n"));
@@ -81,6 +83,8 @@ registerModels(program);
 registerTts(program);
 registerImages(program);
 registerContent(program);
+registerAudio(program);
+registerSubtitles(program);
 registerTemplates(program);
 registerFrames(program);
 registerCompositions(program);

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "reelforge",
-  "version": "0.5.5",
-  "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",
-  "bin": {
-    "reelforge": "./bin/reelforge.js",
-    "rf": "./bin/reelforge.js"
-  },
-  "files": [
-    "bin",
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18.17"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -p tsconfig.json --watch",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "clean": "rimraf dist",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-  "dependencies": {
-    "commander": "^12.1.0",
-    "kleur": "^4.1.5"
-  },
-  "devDependencies": {
-    "@types/node": "^20.14.0",
-    "rimraf": "^6.0.1",
-    "typescript": "^5.5.0"
-  },
-  "keywords": [
-    "reelforge",
-    "ai-video",
-    "relayx",
-    "tts",
-    "edge-tts",
-    "ffmpeg",
-    "playwright",
-    "cli"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/puke3615/ReelForge.git",
-    "directory": "cli"
-  },
-  "homepage": "https://github.com/puke3615/ReelForge"
-}
+{
+  "name": "reelforge",
+  "version": "0.7.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",
+  "bin": {
+    "reelforge": "./bin/reelforge.js",
+    "rf": "./bin/reelforge.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "kleur": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "reelforge",
+    "ai-video",
+    "relayx",
+    "tts",
+    "edge-tts",
+    "ffmpeg",
+    "playwright",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/puke3615/ReelForge.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/puke3615/ReelForge"
+}