@growthub/cli 0.3.56 → 0.3.58

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

@@ -0,0 +1,70 @@
+# Content Calendar — [Client Name] · [Project Name]
+
+**Kit:** `growthub-zernio-social-v1`
+**Generated:** [YYYY-MM-DD]
+**Mode:** [api-live | agent-only | hybrid]
+**Version:** `v1`
+
+---
+
+## Calendar Header
+
+| Field | Value |
+|---|---|
+| Client | [Client Name] |
+| Zernio profile id | [prof_... or placeholder] |
+| Campaign window | [YYYY-MM-DD] → [YYYY-MM-DD] |
+| Platforms | [comma-separated Zernio platform slugs] |
+| Posting timezone | [IANA tz] |
+
+---
+
+## Calendar Table
+
+Column contract (one row per scheduled post):
+
+| Date | Day | Platform | Account | Theme | Post Type | Caption Preview | CTA | Media Notes | Status |
+|---|---|---|---|---|---|---|---|---|---|
+| YYYY-MM-DD | Mon | `instagram` | [@handle or accountId] | [Pillar] | image | [first 100 chars of variant A] | [CTA] | [dims, duration, overlays] | draft |
+| YYYY-MM-DD | Mon | `twitter` | [@handle or accountId] | [Pillar] | text | [first 100 chars] | [CTA] | — | draft |
+| YYYY-MM-DD | Tue | `linkedin` | [page id or accountId] | [Pillar] | carousel | [first 100 chars] | [CTA] | [slide count + order] | draft |
+| ... | | | | | | | | | |
+
+### Rules
+
+- One row per scheduled post
+- `Platform` values must exist in `docs/platform-coverage.md`
+- `Post Type` must be valid for the platform
+- `Caption Preview` is the first 100 characters of the selected variant — full captions live in the Caption Copy Deck
+- `CTA` is required and non-empty
+- `Media Notes` are required for image/video/carousel/reel/short/story
+- `Status` defaults to `draft` and moves to `scheduled` once the manifest is submitted
+
+---
+
+## Posting Cadence Summary
+
+| Platform | Posts / week | Best time window | Notes |
+|---|---|---|---|
+| `instagram` | [3] | [12:00–13:00 local] | [rationale] |
+| `linkedin` | [3] | [08:00–09:30 local] | [rationale] |
+| `twitter` | [7] | [spread: 08:00, 12:00, 17:00] | [rationale] |
+
+---
+
+## Theme Pillar Distribution
+
+| Pillar | Count | % of calendar |
+|---|---|---|
+| [Pillar 1] | [N] | [40%] |
+| [Pillar 2] | [N] | [30%] |
+| [Pillar 3] | [N] | [20%] |
+| [Pillar 4] | [N] | [10%] |
+
+---
+
+## Notes
+
+- Cadence must match the Platform Publishing Plan
+- Multi-platform posts spaced ≥30 minutes apart to avoid simultaneous-publishing optics
+- Weekend slots default to community / engagement pillars unless client overrides

package/assets/worker-kits/growthub-zernio-social-v1/templates/platform-publishing-plan.md

@@ -0,0 +1,86 @@
+# Platform Publishing Plan — [Client Name] · [Project Name]
+
+**Kit:** `growthub-zernio-social-v1`
+**Generated:** [YYYY-MM-DD]
+**Mode:** [api-live | agent-only | hybrid]
+**Version:** `v1`
+
+---
+
+## Per-Platform Rows
+
+Produce one row per platform in scope. Every field is required.
+
+### [Platform — e.g., Instagram]
+
+| Field | Value |
+|---|---|
+| Zernio platform id | `instagram` |
+| Zernio account id | [acc_ig_... or `placeholder_@handle` in agent-only] |
+| Format mix | [e.g., 40% reels, 30% carousel, 20% single image, 10% story] |
+| Posting frequency | [e.g., 3/week + daily stories] |
+| Best posting times (local) | [e.g., Tue 12:00, Thu 12:00, Sat 10:30] |
+| Primary theme pillars | [pillar names] |
+| Caption length target | [e.g., 125–150 chars above the fold] |
+| Hashtag count | [e.g., 3–5 primary] |
+| Content mix rationale | [One paragraph: why this mix fits the audience and objective] |
+
+### [Platform — e.g., LinkedIn]
+
+| Field | Value |
+|---|---|
+| Zernio platform id | `linkedin` |
+| Zernio account id | [page id or accountId] |
+| Format mix | [e.g., 50% text+image, 30% document carousel, 20% video] |
+| Posting frequency | [e.g., 3/week] |
+| Best posting times (local) | [e.g., Tue 08:30, Wed 08:30, Thu 08:30] |
+| Primary theme pillars | [pillar names] |
+| Caption length target | [e.g., 1,200–2,000 chars for thought leadership] |
+| Hashtag count | [e.g., 3–5 professional] |
+| Content mix rationale | [One paragraph] |
+
+### [Platform — e.g., X/Twitter]
+
+| Field | Value |
+|---|---|
+| Zernio platform id | `twitter` |
+| Zernio account id | [acc_x_...] |
+| Format mix | [e.g., 60% text, 25% image, 15% thread] |
+| Posting frequency | [e.g., 7/week] |
+| Best posting times (local) | [e.g., 08:00, 12:00, 17:00] |
+| Primary theme pillars | [pillar names] |
+| Caption length target | [e.g., 200–240 chars] |
+| Hashtag count | [1–2] |
+| Content mix rationale | [One paragraph] |
+
+---
+
+## Cross-Platform Orchestration
+
+| Rule | Value |
+|---|---|
+| Minimum gap between simultaneous posts | 30 minutes |
+| Collision check | Run against `GET /api/v1/posts?status=scheduled` before submission |
+| Queue in use | [queue name or `none`] |
+| Default timezone | [IANA tz] |
+
+---
+
+## Queue Coverage (if applicable)
+
+| Queue name | Platforms covered | Slots per week |
+|---|---|---|
+| [weekly-evergreen] | [twitter, linkedin] | [3] |
+| [daily-visual] | [instagram] | [5] |
+
+If queues are used, posts scheduled into a queue omit `scheduledFor` from the Zernio body and include `queueId` — see `docs/posts-and-queues-layer.md`.
+
+---
+
+## Go-Live Checklist
+
+- [ ] Every platform in this plan is connected on the Zernio profile
+- [ ] Every `accountId` is a real Zernio id (live mode) or a documented placeholder (agent-only)
+- [ ] Posting windows cross-checked against existing scheduled posts
+- [ ] Hashtag and caption rules match `docs/ai-caption-layer.md`
+- [ ] Client approved the plan before any write requests are issued

package/assets/worker-kits/growthub-zernio-social-v1/templates/scheduling-manifest.md

@@ -0,0 +1,92 @@
+# Scheduling Manifest — [Client Name] · [Project Name]
+
+**Kit:** `growthub-zernio-social-v1`
+**Generated:** [YYYY-MM-DD]
+**Mode:** [api-live | agent-only | hybrid]
+**Version:** `v1`
+
+---
+
+## Purpose
+
+This file documents the Zernio-shaped scheduling manifest for this campaign. The machine-readable companion is `scheduling-manifest.json` in the same folder — the operator writes that file alongside this Markdown record.
+
+Manifest shape is fully specified in `docs/posts-and-queues-layer.md`. Every post entry is a valid `POST /api/v1/posts` body (minus the two bookkeeping fields `clientPostId` and `status`).
+
+---
+
+## Manifest Header
+
+| Field | Value |
+|---|---|
+| `version` | `1.0` |
+| `profileId` | [prof_... or `placeholder`] |
+| `timezone` | [IANA tz, e.g., `America/New_York`] |
+| `dryRun` | [true in agent-only mode, false otherwise] |
+| `generatedAt` | [ISO 8601 with tz offset] |
+| Post count | [N entries] |
+
+---
+
+## Post Entries (reference table)
+
+| clientPostId | scheduledFor | platforms (count) | media (count) | status |
+|---|---|---|---|---|
+| `urban-cycle-20260501-001` | 2026-05-01T09:00:00-04:00 | 2 | 1 | pending |
+| `urban-cycle-20260501-002` | 2026-05-01T12:30:00-04:00 | 1 | 0 | pending |
+
+Full JSON lives in `scheduling-manifest.json` beside this file.
+
+---
+
+## Reference JSON Block
+
+```json
+{
+  "zernioSchedulingManifest": {
+    "version": "1.0",
+    "profileId": "prof_abc123",
+    "timezone": "America/New_York",
+    "dryRun": false,
+    "generatedAt": "2026-04-15T14:30:00-04:00",
+    "posts": [
+      {
+        "clientPostId": "urban-cycle-20260501-001",
+        "content": "Launch day — shipping our spring gravel lineup. Ride it today →",
+        "scheduledFor": "2026-05-01T09:00:00-04:00",
+        "timezone": "America/New_York",
+        "media": [{ "mediaId": "med_HERO_01" }],
+        "platforms": [
+          { "platform": "instagram", "accountId": "acc_ig_UrbanCycle" },
+          { "platform": "twitter",   "accountId": "acc_x_UrbanCycle" }
+        ],
+        "status": "pending"
+      }
+    ]
+  }
+}
+```
+
+---
+
+## Submission Sequence
+
+1. Upload every referenced media asset via `POST /api/v1/media`, capturing each returned `mediaId`
+2. Replace placeholder media IDs in `scheduling-manifest.json`
+3. Iterate `posts[]`, issuing one `POST /api/v1/posts` per entry with `Idempotency-Key: <clientPostId>`
+4. Update each entry's `status` from `pending` to `scheduled` on 2xx, or `failed` on non-2xx with the Zernio `requestId`
+5. If the campaign uses a recurring queue, submit `POST /api/v1/queues` first so its id can be referenced by queued post entries
+
+---
+
+## Validation Before Submit
+
+- [ ] Every post in the manifest also exists in the Content Calendar
+- [ ] Every caption is the selected variant from the Caption Copy Deck
+- [ ] Every platform exists in `docs/platform-coverage.md`
+- [ ] Every `scheduledFor` is ISO 8601 with timezone offset
+- [ ] Every `clientPostId` follows `<client-slug>-<YYYYMMDD>-<sequence>`
+- [ ] In api-live mode, every `accountId` is confirmed via `GET /api/v1/accounts`
+- [ ] `dryRun` matches the execution mode declared in the Social Campaign Brief
+
+Failure on any of these blocks submission.

package/assets/worker-kits/growthub-zernio-social-v1/templates/social-campaign-brief.md

@@ -0,0 +1,102 @@
+# Social Campaign Brief — [Client Name] · [Project Name]
+
+**Kit:** `growthub-zernio-social-v1`
+**Generated:** [YYYY-MM-DD]
+**Mode:** [api-live | agent-only | hybrid]
+**Version:** `v1`
+
+---
+
+## Project Overview
+
+| Field | Value |
+|---|---|
+| Client | [Client Name] |
+| Project | [Project Name] |
+| Campaign window | [YYYY-MM-DD] → [YYYY-MM-DD] |
+| Zernio profile id | [prof_...] or `placeholder` in agent-only mode |
+| Posting timezone | [IANA tz name, e.g., America/New_York] |
+
+---
+
+## Campaign Objective
+
+**Primary:** [brand awareness | lead generation | engagement | product launch | community growth]
+
+**Why this objective:** [One paragraph grounded in the brand kit's current stage and retainer context.]
+
+---
+
+## Target Platforms
+
+| Platform | Zernio ID | Account | Rationale |
+|---|---|---|---|
+| [Instagram] | `instagram` | [@handle or accountId] | [Why selected — demographics, format fit, client capacity] |
+| [LinkedIn]  | `linkedin`  | [company page or accountId] | [Why selected] |
+| [X/Twitter] | `twitter`   | [@handle] | [Why selected] |
+
+Max 5 platforms unless the brand kit documents the team capacity to support more.
+
+---
+
+## Audience Profile
+
+### Primary
+
+| Attribute | Value |
+|---|---|
+| Age range | [range] |
+| Geography | [regions or countries] |
+| Interests | [top 3–5] |
+| Pain points | [top 3] |
+| Content preferences | [formats + topics] |
+
+### Secondary
+
+| Attribute | Value |
+|---|---|
+| Age range | [range] |
+| Platforms | [where they are concentrated] |
+| Interests | [top 2–3] |
+
+---
+
+## KPI Targets
+
+| KPI | Metric | Target | Timeline |
+|---|---|---|---|
+| [Brand awareness] | [Impressions] | [50,000/month] | [Month 1] |
+| [Engagement] | [Engagement rate] | [≥3%] | [Rolling] |
+| [Lead generation] | [Link clicks] | [200/month] | [Month 1] |
+
+---
+
+## Content Theme Pillars
+
+| Pillar | Description | % of calendar | Primary platforms |
+|---|---|---|---|
+| [Pillar 1] | [One-sentence definition] | [40%] | [platforms] |
+| [Pillar 2] | [Definition] | [30%] | [platforms] |
+| [Pillar 3] | [Definition] | [20%] | [platforms] |
+| [Pillar 4] | [Definition] | [10%] | [platforms] |
+
+---
+
+## Brand Voice Summary
+
+| Attribute | Spec |
+|---|---|
+| Tone | [From brand kit] |
+| Words to use | [Top 5–8] |
+| Words to avoid | [Top 5–8] |
+| Emoji rule | [Per platform] |
+| CTA style | [From brand kit] |
+
+---
+
+## Execution Notes
+
+- Caption variants: 3 per post (A direct, B narrative, C question/hook)
+- Every write request to Zernio uses `Idempotency-Key = clientPostId`
+- `dryRun` is `[true/false]` based on execution mode
+- Manifest submission order: media uploads → posts → (optional) queue creation

package/assets/worker-kits/growthub-zernio-social-v1/validation-checklist.md

@@ -0,0 +1,85 @@
+# Validation Checklist — growthub-zernio-social-v1
+
+**Run through this checklist before starting every operator session and before delivering any artifact package.**
+
+---
+
+## Pre-Session Checklist
+
+### Environment Gate
+
+- [ ] Node.js 18+ is installed (`node --version` returns 18+)
+- [ ] `curl` is installed (used for Zernio healthchecks)
+- [ ] Git is installed (`git --version`)
+
+### Api-Live Mode (skip if agent-only)
+
+- [ ] `ZERNIO_API_KEY` is set in `.env` and matches `sk_` + 64 hex format
+- [ ] `ZERNIO_API_URL` is set (default `https://zernio.com/api/v1`)
+- [ ] `GET /api/v1/profiles` returns 200 with the API key
+- [ ] `ZERNIO_PROFILE_ID` is set and exists on the account
+- [ ] At least one platform account is connected on the profile (`GET /api/v1/accounts`)
+- [ ] API key scope is `read-write` (required for scheduling)
+
+### Agent-Only Mode (skip if api-live)
+
+- [ ] Mode is confirmed with the user and documented as `agent-only` at the top of all outputs
+- [ ] Scheduling manifests are marked as `"dryRun": true` in the manifest header
+- [ ] Every `platforms[].accountId` is flagged as placeholder tagged with the account handle
+
+### Context
+
+- [ ] Brand kit exists for the active client (`brands/<client-slug>/brand-kit.md`)
+- [ ] Campaign objective is confirmed (one of: brand awareness / lead generation / engagement / product launch / community growth)
+- [ ] Target platforms are confirmed and in the supported list (`docs/platform-coverage.md`)
+- [ ] Campaign timeframe and posting cadence are confirmed
+
+---
+
+## Pre-Delivery Checklist
+
+### Content Calendar
+
+- [ ] All calendar rows have dates within the campaign window
+- [ ] All platform slugs match `docs/platform-coverage.md`
+- [ ] All post types are valid for their target platform
+- [ ] Every row has a non-empty CTA
+- [ ] Media asset notes are present for all image/video/carousel posts
+
+### Caption Copy Deck
+
+- [ ] All 3 variants (A/B/C) are present for every post entry
+- [ ] All captions respect platform character limits
+- [ ] Hashtag counts are within platform-recommended ranges
+- [ ] No placeholder text remains (no `[INSERT CAPTION HERE]` style fragments)
+
+### Scheduling Manifest
+
+- [ ] Shape matches `POST /api/v1/posts` body expectations (see `docs/posts-and-queues-layer.md`)
+- [ ] All `scheduledFor` timestamps are ISO 8601 with explicit timezone offset
+- [ ] All `clientPostId` values follow the naming convention
+- [ ] `profileId` is present (or the manifest is `"dryRun": true`)
+- [ ] `platforms[].platform` values all exist in `docs/platform-coverage.md`
+- [ ] Every post in the manifest has a corresponding entry in the ContentCalendar
+
+### Output Files
+
+- [ ] All files follow the naming convention (`ClientSlug_OutputType_v<N>_<YYYYMMDD>.md`)
+- [ ] All files are saved to `output/<client-slug>/<project-slug>/`
+- [ ] Deliverable is logged in the brand kit DELIVERABLES LOG
+- [ ] No API keys, tokens, or credentials appear in any output file
+- [ ] No partial Zernio request responses with raw auth headers are included
+
+---
+
+## Kit Integrity Checklist (run after kit changes)
+
+- [ ] `kit.json` is valid JSON with `schemaVersion: 2`
+- [ ] All paths in `frozenAssetPaths` exist on disk
+- [ ] All paths in `outputStandard.requiredPaths` exist on disk
+- [ ] Bundle manifest `bundles/growthub-zernio-social-v1.json` exists and matches kit.json
+- [ ] `bundle.kitId` in bundle manifest matches `kit.id` in kit.json
+- [ ] `bundle.workerId` in bundle manifest matches `entrypoint.workerId` in kit.json
+- [ ] All paths in `requiredFrozenAssets` in bundle manifest exist on disk
+- [ ] `node scripts/check-worker-kits.mjs` passes
+- [ ] `bash scripts/check-custom-workspace-kernel.sh` passes