@growthub/cli 0.14.5 → 0.14.8

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

@@ -1,122 +0,0 @@
-{
-  "schemaVersion": 2,
-  "kit": {
-    "id": "growthub-open-montage-studio-v1",
-    "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit \u2014 Open Montage Studio",
-    "description": "Self-contained local execution environment for OpenMontage agentic video production. Produces end-to-end video content through 12 production pipelines \u2014 from animated explainers and cinematic trailers to documentary montages and talking heads \u2014 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",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.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",
-      "SKILL.md",
-      "templates/project.md",
-      "templates/self-eval.md",
-      "helpers",
-      "helpers/README.md",
-      "skills",
-      "skills/README.md"
-    ]
-  },
-  "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"
-  },
-  "workspaceVisibility": "addon",
-  "workspaceCompatible": false,
-  "workspaceCategory": "studio"
-}

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

@@ -1,34 +0,0 @@
-# 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

@@ -1,79 +0,0 @@
-# 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

@@ -1,86 +0,0 @@
-# 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: `$HOME/OpenMontage` (override with `OPEN_MONTAGE_HOME` (legacy: `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

@@ -1,43 +0,0 @@
-#!/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

@@ -1,54 +0,0 @@
-#!/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]
-
-# Canonical: OPEN_MONTAGE_HOME. Legacy alias: OPENMONTAGE_PATH.
-TARGET_DIR="${1:-${OPEN_MONTAGE_HOME:-${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

@@ -1,105 +0,0 @@
-#!/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 — canonical OPEN_MONTAGE_HOME, legacy alias OPENMONTAGE_PATH.
-const omPath =
-  env.OPEN_MONTAGE_HOME ||
-  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);

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

@@ -1,23 +0,0 @@
-# `skills/` — nested sub-skill convention (primitive #5)
-
-A **sub-skill** is a full `SKILL.md`-addressable lane that a parent skill can spawn as a parallel sub-agent.
-
-## Convention
-
-```
-skills/
-├── README.md                        # this file
-└── <slug>/                          # kebab-case; matches the SKILL.md name
-    ├── SKILL.md                     # frontmatter + routing body (≤ 500 lines)
-    ├── references/                  # optional — long docs loaded on demand
-    ├── templates/                   # optional — reusable text/JS templates
-    └── scripts/                     # optional — deterministic helpers
-```
-
-Each sub-skill's frontmatter follows `@growthub/api-contract/skills::SkillManifest`. Sub-skills share the parent's `.growthub-fork/project.md` journal — they do not branch it.
-
-## Parallelism
-
-Spawn a sub-skill sub-agent when (a) the sub-skill's work is fully scoped by its own criteria, and (b) the parent's next step does not depend on intermediate state from the sub-skill. Each sub-skill run appends a row to `project.md::subSkillRuns` so the parent can read the outcome on return.
-
-See the parent `SKILL.md` `subSkills[]` array for the current roster.