@growthub/cli 0.3.54 → 0.3.55

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/generation-batch-plan.md

@@ -0,0 +1,70 @@
+# Generation Batch Plan
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Date | `YYYY-MM-DD` |
+
+## Execution Order
+
+Batches run top-to-bottom. Items within a batch can run in parallel.
+
+### Batch 1 — Research & Script
+
+| Step | Tool / Action | Input | Output | Depends On |
+|---|---|---|---|---|
+| 1.1 | Web search | Topic keywords | Research brief | — |
+| 1.2 | Script draft | Research brief | Script | 1.1 |
+
+### Batch 2 — Image Generation
+
+| Step | Provider / CMS Node | Prompt Ref | Input Assets | Expected Output | Est. Cost |
+|---|---|---|---|---|---|
+| 2.1 | | Scene 1 prompt | — | Scene 1 image | |
+| 2.2 | | Scene 2 prompt | — | Scene 2 image | |
+| 2.3 | | Scene 3 prompt | — | Scene 3 image | |
+
+### Batch 3 — Video Generation (if applicable)
+
+| Step | Provider / CMS Node | Prompt Ref | Source Image | Duration | Est. Cost |
+|---|---|---|---|---|---|
+| 3.1 | | Scene 1 video prompt | Scene 1 image | 5s | |
+| 3.2 | | Scene 2 video prompt | Scene 2 image | 5s | |
+
+### Batch 4 — Audio
+
+| Step | Provider | Type | Input | Duration | Est. Cost |
+|---|---|---|---|---|---|
+| 4.1 | | TTS narration | Script | — | |
+| 4.2 | | Background music | Genre/mood spec | — | |
+
+### Batch 5 — Composition & Post-Production
+
+| Step | Tool | Input | Output | Depends On |
+|---|---|---|---|---|
+| 5.1 | Remotion / FFmpeg | All scene assets + audio | Draft render | Batches 2-4 |
+| 5.2 | Subtitle gen | TTS audio | SRT/VTT | 4.1 |
+| 5.3 | FFmpeg | Draft render + subtitles | Final render | 5.1, 5.2 |
+
+## Cost Summary
+
+| Batch | Estimated Cost |
+|---|---|
+| Batch 1 (Research) | $0.00 |
+| Batch 2 (Images) | $— |
+| Batch 3 (Video) | $— |
+| Batch 4 (Audio) | $— |
+| Batch 5 (Post) | $0.00 |
+| **Total** | **$—** |
+
+## Budget Gate
+
+| Field | Value |
+|---|---|
+| Budget cap | $10.00 |
+| Estimated total | $— |
+| Approved | `<yes / pending>` |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/pipeline-selection-brief.md

@@ -0,0 +1,67 @@
+# Pipeline Selection Brief
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Date | `YYYY-MM-DD` |
+
+## Requested Outcome
+
+<!-- What the user asked for in their own words. -->
+
+## Selected Pipeline
+
+| Field | Value |
+|---|---|
+| Pipeline | `<Animated Explainer / Animation / Avatar Spokesperson / Cinematic / Clip Factory / Documentary Montage / Hybrid / Localization & Dub / Podcast Repurpose / Screen Demo / Talking Head>` |
+| Reason | <!-- Why this pipeline is the best match --> |
+
+## Pipeline Fit Assessment
+
+| Criterion | Score (1-5) | Notes |
+|---|---|---|
+| Content type match | | |
+| Available tool coverage | | |
+| Source asset alignment | | |
+| Budget feasibility | | |
+| Quality ceiling | | |
+
+## Input Asset Requirements
+
+<!-- What the selected pipeline needs to execute. -->
+
+## Output Specification
+
+| Field | Value |
+|---|---|
+| Primary deliverable | |
+| Duration | |
+| Resolution | |
+| Codec | |
+
+## Fallback Pipeline
+
+| Field | Value |
+|---|---|
+| Pipeline | `<fallback-pipeline>` |
+| Trigger | <!-- When to switch --> |
+| Trade-off | <!-- What changes with the fallback --> |
+
+## Pipeline Stage Plan
+
+```
+research → proposal → script → scene_plan → assets → edit → compose
+```
+
+| Stage | Owner | Tool / CMS Node | Notes |
+|---|---|---|---|
+| Research | Agent | Web search | |
+| Proposal | Agent | — | |
+| Script | Agent | — | |
+| Scene plan | Agent | — | |
+| Assets | Agent + Provider | `<tool-or-cms-node>` | |
+| Edit | Agent | FFmpeg / Remotion | |
+| Compose | Agent | Remotion / FFmpeg | |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/platform-ready-execution-handoff.md

@@ -0,0 +1,103 @@
+# Platform-Ready Execution Handoff
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Execution mode | `<local-fork / agent-only / hybrid>` |
+| Date | `YYYY-MM-DD` |
+
+## Deliverable Summary
+
+| Field | Value |
+|---|---|
+| Video title | |
+| Duration | `<seconds>` |
+| Resolution | `<WxH>` |
+| Aspect ratio | `<ratio>` |
+| Platform target | `<YouTube / TikTok / Instagram / LinkedIn>` |
+| Estimated cost | `$—` |
+| Actual cost | `$—` |
+
+## Execution Instructions
+
+### For local-fork mode
+
+```bash
+cd ~/OpenMontage
+
+# 1. Verify environment
+python -c "from tools.tool_registry import registry; registry.discover(); print('OK')"
+
+# 2. Run the pipeline
+# The agent executes each stage in order:
+#   research → proposal → script → scene_plan → assets → edit → compose
+
+# 3. Final render location
+# Output: output/<project-slug>/final-render.<ext>
+```
+
+### For agent-only mode (CMS node generation)
+
+1. Execute CMS nodes via GrowthHub hosted execution:
+
+| Step | CMS Node Slug | Inputs | Expected Output |
+|---|---|---|---|
+| 1 | | | |
+| 2 | | | |
+
+2. Collect output URLs from CMS node execution results
+3. Follow post-production guidance below
+
+### For hybrid mode
+
+1. Generate assets via CMS nodes (see agent-only instructions above)
+2. Run local OpenMontage post-production:
+
+```bash
+cd ~/OpenMontage
+# Composition, audio mixing, subtitle burn-in, color grading
+# Use the scene plan and prompt matrix from this handoff
+```
+
+## Asset Manifest
+
+| ID | Type | Source | URL / Path | Status |
+|---|---|---|---|---|
+| | | | | |
+
+## Post-Production Steps
+
+| Step | Tool | Input | Output | Notes |
+|---|---|---|---|---|
+| 1 | Remotion / FFmpeg | Scene assets | Draft composition | |
+| 2 | Subtitle gen | Narration audio | SRT/VTT file | |
+| 3 | FFmpeg | Draft + subtitles | Subtitled render | |
+| 4 | FFmpeg | Subtitled render | Color-graded final | Optional |
+
+## Render Profile
+
+| Field | Value |
+|---|---|
+| Resolution | |
+| FPS | |
+| Codec | |
+| Bitrate | |
+| Audio codec | |
+| Container | |
+
+## Known Limitations
+
+<!-- Any manual steps, unsupported features, or quality compromises. -->
+
+## Approval
+
+| Gate | Status |
+|---|---|
+| Production brief approved | `<yes / no>` |
+| Budget approved | `<yes / no>` |
+| QA checklist passed | `<yes / no>` |
+| Ready for execution | `<yes / no>` |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/prompt-matrix.md

@@ -0,0 +1,48 @@
+# Prompt Matrix
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Date | `YYYY-MM-DD` |
+
+## Image Generation Prompts
+
+| Scene | Provider / CMS Node | Model | Prompt | Style Directive | Aspect Ratio | Negative Prompt | Expected Cost |
+|---|---|---|---|---|---|---|---|
+| 1 | | | | | | | |
+| 2 | | | | | | | |
+| 3 | | | | | | | |
+
+## Video Generation Prompts
+
+| Scene | Provider / CMS Node | Model | Prompt | Source Image | Duration | Camera Motion | Expected Cost |
+|---|---|---|---|---|---|---|---|
+| 1 | | | | | | | |
+| 2 | | | | | | | |
+
+## TTS Prompts
+
+| Scene | Provider | Voice | Text | Speed | Emotion | Expected Cost |
+|---|---|---|---|---|---|---|
+| 1 | | | | | | |
+| 2 | | | | | | |
+
+## Music Prompts
+
+| Track | Provider | Genre | Mood | Duration | Instrumental | Expected Cost |
+|---|---|---|---|---|---|---|
+| BG | | | | | | |
+
+## Style Consistency Rules
+
+<!-- Global style directives that apply across all prompts. -->
+
+- Base style: `<photorealistic / illustrated / anime / flat motion / minimalist>`
+- Color palette: `<description or hex values>`
+- Typography: `<font family, weight, treatment>`
+- Lighting: `<natural / studio / cinematic / neon>`
+- Consistency anchor: `<reference image URL or description>`

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/provider-selection-brief.md

@@ -0,0 +1,86 @@
+# Provider / CMS Node Selection Brief
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Date | `YYYY-MM-DD` |
+
+## Available Providers
+
+### Direct API Providers (from .env)
+
+| Provider | Key Set | Capabilities |
+|---|---|---|
+| fal.ai | `<yes/no>` | FLUX images, Kling/Veo/MiniMax video, Recraft |
+| OpenAI | `<yes/no>` | DALL-E 3 images, OpenAI TTS |
+| Google | `<yes/no>` | Google TTS (700+ voices), Imagen images |
+| ElevenLabs | `<yes/no>` | Premium TTS, music, SFX |
+| Runway | `<yes/no>` | Gen-4 video |
+| Higgsfield | `<yes/no>` | Multi-model video orchestrator |
+| xAI Grok | `<yes/no>` | Image + video generation |
+| HeyGen | `<yes/no>` | Avatar videos |
+| Suno | `<yes/no>` | AI music generation |
+
+### CMS Node Providers (from GrowthHub)
+
+| CMS Node Slug | Family | Execution Kind | Available |
+|---|---|---|---|
+| | | | |
+
+### Local/Free Providers (always available)
+
+| Provider | Capability |
+|---|---|
+| Piper TTS | Offline narration |
+| Remotion | Programmatic video composition |
+| FFmpeg | Encoding, subtitles, audio mixing |
+| Archive.org | Free archival footage |
+| Pexels / Pixabay / Unsplash | Free stock media (if keys set) |
+
+## Provider Selection Per Stage
+
+| Stage | Selected Provider | Score | Alternative | Cost Estimate |
+|---|---|---|---|---|
+| Image generation | | | | |
+| Video generation | | | | |
+| TTS / narration | | | | |
+| Music | | | | |
+| Composition | | | | |
+| Post-production | | | | |
+
+## 7-Dimension Scoring (Primary Provider)
+
+| Dimension | Weight | Score (1-10) | Weighted |
+|---|---|---|---|
+| Task fit | 30% | | |
+| Output quality | 20% | | |
+| Control features | 15% | | |
+| Reliability | 15% | | |
+| Cost efficiency | 10% | | |
+| Latency | 5% | | |
+| Continuity | 5% | | |
+| **Total** | **100%** | | **—** |
+
+## Cost Estimate
+
+| Category | Provider | Unit Cost | Quantity | Subtotal |
+|---|---|---|---|---|
+| Images | | | | |
+| Video clips | | | | |
+| TTS | | | | |
+| Music | | | | |
+| CMS nodes | GrowthHub billing | — | | — |
+| **Total** | | | | **$—** |
+
+## Budget Gate
+
+| Field | Value |
+|---|---|
+| Per-action threshold | $0.50 |
+| Total budget cap | $10.00 |
+| Estimated total | $— |
+| Within budget | `<yes / no>` |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/review-qa-checklist.md

@@ -0,0 +1,59 @@
+# Review QA Checklist
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Date | `YYYY-MM-DD` |
+
+## Pre-Compose Validation
+
+- [ ] All scene assets exist and are accessible (URLs resolve, files present)
+- [ ] Asset resolutions match the target render profile
+- [ ] Audio tracks are present and duration-matched to scene plan
+- [ ] Subtitle timing is aligned to narration word boundaries
+- [ ] Delivery promise is achievable with available tools
+- [ ] Budget is within approved cap
+- [ ] No placeholder or draft assets remain in the batch plan
+
+## Composition Review
+
+- [ ] Scene order matches scene plan
+- [ ] Transitions render correctly (no black frames, no jumps)
+- [ ] Audio levels are consistent across scenes (no clipping, no drops)
+- [ ] Subtitles are readable against all backgrounds
+- [ ] Lower thirds and overlays are positioned correctly
+- [ ] Opening and closing frames are intentional (no abrupt start/end)
+
+## Post-Render Self-Review
+
+- [ ] ffprobe validation: codec, resolution, duration, bitrate match spec
+- [ ] Frame extraction: first, middle, last, and transition frames look correct
+- [ ] Audio analysis: consistent levels, no silence gaps, no clipping
+- [ ] Subtitle check: timing accuracy, no overlapping text
+- [ ] Platform compliance: aspect ratio, duration, file size within limits
+
+## Slideshow Risk Assessment (image-based video only)
+
+| Dimension | Score (1-10) | Notes |
+|---|---|---|
+| Motion variety | | |
+| Transition diversity | | |
+| Animation layer count | | |
+| Audio-visual sync | | |
+| Pacing variation | | |
+| Visual grammar complexity | | |
+| **Average** | **—** | Minimum 6.0 to proceed |
+
+## Final Sign-Off
+
+| Gate | Status | Reviewer |
+|---|---|---|
+| Pre-compose | `<pass / fail>` | |
+| Composition | `<pass / fail>` | |
+| Post-render | `<pass / fail>` | |
+| Slideshow risk (if applicable) | `<pass / fail / n/a>` | |
+| **Overall** | `<approved / blocked>` | |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/scene-plan.md

@@ -0,0 +1,65 @@
+# Scene Plan
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Pipeline | `<selected-pipeline>` |
+| Total duration | `<seconds>` |
+| Scene count | `<N>` |
+
+## Scenes
+
+### Scene 1 — `<scene-title>`
+
+| Field | Value |
+|---|---|
+| Duration | `<seconds>` |
+| Start time | `0:00` |
+| Visual type | `<AI-generated / stock footage / screen recording / text card / data viz>` |
+| Camera motion | `<static / pan / zoom / Ken Burns / parallax>` |
+| Transition in | `<cut / crossfade / wipe / zoom>` |
+| Transition out | `<cut / crossfade / wipe / zoom>` |
+| Audio | `<narration / music / SFX / silent>` |
+| Narration text | <!-- Script line for this scene --> |
+| Visual prompt | <!-- Image or video generation prompt --> |
+| Provider / CMS node | `<provider-name or cms-node-slug>` |
+| Overlay | `<subtitles / lower-third / data overlay / none>` |
+
+<!-- Copy this block for each additional scene -->
+
+### Scene 2 — `<scene-title>`
+
+| Field | Value |
+|---|---|
+| Duration | `<seconds>` |
+| Start time | `<M:SS>` |
+| Visual type | |
+| Camera motion | |
+| Transition in | |
+| Transition out | |
+| Audio | |
+| Narration text | |
+| Visual prompt | |
+| Provider / CMS node | |
+| Overlay | |
+
+## Audio Timeline
+
+| Track | Source | Start | End | Notes |
+|---|---|---|---|---|
+| Narration | `<TTS provider>` | 0:00 | — | |
+| Background music | `<music provider>` | 0:00 | — | |
+| SFX | `<source>` | — | — | |
+
+## Render Profile
+
+| Field | Value |
+|---|---|
+| Resolution | `<1920x1080>` |
+| Aspect ratio | `<16:9>` |
+| FPS | `<30>` |
+| Codec | `<H.264>` |
+| Platform | `<YouTube / TikTok / Instagram>` |

package/assets/worker-kits/growthub-open-montage-studio-v1/templates/video-production-brief.md

@@ -0,0 +1,58 @@
+# Video Production Brief
+
+## Project
+
+| Field | Value |
+|---|---|
+| Client | `<client-name>` |
+| Project | `<project-name>` |
+| Date | `YYYY-MM-DD` |
+| Operator | Open Montage Studio Operator |
+
+## Objective
+
+<!-- What is the video for? Who is the audience? What action should the viewer take? -->
+
+## Format
+
+| Field | Value |
+|---|---|
+| Duration target | `<seconds>` |
+| Aspect ratio | `<16:9 / 9:16 / 1:1 / 21:9>` |
+| Resolution | `<1920x1080 / 1080x1920 / 3840x2160>` |
+| Platform | `<YouTube / TikTok / Instagram / LinkedIn / Web>` |
+
+## Content Summary
+
+<!-- 2-3 sentence summary of what the video will contain. -->
+
+## Tone and Style
+
+<!-- Visual style, mood, pacing, reference videos if any. -->
+
+## Source Assets
+
+| Asset | Status | Notes |
+|---|---|---|
+| Brand kit | `<available / missing>` | |
+| Reference video | `<available / missing>` | |
+| Source footage | `<available / missing>` | |
+| Product images | `<available / missing>` | |
+| Audio / voiceover | `<available / missing>` | |
+| Script | `<available / to-generate>` | |
+
+## CMS Node Availability
+
+| CMS Node Family | Available | Notes |
+|---|---|---|
+| Video generation | `<yes / no>` | |
+| Image generation | `<yes / no>` | |
+| Text generation | `<yes / no>` | |
+
+## Constraints
+
+<!-- Budget cap, timeline, brand guidelines, compliance requirements. -->
+
+## Success Criteria
+
+<!-- What does "done" look like? Specific deliverables and quality bars. -->

package/assets/worker-kits/growthub-open-montage-studio-v1/validation-checklist.md

@@ -0,0 +1,46 @@
+# Validation Checklist — Open Montage Studio
+
+Run through this checklist before your first generation session.
+
+---
+
+## Environment Validation
+
+- [ ] `.env` file exists (copied from `.env.example`)
+- [ ] At least one provider key is set OR GrowthHub session is active OR zero-key mode is acceptable
+- [ ] `skills.md` is readable from the working directory
+- [ ] `workers/open-montage-studio-operator/CLAUDE.md` is readable
+
+## Local-Fork Validation (skip if agent-only mode)
+
+- [ ] Python 3.10+ installed: `python3 --version`
+- [ ] FFmpeg installed: `ffmpeg -version`
+- [ ] Node.js 18+ installed: `node --version`
+- [ ] OpenMontage clone exists at `$OPENMONTAGE_PATH` (default `~/OpenMontage`)
+- [ ] OpenMontage setup completed: `cd ~/OpenMontage && python -c "from tools.tool_registry import registry; registry.discover(); print('OK')"`
+- [ ] Remotion dependencies installed: `cd ~/OpenMontage/remotion-composer && node -e "require('remotion')"`
+
+## CMS Node Validation (skip if local-fork only)
+
+- [ ] GrowthHub session is active: `growthub auth:status`
+- [ ] CMS capability registry returns nodes: agent queries for `video` and `image` family nodes
+- [ ] At least one generation node is available and enabled
+
+## Brand Kit Validation
+
+- [ ] Brand kit exists in `brands/<client-slug>/brand-kit.md`
+- [ ] Brand identity section is complete
+- [ ] Visual identity section has color values
+- [ ] Tone of voice section is filled
+
+## Provider Key Validation
+
+Run `node setup/verify-env.mjs` to check which providers are configured:
+
+- [ ] Script exits 0 (at least one provider or zero-key mode acknowledged)
+- [ ] Configured providers match the intended production plan
+
+## Output Directory
+
+- [ ] `output/` directory exists and is writable
+- [ ] No stale output from a previous session that could conflict