@growthub/cli 0.9.11 → 0.9.13

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/workspace-builder.jsx

@@ -57,6 +57,7 @@ import {
   wrapWorkspaceTemplateExport
 } from "@/lib/workspace-schema";
 import { governedWorkspaceIntegrationCatalog } from "@/lib/domain/integrations";
+import { listWorkspaceDataModelTables } from "@/lib/workspace-data-model";
 
 const DEFAULT_CHART_TYPE = "bar-vertical";
 const DEFAULT_FILTER_OP = "and";
@@ -65,6 +66,7 @@ const DEFAULT_SORT_DIRECTION = "asc";
 const SUB_PANEL_ROOT = "root";
 const MANAGED_INTEGRATION_SOURCE_TYPE = "managed-integrations";
 const CUSTOM_API_SOURCE_TYPE = "custom-api-webhooks";
+const DATA_MODEL_SOURCE_TYPE = "workspace-data-model";
 
 const SOURCE_TYPE_OBJECTS = [
   {
@@ -144,10 +146,20 @@ function generateId(prefix) {
   return `${prefix}_${Math.random().toString(36).slice(2, 10)}_${Date.now().toString(36)}`;
 }
 
+function textColorForAccent(accent) {
+  const hex = String(accent || "").replace("#", "");
+  if (!/^[0-9a-f]{6}$/i.test(hex)) return "#ffffff";
+  const red = parseInt(hex.slice(0, 2), 16);
+  const green = parseInt(hex.slice(2, 4), 16);
+  const blue = parseInt(hex.slice(4, 6), 16);
+  const luminance = (0.299 * red + 0.587 * green + 0.114 * blue) / 255;
+  return luminance > 0.62 ? "#252525" : "#ffffff";
+}
+
 function defaultTitleFor(kind) {
   switch (kind) {
     case "chart": return "Untitled chart";
-    case "view": return "Companies";
+    case "view": return "Untitled view";
     case "iframe": return "Untitled iFrame";
     case "rich-text": return "Untitled Rich Text";
     default: return "Untitled widget";
@@ -641,6 +653,7 @@ function getChartStyle(widget) {
 
 function summarizeSource(widget) {
   const binding = widget?.config?.binding;
+  if (binding?.sourceType === DATA_MODEL_SOURCE_TYPE) return binding.source || widget?.config?.source || "Data Model object";
   if (binding?.mode === "integration") {
     const source = binding.source || "Integration";
     if (binding.entityLabel) return `${source} · ${binding.entityLabel}`;
@@ -652,6 +665,7 @@ function summarizeSource(widget) {
 }
 
 function summarizeSourceType(binding) {
+  if (binding?.sourceType === DATA_MODEL_SOURCE_TYPE) return "Data Model";
   if (binding?.sourceType === CUSTOM_API_SOURCE_TYPE) return "Custom APIs/Webhooks";
   if (binding?.mode === "integration" || binding?.sourceType === MANAGED_INTEGRATION_SOURCE_TYPE) return "Managed Integrations";
   return "Static data";
@@ -663,6 +677,27 @@ function resolveBindingSourceType(binding) {
   return "static";
 }
 
+function resolveDataModelTable(dataModelTables, binding) {
+  if (binding?.sourceType !== DATA_MODEL_SOURCE_TYPE) return null;
+  const tables = Array.isArray(dataModelTables) ? dataModelTables : [];
+  return tables.find((table) => table.objectId === binding.objectId || table.id === binding.objectId || table.source === binding.source) || null;
+}
+
+function resolveViewWidget(widget, dataModelTables) {
+  if (widget?.kind !== "view") return widget;
+  const table = resolveDataModelTable(dataModelTables, widget.config?.binding);
+  if (!table) return widget;
+  return {
+    ...widget,
+    config: {
+      ...(widget.config || {}),
+      source: table.source,
+      columns: table.columns,
+      rows: table.rows
+    }
+  };
+}
+
 function summarizeFields(widget) {
   const total = getColumnList(widget).length;
   const hidden = getHiddenColumnSet(widget).size;
@@ -1061,7 +1096,7 @@ function EntitySelector({ integration, entities, selectedEntityId, selectedEntit
   </div>;
 }
 
-function SourceSubPanel({ widget, integrations, onChange, onBack }) {
+function SourceSubPanel({ widget, integrations, dataModelTables, onChange, onBack }) {
   const binding = widget.config?.binding || {};
   const currentMode = binding.mode || (widget.kind === "view" ? "manual" : "json");
 	  const activeSourceType = resolveBindingSourceType(binding);
@@ -1070,6 +1105,7 @@ function SourceSubPanel({ widget, integrations, onChange, onBack }) {
   const hasConnectedSource = Boolean(
     binding.integrationId ||
     binding.endpointRef ||
+    binding.sourceType === DATA_MODEL_SOURCE_TYPE ||
     binding.sourceType === MANAGED_INTEGRATION_SOURCE_TYPE ||
     binding.sourceType === CUSTOM_API_SOURCE_TYPE
   );
@@ -1098,6 +1134,16 @@ function SourceSubPanel({ widget, integrations, onChange, onBack }) {
     };
   }, [integrations, laneFilter, query]);
 
+  const availableDataObjects = useMemo(() => {
+    const list = Array.isArray(dataModelTables) ? dataModelTables : [];
+    const trimmed = query.trim().toLowerCase();
+    return list.filter((table) => {
+      if (table.storage !== "manual-object") return false;
+      if (!trimmed) return true;
+      return `${table.label} ${table.source}`.toLowerCase().includes(trimmed);
+    });
+  }, [dataModelTables, query]);
+
 	  const selectStatic = useCallback(() => {
     if (!confirmSourceChange("Static rows")) return;
 	    if (widget.kind === "chart") {
@@ -1105,12 +1151,34 @@ function SourceSubPanel({ widget, integrations, onChange, onBack }) {
     } else {
       onChange({
         ...widget.config,
-        source: widget.config?.source || "Companies",
-        binding: SAMPLE_DATA_BINDINGS.companiesManual
+        source: widget.config?.source || "Static rows",
+        binding: { mode: "manual", source: "Static rows", rows: Array.isArray(widget.config?.rows) ? widget.config.rows : [] }
       });
     }
 	  }, [confirmSourceChange, onChange, widget.config, widget.kind]);
 
+  const selectDataModelObject = useCallback((table) => {
+    if (!table || !confirmSourceChange(table.label)) return;
+    onChange({
+      ...widget.config,
+      source: table.source,
+      columns: table.columns,
+      rows: [],
+      binding: {
+        mode: "manual",
+        source: table.source,
+        sourceType: DATA_MODEL_SOURCE_TYPE,
+        sourceAuthority: "workspace-config",
+        objectId: table.objectId,
+        rows: []
+      },
+      fieldSettings: {
+        hidden: [],
+        order: table.columns
+      }
+    });
+  }, [confirmSourceChange, onChange, widget.config]);
+
 	  const selectCustomApi = useCallback(() => {
     if (!confirmSourceChange("Custom APIs/Webhooks")) return;
 	    onChange({
@@ -1238,6 +1306,27 @@ function SourceSubPanel({ widget, integrations, onChange, onBack }) {
         {activeSourceType === "static" ? <span className="workspace-source-tick" aria-hidden="true"><Check size={16} strokeWidth={2.4} /></span> : null}
       </button>
     </div>
+    {widget.kind === "view" ? <>
+      <p className="workspace-panel-label">Data Model objects</p>
+      <div className="workspace-source-list">
+        {availableDataObjects.length ? availableDataObjects.map((table) => {
+          const isActive = binding.sourceType === DATA_MODEL_SOURCE_TYPE && binding.objectId === table.objectId;
+          return <button
+            key={table.id}
+            type="button"
+            className={`workspace-source-row${isActive ? " active" : ""}`}
+            onClick={() => selectDataModelObject(table)}
+          >
+            <span className="workspace-source-icon" aria-hidden="true"><Database size={15} /></span>
+            <span className="workspace-source-meta">
+              <strong>{table.label}</strong>
+              <em>{table.columns.length} fields · {table.rows.length} records · workspace config</em>
+            </span>
+            {isActive ? <span className="workspace-source-tick" aria-hidden="true"><Check size={16} strokeWidth={2.4} /></span> : null}
+          </button>;
+        }) : <p className="workspace-entity-empty">No manual Data Model objects yet.</p>}
+      </div>
+    </> : null}
     {Object.entries(groups).map(([lane, items]) => items.length ? <div key={lane}>
       <p className="workspace-panel-label">{lane === "data-source" ? "Data Sources" : "Workspace Tools"}</p>
       <div className="workspace-source-list">
@@ -1289,22 +1378,24 @@ function SourceSubPanel({ widget, integrations, onChange, onBack }) {
   </section>;
 }
 
-function FieldsSubPanel({ widget, onChange, onBack }) {
-  const ordered = getOrderedColumns(widget);
-  const hidden = getHiddenColumnSet(widget);
+function FieldsSubPanel({ widget, dataModelTable, onChange, onBack }) {
+  const viewWidget = dataModelTable ? resolveViewWidget(widget, [dataModelTable]) : widget;
+  const ordered = getOrderedColumns(viewWidget);
+  const hidden = getHiddenColumnSet(viewWidget);
   const visible = ordered.filter((name) => !hidden.has(name));
   const hiddenList = ordered.filter((name) => hidden.has(name));
   const [hiddenOpen, setHiddenOpen] = useState(true);
   const [draftField, setDraftField] = useState("");
   const move = (fieldId, direction) => {
-    const next = reorderColumn(widget, fieldId, direction);
+    const next = reorderColumn(viewWidget, fieldId, direction);
     onChange({ ...widget.config, fieldSettings: next });
   };
   const toggle = (fieldId) => {
-    const next = toggleColumnHidden(widget, fieldId);
+    const next = toggleColumnHidden(viewWidget, fieldId);
     onChange({ ...widget.config, fieldSettings: next });
   };
   const removeColumn = (fieldId) => {
+    if (dataModelTable) return;
     const nextColumns = ordered.filter((name) => name !== fieldId);
     const fs = widget.config?.fieldSettings || {};
     onChange({
@@ -1317,6 +1408,7 @@ function FieldsSubPanel({ widget, onChange, onBack }) {
     });
   };
   const addColumn = () => {
+    if (dataModelTable) return;
     const trimmed = draftField.trim();
     if (!trimmed || ordered.includes(trimmed)) return;
     onChange({ ...widget.config, columns: [...ordered, trimmed] });
@@ -1324,6 +1416,7 @@ function FieldsSubPanel({ widget, onChange, onBack }) {
   };
   return <section className="workspace-widget-subpanel">
     <SubPanelHeader title="Fields" breadcrumb={widget.title} onBack={onBack} />
+    {dataModelTable ? <p className="workspace-panel-hint">This View is bound to a Data Model object. Field order and visibility are widget-local; add or remove object fields on the Data Model page.</p> : null}
     <p className="workspace-panel-label">Visible fields</p>
     <div className="workspace-field-rows">
       {visible.length === 0 ? <p className="workspace-panel-hint">No visible fields. Add one below or unhide an existing field.</p> : null}
@@ -1335,7 +1428,7 @@ function FieldsSubPanel({ widget, onChange, onBack }) {
           <button type="button" aria-label={`Move ${name} up`} disabled={index === 0} onClick={() => move(name, "up")}>↑</button>
           <button type="button" aria-label={`Move ${name} down`} disabled={index === visible.length - 1} onClick={() => move(name, "down")}>↓</button>
           <button type="button" aria-label={`Hide ${name}`} onClick={() => toggle(name)}>👁</button>
-          <button type="button" aria-label={`Remove ${name}`} onClick={() => removeColumn(name)}>✕</button>
+          <button type="button" aria-label={`Remove ${name}`} disabled={Boolean(dataModelTable)} onClick={() => removeColumn(name)}>✕</button>
         </span>
       </div>)}
     </div>
@@ -1355,7 +1448,7 @@ function FieldsSubPanel({ widget, onChange, onBack }) {
         <span className="workspace-field-row-name">{name}</span>
         <span className="workspace-field-row-actions">
           <button type="button" aria-label={`Show ${name}`} onClick={() => toggle(name)}>👁</button>
-          <button type="button" aria-label={`Remove ${name}`} onClick={() => removeColumn(name)}>✕</button>
+          <button type="button" aria-label={`Remove ${name}`} disabled={Boolean(dataModelTable)} onClick={() => removeColumn(name)}>✕</button>
         </span>
       </div>)}
     </div> : null}
@@ -1372,14 +1465,15 @@ function FieldsSubPanel({ widget, onChange, onBack }) {
           }
         }}
       />
-      <button type="button" onClick={addColumn} disabled={!draftField.trim()}>Add</button>
+      <button type="button" onClick={addColumn} disabled={Boolean(dataModelTable) || !draftField.trim()}>Add</button>
     </div>
   </section>;
 }
 
-function SortSubPanel({ widget, onChange, onBack }) {
+function SortSubPanel({ widget, dataModelTable, onChange, onBack }) {
+  const viewWidget = dataModelTable ? resolveViewWidget(widget, [dataModelTable]) : widget;
   const sort = getSortClauses(widget);
-  const columns = getColumnList(widget);
+  const columns = getColumnList(viewWidget);
   const updateSort = (next) => onChange({ ...widget.config, sort: next });
   const addClause = () => {
     const fieldId = columns[0] || "";
@@ -1423,12 +1517,13 @@ function SortSubPanel({ widget, onChange, onBack }) {
   </section>;
 }
 
-function FilterSubPanel({ widget, integrations, onChange, onBack }) {
+function FilterSubPanel({ widget, integrations, dataModelTable, onChange, onBack }) {
+  const viewWidget = dataModelTable ? resolveViewWidget(widget, [dataModelTable]) : widget;
   const binding = widget.config?.binding || {};
   const filter = getFilterConfig(widget);
   const [entities, setEntities] = useState([]);
   const [entitiesLoading, setEntitiesLoading] = useState(false);
-  const fieldChoices = getFilterFieldChoices(widget, entities);
+  const fieldChoices = getFilterFieldChoices(viewWidget, entities);
   const columns = fieldChoices.map((field) => field.id);
   const setFilter = (next) => onChange({ ...widget.config, filter: next });
   const setOp = (op) => setFilter({ ...filter, op });
@@ -2000,7 +2095,7 @@ function WorkspaceSettingsPanel({ config, persistence, adapterConfig, integratio
         Inspect-only. Sourced from <code>growthub.config.json</code> + <code>GET /api/workspace</code>.
         Edit branding by updating <code>growthub.config.json</code> inside your governed fork.
         The builder itself never holds tokens, never executes hosted workflows, and never bypasses the PATCH allowlist
-        (<code>dashboards</code>, <code>widgetTypes</code>, <code>canvas</code>).
+        (<code>dashboards</code>, <code>widgetTypes</code>, <code>canvas</code>, <code>dataModel</code>).
       </p>
       <div className="workspace-readiness">
         <article className="workspace-readiness-section">
@@ -2081,7 +2176,7 @@ function WorkspaceManagementPanel({ config, persistence, adapterConfig, onClose
         </article>
         <article className="workspace-readiness-section">
           <h3>API</h3>
-          <div className="workspace-readiness-row"><span>PATCH allowlist</span><code>dashboards | widgetTypes | canvas</code></div>
+          <div className="workspace-readiness-row"><span>PATCH allowlist</span><code>dashboards | widgetTypes | canvas | dataModel</code></div>
           <div className="workspace-readiness-row"><span>Unknown field</span><code>400</code></div>
           <div className="workspace-readiness-row"><span>Read-only runtime</span><code>409 + guidance</code></div>
           <div className="workspace-readiness-row"><span>Can save now</span>
@@ -2175,6 +2270,8 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
   const addSlot = dragPreview || selectedPosition;
   const selectedWidget = activeWidgets.find((widget) => widget.id === selectedWidgetId) || null;
   const availableIntegrations = useMemo(() => flattenIntegrationSettings(integrationSettings), [integrationSettings]);
+  const dataModelTables = useMemo(() => listWorkspaceDataModelTables(config), [config]);
+  const selectedResolvedWidget = selectedWidget ? resolveViewWidget(selectedWidget, dataModelTables) : null;
   const branding = config.branding || {};
   const occupiedCells = useMemo(() => {
     const cells = new Set();
@@ -3013,7 +3110,7 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
     });
     list.push({
       id: "workspace.settings", group: "Workspace", icon: Settings, label: "Go to Workspace Settings", shortcut: "G S",
-      run: () => setSettingsOpen(true)
+      run: () => { window.location.href = "/settings/general"; }
     });
     list.push({
       id: "workspace.management", group: "Workspace", icon: Bolt, label: "Go to Management",
@@ -3050,14 +3147,20 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
   return <main className="workspace-builder" onPointerDownCapture={resetWidgetSelectionOnOutsidePointer} style={builderStyle}>
       <aside className="workspace-rail" aria-label="Workspace navigation">
         <div className="workspace-brand">
-          <span className="workspace-mark">G</span>
-          <span>Growthub Workspace</span>
+          <span className="workspace-mark" style={{
+            background: branding.logoUrl ? undefined : branding.accent || undefined,
+            color: branding.logoUrl ? undefined : textColorForAccent(branding.accent)
+          }}>
+            {branding.logoUrl ? <img src={branding.logoUrl} alt="" /> : (branding.name || config.name || "Growthub Workspace").slice(0, 1).toUpperCase()}
+          </span>
+          <span>{branding.name || config.name || "Growthub Workspace"}</span>
         </div>
         <nav className="workspace-nav">
           <button type="button" className={workspaceView === "dashboards" ? "active workspace-nav-button" : "workspace-nav-button"} onClick={showDashboardHome}>Dashboards</button>
+          <Link href="/data-model">Data Model</Link>
           <Link href="/settings/integrations">Integrations</Link>
-          <button type="button" className="workspace-nav-button" onClick={() => setSettingsOpen(true)}>Workspace Settings</button>
           <button type="button" className="workspace-nav-button" onClick={() => setManagementOpen(true)}>Management</button>
+          <Link className="workspace-nav-bottom" href="/settings/general">Workspace Settings</Link>
         </nav>
         <div className="workspace-rail-status">
           <span className="status-dot" />
@@ -3246,7 +3349,7 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
               onSelect={() => selectWidget(widget.id)}
               onExpandIframe={setExpandedIframeWidget}
               selected={widget.id === selectedWidgetId}
-              widget={widget}
+              widget={resolveViewWidget(widget, dataModelTables)}
             />)}
           </div>
         </section> : null}
@@ -3292,22 +3395,26 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
         {selectedWidget && inspectorPath === "source" ? <SourceSubPanel
           widget={selectedWidget}
           integrations={availableIntegrations}
+          dataModelTables={dataModelTables}
           onChange={replaceSelectedWidgetConfig}
           onBack={() => setInspectorPath(SUB_PANEL_ROOT)}
         /> : null}
         {selectedWidget && inspectorPath === "fields" ? <FieldsSubPanel
           widget={selectedWidget}
+          dataModelTable={resolveDataModelTable(dataModelTables, selectedWidget.config?.binding)}
           onChange={replaceSelectedWidgetConfig}
           onBack={() => setInspectorPath(SUB_PANEL_ROOT)}
         /> : null}
         {selectedWidget && inspectorPath === "sort" ? <SortSubPanel
           widget={selectedWidget}
+          dataModelTable={resolveDataModelTable(dataModelTables, selectedWidget.config?.binding)}
           onChange={replaceSelectedWidgetConfig}
           onBack={() => setInspectorPath(SUB_PANEL_ROOT)}
         /> : null}
         {selectedWidget && inspectorPath === "filter" ? <FilterSubPanel
           widget={selectedWidget}
           integrations={availableIntegrations}
+          dataModelTable={resolveDataModelTable(dataModelTables, selectedWidget.config?.binding)}
           onChange={replaceSelectedWidgetConfig}
           onBack={() => setInspectorPath(SUB_PANEL_ROOT)}
         /> : null}
@@ -3370,7 +3477,11 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
             </small>
           </label> : null}
           {selectedWidget.kind === "view" ? <section className="workspace-field-stack">
-            <label>
+            {selectedWidget.config?.binding?.sourceType === DATA_MODEL_SOURCE_TYPE ? <div className="workspace-active-source-state">
+              <span>Data Model object</span>
+              <strong>{summarizeSource(selectedWidget)}</strong>
+              <code>{selectedWidget.config?.binding?.objectId || "workspace-config"}</code>
+            </div> : <label>
               <span>Manual Rows</span>
               <textarea
                 value={serializeManualRows(selectedWidget.config?.rows || [], selectedWidget.config?.columns || [])}
@@ -3382,7 +3493,7 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
                   });
                 }}
               />
-            </label>
+            </label>}
             <div className="workspace-settings-list" role="group" aria-label="View widget settings">
               <p className="workspace-panel-label">Settings</p>
               <button type="button" className="workspace-settings-row" disabled>
@@ -3392,13 +3503,13 @@ function WorkspaceBuilder({ initialConfig, adapterConfig, integrationAdapter, in
                 <span>Source</span><code>{summarizeSource(selectedWidget)}</code>
               </button>
               <button type="button" className="workspace-settings-row" onClick={() => setInspectorPath("fields")}>
-                <span>Fields</span><code>{summarizeFields(selectedWidget)}</code>
+                <span>Fields</span><code>{summarizeFields(selectedResolvedWidget || selectedWidget)}</code>
               </button>
               <button type="button" className="workspace-settings-row" onClick={() => setInspectorPath("filter")}>
-                <span>Filter</span><code>{summarizeFilter(selectedWidget)}</code>
+                <span>Filter</span><code>{summarizeFilter(selectedResolvedWidget || selectedWidget)}</code>
               </button>
               <button type="button" className="workspace-settings-row" onClick={() => setInspectorPath("sort")}>
-                <span>Sort</span><code>{summarizeSort(selectedWidget)}</code>
+                <span>Sort</span><code>{summarizeSort(selectedResolvedWidget || selectedWidget)}</code>
               </button>
             </div>
           </section> : null}

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

@@ -93,6 +93,7 @@ function applyPatch(currentConfig, patch) {
   const next = { ...currentConfig };
   if (patch.dashboards !== undefined) next.dashboards = patch.dashboards;
   if (patch.widgetTypes !== undefined) next.widgetTypes = patch.widgetTypes;
+  if (patch.dataModel !== undefined) next.dataModel = patch.dataModel;
   if (patch.canvas !== undefined && patch.canvas !== null) {
     const patchCanvas = { ...patch.canvas };
     if (Array.isArray(patchCanvas.tabs)) {
@@ -140,7 +141,8 @@ async function writeWorkspaceConfig(patch) {
   validateWorkspaceConfig({
     dashboards: next.dashboards,
     widgetTypes: next.widgetTypes,
-    canvas: next.canvas
+    canvas: next.canvas,
+    dataModel: next.dataModel
   });
   const configPath = resolveWorkspaceConfigPath();
   const expectedDir = path.resolve(/*turbopackIgnore: true*/ process.cwd());
@@ -153,6 +155,189 @@ async function writeWorkspaceConfig(patch) {
   return next;
 }
 
+function normalizeWorkspaceIdentityPatch(patch) {
+  if (!patch || typeof patch !== "object" || Array.isArray(patch)) {
+    const error = new Error("settings patch must be a plain object");
+    error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+    throw error;
+  }
+
+  const allowed = new Set(["name", "branding"]);
+  const unknown = Object.keys(patch).filter((key) => !allowed.has(key));
+  if (unknown.length) {
+    const error = new Error("settings patch contains unknown fields");
+    error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+    error.details = unknown;
+    throw error;
+  }
+
+  const normalized = {};
+  if (Object.prototype.hasOwnProperty.call(patch, "name")) {
+    if (typeof patch.name !== "string") {
+      const error = new Error("name must be a string");
+      error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+      throw error;
+    }
+    normalized.name = patch.name.trim() || "Growthub Workspace";
+  }
+
+  if (Object.prototype.hasOwnProperty.call(patch, "branding")) {
+    if (!patch.branding || typeof patch.branding !== "object" || Array.isArray(patch.branding)) {
+      const error = new Error("branding must be a plain object");
+      error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+      throw error;
+    }
+    const brandingAllowed = new Set(["name", "logoUrl", "accent"]);
+    const brandingUnknown = Object.keys(patch.branding).filter((key) => !brandingAllowed.has(key));
+    if (brandingUnknown.length) {
+      const error = new Error("branding patch contains unknown fields");
+      error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+      error.details = brandingUnknown.map((key) => `branding.${key}`);
+      throw error;
+    }
+    normalized.branding = {};
+    for (const key of brandingAllowed) {
+      if (Object.prototype.hasOwnProperty.call(patch.branding, key)) {
+        if (typeof patch.branding[key] !== "string") {
+          const error = new Error(`branding.${key} must be a string`);
+          error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+          throw error;
+        }
+        normalized.branding[key] = patch.branding[key].trim();
+      }
+    }
+  }
+
+  return normalized;
+}
+
+async function writeWorkspaceIdentitySettings(patch) {
+  const persistence = describePersistenceMode();
+  const adapter = readAdapterConfig();
+  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 normalized = normalizeWorkspaceIdentityPatch(patch);
+  const current = await readWorkspaceConfig();
+  const next = { ...current };
+  if (normalized.name !== undefined) {
+    next.name = normalized.name;
+  }
+  if (normalized.branding) {
+    next.branding = {
+      ...(current.branding && typeof current.branding === "object" && !Array.isArray(current.branding)
+        ? current.branding
+        : {}),
+      ...normalized.branding
+    };
+    if (!next.branding.name) {
+      next.branding.name = next.name || "Growthub Workspace";
+    }
+  }
+
+  validateWorkspaceConfig({
+    dashboards: next.dashboards,
+    widgetTypes: next.widgetTypes,
+    canvas: next.canvas,
+    dataModel: next.dataModel
+  });
+
+  const configPath = resolveWorkspaceConfigPath();
+  const expectedDir = path.resolve(/*turbopackIgnore: true*/ process.cwd());
+  if (path.dirname(configPath) !== expectedDir) {
+    const error = new Error(`refused to write outside workspace cwd: ${configPath}`);
+    error.code = "WORKSPACE_PERSISTENCE_PATH_REFUSED";
+    throw error;
+  }
+  await fs.writeFile(configPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+  return next;
+}
+
+function normalizeApiWebhookRefs(refs) {
+  if (!Array.isArray(refs)) {
+    const error = new Error("refs must be an array");
+    error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+    throw error;
+  }
+  return refs
+    .map((item, index) => {
+      if (!item || typeof item !== "object" || Array.isArray(item)) {
+        const error = new Error("each ref must be a plain object");
+        error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+        throw error;
+      }
+      const allowed = new Set(["id", "label", "kind", "endpointRef", "status", "hasSecret", "url"]);
+      const unknown = Object.keys(item).filter((key) => !allowed.has(key));
+      if (unknown.length) {
+        const error = new Error("ref contains unknown fields");
+        error.code = "INVALID_WORKSPACE_SETTINGS_PATCH";
+        error.details = unknown;
+        throw error;
+      }
+      const kind = item.kind === "webhook" ? "webhook" : "api";
+      const label = typeof item.label === "string" ? item.label.trim() : "";
+      const endpointRef = typeof item.endpointRef === "string" ? item.endpointRef.trim() : "";
+      const url = typeof item.url === "string" ? item.url.trim() : "";
+      if (!label && !endpointRef && !url && item.hasSecret !== true) return null;
+      return {
+        id: typeof item.id === "string" && item.id.trim() ? item.id.trim() : `custom-${kind}-${index + 1}`,
+        label: label || endpointRef,
+        kind,
+        sourceType: "custom-api-webhooks",
+        endpointRef,
+        url,
+        status: typeof item.status === "string" && item.status.trim() ? item.status.trim() : "configured",
+        hasSecret: item.hasSecret === true
+      };
+    })
+    .filter(Boolean);
+}
+
+async function writeWorkspaceApiWebhookSettings(patch) {
+  const persistence = describePersistenceMode();
+  const adapter = readAdapterConfig();
+  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 refs = normalizeApiWebhookRefs(patch?.refs);
+  const current = await readWorkspaceConfig();
+  const existing = Array.isArray(current.integrations) ? current.integrations : [];
+  const next = {
+    ...current,
+    integrations: [
+      ...existing.filter((item) => item?.sourceType !== "custom-api-webhooks"),
+      ...refs
+    ]
+  };
+
+  validateWorkspaceConfig({
+    dashboards: next.dashboards,
+    widgetTypes: next.widgetTypes,
+    canvas: next.canvas,
+    dataModel: next.dataModel
+  });
+
+  const configPath = resolveWorkspaceConfigPath();
+  const expectedDir = path.resolve(/*turbopackIgnore: true*/ process.cwd());
+  if (path.dirname(configPath) !== expectedDir) {
+    const error = new Error(`refused to write outside workspace cwd: ${configPath}`);
+    error.code = "WORKSPACE_PERSISTENCE_PATH_REFUSED";
+    throw error;
+  }
+  await fs.writeFile(configPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+  return next.integrations.filter((item) => item?.sourceType === "custom-api-webhooks");
+}
+
 export {
   GRID_COLUMNS,
   GRID_ROWS,
@@ -163,5 +348,7 @@ export {
   readWorkspaceConfig,
   resolveWorkspaceConfigPath,
   validateWorkspaceConfig,
-  writeWorkspaceConfig
+  writeWorkspaceConfig,
+  writeWorkspaceApiWebhookSettings,
+  writeWorkspaceIdentitySettings
 };