@growthub/cli 0.14.6 → 0.14.9

package/assets/worker-kits/growthub-custom-workspace-starter-v1/SKILL.md

@@ -39,6 +39,27 @@ mcpTools: []
 
 The **Workspace** is the top-level Growthub Local product object. This kit is the official starter that bootstraps every governed Workspace; everything else (worker kits, templates, workflows, hosted agents, source imports) is an input to a Workspace.
 
+## Your operating role (read first)
+
+**If you are an agent reading this, you are the operating layer.** A human gave you an outcome; you operate this governed Workspace on their behalf. When the requester is a super admin or workspace admin, you can act as the super-admin orchestrator inside the governed boundary; when the requester is a regular user, you still do the orchestration work, but approval, review, rollback, and authority stay with the workspace/super-admin surfaces. You are not editing files and hoping tests catch mistakes — you are operating a live domain model where the platform rejects invalid reality before it lands and remembers everything that does. The chat you are in *is* the user's steering surface; the no-code Workspace is the control and audit plane.
+
+**The human is usually non-technical, and asks for a business outcome — not workspace mechanics.** They will not mention the Data Model, metadata graph, routes, validators, the PATCH boundary, or the run console — those are the control plane and proof layer that exist so you can operate safely and the super admin can inspect everything. They ask in plain language: *research a customer avatar, run market/competitor research, generate this week's content batch, script and brief the next campaign, pull the latest campaign performance, update the client report, build an MRR-by-plan dashboard, run the revenue workflow, iterate on a feature, find what broke.* Your job is to translate that outcome into governed operations over **what already exists** in this Workspace (prebuilt workflows, objects, and procedures), execute it, and deliver the result — outputs saved, synced, inspectable, and governed. This **private repository is the customer's durable operating environment**: their kit, objects, workflows, procedures, rules, source records, docs, receipts, run history, and governance boundaries all live here; your session is just the operator entering that universe.
+
+The completion bar is the user's real-world outcome, not a partial proposal or a hidden local artifact. Continue the governed loop until the workspace has objective proof: the relevant workflow ran or object changed, output rows/ledgers reflect the count and state, durable storage or source records hold the deliverables, receipts/run ids explain what happened, and any human-review state remains explicit. Do not hard-code one client's workflow as the pattern; swap the client, rows, registries, brand constraints, storage prefix, dashboard, and quality criteria while keeping the same governed causation loop.
+
+Your loop, every time:
+
+1. **Inherit state** — read the `workspace:agent-outcomes` receipt stream (`GET /api/workspace/agent-outcomes`) and `.growthub-fork/project.md` to see what the last agent did; continue from `nextActions` / `rollbackRef`, don't redo work.
+2. **Check what exists** — a scheduled job, external API, data view, or multi-agent workflow is almost always already a governed object. Prefer operating an existing object over writing code.
+3. **Act only through governed routes** — `PATCH /api/workspace` (config) and `POST /api/workspace/sandbox-run` (execution); drafts via `workflow/publish`; proposals via `helper/apply`. There is no third path.
+4. **Let the validator correct you** — preflight, read the rejection reason, repair, retry. Rejections are navigation, not failure.
+5. **Persist the outcome** — count only connected, durable outputs; save accepted artifacts to the governed ledger/storage surface; keep generated binaries and secrets out of git.
+6. **Leave proof** — every governed action emits a secret-redacted receipt. The human does not need the mechanics; the super admin inspects all of it after the fact (Workspace Map, Run Console, outcome cockpit).
+
+**Three roles:** the human states outcomes → you (the agent) operate → the workspace admin/super admin governs and audits. The mechanics of the boundary are in [`skills/governed-workspace-mutation/SKILL.md`](./skills/governed-workspace-mutation/SKILL.md) — read it before any mutation.
+
+> **For the human operator:** you do not have to operate this Workspace yourself. Tell an agent what you want; it operates the Workspace through governed routes; you (or your admin) inspect every change with full proof and rollback. The no-code Builder is the governed substrate and the audit surface — not a tool you must personally drive.
+
 Every Growthub governed Workspace is materialised from this kit. The kit ships the `.growthub-fork/` contract (identity, policy, trace, optional authority), the `apps/workspace` no-code Workspace Builder, the validated `growthub.config.json` V1 contract, plus the six primitive layers Claude/Cursor/Codex agents operate against:
 
 1. **`SKILL.md`** — this file. Discovery entry + routing menu. Always loaded first; the full operator runbook (`skills.md`) is disclosed progressively when work begins.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/README.md

@@ -18,7 +18,7 @@ It intentionally depends on adapter contracts:
 - `NANGO_ENVIRONMENT` (default `dev`)
 - `NANGO_MODE` (`cloud` | `self-hosted`, default `cloud`)
 
-The Growthub local-first operator shell remains at `../../studio`.
+This `apps/workspace` app is the only bundled app surface; the legacy `studio/` Vite shell has been removed. It is the governed control plane and audit surface — non-technical users do not operate it directly; an agent operates the Workspace on their behalf through the governed routes (see the workspace `SKILL.md` operating-role contract), while super admins use this app for inspection, proof, and governance.
 
 Settings exposes two universal integration lanes:
 

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

@@ -413,6 +413,11 @@ function buildRunResponse({
   if (result && typeof result === "object" && Array.isArray(result.logTree)) {
     base.logTree = result.logTree;
   }
+  // Per-node orchestration execution trace (general pipeline, not swarm) so the
+  // Workflow Canvas can settle per-node status from the persisted record.
+  if (result && typeof result === "object" && Array.isArray(result.nodeTrace)) {
+    base.nodeTrace = result.nodeTrace;
+  }
   base.exports = {
     available: ["download-json", "copy-output", "download-stdout", "download-stderr", "download-log-node"],
     external: []

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

@@ -20,7 +20,7 @@
 
 import { useEffect, useMemo, useState } from "react";
 import Link from "next/link";
-import { Activity, BarChart3, Check, Copy, Eye, GitBranch, MoreVertical, Search } from "lucide-react";
+import { Activity, BarChart3, Check, Copy, Eye, GitBranch, MoreVertical, Search, Share2 } from "lucide-react";
 import { deriveWorkspaceState, deriveSwarmConditionPacket, deriveWorkspaceContributions, deriveLensWalkthroughState, LENS_WALKTHROUGH_DISMISS_FLAG } from "@/lib/workspace-activation";
 import { WorkspaceContributionGraph } from "./WorkspaceContributionGraph.jsx";
 import { WorkspaceLensWalkthrough } from "./WorkspaceLensWalkthrough.jsx";
@@ -244,9 +244,10 @@ export function WorkspaceLensPanel({ workspaceConfig, workspaceSourceRecords, me
           <h1 className="workspace-lens-title">Workspace Lens</h1>
           <p className="workspace-lens-subtitle">Live derived state for this workspace.</p>
         </div>
-        <p className="workspace-lens-score" aria-label="Workspace lens summary">
-          {counts.total} lenses · {counts.ready} ready · {counts.blocked} blocked · {counts.assignable} agent-assignable
-        </p>
+        <Link className="workspace-lens-map-link" href="/workspace-map" aria-label="Open Workspace Map">
+          <Share2 size={15} aria-hidden="true" />
+          <span>Workspace Map</span>
+        </Link>
       </header>
 
       {showWalk ? (

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

@@ -2390,6 +2390,7 @@ function DataModelTableSurface({
   const [selectMenuOpen, setSelectMenuOpen] = useState(false);
   const [pageSize, setPageSize] = useState(15);
   const [pageIndex, setPageIndex] = useState(0);
+  const [search, setSearch] = useState("");
   const fieldInputRef = useRef(null);
   const selectedOriginalIndex = selectedRecordIndex ?? localSelectedOriginalIndex;
 
@@ -2407,6 +2408,7 @@ function DataModelTableSurface({
     setLastSelectedRowIndex(null);
     setSelectMenuOpen(false);
     setPageIndex(0);
+    setSearch("");
   }, [table.id]);
 
   useEffect(() => {
@@ -2428,7 +2430,14 @@ function DataModelTableSurface({
   const visibleColumns = useMemo(() => orderedColumns.filter((column) => !settings.hidden.includes(column)), [orderedColumns, settings.hidden]);
   const rowEntries = useMemo(() => {
     const indexed = (table.rows || []).map((row, originalIndex) => ({ row, originalIndex }));
-    const filtered = indexed.filter((entry) => rowMatchesFilter(entry.row, settings.filter));
+    const needle = search.trim().toLowerCase();
+    const filtered = indexed.filter((entry) => {
+      if (!rowMatchesFilter(entry.row, settings.filter)) return false;
+      if (!needle) return true;
+      // Quick search across the visible columns only — additive to the
+      // column-level filter clauses, never replaces them.
+      return visibleColumns.some((column) => String(entry.row?.[column] ?? "").toLowerCase().includes(needle));
+    });
     if (!settings.sort?.length) return filtered;
     const clauses = settings.sort;
     return [...filtered].sort((left, right) => {
@@ -2439,7 +2448,7 @@ function DataModelTableSurface({
       }
       return 0;
     });
-  }, [table.rows, settings]);
+  }, [table.rows, settings, search, visibleColumns]);
   const selectedRowCount = selectedRows.size;
   const pageCount = Math.max(1, Math.ceil(rowEntries.length / pageSize));
   const safePageIndex = Math.min(pageIndex, pageCount - 1);
@@ -2491,7 +2500,7 @@ function DataModelTableSurface({
     setSelectedRow(null);
     setLastSelectedRowIndex(null);
     setSelectMenuOpen(false);
-  }, [settings.filter, settings.sort, pageSize]);
+  }, [settings.filter, settings.sort, pageSize, search]);
 
   function commitField() {
     const name = fieldName.trim();
@@ -2690,9 +2699,25 @@ function DataModelTableSurface({
           ))}
         </div>
         <div className="dm-records-actions">
+          <label className="dm-toolbar-search">
+            <Search size={13} aria-hidden="true" />
+            <input
+              value={search}
+              placeholder="Search records"
+              onChange={(event) => setSearch(event.target.value)}
+              aria-label={`Search ${table.label || "records"}`}
+            />
+          </label>
+          <span className="dm-toolbar-count">
+            {(search.trim() || settings.filter?.clauses?.length)
+              ? `${rowEntries.length} of ${pluralize(table.rows?.length || 0, "record")}`
+              : pluralize(table.rows?.length || 0, "record")}
+          </span>
+          <span className="dm-toolbar-divider" aria-hidden="true" />
           <span className="dm-filter-anchor">
-            <button type="button" className="dm-btn-ghost" onClick={() => setFilterTarget((current) => current === "toolbar" ? "" : "toolbar")}>
+            <button type="button" className={`dm-btn-ghost${settings.filter?.clauses?.length ? " is-active" : ""}`} onClick={() => setFilterTarget((current) => current === "toolbar" ? "" : "toolbar")}>
               <Filter size={13} />Filter
+              {settings.filter?.clauses?.length > 0 && <span className="dm-filter-chip-count">{settings.filter.clauses.length}</span>}
             </button>
             {filterTarget === "toolbar" && (
               <div className="dm-filter-popover dm-filter-popover-toolbar">
@@ -2843,6 +2868,35 @@ function DataModelTableSurface({
             </tr>
           </thead>
           <tbody>
+            {rowEntries.length === 0 && (
+              <tr className="dm-db-empty-row">
+                <td colSpan={visibleColumns.length + 1 + (table.mutable ? 1 : 0)}>
+                  <div className="dm-db-empty-state">
+                    {(search.trim() || settings.filter?.clauses?.length) ? (
+                      <>
+                        <strong>No records match</strong>
+                        <span>Try a different search or clear your filters.</span>
+                        <div className="dm-db-empty-actions">
+                          {search.trim() && <button type="button" className="dm-btn-outline" onClick={() => setSearch("")}>Clear search</button>}
+                          {settings.filter?.clauses?.length > 0 && <button type="button" className="dm-btn-outline" onClick={resetView}>Reset view</button>}
+                        </div>
+                      </>
+                    ) : (
+                      <>
+                        <strong>No records yet</strong>
+                        <span>{table.mutable ? "Add your first row or import a CSV to start using this object." : "Records resolve at runtime for this live-backed object."}</span>
+                        {table.mutable && (
+                          <div className="dm-db-empty-actions">
+                            <button type="button" className="dm-btn-primary-sm" disabled={saving} onClick={() => onSave((config) => addTableRow(config, table))}><Plus size={13} />Add record</button>
+                            <button type="button" className="dm-btn-outline" onClick={() => setCsvOpen(true)}><Upload size={13} />Import CSV</button>
+                          </div>
+                        )}
+                      </>
+                    )}
+                  </div>
+                </td>
+              </tr>
+            )}
             {pageEntries.map(({ row, originalIndex }, rowIndex) => {
               const visibleIndex = pageStart + rowIndex;
               const displayIndex = visibleIndex + 1;

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

@@ -103,6 +103,21 @@ function nodeRecordName(node) {
   return "";
 }
 
+// Per-node run-status pill (Attio-style), docked outside the node top-right.
+// Driven only by the real general-orchestration run signal passed in
+// `nodeStatuses` — the streamed orchestration.node.* deltas and the persisted
+// nodeTrace (see lib/orchestration-node-status.js). Never fabricated here.
+const NODE_STATUS_CHIP = {
+  completed: { cls: "is-ok", label: "Completed" },
+  ok: { cls: "is-ok", label: "Completed" },
+  running: { cls: "is-running", label: "Running" },
+  executing: { cls: "is-running", label: "Running" },
+  failed: { cls: "is-bad", label: "Failed" },
+  skipped: { cls: "is-waiting", label: "Skipped" },
+  pending: { cls: "is-waiting", label: "Waiting" },
+  queued: { cls: "is-waiting", label: "Waiting" },
+};
+
 export function OrchestrationGraphCanvas({
   graph,
   selectedNodeId,
@@ -112,6 +127,8 @@ export function OrchestrationGraphCanvas({
   onRunTest,
   runStatus,
   runMessage,
+  nodeStatuses,
+  onNodeStatusClick,
   statusLabel = "Draft",
 }) {
   const parsed = useMemo(() => parseOrchestrationGraph(graph) || graph, [graph]);
@@ -222,6 +239,9 @@ export function OrchestrationGraphCanvas({
           const isSelected = activeId === id;
           const prevId = index > 0 ? String(nodes[index - 1].id || "") : "";
           const Icon = NODE_ICONS[node.type] || ArrowDownToLine;
+          const nodeStatusChip = nodeStatuses
+            ? NODE_STATUS_CHIP[String(nodeStatuses[id] || "").toLowerCase()] || null
+            : null;
 
           return (
             <div key={id || index} className="dm-orchestration-canvas__step">
@@ -285,6 +305,17 @@ export function OrchestrationGraphCanvas({
                   onSelectNode?.(node);
                 }}
               >
+                {nodeStatusChip && (
+                  <button
+                    type="button"
+                    className={`dm-status-chip ${nodeStatusChip.cls} dm-orchestration-node__status`}
+                    title={`${nodeStatusChip.label} — open run trace`}
+                    onClick={(event) => { event.stopPropagation(); onNodeStatusClick?.(node); }}
+                  >
+                    <span className="dm-status-dot" aria-hidden="true" />
+                    {nodeStatusChip.label}
+                  </button>
+                )}
                 <span className="dm-orchestration-node__icon" aria-hidden="true">
                   <Icon size={14} />
                 </span>

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

@@ -1,13 +1,29 @@
 "use client";
 
+// Maps a free-form status string to one calm, consistent chip state.
+// Backwards-compatible: same { value } prop, same default ("untested").
+const OK = ["connected", "approved", "ok", "success", "succeeded", "complete", "completed", "passed", "live", "ready"];
+const BAD = ["failed", "error", "errored", "disconnected", "rejected"];
+const WARN = ["warning", "warn", "pending", "untrusted", "stale", "degraded"];
+const RUNNING = ["running", "in_progress", "in-progress", "active", "executing", "started"];
+const WAITING = ["waiting", "queued", "idle", "scheduled"];
+
+function classifyStatus(status) {
+  if (OK.includes(status)) return "is-ok";
+  if (BAD.includes(status)) return "is-bad";
+  if (RUNNING.includes(status)) return "is-running";
+  if (WARN.includes(status)) return "is-warn";
+  if (WAITING.includes(status)) return "is-waiting";
+  return "";
+}
+
 export function StatusPill({ value }) {
-  const status = String(value || "untested").toLowerCase();
-  const ok = ["connected", "approved", "ok", "success"].includes(status);
-  const bad = ["failed", "error", "disconnected"].includes(status);
+  const raw = value || "untested";
+  const state = classifyStatus(String(raw).toLowerCase());
   return (
-    <span className={`dm-db-status ${ok ? "ok" : bad ? "bad" : ""}`}>
-      <span />
-      {value || "untested"}
+    <span className={`dm-status-chip ${state}`.trim()}>
+      <span className="dm-status-dot" />
+      {raw}
     </span>
   );
 }

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

@@ -2,16 +2,17 @@
 
 export function ToggleField({ checked, disabled, label, onChange, description }) {
   return (
-    <label className="dm-check-row">
+    <label className={`dm-switch-row${disabled ? " is-disabled" : ""}`}>
       <input
         type="checkbox"
         checked={Boolean(checked)}
         disabled={disabled}
         onChange={(event) => onChange(event.target.checked)}
       />
-      <span>
-        {label}
-        {description && <span className="dm-cell-empty" style={{ display: "block", marginTop: 4 }}>{description}</span>}
+      <span className="dm-switch-track" aria-hidden="true" />
+      <span className="dm-switch-label">
+        <span>{label}</span>
+        {description && <span className="dm-switch-desc">{description}</span>}
       </span>
     </label>
   );