@growthub/cli 0.8.1 → 0.9.0

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

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# check-pipeline-health.sh
+#
+# Composable end-to-end readiness check for the creative-video-pipeline kit.
+# Wraps existing setup/verify-env.mjs + helpers/check-generative-adapter.sh
+# and adds checks that span all three stages (sub-skills present, helpers
+# executable, output dir writable, Stage-3 deps).
+#
+# Usage:
+#   bash helpers/check-pipeline-health.sh           # human output, exit non-zero on failure
+#   bash helpers/check-pipeline-health.sh --json    # JSON report on stdout
+#
+# Convention: docs/PIPELINE_KIT_CONTRACT_V1.md (kit-local health helper)
+set -uo pipefail
+
+JSON_MODE=0
+if [ "${1:-}" = "--json" ]; then
+  JSON_MODE=1
+fi
+
+KIT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+PASS=()
+FAIL=()
+WARN=()
+
+record_pass() { PASS+=("$1"); }
+record_fail() { FAIL+=("$1"); }
+record_warn() { WARN+=("$1"); }
+
+# --- Load .env / .env.local if present (for inherited shell, mjs reads its own) ---
+for env_file in "$KIT_ROOT/.env" "$KIT_ROOT/.env.local"; do
+  if [ -f "$env_file" ]; then
+    set -a
+    # shellcheck disable=SC1090
+    . "$env_file"
+    set +a
+  fi
+done
+
+# --- 1. .env presence ---
+if [ -f "$KIT_ROOT/.env" ] || [ -f "$KIT_ROOT/.env.local" ]; then
+  record_pass "env-file-present"
+elif [ -f "$KIT_ROOT/.env.example" ]; then
+  record_warn "env-file-missing-but-example-available"
+else
+  record_fail "env-file-missing-and-no-example"
+fi
+
+# --- 2. setup/verify-env.mjs passes ---
+if [ -f "$KIT_ROOT/setup/verify-env.mjs" ]; then
+  if node "$KIT_ROOT/setup/verify-env.mjs" >/dev/null 2>&1; then
+    record_pass "verify-env"
+  else
+    record_fail "verify-env"
+  fi
+else
+  record_fail "verify-env-script-missing"
+fi
+
+# --- 3. helpers/check-generative-adapter.sh passes ---
+if [ -x "$KIT_ROOT/helpers/check-generative-adapter.sh" ]; then
+  if bash "$KIT_ROOT/helpers/check-generative-adapter.sh" >/dev/null 2>&1; then
+    record_pass "generative-adapter-env"
+  else
+    record_fail "generative-adapter-env"
+  fi
+else
+  record_fail "check-generative-adapter-not-executable"
+fi
+
+# --- 4. VIDEO_USE_HOME resolves to a directory ---
+if [ -n "${VIDEO_USE_HOME:-}" ] && [ -d "${VIDEO_USE_HOME}" ]; then
+  record_pass "video-use-home"
+else
+  record_fail "video-use-home-missing-or-not-a-directory"
+fi
+
+# --- 5. ELEVENLABS_API_KEY (Stage 3 transcription) ---
+if [ -n "${ELEVENLABS_API_KEY:-}" ]; then
+  record_pass "elevenlabs-api-key"
+else
+  record_fail "elevenlabs-api-key-missing"
+fi
+
+# --- 6. output/ writable ---
+mkdir -p "$KIT_ROOT/output" 2>/dev/null || true
+if [ -w "$KIT_ROOT/output" ]; then
+  record_pass "output-dir-writable"
+else
+  record_fail "output-dir-not-writable"
+fi
+
+# --- 7. Stage sub-skills present ---
+for stage in brief-generation generative-execution video-edit; do
+  if [ -f "$KIT_ROOT/skills/$stage/SKILL.md" ]; then
+    record_pass "sub-skill-$stage"
+  else
+    record_fail "sub-skill-$stage-missing"
+  fi
+done
+
+# --- 8. Helpers executable ---
+for helper in run-pipeline.sh check-generative-adapter.sh check-pipeline-health.sh; do
+  helper_path="$KIT_ROOT/helpers/$helper"
+  if [ -f "$helper_path" ] && [ -r "$helper_path" ]; then
+    record_pass "helper-$helper"
+  else
+    record_fail "helper-$helper-missing"
+  fi
+done
+
+# --- 9. pipeline.manifest.json + workspace.dependencies.json present (kit contract v1) ---
+for manifest in pipeline.manifest.json workspace.dependencies.json; do
+  if [ -f "$KIT_ROOT/$manifest" ]; then
+    record_pass "manifest-$manifest"
+  else
+    record_warn "manifest-$manifest-missing"
+  fi
+done
+
+# --- Render result ---
+if [ "$JSON_MODE" = "1" ]; then
+  printf '{'
+  printf '"kitId":"growthub-creative-video-pipeline-v1",'
+  printf '"convention":"docs/PIPELINE_KIT_CONTRACT_V1.md",'
+  printf '"pass":['
+  for i in "${!PASS[@]}"; do
+    [ "$i" -gt 0 ] && printf ','
+    printf '"%s"' "${PASS[$i]}"
+  done
+  printf '],"warn":['
+  for i in "${!WARN[@]}"; do
+    [ "$i" -gt 0 ] && printf ','
+    printf '"%s"' "${WARN[$i]}"
+  done
+  printf '],"fail":['
+  for i in "${!FAIL[@]}"; do
+    [ "$i" -gt 0 ] && printf ','
+    printf '"%s"' "${FAIL[$i]}"
+  done
+  printf ']}\n'
+else
+  echo "[check-pipeline-health] Kit: growthub-creative-video-pipeline-v1"
+  for item in "${PASS[@]}"; do echo "  PASS  $item"; done
+  for item in "${WARN[@]}"; do echo "  WARN  $item"; done
+  for item in "${FAIL[@]}"; do echo "  FAIL  $item" >&2; done
+  echo "[check-pipeline-health] pass=${#PASS[@]} warn=${#WARN[@]} fail=${#FAIL[@]}"
+fi
+
+if [ "${#FAIL[@]}" -gt 0 ]; then
+  exit 1
+fi
+exit 0

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,154 @@
+{
+  "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",
+    "pipeline.manifest.json",
+    "workspace.dependencies.json",
+    "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",
+    "helpers/check-pipeline-health.sh",
+    "validation/e2e-reference.md",
+    "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",
+      "pipeline.manifest.json",
+      "workspace.dependencies.json",
+      "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/pipeline.manifest.json

@@ -0,0 +1,83 @@
+{
+  "version": 1,
+  "kitId": "growthub-creative-video-pipeline-v1",
+  "pipelineId": "creative-video-pipeline",
+  "outputTopology": {
+    "root": "output/<client>/<project>",
+    "buckets": ["brief", "generative", "final"]
+  },
+  "tracePolicy": {
+    "convention": "docs/PIPELINE_TRACE_CONVENTION_V1.md",
+    "traceFile": ".growthub-fork/trace.jsonl",
+    "projectMemoryFile": ".growthub-fork/project.md"
+  },
+  "sessionMemoryPolicy": {
+    "seedTemplate": "templates/project.md",
+    "appendOn": ["stage-completed", "stage-failed", "self-eval"]
+  },
+  "stages": [
+    {
+      "id": "brief-generation",
+      "label": "Brief",
+      "subSkillPath": "skills/brief-generation/SKILL.md",
+      "inputArtifacts": [
+        "brands/<client>/brand-kit.md"
+      ],
+      "outputArtifacts": [
+        "output/<client>/<project>/brief/pipeline-brief.md"
+      ],
+      "helperPaths": [],
+      "adapterModes": [],
+      "externalDependencies": [],
+      "traceRequired": true,
+      "projectMemoryRequired": true
+    },
+    {
+      "id": "generative-execution",
+      "label": "Generate",
+      "subSkillPath": "skills/generative-execution/SKILL.md",
+      "inputArtifacts": [
+        "output/<client>/<project>/brief/pipeline-brief.md"
+      ],
+      "outputArtifacts": [
+        "output/<client>/<project>/generative/manifest.json"
+      ],
+      "helperPaths": [
+        "helpers/run-pipeline.sh",
+        "helpers/check-generative-adapter.sh"
+      ],
+      "adapterModes": [
+        "growthub-pipeline",
+        "byo-api-key"
+      ],
+      "externalDependencies": [],
+      "traceRequired": true,
+      "projectMemoryRequired": true
+    },
+    {
+      "id": "video-edit",
+      "label": "Edit",
+      "subSkillPath": "skills/video-edit/SKILL.md",
+      "inputArtifacts": [
+        "output/<client>/<project>/generative/manifest.json",
+        "output/<client>/<project>/brief/pipeline-brief.md"
+      ],
+      "outputArtifacts": [
+        "output/<client>/<project>/final/final.mp4"
+      ],
+      "helperPaths": [],
+      "adapterModes": [],
+      "externalDependencies": ["video-use"],
+      "traceRequired": true,
+      "projectMemoryRequired": true
+    }
+  ],
+  "convention": {
+    "spec": "docs/PIPELINE_KIT_CONTRACT_V1.md",
+    "sdkType": "@growthub/api-contract/pipeline-kits#PipelineKitManifest",
+    "sdkVersion": 1,
+    "version": 1,
+    "interpretedBy": ["growthub kit pipeline inspect", "agents", "operators"],
+    "runtimeEnforcement": "none"
+  }
+}

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."