@growthub/cli 0.12.2 → 0.13.1

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/orchestration-run-trace.js

@@ -0,0 +1,73 @@
+/**
+ * Parse sandbox row lastResponse / source-record run entries for trace viewer UI.
+ */
+
+import { redactSecretsFromText } from "./orchestration-graph.js";
+
+function safeParseJson(text) {
+  const raw = String(text || "").trim();
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function parseSandboxRunTrace(lastResponse) {
+  const parsed = safeParseJson(lastResponse);
+  if (!parsed || typeof parsed !== "object") {
+    return {
+      status: "",
+      runId: "",
+      exitCode: null,
+      durationMs: null,
+      runtime: "",
+      adapter: "",
+      runLocality: "",
+      error: "",
+      stdout: "",
+      stderr: "",
+      output: "",
+      ranAt: "",
+      envRefsResolved: [],
+      envRefsMissing: []
+    };
+  }
+  const outputRaw = parsed.output ?? parsed.normalizedOutput ?? parsed.response;
+  return {
+    status: parsed.status || (parsed.exitCode === 0 && !parsed.error ? "connected" : parsed.error ? "failed" : ""),
+    runId: String(parsed.runId || "").trim(),
+    exitCode: parsed.exitCode ?? null,
+    durationMs: parsed.durationMs ?? null,
+    runtime: String(parsed.runtime || "").trim(),
+    adapter: String(parsed.adapter || "").trim(),
+    runLocality: String(parsed.runLocality || "").trim(),
+    error: redactSecretsFromText(parsed.error || ""),
+    stdout: redactSecretsFromText(typeof parsed.stdout === "string" ? parsed.stdout : JSON.stringify(parsed.stdout ?? "", null, 2)),
+    stderr: redactSecretsFromText(parsed.stderr || ""),
+    output: redactSecretsFromText(
+      typeof outputRaw === "string" ? outputRaw : JSON.stringify(outputRaw ?? "", null, 2)
+    ),
+    ranAt: String(parsed.ranAt || "").trim(),
+    envRefsResolved: Array.isArray(parsed.envRefsResolved) ? parsed.envRefsResolved : [],
+    envRefsMissing: Array.isArray(parsed.envRefsMissing) ? parsed.envRefsMissing : []
+  };
+}
+
+function normalizeRunRecord(record) {
+  if (!record || typeof record !== "object") return null;
+  return {
+    runId: String(record.runId || "").trim(),
+    ranAt: String(record.ranAt || "").trim(),
+    exitCode: record.exitCode ?? null,
+    durationMs: record.durationMs ?? null,
+    error: redactSecretsFromText(record.error || ""),
+    stdout: redactSecretsFromText(typeof record.stdout === "string" ? record.stdout : ""),
+    stderr: redactSecretsFromText(record.stderr || ""),
+    lifecycleStatus: String(record.lifecycleStatus || "").trim(),
+    version: String(record.version || "").trim()
+  };
+}
+
+export { parseSandboxRunTrace, normalizeRunRecord, safeParseJson };

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/orchestration-sidecar-routing.js

@@ -0,0 +1,24 @@
+/**
+ * Pure routing for connector menu → node + config tab (sidecar UX contract).
+ */
+
+function resolveConnectorAction({ from, to, action }) {
+  const result = { nodeId: "input", tab: "node" };
+  if (action === "filter") {
+    if (to === "transform" || from === "api-request") {
+      result.nodeId = "transform";
+    } else {
+      result.nodeId = "input";
+    }
+    result.tab = "filters";
+  } else if (action === "map") {
+    result.nodeId = "transform";
+    result.tab = "node";
+  } else if (action === "preview") {
+    result.nodeId = "result";
+    result.tab = "preview";
+  }
+  return result;
+}
+
+export { resolveConnectorAction };

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) {
@@ -724,6 +731,8 @@ const OBJECT_TYPE_PRESETS = {
       "lastRunId",
       "lastSourceId",
       "lastResponse",
+      "orchestrationGraph",
+      "description",
       "resolverTemplateId",
       "connectorKind",
       "executionLane"

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

@@ -963,6 +963,11 @@ function validateSandboxEnvironmentRow(row, path, errors) {
       errors.push(`${path}.intelligenceAdapterMode must be one of ${INTELLIGENCE_ADAPTER_MODES.join(", ")}`);
     }
   }
+  if (row.orchestrationGraph !== undefined && row.orchestrationGraph !== null && row.orchestrationGraph !== "") {
+    if (typeof row.orchestrationGraph !== "string" && (typeof row.orchestrationGraph !== "object" || Array.isArray(row.orchestrationGraph))) {
+      errors.push(`${path}.orchestrationGraph must be a JSON string or plain object`);
+    }
+  }
   if (row.envRefs !== undefined && typeof row.envRefs !== "string" && !Array.isArray(row.envRefs)) {
     errors.push(`${path}.envRefs must be a comma-separated string or array of env-ref slugs (never values)`);
   }
@@ -1000,6 +1005,116 @@ 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", "workflow"];
+
+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`);
+          }
+        }
+      }
+    } else if (item.type === "workflow") {
+      if (typeof item.objectId !== "string" || !item.objectId.trim()) {
+        errors.push(`${ipfx}.objectId must be a non-empty string for workflow items`);
+      }
+      if (typeof item.rowId !== "string" || !item.rowId.trim()) {
+        errors.push(`${ipfx}.rowId must be a non-empty string for workflow items`);
+      }
+      if (item.fieldName !== undefined) {
+        if (typeof item.fieldName !== "string" || !item.fieldName.trim()) {
+          errors.push(`${ipfx}.fieldName must be a non-empty string when present`);
+        }
+      }
+      if (item.orchestrationGraph !== undefined) {
+        errors.push(`${ipfx} must not embed orchestrationGraph — workflow items are shortcuts only`);
+      }
+    }
+  });
+}
+
 function validateDataModelConfig(dataModel, errors) {
   if (dataModel === undefined) return;
   if (!isPlainObject(dataModel)) {
@@ -1040,6 +1155,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 +1434,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,

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

@@ -115,6 +115,7 @@
     "apps/workspace/app/data-model/page.jsx",
     "apps/workspace/app/data-model/components/DataModelShell.jsx",
     "apps/workspace/app/data-model/components/HelperSidecar.jsx",
+    "apps/workspace/app/views/[viewId]/page.jsx",
     "apps/workspace/lib/adapters/payments/index.js",
     "apps/workspace/lib/adapters/persistence/index.js",
     "apps/workspace/lib/adapters/persistence/postgres.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthub/cli",
-  "version": "0.12.2",
+  "version": "0.13.1",
   "description": "CLI control plane for Growthub Local and Agent Workspace as Code: export, fork, inspect, operate, sync, and optionally activate governed AI workspaces.",
   "type": "module",
   "bin": {