npm - @growthub/cli - Versions diffs - 0.8.1 → 0.8.2 - Mend

@growthub/cli 0.8.1 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

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

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

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

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

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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
+```