@growthub/cli 0.3.37 → 0.3.39

package/README.md

@@ -22,10 +22,14 @@ The CLI ships a bundled Worker Kit export surface for local adapter environments
 These kits are not server installs or database records. They are frozen, working-directory-ready
 artifacts that local adapters can run inside directly.
 
+They should be understood as packaged execution environments. A kit can carry prompts, templates, examples, output standards, and local runtime assumptions together as one reusable environment.
+
 ```bash
 growthub kit list
 growthub kit inspect creative-strategist-v1
+growthub kit inspect growthub-open-higgsfield-studio-v1
 growthub kit download creative-strategist-v1
+growthub kit download growthub-open-higgsfield-studio-v1
 growthub kit path creative-strategist-v1
 growthub kit validate /absolute/path/to/kit
 ```
@@ -33,9 +37,9 @@ growthub kit validate /absolute/path/to/kit
 V1 is intentionally narrow:
 
 - bundled catalog plus local export only
-- one downloadable Creative Strategist kit
+- downloadable worker kits for creative strategy, email strategy, and Open Higgsfield AI visual production
 - deterministic zip plus expanded export folder
-- public `solawave` example brand included
+- public example brand kits only
 - no heartbeat wiring, app install flow, server registry, plugin lifecycle, or database kit records
 
 ### How local adapters use worker kits
@@ -54,6 +58,26 @@ This is the current integration surface for worker kits in Growthub. In other wo
 becomes a specialized local execution environment that an agent can access and work within through
 its configured working directory.
 
+### Environment expansion model
+
+The packaging model supports more than a single strategy kit.
+
+The same packaging model can support:
+
+- strategy environments
+- email marketing environments
+- browser-heavy GTM environments
+- local production environments such as motion or Remotion-based workflows
+
+That means a new environment should usually be added as:
+
+1. a self-contained kit folder
+2. a manifest and bundle contract
+3. registered catalog metadata
+4. a real local adapter validation pass through `Working directory`
+
+not as a new one-off CLI code path.
+
 ## 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/growthub-email-marketing-v1/brands/_template/brand-kit.md

@@ -0,0 +1,172 @@
+# Brand Kit — [CLIENT NAME]
+
+> Copy this file to `brands/<client-slug>/brand-kit.md` and fill in all fields before writing any copy.
+> Fields marked [REQUIRED] must be filled before the agent can proceed. Fields marked [OPTIONAL] can be added later.
+
+---
+
+## IDENTITY
+
+```yaml
+client_name:         "[CLIENT NAME]"                   # [REQUIRED]
+slug:                "[client-slug]"                    # [REQUIRED] lowercase-hyphen, no spaces
+industry:            "[industry description]"           # [REQUIRED]
+primary_service:     "[core service or product]"        # [REQUIRED]
+campaign_owner:      "[name or team]"                  # [OPTIONAL]
+date_onboarded:      "YYYY-MM-DD"                      # [REQUIRED]
+account_owner:       "[agent or operator name]"        # [OPTIONAL]
+```
+
+---
+
+## AUDIENCE
+
+```yaml
+primary_persona:
+  name:              "[persona name or description]"    # [REQUIRED]
+  age_range:         "[e.g. 35–55]"                    # [OPTIONAL]
+  role:              "[e.g. agency owner, CGO, founder]" # [REQUIRED]
+  company_type:      "[e.g. local business, agency, B2B SaaS]" # [REQUIRED]
+  pain_point:        "[primary pain — specific, not generic]"   # [REQUIRED]
+  desired_outcome:   "[what they actually want — see brand doc]" # [REQUIRED]
+  current_stage:     "[what they've tried / where they are now]" # [OPTIONAL]
+  awareness_level:   "[unaware / problem-aware / solution-aware / product-aware]" # [REQUIRED]
+
+do_not_attract:      # [REQUIRED] — who this is NOT for
+  - "[anti-audience type 1]"
+  - "[anti-audience type 2]"
+```
+
+---
+
+## POSITIONING
+
+```yaml
+core_positioning:    "[one-sentence positioning statement]"  # [REQUIRED]
+what_they_buy:       "[what the ICP is actually buying — outcome/feeling, not feature]" # [REQUIRED]
+what_you_sell:       "[how you frame it to them]"           # [REQUIRED]
+category_frame:      "[what category do you put yourself in]" # [OPTIONAL]
+
+unique_mechanism:    "[what makes the outcome possible — the HOW]" # [OPTIONAL]
+
+proof_points:        # [OPTIONAL] — approved numbers and results only, never fabricate
+  - "[proof point 1 — e.g. X clients scaled to Y in Z timeframe]"
+  - "[proof point 2]"
+```
+
+---
+
+## MESSAGING
+
+```yaml
+voice_and_tone:      # [REQUIRED]
+  - "[tone adjective 1 — e.g. direct]"
+  - "[tone adjective 2 — e.g. operator-level]"
+  - "[tone adjective 3 — e.g. no-fluff]"
+
+voice_notes:         "[how to write for this brand — e.g. 'speak like a knowledgeable operator, not a marketer']" # [REQUIRED]
+
+approved_phrases:    # [REQUIRED] — verbatim, use in copy
+  - "[phrase 1]"
+  - "[phrase 2]"
+  - "[phrase 3]"
+
+messaging_guardrails: # [REQUIRED] — absolute no-go items
+  - "[do not say or claim: X]"
+  - "[do not say or claim: Y]"
+
+emotional_arc:       "[default emotional arc — e.g. Overwhelmed → Systematized → Scaling]" # [REQUIRED]
+```
+
+---
+
+## CONTENT PILLARS
+
+```yaml
+content_pillars:     # [REQUIRED] — define which pillars are active for this client
+  pillar_1:
+    name:            "[pillar name]"
+    angle:           "[default campaign angle for this pillar]"
+    tone:            "[tone variation for this pillar]"
+  pillar_2:
+    name:            "[pillar name]"
+    angle:           "[default campaign angle]"
+    tone:            "[tone variation]"
+  pillar_3:          # add as needed
+    name:            "[pillar name]"
+    angle:           "[default campaign angle]"
+    tone:            "[tone variation]"
+```
+
+---
+
+## CTA & OFFERS
+
+```yaml
+primary_cta_text:    "[exact CTA text — e.g. 'Book your growth call']"  # [REQUIRED]
+primary_cta_url:     "[URL or placeholder]"                              # [REQUIRED]
+secondary_cta_text:  "[soft CTA text — e.g. 'Reply and tell me more']" # [OPTIONAL]
+offer_notes:         "[any active offers, pricing, trial details]"       # [OPTIONAL]
+```
+
+---
+
+## EMAIL PLATFORM
+
+```yaml
+platform:            "[platform name — e.g. GHL, ActiveCampaign, Klaviyo, HubSpot]" # [REQUIRED if platform handoff in scope]
+platform_api_key_env: "[env var name — e.g. GHL_API_KEY]"               # [REQUIRED for API mode]
+platform_location_id_env: "[env var name — e.g. GHL_LOCATION_ID]"       # [OPTIONAL — platform-specific]
+platform_api_base:   "[base URL — e.g. https://rest.gohighlevel.com/v1]" # [REQUIRED for API mode]
+email_from_name:     "[sender name as it appears in inbox]"              # [REQUIRED]
+email_from_address:  "[sender email — configured in platform]"           # [REQUIRED]
+
+list_segments:       # [REQUIRED] — segment names or tags used in this platform account
+  - "[segment name or tag 1]"
+  - "[segment name or tag 2]"
+
+sending_cadence:
+  nurture:           "[e.g. every 3–5 days]"                            # [OPTIONAL]
+  cold:              "[e.g. every 2–3 days]"                            # [OPTIONAL]
+  follow_up:         "[e.g. every 1–2 days]"                            # [OPTIONAL]
+  re_engagement:     "[e.g. every 5–7 days]"                            # [OPTIONAL]
+
+send_time_preference: "[e.g. Tue–Thu, 9–11am recipient local time]"     # [OPTIONAL]
+```
+
+---
+
+## COMPLIANCE
+
+```yaml
+compliance_notes:    # [REQUIRED]
+  - "[required disclaimer or legal restriction 1]"
+  - "[required disclaimer or legal restriction 2]"
+  - "CAN-SPAM: physical address and unsubscribe link required on all broadcasts"
+  - "[GDPR notes if applicable]"
+
+unsubscribe_footer:  "[unsubscribe link text and footer format]"         # [REQUIRED]
+physical_address:    "[legal physical mailing address for CAN-SPAM]"    # [REQUIRED]
+```
+
+---
+
+## ASSET LINKS
+
+```yaml
+website:             "[URL]"                # [OPTIONAL]
+landing_page:        "[URL]"                # [OPTIONAL]
+google_drive:        "[URL]"                # [OPTIONAL]
+brand_assets:        "[URL]"                # [OPTIONAL]
+previous_campaigns:  "[URL or path]"        # [OPTIONAL]
+```
+
+---
+
+## DELIVERABLES LOG
+
+> Append one line per completed output. Never delete entries.
+
+```
+# Format: YYYY-MM-DD | <CampaignType> v<N> — <CampaignName> | output/<slug>/<folder>/
+```

package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/VERSION.md

@@ -0,0 +1,32 @@
+# Growthub Brand Kit — Local Version History
+
+> This file tracks the Growthub brand configuration independently of the kit schema version.
+> Kit version (in kit.json) = schema and structure.
+> Local version (here) = Growthub brand data, vault content, assets, and copy system.
+>
+> Bump local_version in brand-kit.md when you: add proof points, update CTAs, add lead magnets,
+> add case studies, change positioning, update compliance notes, or add vault assets.
+> Do NOT bump until changes are tested and confirmed working.
+
+---
+
+## Current version: 1.0.0
+
+---
+
+## CHANGELOG
+
+### v1.0.0 — 2026-04-10
+**Initial release.**
+- Brand kit created from Creative OS positioning document ("What Our Customers Really Want")
+- 5 content pillars defined with campaign angles and language patterns
+- Voice, tone, approved phrases, and guardrails populated
+- GHL platform configuration added
+- CTA hierarchy defined
+- Broadcast vault created with full asset library:
+  - 10 lead magnets
+  - 6 proof assets (AIR galleries, YouTube videos)
+  - 7 case studies
+  - 3 YouTube content videos (Antonio)
+  - 1 customer video testimonial
+  - SKOOL community link

package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/brand-kit.md

@@ -0,0 +1,282 @@
+# Brand Kit — Growthub
+
+> Canonical reference brand kit. Pre-filled with Growthub's positioning, voice, pillars, and messaging system.
+> Source: Growthub Creative OS brand document — "What Our Customers Really Want" (2026)
+
+---
+
+## IDENTITY
+
+```yaml
+client_name:         "Growthub"
+slug:                "growthub"
+industry:            "B2B SaaS / Growth Infrastructure / Creative Production"
+primary_service:     "Creative velocity and growth systems for brands and agencies running paid media"
+campaign_owner:      "Growthub team"
+date_onboarded:      "2026-04-10"
+account_owner:       "Antonio"
+```
+
+---
+
+## AUDIENCE
+
+```yaml
+primary_persona:
+  name:              "The Performance-Minded Operator"
+  role:              "CGO, performance director, agency owner, or founder running paid media at scale"
+  company_type:      "DTC brand, performance agency, or funded startup with active paid media spend"
+  pain_point:        "They can scale budget but not creative output — the bottleneck is finding winning concepts fast enough to justify spend increases"
+  desired_outcome:   "More winning ads, faster, without increasing production cost or headcount"
+  current_stage:     "Spending $10K–$500K/month on ads, have tried in-house creative, freelancers, or basic UGC — still hitting the same creative ceiling"
+  awareness_level:   "problem-aware — they know the creative bottleneck is the constraint, unsure whether Growthub is the right solution"
+
+secondary_persona:
+  name:              "The Agency Operator"
+  role:              "Agency owner or creative lead managing 5–20+ clients on Meta/TikTok"
+  pain_point:        "Creative output doesn't scale with client count — team is burning out producing volume without improving win rate"
+  desired_outcome:   "More output without burning the team — increase creative throughput without adding headcount"
+  awareness_level:   "solution-aware — shopping for a production partner or system"
+
+do_not_attract:
+  - "Bootstrapped founders who can't afford performance creative investment"
+  - "Enterprise buyers expecting full-service agency account management"
+  - "Clients who want cheap, non-strategic volume production"
+  - "Businesses with no active paid media spend"
+```
+
+---
+
+## POSITIONING
+
+```yaml
+core_positioning:    "Growthub is the creative velocity engine — we help brands and agencies increase the speed and volume of winning ad concepts so they can scale spend without increasing production cost or headcount."
+
+what_they_buy:       "Momentum — the feeling that growth is finally easy and fast. Specifically: the ability to scale spend because the creative bottleneck is solved."
+
+what_you_sell:       "Speed to winning ads without risk. Not creatives, not AI, not volume — the outcome of finding winners faster than your competition."
+
+category_frame:      "Creative infrastructure — not a production agency, not a tool, not an AI platform. The operating layer that makes creative testing fast and affordable."
+
+unique_mechanism:    "The Creative OS — a system that combines AI UGC production, a structured intelligence layer (insight extraction + hook research), and iterative testing at a rate that lowers cost-per-learning while increasing win rate."
+
+proof_points:
+  - "Clients have gone from 100K to 500K in monthly ad spend after removing the creative bottleneck"
+  - "Reduce cost per learning by testing 5–10x more concepts per month without increasing production cost"
+  - "Weekly winning concepts instead of slow monthly production cycles"
+  # NOTE: Use only with approved attribution. Never fabricate or exaggerate.
+```
+
+---
+
+## MESSAGING
+
+```yaml
+voice_and_tone:
+  - "direct"
+  - "operator-level"
+  - "no-fluff"
+  - "practical"
+  - "confident"
+  - "growth-literate"
+
+voice_notes: >
+  Speak like a knowledgeable operator, not a marketer. The reader has heard every marketing claim.
+  They respond to specificity, honesty, and proof. Never use hype language. Never make vague promises.
+  Write like you're explaining something to a smart peer who has been burned by similar solutions before.
+  The tone is direct but not aggressive. Confident but not arrogant. Practical but not dry.
+  Short sentences. Concrete language. One idea per paragraph. White space is intentional.
+
+approved_phrases:
+  - "creative velocity"
+  - "speed to winning ads"
+  - "creative bottleneck"
+  - "scale spend without increasing production cost"
+  - "more winning concepts per month"
+  - "test faster than your competitors can react"
+  - "lower your cost per learning"
+  - "growth infrastructure"
+  - "the operating layer for growth"
+  - "weekly winning concepts"
+  - "momentum — growth that feels easy and fast"
+  - "remove the bottleneck between ideas and execution"
+  - "scale without chaos"
+  - "turn creative into a growth lever, not a cost center"
+
+messaging_guardrails:
+  - "Never use: 'revolutionary', 'game-changing', 'best-in-class', 'world-class' — hype kills credibility"
+  - "Never use vague outcome language: 'grow your business', 'scale to the moon', '10x your revenue'"
+  - "Never promise specific revenue outcomes without approved case study attribution"
+  - "Never use 'guaranteed' without a specific legal qualifier"
+  - "Never position Growthub as just an AI tool or just a production agency — it is a system"
+  - "Never lead with features (AI UGC, workflows) — lead with the outcome the ICP wants"
+  - "Never use passive voice in CTAs"
+
+emotional_arc:     "Frustrated (bottlenecked) → Informed (the problem is solvable) → Activated (they have a path)"
+```
+
+---
+
+## CONTENT PILLARS
+
+```yaml
+content_pillars:
+
+  pillar_1:
+    name:    "Growth System"
+    summary: "Growthub is the operating system for growth — not a tool, not an agency. Infrastructure that makes scaling systematic."
+    angle:   "Most businesses don't have a growth problem. They have a systems problem."
+    emotional_arc: "Chaotic → Systematic → In Control"
+    tone:    "Diagnostic, confident, operator-to-operator"
+    use_for: "Nurture sequences, educational content, positioning campaigns"
+    language_patterns:
+      - "growth infrastructure"
+      - "systematic scaling"
+      - "most agencies run on duct tape — this is the alternative"
+      - "built-in accountability"
+      - "growth that compounds"
+      - "without the chaos"
+
+  pillar_2:
+    name:    "Automation & AI"
+    summary: "Speed from insight to action. The businesses winning right now are moving faster. Automation removes the bottleneck between thinking and doing."
+    angle:   "The bottleneck isn't your team. It's the time between ideas and execution."
+    emotional_arc: "Overwhelmed → Informed → Empowered"
+    tone:    "Practical, specific, outcome-forward — not AI-hype-driven"
+    use_for: "Nurture sequences, promotional campaigns, outbound sequences"
+    language_patterns:
+      - "speed to winning results"
+      - "automated follow-up that works while you sleep"
+      - "ideas → execution → learning"
+      - "test faster than competitors can react"
+      - "remove the bottleneck"
+      - "without adding headcount"
+
+  pillar_3:
+    name:    "Client Results"
+    summary: "Proof over promises. The most compelling content shows what happened for someone like you. Results, specifics, stories — not features."
+    angle:   "Here's exactly what happened — and the same system is available to you."
+    emotional_arc: "Skeptical → Curious → Convinced"
+    tone:    "Story-forward, peer-to-peer, specific — not testimonial-polished"
+    use_for: "Re-engagement campaigns, follow-up sequences, warm nurture"
+    language_patterns:
+      - "here's what actually happened"
+      - "not theory — this is a real result"
+      - "the same system is available to you"
+      - "before Growthub: [pain]. After: [outcome]."
+
+  pillar_4:
+    name:    "Education & Strategy"
+    summary: "We earn attention by making people smarter. Teach first, position second. The most trusted brands give before they ask."
+    angle:   "Most people miss this step — here's the framework we use."
+    emotional_arc: "Curious → Informed → Action-ready"
+    tone:    "Generous, credible, direct — no condescension"
+    use_for: "Cold outbound, top-of-funnel nurture, content upgrade campaigns"
+    language_patterns:
+      - "here's what we've found"
+      - "this is the framework we use"
+      - "most people miss this step"
+      - "the unlock is simpler than you think"
+      - "you can steal this"
+
+  pillar_5:
+    name:    "Pipeline & Revenue"
+    summary: "Email is a pipeline tool, not a broadcast tool. Every sequence should move someone from one stage to the next. The metric is pipeline movement."
+    angle:   "There is more revenue in your existing list than in any new lead you'll generate this month."
+    emotional_arc: "Stalled → Re-engaged → Moving"
+    tone:    "Direct, urgent-but-not-pushy, revenue-literate"
+    use_for: "Re-engagement campaigns, post-demo follow-up, pipeline-moving GTM sequences"
+    language_patterns:
+      - "stalled pipeline"
+      - "move deals forward"
+      - "already in your list"
+      - "the money is in the follow-up"
+      - "re-engage without burning bridges"
+      - "one email away from a yes"
+```
+
+---
+
+## CTA & OFFERS
+
+```yaml
+primary_cta_text:    "Book your growth call"
+primary_cta_url:     "[URL — fill in per campaign]"
+secondary_cta_text:  "Reply and tell me where you're stuck"
+offer_notes:         "[fill in per campaign — free audit, demo, trial, case study]"
+
+cta_hierarchy:
+  warm_audience:     "Book your growth call → See how it works → Reply with [X]"
+  cold_audience:     "Reply with [X] → Download [resource] → Book your call"
+  re_engagement:     "Let's pick this back up → One quick question → Still relevant?"
+```
+
+---
+
+## EMAIL PLATFORM
+
+```yaml
+platform:            "GHL"
+platform_api_key_env:         "GHL_API_KEY"
+platform_location_id_env:     "GHL_LOCATION_ID"
+platform_api_base:   "https://rest.gohighlevel.com/v1"
+email_from_name:     "[Sender first name] at Growthub"
+email_from_address:  "[configured in GHL account — fill in per deployment]"
+
+list_segments:
+  - "new-lead"
+  - "warm-prospect"
+  - "past-client"
+  - "re-engage"
+  - "pipeline-active"
+  - "post-demo"
+  - "cold-outbound"
+
+sending_cadence:
+  nurture:           "every 3–5 days"
+  cold:              "every 2–3 days"
+  follow_up:         "every 1–2 days"
+  re_engagement:     "every 5–7 days"
+  promotional:       "send day + 1 day reminder"
+
+send_time_preference: "Tuesday–Thursday, 9–11am recipient local time"
+```
+
+---
+
+## COMPLIANCE
+
+```yaml
+compliance_notes:
+  - "CAN-SPAM: physical mailing address required in every broadcast footer"
+  - "CAN-SPAM: unsubscribe link required in every broadcast — one-click"
+  - "Do not make specific revenue guarantees without approved attribution"
+  - "GDPR: only email contacts who have opted in or have a legitimate interest basis"
+  - "Do not use 'guaranteed results' — use 'proven system' or 'based on [X] client results'"
+
+unsubscribe_footer:  "You're receiving this because you opted in at [source]. Unsubscribe: [link] | Growthub, [physical address]"
+physical_address:    "[fill in — legal physical mailing address]"
+```
+
+---
+
+## ASSET LINKS
+
+```yaml
+website:             "[growthub website URL]"
+landing_page:        "[fill in per campaign]"
+brand_assets:        "[Google Drive or AIR link]"
+case_studies:        "[link to approved case studies]"
+previous_campaigns:  "[output/growthub/ folder]"
+```
+
+---
+
+## DELIVERABLES LOG
+
+> Append one line per completed output. Never delete entries.
+
+```
+# Format: YYYY-MM-DD | <CampaignType> v<N> — <CampaignName> | output/<slug>/<folder>/
+2026-04-10 | Broadcast showcase-proof v1 — AI UGC Creative Showcase (sh-01, warm-prospect) | output/growthub/showcase-proof-ai-ugc-v1-20260410/
+```