@growthub/cli 0.14.5 → 0.14.8

package/assets/worker-kits/growthub-geo-seo-v1/brands/_template/brand-kit.md

@@ -1,116 +0,0 @@
-# Brand Kit — [CLIENT NAME]
-
-> Copy to `brands/<client-slug>/brand-kit.md` and fill in all fields before producing outputs.
-> The GEO SEO Operator reads this file at Step 1 of every session.
-
----
-
-## IDENTITY
-
-```yaml
-client_name: ""                # Full legal or trading name
-slug: ""                       # URL-safe slug, lowercase, hyphens only (e.g., "urban-cycle")
-industry: ""                   # Industry category (e.g., "e-commerce — electric bikes")
-primary_service: ""            # What GEO/SEO work is being done (e.g., "GEO + SEO audit and AI search visibility remediation")
-campaign_name: ""              # This engagement's name (e.g., "Q2 2026 AI Search Launch Audit")
-date_onboarded: ""             # YYYY-MM-DD
-account_owner: ""              # Growthub team member responsible for this account
-```
-
----
-
-## AUDIENCE
-
-```yaml
-target_persona:
-  role: ""                     # Job title or role of the ideal website visitor / buyer
-  company_type: ""             # e.g., "DTC e-commerce brand", "B2B SaaS", "local service business"
-  pain_point: ""               # What they are struggling with (e.g., "losing organic traffic to AI search answers")
-  intent: ""                   # What they are trying to accomplish (e.g., "rank in AI-generated answers, not just Google blue links")
-
-geographic_target: ""          # e.g., "US, Canada, UK" or "Local — Chicago metro"
-
-do_not_attract:                # Who we are NOT trying to reach with this content
-  - ""
-  - ""
-```
-
----
-
-## MESSAGING
-
-```yaml
-core_message: ""               # One sentence: what does this brand want to be known for in AI search?
-
-tone:                          # 3–5 adjectives describing the brand voice
-  - ""
-  - ""
-  - ""
-
-approved_phrases:              # Phrases that are on-brand and should appear in content
-  - ""
-  - ""
-  - ""
-
-messaging_guardrails:          # What NOT to say — claims to avoid, topics to sidestep
-  - ""
-  - ""
-
-cta_text: ""                   # Primary call-to-action (e.g., "Start your free GEO audit")
-```
-
----
-
-## BRAND DESIGN
-
-```yaml
-colors:
-  primary: ""                  # Hex code (e.g., "#1A1A2E")
-  secondary: ""                # Hex code
-  accent: ""                   # Hex code
-  dark: ""                     # Hex code — for dark backgrounds
-  white: ""                    # Hex code — for light backgrounds (usually #FFFFFF)
-
-fonts:
-  heading: ""                  # Font name (e.g., "Inter Bold")
-  body: ""                     # Font name (e.g., "Inter Regular")
-
-logo_file: ""                  # Path to logo file (e.g., "brands/<slug>/assets/logo.png")
-logo_on_dark: ""               # Path to reversed logo for dark backgrounds
-```
-
----
-
-## AUDIT SCOPE
-
-```yaml
-target_url: ""                 # Primary URL to audit (e.g., "https://domain.com")
-
-competitor_urls:               # Competitor domains for comparison — fill per engagement
-  - ""
-  - ""
-  - ""
-
-audit_type: ""                 # quick | full | report | specific-command
-
-delivery_format: ""            # markdown | pdf | both
-```
-
----
-
-## AGENCY CONTEXT
-
-```yaml
-monthly_retainer_range: ""     # e.g., "$2,500–$4,000/month" or "N/A — project only"
-prospect_stage: ""             # discovery | proposal-sent | active | paused | churned | internal
-crm_notes: ""                  # Free text — any notes about the account, deal status, key contacts
-```
-
----
-
-## DELIVERABLES LOG
-
-> Append a line here each time an audit package is delivered.
-> Format: `- YYYY-MM-DD | GEO SEO Audit Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/`
-
-<!-- No deliverables yet. First entry goes here. -->

package/assets/worker-kits/growthub-geo-seo-v1/brands/growthub/brand-kit.md

@@ -1,117 +0,0 @@
-# Brand Kit — Growthub
-
-> Internal reference brand kit. Used as the example for all GEO SEO Studio demos and reference audits.
-
----
-
-## IDENTITY
-
-```yaml
-client_name: "Growthub"
-slug: "growthub"
-industry: "AI-enabled growth infrastructure and creative operations"
-primary_service: "GEO + SEO audit and remediation for AI search visibility"
-campaign_name: "Studio Launch Reference Audit"
-date_onboarded: "2026-04-14"
-account_owner: "Antonio"
-```
-
----
-
-## AUDIENCE
-
-```yaml
-target_persona:
-  role: "Growth lead, Head of Marketing, or Founder at a digital-native brand or agency"
-  company_type: "DTC e-commerce, B2B SaaS, or marketing agency — 10–200 employees"
-  pain_point: "Organic traffic is declining as AI search answers replace blue-link clicks. They have no strategy for AI search visibility."
-  intent: "Understand where they stand in AI search, fix the gaps, and capture AI-referred traffic before competitors do."
-
-geographic_target: "US, Canada, UK, Australia — English-language markets"
-
-do_not_attract:
-  - "Solo freelancers with no marketing budget"
-  - "Enterprise companies requiring procurement cycles >90 days"
-  - "Clients seeking black-hat SEO tactics"
-```
-
----
-
-## MESSAGING
-
-```yaml
-core_message: "Growthub helps growth-focused brands become citable, visible, and recommended by AI search systems — not just Google."
-
-tone:
-  - "Direct"
-  - "Technical"
-  - "Confident"
-  - "Data-grounded"
-  - "No-fluff"
-
-approved_phrases:
-  - "AI search visibility"
-  - "GEO Score"
-  - "citability"
-  - "AI-referred traffic"
-  - "worker kit"
-  - "remediation roadmap"
-  - "crawlable, citable, and optimized"
-
-messaging_guardrails:
-  - "Do not promise specific traffic or ranking outcomes — frame as projections based on audit data"
-  - "Do not call it 'SEO' alone — always pair with 'GEO' to signal AI search differentiation"
-  - "Do not claim to game AI systems — frame work as making content genuinely better for AI citation"
-
-cta_text: "Get your free GEO Score"
-```
-
----
-
-## BRAND DESIGN
-
-```yaml
-colors:
-  primary: "#1A1A2E"           # Deep navy — primary brand color
-  secondary: "#16213E"         # Darker navy — backgrounds
-  accent: "#E94560"            # Red-coral — CTAs, highlights
-  dark: "#0F3460"              # Dark blue — section backgrounds
-  white: "#EAEAEA"             # Off-white — body text on dark
-
-fonts:
-  heading: "Inter Bold"
-  body: "Inter Regular"
-
-logo_file: "brands/growthub/assets/logo.png"
-logo_on_dark: "brands/growthub/assets/logo-white.png"
-```
-
----
-
-## AUDIT SCOPE
-
-```yaml
-target_url: "https://thegrowthub.com"
-
-competitor_urls:
-  - ""                         # Fill per engagement — no standing competitors for internal reference
-
-audit_type: "full"
-delivery_format: "both"
-```
-
----
-
-## AGENCY CONTEXT
-
-```yaml
-monthly_retainer_range: "Internal reference — not sold externally for this domain"
-prospect_stage: "Internal"
-crm_notes: "This is the Growthub reference brand kit. Used for all studio demos, kit examples, and internal reference audits. Do not use as a template for external clients — copy brands/_template/brand-kit.md instead."
-```
-
----
-
-## DELIVERABLES LOG
-
-- 2026-04-14 | GEO SEO Audit Package v1 — Studio Launch Reference | output/growthub/studio-launch-reference/

package/assets/worker-kits/growthub-geo-seo-v1/bundles/growthub-geo-seo-v1.json

@@ -1,63 +0,0 @@
-{
-  "schemaVersion": 2,
-  "bundle": {
-    "id": "growthub-geo-seo-v1",
-    "version": "1.0.0",
-    "kitId": "growthub-geo-seo-v1",
-    "workerId": "geo-seo-operator"
-  },
-  "briefType": "geo-seo-audit",
-  "publicExampleBrandPaths": [
-    "brands/growthub/brand-kit.md"
-  ],
-  "requiredFrozenAssets": [
-    "QUICKSTART.md",
-    ".env.example",
-    "skills.md",
-    "output-standards.md",
-    "runtime-assumptions.md",
-    "validation-checklist.md",
-    "workers/geo-seo-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/geo-audit-brief.md",
-    "templates/citability-analysis.md",
-    "templates/crawler-access-report.md",
-    "templates/brand-visibility-report.md",
-    "templates/geo-score-summary.md",
-    "templates/content-analysis.md",
-    "templates/schema-validation.md",
-    "templates/technical-foundations.md",
-    "templates/llmstxt-plan.md",
-    "templates/remediation-roadmap.md",
-    "templates/client-proposal.md",
-    "examples/geo-audit-sample.md",
-    "examples/citability-sample.md",
-    "examples/pdf-report-sample.md",
-    "examples/prospect-proposal-sample.md",
-    "docs/geo-seo-fork-integration.md",
-    "docs/subagent-dispatch.md",
-    "docs/scoring-methodology.md",
-    "docs/pdf-report-layer.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"
-  ],
-  "optionalPresets": [],
-  "export": {
-    "folderName": "growthub-agent-worker-kit-geo-seo-v1",
-    "zipFileName": "growthub-agent-worker-kit-geo-seo-v1.zip"
-  },
-  "activationModes": [
-    "export"
-  ]
-}

package/assets/worker-kits/growthub-geo-seo-v1/docs/geo-seo-fork-integration.md

@@ -1,244 +0,0 @@
-# geo-seo-claude Fork Integration
-
-**Source repo:** https://github.com/zubair-trabzada/geo-seo-claude
-
----
-
-## What geo-seo-claude Is
-
-`geo-seo-claude` is an open-source Claude Code skill for GEO (Generative Engine Optimization) and SEO auditing. It provides 14 specialized commands that run against any live URL to produce AI search visibility data, citability scores, crawler access reports, and remediation artifacts.
-
-The Growthub GEO SEO Studio wraps this tool with:
-- A brand kit system (per-client configuration)
-- Structured output templates (11 templates, 9 core artifact types)
-- A 5-layer documentation architecture
-- A 4-week remediation roadmap format
-- PDF report generation integration
-- Agency proposal templates
-
----
-
-## Architecture of the Fork
-
-```
-geo-seo-claude/
-  geo/                        # Main skill entry point — Claude Code reads this
-    skill.md                  # Master skill definition
-  skills/                     # 14 sub-skill definitions (one per /geo command)
-    audit.md
-    citability.md
-    crawlers.md
-    brands.md
-    report.md
-    report-pdf.md
-    content.md
-    schema.md
-    technical.md
-    llmstxt.md
-    quick.md
-    proposal.md
-    prospect.md
-    compare.md
-  agents/                     # 5 parallel subagent definitions
-    geo-ai-visibility.md
-    geo-content.md
-    geo-platform-analysis.md
-    geo-schema.md
-    geo-technical.md
-  scripts/                    # Python utility scripts
-    fetch_page.py             # Playwright-based page fetcher and parser
-    citability_scorer.py      # 5-metric citability algorithm
-    brand_scanner.py          # 8-platform brand mention scanner
-    generate_pdf_report.py    # ReportLab PDF generator
-    llmstxt_generator.py      # llms.txt and llms-full.txt generator
-    crm_dashboard.py          # Flask CRM dashboard
-  schema/                     # 6 JSON-LD templates
-    organization.json
-    article.json
-    faqpage.json
-    product.json
-    localbusiness.json
-    breadcrumblist.json
-  requirements.txt            # Python dependencies
-  README.md
-```
-
----
-
-## Key Scripts and What Each Does
-
-### `scripts/fetch_page.py`
-
-Fetches a URL using Playwright (chromium) and extracts all signals needed for GEO analysis.
-
-**What it produces:**
-- Rendered HTML (after JavaScript execution)
-- robots.txt contents (fetched from domain root)
-- llms.txt and llms-full.txt status (exists/missing/malformed)
-- sitemap.xml discovery and URL count
-- HTTP response headers
-- Page word count and heading hierarchy
-- JSON-LD structured data blocks
-
-**Usage:**
-```bash
-python scripts/fetch_page.py https://example.com
-python scripts/fetch_page.py https://example.com --output analysis.json
-```
-
----
-
-### `scripts/citability_scorer.py`
-
-Runs the 5-metric citability algorithm against page content extracted by `fetch_page.py`.
-
-**5 metrics:**
-1. Answer Block Quality (30%)
-2. Self-Containment (25%)
-3. Structural Readability (20%)
-4. Statistical Density (15%)
-5. Uniqueness Signals (10%)
-
-**Usage:**
-```bash
-python scripts/citability_scorer.py --input analysis.json
-python scripts/citability_scorer.py --url https://example.com
-```
-
----
-
-### `scripts/brand_scanner.py`
-
-Scans 8 platforms for brand mentions and computes a brand authority score.
-
-**Platforms scanned:**
-YouTube, Reddit, Wikipedia, LinkedIn, Twitter/X, GitHub, Quora, HackerNews
-
-**Usage:**
-```bash
-python scripts/brand_scanner.py --brand "Brand Name" --domain example.com
-```
-
----
-
-### `scripts/generate_pdf_report.py`
-
-Generates a branded PDF report using ReportLab from a GEO score JSON data file.
-
-**Inputs required:**
-- `geo_score_data.json` — machine-readable score data produced by the audit
-- Client name and target URL
-- Optional: logo file path, color scheme
-
-**Usage:**
-```bash
-python scripts/generate_pdf_report.py \
-  --input output/<client>/geo_score_data.json \
-  --output output/<client>/report.pdf \
-  --brand "Client Name"
-```
-
----
-
-### `scripts/llmstxt_generator.py`
-
-Generates `llms.txt` and `llms-full.txt` files for a domain.
-
-**Usage:**
-```bash
-python scripts/llmstxt_generator.py --domain https://example.com --from-sitemap
-python scripts/llmstxt_generator.py --domain https://example.com --full
-python scripts/llmstxt_generator.py --domain https://example.com --dry-run
-```
-
----
-
-### `scripts/crm_dashboard.py`
-
-Launches a Flask web dashboard for managing audit history and client accounts.
-
-**Usage:**
-```bash
-python scripts/crm_dashboard.py
-# Dashboard available at http://localhost:5000 (or FLASK_PORT if set)
-```
-
----
-
-## Python Dependencies
-
-```
-beautifulsoup4      # HTML parsing
-playwright          # Dynamic page fetching (requires: playwright install chromium)
-reportlab           # PDF generation
-flask               # CRM dashboard web server
-rich                # Terminal output formatting
-validators          # URL validation
-requests            # HTTP requests for robots.txt, llms.txt
-lxml                # Fast XML/HTML parsing (sitemap processing)
-```
-
-Install all:
-```bash
-pip install -r requirements.txt
-playwright install chromium
-```
-
----
-
-## Installation
-
-```bash
-# Clone the fork
-git clone https://github.com/zubair-trabzada/geo-seo-claude ~/geo-seo-claude
-
-# Install Python dependencies
-cd ~/geo-seo-claude
-pip install -r requirements.txt
-
-# Install Playwright browser
-playwright install chromium
-
-# Verify installation
-python scripts/fetch_page.py https://example.com
-```
-
-Or use the kit's setup script:
-```bash
-bash setup/clone-fork.sh
-```
-
----
-
-## When the Fork Is Unavailable
-
-If the local fork is not cloned, the GEO SEO Operator switches to **agent-only mode**:
-
-- Page fetching is performed via Claude's built-in fetch capability
-- Citability scoring is performed manually using the 5-metric algorithm from `docs/scoring-methodology.md`
-- Brand scanning is performed via Claude's knowledge of platform signals
-- PDF generation is not available — Markdown equivalents are produced instead
-- All output artifacts are still produced and follow the same templates
-
-Agent-only mode is always valid and produces complete outputs. The local fork adds:
-- Higher accuracy citability scores (Python parser vs. agent estimate)
-- Real-time robots.txt parsing with exact user-agent matching
-- Playwright-rendered page content (handles JavaScript-heavy sites)
-- PDF generation capability
-- Flask CRM dashboard
-
----
-
-## Upstream Assumptions Frozen in This Kit
-
-These assumptions were verified against the fork at kit creation time (2026-04-14):
-
-- 14 /geo commands are available (listed in skills.md)
-- 5 parallel subagents are defined in `agents/`
-- Python 3.8+ is required
-- Playwright uses chromium by default
-- `requirements.txt` includes all dependencies listed above
-- `schema/` contains 6 JSON-LD templates
-- CRM dashboard runs on Flask at port 5000 by default
-
-If the upstream fork changes its API or file structure after this date, update `runtime-assumptions.md` accordingly.

package/assets/worker-kits/growthub-geo-seo-v1/docs/pdf-report-layer.md

@@ -1,139 +0,0 @@
-# PDF Report Layer
-
----
-
-## When to Trigger PDF Generation
-
-Trigger PDF generation only in these cases:
-
-1. The user explicitly requests `/geo report-pdf`
-2. The brand kit has `delivery_format: pdf` or `delivery_format: both`
-3. The operator completes a full audit and the user confirms PDF delivery
-
-Do not generate a PDF unless one of these conditions is met. Markdown is the default delivery format.
-
----
-
-## Script and Requirements
-
-**Script:** `scripts/generate_pdf_report.py` (in geo-seo-claude fork)
-
-**Python dependency:** ReportLab (`pip install reportlab`)
-
-**Required data:** The script consumes `geo_score_data.json` — the machine-readable score data produced at the end of the audit workflow. This file must be written to the output directory before triggering PDF generation.
-
----
-
-## What the Script Needs
-
-The following inputs are required by `generate_pdf_report.py`:
-
-| Input | Source | Required |
-|---|---|---|
-| `--input path/to/geo_score_data.json` | Written by operator at end of audit | Yes |
-| `--output path/to/report.pdf` | Specified by operator | Yes |
-| `--brand "Client Name"` | From brand kit `client_name` field | Yes |
-| Target URL | From `geo_score_data.json` | Yes (in data) |
-| All 6 component scores | From `geo_score_data.json` | Yes (in data) |
-| Top findings list | From `geo_score_data.json` | Yes (in data) |
-| Remediation roadmap summary | From `geo_score_data.json` | Yes (in data) |
-| `--logo path/to/logo.png` | From brand kit `logo_file` field | Optional |
-
----
-
-## Usage
-
-```bash
-# Standard invocation from kit root
-python ~/geo-seo-claude/scripts/generate_pdf_report.py \
-  --input output/<client-slug>/<project-slug>/geo_score_data.json \
-  --output output/<client-slug>/<project-slug>/<ClientSlug>_GeoScoreReport_v1_<YYYYMMDD>.pdf \
-  --brand "Client Name" \
-  --logo brands/<client-slug>/assets/logo.png
-
-# Without logo (logo will use default Growthub placeholder)
-python ~/geo-seo-claude/scripts/generate_pdf_report.py \
-  --input output/<client-slug>/<project-slug>/geo_score_data.json \
-  --output output/<client-slug>/<project-slug>/report.pdf \
-  --brand "Client Name"
-```
-
----
-
-## What the PDF Contains
-
-The branded PDF report produced by `generate_pdf_report.py` includes the following sections:
-
-| Section | Pages | Content |
-|---|---|---|
-| Cover page | 1 | Client name, target URL, GEO Score gauge visualization, letter grade, audit date |
-| Executive summary | 1 | 3 key findings, score vs. category benchmark, top recommended action |
-| GEO Score breakdown | 2 | Visual bar chart for all 6 components, weighted contribution table |
-| Citability analysis | 1 | 5-metric breakdown with visual gauges, letter grade, top 3 improvements |
-| Crawler access matrix | 1 | 14-crawler table with color-coded access status (green/yellow/red) |
-| Top findings | 2 | Ranked findings with impact level, effort estimate, and specific fix instructions |
-| 4-week roadmap | 1 | Sprint table with actions, owners, and projected score gain |
-| Back cover | 1 | Growthub contact information, next steps, rescore recommendation |
-
-**Typical PDF length:** 10–12 pages (Letter or A4)
-
----
-
-## geo_score_data.json Format
-
-The operator must write this file before triggering PDF generation. See `examples/pdf-report-sample.md` for the complete format.
-
-Minimum required structure:
-```json
-{
-  "report_meta": {
-    "client_name": "",
-    "target_url": "",
-    "audit_date": "",
-    "report_version": "1"
-  },
-  "geo_score": {
-    "composite": 0,
-    "grade": ""
-  },
-  "components": [
-    { "name": "", "weight": 0.0, "raw_score": 0, "weighted_score": 0.0, "grade": "", "primary_issue": "" }
-  ],
-  "top_findings": [
-    { "rank": 1, "title": "", "description": "", "component": "", "priority": "", "expected_score_gain": 0 }
-  ],
-  "remediation_summary": {
-    "score_before": 0,
-    "score_after_projected": 0
-  }
-}
-```
-
----
-
-## In Agent-Only Mode
-
-If the local fork is not available, PDF generation is not possible.
-
-**Fallback behavior:**
-1. Produce the complete `GeoScoreSummary` Markdown file as the primary score artifact
-2. Note at the top: `> PDF generation requires the local geo-seo-claude fork. Run bash setup/clone-fork.sh to enable.`
-3. Write `geo_score_data.json` to the output directory so PDF can be generated later when the fork is available
-
-The Markdown output is a complete substitute for stakeholder communication. All the same data is present — the PDF simply adds visual formatting.
-
----
-
-## PDF Styling
-
-The PDF uses the brand kit's color values:
-
-| Element | Color Source |
-|---|---|
-| Header and cover background | `colors.primary` from brand kit |
-| Accent bars and highlights | `colors.accent` from brand kit |
-| Score gauge fill | Dynamic: green (A), blue (B), yellow (C), orange (D), red (F) |
-| Body text | `colors.dark` or black |
-| Table alternating rows | `colors.secondary` at 10% opacity |
-
-If no brand kit colors are found, the PDF uses Growthub defaults (`#1A1A2E` primary, `#E94560` accent).