@growthub/cli 0.14.4 → 0.14.6

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

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

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

@@ -1,114 +0,0 @@
-# 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/project.md

@@ -1,48 +0,0 @@
----
-# .growthub-fork/project.md — session memory primitive (v1)
-#
-# Written by the CLI at init/import time. Append-only, human-readable; sits
-# alongside the machine-readable `trace.jsonl`. Approvals, self-eval outcomes,
-# and sub-skill runs all record here.
-#
-# Replaceable tokens (seeded at init time):
-#   {{KIT_ID}}   {{FORK_ID}}   {{STARTED_AT}}   {{SOURCE}}   {{SOURCE_REF}}
-
-kitId: "{{KIT_ID}}"
-forkId: "{{FORK_ID}}"
-startedAt: "{{STARTED_AT}}"
-source: "{{SOURCE}}"
-sourceRef: "{{SOURCE_REF}}"
-skillManifestVersion: 1
-approvals: []
-selfEvalHistory: []
-subSkillRuns: []
----
-
-# Project journal — fork `{{FORK_ID}}`
-
-Baseline primitive: `{{KIT_ID}}`. Seeded at `{{STARTED_AT}}` from `{{SOURCE}}` (`{{SOURCE_REF}}`).
-
-This is your cross-session continuity surface. Read the last few entries before every session; append after every material change, approval, and self-eval boundary.
-
-## How to use this file
-
-1. **Session start.** Read the last 3 entries + tail 20 events in `.growthub-fork/trace.jsonl`. State your plan.
-2. **Material change.** Record as a dated bullet (what, why, outcome). Simultaneously append a typed event to `trace.jsonl` via the Fork Sync Agent — never bypass.
-3. **Approval boundary.** Add a row to `approvals` in the frontmatter (verbatim decision).
-4. **Self-eval boundary.** Append to `selfEvalHistory`: `attempt`, `criteria`, `outcome`, `notes`. Enforce `maxRetries: 3`.
-5. **Sub-skill spawn.** Append to `subSkillRuns`: `subSkill`, `startedAt`, `result`.
-
-## Session log
-
-<!-- Append newest entries at the bottom. Format:
-
-### {{YYYY-MM-DD HH:mm UTC}} · {{skill-slug}}
-- **Plan.** What you intend to do.
-- **Changes.** Material changes (each must correspond to a trace event).
-- **Outcome.** Pass / fail / parked. Reference self-eval criteria.
-- **Next.** What the next session should pick up.
-
--->
-
-_No sessions recorded yet. Populated as the fork is operated._

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

@@ -1,77 +0,0 @@
-# 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.]

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/self-eval.md

@@ -1,67 +0,0 @@
-# Self-evaluation template — v1 primitive (Growthub, capability-agnostic)
-
-A skill's `selfEval` contract declares **what good looks like** (`criteria[]`) and **the retry ceiling** (`maxRetries`). The agent drives the loop; this file is the pattern the agent follows at every unit of work.
-
-The contract is defined in `@growthub/api-contract/skills::SkillSelfEval` and is **capability-agnostic** — the same primitive applies to code edits, copy drafts, CRM rules, API payloads, asset renders, audit passes, and every other domain. The "unit of work" is the smallest reversible change the skill operates on; concrete boundaries are defined in the kit's own `skills.md` operator runbook, not here.
-
-## Loop
-
-```
-for attempt in 1..maxRetries:          # default maxRetries = 3
-  generate       — produce a proposal (whatever the skill produces)
-  apply          — materialise the proposal against the fork
-  self-evaluate  — for each criterion in skill.selfEval.criteria:
-                     check → pass / fail / needs-confirmation
-  record         — append to project.md (human) + trace.jsonl (machine)
-
-  if all criteria pass: break
-  if attempt == maxRetries: park with needs_confirmation note. Stop.
-```
-
-## What each attempt writes
-
-### Human row — append to `.growthub-fork/project.md` "Session log"
-
-```md
-### 2026-04-23 18:40 UTC · <skill-slug>
-- **Plan.** What you intend to do this unit of work.
-- **Changes.** Material change applied (must correspond to a trace event).
-- **Self-eval.** attempt 2/3 — criterion "<one of skill.selfEval.criteria>" ✗ (<note>). Retrying.
-- **Outcome.** retry-pending / pass / parked.
-- **Next.** What the next attempt (or next session) should pick up.
-```
-
-### Machine row — append to `.growthub-fork/trace.jsonl` (via `appendKitForkTraceEvent`)
-
-```json
-{
-  "ts": "2026-04-23T18:40:00.000Z",
-  "forkId": "<fork-id>",
-  "kitId": "<kit-id>",
-  "type": "self_eval_recorded",
-  "summary": "attempt 2/3 failed on <criterion>",
-  "detail": {
-    "skill": "<skill-slug>",
-    "attempt": 2,
-    "maxRetries": 3,
-    "criterion": "<one of skill.selfEval.criteria>",
-    "outcome": "fail",
-    "notes": "<short explanation>"
-  }
-}
-```
-
-## Hard rules
-
-1. **Never exceed `maxRetries`.** At the ceiling, park with a `needs_confirmation` note and stop. Do not loop forever.
-2. **Record every attempt.** Even the first pass. Continuity depends on a complete journal.
-3. **Keep `project.md` and `trace.jsonl` in sync.** One without the other is a protocol violation.
-4. **Preserve prior entries.** Append-only. Never rewrite history.
-
-## Bound the blast radius
-
-Evaluate at the smallest unit of work the skill operates on, not only at the end of a multi-step run. The retry ceiling applies to that unit — so a bad attempt does not sink the whole job.
-
-What counts as a "unit of work" is **kit-specific** and lives in that kit's `skills.md` operator runbook — not in this agnostic template. A kit picks its own smallest reversible boundary and documents it in `skills.md`; this template does not prescribe one.
-
-The agnostic SDK (`@growthub/api-contract/skills::SkillSelfEval`) does not encode any domain-specific boundaries — it only carries `criteria[]`, `maxRetries`, and `traceTo`. See `SKILL.md::selfEval.criteria` in this kit for the concrete checks, and `skills.md` for the kit-specific unit of work.

package/assets/worker-kits/growthub-ai-website-cloner-v1/templates/visual-qa-checklist.md

@@ -1,107 +0,0 @@
-# Visual QA Checklist
-
-**Project:** [PROJECT NAME]  
-**Clone URL:** [http://localhost:3000]  
-**Original URL:** [https://example.com]  
-**Date:** YYYY-MM-DD  
-**QA reviewer:** `ai-website-cloner-operator`
-
----
-
-## Build checks
-
-- [ ] `npm run build` exits 0
-- [ ] `npm run lint` exits 0
-- [ ] `npm run typecheck` exits 0
-- [ ] Dev server starts without errors: `npm run dev`
-- [ ] No 404s in browser console for assets
-
----
-
-## Layout QA — Desktop (1440px)
-
-| Section | Status | Notes |
-|---|---|---|
-| Navigation | [ ] Pass / [ ] Deviation | — |
-| Hero | [ ] Pass / [ ] Deviation | — |
-| [Section] | [ ] Pass / [ ] Deviation | — |
-| Footer | [ ] Pass / [ ] Deviation | — |
-
----
-
-## Layout QA — Tablet (768px)
-
-| Section | Status | Notes |
-|---|---|---|
-| Navigation | [ ] Pass / [ ] Deviation | — |
-| Hero | [ ] Pass / [ ] Deviation | — |
-| [Section] | [ ] Pass / [ ] Deviation | — |
-| Footer | [ ] Pass / [ ] Deviation | — |
-
----
-
-## Layout QA — Mobile (375px)
-
-| Section | Status | Notes |
-|---|---|---|
-| Navigation | [ ] Pass / [ ] Deviation | — |
-| Hero | [ ] Pass / [ ] Deviation | — |
-| [Section] | [ ] Pass / [ ] Deviation | — |
-| Footer | [ ] Pass / [ ] Deviation | — |
-
----
-
-## Color fidelity
-
-| Token | Expected | Actual | Pass |
-|---|---|---|---|
-| Background | [hex] | [hex] | [ ] |
-| Text primary | [hex] | [hex] | [ ] |
-| Accent | [hex] | [hex] | [ ] |
-
----
-
-## Typography fidelity
-
-| Element | Expected font | Actual | Expected size | Actual | Pass |
-|---|---|---|---|---|---|
-| H1 | [family] | [actual] | [size] | [actual] | [ ] |
-| Body | [family] | [actual] | [size] | [actual] | [ ] |
-
----
-
-## Asset completeness
-
-- [ ] All images loading (no broken images)
-- [ ] All videos loading
-- [ ] All SVG icons rendering
-- [ ] Custom fonts loading
-
----
-
-## Interaction states
-
-| Element | State | Expected | Actual | Pass |
-|---|---|---|---|---|
-| Primary CTA | Hover | [describe] | [actual] | [ ] |
-| Navigation | Hover | [describe] | [actual] | [ ] |
-| Mobile nav | Tap | Opens hamburger | [actual] | [ ] |
-
----
-
-## Deviations
-
-| Section | Type | Reason | Resolution |
-|---|---|---|---|
-| [section] | [font/color/layout/asset/content] | [reason] | [how resolved] |
-
----
-
-## Final QA result
-
-- [ ] **PASS** — Clone meets all quality gates
-- [ ] **PASS WITH NOTED DEVIATIONS** — Deviations documented above
-- [ ] **FAIL** — Blocking issues must be resolved before handoff
-
-**Reviewer notes:**  
-[Any additional notes]

package/assets/worker-kits/growthub-ai-website-cloner-v1/validation-checklist.md

@@ -1,76 +0,0 @@
-# Validation Checklist — AI Website Cloner
-
-**Kit:** `growthub-ai-website-cloner-v1`
-
-Run through this checklist before producing the platform handoff.
-
----
-
-## Environment validation
-
-- [ ] Fork exists at `$HOME/ai-website-cloner-template` (or `AI_WEBSITE_CLONER_HOME` (legacy: `AI_CLONER_FORK_PATH`))
-- [ ] Node.js 24+ confirmed (`node --version`)
-- [ ] `node_modules/` installed in fork root
-- [ ] AI agent is active and running in the fork directory
-
----
-
-## Reconnaissance validation
-
-- [ ] Desktop screenshots captured (1440px, all scroll depths)
-- [ ] Tablet screenshots captured (768px)
-- [ ] Mobile screenshots captured (375px)
-- [ ] Design tokens extracted (`design-token-extraction.md` complete)
-- [ ] All hover/focus/active states documented
-- [ ] Asset inventory complete (all external URLs collected)
-- [ ] All assets downloaded to `public/images/`, `public/videos/`, `public/seo/`
-
----
-
-## Spec validation
-
-- [ ] One spec file per identified section in `output/<client>/<project>/specs/`
-- [ ] Each spec has exact computed CSS values (not estimated)
-- [ ] Each spec documents responsive breakpoints
-- [ ] Each spec documents interaction states
-- [ ] Asset paths in specs match `public/` inventory
-
----
-
-## Build validation
-
-- [ ] `npm run build` exits 0 (no TypeScript errors, no build errors)
-- [ ] `npm run lint` exits 0 (no ESLint errors)
-- [ ] `npm run typecheck` exits 0 (TypeScript strict mode clean)
-- [ ] Dev server runs: `npm run dev` → `localhost:3000` loads without errors
-- [ ] No 404s for assets in browser console
-
----
-
-## Visual QA validation
-
-- [ ] All sections rendered at desktop 1440px — reviewed against screenshot
-- [ ] All sections rendered at tablet 768px — reviewed against screenshot
-- [ ] All sections rendered at mobile 375px — reviewed against screenshot
-- [ ] All hover states verified interactively
-- [ ] All focus states verified via keyboard navigation
-- [ ] Color tokens match extracted values (spot-check 5+ elements)
-- [ ] Typography matches (spot-check font family, size, weight, line-height)
-- [ ] All images loading (no broken images)
-- [ ] All videos loading (no broken videos)
-- [ ] All SVG icons rendering correctly
-
----
-
-## Deviations documented
-
-- [ ] All known deviations listed in `qa/visual-qa-checklist.md`
-- [ ] Each deviation has a type, reason, and resolution
-
----
-
-## Handoff validation
-
-- [ ] `platform-handoff.md` complete
-- [ ] Deployment instructions for the target platform written
-- [ ] Brand kit updated with deliverable line