@growthub/cli 0.3.54 → 0.3.56

package/assets/worker-kits/growthub-open-montage-studio-v1/docs/pipeline-reference.md

@@ -0,0 +1,147 @@
+# OpenMontage Pipeline Reference
+
+Quick reference for all 12 OpenMontage production pipelines.
+
+---
+
+## Pipelines
+
+### Animated Explainer
+
+| Field | Value |
+|---|---|
+| Best for | Educational content, tutorials, topic breakdowns |
+| Stage flow | research → proposal → script → scene_plan → assets → edit → compose |
+| Key tools | Web search, image gen (FLUX/DALL-E), TTS, Remotion, FFmpeg |
+| Typical cost | $0.15-$3.00 |
+| Duration range | 30-300 seconds |
+
+### Animation
+
+| Field | Value |
+|---|---|
+| Best for | Social media, product demos, abstract concepts |
+| Stage flow | research → proposal → script → scene_plan → assets → edit → compose |
+| Key tools | Image gen, video gen (optional), Remotion motion graphics |
+| Typical cost | $0.15-$5.00 |
+| Duration range | 15-120 seconds |
+
+### Avatar Spokesperson
+
+| Field | Value |
+|---|---|
+| Best for | Corporate comms, training, announcements |
+| Stage flow | research → proposal → script → scene_plan → assets → edit → compose |
+| Key tools | HeyGen avatar, TTS, Remotion |
+| Typical cost | $2.00-$10.00 |
+| Duration range | 30-300 seconds |
+
+### Cinematic
+
+| Field | Value |
+|---|---|
+| Best for | Brand films, teasers, promotional content |
+| Stage flow | research → proposal → script → scene_plan → assets → edit → compose |
+| Key tools | Video gen (Kling/Veo/Runway), image gen, music gen, FFmpeg |
+| Typical cost | $1.00-$10.00 |
+| Duration range | 15-120 seconds |
+
+### Clip Factory
+
+| Field | Value |
+|---|---|
+| Best for | Repurposing long content for social media |
+| Stage flow | analysis → ranking → extraction → edit → compose |
+| Key tools | Transcriber, scene detect, FFmpeg trim, subtitle gen |
+| Typical cost | $0.00-$1.00 |
+| Duration range | 15-60 seconds per clip |
+
+### Documentary Montage
+
+| Field | Value |
+|---|---|
+| Best for | Video essays, mood pieces, real-footage B-roll edits |
+| Stage flow | research → corpus_build → clip_selection → edit → compose |
+| Key tools | Pexels/Archive.org/Wikimedia, CLIP search, FFmpeg, music |
+| Typical cost | $0.00-$2.00 |
+| Duration range | 30-300 seconds |
+
+### Hybrid
+
+| Field | Value |
+|---|---|
+| Best for | Enhancing existing footage with AI-generated support visuals |
+| Stage flow | analysis → proposal → assets → edit → compose |
+| Key tools | Scene detect, image gen, video gen, FFmpeg overlay |
+| Typical cost | $0.50-$5.00 |
+| Duration range | 15-300 seconds |
+
+### Localization & Dub
+
+| Field | Value |
+|---|---|
+| Best for | Multi-language distribution |
+| Stage flow | analysis → transcription → translation → dub → compose |
+| Key tools | Transcriber, TTS (multi-language), subtitle gen, FFmpeg |
+| Typical cost | $0.50-$5.00 per language |
+| Duration range | Matches source |
+
+### Podcast Repurpose
+
+| Field | Value |
+|---|---|
+| Best for | Podcast marketing, audiogram videos |
+| Stage flow | analysis → highlight_extraction → visual_design → compose |
+| Key tools | Transcriber, image gen, Remotion audiogram, FFmpeg |
+| Typical cost | $0.00-$2.00 |
+| Duration range | 30-120 seconds per clip |
+
+### Screen Demo
+
+| Field | Value |
+|---|---|
+| Best for | Product demos, tutorials, documentation |
+| Stage flow | proposal → script → recording → edit → compose |
+| Key tools | Screen capture, TTS narration, Remotion overlays, FFmpeg |
+| Typical cost | $0.00-$1.00 |
+| Duration range | 30-600 seconds |
+
+### Talking Head
+
+| Field | Value |
+|---|---|
+| Best for | Presentations, vlogs, interviews |
+| Stage flow | proposal → script → recording → edit → compose |
+| Key tools | Source footage, face enhance, TTS (optional), FFmpeg |
+| Typical cost | $0.00-$2.00 |
+| Duration range | 30-600 seconds |
+
+---
+
+## Universal Stage Flow
+
+All pipelines follow the same core structure:
+
+```
+research → proposal → script → scene_plan → assets → edit → compose
+```
+
+Some pipelines have specialized stages (e.g., `corpus_build` for Documentary Montage, `analysis` for Clip Factory), but the overall flow is always: understand → plan → generate → assemble → deliver.
+
+---
+
+## Pipeline Selection Decision Matrix
+
+| If the user wants... | Select... |
+|---|---|
+| Explain a topic | Animated Explainer |
+| Motion graphics / kinetic typography | Animation |
+| Avatar presenter | Avatar Spokesperson |
+| Cinematic trailer / brand film | Cinematic |
+| Batch clips from long content | Clip Factory |
+| Real footage montage / video essay | Documentary Montage |
+| Enhance existing footage | Hybrid |
+| Translate / dub | Localization & Dub |
+| Podcast to video | Podcast Repurpose |
+| Software walkthrough | Screen Demo |
+| Speaker-led video | Talking Head |

package/assets/worker-kits/growthub-open-montage-studio-v1/docs/provider-adapter-layer.md

@@ -0,0 +1,105 @@
+# Provider Adapter Layer
+
+OpenMontage uses a scored provider selection system. This document describes how providers integrate and how GrowthHub CMS nodes fit into the provider model.
+
+---
+
+## Provider Selection Model
+
+Every tool selection runs through a 7-dimension scoring engine:
+
+| Dimension | Weight | Description |
+|---|---|---|
+| Task fit | 30% | How well the provider matches the specific task |
+| Output quality | 20% | Resolution, fidelity, consistency |
+| Control features | 15% | Prompt adherence, parameter granularity |
+| Reliability | 15% | Uptime, error rate, queue latency |
+| Cost efficiency | 10% | Price per output unit |
+| Latency | 5% | Request to deliverable time |
+| Continuity | 5% | Session persistence, rate limits |
+
+The agent scores available providers for each task and selects the highest-scoring option. Alternatives are logged with their scores in the decision audit trail.
+
+---
+
+## Provider Categories
+
+### Cloud API Providers
+
+| Provider | Env Key | Capabilities |
+|---|---|---|
+| fal.ai | `FAL_KEY` | FLUX images, Kling/Veo/MiniMax video, Recraft images |
+| OpenAI | `OPENAI_API_KEY` | DALL-E 3 images, OpenAI TTS |
+| Google | `GOOGLE_API_KEY` | Google TTS (700+ voices), Imagen images |
+| ElevenLabs | `ELEVENLABS_API_KEY` | Premium TTS, music, SFX |
+| xAI Grok | `XAI_API_KEY` | Image + video generation |
+| Runway | `RUNWAY_API_KEY` | Gen-4 video |
+| Higgsfield | `HIGGSFIELD_API_KEY` | Multi-model video orchestrator |
+| HeyGen | `HEYGEN_API_KEY` | Avatar videos |
+| Suno | `SUNO_API_KEY` | AI music generation |
+
+### Free Stock Media
+
+| Provider | Env Key | Capabilities |
+|---|---|---|
+| Pexels | `PEXELS_API_KEY` | Stock photos + videos |
+| Pixabay | `PIXABAY_API_KEY` | Stock photos + videos |
+| Unsplash | `UNSPLASH_ACCESS_KEY` | Stock images |
+
+### Local Providers (Always Available)
+
+| Provider | Capabilities |
+|---|---|
+| Piper TTS | Offline text-to-speech, ~30 English voices |
+| Remotion | React-based programmatic video composition |
+| FFmpeg | Video encoding, subtitles, audio mixing, color grading |
+| Archive.org + NASA + Wikimedia | Free archival footage |
+
+### Local GPU Providers (Optional)
+
+| Provider | Env Key | Requirements |
+|---|---|---|
+| WAN 2.1 | `VIDEO_GEN_LOCAL_ENABLED` | NVIDIA GPU, 6-24GB VRAM |
+| Hunyuan | `VIDEO_GEN_LOCAL_ENABLED` | NVIDIA GPU, 12GB VRAM |
+| CogVideo | `VIDEO_GEN_LOCAL_ENABLED` | NVIDIA GPU, 6-10GB VRAM |
+| LTX-Video | `VIDEO_GEN_LOCAL_ENABLED` | NVIDIA GPU, 8GB VRAM |
+| Stable Diffusion | — | NVIDIA GPU, 4GB+ VRAM |
+
+---
+
+## GrowthHub CMS Nodes as Providers
+
+GrowthHub CMS nodes act as an additional provider source in the scoring model. They are treated identically to cloud providers with the following characteristics:
+
+| Dimension | CMS Node Score Basis |
+|---|---|
+| Task fit | Matches if the CMS node family matches the task (video/image) |
+| Output quality | Depends on the underlying provider routed by the CMS node |
+| Control features | Limited to CMS node input bindings |
+| Reliability | GrowthHub hosted infrastructure SLA |
+| Cost efficiency | GrowthHub billing (may be included in plan) |
+| Latency | Hosted execution overhead + provider latency |
+| Continuity | Depends on GrowthHub session |
+
+When CMS nodes are available and the user prefers unified GrowthHub billing, the scoring engine should weight cost efficiency higher for CMS nodes.
+
+---
+
+## Fallback Strategy
+
+When the primary provider path fails:
+
+1. Fall back to the next highest-scored provider for the same task
+2. If no alternative provider exists, fall back to a different tool category (e.g., image-to-video instead of text-to-video)
+3. If all providers fail, fall back to free/local tools (Piper TTS, Remotion composition, stock media)
+4. Mark the handoff with the exact fallback trigger and trade-offs
+
+---
+
+## Adding a New Provider
+
+New providers integrate by:
+1. Adding a tool in the appropriate `tools/` subdirectory
+2. Implementing the tool contract (BaseTool inheritance)
+3. The registry auto-discovers it
+4. The scoring engine includes it in selection automatically

package/assets/worker-kits/growthub-open-montage-studio-v1/examples/cms-node-video-gen-sample.md

@@ -0,0 +1,109 @@
+# CMS Node Integration Example — Video Generation
+
+This example shows how a GrowthHub CMS video-generation node integrates into an OpenMontage Cinematic pipeline.
+
+---
+
+## Scenario
+
+A user wants to create a 30-second cinematic product trailer. They have a GrowthHub session with access to the `video-generation` CMS node (which routes to a hosted video generation provider). They also have a local OpenMontage clone for post-production.
+
+**Execution mode:** hybrid
+
+---
+
+## Step 1 — Discover Available CMS Nodes
+
+The agent queries the CMS capability registry:
+
+```
+Family: video
+Execution kind: hosted-execute
+```
+
+Result:
+- `video-generation` — family: video, executionKind: hosted-execute, outputTypes: ["video_url"]
+
+---
+
+## Step 2 — Map CMS Node to Pipeline Stage
+
+| CMS Node | Pipeline Stage | Role |
+|---|---|---|
+| `video-generation` | `assets` | Generate 4 motion clips for scene footage |
+
+The `video-generation` CMS node replaces what would normally be a direct `kling_video` or `veo_video` tool call in the OpenMontage pipeline.
+
+---
+
+## Step 3 — Prepare Input Bindings
+
+For each scene clip, the agent prepares CMS node inputs:
+
+| Scene | Input Key | Value |
+|---|---|---|
+| 1 | prompt | "Cinematic close-up of a glowing smart water bottle rotating slowly on a dark surface, volumetric lighting, product photography" |
+| 1 | duration | 5 |
+| 1 | aspect_ratio | "16:9" |
+| 2 | prompt | "Hand reaching for the smart water bottle, LED ring pulsing blue, shallow depth of field, warm lighting" |
+| 2 | duration | 5 |
+| 2 | aspect_ratio | "16:9" |
+
+---
+
+## Step 4 — Execute CMS Nodes
+
+The agent triggers hosted execution for each scene:
+
+```
+CMS Node: video-generation
+Execution: hosted-execute via HostedExecutionClient
+Result: { outputUrl: "https://cdn.growthub.ai/gen/abc123.mp4", status: "completed" }
+```
+
+---
+
+## Step 5 — Feed Outputs into OpenMontage
+
+The output URLs from CMS node execution become source assets in the OpenMontage pipeline:
+
+```
+Scene 1 source clip: https://cdn.growthub.ai/gen/abc123.mp4
+Scene 2 source clip: https://cdn.growthub.ai/gen/def456.mp4
+Scene 3 source clip: https://cdn.growthub.ai/gen/ghi789.mp4
+Scene 4 source clip: https://cdn.growthub.ai/gen/jkl012.mp4
+```
+
+These feed into the `edit` and `compose` stages of the Cinematic pipeline, where OpenMontage handles:
+- Timeline assembly and scene ordering
+- Transition effects (crossfades, zooms)
+- Audio mixing (narration + music)
+- Subtitle burn-in
+- Color grading
+- Final H.264 render
+
+---
+
+## Step 6 — Post-Production via Local OpenMontage
+
+```bash
+cd ~/OpenMontage
+# Agent uses FFmpeg tools for:
+# - Video stitch (combine 4 clips into timeline)
+# - Audio mix (narration + background music)
+# - Subtitle burn-in (word-level SRT)
+# - Color grade (cinematic LUT)
+# - Final render (1920x1080, H.264, 8 Mbps)
+```
+
+---
+
+## Cost Summary
+
+| Item | Provider | Cost |
+|---|---|---|
+| 4 video clips | CMS node (GrowthHub billing) | Included in plan |
+| TTS narration | Piper (local) | $0.00 |
+| Background music | Free royalty-free | $0.00 |
+| Post-production | FFmpeg (local) | $0.00 |
+| **Total direct cost** | | **$0.00** (CMS node costs on GrowthHub billing) |

package/assets/worker-kits/growthub-open-montage-studio-v1/examples/pipeline-selection-sample.md

@@ -0,0 +1,67 @@
+# Pipeline Selection Brief
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | Growthub |
+| Project | How Neural Networks Learn — 60s Explainer |
+| Date | 2026-04-14 |
+
+## Requested Outcome
+
+"Make a 60-second animated explainer about how neural networks learn."
+
+## Selected Pipeline
+
+| Field | Value |
+|---|---|
+| Pipeline | Animated Explainer |
+| Reason | The user explicitly asked for an explainer about a technical topic. The Animated Explainer pipeline is purpose-built for educational content with research, scripting, AI-generated visuals, narration, and Remotion composition. |
+
+## Pipeline Fit Assessment
+
+| Criterion | Score (1-5) | Notes |
+|---|---|---|
+| Content type match | 5 | Explainer is the exact target content type |
+| Available tool coverage | 5 | FLUX images via fal.ai + Piper TTS + Remotion |
+| Source asset alignment | 4 | No source assets needed; all generated |
+| Budget feasibility | 5 | ~$0.30 for 12 FLUX images, free TTS, free composition |
+| Quality ceiling | 4 | Image-based video — need strong motion/animation |
+
+## Input Asset Requirements
+
+- None — the pipeline handles research, script, image generation, TTS, and composition end-to-end.
+
+## Output Specification
+
+| Field | Value |
+|---|---|
+| Primary deliverable | 60-second animated explainer video |
+| Duration | 60 seconds |
+| Resolution | 1920x1080 |
+| Codec | H.264 |
+
+## Fallback Pipeline
+
+| Field | Value |
+|---|---|
+| Pipeline | Animation |
+| Trigger | If the explainer pipeline cannot produce sufficient visual variety (slideshow risk > 40%) |
+| Trade-off | Animation pipeline adds kinetic typography and motion graphics but requires more manual scene design |
+
+## Pipeline Stage Plan
+
+```
+research → proposal → script → scene_plan → assets → edit → compose
+```
+
+| Stage | Owner | Tool / CMS Node | Notes |
+|---|---|---|---|
+| Research | Agent | Web search (15-25 searches) | YouTube, Reddit, academic sources on neural network education |
+| Proposal | Agent | — | 2-3 concept variants for user approval |
+| Script | Agent | — | 60s script with word-level timing targets |
+| Scene plan | Agent | — | 10-12 scenes with transitions and audio cues |
+| Assets | Agent + fal.ai | FLUX image gen + CMS image-generation node | 12 scene images + narration + music |
+| Edit | Agent | Remotion | Animated composition with spring physics |
+| Compose | Agent | FFmpeg | Final render with subtitles |

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

@@ -0,0 +1,101 @@
+# Platform-Ready Execution Handoff
+
+## Project Reference
+
+| Field | Value |
+|---|---|
+| Client | Growthub |
+| Project | How Neural Networks Learn — 60s Explainer |
+| Pipeline | Animated Explainer |
+| Execution mode | local-fork |
+| Date | 2026-04-14 |
+
+## Deliverable Summary
+
+| Field | Value |
+|---|---|
+| Video title | How Neural Networks Learn |
+| Duration | 62 seconds |
+| Resolution | 1920x1080 |
+| Aspect ratio | 16:9 |
+| Platform target | YouTube |
+| Estimated cost | $0.45 |
+| Actual cost | $0.38 |
+
+## 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. The agent executed the Animated Explainer pipeline:
+#    research → proposal → script → scene_plan → assets → edit → compose
+#
+#    Research: 18 web searches across YouTube, Reddit, ArXiv
+#    Proposal: 3 concepts presented, user selected concept B (metaphor-driven)
+#    Script: 62-second narrated script with 12 scene markers
+#    Assets: 12 FLUX images + 1 Piper TTS narration + 1 royalty-free BGM
+#    Edit: Remotion composition with spring animations and crossfade transitions
+#    Compose: FFmpeg final render with burned-in subtitles
+
+# 3. Final render
+# Output: output/growthub/neural-networks-explainer/assets/render/final.mp4
+```
+
+## Asset Manifest
+
+| ID | Type | Source | URL / Path | Status |
+|---|---|---|---|---|
+| A-001 | image | FLUX (fal.ai) | assets/images/01-image-001.png | ready |
+| A-002 | image | FLUX (fal.ai) | assets/images/02-image-001.png | ready |
+| A-003 | image | FLUX (fal.ai) | assets/images/03-image-001.png | ready |
+| A-004 | image | FLUX (fal.ai) | assets/images/04-image-001.png | ready |
+| A-005 | image | FLUX (fal.ai) | assets/images/05-image-001.png | ready |
+| A-006 | image | FLUX (fal.ai) | assets/images/06-image-001.png | ready |
+| A-007 | image | FLUX (fal.ai) | assets/images/07-image-001.png | ready |
+| A-008 | image | FLUX (fal.ai) | assets/images/08-image-001.png | ready |
+| A-009 | image | FLUX (fal.ai) | assets/images/09-image-001.png | ready |
+| A-010 | image | FLUX (fal.ai) | assets/images/10-image-001.png | ready |
+| A-011 | image | FLUX (fal.ai) | assets/images/11-image-001.png | ready |
+| A-012 | image | FLUX (fal.ai) | assets/images/12-image-001.png | ready |
+| A-013 | narration | Piper TTS | assets/audio/narration.wav | ready |
+| A-014 | music | Royalty-free | assets/audio/bgm.mp3 | ready |
+| A-015 | subtitles | Built-in | assets/audio/subtitles.srt | ready |
+| A-016 | render | Remotion + FFmpeg | assets/render/final.mp4 | ready |
+
+## Post-Production Steps
+
+| Step | Tool | Input | Output | Notes |
+|---|---|---|---|---|
+| 1 | Remotion | 12 scene images + animation config | Draft composition | Spring physics, crossfade transitions, Ken Burns |
+| 2 | WhisperX | Narration audio | Word-level SRT | Aligned to narration timing |
+| 3 | FFmpeg | Draft + narration + BGM + SRT | Final render | H.264, 1920x1080, 30fps, 8 Mbps |
+
+## Render Profile
+
+| Field | Value |
+|---|---|
+| Resolution | 1920x1080 |
+| FPS | 30 |
+| Codec | H.264 |
+| Bitrate | 8 Mbps |
+| Audio codec | AAC |
+| Container | MP4 |
+
+## Known Limitations
+
+- Image-based video — no actual motion clips. Remotion provides animated transitions, zoom, and Ken Burns effects to mitigate slideshow risk.
+- Slideshow risk score: 7.2/10 (above 6.0 threshold — approved).
+
+## Approval
+
+| Gate | Status |
+|---|---|
+| Production brief approved | yes |
+| Budget approved | yes |
+| QA checklist passed | yes |
+| Ready for execution | yes |

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

@@ -0,0 +1,68 @@
+# Video Production Brief
+
+## Project
+
+| Field | Value |
+|---|---|
+| Client | Growthub |
+| Project | How Neural Networks Learn — 60s Explainer |
+| Date | 2026-04-14 |
+| Operator | Open Montage Studio Operator |
+
+## Objective
+
+Create a 60-second animated explainer video about how neural networks learn, targeting a general audience on YouTube. The viewer should understand backpropagation at a conceptual level and feel motivated to explore further.
+
+## Format
+
+| Field | Value |
+|---|---|
+| Duration target | 60 seconds |
+| Aspect ratio | 16:9 |
+| Resolution | 1920x1080 |
+| Platform | YouTube |
+
+## Content Summary
+
+A visually engaging animated explainer that walks through the core loop of neural network training: forward pass, loss calculation, backpropagation, and weight updates. Uses metaphors (a student adjusting answers based on feedback) alongside technical visualizations.
+
+## Tone and Style
+
+- Visual style: Flat motion graphics with clean professional palette
+- Mood: Curious, accessible, slightly futuristic
+- Pacing: Medium — 4-5 seconds per scene, breathing room between concepts
+- Reference: 3Blue1Brown visual style but with more color and animation
+
+## Source Assets
+
+| Asset | Status | Notes |
+|---|---|---|
+| Brand kit | available | brands/growthub/brand-kit.md |
+| Reference video | missing | Can reference 3Blue1Brown neural network series |
+| Source footage | missing | All visuals will be AI-generated |
+| Product images | n/a | |
+| Audio / voiceover | to-generate | TTS narration |
+| Script | to-generate | Agent will research and write |
+
+## CMS Node Availability
+
+| CMS Node Family | Available | Notes |
+|---|---|---|
+| Video generation | no | Using direct fal.ai provider |
+| Image generation | yes | GrowthHub image-generation node available |
+| Text generation | no | Agent handles script |
+
+## Constraints
+
+- Budget cap: $5.00
+- Timeline: Single session
+- Brand guidelines: Use Growthub color palette
+- Must include word-level subtitles
+
+## Success Criteria
+
+- 60-second video with 10-12 scenes
+- Clear explanation of backpropagation concept
+- Professional narration with background music
+- Word-level subtitles burned in
+- YouTube-ready H.264 render at 1920x1080

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

@@ -0,0 +1,7 @@
+# Growthub Meta — Open Montage Studio
+
+This directory contains metadata about the kit's relationship to the Growthub ecosystem.
+
+## Contents
+
+- `kit-standard.md` — Compliance with the Growthub Agent Worker Kit standard

package/assets/worker-kits/growthub-open-montage-studio-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,45 @@
+# Kit Standard Compliance — Open Montage Studio
+
+## Kit Identity
+
+| Field | Value |
+|---|---|
+| Kit ID | `growthub-open-montage-studio-v1` |
+| Schema version | 2 |
+| Type | worker |
+| Family | studio |
+| Execution mode | export |
+| Activation modes | export |
+| CLI min version | 0.3.50 |
+
+## Five-Layer Architecture Compliance
+
+| Layer | Status | Evidence |
+|---|---|---|
+| 1. Contract | Complete | `kit.json` (schema v2), `bundles/` manifest |
+| 2. Cognitive | Complete | `workers/open-montage-studio-operator/CLAUDE.md`, `skills.md` |
+| 3. Production | Complete | 10 templates, output standards, examples |
+| 4. Runtime | Complete | Setup scripts, runtime assumptions, validation checklist |
+| 5. Activation | Complete | `QUICKSTART.md`, export-based activation |
+
+## Contributor Checklist
+
+- [x] Self-contained kit folder exists under `cli/assets/worker-kits/`
+- [x] `kit.json` exists and is complete (schema v2)
+- [x] Bundle manifest exists and is complete
+- [x] Payload files are present (all `frozenAssetPaths` exist)
+- [x] Catalog registration exists in `cli/src/kits/catalog.ts`
+- [x] Kit validates via `growthub kit validate <path>`
+- [x] Real local adapter test passes through Working Directory
+
+## Differentiators from Other Kits
+
+| Feature | This Kit | Higgsfield Kit |
+|---|---|---|
+| Production substrate | OpenMontage (12 pipelines, 52 tools) | Open Higgsfield AI (4 studios) |
+| Pipeline count | 12 | 1 (visual production) |
+| CMS node integration | First-class bridge adapter | Not present |
+| Provider count | 14 video + 10 image + 4 TTS | 1 (Muapi) |
+| Execution modes | local-fork, agent-only, hybrid | local-fork, browser-hosted, desktop-app |
+| Composition engine | Remotion + FFmpeg | Higgsfield studios |
+| Zero-key capability | Full (Piper + archives + Remotion) | Limited |