growthub-local

Operate the governed-universe MCP tools over a Growthub workspace — describe the workspace, traverse the metadata graph, simulate causal impact and blast radius, check ship-readiness, dry-run a PATCH with preflight_patch, and convert findings into governed next actions. Use whenever you need to answer "what exists, what depends on what, what would break, is it ready, and what governed call should happen next" in a workspace that contains growthub.config.json.

Run the offline causal-intelligence CLI over a governed Growthub workspace — growthub plan (blast radius, stale surfaces, lineage), growthub patch (offline allowlisted edit with impact + compliance, PR-ready), growthub capture (live vs repo drift), growthub readiness (ship verdict across forks). Use for scripted or CI-side impact analysis when you want JSON output instead of MCP tool calls.

Baseline primitive for every Growthub governed workspace. Routing menu for the Custom Workspace Operator — delegates to the operator runbook (`skills.md`), the session-memory template (`templates/project.md`), the self-evaluation contract (`templates/self-eval.md`), the safe-shell helpers layer (`helpers/`), and the parallel sub-skill convention (`skills/`). Invoked when the user starts a greenfield workspace via `growthub starter init`, imports a GitHub repo or skills.sh skill via `growthub starter import-repo`/`import-skill`, or downloads this kit directly via `growthub kit download`.

The two canonical Growthub workspace mutation calls and the verified protocol — PATCH /api/workspace (allowlist dashboards, widgetTypes, canvas, dataModel) and POST /api/workspace/sandbox-run. Read before changing workspace configuration or executing anything in a governed workspace. Mutations are runtime-enforced; this card keeps you on the sanctioned lanes.

Draft dashboards, widgets, API registry rows, custom business objects, and swarm graphs for a governed Growthub workspace via the workspace helper — a propose-only planning engine whose output is applied through an explicit governed apply step. Use when asked to build a dashboard, create a custom object, register an API, scaffold a widget, repair broken references, or explain a workspace object.

Sign in, confirm identity, and sign out of hosted Growthub via `growthub auth login` / `whoami` / `logout`. Use when the user needs to authenticate before Workflows / Saved Workflows / Pipeline execution, verify the active session, script auth with a pre-issued token, or opt out of telemetry.

Derive what a workspace change would actually affect BEFORE proposing it — blast radius, downstream dependencies, lineage, stale surfaces, workflow impact, app readiness, and patch impact — using the workspace metadata graph and the pure derivers. Use when asked "what breaks if I change this", before any PATCH/publish/remove, when triaging a broken widget or workflow, or when assessing whether an app surface is ship-ready.

Operate a governed Growthub workspace as an agent through the canonical loop — read state → reason with causal tools → dry-run preflight → governed hand-off through a sanctioned route → re-read. Use for ANY workspace-config change, sandbox/swarm execution, workflow publish, or helper apply inside a governed workspace or exported fork. This skill is how mutations happen; it never invents a third mutation path.

Start every governed-workspace session from the agent-outcome receipt ledger and self-correct from structured rejections. Use at the start of any session in a governed workspace or exported fork, after any 400/422/ AppScope rejection, when resuming interrupted work, or when auditing what agents actually did (blocked attempts, publishes, drafts awaiting proof). Receipts are the workspace's memory — read them before acting.

Convert any private-repo workspace variant (a customized growthub.config.json) into a clean, non-secret, production-ready seeded workspace template registered on the canonical Discover CLI pathway — export + sanitize with a verification gate, register the seed + WORKSPACE_TEMPLATES entry (src AND committed dist), mirror the seed contract tests, and prove it with the real starter-init smoke, a boot, and a browser readback. Use when the user asks to turn a workspace variant/config into a template, export a seeded config from a private repo, add a workspace template to kit list/discover, or QA a template export end to end (e.g. the gtm-os and project-management templates).

Ship a new official workspace marketplace provider (plugin) + install products at Supabase/Vercel parity: source-truth recon of the existing provider grammar, one-place provider definition, governed api-registry rows, /settings/apps icon derivation, circular badge icons, unit + source-truth tests, and the mandatory real-browser closed-loop QA with screenshot proof on a booted export. Use when the user asks to add or integrate a marketplace provider/plugin (Neon, Planetscale, Stripe, any SaaS), add install products, wire provider icons, or QA a provider end-to-end as a real user.

The two canonical workspace API calls and the verified mutation protocol — PATCH /api/workspace (4-field allowlist) and POST /api/workspace/sandbox-run (sandbox execution). Read this before changing workspace configuration or executing anything, in any agent harness. Every shape and error below was verified against the live workspace runtime, not inferred from docs.

Investigate the real architecture of a repository before proposing changes — map runtime topology, contracts, invariants, and extension points, then produce an additive, phased implementation plan grounded in source files rather than assumptions. Use when the user asks to analyze an OSS repo or SDK, plan an adapter/provider/integration extension, audit a workflow or agentic runtime, review a PR against architecture truth, or draft an implementation module for a monorepo.

Router to the runtime-verified contract card for the two canonical governed-workspace API calls — PATCH /api/workspace (config mutation, 4-field allowlist) and POST /api/workspace/sandbox-run (sandbox execution). Read before any agent makes a workspace-configuration mutation, in any harness.

Draft dashboards, widget layouts, API registry rows, and custom business objects via the workspace helper endpoint. Returns governed proposals for explicit human review and apply. Use when the user asks to build a dashboard, create a custom object, register an API, scaffold a widget, repair broken references, or explain what a workspace object does.

Use the public CMS SDK v1 contract (`@growthub/api-contract`) to type workflow payloads, parse NDJSON execution events, read capability manifests, and validate node schemas. Use when the user asks about the api-contract package, CMS SDK, ExecutionEvent streams, CapabilityManifestEnvelope, NodeInputSchema, or types for hosted execution.