@growthub/cli 0.9.10 → 0.9.12

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/workspace-schema.js

@@ -12,11 +12,12 @@
  *   - `widgetTypes`    palette of allowed widget kinds (label/icon)
  *   - `canvas`         active canvas: layout, single-tab `widgets[]`, or
  *                      multi-tab `tabs[]` + `activeTabId`, plus `bindings`
+ *   - `dataModel`      governed manual data objects, never dashboard widgets
  *
  * Other top-level fields (`id`, `name`, `description`, `capabilities`,
  * `branding`, `pipelines`, `integrations`, `provenance`) are preserved
  * round-trip but cannot be mutated through PATCH. The validator rejects
- * unknown fields inside the three allowlisted sections.
+ * unknown fields inside the allowlisted sections.
  *
  * Canonical canvas shape (mutually exclusive — never both at once):
  *
@@ -39,13 +40,15 @@
 const GRID_COLUMNS = 12;
 const GRID_ROWS = 16;
 const KNOWN_WIDGET_KINDS = ["chart", "view", "iframe", "rich-text"];
-const KNOWN_FIELDS = ["dashboards", "widgetTypes", "canvas"];
+const KNOWN_FIELDS = ["dashboards", "widgetTypes", "canvas", "dataModel"];
 const KNOWN_DATA_BINDING_MODES = ["manual", "json", "csv", "integration"];
 const KNOWN_CHART_TYPES = ["bar-vertical", "bar-horizontal", "line", "pie", "sum", "gauge"];
 const KNOWN_FILTER_OPERATORS = ["eq", "ne", "contains", "gt", "lt", "isEmpty", "isNotEmpty"];
 const KNOWN_FILTER_CONJUNCTIONS = ["and", "or"];
 const KNOWN_SORT_DIRECTIONS = ["asc", "desc"];
 const KNOWN_AGGREGATIONS = ["sum", "avg", "count", "min", "max"];
+
+const NORMALIZED_OBJECT_FIELD_IDS = ["id", "label", "secondaryLabel", "entityType", "provider", "lane", "status"];
 const WORKSPACE_TEMPLATE_KIND = "growthub-workspace-template";
 const WORKSPACE_TEMPLATE_VERSION = 1;
 const WORKSPACE_TEMPLATE_SOURCE = "growthub-custom-workspace-starter-v1";
@@ -141,17 +144,35 @@ const WIDGET_SCHEMA_CONTRACTS = {
     source: "string",
     rows: "manual record[] optional",
     json: "JSON string optional",
-    csv: "CSV string optional"
+    csv: "CSV string optional",
+    sourceType: "managed-integrations | custom-api-webhooks optional",
+    sourceAuthority: "string optional — adapter authority label, never a secret",
+    endpointRef: "string optional — stable custom API/webhook reference, never a token",
+    integrationId: "string optional (when mode === 'integration')",
+    lane: "string optional (when mode === 'integration')",
+    entityId: "string optional — stable source object ID (never a token or credential)",
+    entityType: "string optional — adapter-provided object type",
+    entityLabel: "string optional — display-only resolved label, not authoritative"
+  },
+  NormalizedIntegrationEntity: {
+    id: "non-empty string — stable source object ID",
+    label: "non-empty string — primary display name",
+    secondaryLabel: "string optional — muted subtitle (ID, domain, or type hint)",
+    entityType: "string optional — adapter-provided object type",
+    provider: "string optional — adapter/provider slug",
+    lane: "string optional — adapter-provided lane",
+    status: "string optional — adapter-provided status",
+    metadata: "record optional — additional adapter metadata"
   }
 };
 
 const SAMPLE_VIEW_ROWS = [
-  { Name: "CMWL Direct", "Domain Name": "centerformedica" },
-  { Name: "Medi-Weightloss", "Domain Name": "mediweightloss.com" },
-  { Name: "Optima Tyler", "Domain Name": "optimatyler.com" },
-  { Name: "Balanced Hormone He...", "Domain Name": "balancedhormor" },
-  { Name: "Jolie Aesthetics RVA", "Domain Name": "jolie-aesthetics.c" },
-  { Name: "Livea Centers", "Domain Name": "livea.com" }
+  { Name: "Example Company A", "Domain Name": "example-a.test" },
+  { Name: "Example Company B", "Domain Name": "example-b.test" },
+  { Name: "Example Company C", "Domain Name": "example-c.test" },
+  { Name: "Example Company D", "Domain Name": "example-d.test" },
+  { Name: "Example Company E", "Domain Name": "example-e.test" },
+  { Name: "Example Company F", "Domain Name": "example-f.test" }
 ];
 
 const SAMPLE_DATA_BINDINGS = {
@@ -182,11 +203,11 @@ function defaultConfigFor(kind) {
       return { values: [58, 36, 72, 48, 64], binding: SAMPLE_DATA_BINDINGS.reportingJson };
     case "view":
       return {
-        source: "Companies",
+        source: "",
         layout: "Table",
-        columns: ["Name", "Domain Name"],
-        rows: SAMPLE_VIEW_ROWS,
-        binding: SAMPLE_DATA_BINDINGS.companiesManual
+        columns: [],
+        rows: [],
+        binding: { mode: "manual", source: "Static rows", rows: [] }
       };
     case "iframe":
       return { url: "" };
@@ -227,7 +248,13 @@ const DASHBOARD_TEMPLATES = [
     dashboard: { name: "Client Portal", status: "draft" },
     widgets: [
       createWidget("rich-text", "Client Summary", { x: 0, y: 0, w: 4, h: 4 }, { text: "Current client priorities, owner notes, and next milestone.", binding: { mode: "manual", source: "Manual text", rows: [] } }),
-      createWidget("view", "Companies", { x: 4, y: 0, w: 5, h: 5 }),
+      createWidget("view", "Companies", { x: 4, y: 0, w: 5, h: 5 }, {
+        source: "Companies",
+        layout: "Table",
+        columns: ["Name", "Domain Name"],
+        rows: SAMPLE_VIEW_ROWS,
+        binding: SAMPLE_DATA_BINDINGS.companiesManual
+      }),
       createWidget("iframe", "Client Portal Embed", { x: 9, y: 0, w: 3, h: 5 }, { url: "" }),
       createWidget("chart", "Delivery Health", { x: 0, y: 4, w: 4, h: 4 }, { values: [72, 64, 81, 58, 76], binding: SAMPLE_DATA_BINDINGS.reportingJson })
     ]
@@ -365,6 +392,14 @@ function validateStaticDataBinding(binding, path, errors) {
   if (!KNOWN_DATA_BINDING_MODES.includes(binding.mode)) {
     errors.push(`${path}.mode must be one of ${KNOWN_DATA_BINDING_MODES.join(", ")}`);
   }
+  if (binding.mode === "integration") {
+    if (typeof binding.integrationId !== "string" || !binding.integrationId.trim()) {
+      errors.push(`${path}.integrationId is required when mode is integration`);
+    }
+    if (typeof binding.lane !== "string" || !binding.lane.trim()) {
+      errors.push(`${path}.lane is required when mode is integration`);
+    }
+  }
   if (binding.source !== undefined && typeof binding.source !== "string") {
     errors.push(`${path}.source must be a string`);
   }
@@ -377,12 +412,33 @@ function validateStaticDataBinding(binding, path, errors) {
   if (binding.csv !== undefined && typeof binding.csv !== "string") {
     errors.push(`${path}.csv must be a string`);
   }
+  if (binding.sourceType !== undefined && typeof binding.sourceType !== "string") {
+    errors.push(`${path}.sourceType must be a string`);
+  }
+  if (binding.sourceAuthority !== undefined && typeof binding.sourceAuthority !== "string") {
+    errors.push(`${path}.sourceAuthority must be a string`);
+  }
+  if (binding.endpointRef !== undefined && typeof binding.endpointRef !== "string") {
+    errors.push(`${path}.endpointRef must be a string`);
+  }
+  if (binding.objectId !== undefined && typeof binding.objectId !== "string") {
+    errors.push(`${path}.objectId must be a string`);
+  }
   if (binding.integrationId !== undefined && typeof binding.integrationId !== "string") {
     errors.push(`${path}.integrationId must be a string`);
   }
   if (binding.lane !== undefined && typeof binding.lane !== "string") {
     errors.push(`${path}.lane must be a string`);
   }
+  if (binding.entityId !== undefined && typeof binding.entityId !== "string") {
+    errors.push(`${path}.entityId must be a string`);
+  }
+  if (binding.entityType !== undefined && typeof binding.entityType !== "string") {
+    errors.push(`${path}.entityType must be a string`);
+  }
+  if (binding.entityLabel !== undefined && typeof binding.entityLabel !== "string") {
+    errors.push(`${path}.entityLabel must be a string`);
+  }
 }
 
 function validateFieldSettings(fieldSettings, path, errors) {
@@ -722,6 +778,46 @@ function validateCanvasConfig(canvas, errors) {
   }
 }
 
+function validateDataModelConfig(dataModel, errors) {
+  if (dataModel === undefined) return;
+  if (!isPlainObject(dataModel)) {
+    errors.push("dataModel must be a plain object");
+    return;
+  }
+  if (dataModel.objects === undefined) return;
+  if (!Array.isArray(dataModel.objects)) {
+    errors.push("dataModel.objects must be an array");
+    return;
+  }
+  const ids = new Set();
+  dataModel.objects.forEach((object, index) => {
+    const prefix = `dataModel.objects[${index}]`;
+    if (!isPlainObject(object)) {
+      errors.push(`${prefix} must be an object`);
+      return;
+    }
+    if (typeof object.id !== "string" || !object.id.trim()) {
+      errors.push(`${prefix}.id must be a non-empty string`);
+    } else if (ids.has(object.id)) {
+      errors.push(`${prefix}.id duplicates an earlier object id`);
+    } else {
+      ids.add(object.id);
+    }
+    if (typeof object.label !== "string" || !object.label.trim()) errors.push(`${prefix}.label must be a non-empty string`);
+    if (object.source !== undefined && typeof object.source !== "string") errors.push(`${prefix}.source must be a string`);
+    validateStringArray(object.columns, `${prefix}.columns`, errors);
+    if (!Array.isArray(object.rows)) {
+      errors.push(`${prefix}.rows must be an array`);
+    } else {
+      object.rows.forEach((row, rowIndex) => {
+        if (!isPlainObject(row)) errors.push(`${prefix}.rows[${rowIndex}] must be a plain object`);
+      });
+    }
+    validateStaticDataBinding(object.binding, `${prefix}.binding`, errors);
+    validateFieldSettings(object.fieldSettings, `${prefix}.fieldSettings`, errors);
+  });
+}
+
 function validateTemplateWidgetArray(widgets, contextPath, errors) {
   if (!Array.isArray(widgets)) {
     errors.push(`${contextPath} must be an array`);
@@ -950,6 +1046,7 @@ function validateWorkspaceConfig(nextConfig) {
   if (nextConfig.dashboards !== undefined) validateDashboardArray(nextConfig.dashboards, errors);
   if (nextConfig.widgetTypes !== undefined && !Array.isArray(nextConfig.widgetTypes)) errors.push("widgetTypes must be an array");
   if (nextConfig.canvas !== undefined) validateCanvasConfig(nextConfig.canvas, errors);
+  if (nextConfig.dataModel !== undefined) validateDataModelConfig(nextConfig.dataModel, errors);
   if (errors.length) {
     const error = new Error(`invalid workspace config: ${errors.join("; ")}`);
     error.code = "INVALID_WORKSPACE_CONFIG";
@@ -970,6 +1067,7 @@ export {
   KNOWN_FILTER_OPERATORS,
   KNOWN_SORT_DIRECTIONS,
   KNOWN_WIDGET_KINDS,
+  NORMALIZED_OBJECT_FIELD_IDS,
   SAMPLE_DATA_BINDINGS,
   SAMPLE_VIEW_ROWS,
   WIDGET_SCHEMA_CONTRACTS,

package/assets/worker-kits/growthub-custom-workspace-starter-v1/kit.json

@@ -101,7 +101,7 @@
   },
   "outputStandard": {
     "type": "working-directory",
-    "description": "Fork the starter kit directly with `growthub starter init` — the CLI materializes this bundled asset tree to the user's chosen path, auto-registers the destination as a kit-fork (canonical state under `<forkPath>/.growthub-fork/fork.json`), optionally binds it to a GitHub remote, and hands off the forkId. Every downstream customization flows through the v1 Self-Healing Fork Sync Agent.",
+    "description": "Fork the starter kit directly with `growthub starter init` \u2014 the CLI materializes this bundled asset tree to the user's chosen path, auto-registers the destination as a kit-fork (canonical state under `<forkPath>/.growthub-fork/fork.json`), optionally binds it to a GitHub remote, and hands off the forkId. Every downstream customization flows through the v1 Self-Healing Fork Sync Agent.",
     "requiredPaths": [
       "QUICKSTART.md",
       "kit.json",
@@ -159,5 +159,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-16T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "official",
+  "workspaceCompatible": true,
+  "workspaceCategory": "workspace-starter"
 }

package/assets/worker-kits/growthub-email-marketing-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-email-marketing-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Email Marketing Strategist",
+    "name": "Growthub Agent Worker Kit \u2014 Email Marketing Strategist",
     "description": "Self-contained local execution environment for Growthub-focused email marketing. Produces brand-aware email campaigns, nurture sequences, broadcasts, and content-pillar-driven campaign plans with pluggable email platform integration.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -112,5 +112,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-10T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": true,
+  "workspaceCategory": "email-marketing"
 }

package/assets/worker-kits/growthub-geo-seo-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-geo-seo-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — GEO SEO Studio",
+    "name": "Growthub Agent Worker Kit \u2014 GEO SEO Studio",
     "description": "Self-contained local execution environment for GEO + SEO auditing using geo-seo-claude. Produces AI search visibility audits, citability scores, crawler access reports, brand mention scans, remediation roadmaps, and client-ready PDF deliverables via 14 specialized commands and 5 parallel subagents.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -116,5 +116,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-14T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "studio"
 }

package/assets/worker-kits/growthub-hyperframes-studio-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-hyperframes-studio-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Hyperframes Studio",
+    "name": "Growthub Agent Worker Kit \u2014 Hyperframes Studio",
     "description": "Self-contained local execution environment for Hyperframes video production. Produces implementation-ready video briefs, composition specs, render plans, and QA handoff artifacts for HTML-native rendering workflows.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -105,5 +105,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-17T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "studio"
 }

package/assets/worker-kits/growthub-marketing-skills-v1/kit.json

@@ -3,8 +3,8 @@
   "kit": {
     "id": "growthub-marketing-skills-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Marketing Operator",
-    "description": "Self-contained marketing execution environment wrapping the open-source marketingskills library (coreyhaines31/marketingskills). Provides structured marketing workflows for CRO, SEO, content strategy, email sequences, paid ads, and growth — grounded in product-marketing context and brand voice. Skills are one dimension of the kit; the operator workflow, brand kit, templates, and output standards form the complete environment.",
+    "name": "Growthub Agent Worker Kit \u2014 Marketing Operator",
+    "description": "Self-contained marketing execution environment wrapping the open-source marketingskills library (coreyhaines31/marketingskills). Provides structured marketing workflows for CRO, SEO, content strategy, email sequences, paid ads, and growth \u2014 grounded in product-marketing context and brand voice. Skills are one dimension of the kit; the operator workflow, brand kit, templates, and output standards form the complete environment.",
     "type": "worker",
     "visibility": "public-open-source",
     "sourceRepo": "growthub-local",
@@ -101,5 +101,8 @@
     "sourceRepo": "growthub-local",
     "upstream": "https://github.com/coreyhaines31/marketingskills",
     "frozenAt": "2026-04-15T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": true,
+  "workspaceCategory": "marketing-operator"
 }

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-open-higgsfield-studio-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Open Higgsfield Studio",
+    "name": "Growthub Agent Worker Kit \u2014 Open Higgsfield Studio",
     "description": "Self-contained local execution environment for Open Higgsfield AI visual production. Produces implementation-ready visual briefs, prompt systems, shot plans, generation batches, model selections, and execution handoff artifacts for browser, desktop, and local fork workflows.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -119,5 +119,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-10T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "studio"
 }

package/assets/worker-kits/growthub-open-montage-studio-v1/kit.json

@@ -3,8 +3,8 @@
   "kit": {
     "id": "growthub-open-montage-studio-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Open Montage Studio",
-    "description": "Self-contained local execution environment for OpenMontage agentic video production. Produces end-to-end video content through 12 production pipelines — from animated explainers and cinematic trailers to documentary montages and talking heads — with direct CMS node integration for first-party video/image generation.",
+    "name": "Growthub Agent Worker Kit \u2014 Open Montage Studio",
+    "description": "Self-contained local execution environment for OpenMontage agentic video production. Produces end-to-end video content through 12 production pipelines \u2014 from animated explainers and cinematic trailers to documentary montages and talking heads \u2014 with direct CMS node integration for first-party video/image generation.",
     "type": "worker",
     "visibility": "public-open-source",
     "sourceRepo": "growthub-local",
@@ -115,5 +115,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-14T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "studio"
 }

package/assets/worker-kits/growthub-postiz-social-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-postiz-social-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Postiz Social Media Studio",
+    "name": "Growthub Agent Worker Kit \u2014 Postiz Social Media Studio",
     "description": "Self-contained local execution environment for Postiz, the open-source agentic social media scheduler. Produces implementation-ready social media campaigns, content calendars, multi-platform publishing plans, AI-assisted captions, and analytics briefings across 28+ platforms including Instagram, LinkedIn, TikTok, X/Twitter, YouTube, Pinterest, Reddit, Bluesky, and more.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -112,5 +112,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-15T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "social-media"
 }

package/assets/worker-kits/growthub-twenty-crm-v1/kit.json

@@ -3,8 +3,8 @@
   "kit": {
     "id": "growthub-twenty-crm-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Twenty CRM",
-    "description": "Self-contained local execution environment for Twenty CRM — the open-source Salesforce/Apollo alternative. Produces CRM setup plans, data model designs, lead enrichment pipelines, pipeline automation briefs, webhook integration specs, API query plans, and client-ready CRM playbooks for teams adopting Twenty as their growth stack foundation.",
+    "name": "Growthub Agent Worker Kit \u2014 Twenty CRM",
+    "description": "Self-contained local execution environment for Twenty CRM \u2014 the open-source Salesforce/Apollo alternative. Produces CRM setup plans, data model designs, lead enrichment pipelines, pipeline automation briefs, webhook integration specs, API query plans, and client-ready CRM playbooks for teams adopting Twenty as their growth stack foundation.",
     "type": "worker",
     "visibility": "public-open-source",
     "sourceRepo": "growthub-local",
@@ -116,5 +116,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-15T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "crm"
 }

package/assets/worker-kits/growthub-video-use-studio-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-video-use-studio-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Video Use Studio",
+    "name": "Growthub Agent Worker Kit \u2014 Video Use Studio",
     "description": "Self-contained local execution environment for conversational video editing with browser-use/video-use. Produces implementation-ready video briefs, transcript-driven edit strategies, edit decision lists, render plans, and QA handoff artifacts for ElevenLabs Scribe + FFmpeg workflows.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -108,5 +108,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-23T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "studio"
 }

package/assets/worker-kits/growthub-zernio-social-v1/kit.json

@@ -3,7 +3,7 @@
   "kit": {
     "id": "growthub-zernio-social-v1",
     "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit — Zernio Social Media Studio",
+    "name": "Growthub Agent Worker Kit \u2014 Zernio Social Media Studio",
     "description": "Self-contained local execution environment for Zernio, the unified social media REST API for developers and AI agents. Produces implementation-ready social media campaigns, content calendars, multi-platform publishing plans, AI-assisted captions, Zernio-shaped scheduling manifests, recurring queue definitions, inbox reply plans, and analytics briefings across 14 platforms including X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, Snapchat, and WhatsApp.",
     "type": "worker",
     "visibility": "public-open-source",
@@ -144,5 +144,8 @@
   "provenance": {
     "sourceRepo": "growthub-local",
     "frozenAt": "2026-04-15T00:00:00.000Z"
-  }
+  },
+  "workspaceVisibility": "addon",
+  "workspaceCompatible": false,
+  "workspaceCategory": "social-media"
 }