@growthub/cli 0.13.8 → 0.13.9

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/workspace/codex-sites/route.js

@@ -0,0 +1,13 @@
+import { NextResponse } from "next/server";
+import { listLocalCodexSites } from "@/lib/codex-sites-local-state";
+
+async function GET() {
+  const sites = await listLocalCodexSites();
+  return NextResponse.json({
+    ok: true,
+    source: "codex-local-session-state",
+    sites
+  });
+}
+
+export { GET };

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/data-model/components/DataModelShell.jsx

@@ -95,6 +95,12 @@ import {
   pluralize,
   textColorForAccent,
 } from "./dm-shared.jsx";
+import {
+  CODEX_SITES_OBJECT_ID,
+  codexSiteRecordToRow,
+  isCodexSiteUrl,
+  normalizeCodexSiteRecord,
+} from "@/lib/codex-sites-workspace-adapter";
 
 // ─── Object type definitions for the type-picker step ────────────────────────
 
@@ -1015,6 +1021,95 @@ function SandboxRecordFields({
   );
 }
 
+function CodexSitesRecordFields({ draft, setDraft, table, saving, onSave, rowIndex }) {
+  const [sites, setSites] = useState([]);
+  const [loadingSites, setLoadingSites] = useState(false);
+  const [sitesMessage, setSitesMessage] = useState("");
+  const selectedUrl = String(draft?.url || "").trim();
+
+  useEffect(() => {
+    let cancelled = false;
+    setLoadingSites(true);
+    setSitesMessage("");
+    fetch("/api/workspace/codex-sites", { cache: "no-store" })
+      .then((res) => res.json())
+      .then((payload) => {
+        if (cancelled) return;
+        const nextSites = Array.isArray(payload.sites)
+          ? payload.sites.map((site) => normalizeCodexSiteRecord(site)).filter((site) => isCodexSiteUrl(site.url))
+          : [];
+        setSites(nextSites);
+        setSitesMessage(nextSites.length ? "" : "No Codex Sites are available from the workspace adapter.");
+      })
+      .catch((error) => {
+        if (cancelled) return;
+        setSites([]);
+        setSitesMessage(error?.message || "Codex Sites adapter unavailable.");
+      })
+      .finally(() => {
+        if (!cancelled) setLoadingSites(false);
+      });
+    return () => { cancelled = true; };
+  }, []);
+
+  function patchFields(fields) {
+    setDraft((current) => ({ ...current, ...fields }));
+    onSave((config) => Object.entries(fields).reduce(
+      (nextConfig, [column, value]) => updateTableCell(nextConfig, table, rowIndex, column, value),
+      config
+    ));
+  }
+
+  function selectSite(url) {
+    const site = sites.find((item) => item.url === url);
+    if (!site) return;
+    patchFields(codexSiteRecordToRow(site));
+  }
+
+  return (
+    <div className="dm-codex-sites-config">
+      <DrawerSection title="Codex Site Binding" defaultOpen>
+        <label className="dm-record-field">
+          <span>Available site</span>
+          <StaticSelect
+            value={selectedUrl}
+            disabled={!table.mutable || saving || loadingSites || sites.length === 0}
+            placeholder={loadingSites ? "Loading Codex Sites..." : "Select Codex Site..."}
+            options={sites.map((site) => ({
+              value: site.url,
+              label: site.Name,
+              source: site.url,
+            }))}
+            onChange={selectSite}
+          />
+          {sitesMessage && <span className="dm-cell-empty">{sitesMessage}</span>}
+        </label>
+        {selectedUrl && (
+          <a className="dm-btn-outline dm-codex-sites-open-link" href={selectedUrl} target="_blank" rel="noreferrer">
+            <Link2 size={13} />Open selected site
+          </a>
+        )}
+      </DrawerSection>
+      <DrawerSection title="Bound Row" defaultOpen>
+        {["Name", "app", "client", "url", "status", "accessMode", "dashboardId", "lastRecordedAt", "notes"].map((column) => (
+          <RecordFieldEditor
+            key={column}
+            table={table}
+            tables={[]}
+            column={column}
+            value={String(draft?.[column] ?? "")}
+            saving={saving}
+            editable={false}
+            onDraft={() => {}}
+            onCommit={() => {}}
+            onExpandJson={() => {}}
+          />
+        ))}
+      </DrawerSection>
+    </div>
+  );
+}
+
 function DataModelRecordDrawer({
   table,
   tables,
@@ -1086,6 +1181,7 @@ function DataModelRecordDrawer({
 
   const isApiRegistry = table.objectType === "api-registry";
   const isSandbox = table.objectType === "sandbox-environment";
+  const isCodexSitesObject = table.objectId === CODEX_SITES_OBJECT_ID;
   const isDirty = JSON.stringify(draft || {}) !== JSON.stringify(row || {}) || JSON.stringify(pendingColumns) !== JSON.stringify(table.columns || []) || JSON.stringify(pendingHidden) !== JSON.stringify(table.fieldSettings?.hidden || []);
 
   function updateField(column, value) {
@@ -1561,6 +1657,15 @@ function DataModelRecordDrawer({
               onOpenGraphSidecar={openWorkflowView}
               onOpenTraceSidecar={openTraceSidecar}
             />
+          ) : isCodexSitesObject ? (
+            <CodexSitesRecordFields
+              draft={draft}
+              setDraft={setDraft}
+              table={table}
+              saving={saving}
+              onSave={onSave}
+              rowIndex={rowIndex}
+            />
           ) : groupRecordColumns(table.columns || []).map((section) => (
             <DrawerSection key={section.title} title={section.title}>
               {section.columns.map((column) => (

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/globals.css

@@ -857,7 +857,8 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
 .workspace-dashboard-title {
   min-width: 0;
 }
-.workspace-dashboard-title button {
+.workspace-dashboard-title button,
+.workspace-dashboard-title a {
   min-width: 0;
   display: inline-flex;
   align-items: center;
@@ -870,6 +871,7 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   overflow: hidden;
   padding: 0;
   text-align: left;
+  text-decoration: none;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
@@ -953,17 +955,24 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   background: #ffffff;
   box-shadow: 0 12px 30px rgba(15, 23, 42, .16);
 }
-.workspace-row-action-menu button {
+.workspace-row-action-menu button,
+.workspace-row-action-menu a {
   width: 100%;
   min-height: 30px;
+  display: inline-flex;
+  align-items: center;
   justify-content: flex-start;
   border: 0;
   border-radius: 6px;
   background: transparent;
   color: #344054;
+  font: inherit;
+  font-size: 12px;
   padding: 0 9px;
+  text-decoration: none;
 }
-.workspace-row-action-menu button:hover {
+.workspace-row-action-menu button:hover,
+.workspace-row-action-menu a:hover {
   background: #f5f5f5;
   border-color: transparent;
 }
@@ -3079,6 +3088,55 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   border-top: 1px solid #eeeeec;
   padding: 20px 0;
 }
+.workspace-settings-accordion {
+  gap: 12px;
+}
+.workspace-settings-accordion-trigger {
+  width: 100%;
+  min-height: 34px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 14px;
+  border: 0;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  font: inherit;
+  padding: 0;
+  text-align: left;
+}
+.workspace-settings-accordion-trigger > span {
+  min-width: 0;
+  display: grid;
+  gap: 3px;
+}
+.workspace-settings-accordion-trigger h3 {
+  margin: 0;
+}
+.workspace-settings-accordion-trigger em {
+  min-width: 0;
+  display: block;
+  color: #888;
+  font-size: 12px;
+  font-style: normal;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.workspace-settings-accordion-trigger svg {
+  flex: 0 0 auto;
+  color: #777;
+  transition: transform .16s ease;
+}
+.workspace-settings-accordion.is-open .workspace-settings-accordion-trigger svg {
+  transform: rotate(180deg);
+}
+.workspace-settings-accordion-body {
+  min-height: 0;
+  display: grid;
+  gap: 12px;
+}
 .workspace-apps-linkage-section {
   flex: 0 0 auto;
   padding-bottom: 16px;
@@ -3089,6 +3147,9 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   grid-template-rows: auto minmax(0, 1fr);
   padding-bottom: 0;
 }
+.workspace-apps-list-section .workspace-settings-accordion-body {
+  min-height: 0;
+}
 .workspace-settings-section:first-of-type {
   border-top: 0;
   padding-top: 0;
@@ -3577,6 +3638,52 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   font-size: 12px;
   line-height: 1.4;
 }
+.workspace-settings-action {
+  min-height: 32px;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  border: 1px solid #dedede;
+  border-radius: 6px;
+  background: #fff;
+  color: #333;
+  font: inherit;
+  font-size: 12px;
+  padding: 0 10px;
+}
+.workspace-settings-codex-sites-list {
+  display: grid;
+  gap: 6px;
+  padding: 0 14px 0;
+}
+.workspace-settings-codex-sites-list a,
+.workspace-settings-codex-sites-list button {
+  min-height: 34px;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(0, .8fr) auto;
+  gap: 10px;
+  align-items: center;
+  border: 1px solid #ececea;
+  border-radius: 6px;
+  background: #fff;
+  color: #333;
+  font: inherit;
+  font-size: 12px;
+  text-align: left;
+  text-decoration: none;
+  padding: 0 10px;
+}
+.workspace-settings-codex-sites-list span,
+.workspace-settings-codex-sites-list em {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.workspace-settings-codex-sites-list em {
+  color: #777;
+  font-style: normal;
+}
 
 /* Source picker */
 .workspace-source-list {
@@ -4639,7 +4746,7 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
 .dm-detail-v2-title h2 { margin: 0; font-size: 15px; font-weight: 600; color: #111827; flex: 1; }
 .dm-detail-v2-meta { display: flex; align-items: center; gap: 10px; padding-left: 21px; font-size: 12px; color: #9ca3af; }
 .dm-detail-v2-meta code { font-size: 11px; color: #6b7280; background: #f3f4f6; border-radius: 4px; padding: 2px 6px; }
-.dm-detail-v3 { border: 1px solid #e5e7eb; border-radius: 12px; background: #fff; overflow: hidden; }
+.dm-detail-v3 { border: 1px solid #e5e7eb; border-radius: 12px; background: #fff; overflow: visible; }
 .dm-picker { position: relative; min-width: 280px; }
 .dm-picker-trigger { width: min(420px, 100%); display: inline-flex; align-items: center; gap: 10px; min-height: 40px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; color: #0f172a; box-shadow: 0 1px 2px rgba(15,23,42,.05); font: inherit; padding: 0 12px; cursor: pointer; text-align: left; }
 .dm-picker.open .dm-picker-trigger { border-color: #94a3b8; box-shadow: 0 0 0 4px rgba(148,163,184,.14); }
@@ -4680,6 +4787,7 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
 .workspace-toolbar-actions .dm-picker-popover {
   left: auto;
   right: 0;
+  z-index: 220;
 }
 
 /* Active-object title block in the workspace toolbar — replaces the
@@ -4729,13 +4837,13 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
   font-weight: 400;
   color: #6b7280;
 }
-.dm-picker-popover { position: absolute; top: calc(100% + 8px); left: 0; z-index: 50; width: 360px; display: grid; gap: 10px; padding: 12px; border: 1px solid #dbe2ea; border-radius: 14px; background: #fff; box-shadow: 0 28px 80px rgba(15,23,42,.24); overflow: visible; }
+.dm-picker-popover { position: absolute; top: calc(100% + 8px); left: 0; z-index: 220; width: min(360px, calc(100vw - 32px)); max-height: min(520px, calc(100vh - 120px)); display: grid; gap: 10px; padding: 12px; border: 1px solid #dbe2ea; border-radius: 14px; background: #fff; box-shadow: 0 28px 80px rgba(15,23,42,.24); overflow-y: auto; overflow-x: visible; }
 .dm-picker-tabs { display: inline-flex; gap: 6px; padding: 4px; border-radius: 999px; background: #f8fafc; }
 .dm-picker-tabs button { height: 28px; border: 0; border-radius: 999px; background: transparent; color: #64748b; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; }
 .dm-picker-tabs button.active { background: #fff; color: #111827; box-shadow: 0 1px 2px rgba(15,23,42,.08); }
 .dm-picker-section { display: grid; gap: 8px; }
 .dm-picker-section > p { margin: 0; font-size: 11px; font-weight: 700; color: #94a3b8; text-transform: uppercase; letter-spacing: .06em; }
-.dm-picker-scroll { display: grid; gap: 4px; max-height: 220px; overflow-y: auto; padding-right: 10px; scrollbar-gutter: stable; }
+.dm-picker-scroll { display: grid; gap: 4px; max-height: none; overflow: visible; padding-right: 10px; scrollbar-gutter: stable; }
 .dm-picker-item { position: relative; display: grid; grid-template-columns: minmax(0,1fr) auto; gap: 8px; align-items: center; }
 .dm-picker-row { width: 100%; display: inline-flex; align-items: center; gap: 8px; min-width: 0; min-height: 34px; border: 0; border-radius: 9px; background: transparent; color: #334155; font: inherit; font-size: 12px; font-weight: 500; padding: 0 10px; cursor: pointer; text-align: left; }
 .dm-picker-row:hover, .dm-picker-item.active .dm-picker-row { background: #f1f5f9; color: #111827; }
@@ -4746,7 +4854,7 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
 .dm-picker-icon-btn:hover { color: #111827; border-color: #cbd5e1; }
 .dm-picker-icon-btn.danger:hover { color: #b91c1c; border-color: #fecaca; background: #fef2f2; }
 .dm-picker-lock { margin-left: auto; color: #94a3b8; }
-.dm-picker-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 55; display: grid; gap: 4px; min-width: 156px; padding: 8px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 20px 44px rgba(15,23,42,.2), 0 4px 12px rgba(15,23,42,.08); }
+.dm-picker-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 240; display: grid; gap: 4px; min-width: 156px; padding: 8px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 20px 44px rgba(15,23,42,.2), 0 4px 12px rgba(15,23,42,.08); }
 .dm-picker-menu button { display: inline-flex; align-items: center; gap: 8px; height: 30px; border: 0; border-radius: 7px; background: transparent; color: #334155; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; text-align: left; }
 .dm-picker-menu button:hover { background: #f1f5f9; color: #111827; }
 .dm-picker-menu button.danger:hover { background: #fef2f2; color: #b91c1c; }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/settings/apps/codex-sites-data-model-card.jsx

@@ -0,0 +1,81 @@
+"use client";
+
+import { ExternalLink, Rocket } from "lucide-react";
+import {
+  CODEX_SITES_OBJECT_ID,
+  ensureCodexSitesDataModel,
+  isCodexSiteUrl
+} from "@/lib/codex-sites-workspace-adapter";
+import { SettingsAccordionSection } from "./settings-accordion-section.jsx";
+
+function CodexSitesDataModelCard({ apps, dataModel }) {
+  const objects = Array.isArray(dataModel?.objects) ? dataModel.objects : [];
+  const object = objects.find((item) => item?.id === CODEX_SITES_OBJECT_ID) || null;
+  const rows = Array.isArray(object?.rows) ? object.rows : [];
+  const liveRows = rows.filter((row) => {
+    const status = String(row?.status || "").toLowerCase();
+    return isCodexSiteUrl(row?.url) && (status === "live" || status === "active");
+  });
+  const liveCount = liveRows.length;
+  const appCount = new Set(rows.map((row) => row?.app).filter(Boolean)).size;
+
+  async function openDataModel() {
+    if (!object) {
+      const nextDataModel = ensureCodexSitesDataModel(dataModel, apps);
+      const response = await fetch("/api/workspace", {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ dataModel: nextDataModel })
+      });
+      if (!response.ok) {
+        const payload = await response.json().catch(() => ({}));
+        window.alert(payload.error || "Failed to create Codex Sites object.");
+        return;
+      }
+    }
+    window.location.href = `/data-model?object=${encodeURIComponent(CODEX_SITES_OBJECT_ID)}`;
+  }
+
+  return <SettingsAccordionSection
+    id="codex-sites"
+    title="Codex Sites"
+    summary={`${rows.length} site${rows.length === 1 ? "" : "s"} · ${liveCount} live · ${appCount || apps?.length || 0} app${(appCount || apps?.length || 0) === 1 ? "" : "s"}`}
+    className="workspace-apps-linkage-section workspace-codex-sites-section"
+  >
+    <div className="workspace-app-row">
+      <span className="workspace-provider-mark"><Rocket size={15} /></span>
+      <div>
+        <strong>Codex Sites</strong>
+        <p>Manage Codex-hosted site URLs as a governed custom Data Model object attached to workspace apps and clients.</p>
+        <div className="workspace-integration-meta">
+          <span>{object ? "configured" : "not configured"}</span>
+          <span>{rows.length} site{rows.length === 1 ? "" : "s"}</span>
+          <span>{liveCount} live</span>
+          <span>{appCount || apps?.length || 0} app{(appCount || apps?.length || 0) === 1 ? "" : "s"}</span>
+        </div>
+      </div>
+      <button type="button" className="workspace-settings-action" onClick={openDataModel}>
+        <ExternalLink size={14} />{object ? "Manage" : "Set up"}
+      </button>
+    </div>
+    {rows.length ? <div className="workspace-settings-codex-sites-list">
+      {rows.slice(0, 4).map((row, index) => isCodexSiteUrl(row?.url) ? (
+        <a key={row.id || row.Name || index} href={row.url} target="_blank" rel="noreferrer">
+          <span>{row.Name || `Site ${index + 1}`}</span>
+          <em>{row.client || "Workspace"} · {row.app || "apps/workspace"}</em>
+          <ExternalLink size={13} />
+        </a>
+      ) : (
+        <button key={row.id || row.Name || index} type="button" onClick={openDataModel}>
+          <span>{row.Name || `Site ${index + 1}`}</span>
+          <em>{row.client || "Workspace"} · {row.status || "draft"}</em>
+        </button>
+      ))}
+    </div> : null}
+  </SettingsAccordionSection>;
+}
+
+export {
+  CODEX_SITES_OBJECT_ID,
+  CodexSitesDataModelCard
+};

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,
@@ -89,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";
@@ -503,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;
@@ -4246,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",
@@ -4266,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;
@@ -4709,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);
@@ -5234,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),
@@ -5916,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>}
@@ -5952,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
@@ -6052,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/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
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthub/cli",
-  "version": "0.13.8",
+  "version": "0.13.9",
   "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": {