@growthub/cli 0.13.7 → 0.13.9

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

@@ -3,6 +3,8 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 import { readWorkspaceConfig } from "@/lib/workspace-config";
 import { AppsList } from "./apps-list.jsx";
+import { CodexSitesDataModelCard } from "./codex-sites-data-model-card.jsx";
+import { SettingsAccordionGroup, SettingsAccordionSection } from "./settings-accordion-section.jsx";
 
 async function readForkMetadata() {
   try {
@@ -82,24 +84,39 @@ async function AppsSettingsPage() {
       <div className="workspace-settings-card-heading">
         <div>
           <h2>Apps</h2>
-          <p>Read-only workspace app, bridge, and fork metadata already available to this workspace.</p>
+          <p>Workspace apps discovered from the local apps directory and governed Data Model configuration.</p>
         </div>
       </div>
 
-      <section className="workspace-settings-section workspace-apps-linkage-section">
-        <h3>Workspace Linkage</h3>
-        <div className="workspace-settings-kv">
-          <span>Workspace</span><code>{workspaceConfig.id || "workspace-builder-default"}</code>
-          <span>Fork</span><code>{fork?.forkId || "local fork metadata unavailable"}</code>
-          <span>Kit</span><code>{fork?.kitId || workspaceConfig.provenance?.mirrors || "growthub-custom-workspace-starter-v1"}</code>
-          <span>Bridge</span><code>{bridge?.status || bridge?.id || "not connected"}</code>
-        </div>
-      </section>
+      <SettingsAccordionGroup defaultOpenId="workspace-apps">
+        <SettingsAccordionSection
+          id="workspace-apps"
+          title="Workspace Apps"
+          summary={`${apps.length} app${apps.length === 1 ? "" : "s"} discovered from directory and config.`}
+          className="workspace-apps-list-section"
+        >
+          <AppsList apps={apps} />
+        </SettingsAccordionSection>
+
+        <SettingsAccordionSection
+          id="workspace-linkage"
+          title="Workspace Linkage"
+          summary="Fork, kit, and bridge identity for this workspace."
+          className="workspace-apps-linkage-section"
+        >
+          <div className="workspace-settings-kv">
+            <span>Workspace</span><code>{workspaceConfig.id || "workspace-builder-default"}</code>
+            <span>Fork</span><code>{fork?.forkId || "local fork metadata unavailable"}</code>
+            <span>Kit</span><code>{fork?.kitId || workspaceConfig.provenance?.mirrors || "growthub-custom-workspace-starter-v1"}</code>
+            <span>Bridge</span><code>{bridge?.status || bridge?.id || "not connected"}</code>
+          </div>
+        </SettingsAccordionSection>
 
-      <section className="workspace-settings-section workspace-apps-list-section">
-        <h3>Workspace Apps</h3>
-        <AppsList apps={apps} />
-      </section>
+        <CodexSitesDataModelCard
+          apps={apps}
+          dataModel={workspaceConfig.dataModel || {}}
+        />
+      </SettingsAccordionGroup>
     </section>
   </SettingsShell>;
 }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/settings/apps/settings-accordion-section.jsx

@@ -0,0 +1,50 @@
+"use client";
+
+import { createContext, useContext, useState } from "react";
+import { ChevronDown } from "lucide-react";
+
+const SettingsAccordionContext = createContext(null);
+
+function SettingsAccordionGroup({ defaultOpenId, children }) {
+  const [openId, setOpenId] = useState(defaultOpenId || null);
+  return <SettingsAccordionContext.Provider value={{ openId, setOpenId }}>
+    {children}
+  </SettingsAccordionContext.Provider>;
+}
+
+function SettingsAccordionSection({ id, title, summary, className = "", defaultOpen = false, children }) {
+  const group = useContext(SettingsAccordionContext);
+  const [localOpen, setLocalOpen] = useState(defaultOpen);
+  const open = group ? group.openId === id : localOpen;
+  const sectionClass = [
+    "workspace-settings-section",
+    "workspace-settings-accordion",
+    open ? "is-open" : "is-collapsed",
+    className
+  ].filter(Boolean).join(" ");
+  const toggle = () => {
+    if (group) {
+      group.setOpenId(open ? null : id);
+      return;
+    }
+    setLocalOpen((value) => !value);
+  };
+
+  return <section className={sectionClass}>
+    <button
+      type="button"
+      className="workspace-settings-accordion-trigger"
+      aria-expanded={open}
+      onClick={toggle}
+    >
+      <span>
+        <h3>{title}</h3>
+        {summary ? <em>{summary}</em> : null}
+      </span>
+      <ChevronDown size={16} aria-hidden="true" />
+    </button>
+    {open ? <div className="workspace-settings-accordion-body">{children}</div> : null}
+  </section>;
+}
+
+export { SettingsAccordionGroup, SettingsAccordionSection };

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

@@ -45,6 +45,7 @@ import {
   Plus,
   Quote,
   RefreshCw,
+  Rocket,
   Rows3,
   Save,
   Search,
@@ -59,6 +60,8 @@ import {
   Trash2,
   Type,
   Users,
+  Eye,
+  Wrench,
   X,
   Zap,
 } from "lucide-react";
@@ -87,6 +90,11 @@ import {
 } from "@/lib/workspace-chart-values";
 import { selectObjectFilterableFields, selectObjectSortableFields } from "@/lib/workspace-metadata-selectors";
 import { deriveWorkspaceActivationState } from "@/lib/workspace-activation";
+import {
+  CODEX_SITES_OBJECT_ID,
+  ensureCodexSitesDataModel,
+  isCodexSiteUrl
+} from "@/lib/codex-sites-workspace-adapter";
 import { HelperSidecar } from "./data-model/components/HelperSidecar.jsx";
 import { WorkspaceRail } from "./workspace-rail.jsx";
 import { WorkspaceActivationPanel } from "./components/WorkspaceActivationPanel.jsx";
@@ -501,6 +509,34 @@ function listBuilderWorkflowItems(config) {
   });
 }
 
+function listBuilderSiteItems(config) {
+  const object = getDataModelObject(config, CODEX_SITES_OBJECT_ID);
+  const rows = Array.isArray(object?.rows) ? object.rows : [];
+  return rows.flatMap((row, index) => {
+    const url = String(row?.url || "").trim();
+    if (!isCodexSiteUrl(url)) return [];
+    const title = String(row?.Name || row?.name || `Codex Site ${index + 1}`).trim();
+    const rawStatus = String(row?.status || "").trim().toLowerCase();
+    const status = rawStatus === "active" ? "live" : rawStatus || "draft";
+    return [{
+      type: "site",
+      id: String(row?.id || row?.Name || `codex-site-${index + 1}`),
+      title,
+      itemKind: "Site",
+      updatedAt: formatBuilderTimestamp(row?.lastRecordedAt || ""),
+      status,
+      site: {
+        row,
+        rowIndex: index,
+        title,
+        url,
+        app: String(row?.app || "apps/workspace").trim(),
+        client: String(row?.client || "Workspace").trim()
+      }
+    }];
+  });
+}
+
 function formatBuilderTimestamp(value) {
   const raw = String(value || "").trim();
   if (!raw || raw === "new") return raw;
@@ -4244,6 +4280,7 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
   const canvas = config.canvas;
   const dashboards = config.dashboards || [];
   const workflows = useMemo(() => listBuilderWorkflowItems(config), [config]);
+  const sites = useMemo(() => listBuilderSiteItems(config), [config]);
   const builderItems = useMemo(() => {
     const dashboardItems = dashboards.map((dashboard, index) => ({
       type: "dashboard",
@@ -4264,13 +4301,17 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
       status: workflow.lifecycleStatus || "draft",
       workflow
     }));
+    const siteItems = sites.map((site) => ({
+      ...site,
+      updatedAt: site.updatedAt || "new"
+    }));
     const q = builderListFilter.query.trim().toLowerCase();
-    return [...dashboardItems, ...workflowItems].filter((item) => {
+    return [...dashboardItems, ...siteItems, ...workflowItems].filter((item) => {
       if (builderListFilter.type !== "all" && item.type !== builderListFilter.type) return false;
       if (!q) return true;
-      return [item.title, item.itemKind, item.status, item.type].some((part) => String(part || "").toLowerCase().includes(q));
+      return [item.title, item.itemKind, item.status, item.type, item.site?.client, item.site?.app, item.site?.url].some((part) => String(part || "").toLowerCase().includes(q));
     });
-  }, [builderListFilter, dashboards, workflows]);
+  }, [builderListFilter, dashboards, sites, workflows]);
   const resolvedActiveDashboardId = getActiveDashboardId(dashboards, activeDashboardId);
   const resolvedActiveDashboardIndex = activeDashboardIndex(dashboards, resolvedActiveDashboardId);
   const widgetTypes = config.widgetTypes;
@@ -4316,6 +4357,18 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
     workspaceConfig: config,
     workspaceSourceRecords,
   }), [config, workspaceSourceRecords]);
+  // Safe runtime descriptor for the secondary readiness lenses — assembled from
+  // the persistence/adapter props the builder already receives (no fetch, no
+  // secrets; booleans only).
+  const lensMetadataGraph = useMemo(() => ({
+    runtime: {
+      persistenceMode: persistence?.mode || "",
+      persistenceAdapter: persistence?.mode === "database" ? (adapterConfig?.dataAdapter || null) : null,
+      allowFsWrite: persistence?.mode === "filesystem" && persistence?.canSave === true,
+      nangoConfigured: Boolean(adapterConfig?.nango?.hasSecretKey),
+      deploy: { target: adapterConfig?.deployTarget || "" },
+    },
+  }), [persistence, adapterConfig]);
   const activationStarted = activationState.completedCount > 0;
   const activationComplete = Boolean(activationState.complete);
   const activationUiCache = useMemo(() => getWorkspaceUiCache(config), [config]);
@@ -4695,6 +4748,50 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
     }
   }, [config, saving]);
 
+  const createCodexSite = useCallback(async () => {
+    if (saving) return;
+    const objects = Array.isArray(config.dataModel?.objects) ? config.dataModel.objects : [];
+    const hasCodexSitesObject = objects.some((object) => object?.id === CODEX_SITES_OBJECT_ID);
+    if (hasCodexSitesObject) {
+      window.open(`/data-model?object=${encodeURIComponent(CODEX_SITES_OBJECT_ID)}`, "_self");
+      return;
+    }
+    const nextDataModel = ensureCodexSitesDataModel(config.dataModel, []);
+    setSaving(true);
+    try {
+      const response = await fetch("/api/workspace", {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ dataModel: nextDataModel })
+      });
+      const payload = await response.json();
+      if (!response.ok || !payload.workspaceConfig) {
+        throw new Error(payload.error || "Failed to create Codex Sites object");
+      }
+      setConfig((prev) => ({ ...prev, dataModel: payload.workspaceConfig.dataModel }));
+      setBuilderListFilter({ type: "site", query: "" });
+      setConfigMessage("Created Codex Sites object");
+      window.open(`/data-model?object=${encodeURIComponent(CODEX_SITES_OBJECT_ID)}`, "_self");
+    } catch (error) {
+      setConfigMessage(error.message || "Failed to create Codex Sites object");
+    } finally {
+      setSaving(false);
+    }
+  }, [config, saving]);
+
+  const manageSite = useCallback((site) => {
+    const rowParam = site?.rowIndex !== undefined ? `&row=${encodeURIComponent(String(site.rowIndex))}` : "";
+    window.open(`/data-model?object=${encodeURIComponent(CODEX_SITES_OBJECT_ID)}${rowParam}`, "_self");
+  }, []);
+
+  const openSite = useCallback((site) => {
+    if (site?.url) {
+      window.open(site.url, "_blank", "noopener,noreferrer");
+      return;
+    }
+    manageSite(site);
+  }, [manageSite]);
+
   const selectDashboard = useCallback((index) => {
     setConfig((prev) => {
       const synced = syncActiveDashboard(prev, activeDashboardId);
@@ -5220,7 +5317,7 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
     }
     const rect = event.currentTarget.getBoundingClientRect();
     const menuWidth = 148;
-    const menuHeight = item?.type === "dashboard" ? 136 : 76;
+    const menuHeight = item?.type === "dashboard" ? 136 : item?.type === "site" ? 108 : 76;
     const margin = 8;
     const left = Math.min(
       Math.max(margin, rect.right - menuWidth),
@@ -5752,6 +5849,40 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
       id: "workspace.builder", group: "Navigation", icon: Home, label: "Go to Builder",
       run: () => showDashboardHome()
     });
+    list.push({
+      id: "nav.data-model", group: "Navigation", icon: Database, label: "Go to Management (Data Model)",
+      run: () => { window.location.href = "/data-model"; }
+    });
+
+    // Workspace Lens — fast navigation into the post-activation operating
+    // surface and its filtered views. Unlocks once activation completes.
+    const lensReady = Boolean(activationState?.complete);
+    list.push({
+      id: "lens.open", group: "Workspace Lens", icon: Eye,
+      label: lensReady ? "Open Workspace Lens" : "Workspace Lens (finish setup to unlock)",
+      disabled: !lensReady,
+      run: () => { window.location.href = "/workspace-lens"; }
+    });
+    list.push({
+      id: "lens.blocked", group: "Workspace Lens", icon: Eye, label: "Workspace Lens — Blocked",
+      disabled: !lensReady,
+      run: () => { window.location.href = "/workspace-lens?filter=blocked"; }
+    });
+    list.push({
+      id: "lens.ready", group: "Workspace Lens", icon: Eye, label: "Workspace Lens — Ready",
+      disabled: !lensReady,
+      run: () => { window.location.href = "/workspace-lens?filter=ready"; }
+    });
+    list.push({
+      id: "lens.assignable", group: "Workspace Lens", icon: Eye, label: "Workspace Lens — Agent-assignable",
+      disabled: !lensReady,
+      run: () => { window.location.href = "/workspace-lens?filter=assignable"; }
+    });
+    list.push({
+      id: "lens.runs", group: "Workspace Lens", icon: Eye, label: "Workspace Lens — Runs",
+      disabled: !lensReady,
+      run: () => { window.location.href = "/workspace-lens?filter=runs"; }
+    });
 
     return list;
   }, [
@@ -5770,7 +5901,8 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
     saving,
     selectedWidget,
     showDashboardHome,
-    workspaceView
+    workspaceView,
+    activationState
   ]);
 
   return <main className="workspace-builder" onPointerDownCapture={resetWidgetSelectionOnOutsidePointer} style={builderStyle}>
@@ -5798,10 +5930,12 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
         dashboardsSlot={(
           <button
             type="button"
+            title="Builder"
             className={workspaceView === "dashboards" ? "active workspace-nav-button" : "workspace-nav-button"}
             onClick={showDashboardHome}
           >
-            Builder
+            <Wrench size={15} aria-hidden="true" />
+            <span className="workspace-nav-label">Builder</span>
           </button>
         )}
         managementSlot={(
@@ -5865,6 +5999,7 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
               </span>
             ) : null}
             <button type="button" onClick={addDashboard}><Plus size={15} />New Dashboard</button>
+            <button type="button" onClick={createCodexSite} disabled={saving}><Rocket size={15} />New Codex Site</button>
             <button type="button" onClick={createWorkflow} disabled={saving}><GitBranch size={15} />New Workflow</button>
             <button type="button" onClick={() => importInputRef.current?.click()}><Import size={15} />Import</button>
           </div>}
@@ -5881,6 +6016,8 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
           {showActivationPanel ? <WorkspaceActivationPanel
             workspaceConfig={config}
             workspaceSourceRecords={workspaceSourceRecords}
+            metadataGraph={lensMetadataGraph}
+            showLenses={true}
             onStepAction={(step) => {
               if (step?.id === "add-widget") return openAddWidgetBuilder();
               if (step?.id === "create-workflow") {
@@ -5899,13 +6036,14 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
         <section className="workspace-table" id="dashboards" aria-label="Builder">
           <div className="workspace-table-heading">
             <strong>Builder</strong>
-            <span>{dashboards.length} dashboard{dashboards.length === 1 ? "" : "s"} · {workflows.length} workflow{workflows.length === 1 ? "" : "s"}</span>
+            <span>{dashboards.length} dashboard{dashboards.length === 1 ? "" : "s"} · {sites.length} site{sites.length === 1 ? "" : "s"} · {workflows.length} workflow{workflows.length === 1 ? "" : "s"}</span>
           </div>
           <div className="workspace-builder-filterbar">
             <div className="workspace-builder-filterbar__segments" role="group" aria-label="Builder item type">
               {[
                 ["all", "All"],
                 ["dashboard", "Dashboards"],
+                ["site", "Sites"],
                 ["workflow", "Workflows"]
               ].map(([type, label]) => (
                 <button
@@ -5999,6 +6137,53 @@ function WorkspaceBuilder({ initialConfig, initialSourceRecords, adapterConfig,
                   </span>
                 )}
               </span>
+            </div> : item.type === "site" ? <div className="workspace-table-row" key={item.id}>
+              <span className="workspace-dashboard-title">
+                {item.site.url ? (
+                  <a href={item.site.url} target="_blank" rel="noreferrer">{item.title}</a>
+                ) : (
+                  <button
+                    className="active"
+                    onClick={() => manageSite(item.site)}
+                    type="button"
+                  >{item.title}</button>
+                )}
+              </span>
+              <span>{item.itemKind}</span>
+              <span>{item.updatedAt}</span>
+              <span>
+                <select
+                  aria-label={`Status for ${item.title}`}
+                  value={item.status || "draft"}
+                  disabled
+                >
+                  <option value="draft">draft</option>
+                  <option value="review">review</option>
+                  <option value="live">live</option>
+                  <option value="paused">paused</option>
+                </select>
+              </span>
+              <span className="workspace-dashboard-actions">
+                <button
+                  type="button"
+                  className="workspace-row-action-trigger"
+                  aria-label={`Actions for ${item.title}`}
+                  onClick={(event) => openBuilderActionMenu(item, event)}
+                >
+                  <MoreVertical size={16} aria-hidden="true" />
+                </button>
+                {builderActionMenuId === item.id && (
+                  <span className="workspace-row-action-menu" style={builderActionMenuPlacement || undefined}>
+                    {item.site.url ? (
+                      <a href={item.site.url} target="_blank" rel="noreferrer" onClick={closeBuilderActionMenu}>Open URL</a>
+                    ) : (
+                      <button type="button" disabled>Open URL</button>
+                    )}
+                    <button type="button" onClick={() => { closeBuilderActionMenu(); manageSite(item.site); }}>Manage</button>
+                    <button type="button" onClick={() => { closeBuilderActionMenu(); window.open("/settings/apps", "_self"); }}>Apps</button>
+                  </span>
+                )}
+              </span>
             </div> : <div className="workspace-table-row" key={item.id}>
               <span className="workspace-dashboard-title">
                 {editingWorkflowId === item.workflow.id ? <span className="workspace-dashboard-title-editor">

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

@@ -0,0 +1,76 @@
+import { Suspense } from "react";
+import Link from "next/link";
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { describePersistenceMode, readWorkspaceConfig, readWorkspaceSourceRecords } from "@/lib/workspace-config";
+import { deriveWorkspaceActivationState } from "@/lib/workspace-activation";
+import { WorkspaceRail } from "../workspace-rail.jsx";
+import { WorkspaceLensPanel } from "../components/WorkspaceLensPanel.jsx";
+
+/**
+ * /workspace-lens — the dedicated Workspace Lens surface.
+ *
+ * Server-rendered and force-dynamic so it always reflects the LIVE workspace
+ * artifact (a live operating surface must not be statically baked). Reads the
+ * same governed helpers the home page uses, assembles a safe runtime
+ * descriptor (no secrets), and gates behind activation completeness:
+ * onboarding first, operating surface second.
+ */
+export const dynamic = "force-dynamic";
+
+async function WorkspaceLens() {
+  const adapter = readAdapterConfig();
+  const persistence = describePersistenceMode();
+  const workspaceConfig = await readWorkspaceConfig();
+  let workspaceSourceRecords = {};
+  try {
+    workspaceSourceRecords = (await readWorkspaceSourceRecords()) || {};
+  } catch {
+    workspaceSourceRecords = {};
+  }
+
+  const metadataGraph = {
+    runtime: {
+      persistenceMode: persistence?.mode || "",
+      persistenceAdapter: persistence?.mode === "database" ? (adapter?.dataAdapter || null) : null,
+      allowFsWrite: persistence?.mode === "filesystem" && persistence?.canSave === true,
+      nangoConfigured: Boolean(adapter?.nango?.hasSecretKey),
+      deploy: { target: adapter?.deployTarget || "" },
+    },
+  };
+
+  const activationComplete = deriveWorkspaceActivationState({ workspaceConfig, workspaceSourceRecords }).complete;
+
+  return (
+    <main className="workspace-builder workspace-lens-page">
+      <WorkspaceRail workspaceConfig={workspaceConfig || {}} />
+      <section className="workspace-surface workspace-lens-surface">
+        <div className="workspace-lens-shell">
+          {activationComplete ? (
+            <WorkspaceLensPanel
+              workspaceConfig={workspaceConfig}
+              workspaceSourceRecords={workspaceSourceRecords}
+              metadataGraph={metadataGraph}
+            />
+          ) : (
+            <div className="workspace-lens-locked">
+              <h1 className="workspace-lens-title">Workspace Lens is locked</h1>
+              <p className="workspace-lens-subtitle">
+                Finish workspace setup to unlock the live operating surface — state, blocked conditions,
+                next actions, and agent-assignable work.
+              </p>
+              <Link href="/" className="workspace-lens-next-link">Finish setup in the Builder</Link>
+            </div>
+          )}
+        </div>
+      </section>
+    </main>
+  );
+}
+
+export default function WorkspaceLensPage() {
+  return (
+    <Suspense fallback={null}>
+      <WorkspaceLens />
+    </Suspense>
+  );
+}