@growthub/cli 0.8.0 → 0.8.2

package/assets/worker-kits/growthub-creative-video-pipeline-v1/studio/src/app.css

@@ -0,0 +1,194 @@
+:root {
+  color-scheme: dark;
+  --bg: #080b12;
+  --sidebar: #0d1118;
+  --panel: #111827;
+  --panel-soft: #0d1420;
+  --ink: #f7fafc;
+  --muted: #93a3b8;
+  --line: #223047;
+  --accent: #38bdf8;
+  --accent-soft: rgba(56, 189, 248, 0.12);
+  --good: #22c55e;
+  --warn: #f59e0b;
+}
+
+* { box-sizing: border-box; }
+html { scroll-behavior: smooth; }
+body {
+  margin: 0;
+  background: var(--bg);
+  color: var(--ink);
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+a { color: inherit; }
+code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.9em; }
+
+.shell {
+  min-height: 100vh;
+  display: grid;
+  grid-template-columns: 232px minmax(0, 1fr);
+  background: radial-gradient(circle at top right, rgba(56, 189, 248, 0.12), transparent 360px), var(--bg);
+}
+.sidebar {
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+  gap: 22px;
+  background: rgba(13, 17, 24, 0.96);
+  border-right: 1px solid var(--line);
+  padding: 22px 16px;
+}
+.brand { display: flex; align-items: center; gap: 10px; font-weight: 800; }
+.brand-mark {
+  width: 34px;
+  height: 34px;
+  display: grid;
+  place-items: center;
+  border-radius: 8px;
+  background: var(--accent);
+  color: #06111d;
+  font-size: 13px;
+  font-weight: 900;
+}
+.nav { display: grid; gap: 5px; }
+.nav a {
+  color: #c6d1e1;
+  text-decoration: none;
+  padding: 9px 10px;
+  border-radius: 7px;
+  font-size: 14px;
+  cursor: pointer;
+}
+.nav a:hover { background: #172133; color: white; }
+.sidebar-footer { margin-top: auto; display: flex; align-items: center; gap: 8px; color: var(--muted); font-size: 13px; }
+.status-dot { width: 8px; height: 8px; border-radius: 999px; background: var(--good); box-shadow: 0 0 0 4px rgba(34, 197, 94, 0.12); }
+.main { width: min(100%, 1180px); padding: 30px; }
+.utility-bar {
+  display: flex;
+  justify-content: space-between;
+  gap: 16px;
+  align-items: center;
+  margin-bottom: 20px;
+  padding: 12px 14px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: rgba(17, 24, 39, 0.82);
+}
+.utility-bar strong { display: block; font-size: 14px; }
+.utility-bar span, .page-heading p, .card p, .stage-card p, .setup-card p { color: var(--muted); line-height: 1.5; }
+.utility-actions { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+.utility-actions a, .pill {
+  display: inline-flex;
+  align-items: center;
+  min-height: 28px;
+  border: 1px solid var(--line);
+  border-radius: 999px;
+  padding: 5px 10px;
+  background: #0c1320;
+  color: #c9d7e8;
+  text-decoration: none;
+  font-size: 12px;
+  cursor: pointer;
+}
+.page-heading { margin-bottom: 22px; }
+.page-heading h1 { margin: 4px 0 8px; font-size: clamp(32px, 5vw, 58px); line-height: 0.98; letter-spacing: 0; }
+.page-heading p { max-width: 780px; margin: 0; }
+.eyebrow { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; letter-spacing: 0.12em; }
+
+/* Pipeline strip — three stages */
+.pipeline-strip {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
+  margin-bottom: 22px;
+}
+.stage-card {
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: rgba(17, 24, 39, 0.9);
+  padding: 18px;
+}
+.stage-step { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; }
+.stage-card strong { display: block; margin: 8px 0 6px; font-size: 18px; }
+.stage-card code { display: block; margin-top: 10px; color: #9ab8d8; font-size: 11px; word-break: break-all; }
+
+.hero-grid { display: grid; grid-template-columns: 1.2fr 0.9fr 0.9fr; gap: 14px; margin-bottom: 16px; }
+.hero-card {
+  min-height: 160px;
+  padding: 18px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: rgba(17, 24, 39, 0.9);
+}
+.hero-card.primary { background: linear-gradient(135deg, rgba(56, 189, 248, 0.18), rgba(17, 24, 39, 0.95)); }
+.hero-card span { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; }
+.hero-card strong { display: block; margin-top: 10px; font-size: 28px; line-height: 1; }
+.hero-card p { margin: 10px 0 0; color: var(--muted); line-height: 1.5; font-size: 13px; }
+
+.adapter-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-bottom: 18px; }
+.card { min-height: 100px; padding: 16px; border: 1px solid var(--line); border-radius: 8px; background: rgba(17, 24, 39, 0.9); }
+.card h3 { margin: 0 0 8px; font-size: 14px; color: var(--accent); }
+
+.ops-strip { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 12px; margin-bottom: 22px; }
+.ops-strip article { padding: 14px; border: 1px solid var(--line); border-radius: 8px; background: rgba(13, 20, 32, 0.88); }
+.ops-strip span { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; }
+.ops-strip strong { display: block; margin: 7px 0; font-size: 14px; }
+
+/* Settings panel */
+.settings-panel {
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: rgba(13, 20, 32, 0.95);
+  padding: 22px;
+  margin-bottom: 22px;
+}
+.settings-header { margin-bottom: 18px; }
+.settings-header h2 { margin: 0 0 8px; font-size: 20px; }
+.settings-header p { color: var(--muted); margin: 0; }
+.setup-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; margin-bottom: 18px; }
+.setup-card { padding: 14px; border: 1px solid var(--line); border-radius: 8px; background: rgba(13, 20, 32, 0.88); }
+.setup-card span { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; }
+.setup-card strong { display: block; margin: 7px 0; font-size: 14px; }
+.setup-card code { color: #d7e8ff; word-break: break-word; font-size: 12px; }
+.key-list { display: grid; gap: 8px; }
+.key-row { padding: 12px 14px; border: 1px solid var(--line); border-radius: 8px; background: #0a101b; }
+.key-row div { display: flex; align-items: center; gap: 8px; margin-bottom: 4px; }
+.key-row p { margin: 0; color: var(--muted); font-size: 13px; }
+.key-badge {
+  border-radius: 999px;
+  padding: 2px 7px;
+  font-size: 11px;
+  font-weight: 700;
+}
+.key-badge.required { background: rgba(56, 189, 248, 0.15); color: var(--accent); border: 1px solid rgba(56, 189, 248, 0.3); }
+.key-badge.optional { background: rgba(147, 163, 184, 0.1); color: var(--muted); border: 1px solid var(--line); }
+.settings-note { margin: 14px 0 0; color: var(--muted); font-size: 13px; }
+
+.quick-actions { position: fixed; right: 20px; bottom: 20px; display: grid; gap: 8px; width: 200px; }
+.quick-actions button {
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 10px 12px;
+  background: #0d1420;
+  color: var(--ink);
+  text-align: left;
+  font: inherit;
+  cursor: pointer;
+}
+.quick-actions button:hover { background: #172133; }
+
+@media (max-width: 1020px) {
+  .shell { grid-template-columns: 1fr; }
+  .sidebar { position: static; height: auto; }
+  .pipeline-strip, .hero-grid, .adapter-grid, .ops-strip, .setup-grid { grid-template-columns: 1fr; }
+  .quick-actions { position: static; width: auto; margin: 20px 30px; }
+}
+
+@media (max-width: 720px) {
+  .main { padding: 20px; }
+  .utility-bar { display: block; }
+  .utility-actions { margin-top: 10px; }
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/studio/src/main.jsx

@@ -0,0 +1,10 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import App from "./App.jsx";
+import "./app.css";
+
+createRoot(document.getElementById("root")).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/assets/worker-kits/growthub-creative-video-pipeline-v1/studio/vite.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: { port: 5180 },
+  build: { outDir: "dist", emptyOutDir: true },
+});

package/assets/worker-kits/growthub-creative-video-pipeline-v1/templates/edit-plan.md

@@ -0,0 +1,66 @@
+# Edit Plan — [CLIENT] / [PROJECT]
+> Stage 3 planning artifact. Hand this to the video-use agent alongside `pipeline-brief.md`.
+
+---
+
+## Source clips
+
+| # | File | Duration | Scene | From manifest |
+|---|---|---|---|---|
+| 1 | generative/scene1-hook-a.mp4 | 5s | Hook A | manifest.json #id |
+| 2 | generative/scene2.mp4 | 8s | Problem | manifest.json #id |
+| N | generative/sceneN.mp4 | 5s | CTA | manifest.json #id |
+
+VIDEO_USE_HOME staging path: `${VIDEO_USE_HOME}/<project>/`
+
+---
+
+## Cut strategy
+
+- **Target duration:** [N]s
+- **Opening hook:** Scene 1 (Hook [A–E] selected for this cut)
+- **Core through-line:** Problem → Solution → CTA
+- **Pacing bias:** tight (cut every ~3s) / breathing / mixed
+- **Word-boundary cuts:** always — never cut inside a word
+- **30 ms audio fades** at every segment boundary
+
+---
+
+## Overlay plan
+
+| Time | Overlay | Tool | Notes |
+|---|---|---|---|
+| 0:00 | On-screen text: "[hook text]" | Manim / PIL | From brief Scene 1 |
+| 0:05 | Caption track starts | FFmpeg subtitle filter | Subtitles applied last |
+| 0:25 | CTA card: "[cta text]", [phone], [url] | Manim / PIL | From brand kit |
+
+Subtitles are applied **last** — after all overlays. `setpts=PTS-STARTPTS+T/TB` for timing.
+
+---
+
+## Music direction
+
+- **Style:** [description]
+- **Tempo:** [BPM guidance]
+- **Fade in/out:** [direction]
+
+---
+
+## Render target
+
+| Format | Codec | Resolution | Aspect |
+|---|---|---|---|
+| MP4 | h264 | 1080×1920 | 9:16 |
+| MP4 | h264 | 1080×1080 | 1:1 (if required) |
+
+Output: `output/<client>/<project>/final/final.mp4`
+
+---
+
+## QA pass criteria
+
+- [ ] Duration within ±10% of target
+- [ ] Audio fades present at every segment boundary
+- [ ] Subtitles applied last and aligned to phrase transcript
+- [ ] No API keys or secrets in rendered output
+- [ ] All 12 video-use production rules pass (see video-use qa-checklist.md)

package/assets/worker-kits/growthub-creative-video-pipeline-v1/templates/generative-plan.md

@@ -0,0 +1,83 @@
+# Generative Plan — [CLIENT] / [PROJECT]
+> Stage 2 planning artifact. Fill before running `helpers/run-pipeline.sh` or BYOK execution.
+
+---
+
+## Adapter
+
+```
+CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER=
+VIDEO_MODEL_PROVIDER= (if byo-api-key)
+```
+
+---
+
+## Node bindings
+
+| Scene | Type | Model | Prompt (from brief Appendix) | Duration | Aspect |
+|---|---|---|---|---|---|
+| Scene 1 (Hook A) | video | veo-3.1-generate-001 | | 5s | 9:16 |
+| Scene 2 | video | veo-3.1-generate-001 | | 8s | 9:16 |
+| Scene N | image | (image capability) | | — | 9:16 |
+
+---
+
+## Reference images
+
+> Bind as typed data URLs: `data:image/jpeg;base64,<base64>` per `@growthub/api-contract` ref spec.
+> Never pass raw URLs as `refs[].dataUrl`.
+
+| Name | Source | Purpose |
+|---|---|---|
+| brand_reference | brands/<client>/assets/logo.jpg | Brand anchor |
+| scene_reference | brands/<client>/assets/reference.jpg | Visual style |
+
+Shell command to convert a local image to a typed data URL:
+
+```bash
+python3 -c "
+import base64, sys
+with open(sys.argv[1], 'rb') as f:
+    b64 = base64.b64encode(f.read()).decode()
+print(f'data:image/{sys.argv[2]};base64,{b64}')
+" brands/<client>/assets/logo.jpg jpeg
+```
+
+---
+
+## Pipeline payload (growthub-pipeline adapter)
+
+```json
+{
+  "pipelineId": "",
+  "executionMode": "hosted",
+  "nodes": [
+    {
+      "nodeId": "video-gen-1",
+      "slug": "video-generation",
+      "bindings": {
+        "videoModel": "veo-3.1-generate-001",
+        "prompt": "",
+        "seconds": 8,
+        "aspectRatio": "9:16",
+        "creativeCount": 1,
+        "refs": [
+          { "name": "brand_reference", "dataUrl": "" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+---
+
+## Expected output
+
+```
+output/<client>/<project>/generative/
+├── manifest.json
+├── scene1-hook-a.mp4
+├── scene2.mp4
+└── scene-n-bg.jpg
+```

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

@@ -0,0 +1,129 @@
+# Pipeline Brief — [CLIENT NAME] / [CAMPAIGN NAME]
+> Stage 1 output. Write this file to `output/<client-slug>/<project-slug>/brief/pipeline-brief.md`.
+> Pull all brand values from `brands/<client-slug>/brand-kit.md`. Do not invent brand detail.
+
+---
+
+## BRAND CONSTRAINTS
+
+> ⚠️ This ad must NEVER:
+> - [Pull from brand-kit.md `messaging_guardrails`]
+> - [Pull from brand-kit.md `do_not_attract`]
+
+---
+
+## BRIEF OVERVIEW
+
+| Field | Value |
+|---|---|
+| Client | |
+| Campaign | |
+| Date | |
+| Format | (UGC / AI Avatar / Explainer / Performance) |
+| Length | (seconds) |
+| Primary Goal | (Conversion / Awareness / Education) |
+| Hook Variations | (default 5 — A through E) |
+| Scene Count | |
+| Aspect Ratios | (9:16 + 1:1 minimum) |
+| Captions | ON |
+| CTA Offer | |
+| Landing Page | |
+
+---
+
+## SCENE STRUCTURE
+
+| Scene | Name | Timecode | Beat |
+|---|---|---|---|
+| 1 | Hook | 0:00–0:05 | N hook variations A–E |
+| 2 | Problem | 0:05–0:15 | Consistent across all hooks |
+| 3 | Solution | 0:15–0:25 | Consistent across all hooks |
+| N | CTA | 0:25–0:30 | Consistent across all hooks |
+
+---
+
+## SCENE 1 — HOOK (N VARIATIONS)
+
+> All variations share the same Scene 2–N structure. Only Scene 1 differs.
+
+### Hook A — [Type]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Hook B — [Type]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Hook C — [Type]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Hook D — [Type]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Hook E — [Type]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+---
+
+## SCENES 2–N (CONSISTENT ACROSS ALL HOOK VARIATIONS)
+
+### Scene 2 — [Name]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Scene 3 — [Name]
+**Visual:** 
+**On-Screen Text:** 
+**VO:** 
+
+### Scene N — CTA
+**Visual:** 
+**On-Screen Text:** 
+**VO:** `[CTA text from brand kit]`
+
+---
+
+## EDITING GUIDELINES
+
+- **Pacing:** Cut every ~3s unless specified otherwise
+- **Music:** [direction]
+- **Captions:** ON — match VO rhythm
+- **Color grade:** [direction]
+- **Aspect ratios:** 9:16 primary, 1:1 secondary
+- **NO list:** [pull from brand-kit.md messaging_guardrails]
+
+---
+
+## APPENDIX — AI GENERATION PROMPTS (OPTIONAL)
+
+> These prompts feed Stage 2 of the pipeline. Each prompt maps to one scene / one clip.
+> Keep prompts in this appendix only. Never inline in scene blocks above.
+
+### Video prompt — Scene 1 (Hook A)
+
+```
+[Scene description for video-generation CMS node]
+Brand: [brand name], style: [style from brand kit], no text overlays,
+[aspect ratio], [duration]s
+```
+
+### Video prompt — Scene 2
+
+```
+[Scene description]
+```
+
+### Image prompt — [Scene N background / reference]
+
+```
+[Image description]
+```

package/assets/worker-kits/growthub-creative-video-pipeline-v1/templates/project.md

@@ -0,0 +1,68 @@
+---
+# .growthub-fork/project.md — session memory primitive (v1)
+#
+# Seeded by `growthub kit fork register` from this template.
+# Replaceable tokens: {{KIT_ID}} {{FORK_ID}} {{STARTED_AT}} {{SOURCE}} {{SOURCE_REF}}
+
+kitId: "{{KIT_ID}}"
+forkId: "{{FORK_ID}}"
+startedAt: "{{STARTED_AT}}"
+source: "{{SOURCE}}"
+sourceRef: "{{SOURCE_REF}}"
+skillManifestVersion: 1
+approvals: []
+selfEvalHistory: []
+subSkillRuns: []
+
+# Pipeline state (update after each stage)
+pipelineState:
+  stage1Brief:
+    status: pending       # pending | in_progress | complete
+    clientSlug: ""
+    projectSlug: ""
+    briefPath: ""
+    sceneCount: 0
+    hookVariations: 0
+    completedAt: ""
+  stage2Generative:
+    status: pending       # pending | in_progress | complete
+    adapter: ""           # growthub-pipeline | byo-api-key
+    provider: ""
+    artifactCount: 0
+    manifestPath: ""
+    completedAt: ""
+  stage3Edit:
+    status: pending       # pending | in_progress | complete
+    videoUseForkPath: ""
+    finalVideoPath: ""
+    durationTarget: ""
+    qaPass: false
+    completedAt: ""
+---
+
+# Project journal — fork `{{FORK_ID}}`
+
+Baseline primitive: `{{KIT_ID}}`. Seeded at `{{STARTED_AT}}` from `{{SOURCE}}` (`{{SOURCE_REF}}`).
+
+## How to use this file
+
+1. **Session start.** Read the last 3 entries below + tail 20 events in `.growthub-fork/trace.jsonl`. Update `pipelineState` to reflect actual completion.
+2. **Stage completion.** Record a dated entry in "Session log" with: stage, client, project, key paths, self-eval outcome.
+3. **Material change.** Append a dated bullet here AND a typed event to `trace.jsonl`.
+4. **Self-eval boundary.** Append to `selfEvalHistory`: `attempt`, `criteria`, `outcome`, `notes`.
+5. **Sub-skill spawn.** Append to `subSkillRuns`: `subSkill`, `startedAt`, `result`.
+
+## Session log
+
+<!-- Append entries below, newest at the bottom.
+
+### YYYY-MM-DD HH:mm UTC · creative-video-pipeline-operator
+- **Plan.** What you intend to do this session.
+- **Stage.** Which stage (1/2/3) and what sub-task.
+- **Changes.** What you actually did (each must correspond to a trace event).
+- **Outcome.** Pass / fail / parked. Reference the selfEval criteria checked.
+- **Next.** What the next session should pick up.
+
+-->
+
+_No sessions recorded yet. This block is populated as the fork is operated._

package/assets/worker-kits/growthub-creative-video-pipeline-v1/templates/self-eval.md

@@ -0,0 +1,67 @@
+# Self-evaluation template — v1 primitive (Growthub, capability-agnostic)
+
+A skill's `selfEval` contract declares **what good looks like** (`criteria[]`) and **the retry ceiling** (`maxRetries`). The agent drives the loop; this file is the pattern the agent follows at every unit of work.
+
+The contract is defined in `@growthub/api-contract/skills::SkillSelfEval` and is **capability-agnostic** — the same primitive applies to code edits, copy drafts, CRM rules, API payloads, asset renders, audit passes, and every other domain. The "unit of work" is the smallest reversible change the skill operates on; concrete boundaries are defined in the kit's own `skills.md` operator runbook, not here.
+
+## Loop
+
+```
+for attempt in 1..maxRetries:          # default maxRetries = 3
+  generate       — produce a proposal (whatever the skill produces)
+  apply          — materialise the proposal against the fork
+  self-evaluate  — for each criterion in skill.selfEval.criteria:
+                     check → pass / fail / needs-confirmation
+  record         — append to project.md (human) + trace.jsonl (machine)
+
+  if all criteria pass: break
+  if attempt == maxRetries: park with needs_confirmation note. Stop.
+```
+
+## What each attempt writes
+
+### Human row — append to `.growthub-fork/project.md` "Session log"
+
+```md
+### 2026-04-24 · creative-video-pipeline-operator
+- **Plan.** What you intend to do this unit of work.
+- **Changes.** Material change applied (must correspond to a trace event).
+- **Self-eval.** attempt 2/3 — criterion "<one of skill.selfEval.criteria>" ✗ (<note>). Retrying.
+- **Outcome.** retry-pending / pass / parked.
+- **Next.** What the next attempt (or next session) should pick up.
+```
+
+### Machine row — append to `.growthub-fork/trace.jsonl`
+
+```json
+{
+  "ts": "2026-04-24T00:00:00.000Z",
+  "forkId": "<fork-id>",
+  "kitId": "growthub-creative-video-pipeline-v1",
+  "type": "self_eval_recorded",
+  "summary": "attempt 2/3 failed on <criterion>",
+  "detail": {
+    "skill": "<skill-slug>",
+    "attempt": 2,
+    "maxRetries": 3,
+    "criterion": "<one of skill.selfEval.criteria>",
+    "outcome": "fail",
+    "notes": "<short explanation>"
+  }
+}
+```
+
+## Hard rules
+
+1. **Never exceed `maxRetries`.** At the ceiling, park with a `needs_confirmation` note and stop.
+2. **Record every attempt.** Even the first pass.
+3. **Keep `project.md` and `trace.jsonl` in sync.**
+4. **Preserve prior entries.** Append-only. Never rewrite history.
+
+## Kit-specific self-eval units
+
+| Stage | Unit of work |
+|---|---|
+| Stage 1 — Brief | Completed `pipeline-brief.md` for one creative concept |
+| Stage 2 — Generate | `manifest.json` with one artifact URL per scene |
+| Stage 3 — Edit | `final.mp4` exists, duration ±10% of target, QA pass |

package/assets/worker-kits/growthub-creative-video-pipeline-v1/validation-checklist.md

@@ -0,0 +1,52 @@
+# Validation Checklist — Creative Video Pipeline
+
+Run before calling the kit v1-ready or before a Vercel deployment.
+
+## Environment
+
+- [ ] `bash setup/check-deps.sh` passes (FFmpeg, Python 3, pip, git, node)
+- [ ] `node setup/verify-env.mjs` passes
+- [ ] `bash helpers/check-generative-adapter.sh` shows expected adapter and keys
+- [ ] `VIDEO_USE_HOME` resolves to an existing `video-use` clone
+
+## Growthub CLI (growthub-pipeline adapter)
+
+- [ ] `growthub auth whoami --json` returns authenticated user
+- [ ] `growthub kit list --family studio` includes `growthub-creative-video-pipeline-v1`
+- [ ] `growthub kit fork status <fork-id>` shows no unexpected drift
+
+## Stage 1 — Brief
+
+- [ ] Brand kit exists at `brands/<client-slug>/brand-kit.md`
+- [ ] `pipeline-brief.md` written to `output/<client>/<project>/brief/`
+- [ ] Brief contains: brand constraints box, scene table, hook variations A–E, editing guidelines
+- [ ] AI generation prompts in Appendix only (not inline in scene blocks)
+
+## Stage 2 — Generate
+
+- [ ] `output/<client>/<project>/generative/manifest.json` exists and is valid JSON
+- [ ] Each manifest entry has `id`, `type`, `provider`, `url`, `prompt`
+- [ ] No API keys appear in any artifact file
+- [ ] Artifact count matches scene count in brief
+
+## Stage 3 — Edit
+
+- [ ] `output/<client>/<project>/final/final.mp4` exists
+- [ ] Duration within ±10% of target from edit plan
+- [ ] Audio fades at segment boundaries (30 ms)
+- [ ] Subtitles applied last
+- [ ] No secrets in any output artifact
+
+## Local shell
+
+- [ ] `cd studio && npm install && npm run build` succeeds
+- [ ] `cd apps/creative-video-pipeline && npm install && npm run build` succeeds
+- [ ] Studio Vite shell renders pipeline stage status without errors
+- [ ] Next.js `/settings/keys` page renders adapter config
+
+## Governed primitives
+
+- [ ] `.growthub-fork/project.md` has entries for all completed stages
+- [ ] `.growthub-fork/trace.jsonl` has typed events for all material changes
+- [ ] `growthub skills validate` passes
+- [ ] `growthub skills list` shows this kit's SKILL.md tree