@growthub/cli 0.14.5 → 0.14.6

package/assets/worker-kits/growthub-zernio-social-v1/brands/NEW-CLIENT.md

@@ -1,74 +0,0 @@
-# Adding a New Client
-
-This guide explains how to create a brand kit for a new client in the Zernio Social Media Studio.
-
----
-
-## Steps
-
-### 1. Copy the Template
-
-```bash
-cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
-```
-
-Replace `<client-slug>` with a lowercase, hyphenated version of the client name. Examples:
-- "Urban Cycle" → `urban-cycle`
-- "Acme SaaS Corp" → `acme-saas`
-- "The Bloom Studio" → `bloom-studio`
-
-### 2. Fill in the Brand Kit
-
-Open the new file and fill in every section:
-
-- **Client Identity** — name, slug, industry, website
-- **Zernio Account Context** — profile id, timezone, API key scope
-- **Social Media Presence** — existing accounts with Zernio platform ids and account ids
-- **Target Audience** — primary and secondary audience profiles
-- **Campaign Objectives** — metrics, targets, and timelines
-- **Brand Voice** — tone, personality, approved/blocked words, emoji usage
-- **Content Theme Pillars** — 3–5 recurring themes with platform assignments
-- **Competitor Reference Accounts** — 2–3 accounts to reference for format benchmarking
-- **Benchmark Reference** (optional) — baseline engagement rates per platform
-- **Agency Context** — engagement stage, retainer, reporting cadence
-
-### 3. Verify the Brand Kit
-
-Before using the brand kit in a session, confirm:
-
-- [ ] `client-slug` in the filename matches the `Client Slug` field in the kit
-- [ ] At least one platform is listed in `Social Media Presence` with a Zernio platform id from `docs/platform-coverage.md`
-- [ ] At least one campaign objective has a measurable target
-- [ ] Brand voice section is complete — no empty `[fill in]` placeholders
-- [ ] At least 3 content theme pillars are defined
-- [ ] `Zernio profile id` either references a real `prof_...` or is tagged `placeholder` (agent-only mode)
-
-### 4. Tell the Operator
-
-Start your Claude Code session and say:
-
-> "Load the brand kit for [client-name] and begin a [campaign objective] campaign."
-
-The operator will read the brand kit and ask the 4-question gate before producing any output.
-
----
-
-## Brand Kit Naming Rules
-
-| Rule | Correct | Incorrect |
-|---|---|---|
-| Directory name is lowercase kebab-case | `brands/urban-cycle/` | `brands/UrbanCycle/` |
-| Filename is always `brand-kit.md` | `brands/urban-cycle/brand-kit.md` | `brands/urban-cycle/UrbanCycle.md` |
-| Slug contains no spaces | `acme-saas` | `acme saas` |
-| Slug contains no special chars | `bloom-studio` | `bloom/studio` |
-
----
-
-## Note on Public Brand Kits
-
-Brand kits are **not included in kit exports by default**. The only brand kits included in exports are:
-
-- `brands/_template/brand-kit.md` — the blank template
-- `brands/growthub/brand-kit.md` — the public reference example
-
-Client brand kits you create live in your local kit installation only. They are not bundled into the export zip or submitted to any external service.

package/assets/worker-kits/growthub-zernio-social-v1/brands/_template/brand-kit.md

@@ -1,131 +0,0 @@
-# Brand Kit — [Client Name]
-
-<!-- Replace [Client Name] with the actual client name and rename this file to brands/<client-slug>/brand-kit.md -->
-
----
-
-## Client Identity
-
-| Field | Value |
-|---|---|
-| Client Name | [Client Name] |
-| Client Slug | [client-slug] |
-| Industry | [e.g., SaaS / E-commerce / Hospitality / Fintech] |
-| Website | [https://...] |
-| Primary Contact | [Name, email] |
-
----
-
-## Zernio Account Context
-
-| Field | Value |
-|---|---|
-| Zernio profile id | [prof_...] or `placeholder` in agent-only mode |
-| Default posting timezone | [IANA tz, e.g., America/New_York] |
-| API key scope | [read | read-write] |
-| Profile-specific key? | [yes | no] |
-
----
-
-## Social Media Presence
-
-| Platform | Zernio platform id | Account id / handle | Followers | Current Status |
-|---|---|---|---|---|
-| Instagram | `instagram` | [acc_ig_... or @handle] | [N] | [Active / Inactive / New] |
-| LinkedIn | `linkedin` | [page id] | [N] | [Active / Inactive] |
-| TikTok | `tiktok` | [acc_tt_...] | [N] | [Active / Inactive] |
-| X/Twitter | `twitter` | [acc_x_...] | [N] | [Active / Inactive] |
-| [Other] | [id] | [handle] | [N] | [Active / Inactive] |
-
----
-
-## Target Audience
-
-### Primary Audience
-
-| Attribute | Description |
-|---|---|
-| Age Range | [e.g., 25–40] |
-| Gender | [e.g., 55% female, 45% male] |
-| Location | [e.g., North America, English-speaking markets] |
-| Interests | [e.g., entrepreneurship, productivity, design] |
-| Pain Points | [e.g., too many disconnected tools, manual social media posting] |
-| Content Preferences | [e.g., educational how-tos, success stories, data-driven insights] |
-
-### Secondary Audience
-
-| Attribute | Description |
-|---|---|
-| Age Range | [e.g., 18–25] |
-| Interests | [e.g., tech, side projects] |
-| Platform | [e.g., TikTok, Reddit] |
-
----
-
-## Campaign Objectives
-
-| Objective | Metric | Target | Timeline |
-|---|---|---|---|
-| [Brand awareness] | [Impressions] | [50,000/month] | [Q2 2026] |
-| [Lead generation] | [Link clicks] | [200/month] | [Q2 2026] |
-| [Community growth] | [Follower growth] | [+500] | [Q2 2026] |
-
----
-
-## Brand Voice
-
-| Attribute | Spec |
-|---|---|
-| Tone | [e.g., Professional but approachable. Data-driven without being dry. Never salesy.] |
-| Personality | [e.g., Smart, helpful, occasionally witty] |
-| Words to Use | [e.g., "build", "grow", "automate", "team", "results"] |
-| Words to Avoid | [e.g., "hack", "guru", "crush it", "cheap", "amazing"] |
-| Emoji Usage | [e.g., Minimal on LinkedIn; moderate on Instagram; more on TikTok] |
-| CTA Style | [e.g., Direct action verbs: "Start today", "Learn more", "Join the team"] |
-
----
-
-## Content Theme Pillars
-
-| Pillar | Description | Platforms | % of Calendar |
-|---|---|---|---|
-| [Industry Insights] | [What we know that others don't — data, trends, analysis] | [All] | [40%] |
-| [Product Value] | [Feature spotlights, use cases, ROI stories] | [LinkedIn, Instagram] | [30%] |
-| [Social Proof] | [Customer testimonials, case studies, results] | [All] | [20%] |
-| [Community] | [Q&A, behind the scenes, team moments] | [Instagram, TikTok] | [10%] |
-
----
-
-## Competitor Reference Accounts
-
-| Platform | Account | Why Reference |
-|---|---|---|
-| [Instagram] | [@competitor] | [Strong visual brand, good engagement format] |
-| [LinkedIn] | [competitor company page] | [Industry leader, consistent posting cadence] |
-
----
-
-## Agency Context
-
-| Field | Value |
-|---|---|
-| Engagement Stage | [Prospect / Onboarding / Retained] |
-| Monthly Retainer | [e.g., $X,XXX/month or "not established"] |
-| Campaign Budget | [e.g., $X,XXX / campaign or "TBD"] |
-| Reporting Cadence | [e.g., Monthly analytics brief] |
-
----
-
-## CRM Notes
-
-<!-- Internal notes for agency context. Not included in client-facing outputs. -->
-
-[Add internal notes here: key contacts, relationship history, upsell opportunities, account health signals]
-
----
-
-## DELIVERABLES LOG
-
-<!-- Append a line for each completed deliverable. -->
-
-<!-- - YYYY-MM-DD | Social Media Campaign Package v1 — [Project Name] | output/<client-slug>/<project-slug>/ -->

package/assets/worker-kits/growthub-zernio-social-v1/brands/growthub/brand-kit.md

@@ -1,141 +0,0 @@
-# Brand Kit — Growthub
-
-<!-- Reference example for the Zernio Social Media Studio. Use this to understand the expected format and detail level. -->
-
----
-
-## Client Identity
-
-| Field | Value |
-|---|---|
-| Client Name | Growthub |
-| Client Slug | `growthub` |
-| Industry | Developer tools / AI agent infrastructure / SaaS |
-| Website | https://growthub.ai |
-| Primary Contact | Internal — Growthub marketing team |
-
----
-
-## Zernio Account Context
-
-| Field | Value |
-|---|---|
-| Zernio profile id | prof_GRO_primary |
-| Default posting timezone | America/New_York |
-| API key scope | read-write |
-| Profile-specific key? | yes — scoped to `prof_GRO_primary` only |
-
----
-
-## Social Media Presence
-
-| Platform | Zernio platform id | Account id / handle | Followers | Current Status |
-|---|---|---|---|---|
-| X/Twitter | `twitter` | acc_x_growthubai (@growthubai) | 3,200 | Active |
-| LinkedIn | `linkedin` | acc_li_GrowthubPage | 1,800 | Active |
-| Bluesky | `bluesky` | acc_bsky_growthub (@growthub.ai) | 400 | Growing |
-| YouTube | `youtube` | acc_yt_GrowthubAI | 1,100 | Active |
-
-GitHub (github.com/Growthub-ai — 2,100 stars) is tracked separately; not published through Zernio.
-
----
-
-## Target Audience
-
-### Primary Audience
-
-| Attribute | Description |
-|---|---|
-| Age Range | 25–45 |
-| Gender | 60% male, 40% female |
-| Location | North America, Europe, English-speaking global |
-| Interests | AI agents, developer tools, automation, indie hacking, SaaS growth |
-| Pain Points | Complex agent orchestration, lack of open-source local-first alternatives, AI tool fatigue |
-| Content Preferences | Technical tutorials, tool comparisons, workflow examples, behind-the-scenes product builds |
-
-### Secondary Audience
-
-| Attribute | Description |
-|---|---|
-| Age Range | 18–25 |
-| Interests | Open source, hackathons, learning AI development |
-| Platform | GitHub, X/Twitter, Bluesky |
-
----
-
-## Campaign Objectives
-
-| Objective | Metric | Target | Timeline |
-|---|---|---|---|
-| Developer awareness | GitHub stars | +500/quarter | Q2 2026 |
-| Community growth | X followers | +200/month | Ongoing |
-| Thought leadership | LinkedIn impressions | 20,000/month | Q2 2026 |
-| Open-source adoption | CLI downloads | +1,000/month | Q2 2026 |
-
----
-
-## Brand Voice
-
-| Attribute | Spec |
-|---|---|
-| Tone | Direct, technically credible, approachable. We explain without condescending. We ship without bragging. |
-| Personality | Builder-first. We're in the trenches using the tools we build. |
-| Words to Use | "build", "ship", "run", "local", "open", "agent", "workflow", "kit", "workspace" |
-| Words to Avoid | "disruptive", "AI-powered" (use "agent-native" instead), "revolutionary", "hack" |
-| Emoji Usage | Minimal — 0–1 on LinkedIn; 0–2 on X; 0 on Bluesky |
-| CTA Style | Action verbs with immediate value: "Try it now", "Clone and run", "Read the docs", "Star on GitHub" |
-
----
-
-## Content Theme Pillars
-
-| Pillar | Description | Platforms | % of Calendar |
-|---|---|---|---|
-| Product Builds | Behind-the-scenes of building Growthub features — architecture, decisions, tradeoffs | X, LinkedIn, YouTube | 35% |
-| Developer Tutorials | How to use Growthub kits, commands, and workflows in real workflows | X, Bluesky, YouTube | 30% |
-| Open Source | Open-source culture, contributions, partner project spotlights | X, Bluesky | 20% |
-| Community | User projects, shoutouts, Q&A, polls | X, LinkedIn | 15% |
-
----
-
-## Competitor Reference Accounts
-
-| Platform | Account | Why Reference |
-|---|---|---|
-| X/Twitter | @langchain | Strong developer community engagement, technical thread format |
-| LinkedIn | Anthropic company page | Consistent educational posting, thought leadership |
-| X/Twitter | @cursor_ai | Product-led content strategy, community responsiveness |
-
----
-
-## Benchmark Reference
-
-| Platform | Median developer-tool engagement rate | Notes |
-|---|---|---|
-| `twitter` | 3.2% | Across peer dev-tool accounts, rolling 90-day |
-| `linkedin` | 4.0% | Peer enterprise tool pages |
-| `bluesky` | 5.5% | Narrower tech-fluent audience skews rate up |
-| `youtube` | 6.0% (likes+comments/views) | Short-form skew |
-
----
-
-## Agency Context
-
-| Field | Value |
-|---|---|
-| Engagement Stage | Internal — first-party reference kit |
-| Monthly Retainer | N/A (internal) |
-| Campaign Budget | N/A |
-| Reporting Cadence | Monthly analytics brief to marketing team |
-
----
-
-## CRM Notes
-
-Internal reference account. Used to demonstrate the kit's brand kit format and example output quality. Not a live client account.
-
----
-
-## DELIVERABLES LOG
-
-<!-- - YYYY-MM-DD | Social Media Campaign Package v1 — Growthub Q2 2026 Launch | output/growthub/q2-2026-launch/ -->

package/assets/worker-kits/growthub-zernio-social-v1/bundles/growthub-zernio-social-v1.json

@@ -1,91 +0,0 @@
-{
-  "schemaVersion": 2,
-  "bundle": {
-    "id": "growthub-zernio-social-v1",
-    "version": "1.0.0",
-    "kitId": "growthub-zernio-social-v1",
-    "workerId": "zernio-social-operator"
-  },
-  "briefType": "zernio-social-media-campaign",
-  "publicExampleBrandPaths": [
-    "brands/growthub/brand-kit.md"
-  ],
-  "requiredFrozenAssets": [
-    "QUICKSTART.md",
-    ".env.example",
-    "skills.md",
-    "output-standards.md",
-    "runtime-assumptions.md",
-    "validation-checklist.md",
-    "workers/zernio-social-operator/CLAUDE.md",
-    "brands/_template/brand-kit.md",
-    "brands/growthub/brand-kit.md",
-    "brands/NEW-CLIENT.md",
-    "setup/setup.mjs",
-    "setup/verify-env.mjs",
-    "setup/check-deps.sh",
-    "setup/check-deps.mjs",
-    "setup/install-mcp.mjs",
-    "output/README.md",
-    "templates/social-campaign-brief.md",
-    "templates/content-calendar.md",
-    "templates/platform-publishing-plan.md",
-    "templates/caption-copy-deck.md",
-    "templates/analytics-brief.md",
-    "templates/scheduling-manifest.md",
-    "templates/client-proposal.md",
-    "examples/social-campaign-sample.md",
-    "examples/content-calendar-sample.md",
-    "examples/analytics-brief-sample.md",
-    "examples/client-proposal-sample.md",
-    "docs/zernio-api-integration.md",
-    "docs/platform-coverage.md",
-    "docs/ai-caption-layer.md",
-    "docs/posts-and-queues-layer.md",
-    "docs/growthub-agentic-social-platform-ui-shell.md",
-    "docs/local-adapters.md",
-    "studio/.env.example",
-    "studio/serve.mjs",
-    "studio/index.html",
-    "studio/package.json",
-    "studio/package-lock.json",
-    "studio/vite.config.js",
-    "studio/dist/index.html",
-    "studio/dist/assets/index-DTmBMuXr.js",
-    "studio/dist/assets/index-gHr-nTMF.css",
-    "studio/src/App.jsx",
-    "studio/src/api.js",
-    "studio/src/app.css",
-    "studio/src/lib/rules.js",
-    "studio/src/lib/templates.js",
-    "studio/src/main.jsx",
-    "studio/src/views/Accounts.jsx",
-    "studio/src/views/Agent.jsx",
-    "studio/src/views/Analytics.jsx",
-    "studio/src/views/ApiKeys.jsx",
-    "studio/src/views/Automations.jsx",
-    "studio/src/views/CommentRules.jsx",
-    "studio/src/views/Compose.jsx",
-    "studio/src/views/Dashboard.jsx",
-    "studio/src/views/Inbox.jsx",
-    "studio/src/views/Queues.jsx",
-    "studio/src/views/Scheduled.jsx",
-    "studio/src/views/Sequences.jsx",
-    "studio/src/views/Templates.jsx",
-    "growthub-meta/README.md",
-    "growthub-meta/kit-standard.md",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.md"
-  ],
-  "optionalPresets": [],
-  "export": {
-    "folderName": "growthub-agent-worker-kit-zernio-social-v1",
-    "zipFileName": "growthub-agent-worker-kit-zernio-social-v1.zip"
-  },
-  "activationModes": [
-    "export"
-  ]
-}

package/assets/worker-kits/growthub-zernio-social-v1/docs/ai-caption-layer.md

@@ -1,132 +0,0 @@
-# AI Caption Layer
-
-The AI caption layer is the operator's methodology for drafting platform-adapted captions at volume while preserving brand voice.
-
-The kit produces **A/B/C variants** for every post. Each variant is meaningfully different. This document defines what "meaningfully different" means and how to get there.
-
----
-
-## Caption Source
-
-- Primary source: Claude (the agent running the operator). Uses the local `ANTHROPIC_API_KEY` only when explicitly configured for enhanced drafting.
-- Secondary source: Zernio's own caption service (not used by this kit).
-
-The kit produces captions deterministically from the agent. The Zernio account's AI configuration is never invoked as part of scheduled manifest creation.
-
----
-
-## Variant Contract
-
-Every post in the Caption Copy Deck has exactly three variants:
-
-| Variant | Hook style | When to pick it |
-|---|---|---|
-| A — Direct | Declarative fact or benefit in the first line | Product announcements, educational content, lead gen |
-| B — Narrative | Story beat, anecdote, or "I / we used to..." opening | Brand building, founder voice, community posts |
-| C — Question | Question or provocation as the opener | Engagement-driven posts, polls, community prompts |
-
-Variants must differ in:
-
-- Opening hook
-- Structural rhythm (list vs. paragraph vs. question-answer)
-- Called-out angle (data, emotion, curiosity)
-
-Minor word swaps (e.g., "great" → "excellent") do not count as separate variants. If three variants cannot be meaningfully differentiated for a post, collapse it to one and note the reason in the Caption Copy Deck.
-
----
-
-## Per-Platform Character Targets
-
-| Platform | Hard limit | Optimal target | Notes |
-|---|---|---|---|
-| `twitter` | 280 | 200–240 | Reserve space for quote-share |
-| `instagram` | 2,200 | 125–150 above the "more" fold | Emoji usage moderate |
-| `facebook` | 63,206 | 100–250 | Longer works but engagement peaks under 250 |
-| `linkedin` | 3,000 | 1,200–2,000 for thought leadership | First 210 chars are the preview |
-| `tiktok` | 2,200 | 100–150 | First 150 chars decide watch-through |
-| `youtube` | Title 100 / Description 5,000 | Title 55–65 / Description 1,500 | Put key benefit in title |
-| `pinterest` | 500 | 200–300 | Keyword-dense; no emoji |
-| `reddit` | Varies | Subreddit-native (read mods' pinned post) | No marketing voice |
-| `bluesky` | 300 | 180–240 | No hashtags, context only |
-| `threads` | 500 | 200–350 | Text-first, image secondary |
-| `googlebusiness` | 1,500 | 150–250 | Lead with action or offer |
-| `telegram` | 4,096 | 300–800 (channel posts) | Preview shows first 2 lines |
-| `snapchat` | 80 (snap overlay) | ≤60 | Must read without audio |
-| `whatsapp` | 1,024 | ≤200 | Personal tone |
-
----
-
-## Hashtag Rules
-
-| Platform | Count | Rule |
-|---|---|---|
-| `instagram` | 3–5 | Mix branded + niche; skip filler (#love, #instagood) |
-| `linkedin` | 3–5 | Professional and topical only |
-| `tiktok` | 3–6 | Mix trending + niche; avoid banned tags |
-| `pinterest` | 2–3 | Keyword hashtags matched to pin description |
-| `twitter` | 1–2 | One branded max; one topical max |
-| `bluesky` | 0 | Platform convention is no hashtags |
-| `threads` | 0–1 | Hashtags used sparingly |
-| `reddit` | 0 | Hashtags read as marketing; remove them |
-| `googlebusiness` | 0 | Not used by platform |
-| `facebook` | 1–2 | Optional; brand-specific |
-| `youtube` | 3–5 in description, 1 in title if relevant | Descriptions tolerate more |
-| `telegram` | 0–2 | Channel-culture dependent |
-| `snapchat` | 0 | Not used by platform |
-| `whatsapp` | 0 | Not used by platform |
-
----
-
-## Brand Voice Preservation
-
-Every variant must pass these guardrails drawn from the active brand kit (`brands/<client-slug>/brand-kit.md`):
-
-1. Tone matches the brand's voice spec (e.g., "direct, technically credible")
-2. No blocked words (from the brand kit's "Words to Avoid")
-3. Preferred words are represented where natural (from "Words to Use")
-4. Emoji usage respects per-platform limits from the brand kit
-5. CTA matches the client's approved CTA style
-
-If a variant cannot satisfy all five guardrails, regenerate — do not ship it.
-
----
-
-## CTA Catalog
-
-Pick one CTA per post. "Learn more" is acceptable; blank is not. Examples mapped to common objectives:
-
-| Objective | CTA options |
-|---|---|
-| Brand awareness | "Follow for more", "Save for later", "Share with your team" |
-| Lead generation | "Get the guide", "Request a demo", "Join the waitlist" |
-| Engagement | "What's your take?", "Drop a comment", "Tag a friend" |
-| Product launch | "Try it today", "See what's new", "Book a walkthrough" |
-| Community | "Join the conversation", "Share your build", "Introduce yourself" |
-| Local (Google Business) | "Visit us today", "Claim the offer", "Call to book" |
-
----
-
-## Media Notes in Captions
-
-If a post depends on a media asset (image, video, carousel, reel, short, story):
-
-- Include one line in the Media Notes column of the Content Calendar
-- Cite: dimensions, duration, required overlays, brand safe zones, version (landscape/portrait)
-- For carousels, note slide count and order of slides (1 = hook, last = CTA)
-- For videos, note captions-on-by-default requirement and soundtrack licensing status
-
-Captions must never describe content that the media does not contain.
-
----
-
-## AI Enhancement Workflow
-
-When `ANTHROPIC_API_KEY` is present and the user asks for enhanced drafting:
-
-1. Draft the three variants with the rules above
-2. Run a quality pass asking: "which variant would an experienced social editor ship?"
-3. Revise the other two so they represent genuinely different angles — not alternate phrasings
-4. Score each variant against the brand voice guardrails
-5. Store scores in the Caption Copy Deck table
-
-This workflow runs entirely inside the agent. No calls go to Zernio for caption content generation.