@growthub/cli 0.14.5 → 0.14.8

package/README.md

@@ -2,7 +2,7 @@
 
 `@growthub/cli` is the local control plane for Growthub Local and Agent Workspace as Code (AWaC).
 
-It turns repos, skills, starters, kits, and templates into governed **Workspaces** that can be exported, forked, inspected, operated by agents, kept current, and optionally connected to hosted authority. The Workspace is the top-level product object; the CLI is the executor that moves it through the lifecycle.
+It turns repos, skills, starters, and templates into governed **Workspaces** that can be exported, forked, inspected, operated by agents, kept current, and optionally connected to hosted authority. The Workspace is the top-level product object; the CLI is the executor that moves it through the lifecycle.
 
 ## Start here: create a governed Workspace
 
@@ -40,20 +40,19 @@ Growthub Local keeps the Workspace as the owned artifact: a forkable app, `growt
 
 The CLI is the machine-readable path through that architecture:
 
-- **Export** a starter, repo, skill, template, or worker kit into a local Workspace.
+- **Export** a starter, repo, skill, or template into a local Workspace.
 - **Register and inspect forks** so customization carries identity, policy, and trace instead of becoming an untracked copy.
 - **Operate ongoing lifecycle checks** for workspace status, QA, deploy readiness, upstream drift, surface detection, and portal preparation.
 - **Connect optional authority** through Growthub auth, bridge-backed integrations, hosted agents, and capability activation when local value is already clear.
 - **Expose the same contracts to agents and humans** through structured commands, JSON output, skill manifests, helper scripts, and the Workspace Builder.
 
-## Profile-first setup (recommended)
+## Workspace-first setup (recommended)
 
-The guided flow is profile-first before deeper harness/workflow choices:
+The guided flow starts at the governed workspace export path before deeper harness/workflow choices:
 
 ```bash
-npm create @growthub/growthub-local@latest -- --profile gtm
-npm create @growthub/growthub-local@latest -- --profile dx
 npm create @growthub/growthub-local@latest -- --profile workspace --out ./my-workspace
+npm create @growthub/growthub-local@latest -- --profile self-improving --out ./my-workspace
 ```
 
 ## Discovery lanes
@@ -66,7 +65,7 @@ growthub discover
 
 Core lanes:
 
-1. Worker Kits
+1. Workspace Templates
 2. Templates
 3. Workflows
 4. Local Intelligence
@@ -119,19 +118,17 @@ Compatibility examples used by package validation:
 
 ```bash
 growthub kit list
-growthub kit inspect creative-strategist-v1
-growthub kit inspect growthub-open-higgsfield-studio-v1
-growthub kit download creative-strategist-v1
-growthub kit download growthub-open-higgsfield-studio-v1
-growthub kit path creative-strategist-v1
+growthub kit inspect growthub-custom-workspace-starter-v1
+growthub kit download growthub-custom-workspace-starter-v1
+growthub kit path growthub-custom-workspace-starter-v1
 growthub kit validate /absolute/path/to/kit
 ```
 
-### How local adapters use worker kits
+### How local adapters use workspace exports
 
-1. Download or resolve a kit path from the CLI.
+1. Export or resolve a workspace path from the CLI.
 2. Point the agent working directory at the exported folder.
-3. Start a new session so the kit contract loads from `CLAUDE.md`.
+3. Start a new session so the workspace contract loads from `AGENTS.md` / `SKILL.md`.
 
 ### Workflows + pipelines
 
@@ -168,7 +165,7 @@ When ready, activate deeper hosted lanes:
 ## Docs
 
 - [Growthub Local README](https://github.com/Growthub-ai/growthub-local#readme)
-- [Worker Kits](https://github.com/Growthub-ai/growthub-local/blob/main/docs/WORKER_KITS.md)
+- [First-Run Paths](https://github.com/Growthub-ai/growthub-local/blob/main/docs/FIRST_RUN_PATHS.md)
 - [CLI Workflows Discovery](https://github.com/Growthub-ai/growthub-local/blob/main/docs/CLI_WORKFLOWS_DISCOVERY_V1.md)
 - [Agent Harness Auth Primitive](https://github.com/Growthub-ai/growthub-local/blob/main/docs/AGENT_HARNESS_AUTH_PRIMITIVE.md)
 - [Contributing](https://github.com/Growthub-ai/growthub-local/blob/main/CONTRIBUTING.md)

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

@@ -29,14 +29,13 @@ growthub starter init \
 
 After export, set `NANGO_SECRET_KEY` in the workspace runtime, complete provider OAuth, then fill `providerConfigKey`, `connectionIds`, and project identifiers in the Data Model before running the workflow.
 
-## Run the bundled Vite UI shell
+## Run the workspace app
 
 ```bash
-cd studio
+cd apps/workspace
 npm install
-npm run dev          # local dev server
-npm run build        # produces studio/dist
-node serve.mjs       # serves the built shell
+npm run dev          # local workspace builder
+npm run build        # production build
 ```
 
 ## Build out the agent contract
@@ -57,7 +56,7 @@ growthub kit fork trace --fork-id <fork-id> --tail 50
 ```bash
 growthub kit fork policy --fork-id <fork-id> --set \
   autoApprove=additive \
-  untouchablePaths+=studio/src/views/MyFeature.jsx \
+  untouchablePaths+=apps/workspace/app/custom/MyFeature.jsx \
   confirmBeforeChange+=workers/custom-workspace-operator/CLAUDE.md \
   remoteSyncMode=pr
 ```

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

@@ -68,7 +68,7 @@ function safeRuntime(warnings) {
 
 // Mirrors the CLI probe (cli/src/commands/workspace-surface.ts) so detection
 // lives inside the artifact too — the bridge roadmap Item 4 called for.
-const KNOWN_APP_DIRS = ["apps/workspace", "apps/agency-portal", "apps/portal", "studio", "app", "src"];
+const KNOWN_APP_DIRS = ["apps/workspace"];
 
 function detectFramework(absPath) {
   try {

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