@growthub/cli 0.8.1 → 0.9.0

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`

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

@@ -0,0 +1,41 @@
+---
+id: creative-video-pipeline/video-edit
+name: creative-video-pipeline-video-edit
+description: Prepare the Stage 3 edit handoff for the VIDEO_USE_HOME fork and collect final video output.
+version: 1.0.0
+triggers:
+  - "run edit stage"
+  - "stage 3 edit"
+  - "assemble final video"
+  - "video-use edit"
+selfEval:
+  criteria:
+    - "edit-plan.md written from generative manifest and brief"
+    - "VIDEO_USE_HOME is set and resolves to a cloned video-use fork"
+    - "Handoff to video-use fork executed — do not duplicate video-use pipeline logic"
+    - "final.mp4 copied to output/<client>/<project>/final/"
+    - "project.md and trace.jsonl updated with Stage 3 completion"
+  maxRetries: 3
+---
+
+# Video Edit Sub-Skill
+
+## Role
+Execute Stage 3: delegate edit to the `VIDEO_USE_HOME` video-use fork and collect final output.
+
+## Dependencies
+- `VIDEO_USE_HOME` — absolute path to video-use fork clone
+- `ELEVENLABS_API_KEY` — for ElevenLabs Scribe word-level transcription
+- `ffmpeg` — must be on PATH inside the video-use fork environment
+
+## Process
+1. Read `output/<client>/<project>/generative/manifest.json` to identify source clips
+2. Read `output/<client>/<project>/brief/pipeline-brief.md` for editing guidelines
+3. Write `output/<client>/<project>/edit-plan.md` from `templates/edit-plan.md`
+4. Delegate to video-use fork — do NOT inline video-use logic here
+5. Copy final rendered `final.mp4` to `output/<client>/<project>/final/final.mp4`
+6. Append Stage 3 completion to `project.md` and `trace.jsonl`
+
+## Handoff
+The video-use fork owns the full Scribe → word-boundary EDL → FFmpeg render pipeline.
+This sub-skill's only job is to form the `edit-plan.md` handoff and collect the output artifact.

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

@@ -0,0 +1,302 @@
+# Creative Video Pipeline — Operator Runbook
+
+> **Who this is for:** Any agent operating inside `${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/` and running the three-stage creative video pipeline.
+> Read this file fully before starting. Every section is a required step.
+
+---
+
+## QUICK REFERENCE
+
+| What you need | Where to find it |
+|---|---|
+| This runbook | `skills.md` ← you are here |
+| Routing menu | `SKILL.md` |
+| Agent contract | `workers/creative-video-pipeline-operator/CLAUDE.md` |
+| Brief template | `templates/pipeline-brief.md` |
+| Brand kit template | `brands/_template/brand-kit.md` |
+| Generative plan template | `templates/generative-plan.md` |
+| Edit plan template | `templates/edit-plan.md` |
+| Session memory | `.growthub-fork/project.md` |
+| Output directory | `output/<client-slug>/<project-slug>/` |
+| Adapter contracts | `docs/adapter-contracts.md` |
+| Pipeline architecture | `docs/pipeline-architecture.md` |
+
+---
+
+## STAGE 0 — PREPARE
+
+### 0a. Environment check
+
+```bash
+bash setup/check-deps.sh
+node setup/verify-env.mjs
+```
+
+If deps fail, stop and return remediation only. Do not invent API keys or hardcode paths.
+
+### 0b. Verify generative adapter
+
+```bash
+bash helpers/check-generative-adapter.sh
+```
+
+Prints active adapter (`growthub-pipeline` or `byo-api-key`) and which keys are set.
+
+### 0c. Auth pre-flight (growthub-pipeline adapter only)
+
+```bash
+growthub auth whoami --json
+```
+
+If not authenticated, run `growthub auth login` before proceeding.
+
+### 0d. Create or load brand kit
+
+```bash
+# New client
+cp ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/_template/brand-kit.md \
+   ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/<client-slug>/brand-kit.md
+
+# Existing client
+cat ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/<client-slug>/brand-kit.md
+```
+
+Required fields: `client_name`, `slug`, `primary_service`, `tone`, `messaging_guardrails`, `cta_text`, `colors`.
+
+---
+
+## STAGE 1 — BRIEF
+
+Sub-skill: `skills/brief-generation/SKILL.md`
+
+### 1a. Build scene structure
+
+From the brand kit and campaign intent, produce a scene table:
+
+```
+Scene 1 — Hook          N variations (A–E), same creative concept
+Scene 2 — Problem       consistent across all hook variations
+Scene 3 — Solution      consistent across all hook variations
+Scene N — CTA           consistent across all hook variations
+```
+
+Hook sources (in priority order):
+1. `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/hooks-library/500-winning-hooks.csv` — if the creative-strategist kit is installed
+2. Inline hook reasoning from brand kit tone and `approved_phrases`
+
+### 1b. Write the brief
+
+Fill `templates/pipeline-brief.md` and write the output to:
+
+```
+output/<client-slug>/<project-slug>/brief/pipeline-brief.md
+```
+
+Required sections:
+1. Brand constraints box — from `messaging_guardrails`
+2. Scene structure table
+3. Hook variations A–E for Scene 1
+4. Per-scene production notes (visual direction, VO, on-screen text)
+5. Editing guidelines
+6. Appendix: AI generation prompts (labeled OPTIONAL) — used in Stage 2
+
+### 1c. Append to session memory
+
+```bash
+# After completing Stage 1:
+# Append to .growthub-fork/project.md with: stage, client, brief path, hook count, scene count
+```
+
+**Self-eval unit for Stage 1:** The completed `pipeline-brief.md` for one creative concept.
+
+---
+
+## STAGE 2 — GENERATE
+
+Sub-skill: `skills/generative-execution/SKILL.md`
+
+### 2a. Resolve adapter
+
+```bash
+bash helpers/check-generative-adapter.sh
+```
+
+### 2b. Build generative plan
+
+Fill `templates/generative-plan.md` with:
+- Node bindings (which scenes become video clips, which become images)
+- Reference images (if any — as typed data URLs per `@growthub/api-contract` ref spec)
+- Provider model choice
+- Prompts from Stage 1 brief Appendix
+
+### 2c. Execute — growthub-pipeline path (primary)
+
+```bash
+bash helpers/run-pipeline.sh
+```
+
+Or directly:
+
+```bash
+# Auth pre-flight
+growthub auth whoami --json || { echo "Not authenticated. Run: growthub auth login"; exit 1; }
+
+# Execute
+growthub pipeline execute '<json-payload>'
+```
+
+Pipeline payload shape (`DynamicRegistryPipeline`):
+```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>" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+Parse streaming NDJSON output with `isExecutionEvent` from `@growthub/api-contract/events`.
+
+### 2d. Execute — byo-api-key path (secondary)
+
+Set `VIDEO_MODEL_PROVIDER` and the corresponding provider key in `.env`.
+The adapter in `lib/adapters/generative/index.js` routes to the correct provider SDK.
+
+### 2e. Write generative manifest
+
+After execution, write `output/<client>/<project>/generative/manifest.json` per `output-standards.md`.
+
+### 2f. Append to session memory
+
+Record: execution id, artifact count, provider used, artifact URLs.
+
+**Self-eval unit for Stage 2:** `manifest.json` with at least one artifact URL per scene in the brief.
+
+---
+
+## STAGE 3 — EDIT
+
+Sub-skill: `skills/video-edit/SKILL.md`
+
+### 3a. Verify video-use fork
+
+```bash
+ls "${VIDEO_USE_HOME:-$HOME/video-use}/skills.md" || {
+  echo "video-use fork not found. Run: bash setup/clone-fork.sh"
+  exit 1
+}
+```
+
+### 3b. Stage generated clips
+
+Copy/link generated clips from `output/<client>/<project>/generative/` into `${VIDEO_USE_HOME}/<project>/`.
+
+### 3c. Write edit plan
+
+Fill `templates/edit-plan.md` and write to `output/<client>/<project>/final/edit-plan.md`.
+
+Minimum contents:
+- Source clips list (from generative manifest)
+- Cut strategy aligned to scene structure from brief
+- Overlay plan (captions, on-screen text from brief scenes)
+- Music direction
+- Final duration target
+
+### 3d. Hand off to video-use agent
+
+The video-use agent reads from its `${VIDEO_USE_HOME}/skills.md` runbook. Pass:
+1. `output/<client>/<project>/brief/pipeline-brief.md` — scene + VO structure
+2. `output/<client>/<project>/final/edit-plan.md` — cut strategy
+
+The video-use fork pipeline:
+```
+inventory → transcribe (ElevenLabs Scribe) → pack phrase-level transcript
+         → EDL generation (word-boundary cuts)
+         → render (FFmpeg + overlays)
+         → self-eval (up to 3 iterations)
+         → final.mp4 at ${VIDEO_USE_HOME}/<project>/edit/final.mp4
+```
+
+### 3e. Copy final output
+
+```bash
+mkdir -p output/<client>/<project>/final
+cp "${VIDEO_USE_HOME}/<project>/edit/final.mp4" output/<client>/<project>/final/final.mp4
+```
+
+### 3f. Append to session memory
+
+Record: edit decision count, render duration, final.mp4 path, QA pass status.
+
+**Self-eval unit for Stage 3:** `final.mp4` exists, passes QA checklist, duration matches target.
+
+---
+
+## NON-NEGOTIABLE RULES
+
+1. Stage 1 brief must be sourced from `brand-kit.md` — no brand details from memory.
+2. Stage 2 generative execution goes through the adapter contract — never raw API calls outside it.
+3. Stage 3 edit delegates to `VIDEO_USE_HOME` fork — never duplicate its pipeline inline.
+4. `output/<client>/<project>/` is the single output root — no other write locations.
+5. Append to `.growthub-fork/project.md` at every stage boundary.
+6. `ELEVENLABS_API_KEY` never appears in any output artifact.
+7. Provider API keys never appear in any output artifact.
+8. Brief AI generation prompts live in the Appendix only — never inline in scene blocks.
+
+---
+
+## FOLDER STRUCTURE
+
+```
+${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/
+├── skills.md                        ← this file — read first, every session
+├── SKILL.md                         ← routing menu — read before skills.md
+├── QUICKSTART.md
+├── .env.example
+├── workers/
+│   └── creative-video-pipeline-operator/CLAUDE.md
+├── brands/
+│   ├── _template/brand-kit.md
+│   ├── growthub/brand-kit.md
+│   └── NEW-CLIENT.md
+├── templates/
+│   ├── pipeline-brief.md
+│   ├── generative-plan.md
+│   └── edit-plan.md
+├── setup/
+│   ├── check-deps.sh
+│   ├── verify-env.mjs
+│   ├── clone-fork.sh
+│   └── install-skill.sh
+├── helpers/
+│   ├── run-pipeline.sh
+│   └── check-generative-adapter.sh
+├── skills/
+│   ├── brief-generation/SKILL.md
+│   ├── generative-execution/SKILL.md
+│   └── video-edit/SKILL.md
+├── docs/
+│   ├── adapter-contracts.md
+│   ├── pipeline-architecture.md
+│   ├── governed-workspace-primitives.md
+│   └── vercel-deployment.md
+├── output/
+│   └── <client-slug>/<project-slug>/{brief/,generative/,final/}
+├── studio/                          ← Vite local shell
+└── apps/
+    └── creative-video-pipeline/     ← Next.js / Vercel app
+```

package/assets/worker-kits/growthub-creative-video-pipeline-v1/studio/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Creative Video Pipeline</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

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

@@ -0,0 +1,20 @@
+{
+  "name": "growthub-creative-video-pipeline-studio",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "growthub-creative-video-pipeline-studio",
+      "version": "1.0.0",
+      "dependencies": {
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1"
+      },
+      "devDependencies": {
+        "@vitejs/plugin-react": "^4.3.1",
+        "vite": "^5.4.2"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,20 @@
+{
+  "name": "growthub-creative-video-pipeline-studio",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "serve": "node serve.mjs"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.1",
+    "vite": "^5.4.2"
+  }
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/studio/serve.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Minimal static server for the built Vite shell.
+// Usage: node serve.mjs [--port 5180]
+import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DIST = path.resolve(__dirname, "dist");
+const PORT = Number(process.env.PORT ?? 5180);
+
+const mime = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".json": "application/json; charset=utf-8",
+};
+
+function serve(req, res) {
+  const url = decodeURIComponent(req.url?.split("?")[0] ?? "/");
+  const file = url === "/" ? "/index.html" : url;
+  const full = path.resolve(DIST, "." + file);
+  if (!full.startsWith(DIST)) { res.statusCode = 403; res.end("Forbidden"); return; }
+  fs.readFile(full, (err, buf) => {
+    if (err) {
+      fs.readFile(path.resolve(DIST, "index.html"), (err2, fallback) => {
+        if (err2) { res.statusCode = 404; res.end("Not found"); return; }
+        res.setHeader("Content-Type", mime[".html"]); res.end(fallback);
+      });
+      return;
+    }
+    res.setHeader("Content-Type", mime[path.extname(full)] ?? "application/octet-stream");
+    res.end(buf);
+  });
+}
+
+http.createServer(serve).listen(PORT, () => {
+  console.log(`[creative-video-pipeline-studio] serving ${DIST} on http://localhost:${PORT}`);
+});