@growthub/cli 0.3.60 → 0.4.1

package/assets/worker-kits/growthub-custom-workspace-starter-v1/.env.example

@@ -0,0 +1,10 @@
+# Growthub Custom Workspace Starter Kit — environment template
+#
+# The starter ships with zero required env vars. Copy this file to `.env`
+# (which is unconditionally preserved by the Self-Healing Fork Sync Agent
+# via USER_PROTECTED_PATTERNS) and add whatever your workspace needs.
+#
+# Optional overrides honoured by the CLI (not the starter):
+#   GROWTHUB_KIT_FORKS_HOME=~/.growthub/kit-forks
+#   GROWTHUB_GITHUB_HOME=~/.growthub/github
+#   GROWTHUB_GITHUB_CLIENT_ID=<your-oauth-app-client-id>

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

@@ -0,0 +1,44 @@
+# Growthub Custom Workspace Starter Kit — Quickstart
+
+This kit is the canonical v1 starter primitive. Run `growthub starter init --name <workspace> --out <path>` and the CLI will:
+
+1. Materialize this bundled asset tree at `<path>`.
+2. Auto-register the directory as a kit-fork with a dedicated `forkId`, writing `<path>/.growthub-fork/fork.json` (canonical self-describing state).
+3. Optionally create a GitHub remote with `growthub kit fork create --upstream <owner/repo>` flow.
+4. Seed a conservative `policy.json` (`autoApprove=additive`, `remoteSyncMode=off` by default).
+5. Append a `registered` + `remote_connected` trace event.
+
+After that, every customization you make stays yours — the Self-Healing Fork Sync Agent will propose upstream additions non-destructively, honouring your policy.
+
+## Run the bundled Vite UI shell
+
+```bash
+cd studio
+npm install
+npm run dev          # local dev server
+npm run build        # produces studio/dist
+node serve.mjs       # serves the built shell
+```
+
+## Build out the agent contract
+
+Edit `workers/custom-workspace-operator/CLAUDE.md`. This is the living contract between the CLI agent and your workspace. Add tools, skills, and output rules here.
+
+## Healing from upstream
+
+```bash
+growthub kit fork status <fork-id>
+growthub kit fork heal <fork-id> --dry-run
+growthub kit fork heal <fork-id>
+growthub kit fork trace --fork-id <fork-id> --tail 50
+```
+
+## Policy primer
+
+```bash
+growthub kit fork policy --fork-id <fork-id> --set \
+  autoApprove=additive \
+  untouchablePaths+=studio/src/views/MyFeature.jsx \
+  confirmBeforeChange+=workers/custom-workspace-operator/CLAUDE.md \
+  remoteSyncMode=pr
+```

package/assets/worker-kits/growthub-custom-workspace-starter-v1/brands/NEW-CLIENT.md

@@ -0,0 +1,10 @@
+# New Client — Onboarding
+
+When the operator starts a new project:
+
+1. Create `brands/<client-slug>/brand-kit.md` from the `_template` scaffold.
+2. Fill in the Identity, Voice, Visual, Assets sections.
+3. Append a `registered` event to `.growthub-fork/trace.jsonl` with `{clientSlug}` in the detail.
+4. Run `growthub kit fork status <fork-id>` to confirm no drift was introduced.
+
+The `_template/` brand is upstream-owned; all real client work lives under `brands/<client-slug>/`.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/brands/_template/brand-kit.md

@@ -0,0 +1,27 @@
+# Brand Kit — Template
+
+Copy this template to `brands/<slug>/brand-kit.md` and fill in the fields.
+
+## Identity
+
+- Display name:
+- Slug:
+- Tagline:
+
+## Voice
+
+- Tone:
+- Vocabulary:
+- Anti-patterns to avoid:
+
+## Visual
+
+- Primary colour:
+- Secondary colour:
+- Typography pairing:
+
+## Assets
+
+- Logo URL:
+- Favicon URL:
+- Open Graph image URL:

package/assets/worker-kits/growthub-custom-workspace-starter-v1/brands/growthub/brand-kit.md

@@ -0,0 +1,25 @@
+# Growthub — Reference Brand Kit
+
+A worked example of a fully-populated brand kit. The `growthub/` brand is owned by upstream — if you want to customize, create your own brand under `brands/<your-slug>/brand-kit.md`.
+
+## Identity
+
+- Display name: Growthub
+- Slug: growthub
+- Tagline: Local DX and GTM runtime for AI-native teams.
+
+## Voice
+
+- Tone: Direct, technical, no filler.
+- Vocabulary: "Worker kit", "custom workspace", "kernel packet", "fork-sync", "heal".
+- Anti-patterns: marketing fluff, redundant adjectives, overpromising.
+
+## Visual
+
+- Primary colour: #0a0a0a
+- Secondary colour: #4ade80
+- Typography: Inter for UI, JetBrains Mono for code.
+
+## Assets
+
+- See `ui/public/` in the main repository.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/bundles/growthub-custom-workspace-starter-v1.json

@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 2,
+  "bundle": {
+    "id": "growthub-custom-workspace-starter-v1",
+    "version": "1.0.0",
+    "kitId": "growthub-custom-workspace-starter-v1",
+    "workerId": "custom-workspace-operator"
+  },
+  "briefType": "custom-workspace-starter",
+  "capabilityType": "worker",
+  "executionMode": "export",
+  "activationModes": ["export"],
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "requiredFrozenAssets": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/custom-workspace-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/workspace-brief.md",
+    "templates/agent-contract.md",
+    "templates/deployment-plan.md",
+    "examples/workspace-sample.md",
+    "docs/starter-kit-overview.md",
+    "docs/fork-sync-integration.md",
+    "docs/vite-ui-shell-guide.md",
+    "studio/index.html",
+    "studio/package.json",
+    "studio/vite.config.js",
+    "studio/serve.mjs",
+    "studio/src/main.jsx",
+    "studio/src/App.jsx",
+    "studio/src/app.css",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ]
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/docs/fork-sync-integration.md

@@ -0,0 +1,32 @@
+# Starter Kit — Fork Sync Integration
+
+The starter kit is the first bundled worker kit that is both a **template** and a **native consumer** of the Self-Healing Fork Sync Agent.
+
+## What the starter registers for you
+
+On `growthub starter init` the CLI:
+
+1. Materializes the bundled tree to `<out>` via `copyBundledKitSource`.
+2. Calls `registerKitFork({ forkPath, kitId, baseVersion })` — writes `<out>/.growthub-fork/fork.json` and appends an entry to the CLI-owned discovery index at `GROWTHUB_KIT_FORKS_HOME/index.json`.
+3. Seeds `<out>/.growthub-fork/policy.json` with conservative defaults (`autoApprove=additive`, `remoteSyncMode=off`, `interactiveConflicts=true`).
+4. Appends a `registered` event to `<out>/.growthub-fork/trace.jsonl`.
+5. Optionally binds a GitHub remote via `growthub kit fork create --upstream <owner/repo>` or `growthub kit fork connect --remote <owner/repo>`.
+
+## What you never have to do manually
+
+- Generate a forkId.
+- Write the initial policy.json.
+- Ensure `.growthub-fork/` is present and well-formed.
+- Add the fork to the discovery index.
+
+## When upstream ships a new version
+
+Exactly the same flow as every other kit-fork:
+
+```
+growthub kit fork status <fork-id>
+growthub kit fork heal <fork-id> --dry-run
+growthub kit fork heal <fork-id>
+```
+
+The heal plan honours your `policy.json`. User-modified files, `policy.untouchablePaths`, and `CUSTOM_SKILL_PATTERNS` are never overwritten.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/docs/starter-kit-overview.md

@@ -0,0 +1,26 @@
+# Starter Kit — Overview
+
+The Growthub Custom Workspace Starter Kit is the canonical v1 primitive for forking a single worker kit without the rest of the repository. It combines:
+
+1. **Bundled asset tree** — the full custom-workspace kernel-packet surface (kit.json, frozen assets, brand scaffolds, setup, templates, examples, docs, growthub-meta).
+2. **Vite-bundled UI shell** — a minimal React + Vite 5 studio at `studio/` that users extend with their own views.
+3. **First-class Self-Healing Fork Sync Agent wiring** — `growthub starter init` materializes this tree at a user-chosen path and auto-registers it as a kit-fork with a dedicated `forkId`.
+
+## Why a dedicated primitive
+
+Users who want to customize one worker kit shouldn't have to fork the whole `growthub-local` repository. The starter kit gives them:
+
+- A clean, empty workspace that still satisfies every custom-workspace kernel invariant.
+- An auto-registered fork with policy, trace, and (optionally) a GitHub remote.
+- A guaranteed upgrade path back to upstream via the Self-Healing Fork Sync Agent.
+
+## End-to-end flow
+
+```
+growthub starter init --name my-workspace --out ./my-workspace
+  └→ copyBundledKitSource('growthub-custom-workspace-starter-v1', './my-workspace')
+  └→ registerKitFork({ forkPath: './my-workspace', kitId: '...', baseVersion: '1.0.0' })
+  └→ writeKitForkPolicy(forkPath, default)
+  └→ appendKitForkTraceEvent(forkPath, 'registered')
+  └→ (optional) growthub kit fork create --upstream owner/repo  → GitHub remote
+```

package/assets/worker-kits/growthub-custom-workspace-starter-v1/docs/vite-ui-shell-guide.md

@@ -0,0 +1,24 @@
+# Starter Kit — Vite UI Shell Guide
+
+The `studio/` directory ships a minimal Vite 5 + React 18 shell. It is intentionally tiny — a single `App.jsx` view that introspects the fork state.
+
+## Extend it
+
+Add views under `studio/src/views/<Name>.jsx`. Import them in `App.jsx`. Vite's hot-module-replacement handles the dev loop; the Self-Healing Fork Sync Agent treats any file you add under `studio/src/` as user-authored (it may still update upstream-owned files in `studio/src/` — protect yours via `policy.untouchablePaths`).
+
+## Build + serve
+
+```bash
+cd studio
+npm install
+npm run dev          # dev server
+npm run build        # production build -> studio/dist
+node serve.mjs       # serve studio/dist on localhost
+```
+
+## Why Vite, not Next.js
+
+- Zero server coupling — a static `dist/` directory ships anywhere.
+- Fast dev loop (HMR).
+- No vendor lock-in at the framework level.
+- Mirrors the pattern already in production for `growthub-zernio-social-v1`.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/examples/workspace-sample.md

@@ -0,0 +1,10 @@
+# Workspace Sample — Reference Output
+
+A worked example of the artifact shape a finished workspace produces. Use this as a comparison benchmark when validating a custom workspace run.
+
+- Client: growthub
+- Project slug: starter-reference
+- Goals: (1) demonstrate the starter contract; (2) validate fork-sync wiring; (3) produce a minimal but complete workspace tree
+- First heal checkpoint: `status_ran` at registration, overall severity = none.
+
+See `output/growthub/starter-reference/` after running the starter init + first heal.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/growthub-meta/README.md

@@ -0,0 +1,3 @@
+# growthub-meta
+
+Upstream-owned metadata that travels with the starter kit. Do not edit these files in a fork — the Self-Healing Fork Sync Agent flags them for confirmation on every heal and generally wants them aligned with upstream.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,10 @@
+# Kit Standard
+
+This starter is a custom-workspace worker kit with:
+
+- `schemaVersion: 2` in `kit.json`
+- `family: "studio"`
+- `executionMode: "export"`
+- `activationModes: ["export"]`
+
+Every bundled worker kit under `cli/assets/worker-kits/` conforms to the same shape. See `docs/kernel-packets/KERNEL_PACKET_CUSTOM_WORKSPACES.md` for the full invariant list.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/kit.json

@@ -0,0 +1,101 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-custom-workspace-starter-v1",
+    "version": "1.0.0",
+    "name": "Growthub Custom Workspace Starter Kit",
+    "description": "Canonical v1 starter primitive for a Growthub custom workspace worker kit. Ships a minimal Vite-bundled UI shell, a worker agent contract, the full custom-workspace kernel-packet asset surface, and first-class wiring into the Self-Healing Fork Sync Agent. Users can fork just this one kit without the rest of the repository and the CLI will register the new directory as a self-describing fork with a dedicated forkId, honouring every v1 policy, trace, and remote-sync invariant.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "custom-workspace-operator",
+    "path": "workers/custom-workspace-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "custom-workspace-operator"
+  ],
+  "agentContractPath": "workers/custom-workspace-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/custom-workspace-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/workspace-brief.md",
+    "templates/agent-contract.md",
+    "templates/deployment-plan.md",
+    "examples/workspace-sample.md",
+    "docs/starter-kit-overview.md",
+    "docs/fork-sync-integration.md",
+    "docs/vite-ui-shell-guide.md",
+    "studio/index.html",
+    "studio/package.json",
+    "studio/vite.config.js",
+    "studio/serve.mjs",
+    "studio/src/main.jsx",
+    "studio/src/App.jsx",
+    "studio/src/app.css",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Fork the starter kit directly with `growthub starter init` — the CLI materializes this bundled asset tree to the user's chosen path, auto-registers the destination as a kit-fork (canonical state under `<forkPath>/.growthub-fork/fork.json`), optionally binds it to a GitHub remote, and hands off the forkId. Every downstream customization flows through the v1 Self-Healing Fork Sync Agent.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      "kit.json",
+      ".env.example",
+      "bundles/growthub-custom-workspace-starter-v1.json",
+      "skills.md",
+      "workers/custom-workspace-operator/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/growthub/brand-kit.md",
+      "brands/NEW-CLIENT.md",
+      "setup/verify-env.mjs",
+      "setup/check-deps.sh",
+      "output/README.md",
+      "studio",
+      "templates",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-custom-workspace-starter-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-custom-workspace-starter-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.4.0"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-16T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/output/README.md

@@ -0,0 +1,3 @@
+# Output Directory
+
+All artifacts produced for a given project land here at `output/<client-slug>/<project-slug>/`. This directory is intentionally empty in the starter; the agent will create the first sub-folder on its first run.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/output-standards.md

@@ -0,0 +1,11 @@
+# Starter Kit — Output Standards
+
+All generated artifacts write to `output/<client-slug>/<project-slug>/`.
+
+Required artifacts per project:
+
+- `workspace-brief.md` — the user-supplied brief (or a generated one)
+- `deployment-plan.md` — machine-readable and human-reviewable
+- `trace-summary.md` — distilled view of `.growthub-fork/trace.jsonl` for the run
+
+Machine-readable outputs must be shape-compatible with the `growthub-custom-workspace-starter-v1` bundle descriptor.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/runtime-assumptions.md

@@ -0,0 +1,8 @@
+# Starter Kit — Runtime Assumptions
+
+- **Node**: >= v20 (the Growthub CLI ships `resolveCliVersion()` which is tested against the same minimum).
+- **Git**: required on PATH for fork-sync remote operations.
+- **Vite**: `studio/` uses Vite 5 + React 18; any compatible toolchain is fine.
+- **Fork registration**: the CLI expects `<forkPath>/.growthub-fork/fork.json` to exist and be readable. Do not commit this file to version control if you are publishing your fork — `.growthub-fork/` is developer-local state and should be added to `.gitignore`.
+- **Policy defaults**: `autoApprove=additive`, `autoApproveDepUpdates=additive`, `remoteSyncMode=off`, `interactiveConflicts=true`.
+- **Bundled sources**: everything under `frozenAssetPaths` in `kit.json` is upstream-owned. Modify at your own risk — the Self-Healing Fork Sync Agent flags every change there for confirmation.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/setup/check-deps.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Starter kit — dependency check. Verifies the local runtime is ready.
+set -euo pipefail
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+missing=0
+for cmd in node npm git; do
+  if ! have "$cmd"; then
+    echo "  [check-deps] MISSING: $cmd"
+    missing=1
+  else
+    echo "  [check-deps] ok: $cmd ($(command -v "$cmd"))"
+  fi
+done
+
+if [ "$missing" -ne 0 ]; then
+  exit 1
+fi
+echo "  [check-deps] All prerequisites satisfied."

package/assets/worker-kits/growthub-custom-workspace-starter-v1/setup/verify-env.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Starter kit — env verification.
+// Prints a readiness report; exits non-zero if critical env is missing.
+import process from "node:process";
+
+const required = []; // starter ships with zero required env — add as the workspace grows
+const optional = ["GROWTHUB_KIT_FORKS_HOME", "GROWTHUB_GITHUB_HOME"];
+
+let errors = 0;
+for (const key of required) {
+  if (!process.env[key]) {
+    console.error(`[verify-env] missing required env: ${key}`);
+    errors += 1;
+  }
+}
+for (const key of optional) {
+  const v = process.env[key];
+  console.log(`[verify-env] ${key} = ${v ? v : "(unset — default path applies)"}`);
+}
+process.exit(errors > 0 ? 1 : 0);

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

@@ -0,0 +1,14 @@
+# Starter Kit — Skills
+
+This file catalogues the skills the Custom Workspace Operator offers out of the box. Add your own under `skills/custom/` — those paths are unconditionally preserved across every heal.
+
+## Built-in skills (upstream-owned, heal will update)
+
+- **scaffold-view** — generate a new Vite view under `studio/src/views/<Name>.jsx`
+- **scaffold-api** — stub an API adapter under `studio/src/api/<slug>.js`
+- **emit-brand-scaffold** — clone `brands/_template/brand-kit.md` to `brands/<slug>/brand-kit.md`
+- **trace-inspect** — summarise the last N events in `.growthub-fork/trace.jsonl`
+
+## User-authored skills (never touched by heal)
+
+Create any markdown file under `skills/custom/` or `custom-skills/`. The agent will discover them at runtime but the Self-Healing Fork Sync Agent will never modify them.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Growthub Custom Workspace Starter</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "growthub-custom-workspace-starter-studio",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "serve": "node serve.mjs"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.1",
+    "vite": "^5.4.2"
+  }
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/serve.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// Minimal static server for the built Vite shell.
+// Usage: node serve.mjs [--port 5180]
+import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DIST = path.resolve(__dirname, "dist");
+const PORT = Number(process.env.PORT ?? 5180);
+
+const mime = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".json": "application/json; charset=utf-8",
+};
+
+function serve(req, res) {
+  const url = decodeURIComponent(req.url?.split("?")[0] ?? "/");
+  const file = url === "/" ? "/index.html" : url;
+  const full = path.resolve(DIST, "." + file);
+  if (!full.startsWith(DIST)) { res.statusCode = 403; res.end("Forbidden"); return; }
+  fs.readFile(full, (err, buf) => {
+    if (err) {
+      // SPA fallback
+      fs.readFile(path.resolve(DIST, "index.html"), (err2, fallback) => {
+        if (err2) { res.statusCode = 404; res.end("Not found"); return; }
+        res.setHeader("Content-Type", mime[".html"]); res.end(fallback);
+      });
+      return;
+    }
+    res.setHeader("Content-Type", mime[path.extname(full)] ?? "application/octet-stream");
+    res.end(buf);
+  });
+}
+
+http.createServer(serve).listen(PORT, () => {
+  console.log(`[starter-studio] serving ${DIST} on http://localhost:${PORT}`);
+});

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/src/App.jsx

@@ -0,0 +1,32 @@
+import React from "react";
+
+export default function App() {
+  return (
+    <main className="starter">
+      <header className="starter-header">
+        <h1>Growthub Custom Workspace Starter</h1>
+        <p className="starter-subtitle">
+          A Vite + React shell wired to the Self-Healing Fork Sync Agent.
+        </p>
+      </header>
+      <section className="starter-grid">
+        <Card title="kit.json" body="Schema v2 — family: studio." />
+        <Card title=".growthub-fork/" body="fork.json · policy.json · trace.jsonl · jobs/" />
+        <Card title="workers/" body="custom-workspace-operator — the agent contract." />
+        <Card title="studio/" body="This shell. Extend src/views/ with your own React." />
+      </section>
+      <footer className="starter-footer">
+        Next:&nbsp;<code>growthub kit fork status &lt;fork-id&gt;</code>
+      </footer>
+    </main>
+  );
+}
+
+function Card({ title, body }) {
+  return (
+    <article className="starter-card">
+      <h2>{title}</h2>
+      <p>{body}</p>
+    </article>
+  );
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/src/app.css

@@ -0,0 +1,20 @@
+:root {
+  color-scheme: dark;
+  --fg: #eaeaea;
+  --fg-dim: #888;
+  --bg: #0a0a0a;
+  --accent: #4ade80;
+  --card: #141414;
+  --border: #222;
+}
+* { box-sizing: border-box; }
+body { margin: 0; font-family: Inter, system-ui, sans-serif; background: var(--bg); color: var(--fg); }
+.starter { max-width: 960px; margin: 0 auto; padding: 48px 24px; }
+.starter-header h1 { font-size: 2rem; margin: 0 0 8px; letter-spacing: -0.02em; }
+.starter-subtitle { color: var(--fg-dim); margin: 0 0 32px; }
+.starter-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 16px; }
+.starter-card { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 16px; }
+.starter-card h2 { font-size: 1rem; margin: 0 0 6px; color: var(--accent); font-family: JetBrains Mono, monospace; }
+.starter-card p { margin: 0; font-size: 0.9rem; color: var(--fg-dim); }
+.starter-footer { margin-top: 40px; color: var(--fg-dim); font-family: JetBrains Mono, monospace; font-size: 0.9rem; }
+.starter-footer code { background: var(--card); padding: 2px 6px; border-radius: 4px; }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/src/main.jsx

@@ -0,0 +1,10 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import App from "./App.jsx";
+import "./app.css";
+
+createRoot(document.getElementById("root")).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/assets/worker-kits/growthub-custom-workspace-starter-v1/studio/vite.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: { port: 5180 },
+  build: { outDir: "dist", emptyOutDir: true },
+});

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

@@ -0,0 +1,9 @@
+# Agent Contract — Template
+
+Used when layering a custom agent on top of this workspace. Keep this narrow — the Self-Healing Fork Sync Agent enforces the broader contract; this template is for workspace-specific rules.
+
+- Agent ID:
+- Scope (which files it may read / write):
+- Tools it may invoke:
+- Escalation policy (when to pause for user confirmation):
+- Trace requirements (which events must be appended):

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthub/cli",
-  "version": "0.3.60",
+  "version": "0.4.1",
   "description": "Growthub CLI — orchestrate AI agent teams to run a business",
   "type": "module",
   "bin": {