gflow-cli 0.27.0__tar.gz → 0.27.1__tar.gz

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.27.1] — 2026-07-07
+
+### Fixed
+
+- **Version Wiring in Movie Handoff:** Properly imported and passed `__version__` to `build_handoff()` generator version instead of using a hardcoded stale default (`0.14.0`).
+- **Rich Markup Escaping in CLI Output:** Escaped brackets in `_format_scene_line` plan output (`[t2v]`, `[r2v]`, and `refs=[...]`) so they are not swallowed by Rich console formatting.
+- **MCP Server Stale Version:** Wired FastMCP version to `__version__` dynamically on startup, fixing the stale `0.21.0` version trap.
+- **MCP Agent Guide:** Added `gflow_list_tools` to the list of available tools in the static MCP agent guide resource.
+
+### Added
+
+- **Document Anchors:** Added HTML anchor (`style-configuration-errors`) to `docs/MOVIE.md` for reserved name `"none"` and unknown style variant `ConfigurationError` paths.
+- **Movie Usages Documentation:** Added complete documentation for `gflow movie run` and `gflow movie template` commands to `docs/USAGE.md`.
+
 ## [0.27.0] — 2026-07-07
 
 ### Added
@@ -1830,7 +1844,8 @@ shell-script template that branches on these codes.
 
 First skeleton. Not functional end-to-end yet.
 
-[Unreleased]: https://github.com/ffroliva/gflow-cli/compare/v0.27.0...HEAD
+[Unreleased]: https://github.com/ffroliva/gflow-cli/compare/v0.27.1...HEAD
+[0.27.1]: https://github.com/ffroliva/gflow-cli/compare/v0.27.0...v0.27.1
 [0.27.0]: https://github.com/ffroliva/gflow-cli/compare/v0.26.0...v0.27.0
 [0.26.0]: https://github.com/ffroliva/gflow-cli/compare/v0.25.0...v0.26.0
 [0.25.0]: https://github.com/ffroliva/gflow-cli/compare/v0.24.0...v0.25.0

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gflow-cli
-Version: 0.27.0
+Version: 0.27.1
 Summary: Unofficial CLI for Google Flow — drive Veo image-to-video generations from the terminal.
 Project-URL: Homepage, https://github.com/ffroliva/gflow-cli
 Project-URL: Issues, https://github.com/ffroliva/gflow-cli/issues

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/docs/INDEX.md

@@ -120,7 +120,7 @@ Slash commands for Claude Code, stored in `.claude/commands/gflow/`. All prefixe
 **"A gflow command hangs / fails — where do I start?"** → [DEBUGGING § Quick reference](DEBUGGING.md#quick-reference)
 **"Flow's UI broke a selector — how do I diagnose it?"** → [DEBUGGING § Inspecting Flow's live UI](DEBUGGING.md#inspecting-flows-live-ui)
 **"What does each `ui_automation.*` log event mean?"** → [DEBUGGING § Listener & HTTP-layer debugging](DEBUGGING.md#listener--http-layer-debugging)
-**"What was actually live-verified for the latest release?"** → latest: [LIVE_VERIFICATION_v0.27.0](LIVE_VERIFICATION_v0.27.0.md) (**`[style]` block with named variants + prompt-aware resume — credit-free CLI verification**: real `movie run --dry-run` 3-way ledger proving resolved-style display, `skip (done)` on matching `style_hash`, and `re-run (style changed)` after a style edit; composition is local, wire path untouched, so no Veo credits spent — first credited styled run will confirm visually). Prior: [v0.26.0](LIVE_VERIFICATION_v0.26.0.md) (**image i2i by generated-image UUID proven live e2e GREEN** — the existing asset is *selected in place* by its media UUID, no duplicate upload, producing an i2i output that references it; plus generated-image `display_name` capture, credited @C1ph3r404). Prior: [v0.25.0](LIVE_VERIFICATION_v0.25.0.md) (**#237 remote-UUID i2v proven live e2e GREEN** — a real 8s 720×1280 interpolation from a generated image's UUID, after the picker-search attach was reworked to local upload; #240 home-`.env` matrix live; plus two silent-failure guards root-caused live: video-as-image download rejection and rejected-upload fail-loud). Prior: [v0.24.0](LIVE_VERIFICATION_v0.24.0.md) (--project parity across CLI + MCP — automated coverage; live gen auth-gated). Prior: [v0.23.0](LIVE_VERIFICATION_v0.23.0.md) (MCP generation wiring proven live end-to-end — tool→worker→real Flow REST→structured-error translation; final image-write blocked by an expired session, environmental. #222 macOS fix reporter-verified e2e on Apple Silicon). Prior: [v0.22.0](LIVE_VERIFICATION_v0.22.0.md) (Tools framework — automated/CI coverage complete; credit/key-gated live feature run is a pending owner gate, see the doc) · [v0.21.0](LIVE_VERIFICATION_v0.21.0.md) (MCP server over stdio + HTTP/SSE — credit-free protocol handshake; 4 tools / 2 prompts / 3 resources confirmed on stdout) · [v0.20.1](LIVE_VERIFICATION_v0.20.1.md) · [v0.20.0](LIVE_VERIFICATION_v0.20.0.md) · [v0.19.0](LIVE_VERIFICATION_v0.19.0.md) · [v0.18.0](LIVE_VERIFICATION_v0.18.0.md) · [v0.17.0](LIVE_VERIFICATION_v0.17.0.md) · [v0.16.0](LIVE_VERIFICATION_v0.16.0.md) · [v0.13.0](LIVE_VERIFICATION_v0.13.0.md) · [v0.12.0](LIVE_VERIFICATION_v0.12.0.md) · [v0.11.0](LIVE_VERIFICATION_v0.11.0.md) · [v0.10.0](LIVE_VERIFICATION_v0.10.0.md) · [v0.9.1](LIVE_VERIFICATION_v0.9.1.md) · [v0.9.0](LIVE_VERIFICATION_v0.9.0.md) · [v0.8.1](LIVE_VERIFICATION_v0.8.1.md) · [v0.7.0](LIVE_VERIFICATION_v0.7.0.md)
+**"What was actually live-verified for the latest release?"** → latest: [LIVE_VERIFICATION_v0.27.1](LIVE_VERIFICATION_v0.27.1.md) (**v0.27.0 release follow-up fixes and documentation sync**). Prior: [v0.27.0](LIVE_VERIFICATION_v0.27.0.md) (**`[style]` block with named variants + prompt-aware resume — credit-free CLI verification**: real `movie run --dry-run` 3-way ledger proving resolved-style display, `skip (done)` on matching `style_hash`, and `re-run (style changed)` after a style edit; composition is local, wire path untouched, so no Veo credits spent — first credited styled run will confirm visually). Prior: [v0.26.0](LIVE_VERIFICATION_v0.26.0.md) (**image i2i by generated-image UUID proven live e2e GREEN** — the existing asset is *selected in place* by its media UUID, no duplicate upload, producing an i2i output that references it; plus generated-image `display_name` capture, credited @C1ph3r404). Prior: [v0.25.0](LIVE_VERIFICATION_v0.25.0.md) (**#237 remote-UUID i2v proven live e2e GREEN** — a real 8s 720×1280 interpolation from a generated image's UUID, after the picker-search attach was reworked to local upload; #240 home-`.env` matrix live; plus two silent-failure guards root-caused live: video-as-image download rejection and rejected-upload fail-loud). Prior: [v0.24.0](LIVE_VERIFICATION_v0.24.0.md) (--project parity across CLI + MCP — automated coverage; live gen auth-gated). Prior: [v0.23.0](LIVE_VERIFICATION_v0.23.0.md) (MCP generation wiring proven live end-to-end — tool→worker→real Flow REST→structured-error translation; final image-write blocked by an expired session, environmental. #222 macOS fix reporter-verified e2e on Apple Silicon). Prior: [v0.22.0](LIVE_VERIFICATION_v0.22.0.md) (Tools framework — automated/CI coverage complete; credit/key-gated live feature run is a pending owner gate, see the doc) · [v0.21.0](LIVE_VERIFICATION_v0.21.0.md) (MCP server over stdio + HTTP/SSE — credit-free protocol handshake; 4 tools / 2 prompts / 3 resources confirmed on stdout) · [v0.20.1](LIVE_VERIFICATION_v0.20.1.md) · [v0.20.0](LIVE_VERIFICATION_v0.20.0.md) · [v0.19.0](LIVE_VERIFICATION_v0.19.0.md) · [v0.18.0](LIVE_VERIFICATION_v0.18.0.md) · [v0.17.0](LIVE_VERIFICATION_v0.17.0.md) · [v0.16.0](LIVE_VERIFICATION_v0.16.0.md) · [v0.13.0](LIVE_VERIFICATION_v0.13.0.md) · [v0.12.0](LIVE_VERIFICATION_v0.12.0.md) · [v0.11.0](LIVE_VERIFICATION_v0.11.0.md) · [v0.10.0](LIVE_VERIFICATION_v0.10.0.md) · [v0.9.1](LIVE_VERIFICATION_v0.9.1.md) · [v0.9.0](LIVE_VERIFICATION_v0.9.0.md) · [v0.8.1](LIVE_VERIFICATION_v0.8.1.md) · [v0.7.0](LIVE_VERIFICATION_v0.7.0.md)
 **"Where is the reverse-engineered wire protocol for a feature?"** → the `*_RECON.md` design docs: [CHARACTER_RECON](CHARACTER_RECON.md) (Flow character entity protocol), [IMAGE_UPSCALE_RECON](IMAGE_UPSCALE_RECON.md) (`/v1/flow/upsampleImage` wire). Naming convention: one `<FEATURE>_RECON.md` per reverse-engineered surface, kept as the durable spec after the feature ships.
 **"What was live-verified for the data layer (PR #58)?"** → [LIVE_VERIFICATION_data_layer](LIVE_VERIFICATION_data_layer.md) — 1 Imagen + 1 Veo credit on denon82, 6-layer ledger (file + magic + Pillow + DB rows + CLI round-trip + structlog)
 **"What was live-verified for the video-download feature (#29)?"** → [LIVE_VERIFICATION_video_download](LIVE_VERIFICATION_video_download.md)

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/docs/LIVE_VERIFICATION_v0.27.0.md

@@ -87,7 +87,14 @@ before PR #259; cosmetic; tracked as a follow-up.
 
 ## Post-tag evidence
 
-*(filled after the v0.27.0 tag push / publish)*
+- Signed tag `v0.27.0` pushed 2026-07-07; `Release` workflow green
+  (build-and-publish 37s, digital attestations generated).
+- GitHub Release **v0.27.0** published 2026-07-07T21:16:40Z (not draft).
+- PyPI: `gflow-cli 0.27.0` live — `gflow_cli-0.27.0-py3-none-any.whl` +
+  `gflow_cli-0.27.0.tar.gz` (verified via the PyPI JSON API).
+- Release PR #260 (`chore/release-v0.27.0 → main`) merged with a merge commit
+  after a fully green matrix + SonarCloud gate; branch deleted.
+- `main` back-merged into `develop` (`2909cb6`) — branches aligned.
 
 ## Automated coverage
 

gflow_cli-0.27.1/docs/LIVE_VERIFICATION_v0.27.1.md

@@ -0,0 +1,26 @@
+# Live Verification — v0.27.1
+
+Release date: 2026-07-07. Headline: **v0.27.0 release follow-up fixes and documentation sync** (Issue #239, PR #261).
+
+Verification run: 2026-07-07, local validation gates, Windows, `.venv` build of the release tree. **Deliberately credit-free**: this patch release contains only default parameter wiring, Rich console escaping, MCP guide documentation synchronization, and user documentation. No live Flow REST api/browser automation code paths were changed, so no live generation credits were spent.
+
+## Scope
+
+| Change | Surface | Verdict |
+|---|---|---|
+| Wire package version `__version__` as default `version` in `build_handoff()` | `composition.py` | ✅ Unit tests pass (`test_build_handoff_shape_and_schema`) |
+| Escape brackets `\[` in plan output mode and refs | `cli_movie.py` | ✅ Unit tests pass (`test_format_scene_line_escapes_brackets_for_rich`) |
+| Add `gflow_list_tools` to MCP agent guide | `mcp/resources.py` | ✅ MCP guide resource updated |
+| Set `__version__` on FastMCP server on startup | `mcp/server.py` | ✅ MCP tests pass |
+| Add HTML anchors for style configuration errors | `docs/MOVIE.md` | ✅ Document checked via `check_doc_links.py` |
+| Add `gflow movie` subcommands documentation | `docs/USAGE.md` | ✅ USAGE.md updated and link-checked |
+
+## Evidence ledger (Verification Gates)
+
+All local quality gates executed in order as a merge-readiness baseline:
+1. **Hygiene check:** `check_repo_hygiene.py` ran with 0 violations across 505 tracked files.
+2. **Internal links check:** `check_doc_links.py` successfully resolved all internal markdown links across 24 files (including `docs/MOVIE.md` and `docs/USAGE.md`).
+3. **Lint check:** `ruff check src tests` passed with 0 errors.
+4. **Formatting check:** `ruff format --check src tests` verified all files are formatted.
+5. **Type check:** `pyright src` completed with 0 errors and 0 warnings.
+6. **Tests run:** 2056 tests passed, 16 skipped, 55 deselected.

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/docs/MOVIE.md

@@ -101,8 +101,12 @@ Per-scene selection:
 | *(omitted)* | Uses the base `[style]` suffix. |
 | `style_suffix = "sunset light"` | Scene-specific text appended **after** the variant/base suffix. |
 
-`none` is a **reserved name**: defining `[style.variants.none]` is a
-configuration error, so the opt-out keyword can never shadow a real variant.
+<a name="style-configuration-errors"></a>
+### Style Configuration Errors
+
+There are two style configuration errors that will raise a `ConfigurationError`:
+* **Reserved `none` name:** Defining `[style.variants.none]` is a configuration error, so the opt-out keyword can never shadow a real variant.
+* **Unknown variant name:** Specifying a `style_variant` in a scene that does not exist in `[style.variants]` (and is not `"none"`) is a configuration error.
 
 **Composition rule** (deterministic, no LLM):
 

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/docs/PROJECT_STATUS.md

@@ -4,6 +4,12 @@
 
 ## Current release
 
+**v0.27.1 — alpha.** **v0.27.0 release follow-up fixes and documentation sync (#239).** Patch release wiring package version dynamically to `build_handoff()` and `FastMCP` server, escaping brackets in Rich console planning output, updating MCP agent guide, and adding `gflow movie` usage documentation. Verification: [LIVE_VERIFICATION_v0.27.1](LIVE_VERIFICATION_v0.27.1.md) (credit-free baseline verification).
+
+**Develop (unreleased, post-v0.27.1):** *(empty — develop is the staging branch for the next release).*
+
+<details><summary>v0.27.0 — Global [style] block with named variants + prompt-aware resume for gflow movie</summary>
+
 **v0.27.0 — alpha.** **Global `[style]` block with named variants + prompt-aware resume
 for `gflow movie` (#239).** A `movie.toml` can now express a visual style system once —
 `prefix`/`suffix` on `[style]` plus `[style.variants.*]` sub-tables — and select it
@@ -15,7 +21,7 @@ instead of silently skipped, and dry-run marks it `re-run (style changed)`. Carr
 forward v0.26.0 (i2i select-in-place by UUID). Verification:
 [LIVE_VERIFICATION_v0.27.0](LIVE_VERIFICATION_v0.27.0.md) (credit-free CLI ledger).
 
-**Develop (unreleased, post-v0.27.0):** *(empty — develop is the staging branch for the next release).*
+</details>
 
 <details><summary>v0.26.0 — image i2i references a generated image by UUID (select in place)</summary>
 

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/docs/USAGE.md

@@ -1044,6 +1044,84 @@ GFLOW_EXAMPLE_PROFILE=<your-profile> python examples/batch_from_config.py
 
 The bundled `examples/sample_config.json` produces three images at three aspect ratios in `gflow-output/example-batch/`. Copy and edit for your own scenes.
 
+## `gflow movie`
+
+Sequential TOML-described multi-scene AI movie generation. New in v0.14.0.
+
+### `gflow movie template`
+
+Writes a starter `movie.toml` template.
+
+```text
+gflow movie template [OUTPUT] [--force]
+```
+
+* `OUTPUT`: The destination path for the template file (defaults to `./movie.toml`).
+* `--force`: Overwrite the destination file if it already exists.
+
+### `gflow movie run`
+
+Generates individual video clips sequentially from a single TOML manifest file, maintaining crash-recoverable state in a local state JSON file.
+
+```text
+gflow movie run MANIFEST [--out-dir DIR] [--profile NAME] [--continue-on-error|--fail-fast] [--dry-run] [--stitch]
+```
+
+Refer to the complete [Movie Manifests Guide](MOVIE.md) for detailed syntax, character entity creation, and style consistency features.
+
+### Parameters
+
+* `MANIFEST`: Path to your `movie.toml` manifest file (required positional argument).
+* `--out-dir DIR`: Output directory for generated video clips and the handoff file. Defaults to `out/` or `GFLOW_CLI_OUTPUT_DIR`.
+* `--profile NAME`: Specify Google Flow profile to use.
+* `--continue-on-error`: Skip failed scenes and continue generating subsequent scenes (default).
+* `--fail-fast`: Terminate immediately on the first failed scene generation.
+* `--dry-run`: Parse the manifest, estimate credits, and print the generation plan without calling Google Flow.
+* `--stitch`: Run a post-generation preview stitch using ffmpeg to concatenate clips into a single video file.
+
+### Manifest structure (movie.toml)
+
+```toml
+title = "My Cinematic Film"
+project = "Cinematics"
+
+[style]
+look = "3d animation"
+mood = "mysterious"
+negative = "text, watermark"
+prefix = "Cinematic film still, high detail."
+suffix = "Shot on IMAX 70mm, unreal engine 5 render."
+
+[style.variants.warm]
+suffix = "Golden hour light, warm color grading."
+
+[[characters]]
+name = "Stickman"
+identity = "text"
+voice = "alnilam"
+
+[[scenes]]
+id = "scene_01"
+action = "A mysterious stickman walks slowly through a dark forest."
+framing = "wide"
+duration = 5
+characters = ["Stickman"]
+
+[[scenes]]
+id = "scene_02"
+action = "Close up of the stickman looking back in shock."
+framing = "close-up"
+duration = 5
+characters = ["Stickman"]
+style_variant = "warm"
+```
+
+### Outputs
+
+1. **Clip Files:** Individual video files saved under `<out_dir>/scene_<id>.mp4` (or other formats).
+2. **State File:** A `<stem>-state.json` file recording completed operations, seeds, and metadata, allowing a run to resume without wasting credits.
+3. **Handoff Manifest:** A `<stem>-handoff.json` file that projects the run's metadata and clip paths, designed for downstream assemblers.
+
 ## Recipes
 
 ### Burn through a directory of inputs

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gflow-cli"
-version = "0.27.0"
+version = "0.27.1"
 description = "Unofficial CLI for Google Flow — drive Veo image-to-video generations from the terminal."
 readme = "README.md"
 license = { file = "LICENSE" }

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/scripts/ci/check_doc_links.py

@@ -40,6 +40,8 @@ FILES: tuple[str, ...] = (
     "docs/USER_GUIDE.md",
     "docs/LIVE_VERIFICATION_v0.8.1.md",
     "docs/CHARACTER.md",
+    "docs/MOVIE.md",
+    "docs/LIVE_VERIFICATION_v0.27.1.md",
 )
 
 # [text](target) — non-greedy text, balanced target (no nested parens).

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/src/gflow_cli/__init__.py

@@ -1,3 +1,3 @@
 """gflow-cli — unofficial CLI for Google Flow."""
 
-__version__ = "0.27.0"
+__version__ = "0.27.1"

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/src/gflow_cli/cli_movie.py

@@ -285,7 +285,7 @@ def _style_tag(s: Scene, style: StyleSpec) -> str:
 def _format_scene_line(s: Scene, style: StyleSpec, *, done: bool, stale: bool, cost: int) -> str:
     """Return the single-line plan summary for one scene."""
     mode = "r2v" if s.characters else "t2v"
-    refs = f"  refs=[{', '.join(s.characters)}]" if s.characters else ""
+    refs = f"  refs=\\[{', '.join(s.characters)}]" if s.characters else ""
     framing_tag = f"  {s.framing}" if s.framing else ""
     model_tag = f"  {s.model}" if s.model else ""
     dur_tag = f"  {s.duration}s" if s.duration else ""
@@ -296,7 +296,7 @@ def _format_scene_line(s: Scene, style: StyleSpec, *, done: bool, stale: bool, c
     else:
         status = f"{cost} credit(s)"
     style_tag = _style_tag(s, style)
-    return f"    [{mode}] {s.id!r}{framing_tag}{model_tag}{dur_tag}{refs}{style_tag}  {status}"
+    return f"    \\[{mode}] {s.id!r}{framing_tag}{model_tag}{dur_tag}{refs}{style_tag}  {status}"
 
 
 def _print_plan(manifest: MovieManifest, state: MovieState) -> None:

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/src/gflow_cli/composition.py

@@ -14,6 +14,8 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, cast
 
+from gflow_cli import __version__
+
 
 @dataclass(frozen=True)
 class StyleSpec:
@@ -367,7 +369,7 @@ def build_handoff(
     state: Any,
     *,
     out_dir: Path,
-    version: str = "0.14.0",
+    version: str = __version__,
     include_prompts: bool = True,
 ) -> dict[str, Any]:
     """Project a completed/partial movie run into the versioned handoff manifest.

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/src/gflow_cli/mcp/resources.py

@@ -58,6 +58,9 @@ Browse the local project catalog.
 ### gflow_list_characters
 Browse reusable Flow Character entities.
 
+### gflow_list_tools
+List available gflow prompt tools (name, title, description, category).
+
 ## Important Rules
 1. **Use tools, not shell commands.** Do NOT run `gflow image t2i ...` via the terminal.
 2. **One generation at a time.** The rate limiter allows bursts of 8 but throttles sustained use.

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/src/gflow_cli/mcp/server.py

@@ -17,6 +17,8 @@ from typing import TYPE_CHECKING
 import structlog
 from mcp.server.fastmcp import FastMCP
 
+from gflow_cli import __version__
+
 if TYPE_CHECKING:
     pass
 
@@ -27,11 +29,14 @@ log = structlog.get_logger()
 # ---------------------------------------------------------------------------
 
 _SERVER_NAME = "gflow-cli"
-_SERVER_VERSION = "0.21.0"
+_SERVER_VERSION = __version__
 
 server = FastMCP(
     name=_SERVER_NAME,
 )
+# FastMCP does not expose a public API to configure the server version.
+# As a workaround, we assign it directly to the underlying Server instance.
+server._mcp_server.version = _SERVER_VERSION  # pyright: ignore[reportPrivateUsage]
 
 # ---------------------------------------------------------------------------
 # Stdout isolation

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/tests/cli/test_cli_movie.py

@@ -904,3 +904,21 @@ class TestEntityIdentity:
         assert create_mock.call_args.kwargs["body"] is not None
         # Entity id was persisted to state for downstream scene resolution.
         assert state.characters["Hero"].entity_id == "ent-new"
+
+
+class TestFormatSceneLine:
+    def test_format_scene_line_escapes_brackets_for_rich(self) -> None:
+        from gflow_cli.cli_movie import _format_scene_line
+        from gflow_cli.composition import Scene, StyleSpec
+
+        # T2V scene (no characters)
+        s1 = Scene(id="s1", action="A", framing="medium", duration=4)
+        line = _format_scene_line(s1, StyleSpec(), done=False, stale=False, cost=2)
+        assert "\\[t2v]" in line
+        assert "refs=" not in line
+
+        # R2V scene (with characters)
+        s2 = Scene(id="s2", action="B", framing="wide", duration=8, characters=("Hero",))
+        line2 = _format_scene_line(s2, StyleSpec(), done=False, stale=False, cost=2)
+        assert "\\[r2v]" in line2
+        assert "refs=\\[Hero]" in line2

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/tests/composition/test_handoff.py

@@ -7,6 +7,7 @@ from pathlib import Path
 
 import jsonschema
 
+from gflow_cli import __version__
 from gflow_cli.composition import Character, Scene, StyleSpec, build_handoff
 from gflow_cli.movie_manifest import CharacterState, MovieState, SceneState
 
@@ -38,6 +39,8 @@ def _fake_state() -> MovieState:
 def test_build_handoff_shape_and_schema(tmp_path: Path) -> None:
     handoff = build_handoff(_FakeManifest(), _fake_state(), out_dir=Path("/out/x"))
     assert handoff["schema_version"] == 1
+    assert handoff["generator"]["name"] == "gflow-cli"
+    assert handoff["generator"]["version"] == __version__
     assert handoff["clips"][0]["index"] == 0
     assert handoff["clips"][0]["id"] == "s1"
     # relative POSIX path, no backslashes, no signed-url leak

{gflow_cli-0.27.0 → gflow_cli-0.27.1}/uv.lock

@@ -787,7 +787,7 @@ wheels = [
 
 [[package]]
 name = "gflow-cli"
-version = "0.27.0"
+version = "0.27.1"
 source = { editable = "." }
 dependencies = [
     { name = "browser-cookie3" },