@growthub/cli 0.14.4 → 0.14.6

package/assets/worker-kits/growthub-ai-website-cloner-v1/examples/platform-handoff-sample.md

@@ -1,102 +0,0 @@
-# Platform Handoff — Sample
-
-**Project:** Acme Corp Homepage Clone  
-**Client:** Acme Corp  
-**Date:** 2026-04-15  
-**Clone source:** `https://acme.example.com`  
-**Codebase location:** `~/ai-website-cloner-template`
-
----
-
-## What was built
-
-A pixel-perfect clone of the Acme Corp homepage, rebuilt in Next.js 16 + shadcn/ui + Tailwind CSS v4. The clone includes all 7 sections of the original page (navigation, hero, features, testimonials, CTA banner, FAQ, footer) with all assets downloaded and all interactive states matched. The only deviation is the proprietary "Acme Sans" font, replaced with Inter (documented below).
-
----
-
-## Running the clone locally
-
-```bash
-cd ~/ai-website-cloner-template
-npm run dev
-```
-
-Open [http://localhost:3000](http://localhost:3000).
-
----
-
-## Building for production
-
-```bash
-cd ~/ai-website-cloner-template
-npm run build
-npm run start
-```
-
-Expected build output: ~45 static pages + 1 dynamic route.
-
----
-
-## Deploying to Vercel
-
-```bash
-npm install -g vercel
-cd ~/ai-website-cloner-template
-vercel --prod
-```
-
-The app will be live at `https://ai-website-cloner-template.vercel.app` until you configure a custom domain.
-
----
-
-## Project structure
-
-```
-src/
-  app/
-    page.tsx                    # Main homepage
-    layout.tsx                  # Root layout with Inter font
-    globals.css                 # Full design token set (24 colors)
-  components/
-    navigation/Navigation.tsx
-    hero-section/HeroSection.tsx
-    features-grid/FeaturesGrid.tsx
-    testimonials/Testimonials.tsx
-    cta-banner/CtaBanner.tsx
-    faq/Faq.tsx
-    footer/Footer.tsx
-    icons.tsx                   # 18 extracted SVG icons
-public/
-  images/                       # 11 downloaded images
-  videos/
-    hero-bg.mp4                 # Hero background video
-  seo/
-    favicon.ico
-    og-image.png
-```
-
----
-
-## Known deviations from original
-
-| Section | Type | Notes |
-|---|---|---|
-| All headings | Font | "Acme Sans" is a proprietary font not available via CDN. Replaced with Inter (weight 700). Visual difference is subtle — baseline spacing may differ by ~2px on some headings. |
-
----
-
-## Customization next steps
-
-1. [ ] Replace `public/seo/og-image.png` with the client's actual OG image
-2. [ ] Update `src/app/layout.tsx` metadata: title, description, canonical URL
-3. [ ] Configure Vercel environment variables for any future dynamic features
-4. [ ] If "Acme Sans" is obtained via license, add it to `src/app/layout.tsx` and update `globals.css`
-5. [ ] Remove `public/videos/hero-bg.mp4` and replace with a client-owned video file before redistribution
-
----
-
-## QA result
-
-See `qa/visual-qa-checklist.md` for the full QA report.
-
-**Overall result:** PASS WITH NOTED DEVIATIONS (font only)

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

@@ -1,119 +0,0 @@
-# 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

@@ -1,71 +0,0 @@
-# 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

@@ -1,47 +0,0 @@
-# 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/helpers/README.md

@@ -1,29 +0,0 @@
-# `helpers/` — safe shell tool layer (primitive #6)
-
-A **helper** is a small, deterministic script an agent invokes via one shell call instead of reconstructing a raw pipeline inline. Helpers are reviewable, deterministic, and safer than raw commands.
-
-## Convention
-
-```
-helpers/
-├── README.md                 # this file
-├── <verb>.sh                 # single-purpose shell scripts
-├── <verb>.mjs                # optional: Node-based helper
-└── <verb>.py                 # optional: Python-based helper
-```
-
-Every helper:
-
-1. Carries a one-line header comment: what it does + how to invoke it.
-2. Uses `set -euo pipefail` (or equivalent) — no silent failures.
-3. Has a matching row in the parent `SKILL.md`'s `helpers[]` frontmatter.
-4. Is referenced from `skills.md` at the step the agent should invoke it (no duplicated shell bodies).
-
-## When to promote an inline snippet
-
-- Appears more than once in `skills.md`.
-- Has fragile quoting or path interpolation.
-- Calls a side-effecting binary (ffmpeg, git, gh, npm install).
-- Multiple sub-skills invoke it.
-
-See the parent `SKILL.md` `helpers[]` array for the current roster.

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

@@ -1,120 +0,0 @@
-{
-  "schemaVersion": 2,
-  "kit": {
-    "id": "growthub-ai-website-cloner-v1",
-    "version": "1.0.0",
-    "name": "Growthub Agent Worker Kit \u2014 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 \u2014 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",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.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",
-      "SKILL.md",
-      "templates/project.md",
-      "templates/self-eval.md",
-      "helpers",
-      "helpers/README.md",
-      "skills",
-      "skills/README.md"
-    ]
-  },
-  "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"
-  },
-  "workspaceVisibility": "addon",
-  "workspaceCompatible": false,
-  "workspaceCategory": "studio"
-}

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

@@ -1,26 +0,0 @@
-# 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

@@ -1,75 +0,0 @@
-# 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

@@ -1,70 +0,0 @@
-# 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 | `$HOME/ai-website-cloner-template` | `AI_WEBSITE_CLONER_HOME` (legacy: `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.