@growthub/cli 0.3.33 → 0.3.35

package/README.md

@@ -16,6 +16,27 @@ Later:
 npx create-growthub-local --profile gtm
 ```
 
+## Worker Kits V1
+
+The CLI also ships a bundled Worker Kit export surface for local working-directory artifacts:
+
+```bash
+growthub kit list
+growthub kit inspect creative-strategist-v1
+growthub kit download creative-strategist-v1
+growthub kit path creative-strategist-v1
+```
+
+V1 is intentionally narrow:
+
+- bundled catalog plus local export only
+- one downloadable Creative Strategist kit
+- deterministic zip plus expanded export folder
+- public `solawave` example brand included
+- no heartbeat wiring, app install flow, server registry, plugin lifecycle, or database kit records
+
+The exported folder is a machine artifact produced by the CLI for existing Working Directory path support.
+
 ## What this is
 
 **growthub-core** is an opinionated, self-hosted developer experience platform that treats every unit of work as a **Ticket** — a sequential pipeline of stages (planning → execution → review → qa → human) — where each stage is owned by a specific AI agent. Designed for **parallel multi-ticket execution** with real-time agent status, live heartbeat tracking, and full pipeline control from a single command center dashboard.

package/assets/worker-kits/creative-strategist-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]
+```

package/assets/worker-kits/creative-strategist-v1/brands/solawave/brand-kit.md

@@ -0,0 +1,139 @@
+# Brand Kit — Solawave
+> Source of truth for all Solawave ad deliverables.
+
+---
+
+## IDENTITY
+
+```yaml
+client_name:       "Solawave"
+slug:              "solawave"
+industry:          "Beauty / Skincare Technology / At-Home Wellness Devices"
+primary_service:   "Red light therapy skincare wand for wrinkle reduction"
+campaign_name:     "Korean Skincare Truth — BOGO Campaign"
+date_onboarded:    "2026-04-09"
+account_owner:     "Antonio"
+```
+
+---
+
+## AUDIENCE
+
+```yaml
+target_age_range:      "25–45"
+target_gender:         "Female-skewing"
+target_pain_point:     "Fine lines, wrinkles, dark circles, dull skin — wants clinical-level results at home"
+target_intent:         "Actively looking for non-invasive, tech-backed skincare alternatives to serums/creams"
+geographic_target:     "United States — national"
+do_not_attract:        "Users seeking prescription skincare, dermatology procedures, or medical-grade interventions.
+                         Not for 55+ medical skincare seekers — brand is aspirational / beauty-tech, not clinical."
+```
+
+---
+
+## MESSAGING
+
+```yaml
+core_message:          "Solawave uses clinically-backed red light therapy + microcurrent to reduce wrinkles at home — no injections, no downtime."
+emotional_arc:         "Skepticism → Discovery → Proof → Action"
+tone:                  ["confident", "relatable", "science-meets-beauty", "aspirational", "no-BS"]
+approved_phrases:
+  - "red light therapy"
+  - "4-in-1 skincare wand"
+  - "microcurrent technology"
+  - "at-home anti-aging"
+  - "clinically-backed"
+  - "used by dermatologists"
+  - "fine lines and wrinkles"
+  - "glowing skin"
+  - "real results"
+  - "this is the real deal"
+messaging_guardrails:
+  - "Do NOT claim FDA-cleared or FDA-approved unless confirmed — use 'clinically-backed' instead"
+  - "No before/after photos with specific % improvement claims without clinical citations"
+  - "No 'eliminates' or 'erases' wrinkles — use 'reduces,' 'visibly reduces,' 'smooths'"
+  - "No injection or Botox comparisons that could be read as medical claims"
+  - "Do NOT say 'cures' any skin condition"
+  - "Results may vary — include if making specific outcome claims"
+cta_text:              "Shop Now — Buy 1 Get 1 FREE"
+cta_offer:             "Buy 1 Get 1 FREE"
+```
+
+---
+
+## BRAND DESIGN
+
+```yaml
+colors:
+  primary:       "7C1C2F"      # Deep wine / burgundy (from website)
+  secondary:     "B5435A"      # Rose pink
+  light_accent:  "F5E6E8"      # Blush / soft rose
+  dark:          "1B1B1B"
+  white:         "FFFFFF"
+  mid_gray:      "6B7280"
+
+fonts:
+  primary:       "Arial"
+  heading_size:  56
+  body_size:     20
+
+logo_file:       "assets/logo.png"
+logo_on_dark:    "assets/logo-white.png"
+```
+
+---
+
+## TALENT & PRODUCTION
+
+```yaml
+doctor_or_founder_name:  "N/A"
+founder_on_camera:       "No"
+ai_avatar_type:          "UGC Talking Head — Photoreal"
+ai_actor_age_range:      "22–32"
+ai_actor_notes:          "Female-presenting, natural/approachable look, warm skin tone — matches Korean beauty influencer energy.
+                           Bedroom or cozy desk setting. Casual outfit (oversized hoodie or neutral top).
+                           Holding mini microphone prop (silver condenser mic type) — core format signal.
+                           Must look like a real TikTok/Instagram creator, not a polished model."
+ugc_inspiration:         "@frankyshaw on Instagram/TikTok — see muse: instagram.com/reels/DU1lWOeDsdg/"
+vo_style:                "AI actor speaks on-camera — natural, direct, like texting your friend a tip. No announcer voice."
+broll_cadence:           "Cut every 2–3 seconds. Never >3s of talking head without a visual break."
+```
+
+---
+
+## ASSET LINKS
+
+```yaml
+brand_assets_air:    "TBD"
+broll_library:       "TBD"
+ugc_inspiration:     "https://www.instagram.com/reels/DU1lWOeDsdg/"
+google_drive:        "TBD"
+instagram:           "https://www.instagram.com/solawave/"
+tiktok:              "https://www.tiktok.com/@solawave"
+website:             "https://www.solawave.co/"
+landing_page:        "https://www.solawave.co/"
+phone_number:        "N/A — direct to website"
+previous_ads:        []
+```
+
+---
+
+## PLATFORM & FORMAT
+
+```yaml
+primary_platforms:   ["Instagram Reels", "TikTok", "Meta Feed"]
+aspect_ratios:       ["9:16", "1:1"]
+caption_default:     "ON"
+compliance_notes:    "Do not claim FDA-cleared without verification. 'Results may vary' required if making specific
+                       outcome claims. No clinical/medical treatment language. Product is a consumer beauty device."
+```
+
+---
+
+## DELIVERABLES LOG
+
+> Append a new line each time a deliverable is completed.
+
+```
+- 2026-04-09 | Video Creative Brief v1 — Korean Skincare Truth BOGO | ~/Downloads/Solawave_VideoBrief_KoreanSkincaretruth_v1_20260409.docx
+```

package/assets/worker-kits/creative-strategist-v1/bundles/creative-strategist-v1.json

@@ -0,0 +1,46 @@
+{
+  "schemaVersion": 1,
+  "bundle": {
+    "id": "creative-strategist-v1",
+    "version": "1.0.0",
+    "kitId": "creative-strategist-v1",
+    "workerId": "creative-strategist"
+  },
+  "briefType": "video-creative-brief",
+  "publicExampleBrandPaths": [
+    "brands/solawave/brand-kit.md"
+  ],
+  "requiredFrozenAssets": [
+    "skills.md",
+    "workers/creative-strategist/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/solawave/brand-kit.md",
+    "templates/brief-template.js",
+    "templates/hooks-library/500-winning-hooks.csv",
+    "templates/ad-formats/INDEX.md",
+    "templates/ad-formats/bedroom-minimic-talk.md",
+    "templates/ad-formats/frame-analysis.md",
+    "templates/ad-formats/process-specialist-medical.md",
+    "templates/ad-formats/villain-animation.md",
+    "templates/scene-modules/INDEX.md",
+    "templates/scene-modules/body/before-after-flatlay.md",
+    "templates/scene-modules/body/minimic-problem.md",
+    "templates/scene-modules/body/product-demo-glow.md",
+    "templates/scene-modules/body/tiktok-skeptic-pivot.md",
+    "templates/scene-modules/body/villain-agitation.md",
+    "templates/scene-modules/cta/bogo-meme-bookend.md",
+    "templates/scene-modules/cta/guarantee-close.md",
+    "templates/scene-modules/hooks/dollar-amount.md",
+    "templates/scene-modules/hooks/meme-overlay.md",
+    "templates/scene-modules/hooks/pov-confession.md",
+    "templates/scene-modules/hooks/tiktok-comment.md",
+    "templates/scene-modules/hooks/villain-hook.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "optionalPresets": [],
+  "export": {
+    "folderName": "growthub-agent-worker-kit-creative-strategist-v1",
+    "zipFileName": "growthub-agent-worker-kit-creative-strategist-v1.zip"
+  }
+}

package/assets/worker-kits/creative-strategist-v1/growthub-meta/README.md

@@ -0,0 +1,14 @@
+# Growthub Agent Worker Kit Metadata
+
+This folder defines the reusable metadata contract for exporting this worker kit through the Growthub CLI.
+
+The source materials in `claude-workers` stay intact. Growthub reads the frozen machine-readable files added alongside them, then exports only the approved public kit payload declared by `kit.json` and `bundles/creative-strategist-v1.json`.
+
+For V1:
+
+- the only kit is `creative-strategist-v1`
+- the only public example brand is `solawave`
+- confidential brand kits are intentionally excluded from the frozen public payload
+- the exported artifact is a local working-directory-ready bundle, not a server install
+
+See `kit-standard.md` for the locked contract.

package/assets/worker-kits/creative-strategist-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,47 @@
+# Growthub Agent Worker Kit Standard
+
+## Purpose
+
+Growthub Agent Worker Kits are frozen, machine-readable exports of a worker directory that can be materialized locally by the Growthub CLI.
+
+## Required Files
+
+Every kit must provide:
+
+- `kit.json` as the canonical manifest
+- `bundles/<bundle-id>.json` for each frozen downloadable bundle
+- a worker entrypoint path
+- an agent contract path
+- a brand template path
+- a declared list of frozen asset paths
+- an output standard that defines the required exported paths
+
+## `kit.json` Contract
+
+`kit.json` locks:
+
+- kit identity and version
+- entrypoint and worker ids
+- agent contract path
+- brand template path
+- frozen asset paths
+- output standard
+- bundle list
+
+## Bundle Contract
+
+Each bundle manifest locks:
+
+- bundle identity and version
+- worker identity
+- brief type
+- required frozen assets
+- optional presets array, even when empty
+- export folder and zip naming
+
+## Export Boundary
+
+- exported zips and expanded folders are generated locally at runtime
+- generated artifacts are not committed to the repo
+- kits are exported for existing Working Directory path support
+- bundle manifests must exclude confidential assets from the public payload

package/assets/worker-kits/creative-strategist-v1/kit.json

@@ -0,0 +1,72 @@
+{
+  "schemaVersion": 1,
+  "kit": {
+    "id": "creative-strategist-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — Creative Strategist",
+    "description": "Frozen Creative Strategist worker kit for exporting a working-directory-ready video creative brief worker.",
+    "visibility": "public-open-source",
+    "sourceRepo": "claude-workers"
+  },
+  "entrypoint": {
+    "workerId": "creative-strategist",
+    "path": "workers/creative-strategist/CLAUDE.md"
+  },
+  "workerIds": [
+    "creative-strategist"
+  ],
+  "agentContractPath": "workers/creative-strategist/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/solawave/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "skills.md",
+    "workers/creative-strategist/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/solawave/brand-kit.md",
+    "templates/brief-template.js",
+    "templates/hooks-library/500-winning-hooks.csv",
+    "templates/ad-formats/INDEX.md",
+    "templates/ad-formats/bedroom-minimic-talk.md",
+    "templates/ad-formats/frame-analysis.md",
+    "templates/ad-formats/process-specialist-medical.md",
+    "templates/ad-formats/villain-animation.md",
+    "templates/scene-modules/INDEX.md",
+    "templates/scene-modules/body/before-after-flatlay.md",
+    "templates/scene-modules/body/minimic-problem.md",
+    "templates/scene-modules/body/product-demo-glow.md",
+    "templates/scene-modules/body/tiktok-skeptic-pivot.md",
+    "templates/scene-modules/body/villain-agitation.md",
+    "templates/scene-modules/cta/bogo-meme-bookend.md",
+    "templates/scene-modules/cta/guarantee-close.md",
+    "templates/scene-modules/hooks/dollar-amount.md",
+    "templates/scene-modules/hooks/meme-overlay.md",
+    "templates/scene-modules/hooks/pov-confession.md",
+    "templates/scene-modules/hooks/tiktok-comment.md",
+    "templates/scene-modules/hooks/villain-hook.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is intended to be pointed at directly by existing Working Directory path support.",
+    "requiredPaths": [
+      "kit.json",
+      "bundles/creative-strategist-v1.json",
+      "skills.md",
+      "workers/creative-strategist/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/solawave/brand-kit.md",
+      "templates",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "creative-strategist-v1",
+      "version": "1.0.0",
+      "path": "bundles/creative-strategist-v1.json"
+    }
+  ]
+}