@growthub/cli 0.8.1 → 0.9.0

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/app/page.jsx

@@ -0,0 +1,131 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { describeGenerativeAdapter } from "@/lib/adapters/generative/index";
+import { pipelineStages } from "@/lib/domain/pipeline";
+import Link from "next/link";
+
+const nav = [
+  { href: "#pipeline", label: "Pipeline" },
+  { href: "#brief", label: "Brief" },
+  { href: "#generative", label: "Generative" },
+  { href: "#edit", label: "Edit" },
+  { href: "/settings/keys", label: "API Keys" },
+];
+
+function Home() {
+  const config = readAdapterConfig();
+  const generative = describeGenerativeAdapter();
+
+  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">
+          {nav.map((item) => <Link href={item.href} key={item.href}>{item.label}</Link>)}
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          Governed worker kit
+        </div>
+      </aside>
+
+      <section className="main">
+        <div className="utility-bar">
+          <div>
+            <strong>Creative Video Pipeline</strong>
+            <span>Brief → Generate → Edit — governed workspace with local Vite shell and Vercel parity.</span>
+          </div>
+          <div className="utility-actions">
+            <Link href="/settings/keys">API Keys</Link>
+            <span className="pill">v1 kit</span>
+          </div>
+        </div>
+
+        <div className="page-heading" id="pipeline">
+          <p className="eyebrow">Three-stage pipeline</p>
+          <h1>Brief to final video.</h1>
+          <p>
+            Brand-grounded brief, generative image/video via{" "}
+            <strong>{config.generativeAdapter}</strong>, and transcript-anchored editing
+            via the video-use fork — outputs governed across all three stages.
+          </p>
+          <span className="badge">adapter: {generative.label}</span>
+        </div>
+
+        <section className="pipeline-strip" id="pipeline-stages">
+          {pipelineStages.map((stage) => <article className="stage-card" id={stage.id} key={stage.id}>
+              <span className="stage-step">{stage.step}</span>
+              <strong>{stage.label}</strong>
+              <p>{stage.description}</p>
+              <code>{stage.outputPath}</code>
+              <span className="stage-status pending">pending</span>
+            </article>)}
+        </section>
+
+        <section className="hero-grid">
+          <article className="hero-card primary">
+            <p className="card-label">Generative adapter</p>
+            <strong>{config.generativeAdapter}</strong>
+            <p>{generative.description}</p>
+          </article>
+          <article className="hero-card">
+            <p className="card-label">Video-use fork</p>
+            <strong>{config.videoUseHome ? "configured" : "not set"}</strong>
+            <p className="muted">VIDEO_USE_HOME resolves the video-use clone for Stage 3.</p>
+          </article>
+          <article className="hero-card">
+            <p className="card-label">ElevenLabs Scribe</p>
+            <strong>{config.hasElevenLabsKey ? "key set" : "key missing"}</strong>
+            <p className="muted">Required for Stage 3 word-level transcription.</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 only.</p>
+          </article>
+          <article>
+            <span>02</span>
+            <strong>CLI Pipeline</strong>
+            <p>growthub pipeline execute → CMS video-generation node.</p>
+          </article>
+          <article>
+            <span>03</span>
+            <strong>video-use Fork</strong>
+            <p>Scribe → word-boundary EDL → FFmpeg → final.mp4.</p>
+          </article>
+          <article>
+            <span>04</span>
+            <strong>Governed</strong>
+            <p>project.md + trace.jsonl at every stage boundary.</p>
+          </article>
+        </section>
+
+        <section className="adapter-grid" aria-label="Adapter paths">
+          <article className="card">
+            <h3>growthub-pipeline (primary)</h3>
+            <p>Routes through hosted CMS video-generation node. Requires GROWTHUB_BRIDGE_ACCESS_TOKEN + auth.</p>
+          </article>
+          <article className="card">
+            <h3>byo-api-key (secondary)</h3>
+            <p>Explicit provider SDK calls. Set VIDEO_MODEL_PROVIDER (veo | fal | runway) + key. Same artifact contract.</p>
+          </article>
+        </section>
+      </section>
+
+      <aside className="quick-actions">
+        <button type="button">Run Stage 1 — Brief</button>
+        <button type="button">Run Stage 2 — Generate</button>
+        <button type="button">Run Stage 3 — Edit</button>
+        <button type="button">
+          <Link href="/settings/keys">Configure API Keys</Link>
+        </button>
+      </aside>
+    </main>;
+}
+export {
+  Home as default
+};

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/app/settings/keys/page.jsx

@@ -0,0 +1,154 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
+import Link from "next/link";
+
+const KEYS = [
+  {
+    env: "CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER",
+    label: "Generative Adapter",
+    badge: "required",
+    note: "growthub-pipeline (default) or byo-api-key",
+  },
+  {
+    env: "GROWTHUB_BRIDGE_ACCESS_TOKEN",
+    label: "Bridge Access Token",
+    badge: "required",
+    note: "Required for growthub-pipeline adapter. Obtain from Growthub dashboard.",
+  },
+  {
+    env: "GROWTHUB_BRIDGE_BASE_URL",
+    label: "Bridge Base URL",
+    badge: "required",
+    note: "Required for growthub-pipeline adapter. e.g. https://api.growthub.ai",
+  },
+  {
+    env: "ELEVENLABS_API_KEY",
+    label: "ElevenLabs API Key",
+    badge: "required",
+    note: "Required for Stage 3 word-level transcription via Scribe.",
+  },
+  {
+    env: "VIDEO_MODEL_PROVIDER",
+    label: "Video Model Provider",
+    badge: "conditional",
+    note: "Required for byo-api-key adapter. One of: veo | fal | runway",
+  },
+  {
+    env: "GOOGLE_AI_API_KEY",
+    label: "Google AI API Key",
+    badge: "conditional",
+    note: "Required when VIDEO_MODEL_PROVIDER=veo",
+  },
+  {
+    env: "FAL_API_KEY",
+    label: "Fal API Key",
+    badge: "conditional",
+    note: "Required when VIDEO_MODEL_PROVIDER=fal",
+  },
+  {
+    env: "RUNWAY_API_KEY",
+    label: "Runway API Key",
+    badge: "conditional",
+    note: "Required when VIDEO_MODEL_PROVIDER=runway",
+  },
+  {
+    env: "VIDEO_USE_HOME",
+    label: "VIDEO_USE_HOME",
+    badge: "required",
+    note: "Absolute path to the video-use fork clone. Required for Stage 3.",
+  },
+  {
+    env: "CREATIVE_VIDEO_PIPELINE_HOME",
+    label: "Pipeline Home",
+    badge: "conditional",
+    note: "Override workspace root. Defaults to $HOME/creative-video-pipeline",
+  },
+];
+
+const SETUP_CARDS = [
+  {
+    step: "01",
+    label: "Copy .env.example",
+    code: "cp .env.example .env.local",
+  },
+  {
+    step: "02",
+    label: "Set adapter",
+    code: "CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER=growthub-pipeline",
+  },
+  {
+    step: "03",
+    label: "Clone video-use fork",
+    code: "bash setup/clone-fork.sh",
+  },
+];
+
+function KeysPage() {
+  const config = readAdapterConfig();
+
+  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">
+          <Link href="/">Pipeline</Link>
+          <Link href="/settings/keys">API Keys</Link>
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          Governed worker kit
+        </div>
+      </aside>
+
+      <section className="main">
+        <div className="toolbar-strip">
+          <div>
+            <strong>API Key Configuration</strong>
+            <p>Adapter: <code>{config.generativeAdapter}</code> &mdash; Bridge: {config.hasBridgeToken ? "set" : "missing"} &mdash; ElevenLabs: {config.hasElevenLabsKey ? "set" : "missing"}</p>
+          </div>
+          <Link href="/">← Back to Pipeline</Link>
+        </div>
+
+        <div className="page-heading">
+          <p className="eyebrow">Configuration</p>
+          <h1>API Keys</h1>
+          <p>
+            Set these variables in <code>.env.local</code> (local dev) or Vercel environment settings (production).
+            Growthub-pipeline adapter requires the Bridge token. BYOK requires a provider key. Stage 3 always requires ElevenLabs.
+          </p>
+        </div>
+
+        <div className="setup-grid">
+          {SETUP_CARDS.map((card) => (
+            <article className="setup-card" key={card.step}>
+              <span>{card.step}</span>
+              <strong>{card.label}</strong>
+              <code>{card.code}</code>
+            </article>
+          ))}
+        </div>
+
+        <div className="key-board">
+          {KEYS.map((key) => (
+            <div className="key-row" key={key.env}>
+              <div className="key-row-top">
+                <code>{key.env}</code>
+                <span className={`key-badge ${key.badge}`}>{key.badge}</span>
+              </div>
+              <p>{key.note}</p>
+            </div>
+          ))}
+        </div>
+
+        <p className="settings-note">
+          Never commit secrets. Use <code>.env.local</code> locally and Vercel environment variables for deployment.
+          The <code>.env.example</code> file in the kit root documents all variables without values.
+        </p>
+      </section>
+    </main>
+  );
+}
+
+export default KeysPage;

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/lib/adapters/env.js

@@ -0,0 +1,14 @@
+export function readAdapterConfig() {
+  return {
+    generativeAdapter: process.env.CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER || "growthub-pipeline",
+    pipelineHome: process.env.CREATIVE_VIDEO_PIPELINE_HOME || null,
+    videoUseHome: process.env.VIDEO_USE_HOME || null,
+    hasElevenLabsKey: Boolean(process.env.ELEVENLABS_API_KEY),
+    hasBridgeToken: Boolean(process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN),
+    bridgeBaseUrl: process.env.GROWTHUB_BRIDGE_BASE_URL || null,
+    videoModelProvider: process.env.VIDEO_MODEL_PROVIDER || null,
+    hasGoogleKey: Boolean(process.env.GOOGLE_AI_API_KEY),
+    hasFalKey: Boolean(process.env.FAL_API_KEY),
+    hasRunwayKey: Boolean(process.env.RUNWAY_API_KEY),
+  };
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/lib/adapters/generative/index.js

@@ -0,0 +1,31 @@
+const ADAPTERS = {
+  "growthub-pipeline": {
+    id: "growthub-pipeline",
+    label: "growthub-pipeline",
+    description: "Hosted CMS video-generation node via growthub pipeline execute. Requires GROWTHUB_BRIDGE_ACCESS_TOKEN + authenticated session.",
+    requiredEnv: ["GROWTHUB_BRIDGE_ACCESS_TOKEN", "GROWTHUB_BRIDGE_BASE_URL"],
+    cliCommand: "growthub pipeline execute '<DynamicRegistryPipeline JSON>'",
+    sdkContract: "@growthub/api-contract — DynamicRegistryPipeline, ExecutionEvent, isExecutionEvent",
+  },
+  "byo-api-key": {
+    id: "byo-api-key",
+    label: "byo-api-key",
+    description: "Direct provider SDK calls. Set VIDEO_MODEL_PROVIDER (veo | fal | runway) + provider key.",
+    requiredEnv: ["VIDEO_MODEL_PROVIDER"],
+    cliCommand: null,
+    sdkContract: "provider SDK — Google AI / Fal / Runway",
+  },
+};
+
+export function describeGenerativeAdapter() {
+  const id = process.env.CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER || "growthub-pipeline";
+  return ADAPTERS[id] ?? ADAPTERS["growthub-pipeline"];
+}
+
+export function readGenerativeConfig() {
+  const adapter = describeGenerativeAdapter();
+  return {
+    adapter,
+    missingEnv: adapter.requiredEnv.filter((k) => !process.env[k]),
+  };
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/lib/domain/pipeline.js

@@ -0,0 +1,30 @@
+export const pipelineStages = [
+  {
+    id: "brief",
+    step: "01",
+    label: "Brief",
+    description: "Brand-grounded creative brief sourced from brand-kit.md. Scene structure, hooks, and constraints locked before generation.",
+    outputPath: "output/<client>/<project>/brief/pipeline-brief.md",
+  },
+  {
+    id: "generate",
+    step: "02",
+    label: "Generate",
+    description: "Generative image/video via adapter (growthub-pipeline or byo-api-key). Normalised to GenerativeArtifact[] + manifest.json.",
+    outputPath: "output/<client>/<project>/generative/manifest.json",
+  },
+  {
+    id: "edit",
+    step: "03",
+    label: "Edit",
+    description: "ElevenLabs Scribe transcription → word-boundary EDL → FFmpeg render via video-use fork. Final output: final.mp4.",
+    outputPath: "output/<client>/<project>/final/final.mp4",
+  },
+];
+
+export const stageStatus = {
+  PENDING: "pending",
+  ACTIVE: "active",
+  COMPLETE: "complete",
+  ERROR: "error",
+};

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/next.config.js

@@ -0,0 +1,10 @@
+const nextConfig = {
+  typedRoutes: false,
+  turbopack: {
+    root: process.cwd()
+  }
+};
+var stdin_default = nextConfig;
+export {
+  stdin_default as default
+};

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

@@ -0,0 +1,17 @@
+{
+  "name": "growthub-creative-video-pipeline-app",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "growthub-creative-video-pipeline-app",
+      "version": "1.0.0",
+      "dependencies": {
+        "next": "16.2.4",
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "name": "growthub-creative-video-pipeline-app",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "16.2.4",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  }
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/postcss.config.mjs

@@ -0,0 +1,3 @@
+export default {
+  plugins: {},
+};

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

@@ -0,0 +1,5 @@
+{
+  "framework": "nextjs",
+  "buildCommand": "npm run build",
+  "installCommand": "npm install"
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/brands/NEW-CLIENT.md

@@ -0,0 +1,21 @@
+# New Client — Onboarding
+
+When the operator starts a new project:
+
+1. Create `brands/<client-slug>/brand-kit.md` from the `_template` scaffold.
+2. Fill in all YAML fields — Identity, Audience, Messaging, Brand Design, Talent, Assets, Platform.
+3. Create `brands/<client-slug>/assets/` for logo and reference images.
+4. Append a `registered` event to `.growthub-fork/trace.jsonl` with `{clientSlug}` in the detail.
+5. Run `growthub kit fork status <fork-id>` to confirm no drift was introduced.
+
+The `_template/` brand is upstream-owned; all real client work lives under `brands/<client-slug>/`.
+
+## Quick scaffold
+
+```bash
+SLUG=<client-slug>
+cp brands/_template/brand-kit.md brands/${SLUG}/brand-kit.md
+mkdir -p brands/${SLUG}/assets
+```
+
+Fill every field. Use "N/A" or "TBD" if unknown — do not delete keys.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/brands/_template/brand-kit.md

@@ -0,0 +1,123 @@
+# Brand Kit — [CLIENT NAME]
+> Copy this file to `brands/<client-slug>/brand-kit.md` and fill in every field.
+> Leave no field blank. Use "N/A" or "TBD" if unknown — do not delete the key.
+
+---
+
+## IDENTITY
+
+```yaml
+client_name:       ""           # Full legal/brand name
+slug:              ""           # kebab-case folder name e.g. "greentree-wellness"
+industry:          ""           # e.g. Healthcare / Med Spa / Legal / Real Estate
+primary_service:   ""           # The ONE service this campaign promotes
+campaign_name:     ""           # e.g. "Regenerative Medicine — Spring 2026"
+date_onboarded:    ""           # YYYY-MM-DD
+account_owner:     ""           # Internal contact name
+```
+
+---
+
+## AUDIENCE
+
+```yaml
+target_age_range:      ""       # e.g. "55–70"
+target_gender:         ""       # e.g. "All" / "Female-skewing" / "Male"
+target_pain_point:     ""       # e.g. "Chronic joint pain — knees, hips, shoulders"
+target_intent:         ""       # e.g. "Actively seeking non-surgical treatment options"
+geographic_target:     ""       # e.g. "New Jersey — Bergen/Morris/Essex County"
+do_not_attract:        ""       # Who we explicitly DO NOT want — critical for ad targeting
+                                # e.g. "Pain medication / opioid patients. People seeking prescriptions."
+```
+
+---
+
+## MESSAGING
+
+```yaml
+core_message:          ""       # One sentence — what the brand promises
+emotional_arc:         ""       # e.g. "Struggle → Recognition → Transformation → Action"
+tone:                  []       # 3–5 adjectives e.g. ["warm", "credible", "science-informed", "hopeful"]
+approved_phrases:      []       # Language that IS approved for use
+                                # e.g. ["natural healing", "body's own repair process", "results within weeks"]
+messaging_guardrails:  []       # Language that is NEVER allowed
+                                # e.g. ["pain management", "medication", "prescriptions", "opioids"]
+cta_text:              ""       # Primary CTA e.g. "Schedule Your Free Consultation"
+cta_offer:             ""       # Offer text e.g. "Free Initial Assessment" / "50% off first visit"
+```
+
+---
+
+## BRAND DESIGN
+
+```yaml
+colors:
+  primary:       ""             # Hex e.g. "2D6A4F"
+  secondary:     ""             # Hex e.g. "40916C"
+  light_accent:  ""             # Hex e.g. "D8F3DC"
+  dark:          ""             # Hex e.g. "1B1B1B"
+  white:         "FFFFFF"
+  mid_gray:      "6B7280"
+
+fonts:
+  primary:       "Arial"        # Default — change only if brand font is embedded
+  heading_size:  56             # Half-points. 56 = 28pt heading
+  body_size:     20             # Half-points. 20 = 10pt body
+
+logo_file:       ""             # Relative path e.g. "assets/logo.png"
+logo_on_dark:    ""             # Version for dark backgrounds e.g. "assets/logo-white.png"
+```
+
+---
+
+## TALENT & PRODUCTION
+
+```yaml
+doctor_or_founder_name:  ""     # Full name + credentials e.g. "Dr. Anthony Carabasi, DO"
+founder_on_camera:       ""     # Yes / No / Available on request
+ai_avatar_type:          ""     # Photoreal / Talking Head / UGC / None
+ai_actor_age_range:      ""     # e.g. "55–65"
+ai_actor_notes:          ""     # e.g. "Warm, relatable, diverse — 2 actors per creative"
+ugc_inspiration:         ""     # Link to reference actors/style
+vo_style:                ""     # e.g. "Warm credible male, 40–55, calm pace — NOT announcer"
+broll_cadence:           ""     # e.g. "Cut every ~3 seconds — never >3s of uninterrupted talking head"
+```
+
+---
+
+## ASSET LINKS
+
+```yaml
+brand_assets_air:    ""         # e.g. "https://app.air.inc/a/b302d671b"
+broll_library:       ""         # e.g. "https://app.air.inc/a/b9bf52f3b"
+ugc_inspiration:     ""         # e.g. "https://app.air.inc/a/bb21113fd"
+google_drive:        ""         # Drive folder link if applicable
+instagram:           ""         # Instagram handle or URL
+tiktok:              ""         # TikTok handle or URL
+website:             ""         # Main website URL
+landing_page:        ""         # Specific campaign landing page URL
+phone_number:        ""         # Contact number for CTA overlays
+previous_ads:        []         # List of previous ad files/links for reference
+```
+
+---
+
+## PLATFORM & FORMAT
+
+```yaml
+primary_platforms:   []         # e.g. ["Meta Feed", "Instagram Reels", "YouTube Pre-Roll"]
+aspect_ratios:       []         # e.g. ["9:16", "1:1", "16:9"]
+caption_default:     "ON"       # ON / OFF — always ON unless client specifies otherwise
+compliance_notes:    ""         # Any legal/regulatory constraints
+                                # e.g. "No before/after guarantees. 'Results may vary' required if specific claims made."
+```
+
+---
+
+## DELIVERABLES LOG
+
+> Append a new line each time a deliverable is completed.
+
+```
+- YYYY-MM-DD | [Asset Type] v[N] | [file path or link]
+```