@growthub/cli 0.3.54 → 0.3.56

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

@@ -0,0 +1,114 @@
+# Quick Start — Open Montage Studio Worker Kit
+
+This folder is your self-contained agent working directory for OpenMontage video production with GrowthHub CMS node integration.
+
+---
+
+## Step 1 — Point your Working Directory at this folder
+
+**Growthub local (primary):** Open Growthub local and set the **Working Directory** to this folder in your project settings. Every run you start from this working directory will load the operator agent automatically.
+
+**Claude Code (alternative):** Open Claude Code settings and set the **Working Directory** to this folder. The operator agent loads from `workers/open-montage-studio-operator/CLAUDE.md` on session start.
+
+---
+
+## Step 2 — Choose your execution mode
+
+| Mode | What You Need | Best For |
+|---|---|---|
+| `local-fork` | OpenMontage clone + Python + FFmpeg + Node.js | Full production control, all 52 tools |
+| `agent-only` | GrowthHub session or zero-key mode | Quick projects, CMS node generation |
+| `hybrid` | GrowthHub session + local FFmpeg | CMS generation + local post-production |
+
+---
+
+## Step 3 — Add your API keys (optional)
+
+```bash
+cp .env.example .env
+```
+
+Open `.env` and add the keys you have. Every key is optional — more keys = more tools.
+
+**Recommended setup order (cheapest first):**
+
+1. **Pexels + Pixabay** — free stock media (free developer keys)
+2. **Google API key** — TTS with 700+ voices (1M chars/month free)
+3. **ElevenLabs** — premium TTS (10K chars/month free)
+4. **fal.ai** — FLUX images + video generation (~$0.03/image)
+
+**Zero keys is fine.** You still get Piper TTS, free archives, and Remotion composition. Or use GrowthHub CMS nodes for generation.
+
+---
+
+## Step 4 — Verify your setup (optional but recommended)
+
+```bash
+node setup/verify-env.mjs
+```
+
+Shows which providers are configured and checks for the OpenMontage clone.
+
+---
+
+## Step 5 — Set up OpenMontage clone (local-fork mode only)
+
+```bash
+bash setup/check-deps.sh     # Check Python, FFmpeg, Node.js, Git
+bash setup/clone-fork.sh     # Clone OpenMontage and run make setup
+```
+
+This clones OpenMontage to `~/OpenMontage`, installs all dependencies (Python packages, Remotion, Piper TTS), and verifies the tool registry.
+
+Skip this step if you are using agent-only or hybrid mode.
+
+---
+
+## Step 6 — Connect GrowthHub (CMS node mode)
+
+If you want to use GrowthHub CMS nodes for video/image generation:
+
+```bash
+growthub auth:login
+```
+
+This authenticates your session so the agent can discover and execute CMS nodes. CMS node costs flow through your GrowthHub billing.
+
+Skip this step if you are using local-fork mode with direct API keys only.
+
+---
+
+## Step 7 — Start a new session
+
+**Growthub local:** Start a new run from this working directory. The agent loads automatically.
+
+**Claude Code:** Open a new session with this folder as the Working Directory. The agent reads `skills.md` and the methodology automatically.
+
+In both cases the agent will:
+1. Run the environment gate (check .env, providers, dependencies)
+2. Load the methodology and brand context
+3. Ask you 3 clarifying questions before generating anything
+
+---
+
+## What you can ask
+
+Copy any of these into your agent session:
+
+- "Make a 60-second animated explainer about how neural networks learn"
+- "Create a 30-second cinematic product trailer for a smart water bottle"
+- "Make a documentary montage about city life at 4am using real footage only"
+- "Turn this YouTube video into 3 differentiated concepts for my brand"
+- "Create a TikTok-style explainer about CRISPR gene editing"
+
+---
+
+## First-run checklist
+
+See `validation-checklist.md` for the full pre-session checklist before your first production run.
+
+---
+
+## Creating a brand kit for a new client
+
+See `brands/NEW-CLIENT.md`.

package/assets/worker-kits/growthub-open-montage-studio-v1/brands/NEW-CLIENT.md

@@ -0,0 +1,42 @@
+# Creating a Brand Kit for a New Client
+
+## Steps
+
+1. Copy the template:
+
+```bash
+cp -r brands/_template brands/<client-slug>
+```
+
+2. Open `brands/<client-slug>/brand-kit.md` and fill in:
+   - Brand identity (name, tagline, industry, audience)
+   - Visual identity (colors, fonts, logo)
+   - Tone of voice
+   - Visual style preferences
+   - Platform profiles
+   - Music preferences
+
+3. The operator loads this brand kit in Step 1 of every session. All production artifacts will reference these brand guidelines.
+
+## Naming Convention
+
+- Use kebab-case for the client slug: `acme-corp`, `startup-xyz`
+- Keep the slug short and recognizable
+
+## What Goes in a Brand Kit
+
+| Section | Required | Purpose |
+|---|---|---|
+| Brand identity | Yes | Who they are and who they serve |
+| Visual identity | Yes | Colors, fonts, logo for consistent output |
+| Tone of voice | Yes | How to write scripts and narration |
+| Visual style preferences | Yes | Which visual treatment to use |
+| Platform profiles | Recommended | Target platforms and format constraints |
+| Music preferences | Recommended | Audio direction for background music |
+| Deliverable log | Auto-populated | Running record of all produced content |
+
+## Tips
+
+- If the client has a website or existing video content, reference it in the brand kit for style alignment
+- Color values should be hex codes for precision
+- If unsure about visual style, default to "clean professional" and note it for client review

package/assets/worker-kits/growthub-open-montage-studio-v1/brands/_template/brand-kit.md

@@ -0,0 +1,49 @@
+# Brand Kit — `<CLIENT NAME>`
+
+## Brand Identity
+
+| Field | Value |
+|---|---|
+| Brand name | |
+| Tagline | |
+| Industry | |
+| Primary audience | |
+
+## Visual Identity
+
+| Field | Value |
+|---|---|
+| Primary color | `#` |
+| Secondary color | `#` |
+| Accent color | `#` |
+| Background | `#` |
+| Font family (headings) | |
+| Font family (body) | |
+| Logo path | |
+
+## Tone of Voice
+
+<!-- Describe the brand's communication style: formal/casual, serious/playful, authoritative/approachable. -->
+
+## Visual Style Preferences
+
+<!-- Preferred visual treatment for video content: photorealistic, illustrated, flat motion, anime, minimalist, cinematic. -->
+
+## Platform Profiles
+
+| Platform | Aspect Ratio | Duration Range | Notes |
+|---|---|---|---|
+| YouTube | 16:9 | 30-300s | |
+| TikTok | 9:16 | 15-60s | |
+| Instagram Reels | 9:16 | 15-90s | |
+| LinkedIn | 16:9 | 30-120s | |
+
+## Music Preferences
+
+<!-- Genre, mood, energy level, instrumental vs vocal. -->
+
+## Deliverable Log
+
+<!-- Append deliverables as they are produced. -->
+
+<!-- - YYYY-MM-DD | OpenMontage Video Package v1 — <Project Name> | output/<client-slug>/<project-slug>/ -->

package/assets/worker-kits/growthub-open-montage-studio-v1/brands/growthub/brand-kit.md

@@ -0,0 +1,50 @@
+# Brand Kit — Growthub
+
+## Brand Identity
+
+| Field | Value |
+|---|---|
+| Brand name | Growthub |
+| Tagline | Growth infrastructure over a stable agentic substrate |
+| Industry | AI / Developer tools / Growth automation |
+| Primary audience | Developers, growth teams, AI-native companies |
+
+## Visual Identity
+
+| Field | Value |
+|---|---|
+| Primary color | `#1a1a2e` (deep navy) |
+| Secondary color | `#16213e` (dark blue) |
+| Accent color | `#0f3460` (medium blue) |
+| Background | `#0a0a0a` (near black) |
+| Font family (headings) | Monospace / terminal aesthetic |
+| Font family (body) | System sans-serif |
+| Logo path | ASCII art block letter style |
+
+## Tone of Voice
+
+Technical, direct, confident. No marketing fluff. Speak to builders and operators who value substance over polish. Use declarative statements. Avoid exclamation marks.
+
+## Visual Style Preferences
+
+- Clean professional or minimalist diagram style for educational content
+- Flat motion graphics for social media
+- Dark backgrounds with high-contrast text and subtle accent colors
+- Terminal/code aesthetic where appropriate
+- Avoid: stock photo look, corporate clip art, generic gradients
+
+## Platform Profiles
+
+| Platform | Aspect Ratio | Duration Range | Notes |
+|---|---|---|---|
+| YouTube | 16:9 | 30-300s | Primary distribution |
+| TikTok | 9:16 | 15-60s | Short demos |
+| LinkedIn | 16:9 | 30-120s | Product announcements |
+
+## Music Preferences
+
+Ambient electronic, minimal beats, lo-fi. Instrumental only. Low energy for educational, medium energy for product demos. No vocals.
+
+## Deliverable Log
+
+<!-- Append deliverables as they are produced. -->

package/assets/worker-kits/growthub-open-montage-studio-v1/bundles/growthub-open-montage-studio-v1.json

@@ -0,0 +1,55 @@
+{
+  "schemaVersion": 2,
+  "bundle": {
+    "id": "growthub-open-montage-studio-v1",
+    "version": "1.0.0",
+    "kitId": "growthub-open-montage-studio-v1",
+    "workerId": "open-montage-studio-operator"
+  },
+  "briefType": "open-montage-video-production",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "requiredFrozenAssets": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/open-montage-studio-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/clone-fork.sh",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/video-production-brief.md",
+    "templates/pipeline-selection-brief.md",
+    "templates/provider-selection-brief.md",
+    "templates/scene-plan.md",
+    "templates/prompt-matrix.md",
+    "templates/generation-batch-plan.md",
+    "templates/asset-tracking.md",
+    "templates/review-qa-checklist.md",
+    "templates/platform-ready-execution-handoff.md",
+    "templates/cms-node-pipeline-mapping.md",
+    "examples/video-production-brief-sample.md",
+    "examples/pipeline-selection-sample.md",
+    "examples/cms-node-video-gen-sample.md",
+    "examples/platform-ready-handoff-sample.md",
+    "docs/open-montage-fork-integration.md",
+    "docs/provider-adapter-layer.md",
+    "docs/cms-node-bridge.md",
+    "docs/pipeline-reference.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "optionalPresets": [],
+  "export": {
+    "folderName": "growthub-agent-worker-kit-open-montage-studio-v1",
+    "zipFileName": "growthub-agent-worker-kit-open-montage-studio-v1.zip"
+  },
+  "activationModes": ["export"]
+}

package/assets/worker-kits/growthub-open-montage-studio-v1/docs/cms-node-bridge.md

@@ -0,0 +1,152 @@
+# CMS Node Bridge — GrowthHub ↔ OpenMontage
+
+This document describes the adapter layer that bridges GrowthHub CMS node outputs into the OpenMontage production pipeline.
+
+---
+
+## Overview
+
+GrowthHub's CMS exposes video and image generation as hosted execution nodes. These nodes produce output URLs (video clips, images, audio) that can feed directly into OpenMontage's composition engine. The bridge is a **cognitive adapter** — the agent reads this mapping and applies it during pipeline execution. There is no code-level integration; the agent is the integration layer.
+
+---
+
+## Architecture
+
+```
+GrowthHub CMS                          OpenMontage
+─────────────                          ───────────
+                                       
+CMS Capability Registry ──→ Agent discovers available nodes
+       │                              
+       ↓                              
+CMS Node Execution ──→ Agent triggers hosted execution
+       │                              
+       ↓                              
+Output URLs ──→ Agent feeds URLs as source assets
+       │                     │
+       ↓                     ↓
+                    OpenMontage Pipeline Stage
+                    (assets / edit / compose)
+                             │
+                             ↓
+                    Remotion / FFmpeg Composition
+                             │
+                             ↓
+                    Final Video Output
+```
+
+---
+
+## CMS Capability Registry
+
+The CMS capability registry (`cli/src/runtime/cms-capability-registry/`) exposes node primitives:
+
+```typescript
+interface CmsCapabilityNode {
+  slug: string;                    // e.g., "video-generation"
+  family: CapabilityFamily;        // "video" | "image" | "slides" | "text" | "data" | "ops"
+  executionKind: string;           // "hosted-execute"
+  executionBinding: {
+    type: "mcp_tool_call";
+    strategy: "direct" | "sequential-with-persistence" | "async_operation";
+  };
+  requiredBindings: string[];      // Provider keys needed
+  outputTypes: string[];           // e.g., ["video_url", "image_url"]
+  enabled: boolean;
+}
+```
+
+The agent queries the registry to discover which nodes are available:
+
+```
+Query: { family: "video", enabledOnly: true }
+Query: { family: "image", enabledOnly: true }
+```
+
+---
+
+## Node Family → OpenMontage Stage Mapping
+
+| CMS Family | Output Type | OpenMontage Stage | Integration |
+|---|---|---|---|
+| `video` | Video URL | `assets` | Download → source clip for composition |
+| `image` | Image URL | `assets` | Download → scene image for Remotion animation |
+| `text` | String | `script` | Direct use as script content |
+| `slides` | Slide assets | `assets` | Scene images extracted from slides |
+
+---
+
+## Execution Flow
+
+### 1. Discovery
+
+Agent queries the CMS capability registry during Step 6 (provider selection):
+
+```
+Available CMS nodes:
+- video-generation (family: video, hosted-execute)
+- image-generation (family: image, hosted-execute)
+```
+
+### 2. Input Binding Preparation
+
+For each scene that will use a CMS node, the agent prepares input bindings from the scene plan:
+
+```
+CMS Node: image-generation
+Inputs: { prompt: "...", aspect_ratio: "16:9", style: "photorealistic" }
+```
+
+### 3. Hosted Execution
+
+The agent triggers execution via the hosted execution client. Results include output URLs:
+
+```
+Result: { status: "completed", outputUrl: "https://cdn.growthub.ai/gen/abc123.png" }
+```
+
+### 4. Asset Integration
+
+Output URLs are recorded in the asset tracking sheet and fed into the OpenMontage pipeline:
+
+- **Video URLs** → downloaded as source clips → timeline assembly via FFmpeg or Remotion
+- **Image URLs** → downloaded as scene images → animated composition via Remotion
+
+### 5. Composition
+
+OpenMontage handles all post-production:
+- Scene ordering and timeline assembly
+- Transition effects (crossfade, zoom, wipe)
+- Audio mixing (narration + music)
+- Subtitle burn-in (word-level timing)
+- Color grading
+- Final render to target platform spec
+
+---
+
+## When to Bridge vs When to Use Direct Providers
+
+| Scenario | Recommendation |
+|---|---|
+| User has GrowthHub session, no direct API keys | Bridge via CMS nodes |
+| User prefers unified GrowthHub billing | Bridge via CMS nodes |
+| CMS node matches the required generation type | Bridge via CMS nodes |
+| User has direct API keys and wants lower latency | Use direct providers |
+| Required tool/model is not available as a CMS node | Use direct providers |
+| Local-fork mode with full tool access | Use direct providers (faster) |
+
+---
+
+## Adapter Contract
+
+The bridge adapter handles:
+
+| Operation | Description |
+|---|---|
+| `DISCOVER_NODES` | Query CMS capability registry for available nodes |
+| `PREPARE_BINDINGS` | Map scene plan inputs to CMS node input schema |
+| `EXECUTE_NODE` | Trigger hosted execution and poll for results |
+| `COLLECT_OUTPUTS` | Gather output URLs from execution results |
+| `ROUTE_TO_PIPELINE` | Feed output URLs into the appropriate OpenMontage pipeline stage |
+
+The agent performs all of these operations as part of the standard 10-step workflow. No separate adapter code is needed — the agent IS the adapter.

package/assets/worker-kits/growthub-open-montage-studio-v1/docs/open-montage-fork-integration.md

@@ -0,0 +1,120 @@
+# OpenMontage Fork Integration
+
+This document describes how the local OpenMontage clone integrates with this worker kit.
+
+---
+
+## Architecture Overview
+
+OpenMontage is an agent-first video production system. There is no code orchestrator — the AI agent IS the orchestrator.
+
+```
+Agent reads pipeline manifest (YAML) → stages, tools, review criteria
+  ↓
+Agent reads stage director skill (Markdown) → HOW to execute each stage
+  ↓
+Agent calls Python tools → scored provider selection across 7 dimensions
+  ↓
+Agent self-reviews → schema validation, quality checks
+  ↓
+Agent checkpoints state (JSON) → resumable, with decision log
+  ↓
+Pre-compose validation gate → delivery promise, slideshow risk
+  ↓
+Render (Remotion or FFmpeg)
+  ↓
+Post-render self-review → ffprobe, frame extraction, audio analysis
+  ↓
+Final video output
+```
+
+---
+
+## Directory Layout
+
+```
+OpenMontage/
+├── tools/              # 52 Python tools (the agent's hands)
+│   ├── video/          # Video gen: Kling, Runway, Veo, Grok, WAN, Hunyuan, etc.
+│   ├── audio/          # TTS: ElevenLabs, Google, OpenAI, Piper + music
+│   ├── graphics/       # Image gen: FLUX, DALL-E, Imagen, Recraft, local diffusion
+│   ├── enhancement/    # Upscale, bg remove, face enhance, color grade
+│   ├── analysis/       # Transcription, scene detect, frame sampling
+│   ├── avatar/         # Talking head, lip sync
+│   └── subtitle/       # SRT/VTT generation
+│
+├── pipeline_defs/      # 12 YAML pipeline manifests
+├── skills/             # 400+ Markdown skill files
+│   ├── pipelines/      # Per-pipeline stage director skills
+│   ├── creative/       # Creative technique skills
+│   ├── core/           # Core tool skills
+│   └── meta/           # Reviewer, checkpoint protocol
+│
+├── schemas/            # JSON Schemas for contract validation
+├── styles/             # Visual style playbooks (YAML)
+├── remotion-composer/  # React/Remotion video composition engine
+├── lib/                # Core infrastructure
+└── config.yaml         # Global configuration
+```
+
+---
+
+## Tool Discovery
+
+The tool registry auto-discovers all tools at startup:
+
+```bash
+cd ~/OpenMontage
+python3 -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
+```
+
+This returns the full capability envelope: which tools are available, which providers are configured, and what the system can produce.
+
+---
+
+## Three-Layer Knowledge Architecture
+
+| Layer | Location | Purpose |
+|---|---|---|
+| 1 | `tools/` + `pipeline_defs/` | What exists — executable capabilities + orchestration |
+| 2 | `skills/` | How to use it — OpenMontage conventions and quality bars |
+| 3 | `.agents/skills/` | How it works — 47 external technology knowledge packs |
+
+---
+
+## Pipeline Manifests
+
+Each pipeline is defined as a YAML manifest in `pipeline_defs/`. The manifest specifies:
+- Stages in order
+- Tools available at each stage
+- Review criteria
+- Success gates
+
+The agent reads the manifest, then reads the corresponding stage director skills to know HOW to execute each stage.
+
+---
+
+## Remotion Composition Engine
+
+Located at `remotion-composer/`. A React-based programmatic video composition engine that:
+- Renders TextCard, StatCard, charts, image scenes with spring animations
+- Supports crossfade, wipe, zoom transitions
+- Burns in TikTok-style word-level captions
+- Outputs H.264 MP4 at any resolution/aspect ratio
+
+Remotion is always available (no API key needed) and is the primary composition path for image-based video.
+
+---
+
+## Setup
+
+```bash
+bash setup/clone-fork.sh
+```
+
+This script:
+1. Clones `https://github.com/calesthio/OpenMontage.git` to `~/OpenMontage`
+2. Runs `make setup` (pip install + npm install + Piper TTS)
+3. Verifies the tool registry
+
+After setup, add API keys to `~/OpenMontage/.env` for additional provider access.