@vibeframe/cli 0.115.4 → 0.115.5

package/CONTEXT.md

@@ -3,7 +3,7 @@
 ## Overview
 
 VibeFrame CLI (`vibe`) generates AI video on the user's own provider keys
-(Seedance, Runway, Veo, Kling), behind dry runs and a hard `--max-cost`
+(Seedance, Runway, Kling, Gemini Omni), behind dry runs and a hard `--max-cost`
 ceiling, and edits the results. Every operation is
 a shell command. The same surface is exposed as MCP tools through
 [`@vibeframe/mcp-server`](https://www.npmjs.com/package/@vibeframe/mcp-server).

package/dist/commands/_shared/init-templates.d.ts

@@ -18,7 +18,7 @@
  * file. Keep this as the canonical source of truth for agent guidance -
  * \`CLAUDE.md\` and \`GEMINI.md\` just import it.
  */
-export declare const AGENTS_MD = "# AGENTS.md\n\nThis project uses [VibeFrame](https://github.com/vericontext/vibeframe) -\na CLI for AI video generation on the user's own provider keys (Seedance,\nRunway, Veo, Kling), behind dry runs and a hard `--max-cost` ceiling.\nThe `vibe` command provides 80+ subcommands for video generation,\nediting, and analysis. Cost tiers below - **always confirm with the user\nbefore running High / Very High tier commands**.\n\n## Agent host coverage\n\nVibeFrame's CLI works with any bash-capable AI coding agent. Six host\nfamilies have first-class auto-detection and scaffolds today:\n\n- **Claude Code** - `CLAUDE.md` (this file's import wrapper) +\n  `AGENTS.md` + `/vibe-*` slash commands.\n- **OpenAI Codex** - reads `AGENTS.md` natively (agents.md spec).\n- **Cursor** - reads `AGENTS.md` plus `.cursor/rules/` for project\n  rules; supports MCP via `.cursor/mcp.json`.\n- **Aider** - reads `AGENTS.md` (binary-only detection by VibeFrame).\n- **Gemini CLI** - primary context file is `GEMINI.md`; also reads\n  `AGENTS.md` if present.\n- **OpenCode** - reads `AGENTS.md` (officially supported per\n  `opencode.ai/docs/rules`); supports MCP via `.opencode/mcp.json`.\n\nRun `vibe doctor` to see which host(s) the CLI detects in your\nenvironment. Anyone running another bash-capable agent (Continue,\nSourcegraph Cody, etc.) still gets this `AGENTS.md` as the universal\nfallback.\n\n## Self-discovery\n\nDon't memorise the command surface - read it from the CLI:\n\n```bash\nvibe --help                    # command groups overview\nvibe schema --list             # full machine-readable catalog (80+)\nvibe schema --list --surface public  # small first-run/product command surface\nvibe schema generate.video     # JSON Schema for any single command\nvibe doctor                    # available providers + system health\nvibe host setup all            # print Codex/Claude/Cursor app integration snippets\nvibe host doctor all --json    # verify project guidance + MCP config\nvibe guide motion              # choose text-overlay vs motion-overlay vs generate motion\nvibe guide scene               # step-by-step authoring guide (scene)\nvibe guide pipeline            # step-by-step authoring guide (pipeline)\n```\n\n## Route by the user's actual request\n\nRouting the user's request correctly is the most important judgement call\nyou'll make. Do not force everything into a scene project.\n\n**ASSET - default for any single-asset request OR ambiguous prompt.**\nIf the user asks for a single image, single video clip, sound effect, music\nbed, or narration file - **OR pastes a visual/audio brief without explicit\nstoryboard / scene / multi-scene language** - treat it as ASSET. Use\n`vibe generate ...` directly. Do **not** edit `DESIGN.md`,\n`STORYBOARD.md`, run `vibe scene ...`, or auto-load the hyperframes\nskill until BUILD intent is explicit. The visual-identity hard-gate\napplies to BUILD only.\n\nExamples:\n- \"make this image\" \u2192 `vibe generate image \"...\" -o assets/name.png`\n- \"use this image to make a video\" \u2192 `vibe generate video \"...\" -i image.png -o renders/name.mp4`\n- \"add a lower-third/title/animated overlay/grain/vignette to this clip\" \u2192 prefer `vibe edit motion-overlay clip.mp4 \"...\" --understand auto -o out.mp4` when the request asks for designed or animated motion graphics.\n- \"please add visuals using OpenAI image gen\" \u2192 `vibe generate image \"...\" -p openai ...`\n- *(verb-less paste)* \"aerial view of a misty mountain peak at sunrise...\" \u2192 `vibe generate image \"<paste>\" -o assets/mountain-peak.png`. **Don't** read it as a brief for DESIGN.md.\n\nIf genuinely uncertain, ask one short question: *\"single asset or\nmulti-scene project?\"* before authoring DESIGN.md or loading the\nhyperframes skill.\n\n**BUILD - create new video from text intent.**\nUse `vibe build` with a STORYBOARD.md + DESIGN.md. The\nskills-driven pipeline (v0.60+) dispatches narration TTS + backdrop\nimage-gen per beat, composes scene HTML via the bundled composition rules\nbundle, then renders to MP4. Idempotent re-runs reuse cached assets.\n\n**REMIX - transform existing video / audio.**\nUse `vibe remix`, `vibe edit`, or `vibe audio`. One-shot,\nbatch-oriented operations on a file the user already has on disk.\n`vibe edit text-overlay` is the free deterministic path for simple static\ntext burn-in. If the user asks for motion design, animated lower-thirds,\ndesigned titles, grain/vignette as part of a graphic treatment, or says\n\"motion graphics\", use `vibe edit motion-overlay ... --understand auto` instead.\n\nDecision rule: if the user asks for one asset, it's ASSET. If the user asks\nfor a multi-scene/storyboard/composed video, it's BUILD. If the user is\nstarting from a media file and wants it transformed, it's REMIX.\n\n## Common workflows\n\n### BUILD (new video from text)\n\n| Task | Command |\n|---|---|\n| One-shot storyboard \u2192 video | `vibe build [project-dir]` |\n| Render an existing scene project | `vibe render [project-dir] -o out.mp4` |\n| Lint scene HTML | `vibe scene lint --json` |\n| Generate a single image | `vibe generate image \"prompt\" -o img.png --quality hd` |\n| Generate a single video | `vibe generate video \"prompt\" -i image.png -o clip.mp4` |\n| Generate narration | `vibe generate narration \"text\" -o voice.mp3` |\n\n### REMIX (transform existing media)\n\n| Task | Command |\n|---|---|\n| Extract highlights from a long video | `vibe remix highlights file.mp4 -d 60` |\n| Long video \u2192 vertical shorts | `vibe remix auto-shorts file.mp4 -n 3 --add-captions` |\n| Add animated word-by-word captions | `vibe remix animated-caption file.mp4 -s karaoke-sweep` |\n| Add designed motion graphics overlay | `vibe edit motion-overlay file.mp4 \"lower-third...\" --understand auto -o out.mp4` |\n| Remove silence | `vibe edit silence-cut in.mp4 -o out.mp4` |\n| Add static captions | `vibe edit caption in.mp4 -o out.mp4` |\n| Translate audio (transcribe \u2192 TTS) | `vibe audio dub file.mp4 -t ko` |\n| Transcribe (Whisper, word-level) | `vibe audio transcribe file.mp4 --granularity word` |\n| Inspect media with Gemini | `vibe inspect media file.mp4 \"summarise\" --json` |\n\n### Compose pipelines (Video as Code)\n\n| Task | Command |\n|---|---|\n| Run a YAML pipeline | `vibe run pipeline.yaml --dry-run` |\n| Resume from last checkpoint | `vibe run pipeline.yaml --resume` |\n\n## Cost tiers\n\n| Tier | Examples | Approx. per call |\n|---|---|---|\n| **Free** | `schema/context/doctor`, `detect *`, `status *`, `plan`, `storyboard validate`, `inspect project/render --cheap`, deterministic edits | $0 |\n| **Low** | `generate narration/sound-effect/music`, `audio transcribe`, `inspect media`, optional AI review | $0.01\u2013$0.10 |\n| **High** | `generate image/motion`, `edit image/reframe/grade/speed-ramp` | $1\u2013$5 |\n| **Very High** | `generate video`, `edit fill-gaps`, `remix highlights/auto-shorts`, `build` with generated assets | $5\u2013$50+ |\n\n## Agent invariants\n\nWhen you run vibe commands programmatically:\n\n1. **Always `--json`** for structured output you can parse without regex\n2. **Always `--dry-run` first** for any High/Very-High tier command - it returns\n   the cost estimate without spending API budget\n3. **Use `vibe schema <command>`** to discover parameters; do not guess flags\n4. **Pass complex options via `--stdin`**:\n   ```bash\n   echo '{\"video\":\"long.mp4\",\"count\":3,\"aspect\":\"9:16\"}' | vibe remix auto-shorts --stdin --json\n   ```\n\n## Provider keys and project scope\n\nPrefer `vibe setup --scope project` for project-local keys. It writes\n`.vibeframe/config.yaml` in the setup directory; when you work from a\nnested scene directory, the `vibe` CLI automatically searches parent\ndirectories and uses the nearest project config. Do not assume the config\nfile must exist in the current subdirectory.\n\nRun `vibe doctor --json` from the directory where you will run commands\nand check `data.scope.project.configPath` / `data.scope.activeScope` before\ndeciding keys are missing. Never print or copy config file contents.\n\nFor generated project assets, use VibeFrame commands such as\n`vibe generate image|video|speech ...` so these project-scope keys are\nused. Do not switch to a host agent's built-in image/audio generation tool\nunless the user explicitly asks for a non-VibeFrame asset.\n\n`.env` is still supported as a gitignored fallback. Copy `.env.example`\nto start if you prefer environment variables.\n\n## App host setup\n\nVibeFrame is CLI-first, not terminal-only. Codex, Claude Code, and Cursor can\ndrive the same project through shell commands, and app hosts can also use\nVibeFrame's MCP server as a typed tool surface.\n\n```bash\nvibe host setup all         # print snippets only\nvibe host setup all --write # write project/app config\nvibe host doctor all --json # verify readiness\n```\n\nDefault setup is snippet-only; use `--write` when you want VibeFrame to merge\nthe generated config. Keep provider keys in `.vibeframe/config.yaml`, user\nconfig, or env files - not in app host config.\n\n## Host agent loop\n\nFor long-running work, use your host's agent loop (Claude Code, Codex, Cursor,\nor another coding-agent host) as the outer loop. VibeFrame should not own a\ncompeting project-level agent loop. It provides `--json` commands, dry runs,\nbudget caps, `build-report.json`, `review-report.json`, `nextActions`,\n`safeToAutoRun`, `requiresConfirmation`, `fixOwner`, deterministic repair,\nand render inspection for the host agent to decide what to do next.\n\nCopy-paste agent prompt (Codex) - a plain prompt, not a built-in command:\n\n```text\nBuild this VibeFrame project into renders/final.mp4. Use --json for every\nvibe command, run --dry-run before paid operations, use --max-cost 5 for builds\nunless the user gives another budget, read build-report.json and\nreview-report.json before deciding the next action, prefer nextActions before\nguessing, run only safeToAutoRun:true actions automatically, and ask before\nrequiresConfirmation:true actions. Treat retryWith as the compatibility\nfallback, fixOwner:\"vibe\" as CLI repair work, and fixOwner:\"host-agent\" as\nSTORYBOARD.md, DESIGN.md, or composition edits.\nStop only when renders/final.mp4 exists, target duration and aspect ratio are\nmet, inspect render --cheap has no errors, any AI review score is >= 90 when AI review is requested, and every\nremaining host-agent issue is fixed, accepted with rationale, or reported as\nblocked.\n```\n\nCopy-paste agent prompt (Claude Code) - a plain prompt, not a built-in command:\n\n```text\nFinish this VibeFrame render using your host's agent loop as the outer\nloop. Use vibe context/schema when unsure, --json everywhere, dry-run before\npaid operations, budget cap via --max-cost 5, nextActions before guessing,\nbuild-report.json/review-report.json as loop state, and safeToAutoRun,\nrequiresConfirmation, and fixOwner to decide between vibe scene repair and\nhost-agent edits. Stop only after final MP4,\ntarget duration/aspect ratio, clean render inspection, any AI review score >= 90 when AI review is requested, and\nno unresolved unacknowledged host-agent issues.\n```\n\n### Composition rules (scene HTML)\n\nComposition rules live in the **Hyperframes skill** - framework rules, motion\nprinciples, type system, and visual-identity hard-gate. **Load that skill\nbefore authoring any scene composition HTML under `compositions/`.** The same\nrules govern `vibe scene lint`, so your authored HTML and the linter stay in\nagreement.\n\nWhere the skill comes from depends on your setup:\n\n- If the `hyperframes` skill is installed globally (e.g. Claude Code), your\n  agent already has it and nothing else is needed.\n- Otherwise install it into this project with `vibe scene install-skill`,\n  which runs upstream's own installer and writes\n  `.agents/skills/hyperframes/`.\n\n`vibe init` never copies the rules in. They come from upstream so they stay\ncurrent, and fetching them is a network call the scaffold does not make on\nyour behalf. `vibe doctor` reports whether your agent can read them.\n\nFor render-stable text, do not apply continuous `scale`, `x`, `y`,\n`filter`, or other transform tweens to `.scene-content` or any ancestor\ncontaining live text/cards. Put ambient zoom/parallax on background or media\nlayers only; text should enter briefly and then hold still at its final CSS\nposition.\n\n### Scene composer (non-agent fallback)\n\nScene HTML is authored by you, the host agent - the CLI makes no LLM call\nduring `vibe build`. When no agent is available to author scenes, pass\n`--composer template` for the deterministic no-model composer\n(concat background + lower-thirds).\n\n## Project conventions\n\n<!-- Edit this section with YOUR project's specifics. Examples below. -->\n\n- Default aspect ratio: `16:9`\n- Default scene duration: `3 seconds` (per beat)\n- Brand voice: <describe>\n- Output naming: `renders/<name>-<timestamp>.mp4`\n";
+export declare const AGENTS_MD = "# AGENTS.md\n\nThis project uses [VibeFrame](https://github.com/vericontext/vibeframe) -\na CLI for AI video generation on the user's own provider keys (Seedance,\nRunway, Kling, Gemini Omni), behind dry runs and a hard `--max-cost` ceiling.\nThe `vibe` command provides 80+ subcommands for video generation,\nediting, and analysis. Cost tiers below - **always confirm with the user\nbefore running High / Very High tier commands**.\n\n## Agent host coverage\n\nVibeFrame's CLI works with any bash-capable AI coding agent. Six host\nfamilies have first-class auto-detection and scaffolds today:\n\n- **Claude Code** - `CLAUDE.md` (this file's import wrapper) +\n  `AGENTS.md` + `/vibe-*` slash commands.\n- **OpenAI Codex** - reads `AGENTS.md` natively (agents.md spec).\n- **Cursor** - reads `AGENTS.md` plus `.cursor/rules/` for project\n  rules; supports MCP via `.cursor/mcp.json`.\n- **Aider** - reads `AGENTS.md` (binary-only detection by VibeFrame).\n- **Gemini CLI** - primary context file is `GEMINI.md`; also reads\n  `AGENTS.md` if present.\n- **OpenCode** - reads `AGENTS.md` (officially supported per\n  `opencode.ai/docs/rules`); supports MCP via `.opencode/mcp.json`.\n\nRun `vibe doctor` to see which host(s) the CLI detects in your\nenvironment. Anyone running another bash-capable agent (Continue,\nSourcegraph Cody, etc.) still gets this `AGENTS.md` as the universal\nfallback.\n\n## Self-discovery\n\nDon't memorise the command surface - read it from the CLI:\n\n```bash\nvibe --help                    # command groups overview\nvibe schema --list             # full machine-readable catalog (80+)\nvibe schema --list --surface public  # small first-run/product command surface\nvibe schema generate.video     # JSON Schema for any single command\nvibe doctor                    # available providers + system health\nvibe host setup all            # print Codex/Claude/Cursor app integration snippets\nvibe host doctor all --json    # verify project guidance + MCP config\nvibe guide motion              # choose text-overlay vs motion-overlay vs generate motion\nvibe guide scene               # step-by-step authoring guide (scene)\nvibe guide pipeline            # step-by-step authoring guide (pipeline)\n```\n\n## Route by the user's actual request\n\nRouting the user's request correctly is the most important judgement call\nyou'll make. Do not force everything into a scene project.\n\n**ASSET - default for any single-asset request OR ambiguous prompt.**\nIf the user asks for a single image, single video clip, sound effect, music\nbed, or narration file - **OR pastes a visual/audio brief without explicit\nstoryboard / scene / multi-scene language** - treat it as ASSET. Use\n`vibe generate ...` directly. Do **not** edit `DESIGN.md`,\n`STORYBOARD.md`, run `vibe scene ...`, or auto-load the hyperframes\nskill until BUILD intent is explicit. The visual-identity hard-gate\napplies to BUILD only.\n\nExamples:\n- \"make this image\" \u2192 `vibe generate image \"...\" -o assets/name.png`\n- \"use this image to make a video\" \u2192 `vibe generate video \"...\" -i image.png -o renders/name.mp4`\n- \"add a lower-third/title/animated overlay/grain/vignette to this clip\" \u2192 prefer `vibe edit motion-overlay clip.mp4 \"...\" --understand auto -o out.mp4` when the request asks for designed or animated motion graphics.\n- \"please add visuals using OpenAI image gen\" \u2192 `vibe generate image \"...\" -p openai ...`\n- *(verb-less paste)* \"aerial view of a misty mountain peak at sunrise...\" \u2192 `vibe generate image \"<paste>\" -o assets/mountain-peak.png`. **Don't** read it as a brief for DESIGN.md.\n\nIf genuinely uncertain, ask one short question: *\"single asset or\nmulti-scene project?\"* before authoring DESIGN.md or loading the\nhyperframes skill.\n\n**BUILD - create new video from text intent.**\nUse `vibe build` with a STORYBOARD.md + DESIGN.md. The\nskills-driven pipeline (v0.60+) dispatches narration TTS + backdrop\nimage-gen per beat, composes scene HTML via the bundled composition rules\nbundle, then renders to MP4. Idempotent re-runs reuse cached assets.\n\n**REMIX - transform existing video / audio.**\nUse `vibe remix`, `vibe edit`, or `vibe audio`. One-shot,\nbatch-oriented operations on a file the user already has on disk.\n`vibe edit text-overlay` is the free deterministic path for simple static\ntext burn-in. If the user asks for motion design, animated lower-thirds,\ndesigned titles, grain/vignette as part of a graphic treatment, or says\n\"motion graphics\", use `vibe edit motion-overlay ... --understand auto` instead.\n\nDecision rule: if the user asks for one asset, it's ASSET. If the user asks\nfor a multi-scene/storyboard/composed video, it's BUILD. If the user is\nstarting from a media file and wants it transformed, it's REMIX.\n\n## Common workflows\n\n### BUILD (new video from text)\n\n| Task | Command |\n|---|---|\n| One-shot storyboard \u2192 video | `vibe build [project-dir]` |\n| Render an existing scene project | `vibe render [project-dir] -o out.mp4` |\n| Lint scene HTML | `vibe scene lint --json` |\n| Generate a single image | `vibe generate image \"prompt\" -o img.png --quality hd` |\n| Generate a single video | `vibe generate video \"prompt\" -i image.png -o clip.mp4` |\n| Generate narration | `vibe generate narration \"text\" -o voice.mp3` |\n\n### REMIX (transform existing media)\n\n| Task | Command |\n|---|---|\n| Extract highlights from a long video | `vibe remix highlights file.mp4 -d 60` |\n| Long video \u2192 vertical shorts | `vibe remix auto-shorts file.mp4 -n 3 --add-captions` |\n| Add animated word-by-word captions | `vibe remix animated-caption file.mp4 -s karaoke-sweep` |\n| Add designed motion graphics overlay | `vibe edit motion-overlay file.mp4 \"lower-third...\" --understand auto -o out.mp4` |\n| Remove silence | `vibe edit silence-cut in.mp4 -o out.mp4` |\n| Add static captions | `vibe edit caption in.mp4 -o out.mp4` |\n| Translate audio (transcribe \u2192 TTS) | `vibe audio dub file.mp4 -t ko` |\n| Transcribe (Whisper, word-level) | `vibe audio transcribe file.mp4 --granularity word` |\n| Inspect media with Gemini | `vibe inspect media file.mp4 \"summarise\" --json` |\n\n### Compose pipelines (Video as Code)\n\n| Task | Command |\n|---|---|\n| Run a YAML pipeline | `vibe run pipeline.yaml --dry-run` |\n| Resume from last checkpoint | `vibe run pipeline.yaml --resume` |\n\n## Cost tiers\n\n| Tier | Examples | Approx. per call |\n|---|---|---|\n| **Free** | `schema/context/doctor`, `detect *`, `status *`, `plan`, `storyboard validate`, `inspect project/render --cheap`, deterministic edits | $0 |\n| **Low** | `generate narration/sound-effect/music`, `audio transcribe`, `inspect media`, optional AI review | $0.01\u2013$0.10 |\n| **High** | `generate image/motion`, `edit image/reframe/grade/speed-ramp` | $1\u2013$5 |\n| **Very High** | `generate video`, `edit fill-gaps`, `remix highlights/auto-shorts`, `build` with generated assets | $5\u2013$50+ |\n\n## Agent invariants\n\nWhen you run vibe commands programmatically:\n\n1. **Always `--json`** for structured output you can parse without regex\n2. **Always `--dry-run` first** for any High/Very-High tier command - it returns\n   the cost estimate without spending API budget\n3. **Use `vibe schema <command>`** to discover parameters; do not guess flags\n4. **Pass complex options via `--stdin`**:\n   ```bash\n   echo '{\"video\":\"long.mp4\",\"count\":3,\"aspect\":\"9:16\"}' | vibe remix auto-shorts --stdin --json\n   ```\n\n## Provider keys and project scope\n\nPrefer `vibe setup --scope project` for project-local keys. It writes\n`.vibeframe/config.yaml` in the setup directory; when you work from a\nnested scene directory, the `vibe` CLI automatically searches parent\ndirectories and uses the nearest project config. Do not assume the config\nfile must exist in the current subdirectory.\n\nRun `vibe doctor --json` from the directory where you will run commands\nand check `data.scope.project.configPath` / `data.scope.activeScope` before\ndeciding keys are missing. Never print or copy config file contents.\n\nFor generated project assets, use VibeFrame commands such as\n`vibe generate image|video|speech ...` so these project-scope keys are\nused. Do not switch to a host agent's built-in image/audio generation tool\nunless the user explicitly asks for a non-VibeFrame asset.\n\n`.env` is still supported as a gitignored fallback. Copy `.env.example`\nto start if you prefer environment variables.\n\n## App host setup\n\nVibeFrame is CLI-first, not terminal-only. Codex, Claude Code, and Cursor can\ndrive the same project through shell commands, and app hosts can also use\nVibeFrame's MCP server as a typed tool surface.\n\n```bash\nvibe host setup all         # print snippets only\nvibe host setup all --write # write project/app config\nvibe host doctor all --json # verify readiness\n```\n\nDefault setup is snippet-only; use `--write` when you want VibeFrame to merge\nthe generated config. Keep provider keys in `.vibeframe/config.yaml`, user\nconfig, or env files - not in app host config.\n\n## Host agent loop\n\nFor long-running work, use your host's agent loop (Claude Code, Codex, Cursor,\nor another coding-agent host) as the outer loop. VibeFrame should not own a\ncompeting project-level agent loop. It provides `--json` commands, dry runs,\nbudget caps, `build-report.json`, `review-report.json`, `nextActions`,\n`safeToAutoRun`, `requiresConfirmation`, `fixOwner`, deterministic repair,\nand render inspection for the host agent to decide what to do next.\n\nCopy-paste agent prompt (Codex) - a plain prompt, not a built-in command:\n\n```text\nBuild this VibeFrame project into renders/final.mp4. Use --json for every\nvibe command, run --dry-run before paid operations, use --max-cost 5 for builds\nunless the user gives another budget, read build-report.json and\nreview-report.json before deciding the next action, prefer nextActions before\nguessing, run only safeToAutoRun:true actions automatically, and ask before\nrequiresConfirmation:true actions. Treat retryWith as the compatibility\nfallback, fixOwner:\"vibe\" as CLI repair work, and fixOwner:\"host-agent\" as\nSTORYBOARD.md, DESIGN.md, or composition edits.\nStop only when renders/final.mp4 exists, target duration and aspect ratio are\nmet, inspect render --cheap has no errors, any AI review score is >= 90 when AI review is requested, and every\nremaining host-agent issue is fixed, accepted with rationale, or reported as\nblocked.\n```\n\nCopy-paste agent prompt (Claude Code) - a plain prompt, not a built-in command:\n\n```text\nFinish this VibeFrame render using your host's agent loop as the outer\nloop. Use vibe context/schema when unsure, --json everywhere, dry-run before\npaid operations, budget cap via --max-cost 5, nextActions before guessing,\nbuild-report.json/review-report.json as loop state, and safeToAutoRun,\nrequiresConfirmation, and fixOwner to decide between vibe scene repair and\nhost-agent edits. Stop only after final MP4,\ntarget duration/aspect ratio, clean render inspection, any AI review score >= 90 when AI review is requested, and\nno unresolved unacknowledged host-agent issues.\n```\n\n### Composition rules (scene HTML)\n\nComposition rules live in the **Hyperframes skill** - framework rules, motion\nprinciples, type system, and visual-identity hard-gate. **Load that skill\nbefore authoring any scene composition HTML under `compositions/`.** The same\nrules govern `vibe scene lint`, so your authored HTML and the linter stay in\nagreement.\n\nWhere the skill comes from depends on your setup:\n\n- If the `hyperframes` skill is installed globally (e.g. Claude Code), your\n  agent already has it and nothing else is needed.\n- Otherwise install it into this project with `vibe scene install-skill`,\n  which runs upstream's own installer and writes\n  `.agents/skills/hyperframes/`.\n\n`vibe init` never copies the rules in. They come from upstream so they stay\ncurrent, and fetching them is a network call the scaffold does not make on\nyour behalf. `vibe doctor` reports whether your agent can read them.\n\nFor render-stable text, do not apply continuous `scale`, `x`, `y`,\n`filter`, or other transform tweens to `.scene-content` or any ancestor\ncontaining live text/cards. Put ambient zoom/parallax on background or media\nlayers only; text should enter briefly and then hold still at its final CSS\nposition.\n\n### Scene composer (non-agent fallback)\n\nScene HTML is authored by you, the host agent - the CLI makes no LLM call\nduring `vibe build`. When no agent is available to author scenes, pass\n`--composer template` for the deterministic no-model composer\n(concat background + lower-thirds).\n\n## Project conventions\n\n<!-- Edit this section with YOUR project's specifics. Examples below. -->\n\n- Default aspect ratio: `16:9`\n- Default scene duration: `3 seconds` (per beat)\n- Brand voice: <describe>\n- Output naming: `renders/<name>-<timestamp>.mp4`\n";
 /**
  * Claude Code project file. Imports AGENTS.md so guidance stays
  * single-sourced; adds Claude-specific overrides (slash commands, etc.).

package/dist/commands/generate/video.d.ts

@@ -7,6 +7,15 @@
  */
 import type { Command } from "commander";
 export declare function registerVideoCommand(parent: Command): void;
+/**
+ * Cost figure for a REAL (non-dry-run) generation envelope.
+ *
+ * Seedance has a token-accurate estimator; every other provider reports the
+ * command's tier upper bound with a warning naming it an estimate. Without
+ * this the success envelope defaulted to costUsd 0, which an agent budget
+ * loop reads as "free" - the hybrid-brew dogfood run billed Runway twice
+ * while reporting $0.
+ */
 export declare function realRunCost(provider: string, options: {
     duration?: string;
     resolution?: string;

package/dist/commands/generate.d.ts

@@ -5,7 +5,7 @@
  *
  * Commands:
  *   generate image          - Generate image (Gemini, OpenAI, Grok, Runway)
- *   generate video          - Generate video (Seedance, Grok, Kling, Runway, Veo)
+ *   generate video          - Generate video (Seedance, Grok, Kling, Runway, Omni, Veo)
  *   generate sound-effect   - Sound effects (ElevenLabs)
  *   generate music          - Music generation (ElevenLabs default, Replicate MusicGen)
  *   generate motion         - Standalone motion assets (Claude/Gemini + Remotion)

package/dist/commands/output.d.ts

@@ -75,6 +75,11 @@ export interface SuccessEnvelopeOptions {
     warnings?: string[];
     /** Pass-through of `--dry-run` flag — surfaces as a top-level `dryRun: true` in the envelope. */
     dryRun?: boolean;
+    /**
+     * The caller already printed its own human-readable output (a build plan,
+     * a render summary), so human mode adds nothing for this dry run.
+     */
+    humanRendered?: boolean;
 }
 /** Look up the upper-bound cost estimate for a command (used by dry-run). */
 /**
@@ -87,12 +92,15 @@ export declare function lookupCostEstimateUpperBound(command: string): number;
  * Emit a canonical success envelope (#33 — 2c). JSON mode prints the
  * envelope; quiet mode prints a single primary value extracted from
  * `data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id`;
- * human mode prints nothing — the caller renders human output itself.
+ * human mode prints a summary for dry runs (unless the caller rendered its
+ * own) and otherwise nothing — the caller renders human output itself.
  *
  * Canary scope: `generate image` only in 2c-canary. 2c-sweep migrates
  * the rest. Old `outputResult()` remains for the sweep transition.
  */
 export declare function outputSuccess(opts: SuccessEnvelopeOptions): void;
+/** Print warnings to stderr in human mode; JSON envelopes carry them instead. */
+export declare function printWarnings(warnings: readonly string[]): void;
 /** Output result - JSON mode outputs JSON, quiet mode outputs primary value only */
 export declare function outputResult(result: Record<string, unknown>): void;
 /** Wrap console output - suppressed in JSON/quiet mode */

package/dist/index.js

@@ -6629,7 +6629,42 @@ function outputSuccess(opts) {
     const data = opts.data;
     const primary = data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id;
     if (primary !== void 0) console.log(String(primary));
+    return;
+  }
+  if (opts.dryRun && !opts.humanRendered) {
+    printDryRunSummary(opts.command, costUsd, opts.data, opts.warnings ?? []);
+  }
+}
+function printWarnings(warnings) {
+  if (isJsonMode()) return;
+  for (const warning of warnings) {
+    process.stderr.write(`${source_default.yellow(`Warning: ${warning}`)}
+`);
+  }
+}
+function formatDryRunValue(value) {
+  const text = Array.isArray(value) ? value.map((v) => formatDryRunValue(v)).join(", ") : typeof value === "object" ? JSON.stringify(value) : String(value);
+  return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+}
+function printDryRunSummary(command, costUsd, data, warnings) {
+  const params = data.params && typeof data.params === "object" ? data.params : data;
+  const rows = [
+    ["cost", costUsd > 0 ? `up to $${costUsd.toFixed(2)} (estimate)` : "free"]
+  ];
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0 || value === null || value === "") continue;
+    if (Array.isArray(value) && value.length === 0) continue;
+    rows.push([key, formatDryRunValue(value)]);
   }
+  const width = Math.max(...rows.map(([key]) => key.length));
+  console.log();
+  console.log(`${source_default.bold.cyan(`Dry run: vibe ${command}`)} ${source_default.dim("(nothing was sent)")}`);
+  for (const [key, value] of rows) {
+    console.log(`  ${source_default.dim(key.padEnd(width))}  ${value}`);
+  }
+  printWarnings(warnings);
+  console.log(source_default.dim("  Run again without --dry-run to execute."));
+  console.log();
 }
 function log(...args) {
   if (!isJsonMode() && !isQuietMode()) {
@@ -6984,8 +7019,8 @@ var init_api_keys = __esm({
       envVar: "GOOGLE_API_KEY",
       label: "Google",
       showInSetup: true,
-      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)",
-      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Veo video)",
+      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Omni video ($$)",
+      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Omni video)",
       envExampleUrl: "https://aistudio.google.com/apikey",
       keyFormat: { prefix: /^AIza/, example: "AIza..." }
     });
@@ -7239,10 +7274,35 @@ function findModel(provider, kind, aliasOrId) {
   const lower = key.toLowerCase();
   return listModels({ provider, kind }).find((m) => m.id === key || m.aliases?.includes(lower));
 }
+function modelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec.shutdown)
+    return { state: "served" };
+  const remainingMs = Date.parse(`${spec.shutdown}T00:00:00Z`) - now.getTime();
+  const instead = spec.replacement ? ` Use ${spec.replacement} instead.` : "";
+  if (remainingMs <= 0) {
+    return {
+      state: "retired",
+      shutdown: spec.shutdown,
+      message: `${spec.label} (${spec.id}) was shut down by the provider on ${spec.shutdown}.${instead}`
+    };
+  }
+  const daysLeft = Math.ceil(remainingMs / 864e5);
+  return {
+    state: "retiring",
+    shutdown: spec.shutdown,
+    daysLeft,
+    message: `${spec.label} (${spec.id}) shuts down on ${spec.shutdown} (${daysLeft} day${daysLeft === 1 ? "" : "s"} left).${instead}`
+  };
+}
+function assertModelServed(spec, now = /* @__PURE__ */ new Date()) {
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired")
+    throw new ModelRetiredError(lifecycle.message, spec);
+}
 function modelAliases(provider, kind) {
   return listModels({ provider, kind }).flatMap((m) => m.aliases ?? []);
 }
-var MODEL_CATALOG;
+var MODEL_CATALOG, ModelRetiredError;
 var init_catalog = __esm({
   "../ai-providers/dist/catalog/catalog.js"() {
     "use strict";
@@ -7278,8 +7338,8 @@ var init_catalog = __esm({
       { id: "seedance-2.0-fast", provider: "seedance", kind: "video", label: "Seedance 2.0 Fast", aliases: ["fast"], status: "ga", price: { usd: 0.2419, per: "second", basis: "720p 16:9" }, note: "4-15 s, up to 720p, native audio" },
       { id: "seedance-2.5", provider: "seedance", kind: "video", label: "Seedance 2.5", aliases: ["2.5"], status: "ga", price: { usd: 0.473, per: "second", basis: "720p 16:9" }, note: "Opt-in; 4-30 s, native audio" },
       { id: "gemini-omni-1.1-flash", provider: "omni", kind: "video", label: "Gemini Omni 1.1 Flash", default: true, status: "ga", price: { usd: 0.1, per: "second", basis: "720p" }, note: "Google video default; the model picks 3-10 s; native audio" },
-      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
-      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
       { id: "grok-imagine-video-1.5", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5", aliases: ["1.5"], default: true, status: "ga", price: { usd: 0.14, per: "second", basis: "720p" }, note: "1-15 s, native audio; 720p unless `--resolution` says otherwise" },
       { id: "grok-imagine-video-1.5-lite", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5 Lite", aliases: ["lite", "1.5-lite"], status: "ga", price: { usd: 0.03, per: "second", basis: "720p" }, note: "1-15 s, native audio" },
       { id: "grok-imagine-video", provider: "grok", kind: "video", label: "Grok Imagine Video", aliases: ["classic"], status: "legacy", price: { usd: 0.05, per: "second", basis: "480p" }, note: "Previous generation" },
@@ -7295,6 +7355,13 @@ var init_catalog = __esm({
       { id: "eleven_text_to_sound_v2", provider: "elevenlabs", kind: "sound-effect", label: "ElevenLabs Sound Effects v2", default: true, status: "ga", price: { usd: 0.12, per: "minute" }, note: "0.5-30 s" },
       { id: "whisper-1", provider: "openai", kind: "transcription", label: "Whisper", default: true, status: "deprecated", shutdown: "2027-02-26", note: "Only OpenAI model with word timestamps" }
     ];
+    ModelRetiredError = class extends Error {
+      constructor(message, model) {
+        super(message);
+        this.model = model;
+        this.name = "ModelRetiredError";
+      }
+    };
   }
 });
 
@@ -7842,12 +7909,18 @@ var init_http = __esm({
 // ../ai-providers/dist/gemini/GeminiProvider.js
 function resolveVeoModel(alias) {
   if (Object.hasOwn(VEO_MODEL_ALIASES, alias)) {
-    return VEO_MODEL_ALIASES[alias];
+    return servedVeoModel(VEO_MODEL_ALIASES[alias]);
   }
   const valid = Object.keys(VEO_MODEL_ALIASES).join(", ");
   const hint = alias === "3.0" ? " Veo 3.0 was shut down by Google on 2025-11-12." : "";
   throw new Error(`Unknown Veo model "${alias}". Valid: ${valid}.${hint}`);
 }
+function servedVeoModel(id) {
+  const spec = id ? findModel("veo", "video", id) : defaultModel("veo", "video");
+  if (spec)
+    assertModelServed(spec);
+  return spec?.id ?? id;
+}
 var VEO_MODEL_ALIASES, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
@@ -7891,7 +7964,7 @@ var init_GeminiProvider = __esm({
         }
         try {
           const veoOpts = options ?? {};
-          const model = veoOpts.model || "veo-3.1-fast-generate-preview";
+          const model = servedVeoModel(veoOpts.model);
           const aspectRatioMap = {
             "16:9": "16:9",
             "9:16": "9:16",
@@ -8068,7 +8141,7 @@ var init_GeminiProvider = __esm({
           };
         }
         try {
-          const model = options?.model || "veo-3.1-generate-preview";
+          const model = servedVeoModel(options?.model ?? findModel("veo", "video", "3.1")?.id);
           const instance = {
             video: { previousOperationName }
           };
@@ -18510,6 +18583,7 @@ __export(dist_exports2, {
   KlingProvider: () => KlingProvider,
   KokoroProvider: () => KokoroProvider,
   MODEL_CATALOG: () => MODEL_CATALOG,
+  ModelRetiredError: () => ModelRetiredError,
   OPENAI_IMAGE_DEFAULT_MODEL: () => OPENAI_IMAGE_DEFAULT_MODEL,
   OPENAI_TTS_VOICES: () => OPENAI_TTS_VOICES,
   OllamaProvider: () => OllamaProvider,
@@ -18521,6 +18595,7 @@ __export(dist_exports2, {
   RunwayProvider: () => RunwayProvider,
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
+  assertModelServed: () => assertModelServed,
   claudeProvider: () => claudeProvider,
   defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
@@ -18549,6 +18624,7 @@ __export(dist_exports2, {
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
   modelAliases: () => modelAliases,
+  modelLifecycle: () => modelLifecycle,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -36602,6 +36678,34 @@ var init_thumbnail = __esm({
   }
 });
 
+// src/utils/model-lifecycle.ts
+function videoModelSpec(provider, flags) {
+  const catalogProvider = provider === "fal" ? "seedance" : provider;
+  const flag = VIDEO_MODEL_FLAG[catalogProvider];
+  return findModel(catalogProvider, "video", flag ? flags[flag] : void 0);
+}
+function checkModelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec) return [];
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired") exitWithError(usageError(lifecycle.message));
+  return lifecycle.state === "retiring" ? [lifecycle.message] : [];
+}
+var VIDEO_MODEL_FLAG;
+var init_model_lifecycle = __esm({
+  "src/utils/model-lifecycle.ts"() {
+    "use strict";
+    init_dist2();
+    init_output();
+    VIDEO_MODEL_FLAG = {
+      seedance: "seedanceModel",
+      grok: "grokModel",
+      kling: "klingModel",
+      veo: "veoModel",
+      runway: "runwayModel"
+    };
+  }
+});
+
 // src/commands/generate/video-extend.ts
 import { resolve as resolve26 } from "node:path";
 import { writeFile as writeFile23 } from "node:fs/promises";
@@ -36613,11 +36717,22 @@ function registerVideoExtendCommand(parent) {
       if (options.output) {
         validateOutputPath(options.output);
       }
+      let lifecycleWarnings = [];
+      if (provider === "veo") {
+        try {
+          resolveVeoModel(options.veoModel);
+        } catch (err) {
+          exitWithError(usageError(err instanceof Error ? err.message : String(err)));
+        }
+        lifecycleWarnings = checkModelLifecycle(findModel("veo", "video", options.veoModel));
+        if (!options.dryRun) printWarnings(lifecycleWarnings);
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "generate video-extend",
           startedAt,
           dryRun: true,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               id,
@@ -36770,6 +36885,7 @@ function registerVideoExtendCommand(parent) {
           outputSuccess({
             command: "generate video-extend",
             startedAt,
+            warnings: lifecycleWarnings,
             data: {
               provider: "veo",
               taskId: result.id,
@@ -36818,6 +36934,7 @@ var init_video_extend = __esm({
     init_ora();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_output();
     init_validate();
     init_ai_helpers();
@@ -38528,6 +38645,8 @@ Examples:
       } catch (err) {
         exitWithError(usageError(err instanceof Error ? err.message : String(err)));
       }
+      const lifecycleWarnings = checkModelLifecycle(videoModelSpec(provider, options));
+      if (!options.dryRun) printWarnings(lifecycleWarnings);
       if (options.dryRun) {
         const costUsd = provider === "seedance" || provider === "fal" ? realRunCost(provider, options).costUsd : void 0;
         outputSuccess({
@@ -38535,6 +38654,7 @@ Examples:
           startedAt,
           dryRun: true,
           costUsd,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               prompt: prompt3,
@@ -38542,13 +38662,10 @@ Examples:
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
-              mode: options.mode,
+              mode: provider === "kling" ? options.mode : void 0,
               negative: options.negative,
               resolution: options.resolution,
-              veoModel: options.veoModel,
-              seedanceModel: options.seedanceModel,
-              grokModel: options.grokModel,
-              klingModel: options.klingModel,
+              model: videoModelSpec(provider, options)?.id,
               refImages: options.refImages,
               refVideos: options.refVideos,
               refAudio: options.refAudio,
@@ -38940,7 +39057,7 @@ Examples:
           command: "generate video",
           startedAt,
           costUsd: cost.costUsd,
-          warnings: provider === "veo" ? [VEO_SHUTDOWN_WARNING, ...cost.warnings] : cost.warnings,
+          warnings: [...lifecycleWarnings, ...cost.warnings],
           data: {
             provider,
             taskId: result?.id,
@@ -38952,9 +39069,6 @@ Examples:
         return;
       }
       console.log();
-      if (provider === "veo") {
-        console.log(source_default.yellow(VEO_SHUTDOWN_WARNING));
-      }
       if (finalResult.videoUrl) {
         console.log(`Video URL: ${finalResult.videoUrl}`);
       }
@@ -39079,7 +39193,6 @@ function printVideoStarted(providerLabel, taskId, taskType) {
   console.log(`Task ID: ${source_default.bold(taskId)}`);
   if (taskType) console.log(`Type: ${taskType}`);
 }
-var VEO_SHUTDOWN_WARNING;
 var init_video = __esm({
   "src/commands/generate/video.ts"() {
     "use strict";
@@ -39088,6 +39201,7 @@ var init_video = __esm({
     init_dist3();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_tty();
     init_output();
     init_validate();
@@ -39095,7 +39209,6 @@ var init_video = __esm({
     init_upload_host();
     init_ai_helpers();
     init_status_jobs();
-    VEO_SHUTDOWN_WARNING = "Veo 3.1 preview models shut down on 2026-10-22. Use `-p omni` (Gemini Omni 1.1 Flash) instead.";
   }
 });
 
@@ -39205,7 +39318,7 @@ Advanced:
   generate video-cancel Provider lifecycle control; poll with 'vibe status job <job-id> --json'
 
 API Keys (per provider):
-  GOOGLE_API_KEY     Image (default), Veo video
+  GOOGLE_API_KEY     Image (default), Omni video
   OPENAI_API_KEY     Image (-p openai)
   FAL_API_KEY        Seedance video (-p seedance, default video)
   XAI_API_KEY        Grok image/video
@@ -56227,6 +56340,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect scenes",
             startedAt,
@@ -56346,6 +56460,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect silence",
             startedAt,
@@ -56432,6 +56547,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect beats",
             startedAt,
@@ -70389,7 +70505,7 @@ var init_generate2 = __esm({
       cost: "high",
       title: "Generate Video",
       annotations: { readOnly: false, openWorld: true },
-      description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, and Veo. Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
+      description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, Gemini Omni, and Veo (shuts down 2026-10-22). Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
       schema: external_exports.object({
         prompt: external_exports.string().describe("Text prompt describing the video"),
         provider: external_exports.enum(["seedance", "grok", "kling", "runway", "veo", "omni"]).optional().describe(
@@ -73672,7 +73788,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.115.4",
+  version: "0.115.5",
   description: "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   private: false,
   license: "MIT",
@@ -74058,6 +74174,7 @@ timelineCommand.command("add-source").description("Add a media source to the tim
   const spinner2 = ora("Adding source...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-source",
         startedAt,
@@ -74122,6 +74239,7 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
     validateResourceId(sourceId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-clip",
         startedAt,
@@ -74202,6 +74320,7 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
   const spinner2 = ora("Adding track...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-track",
         startedAt,
@@ -74263,6 +74382,7 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-effect",
         startedAt,
@@ -74335,6 +74455,7 @@ timelineCommand.command("trim-clip").description("Trim a clip").argument("<proje
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline trim-clip",
         startedAt,
@@ -74502,6 +74623,7 @@ timelineCommand.command("split-clip").description("Split a clip at a specific ti
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline split-clip",
         startedAt,
@@ -74564,6 +74686,7 @@ timelineCommand.command("duplicate-clip").description("Duplicate a clip").argume
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline duplicate-clip",
         startedAt,
@@ -74623,6 +74746,7 @@ timelineCommand.command("delete-clip").description("Delete a clip from the timel
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline delete-clip",
         startedAt,
@@ -74676,6 +74800,7 @@ timelineCommand.command("move-clip").description("Move a clip to a new position"
     validateResourceId(clipId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline move-clip",
         startedAt,
@@ -80171,6 +80296,7 @@ batchCommand.command("import").description("Import multiple media files from a d
   const spinner2 = ora("Scanning directory...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch import",
         startedAt,
@@ -80248,6 +80374,7 @@ batchCommand.command("concat").description("Concatenate multiple sources into se
   const spinner2 = ora("Creating clips...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch concat",
         startedAt,
@@ -80326,6 +80453,7 @@ batchCommand.command("apply-effect").description("Apply an effect to multiple cl
     const spinner2 = ora("Applying effects...").start();
     try {
       if (options.dryRun) {
+        spinner2.stop();
         outputSuccess({
           command: "batch apply-effect",
           startedAt,
@@ -80397,6 +80525,7 @@ batchCommand.command("remove-clips").description("Remove multiple clips from the
   const spinner2 = ora("Removing clips...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch remove-clips",
         startedAt,
@@ -80459,7 +80588,9 @@ batchCommand.command("info").description("Show batch processing statistics").arg
     const tracks = project.getTracks();
     const summary = project.getSummary();
     spinner2.stop();
-    console.log(source_default.bold("\nProject Statistics\n"));
+    console.log(`
+${source_default.bold("Project Statistics")}
+`);
     const videoSources = sources.filter((s) => s.type === "video").length;
     const audioSources = sources.filter((s) => s.type === "audio").length;
     const imageSources = sources.filter((s) => s.type === "image").length;
@@ -80853,7 +80984,7 @@ var AI_FEATURES = [
     label: "Videos",
     desc: "generate + extend",
     defaultProvider: "Seedance 2.0 via fal.ai (Artificial Analysis #2 t2v + i2v, since v0.57)",
-    alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Google Veo",
+    alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Gemini Omni",
     keyHint: "1-2 keys",
     keys: [
       {
@@ -80932,16 +81063,16 @@ var AI_FEATURES = [
         defaultFor: { kind: "video", value: "runway" }
       },
       {
-        label: "Veo",
-        desc: "Google Veo video generation",
+        label: "Gemini Omni",
+        desc: "Google Gemini Omni video generation",
         key: {
           configKey: "google",
           envVar: "GOOGLE_API_KEY",
           name: "Google",
           url: "https://aistudio.google.com/apikey",
-          what: "Google Veo video generation"
+          what: "Google Gemini Omni video generation"
         },
-        defaultFor: { kind: "video", value: "veo" }
+        defaultFor: { kind: "video", value: "omni" }
       }
     ],
     tryCommand: 'vibe generate video "ocean waves" -o waves.mp4'
@@ -82475,7 +82606,7 @@ var AGENTS_MD = `# AGENTS.md
 
 This project uses [VibeFrame](https://github.com/vericontext/vibeframe) -
 a CLI for AI video generation on the user's own provider keys (Seedance,
-Runway, Veo, Kling), behind dry runs and a hard \`--max-cost\` ceiling.
+Runway, Kling, Gemini Omni), behind dry runs and a hard \`--max-cost\` ceiling.
 The \`vibe\` command provides 80+ subcommands for video generation,
 editing, and analysis. Cost tiers below - **always confirm with the user
 before running High / Very High tier commands**.
@@ -82800,7 +82931,7 @@ function renderEnvExample(opts = {}) {
 ${fallback2}# \u2500\u2500 LLM provider / optional \`vibe agent\` fallback (pick one) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 ANTHROPIC_API_KEY=                    # Claude - recommended default
 OPENAI_API_KEY=                       # GPT-5.4 mini \xB7 Whisper \xB7 gpt-image-2.5
-GOOGLE_API_KEY=                       # Gemini \xB7 Veo
+GOOGLE_API_KEY=                       # Gemini \xB7 Omni video
 XAI_API_KEY=                          # Grok image+video
 OPENROUTER_API_KEY=                   # multiplexes any provider above
 # OLLAMA_HOST=http://localhost:11434  # offline, no key needed
@@ -87654,7 +87785,8 @@ program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI
       process.stderr.write(JSON.stringify(err, null, 2) + "\n");
     } else {
       write2(source_default.red(str.trim()) + "\n");
-      write2(source_default.dim("Run with --help for full options.\n"));
+      write2(`${source_default.dim("Run with --help for full options.")}
+`);
     }
   }
 }).configureHelp({
@@ -87807,7 +87939,8 @@ function propagateErrorHandling(cmd) {
           process.stderr.write(JSON.stringify(err, null, 2) + "\n");
         } else {
           write2(source_default.red(str.trim()) + "\n");
-          write2(source_default.dim("Run with --help for full options.\n"));
+          write2(`${source_default.dim("Run with --help for full options.")}
+`);
         }
       }
     });

package/dist/tools/manifest/index.js

@@ -201,8 +201,8 @@ var init_api_keys = __esm({
       envVar: "GOOGLE_API_KEY",
       label: "Google",
       showInSetup: true,
-      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)",
-      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Veo video)",
+      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Omni video ($$)",
+      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Omni video)",
       envExampleUrl: "https://aistudio.google.com/apikey",
       keyFormat: { prefix: /^AIza/, example: "AIza..." }
     });
@@ -456,10 +456,35 @@ function findModel(provider, kind, aliasOrId) {
   const lower = key.toLowerCase();
   return listModels({ provider, kind }).find((m) => m.id === key || m.aliases?.includes(lower));
 }
+function modelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec.shutdown)
+    return { state: "served" };
+  const remainingMs = Date.parse(`${spec.shutdown}T00:00:00Z`) - now.getTime();
+  const instead = spec.replacement ? ` Use ${spec.replacement} instead.` : "";
+  if (remainingMs <= 0) {
+    return {
+      state: "retired",
+      shutdown: spec.shutdown,
+      message: `${spec.label} (${spec.id}) was shut down by the provider on ${spec.shutdown}.${instead}`
+    };
+  }
+  const daysLeft = Math.ceil(remainingMs / 864e5);
+  return {
+    state: "retiring",
+    shutdown: spec.shutdown,
+    daysLeft,
+    message: `${spec.label} (${spec.id}) shuts down on ${spec.shutdown} (${daysLeft} day${daysLeft === 1 ? "" : "s"} left).${instead}`
+  };
+}
+function assertModelServed(spec, now = /* @__PURE__ */ new Date()) {
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired")
+    throw new ModelRetiredError(lifecycle.message, spec);
+}
 function modelAliases(provider, kind) {
   return listModels({ provider, kind }).flatMap((m) => m.aliases ?? []);
 }
-var MODEL_CATALOG;
+var MODEL_CATALOG, ModelRetiredError;
 var init_catalog = __esm({
   "../ai-providers/dist/catalog/catalog.js"() {
     "use strict";
@@ -495,8 +520,8 @@ var init_catalog = __esm({
       { id: "seedance-2.0-fast", provider: "seedance", kind: "video", label: "Seedance 2.0 Fast", aliases: ["fast"], status: "ga", price: { usd: 0.2419, per: "second", basis: "720p 16:9" }, note: "4-15 s, up to 720p, native audio" },
       { id: "seedance-2.5", provider: "seedance", kind: "video", label: "Seedance 2.5", aliases: ["2.5"], status: "ga", price: { usd: 0.473, per: "second", basis: "720p 16:9" }, note: "Opt-in; 4-30 s, native audio" },
       { id: "gemini-omni-1.1-flash", provider: "omni", kind: "video", label: "Gemini Omni 1.1 Flash", default: true, status: "ga", price: { usd: 0.1, per: "second", basis: "720p" }, note: "Google video default; the model picks 3-10 s; native audio" },
-      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
-      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
       { id: "grok-imagine-video-1.5", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5", aliases: ["1.5"], default: true, status: "ga", price: { usd: 0.14, per: "second", basis: "720p" }, note: "1-15 s, native audio; 720p unless `--resolution` says otherwise" },
       { id: "grok-imagine-video-1.5-lite", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5 Lite", aliases: ["lite", "1.5-lite"], status: "ga", price: { usd: 0.03, per: "second", basis: "720p" }, note: "1-15 s, native audio" },
       { id: "grok-imagine-video", provider: "grok", kind: "video", label: "Grok Imagine Video", aliases: ["classic"], status: "legacy", price: { usd: 0.05, per: "second", basis: "480p" }, note: "Previous generation" },
@@ -512,6 +537,13 @@ var init_catalog = __esm({
       { id: "eleven_text_to_sound_v2", provider: "elevenlabs", kind: "sound-effect", label: "ElevenLabs Sound Effects v2", default: true, status: "ga", price: { usd: 0.12, per: "minute" }, note: "0.5-30 s" },
       { id: "whisper-1", provider: "openai", kind: "transcription", label: "Whisper", default: true, status: "deprecated", shutdown: "2027-02-26", note: "Only OpenAI model with word timestamps" }
     ];
+    ModelRetiredError = class extends Error {
+      constructor(message, model) {
+        super(message);
+        this.model = model;
+        this.name = "ModelRetiredError";
+      }
+    };
   }
 });
 
@@ -1059,12 +1091,18 @@ var init_http = __esm({
 // ../ai-providers/dist/gemini/GeminiProvider.js
 function resolveVeoModel(alias) {
   if (Object.hasOwn(VEO_MODEL_ALIASES, alias)) {
-    return VEO_MODEL_ALIASES[alias];
+    return servedVeoModel(VEO_MODEL_ALIASES[alias]);
   }
   const valid = Object.keys(VEO_MODEL_ALIASES).join(", ");
   const hint = alias === "3.0" ? " Veo 3.0 was shut down by Google on 2025-11-12." : "";
   throw new Error(`Unknown Veo model "${alias}". Valid: ${valid}.${hint}`);
 }
+function servedVeoModel(id) {
+  const spec = id ? findModel("veo", "video", id) : defaultModel("veo", "video");
+  if (spec)
+    assertModelServed(spec);
+  return spec?.id ?? id;
+}
 var VEO_MODEL_ALIASES, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
@@ -1108,7 +1146,7 @@ var init_GeminiProvider = __esm({
         }
         try {
           const veoOpts = options ?? {};
-          const model = veoOpts.model || "veo-3.1-fast-generate-preview";
+          const model = servedVeoModel(veoOpts.model);
           const aspectRatioMap = {
             "16:9": "16:9",
             "9:16": "9:16",
@@ -1285,7 +1323,7 @@ var init_GeminiProvider = __esm({
           };
         }
         try {
-          const model = options?.model || "veo-3.1-generate-preview";
+          const model = servedVeoModel(options?.model ?? findModel("veo", "video", "3.1")?.id);
           const instance = {
             video: { previousOperationName }
           };
@@ -11727,6 +11765,7 @@ __export(dist_exports2, {
   KlingProvider: () => KlingProvider,
   KokoroProvider: () => KokoroProvider,
   MODEL_CATALOG: () => MODEL_CATALOG,
+  ModelRetiredError: () => ModelRetiredError,
   OPENAI_IMAGE_DEFAULT_MODEL: () => OPENAI_IMAGE_DEFAULT_MODEL,
   OPENAI_TTS_VOICES: () => OPENAI_TTS_VOICES,
   OllamaProvider: () => OllamaProvider,
@@ -11738,6 +11777,7 @@ __export(dist_exports2, {
   RunwayProvider: () => RunwayProvider,
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
+  assertModelServed: () => assertModelServed,
   claudeProvider: () => claudeProvider,
   defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
@@ -11766,6 +11806,7 @@ __export(dist_exports2, {
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
   modelAliases: () => modelAliases,
+  modelLifecycle: () => modelLifecycle,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -30473,8 +30514,43 @@ function outputSuccess(opts) {
     const data = opts.data;
     const primary = data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id;
     if (primary !== void 0) console.log(String(primary));
+    return;
+  }
+  if (opts.dryRun && !opts.humanRendered) {
+    printDryRunSummary(opts.command, costUsd, opts.data, opts.warnings ?? []);
+  }
+}
+function printWarnings(warnings) {
+  if (isJsonMode()) return;
+  for (const warning of warnings) {
+    process.stderr.write(`${source_default.yellow(`Warning: ${warning}`)}
+`);
   }
 }
+function formatDryRunValue(value) {
+  const text = Array.isArray(value) ? value.map((v) => formatDryRunValue(v)).join(", ") : typeof value === "object" ? JSON.stringify(value) : String(value);
+  return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+}
+function printDryRunSummary(command, costUsd, data, warnings) {
+  const params = data.params && typeof data.params === "object" ? data.params : data;
+  const rows = [
+    ["cost", costUsd > 0 ? `up to $${costUsd.toFixed(2)} (estimate)` : "free"]
+  ];
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0 || value === null || value === "") continue;
+    if (Array.isArray(value) && value.length === 0) continue;
+    rows.push([key, formatDryRunValue(value)]);
+  }
+  const width = Math.max(...rows.map(([key]) => key.length));
+  console.log();
+  console.log(`${source_default.bold.cyan(`Dry run: vibe ${command}`)} ${source_default.dim("(nothing was sent)")}`);
+  for (const [key, value] of rows) {
+    console.log(`  ${source_default.dim(key.padEnd(width))}  ${value}`);
+  }
+  printWarnings(warnings);
+  console.log(source_default.dim("  Run again without --dry-run to execute."));
+  console.log();
+}
 function log(...args) {
   if (!isJsonMode() && !isQuietMode()) {
     console.log(...args);
@@ -44079,6 +44155,34 @@ var init_thumbnail = __esm({
   }
 });
 
+// src/utils/model-lifecycle.ts
+function videoModelSpec(provider, flags) {
+  const catalogProvider = provider === "fal" ? "seedance" : provider;
+  const flag = VIDEO_MODEL_FLAG[catalogProvider];
+  return findModel(catalogProvider, "video", flag ? flags[flag] : void 0);
+}
+function checkModelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec) return [];
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired") exitWithError(usageError(lifecycle.message));
+  return lifecycle.state === "retiring" ? [lifecycle.message] : [];
+}
+var VIDEO_MODEL_FLAG;
+var init_model_lifecycle = __esm({
+  "src/utils/model-lifecycle.ts"() {
+    "use strict";
+    init_dist2();
+    init_output();
+    VIDEO_MODEL_FLAG = {
+      seedance: "seedanceModel",
+      grok: "grokModel",
+      kling: "klingModel",
+      veo: "veoModel",
+      runway: "runwayModel"
+    };
+  }
+});
+
 // src/commands/generate/video-extend.ts
 import { resolve as resolve48 } from "node:path";
 import { writeFile as writeFile34 } from "node:fs/promises";
@@ -44090,11 +44194,22 @@ function registerVideoExtendCommand(parent) {
       if (options.output) {
         validateOutputPath(options.output);
       }
+      let lifecycleWarnings = [];
+      if (provider === "veo") {
+        try {
+          resolveVeoModel(options.veoModel);
+        } catch (err) {
+          exitWithError(usageError(err instanceof Error ? err.message : String(err)));
+        }
+        lifecycleWarnings = checkModelLifecycle(findModel("veo", "video", options.veoModel));
+        if (!options.dryRun) printWarnings(lifecycleWarnings);
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "generate video-extend",
           startedAt,
           dryRun: true,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               id,
@@ -44247,6 +44362,7 @@ function registerVideoExtendCommand(parent) {
           outputSuccess({
             command: "generate video-extend",
             startedAt,
+            warnings: lifecycleWarnings,
             data: {
               provider: "veo",
               taskId: result.id,
@@ -44295,6 +44411,7 @@ var init_video_extend = __esm({
     init_ora();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_output();
     init_validate();
     init_ai_helpers();
@@ -46005,6 +46122,8 @@ Examples:
       } catch (err) {
         exitWithError(usageError(err instanceof Error ? err.message : String(err)));
       }
+      const lifecycleWarnings = checkModelLifecycle(videoModelSpec(provider, options));
+      if (!options.dryRun) printWarnings(lifecycleWarnings);
       if (options.dryRun) {
         const costUsd = provider === "seedance" || provider === "fal" ? realRunCost(provider, options).costUsd : void 0;
         outputSuccess({
@@ -46012,6 +46131,7 @@ Examples:
           startedAt,
           dryRun: true,
           costUsd,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               prompt: prompt3,
@@ -46019,13 +46139,10 @@ Examples:
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
-              mode: options.mode,
+              mode: provider === "kling" ? options.mode : void 0,
               negative: options.negative,
               resolution: options.resolution,
-              veoModel: options.veoModel,
-              seedanceModel: options.seedanceModel,
-              grokModel: options.grokModel,
-              klingModel: options.klingModel,
+              model: videoModelSpec(provider, options)?.id,
               refImages: options.refImages,
               refVideos: options.refVideos,
               refAudio: options.refAudio,
@@ -46417,7 +46534,7 @@ Examples:
           command: "generate video",
           startedAt,
           costUsd: cost.costUsd,
-          warnings: provider === "veo" ? [VEO_SHUTDOWN_WARNING, ...cost.warnings] : cost.warnings,
+          warnings: [...lifecycleWarnings, ...cost.warnings],
           data: {
             provider,
             taskId: result?.id,
@@ -46429,9 +46546,6 @@ Examples:
         return;
       }
       console.log();
-      if (provider === "veo") {
-        console.log(source_default.yellow(VEO_SHUTDOWN_WARNING));
-      }
       if (finalResult.videoUrl) {
         console.log(`Video URL: ${finalResult.videoUrl}`);
       }
@@ -46556,7 +46670,6 @@ function printVideoStarted(providerLabel, taskId, taskType) {
   console.log(`Task ID: ${source_default.bold(taskId)}`);
   if (taskType) console.log(`Type: ${taskType}`);
 }
-var VEO_SHUTDOWN_WARNING;
 var init_video = __esm({
   "src/commands/generate/video.ts"() {
     "use strict";
@@ -46565,6 +46678,7 @@ var init_video = __esm({
     init_dist3();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_tty();
     init_output();
     init_validate();
@@ -46572,7 +46686,6 @@ var init_video = __esm({
     init_upload_host();
     init_ai_helpers();
     init_status_jobs();
-    VEO_SHUTDOWN_WARNING = "Veo 3.1 preview models shut down on 2026-10-22. Use `-p omni` (Gemini Omni 1.1 Flash) instead.";
   }
 });
 
@@ -46682,7 +46795,7 @@ Advanced:
   generate video-cancel Provider lifecycle control; poll with 'vibe status job <job-id> --json'
 
 API Keys (per provider):
-  GOOGLE_API_KEY     Image (default), Veo video
+  GOOGLE_API_KEY     Image (default), Omni video
   OPENAI_API_KEY     Image (-p openai)
   FAL_API_KEY        Seedance video (-p seedance, default video)
   XAI_API_KEY        Grok image/video
@@ -47780,6 +47893,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect scenes",
             startedAt,
@@ -47899,6 +48013,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect silence",
             startedAt,
@@ -47985,6 +48100,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect beats",
             startedAt,
@@ -57720,7 +57836,7 @@ var generateVideoTool = defineTool({
   cost: "high",
   title: "Generate Video",
   annotations: { readOnly: false, openWorld: true },
-  description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, and Veo. Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
+  description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, Gemini Omni, and Veo (shuts down 2026-10-22). Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
   schema: external_exports.object({
     prompt: external_exports.string().describe("Text prompt describing the video"),
     provider: external_exports.enum(["seedance", "grok", "kling", "runway", "veo", "omni"]).optional().describe(

package/dist/tools/manifest/storyboard.d.ts

@@ -32,15 +32,15 @@ export declare const storyboardSetTool: import("../define-tool.js").ToolDefiniti
     jsonValue: z.ZodOptional<z.ZodBoolean>;
     unset: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    beat: string;
     key: string;
+    beat: string;
     value?: string | undefined;
     projectDir?: string | undefined;
     unset?: boolean | undefined;
     jsonValue?: boolean | undefined;
 }, {
-    beat: string;
     key: string;
+    beat: string;
     value?: string | undefined;
     projectDir?: string | undefined;
     unset?: boolean | undefined;

package/dist/utils/model-lifecycle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Model shutdown checks for commands that call a dated model.
+ *
+ * The catalog records each model's announced shutdown date. Commands check
+ * it before any dry run or paid request: a retiring model adds a warning to
+ * the dry run, the result, and stderr; a retired model is a usage error that
+ * names the replacement. Providers enforce the same rule on their own, so
+ * executors that skip this check still never call a retired model.
+ */
+import { type ModelSpec } from "@vibeframe/ai-providers";
+/** Model flags `generate video` reads, keyed by provider. */
+export interface VideoModelFlags {
+    seedanceModel?: string;
+    grokModel?: string;
+    klingModel?: string;
+    veoModel?: string;
+    runwayModel?: string;
+}
+/** The catalog model a video provider will call, given the command's model flags. */
+export declare function videoModelSpec(provider: string, flags: VideoModelFlags): ModelSpec | undefined;
+/**
+ * Exit with a usage error for a retired model; return the shutdown warning
+ * for a retiring one, for the caller's envelope and `printWarnings()`.
+ */
+export declare function checkModelLifecycle(spec: ModelSpec | undefined, now?: Date): string[];

package/dist/utils/model-lifecycle.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.115.4",
+  "version": "0.115.5",
   "description": "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   "private": false,
   "license": "MIT",
@@ -91,8 +91,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.115.4",
-    "@vibeframe/core": "0.115.4"
+    "@vibeframe/ai-providers": "0.115.5",
+    "@vibeframe/core": "0.115.5"
   },
   "engines": {
     "node": ">=20"