@growthub/cli 0.3.52 → 0.3.53

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

@@ -0,0 +1,102 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-geo-seo-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — GEO SEO Studio",
+    "description": "Self-contained local execution environment for GEO + SEO auditing using geo-seo-claude. Produces AI search visibility audits, citability scores, crawler access reports, brand mention scans, remediation roadmaps, and client-ready PDF deliverables via 14 specialized commands and 5 parallel subagents.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "geo-seo-operator",
+    "path": "workers/geo-seo-operator/CLAUDE.md"
+  },
+  "workerIds": ["geo-seo-operator"],
+  "agentContractPath": "workers/geo-seo-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/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"
+  ],
+  "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-geo-seo-v1.json",
+      "skills.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",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-geo-seo-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-geo-seo-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": ["export"],
+  "compatibility": {
+    "cliMinVersion": "0.3.50"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-14T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-geo-seo-v1/output/README.md

@@ -0,0 +1,114 @@
+# Output Directory
+
+All GEO SEO audit artifacts are written here. Each client gets a subdirectory. Each engagement gets a project subdirectory.
+
+---
+
+## Directory Structure
+
+```
+output/
+  <client-slug>/
+    <project-slug>/
+      GeoAuditBrief_v1_YYYYMMDD.md
+      CitabilityAnalysis_v1_YYYYMMDD.md
+      CrawlerAccessReport_v1_YYYYMMDD.md
+      BrandVisibilityReport_v1_YYYYMMDD.md
+      GeoScoreSummary_v1_YYYYMMDD.md
+      ContentAnalysis_v1_YYYYMMDD.md
+      SchemaValidation_v1_YYYYMMDD.md
+      TechnicalFoundations_v1_YYYYMMDD.md
+      LlmstxtPlan_v1_YYYYMMDD.md
+      RemediationRoadmap_v1_YYYYMMDD.md
+      ClientProposal_v1_YYYYMMDD.md        (if requested)
+      geo_score_data.json                  (machine-readable score data for PDF generation)
+      <ClientSlug>_GeoScoreReport_v1_YYYYMMDD.pdf  (if PDF delivery requested)
+```
+
+---
+
+## File Naming Convention
+
+```
+<ClientSlug>_<OutputType>_v<N>_<YYYYMMDD>.md
+```
+
+| Part | Format | Example |
+|---|---|---|
+| ClientSlug | TitleCase, no spaces | `GrowthHub` |
+| OutputType | CamelCase artifact type | `GeoScoreSummary` |
+| Version | `v` + integer | `v1`, `v2` |
+| Date | `YYYYMMDD` | `20260414` |
+
+Full example: `GrowthHub_GeoScoreSummary_v1_20260414.md`
+
+---
+
+## Artifact Types (9 Core + 2 Optional)
+
+| Artifact | File Name Pattern | Description |
+|---|---|---|
+| GEO Audit Brief | `GeoAuditBrief_v<N>_<YYYYMMDD>.md` | Project scope, objective, command plan |
+| Citability Analysis | `CitabilityAnalysis_v<N>_<YYYYMMDD>.md` | 5-metric citability score with component breakdown |
+| Crawler Access Report | `CrawlerAccessReport_v<N>_<YYYYMMDD>.md` | 14 AI crawler permission matrix |
+| Brand Visibility Report | `BrandVisibilityReport_v<N>_<YYYYMMDD>.md` | 8-platform brand mention scan |
+| GEO Score Summary | `GeoScoreSummary_v<N>_<YYYYMMDD>.md` | 6-component weighted composite score |
+| Content Analysis | `ContentAnalysis_v<N>_<YYYYMMDD>.md` | E-E-A-T, answer blocks, statistical density |
+| Schema Validation | `SchemaValidation_v<N>_<YYYYMMDD>.md` | Structured data coverage and errors |
+| Technical Foundations | `TechnicalFoundations_v<N>_<YYYYMMDD>.md` | Server headers, Core Web Vitals signals |
+| llms.txt Plan | `LlmstxtPlan_v<N>_<YYYYMMDD>.md` | llms.txt implementation plan and files |
+| Remediation Roadmap | `RemediationRoadmap_v<N>_<YYYYMMDD>.md` | 4-week sprint plan with owners |
+| Client Proposal | `ClientProposal_v<N>_<YYYYMMDD>.md` | Agency proposal with pricing and ROI |
+| PDF Report | `<ClientSlug>_GeoScoreReport_v<N>_<YYYYMMDD>.pdf` | Branded PDF for stakeholder delivery |
+
+---
+
+## Usage Notes
+
+- **Never edit output files directly.** Always run a new audit and increment the version number.
+- **Version numbering:** Start at v1. Increment on each rescore or significant update.
+- **Rescore tracking:** Compare GEO Score Summary files across versions to track improvement.
+- **Brand kit log:** The operator appends a line to the brand kit's DELIVERABLES LOG after each package is delivered.
+
+---
+
+## Deliverable Tracking Format
+
+Append this line to `brands/<client-slug>/brand-kit.md` after each delivery:
+
+```
+- YYYY-MM-DD | GEO SEO Audit Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/
+```
+
+Examples:
+```
+- 2026-04-14 | GEO SEO Audit Package v1 — Studio Launch Reference | output/growthub/studio-launch-reference/
+- 2026-05-01 | GEO SEO Audit Package v1 — UrbanCycle Full Audit | output/urban-cycle/full-audit-q2-2026/
+- 2026-05-15 | GEO SEO Audit Package v2 — UrbanCycle Post-Remediation Rescore | output/urban-cycle/rescore-may-2026/
+```
+
+---
+
+## Example Layout (Populated)
+
+```
+output/
+  growthub/
+    studio-launch-reference/
+      GeoAuditBrief_v1_20260414.md
+      CitabilityAnalysis_v1_20260414.md
+      CrawlerAccessReport_v1_20260414.md
+      BrandVisibilityReport_v1_20260414.md
+      GeoScoreSummary_v1_20260414.md
+      ContentAnalysis_v1_20260414.md
+      SchemaValidation_v1_20260414.md
+      TechnicalFoundations_v1_20260414.md
+      LlmstxtPlan_v1_20260414.md
+      RemediationRoadmap_v1_20260414.md
+      geo_score_data.json
+      GrowthHub_GeoScoreReport_v1_20260414.pdf
+  urban-cycle/
+    full-audit-q2-2026/
+      GeoAuditBrief_v1_20260501.md
+      ...
+```

package/assets/worker-kits/growthub-geo-seo-v1/output-standards.md

@@ -0,0 +1,143 @@
+# Output Standards
+
+**All GEO SEO Operator outputs must meet these standards before being delivered to a client.**
+
+---
+
+## Output Directory Structure
+
+```
+output/
+  <client-slug>/
+    <project-slug>/
+      GeoAuditBrief_v<N>_<YYYYMMDD>.md
+      CitabilityAnalysis_v<N>_<YYYYMMDD>.md
+      CrawlerAccessReport_v<N>_<YYYYMMDD>.md
+      BrandVisibilityReport_v<N>_<YYYYMMDD>.md
+      GeoScoreSummary_v<N>_<YYYYMMDD>.md
+      ContentAnalysis_v<N>_<YYYYMMDD>.md
+      SchemaValidation_v<N>_<YYYYMMDD>.md
+      TechnicalFoundations_v<N>_<YYYYMMDD>.md
+      LlmstxtPlan_v<N>_<YYYYMMDD>.md
+      RemediationRoadmap_v<N>_<YYYYMMDD>.md
+      ClientProposal_v<N>_<YYYYMMDD>.md       (if requested)
+      geo_score_data.json                     (always — powers PDF and rescores)
+      <ClientSlug>_GeoScoreReport_v<N>_<YYYYMMDD>.pdf  (if PDF requested)
+```
+
+---
+
+## File Naming Convention
+
+```
+<ClientSlug>_<OutputType>_v<N>_<YYYYMMDD>.md
+```
+
+| Part | Rules | Example |
+|---|---|---|
+| ClientSlug | TitleCase, no spaces, no special chars | `UrbanCycle` |
+| OutputType | CamelCase from the list below | `GeoScoreSummary` |
+| Version | `v` + integer, starting at 1 | `v1` |
+| Date | `YYYYMMDD` format | `20260414` |
+
+**Output type names:**
+
+| Artifact | OutputType string |
+|---|---|
+| GEO Audit Brief | `GeoAuditBrief` |
+| Citability Analysis | `CitabilityAnalysis` |
+| Crawler Access Report | `CrawlerAccessReport` |
+| Brand Visibility Report | `BrandVisibilityReport` |
+| GEO Score Summary | `GeoScoreSummary` |
+| Content Analysis | `ContentAnalysis` |
+| Schema Validation | `SchemaValidation` |
+| Technical Foundations | `TechnicalFoundations` |
+| llms.txt Plan | `LlmstxtPlan` |
+| Remediation Roadmap | `RemediationRoadmap` |
+| Client Proposal | `ClientProposal` |
+
+---
+
+## Required Sections Per Artifact
+
+Each artifact must include all sections from its template. Incomplete sections must be marked `<!-- data-gap: reason -->` — never left blank without explanation.
+
+| Artifact | Minimum Required Sections |
+|---|---|
+| GeoAuditBrief | Project Overview table, Audit Objective, Command Selection Plan, Success Criteria |
+| CitabilityAnalysis | URL Audited, Citability Score table, Component Breakdown table, Top 3 Improvements |
+| CrawlerAccessReport | URL Audited, Crawler Permission Matrix (all 14 rows), Summary, Recommended Actions |
+| BrandVisibilityReport | Brand Audited, Platform Scan table (all 8 rows), Brand Authority Score, Gap Analysis |
+| GeoScoreSummary | Overall GEO Score (number + grade), Component Scores table, Score Narrative, Priority Recommendations |
+| ContentAnalysis | E-E-A-T Assessment table, Answer Block Analysis, Self-Containment Check, Content Quality Score |
+| SchemaValidation | Schema Types Found table, Validation Errors table, Missing Recommended Types, Implementation Priority |
+| TechnicalFoundations | Server Headers table, Core Signals table, Technical Score, Critical Fixes |
+| LlmstxtPlan | Current Status, Proposed llms.txt content, Proposed llms-full.txt content, Implementation Steps |
+| RemediationRoadmap | Current vs. Target Score, 4-Week Sprint Plan (all 4 weeks), Estimated Score After Roadmap |
+| ClientProposal | GEO Audit Summary, Why GEO Matters Now, 3 Critical Issues, Recommended Engagement (all 3 tiers), ROI Projection |
+
+---
+
+## Quality Bar
+
+### Data-Grounded
+
+- Every score must be derived from actual page data, not estimated without basis
+- If a score cannot be determined (e.g., robots.txt returns 500), use 50 and flag as `data-gap`
+- Never invent a score to complete a section — a flagged gap is more useful than a fabricated number
+
+### No Filler
+
+- Every sentence must either present data, explain a finding, or specify an action
+- Remove phrases like "This is an important area to consider" — replace with the actual consideration
+- Recommendations must be specific: name the exact robots.txt line, the exact schema type, the exact paragraph to rewrite
+
+### Actionable
+
+- Every finding must have a corresponding action in the Remediation Roadmap
+- Actions must include: what to do, who should do it, how long it should take, what the expected impact is
+- Code snippets in SchemaValidation must be copy-pasteable
+
+### Consistent
+
+- All scores in all artifacts must match — the GEO Score in GeoScoreSummary must equal the calculated composite from all component scores
+- Dates must be consistent across all artifacts
+- Client name and URL must match the brand kit exactly
+
+### Output Order
+
+Artifacts must be produced and numbered in this order:
+
+1. GeoAuditBrief
+2. CitabilityAnalysis
+3. CrawlerAccessReport
+4. BrandVisibilityReport
+5. GeoScoreSummary
+6. ContentAnalysis
+7. SchemaValidation
+8. TechnicalFoundations
+9. LlmstxtPlan
+10. RemediationRoadmap
+11. ClientProposal (if requested)
+
+---
+
+## Versioning Rules
+
+| Scenario | Action |
+|---|---|
+| First audit for a client | All files at v1 |
+| Rescore after remediation | Increment all files to v2 (or current version + 1) |
+| Partial update (one artifact revised) | Increment only the revised artifact's version |
+| Major scope change | Start new project-slug, all files at v1 |
+
+---
+
+## geo_score_data.json
+
+This file must always be written to the output directory. It is the machine-readable record of the audit and is required for:
+- PDF generation (`generate_pdf_report.py`)
+- Rescore comparison (load v1 data, compare to v2)
+- CRM dashboard import (`crm_dashboard.py`)
+
+See `examples/pdf-report-sample.md` for the complete format.

package/assets/worker-kits/growthub-geo-seo-v1/runtime-assumptions.md

@@ -0,0 +1,175 @@
+# Runtime Assumptions
+
+**Frozen at kit creation: 2026-04-14. Update this file when upstream fork behavior changes.**
+
+---
+
+## Execution Mode Overview
+
+| Mode | Requirements | Fork Used? | Python Scripts? | PDF? | Accuracy |
+|---|---|---|---|---|---|
+| `local-fork` | Python 3.8+, Playwright, geo-seo-claude clone | Yes | Yes | Yes | Highest |
+| `agent-only` | Nothing (Claude Code only) | No | No | No | Good |
+| `hybrid` | ANTHROPIC_API_KEY + fork | Yes | Yes | Yes | Highest |
+
+### Choosing a Mode
+
+- **Use `local-fork`** when you need the most accurate citability scores (Python parser), real Playwright-rendered page content, or PDF output.
+- **Use `agent-only`** when the fork is not installed or when speed matters more than exact precision. All outputs are still produced using the same templates and formulas.
+- **Use `hybrid`** when you want agent reasoning layer on top of Python data collection — useful for complex competitor comparisons or detailed content rewrites.
+
+---
+
+## geo-seo-claude Upstream Assumptions
+
+These are the assumptions frozen at kit creation time about the `geo-seo-claude` fork at https://github.com/zubair-trabzada/geo-seo-claude.
+
+### Python Environment
+
+| Requirement | Value | Notes |
+|---|---|---|
+| Python version | 3.8+ | Tested on 3.10 and 3.11 |
+| Package manager | pip | `pip install -r requirements.txt` |
+| Key dependencies | BeautifulSoup4, Playwright, ReportLab, Flask, Rich, validators | See requirements.txt |
+| Playwright browser | chromium | `playwright install chromium` |
+
+### 14 CLI Skills (Commands)
+
+All 14 `/geo` commands are available in `skills/` directory:
+
+| Command | File | Status |
+|---|---|---|
+| `/geo audit` | `skills/audit.md` | Available |
+| `/geo citability` | `skills/citability.md` | Available |
+| `/geo crawlers` | `skills/crawlers.md` | Available |
+| `/geo brands` | `skills/brands.md` | Available |
+| `/geo report` | `skills/report.md` | Available |
+| `/geo report-pdf` | `skills/report-pdf.md` | Available |
+| `/geo content` | `skills/content.md` | Available |
+| `/geo schema` | `skills/schema.md` | Available |
+| `/geo technical` | `skills/technical.md` | Available |
+| `/geo llmstxt` | `skills/llmstxt.md` | Available |
+| `/geo quick` | `skills/quick.md` | Available |
+| `/geo proposal` | `skills/proposal.md` | Available |
+| `/geo prospect` | `skills/prospect.md` | Available |
+| `/geo compare` | `skills/compare.md` | Available |
+
+### 5 Parallel Subagents
+
+All 5 subagent definitions are in `agents/` directory:
+
+| Subagent | File | Weight |
+|---|---|---|
+| geo-ai-visibility | `agents/geo-ai-visibility.md` | 25% |
+| geo-content | `agents/geo-content.md` | 20% |
+| geo-platform-analysis | `agents/geo-platform-analysis.md` | 10% |
+| geo-schema | `agents/geo-schema.md` | 10% |
+| geo-technical | `agents/geo-technical.md` | 15% |
+
+### Key Python Scripts
+
+| Script | Path in Fork | Purpose |
+|---|---|---|
+| fetch_page.py | `scripts/fetch_page.py` | Playwright-based page fetcher |
+| citability_scorer.py | `scripts/citability_scorer.py` | 5-metric citability algorithm |
+| brand_scanner.py | `scripts/brand_scanner.py` | 8-platform brand mention scanner |
+| generate_pdf_report.py | `scripts/generate_pdf_report.py` | ReportLab PDF generator |
+| llmstxt_generator.py | `scripts/llmstxt_generator.py` | llms.txt generator |
+| crm_dashboard.py | `scripts/crm_dashboard.py` | Flask CRM dashboard |
+
+### Schema Templates
+
+6 JSON-LD templates in `schema/` directory:
+
+| Template | Type |
+|---|---|
+| organization.json | Organization |
+| article.json | Article |
+| faqpage.json | FAQPage |
+| product.json | Product |
+| localbusiness.json | LocalBusiness |
+| breadcrumblist.json | BreadcrumbList |
+
+---
+
+## Execution Surface Flows
+
+### Local-Fork Mode
+
+```
+User request → Environment gate (Step 0)
+  ↓
+Read skills.md + brand kit (Step 1)
+  ↓
+Read runtime docs (Step 2)
+  ↓
+Inspect fork: README, skills/, agents/, scripts/ (Step 3)
+  ↓
+3-question gate (Step 4)
+  ↓
+Select /geo command (Step 5)
+  ↓
+Phase 1: python fetch_page.py <url> → phase1_data.json (Step 6)
+  ↓
+Phase 2: 5 subagents in parallel → component scores (Step 7)
+  ↓
+GEO Score synthesis → composite score (Step 8)
+  ↓
+Artifact package: 9–11 Markdown files (Step 9)
+  ↓ (if PDF requested)
+python generate_pdf_report.py --input geo_score_data.json (Step 9)
+  ↓
+Log deliverable → brand kit DELIVERABLES LOG (Step 10)
+```
+
+### Agent-Only Mode
+
+```
+User request → Environment gate (Step 0 — confirm agent-only)
+  ↓
+Read skills.md + brand kit (Step 1)
+  ↓
+Read runtime docs (Step 2)
+  ↓
+Skip fork inspection (Step 3 — N/A)
+  ↓
+3-question gate (Step 4)
+  ↓
+Select /geo command (Step 5)
+  ↓
+Phase 1: fetch page via Claude built-in fetch → parse manually (Step 6)
+  ↓
+Phase 2: 5 subagents via Claude reasoning → component scores (Step 7)
+  ↓
+GEO Score synthesis → composite score (Step 8)
+  ↓
+Artifact package: 9–11 Markdown files + geo_score_data.json (Step 9)
+  ↓ (PDF not available — note Markdown equivalent)
+Log deliverable → brand kit DELIVERABLES LOG (Step 10)
+```
+
+---
+
+## Output Assumption
+
+All outputs are Markdown files written to:
+
+```
+output/<client-slug>/<project-slug>/
+```
+
+The operator does not write directly to client systems. Outputs are produced locally and then shared with clients via the agreed delivery channel.
+
+---
+
+## Flask CRM Dashboard Assumption
+
+The CRM dashboard (`crm_dashboard.py`) runs as a separate process. It is not started automatically during an audit session.
+
+To launch manually from the fork directory:
+```bash
+python scripts/crm_dashboard.py
+# Accessible at http://localhost:5000 (or FLASK_PORT if set)
+```
+
+The dashboard reads from the `output/` directory and displays audit history across all clients.

package/assets/worker-kits/growthub-geo-seo-v1/setup/check-deps.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# check-deps.sh — Verify dependencies for geo-seo-claude local-fork workflows
+# Usage: bash setup/check-deps.sh
+set -e
+
+PASS=0
+FAIL=0
+
+check() {
+  local name="$1" cmd="$2" hint="$3"
+  if command -v "$cmd" >/dev/null 2>&1; then
+    echo "OK   $name ($(command -v $cmd))"
+    PASS=$((PASS+1))
+  else
+    echo "MISS $name — $hint"
+    FAIL=$((FAIL+1))
+  fi
+}
+
+echo "=== Growthub GEO SEO Studio — Dependency Check ==="
+echo ""
+
+check "python3"     "python3"     "https://python.org — install Python 3.8+"
+check "pip"         "pip"         "Comes with Python — try: python3 -m pip"
+check "playwright"  "playwright"  "pip install playwright && playwright install chromium"
+check "git"         "git"         "https://git-scm.com"
+check "node"        "node"        "https://nodejs.org — required for setup/verify-env.mjs"
+
+echo ""
+
+# Check Python version is 3.8+
+if command -v python3 >/dev/null 2>&1; then
+  PY_VERSION=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
+  PY_MAJOR=$(python3 -c "import sys; print(sys.version_info.major)")
+  PY_MINOR=$(python3 -c "import sys; print(sys.version_info.minor)")
+  if [ "$PY_MAJOR" -ge 3 ] && [ "$PY_MINOR" -ge 8 ]; then
+    echo "OK   Python version: $PY_VERSION (3.8+ required)"
+    PASS=$((PASS+1))
+  else
+    echo "MISS Python version: $PY_VERSION — geo-seo-claude requires Python 3.8+"
+    FAIL=$((FAIL+1))
+  fi
+fi
+
+# Check Playwright chromium is installed (not just the CLI)
+if command -v playwright >/dev/null 2>&1; then
+  if playwright browsers 2>/dev/null | grep -q "chromium"; then
+    echo "OK   Playwright chromium browser installed"
+    PASS=$((PASS+1))
+  else
+    echo "MISS Playwright chromium browser not found — run: playwright install chromium"
+    FAIL=$((FAIL+1))
+  fi
+fi
+
+# Check for the fork directory
+FORK_DIR="${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}"
+if [ -d "$FORK_DIR" ]; then
+  echo "OK   geo-seo-claude fork at $FORK_DIR"
+  PASS=$((PASS+1))
+else
+  echo "MISS geo-seo-claude fork not found at $FORK_DIR"
+  echo "     Run: bash setup/clone-fork.sh"
+  echo "     Or set GEO_SEO_FORK_PATH to your fork path in .env"
+  FAIL=$((FAIL+1))
+fi
+
+echo ""
+echo "Passed: $PASS  |  Missing: $FAIL"
+
+if [ "$FAIL" -gt 0 ]; then
+  echo ""
+  echo "Install missing dependencies before running local-fork workflows."
+  echo "Agent-only mode (no fork required) is always available as a fallback."
+  exit 1
+fi
+
+echo ""
+echo "All dependencies present. Local-fork mode is ready."
+echo "Next: node setup/verify-env.mjs"

package/assets/worker-kits/growthub-geo-seo-v1/setup/clone-fork.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# clone-fork.sh — Clone geo-seo-claude and install dependencies
+# Usage: bash setup/clone-fork.sh
+set -e
+
+FORK_DIR="${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}"
+REPO_URL="https://github.com/zubair-trabzada/geo-seo-claude"
+
+echo "=== Growthub GEO SEO Studio — 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 geo-seo-claude → $FORK_DIR"
+  git clone "$REPO_URL" "$FORK_DIR"
+  echo "Clone complete."
+fi
+
+echo ""
+echo "Installing Python dependencies..."
+cd "$FORK_DIR"
+pip install -r requirements.txt
+echo "Python dependencies installed."
+
+echo ""
+echo "Installing Playwright browsers..."
+playwright install chromium
+echo "Playwright chromium installed."
+
+echo ""
+echo "Verifying key scripts..."
+SCRIPTS_OK=0
+for script in fetch_page.py citability_scorer.py brand_scanner.py generate_pdf_report.py llmstxt_generator.py; do
+  if [ -f "scripts/$script" ]; then
+    echo "  OK   scripts/$script"
+  else
+    echo "  MISS scripts/$script — may not exist in this fork version"
+    SCRIPTS_OK=1
+  fi
+done
+
+echo ""
+if [ "$SCRIPTS_OK" -eq 0 ]; then
+  echo "geo-seo-claude is ready at $FORK_DIR"
+else
+  echo "geo-seo-claude cloned at $FORK_DIR — some scripts may be missing."
+  echo "Check the fork's README for the correct script paths."
+fi
+
+echo ""
+echo "Quick test:"
+echo "  python $FORK_DIR/scripts/fetch_page.py https://example.com"
+echo ""
+echo "Run the GEO audit operator by pointing Claude Code at this kit."