@growthub/cli 0.12.1 → 0.13.0

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

@@ -289,12 +289,19 @@ function deriveManualObjectTable(object) {
 }
 
 // Helper-owned hidden objects — system-managed, never surfaced in the
-// user-facing Data Model picker / object list / dynamic title. The
-// workspace-helper-sandbox row backs the helper's local-intelligence
-// sandbox primitive (helper-tuned instructions live there); users
-// interact with it only through the helper Setup tab.
+// user-facing Data Model picker / object list / dynamic title.
+//
+// - `workspace-helper-sandbox` backs the helper's local-intelligence
+//   sandbox primitive (helper-tuned instructions live there); users
+//   interact with it only through the helper Setup tab.
+// - `nav-folders` backs the Custom Folders Navigation module rendered
+//   in the workspace rail (between the tab toggles and the Home / Chat
+//   body). Users create, rename, drag, and add items entirely from the
+//   rail; the row-level structure is never exposed in the Data Model
+//   admin surface so the core governed business objects stay clean.
 const HIDDEN_HELPER_OBJECT_IDS = new Set([
   "workspace-helper-sandbox",
+  "nav-folders",
 ]);
 
 function listWorkspaceDataModelTables(workspaceConfig) {

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

@@ -461,6 +461,92 @@ function nextThreadId() {
   return `thr_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
 }
 
+/**
+ * Custom Folders Navigation — governed end-user organization layer.
+ *
+ * Same well-known custom-typed Data Model object pattern as
+ * `helper-threads`: one object (id = "nav-folders") whose `rows[]` carry
+ * the user's folder structure. Each row is a folder. Folder items
+ * (dashboard links, lightweight views of governed objects) are nested
+ * inside the row as a JSON-serialisable `items[]` array.
+ *
+ * Persists through the existing PATCH allowlist on `/api/workspace`
+ * (`dataModel`), is round-trip validated by `validateWorkspaceConfig`,
+ * is hidden from the user-facing Data Model picker via
+ * `HIDDEN_HELPER_OBJECT_IDS` in `lib/workspace-data-model.js`, and is
+ * fully backwards compatible — if the object is missing the rail simply
+ * shows zero folders and the user can add one with the `+` button.
+ *
+ * Row shape (validated in `lib/workspace-schema.js`):
+ *
+ *   {
+ *     id: "fld_…",
+ *     name: "Sales Pipeline",
+ *     order: 0,
+ *     collapsed: false,
+ *     items: [
+ *       { id: "item_…", type: "dashboard", refId: "dash-abc",
+ *         label: "Revenue Overview" },
+ *       { id: "item_…", type: "view", objectId: "prospects",
+ *         label: "Active Prospects",
+ *         viewConfig: { columns: [...], filters: [...], sort: {...} } }
+ *     ]
+ *   }
+ */
+
+const NAV_FOLDERS_OBJECT_ID = "nav-folders";
+const NAV_FOLDERS_LABEL = "Custom Folders";
+const NAV_FOLDER_NAME_MAX = 60;
+const NAV_ITEM_LABEL_MAX = 80;
+const NAV_ITEM_TYPES = new Set(["dashboard", "view"]);
+
+function ensureNavFoldersObject(config) {
+  const dm = config?.dataModel && typeof config.dataModel === "object" ? config.dataModel : {};
+  const objects = Array.isArray(dm.objects) ? dm.objects.slice() : [];
+  const idx = objects.findIndex((o) => o?.id === NAV_FOLDERS_OBJECT_ID);
+  if (idx >= 0) {
+    const existing = objects[idx];
+    if (!Array.isArray(existing.rows)) {
+      objects[idx] = { ...existing, rows: [] };
+    }
+    return { ...config, dataModel: { ...dm, objects } };
+  }
+  const seeded = {
+    id: NAV_FOLDERS_OBJECT_ID,
+    label: NAV_FOLDERS_LABEL,
+    source: NAV_FOLDERS_LABEL,
+    objectType: "custom",
+    icon: "Folder",
+    columns: ["name", "order", "collapsed", "items"],
+    rows: [],
+    binding: { mode: "manual", source: NAV_FOLDERS_LABEL },
+  };
+  return { ...config, dataModel: { ...dm, objects: [...objects, seeded] } };
+}
+
+function nextNavFolderId() {
+  return `fld_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+
+function nextNavItemId() {
+  return `item_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+
+function getNavFolderRows(config) {
+  const obj = (config?.dataModel?.objects || []).find((o) => o?.id === NAV_FOLDERS_OBJECT_ID);
+  return Array.isArray(obj?.rows) ? obj.rows : [];
+}
+
+function writeNavFolderRows(config, rows) {
+  const withObject = ensureNavFoldersObject(config);
+  const dm = withObject.dataModel;
+  const objects = dm.objects.slice();
+  const idx = objects.findIndex((o) => o?.id === NAV_FOLDERS_OBJECT_ID);
+  if (idx === -1) return withObject;
+  objects[idx] = { ...objects[idx], rows: rows.map((row, i) => ({ ...row, order: i })) };
+  return { ...withObject, dataModel: { ...dm, objects } };
+}
+
 export {
   applyProposalToConfig,
   validateProposalForApply,
@@ -470,4 +556,14 @@ export {
   nextThreadId,
   HELPER_THREADS_OBJECT_ID,
   ALLOWED_PATCH_FIELDS,
+  NAV_FOLDERS_OBJECT_ID,
+  NAV_FOLDERS_LABEL,
+  NAV_FOLDER_NAME_MAX,
+  NAV_ITEM_LABEL_MAX,
+  NAV_ITEM_TYPES,
+  ensureNavFoldersObject,
+  nextNavFolderId,
+  nextNavItemId,
+  getNavFolderRows,
+  writeNavFolderRows,
 };

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

@@ -1000,6 +1000,101 @@ function validateSandboxEnvironmentRow(row, path, errors) {
   }
 }
 
+const NAV_FOLDERS_OBJECT_ID = "nav-folders";
+const NAV_FOLDER_NAME_MAX = 60;
+const NAV_ITEM_LABEL_MAX = 80;
+const NAV_ITEM_TYPES = ["dashboard", "view"];
+
+function validateNavFolderRow(row, path, errors) {
+  if (!isPlainObject(row)) return;
+  if (typeof row.id !== "string" || !row.id.trim()) {
+    errors.push(`${path}.id must be a non-empty string`);
+  }
+  if (typeof row.name !== "string" || !row.name.trim()) {
+    errors.push(`${path}.name must be a non-empty string`);
+  } else if (row.name.length > NAV_FOLDER_NAME_MAX) {
+    errors.push(`${path}.name must be ${NAV_FOLDER_NAME_MAX} characters or fewer`);
+  }
+  if (row.order !== undefined && !isFiniteInt(row.order)) {
+    errors.push(`${path}.order must be a finite integer when present`);
+  }
+  if (row.collapsed !== undefined && typeof row.collapsed !== "boolean") {
+    errors.push(`${path}.collapsed must be a boolean when present`);
+  }
+  if (row.icon !== undefined && typeof row.icon !== "string") {
+    errors.push(`${path}.icon must be a string when present`);
+  }
+  if (row.color !== undefined && typeof row.color !== "string") {
+    errors.push(`${path}.color must be a string when present`);
+  }
+  if (row.iconBg !== undefined && typeof row.iconBg !== "string") {
+    errors.push(`${path}.iconBg must be a string when present`);
+  }
+  if (row.items === undefined) return;
+  if (!Array.isArray(row.items)) {
+    errors.push(`${path}.items must be an array`);
+    return;
+  }
+  const seenItemIds = new Set();
+  row.items.forEach((item, index) => {
+    const ipfx = `${path}.items[${index}]`;
+    if (!isPlainObject(item)) {
+      errors.push(`${ipfx} must be a plain object`);
+      return;
+    }
+    if (typeof item.id !== "string" || !item.id.trim()) {
+      errors.push(`${ipfx}.id must be a non-empty string`);
+    } else if (seenItemIds.has(item.id)) {
+      errors.push(`${ipfx}.id duplicates an earlier item id in this folder`);
+    } else {
+      seenItemIds.add(item.id);
+    }
+    if (!NAV_ITEM_TYPES.includes(item.type)) {
+      errors.push(`${ipfx}.type must be one of ${NAV_ITEM_TYPES.join(", ")}`);
+    }
+    if (item.label !== undefined) {
+      if (typeof item.label !== "string") {
+        errors.push(`${ipfx}.label must be a string when present`);
+      } else if (item.label.length > NAV_ITEM_LABEL_MAX) {
+        errors.push(`${ipfx}.label must be ${NAV_ITEM_LABEL_MAX} characters or fewer`);
+      }
+    }
+    if (item.icon !== undefined && typeof item.icon !== "string") {
+      errors.push(`${ipfx}.icon must be a string when present`);
+    }
+    if (item.color !== undefined && typeof item.color !== "string") {
+      errors.push(`${ipfx}.color must be a string when present`);
+    }
+    if (item.iconBg !== undefined && typeof item.iconBg !== "string") {
+      errors.push(`${ipfx}.iconBg must be a string when present`);
+    }
+    if (item.type === "dashboard") {
+      if (typeof item.refId !== "string" || !item.refId.trim()) {
+        errors.push(`${ipfx}.refId must be a non-empty string for dashboard items`);
+      }
+    } else if (item.type === "view") {
+      if (typeof item.objectId !== "string" || !item.objectId.trim()) {
+        errors.push(`${ipfx}.objectId must be a non-empty string for view items`);
+      }
+      if (item.viewConfig !== undefined) {
+        if (!isPlainObject(item.viewConfig)) {
+          errors.push(`${ipfx}.viewConfig must be a plain object when present`);
+        } else {
+          if (item.viewConfig.columns !== undefined) {
+            validateStringArray(item.viewConfig.columns, `${ipfx}.viewConfig.columns`, errors);
+          }
+          if (item.viewConfig.filters !== undefined && !Array.isArray(item.viewConfig.filters)) {
+            errors.push(`${ipfx}.viewConfig.filters must be an array when present`);
+          }
+          if (item.viewConfig.sort !== undefined && !isPlainObject(item.viewConfig.sort)) {
+            errors.push(`${ipfx}.viewConfig.sort must be a plain object when present`);
+          }
+        }
+      }
+    }
+  });
+}
+
 function validateDataModelConfig(dataModel, errors) {
   if (dataModel === undefined) return;
   if (!isPlainObject(dataModel)) {
@@ -1040,6 +1135,9 @@ function validateDataModelConfig(dataModel, errors) {
         if (object.objectType === "sandbox-environment") {
           validateSandboxEnvironmentRow(row, `${prefix}.rows[${rowIndex}]`, errors);
         }
+        if (object.id === NAV_FOLDERS_OBJECT_ID) {
+          validateNavFolderRow(row, `${prefix}.rows[${rowIndex}]`, errors);
+        }
       });
     }
     validateStaticDataBinding(object.binding, `${prefix}.binding`, errors);
@@ -1316,6 +1414,10 @@ export {
   DEFAULT_SANDBOX_ADAPTER,
   SANDBOX_DEFAULT_TIMEOUT_MS,
   SANDBOX_MAX_TIMEOUT_MS,
+  NAV_FOLDERS_OBJECT_ID,
+  NAV_FOLDER_NAME_MAX,
+  NAV_ITEM_LABEL_MAX,
+  NAV_ITEM_TYPES,
   NORMALIZED_OBJECT_FIELD_IDS,
   SAMPLE_DATA_BINDINGS,
   SAMPLE_VIEW_ROWS,