@growthub/cli 0.3.59 → 0.4.1

package/assets/worker-kits/growthub-custom-workspace-starter-v1/templates/deployment-plan.md

@@ -0,0 +1,22 @@
+# Deployment Plan — Template
+
+A deployment plan is the final artifact of a workspace run. It must be:
+
+1. Human-reviewable (Markdown prose).
+2. Machine-executable (the JSON plan block below must be shape-compatible with the bundle descriptor).
+
+## Human summary
+
+Describe the plan in 3–5 sentences.
+
+## Machine plan
+
+```json
+{
+  "kit": "growthub-custom-workspace-starter-v1",
+  "forkId": "<filled at runtime>",
+  "actions": [
+    { "type": "deploy", "target": "<env>" }
+  ]
+}
+```

package/assets/worker-kits/growthub-custom-workspace-starter-v1/templates/workspace-brief.md

@@ -0,0 +1,11 @@
+# Workspace Brief — Template
+
+Use this template to capture what a new custom workspace is for.
+
+- Client:
+- Project slug:
+- Goals (3 bullets max):
+- Surface area (which worker kits this workspace composes):
+- Out of scope:
+- Success criteria:
+- First heal checkpoint:

package/assets/worker-kits/growthub-custom-workspace-starter-v1/validation-checklist.md

@@ -0,0 +1,13 @@
+# Starter Kit — Validation Checklist
+
+Run before declaring a workspace ready for production:
+
+- [ ] `kit.json` is schema-v2 valid
+- [ ] Every path listed in `frozenAssetPaths` exists on disk
+- [ ] `.growthub-fork/fork.json` is present and `growthub kit fork status <fork-id>` returns severity = none
+- [ ] `policy.json` reflects the intended safety envelope
+- [ ] `trace.jsonl` contains at minimum `registered` + `policy_updated` + one `status_ran` event
+- [ ] `studio/` builds with `npm run build` (no errors)
+- [ ] `growthub kit fork heal <fork-id> --dry-run` produces zero errors
+- [ ] When `policy.remoteSyncMode === "pr"`: the GitHub remote is reachable and the last heal opened a draft PR
+- [ ] `growthub status --super-admin` shows all critical services operational

package/assets/worker-kits/growthub-custom-workspace-starter-v1/workers/custom-workspace-operator/CLAUDE.md

@@ -0,0 +1,32 @@
+# Custom Workspace Operator — Agent Contract
+
+You are the Custom Workspace Operator — the agent wired to this Growthub custom workspace fork. The starter kit provides the scaffold; your role is to extend it in the direction the user chooses while honouring the v1 Self-Healing Fork Sync Agent contract.
+
+## Inputs you always have
+
+- `kit.json` — the manifest, schema v2, family `studio`
+- `bundles/growthub-custom-workspace-starter-v1.json` — the bundle contract
+- `brands/_template/brand-kit.md` — empty brand scaffold
+- `brands/growthub/brand-kit.md` — reference brand
+- `studio/` — the Vite UI shell (React + Vite 5)
+- `workers/custom-workspace-operator/CLAUDE.md` — this file
+- `.growthub-fork/fork.json`, `.growthub-fork/policy.json`, `.growthub-fork/trace.jsonl` — the fork state the CLI registered for this workspace
+
+## Non-negotiables
+
+- Never modify files under `skills/`, `custom/`, `.env`, `.env.local`, or any path listed in `policy.untouchablePaths`.
+- Never perform a destructive remote operation (`push --force`, `reset --hard`) without explicit user confirmation.
+- Every significant action appends an event to `trace.jsonl` via the Fork Sync Agent — do not bypass.
+- Respect `policy.autoApprove` + `policy.autoApproveDepUpdates`. If a change is outside scope, mark it `needsConfirmation` and park.
+
+## Execution verbs
+
+- `growthub starter init --name <workspace> --out <path>` — scaffold a new workspace from this starter
+- `growthub kit fork status <fork-id>` — check drift
+- `growthub kit fork heal <fork-id> [--dry-run | --background]` — propose + apply heal
+- `growthub kit fork policy --fork-id <fork-id> --set <key=value>` — configure safety envelope
+- `growthub kit fork trace --fork-id <fork-id> --tail N` — replay the event log
+
+## Output contract
+
+All user-facing artifacts for a custom workspace run write to `output/<client-slug>/<project-slug>/`. Machine-readable manifests should be shape-compatible with the bundle descriptor in `bundles/`.

package/assets/worker-kits/growthub-zernio-social-v1/.env.example

@@ -0,0 +1,5 @@
+ZERNIO_API_KEY=your_zernio_api_key_here
+ZERNIO_API_URL=https://zernio.com/api/v1
+ZERNIO_PROFILE_ID=
+ZERNIO_TIMEZONE=America/New_York
+ANTHROPIC_API_KEY=your_anthropic_key_here

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

@@ -56,6 +56,40 @@ Open `.env` and fill in:
 
 Re-run `node setup/setup.mjs` after editing `.env` to confirm everything is valid.
 
+### Run the exported UI shell workspace
+
+The social UI lives in the exported worker-kit folder under `studio/`. Treat that exported folder as the working copy. Do not edit or rely on the CLI repo copy once the kit has been exported.
+
+From the exported kit folder:
+
+```bash
+cd studio
+npm install
+```
+
+Create a local `.env` in `studio/` with:
+
+```bash
+VITE_ZERNIO_API_URL=https://zernio.com/api/v1
+VITE_ZERNIO_API_KEY=<your-zernio-api-key>
+VITE_ZERNIO_PROFILE_ID=<your-profile-id>
+```
+
+Then start the UI shell:
+
+```bash
+cd studio
+npm run dev
+```
+
+Default local URL:
+
+```text
+http://127.0.0.1:5173
+```
+
+The exported Vite workspace is the user-facing setup path. The CLI's job is only to export the worker kit cleanly.
+
 ### Agent-only mode (no Zernio key needed)
 
 If you just want to plan, write captions, and produce dry-run manifests without touching the Zernio API, skip the key entirely:
@@ -133,7 +167,7 @@ Override the export path with `--out <path>` on `growthub kit download`.
 | `api-live`        | Valid `ZERNIO_API_KEY` + at least one connected account on a profile         | You want to schedule posts and queues via the live Zernio API                                                                                                     |
 | `agent-only`      | Nothing — Claude Code handles everything                                     | You need campaign planning, calendars, and captions without touching the Zernio API                                                                               |
 | `hybrid`          | `ANTHROPIC_API_KEY` + valid `ZERNIO_API_KEY`                                 | Enhanced caption drafting via Anthropic plus live Zernio scheduling                                                                                               |
-| `postiz-ui-shell` | `api-live` / `hybrid` + the Postiz kit (`growthub-postiz-social-v1`) running | You want Postiz's UI (calendar, compose, analytics shell) with Zernio as the transport engine. See `docs/postiz-ui-shell-integration.md` for the 7-module bridge. |
+| `growthub-ui-shell` | `api-live` / `hybrid` + the exported `studio/` workspace | You want the exported Growthub Agentic Social Media Platform UI shell for calendar, compose, comment automation, analytics, and account operations. See `docs/growthub-agentic-social-platform-ui-shell.md`. |
 
 
 **Agent-only mode is always valid.** Zernio reachability never blocks campaign planning.
@@ -203,7 +237,5 @@ Tell the operator which you need:
 | `docs/ai-caption-layer.md`                 | AI caption generation methodology                                                                      |
 | `docs/posts-and-queues-layer.md`           | Scheduling manifest + queue format for Zernio API                                                      |
 | `docs/local-adapters.md`                   | Per-IDE setup matrix (Claude Code / Desktop / Codex / Cursor / Gemini / OpenCode / Qwen / Open Agents) |
-| `docs/postiz-ui-shell-integration.md`      | Optional — run this kit as the engine under the Postiz UI shell                                        |
+| `docs/growthub-agentic-social-platform-ui-shell.md` | Exported UI-shell workflow and validation contract                                         |
 | `validation-checklist.md`                  | Pre-session checklist                                                                                  |
-
-

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

@@ -12,6 +12,7 @@
   ],
   "requiredFrozenAssets": [
     "QUICKSTART.md",
+    ".env.example",
     "skills.md",
     "output-standards.md",
     "runtime-assumptions.md",
@@ -41,8 +42,36 @@
     "docs/platform-coverage.md",
     "docs/ai-caption-layer.md",
     "docs/posts-and-queues-layer.md",
-    "docs/postiz-ui-shell-integration.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"
   ],

package/assets/worker-kits/growthub-zernio-social-v1/docs/growthub-agentic-social-platform-ui-shell.md

@@ -0,0 +1,134 @@
+# Growthub Agentic Social Media Platform — Exported UI Shell
+
+This document is the source of truth for the UI shell that ships inside the exported `growthub-zernio-social-v1` worker kit.
+
+**Read order:** `../runtime-assumptions.md` → `./zernio-api-integration.md` → this file.
+
+---
+
+## Truth Boundary
+
+- The user exports this worker kit from the CLI.
+- After export, the user works inside the exported folder, not inside the CLI repo.
+- The UI shell lives at `studio/` inside that exported folder.
+- The rest of the exported worker kit remains the execution contract for setup, templates, agent law, and Zernio API behavior.
+
+This keeps the Vite shell fully isolated inside the exported worker-kit workspace.
+
+---
+
+## Exported Workspace Shape
+
+```text
+growthub-agent-worker-kit-zernio-social-v1/
+  QUICKSTART.md
+  kit.json
+  setup/
+  docs/
+  workers/
+  templates/
+  studio/
+    package.json
+    vite.config.js
+    src/
+```
+
+The user-facing UI setup starts in `studio/`. The worker-kit root remains the source of truth for setup scripts, templates, and the Zernio operator contract.
+
+---
+
+## Launch Flow
+
+From the exported worker-kit folder:
+
+```bash
+cd studio
+npm install
+```
+
+Create `studio/.env` with:
+
+```bash
+VITE_ZERNIO_API_URL=https://zernio.com/api/v1
+VITE_ZERNIO_API_KEY=<your-zernio-api-key>
+VITE_ZERNIO_PROFILE_ID=<your-profile-id>
+```
+
+Then start the UI shell:
+
+```bash
+cd studio
+npm run dev
+```
+
+Default local URL:
+
+```text
+http://127.0.0.1:5173
+```
+
+The UI shell is validated from the exported folder itself. Do not use the CLI repo copy as the runtime workspace for the end user.
+
+---
+
+## What The UI Shell Covers
+
+The exported Growthub UI shell owns these surfaces:
+
+- Dashboard
+- Accounts
+- Compose
+- Scheduled
+- Queues
+- Analytics
+- Templates
+- Comment Rules
+- Sequences
+- Automations
+- Agent / Swarm
+- API Keys
+
+The Zernio worker kit owns the transport, setup scripts, API contract, and agent workflow that sit behind those screens.
+
+---
+
+## Comment Automation Scope
+
+The validated comment automation surface in the UI shell is:
+
+- post-bound comment automation
+- keyword-triggered comment detection
+- optional public comment reply
+- optional DM lead magnet message
+- CRUD for comment automations
+- activation / pause control
+- automation logs
+- account-connect prompts for Instagram and Facebook
+
+The canonical API surface for that flow is `POST /api/v1/comment-automations` plus the related read, update, delete, and logs endpoints documented in the exported UI source.
+
+---
+
+## Validation Contract
+
+For this UI shell to be considered valid inside the worker kit:
+
+- the exported folder contains `studio/`
+- `studio/package.json` and `studio/vite.config.js` exist
+- the user can run `npm install` and `npm run dev` from the exported `studio/` folder
+- the UI can be configured with `VITE_ZERNIO_API_URL`, `VITE_ZERNIO_API_KEY`, and `VITE_ZERNIO_PROFILE_ID`
+- the UI shell remains isolated to the exported worker-kit workspace
+- no external paired UI kit is required for the Zernio kit's UI truth
+
+---
+
+## Non-Goals
+
+This document does not describe:
+
+- a main-app integration inside the CLI repo
+- a custom Agent Harness
+- a new adapter registry entry
+- a provider SDK install path
+
+Those are intentionally out of scope for this exported worker-kit UI shell.

package/assets/worker-kits/growthub-zernio-social-v1/docs/local-adapters.md

@@ -97,7 +97,7 @@ This installs Zernio's official Claude Code skill (docs + examples) alongside th
 | Simplest possible setup; agent-only mode included | Layer 1 (Working Directory) |
 | Typed tool calls from the agent to Zernio | Layer 1 + Layer 2 (MCP) |
 | First-class Zernio knowledge baked into Claude Code | Layer 1 + Layer 3 (Claude Code skill) |
-| Postiz UI shell with Zernio as the engine | See `docs/postiz-ui-shell-integration.md` |
+| Growthub Agentic Social Media Platform UI shell | See `docs/growthub-agentic-social-platform-ui-shell.md` |
 
 All four paths work from the same kit folder. You can layer them — they are strictly additive.
 
@@ -120,4 +120,4 @@ This keeps the diff surface minimal and the kit strictly reusable across every l
 - `../setup/setup.mjs` — cross-platform bootstrap
 - `../setup/install-mcp.mjs` — per-IDE MCP config printer
 - `./zernio-api-integration.md` — Zernio REST contract
-- `./postiz-ui-shell-integration.md` — pair the kit with the Postiz UI kit
+- `./growthub-agentic-social-platform-ui-shell.md` — exported-workspace UI shell guide

package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/README.md

@@ -27,7 +27,7 @@ The Growthub Zernio Social Media Studio is a worker kit that wraps the [Zernio](
 
 The kit provides a self-contained local execution environment. An operator exports the kit, points Claude Code's Working Directory at the kit root, and the `zernio-social-operator` worker handles the complete 10-step social media campaign workflow.
 
-Unlike the Postiz kit (self-hosted fork), Zernio is a hosted SaaS: there is no docker / fork to clone. The kit works against the hosted `https://zernio.com/api/v1` endpoint using an API key.
+Zernio is a hosted SaaS: there is no docker image or local fork to clone. The kit works against the hosted `https://zernio.com/api/v1` endpoint using an API key, and the exported `studio/` workspace is the user-facing UI shell.
 
 ---
 
@@ -37,7 +37,7 @@ Unlike the Postiz kit (self-hosted fork), Zernio is a hosted SaaS: there is no d
 growthub-zernio-social-v1/
   kit.json                              ← Kit manifest (schemaVersion: 2)
   QUICKSTART.md                         ← Setup guide
-  .env.example                          ← Environment template
+  .env.example                          ← Worker-kit environment template
   skills.md                             ← Master methodology doc (read at every session)
   output-standards.md                   ← Output naming, structure, quality bar
   runtime-assumptions.md                ← Frozen upstream assumptions
@@ -79,7 +79,7 @@ growthub-zernio-social-v1/
     platform-coverage.md
     ai-caption-layer.md
     posts-and-queues-layer.md
-    postiz-ui-shell-integration.md      ← Optional — pair with the Postiz UI kit
+    growthub-agentic-social-platform-ui-shell.md ← Exported UI-shell workflow and setup truth
     local-adapters.md                   ← Per-IDE matrix (Claude/Codex/Cursor/Gemini/OpenCode/…)
   growthub-meta/
     README.md                           ← This file
@@ -136,11 +136,8 @@ No server-side activation is required. The kit is fully self-contained.
 | `growthub-email-marketing-v1` | operator | Email marketing campaigns |
 | `growthub-open-higgsfield-studio-v1` | studio | AI video generation via Open Higgsfield |
 | `growthub-geo-seo-v1` | studio | GEO + SEO auditing |
-| `growthub-postiz-social-v1` | studio | Social media via self-hosted Postiz |
 | `growthub-zernio-social-v1` | studio | Social media via hosted Zernio REST API (this kit) |
 
-### Recommended Pairing — Social Media Stack
+### Exported Workspace Truth
 
-`growthub-postiz-social-v1` (UI shell) + `growthub-zernio-social-v1` (engine) form a first-class paired environment. Postiz provides calendar, compose, analytics shell, and team workspace. Zernio provides the 14-platform transport, queues, media, inbox, and analytics against a single bearer-token REST API — no per-platform OAuth dance, no regional secrets sprayed across the kit.
-
-See `docs/postiz-ui-shell-integration.md` in this kit for the 7-module bridge recipe.
+The exported worker kit is the only user-facing workspace. Inside that exported folder, `studio/` is the Vite UI shell and the rest of the kit provides the Zernio operator law, templates, setup scripts, and API contract. The CLI is responsible only for exporting this workspace cleanly.

package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/kit-standard.md

@@ -26,7 +26,7 @@ The following files must be present in every valid kit installation. Any missing
 | `output/README.md` | Output directory guide | No |
 | All 7 template files | Campaign output templates | No — each must have all sections |
 | All 4 example files | Reference samples | No — must contain realistic filled data |
-| All 4 doc files | Technical reference | No |
+| All 6 doc files | Technical reference | No |
 | `bundles/growthub-zernio-social-v1.json` | Bundle manifest | No |
 | `growthub-meta/README.md` | Kit metadata | No |
 | `growthub-meta/kit-standard.md` | This file | No |

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

@@ -24,6 +24,7 @@
   ],
   "frozenAssetPaths": [
     "QUICKSTART.md",
+    ".env.example",
     "skills.md",
     "output-standards.md",
     "runtime-assumptions.md",
@@ -53,8 +54,36 @@
     "docs/platform-coverage.md",
     "docs/ai-caption-layer.md",
     "docs/posts-and-queues-layer.md",
-    "docs/postiz-ui-shell-integration.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"
   ],
@@ -69,6 +98,7 @@
     "requiredPaths": [
       "QUICKSTART.md",
       "kit.json",
+      ".env.example",
       "bundles/growthub-zernio-social-v1.json",
       "skills.md",
       "workers/zernio-social-operator/CLAUDE.md",
@@ -78,6 +108,8 @@
       "setup/verify-env.mjs",
       "setup/check-deps.sh",
       "output/README.md",
+      "studio",
+      "studio/dist",
       "templates",
       "docs",
       "growthub-meta"

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

@@ -17,7 +17,7 @@
 | Platform coverage | `docs/platform-coverage.md` |
 | AI caption layer | `docs/ai-caption-layer.md` |
 | Posts + queues layer | `docs/posts-and-queues-layer.md` |
-| Postiz UI shell integration | `docs/postiz-ui-shell-integration.md` |
+| Growthub Agentic UI shell | `docs/growthub-agentic-social-platform-ui-shell.md` |
 | Social campaign brief | `templates/social-campaign-brief.md` |
 | Content calendar | `templates/content-calendar.md` |
 | Platform publishing plan | `templates/platform-publishing-plan.md` |

package/assets/worker-kits/growthub-zernio-social-v1/studio/.env.example

@@ -0,0 +1,3 @@
+VITE_ZERNIO_API_KEY=your_zernio_api_key_here
+VITE_ZERNIO_API_URL=https://zernio.com/api/v1
+VITE_ZERNIO_PROFILE_ID=