@growthub/cli 0.14.4 → 0.14.6

package/assets/worker-kits/growthub-zernio-social-v1/docs/zernio-api-integration.md

@@ -1,265 +0,0 @@
-# Zernio API Integration
-
-This document is the reference contract between the `growthub-zernio-social-v1` kit and the [Zernio](https://zernio.com) REST API. It is frozen at kit creation and should be updated when the upstream API contract changes.
-
-> Source of truth upstream: [docs.zernio.com](https://docs.zernio.com). When this document conflicts with live Zernio docs, the live docs win; update this file and the kit version.
-
----
-
-## Base Contract
-
-| Field | Value |
-|---|---|
-| Base URL | `https://zernio.com/api/v1` |
-| Env var | `ZERNIO_API_URL` (override only for regional / proxy deployments) |
-| Transport | HTTPS only |
-| Request content type | `application/json` (JSON endpoints) · `multipart/form-data` (`/media` upload) |
-| Response content type | `application/json` |
-| Character encoding | UTF-8 |
-
----
-
-## Authentication
-
-Every request carries a single bearer header:
-
-```
-Authorization: Bearer ${ZERNIO_API_KEY}
-```
-
-### Key format
-
-- Prefix: `sk_`
-- Body: 64 hex characters
-- Total length: 67 characters
-
-Regex: `^sk_[0-9a-fA-F]{64}$`
-
-### Key scopes
-
-| Scope | Purpose |
-|---|---|
-| `read` | Read-only endpoints only (profiles, accounts, analytics, inbox listing) |
-| `read-write` | Everything in `read` plus create/update posts, queues, media, and inbox replies |
-
-### Key scope filter
-
-An individual key may be scoped `full` (any profile on the account) or `profiles-specific` (restricted to a list of profile IDs).
-
-### Idempotency
-
-Attach an `Idempotency-Key` header to every write request. The operator uses the `clientPostId` from the scheduling manifest as the idempotency key so the manifest can be re-submitted safely.
-
----
-
-## Core Resource Model
-
-Zernio models social publishing around five primary resources:
-
-| Resource | Endpoint root | Role |
-|---|---|---|
-| Profiles | `/api/v1/profiles` | A container that groups social accounts. Every request is implicitly scoped to one profile for scheduling. |
-| Accounts | `/api/v1/accounts` | A connected social account that belongs to a profile. Identified by `accountId`. |
-| Posts | `/api/v1/posts` | Schedulable content. One post can fan out to many `{ platform, accountId }` pairs. |
-| Queues | `/api/v1/queues` | Recurring time-slot schedule attached to a profile. Posts added to a queue auto-schedule into the next open slot. |
-| Media | `/api/v1/media` | Image, video, and document assets uploaded once and referenced by `mediaId` from a post body. |
-
-Two secondary resources:
-
-| Resource | Endpoint root | Role |
-|---|---|---|
-| Inbox | `/api/v1/inbox` | Unified DM, comment, and review conversations aggregated per profile. |
-| Analytics | `/api/v1/analytics` | Per-post and per-account metrics. |
-
-Supporting endpoints:
-
-| Endpoint | Role |
-|---|---|
-| `/api/v1/api-keys` | Create, list, rotate, and revoke API keys |
-| `/api/v1/connect/<platform>` | Begin platform OAuth / credential flow for a new account on a profile |
-| `/api/v1/platforms` | Live list of supported platforms and their per-platform capability flags |
-
-Extended capability surface (confirmed in `zernio-cli`, may be plan-gated):
-
-| Resource | Endpoint root | Role |
-|---|---|---|
-| Contacts | `/api/v1/contacts` | CRUD + bulk create + custom fields |
-| Broadcasts | `/api/v1/broadcasts` | Create / schedule / send / cancel + recipient management |
-| Sequences | `/api/v1/sequences` | Create / activate / pause + enrollment management |
-| Automations | `/api/v1/automations` | Create / run / inspect execution logs |
-| Webhooks | `/api/v1/webhooks` | Settings (create/update) + logs + signature verification; events include `account.connected`, `post.recycled` |
-
-The zernio-social-operator uses these endpoints only when the user explicitly asks for CRM-shaped work (contacts / broadcasts / sequences) or wants an automation wired into a campaign. Default campaign flow stays scoped to posts + queues + media + inbox + analytics.
-
----
-
-## Endpoints Used By This Kit
-
-### Profiles
-
-- `GET /api/v1/profiles` — list profiles on the account
-- `GET /api/v1/profiles/<profileId>` — fetch a single profile, including the default timezone
-
-### Accounts
-
-- `GET /api/v1/accounts?profileId=<id>` — list connected accounts on a profile (platform + handle + accountId)
-
-### Media upload
-
-- `POST /api/v1/media` — multipart upload; response includes `mediaId`
-- `GET /api/v1/media/<mediaId>` — fetch metadata of an uploaded asset
-
-### Posts
-
-- `POST /api/v1/posts` — schedule one post with fan-out targets
-- `GET /api/v1/posts?profileId=<id>&status=scheduled` — list scheduled posts
-- `GET /api/v1/posts/<postId>` — fetch a single post
-- `DELETE /api/v1/posts/<postId>` — unschedule a post (only while `status=scheduled`)
-
-Minimal `POST /api/v1/posts` body:
-
-```json
-{
-  "profileId": "prof_abc123",
-  "content": "Launch day — shipping our new kit. →",
-  "scheduledFor": "2026-05-01T09:00:00-04:00",
-  "timezone": "America/New_York",
-  "media": [{ "mediaId": "med_imgA" }],
-  "platforms": [
-    { "platform": "twitter",  "accountId": "acc_x_111" },
-    { "platform": "linkedin", "accountId": "acc_li_222" }
-  ]
-}
-```
-
-### Queues (recurring schedules)
-
-- `POST /api/v1/queues` — create a recurring queue
-- `GET /api/v1/queues?profileId=<id>` — list queues on a profile
-- `PUT /api/v1/queues/<queueId>` — replace queue configuration
-- `DELETE /api/v1/queues/<queueId>` — remove queue (future slots stop; already-scheduled posts remain)
-
-Minimal queue body:
-
-```json
-{
-  "profileId": "prof_abc123",
-  "name": "weekly-evergreen",
-  "timezone": "America/New_York",
-  "slots": [
-    { "day": "mon", "time": "09:00", "platforms": ["twitter", "linkedin"] },
-    { "day": "wed", "time": "12:30", "platforms": ["instagram"] },
-    { "day": "fri", "time": "17:00", "platforms": ["bluesky", "threads"] }
-  ]
-}
-```
-
-Posts attached to a queue omit `scheduledFor` and include `queueId` instead:
-
-```json
-{
-  "profileId": "prof_abc123",
-  "queueId": "que_xyz789",
-  "content": "Weekend builder log: three wins, one lesson.",
-  "platforms": [{ "platform": "twitter", "accountId": "acc_x_111" }]
-}
-```
-
-### Inbox (DMs, comments, reviews)
-
-- `GET /api/v1/inbox?profileId=<id>` — unified conversation list
-- `GET /api/v1/inbox/<conversationId>` — conversation thread
-- `POST /api/v1/inbox/<conversationId>/reply` — reply to a conversation
-
-### Analytics
-
-- `GET /api/v1/analytics/posts?profileId=<id>&from=<date>&to=<date>` — per-post metrics
-- `GET /api/v1/analytics/accounts?profileId=<id>&from=<date>&to=<date>` — per-account summary
-
-### API keys
-
-- `POST /api/v1/api-keys` — create a new key with `scope` and `permission`
-- `GET /api/v1/api-keys` — list existing keys
-- `DELETE /api/v1/api-keys/<keyId>` — revoke a key
-
----
-
-## Error Model
-
-All non-2xx responses return:
-
-```json
-{
-  "error": {
-    "code": "<machine_readable_code>",
-    "message": "<human readable>",
-    "requestId": "<uuid>"
-  }
-}
-```
-
-Well-known codes the operator handles:
-
-| HTTP | Zernio code | Behavior |
-|---|---|---|
-| 401 | `auth_invalid` | Key missing / malformed / revoked — surface to user, fall back to agent-only |
-| 403 | `permission_denied` | Key lacks `read-write` scope — surface with rotate-instructions |
-| 404 | `profile_not_found` / `account_not_found` | Correct the id or fall back to dry-run |
-| 409 | `conflict` | Typically an idempotency collision; safe to treat as success |
-| 422 | `validation_failed` | Manifest shape bug — fix and retry |
-| 429 | `rate_limited` | Back off using `Retry-After` header |
-| 5xx | `internal_error` | Retry with exponential backoff up to 3 attempts |
-
----
-
-## Plans and Quotas (as-of kit freeze)
-
-| Plan | Monthly | Annual (per mo) | Profiles | Posts / month | Notes |
-|---|---|---|---|---|---|
-| Free | $0 | $0 | 2 | 20 | Full REST API access; useful for prototypes |
-| Build | $19 | $16 | 10 | 120 | First paid tier |
-| Accelerate | $49 | $41 | 50 | unlimited | Recommended for agencies + multi-client operators |
-| Unlimited | $999 | $833 | unlimited | unlimited | Enterprise; includes higher support SLA |
-
-All plans ship the same REST contract (posts, queues, accounts, profiles, media, inbox, analytics, contacts, broadcasts, sequences, automations, webhooks, api-keys, connect, platforms). The post-count gate is the main throttle across tiers. Rate limit is 60 requests/minute per API key at every tier.
-
-The operator must degrade gracefully when a quota is hit: surface the Zernio error code (`rate_limited`, `quota_exhausted`) to the user, offer to switch the session into `agent-only` mode, and never silently drop scheduled posts.
-
-## Rate Limit Handling
-
-Default plan: 60 requests/minute per API key. The operator batches reads during account inspection and never issues more than one write per post per second.
-
-When a 429 is returned:
-
-1. Read `Retry-After` header (seconds)
-2. Sleep for the returned value plus 500ms jitter
-3. Retry the same request with the same `Idempotency-Key`
-4. On third failure, stop and report to the user
-
----
-
-## SDK + Harness Options (informational)
-
-Zernio ships official SDKs for Node.js, Python, Go, Ruby, Java, PHP, .NET, and Rust. Source repos live under [github.com/zernio-dev](https://github.com/zernio-dev).
-
-Two primitives are directly relevant to local AI coding environments:
-
-| Primitive | Distribution | Use from | Install |
-|---|---|---|---|
-| Official MCP server | bundled inside `zernio-python` | Claude Desktop, Claude Code, Cursor, any MCP-compatible IDE | `pip install zernio-sdk[mcp]` |
-| Zernio API Claude Code skill | `zernio-api` repo | Claude Code only | `npx clawhub@latest install zernio-api` |
-
-This kit intentionally uses the **raw REST contract** via Node's built-in `fetch()` so the operator behaves identically regardless of which local IDE the user has installed. If the user additionally plugs in Zernio's MCP server or the Claude Code skill, that is strictly complementary — the kit does not depend on either.
-
-See `docs/local-adapters.md` for the per-IDE setup matrix and `setup/install-mcp.mjs` for the copy-paste MCP config JSON blocks.
-
-Kit files never install or require any Zernio SDK. If the user wants to install one locally for their own tooling, that is their choice and does not affect kit behavior.
-
----
-
-## Security
-
-- `ZERNIO_API_KEY` lives only in `.env` (ignored by git) and the runtime environment
-- Outputs never include the raw key, request headers, or response payloads that contain keys
-- `scheduling-manifest.json` contains only `clientPostId`, content, timestamps, and Zernio resource IDs — no secrets
-- Any snippet of curl help in documentation uses `${ZERNIO_API_KEY}` as an expanded env var reference, never a literal

package/assets/worker-kits/growthub-zernio-social-v1/examples/analytics-brief-sample.md

@@ -1,97 +0,0 @@
-# Analytics Brief — Growthub · Q2 2026 Agent-Native CLI Launch
-
-**Kit:** `growthub-zernio-social-v1`
-**Generated:** 2026-06-02
-**Mode:** api-live
-**Version:** `v1`
-
----
-
-## Period Summary
-
-| Field | Value |
-|---|---|
-| Period | 2026-05-01 → 2026-05-30 |
-| Total posts published | 82 |
-| Platforms in scope | `twitter`, `linkedin`, `bluesky`, `youtube` |
-| Data source | Zernio `GET /api/v1/analytics/posts` + `GET /api/v1/analytics/accounts` |
-| Zernio profile id | prof_GRO_primary |
-
----
-
-## Per-Platform Performance
-
-| Platform | Posts | Impressions | Reach | Engagement rate | Follower growth | Link clicks |
-|---|---|---|---|---|---|---|
-| `twitter` | 30 | 184,000 | 92,300 | 4.1% | +438 | 1,240 |
-| `linkedin` | 12 | 31,200 | 18,400 | 5.6% | +126 | 614 |
-| `bluesky` | 13 | 22,800 | 14,100 | 6.9% | +215 | 310 |
-| `youtube` | 9 videos (6 shorts, 3 long) | 64,500 | — | 7.2% (likes+comments / views) | +71 | — |
-
-Engagement rate = (likes + comments + shares) / impressions × 100, normalized per platform.
-
----
-
-## Top 3 Posts
-
-| clientPostId | Platform | Date | Engagement rate | Why it worked |
-|---|---|---|---|---|
-| `growthub-20260514-022` | `twitter` | 2026-05-14 | 9.4% | Step-by-step thread on shipping a full campaign end-to-end landed on Hacker News; reply chain drove 60% of the engagement |
-| `growthub-20260501-001` | `twitter` | 2026-05-01 | 8.2% | Launch-day thread — `Agent Harness production-ready` framing matched developer Twitter's appetite for concrete builds |
-| `growthub-20260512-019` | `linkedin` | 2026-05-12 | 7.8% | Open-source maturity ladder carousel; carousel format on LinkedIn consistently beats plain text for diagram-driven content |
-
----
-
-## Bottom 3 Posts
-
-| clientPostId | Platform | Date | Engagement rate | Hypothesis |
-|---|---|---|---|---|
-| `growthub-20260509-018` | `twitter` | 2026-05-09 | 0.9% | Weekend "what are you building" prompt — low re-share fuel, generic CTA. Replace with a pinned answer-question format next cycle. |
-| `growthub-20260517-026` | `bluesky` | 2026-05-17 | 1.6% | Sunday OSS spotlight posted after 20:00 local — Bluesky's text feed benefits from morning placement; re-slot to 10:00. |
-| `growthub-20260523-032` | `linkedin` | 2026-05-23 | 1.8% | Long-form text without visual on Saturday; LinkedIn engagement dips on weekends. Move weekend posts to X only. |
-
----
-
-## Inbox Activity
-
-| Metric | Value |
-|---|---|
-| Open conversations (period start) | 6 |
-| Open conversations (period end) | 9 |
-| Avg first-response time | 38 minutes |
-| Replies sent | 64 |
-| Unresolved threads > 48h | 2 |
-
-Pulled via `GET /api/v1/inbox?profileId=prof_GRO_primary`.
-
----
-
-## Recommendations
-
-1. **X/Twitter — double down on step-by-step threads.** Posts 22 and 01 each cleared 8% engagement. Schedule one full walkthrough thread per week anchored to a CLI command; target Thursday 12:00 local.
-2. **LinkedIn — move to carousel-first.** Carousel posts outperformed plain text by ~2.4× in this period. Convert the next three planned LinkedIn text posts into 5-slide carousels sized 1080×1080.
-3. **Bluesky — shift OSS spotlight to Sunday 10:00.** Data shows ≥2× engagement lift for morning placement versus evening on this audience.
-4. **Weekend cadence — concentrate on X only.** LinkedIn and Bluesky weekend posts underperform. Free that capacity for 1 extra X post per weekend instead.
-5. **YouTube Shorts — add captions-on by default.** Shorts with burned-in captions hit 7.9% engagement; shorts without hit 4.3%. Standardize captions-on in the platform publishing plan.
-
----
-
-## Benchmark Comparison
-
-| Platform | Our engagement rate | Benchmark (developer-tool peers) | Delta |
-|---|---|---|---|
-| `twitter` | 4.1% | 3.2% | +0.9 pts |
-| `linkedin` | 5.6% | 4.0% | +1.6 pts |
-| `bluesky` | 6.9% | 5.5% | +1.4 pts |
-
-Benchmarks sourced from the brand kit's benchmark table.
-
----
-
-## Source Queries
-
-```
-GET /api/v1/analytics/posts?profileId=prof_GRO_primary&from=2026-05-01&to=2026-05-30
-GET /api/v1/analytics/accounts?profileId=prof_GRO_primary&from=2026-05-01&to=2026-05-30
-GET /api/v1/inbox?profileId=prof_GRO_primary
-```

package/assets/worker-kits/growthub-zernio-social-v1/examples/client-proposal-sample.md

@@ -1,106 +0,0 @@
-# Client Proposal — Growthub · Q2 2026 Agent-Native CLI Launch
-
-**Kit:** `growthub-zernio-social-v1`
-**Generated:** 2026-04-15
-**Mode:** api-live
-**Version:** `v1`
-
-> Internal reference proposal for the Growthub flagship campaign. Demonstrates the expected format and grounding depth for a real client proposal.
-
----
-
-## Campaign Overview
-
-| Field | Value |
-|---|---|
-| Client | Growthub |
-| Campaign | Q2 2026 Agent-Native CLI Launch |
-| Window | 2026-05-01 → 2026-05-30 |
-| Primary objective | Community growth (secondary: lead generation via CLI downloads) |
-| Platforms in scope | `twitter`, `linkedin`, `bluesky`, `youtube` |
-
----
-
-## Platform Mix Rationale
-
-| Platform | Role in this campaign | Why selected |
-|---|---|---|
-| `twitter` | Anchor — daily technical commentary | Developer community is concentrated here; 280-char format fits our voice |
-| `linkedin` | B2B thought leadership + hiring signal | Partners and enterprise prospects live here; carousel format amplifies architectural content |
-| `bluesky` | Early-adopter tech audience | Strong overlap with the agent-tooling audience; text-first matches Growthub's style |
-| `youtube` | Long-form + shorts | Weekly long-form drives durable discovery; shorts feed the algorithm with CLI walkthroughs |
-
-Instagram is deferred until team capacity supports a sustained visual pipeline.
-
----
-
-## Content Strategy
-
-- **Theme pillars:** Product Builds (35%), Developer Tutorials (30%), Open Source (20%), Community (15%)
-- **Format mix:** Threads on X, carousels on LinkedIn, long-form + shorts on YouTube, text on Bluesky
-- **Cadence:** X daily, LinkedIn 3×/week, Bluesky 3×/week, YouTube 1 long + 1 short/week
-- **Caption approach:** A/B/C variants per post — Variant A direct, B narrative, C question-hook. Selected variant is shipped; all three are logged for client review
-
----
-
-## Deliverables Scope
-
-| Deliverable | Included | Notes |
-|---|---|---|
-| Social Campaign Brief | Yes | One-time at campaign start |
-| Content Calendar | Yes | 30-day plan, refreshed monthly |
-| Platform Publishing Plan | Yes | Per-platform format + time window |
-| Caption Copy Deck | Yes | A/B/C variants for every scheduled post |
-| Scheduling Manifest | Yes | Zernio-shaped JSON + submission to `POST /api/v1/posts` |
-| Recurring Queue | Yes | `weekly-build-log` for weekend community posts |
-| Analytics Brief | Monthly | Pulled from `GET /api/v1/analytics/*` |
-| Inbox reply coverage | Yes | Unified DMs/comments via `GET /api/v1/inbox` |
-
----
-
-## Pricing Tiers
-
-| Tier | Scope | Monthly |
-|---|---|---|
-| Starter | 2 platforms, 3 posts/week, monthly analytics | $2,800 |
-| Growth | 4 platforms, daily posts, biweekly analytics, inbox coverage | $5,400 |
-| Scale | 6+ platforms, daily posts with queues, weekly analytics, priority inbox | $9,800 |
-
-Growthub's Q2 campaign fits **Growth** (4 platforms, daily posts, biweekly analytics, inbox coverage). Tier may move to Scale in Q3 if Instagram and Threads are added.
-
----
-
-## ROI Projection
-
-Based on the brand-kit benchmarks and May 2026 forecast (extrapolated from April 2026 baseline):
-
-| KPI | Growth-tier target | Scale-tier upside |
-|---|---|---|
-| Impressions / month | 300,000 | 520,000 |
-| Engagement rate | 4.5% | 5.2% |
-| Follower growth | +750 | +1,200 |
-| Link clicks | 1,800 | 3,100 |
-| CLI downloads attributable to social | +1,000 | +1,800 |
-
-Assumptions: median developer-tool engagement rate ~3.2%; Growthub's recent baseline on X is 3.8%; incremental lift comes from disciplined A/B/C variant shipping and carousel-first on LinkedIn.
-
----
-
-## Onboarding Plan
-
-1. Connect X, LinkedIn, Bluesky, YouTube inside Zernio (`/api/v1/connect/<platform>`)
-2. Confirm `ZERNIO_PROFILE_ID=prof_GRO_primary` and create a read-write API key scoped to it
-3. Review and approve Content Theme Pillars in the Social Campaign Brief
-4. Approve the Platform Publishing Plan and posting cadence
-5. Approve the Caption Copy Deck A/B/C variants (1–2 revision cycles expected)
-6. Submit the Scheduling Manifest with `Idempotency-Key = clientPostId`
-7. Cadence review at week 4 alongside the first Analytics Brief
-
----
-
-## Terms
-
-- Content ownership stays with Growthub
-- `ZERNIO_API_KEY`, `ANTHROPIC_API_KEY`, and any per-platform OAuth tokens stay inside Growthub's Zernio account and local `.env` — never included in deliverables
-- Cancellation: 30-day written notice
-- Revisions: two full revision cycles per deliverable included in each tier

package/assets/worker-kits/growthub-zernio-social-v1/examples/content-calendar-sample.md

@@ -1,74 +0,0 @@
-# Content Calendar — Growthub · Q2 2026 Agent-Native CLI Launch
-
-**Kit:** `growthub-zernio-social-v1`
-**Generated:** 2026-04-15
-**Mode:** api-live
-**Version:** `v1`
-
----
-
-## Calendar Header
-
-| Field | Value |
-|---|---|
-| Client | Growthub |
-| Zernio profile id | prof_GRO_primary |
-| Campaign window | 2026-05-01 → 2026-05-30 |
-| Platforms | `twitter`, `linkedin`, `bluesky`, `youtube` |
-| Posting timezone | America/New_York |
-
----
-
-## Calendar Table (first two weeks shown)
-
-| Date | Day | Platform | Account | Theme | Post Type | Caption Preview | CTA | Media Notes | Status |
-|---|---|---|---|---|---|---|---|---|---|
-| 2026-05-01 | Fri | `twitter` | acc_x_growthubai | Product Builds | thread | Q2 is here and the Agent Harness is production-ready. Here's what | Try it now | — | draft |
-| 2026-05-01 | Fri | `linkedin` | acc_li_GrowthubPage | Product Builds | text+image | Q2 is the window where Growthub's Agent Harness moves from preview | Read the docs | 1200x627 launch cover | draft |
-| 2026-05-01 | Fri | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | long-form | Agent Harness end-to-end walkthrough: kits, workflows, pipelines | Subscribe for weekly builds | 1920x1080 thumbnail, 16:9 video | draft |
-| 2026-05-02 | Sat | `twitter` | acc_x_growthubai | Community | text | Weekend builder log: three wins from the week shipping Agent Harness | Drop yours | — | draft |
-| 2026-05-03 | Sun | `bluesky` | acc_bsky_growthub | Open Source | text | Sunday OSS spotlight — the one tool we couldn't have shipped without | Check it out | — | draft |
-| 2026-05-05 | Tue | `twitter` | acc_x_growthubai | Developer Tutorials | image | 30 seconds: `growthub kit download growthub-zernio-social-v1` to | Star on GitHub | Terminal demo screencap | draft |
-| 2026-05-05 | Tue | `linkedin` | acc_li_GrowthubPage | Developer Tutorials | document/carousel | Three ways agent-native CLIs change how teams ship social campaigns | Try it now | 5-slide carousel, 1080x1080 | draft |
-| 2026-05-06 | Wed | `bluesky` | acc_bsky_growthub | Product Builds | text | We chose a kit-first architecture so every workspace ships as a po | Read the docs | — | draft |
-| 2026-05-07 | Thu | `twitter` | acc_x_growthubai | Product Builds | thread | Why we ship kits, not features: the short version and the tradeoffs | Read the docs | — | draft |
-| 2026-05-07 | Thu | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | short | 60s — add a Growthub kit to your workflow | Subscribe | 1080x1920, captions-on | draft |
-| 2026-05-08 | Fri | `linkedin` | acc_li_GrowthubPage | Community | text | Three user projects this week that bent our roadmap in a good way | Share yours | — | draft |
-| 2026-05-09 | Sat | `twitter` | acc_x_growthubai | Community | text | What are you building this weekend? Reply with a link — we rep the | Drop a link | — | draft |
-| 2026-05-10 | Sun | `bluesky` | acc_bsky_growthub | Community | text | Sunday show-and-tell — what's the smallest win you shipped this wee | Share it | — | draft |
-| 2026-05-12 | Tue | `twitter` | acc_x_growthubai | Open Source | image | Open source maturity ladder — where agent tooling is right now and | Keep going | Diagram 1200x675 | draft |
-| 2026-05-12 | Tue | `linkedin` | acc_li_GrowthubPage | Open Source | text+image | Open source maturity isn't about stars. It's about reproducible env | Read the guide | 1200x627 | draft |
-| 2026-05-14 | Thu | `twitter` | acc_x_growthubai | Developer Tutorials | thread | Step by step: how to ship a full social-media campaign with growth | Try it now | — | draft |
-| 2026-05-14 | Thu | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | long-form | Full walkthrough: growthub-zernio-social-v1 from download to publi | Subscribe | 1920x1080, 18 min | draft |
-
-Full calendar (weeks 3–4) continues the same cadence — product builds early week, tutorial mid-week, community Fridays and weekends, OSS Sundays.
-
----
-
-## Posting Cadence Summary
-
-| Platform | Posts / week | Best time window (America/New_York) | Notes |
-|---|---|---|---|
-| `twitter` | 7 | 08:00, 12:00, 17:00 | Anchor platform; highest-cadence |
-| `linkedin` | 3 | Tue 08:30, Thu 08:30, Fri 09:00 | Never more than 1/day |
-| `bluesky` | 3 | Wed 10:00, Sun 11:00, plus ad-hoc | Text-first, no hashtags |
-| `youtube` | 2 (1 long-form, 1 short) | Thu 12:00, Sat 10:00 | Long-form Thursdays drive weekend discovery |
-
----
-
-## Theme Pillar Distribution
-
-| Pillar | Count | % of calendar |
-|---|---|---|
-| Product Builds | 11 | 35% |
-| Developer Tutorials | 9 | 30% |
-| Open Source | 6 | 20% |
-| Community | 5 | 15% |
-
----
-
-## Notes
-
-- Multi-platform posts (e.g., 2026-05-01 X + LinkedIn) are spaced 45 minutes apart — X first, LinkedIn second — to avoid simultaneous-publishing optics
-- The `weekly-build-log` recurring queue handles Saturday community posts so cadence is stable through Q2
-- YouTube long-form premieres are disabled — scheduled publish only, to keep control inside Zernio

package/assets/worker-kits/growthub-zernio-social-v1/examples/social-campaign-sample.md

@@ -1,105 +0,0 @@
-# Social Campaign Brief — Growthub · Q2 2026 Agent-Native CLI Launch
-
-**Kit:** `growthub-zernio-social-v1`
-**Generated:** 2026-04-15
-**Mode:** api-live
-**Version:** `v1`
-
----
-
-## Project Overview
-
-| Field | Value |
-|---|---|
-| Client | Growthub |
-| Project | Q2 2026 Agent-Native CLI Launch |
-| Campaign window | 2026-05-01 → 2026-05-30 |
-| Zernio profile id | prof_GRO_primary |
-| Posting timezone | America/New_York |
-
----
-
-## Campaign Objective
-
-**Primary:** community growth with a strong secondary for lead generation
-
-**Why this objective:** Growthub's flywheel is developer adoption. The CLI ships daily; every release earns a round of organic developer commentary on X, Bluesky, and LinkedIn. Q2 is the first window where the newly-shipped Agent Harness is production-ready, and the campaign goal is to convert that community interest into measurable open-source adoption (CLI downloads, GitHub stars, waitlist signups).
-
----
-
-## Target Platforms
-
-| Platform | Zernio ID | Account | Rationale |
-|---|---|---|---|
-| X/Twitter | `twitter` | acc_x_growthubai | Highest-signal developer community for agent tooling; lives for technical threads |
-| LinkedIn | `linkedin` | acc_li_GrowthubPage | Hiring signal + thought leadership; partners and enterprise-adjacent audience |
-| Bluesky | `bluesky` | acc_bsky_growthub | Tech-fluent early adopters; text-first format fits our voice |
-| YouTube | `youtube` | acc_yt_GrowthubAI | Long-form CLI walkthroughs and shorts for each release |
-
-Max 5 platforms. Fifth (Instagram) deferred — team capacity insufficient for sustained visual production this cycle.
-
----
-
-## Audience Profile
-
-### Primary
-
-| Attribute | Value |
-|---|---|
-| Age range | 25–45 |
-| Geography | North America + Europe, English-first |
-| Interests | AI agents, developer tools, automation, local-first infra |
-| Pain points | Agent orchestration sprawl, tool fatigue, SaaS lock-in |
-| Content preferences | Technical threads, CLI walkthroughs, architecture posts, build-in-public behind the scenes |
-
-### Secondary
-
-| Attribute | Value |
-|---|---|
-| Age range | 18–25 |
-| Platforms | X/Twitter, Bluesky, GitHub |
-| Interests | Open source, indie hacking, learning agent development |
-
----
-
-## KPI Targets
-
-| KPI | Metric | Target | Timeline |
-|---|---|---|---|
-| Developer awareness | GitHub stars | +500 | By 2026-05-30 |
-| Community growth | X followers | +400 | Rolling through Q2 |
-| Thought leadership | LinkedIn impressions | 25,000 / month | May 2026 |
-| Open-source adoption | CLI downloads (npm) | +2,000 / month | May 2026 |
-
----
-
-## Content Theme Pillars
-
-| Pillar | Description | % of calendar | Primary platforms |
-|---|---|---|---|
-| Product Builds | Behind-the-scenes of shipping kits and CLI features | 35% | X, LinkedIn, YouTube |
-| Developer Tutorials | How to use kits, commands, workflows end-to-end | 30% | X, Bluesky, YouTube |
-| Open Source | OSS culture, contributions, partner projects | 20% | X, Bluesky |
-| Community | User projects, shoutouts, Q&A, polls | 15% | X, LinkedIn |
-
----
-
-## Brand Voice Summary
-
-| Attribute | Spec |
-|---|---|
-| Tone | Direct, technically credible, approachable. Explains without condescension. Ships without bragging. |
-| Words to use | "build", "ship", "run", "local", "open", "agent", "workflow", "kit", "workspace" |
-| Words to avoid | "disruptive", "AI-powered", "revolutionary", "hack" |
-| Emoji rule | 0–1 on LinkedIn, 0–2 on X, none on Bluesky |
-| CTA style | Action verbs with immediate value: "Try it now", "Clone and run", "Read the docs", "Star on GitHub" |
-
----
-
-## Execution Notes
-
-- Caption variants: 3 per post (A direct, B narrative, C question)
-- Every `POST /api/v1/posts` call uses `Idempotency-Key = clientPostId` (shape `growthub-YYYYMMDD-NNN`)
-- `dryRun` is `false` — api-live mode, profile `prof_GRO_primary`
-- Manifest submission order: media uploads → posts → recurring `weekly-build-log` queue creation
-- YouTube long-form videos scheduled via Zernio with premieres disabled; Shorts scheduled via queue