@growthub/cli 0.13.6 → 0.13.8

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>
+  );
+}

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

@@ -36,14 +36,18 @@ import Link from "next/link";
 import { usePathname, useRouter, useSearchParams } from "next/navigation";
 import {
   Archive,
+  BarChart3,
   ChevronDown,
   ChevronRight,
+  Database,
+  Eye,
   Folder,
   FolderPlus,
   GitBranch,
   Home,
   LayoutDashboard,
   MessageCircle,
+  Wrench,
   MessageCirclePlus,
   MoreHorizontal,
   MoreVertical,
@@ -66,6 +70,34 @@ import {
   nextNavItemId,
 } from "@/lib/workspace-helper-apply";
 import { listAvailableWorkflows } from "@/lib/nav-workflows";
+import { deriveWorkspaceActivationState, deriveLensWalkthroughState, LENS_WALKTHROUGH_DISMISS_FLAG } from "@/lib/workspace-activation";
+import { WorkspaceLensWalkthrough } from "./components/WorkspaceLensWalkthrough.jsx";
+import { isHelperConfigured, WorkspaceHelperSetupModal } from "./components/WorkspaceHelperSetupModal.jsx";
+
+// Set a flag on the governed workspace-ui-cache "activation" row (pure
+// transform) — the same row the onboarding dismiss persists to. Returned
+// config is PATCHed via the existing /api/workspace boundary.
+function withUiCacheFlag(config, key, value) {
+  const dataModel = config?.dataModel && typeof config.dataModel === "object" ? config.dataModel : {};
+  const objects = Array.isArray(dataModel.objects) ? dataModel.objects : [];
+  const existing = objects.find((o) => o?.id === "workspace-ui-cache");
+  const cacheObject = existing || {
+    id: "workspace-ui-cache", label: "Workspace UI Cache", source: "Workspace UI Cache",
+    objectType: "custom", icon: "Settings", columns: ["id", key], rows: [],
+    binding: { mode: "manual", source: "Workspace UI Cache" },
+  };
+  const columns = Array.from(new Set([...(Array.isArray(cacheObject.columns) ? cacheObject.columns : ["id"]), key]));
+  const rows = Array.isArray(cacheObject.rows) ? cacheObject.rows : [];
+  const hasRow = rows.some((r) => r?.id === "activation");
+  const nextRows = hasRow
+    ? rows.map((r) => (r?.id === "activation" ? { ...r, [key]: value } : r))
+    : [...rows, { id: "activation", [key]: value }];
+  const nextCache = { ...cacheObject, columns, rows: nextRows };
+  const nextObjects = existing
+    ? objects.map((o) => (o?.id === "workspace-ui-cache" ? nextCache : o))
+    : [...objects, nextCache];
+  return { ...config, dataModel: { ...dataModel, objects: nextObjects } };
+}
 import { ICON_PICKER_SET, LucideIcon } from "./data-model/components/dm-shared.jsx";
 
 function textColorForAccent(accent) {
@@ -1494,11 +1526,50 @@ export function WorkspaceRail({
   // moved to the Workspace Settings → Ownership tab.
   managementSlot: _managementSlotDeprecated,
   settingsSlot,
+  // Customer Activation Layer V1 — optional rail-friendly slot rendered
+  // above the Home tab nav items. The parent page owns the content
+  // (typically a compact WorkspaceActivationPanel) so the rail stays
+  // surface-agnostic.
+  activationSlot,
 }) {
   const branding = workspaceConfig?.branding || {};
   const workspaceName = branding.name || workspaceConfig?.name || "Growthub Workspace";
   const pathname = usePathname() || "/";
   const router = useRouter();
+  // Workspace Lens unlocks only after the primary activation loop completes —
+  // onboarding first, operating surface second. Derived from the same config
+  // the rail already holds, so the gate is consistent across every page.
+  const lensUnlocked = useMemo(
+    () => Boolean(deriveWorkspaceActivationState({ workspaceConfig: workspaceConfig || {} }).complete),
+    [workspaceConfig],
+  );
+  // One-time Workspace Lens reveal: shown anchored to the (newly visible) lens
+  // nav item only in the in-between state, and never on the lens page itself.
+  const lensWalkthrough = useMemo(
+    () => deriveLensWalkthroughState({ workspaceConfig: workspaceConfig || {} }),
+    [workspaceConfig],
+  );
+  const showLensReveal = lensWalkthrough.show && pathname === "/";
+  const lensNavRef = useRef(null);
+  const [lensRevealStyle, setLensRevealStyle] = useState(null);
+  const dismissLensWalkthrough = useCallback(async () => {
+    const next = withUiCacheFlag(workspaceConfig || {}, LENS_WALKTHROUGH_DISMISS_FLAG, true);
+    if (onConfigChange) onConfigChange(next);
+    try {
+      const res = await fetch("/api/workspace", {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ dataModel: next.dataModel }),
+      });
+      const body = await res.json();
+      if (body?.workspaceConfig && onConfigChange) onConfigChange(body.workspaceConfig);
+    } catch {
+      /* optimistic update already applied; cache write is best-effort */
+    }
+  }, [workspaceConfig, onConfigChange]);
+  const enterLensWalkthrough = useCallback(() => {
+    router.push("/workspace-lens?walkthrough=2");
+  }, [router]);
 
   const [activeTab, setActiveTab] = useState("home");
   const [railCollapsed, setRailCollapsed] = useState(Boolean(defaultCollapsed));
@@ -1507,6 +1578,7 @@ export function WorkspaceRail({
   const [renameDraft, setRenameDraft] = useState("");
   const [chatSearch, setChatSearch] = useState("");
   const [chatExpanded, setChatExpanded] = useState(false);
+  const [helperSetupOpen, setHelperSetupOpen] = useState(false);
   const menuWrapRef = useRef(null);
   const CHAT_PREVIEW_COUNT = 10;
 
@@ -1520,6 +1592,31 @@ export function WorkspaceRail({
     return () => document.removeEventListener("pointerdown", onPointerDown);
   }, [openMenuId]);
 
+  useEffect(() => {
+    if (!showLensReveal) {
+      setLensRevealStyle(null);
+      return undefined;
+    }
+    const updatePosition = () => {
+      const rect = lensNavRef.current?.getBoundingClientRect();
+      if (!rect) return;
+      const width = 264;
+      const gap = 12;
+      const minLeft = 16;
+      const maxLeft = Math.max(minLeft, window.innerWidth - width - 16);
+      const left = Math.min(Math.max(rect.right + gap, minLeft), maxLeft);
+      const top = Math.max(16, Math.round(rect.top - 4));
+      setLensRevealStyle({ left, top });
+    };
+    updatePosition();
+    window.addEventListener("resize", updatePosition);
+    window.addEventListener("scroll", updatePosition, true);
+    return () => {
+      window.removeEventListener("resize", updatePosition);
+      window.removeEventListener("scroll", updatePosition, true);
+    };
+  }, [showLensReveal, railCollapsed]);
+
   const threads = useMemo(() => getHelperThreadRows(workspaceConfig), [workspaceConfig]);
 
   useEffect(() => {
@@ -1533,6 +1630,10 @@ export function WorkspaceRail({
   }, [railCollapsed]);
 
   const handleAskHelperClick = () => {
+    if (!isHelperConfigured(workspaceConfig)) {
+      setHelperSetupOpen(true);
+      return;
+    }
     if (onOpenHelper) {
       onOpenHelper();
       return;
@@ -1740,25 +1841,45 @@ export function WorkspaceRail({
           model surface IS the user-facing object/list management. */}
       {activeTab === "home" ? (
         <nav className="workspace-nav" aria-label="Workspace pages">
+          {activationSlot ? (
+            <div className="workspace-rail-activation-slot">{activationSlot}</div>
+          ) : null}
           {dashboardsSlot ?? (
-            <Link href="/" className={pathname === "/" ? "active" : undefined}>
-              Builder
+            <Link href="/" title="Builder" className={pathname === "/" ? "active" : undefined}>
+              <Wrench size={15} aria-hidden="true" />
+              <span className="workspace-nav-label">Builder</span>
             </Link>
           )}
+          {lensUnlocked ? (
+            <div className="workspace-rail-lens-nav" ref={lensNavRef}>
+              <Link
+                href="/workspace-lens"
+                title="Workspace Lens"
+                className={pathname.startsWith("/workspace-lens") ? "active" : undefined}
+              >
+                <Eye size={15} aria-hidden="true" />
+                <span className="workspace-nav-label">Workspace Lens</span>
+              </Link>
+            </div>
+          ) : null}
           {dataModelSlot ?? (
             <Link
               href="/data-model"
+              title="Management"
               className={pathname.startsWith("/data-model") ? "active" : undefined}
             >
-              Management
+              <Database size={15} aria-hidden="true" />
+              <span className="workspace-nav-label">Management</span>
             </Link>
           )}
           {settingsSlot ?? (
             <Link
               href="/settings/general"
+              title="Workspace Settings"
               className={"workspace-nav-bottom" + (pathname.startsWith("/settings") ? " active" : "")}
             >
-              Workspace Settings
+              <Settings size={15} aria-hidden="true" />
+              <span className="workspace-nav-label">Workspace Settings</span>
             </Link>
           )}
         </nav>
@@ -1926,6 +2047,29 @@ export function WorkspaceRail({
         <span className="status-dot" />
         {authority || "local-catalog"}
       </div>
+      {showLensReveal && lensRevealStyle && typeof document !== "undefined"
+        ? createPortal(
+            <WorkspaceLensWalkthrough
+              step={1}
+              className="is-rail-reveal"
+              style={lensRevealStyle}
+              onPrimary={enterLensWalkthrough}
+              onDismiss={dismissLensWalkthrough}
+            />,
+          document.body,
+        )
+        : null}
+      <WorkspaceHelperSetupModal
+        workspaceConfig={workspaceConfig}
+        open={helperSetupOpen}
+        onClose={() => setHelperSetupOpen(false)}
+        onSaved={(nextConfig) => {
+          setHelperSetupOpen(false);
+          if (onConfigChange) onConfigChange(nextConfig);
+          if (onOpenHelper) onOpenHelper();
+          else router.push("/data-model?helper=open");
+        }}
+      />
     </aside>
   );
 }