@growthub/cli 0.9.3 → 0.9.5

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/growthub.config.json

@@ -0,0 +1,112 @@
+{
+  "id": "agency-portal-default",
+  "name": "Agency Portal Dashboard",
+  "description": "Default no-code composition shipped by growthub-agency-portal-starter-v1. It stitches the production portal capabilities catalog and Growthub MCP, BYO, and static integration lanes into a composable widget grid. Forks can edit ids, layouts, and bindings to tailor this composition to their governed workspace.",
+  "capabilities": [
+    "dashboard",
+    "clients",
+    "pipeline",
+    "content",
+    "tasks",
+    "finance",
+    "reports",
+    "metrics",
+    "client-results",
+    "operations",
+    "settings"
+  ],
+  "pipelines": [],
+  "integrations": [
+    "windsor-ai",
+    "google-sheets-blended-data",
+    "google-analytics",
+    "shopify",
+    "meta-ads"
+  ],
+  "canvas": {
+    "id": "agency-canvas",
+    "name": "Agency operating dashboard",
+    "scope": "workspace",
+    "layout": {
+      "columns": 12,
+      "rowHeight": 64,
+      "gap": 16,
+      "responsive": true
+    },
+    "widgets": [
+      {
+        "id": "mrr",
+        "kind": "chart-metric",
+        "title": "MRR",
+        "chart": "number",
+        "aggregate": "sum",
+        "slug": "agencyMetric",
+        "bindings": { "field": "mrr" },
+        "position": { "x": 0, "y": 0, "w": 3, "h": 2 }
+      },
+      {
+        "id": "pipeline-by-stage",
+        "kind": "chart-metric",
+        "title": "Pipeline by stage",
+        "chart": "bar",
+        "aggregate": "sum",
+        "slug": "opportunity",
+        "bindings": { "groupBy": "stage", "field": "value" },
+        "position": { "x": 3, "y": 0, "w": 6, "h": 4 }
+      },
+      {
+        "id": "client-health",
+        "kind": "fields",
+        "title": "Client health",
+        "slug": "client",
+        "bindings": { "fields": ["healthScore", "stage", "renewalDate"] },
+        "position": { "x": 9, "y": 0, "w": 3, "h": 2 }
+      },
+      {
+        "id": "windsor-status",
+        "kind": "integration-card",
+        "title": "Windsor AI",
+        "slug": "windsor-ai",
+        "bindings": { "lane": "data-source", "adapter": "growthub-bridge" },
+        "position": { "x": 0, "y": 2, "w": 3, "h": 2 }
+      },
+      {
+        "id": "open-tasks",
+        "kind": "table",
+        "title": "Open tasks",
+        "slug": "task",
+        "bindings": { "filters": [{ "field": "done", "op": "eq", "value": false }] },
+        "position": { "x": 9, "y": 2, "w": 3, "h": 2 }
+      },
+      {
+        "id": "agent-chat",
+        "kind": "chat-session",
+        "title": "Agent chat",
+        "position": { "x": 0, "y": 4, "w": 4, "h": 4 }
+      },
+      {
+        "id": "active-workflow",
+        "kind": "workflow-runner",
+        "title": "Active pipeline",
+        "position": { "x": 4, "y": 4, "w": 4, "h": 4 }
+      },
+      {
+        "id": "recent-artifacts",
+        "kind": "artifact-viewer",
+        "title": "Recent reports",
+        "mediaPreview": true,
+        "position": { "x": 8, "y": 4, "w": 4, "h": 4 }
+      }
+    ],
+    "bindings": {
+      "chatToCanvas": true,
+      "workflowOutputsToArtifacts": true,
+      "sessionContext": true,
+      "portalCapabilities": true
+    }
+  },
+  "provenance": {
+    "createdBy": "cli",
+    "note": "Shipped with growthub-agency-portal-starter-v1; safe to edit inside a governed fork and validate through the starter export smoke path."
+  }
+}

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "next build --webpack",
     "start": "next start",
     "lint": "next lint"
   },

package/assets/worker-kits/growthub-agency-portal-starter-v1/bundles/growthub-agency-portal-starter-v1.json

@@ -54,6 +54,7 @@
     "apps/agency-portal/package.json",
     "apps/agency-portal/package-lock.json",
     "apps/agency-portal/next.config.js",
+    "apps/agency-portal/growthub.config.json",
     "apps/agency-portal/app/settings/integrations/page.jsx",
     "apps/agency-portal/lib/adapters/env.js",
     "apps/agency-portal/lib/adapters/integrations/index.js",

package/assets/worker-kits/growthub-agency-portal-starter-v1/kit.json

@@ -71,6 +71,7 @@
     "apps/agency-portal/next.config.js",
     "apps/agency-portal/postcss.config.mjs",
     "apps/agency-portal/vercel.json",
+    "apps/agency-portal/growthub.config.json",
     "apps/agency-portal/app/layout.jsx",
     "apps/agency-portal/app/page.jsx",
     "apps/agency-portal/app/globals.css",
@@ -118,6 +119,7 @@
       "apps/agency-portal",
       "apps/agency-portal/package-lock.json",
       "apps/agency-portal/next.config.js",
+      "apps/agency-portal/growthub.config.json",
       "apps/agency-portal/lib/adapters",
       "templates",
       "templates/project.md",

package/assets/worker-kits/growthub-creative-video-pipeline-v1/apps/creative-video-pipeline/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "next build --webpack",
     "start": "next start",
     "lint": "next lint"
   },

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

@@ -19,7 +19,16 @@ selfEval:
     - Operator contract read before any material change.
   maxRetries: 3
   traceTo: .growthub-fork/trace.jsonl
-helpers: []
+helpers:
+  - path: helpers/propose-capability.mjs
+    verb: propose-capability
+    description: Propose a reusable capability from a pipeline run (self-improving feature).
+  - path: helpers/promote-capability.mjs
+    verb: promote-capability
+    description: Promote a capability proposal to the active library.
+  - path: helpers/check-self-improving-health.sh
+    verb: check-self-improving-health
+    description: Validate self-improving workspace primitives and proposal dirs.
 subSkills: []
 mcpTools: []
 ---
@@ -91,6 +100,31 @@ Helpers live under `helpers/`. When an existing shell snippet in `skills.md` is
 
 (None declared at the baseline; see `helpers/README.md` for the pattern.)
 
+## Self-improving feature (optional extension)
+
+Any governed workspace can activate the self-improving loop — no separate kit required.
+
+After a successful pipeline or orchestrator run, propose a reusable capability:
+
+```bash
+# Propose a capability from a run (anchors to trace.jsonl event)
+node helpers/propose-capability.mjs --from-run <run-id> --summary "what this run produced"
+# or directly:
+growthub workspace improve propose --from-run <run-id>
+
+# Review proposals
+growthub workspace improve list
+growthub workspace improve inspect <slug>
+growthub workspace improve promote <slug>
+
+# Health check (includes self-improving feature checks)
+bash helpers/check-self-improving-health.sh
+```
+
+Proposals are governed writes to `.growthub-fork/capabilities/proposals/`. Every proposal references the originating `trace.jsonl` event by trace-event ID — no duplicated schema. Each lifecycle transition (`proposed → promoted | rejected`) appends a typed trace event (`capability_proposed`, `capability_promoted`, `capability_rejected`).
+
+This is an **optional feature extension** on the base governed workspace primitive, not a separate workspace type.
+
 ## MCP routing (optional)
 
 If a concrete MCP server is available for this fork, list its tool IDs in `mcpTools[]`. Growthub's baseline ships declarative-only routing vocabulary — the CLI does not run an MCP server at v1. This field lets future MCP integration light up additively without a breaking change.

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

@@ -0,0 +1,41 @@
+# 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
+
+# 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
+
+# Hosted bridge authority
+GROWTHUB_BRIDGE_BASE_URL=https://www.growthub.ai
+GROWTHUB_BRIDGE_INTEGRATIONS_PATH=/api/mcp/accounts
+GROWTHUB_BRIDGE_ACCESS_TOKEN=
+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
+WINDSOR_API_KEY=
+
+# Optional BYO connection metadata
+AGENCY_PORTAL_BYO_CONNECTIONS_JSON=
+
+# Optional payment/auth/database env selected by adapter values above
+DATABASE_URL=
+QSTASH_KV_REST_URL=
+QSTASH_KV_REST_TOKEN=
+AUTH_SECRET=
+AUTH_ISSUER=
+AUTH_CLIENT_ID=
+AUTH_CLIENT_SECRET=
+PAYMENT_SECRET_KEY=
+PAYMENT_WEBHOOK_SECRET=
+
+# Optional app settings
+CRON_SECRET=
+PORTAL_USER_ID=

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

@@ -0,0 +1,38 @@
+# Growthub Workspace App
+
+This app is the Vercel/serverless runtime payload for `growthub-workspace-starter-v1`.
+
+It intentionally depends on adapter contracts:
+
+- `AGENCY_PORTAL_DATA_ADAPTER`
+- `AGENCY_PORTAL_AUTH_ADAPTER`
+- `AGENCY_PORTAL_PAYMENT_ADAPTER`
+- `AGENCY_PORTAL_INTEGRATION_ADAPTER`
+- `GROWTHUB_BRIDGE_BASE_URL`
+- `GROWTHUB_BRIDGE_INTEGRATIONS_PATH`
+- `GROWTHUB_BRIDGE_ACCESS_TOKEN`
+- `GROWTHUB_BRIDGE_USER_ID`
+- `AGENCY_PORTAL_BYO_CONNECTIONS_JSON`
+
+The Growthub local-first operator shell remains at `../../studio`.
+
+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.
+
+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.
+
+## Run
+
+```bash
+npm install
+npm run dev
+npm run build
+```
+
+## Deploy
+
+Use this directory as the Vercel project root.

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

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

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

@@ -0,0 +1,91 @@
+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 { describePaymentAdapter } from "@/lib/adapters/payments";
+import { describePersistenceAdapter } from "@/lib/adapters/persistence";
+import { groupIntegrationsByLane } from "@/lib/domain/integrations";
+import { buildPortalWorkspace, portalCapabilities } from "@/lib/domain/portal";
+import {
+  describePersistenceMode,
+  readWorkspaceConfig,
+  writeWorkspaceConfig
+} from "@/lib/workspace-config";
+
+const ALLOWED_PATCH_FIELDS = new Set(["dashboards", "widgetTypes", "canvas"]);
+
+async function GET() {
+  const integrations = await listAgencyPortalIntegrations();
+  const config = readAdapterConfig();
+  const adapters = {
+    persistence: describePersistenceAdapter(),
+    auth: describeAuthAdapter(),
+    payments: describePaymentAdapter(),
+    integrations: describeIntegrationAdapter()
+  };
+  const settings = {
+    integrations: groupIntegrationsByLane(integrations)
+  };
+  const workspaceConfig = await readWorkspaceConfig();
+  const persistence = describePersistenceMode();
+  return NextResponse.json({
+    config,
+    adapters,
+    capabilities: portalCapabilities,
+    settings,
+    workspace: buildPortalWorkspace({ config, adapters, integrations: settings.integrations }),
+    workspaceConfig,
+    workspaceConfigPersistence: persistence
+  });
+}
+
+async function PATCH(request) {
+  let patch;
+  try {
+    patch = await request.json();
+  } catch {
+    return NextResponse.json({ error: "invalid json body" }, { status: 400 });
+  }
+  if (!patch || typeof patch !== "object" || Array.isArray(patch)) {
+    return NextResponse.json({ error: "patch must be a plain object" }, { status: 400 });
+  }
+  const unknown = Object.keys(patch).filter((key) => !ALLOWED_PATCH_FIELDS.has(key));
+  if (unknown.length) {
+    return NextResponse.json(
+      { error: "patch contains unknown fields", details: unknown, allowed: Array.from(ALLOWED_PATCH_FIELDS) },
+      { status: 400 }
+    );
+  }
+  const sanitized = {};
+  for (const key of ALLOWED_PATCH_FIELDS) {
+    if (Object.prototype.hasOwnProperty.call(patch, key)) {
+      sanitized[key] = patch[key];
+    }
+  }
+  try {
+    const next = await writeWorkspaceConfig(sanitized);
+    return NextResponse.json({ workspaceConfig: next });
+  } catch (error) {
+    if (error.code === "WORKSPACE_PERSISTENCE_READ_ONLY") {
+      return NextResponse.json(
+        {
+          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."
+        },
+        { status: 409 }
+      );
+    }
+    if (error.code === "WORKSPACE_PERSISTENCE_PATH_REFUSED") {
+      return NextResponse.json({ error: error.message }, { status: 500 });
+    }
+    if (error.code === "INVALID_WORKSPACE_CONFIG") {
+      return NextResponse.json({ error: error.message, details: error.details }, { status: 400 });
+    }
+    return NextResponse.json({ error: error.message || "failed to write workspace config" }, { status: 500 });
+  }
+}
+
+export { GET, PATCH };