@growthub/cli 0.3.54 → 0.3.55

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/asset-manifest.md

@@ -0,0 +1,57 @@
+# Asset Manifest
+
+**Project:** [PROJECT NAME]  
+**Target URL:** [https://example.com]  
+**Date:** YYYY-MM-DD
+
+---
+
+## Images
+
+| File | Public path | Source URL | Section used | Notes |
+|---|---|---|---|---|
+| [filename.ext] | `public/images/[filename.ext]` | [CDN URL] | [section-slug] | — |
+
+---
+
+## Videos
+
+| File | Public path | Source URL | Section used | Notes |
+|---|---|---|---|---|
+| [filename.ext] | `public/videos/[filename.ext]` | [CDN URL] | [section-slug] | — |
+
+---
+
+## SVG icons
+
+| Icon name | Component name | Source | Section used | Notes |
+|---|---|---|---|---|
+| [icon name] | `[IconName]` in `src/components/icons.tsx` | [inline / file URL] | [sections] | — |
+
+---
+
+## Custom fonts
+
+| Font family | Weights | Source | How used |
+|---|---|---|---|
+| [Font Name] | [400, 700] | [CDN URL / system] | [heading, body] |
+
+---
+
+## SEO assets
+
+| File | Public path | Notes |
+|---|---|---|
+| favicon.ico | `public/seo/favicon.ico` | — |
+| og-image.png | `public/seo/og-image.png` | — |
+| site.webmanifest | `public/seo/site.webmanifest` | — |
+
+---
+
+## Download status
+
+- [ ] All images downloaded to `public/images/`
+- [ ] All videos downloaded to `public/videos/`
+- [ ] All SEO assets downloaded to `public/seo/`
+- [ ] All SVG icons extracted and added to `src/components/icons.tsx`
+- [ ] Custom fonts added to `src/app/layout.tsx` or `globals.css`

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/builder-dispatch-plan.md

@@ -0,0 +1,92 @@
+# Builder Dispatch Plan
+
+**Project:** [PROJECT NAME]  
+**Date:** YYYY-MM-DD  
+**Total builders:** [N]
+
+---
+
+## Dispatch rules
+
+1. Each builder works in `git worktree` on branch `build/<section-slug>`
+2. Each builder receives: section spec + design token extraction + asset manifest
+3. Builders output ONLY to `src/components/<section-slug>/`
+4. No builder touches: `src/app/`, `src/lib/`, `src/types/`, `globals.css`, `layout.tsx`
+5. Orchestrator assembles the page and resolves merge conflicts
+
+---
+
+## Builder assignments
+
+| Builder | Branch | Section | Spec file | Est. complexity |
+|---|---|---|---|---|
+| 1 | `build/navigation` | Navigation | `specs/navigation.md` | [low/med/high] |
+| 2 | `build/hero-section` | Hero | `specs/hero-section.md` | [low/med/high] |
+| 3 | `build/[slug]` | [Section] | `specs/[slug].md` | [low/med/high] |
+| N | `build/footer` | Footer | `specs/footer.md` | [low/med/high] |
+
+---
+
+## Shared context for all builders
+
+All builders receive the following files inline:
+- `templates/design-token-extraction.md` (full token set)
+- `templates/asset-manifest.md` (all downloaded assets)
+- Their section's spec file
+
+---
+
+## Assembly order
+
+After all builders complete, the orchestrator assembles in this order:
+
+```tsx
+// src/app/page.tsx
+import { Navigation } from "@/components/navigation/Navigation";
+import { HeroSection } from "@/components/hero-section/HeroSection";
+// ... in section order
+import { Footer } from "@/components/footer/Footer";
+
+export default function Page() {
+  return (
+    <>
+      <Navigation />
+      <main>
+        <HeroSection />
+        {/* sections in order */}
+      </main>
+      <Footer />
+    </>
+  );
+}
+```
+
+---
+
+## Merge instructions
+
+After all `build/*` branches are complete:
+
+```bash
+cd ~/ai-website-cloner-template
+git checkout main
+
+# Merge each builder branch
+git merge build/navigation --no-ff -m "feat: navigation component"
+git merge build/hero-section --no-ff -m "feat: hero section"
+# ... continue for all builders
+
+# Assemble the page
+# Edit src/app/page.tsx to import and wire all components
+
+# Run quality checks
+npm run build
+npm run lint
+npm run typecheck
+```
+
+---
+
+## Conflict resolution notes
+
+[Document any merge conflicts encountered and how they were resolved]

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/clone-brief.md

@@ -0,0 +1,59 @@
+# Clone Brief
+
+**Project:** [PROJECT NAME]  
+**Client:** [CLIENT NAME]  
+**Target URL(s):** [https://example.com]  
+**Date:** YYYY-MM-DD  
+**Operator:** `ai-website-cloner-operator`
+
+---
+
+## Objective
+
+[Describe what success looks like — pixel-perfect clone, design reference, migration to modern stack, etc.]
+
+---
+
+## Scope
+
+### Pages to clone
+- [ ] [https://example.com] — [page description]
+- [ ] [https://example.com/about] — [page description]
+
+### Sections to include
+- [ ] Navigation / Header
+- [ ] Hero / Above-the-fold
+- [ ] [Additional sections…]
+- [ ] Footer
+
+### Sections to exclude
+- [ ] Login / auth flows
+- [ ] Payment pages
+- [ ] [Any other exclusions with reason]
+
+---
+
+## Constraints
+
+- **Deployment target:** [Vercel / self-hosted / static export]
+- **Custom domain:** [domain or TBD]
+- **Proprietary fonts:** [List any fonts that may not be available]
+- **Auth-gated content:** [Any content not accessible without login]
+- **Terms of Service notes:** [Any ToS constraints noted before starting]
+
+---
+
+## Deliverables
+
+- [ ] Cloned Next.js codebase in `~/ai-website-cloner-template`
+- [ ] Reconnaissance report
+- [ ] Design token extraction sheet
+- [ ] Component specs for all sections
+- [ ] Visual QA checklist
+- [ ] Platform handoff document
+
+---
+
+## Timeline
+
+[Technical complexity description — number of sections, interactive components, asset volume]

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/component-spec.md

@@ -0,0 +1,124 @@
+# [SectionName] — Component Spec
+
+**Project:** [PROJECT NAME]  
+**Section slug:** `[section-slug]`  
+**Output component:** `src/components/[section-slug]/[ComponentName].tsx`  
+**Date:** YYYY-MM-DD
+
+---
+
+## Purpose
+
+[What this section does for the user — one paragraph.]
+
+---
+
+## Layout
+
+- **Container max-width:** [value]
+- **Container padding (desktop):** [top right bottom left]
+- **Container padding (mobile):** [top right bottom left]
+- **Display:** [flex | grid | block]
+- **Grid columns (desktop):** [value]
+- **Grid columns (tablet):** [value]
+- **Grid columns (mobile):** [value]
+- **Gap:** [value]
+- **Section min-height:** [value]
+- **Background:** [color token]
+
+---
+
+## Typography
+
+| Element | Font family | Size | Line height | Weight | Color | Notes |
+|---|---|---|---|---|---|---|
+| Heading | [family] | [size] | [lh] | [weight] | [color] | — |
+| Subheading | [family] | [size] | [lh] | [weight] | [color] | — |
+| Body | [family] | [size] | [lh] | [weight] | [color] | — |
+| Caption | [family] | [size] | [lh] | [weight] | [color] | — |
+| Button label | [family] | [size] | [lh] | [weight] | [color] | — |
+
+---
+
+## Colors
+
+- **Background:** [hex] / [oklch]
+- **Text primary:** [hex] / [oklch]
+- **Text secondary:** [hex] / [oklch]
+- **Accent / CTA:** [hex] / [oklch]
+- **Border:** [hex] / [oklch]
+
+---
+
+## States
+
+### Default
+[Describe normal rendering]
+
+### Hover
+- **Trigger:** [what element triggers the state]
+- **Transform:** [e.g. `translateY(-2px)`]
+- **Color change:** [describe]
+- **Transition:** [e.g. `all 0.2s ease`]
+- **Shadow change:** [describe]
+
+### Active
+[Describe active/pressed state]
+
+### Focus
+- **Focus ring color:** [hex / oklch]
+- **Focus ring offset:** [value]
+- **Focus ring width:** [value]
+
+---
+
+## Responsive behavior
+
+### Desktop (1440px)
+[Describe layout]
+
+### Tablet (768px)
+[Describe layout changes from desktop]
+
+### Mobile (375px)
+[Describe layout changes from tablet]
+
+---
+
+## Assets
+
+| Asset | Type | Public path | Source URL |
+|---|---|---|---|
+| [image name] | image | `public/images/[filename].[ext]` | [original CDN URL] |
+| [icon name] | SVG | `src/components/icons.tsx` as `[IconName]` | [inline / file] |
+
+---
+
+## Content
+
+[Paste the exact text content from the target site. No placeholder text.]
+
+**Heading:**  
+[exact heading text]
+
+**Body copy:**  
+[exact body text]
+
+**CTA label:**  
+[exact button/link text]
+
+---
+
+## Accessibility
+
+- **ARIA landmark:** `[nav | main | aside | section]`
+- **Heading level:** `[h1 | h2 | h3]`
+- **Image alt text:** [describe required alt text]
+- **Tab order:** [describe keyboard navigation path through this section]
+- **Screen reader notes:** [any special ARIA labels, descriptions]
+
+---
+
+## Implementation notes
+
+[Any tricky implementation details, browser quirks, or decisions made during spec writing]

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/design-token-extraction.md

@@ -0,0 +1,89 @@
+# Design Token Extraction
+
+**Project:** [PROJECT NAME]  
+**Target URL:** [https://example.com]  
+**Date:** YYYY-MM-DD
+
+---
+
+## Color palette
+
+| Token name | Hex | oklch | Usage |
+|---|---|---|---|
+| `color-primary` | `#000000` | `oklch(0% 0 0)` | [CTAs, headings] |
+| `color-bg` | `#ffffff` | `oklch(100% 0 0)` | [Page background] |
+| `color-text` | `#1a1a1a` | `oklch(12% 0 0)` | [Body text] |
+| `color-text-secondary` | `#666666` | `oklch(45% 0 0)` | [Secondary text] |
+| `color-accent` | `#0070f3` | `oklch(50% 0.2 260)` | [Links, hover states] |
+| `color-border` | `#e5e5e5` | `oklch(91% 0 0)` | [Dividers, borders] |
+
+---
+
+## Typography
+
+| Token name | Font family | Size | Line height | Weight | Usage |
+|---|---|---|---|---|---|
+| `text-h1` | [family] | [size] | [lh] | [weight] | [page heading] |
+| `text-h2` | [family] | [size] | [lh] | [weight] | [section heading] |
+| `text-h3` | [family] | [size] | [lh] | [weight] | [card heading] |
+| `text-body` | [family] | [size] | [lh] | [weight] | [body copy] |
+| `text-caption` | [family] | [size] | [lh] | [weight] | [captions, labels] |
+| `text-button` | [family] | [size] | [lh] | [weight] | [button labels] |
+
+---
+
+## Spacing scale
+
+| Token name | Value | Usage |
+|---|---|---|
+| `spacing-xs` | [value] | [usage] |
+| `spacing-sm` | [value] | [usage] |
+| `spacing-md` | [value] | [usage] |
+| `spacing-lg` | [value] | [usage] |
+| `spacing-xl` | [value] | [usage] |
+| `spacing-2xl` | [value] | [usage] |
+
+---
+
+## Border radius
+
+| Token name | Value | Usage |
+|---|---|---|
+| `radius-sm` | [value] | [buttons, inputs] |
+| `radius-md` | [value] | [cards] |
+| `radius-lg` | [value] | [modals, sections] |
+| `radius-full` | `9999px` | [pills, avatars] |
+
+---
+
+## Box shadows
+
+| Token name | Value | Usage |
+|---|---|---|
+| `shadow-sm` | [value] | [subtle cards] |
+| `shadow-md` | [value] | [elevated cards] |
+| `shadow-lg` | [value] | [modals, dropdowns] |
+
+---
+
+## Transitions
+
+| Token name | Value | Usage |
+|---|---|---|
+| `transition-fast` | [duration easing] | [hover color changes] |
+| `transition-base` | [duration easing] | [transform, opacity] |
+| `transition-slow` | [duration easing] | [page transitions] |
+
+---
+
+## Tailwind CSS v4 config snippet
+
+```css
+@theme {
+  --color-primary: oklch(0% 0 0);
+  --color-bg: oklch(100% 0 0);
+  --color-text: oklch(12% 0 0);
+  --color-accent: oklch(50% 0.2 260);
+  /* Add all extracted tokens here */
+}
+```

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

@@ -0,0 +1,114 @@
+# Platform Handoff
+
+**Project:** [PROJECT NAME]  
+**Client:** [CLIENT NAME]  
+**Date:** YYYY-MM-DD  
+**Clone source:** [https://example.com]  
+**Codebase location:** `~/ai-website-cloner-template` (or custom fork path)
+
+---
+
+## What was built
+
+[One-paragraph summary of what was cloned and what the output codebase contains.]
+
+---
+
+## 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
+```
+
+---
+
+## Deploying to Vercel
+
+```bash
+npm install -g vercel
+cd ~/ai-website-cloner-template
+vercel --prod
+```
+
+Or connect the repository to [vercel.com](https://vercel.com) for automatic deploys.
+
+---
+
+## Deploying to other platforms
+
+### Self-hosted (Node.js)
+```bash
+npm run build
+node .next/standalone/server.js
+```
+
+### Static export (if no server-side features used)
+```bash
+# Add output: 'export' to next.config.ts first
+npm run build
+# Output is in out/
+```
+
+---
+
+## Project structure overview
+
+```
+src/
+  app/
+    page.tsx          # Main cloned page
+    layout.tsx        # Root layout (fonts, globals)
+    globals.css       # Design tokens and base styles
+  components/
+    navigation/       # Navigation component
+    hero-section/     # Hero section
+    [section-slug]/   # One directory per cloned section
+    icons.tsx         # Extracted SVG icons
+  lib/
+    utils.ts          # cn() utility
+public/
+  images/             # Downloaded images
+  videos/             # Downloaded videos
+  seo/                # Favicon, OG image, webmanifest
+docs/
+  research/           # Reconnaissance output
+```
+
+---
+
+## Known deviations from original
+
+| Section | Type | Notes |
+|---|---|---|
+| [section] | [font/color/layout/asset] | [description] |
+
+---
+
+## Customization next steps
+
+1. [ ] Replace placeholder content in all sections with client's actual content
+2. [ ] Update `src/app/layout.tsx` metadata (title, description, OG image)
+3. [ ] Configure deployment environment variables if any
+4. [ ] Remove proprietary assets if not licensed for redistribution
+5. [ ] Update `public/seo/` with client's actual favicon and OG images
+
+---
+
+## QA result
+
+See `qa/visual-qa-checklist.md` for the full QA report.
+
+**Overall result:** [PASS / PASS WITH NOTED DEVIATIONS / FAIL]

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/reconnaissance-report.md

@@ -0,0 +1,77 @@
+# Reconnaissance Report
+
+**Project:** [PROJECT NAME]  
+**Target URL:** [https://example.com]  
+**Date:** YYYY-MM-DD  
+**Phase:** Reconnaissance (Phase 3)
+
+---
+
+## Screenshots captured
+
+| Viewport | Width | File |
+|---|---|---|
+| Desktop | 1440px | `research/screenshots/desktop-<scroll>.png` |
+| Tablet | 768px | `research/screenshots/tablet-<scroll>.png` |
+| Mobile | 375px | `research/screenshots/mobile-<scroll>.png` |
+
+---
+
+## Page structure
+
+### Sections identified
+
+| Order | Section name | Slug | Approximate height | Notes |
+|---|---|---|---|---|
+| 1 | Navigation | `navigation` | 72px | Sticky |
+| 2 | Hero | `hero-section` | 600px | Full viewport |
+| 3 | [Section Name] | `[slug]` | [height] | [notes] |
+| N | Footer | `footer` | 200px | — |
+
+---
+
+## Design token summary
+
+> Full token set in `design-token-extraction.md`
+
+- **Primary color:** [hex]
+- **Background:** [hex]
+- **Heading font:** [family, weight]
+- **Body font:** [family, weight]
+- **Base spacing unit:** [value]
+
+---
+
+## Interaction notes
+
+### Navigation
+- [ ] Hamburger menu at mobile breakpoint
+- [ ] Dropdown menus
+- [ ] Sticky behavior: [describe]
+
+### CTAs / Buttons
+- [ ] Hover: [describe transform, color change]
+- [ ] Active: [describe]
+- [ ] Focus ring: [color, offset]
+
+### Scroll-triggered effects
+- [ ] [Describe any parallax, fade-in, sticky elements]
+
+---
+
+## Asset inventory summary
+
+> Full inventory in `asset-inventory.md`
+
+| Type | Count | Notes |
+|---|---|---|
+| Images | 0 | — |
+| Videos | 0 | — |
+| SVG icons | 0 | — |
+| Custom fonts | 0 | — |
+
+---
+
+## Risk notes
+
+[Any sections that may be difficult to clone — auth-gated content, complex animations, custom WebGL, etc.]