@growthub/cli 0.9.1 → 0.9.3

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

@@ -1,25 +1,41 @@
-# ── Supabase ──────────────────────────────────────────────────────────────────
-# Get these from: https://supabase.com/dashboard → your project → Settings → API
-NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
+# 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
 
-# Service role key — used only in server-side API routes (keep secret, never commit)
-# Get from: Settings → API → service_role key
-SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here
+# 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
 
-# ── Windsor AI (optional — only needed for the automated report engine) ────────
-# Get from: https://windsor.ai → Settings → API Key
-WINDSOR_API_KEY=your-windsor-api-key-here
+# 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=
 
-# ── Cron / Automation (optional) ─────────────────────────────────────────────
-# A random secret you generate — used to authenticate the /api/reports/generate endpoint
-# Generate one: openssl rand -hex 32
-CRON_SECRET=your-random-secret-here
+# 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=
 
-# The Supabase user ID of the portal owner (used by the cron report job)
-# Find it in: Supabase Dashboard → Authentication → Users
-PORTAL_USER_ID=your-supabase-user-uuid-here
+# Optional BYO connection metadata
+AGENCY_PORTAL_BYO_CONNECTIONS_JSON=
 
-# ── Agency settings ───────────────────────────────────────────────────────────
-# Monthly revenue target shown on the dashboard (in your local currency)
-NEXT_PUBLIC_REVENUE_TARGET=10000
+# 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-agency-portal-starter-v1/apps/agency-portal/README.md

@@ -23,6 +23,8 @@ Settings exposes two integration lanes:
 
 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

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

@@ -5,21 +5,25 @@ import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/
 import { describePaymentAdapter } from "@/lib/adapters/payments";
 import { describePersistenceAdapter } from "@/lib/adapters/persistence";
 import { groupIntegrationsByLane } from "@/lib/domain/integrations";
-import { portalCapabilities } from "@/lib/domain/portal";
+import { buildPortalWorkspace, portalCapabilities } from "@/lib/domain/portal";
 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)
+  };
   return NextResponse.json({
-    config: readAdapterConfig(),
-    adapters: {
-      persistence: describePersistenceAdapter(),
-      auth: describeAuthAdapter(),
-      payments: describePaymentAdapter(),
-      integrations: describeIntegrationAdapter()
-    },
+    config,
+    adapters,
     capabilities: portalCapabilities,
-    settings: {
-      integrations: groupIntegrationsByLane(integrations)
-    }
+    settings,
+    workspace: buildPortalWorkspace({ config, adapters, integrations: settings.integrations })
   });
 }
 export {

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/app/globals.css

@@ -119,6 +119,135 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 }
 .page-heading p { max-width: 780px; margin: 0 0 12px; }
 .eyebrow { color: var(--accent); font-size: 12px; font-weight: 800; text-transform: uppercase; letter-spacing: 0.12em; }
+.workspace-header { margin-bottom: 18px; }
+.primitive-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
+  margin-bottom: 16px;
+}
+.primitive-grid.adapter { grid-template-columns: repeat(6, minmax(0, 1fr)); }
+.primitive-card, .capability-primitive, .contract-panel a {
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  background: rgba(17, 24, 39, 0.9);
+}
+.primitive-card { min-height: 158px; padding: 16px; }
+.primitive-card-top, .capability-heading {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 12px;
+}
+.primitive-card strong {
+  display: block;
+  margin-top: 16px;
+  font-size: clamp(20px, 3vw, 34px);
+  line-height: 1;
+  word-break: break-word;
+}
+.primitive-meta, .integration-bindings {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 7px;
+  margin-top: 16px;
+}
+.primitive-meta span, .primitive-meta code, .integration-bindings span, .binding-row code, .contract-panel code, .quick-actions code {
+  border: 1px solid var(--line);
+  border-radius: 999px;
+  padding: 4px 7px;
+  color: var(--muted);
+  background: #0d1420;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11px;
+}
+.capability-board { display: grid; gap: 16px; }
+.capability-primitive {
+  min-height: 252px;
+  padding: 18px;
+  scroll-margin-top: 20px;
+}
+.capability-primitive h2 { margin: 4px 0 0; font-size: 28px; }
+.binding-list { display: grid; gap: 8px; margin-top: 16px; }
+.binding-row {
+  display: grid;
+  grid-template-columns: minmax(90px, 0.8fr) minmax(0, 1fr) auto;
+  gap: 10px;
+  align-items: center;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 9px 10px;
+  background: #0d1420;
+}
+.binding-row span { color: var(--muted); font-size: 12px; }
+.binding-row strong { font-size: 13px; word-break: break-word; }
+.primitive-columns {
+  display: grid;
+  grid-template-columns: 1fr 0.7fr 1fr;
+  gap: 12px;
+  margin-top: 14px;
+}
+.primitive-stack {
+  display: grid;
+  align-content: start;
+  gap: 7px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 10px;
+  background: rgba(13, 20, 32, 0.82);
+}
+.primitive-stack > span {
+  color: var(--accent);
+  font-size: 11px;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.12em;
+}
+.primitive-stack div {
+  display: flex;
+  justify-content: space-between;
+  gap: 8px;
+  align-items: center;
+  border-top: 1px solid rgba(34, 48, 71, 0.65);
+  padding-top: 7px;
+}
+.primitive-stack strong {
+  min-width: 0;
+  font-size: 12px;
+  word-break: break-word;
+}
+.field-cloud {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 12px;
+}
+.field-cloud code {
+  border: 1px solid rgba(56, 189, 248, 0.28);
+  border-radius: 999px;
+  padding: 4px 7px;
+  color: #d7e8ff;
+  background: rgba(56, 189, 248, 0.08);
+  font-size: 11px;
+}
+.integration-bindings span {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+.contract-panel {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 12px;
+  margin-top: 16px;
+}
+.contract-panel a {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 14px;
+  text-decoration: none;
+}
 .hero-grid {
   display: grid;
   grid-template-columns: 1.2fr 0.9fr 0.9fr;
@@ -170,7 +299,7 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
   gap: 8px;
   width: 190px;
 }
-.quick-actions button {
+.quick-actions button, .quick-actions a {
   border: 1px solid var(--line);
   border-radius: 8px;
   padding: 10px 12px;
@@ -178,6 +307,7 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
   color: var(--ink);
   text-align: left;
   font: inherit;
+  text-decoration: none;
 }
 .integration-board { display: grid; gap: 14px; }
 .integration-toolbar { display: flex; justify-content: space-between; align-items: center; gap: 16px; padding: 14px 16px; }
@@ -211,6 +341,8 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 }
 .status.connected { color: var(--good); border-color: rgba(34, 197, 94, 0.45); background: rgba(34, 197, 94, 0.1); }
 .status.needs-connection { color: var(--warn); border-color: rgba(245, 158, 11, 0.5); background: rgba(245, 158, 11, 0.1); }
+.status.runtime-ready, .status.runtime-derived, .status.configured-by-env { color: var(--good); border-color: rgba(34, 197, 94, 0.45); background: rgba(34, 197, 94, 0.1); }
+.status.needs-runtime-config { color: var(--warn); border-color: rgba(245, 158, 11, 0.5); background: rgba(245, 158, 11, 0.1); }
 .integration-card-meta { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 12px; }
 .integration-card-meta span {
   border: 1px solid var(--line);
@@ -224,7 +356,7 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 @media (max-width: 1020px) {
   .shell { grid-template-columns: 1fr; }
   .sidebar { position: static; height: auto; }
-  .hero-grid, .grid, .adapter, .ops-strip, .setup-grid, .results-panel, .results-metrics { grid-template-columns: 1fr; }
+  .primitive-grid, .primitive-grid.adapter, .capability-board, .primitive-columns, .contract-panel, .hero-grid, .grid, .adapter, .ops-strip, .setup-grid, .results-panel, .results-metrics { grid-template-columns: 1fr; }
   .quick-actions { position: static; width: auto; margin: 20px 30px; }
 }
 

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/app/page.jsx

@@ -1,165 +1,159 @@
 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 { portalCapabilities } from "@/lib/domain/portal";
+import { groupIntegrationsByLane } from "@/lib/domain/integrations";
+import { buildPortalWorkspace } from "@/lib/domain/portal";
 import Link from "next/link";
-const nav = [
-  ...portalCapabilities.map((item) => ({ href: `#${item.id}`, label: item.label })),
-  { href: "/settings/integrations", label: "Integrations" }
-];
-const quickActions = [
-  "Client onboarding",
-  "Publish report",
-  "Sync Windsor data",
-  "Review open tasks"
-];
-function Home() {
+async function Home() {
   const config = readAdapterConfig();
-  const persistence = describePersistenceAdapter();
-  const auth = describeAuthAdapter();
-  const payments = describePaymentAdapter();
+  const integrations = groupIntegrationsByLane(await listAgencyPortalIntegrations());
+  const workspace = buildPortalWorkspace({
+    config,
+    integrations,
+    adapters: {
+      persistence: describePersistenceAdapter(),
+      auth: describeAuthAdapter(),
+      payments: describePaymentAdapter(),
+      integrations: describeIntegrationAdapter()
+    }
+  });
   return <main className="shell">
-      <aside className="sidebar">
-        <div className="brand">
-          <span className="brand-mark">GH</span>
-          <span>Agency Portal</span>
-        </div>
-        <nav className="nav">
-          {nav.map((item, index) => <Link className={index === 0 ? "active" : ""} href={item.href} key={item.href}>{item.label}</Link>)}
-        </nav>
-        <div className="sidebar-footer">
-          <span className="status-dot" />
-          Governed worker kit
-        </div>
-      </aside>
-
+      <PortalSidebar workspace={workspace} />
       <section className="main">
-        <div className="utility-bar">
-          <div>
-            <strong>Production workspace</strong>
-            <span>Local customization, Vercel deployment, bridge-ready integrations.</span>
-          </div>
-          <div className="utility-actions">
-            <Link href="/settings/integrations">Integrations</Link>
-            <span className="pill">v1 kit</span>
-          </div>
-        </div>
-
-        <div className="page-heading">
-          <div>
-            <p className="eyebrow">Growthub Local + Vercel</p>
-            <h1>Composable Agency Workspace</h1>
-            <p>
-              A production starter for agency portals with local-first Vite operation, Vercel
-              deployment, thin adapter contracts, Windsor data pipelines, and Growthub MCP
-              connection authority.
-            </p>
-          </div>
-          <span className="badge">deploy: {config.deployTarget}</span>
-        </div>
-
-        <section className="hero-grid" id="dashboard">
-          <article className="hero-card wide">
-            <p className="card-label">Monthly Revenue</p>
-            <strong>$0</strong>
-            <div className="progress"><span style={{ width: "0%" }} /></div>
-            <p className="muted">Connect persistence to populate invoices, retainers, and margin reporting.</p>
-          </article>
-          <article className="hero-card">
-            <p className="card-label">MCP Connections</p>
-            <strong>{config.integrationAdapter}</strong>
-            <p className="muted">Growthub bridge and BYO API key paths normalize into one object model.</p>
-          </article>
-          <article className="hero-card">
-            <p className="card-label">Client Results</p>
-            <strong>Windsor</strong>
-            <p className="muted">First-class Windsor AI and Google Sheets blended data pipeline support.</p>
-          </article>
-        </section>
-
-        <section className="ops-strip" aria-label="Setup paths">
-          <article>
-            <span>01</span>
-            <strong>Local Vite shell</strong>
-            <p>Use the same portal frame for agent-led local customization.</p>
-          </article>
-          <article>
-            <span>02</span>
-            <strong>Vercel app</strong>
-            <p>Deploy the Next app without binding persistence to a single provider.</p>
-          </article>
-          <article>
-            <span>03</span>
-            <strong>Growthub bridge</strong>
-            <p>Resolve hosted MCP accounts when the user connects Growthub authority.</p>
-          </article>
-          <article>
-            <span>04</span>
-            <strong>BYO keys</strong>
-            <p>Support Windsor and external provider keys through the same object contract.</p>
-          </article>
-        </section>
-
-        <section className="grid compact-grid">
-          {portalCapabilities.map((capability) => <article className="card" id={capability.id} key={capability.id}>
-              <h3>{capability.label}</h3>
-              <div className="metric">{capability.metric}</div>
-              <p>{capability.description}</p>
-            </article>)}
-        </section>
-
-        <section className="adapter" aria-label="Adapter contracts">
-          <article className="card">
-            <h3>Persistence</h3>
-            <p><strong>{persistence.label}</strong></p>
-            <p>Postgres, Qstash KV, or provider-managed.</p>
-          </article>
-          <article className="card">
-            <h3>Auth</h3>
-            <p><strong>{auth.id}</strong></p>
-            <p>{auth.requiredEnv.length ? auth.requiredEnv.join(", ") : "provider-defined"}</p>
-          </article>
-          <article className="card">
-            <h3>Payments</h3>
-            <p><strong>{payments.id}</strong></p>
-            <p>{payments.enabled ? "enabled" : "disabled"}</p>
-          </article>
-          <article className="card">
-            <h3>Integrations</h3>
-            <p><strong>{config.integrationAdapter}</strong></p>
-            <p><Link href="/settings/integrations">Open setup surface</Link></p>
-          </article>
-          <article className="card">
-            <h3>Worker API</h3>
-            <p><code>GET /api/workspace</code></p>
-            <p>Adapter and capability metadata for agents.</p>
-          </article>
-        </section>
-
-        <section className="results-panel" id="client-results">
-          <div>
-            <p className="eyebrow">Client Results</p>
-            <h2>Windsor AI + blended data ready</h2>
-            <p>
-              Windsor is a data pipeline object, not a database choice. Google Sheets blended
-              exports, GA4, Shopify, and Meta data stay composable through the integrations surface.
-            </p>
-          </div>
-          <div className="results-metrics">
-            <span>Meta</span>
-            <span>Shopify</span>
-            <span>GA4</span>
-            <span>Sheets</span>
-          </div>
-        </section>
+        <WorkspaceHeader workspace={workspace} />
+        <PrimitiveGrid id="dashboard" items={workspace.summary} variant="summary" />
+        <PrimitiveGrid items={workspace.adapters} variant="adapter" />
+        <CapabilityBoard capabilities={workspace.capabilities} />
+        <ContractPanel api={workspace.api} />
       </section>
-
       <aside className="quick-actions" aria-label="Quick actions">
-        {quickActions.map((action) => <button type="button" key={action}>{action}</button>)}
+        {workspace.actions.map((action) => <Link href={action.href} key={action.href}>
+            <span>{action.label}</span>
+            <code>{action.objectType}</code>
+          </Link>)}
       </aside>
     </main>;
 }
+function PortalSidebar({ workspace }) {
+  return <aside className="sidebar">
+      <div className="brand">
+        <span className="brand-mark">{workspace.identity.mark}</span>
+        <span>{workspace.identity.label}</span>
+      </div>
+      <nav className="nav">
+        {workspace.navigation.map((item, index) => <Link className={index === 0 ? "active" : ""} href={item.href} key={item.href}>{item.label}</Link>)}
+      </nav>
+      <div className="sidebar-footer">
+        <span className="status-dot" />
+        {workspace.identity.mode}
+      </div>
+    </aside>;
+}
+function WorkspaceHeader({ workspace }) {
+  return <header className="workspace-header">
+      <div className="utility-bar">
+        <div>
+          <strong>{workspace.identity.mode}</strong>
+          <span>{workspace.capabilities.length} capability primitives: {workspace.identity.primitiveContract}.</span>
+        </div>
+        <div className="utility-actions">
+          {workspace.api.map((item) => <Link href={item.href} key={item.href}>{item.method} {item.href}</Link>)}
+          <span className="pill">deploy: {workspace.identity.deployTarget}</span>
+        </div>
+      </div>
+      <div className="page-heading">
+        <p className="eyebrow">{workspace.identity.mode}</p>
+        <h1>{workspace.identity.label}</h1>
+        <p>{workspace.identity.primitiveContract}</p>
+      </div>
+    </header>;
+}
+function PrimitiveGrid({ id, items, variant }) {
+  return <section className={`primitive-grid ${variant}`} id={id} aria-label={variant}>
+      {items.map((item) => <PrimitiveCard item={item} key={item.id} />)}
+    </section>;
+}
+function PrimitiveCard({ item }) {
+  return <article className="primitive-card">
+      <div className="primitive-card-top">
+        <p className="card-label">{item.label}</p>
+        <span className={`status ${item.status}`}>{item.status}</span>
+      </div>
+      <strong>{item.value}</strong>
+      <div className="primitive-meta">
+        <span>{item.source}</span>
+        {item.env.map((key) => <code key={key}>{key}</code>)}
+      </div>
+    </article>;
+}
+function CapabilityBoard({ capabilities }) {
+  return <section className="capability-board" aria-label="Capability primitives">
+      {capabilities.map((capability) => <CapabilityPrimitive capability={capability} key={capability.id} />)}
+    </section>;
+}
+function CapabilityPrimitive({ capability }) {
+  return <article className="capability-primitive" id={capability.id}>
+      <div className="capability-heading">
+        <div>
+          <p className="eyebrow">{capability.objectType}</p>
+          <h2>{capability.label}</h2>
+        </div>
+        <span className={`status ${capability.status}`}>{capability.status}</span>
+      </div>
+      <div className="binding-list">
+        {capability.bindings.map((binding) => <div className="binding-row" key={binding.id}>
+            <span>{binding.label}</span>
+            <strong>{binding.value}</strong>
+            <code>{binding.source}</code>
+          </div>)}
+      </div>
+      <div className="primitive-columns">
+        <PrimitiveStack label="Objects" items={capability.objects.map((item) => ({
+    id: item.id,
+    label: item.label,
+    meta: `${item.fields.length} fields`
+  }))} />
+        <PrimitiveStack label="Views" items={capability.views.map((view) => ({
+    id: view,
+    label: view,
+    meta: "view"
+  }))} />
+        <PrimitiveStack label="Widgets" items={capability.widgets.map((widget) => ({
+    id: widget.id,
+    label: widget.id,
+    meta: `${widget.chart} / ${widget.sourceObject}`
+  }))} />
+      </div>
+      <div className="field-cloud">
+        {capability.objects.flatMap((item) => item.fields.map((field) => <code key={`${item.id}-${field.name}`}>{field.name}:{field.type}</code>))}
+      </div>
+      {capability.integrations.length ? <div className="integration-bindings">
+          {capability.integrations.map((item) => <span key={item.id}>
+              {item.label}
+              <code>{item.status}</code>
+            </span>)}
+        </div> : null}
+    </article>;
+}
+function PrimitiveStack({ label, items }) {
+  return <section className="primitive-stack">
+      <span>{label}</span>
+      {items.map((item) => <div key={item.id}>
+          <strong>{item.label}</strong>
+          <code>{item.meta}</code>
+        </div>)}
+    </section>;
+}
+function ContractPanel({ api }) {
+  return <section className="contract-panel" id="operations">
+      {api.map((item) => <Link href={item.href} key={item.href}>
+          <span>{item.label}</span>
+          <code>{item.method} {item.href}</code>
+        </Link>)}
+    </section>;
+}
 export {
   Home as default
 };