@growthub/cli 0.13.7 → 0.13.9

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) {
@@ -1504,6 +1536,40 @@ export function WorkspaceRail({
   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));
@@ -1512,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;
 
@@ -1525,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(() => {
@@ -1538,6 +1630,10 @@ export function WorkspaceRail({
   }, [railCollapsed]);
 
   const handleAskHelperClick = () => {
+    if (!isHelperConfigured(workspaceConfig)) {
+      setHelperSetupOpen(true);
+      return;
+    }
     if (onOpenHelper) {
       onOpenHelper();
       return;
@@ -1749,24 +1845,41 @@ export function WorkspaceRail({
             <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>
@@ -1934,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>
   );
 }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/codex-sites-local-state.js

@@ -0,0 +1,139 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { normalizeCodexSiteRecord } from "./codex-sites-workspace-adapter.js";
+
+const MAX_SESSION_FILES = 16;
+
+function resolveCodexHome() {
+  return process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
+}
+
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function stripSensitiveProjectFields(project) {
+  if (!isPlainObject(project)) return null;
+  const {
+    source_repository_credential: _sourceRepositoryCredential,
+    access_policy: _accessPolicy,
+    auth_client_id: _authClientId,
+    ...safeProject
+  } = project;
+  return safeProject;
+}
+
+function parseJsonMaybe(value) {
+  if (isPlainObject(value)) return value;
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    const marker = "Output:";
+    const index = trimmed.lastIndexOf(marker);
+    if (index === -1) return null;
+    const candidate = trimmed.slice(index + marker.length).trim();
+    try {
+      return JSON.parse(candidate);
+    } catch {
+      return null;
+    }
+  }
+}
+
+function collectStructuredPayloads(line) {
+  const parsed = parseJsonMaybe(line);
+  if (!isPlainObject(parsed)) return [];
+  const payload = parsed.payload;
+  const values = [];
+  const structured = payload?.result?.Ok?.structuredContent;
+  if (isPlainObject(structured)) values.push(structured);
+  const outputPayload = parseJsonMaybe(payload?.output);
+  if (isPlainObject(outputPayload)) values.push(outputPayload);
+  return values;
+}
+
+function mergeCodexSitePayload(byProjectId, payload) {
+  if (!isPlainObject(payload)) return;
+  const isProject =
+    typeof payload.id === "string" &&
+    payload.id.startsWith("appgprj_") &&
+    (payload.current_live_url !== undefined || payload.slug || payload.title);
+  const isDeployment =
+    typeof payload.project_id === "string" &&
+    typeof payload.url === "string" &&
+    payload.url.startsWith("http");
+  if (!isProject && !isDeployment) return;
+
+  const projectId = isProject ? payload.id : payload.project_id;
+  const current = byProjectId.get(projectId) || { id: projectId };
+  const next = isProject
+    ? { ...current, ...stripSensitiveProjectFields(payload) }
+    : {
+        ...current,
+        id: projectId,
+        title: payload.title || current.title,
+        current_live_url: payload.url,
+        status: payload.status === "succeeded" ? "live" : payload.status || current.status,
+        updated_at: payload.updated_at || current.updated_at,
+        dashboardId: current.dashboardId || projectId,
+        deployment_id: payload.id,
+        version_id: payload.version_id
+      };
+  byProjectId.set(projectId, next);
+}
+
+async function listSessionFiles(root) {
+  const entries = [];
+  async function visit(dir) {
+    let children;
+    try {
+      children = await fs.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    await Promise.all(children.map(async (entry) => {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await visit(fullPath);
+        return;
+      }
+      if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+        const stat = await fs.stat(fullPath).catch(() => null);
+        if (stat) entries.push({ path: fullPath, mtimeMs: stat.mtimeMs });
+      }
+    }));
+  }
+  await visit(root);
+  return entries
+    .sort((a, b) => b.mtimeMs - a.mtimeMs)
+    .slice(0, MAX_SESSION_FILES)
+    .map((entry) => entry.path);
+}
+
+async function listLocalCodexSites() {
+  const codexHome = resolveCodexHome();
+  const sessionRoot = path.join(codexHome, "sessions");
+  const files = await listSessionFiles(sessionRoot);
+  const byProjectId = new Map();
+  for (const file of files) {
+    const raw = await fs.readFile(file, "utf8").catch(() => "");
+    if (!raw.includes("mcp__codex_apps__sites") && !raw.includes("sites_") && !raw.includes("appgprj_")) continue;
+    raw.split(/\r?\n/).forEach((line) => {
+      collectStructuredPayloads(line).forEach((payload) => mergeCodexSitePayload(byProjectId, payload));
+    });
+  }
+  return Array.from(byProjectId.values())
+    .map((site) => normalizeCodexSiteRecord({
+      ...site,
+      url: site.current_live_url || site.url,
+      accessMode: site.access_mode,
+      dashboardId: site.dashboardId || site.slug || site.id
+    }))
+    .filter((site) => site.url);
+}
+
+export { listLocalCodexSites };

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/codex-sites-workspace-adapter.js

@@ -0,0 +1,156 @@
+const CODEX_SITES_OBJECT_ID = "workspace-codex-sites";
+const CODEX_SITES_COLUMNS = [
+  "Name",
+  "app",
+  "client",
+  "url",
+  "status",
+  "accessMode",
+  "dashboardId",
+  "lastRecordedAt",
+  "notes"
+];
+const CODEX_SITES_SOURCE_ID = "codex-sites";
+
+function isCodexSiteUrl(value) {
+  return /^https?:\/\//i.test(String(value || "").trim());
+}
+
+function defaultAppSource(apps) {
+  const first = Array.isArray(apps) ? apps.find((app) => app?.source) : null;
+  return first?.source || "apps/workspace";
+}
+
+function createCodexSitesObject(apps = []) {
+  return {
+    id: CODEX_SITES_OBJECT_ID,
+    label: "Codex Sites",
+    source: "Workspace Apps",
+    sourceId: CODEX_SITES_OBJECT_ID,
+    objectType: "custom",
+    icon: "Rocket",
+    columns: CODEX_SITES_COLUMNS,
+    rows: [],
+    binding: {
+      mode: "manual",
+      source: "Settings / Apps",
+      sourceType: "workspace-data-model",
+      sourceAuthority: "workspace-config",
+      objectId: CODEX_SITES_OBJECT_ID,
+      sourceId: CODEX_SITES_SOURCE_ID,
+      entityType: "codex-site",
+      app: defaultAppSource(apps)
+    },
+    fieldSettings: {
+      hidden: [],
+      order: CODEX_SITES_COLUMNS,
+      views: [
+        {
+          id: "codex-sites-live",
+          name: "Live",
+          favorite: true,
+          order: CODEX_SITES_COLUMNS,
+          filter: { op: "and", clauses: [{ fieldId: "status", operator: "eq", value: "live" }] }
+        },
+        {
+          id: "codex-sites-review",
+          name: "Draft & Review",
+          order: CODEX_SITES_COLUMNS,
+          filter: { op: "or", clauses: [
+            { fieldId: "status", operator: "eq", value: "draft" },
+            { fieldId: "status", operator: "eq", value: "review" }
+          ] }
+        }
+      ],
+      activeViewId: "codex-sites-live",
+      types: {
+        Name: "text",
+        app: "text",
+        client: "text",
+        url: "url",
+        status: "select",
+        accessMode: "select",
+        dashboardId: "text",
+        lastRecordedAt: "date",
+        notes: "text"
+      }
+    }
+  };
+}
+
+function normalizeCodexSiteRecord(record = {}) {
+  const url = String(record.url || record.liveUrl || record.current_live_url || "").trim();
+  return {
+    id: String(record.id || record.projectId || record.project_id || record.slug || url).trim(),
+    Name: String(record.Name || record.name || record.title || record.slug || "Codex Site").trim(),
+    app: String(record.app || record.source || "apps/workspace").trim(),
+    client: String(record.client || record.workspace || "Workspace").trim(),
+    url,
+    status: String(record.status || (url ? "live" : "draft")).trim(),
+    accessMode: String(record.accessMode || record.access_mode || "workspace").trim(),
+    dashboardId: String(record.dashboardId || record.dashboard_id || record.slug || record.id || "").trim(),
+    lastRecordedAt: String(record.lastRecordedAt || record.updated_at || record.created_at || "").trim(),
+    notes: String(record.notes || record.description || "").trim()
+  };
+}
+
+function codexSiteRecordToRow(record = {}) {
+  const site = normalizeCodexSiteRecord(record);
+  return {
+    Name: site.Name,
+    app: site.app,
+    client: site.client,
+    url: site.url,
+    status: site.status,
+    accessMode: site.accessMode,
+    dashboardId: site.dashboardId,
+    lastRecordedAt: site.lastRecordedAt || new Date().toISOString(),
+    notes: site.notes
+  };
+}
+
+function recordsFromSourceEntry(entry) {
+  if (Array.isArray(entry)) return entry;
+  if (Array.isArray(entry?.records)) return entry.records;
+  if (Array.isArray(entry?.sites)) return entry.sites;
+  if (Array.isArray(entry?.items)) return entry.items;
+  return [];
+}
+
+function listAvailableCodexSites(workspaceConfig = {}, workspaceSourceRecords = {}) {
+  const sidecarRecords = [
+    ...recordsFromSourceEntry(workspaceSourceRecords?.[CODEX_SITES_SOURCE_ID]),
+    ...recordsFromSourceEntry(workspaceSourceRecords?.[CODEX_SITES_OBJECT_ID])
+  ];
+  const objects = Array.isArray(workspaceConfig?.dataModel?.objects) ? workspaceConfig.dataModel.objects : [];
+  const object = objects.find((item) => item?.id === CODEX_SITES_OBJECT_ID);
+  const rowRecords = Array.isArray(object?.rows) ? object.rows : [];
+  const byUrl = new Map();
+  [...sidecarRecords, ...rowRecords].forEach((record) => {
+    const site = normalizeCodexSiteRecord(record);
+    if (!isCodexSiteUrl(site.url)) return;
+    byUrl.set(site.url, site);
+  });
+  return Array.from(byUrl.values());
+}
+
+function ensureCodexSitesDataModel(dataModel, apps = []) {
+  const objects = Array.isArray(dataModel?.objects) ? dataModel.objects : [];
+  if (objects.some((object) => object?.id === CODEX_SITES_OBJECT_ID)) return dataModel || {};
+  return {
+    ...(dataModel || {}),
+    objects: [...objects, createCodexSitesObject(apps)]
+  };
+}
+
+export {
+  CODEX_SITES_COLUMNS,
+  CODEX_SITES_OBJECT_ID,
+  CODEX_SITES_SOURCE_ID,
+  codexSiteRecordToRow,
+  createCodexSitesObject,
+  ensureCodexSitesDataModel,
+  isCodexSiteUrl,
+  listAvailableCodexSites,
+  normalizeCodexSiteRecord
+};