@growthub/cli 0.14.5 → 0.14.8

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

@@ -1,89 +0,0 @@
----
-name: growthub-open-montage-studio-v1
-description: "Self-contained workspace for OpenMontage agentic video production — end-to-end video content with EDL generation, segment rendering, and self-eval at every cut boundary. Use when the user says: \"open montage\", \"agentic video\", \"montage studio\". Session memory tracks EDL drafts, per-cut retries, and final assembly acceptance."
-triggers:
-  - open montage studio
-  - fork growthub-open-montage-studio-v1
-progressiveDisclosure: true
-sessionMemory:
-  path: .growthub-fork/project.md
-selfEval:
-  criteria:
-    - Operator contract (workers/open-montage-studio-operator/CLAUDE.md) read before any material change.
-    - .growthub-fork/project.md appended to at each material change.
-    - .growthub-fork/trace.jsonl receives a typed event for each material change.
-    - Kit-specific QUICKSTART / runtime-assumptions / output-standards honoured.
-  maxRetries: 3
-  traceTo: .growthub-fork/trace.jsonl
-helpers: []
-subSkills: []
-mcpTools: []
----
-
-# Growthub Agent Worker Kit — Open Montage Studio
-
-Discovery entry + routing menu for the `growthub-open-montage-studio-v1` worker kit. Family: `studio`. Agent contract: `workers/open-montage-studio-operator/CLAUDE.md`.
-
-## When to use this skill
-
-When the user's intent matches any of the triggers above — or when an agent has been dropped into a fork whose `.growthub-fork/fork.json` declares `kitId: "growthub-open-montage-studio-v1"`.
-
-## Decision tree
-
-```
-Fork exists (this directory contains .growthub-fork/fork.json)?
-├── No  → run: growthub starter init --out <path>   (or import-repo / import-skill)
-│         then: growthub kit download growthub-open-montage-studio-v1 --out <path>
-│
-└── Yes → read in this order:
-          1. .growthub-fork/project.md                         — session memory (primitive #3)
-          2. SKILL.md  (this file)                             — routing menu  (primitive #1)
-          3. skills.md                                         — operator runbook
-          4. workers/open-montage-studio-operator/CLAUDE.md                              — agent contract
-          5. QUICKSTART.md                                     — first-run steps
-          6. runtime-assumptions.md                            — host expectations
-          7. .growthub-fork/policy.json                        — what you may touch
-          8. .growthub-fork/trace.jsonl (tail 20)              — recent machine history
-```
-
-## The six primitives (same shape across every Growthub worker kit)
-
-1. **`SKILL.md`** — this file.
-2. **Symlinked pointer** — repo-root `AGENTS.md` is authoritative.
-3. **`.growthub-fork/project.md`** — session memory, seeded by the CLI from `templates/project.md` at init/import time.
-4. **Self-evaluation** — generate → apply → evaluate → record; retry up to `selfEval.maxRetries` (default 3); mirrors the Fork Sync Agent's preview → apply → trace loop (primitive #4). Contract: `@growthub/api-contract/skills::SkillSelfEval`.
-5. **`skills/`** — nested sub-skills for parallel sub-agents on heavy / narrow work.
-6. **`helpers/`** — safe shell tool layer. Promote inline shell here whenever the same snippet is re-used.
-
-## Self-evaluation (primitive #4)
-
-Enforce `selfEval.maxRetries: 3`. At the ceiling, park with a `needs_confirmation` note in `project.md` and stop. Record every attempt to both `project.md` and `trace.jsonl`.
-
-## Session memory (primitive #3)
-
-`.growthub-fork/project.md` is the only cross-session continuity surface for this fork. Append at every material change, approval boundary, and self-eval outcome.
-
-## Sub-skills (primitive #5)
-
-(None declared at the baseline; populate `skills/` and the frontmatter `subSkills[]` array as specialist lanes emerge.)
-
-## Helpers (primitive #6)
-
-(None declared at the baseline; populate `helpers/` and the frontmatter `helpers[]` array as inline shell matures.)
-
-## MCP routing (optional)
-
-List concrete MCP tool IDs in `mcpTools[]` when a fork runs an MCP server for auth-heavy actions. Declarative only at v1.
-
-## Related files
-
-- `skills.md` — operator runbook (deep)
-- `QUICKSTART.md` — first-run steps
-- `runtime-assumptions.md` — host expectations
-- `output-standards.md` — output locations + manifest shape
-- `validation-checklist.md` — pre-flight checklist (if present)
-- `templates/project.md` — session-memory template
-- `templates/self-eval.md` — self-evaluation template
-- `helpers/README.md` — safe shell tool layer convention
-- `skills/README.md` — sub-skill convention
-- `workers/open-montage-studio-operator/CLAUDE.md` — agent contract

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

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

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

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

@@ -1,62 +0,0 @@
-{
-  "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",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.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

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

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