@growthub/cli 0.3.60 → 0.4.2

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/`.