@growthub/cli 0.3.54 → 0.3.56

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

@@ -0,0 +1,107 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-open-montage-studio-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — Open Montage Studio",
+    "description": "Self-contained local execution environment for OpenMontage agentic video production. Produces end-to-end video content through 12 production pipelines — from animated explainers and cinematic trailers to documentary montages and talking heads — with direct CMS node integration for first-party video/image generation.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "open-montage-studio-operator",
+    "path": "workers/open-montage-studio-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "open-montage-studio-operator"
+  ],
+  "agentContractPath": "workers/open-montage-studio-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "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"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "envExample": ".env.example",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is intended to be pointed at directly by the agent Working Directory. All outputs are Markdown files written to output/<client-slug>/<project-slug>/.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      ".env.example",
+      "kit.json",
+      "bundles/growthub-open-montage-studio-v1.json",
+      "skills.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",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-open-montage-studio-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-open-montage-studio-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.3.50"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-14T00:00:00.000Z"
+  }
+}

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

@@ -0,0 +1,34 @@
+# Output Directory
+
+This directory stores all production artifacts created by the Open Montage Studio Operator.
+
+## Structure
+
+```
+output/
+└── <client-slug>/
+    └── <project-slug>/
+        ├── video-production-brief.md
+        ├── pipeline-selection-brief.md
+        ├── provider-selection-brief.md
+        ├── scene-plan.md
+        ├── prompt-matrix.md
+        ├── generation-batch-plan.md
+        ├── asset-tracking.md
+        ├── review-qa-checklist.md
+        ├── platform-ready-execution-handoff.md
+        ├── cms-node-pipeline-mapping.md     (if CMS nodes used)
+        └── assets/                          (if local-fork mode)
+            ├── images/
+            ├── video/
+            ├── audio/
+            └── render/
+```
+
+## Conventions
+
+- One directory per client, one subdirectory per project
+- Use kebab-case for slugs
+- All production artifacts are Markdown files
+- Generated media assets go in `assets/` subdirectories
+- Final render goes in `assets/render/`

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

@@ -0,0 +1,79 @@
+# Output Standards — Open Montage Studio
+
+All artifacts produced by the Open Montage Studio Operator must follow these standards.
+
+---
+
+## Directory Structure
+
+```
+output/<client-slug>/<project-slug>/
+├── video-production-brief.md
+├── pipeline-selection-brief.md
+├── provider-selection-brief.md
+├── scene-plan.md
+├── prompt-matrix.md
+├── generation-batch-plan.md
+├── asset-tracking.md
+├── review-qa-checklist.md
+├── platform-ready-execution-handoff.md
+├── cms-node-pipeline-mapping.md          (if CMS nodes used)
+└── assets/                               (generated assets, if local-fork mode)
+    ├── images/
+    ├── video/
+    ├── audio/
+    └── render/
+```
+
+---
+
+## File Naming
+
+- Use kebab-case for all file names
+- Include the project slug in the directory path, not in each file name
+- Asset files use the pattern: `<scene-number>-<type>-<sequence>.<ext>` (e.g., `01-image-001.png`)
+
+---
+
+## Markdown Standards
+
+- All artifacts are Markdown files
+- Use tables for structured data (not inline lists)
+- Use code blocks for commands, paths, and configuration values
+- Every artifact must include a Project Reference header with client, project, pipeline, and date
+- Templates must be filled completely — no empty placeholder fields in final output
+
+---
+
+## Render Profiles
+
+| Profile | Resolution | Aspect Ratio | FPS | Codec | Bitrate |
+|---------|-----------|--------------|-----|-------|---------|
+| YouTube Landscape | 1920x1080 | 16:9 | 30 | H.264 | 8 Mbps |
+| YouTube 4K | 3840x2160 | 16:9 | 30 | H.264 | 35 Mbps |
+| YouTube Shorts | 1080x1920 | 9:16 | 30 | H.264 | 8 Mbps |
+| Instagram Reels | 1080x1920 | 9:16 | 30 | H.264 | 8 Mbps |
+| Instagram Feed | 1080x1080 | 1:1 | 30 | H.264 | 8 Mbps |
+| TikTok | 1080x1920 | 9:16 | 30 | H.264 | 8 Mbps |
+| LinkedIn | 1920x1080 | 16:9 | 30 | H.264 | 8 Mbps |
+| Cinematic | 2560x1080 | 21:9 | 24 | H.264 | 12 Mbps |
+
+---
+
+## Quality Bars
+
+- **No slideshow outputs** — image-based videos must score >= 6.0 on the slideshow risk assessment
+- **Audio must be present** — silent video is only acceptable when explicitly requested
+- **Subtitles must be word-level timed** — no sentence-level block captions
+- **Transitions must be intentional** — no default cuts everywhere; vary based on scene mood
+- **Color grading is expected** — unless the user explicitly opts out
+
+---
+
+## Deliverable Line Format
+
+When logging a deliverable in the brand kit:
+
+```
+- YYYY-MM-DD | OpenMontage Video Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/
+```

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

@@ -0,0 +1,86 @@
+# Runtime Assumptions — Open Montage Studio
+
+This file documents the runtime environment expectations for the Open Montage Studio Worker Kit.
+
+---
+
+## Execution Modes
+
+| Mode | Requirements | Description |
+|---|---|---|
+| `local-fork` | Python 3.10+, FFmpeg, Node.js 18+, OpenMontage clone | Full tool access — agent runs pipelines directly |
+| `agent-only` | GrowthHub session or zero-key mode | No local clone — CMS nodes or free tools provide generation |
+| `hybrid` | GrowthHub session + partial local tools | CMS nodes for generation + local post-production |
+
+---
+
+## Local-Fork Mode Requirements
+
+### System Dependencies
+
+| Dependency | Minimum Version | Check Command | Purpose |
+|---|---|---|---|
+| Python | 3.10+ | `python3 --version` | OpenMontage tool execution |
+| FFmpeg | any recent | `ffmpeg -version` | Video encoding, subtitle burn-in, audio mixing |
+| Node.js | 18+ | `node --version` | Remotion composition engine |
+| npm | any recent | `npm --version` | Remotion dependency management |
+
+### OpenMontage Clone
+
+- Default path: `~/OpenMontage` (override with `OPENMONTAGE_PATH` in `.env`)
+- Setup: `git clone https://github.com/calesthio/OpenMontage.git && cd OpenMontage && make setup`
+- The clone includes Python requirements, Remotion composer, and Piper TTS
+
+### API Keys
+
+All keys are optional. More keys = more tools available. Recommended setup order:
+
+1. Free stock media keys (Pexels, Pixabay) — completely free
+2. Google API key — 1M chars/month free TTS + $300 new account credits
+3. ElevenLabs — 10K chars/month free premium TTS
+4. fal.ai — FLUX images + multi-model video (~$0.03/image)
+
+---
+
+## Agent-Only Mode Requirements
+
+- Active GrowthHub session (`growthub auth:login`) for CMS node access
+- OR: zero-key mode (Piper TTS + free archives + Remotion guidance only)
+- No local OpenMontage clone needed
+- Agent produces production artifacts and composition guidance
+- Actual generation happens via CMS hosted execution
+
+---
+
+## Hybrid Mode Requirements
+
+- Active GrowthHub session for CMS node generation
+- Local FFmpeg for post-production (composition, subtitles, audio mixing)
+- Optional: local OpenMontage clone for full Remotion composition
+- CMS node outputs (URLs) are downloaded locally for post-production
+
+---
+
+## File System Assumptions
+
+- Working directory is this kit folder (exported via `growthub kit download`)
+- Output goes to `output/<client-slug>/<project-slug>/`
+- Brand kits live in `brands/<client-slug>/`
+- The agent reads `skills.md` and templates from relative paths
+
+---
+
+## Network Assumptions
+
+- Internet access required for: provider API calls, CMS node execution, stock media search, web research
+- Local-fork Remotion rendering is fully offline after assets are downloaded
+- FFmpeg post-production is fully offline
+
+---
+
+## Known Limitations
+
+- Piper TTS quality is lower than cloud TTS — acceptable for drafts, recommend ElevenLabs or Google for final output
+- Local GPU video generation (WAN 2.1, Hunyuan) requires NVIDIA GPU with 6-24GB VRAM — not available on most laptops
+- Remotion composition renders images into animated video — not the same as AI-generated motion clips
+- CMS node execution latency depends on GrowthHub hosted infrastructure — may be slower than direct API calls

package/assets/worker-kits/growthub-open-montage-studio-v1/setup/check-deps.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Check system dependencies for Open Montage Studio local-fork mode.
+# Exit 0: all dependencies present.
+# Exit 1: one or more dependencies missing.
+
+echo "=== Open Montage Studio — Dependency Check ==="
+echo ""
+
+MISSING=0
+
+check_dep() {
+  local name="$1"
+  local cmd="$2"
+  local min_version="$3"
+  local install_hint="$4"
+
+  if command -v "$cmd" &>/dev/null; then
+    local version
+    version=$("$cmd" --version 2>&1 | head -1)
+    echo "  [ok] $name: $version"
+  else
+    echo "  [missing] $name — install: $install_hint"
+    MISSING=$((MISSING + 1))
+  fi
+}
+
+check_dep "Python 3.10+" "python3" "3.10" "python.org or brew install python"
+check_dep "FFmpeg" "ffmpeg" "any" "brew install ffmpeg or ffmpeg.org"
+check_dep "Node.js 18+" "node" "18" "nodejs.org or brew install node"
+check_dep "npm" "npm" "any" "comes with Node.js"
+check_dep "Git" "git" "any" "brew install git"
+
+echo ""
+
+if [ "$MISSING" -gt 0 ]; then
+  echo "[result] $MISSING dependency(s) missing. Install them and rerun this check."
+  exit 1
+else
+  echo "[result] All dependencies present."
+  exit 0
+fi

package/assets/worker-kits/growthub-open-montage-studio-v1/setup/clone-fork.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Clone and set up OpenMontage for local-fork execution mode.
+# Usage: bash setup/clone-fork.sh [target-dir]
+
+TARGET_DIR="${1:-${OPENMONTAGE_PATH:-$HOME/OpenMontage}}"
+
+echo "=== OpenMontage Fork Setup ==="
+echo "Target directory: $TARGET_DIR"
+echo ""
+
+# ── Step 1: Clone ──
+if [ -d "$TARGET_DIR/.git" ]; then
+  echo "[skip] Repository already exists at $TARGET_DIR"
+  echo "       To update: cd $TARGET_DIR && git pull"
+else
+  echo "[clone] Cloning OpenMontage..."
+  git clone https://github.com/calesthio/OpenMontage.git "$TARGET_DIR"
+  echo "[done] Cloned to $TARGET_DIR"
+fi
+
+# ── Step 2: Install dependencies ──
+echo ""
+echo "[setup] Running make setup..."
+cd "$TARGET_DIR"
+
+if [ -f Makefile ]; then
+  make setup
+else
+  echo "[fallback] No Makefile found. Running manual setup..."
+  pip install -r requirements.txt
+  cd remotion-composer && npm install && cd ..
+  pip install piper-tts
+  cp -n .env.example .env 2>/dev/null || true
+fi
+
+# ── Step 3: Verify ──
+echo ""
+echo "[verify] Checking tool registry..."
+python3 -c "from tools.tool_registry import registry; registry.discover(); print('Tool registry: OK')" 2>/dev/null || {
+  echo "[warn] Tool registry check failed. This may be normal on first setup."
+  echo "       Try: cd $TARGET_DIR && python3 -c \"from tools.tool_registry import registry; registry.discover()\""
+}
+
+echo ""
+echo "=== Setup Complete ==="
+echo "OpenMontage is ready at: $TARGET_DIR"
+echo ""
+echo "Next steps:"
+echo "  1. Add API keys to $TARGET_DIR/.env (optional — more keys = more tools)"
+echo "  2. Point your agent Working Directory at this kit folder"
+echo "  3. Start a session — the operator will detect the local fork automatically"

package/assets/worker-kits/growthub-open-montage-studio-v1/setup/verify-env.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/**
+ * Verify environment configuration for Open Montage Studio.
+ * Checks which providers are configured and validates key formats.
+ * Exit 0: at least one provider configured or zero-key mode acknowledged.
+ * Exit 1: configuration issue found.
+ */
+
+import { readFileSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const kitRoot = resolve(__dirname, "..");
+const envPath = resolve(kitRoot, ".env");
+
+// ── Parse .env ──
+
+function parseEnv(filePath) {
+  if (!existsSync(filePath)) return {};
+  const lines = readFileSync(filePath, "utf-8").split("\n");
+  const env = {};
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const value = trimmed.slice(eqIndex + 1).trim();
+    env[key] = value;
+  }
+  return env;
+}
+
+// ── Provider definitions ──
+
+const PROVIDERS = [
+  { key: "FAL_KEY", name: "fal.ai", capabilities: "FLUX images, Kling/Veo/MiniMax video, Recraft", placeholder: "your_fal_key_here" },
+  { key: "PEXELS_API_KEY", name: "Pexels", capabilities: "Free stock photos + videos", placeholder: "your_pexels_key_here" },
+  { key: "PIXABAY_API_KEY", name: "Pixabay", capabilities: "Free stock photos + videos", placeholder: "your_pixabay_key_here" },
+  { key: "UNSPLASH_ACCESS_KEY", name: "Unsplash", capabilities: "Free stock images", placeholder: "your_unsplash_key_here" },
+  { key: "OPENAI_API_KEY", name: "OpenAI", capabilities: "DALL-E 3 images, OpenAI TTS", placeholder: "your_openai_key_here" },
+  { key: "GOOGLE_API_KEY", name: "Google", capabilities: "Google TTS (700+ voices), Imagen images", placeholder: "your_google_key_here" },
+  { key: "ELEVENLABS_API_KEY", name: "ElevenLabs", capabilities: "Premium TTS, music, SFX", placeholder: "your_elevenlabs_key_here" },
+  { key: "SUNO_API_KEY", name: "Suno", capabilities: "AI music generation", placeholder: "your_suno_key_here" },
+  { key: "RUNWAY_API_KEY", name: "Runway", capabilities: "Gen-4 video", placeholder: "your_runway_key_here" },
+  { key: "HEYGEN_API_KEY", name: "HeyGen", capabilities: "Avatar videos", placeholder: "your_heygen_key_here" },
+  { key: "HIGGSFIELD_API_KEY", name: "Higgsfield", capabilities: "Multi-model video orchestrator", placeholder: "your_higgsfield_key_here" },
+  { key: "XAI_API_KEY", name: "xAI Grok", capabilities: "Image + video generation", placeholder: "your_xai_key_here" },
+];
+
+// ── Check ──
+
+console.log("=== Open Montage Studio — Environment Check ===\n");
+
+if (!existsSync(envPath)) {
+  console.log("[error] .env file not found at:", envPath);
+  console.log("        Run: cp .env.example .env");
+  process.exit(1);
+}
+
+const env = parseEnv(envPath);
+const configured = [];
+const missing = [];
+
+for (const provider of PROVIDERS) {
+  const value = env[provider.key];
+  if (value && value !== provider.placeholder && value.length > 5) {
+    configured.push(provider);
+    console.log(`  [ok] ${provider.name} — ${provider.capabilities}`);
+  } else {
+    missing.push(provider);
+  }
+}
+
+console.log("");
+
+if (configured.length === 0) {
+  console.log("[info] No provider keys configured.");
+  console.log("       You can still use:");
+  console.log("       - GrowthHub CMS nodes (requires growthub auth:login)");
+  console.log("       - Zero-key mode: Piper TTS + free archives + Remotion");
+  console.log("");
+  console.log("       To add providers, edit .env and rerun this script.");
+  // Exit 0 — zero-key mode is valid
+  process.exit(0);
+}
+
+console.log(`[summary] ${configured.length} provider(s) configured, ${missing.length} not set.`);
+
+// Check OpenMontage path
+const omPath = env.OPENMONTAGE_PATH || resolve(process.env.HOME || "~", "OpenMontage");
+if (existsSync(omPath)) {
+  console.log(`[ok] OpenMontage clone found at: ${omPath}`);
+} else {
+  console.log(`[info] OpenMontage not found at: ${omPath}`);
+  console.log("       Run: bash setup/clone-fork.sh (optional — needed for local-fork mode only)");
+}
+
+console.log("\n=== Check Complete ===");
+process.exit(0);