@growthub/cli 0.8.0 → 0.8.2

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}`);
+});

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

@@ -0,0 +1,210 @@
+import React, { useState } from "react";
+
+const stages = [
+  {
+    id: "brief",
+    label: "Brief",
+    step: "01",
+    description: "Brand kit → scene structure → hooks → pipeline-brief.md",
+    outputPath: "output/<client>/<project>/brief/pipeline-brief.md",
+  },
+  {
+    id: "generative",
+    label: "Generate",
+    step: "02",
+    description: "growthub pipeline execute → image/video artifacts",
+    outputPath: "output/<client>/<project>/generative/manifest.json",
+  },
+  {
+    id: "edit",
+    label: "Edit",
+    step: "03",
+    description: "video-use fork → ElevenLabs Scribe → EDL → FFmpeg → final.mp4",
+    outputPath: "output/<client>/<project>/final/final.mp4",
+  },
+];
+
+const adapterDocs = [
+  ["growthub-pipeline", "Routes through growthub pipeline execute + CMS video-generation node. Requires GROWTHUB_BRIDGE_ACCESS_TOKEN."],
+  ["byo-api-key", "Routes through explicit provider SDK. Set VIDEO_MODEL_PROVIDER (veo | fal | runway) + provider key."],
+];
+
+const providerKeys = [
+  ["ELEVENLABS_API_KEY", "Required for Stage 3 — ElevenLabs Scribe transcription", true],
+  ["GROWTHUB_BRIDGE_ACCESS_TOKEN", "growthub-pipeline adapter — from growthub auth login", false],
+  ["GOOGLE_AI_API_KEY", "BYOK: VIDEO_MODEL_PROVIDER=veo", false],
+  ["FAL_API_KEY", "BYOK: VIDEO_MODEL_PROVIDER=fal", false],
+  ["RUNWAY_API_KEY", "BYOK: VIDEO_MODEL_PROVIDER=runway", false],
+];
+
+export default function App() {
+  const [settingsOpen, setSettingsOpen] = useState(false);
+
+  return (
+    <main className="shell">
+      <aside className="sidebar">
+        <div className="brand">
+          <span className="brand-mark">CV</span>
+          <span>Creative Video Pipeline</span>
+        </div>
+        <nav className="nav">
+          <a href="#pipeline">Pipeline</a>
+          <a href="#brief">Brief</a>
+          <a href="#generative">Generative</a>
+          <a href="#edit">Edit</a>
+          <a href="#settings" onClick={(e) => { e.preventDefault(); setSettingsOpen(!settingsOpen); }}>
+            Settings
+          </a>
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          Local Vite shell
+        </div>
+      </aside>
+
+      <section className="main">
+        <div className="utility-bar">
+          <div>
+            <strong>Growthub Creative Video Pipeline</strong>
+            <span>Brief → Generate → Edit — governed workspace with Vite local shell and Vercel app parity.</span>
+          </div>
+          <div className="utility-actions">
+            <a href="#settings" onClick={(e) => { e.preventDefault(); setSettingsOpen(!settingsOpen); }}>
+              API Keys
+            </a>
+            <span className="pill">kit v1</span>
+          </div>
+        </div>
+
+        <header className="page-heading" id="pipeline">
+          <span className="eyebrow">Three-stage pipeline</span>
+          <h1>Brief to final video.</h1>
+          <p>
+            Brand-grounded brief, generative images and video via the growthub pipeline or BYOK provider, and
+            transcript-anchored editing via the video-use fork — all in one governed workspace.
+          </p>
+        </header>
+
+        <section className="pipeline-strip" id="pipeline-stages">
+          {stages.map((stage) => (
+            <article className="stage-card" key={stage.id} id={stage.id}>
+              <span className="stage-step">{stage.step}</span>
+              <strong>{stage.label}</strong>
+              <p>{stage.description}</p>
+              <code>{stage.outputPath}</code>
+            </article>
+          ))}
+        </section>
+
+        <section className="hero-grid">
+          <article className="hero-card primary">
+            <span>Adapter</span>
+            <strong>growthub-pipeline</strong>
+            <p>Primary path. Routes through hosted CMS video-generation node (veo-3.1-generate-001). Requires Growthub auth.</p>
+          </article>
+          <article className="hero-card">
+            <span>BYOK</span>
+            <strong>byo-api-key</strong>
+            <p>Secondary path. Explicit provider keys (Veo / fal / Runway). Normalizes to same artifact contract.</p>
+          </article>
+          <article className="hero-card">
+            <span>Edit</span>
+            <strong>video-use fork</strong>
+            <p>Stage 3 delegates to VIDEO_USE_HOME. ElevenLabs Scribe + FFmpeg render + self-eval loop.</p>
+          </article>
+        </section>
+
+        <section className="adapter-grid">
+          {adapterDocs.map(([name, desc]) => (
+            <article className="card" key={name}>
+              <h3>{name}</h3>
+              <p>{desc}</p>
+            </article>
+          ))}
+        </section>
+
+        <section className="ops-strip">
+          <article>
+            <span>01</span>
+            <strong>Brand Kit</strong>
+            <p>Scene structure and hooks sourced from brand-kit.md — not memory.</p>
+          </article>
+          <article>
+            <span>02</span>
+            <strong>CLI Pipeline</strong>
+            <p>growthub pipeline execute routes to CMS video-generation node.</p>
+          </article>
+          <article>
+            <span>03</span>
+            <strong>video-use Fork</strong>
+            <p>Scribe → word-boundary EDL → FFmpeg render → final.mp4.</p>
+          </article>
+          <article>
+            <span>04</span>
+            <strong>Governed</strong>
+            <p>Every stage appends to project.md and trace.jsonl.</p>
+          </article>
+        </section>
+
+        {settingsOpen && (
+          <section className="settings-panel" id="settings">
+            <div className="settings-header">
+              <h2>API Key Settings</h2>
+              <p>
+                Configure the generative adapter and provider keys. Both paths normalize to the same
+                GenerativeArtifact[] object. Set keys in your fork&apos;s <code>.env</code> file.
+              </p>
+            </div>
+
+            <div className="setup-grid">
+              <article className="setup-card">
+                <span>Primary</span>
+                <strong>Growthub Pipeline</strong>
+                <p>Set <code>CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER=growthub-pipeline</code> and authenticate via <code>growthub auth login</code>.</p>
+                <code>GROWTHUB_BRIDGE_ACCESS_TOKEN</code>
+              </article>
+              <article className="setup-card">
+                <span>Secondary</span>
+                <strong>BYOK Provider</strong>
+                <p>Set <code>CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER=byo-api-key</code> and <code>VIDEO_MODEL_PROVIDER</code>.</p>
+                <code>GOOGLE_AI_API_KEY / FAL_API_KEY / RUNWAY_API_KEY</code>
+              </article>
+              <article className="setup-card">
+                <span>Required</span>
+                <strong>ElevenLabs Scribe</strong>
+                <p>Required for Stage 3 — word-level transcription for the video-use EDL pipeline.</p>
+                <code>ELEVENLABS_API_KEY</code>
+              </article>
+            </div>
+
+            <div className="key-list">
+              {providerKeys.map(([key, desc, required]) => (
+                <article className="key-row" key={key}>
+                  <div>
+                    <code>{key}</code>
+                    <span className={`key-badge ${required ? "required" : "optional"}`}>
+                      {required ? "required" : "conditional"}
+                    </span>
+                  </div>
+                  <p>{desc}</p>
+                </article>
+              ))}
+            </div>
+
+            <p className="settings-note">
+              Keys are read from your fork&apos;s <code>.env</code> file. See <code>.env.example</code> for all available options.
+              Never commit API keys to the repo.
+            </p>
+          </section>
+        )}
+      </section>
+
+      <aside className="quick-actions">
+        <button onClick={() => setSettingsOpen(!settingsOpen)}>Configure API keys</button>
+        <button>View brief output</button>
+        <button>View generative output</button>
+        <button>Open final video</button>
+      </aside>
+    </main>
+  );
+}