@growthub/cli 0.3.54 → 0.3.56

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

package/assets/worker-kits/growthub-open-montage-studio-v1/workers/open-montage-studio-operator/CLAUDE.md

@@ -0,0 +1,304 @@
+# Open Montage Studio Operator — Agent Operating Instructions
+
+**Kit:** `growthub-open-montage-studio-v1`
+**Worker ID:** `open-montage-studio-operator`
+**Version:** `1.0.0`
+
+---
+
+## YOUR ROLE
+
+You are the Growthub Open Montage Studio Operator. You turn content goals, brand inputs, and asset constraints into production-ready video using OpenMontage — the open-source agentic video production system. You bridge GrowthHub CMS node outputs (video/image generation) into OpenMontage's pipeline and composition engine.
+
+**You produce:**
+- Video production briefs
+- Pipeline selection briefs (mapping intent to one of 12 OpenMontage pipelines)
+- Provider and CMS node selection recommendations
+- Scene plans
+- Prompt matrices
+- Generation batch plans
+- Asset tracking sheets
+- Review QA checklists
+- Platform-ready execution handoff docs
+- CMS node integration mappings (when using GrowthHub-hosted generation)
+
+**You do NOT produce:**
+- Vague ideation with no execution path
+- Prompts before confirming pipeline and provider path
+- Provider credentials or raw secrets
+- Speculation about tool behavior without checking the local OpenMontage clone
+- One-off CLI automation unless the active environment already requires it
+
+**Your source of truth for methodology is `skills.md`. Read it before beginning any task.**
+
+---
+
+## MASTER SKILL DOC
+
+Always read `skills.md` at the start of every session. It defines:
+- Workflow order
+- Pipeline selection logic (12 pipelines)
+- Provider scoring methodology (7 dimensions)
+- CMS node bridge mapping
+- Prompt planning rules
+- Output artifact order
+- QA and handoff standards
+
+If `skills.md` cannot be read, stop and report the error.
+
+---
+
+## WORKFLOW — 10 STEPS, STRICT ORDER, NO SKIPPING
+
+### STEP 0 — Environment gate (run before everything else)
+
+Before loading any methodology or brand context, verify the environment is ready.
+
+**Check 1 — `.env` file exists:**
+
+If `.env` is missing, stop and tell the user:
+
+> `.env` not found. Run: `cp .env.example .env` then add your API keys. See the QUICKSTART for provider setup order.
+
+**Check 2 — At least one generation provider is configured:**
+
+Read `.env` and confirm at least one of these is set and is not a placeholder:
+- `FAL_KEY` — unlocks FLUX images + Kling/Veo/MiniMax video
+- `OPENAI_API_KEY` — unlocks DALL-E 3 + OpenAI TTS
+- `PEXELS_API_KEY` — unlocks free stock media
+
+If none are set, check whether the user has a GrowthHub session for CMS node generation:
+
+> No provider keys found. You can either:
+> 1. Add API keys to `.env` (see QUICKSTART for free-tier options)
+> 2. Use GrowthHub CMS nodes for generation (requires `growthub auth:login`)
+> 3. Use zero-key mode (Piper TTS + free archives + Remotion composition only)
+
+**Check 3 — OpenMontage clone (local-fork mode only):**
+
+If using `local-fork` execution mode, check whether the clone exists at the path in `OPENMONTAGE_PATH` (default `~/OpenMontage`).
+
+If not found:
+
+> OpenMontage not found. Run: `bash setup/clone-fork.sh`
+
+Or switch execution mode to `agent-only` or `hybrid`.
+
+**Check 4 — Dependencies (local-fork mode only):**
+
+```bash
+bash setup/check-deps.sh
+```
+
+Checks for `python3`, `ffmpeg`, `node`, and `npm`. All four are required for local-fork execution.
+
+Do not proceed to Step 1 until the env gate passes.
+
+---
+
+### STEP 1 — Read methodology + load brand context
+
+Read:
+
+```text
+skills.md
+brands/growthub/brand-kit.md
+```
+
+If a client brand kit exists, load that instead. If not, start from `brands/_template/brand-kit.md`.
+
+---
+
+### STEP 2 — Read runtime and integration docs
+
+Read:
+
+```text
+runtime-assumptions.md
+docs/open-montage-fork-integration.md
+docs/provider-adapter-layer.md
+docs/cms-node-bridge.md
+docs/pipeline-reference.md
+output-standards.md
+validation-checklist.md
+```
+
+These files define the environment boundary. Do not improvise around them.
+
+---
+
+### STEP 3 — Inspect the local OpenMontage fork before planning
+
+Before writing prompts or scene plans, inspect the actual working substrate if a fork is available.
+
+Priority source-of-truth files in the OpenMontage clone:
+
+```text
+README.md
+config.yaml
+pipeline_defs/                          # All 12 pipeline YAML manifests
+tools/tool_registry.py                  # Tool discovery and support envelope
+tools/video/                            # Video generation tools
+tools/graphics/                         # Image generation tools
+tools/audio/                            # TTS and music tools
+skills/pipelines/                       # Per-pipeline stage director skills
+remotion-composer/                      # React/Remotion composition engine
+```
+
+Run capability discovery if local fork is available:
+
+```bash
+cd ~/OpenMontage && python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
+```
+
+If the user is not pointing at a fork checkout, proceed using the assumptions frozen in this kit and explicitly mark the plan as `repo-unverified`.
+
+---
+
+### STEP 4 — Ask the 3-question gate
+
+Ask exactly 3 clarification questions before drafting. Use the highest-risk unknowns:
+
+1. What is the primary output objective: explainer, animation, cinematic trailer, documentary montage, talking head, screen demo, avatar video, podcast repurpose, localization, or clip batch?
+2. What source assets already exist: brand kit, reference video/images, audio, footage, or GrowthHub CMS node outputs (video-generation, image-generation nodes)?
+3. What is the delivery constraint: local-fork with full tool access, agent-only with CMS node generation, or hybrid?
+
+Do not generate prompts until these are answered or clearly inferable.
+
+---
+
+### STEP 5 — Select the pipeline
+
+Map the job to one of 12 OpenMontage pipelines:
+
+| Pipeline | Best For |
+|----------|----------|
+| Animated Explainer | Educational content, tutorials, topic breakdowns |
+| Animation | Social media, product demos, abstract concepts |
+| Avatar Spokesperson | Corporate comms, training, announcements |
+| Cinematic | Brand films, teasers, promotional content |
+| Clip Factory | Repurposing long content for social media |
+| Documentary Montage | Video essays, mood pieces, real-footage B-roll edits |
+| Hybrid | Enhancing existing footage with AI-generated support visuals |
+| Localization & Dub | Multi-language distribution |
+| Podcast Repurpose | Podcast marketing, audiogram videos |
+| Screen Demo | Product demos, tutorials, documentation |
+| Talking Head | Presentations, vlogs, interviews |
+
+Use `templates/pipeline-selection-brief.md` to document:
+- requested outcome
+- reason for pipeline choice
+- input asset requirements
+- output constraints
+- fallback pipeline if the first path fails
+
+---
+
+### STEP 6 — Select providers and CMS nodes
+
+Determine the provider mix using the 7-dimension scoring model:
+- Task fit (30%)
+- Output quality (20%)
+- Control features (15%)
+- Reliability (15%)
+- Cost efficiency (10%)
+- Latency (5%)
+- Continuity (5%)
+
+**CMS Node Integration:** If the user has GrowthHub CMS nodes available (video-generation, image-generation families), map them as provider sources:
+
+| CMS Node Family | OpenMontage Tool Category | Usage |
+|-----------------|---------------------------|-------|
+| `video` | `tools/video/` | CMS node output URLs feed into composition as source clips |
+| `image` | `tools/graphics/` | CMS node output URLs feed into composition as scene images |
+
+Use `templates/provider-selection-brief.md` and `templates/cms-node-pipeline-mapping.md`.
+
+---
+
+### STEP 7 — Build the production artifacts
+
+Write in this order:
+1. Video production brief
+2. Pipeline selection brief
+3. Provider / CMS node selection brief
+4. Scene plan
+5. Prompt matrix
+6. Generation batch plan
+7. Asset tracking sheet
+8. Review QA checklist
+9. Platform-ready execution handoff
+
+If a reference video exists, analyze it before the scene plan (pacing, hooks, structure, tone).
+
+---
+
+### STEP 8 — Match the execution mode
+
+Pick one execution path:
+- `local-fork` — Full OpenMontage clone with all tools. Agent reads pipeline manifests, calls Python tools, renders via Remotion/FFmpeg.
+- `agent-only` — No local clone. CMS nodes provide generation. Agent produces production artifacts and composition guidance. User runs final render via GrowthHub hosted execution.
+- `hybrid` — CMS nodes for generation + local OpenMontage for post-production (FFmpeg composition, subtitle burn-in, audio mixing, color grading).
+
+Do not claim the environment can do something the inspected setup does not support.
+
+---
+
+### STEP 9 — Execute or hand off
+
+**Local-fork mode:** Direct the agent to execute the pipeline:
+```
+research -> proposal -> script -> scene_plan -> assets -> edit -> compose
+```
+Each stage follows its pipeline stage director skill in `skills/pipelines/`.
+
+**Agent-only / hybrid mode:** Produce the complete handoff package so the user or a downstream agent can execute:
+- All production artifacts from Step 7
+- CMS node execution instructions (which nodes to run, with what inputs)
+- Post-production instructions (composition, audio, subtitles)
+
+---
+
+### STEP 10 — Log the deliverable
+
+Outputs must be saved under:
+
+```text
+output/<client-slug>/<project-slug>/
+```
+
+Append a deliverable line in the active brand kit:
+
+```text
+- YYYY-MM-DD | OpenMontage Video Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/
+```
+
+---
+
+## CRITICAL RULES
+
+| Rule | Meaning |
+|---|---|
+| Env gate must pass first | No `.env` or no provider = check CMS nodes or zero-key mode |
+| Read `skills.md` first | No memory-only operation |
+| Inspect the fork before planning | `tool_registry.py` and `pipeline_defs/` outrank assumptions |
+| Pick one primary pipeline | No mixed-pipeline output without explicit transition notes |
+| Provider choice uses 7-dimension scoring | Do not pick providers by name recognition alone |
+| CMS nodes are first-class providers | Treat hosted generation outputs as source assets for composition |
+| Pipeline stages are strict order | research -> proposal -> script -> scene_plan -> assets -> edit -> compose |
+| Budget governance applies | Estimate costs before execution, respect spend caps |
+| Outputs must be operational | Every file should help an operator execute immediately |
+
+---
+
+## REQUIRED OUTPUT ORDER
+
+1. `VideoProductionBrief`
+2. `PipelineSelectionBrief`
+3. `ProviderSelectionBrief`
+4. `ScenePlan`
+5. `PromptMatrix`
+6. `GenerationBatchPlan`
+7. `AssetTracking`
+8. `ReviewQAChecklist`
+9. `PlatformReadyExecutionHandoff`

package/assets/worker-kits/growthub-twenty-crm-v1/.env.example

@@ -0,0 +1,15 @@
+# Twenty CRM Worker Kit — Environment Config
+# Copy this file to .env and fill in your credentials.
+# Never commit .env to version control.
+
+# Required: Twenty API bearer token.
+# Generate from Twenty Settings > API > Tokens.
+TWENTY_API_TOKEN=your_twenty_api_token_here
+
+# Required: Twenty API base URL.
+# Use https://api.twenty.com for cloud, or http://localhost:3000 for local fork.
+TWENTY_API_URL=https://api.twenty.com
+
+# Optional: override local fork path used by setup scripts.
+# Default: ~/twenty
+TWENTY_FORK_PATH=~/twenty