@growthub/create-growthub-local 0.1.45

package/README.md

@@ -0,0 +1,79 @@
+# create-growthub-local
+
+Install and run a local Growthub instance — GTM or DX surface — in one command.
+
+## Usage
+
+**Go-to-Market surface:**
+
+```bash
+npm create growthub-local@latest -- --profile gtm
+```
+
+**DX (Developer Experience) surface:**
+
+```bash
+npm create growthub-local@latest -- --profile dx
+```
+
+Both commands install the local runtime into a `growthub-local/` folder in your current directory, onboard a fresh instance, and start the server.
+
+## Options
+
+| Flag | Description |
+|---|---|
+| `--profile gtm\|dx` | Required. Selects the surface to install. |
+| `--run` | Start the server immediately after install. |
+| `--data-dir <path>` | Custom directory for instance data (default: `./growthub-local`). |
+| `--config <path>` | Path to a custom config file. |
+
+## What happens
+
+1. Installs `@growthub/cli` and provisions a local instance
+2. Starts an embedded PostgreSQL database on an auto-selected port
+3. Serves the local UI at `http://localhost:3100` (GTM) or `http://localhost:3101` (DX)
+4. Opens the Growthub Connection card — complete auth to bridge to hosted Growthub
+
+For GTM installs, browser-agent execution is issue-bound through heartbeat. Concurrent browser agents can run on distinct runtime browser slots when launched from real assigned issues.
+
+## Starting again after install
+
+```bash
+cd growthub-local
+npx growthub start
+```
+
+## Upgrading
+
+```bash
+cd growthub-local
+npx growthub upgrade
+```
+
+Upgrades the CLI and server in place. Runs any pending migrations. No data loss.
+
+## Running two surfaces
+
+Each surface needs its own directory:
+
+```bash
+mkdir gtm-fresh && cd gtm-fresh
+npm create growthub-local@latest -- --profile gtm --run
+
+mkdir dx-fresh && cd dx-fresh
+npm create growthub-local@latest -- --profile dx --run
+```
+
+Each instance gets an isolated database and port. They share no state.
+
+## Requirements
+
+- Node.js 20 or later
+- npm 7 or later (for `npm create`)
+
+## Links
+
+- [GitHub](https://github.com/antonioromero1220/growthub-local)
+- [Contributing](https://github.com/antonioromero1220/growthub-local/blob/main/CONTRIBUTING.md)
+- [Frozen browser isolation snapshot](https://github.com/antonioromero1220/growthub-local/blob/main/docs/FROZEN_GTM_BROWSER_AGENT_ISOLATION_STATE.md)
+- [Issues](https://github.com/antonioromero1220/growthub-local/issues)

package/bin/create-growthub-local.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+
+const require = createRequire(import.meta.url);
+
+function printUsage() {
+  console.log("Usage: create-growthub-local --profile <dx|gtm> [--run] [--data-dir <path>] [--config <path>]");
+}
+
+function parseArgs(argv) {
+  let profile = null;
+  let run = false;
+  let dataDir = null;
+  let config = null;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === "--profile" && argv[index + 1]) {
+      profile = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (value === "--run") {
+      run = true;
+      continue;
+    }
+    if ((value === "-d" || value === "--data-dir") && argv[index + 1]) {
+      dataDir = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if ((value === "-c" || value === "--config") && argv[index + 1]) {
+      config = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (value === "-h" || value === "--help") {
+      printUsage();
+      process.exit(0);
+    }
+  }
+
+  if (profile !== "dx" && profile !== "gtm") {
+    printUsage();
+    console.error("create-growthub-local requires --profile dx or --profile gtm");
+    process.exit(1);
+  }
+
+  return { profile, run, dataDir, config };
+}
+
+function resolveGrowthubCliEntrypoint() {
+  const cliPackageJsonPath = require.resolve("@growthub/cli/package.json");
+  const cliPackageDir = path.dirname(cliPackageJsonPath);
+  const cliPackage = require(cliPackageJsonPath);
+  const growthubBin = cliPackage?.bin?.growthub;
+
+  if (typeof growthubBin !== "string" || growthubBin.trim().length === 0) {
+    throw new Error("Installed @growthub/cli package does not expose a growthub binary");
+  }
+
+  return path.resolve(cliPackageDir, growthubBin);
+}
+
+const { profile, run, dataDir, config } = parseArgs(process.argv.slice(2));
+const effectiveDataDir = dataDir ? path.resolve(process.cwd(), dataDir) : path.resolve(process.cwd(), "growthub-local");
+let growthubCli;
+
+try {
+  growthubCli = resolveGrowthubCliEntrypoint();
+} catch (error) {
+  console.error(
+    error instanceof Error
+      ? `create-growthub-local could not resolve the Growthub CLI: ${error.message}`
+      : "create-growthub-local could not resolve the Growthub CLI",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(
+  process.execPath,
+  [
+    growthubCli,
+    "onboard",
+    "--yes",
+    ...(run ? ["--run"] : []),
+    "--data-dir",
+    effectiveDataDir,
+    ...(config ? ["--config", config] : []),
+  ],
+  {
+    cwd: process.cwd(),
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      PAPERCLIP_SURFACE_PROFILE: profile,
+    },
+  },
+);
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@growthub/create-growthub-local",
+  "version": "0.1.45",
+  "description": "Growthub local installer for DX and GTM profiles",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Growthub-ai/growthub-local",
+    "directory": "packages/create-growthub-local"
+  },
+  "homepage": "https://github.com/Growthub-ai/growthub-local#readme",
+  "bugs": {
+    "url": "https://github.com/Growthub-ai/growthub-local/issues"
+  },
+  "bin": {
+    "create-growthub-local": "./bin/create-growthub-local.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@growthub/cli": "0.3.42"
+  },
+  "keywords": [
+    "growthub",
+    "paperclip",
+    "local",
+    "gtm",
+    "dx",
+    "ai-agents",
+    "agent-orchestration",
+    "local-dev"
+  ],
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "pack:dry-run": "npm pack --dry-run"
+  }
+}