@growthub/cli 0.9.8 → 0.9.10

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

@@ -1,7 +1,12 @@
 {
   "id": "workspace-builder-default",
-  "name": "Workspace Builder",
-  "description": "Default no-code composition for the official Growthub Custom Workspace Starter. The interface starts as a configurable dashboard-builder shell and can be customized by editing this file or by future governed UI controls.",
+  "name": "Growthub Workspace",
+  "description": "Default no-code composition for the official Growthub Custom Workspace Starter. The interface starts as a governed dashboard workspace and can be customized by editing this file or by future governed UI controls.",
+  "branding": {
+    "name": "Growthub Workspace",
+    "logoUrl": "",
+    "accent": "#3f68ff"
+  },
   "capabilities": [
     "dashboards",
     "canvas",
@@ -47,7 +52,7 @@
   },
   "provenance": {
     "createdBy": "cli",
-    "mirrors": "growthub-agency-portal-starter-v1",
+    "mirrors": "growthub-custom-workspace-starter-v1",
     "note": "Shipped with growthub-custom-workspace-starter-v1; safe to edit inside a governed fork and validate through the starter export smoke path."
   }
 }

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

@@ -1,11 +1,11 @@
 function readAdapterConfig() {
   return {
     deployTarget: "vercel",
-    dataAdapter: readEnum("AGENCY_PORTAL_DATA_ADAPTER", ["postgres", "qstash-kv", "provider-managed"], "provider-managed"),
-    authAdapter: readEnum("AGENCY_PORTAL_AUTH_ADAPTER", ["oidc", "clerk", "authjs", "provider-managed"], "provider-managed"),
-    paymentAdapter: readEnum("AGENCY_PORTAL_PAYMENT_ADAPTER", ["none", "stripe", "polar"], "none"),
-    integrationAdapter: readEnum("AGENCY_PORTAL_INTEGRATION_ADAPTER", ["growthub-bridge", "byo-api-key", "static"], "static"),
-    reportingAdapter: process.env.AGENCY_PORTAL_REPORTING_ADAPTER || void 0,
+    dataAdapter: readEnum(["GROWTHUB_WORKSPACE_DATA_ADAPTER", "AGENCY_PORTAL_DATA_ADAPTER"], ["postgres", "qstash-kv", "provider-managed"], "provider-managed"),
+    authAdapter: readEnum(["GROWTHUB_WORKSPACE_AUTH_ADAPTER", "AGENCY_PORTAL_AUTH_ADAPTER"], ["oidc", "clerk", "authjs", "provider-managed"], "provider-managed"),
+    paymentAdapter: readEnum(["GROWTHUB_WORKSPACE_PAYMENT_ADAPTER", "AGENCY_PORTAL_PAYMENT_ADAPTER"], ["none", "stripe", "polar"], "none"),
+    integrationAdapter: readEnum(["GROWTHUB_WORKSPACE_INTEGRATION_ADAPTER", "AGENCY_PORTAL_INTEGRATION_ADAPTER"], ["growthub-bridge", "byo-api-key", "static"], "static"),
+    reportingAdapter: process.env.GROWTHUB_WORKSPACE_REPORTING_ADAPTER || process.env.AGENCY_PORTAL_REPORTING_ADAPTER || void 0,
     growthubBridge: {
       baseUrl: process.env.GROWTHUB_BRIDGE_BASE_URL || void 0,
       integrationsPath: process.env.GROWTHUB_BRIDGE_INTEGRATIONS_PATH || "/api/mcp/accounts",
@@ -17,8 +17,10 @@ function readAdapterConfig() {
     }
   };
 }
-function readEnum(key, allowed, fallback) {
-  const value = process.env[key];
+function readEnum(keys, allowed, fallback) {
+  const keyList = Array.isArray(keys) ? keys : [keys];
+  const key = keyList.find((candidate) => process.env[candidate]);
+  const value = key ? process.env[key] : undefined;
   if (!value) return fallback;
   if (allowed.includes(value)) return value;
   throw new Error(`${key} must be one of: ${allowed.join(", ")}`);

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

@@ -1,6 +1,6 @@
 import { readAdapterConfig } from "@/lib/adapters/env";
 import {
-  agencyPortalIntegrationCatalog
+  governedWorkspaceIntegrationCatalog
 } from "@/lib/domain/integrations";
 import {
   normalizeGrowthubBridgePayload
@@ -19,7 +19,7 @@ function describeIntegrationAdapter() {
     return {
       id: "byo-api-key",
       label: "Bring your own API key",
-      requiredEnv: ["AGENCY_PORTAL_BYO_CONNECTIONS_JSON"],
+      requiredEnv: ["GROWTHUB_WORKSPACE_BYO_CONNECTIONS_JSON"],
       authority: "workspace-env"
     };
   }
@@ -30,16 +30,16 @@ function describeIntegrationAdapter() {
     authority: "local-catalog"
   };
 }
-async function listAgencyPortalIntegrations() {
+async function listGovernedWorkspaceIntegrations() {
   const config = readAdapterConfig();
   if (config.integrationAdapter !== "growthub-bridge") {
     if (config.integrationAdapter === "byo-api-key") {
       return mergeBringYourOwnRows(readBringYourOwnRows());
     }
-    return agencyPortalIntegrationCatalog;
+    return governedWorkspaceIntegrationCatalog;
   }
   if (!config.growthubBridge.baseUrl || !process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN) {
-    return agencyPortalIntegrationCatalog;
+    return governedWorkspaceIntegrationCatalog;
   }
   const url = new URL(config.growthubBridge.integrationsPath, config.growthubBridge.baseUrl);
   const headers = {
@@ -54,7 +54,7 @@ async function listAgencyPortalIntegrations() {
     next: { revalidate: 30 }
   });
   if (!response.ok) {
-    return agencyPortalIntegrationCatalog;
+    return governedWorkspaceIntegrationCatalog;
   }
   const payload = await response.json();
   const merged = mergeBridgeRows(normalizeGrowthubBridgePayload(payload));
@@ -80,7 +80,7 @@ function applyApiKeyOverlays(integrations, config) {
   });
 }
 function readBringYourOwnRows() {
-  const raw = process.env.AGENCY_PORTAL_BYO_CONNECTIONS_JSON;
+  const raw = process.env.GROWTHUB_WORKSPACE_BYO_CONNECTIONS_JSON || process.env.AGENCY_PORTAL_BYO_CONNECTIONS_JSON;
   const rows = [];
   if (process.env.WINDSOR_API_KEY) {
     rows.push({
@@ -129,7 +129,7 @@ function mergeBringYourOwnRows(rows) {
 }
 function mergeBridgeRows(rows) {
   const seenProviders = /* @__PURE__ */ new Set();
-  const merged = agencyPortalIntegrationCatalog.map((catalogItem) => {
+  const merged = governedWorkspaceIntegrationCatalog.map((catalogItem) => {
     const row = rows.find((item) => {
       const provider = item.provider || item.id;
       return provider === catalogItem.provider || item.id === catalogItem.id;
@@ -160,7 +160,7 @@ function mergeBridgeRows(rows) {
     const provider = row.provider || row.id;
     if (!provider) return false;
     if (seenProviders.has(provider)) return false;
-    return !agencyPortalIntegrationCatalog.some((item) => item.provider === provider || item.id === row.id);
+    return !governedWorkspaceIntegrationCatalog.some((item) => item.provider === provider || item.id === row.id);
   });
   return [...merged, ...discoveredRows.map(toDiscoveredIntegration)];
 }
@@ -194,5 +194,5 @@ function toDiscoveredIntegration(row) {
 }
 export {
   describeIntegrationAdapter,
-  listAgencyPortalIntegrations
+  listGovernedWorkspaceIntegrations
 };

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

@@ -172,7 +172,7 @@ const workspaceIntegrations = [
     setupMode: "hosted-authority"
   }
 ];
-const agencyPortalIntegrationCatalog = [...dataSources, ...workspaceIntegrations];
+const governedWorkspaceIntegrationCatalog = [...dataSources, ...workspaceIntegrations];
 function groupIntegrationsByLane(integrations) {
   return {
     dataSources: integrations.filter((item) => item.lane === "data-source"),
@@ -180,6 +180,6 @@ function groupIntegrationsByLane(integrations) {
   };
 }
 export {
-  agencyPortalIntegrationCatalog,
+  governedWorkspaceIntegrationCatalog,
   groupIntegrationsByLane
 };

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

@@ -1,3 +1,22 @@
+/**
+ * Workspace persistence — thin adapter boundary.
+ *
+ * Modes (Workspace Builder Runtime V1 contract — `docs/WORKSPACE_BUILDER_RUNTIME_V1.md`):
+ *
+ *   - `filesystem`    Local Next.js dev or any runtime that opts in via
+ *                     `WORKSPACE_CONFIG_ALLOW_FS_WRITE=true`. Save writes
+ *                     `growthub.config.json` on disk.
+ *   - `read-only`     Vercel / Netlify-style runtimes where the bundle is
+ *                     immutable. `PATCH /api/workspace` returns 409 with the
+ *                     same `guidance` string the no-code Save UI surfaces.
+ *   - `database` (future) Reserved adapter slot. Not implemented in V1 — the
+ *                     return shape is stable so a hosted adapter can be wired
+ *                     without changing UI or API contracts.
+ *
+ * `describePersistenceMode()` is the single source of truth the GET payload,
+ * the no-code Settings/Readiness panel, and the PATCH 409 path all read.
+ */
+
 import { promises as fs } from "node:fs";
 import path from "node:path";
 import { readAdapterConfig } from "@/lib/adapters/env";
@@ -8,6 +27,15 @@ import {
   validateWorkspaceConfig
 } from "@/lib/workspace-schema";
 
+const PERSISTENCE_ADAPTERS = Object.freeze({
+  FILESYSTEM: "filesystem",
+  READ_ONLY: "read-only",
+  DATABASE: "database"
+});
+
+const READ_ONLY_GUIDANCE =
+  "Edit growthub.config.json locally, or set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true on a writable runtime.";
+
 function resolveWorkspaceConfigPath() {
   return path.resolve(/*turbopackIgnore: true*/ process.cwd(), "growthub.config.json");
 }
@@ -18,23 +46,47 @@ async function readWorkspaceConfig() {
   return JSON.parse(raw);
 }
 
+/**
+ * `canSave` is a *logical* statement about adapter mode, not a *filesystem*
+ * guarantee. A `filesystem`-mode workspace whose `growthub.config.json` is
+ * actually read-only on disk (permission denied, RO mount) will still report
+ * `canSave: true`; the no-code Save UI surfaces the underlying fs error
+ * (workspace-builder.jsx#save → setConfigMessage) and PATCH returns 500 with
+ * the original error message. Read-only-mode 409 is the *contractual* not-save
+ * path and gets verbatim `guidance` instead.
+ */
 function describePersistenceMode() {
-  const target = process.env.AGENCY_PORTAL_DEPLOY_TARGET || "vercel";
+  const target = process.env.GROWTHUB_WORKSPACE_DEPLOY_TARGET || process.env.AGENCY_PORTAL_DEPLOY_TARGET || "vercel";
   const isReadOnlyDeploy = target === "vercel" || target === "netlify";
   const allowFsWrite = process.env.WORKSPACE_CONFIG_ALLOW_FS_WRITE === "true";
+  const baseFilesystem = (reason) => ({
+    mode: PERSISTENCE_ADAPTERS.FILESYSTEM,
+    adapter: PERSISTENCE_ADAPTERS.FILESYSTEM,
+    canSave: true,
+    saveLabel: "Save writes growthub.config.json on disk.",
+    reason,
+    nextAction: null,
+    guidance: null
+  });
   if (allowFsWrite) {
-    return { mode: "filesystem", reason: "WORKSPACE_CONFIG_ALLOW_FS_WRITE=true" };
+    return baseFilesystem("WORKSPACE_CONFIG_ALLOW_FS_WRITE=true");
   }
   if (process.env.NODE_ENV === "development") {
-    return { mode: "filesystem", reason: "Local Next.js development" };
+    return baseFilesystem("Local Next.js development");
   }
   if (isReadOnlyDeploy) {
+    const reason = `Deploy target ${target} treats the bundle as read-only. Set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true on a writable runtime, or wire a hosted persistence adapter.`;
     return {
-      mode: "read-only",
-      reason: `Deploy target ${target} treats the bundle as read-only. Set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true on a writable runtime, or wire a hosted persistence adapter.`
+      mode: PERSISTENCE_ADAPTERS.READ_ONLY,
+      adapter: PERSISTENCE_ADAPTERS.READ_ONLY,
+      canSave: false,
+      saveLabel: "Save is disabled in this runtime.",
+      reason,
+      nextAction: "Set WORKSPACE_CONFIG_ALLOW_FS_WRITE=true or connect a persistence adapter.",
+      guidance: READ_ONLY_GUIDANCE
     };
   }
-  return { mode: "filesystem", reason: "Local development" };
+  return baseFilesystem("Local development");
 }
 
 function applyPatch(currentConfig, patch) {
@@ -76,10 +128,11 @@ function applyPatch(currentConfig, patch) {
 async function writeWorkspaceConfig(patch) {
   const persistence = describePersistenceMode();
   const adapter = readAdapterConfig();
-  if (persistence.mode !== "filesystem") {
+  if (persistence.mode !== PERSISTENCE_ADAPTERS.FILESYSTEM || !persistence.canSave) {
     const error = new Error(persistence.reason);
     error.code = "WORKSPACE_PERSISTENCE_READ_ONLY";
     error.adapter = adapter.integrationAdapter;
+    error.guidance = persistence.guidance || READ_ONLY_GUIDANCE;
     throw error;
   }
   const current = await readWorkspaceConfig();
@@ -104,6 +157,8 @@ export {
   GRID_COLUMNS,
   GRID_ROWS,
   KNOWN_WIDGET_KINDS,
+  PERSISTENCE_ADAPTERS,
+  READ_ONLY_GUIDANCE,
   describePersistenceMode,
   readWorkspaceConfig,
   resolveWorkspaceConfigPath,

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

@@ -1,8 +1,51 @@
+/**
+ * Workspace Config Contract V1 — local source of truth.
+ *
+ * Authoritative reference: `docs/WORKSPACE_CONFIG_CONTRACT_V1.md`.
+ * Companion runtime doc: `docs/WORKSPACE_BUILDER_RUNTIME_V1.md`.
+ *
+ * This file owns the workspace config validator. The persisted file lives at
+ * `<workspace>/growthub.config.json`. The PATCH allowlist on `/api/workspace`
+ * is permanently restricted to:
+ *
+ *   - `dashboards`     dashboard rows (id, name, status, tabs, activeTabId)
+ *   - `widgetTypes`    palette of allowed widget kinds (label/icon)
+ *   - `canvas`         active canvas: layout, single-tab `widgets[]`, or
+ *                      multi-tab `tabs[]` + `activeTabId`, plus `bindings`
+ *
+ * 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.
+ *
+ * Canonical canvas shape (mutually exclusive — never both at once):
+ *
+ *   single-tab → `canvas.widgets[]`           (DO NOT also serialize tabs)
+ *   multi-tab  → `canvas.tabs[]` + `activeTabId` (DO NOT also serialize widgets)
+ *
+ * Import/export envelope: `{ version: 1, kind: "growthub-workspace-template",
+ * exportedAt, source, name, description, payload }`. Raw `{dashboards,
+ * widgetTypes, canvas}` payloads are also accepted for back-compat.
+ *
+ * Widget grid is a strict 12-column × 16-row fixed lattice with
+ * non-overlapping integer rectangles. Widget IDs are minted at clone time —
+ * template widgets intentionally omit `id`.
+ *
+ * Validation errors are surfaced as readable strings on the thrown error
+ * (`error.details: string[]`) so agents and the no-code Save UI can round-trip
+ * them without parsing a stack trace.
+ */
+
 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_DATA_BINDING_MODES = ["manual", "json", "csv"];
+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 WORKSPACE_TEMPLATE_KIND = "growthub-workspace-template";
 const WORKSPACE_TEMPLATE_VERSION = 1;
 const WORKSPACE_TEMPLATE_SOURCE = "growthub-custom-workspace-starter-v1";
@@ -23,7 +66,12 @@ const WIDGET_SCHEMA_CONTRACTS = {
     config: "kind-specific config object"
   },
   ChartWidgetConfig: {
-    values: "number[]",
+    values: "number[] (legacy preserved)",
+    chartType: `${KNOWN_CHART_TYPES.join(" | ")} optional, defaults to bar-vertical`,
+    xAxis: "ChartAxisConfig optional",
+    yAxis: "ChartAxisConfig optional",
+    style: "ChartStyleConfig optional",
+    filter: "FilterConfig optional",
     binding: "StaticDataBinding optional"
   },
   ViewWidgetConfig: {
@@ -31,8 +79,42 @@ const WIDGET_SCHEMA_CONTRACTS = {
     layout: "Table",
     columns: "string[]",
     rows: "record[]",
+    fieldSettings: "FieldSettingsConfig optional (hidden[], order[])",
+    sort: "SortClause[] optional ({ fieldId, direction })",
+    filter: "FilterConfig optional ({ op, clauses[] })",
     binding: "StaticDataBinding optional"
   },
+  ChartAxisConfig: {
+    field: "string optional",
+    sort: "string optional (asc | desc | position)",
+    aggregation: `${KNOWN_AGGREGATIONS.join(" | ")} optional`,
+    groupBy: "string optional",
+    omitZero: "boolean optional",
+    min: "string | number optional",
+    max: "string | number optional"
+  },
+  ChartStyleConfig: {
+    colors: "string optional (auto | manual swatch label)",
+    axisName: "string optional",
+    dataLabels: "boolean optional"
+  },
+  FieldSettingsConfig: {
+    hidden: "string[] of column names hidden from preview",
+    order: "string[] of column names defining custom order"
+  },
+  SortClause: {
+    fieldId: "non-empty string (column name)",
+    direction: KNOWN_SORT_DIRECTIONS.join(" | ")
+  },
+  FilterConfig: {
+    op: KNOWN_FILTER_CONJUNCTIONS.join(" | "),
+    clauses: "FilterClause[]"
+  },
+  FilterClause: {
+    fieldId: "non-empty string (column name)",
+    operator: KNOWN_FILTER_OPERATORS.join(" | "),
+    value: "string | number | boolean optional"
+  },
   IframeWidgetConfig: {
     url: "string"
   },
@@ -295,6 +377,127 @@ function validateStaticDataBinding(binding, path, errors) {
   if (binding.csv !== undefined && typeof binding.csv !== "string") {
     errors.push(`${path}.csv 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`);
+  }
+}
+
+function validateFieldSettings(fieldSettings, path, errors) {
+  if (fieldSettings === undefined) return;
+  if (!isPlainObject(fieldSettings)) {
+    errors.push(`${path} must be a plain object`);
+    return;
+  }
+  if (fieldSettings.hidden !== undefined) validateStringArray(fieldSettings.hidden, `${path}.hidden`, errors);
+  if (fieldSettings.order !== undefined) validateStringArray(fieldSettings.order, `${path}.order`, errors);
+}
+
+function validateSortClauses(sort, path, errors) {
+  if (sort === undefined) return;
+  if (!Array.isArray(sort)) {
+    errors.push(`${path} must be an array`);
+    return;
+  }
+  sort.forEach((clause, index) => {
+    const prefix = `${path}[${index}]`;
+    if (!isPlainObject(clause)) {
+      errors.push(`${prefix} must be a plain object`);
+      return;
+    }
+    if (typeof clause.fieldId !== "string" || !clause.fieldId) {
+      errors.push(`${prefix}.fieldId must be a non-empty string`);
+    }
+    if (clause.direction !== undefined && !KNOWN_SORT_DIRECTIONS.includes(clause.direction)) {
+      errors.push(`${prefix}.direction must be one of ${KNOWN_SORT_DIRECTIONS.join(", ")}`);
+    }
+  });
+}
+
+function validateFilterClauses(filter, path, errors) {
+  if (filter === undefined) return;
+  if (!isPlainObject(filter)) {
+    errors.push(`${path} must be a plain object`);
+    return;
+  }
+  if (filter.op !== undefined && !KNOWN_FILTER_CONJUNCTIONS.includes(filter.op)) {
+    errors.push(`${path}.op must be one of ${KNOWN_FILTER_CONJUNCTIONS.join(", ")}`);
+  }
+  if (filter.clauses !== undefined) {
+    if (!Array.isArray(filter.clauses)) {
+      errors.push(`${path}.clauses must be an array`);
+    } else {
+      filter.clauses.forEach((clause, index) => {
+        const prefix = `${path}.clauses[${index}]`;
+        if (!isPlainObject(clause)) {
+          errors.push(`${prefix} must be a plain object`);
+          return;
+        }
+        if (typeof clause.fieldId !== "string" || !clause.fieldId) {
+          errors.push(`${prefix}.fieldId must be a non-empty string`);
+        }
+        if (clause.operator !== undefined && !KNOWN_FILTER_OPERATORS.includes(clause.operator)) {
+          errors.push(`${prefix}.operator must be one of ${KNOWN_FILTER_OPERATORS.join(", ")}`);
+        }
+        if (
+          clause.value !== undefined &&
+          typeof clause.value !== "string" &&
+          typeof clause.value !== "number" &&
+          typeof clause.value !== "boolean"
+        ) {
+          errors.push(`${prefix}.value must be a string, number, or boolean`);
+        }
+      });
+    }
+  }
+}
+
+function validateChartAxis(axis, path, errors) {
+  if (axis === undefined) return;
+  if (!isPlainObject(axis)) {
+    errors.push(`${path} must be a plain object`);
+    return;
+  }
+  if (axis.field !== undefined && typeof axis.field !== "string") {
+    errors.push(`${path}.field must be a string`);
+  }
+  if (axis.sort !== undefined && typeof axis.sort !== "string") {
+    errors.push(`${path}.sort must be a string`);
+  }
+  if (axis.aggregation !== undefined && !KNOWN_AGGREGATIONS.includes(axis.aggregation)) {
+    errors.push(`${path}.aggregation must be one of ${KNOWN_AGGREGATIONS.join(", ")}`);
+  }
+  if (axis.groupBy !== undefined && typeof axis.groupBy !== "string") {
+    errors.push(`${path}.groupBy must be a string`);
+  }
+  if (axis.omitZero !== undefined && typeof axis.omitZero !== "boolean") {
+    errors.push(`${path}.omitZero must be a boolean`);
+  }
+  if (axis.min !== undefined && typeof axis.min !== "string" && typeof axis.min !== "number") {
+    errors.push(`${path}.min must be a string or number`);
+  }
+  if (axis.max !== undefined && typeof axis.max !== "string" && typeof axis.max !== "number") {
+    errors.push(`${path}.max must be a string or number`);
+  }
+}
+
+function validateChartStyle(style, path, errors) {
+  if (style === undefined) return;
+  if (!isPlainObject(style)) {
+    errors.push(`${path} must be a plain object`);
+    return;
+  }
+  if (style.colors !== undefined && typeof style.colors !== "string") {
+    errors.push(`${path}.colors must be a string`);
+  }
+  if (style.axisName !== undefined && typeof style.axisName !== "string") {
+    errors.push(`${path}.axisName must be a string`);
+  }
+  if (style.dataLabels !== undefined && typeof style.dataLabels !== "boolean") {
+    errors.push(`${path}.dataLabels must be a boolean`);
+  }
 }
 
 function validateWidgetConfig(kind, config, path, errors) {
@@ -315,6 +518,13 @@ function validateWidgetConfig(kind, config, path, errors) {
         });
       }
     }
+    if (config.chartType !== undefined && !KNOWN_CHART_TYPES.includes(config.chartType)) {
+      errors.push(`${path}.chartType must be one of ${KNOWN_CHART_TYPES.join(", ")}`);
+    }
+    validateChartAxis(config.xAxis, `${path}.xAxis`, errors);
+    validateChartAxis(config.yAxis, `${path}.yAxis`, errors);
+    validateChartStyle(config.style, `${path}.style`, errors);
+    validateFilterClauses(config.filter, `${path}.filter`, errors);
     validateStaticDataBinding(config.binding, `${path}.binding`, errors);
   }
   if (kind === "view") {
@@ -322,6 +532,9 @@ function validateWidgetConfig(kind, config, path, errors) {
     if (config.layout !== undefined && config.layout !== "Table") errors.push(`${path}.layout must be Table`);
     if (config.columns !== undefined) validateStringArray(config.columns, `${path}.columns`, errors);
     if (config.rows !== undefined && !Array.isArray(config.rows)) errors.push(`${path}.rows must be an array`);
+    validateFieldSettings(config.fieldSettings, `${path}.fieldSettings`, errors);
+    validateSortClauses(config.sort, `${path}.sort`, errors);
+    validateFilterClauses(config.filter, `${path}.filter`, errors);
     validateStaticDataBinding(config.binding, `${path}.binding`, errors);
   }
   if (kind === "iframe" && config.url !== undefined && typeof config.url !== "string") {
@@ -749,8 +962,13 @@ export {
   DASHBOARD_TEMPLATES,
   GRID_COLUMNS,
   GRID_ROWS,
+  KNOWN_AGGREGATIONS,
+  KNOWN_CHART_TYPES,
   KNOWN_DATA_BINDING_MODES,
   KNOWN_FIELDS,
+  KNOWN_FILTER_CONJUNCTIONS,
+  KNOWN_FILTER_OPERATORS,
+  KNOWN_SORT_DIRECTIONS,
   KNOWN_WIDGET_KINDS,
   SAMPLE_DATA_BINDINGS,
   SAMPLE_VIEW_ROWS,

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

@@ -8,15 +8,10 @@
       "name": "growthub-workspace-app",
       "version": "1.0.0",
       "dependencies": {
+        "lucide-react": "^0.468.0",
         "next": "16.2.4",
         "react": "19.2.4",
         "react-dom": "19.2.4"
-      },
-      "devDependencies": {
-        "@types/node": "^20",
-        "@types/react": "^19",
-        "@types/react-dom": "^19",
-        "typescript": "^5"
       }
     },
     "node_modules/@emnapi/runtime": {
@@ -638,36 +633,6 @@
         "tslib": "^2.8.0"
       }
     },
-    "node_modules/@types/node": {
-      "version": "20.19.39",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.39.tgz",
-      "integrity": "sha512-orrrD74MBUyK8jOAD/r0+lfa1I2MO6I+vAkmAWzMYbCcgrN4lCrmK52gRFQq/JRxfYPfonkr4b0jcY7Olqdqbw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "undici-types": "~6.21.0"
-      }
-    },
-    "node_modules/@types/react": {
-      "version": "19.2.14",
-      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz",
-      "integrity": "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "csstype": "^3.2.2"
-      }
-    },
-    "node_modules/@types/react-dom": {
-      "version": "19.2.3",
-      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.3.tgz",
-      "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==",
-      "dev": true,
-      "license": "MIT",
-      "peerDependencies": {
-        "@types/react": "^19.2.0"
-      }
-    },
     "node_modules/baseline-browser-mapping": {
       "version": "2.10.21",
       "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.21.tgz",
@@ -706,13 +671,6 @@
       "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==",
       "license": "MIT"
     },
-    "node_modules/csstype": {
-      "version": "3.2.3",
-      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
-      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/detect-libc": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
@@ -723,6 +681,15 @@
         "node": ">=8"
       }
     },
+    "node_modules/lucide-react": {
+      "version": "0.468.0",
+      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.468.0.tgz",
+      "integrity": "sha512-6koYRhnM2N0GGZIdXzSeiNwguv1gt/FAjZOiPl76roBi3xKEXa4WmfpxgQwTTL4KipXjefrnf3oV4IsYhi4JFA==",
+      "license": "ISC",
+      "peerDependencies": {
+        "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0-rc"
+      }
+    },
     "node_modules/nanoid": {
       "version": "3.3.11",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
@@ -950,27 +917,6 @@
       "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
       "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
       "license": "0BSD"
-    },
-    "node_modules/typescript": {
-      "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "bin": {
-        "tsc": "bin/tsc",
-        "tsserver": "bin/tsserver"
-      },
-      "engines": {
-        "node": ">=14.17"
-      }
-    },
-    "node_modules/undici-types": {
-      "version": "6.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
-      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
-      "dev": true,
-      "license": "MIT"
     }
   }
 }

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

@@ -10,6 +10,7 @@
     "lint": "next lint"
   },
   "dependencies": {
+    "lucide-react": "^0.468.0",
     "next": "16.2.4",
     "react": "19.2.4",
     "react-dom": "19.2.4"

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

@@ -73,9 +73,12 @@
     "apps/workspace/app/layout.jsx",
     "apps/workspace/app/page.jsx",
     "apps/workspace/app/globals.css",
+    "apps/workspace/app/workspace-builder.jsx",
     "apps/workspace/app/settings/integrations/page.jsx",
     "apps/workspace/app/api/workspace/route.js",
     "apps/workspace/app/api/settings/integrations/route.js",
+    "apps/workspace/lib/workspace-schema.js",
+    "apps/workspace/lib/workspace-config.js",
     "apps/workspace/lib/domain/portal.js",
     "apps/workspace/lib/domain/integrations.js",
     "apps/workspace/lib/adapters/env.js",