@growthub/cli 0.8.1 → 0.8.2

package/assets/worker-kits/growthub-creative-video-pipeline-v1/docs/adapter-contracts.md

@@ -0,0 +1,73 @@
+# Adapter Contracts
+
+## Execution — growthub-pipeline (primary)
+
+The official CLI + SDK is the execution layer. No custom wrapper.
+
+```bash
+growthub pipeline execute '<DynamicRegistryPipeline JSON>'
+```
+
+**SDK types:** `@growthub/api-contract`
+- Input: `DynamicRegistryPipeline` — pipelineId, executionMode, nodes[].{nodeId, slug, bindings}
+- Events: `ExecutionEvent` — validated with `isExecutionEvent()`
+- Event types: `node_start`, `node_complete`, `node_error`, `progress`, `credit_warning`, `complete`, `error`
+
+**Required env:**
+- `GROWTHUB_BRIDGE_ACCESS_TOKEN`
+- `GROWTHUB_BRIDGE_BASE_URL`
+- Valid session from `growthub auth login` (`~/.claude/config/session.json`)
+
+**Auth pre-flight:**
+```bash
+growthub auth whoami --json
+```
+
+**Payload (DynamicRegistryPipeline):**
+```json
+{
+  "pipelineId": "<uuid>",
+  "executionMode": "hosted",
+  "nodes": [
+    {
+      "nodeId": "video-gen-1",
+      "slug": "video-generation",
+      "bindings": {
+        "videoModel": "veo-3.1-generate-001",
+        "prompt": "<scene prompt>",
+        "seconds": 8,
+        "aspectRatio": "9:16",
+        "creativeCount": 1,
+        "refs": [{ "name": "brand_reference", "dataUrl": "data:image/jpeg;base64,<b64>" }]
+      }
+    }
+  ]
+}
+```
+
+---
+
+## Execution — byo-api-key (secondary)
+
+**Required env:**
+- `VIDEO_MODEL_PROVIDER` — `veo` | `fal` | `runway`
+- Provider key: `GOOGLE_AI_API_KEY` / `FAL_API_KEY` / `RUNWAY_API_KEY`
+
+Call the provider SDK directly. No CLI wrapper.
+
+---
+
+## Manifest (output contract)
+
+`output/<client>/<project>/generative/manifest.json`:
+```json
+{
+  "kitId": "growthub-creative-video-pipeline-v1",
+  "adapter": "growthub-pipeline",
+  "executionId": "<from complete event>",
+  "createdAt": "<iso>",
+  "artifacts": [{ "url": "<artifact url>", "type": "video", "nodeId": "..." }]
+}
+```
+
+This is the Stage 2 → Stage 3 handoff artifact. Stage 3 reads this to locate source clips.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/docs/governed-workspace-primitives.md

@@ -0,0 +1,50 @@
+# Governed Workspace Primitives v1.2
+
+This kit implements the six-primitive governed-workspace contract.
+
+## Primitive 1 — SKILL.md
+
+Top-level `SKILL.md` at the kit root. Frontmatter declares triggers, selfEval criteria (5 items), maxRetries:3, helpers[], and subSkills[].
+
+## Primitive 2 — AGENTS.md Pointer
+
+`workers/creative-video-pipeline-operator/CLAUDE.md` serves as the operator contract. References the repo-level `AGENTS.md` as authoritative agent contract.
+
+## Primitive 3 — project.md
+
+`.growthub-fork/project.md` seeded from `templates/project.md` at fork register time via `scaffoldSessionMemory`. Contains `pipelineState` frontmatter tracking stage status.
+
+Every stage boundary appends a log entry:
+```
+## Stage N Complete — <stage-name>
+Date: <iso>
+Output: <artifact path>
+```
+
+## Primitive 4 — selfEval
+
+`templates/self-eval.md` provides the self-eval template. `recordSelfEval` in `cli/src/skills/self-eval.ts` is the canonical primitive. maxRetries:3 applies to all three stages.
+
+## Primitive 5 — Sub-skills
+
+`skills/` directory contains three sub-skill SKILL.md files:
+- `skills/brief-generation/SKILL.md`
+- `skills/generative-execution/SKILL.md`
+- `skills/video-edit/SKILL.md`
+
+## Primitive 6 — Helpers
+
+`helpers/` directory contains safe shell wrappers:
+- `helpers/run-pipeline.sh` — wraps `growthub pipeline execute`
+- `helpers/check-generative-adapter.sh` — validates adapter env
+
+## trace.jsonl
+
+Machine-readable governance log. Each stage boundary writes:
+```json
+{"type":"stage-complete","stage":"brief","ts":"<iso>"}
+{"type":"stage-complete","stage":"generative","ts":"<iso>"}
+{"type":"stage-complete","stage":"edit","ts":"<iso>"}
+```
+
+Additional event types: `auth-preflight`, `adapter-selected`, `artifact-written`, `self-eval-pass`, `self-eval-retry`.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/docs/pipeline-architecture.md

@@ -0,0 +1,61 @@
+# Pipeline Architecture
+
+## Stage 1 — Brief
+
+**Input:** `brands/<client>/brand-kit.md`  
+**Process:** Brand-constrained scene structure and hook generation  
+**Output:** `output/<client>/<project>/brief/pipeline-brief.md`
+
+The brief stage is purely Claude-driven. No external API calls. The brand-kit.md is the sole source of truth for brand voice, audience, scene count, and hook patterns. Optional: reference `CREATIVE_STRATEGIST_HOME/hooks/500-winning-hooks.csv` for hook inspiration — never as brand override.
+
+## Stage 2 — Generate
+
+**Input:** `pipeline-brief.md` scene prompts + reference images  
+**Output:** `GenerativeArtifact[]` + `output/<client>/<project>/generative/manifest.json`
+
+Two adapter paths with identical output contracts:
+
+### growthub-pipeline (primary)
+```
+DynamicRegistryPipeline JSON → growthub pipeline execute → NDJSON stream
+→ official CLI/SDK ExecutionEvent handling → GenerativeArtifact[]
+```
+Node: `video-generation` / Model: `veo-3.1-generate-001`
+
+### byo-api-key (secondary)
+```
+VIDEO_MODEL_PROVIDER (veo|fal|runway) → provider SDK → GenerativeArtifact[]
+```
+
+## Stage 3 — Edit
+
+**Input:** `manifest.json` source clips + `pipeline-brief.md` editing guidelines  
+**Process:** Delegate entirely to `VIDEO_USE_HOME` video-use fork  
+**Output:** `output/<client>/<project>/final/final.mp4`
+
+```
+edit-plan.md (handoff) → video-use fork → ElevenLabs Scribe → word-boundary EDL → FFmpeg → final.mp4
+```
+
+The kit does NOT inline any video-use logic. The `edit-plan.md` is the only interface.
+
+## Data Flow
+
+```
+brand-kit.md
+    │
+    ▼ Stage 1
+pipeline-brief.md
+    │
+    ▼ Stage 2 (adapter-routed)
+GenerativeArtifact[] + manifest.json
+    │
+    ▼ Stage 3 (video-use delegation)
+final.mp4
+```
+
+## Governance
+
+Every stage boundary appends:
+- `.growthub-fork/project.md` — human-readable progress log
+- `trace.jsonl` — machine-readable stage events

package/assets/worker-kits/growthub-creative-video-pipeline-v1/docs/starter-kit-overview.md

@@ -0,0 +1,33 @@
+# Starter Kit Overview
+
+`growthub-creative-video-pipeline-v1` is a fully self-contained worker kit that composes three governed primitives into a single three-stage creative video pipeline.
+
+## What's Included
+
+| Surface | Description |
+|---------|-------------|
+| `studio/` | Vite 5 + React 18 local-first UI shell |
+| `apps/creative-video-pipeline/` | Next.js 16 + React 19 Vercel-deployable app |
+| `workers/creative-video-pipeline-operator/` | Governed worker contract |
+| `skills/` | Three sub-skill primitives (brief, generative, edit) |
+| `helpers/` | Safe shell wrappers |
+| `templates/` | Governed output templates |
+| `brands/` | Brand kit template + Growthub reference brand |
+| `setup/` | Dependency check, env verify, fork clone, skill install |
+| `docs/` | Architecture, adapter contracts, deployment |
+
+## Three-Stage Pipeline
+
+```
+Stage 1 — Brief      brands/<client>/brand-kit.md → pipeline-brief.md
+Stage 2 — Generate   growthub-pipeline | byo-api-key → GenerativeArtifact[] + manifest.json
+Stage 3 — Edit       VIDEO_USE_HOME fork → Scribe → EDL → FFmpeg → final.mp4
+```
+
+## Governed Workspace
+
+Every stage boundary writes:
+- Updated `.growthub-fork/project.md`
+- A `{"type":"stage-complete","stage":"<name>","ts":"<iso>"}` event to `trace.jsonl`
+
+See `docs/governed-workspace-primitives.md` for the full primitive contract.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/docs/vercel-deployment.md

@@ -0,0 +1,42 @@
+# Vercel Deployment
+
+## Deploy the Next.js App
+
+```bash
+cd apps/creative-video-pipeline
+vercel --prod
+```
+
+Or connect the `apps/creative-video-pipeline` directory in the Vercel dashboard.
+
+## Environment Variables
+
+Set these in Vercel → Project → Settings → Environment Variables:
+
+| Variable | Required | Notes |
+|----------|----------|-------|
+| `CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER` | yes | `growthub-pipeline` or `byo-api-key` |
+| `GROWTHUB_BRIDGE_ACCESS_TOKEN` | adapter | growthub-pipeline only |
+| `GROWTHUB_BRIDGE_BASE_URL` | adapter | growthub-pipeline only |
+| `ELEVENLABS_API_KEY` | yes | Stage 3 transcription |
+| `VIDEO_MODEL_PROVIDER` | adapter | byo-api-key only |
+| `GOOGLE_AI_API_KEY` | conditional | veo provider |
+| `FAL_API_KEY` | conditional | fal provider |
+| `RUNWAY_API_KEY` | conditional | runway provider |
+| `VIDEO_USE_HOME` | yes | Path to video-use fork (server-side Stage 3) |
+
+## vercel.json
+
+```json
+{
+  "framework": "nextjs",
+  "buildCommand": "npm run build",
+  "installCommand": "npm install"
+}
+```
+
+## Notes
+
+- All pages using `readAdapterConfig()` or `describeGenerativeAdapter()` run server-side — env vars are never exposed to the client.
+- `app/api/pipeline/route.js` uses `export const dynamic = "force-dynamic"` to read live env state at request time.
+- The studio Vite shell (`studio/`) is local-only and is not deployed to Vercel.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/examples/pipeline-brief-sample.md

@@ -0,0 +1,56 @@
+---
+client: growthub
+project: launch-2025
+stage: brief
+brand_kit: brands/growthub/brand-kit.md
+created_at: 2025-01-15T10:00:00Z
+---
+
+# Pipeline Brief — Growthub Launch 2025
+
+## Brand Constraints
+| Constraint | Value |
+|------------|-------|
+| Primary Colour | #38bdf8 (sky blue) |
+| Tone | Direct, capable, builder-focused |
+| Target Audience | Indie founders, solo operators, small creative teams |
+| Platform | Instagram Reels / TikTok |
+| Format | 9:16 vertical, 30s |
+| Scene Count | 3 |
+
+## Brief Overview
+| Field | Value |
+|-------|-------|
+| Campaign Goal | Launch awareness for Growthub governed worker kits |
+| Core Message | From brief to final video in three governed stages |
+| CTA | Try the pipeline today |
+
+## Scene Structure
+| Scene | Duration | Hook Type | B-Roll Notes |
+|-------|----------|-----------|--------------|
+| 1 | 8s | Problem-agitation | Developer staring at blank terminal |
+| 2 | 14s | Solution demo | Pipeline running, artifacts materialising |
+| 3 | 8s | Social proof + CTA | Finished video output, Growthub branding |
+
+## Scene 1 — Hook Variations
+**A.** "You've been stuck on the brief for 3 hours. The pipeline has it in 30 seconds."  
+**B.** "Stop designing workflows. Start shipping governed ones."  
+**C.** "Brief to final video. Three stages. Zero guesswork."  
+**D.** "Every creative decision is logged. Every output is governed."  
+**E.** "The video pipeline that actually ships."
+
+## Scene 2 — Solution Demo
+Generative prompt: A clean dark terminal UI showing a three-stage pipeline strip — Brief, Generate, Edit — each card lighting up in sequence. Sky-blue accent colours. Text overlay: "governed workspace". Cinematic, confident pacing.
+
+## Scene 3 — CTA
+Generative prompt: Split screen — pipeline dashboard on the left, finished .mp4 playing on the right. Growthub wordmark animates in bottom-left. Text: "Try it today." Sky-blue text on dark background.
+
+## Editing Guidelines
+- Cut on beat (lo-fi electronic track, 100 BPM)
+- Scene 1→2 hard cut at 8s
+- Scene 2→3 fade at 22s
+- Captions: word-boundary subtitles via ElevenLabs Scribe
+- Final frame hold: 2s on CTA
+
+---
+*Generated by creative-video-pipeline-operator Stage 1 — Brief*

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

@@ -0,0 +1,9 @@
+# growthub-meta/
+
+Kit metadata consumed by the Growthub registry and CLI export tooling.
+
+| File | Purpose |
+|------|---------|
+| `kit-standard.md` | Kit standard version, outputStandard contract, and upgrade notes |
+
+These files are read by `growthub worker-kit export` and `growthub worker-kit validate`.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,24 @@
+# Kit Standard
+
+## Version
+- Kit: `growthub-creative-video-pipeline-v1`
+- Schema: `2`
+- Standard: `v1.2`
+- CLI minimum: `0.4.3`
+
+## outputStandard
+
+Required paths for a complete pipeline run:
+```
+output/<client>/<project>/brief/pipeline-brief.md
+output/<client>/<project>/generative/manifest.json
+output/<client>/<project>/final/final.mp4
+output/<client>/<project>/.growthub-fork/project.md
+output/<client>/<project>/.growthub-fork/trace.jsonl
+```
+
+## Upgrade Notes
+
+- v1 → v2 schema: `frozenAssetPaths` array added. All asset paths enumerated in `kit.json`.
+- outputStandard v1.2: `trace.jsonl` required at every stage boundary (previously optional).
+- Adapter contract v1.0: `GenerativeArtifact[]` normalisation required for both adapters.

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.