@growthub/cli 0.9.8 → 0.9.10

package/README.md

@@ -2,20 +2,38 @@
 
 `@growthub/cli` is the CLI control plane for Growthub Local.
 
-It helps you turn a repo, skill, starter, or kit into a governed local agent environment you can customize, keep current, and optionally activate with hosted authority.
+It creates governed **Workspaces** from any source — repo, skill, kit, template, or greenfield. The Workspace is the top-level product object; this CLI is the local executor that creates, customizes, and inspects them.
 
-## Install
+## Start here: create a governed Workspace
+
+Power-user one-liner that exports the official starter directly:
 
 ```bash
-npm install -g @growthub/cli
+npx -p @growthub/cli@latest growthub kit download growthub-custom-workspace-starter-v1 --out ./my-workspace
+```
+
+Or the guided installer:
+
+```bash
+npm create @growthub/growthub-local@latest
 ```
 
-Or start with the guided installer:
+After export, open the no-code Workspace Builder:
 
 ```bash
-npm create growthub-local@latest
+cd my-workspace/apps/workspace
+npm install
+npm run dev
 ```
 
+## Install (CLI only)
+
+```bash
+npm install -g @growthub/cli
+```
+
+Reference contracts: [Workspace Config Contract V1](../docs/WORKSPACE_CONFIG_CONTRACT_V1.md) · [Governed Workspace Topology V1](../docs/GOVERNED_WORKSPACE_TOPOLOGY_V1.md) · [Workspace Builder Runtime V1](../docs/WORKSPACE_BUILDER_RUNTIME_V1.md)
+
 ## Profile-first setup (recommended)
 
 The guided flow is profile-first before deeper harness/workflow choices:

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

@@ -33,9 +33,11 @@ subSkills: []
 mcpTools: []
 ---
 
-# Custom Workspace Starter — Baseline Primitive
+# Custom Workspace Starter — Baseline Primitive for the Governed Workspace product object
 
-Every Growthub governed workspace is materialised from this kit. The kit ships the `.growthub-fork/` contract (identity, policy, trace, optional authority) plus the six primitive layers Claude/Cursor/Codex agents operate against:
+The **Workspace** is the top-level Growthub Local product object. This kit is the official starter that bootstraps every governed Workspace; everything else (worker kits, templates, workflows, hosted agents, source imports) is an input to a Workspace.
+
+Every Growthub governed Workspace is materialised from this kit. The kit ships the `.growthub-fork/` contract (identity, policy, trace, optional authority), the `apps/workspace` no-code Workspace Builder, the validated `growthub.config.json` V1 contract, plus the six primitive layers Claude/Cursor/Codex agents operate against:
 
 1. **`SKILL.md`** — this file. Discovery entry + routing menu. Always loaded first; the full operator runbook (`skills.md`) is disclosed progressively when work begins.
 2. **`skills.md`** — the deep operator runbook. Everything the operator agent needs to actually customise the workspace. Unchanged from v1.
@@ -154,3 +156,7 @@ If a concrete MCP server is available for this fork, list its tool IDs in `mcpTo
 - `helpers/README.md` — helpers convention
 - `skills/README.md` — sub-skills convention
 - `workers/custom-workspace-operator/CLAUDE.md` — agent contract
+- `apps/workspace/` — the no-code Workspace Builder Next.js app (V1 runtime)
+- `apps/workspace/lib/workspace-schema.js` — Workspace Config Contract V1 (validator + grid invariants)
+- `apps/workspace/lib/workspace-config.js` — persistence adapter (filesystem / read-only / future database)
+- `growthub.config.json` — persisted Workspace Config (V1 reference instance)

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

@@ -1,14 +1,14 @@
 # Core adapter selectors
-AGENCY_PORTAL_DEPLOY_TARGET=vercel
-AGENCY_PORTAL_DATA_ADAPTER=provider-managed
-AGENCY_PORTAL_AUTH_ADAPTER=provider-managed
-AGENCY_PORTAL_PAYMENT_ADAPTER=none
+GROWTHUB_WORKSPACE_DEPLOY_TARGET=vercel
+GROWTHUB_WORKSPACE_DATA_ADAPTER=provider-managed
+GROWTHUB_WORKSPACE_AUTH_ADAPTER=provider-managed
+GROWTHUB_WORKSPACE_PAYMENT_ADAPTER=none
 
 # Integration mode
 # - growthub-bridge: hosted Growthub account authority
 # - byo-api-key: workspace-owned connection metadata
 # - static: local starter catalog only
-AGENCY_PORTAL_INTEGRATION_ADAPTER=growthub-bridge
+GROWTHUB_WORKSPACE_INTEGRATION_ADAPTER=growthub-bridge
 
 # Hosted bridge authority
 GROWTHUB_BRIDGE_BASE_URL=https://www.growthub.ai
@@ -19,11 +19,11 @@ GROWTHUB_BRIDGE_USER_ID=
 # Optional Windsor reporting lane.
 # Hybrid first boot: keep growthub-bridge authority and set WINDSOR_API_KEY
 # to mark Windsor AI + Google Sheets blended data connected locally.
-AGENCY_PORTAL_REPORTING_ADAPTER=windsor
+GROWTHUB_WORKSPACE_REPORTING_ADAPTER=windsor
 WINDSOR_API_KEY=
 
 # Optional BYO connection metadata
-AGENCY_PORTAL_BYO_CONNECTIONS_JSON=
+GROWTHUB_WORKSPACE_BYO_CONNECTIONS_JSON=
 
 # Optional payment/auth/database env selected by adapter values above
 DATABASE_URL=
@@ -38,4 +38,4 @@ PAYMENT_WEBHOOK_SECRET=
 
 # Optional app settings
 CRON_SECRET=
-PORTAL_USER_ID=
+GROWTHUB_WORKSPACE_USER_ID=

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

@@ -4,15 +4,15 @@ This app is the Vercel/serverless runtime payload for `growthub-workspace-starte
 
 It intentionally depends on adapter contracts:
 
-- `AGENCY_PORTAL_DATA_ADAPTER`
-- `AGENCY_PORTAL_AUTH_ADAPTER`
-- `AGENCY_PORTAL_PAYMENT_ADAPTER`
-- `AGENCY_PORTAL_INTEGRATION_ADAPTER`
+- `GROWTHUB_WORKSPACE_DATA_ADAPTER`
+- `GROWTHUB_WORKSPACE_AUTH_ADAPTER`
+- `GROWTHUB_WORKSPACE_PAYMENT_ADAPTER`
+- `GROWTHUB_WORKSPACE_INTEGRATION_ADAPTER`
 - `GROWTHUB_BRIDGE_BASE_URL`
 - `GROWTHUB_BRIDGE_INTEGRATIONS_PATH`
 - `GROWTHUB_BRIDGE_ACCESS_TOKEN`
 - `GROWTHUB_BRIDGE_USER_ID`
-- `AGENCY_PORTAL_BYO_CONNECTIONS_JSON`
+- `GROWTHUB_WORKSPACE_BYO_CONNECTIONS_JSON`
 
 The Growthub local-first operator shell remains at `../../studio`.
 
@@ -21,9 +21,11 @@ Settings exposes two integration lanes:
 - Data sources: Windsor AI, Google Sheets blended data, Google Analytics, Shopify, Meta Facebook/Instagram.
 - Workspace integrations: Asana, Slack, GoHighLevel, Google Drive, Notion.
 
-Use `AGENCY_PORTAL_INTEGRATION_ADAPTER=growthub-bridge` when the deployed app should read connection state from the Growthub GH app MCP bridge. The reusable primitive is `lib/adapters/integrations/growthub-connection-normalizer.js`; it accepts SDK/profile-style `integrations[]` payloads and GH app MCP `accounts[]` payloads, then emits the same normalized object shape used by `byo-api-key`. Keep provider tokens in the hosted authority layer or named env vars; this app consumes normalized connection metadata only.
+The `/settings/integrations` page is part of the official governed workspace app shell. It uses the same light workspace rail, toolbar, and product object model as the dashboard workspace, and it renders Growthub bridge account state without redirecting to or borrowing the agency portal kit.
 
-For first boot, the bundled app also supports a hybrid path: keep `AGENCY_PORTAL_INTEGRATION_ADAPTER=growthub-bridge` and set `WINDSOR_API_KEY` locally. That overlays connected state for Windsor AI and Google Sheets blended data without moving the rest of the portal off the hosted bridge authority path.
+Use `GROWTHUB_WORKSPACE_INTEGRATION_ADAPTER=growthub-bridge` when the deployed app should read connection state from the Growthub GH app MCP bridge. The reusable primitive is `lib/adapters/integrations/growthub-connection-normalizer.js`; it accepts SDK/profile-style `integrations[]` payloads and GH app MCP `accounts[]` payloads, then emits the same normalized object shape used by `byo-api-key`. Keep provider tokens in the hosted authority layer or named env vars; this app consumes normalized connection metadata only.
+
+For first boot, the bundled app also supports a hybrid path: keep `GROWTHUB_WORKSPACE_INTEGRATION_ADAPTER=growthub-bridge` and set `WINDSOR_API_KEY` locally. That overlays connected state for Windsor AI and Google Sheets blended data without moving the rest of the workspace off the hosted bridge authority path.
 
 ## Run
 

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/settings/integrations/route.js

@@ -1,8 +1,8 @@
 import { NextResponse } from "next/server";
-import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/adapters/integrations";
+import { describeIntegrationAdapter, listGovernedWorkspaceIntegrations } from "@/lib/adapters/integrations";
 import { groupIntegrationsByLane } from "@/lib/domain/integrations";
 async function GET() {
-  const integrations = await listAgencyPortalIntegrations();
+  const integrations = await listGovernedWorkspaceIntegrations();
   return NextResponse.json({
     adapter: describeIntegrationAdapter(),
     ...groupIntegrationsByLane(integrations)

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/workspace/route.js

@@ -1,7 +1,7 @@
 import { NextResponse } from "next/server";
 import { describeAuthAdapter } from "@/lib/adapters/auth";
 import { readAdapterConfig } from "@/lib/adapters/env";
-import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/adapters/integrations";
+import { describeIntegrationAdapter, listGovernedWorkspaceIntegrations } from "@/lib/adapters/integrations";
 import { describePaymentAdapter } from "@/lib/adapters/payments";
 import { describePersistenceAdapter } from "@/lib/adapters/persistence";
 import { groupIntegrationsByLane } from "@/lib/domain/integrations";
@@ -15,7 +15,7 @@ import {
 const ALLOWED_PATCH_FIELDS = new Set(["dashboards", "widgetTypes", "canvas"]);
 
 async function GET() {
-  const integrations = await listAgencyPortalIntegrations();
+  const integrations = await listGovernedWorkspaceIntegrations();
   const config = readAdapterConfig();
   const adapters = {
     persistence: describePersistenceAdapter(),
@@ -72,8 +72,8 @@ async function PATCH(request) {
           error: "workspace config is read-only in this runtime",
           reason: error.message,
           adapter: error.adapter,
-          guidance:
-            "Edit growthub.config.json locally, or set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true on a writable runtime."
+          guidance: error.guidance
+            || "Edit growthub.config.json locally, or set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true on a writable runtime."
         },
         { status: 409 }
       );