@growthub/cli 0.9.1 → 0.9.2

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

@@ -1,134 +1,105 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
 import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/adapters/integrations";
-import { portalCapabilities } from "@/lib/domain/portal";
 import { groupIntegrationsByLane } from "@/lib/domain/integrations";
+import { buildPortalWorkspace } from "@/lib/domain/portal";
+import { describeAuthAdapter } from "@/lib/adapters/auth";
+import { describePaymentAdapter } from "@/lib/adapters/payments";
+import { describePersistenceAdapter } from "@/lib/adapters/persistence";
 import Link from "next/link";
-const nav = [
-  ...portalCapabilities.map((item) => ({ href: `/#${item.id}`, label: item.label })),
-  { href: "/settings/integrations", label: "Integrations" }
-];
 async function IntegrationsSettingsPage() {
+  const config = readAdapterConfig();
   const adapter = describeIntegrationAdapter();
   const grouped = groupIntegrationsByLane(await listAgencyPortalIntegrations());
-  const allIntegrations = [...grouped.dataSources, ...grouped.workspaceIntegrations];
-  const connectedCount = allIntegrations.filter((item) => item.isConnected).length;
+  const workspace = buildPortalWorkspace({
+    config,
+    integrations: grouped,
+    adapters: {
+      persistence: describePersistenceAdapter(),
+      auth: describeAuthAdapter(),
+      payments: describePaymentAdapter(),
+      integrations: adapter
+    }
+  });
+  const rows = [
+    ...grouped.dataSources.map((item) => ({ ...item, primitiveGroup: "data-source" })),
+    ...grouped.workspaceIntegrations.map((item) => ({ ...item, primitiveGroup: "workspace-integration" }))
+  ];
   return <main className="shell">
       <aside className="sidebar">
         <div className="brand">
-          <span className="brand-mark">GH</span>
-          <span>Agency Portal</span>
+          <span className="brand-mark">{workspace.identity.mark}</span>
+          <span>{workspace.identity.label}</span>
         </div>
         <nav className="nav">
-          {nav.map((item) => <Link className={item.href === "/settings/integrations" ? "active" : ""} key={item.href} href={item.href}>
+          {workspace.navigation.map((item) => <Link className={item.href === "/settings/integrations" ? "active" : ""} key={item.href} href={item.href.startsWith("#") ? `/${item.href}` : item.href}>
               {item.label}
             </Link>)}
         </nav>
         <div className="sidebar-footer">
           <span className="status-dot" />
-          {connectedCount} connected
+          {adapter.authority}
         </div>
       </aside>
-
       <section className="main">
         <div className="utility-bar">
           <div>
-            <strong>Integration setup</strong>
-            <span>Growthub bridge, BYO API keys, and Windsor data pipelines normalize into one worker-kit object model.</span>
+            <strong>{adapter.label}</strong>
+            <span>{workspace.identity.primitiveContract}</span>
           </div>
           <div className="utility-actions">
+            <span className="pill">{adapter.id}</span>
             <span className="pill">{adapter.authority}</span>
-            <span className="pill">{adapter.source}</span>
           </div>
         </div>
-
-        <div className="page-heading">
-          <span className="eyebrow">Settings</span>
-          <h1>Integrations</h1>
-          <p>
-            Configure the portal through the hosted Growthub auth bridge or through explicit bring-your-own credentials.
-            Data pipeline objects stay separate from workspace integrations while sharing one normalized surface.
-          </p>
-          <span className="badge">{adapter.label}</span>
-        </div>
-
-        <section className="setup-grid" aria-label="Integration setup paths">
-          <article className="setup-card">
-            <span>01</span>
-            <strong>Growthub Bridge</strong>
-            <p>Uses the authenticated Growthub account to resolve already-connected MCP accounts for this portal.</p>
-            <code>GROWTHUB_BRIDGE_ACCESS_TOKEN</code>
+        <section className="primitive-grid summary" aria-label="Integration adapter primitives">
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Authority</p>
+              <span className="status runtime-derived">{adapter.authority}</span>
+            </div>
+            <strong>{adapter.id}</strong>
+            <div className="primitive-meta">
+              {adapter.requiredEnv.map((key) => <code key={key}>{key}</code>)}
+            </div>
           </article>
-          <article className="setup-card">
-            <span>02</span>
-            <strong>BYO API Key</strong>
-            <p>Supports direct provider keys without binding the kit to a database, vendor, or hosted account.</p>
-            <code>AGENCY_PORTAL_BYO_CONNECTIONS_JSON</code>
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Data-source primitives</p>
+              <span className="status runtime-derived">{grouped.dataSources.length}</span>
+            </div>
+            <strong>{grouped.dataSources.filter((item) => item.isConnected).length}/{grouped.dataSources.length}</strong>
+            <div className="primitive-meta"><span>{config.reportingAdapter || "reporting-adapter"}</span></div>
           </article>
-          <article className="setup-card">
-            <span>03</span>
-            <strong>Windsor Data</strong>
-            <p>First-class reporting pipeline for blended Meta, Shopify, GA4, and Google Sheets data sources.</p>
-            <code>WINDSOR_API_KEY</code>
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Workspace primitives</p>
+              <span className="status runtime-derived">{grouped.workspaceIntegrations.length}</span>
+            </div>
+            <strong>{grouped.workspaceIntegrations.filter((item) => item.isConnected).length}/{grouped.workspaceIntegrations.length}</strong>
+            <div className="primitive-meta"><span>{config.integrationAdapter}</span></div>
           </article>
         </section>
-
         <section className="integration-board">
-          <div className="integration-toolbar">
-            <div>
-              <strong>Connection authority</strong>
-              <p>{adapter.description}</p>
-            </div>
-            <code>GET /api/settings/integrations</code>
-          </div>
-
-          <IntegrationPanel
-    title="Data pipeline objects"
-    intro="Meta, Shopify, GA4, Windsor AI, and Google Sheets blended data feed reporting and analytics workflows."
-    items={grouped.dataSources}
-  />
-          <IntegrationPanel
-    title="MCP connection integrations"
-    intro="Asana, Slack, GHL, Google Drive, and Notion are operational integrations resolved through MCP connection authority or explicit BYO setup."
-    items={grouped.workspaceIntegrations}
-  />
+          {rows.map((item) => <article className="integration-card" key={item.id}>
+              <div className="integration-card-top">
+                <div className="provider-mark">{item.icon || item.label.slice(0, 1)}</div>
+                <div>
+                  <strong>{item.label}</strong>
+                  <p>{item.provider} / {item.objectType} / {item.primitiveGroup}</p>
+                </div>
+                <span className={`status ${item.status}`}>{item.status}</span>
+              </div>
+              <div className="integration-card-meta">
+                <span>{item.authPath}</span>
+                <span>{item.setupMode}</span>
+                <span>{item.authType}</span>
+                {item.secretEnvName ? <span>{item.secretEnvName}</span> : null}
+              </div>
+            </article>)}
         </section>
       </section>
     </main>;
 }
-function IntegrationPanel({
-  title,
-  intro,
-  items
-}) {
-  const connected = items.filter((item) => item.isConnected).length;
-  return <article className="integration-section">
-      <div className="section-heading">
-        <div>
-          <h2>{title}</h2>
-          <p className="panel-copy">{intro}</p>
-        </div>
-        <span className="badge">{connected}/{items.length} connected</span>
-      </div>
-      <div className="integration-list">
-        {items.map((item) => <article className="integration-card" key={item.id}>
-            <div className="integration-card-top">
-              <div className="provider-mark">{item.label.slice(0, 1)}</div>
-              <div>
-                <strong>{item.label}</strong>
-                <p>{item.description}</p>
-              </div>
-              <span className={`status ${item.status}`}>{item.status}</span>
-            </div>
-            <div className="integration-card-meta">
-              <span>{item.provider}</span>
-              <span>{item.objectType}</span>
-              <span>{item.authPath}</span>
-              <span>{item.setupMode}</span>
-              {item.secretEnvName ? <span>{item.secretEnvName}</span> : null}
-            </div>
-          </article>)}
-      </div>
-    </article>;
-}
 export {
   IntegrationsSettingsPage as default
 };

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

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  }
+}

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/integrations/index.js

@@ -57,7 +57,27 @@ async function listAgencyPortalIntegrations() {
     return agencyPortalIntegrationCatalog;
   }
   const payload = await response.json();
-  return mergeBridgeRows(normalizeGrowthubBridgePayload(payload));
+  const merged = mergeBridgeRows(normalizeGrowthubBridgePayload(payload));
+  return applyApiKeyOverlays(merged, config);
+}
+function applyApiKeyOverlays(integrations, config) {
+  if (!config.dataSources.hasWindsorApiKey) return integrations;
+  const windsorOverlay = {
+    status: "connected",
+    isConnected: true,
+    isActive: true,
+    authPath: "byo-api-key",
+    setupMode: "bring-your-own-key",
+    authType: "api_token",
+    category: "api_key",
+    secretEnvName: "WINDSOR_API_KEY",
+    connectionMetadata: { source: "workspace-env", secretEnvName: "WINDSOR_API_KEY" }
+  };
+  return integrations.map((item) => {
+    if (item.provider === "windsor-ai") return { ...item, ...windsorOverlay };
+    if (item.provider === "google-sheets") return { ...item, ...windsorOverlay, secretEnvName: undefined, connectionMetadata: { source: "windsor-blended-data" } };
+    return item;
+  });
 }
 function readBringYourOwnRows() {
   const raw = process.env.AGENCY_PORTAL_BYO_CONNECTIONS_JSON;

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/domain/portal.js

@@ -1,16 +1,150 @@
-const portalCapabilities = [
-  { id: "dashboard", label: "Dashboard", metric: "Live agency snapshot", description: "Revenue, client health, overdue work, and next actions." },
-  { id: "clients", label: "Clients", metric: "Profiles and onboarding", description: "Client records, notes, KPIs, lifecycle state, and contacts." },
-  { id: "pipeline", label: "Pipeline", metric: "Opportunities", description: "Lead stages, potential value, won/lost state, and follow-up ownership." },
-  { id: "content", label: "Content", metric: "Calendar", description: "Client content plans by channel, due date, owner, and status." },
-  { id: "tasks", label: "Tasks", metric: "Execution queue", description: "Priorities, recurring templates, due dates, and completion state." },
-  { id: "finance", label: "Finance", metric: "Invoices and expenses", description: "Billing state, expenses, payment status, and retainer visibility." },
-  { id: "reports", label: "Reports", metric: "Performance reviews", description: "Ad and campaign reporting through a pluggable reporting adapter." },
-  { id: "metrics", label: "Metrics", metric: "Agency health", description: "Period-over-period MRR, churn, pipeline, and workload indicators." },
-  { id: "client-results", label: "Client Results", metric: "Windsor reporting", description: "Blended data pipelines for Meta, Shopify, GA4, and Google Sheets-backed reports." },
-  { id: "operations", label: "Operations", metric: "SOP library", description: "Internal documentation, quick links, workflows, and process memory." },
-  { id: "settings", label: "Settings", metric: "Workspace control", description: "Branding, adapter selections, deployment metadata, and user preferences." }
+const fieldTypes = [
+  "text",
+  "long_text",
+  "number",
+  "currency",
+  "percentage",
+  "date",
+  "datetime",
+  "select",
+  "multi_select",
+  "boolean",
+  "relation",
+  "multi_relation",
+  "formula",
+  "rollup",
+  "url",
+  "email",
+  "phone",
+  "json",
+  "file",
+  "rating",
+  "user"
 ];
+const capabilitySpecs = [
+  tab("dashboard", "Dashboard", "workspace-summary", ["agencyAccount", "client", "task"], ["pipelineValue", "clientHealth", "openTasks", "reportingReadiness"], ["data", "auth", "integrations"]),
+  tab("clients", "Clients", "client-records", ["client", "contact", "clientKpi"], ["activeClients", "retainerValue", "healthScore", "renewalWindow"], ["data", "auth"]),
+  tab("pipeline", "Pipeline", "opportunity-flow", ["opportunity", "client", "contact"], ["stageValue", "winRate", "nextFollowUp", "ownerLoad"], ["data", "integrations"]),
+  tab("content", "Content", "publishing-workflow", ["contentPlan", "client", "task"], ["scheduledPosts", "channelMix", "approvalQueue", "overdueAssets"], ["data", "integrations"]),
+  tab("tasks", "Tasks", "execution-queue", ["task", "client", "workflowRun"], ["openTasks", "slaRisk", "ownerLoad", "recurringTemplates"], ["data", "integrations"]),
+  tab("finance", "Finance", "billing-control", ["invoice", "expense", "client"], ["mrr", "outstandingBalance", "margin", "paymentState"], ["data", "payments"]),
+  tab("reports", "Reports", "reporting-adapter", ["report", "clientKpi", "dataConnector"], ["reportQueue", "connectedSources", "periodDelta", "deliveryState"], ["reporting", "integrations"]),
+  tab("metrics", "Metrics", "agency-health", ["agencyMetric", "clientKpi", "opportunity"], ["mrrTrend", "churnRisk", "pipelineCoverage", "capacity"], ["data", "reporting"]),
+  tab("client-results", "Client Results", "client-performance", ["clientKpi", "report", "dataConnector"], ["roas", "cac", "revenue", "sourceFreshness"], ["reporting", "data-sources"]),
+  tab("operations", "Operations", "process-memory", ["sop", "workflowRun", "task"], ["sopCoverage", "runHistory", "handoffHealth", "blockedWork"], ["data", "auth"]),
+  tab("settings", "Settings", "workspace-control", ["workspaceSetting", "dataConnector", "userPreference"], ["adapterState", "permissionCoverage", "auditTrail", "deploymentState"], ["auth", "payments", "integrations"])
+];
+const objectDefinitions = {
+  agencyAccount: object("agencyAccount", "Agency account", [["name", "text"], ["domain", "url"], ["owner", "user"], ["settings", "json"], ["createdAt", "datetime"]]),
+  client: object("client", "Client", [["name", "text"], ["retainer", "currency"], ["healthScore", "rating"], ["stage", "select"], ["primaryContact", "relation"], ["renewalDate", "date"], ["monthlyRevenue", "currency"], ["notes", "long_text"]]),
+  contact: object("contact", "Contact", [["fullName", "text"], ["email", "email"], ["phone", "phone"], ["client", "relation"], ["role", "select"], ["lastTouchAt", "datetime"]]),
+  clientKpi: object("clientKpi", "Client KPI", [["client", "relation"], ["source", "select"], ["period", "date"], ["metric", "text"], ["value", "number"], ["delta", "percentage"], ["formulaValue", "formula"]]),
+  opportunity: object("opportunity", "Opportunity", [["client", "relation"], ["name", "text"], ["stage", "select"], ["value", "currency"], ["probability", "percentage"], ["owner", "user"], ["nextFollowUp", "datetime"]]),
+  contentPlan: object("contentPlan", "Content plan", [["client", "relation"], ["channel", "multi_select"], ["publishAt", "datetime"], ["asset", "file"], ["status", "select"], ["approvers", "multi_relation"]]),
+  task: object("task", "Task", [["title", "text"], ["client", "relation"], ["owner", "user"], ["priority", "select"], ["dueAt", "datetime"], ["done", "boolean"], ["sourcePayload", "json"]]),
+  workflowRun: object("workflowRun", "Workflow run", [["name", "text"], ["status", "select"], ["startedAt", "datetime"], ["completedAt", "datetime"], ["relatedTasks", "multi_relation"], ["trace", "json"]]),
+  invoice: object("invoice", "Invoice", [["client", "relation"], ["amount", "currency"], ["status", "select"], ["dueDate", "date"], ["paidAt", "datetime"], ["lineItems", "json"]]),
+  expense: object("expense", "Expense", [["client", "relation"], ["amount", "currency"], ["category", "select"], ["receipt", "file"], ["billable", "boolean"]]),
+  report: object("report", "Report", [["client", "relation"], ["period", "date"], ["status", "select"], ["sourceConnectors", "multi_relation"], ["snapshot", "json"], ["publishedUrl", "url"]]),
+  dataConnector: object("dataConnector", "Data connector", [["provider", "text"], ["status", "select"], ["authPath", "text"], ["lastSyncedAt", "datetime"], ["metadata", "json"]]),
+  agencyMetric: object("agencyMetric", "Agency metric", [["period", "date"], ["mrr", "currency"], ["churn", "percentage"], ["utilization", "percentage"], ["pipeline", "currency"], ["score", "formula"]]),
+  sop: object("sop", "SOP", [["title", "text"], ["area", "select"], ["owner", "user"], ["body", "long_text"], ["relatedObjects", "multi_relation"], ["version", "number"]]),
+  workspaceSetting: object("workspaceSetting", "Workspace setting", [["key", "text"], ["value", "json"], ["adapter", "select"], ["permission", "select"], ["updatedAt", "datetime"]]),
+  userPreference: object("userPreference", "User preference", [["user", "user"], ["theme", "select"], ["defaultView", "text"], ["notifications", "json"]])
+};
+const portalCapabilities = capabilitySpecs.map(({ id, label, objectType, bindings }) => ({ id, label, objectType, bindings }));
+function tab(id, label, objectType, objects, widgets, bindings) {
+  return { id, label, objectType, objects, widgets, bindings };
+}
+function object(id, label, fields) {
+  return {
+    id,
+    label,
+    fields: fields.map(([name, type]) => ({ name, type })),
+    views: ["table", "kanban", "record", "dashboard"],
+    contract: "twenty-sdk/define"
+  };
+}
+function buildPortalWorkspace({ config, adapters, integrations }) {
+  const integrationRows = [...integrations.dataSources, ...integrations.workspaceIntegrations];
+  const connectedRows = integrationRows.filter((item) => item.isConnected);
+  const connectedDataSources = integrations.dataSources.filter((item) => item.isConnected);
+  const adapterRows = [
+    primitive("data", "Data", config.dataAdapter, adapters.persistence.mode, adapters.persistence.requiredEnv),
+    primitive("auth", "Auth", config.authAdapter, adapters.auth.id, adapters.auth.requiredEnv),
+    primitive("payments", "Payments", config.paymentAdapter, adapters.payments.enabled ? "enabled" : "disabled", adapters.payments.requiredEnv),
+    primitive("integrations", "Integrations", config.integrationAdapter, adapters.integrations.authority, adapters.integrations.requiredEnv),
+    primitive("reporting", "Reporting", config.reportingAdapter || "not-configured", config.dataSources.hasWindsorApiKey ? "windsor-key-present" : "adapter-selected", []),
+    primitive("data-sources", "Data sources", `${connectedDataSources.length}/${integrations.dataSources.length}`, config.dataSources.hasWindsorApiKey ? "windsor-overlay" : "integration-state", [])
+  ];
+  return {
+    identity: {
+      label: "Agency Portal",
+      mark: "GH",
+      mode: "governed-worker-kit",
+      deployTarget: config.deployTarget,
+      primitiveContract: "twenty-sdk/define objects, fields, views, dashboards, widgets, permissions, CRUD, API, webhooks, and audit logs",
+      fieldTypes
+    },
+    navigation: [
+      ...portalCapabilities.map((item) => ({ href: `#${item.id}`, label: item.label })),
+      { href: "/settings/integrations", label: "Integrations" }
+    ],
+    summary: [
+      primitive("object-schema", "Object schema", `${Object.keys(objectDefinitions).length} objects`, "twenty-sdk/define", fieldTypes),
+      primitive("dashboard-widgets", "Dashboard widgets", `${capabilitySpecs.reduce((total, item) => total + item.widgets.length, 0)} widgets`, "capability dashboards", ["bar", "line", "pie", "number"]),
+      primitive("connection-state", "Connection state", `${connectedRows.length}/${integrationRows.length}`, config.integrationAdapter, adapters.integrations.requiredEnv)
+    ],
+    adapters: adapterRows,
+    capabilities: capabilitySpecs.map((item) => buildCapabilityPrimitive(item, adapterRows, integrations)),
+    actions: capabilitySpecs.slice(0, 5).map((item) => ({ href: `#${item.id}`, label: item.label, objectType: item.objectType })),
+    api: [
+      { label: "Workspace contract", href: "/api/workspace", method: "GET" },
+      { label: "Integration contract", href: "/api/settings/integrations", method: "GET" }
+    ]
+  };
+}
+function primitive(id, label, value, source, env) {
+  return {
+    id,
+    label,
+    value,
+    source,
+    env,
+    status: env.length ? "configured-by-env" : "runtime-derived"
+  };
+}
+function buildCapabilityPrimitive(capability, adapterRows, integrations) {
+  const bindings = adapterRows.filter((item) => capability.bindings.includes(item.id));
+  const relatedObjects = capability.objects.map((id) => objectDefinitions[id]);
+  const fieldCount = relatedObjects.reduce((count, item) => count + item.fields.length, 0);
+  const dataSources = integrations.dataSources.filter((item) => capability.bindings.includes("data-sources") || capability.bindings.includes("reporting"));
+  const workspaceIntegrations = integrations.workspaceIntegrations.filter((item) => capability.bindings.includes("integrations"));
+  return {
+    ...capability,
+    status: bindings.some((item) => item.value === "not-configured") ? "needs-runtime-config" : "runtime-ready",
+    fields: fieldCount,
+    objects: relatedObjects,
+    views: Array.from(new Set(relatedObjects.flatMap((item) => item.views))),
+    widgets: capability.widgets.map((id, index) => ({
+      id,
+      chart: ["number", "bar", "line", "pie"][index % 4],
+      sourceObject: relatedObjects[index % relatedObjects.length].id,
+      filters: ["client", "period", "owner", "status"].slice(0, 2 + index % 3),
+      realtime: true
+    })),
+    bindings,
+    integrations: [...dataSources, ...workspaceIntegrations].map((item) => ({
+      id: item.id,
+      label: item.label,
+      provider: item.provider,
+      objectType: item.objectType,
+      status: item.status,
+      source: item.authPath
+    }))
+  };
+}
 export {
+  buildPortalWorkspace,
   portalCapabilities
 };

package/assets/worker-kits/growthub-agency-portal-starter-v1/docs/adapter-contracts.md

@@ -77,3 +77,10 @@ It also accepts the GH app MCP accounts shape returned by `/api/mcp/accounts`:
 Both shapes normalize into the same `AgencyPortalIntegration` object used by the BYO path. Unknown connected providers are preserved as discovered workspace integrations instead of being dropped.
 
 The BYO path uses the same normalized object shape, but expects the workspace operator to provide the connection metadata and secret env names explicitly. Windsor is first-class: when `WINDSOR_API_KEY` is set with `AGENCY_PORTAL_INTEGRATION_ADAPTER=byo-api-key`, the app marks the Windsor AI data pipeline object as connected without requiring a larger JSON payload. The hosted Growthub bridge remains the lower-friction first-party path for user-owned MCP connections.
+
+The starter also supports a safe hybrid mode for new users: keep `AGENCY_PORTAL_INTEGRATION_ADAPTER=growthub-bridge` for hosted account authority, and set `WINDSOR_API_KEY` locally when Windsor reporting is being bootstrapped before the hosted bridge has returned a Windsor account row. In that mode the app overlays a connected Windsor state onto:
+
+- `windsor-ai`
+- `google-sheets` blended data
+
+This preserves the bridge as the source of truth for the rest of the integration catalog while letting the portal surface Windsor-backed reporting setup end to end from first boot.

package/assets/worker-kits/growthub-agency-portal-starter-v1/studio/src/App.jsx

@@ -1,22 +1,19 @@
 import React from "react";
+import { agencyPortalIntegrationCatalog, groupIntegrationsByLane } from "../../apps/agency-portal/lib/domain/integrations.js";
+import { portalCapabilities } from "../../apps/agency-portal/lib/domain/portal.js";
 
-const capabilities = [
-  ["Dashboard", "Live agency snapshot", "Revenue, client health, overdue work, and next actions."],
-  ["Clients", "Profiles and onboarding", "Client records, notes, KPIs, lifecycle state, and contacts."],
-  ["Pipeline", "Opportunities", "Lead stages, potential value, won/lost state, and follow-up ownership."],
-  ["Reports", "Performance reviews", "Ad and campaign reporting through pluggable reporting adapters."],
-  ["Client Results", "Windsor reporting", "Blended Meta, Shopify, GA4, and Google Sheets-backed results."],
-  ["Settings", "Workspace control", "Branding, adapter selections, deployment metadata, and user preferences."],
-];
-
+const grouped = groupIntegrationsByLane(agencyPortalIntegrationCatalog);
+const integrations = [...grouped.dataSources, ...grouped.workspaceIntegrations];
 const adapters = [
-  ["Persistence", "Postgres-compatible adapter boundary, not bound to one vendor."],
-  ["Auth", "Local workspace auth or Growthub hosted bridge authority."],
-  ["Payments", "Replaceable billing adapter for Stripe or explicit project needs."],
-  ["Integrations", "Growthub MCP bridge, BYO API tokens, and Windsor data pipelines."],
+  ["Persistence", "Provider-managed", "Postgres, Qstash KV, or provider-managed adapter boundary."],
+  ["Auth", "Provider-managed", "OIDC, Clerk, Auth.js, or provider-managed auth selector."],
+  ["Payments", "None", "Stripe, Polar, or disabled payment adapter selector."],
+  ["Integrations", `${integrations.filter((item) => item.isConnected).length}/${integrations.length} connected`, "Growthub MCP bridge, BYO API tokens, and Windsor data pipelines."],
+];
+const quickActions = [
+  ...portalCapabilities.slice(0, 4).map((item) => ({ href: `#${item.id}`, label: item.label })),
+  { href: "#integrations", label: "Integrations" },
 ];
-
-const quickActions = ["Client onboarding", "Publish report", "Sync Windsor data", "Review open tasks"];
 
 export default function App() {
   return (
@@ -27,8 +24,8 @@ export default function App() {
           <span>Agency Portal</span>
         </div>
         <nav className="nav">
-          {capabilities.map(([label]) => (
-            <a key={label} href={`#${label.toLowerCase().replaceAll(" ", "-")}`}>{label}</a>
+          {portalCapabilities.map((capability) => (
+            <a key={capability.id} href={`#${capability.id}`}>{capability.label}</a>
           ))}
           <a href="#integrations">Integrations</a>
         </nav>
@@ -46,7 +43,7 @@ export default function App() {
           </div>
           <div className="utility-actions">
             <a href="#integrations">Open integrations</a>
-            <span className="pill">worker kit v1</span>
+            <span className="pill">deploy: local-preview</span>
           </div>
         </div>
 
@@ -54,26 +51,25 @@ export default function App() {
           <span className="eyebrow">Agency operating system</span>
           <h1>Client work, reporting, and integrations in one governed shell.</h1>
           <p>
-            This starter keeps the copied prototype as product direction while the worker kit owns the
-            composable adapter model, local Vite workflow, and clean Vercel deployment path.
+            The local shell previews the same capability and integration objects that the deployable portal exposes.
           </p>
         </header>
 
         <section className="hero-grid">
           <article className="hero-card primary">
-            <span>Monthly revenue</span>
-            <strong>$84.2k</strong>
-            <p>MRR, retainers, won pipeline, and invoice state are ready to bind to any supported database adapter.</p>
+            <span>Runtime adapters</span>
+            <strong>provider-managed</strong>
+            <p>Persistence, auth, and payment selectors stay replaceable at runtime.</p>
           </article>
           <article className="hero-card">
             <span>MCP connections</span>
-            <strong>9 active</strong>
-            <p>Growthub bridge connections can hydrate user-linked providers without hardcoded API sprawl.</p>
+            <strong>{integrations.filter((item) => item.isConnected).length}/{integrations.length}</strong>
+            <p>Bridge, BYO, and catalog rows normalize into one integration object model.</p>
           </article>
           <article className="hero-card">
             <span>Windsor data</span>
-            <strong>4 sources</strong>
-            <p>Meta, Shopify, GA4, and Sheets-backed blended data are modeled as data pipeline objects.</p>
+            <strong>{grouped.dataSources.filter((item) => item.isConnected).length}/{grouped.dataSources.length}</strong>
+            <p>Data pipeline readiness comes from integration state, not seeded reporting metrics.</p>
           </article>
         </section>
 
@@ -101,19 +97,20 @@ export default function App() {
         </section>
 
         <section className="grid">
-          {capabilities.map(([label, metric, description]) => (
-            <article className="card" id={label.toLowerCase().replaceAll(" ", "-")} key={label}>
-              <span>{metric}</span>
-              <h3>{label}</h3>
-              <p>{description}</p>
+          {portalCapabilities.map((capability) => (
+            <article className="card" id={capability.id} key={capability.id}>
+              <span>{capability.metric}</span>
+              <h3>{capability.label}</h3>
+              <p>{capability.description}</p>
             </article>
           ))}
         </section>
 
         <section className="adapter">
-          {adapters.map(([title, body]) => (
+          {adapters.map(([title, value, body]) => (
             <article className="card" key={title}>
               <h3>{title}</h3>
+              <p><strong>{value}</strong></p>
               <p>{body}</p>
             </article>
           ))}
@@ -147,15 +144,15 @@ export default function App() {
             </p>
           </div>
           <div className="results-metrics">
-            <div><strong>Meta</strong><span>Ads and social source</span></div>
-            <div><strong>Shopify</strong><span>Commerce source</span></div>
-            <div><strong>GA4</strong><span>Analytics source</span></div>
+            {grouped.dataSources.map((source) => (
+              <div key={source.id}><strong>{source.label}</strong><span>{source.status}</span></div>
+            ))}
           </div>
         </section>
       </section>
 
       <div className="quick-actions" aria-label="Quick actions">
-        {quickActions.map((action) => <button key={action}>{action}</button>)}
+        {quickActions.map((action) => <a key={action.href} href={action.href}>{action.label}</a>)}
       </div>
     </main>
   );

package/assets/worker-kits/growthub-agency-portal-starter-v1/studio/src/app.css

@@ -114,7 +114,7 @@ a { color: inherit; }
 .results-metrics { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 10px; }
 .results-metrics span { display: block; color: var(--muted); font-size: 12px; }
 .quick-actions { position: fixed; right: 20px; bottom: 20px; display: grid; gap: 8px; width: 190px; }
-.quick-actions button {
+.quick-actions button, .quick-actions a {
   border: 1px solid var(--line);
   border-radius: 8px;
   padding: 10px 12px;
@@ -122,6 +122,7 @@ a { color: inherit; }
   color: var(--ink);
   text-align: left;
   font: inherit;
+  text-decoration: none;
 }
 
 @media (max-width: 1020px) {