@vibeframe/cli 0.96.4 → 0.98.0

package/CONTEXT.md

@@ -104,15 +104,26 @@ export IMGBB_API_KEY="..."         # Local image upload (Seedance image-to-video
 
 ## Mental model
 
-The **project** is the implicit area. Bare top-level commands act on
-the current project; grouped commands handle resources or one-shot
-operations.
+The **storyboard project** is the primary product lane. `STORYBOARD.md`
+and `DESIGN.md` are the source of truth; generated files under
+`compositions/` are artifacts. Use `vibe storyboard *` for narrow cue
+edits and direct Markdown edits for larger creative rewrites. Use
+`vibe inspect project`, `vibe inspect render --cheap`, and `vibe scene repair`
+for deterministic local review and mechanical composition fixes. Semantic
+creative fixes belong to the host agent.
 
 ```
-init → build → render          # 90% users start here   (Tier 1 — project flow)
-gen / edit / inspect / remix    # one-shot media tools   (Tier 2)
-scene / timeline                # lower-level authoring  (Tier 3)
-run / agent / schema / context  # automation + agents    (Tier 4)
+init --from → storyboard validate → plan → build → inspect → render  # storyboard-to-video
+generate / edit / inspect / remix                          # one-shot media tools
+scene / timeline                                            # lower-level authoring
+run / agent / schema / context                              # automation + agents
+```
+
+Provider precedence for project builds:
+
+```
+CLI flag → per-beat STORYBOARD.md cue → vibe.config.json →
+legacy vibe.project.yaml → configured/env default → VibeFrame default
 ```
 
 ## Per-group invariants
@@ -121,7 +132,7 @@ run / agent / schema / context  # automation + agents    (Tier 4)
 |-------|----------|
 | `generate` | Always `--dry-run` first. Costs money. `-p` selects provider; default routes via key availability. |
 | `edit` | FFmpeg-only leaves (silence-cut, fade, noise-reduce, text-overlay, interpolate) are free. caption/grade/reframe/image need API keys. |
-| `inspect` | Read-only Gemini calls. Low cost. `--fields response,model` keeps responses small. |
+| `inspect` | `inspect project` and `inspect render --cheap` are free/local. Gemini media/review calls are low cost. |
 | `audio` | `transcribe` low cost (Whisper). `dub` is full pipeline (medium-high). `duck` is free. |
 | `remix` | **Confirm with user.** Multi-step, high cost ($5–50+). Always `--dry-run`. |
 | `detect` | Free, FFmpeg only. No keys. |
@@ -143,11 +154,16 @@ vibe generate music "mood description" -o bgm.mp3 -d 10 --json
 ### Project flow (canonical)
 
 ```bash
-vibe init my-video --visual-style "Swiss Pulse" --json
+vibe init my-video --from "45-second launch video" --visual-style "Swiss Pulse" --json
 # edit my-video/STORYBOARD.md, my-video/DESIGN.md
-vibe build my-video --dry-run --json
-vibe build my-video --json
+vibe storyboard validate my-video --json
+vibe plan my-video --json
+vibe build my-video --dry-run --max-cost 5 --json
+vibe build my-video --max-cost 5 --json
+vibe inspect project my-video --json
 vibe render my-video -o renders/final.mp4 --json
+vibe inspect render my-video --cheap --json
+vibe scene repair --project my-video --json
 ```
 
 ### Lower-level timeline (NLE-style)