@growthub/cli 0.7.7 → 0.7.9

package/assets/worker-kits/growthub-video-use-studio-v1/.env.example

@@ -0,0 +1,13 @@
+# Growthub Video Use Studio — Environment Config
+# Copy this file to .env and fill in your local values.
+# Never commit .env to version control.
+
+# Absolute path to your local video-use clone.
+# Canonical env var: VIDEO_USE_HOME (uniform pattern across all worker kits)
+# Legacy alias: VIDEO_USE_FORK_PATH (still accepted by setup scripts)
+# Default when unset: $HOME/video-use
+VIDEO_USE_HOME=$HOME/video-use
+
+# ElevenLabs Scribe key — required for transcript generation.
+# Get one at https://elevenlabs.io/app/settings/api-keys
+ELEVENLABS_API_KEY=your_elevenlabs_key_here

package/assets/worker-kits/growthub-video-use-studio-v1/QUICKSTART.md

@@ -0,0 +1,47 @@
+# Video Use Studio Quickstart
+
+## 1) Prepare environment
+
+```bash
+cp .env.example .env
+bash setup/check-deps.sh
+node setup/verify-env.mjs
+```
+
+Required in `.env`:
+
+- `VIDEO_USE_HOME` — absolute path to your local video-use clone (default `$HOME/video-use`)
+- `ELEVENLABS_API_KEY` — ElevenLabs Scribe key for transcript generation
+
+## 2) Clone the video-use upstream
+
+```bash
+bash setup/clone-fork.sh
+```
+
+Clones [`browser-use/video-use`](https://github.com/browser-use/video-use) into `${VIDEO_USE_HOME:-$HOME/video-use}` and runs `pip install -e .`.
+
+## 3) Register as a Claude Code skill
+
+```bash
+bash setup/install-skill.sh
+```
+
+Symlinks the fork into `~/.claude/skills/video-use` per the upstream contract, so Claude Code can load the conversational edit pipeline from any working directory.
+
+## 4) Start work
+
+- Point your agent Working Directory to this exported folder.
+- Follow `workers/video-use-studio-operator/CLAUDE.md`.
+- Place raw footage in `${VIDEO_USE_HOME}/<project>/` and open Claude Code from that directory.
+- Write planning outputs to `output/<client-slug>/<project-slug>/`.
+- Rendered video lands at `${VIDEO_USE_HOME}/<project>/edit/final.mp4` per the upstream contract.
+
+## Execution modes
+
+| Mode | When to use |
+|---|---|
+| `claude-code-skill` | Conversational editing through Claude Code with video-use symlinked as a skill |
+| `local-cli` | Direct Python pipeline runs inside the fork (inventory → transcribe → pack → render) |
+
+See `docs/video-use-fork-integration.md` for the upstream pipeline contract.

package/assets/worker-kits/growthub-video-use-studio-v1/brands/NEW-CLIENT.md

@@ -0,0 +1,3 @@
+# NEW CLIENT
+
+Copy `brands/_template/brand-kit.md` into a new client folder before planning.

package/assets/worker-kits/growthub-video-use-studio-v1/brands/_template/brand-kit.md

@@ -0,0 +1,7 @@
+# Brand Kit Template
+
+- Brand:
+- Audience:
+- Voice:
+- Visual style:
+- Must avoid:

package/assets/worker-kits/growthub-video-use-studio-v1/brands/growthub/brand-kit.md

@@ -0,0 +1,6 @@
+# Growthub Brand Kit
+
+- Brand: Growthub
+- Audience: operators and builders
+- Voice: direct, practical
+- Visual style: clear typography, high contrast, low-motion transitions

package/assets/worker-kits/growthub-video-use-studio-v1/bundles/growthub-video-use-studio-v1.json

@@ -0,0 +1,49 @@
+{
+  "schemaVersion": 2,
+  "bundle": {
+    "id": "growthub-video-use-studio-v1",
+    "version": "1.0.0",
+    "kitId": "growthub-video-use-studio-v1",
+    "workerId": "video-use-studio-operator"
+  },
+  "briefType": "video-use-conversational-edit",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "requiredFrozenAssets": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/video-use-studio-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/clone-fork.sh",
+    "setup/install-skill.sh",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/video-brief.md",
+    "templates/edit-strategy.md",
+    "templates/edit-decision-list.md",
+    "templates/render-plan.md",
+    "templates/qa-checklist.md",
+    "examples/video-brief-sample.md",
+    "docs/video-use-fork-integration.md",
+    "docs/provider-adapter-layer.md",
+    "docs/video-use-discovery-path.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "optionalPresets": [],
+  "export": {
+    "folderName": "growthub-agent-worker-kit-video-use-studio-v1",
+    "zipFileName": "growthub-agent-worker-kit-video-use-studio-v1.zip"
+  },
+  "activationModes": [
+    "export"
+  ]
+}

package/assets/worker-kits/growthub-video-use-studio-v1/docs/provider-adapter-layer.md

@@ -0,0 +1,15 @@
+# Provider Adapter Layer
+
+This kit is a custom workspace package and does not add a new server adapter or agent harness.
+
+It relies on:
+
+- Worker kit export contract
+- Working Directory execution
+- Upstream `browser-use/video-use` fork
+- ElevenLabs Scribe (transcription) via `ELEVENLABS_API_KEY`
+- Local FFmpeg for render
+- Optional `yt-dlp` for pulling online sources
+- Claude Code skill loader at `~/.claude/skills/video-use`
+
+No credentials are stored in this repo. All secrets live in the per-export `.env`.

package/assets/worker-kits/growthub-video-use-studio-v1/docs/video-use-discovery-path.md

@@ -0,0 +1,13 @@
+# Video Use Discovery Path
+
+Discovery path:
+
+- `growthub discover` → `Worker Kits` → `Custom Workspaces`
+- `growthub kit list --family studio`
+- `growthub kit download video-use`
+
+Feature branch demo checks:
+
+- `bash scripts/demo-cli.sh cli kit list --family studio`
+- `bash scripts/demo-cli.sh cli kit inspect video-use`
+- `bash scripts/demo-cli.sh cli kit download video-use`

package/assets/worker-kits/growthub-video-use-studio-v1/docs/video-use-fork-integration.md

@@ -0,0 +1,35 @@
+# Video Use Fork Integration
+
+Upstream repository:
+
+- `https://github.com/browser-use/video-use`
+
+Primary execution flow:
+
+1. Clone + install with `setup/clone-fork.sh` (runs `pip install -e .` inside the fork).
+2. Register as a Claude Code skill with `setup/install-skill.sh` (symlinks the fork into `~/.claude/skills/video-use`).
+3. Stage raw footage under `${VIDEO_USE_HOME}/<project>/`.
+4. Launch `claude` from the project directory and start the conversational edit loop.
+
+Pipeline contract (upstream):
+
+```
+inventory → transcribe (ElevenLabs Scribe) → pack phrase-level transcript
+         → converse + propose strategy (4–8 sentences)
+         → user confirmation
+         → EDL generation (word-boundary cuts)
+         → render (FFmpeg + Manim / Remotion / PIL overlays)
+         → self-evaluation (up to 3 iterations)
+         → final.mp4 at <project>/edit/final.mp4
+```
+
+Session persistence:
+
+- Every confirmed decision is appended to `project.md` inside the source video directory.
+
+Two-layer architecture:
+
+- Layer 1 — ElevenLabs Scribe transcript (word-level, speaker-tagged, audio-event markers). The packed transcript is the editor's primary reading view (≈12 KB text + occasional PNGs).
+- Layer 2 — Visual composites (filmstrip / waveform / word labels) generated on-demand for ambiguous decision points only.
+
+Token budget: orders of magnitude lower than raw frame processing.

package/assets/worker-kits/growthub-video-use-studio-v1/examples/video-brief-sample.md

@@ -0,0 +1,11 @@
+# Sample Video Brief
+
+- Goal: Cut founder interview into a 60-second launch teaser
+- Audience: prospective operators browsing the landing page
+- Source footage directory: `${VIDEO_USE_HOME}/launch-teaser/raw/`
+- Duration target: 00:60
+- Aspect ratio: 9:16 (vertical)
+- Delivery format: MP4 (h264 / aac)
+- Aesthetic direction: high-contrast, minimal overlays, captions on every beat
+- Speakers / on-camera subjects: 1 (founder)
+- External sources to pull via `yt-dlp`: none

package/assets/worker-kits/growthub-video-use-studio-v1/growthub-meta/README.md

@@ -0,0 +1,3 @@
+# Video Use Workspace Meta
+
+This directory stores metadata and standards for `growthub-video-use-studio-v1`.

package/assets/worker-kits/growthub-video-use-studio-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,6 @@
+# Kit Standard
+
+- schemaVersion: 2
+- family: studio
+- executionMode: export
+- activationModes: export

package/assets/worker-kits/growthub-video-use-studio-v1/kit.json

@@ -0,0 +1,100 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-video-use-studio-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — Video Use Studio",
+    "description": "Self-contained local execution environment for conversational video editing with browser-use/video-use. Produces implementation-ready video briefs, transcript-driven edit strategies, edit decision lists, render plans, and QA handoff artifacts for ElevenLabs Scribe + FFmpeg workflows.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "video-use-studio-operator",
+    "path": "workers/video-use-studio-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "video-use-studio-operator"
+  ],
+  "agentContractPath": "workers/video-use-studio-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/video-use-studio-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/clone-fork.sh",
+    "setup/install-skill.sh",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/video-brief.md",
+    "templates/edit-strategy.md",
+    "templates/edit-decision-list.md",
+    "templates/render-plan.md",
+    "templates/qa-checklist.md",
+    "examples/video-brief-sample.md",
+    "docs/video-use-fork-integration.md",
+    "docs/provider-adapter-layer.md",
+    "docs/video-use-discovery-path.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "envExample": ".env.example",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is intended to be pointed at directly by the agent Working Directory. All planning outputs are markdown files written to output/<client-slug>/<project-slug>/. Rendered video artifacts land at ${VIDEO_USE_HOME}/<videos_dir>/edit/final.mp4 per the upstream video-use contract.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      ".env.example",
+      "kit.json",
+      "bundles/growthub-video-use-studio-v1.json",
+      "skills.md",
+      "workers/video-use-studio-operator/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/growthub/brand-kit.md",
+      "brands/NEW-CLIENT.md",
+      "setup/clone-fork.sh",
+      "setup/install-skill.sh",
+      "setup/verify-env.mjs",
+      "setup/check-deps.sh",
+      "output/README.md",
+      "templates",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-video-use-studio-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-video-use-studio-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.4.3"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-23T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-video-use-studio-v1/output/README.md

@@ -0,0 +1,9 @@
+# Output Directory
+
+Save planning outputs under:
+
+- `output/<client-slug>/<project-slug>/`
+
+Rendered video artifacts are produced by the upstream pipeline at:
+
+- `${VIDEO_USE_HOME}/<project>/edit/final.mp4`

package/assets/worker-kits/growthub-video-use-studio-v1/output-standards.md

@@ -0,0 +1,19 @@
+# Output Standards
+
+Planning deliverables — write to:
+
+- `output/<client-slug>/<project-slug>/`
+
+Minimum required planning artifacts:
+
+- `video-brief.md`
+- `edit-strategy.md`
+- `edit-decision-list.md`
+- `render-plan.md`
+- `qa-checklist.md`
+
+Rendered video artifact — produced by the upstream pipeline:
+
+- `${VIDEO_USE_HOME}/<project>/edit/final.mp4`
+
+Every decision appended to `project.md` inside the source video directory per the upstream video-use session-persistence contract.

package/assets/worker-kits/growthub-video-use-studio-v1/runtime-assumptions.md

@@ -0,0 +1,9 @@
+# Runtime Assumptions
+
+- Upstream project: `https://github.com/browser-use/video-use`
+- Python `>=3.11` with `pip` available
+- `ffmpeg` available in PATH (required)
+- `yt-dlp` available in PATH (optional — only for downloading online sources)
+- `ELEVENLABS_API_KEY` set in `.env` — required for transcript generation via ElevenLabs Scribe
+- `~/.claude/skills/video-use` symlink present — set up by `setup/install-skill.sh`
+- Commands run from an exported working directory; raw footage lives under `${VIDEO_USE_HOME}/<project>/`

package/assets/worker-kits/growthub-video-use-studio-v1/setup/check-deps.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1 || {
+    echo "Missing dependency: $1" >&2
+    exit 1
+  }
+}
+
+optional_cmd() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "Optional dependency not found: $1 (only needed for downloading online sources)" >&2
+  fi
+}
+
+need_cmd python3
+need_cmd pip3
+need_cmd git
+need_cmd ffmpeg
+optional_cmd yt-dlp

package/assets/worker-kits/growthub-video-use-studio-v1/setup/clone-fork.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_URL="${VIDEO_USE_REPO_URL:-https://github.com/browser-use/video-use}"
+# Canonical: VIDEO_USE_HOME. Legacy alias: VIDEO_USE_FORK_PATH.
+LOCAL_PATH="${VIDEO_USE_HOME:-${VIDEO_USE_FORK_PATH:-$HOME/video-use}}"
+
+if [ -d "${LOCAL_PATH}/.git" ]; then
+  git -C "${LOCAL_PATH}" fetch origin
+  git -C "${LOCAL_PATH}" pull --ff-only
+else
+  git clone "${REPO_URL}" "${LOCAL_PATH}"
+fi
+
+# Install the upstream package in editable mode so the CLI + skill resolve correctly.
+if command -v pip3 >/dev/null 2>&1; then
+  (cd "${LOCAL_PATH}" && pip3 install -e .)
+fi

package/assets/worker-kits/growthub-video-use-studio-v1/setup/install-skill.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Register the video-use fork as a Claude Code skill per the upstream README contract.
+# Canonical: VIDEO_USE_HOME. Legacy alias: VIDEO_USE_FORK_PATH.
+LOCAL_PATH="${VIDEO_USE_HOME:-${VIDEO_USE_FORK_PATH:-$HOME/video-use}}"
+SKILLS_DIR="${CLAUDE_SKILLS_DIR:-$HOME/.claude/skills}"
+LINK_PATH="${SKILLS_DIR}/video-use"
+
+if [ ! -d "${LOCAL_PATH}" ]; then
+  echo "video-use fork not found at ${LOCAL_PATH}. Run setup/clone-fork.sh first." >&2
+  exit 1
+fi
+
+mkdir -p "${SKILLS_DIR}"
+
+if [ -L "${LINK_PATH}" ] || [ -e "${LINK_PATH}" ]; then
+  echo "Skill entry already present at ${LINK_PATH}. Leaving as-is." >&2
+  exit 0
+fi
+
+ln -s "${LOCAL_PATH}" "${LINK_PATH}"
+echo "Linked ${LOCAL_PATH} -> ${LINK_PATH}"

package/assets/worker-kits/growthub-video-use-studio-v1/setup/verify-env.mjs

@@ -0,0 +1,23 @@
+import fs from "node:fs";
+import path from "node:path";
+
+const envPath = path.resolve(process.cwd(), ".env");
+if (!fs.existsSync(envPath)) {
+  console.error(".env not found. Run: cp .env.example .env");
+  process.exit(1);
+}
+
+const raw = fs.readFileSync(envPath, "utf8");
+
+// Canonical: VIDEO_USE_HOME. Legacy alias: VIDEO_USE_FORK_PATH.
+if (!raw.includes("VIDEO_USE_HOME=") && !raw.includes("VIDEO_USE_FORK_PATH=")) {
+  console.error("VIDEO_USE_HOME (or legacy VIDEO_USE_FORK_PATH) is required in .env");
+  process.exit(1);
+}
+
+if (!/ELEVENLABS_API_KEY=\S/.test(raw) || /ELEVENLABS_API_KEY=your_elevenlabs_key_here/.test(raw)) {
+  console.error("ELEVENLABS_API_KEY is required in .env (for ElevenLabs Scribe transcription)");
+  process.exit(1);
+}
+
+console.log("Environment check passed.");

package/assets/worker-kits/growthub-video-use-studio-v1/skills.md

@@ -0,0 +1,21 @@
+# Video Use Studio Skills
+
+1. Read `runtime-assumptions.md`.
+2. Read `docs/video-use-fork-integration.md`.
+3. Confirm target format: content type, target length, aesthetic direction.
+4. Produce, in order:
+   - `templates/video-brief.md` — source inventory, goal, audience, duration
+   - `templates/edit-strategy.md` — 4–8 sentence proposed approach, wait for confirmation
+   - `templates/edit-decision-list.md` — transcript-anchored EDL with word-boundary cuts
+   - `templates/render-plan.md` — FFmpeg commands, overlay tool choice (Manim / Remotion / PIL)
+   - `templates/qa-checklist.md` — twelve production rules pass, subtitles-last validation
+
+Non-negotiable rules enforced by this kit:
+
+- Subtitles are applied last, after all overlays.
+- 30 ms audio fades at every segment boundary.
+- Word-boundary snapping for every cut; never cut inside a word.
+- Overlays use `setpts=PTS-STARTPTS+T/TB` for timing.
+- Cached transcripts are reused; never re-transcribe a source twice.
+
+Use deterministic command paths. Resolve workspace with `${VIDEO_USE_HOME:-$HOME/video-use}`. Never expose `ELEVENLABS_API_KEY` in output artifacts.

package/assets/worker-kits/growthub-video-use-studio-v1/templates/edit-decision-list.md

@@ -0,0 +1,17 @@
+# Edit Decision List
+
+Every cut is snapped to a word boundary from the packed transcript. Timestamps are source-relative (HH:MM:SS.mmm). Never cut inside a word.
+
+| # | Source file | In (word-boundary) | Out (word-boundary) | Pad (ms) | Overlay | Notes |
+|---|---|---|---|---|---|---|
+|   |   |   |   |   |   |   |
+
+## Overlay references
+
+- Overlay tool (Manim / Remotion / PIL):
+- Timing shift formula: `setpts=PTS-STARTPTS+T/TB`
+
+## Caption strategy
+
+- Packed phrase-level transcript path:
+- Subtitles applied last, after all overlays.

package/assets/worker-kits/growthub-video-use-studio-v1/templates/edit-strategy.md

@@ -0,0 +1,11 @@
+# Edit Strategy
+
+4–8 sentences describing the proposed edit approach. The user must confirm this document in plain English before an EDL is generated.
+
+- Opening hook:
+- Core through-line:
+- Pacing bias (tight / breathing / mixed):
+- Aesthetic direction (grade, overlay tool, typography):
+- Captions strategy:
+- Target length + rationale:
+- Risks to surface during self-evaluation:

package/assets/worker-kits/growthub-video-use-studio-v1/templates/qa-checklist.md

@@ -0,0 +1,21 @@
+# QA Checklist — Twelve Production Rules
+
+- [ ] Subtitles applied last, after every overlay
+- [ ] 30 ms audio fade at every segment boundary
+- [ ] Overlays shifted with `setpts=PTS-STARTPTS+T/TB`
+- [ ] Every cut snapped to a word boundary
+- [ ] Cut edges padded 30–200 ms
+- [ ] No cut inside a word
+- [ ] No re-transcription of a cached source
+- [ ] Caption alignment matches the packed phrase-level transcript
+- [ ] 30 ms fade-out on every overlay exit
+- [ ] Subtitle sequencing respects speaker turns
+- [ ] Output validated (duration, codec, resolution) before handoff
+- [ ] Every destructive edit decision appended to `project.md`
+
+## Delivery checks
+
+- [ ] Duration matches brief (± 500 ms)
+- [ ] Aspect ratio correct
+- [ ] Audio sync verified
+- [ ] `${VIDEO_USE_HOME}/<project>/edit/final.mp4` exists and plays end-to-end

package/assets/worker-kits/growthub-video-use-studio-v1/templates/render-plan.md

@@ -0,0 +1,40 @@
+# Render Plan
+
+## Source resolution
+
+```bash
+WORKSPACE="${VIDEO_USE_HOME:-${VIDEO_USE_FORK_PATH:-$HOME/video-use}}"
+PROJECT_DIR="${WORKSPACE}/<project>"
+```
+
+## Transcription (idempotent — never re-transcribe a cached source)
+
+```bash
+cd "${PROJECT_DIR}"
+# ElevenLabs Scribe, keyed by ELEVENLABS_API_KEY from .env
+python -m video_use.transcribe --source <input.mp4>
+```
+
+## Render
+
+```bash
+cd "${PROJECT_DIR}"
+python -m video_use.render \
+  --edl ../output/<client-slug>/<project-slug>/edit-decision-list.md \
+  --overlay <manim|remotion|pil> \
+  --out edit/final.mp4
+```
+
+## FFmpeg hard constraints
+
+- 30 ms audio fade at every segment boundary.
+- Word-boundary snapping for all cuts; pad edges 30–200 ms.
+- Overlays shifted with `setpts=PTS-STARTPTS+T/TB`.
+- Subtitles are applied last.
+
+## Checks
+
+- Output path: `${PROJECT_DIR}/edit/final.mp4`
+- Duration matches brief (± 500 ms)
+- Codec: h264, audio: aac
+- Self-evaluation loop runs up to 3 times before surfacing output

package/assets/worker-kits/growthub-video-use-studio-v1/templates/video-brief.md

@@ -0,0 +1,11 @@
+# Video Brief
+
+- Goal:
+- Audience:
+- Source footage directory (`${VIDEO_USE_HOME}/<project>/`):
+- Duration target:
+- Aspect ratio:
+- Delivery format: MP4 (h264)
+- Aesthetic direction:
+- Speakers / on-camera subjects:
+- External sources to pull via `yt-dlp` (optional):

package/assets/worker-kits/growthub-video-use-studio-v1/validation-checklist.md

@@ -0,0 +1,11 @@
+# Validation Checklist
+
+- [ ] `bash setup/check-deps.sh` — Python, pip, git, ffmpeg present
+- [ ] `node setup/verify-env.mjs` — `VIDEO_USE_HOME` and `ELEVENLABS_API_KEY` set
+- [ ] `bash setup/clone-fork.sh` — video-use cloned and `pip install -e .` succeeded
+- [ ] `bash setup/install-skill.sh` — `~/.claude/skills/video-use` symlink in place
+- [ ] Source footage staged under `${VIDEO_USE_HOME}/<project>/`
+- [ ] Planning artifacts written to `output/<client-slug>/<project-slug>/`
+- [ ] `edit-strategy.md` confirmed before EDL generation
+- [ ] Twelve production rules checklist passes in `qa-checklist.md`
+- [ ] Final render exists at `${VIDEO_USE_HOME}/<project>/edit/final.mp4`

package/assets/worker-kits/growthub-video-use-studio-v1/workers/video-use-studio-operator/CLAUDE.md

@@ -0,0 +1,71 @@
+# Video Use Studio Operator
+
+**Kit:** `growthub-video-use-studio-v1`  
+**Worker ID:** `video-use-studio-operator`  
+**Version:** `1.0.0`
+
+## Role
+
+You convert raw footage and edit intent into implementation-ready video-use artifacts: a brief, a confirmed edit strategy, a transcript-anchored EDL, a render plan, and a QA pass. You operate the upstream [browser-use/video-use](https://github.com/browser-use/video-use) pipeline (transcription → packing → LLM reasoning → EDL → render → self-eval) from an exported working directory.
+
+## Required startup
+
+1. Read `skills.md`.
+2. Read `runtime-assumptions.md`.
+3. Read `docs/video-use-fork-integration.md`.
+4. Resolve `WORKSPACE="${VIDEO_USE_HOME:-${VIDEO_USE_FORK_PATH:-$HOME/video-use}}"`.
+5. Verify environment with `node setup/verify-env.mjs`.
+
+If setup checks fail, stop and return remediation only. Do not invent API keys or hardcode machine paths.
+
+## Input contract
+
+- Raw footage already staged under `${VIDEO_USE_HOME}/<project>/`.
+- Brand kit at `brands/<client>/brand-kit.md` (copied from `brands/_template/`).
+- User-supplied goal, target length, aesthetic direction.
+
+## Output artifacts
+
+Write every planning deliverable to `output/<client-slug>/<project-slug>/`:
+
+- `video-brief.md` — goal, audience, duration, ratio, delivery format
+- `edit-strategy.md` — 4–8 sentence proposed approach, wait for explicit user confirmation before proceeding
+- `edit-decision-list.md` — transcript-anchored cut list with word-boundary timestamps and overlay markers
+- `render-plan.md` — FFmpeg filter graph, overlay tool choice, caption sequencing
+- `qa-checklist.md` — twelve production rules pass
+
+Rendered output is the upstream pipeline's responsibility:
+
+- `${VIDEO_USE_HOME}/<project>/edit/final.mp4`
+
+## Fork integration
+
+- Upstream contract: conversational edits via Claude Code skill at `~/.claude/skills/video-use`.
+- Transcription: ElevenLabs Scribe (word-level, speaker-tagged, audio-event markers).
+- Overlays: Manim / Remotion / PIL — operator chooses per project aesthetic.
+- Session persistence: append each decision to `project.md` inside the source video directory.
+- Self-evaluation loop: up to three iterative fixes before surfacing output to the user.
+
+## Non-negotiable production rules
+
+1. Subtitles last — applied after every overlay.
+2. 30 ms audio fade at every segment boundary.
+3. Overlays shifted with `setpts=PTS-STARTPTS+T/TB`.
+4. Word-boundary snapping for every cut.
+5. Pad cut edges with a 30–200 ms working window.
+6. Never cut inside a word.
+7. Never re-transcribe a cached source.
+8. Caption alignment matches the packed phrase-level transcript.
+9. 30 ms fade-out on every overlay exit.
+10. Subtitle sequencing respects speaker turns.
+11. Output is validated (duration, codec, resolution) before user handoff.
+12. Every destructive edit decision is logged to `project.md`.
+
+## Troubleshooting
+
+- Missing `ELEVENLABS_API_KEY` → re-run `node setup/verify-env.mjs`.
+- CORS / network failures on transcription → check the ElevenLabs key is active.
+- `~/.claude/skills/video-use` missing → re-run `bash setup/install-skill.sh`.
+- `ffmpeg`/`yt-dlp` not found → re-run `bash setup/check-deps.sh`.
+
+Never write `.env` secrets into any output artifact. Never hardcode absolute user paths; always resolve through `${VIDEO_USE_HOME}` with a `$HOME/video-use` fallback.

package/dist/index.js

@@ -8563,6 +8563,15 @@ var init_catalog = __esm({
         executionMode: "export",
         activationModes: ["export"],
         family: "studio"
+      },
+      {
+        id: "growthub-video-use-studio-v1",
+        packageDirName: "growthub-video-use-studio-v1",
+        defaultBundleId: "growthub-video-use-studio-v1",
+        type: "worker",
+        executionMode: "export",
+        activationModes: ["export"],
+        family: "studio"
       }
     ];
   }
@@ -21389,10 +21398,13 @@ Examples:
   $ growthub kit list --json              # machine-readable output
   $ growthub kit download higgsfield      # fuzzy slug \u2014 resolves automatically
   $ growthub kit download hyperframes     # Hyperframes custom workspace
+  $ growthub kit download video-use       # browser-use/video-use custom workspace
   $ growthub kit download growthub-open-higgsfield-studio-v1
   $ growthub kit download growthub-hyperframes-studio-v1
+  $ growthub kit download growthub-video-use-studio-v1
   $ growthub kit inspect higgsfield-studio-v1
   $ growthub kit inspect hyperframes
+  $ growthub kit inspect video-use
   $ growthub kit families                 # show family taxonomy
 
 Fork Sync Agent:
@@ -21521,7 +21533,7 @@ Examples:
   });
   kit.command("families").description("Show the kit family taxonomy with descriptions and examples").action(() => {
     const defs = [
-      { family: "studio", tagline: "AI generation studio backed by a local fork", surfaces: "local-fork, browser-hosted, desktop-app", example: "growthub-open-higgsfield-studio-v1, growthub-hyperframes-studio-v1, growthub-zernio-social-v1" },
+      { family: "studio", tagline: "AI generation studio backed by a local fork", surfaces: "local-fork, browser-hosted, desktop-app", example: "growthub-open-higgsfield-studio-v1, growthub-hyperframes-studio-v1, growthub-video-use-studio-v1, growthub-zernio-social-v1" },
       { family: "workflow", tagline: "Multi-step pipeline operator across tools or APIs", surfaces: "browser-hosted (primary)", example: "creative-strategist-v1" },
       { family: "operator", tagline: "Domain vertical specialist \u2014 one provider, structured deliverables", surfaces: "browser-hosted", example: "growthub-email-marketing-v1" },
       { family: "ops", tagline: "Infrastructure / toolchain operator (provider optional)", surfaces: "local-fork (primary)", example: "(coming soon)" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthub/cli",
-  "version": "0.7.7",
+  "version": "0.7.9",
   "description": "Growthub Local is a control plane for forked worker kits. The CLI is the executor, the hosted app is the identity authority, the worker kit is the unit of portable agent infrastructure, and the fork is the operator's personal branch of that infrastructure — policy-governed, trace-backed, and self-healing.",
   "type": "module",
   "bin": {
@@ -42,7 +42,7 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.888.0",
     "@clack/prompts": "^0.10.0",
-    "@growthub/api-contract": "workspace:*",
+    "@growthub/api-contract": "1.0.0-alpha.1",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "better-auth": "1.4.18",