@growthub/cli 0.8.0 → 0.8.2

package/assets/worker-kits/growthub-creative-video-pipeline-v1/helpers/README.md

@@ -0,0 +1,8 @@
+# helpers/
+
+Safe shell helpers for the creative-video-pipeline operator. These wrap external commands with error handling and env validation. Never call raw CLI commands without going through these helpers.
+
+| Helper | Purpose |
+|--------|---------|
+| `run-pipeline.sh` | Wraps `growthub pipeline execute` for Stage 2 |
+| `check-generative-adapter.sh` | Validates env for the selected generative adapter |

package/assets/worker-kits/growthub-creative-video-pipeline-v1/helpers/check-generative-adapter.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ADAPTER="${CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER:-growthub-pipeline}"
+ERRORS=0
+
+echo "[check-adapter] Adapter: $ADAPTER"
+
+case "$ADAPTER" in
+  growthub-pipeline)
+    for var in GROWTHUB_BRIDGE_ACCESS_TOKEN GROWTHUB_BRIDGE_BASE_URL; do
+      if [ -z "${!var:-}" ]; then
+        echo "[check-adapter] Missing: $var" >&2
+        ((ERRORS++))
+      fi
+    done
+    ;;
+  byo-api-key)
+    if [ -z "${VIDEO_MODEL_PROVIDER:-}" ]; then
+      echo "[check-adapter] Missing: VIDEO_MODEL_PROVIDER" >&2
+      ((ERRORS++))
+    else
+      case "$VIDEO_MODEL_PROVIDER" in
+        veo)   [ -z "${GOOGLE_AI_API_KEY:-}" ] && echo "[check-adapter] Missing: GOOGLE_AI_API_KEY" >&2 && ((ERRORS++)) || true ;;
+        fal)   [ -z "${FAL_API_KEY:-}" ]       && echo "[check-adapter] Missing: FAL_API_KEY"       >&2 && ((ERRORS++)) || true ;;
+        runway)[ -z "${RUNWAY_API_KEY:-}" ]    && echo "[check-adapter] Missing: RUNWAY_API_KEY"    >&2 && ((ERRORS++)) || true ;;
+        *)     echo "[check-adapter] Unknown VIDEO_MODEL_PROVIDER: $VIDEO_MODEL_PROVIDER" >&2 && ((ERRORS++)) ;;
+      esac
+    fi
+    ;;
+  *)
+    echo "[check-adapter] Unknown adapter: $ADAPTER (expected growthub-pipeline or byo-api-key)" >&2
+    ((ERRORS++))
+    ;;
+esac
+
+if [ "$ERRORS" -gt 0 ]; then
+  echo "[check-adapter] FAIL — $ERRORS error(s)" >&2
+  exit 1
+fi
+echo "[check-adapter] OK"

package/assets/worker-kits/growthub-creative-video-pipeline-v1/helpers/run-pipeline.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Wraps `growthub pipeline execute` for Stage 2 generative execution.
+# Usage: run-pipeline.sh <json-payload-or-file> [output-dir]
+#
+# Args:
+#   payload    — DynamicRegistryPipeline JSON string or path to a JSON file
+#   output-dir — where to write the NDJSON trace (default: ./output)
+
+PAYLOAD="${1:?DynamicRegistryPipeline JSON payload or file path required}"
+OUTPUT_DIR="${2:-./output}"
+
+mkdir -p "$OUTPUT_DIR"
+TRACE="$OUTPUT_DIR/pipeline-trace.ndjson"
+
+if ! command -v growthub &>/dev/null; then
+  echo "[run-pipeline] growthub CLI not found. Install with: npm install -g @growthub/cli" >&2
+  exit 1
+fi
+
+# Auth pre-flight — session must be valid before executing
+if ! growthub auth whoami --json >/dev/null 2>&1; then
+  echo "[run-pipeline] Not authenticated. Run: growthub auth login" >&2
+  exit 1
+fi
+
+echo "[run-pipeline] Executing pipeline..."
+growthub pipeline execute "$PAYLOAD" 2>&1 | tee "$TRACE"
+echo "[run-pipeline] Trace written to $TRACE"

package/assets/worker-kits/growthub-creative-video-pipeline-v1/kit.json

@@ -0,0 +1,148 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-creative-video-pipeline-v1",
+    "version": "1.0.0",
+    "name": "Growthub Creative Video Pipeline",
+    "description": "Chainable worker kit that composes creative-strategist brief logic, the growthub video-generation CMS node, and the video-use edit pipeline into a single governed workspace. Three sequential stages: (1) brand brief, (2) generative image/video via growthub pipeline execute or BYOK, (3) video editing via the video-use fork. The Vite local shell and Vercel app render all outputs and a unified API key settings surface.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "creative-video-pipeline-operator",
+    "path": "workers/creative-video-pipeline-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "creative-video-pipeline-operator"
+  ],
+  "agentContractPath": "workers/creative-video-pipeline-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "QUICKSTART.md",
+    ".env.example",
+    "SKILL.md",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/creative-video-pipeline-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/check-deps.sh",
+    "setup/verify-env.mjs",
+    "setup/clone-fork.sh",
+    "setup/install-skill.sh",
+    "output/README.md",
+    "templates/pipeline-brief.md",
+    "templates/generative-plan.md",
+    "templates/edit-plan.md",
+    "templates/project.md",
+    "templates/self-eval.md",
+    "examples/pipeline-brief-sample.md",
+    "docs/starter-kit-overview.md",
+    "docs/pipeline-architecture.md",
+    "docs/adapter-contracts.md",
+    "docs/vercel-deployment.md",
+    "docs/governed-workspace-primitives.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md",
+    "helpers/README.md",
+    "helpers/run-pipeline.sh",
+    "helpers/check-generative-adapter.sh",
+    "skills/README.md",
+    "skills/brief-generation/SKILL.md",
+    "skills/generative-execution/SKILL.md",
+    "skills/video-edit/SKILL.md",
+    "studio/index.html",
+    "studio/package.json",
+    "studio/package-lock.json",
+    "studio/vite.config.js",
+    "studio/serve.mjs",
+    "studio/src/main.jsx",
+    "studio/src/App.jsx",
+    "studio/src/app.css",
+    "apps/creative-video-pipeline/README.md",
+    "apps/creative-video-pipeline/.env.example",
+    "apps/creative-video-pipeline/package.json",
+    "apps/creative-video-pipeline/package-lock.json",
+    "apps/creative-video-pipeline/next.config.js",
+    "apps/creative-video-pipeline/postcss.config.mjs",
+    "apps/creative-video-pipeline/vercel.json",
+    "apps/creative-video-pipeline/app/layout.jsx",
+    "apps/creative-video-pipeline/app/page.jsx",
+    "apps/creative-video-pipeline/app/globals.css",
+    "apps/creative-video-pipeline/app/settings/keys/page.jsx",
+    "apps/creative-video-pipeline/app/api/pipeline/route.js",
+    "apps/creative-video-pipeline/lib/adapters/env.js",
+    "apps/creative-video-pipeline/lib/adapters/generative/index.js",
+    "apps/creative-video-pipeline/lib/domain/pipeline.js"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "envExample": ".env.example",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is a governed Growthub workspace. The Vite operator shell runs under studio/. The Vercel-ready app lives under apps/creative-video-pipeline/. Pipeline outputs land in output/<client-slug>/<project-slug>/{brief/,generative/,final/}.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      "kit.json",
+      ".env.example",
+      "bundles/growthub-creative-video-pipeline-v1.json",
+      "SKILL.md",
+      "skills.md",
+      "workers/creative-video-pipeline-operator/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/growthub/brand-kit.md",
+      "brands/NEW-CLIENT.md",
+      "setup/check-deps.sh",
+      "setup/verify-env.mjs",
+      "output/README.md",
+      "templates",
+      "templates/project.md",
+      "templates/self-eval.md",
+      "templates/pipeline-brief.md",
+      "helpers",
+      "helpers/README.md",
+      "skills",
+      "skills/README.md",
+      "docs",
+      "docs/governed-workspace-primitives.md",
+      "docs/adapter-contracts.md",
+      "docs/pipeline-architecture.md",
+      "studio",
+      "studio/package-lock.json",
+      "apps/creative-video-pipeline",
+      "apps/creative-video-pipeline/package-lock.json",
+      "apps/creative-video-pipeline/next.config.js",
+      "apps/creative-video-pipeline/lib/adapters",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-creative-video-pipeline-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-creative-video-pipeline-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.4.3"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-24T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/output/README.md

@@ -0,0 +1,23 @@
+# output/
+
+Pipeline output artifacts. Structure: `output/<client>/<project>/`
+
+```
+output/
+  <client>/
+    <project>/
+      brief/
+        pipeline-brief.md       ← Stage 1 output
+      generative/
+        manifest.json           ← GenerativeArtifact[] index
+        <artifact-id>.mp4       ← Generated video clips
+        <artifact-id>.jpg       ← Generated images
+      final/
+        final.mp4               ← Stage 3 output
+        edit-plan.md            ← video-use handoff artifact
+      .growthub-fork/
+        project.md              ← Governed progress log
+        trace.jsonl             ← Machine-readable stage events
+```
+
+This directory is gitignored. Do not commit client output artifacts.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/output-standards.md

@@ -0,0 +1,63 @@
+# Output Standards — Creative Video Pipeline
+
+All pipeline outputs land under:
+
+```
+output/<client-slug>/<project-slug>/
+├── brief/
+│   └── pipeline-brief.md          # Stage 1 deliverable — scene structure, hooks, brand constraints
+├── generative/
+│   ├── manifest.json              # Artifact list: {id, type, provider, url, localPath, nodeId}
+│   ├── *.jpg / *.png              # Generated images (if image nodes were included)
+│   └── *.mp4                      # Generated raw video clips from CMS node or BYOK provider
+└── final/
+    └── final.mp4                  # Stage 3 deliverable — edited, captioned, rendered output
+```
+
+## Stage 1 — Brief
+
+Required: `output/<client>/<project>/brief/pipeline-brief.md`
+
+Minimum contents:
+- Brand constraints box (from `messaging_guardrails` in brand-kit.md)
+- Scene structure table (N scenes)
+- Hook variations A–E for Scene 1
+- Editing guidelines section
+- Optional appendix: AI generation prompts (labeled OPTIONAL)
+
+## Stage 2 — Generative
+
+Required: `output/<client>/<project>/generative/manifest.json`
+
+`manifest.json` shape:
+```json
+[
+  {
+    "id": "<nodeId>-<index>",
+    "type": "video | image",
+    "provider": "growthub-pipeline | veo | fal | runway",
+    "nodeId": "<CMS node id or byo>",
+    "url": "<artifact URL from growthub or provider>",
+    "localPath": "output/<client>/<project>/generative/<filename>",
+    "generatedAt": "<ISO timestamp>",
+    "prompt": "<exact prompt used>"
+  }
+]
+```
+
+The growthub-pipeline adapter writes this manifest from official CLI/SDK `ExecutionEvent` data. The BYOK path writes the same shape from provider SDK responses.
+
+## Stage 3 — Edit
+
+Required: `output/<client>/<project>/final/final.mp4`
+
+The video-use fork renders to `${VIDEO_USE_HOME}/<project>/edit/final.mp4`. Copy or symlink to `output/<client>/<project>/final/final.mp4` after QA pass.
+
+Supporting artifacts (written to `output/<client>/<project>/final/` by the video-use agent):
+- `edit-decision-list.md` — transcript-anchored EDL
+- `render-plan.md` — FFmpeg filter graph
+- `qa-checklist.md` — twelve production rules checked
+
+## Session persistence
+
+Append to `.growthub-fork/project.md` at the completion of each stage.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/runtime-assumptions.md

@@ -0,0 +1,61 @@
+# Runtime Assumptions — Creative Video Pipeline
+
+## Required dependencies
+
+| Dependency | Version | Purpose |
+|---|---|---|
+| Node.js | >= 20 | CLI, Vite dev, Next.js dev |
+| Git | any | Fork registration |
+| FFmpeg | any | Stage 3 video render |
+| Python 3 | >= 3.11 | video-use upstream pipeline |
+| pip | any | video-use install |
+
+Optional:
+
+| Dependency | Purpose |
+|---|---|
+| yt-dlp | Downloading online source clips for Stage 3 |
+
+## Required secrets
+
+| Env var | Required when | Notes |
+|---|---|---|
+| `ELEVENLABS_API_KEY` | Always (Stage 3) | ElevenLabs Scribe word-level transcription |
+| `GROWTHUB_BRIDGE_ACCESS_TOKEN` | `ADAPTER=growthub-pipeline` | Auth token from `growthub auth login` |
+| `GROWTHUB_BRIDGE_BASE_URL` | `ADAPTER=growthub-pipeline` | Growthub hosted base URL |
+| `GOOGLE_AI_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=veo` | Google AI / Vertex key |
+| `FAL_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=fal` | fal.ai key |
+| `RUNWAY_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=runway` | Runway key |
+
+## Workspace paths
+
+| Path | Default | Purpose |
+|---|---|---|
+| `CREATIVE_VIDEO_PIPELINE_HOME` | `$HOME/creative-video-pipeline` | Kit workspace root |
+| `VIDEO_USE_HOME` | `$HOME/video-use` | video-use upstream fork |
+| `CREATIVE_STRATEGIST_HOME` | `$HOME/creative-strategist` | Optional: hooks library source |
+
+## Growthub CLI
+
+Minimum version: `0.4.3`. Verify:
+
+```bash
+growthub --version
+```
+
+Required for `growthub pipeline execute` (Stage 2, primary adapter) and `growthub kit fork` commands.
+
+## video-use fork
+
+Cloned to `${VIDEO_USE_HOME:-$HOME/video-use}` by `setup/clone-fork.sh`. Registered as a Claude Code skill by `setup/install-skill.sh`. Required for Stage 3.
+
+## Claude Code skill
+
+`~/.claude/skills/video-use` symlink must be present for conversational edit flow. Set up by `setup/install-skill.sh`.
+
+## Credential hygiene
+
+- No secrets are stored in this kit.
+- All secrets live in the per-fork `.env` (not committed).
+- `ELEVENLABS_API_KEY` must never appear in any output artifact.
+- Provider keys must never appear in any output artifact.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/check-deps.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PASS=0; FAIL=0
+
+check() {
+  if command -v "$1" &>/dev/null; then
+    echo "  [ok] $1"
+    ((PASS++))
+  else
+    echo "  [missing] $1"
+    ((FAIL++))
+  fi
+}
+
+echo "=== growthub-creative-video-pipeline-v1 dependency check ==="
+echo ""
+echo "CLI tools:"
+check growthub
+check node
+check npm
+check ffmpeg
+
+echo ""
+echo "Optional (video-use fork):"
+if [ -n "${VIDEO_USE_HOME:-}" ] && [ -d "$VIDEO_USE_HOME" ]; then
+  echo "  [ok] VIDEO_USE_HOME=$VIDEO_USE_HOME"
+else
+  echo "  [missing] VIDEO_USE_HOME — set and point to video-use fork clone"
+fi
+
+echo ""
+echo "Environment:"
+for var in CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER ELEVENLABS_API_KEY; do
+  if [ -n "${!var:-}" ]; then
+    echo "  [ok] $var"
+  else
+    echo "  [missing] $var"
+  fi
+done
+
+ADAPTER="${CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER:-growthub-pipeline}"
+if [ "$ADAPTER" = "growthub-pipeline" ]; then
+  for var in GROWTHUB_BRIDGE_ACCESS_TOKEN GROWTHUB_BRIDGE_BASE_URL; do
+    if [ -n "${!var:-}" ]; then
+      echo "  [ok] $var"
+    else
+      echo "  [missing] $var (required for growthub-pipeline adapter)"
+    fi
+  done
+elif [ "$ADAPTER" = "byo-api-key" ]; then
+  for var in VIDEO_MODEL_PROVIDER; do
+    if [ -n "${!var:-}" ]; then
+      echo "  [ok] $var"
+    else
+      echo "  [missing] $var (required for byo-api-key adapter)"
+    fi
+  done
+fi
+
+echo ""
+echo "Result: $PASS ok, $FAIL missing"
+[ "$FAIL" -eq 0 ] && echo "All required dependencies present." || echo "Fix missing items before running the pipeline."

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/clone-fork.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DEST="${VIDEO_USE_HOME:-$HOME/video-use}"
+
+if [ -d "$DEST/.git" ]; then
+  echo "video-use fork already cloned at $DEST"
+  exit 0
+fi
+
+echo "Clone the video-use fork into $DEST, then re-run this script or set VIDEO_USE_HOME."
+echo ""
+echo "  git clone <your-video-use-fork-url> $DEST"
+echo ""
+echo "After cloning, install dependencies:"
+echo "  cd $DEST && npm install"
+echo ""
+echo "Then set VIDEO_USE_HOME=$DEST in your .env.local"

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/install-skill.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SKILL_SRC="$(cd "$(dirname "$0")/.." && pwd)/SKILL.md"
+DEST_DIR="$HOME/.claude/skills/growthub-creative-video-pipeline"
+
+mkdir -p "$DEST_DIR"
+cp "$SKILL_SRC" "$DEST_DIR/SKILL.md"
+echo "Skill installed to $DEST_DIR/SKILL.md"
+echo "Reload Claude Code (or open a new session) to activate."

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/verify-env.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+
+const ROOT = new URL("..", import.meta.url).pathname;
+const envFile = resolve(ROOT, ".env.local");
+
+if (existsSync(envFile)) {
+  const lines = readFileSync(envFile, "utf8").split("\n");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const [key, ...rest] = trimmed.split("=");
+    if (key && rest.join("=")) process.env[key] = rest.join("=");
+  }
+}
+
+const REQUIRED = [
+  "CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER",
+  "ELEVENLABS_API_KEY",
+];
+
+const ADAPTER_DEPS = {
+  "growthub-pipeline": ["GROWTHUB_BRIDGE_ACCESS_TOKEN", "GROWTHUB_BRIDGE_BASE_URL"],
+  "byo-api-key": ["VIDEO_MODEL_PROVIDER"],
+};
+
+const errors = [];
+
+for (const key of REQUIRED) {
+  if (!process.env[key]) errors.push(`Missing required: ${key}`);
+}
+
+const adapter = process.env.CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER ?? "growthub-pipeline";
+const adapterDeps = ADAPTER_DEPS[adapter] ?? [];
+for (const key of adapterDeps) {
+  if (!process.env[key]) errors.push(`Missing for ${adapter} adapter: ${key}`);
+}
+
+if (!process.env.VIDEO_USE_HOME) {
+  errors.push("Missing VIDEO_USE_HOME (required for Stage 3)");
+}
+
+if (errors.length) {
+  console.error("Environment verification failed:");
+  for (const e of errors) console.error(`  - ${e}`);
+  process.exit(1);
+} else {
+  console.log("Environment verified.");
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/README.md

@@ -0,0 +1,11 @@
+# skills/
+
+Sub-skills for the creative-video-pipeline operator. Each sub-skill is a self-contained governed primitive with its own SKILL.md.
+
+| Sub-skill | Stage | Purpose |
+|-----------|-------|---------|
+| brief-generation | Stage 1 | Brand-grounded creative brief from brand-kit.md |
+| generative-execution | Stage 2 | Adapter-routed generative image/video execution |
+| video-edit | Stage 3 | video-use fork delegation: Scribe → EDL → FFmpeg |
+
+The top-level `SKILL.md` at the kit root composes all three sub-skills into the full three-stage pipeline.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/brief-generation/SKILL.md

@@ -0,0 +1,42 @@
+---
+id: creative-video-pipeline/brief-generation
+name: creative-video-pipeline-brief-generation
+description: Generate the Stage 1 brand-grounded pipeline brief from the worker kit brand kit and write output artifacts.
+version: 1.0.0
+triggers:
+  - "generate creative brief"
+  - "run brief stage"
+  - "stage 1 brief"
+  - "write pipeline brief"
+selfEval:
+  criteria:
+    - "Brief is sourced exclusively from brand-kit.md — no invented brand attributes"
+    - "Scene structure matches brand hook patterns"
+    - "pipeline-brief.md written to output/<client>/<project>/brief/"
+    - "project.md appended with Stage 1 completion"
+    - "trace.jsonl event written for stage-complete"
+  maxRetries: 3
+---
+
+# Brief Generation Sub-Skill
+
+## Role
+Generate a brand-grounded creative brief for Stage 1 of the creative video pipeline.
+
+## Input
+- `brands/<client>/brand-kit.md` — brand constraints, audience, hooks, tone
+- `CREATIVE_STRATEGIST_HOME` (optional) — for 500-winning-hooks.csv reference
+- Client name + project name
+
+## Process
+1. Read `brands/<client>/brand-kit.md` in full
+2. Identify brand tone, audience, hook patterns, and platform format
+3. Populate `templates/pipeline-brief.md` — do not invent brand attributes
+4. Write output to `output/<client>/<project>/brief/pipeline-brief.md`
+5. Append Stage 1 completion entry to `.growthub-fork/project.md`
+6. Append `{"type":"stage-complete","stage":"brief","ts":"<iso>"}` to `trace.jsonl`
+
+## Output
+- `output/<client>/<project>/brief/pipeline-brief.md`
+- Updated `.growthub-fork/project.md`
+- Updated `trace.jsonl`

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/generative-execution/SKILL.md

@@ -0,0 +1,86 @@
+---
+id: creative-video-pipeline/generative-execution
+name: creative-video-pipeline-generative-execution
+description: Run Stage 2 generative execution through the selected adapter and write the generative manifest.
+version: 1.0.0
+triggers:
+  - "run generative stage"
+  - "stage 2 generate"
+  - "generate video"
+  - "execute pipeline generation"
+selfEval:
+  criteria:
+    - "Adapter selected from CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER env var"
+    - "growthub-pipeline path: DynamicRegistryPipeline JSON assembled from brief, growthub pipeline execute called directly"
+    - "byo-api-key path: VIDEO_MODEL_PROVIDER resolved, provider SDK called"
+    - "manifest.json written to output/<client>/<project>/generative/ with execution results"
+    - "project.md and trace.jsonl updated with Stage 2 completion"
+  maxRetries: 3
+helpers:
+  - "helpers/check-generative-adapter.sh"
+  - "helpers/run-pipeline.sh"
+---
+
+# Generative Execution Sub-Skill
+
+## Role
+Execute Stage 2 via the official growthub CLI + `@growthub/api-contract` SDK. No custom execution layer.
+
+## Adapter: growthub-pipeline (primary)
+
+```bash
+# Auth pre-flight
+growthub auth whoami --json || { echo "Run: growthub auth login"; exit 1; }
+
+# Assemble DynamicRegistryPipeline from the Stage 1 brief, then execute:
+growthub pipeline execute '<DynamicRegistryPipeline JSON>'
+```
+
+**`DynamicRegistryPipeline` shape (from `@growthub/api-contract`):**
+```json
+{
+  "pipelineId": "<uuid>",
+  "executionMode": "hosted",
+  "nodes": [
+    {
+      "nodeId": "video-gen-1",
+      "slug": "video-generation",
+      "bindings": {
+        "videoModel": "veo-3.1-generate-001",
+        "prompt": "<scene prompt from brief>",
+        "seconds": 8,
+        "aspectRatio": "9:16",
+        "creativeCount": 1,
+        "refs": [
+          { "name": "brand_reference", "dataUrl": "data:image/jpeg;base64,<base64>" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+The CLI streams NDJSON `ExecutionEvent` objects typed by `@growthub/api-contract`. Use `isExecutionEvent()` to validate each line. The `complete` event signals success; the `error` event signals failure.
+
+## Adapter: byo-api-key (secondary)
+Resolve `VIDEO_MODEL_PROVIDER` (veo | fal | runway), call the provider SDK directly.
+
+## Output
+Write `output/<client>/<project>/generative/manifest.json`:
+```json
+{
+  "kitId": "growthub-creative-video-pipeline-v1",
+  "adapter": "growthub-pipeline",
+  "executionId": "<from complete event>",
+  "createdAt": "<iso>",
+  "artifacts": [/* urls/paths from execution output */]
+}
+```
+
+## Process
+1. Read `CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER`
+2. Run `helpers/check-generative-adapter.sh`
+3. Assemble `DynamicRegistryPipeline` JSON from Stage 1 brief prompts and reference images
+4. Execute: `bash helpers/run-pipeline.sh '<payload>'`
+5. Write `manifest.json` from the execution result
+6. Append Stage 2 completion to `project.md` and `trace.jsonl`