@growthub/cli 0.3.54 → 0.3.56

package/assets/worker-kits/growthub-ai-website-cloner-v1/examples/visual-qa-sample.md

@@ -0,0 +1,119 @@
+# Visual QA Checklist — Sample
+
+**Project:** Acme Corp Homepage Clone  
+**Clone URL:** `http://localhost:3000`  
+**Original URL:** `https://acme.example.com`  
+**Date:** 2026-04-15  
+**QA reviewer:** `ai-website-cloner-operator`
+
+---
+
+## Build checks
+
+- [x] `npm run build` exits 0
+- [x] `npm run lint` exits 0
+- [x] `npm run typecheck` exits 0
+- [x] Dev server starts without errors: `npm run dev`
+- [x] No 404s in browser console for assets
+
+---
+
+## Layout QA — Desktop (1440px)
+
+| Section | Status | Notes |
+|---|---|---|
+| Navigation | Pass | Sticky behavior matches; dropdowns exact |
+| Hero | Pass | Video loops, overlays correct, headlines match |
+| Features grid | Pass | 3-column layout, spacing matches |
+| Testimonials | Pass | Carousel transitions match |
+| CTA Banner | Pass | High-contrast colors exact |
+| FAQ accordion | Pass | Open/close transitions match |
+| Footer | Pass | 4-column layout, links correct |
+
+---
+
+## Layout QA — Tablet (768px)
+
+| Section | Status | Notes |
+|---|---|---|
+| Navigation | Pass | Hamburger appears, menu overlay works |
+| Hero | Pass | 56px headline, CTAs stack correctly |
+| Features grid | Pass | 2-column at tablet |
+| Testimonials | Pass | Single column at tablet |
+| CTA Banner | Pass | — |
+| FAQ accordion | Pass | — |
+| Footer | Pass | 2-column at tablet |
+
+---
+
+## Layout QA — Mobile (375px)
+
+| Section | Status | Notes |
+|---|---|---|
+| Navigation | Pass | Hamburger, overlay, full-screen nav match |
+| Hero | Pass | 40px headline, full-width CTAs |
+| Features grid | Pass | 1-column at mobile |
+| Testimonials | Pass | Swipe gesture works |
+| CTA Banner | Pass | — |
+| FAQ accordion | Pass | Touch targets 44px minimum |
+| Footer | Pass | Single column, stacked |
+
+---
+
+## Color fidelity
+
+| Token | Expected | Actual | Pass |
+|---|---|---|---|
+| Background | `#0a0a0a` | `oklch(7% 0 0)` | Pass |
+| Text primary | `#ffffff` | `oklch(100% 0 0)` | Pass |
+| Accent | `#3b82f6` | `oklch(59% 0.2 260)` | Pass |
+| Border | `rgba(255,255,255,0.1)` | Match | Pass |
+
+---
+
+## Typography fidelity
+
+| Element | Expected font | Actual | Expected size | Actual | Pass |
+|---|---|---|---|---|---|
+| H1 | Inter | Inter (system fallback) | 72px | 72px | Pass |
+| Body | Inter | Inter (system fallback) | 20px | 20px | Pass |
+
+---
+
+## Asset completeness
+
+- [x] All images loading (no broken images)
+- [x] Hero background video loading and looping
+- [x] All SVG icons rendering
+- [x] Fonts loading (Inter via Next.js font optimization)
+
+---
+
+## Interaction states
+
+| Element | State | Expected | Actual | Pass |
+|---|---|---|---|---|
+| CTA primary | Hover | Dims slightly | Dims `oklch(91%)` | Pass |
+| CTA secondary | Hover | Border brightens | Border `opacity 0.6` | Pass |
+| Navigation | Hover | Underline appears | Underline `2px` | Pass |
+| Mobile nav | Tap | Overlay opens | Full-screen overlay | Pass |
+| FAQ items | Click | Accordion expands | Smooth height transition | Pass |
+
+---
+
+## Deviations
+
+| Section | Type | Reason | Resolution |
+|---|---|---|---|
+| All headings | Font | "Acme Sans" not publicly available | Replaced with Inter; noted in handoff |
+
+---
+
+## Final QA result
+
+- [ ] PASS
+- [x] PASS WITH NOTED DEVIATIONS — see Deviations table above
+- [ ] FAIL
+
+**Reviewer notes:**  
+The only deviation is the proprietary font. All layout, color, interaction, and asset checks pass. Client has been informed that the font replacement is the only visual difference.

package/assets/worker-kits/growthub-ai-website-cloner-v1/growthub-meta/README.md

@@ -0,0 +1,71 @@
+# Growthub Agent Worker Kit — AI Website Cloner v1
+
+**Kit ID:** `growthub-ai-website-cloner-v1`  
+**Version:** `1.0.0`  
+**Type:** `worker`  
+**Execution mode:** `export`
+
+---
+
+## What this kit does
+
+This kit gives an agent a self-contained environment for cloning any website into a modern Next.js codebase using AI coding agents backed by the `ai-website-cloner-template` fork.
+
+It packages:
+- agent operating instructions
+- a locked 8-phase clone pipeline methodology
+- fork setup scripts and verification tools
+- component spec templates with exact CSS extraction methodology
+- parallel builder dispatch system documentation
+- design token extraction workflow
+- visual QA standards
+- output standards
+- examples and contributor metadata
+
+The intended operator is an AI coding agent orchestrator working against the `ai-website-cloner-template` fork to produce pixel-perfect website clones for platform migration, design reference, or modernization projects.
+
+---
+
+## Folder structure
+
+```text
+growthub-ai-website-cloner-v1/
+├── kit.json
+├── bundles/
+├── workers/
+├── brands/
+├── templates/
+├── examples/
+├── docs/
+├── growthub-meta/
+├── setup/
+├── output/
+├── skills.md
+├── output-standards.md
+├── runtime-assumptions.md
+└── validation-checklist.md
+```
+
+---
+
+## Activation
+
+1. Export the kit via `growthub kit download growthub-ai-website-cloner-v1`
+2. Run `bash setup/clone-fork.sh` to set up the upstream fork
+3. Point the agent working directory at the expanded kit folder
+4. The agent reads `workers/ai-website-cloner-operator/CLAUDE.md`
+5. `skills.md` provides the working method for every session
+6. Run `/clone-website <target-url>` in your AI agent chat
+
+---
+
+## Supported output categories
+
+- clone brief
+- reconnaissance report
+- design token extraction sheet
+- component specs (one per section)
+- asset manifest
+- builder dispatch plan
+- visual QA checklist
+- platform handoff document

package/assets/worker-kits/growthub-ai-website-cloner-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,47 @@
+# Kit Standard — AI Website Cloner v1
+
+This document defines the locked contract for this kit.
+
+---
+
+## Required files contract
+
+Every path in `kit.json -> frozenAssetPaths` must exist in every valid release.
+
+---
+
+## Bundle contract
+
+The bundle manifest must remain aligned with `kit.json`:
+- `bundle.kitId` matches `kit.id`
+- `bundle.workerId` matches `entrypoint.workerId`
+- `requiredFrozenAssets` stays a subset of `frozenAssetPaths`
+
+---
+
+## Agent operating rules
+
+The entrypoint file is the operating law. `skills.md` is the methodology.
+
+Required invariants:
+- strict 8-phase workflow order (no phase may be skipped)
+- reconnaissance before any spec writing (no memory-only specs)
+- one builder per section in its own worktree
+- visual QA required before platform handoff
+- ethical use check before initiating any clone
+
+---
+
+## Runtime rules
+
+- no API keys or credentials stored in kit files
+- the fork path defaults to `~/ai-website-cloner-template` but is overridable via `AI_CLONER_FORK_PATH`
+- all AI work is done by the local agent — no external service calls from this kit
+- outputs are Markdown files except component code (produced in the fork repo, not in this kit directory)
+- brand assets and cloned site assets must not be committed to this kit
+
+---
+
+## Versioning rules
+
+Additive template/docs changes are minor-version work. Entry-point path changes, fork URL changes, or export-name changes require a major version bump. The CLI compatibility minimum version in `kit.json` must be updated on every published kit version bump.

package/assets/worker-kits/growthub-ai-website-cloner-v1/kit.json

@@ -0,0 +1,105 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-ai-website-cloner-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — AI Website Cloner",
+    "description": "Self-contained local workspace for cloning any website into a clean Next.js 16 + shadcn/ui + Tailwind CSS v4 codebase using AI coding agents. Produces pixel-perfect component clones from a target URL via multi-phase reconnaissance, spec writing, parallel builder dispatch, and visual QA — all driven by the ai-website-cloner-template fork.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "ai-website-cloner-operator",
+    "path": "workers/ai-website-cloner-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "ai-website-cloner-operator"
+  ],
+  "agentContractPath": "workers/ai-website-cloner-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/ai-website-cloner-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/clone-fork.sh",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/clone-brief.md",
+    "templates/reconnaissance-report.md",
+    "templates/component-spec.md",
+    "templates/builder-dispatch-plan.md",
+    "templates/asset-manifest.md",
+    "templates/visual-qa-checklist.md",
+    "templates/platform-handoff.md",
+    "templates/design-token-extraction.md",
+    "examples/clone-brief-sample.md",
+    "examples/component-spec-sample.md",
+    "examples/visual-qa-sample.md",
+    "examples/platform-handoff-sample.md",
+    "docs/ai-website-cloner-fork-integration.md",
+    "docs/multi-phase-pipeline.md",
+    "docs/parallel-builder-dispatch.md",
+    "docs/design-token-system.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "envExample": ".env.example",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is intended to be pointed at directly by the agent Working Directory. All outputs are Markdown files written to output/<client-slug>/<project-slug>/.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      ".env.example",
+      "kit.json",
+      "bundles/growthub-ai-website-cloner-v1.json",
+      "skills.md",
+      "workers/ai-website-cloner-operator/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/growthub/brand-kit.md",
+      "brands/NEW-CLIENT.md",
+      "setup/clone-fork.sh",
+      "setup/verify-env.mjs",
+      "setup/check-deps.sh",
+      "output/README.md",
+      "templates",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-ai-website-cloner-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-ai-website-cloner-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.3.54"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-15T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-ai-website-cloner-v1/output/README.md

@@ -0,0 +1,26 @@
+# Output Directory
+
+This directory holds all work products from the AI Website Cloner operator.
+
+## Structure
+
+```
+output/
+  <client-slug>/
+    <project-slug>/
+      research/
+        reconnaissance-report.md   # Screenshots documented, design tokens noted
+        design-token-extraction.md  # Complete token set with oklch conversions
+        asset-inventory.md          # All external assets collected
+      specs/
+        <section-slug>.md           # One file per cloned section (exact CSS values)
+      qa/
+        visual-qa-checklist.md      # QA results vs. original screenshots
+      platform-handoff.md           # Deployment-ready instructions
+```
+
+## Notes
+
+- Never commit client brand assets or proprietary content to this repository.
+- All files in `output/` are generated work products, not source-controlled code.
+- Add `output/<client-slug>/` to `.gitignore` for client-confidential projects.

package/assets/worker-kits/growthub-ai-website-cloner-v1/output-standards.md

@@ -0,0 +1,75 @@
+# Output Standards — AI Website Cloner
+
+**Kit:** `growthub-ai-website-cloner-v1`
+
+---
+
+## Output directory structure
+
+All work products are stored inside the `ai-website-cloner-template` fork repository:
+
+```
+~/ai-website-cloner-template/
+  output/
+    <client-slug>/
+      <project-slug>/
+        research/
+          reconnaissance-report.md
+          design-token-extraction.md
+          asset-inventory.md
+        specs/
+          <section-slug>.md       (one per identified section)
+        qa/
+          visual-qa-checklist.md
+        platform-handoff.md
+```
+
+---
+
+## Naming conventions
+
+| Artifact | Naming pattern |
+|---|---|
+| Client slug | lowercase-kebab-case, e.g. `acme-corp` |
+| Project slug | lowercase-kebab-case, e.g. `homepage-clone` |
+| Section slug | lowercase-kebab-case matching section name, e.g. `hero-section` |
+| Component files | PascalCase under `src/components/<section-slug>/`, e.g. `HeroSection.tsx` |
+
+---
+
+## Required deliverables per project
+
+Every completed clone project must have:
+
+1. `reconnaissance-report.md` — screenshots documented, tokens noted
+2. `design-token-extraction.md` — complete token set with oklch conversions
+3. One `specs/<section-slug>.md` per section cloned
+4. `asset-inventory.md` — all external assets downloaded to `public/`
+5. `qa/visual-qa-checklist.md` — completed with pass/deviation notes
+6. `platform-handoff.md` — deployment-ready instructions
+
+---
+
+## Quality gates
+
+Before producing the platform handoff, the following must pass:
+
+- `npm run build` — TypeScript compilation and Next.js build succeeds
+- `npm run lint` — ESLint passes with no errors
+- `npm run typecheck` — TypeScript strict mode passes
+- Visual diff — all sections visually reviewed against original screenshots
+
+---
+
+## Deviation logging
+
+If a section cannot be cloned exactly (auth-gated content, missing assets, proprietary fonts), log the deviation in `visual-qa-checklist.md` under the "Deviations" section:
+
+```markdown
+## Deviations
+
+| Section | Type | Reason | Resolution |
+|---|---|---|---|
+| hero-section | Font | Proprietary font not available | Replaced with closest system font; documented |
+| pricing-table | Auth | Pricing content behind login | Placeholder content with noted limitation |
+```

package/assets/worker-kits/growthub-ai-website-cloner-v1/runtime-assumptions.md

@@ -0,0 +1,70 @@
+# Runtime Assumptions — AI Website Cloner
+
+**Kit:** `growthub-ai-website-cloner-v1`
+
+---
+
+## Fork assumptions
+
+This kit assumes the `ai-website-cloner-template` fork is checked out and installed:
+
+| Assumption | Default | Override |
+|---|---|---|
+| Fork directory | `~/ai-website-cloner-template` | `AI_CLONER_FORK_PATH` env var |
+| Fork repo URL | `https://github.com/JCodesMore/ai-website-cloner-template` | n/a |
+| Node.js version | 24+ (strict) | n/a — minimum requirement |
+| Package manager | npm | n/a |
+| Dev server port | 3000 | Configurable via Next.js CLI |
+
+---
+
+## Tech stack (locked by fork)
+
+The fork uses a locked stack. Do not deviate inside the clone output:
+
+| Layer | Version |
+|---|---|
+| Next.js | 16 (App Router, React 19) |
+| TypeScript | strict mode |
+| shadcn/ui | Latest at fork commit |
+| Tailwind CSS | v4 |
+| Design tokens | oklch color space |
+| Icons | Lucide React (default) + extracted SVGs |
+
+---
+
+## Agent assumptions
+
+- The AI coding agent is running in the fork's root directory
+- The agent can access the internet for screenshots and asset downloads
+- The agent can spawn parallel subagents / worktrees for builder dispatch
+- Claude Code with `--chrome` flag is the recommended setup (enables browser automation)
+
+---
+
+## What the fork's `/clone-website` skill does
+
+The skill is defined in `.claude/skills/clone-website/SKILL.md` (and synced to other agents).
+When invoked by the operator, it:
+
+1. Opens Chrome DevTools (via `--chrome` flag for Claude Code, or Playwright for other agents)
+2. Navigates to the target URL
+3. Captures screenshots at all viewports
+4. Extracts design tokens via `getComputedStyle()` console calls
+5. Downloads all external assets to `public/`
+6. Writes component specs to `docs/research/components/`
+7. Dispatches builder subagents in git worktrees
+8. Merges and assembles the page
+9. Runs visual QA
+
+---
+
+## Ethical use constraints
+
+This kit must not be used to:
+- Create phishing pages or impersonation sites
+- Clone sites with explicit prohibitions on reproduction in their Terms of Service
+- Redistribute proprietary brand assets or copy
+- Pass off cloned designs as original work
+
+These constraints are enforced by operator instruction, not technical controls. The operator must verify site terms before initiating a clone.

package/assets/worker-kits/growthub-ai-website-cloner-v1/setup/check-deps.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# check-deps.sh — Verify all dependencies for the AI Website Cloner
+set -e
+
+echo "=== AI Website Cloner — Dependency Check ==="
+echo ""
+
+OK=0
+
+check_cmd() {
+  local cmd="$1"
+  local label="$2"
+  local hint="$3"
+  if command -v "$cmd" &>/dev/null; then
+    echo "  OK   $label ($cmd: $(command -v "$cmd"))"
+  else
+    echo "  MISS $label — $hint"
+    OK=1
+  fi
+}
+
+check_version() {
+  local cmd="$1"
+  local label="$2"
+  local min_major="$3"
+  local hint="$4"
+  if command -v "$cmd" &>/dev/null; then
+    local version
+    version=$("$cmd" --version 2>&1 | head -1)
+    echo "  OK   $label ($version)"
+  else
+    echo "  MISS $label (required: $min_major+) — $hint"
+    OK=1
+  fi
+}
+
+check_version "node" "Node.js 24+" "24" "https://nodejs.org/"
+check_cmd "npm" "npm" "Included with Node.js"
+check_cmd "git" "git" "https://git-scm.com/"
+
+echo ""
+echo "Optional — recommended for Chrome/screenshot automation:"
+check_cmd "claude" "Claude Code" "npm install -g @anthropic-ai/claude-code"
+
+echo ""
+if [ "$OK" -eq 0 ]; then
+  echo "All required dependencies are present."
+else
+  echo "Some dependencies are missing. Install them before running the fork setup."
+fi

package/assets/worker-kits/growthub-ai-website-cloner-v1/setup/clone-fork.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# clone-fork.sh — Clone and boot the ai-website-cloner-template fork
+# Run from any location. Installs to ~/ai-website-cloner-template (or AI_CLONER_FORK_PATH).
+set -e
+
+FORK_DIR="${AI_CLONER_FORK_PATH:-$HOME/ai-website-cloner-template}"
+REPO_URL="https://github.com/JCodesMore/ai-website-cloner-template.git"
+
+echo "=== Growthub AI Website Cloner — Fork Setup ==="
+echo ""
+
+if [ -d "$FORK_DIR" ]; then
+  echo "Fork already exists at $FORK_DIR — skipping clone."
+  echo "To re-clone, remove the directory first: rm -rf $FORK_DIR"
+else
+  echo "Cloning ai-website-cloner-template → $FORK_DIR"
+  git clone "$REPO_URL" "$FORK_DIR"
+  echo "Clone complete."
+fi
+
+echo ""
+echo "Installing dependencies..."
+cd "$FORK_DIR"
+npm install
+echo "Dependencies installed."
+
+echo ""
+echo "Checking Node.js version..."
+NODE_VERSION=$(node --version | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 24 ]; then
+  echo "WARNING: Node.js $NODE_VERSION detected. Node.js 24+ is required."
+  echo "Visit https://nodejs.org/ to upgrade, or use nvm: nvm use 24"
+else
+  echo "Node.js $(node --version) — OK"
+fi
+
+echo ""
+echo "Verifying fork structure..."
+STRUCTURE_OK=0
+for item in src/app src/components src/lib package.json next.config.ts; do
+  if [ -e "$FORK_DIR/$item" ]; then
+    echo "  OK   $item"
+  else
+    echo "  MISS $item"
+    STRUCTURE_OK=1
+  fi
+done
+
+echo ""
+if [ "$STRUCTURE_OK" -eq 0 ]; then
+  echo "Fork is ready at $FORK_DIR"
+  echo ""
+  echo "Next steps:"
+  echo "  1. Point your AI agent at the Growthub kit directory (this folder)"
+  echo "  2. Start Claude Code with: claude --chrome"
+  echo "  3. Run the clone skill: /clone-website <target-url>"
+  echo ""
+  echo "Dev server (after cloning a site):"
+  echo "  cd $FORK_DIR && npm run dev"
+else
+  echo "Fork cloned at $FORK_DIR — some expected files may differ in this version."
+  echo "Check the fork's README for the current structure."
+fi
+
+echo ""
+echo "Fork location: $FORK_DIR"