bmad-plus 0.12.0 → 0.12.2

package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json

@@ -1,187 +1,187 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "BMAD+ SEO Audit Result",
-  "description": "Standardized JSON format for SEO audit results. Compatible with dashboards, MCP Server, and external tools.",
-  "version": "1.0.0",
-  "author": "Laurent Rochetta",
-  "type": "object",
-  "required": ["engine", "version", "domain", "timestamp", "score", "issues"],
-  "properties": {
-    "engine": {
-      "type": "string",
-      "const": "bmad-seo-engine",
-      "description": "Engine identifier"
-    },
-    "version": {
-      "type": "string",
-      "description": "Engine version",
-      "examples": ["2.1.0"]
-    },
-    "domain": {
-      "type": "string",
-      "description": "Audited domain (without protocol)",
-      "examples": ["example.com"]
-    },
-    "url": {
-      "type": "string",
-      "format": "uri",
-      "description": "Full URL audited"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of audit completion"
-    },
-    "business_type": {
-      "type": "string",
-      "enum": ["saas", "ecommerce", "local", "publisher", "agency", "other"],
-      "description": "Detected business type"
-    },
-    "pages_analyzed": {
-      "type": "integer",
-      "minimum": 1,
-      "description": "Number of pages analyzed"
-    },
-    "score": {
-      "type": "object",
-      "required": ["total", "categories"],
-      "properties": {
-        "total": {
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 100,
-          "description": "Weighted SEO Health Score"
-        },
-        "rating": {
-          "type": "string",
-          "enum": ["excellent", "good", "needs_work", "poor", "critical"],
-          "description": "Score interpretation"
-        },
-        "categories": {
-          "type": "object",
-          "properties": {
-            "technical": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "content_eeat": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "on_page": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "schema": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "performance": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "ai_readiness": { "type": "integer", "minimum": 0, "maximum": 100 },
-            "images": { "type": "integer", "minimum": 0, "maximum": 100 }
-          },
-          "description": "Score per category (0-100)"
-        }
-      }
-    },
-    "issues": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "severity", "category", "title"],
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "Unique issue identifier",
-            "examples": ["missing-meta-description", "multiple-h1"]
-          },
-          "severity": {
-            "type": "string",
-            "enum": ["critical", "high", "medium", "low"]
-          },
-          "category": {
-            "type": "string",
-            "enum": ["technical", "content", "on_page", "schema", "performance", "geo", "images"]
-          },
-          "title": {
-            "type": "string",
-            "description": "Human-readable issue title"
-          },
-          "description": {
-            "type": "string",
-            "description": "Detailed explanation"
-          },
-          "affected_urls": {
-            "type": "array",
-            "items": { "type": "string", "format": "uri" },
-            "description": "Pages affected by this issue"
-          },
-          "fix": {
-            "type": "string",
-            "description": "Auto-generated fix code (HTML, JSON-LD, etc.)"
-          },
-          "quick_win": {
-            "type": "boolean",
-            "description": "True if high impact / low effort"
-          },
-          "impact": {
-            "type": "string",
-            "enum": ["high", "medium", "low"]
-          },
-          "effort": {
-            "type": "string",
-            "enum": ["high", "medium", "low"]
-          }
-        }
-      }
-    },
-    "pages": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "url": { "type": "string", "format": "uri" },
-          "status": { "type": "integer" },
-          "title": { "type": "string" },
-          "word_count": { "type": "integer" },
-          "schema_types": { "type": "array", "items": { "type": "string" } },
-          "eeat_score": { "type": "integer", "minimum": 0, "maximum": 100 }
-        }
-      },
-      "description": "Per-page analysis data"
-    },
-    "geo": {
-      "type": "object",
-      "properties": {
-        "ai_readiness_score": { "type": "integer", "minimum": 0, "maximum": 100 },
-        "ai_crawlers_allowed": { "type": "array", "items": { "type": "string" } },
-        "has_llms_txt": { "type": "boolean" },
-        "citability_score": { "type": "integer", "minimum": 0, "maximum": 100 }
-      },
-      "description": "GEO / AI search readiness metrics"
-    },
-    "pagespeed": {
-      "type": "object",
-      "properties": {
-        "mobile": {
-          "type": "object",
-          "properties": {
-            "performance": { "type": "integer" },
-            "accessibility": { "type": "integer" },
-            "best_practices": { "type": "integer" },
-            "seo": { "type": "integer" }
-          }
-        },
-        "desktop": {
-          "type": "object",
-          "properties": {
-            "performance": { "type": "integer" },
-            "accessibility": { "type": "integer" },
-            "best_practices": { "type": "integer" },
-            "seo": { "type": "integer" }
-          }
-        }
-      },
-      "description": "PageSpeed Insights scores"
-    },
-    "monitoring": {
-      "type": "object",
-      "properties": {
-        "previous_score": { "type": "integer" },
-        "previous_date": { "type": "string", "format": "date" },
-        "delta": { "type": "integer" },
-        "issues_resolved": { "type": "integer" },
-        "issues_new": { "type": "integer" }
-      },
-      "description": "Comparison with previous audit (if available)"
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "BMAD+ SEO Audit Result",
+  "description": "Standardized JSON format for SEO audit results. Compatible with dashboards, MCP Server, and external tools.",
+  "version": "1.0.0",
+  "author": "Laurent Rochetta",
+  "type": "object",
+  "required": ["engine", "version", "domain", "timestamp", "score", "issues"],
+  "properties": {
+    "engine": {
+      "type": "string",
+      "const": "bmad-seo-engine",
+      "description": "Engine identifier"
+    },
+    "version": {
+      "type": "string",
+      "description": "Engine version",
+      "examples": ["2.1.0"]
+    },
+    "domain": {
+      "type": "string",
+      "description": "Audited domain (without protocol)",
+      "examples": ["example.com"]
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Full URL audited"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of audit completion"
+    },
+    "business_type": {
+      "type": "string",
+      "enum": ["saas", "ecommerce", "local", "publisher", "agency", "other"],
+      "description": "Detected business type"
+    },
+    "pages_analyzed": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Number of pages analyzed"
+    },
+    "score": {
+      "type": "object",
+      "required": ["total", "categories"],
+      "properties": {
+        "total": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Weighted SEO Health Score"
+        },
+        "rating": {
+          "type": "string",
+          "enum": ["excellent", "good", "needs_work", "poor", "critical"],
+          "description": "Score interpretation"
+        },
+        "categories": {
+          "type": "object",
+          "properties": {
+            "technical": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "content_eeat": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "on_page": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "schema": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "performance": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "ai_readiness": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "images": { "type": "integer", "minimum": 0, "maximum": 100 }
+          },
+          "description": "Score per category (0-100)"
+        }
+      }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "severity", "category", "title"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique issue identifier",
+            "examples": ["missing-meta-description", "multiple-h1"]
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["critical", "high", "medium", "low"]
+          },
+          "category": {
+            "type": "string",
+            "enum": ["technical", "content", "on_page", "schema", "performance", "geo", "images"]
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable issue title"
+          },
+          "description": {
+            "type": "string",
+            "description": "Detailed explanation"
+          },
+          "affected_urls": {
+            "type": "array",
+            "items": { "type": "string", "format": "uri" },
+            "description": "Pages affected by this issue"
+          },
+          "fix": {
+            "type": "string",
+            "description": "Auto-generated fix code (HTML, JSON-LD, etc.)"
+          },
+          "quick_win": {
+            "type": "boolean",
+            "description": "True if high impact / low effort"
+          },
+          "impact": {
+            "type": "string",
+            "enum": ["high", "medium", "low"]
+          },
+          "effort": {
+            "type": "string",
+            "enum": ["high", "medium", "low"]
+          }
+        }
+      }
+    },
+    "pages": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "format": "uri" },
+          "status": { "type": "integer" },
+          "title": { "type": "string" },
+          "word_count": { "type": "integer" },
+          "schema_types": { "type": "array", "items": { "type": "string" } },
+          "eeat_score": { "type": "integer", "minimum": 0, "maximum": 100 }
+        }
+      },
+      "description": "Per-page analysis data"
+    },
+    "geo": {
+      "type": "object",
+      "properties": {
+        "ai_readiness_score": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "ai_crawlers_allowed": { "type": "array", "items": { "type": "string" } },
+        "has_llms_txt": { "type": "boolean" },
+        "citability_score": { "type": "integer", "minimum": 0, "maximum": 100 }
+      },
+      "description": "GEO / AI search readiness metrics"
+    },
+    "pagespeed": {
+      "type": "object",
+      "properties": {
+        "mobile": {
+          "type": "object",
+          "properties": {
+            "performance": { "type": "integer" },
+            "accessibility": { "type": "integer" },
+            "best_practices": { "type": "integer" },
+            "seo": { "type": "integer" }
+          }
+        },
+        "desktop": {
+          "type": "object",
+          "properties": {
+            "performance": { "type": "integer" },
+            "accessibility": { "type": "integer" },
+            "best_practices": { "type": "integer" },
+            "seo": { "type": "integer" }
+          }
+        }
+      },
+      "description": "PageSpeed Insights scores"
+    },
+    "monitoring": {
+      "type": "object",
+      "properties": {
+        "previous_score": { "type": "integer" },
+        "previous_date": { "type": "string", "format": "date" },
+        "delta": { "type": "integer" },
+        "issues_resolved": { "type": "integer" },
+        "issues_new": { "type": "integer" }
+      },
+      "description": "Comparison with previous audit (if available)"
+    }
+  }
+}

package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md

@@ -1,87 +1,87 @@
-# Core Web Vitals — Thresholds & Optimization Guide (March 2026)
-
-> Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
-
-## Current Metrics
-
-| Metric | Good | Needs Improvement | Poor |
-|--------|------|-------------------|------|
-| **LCP** (Largest Contentful Paint) | ≤2.5s | 2.5–4.0s | >4.0s |
-| **INP** (Interaction to Next Paint) | ≤200ms | 200–500ms | >500ms |
-| **CLS** (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
-
-> **INP replaced FID on March 12, 2024.** FID was fully removed from all Chrome tools on September 9, 2024. Never reference FID.
-
-## Key Facts
-- Evaluation uses the **75th percentile** of real user data (CrUX field data)
-- Assessment at **page level** AND **origin level**
-- CWV is a **tiebreaker** signal — matters most when content quality is similar
-- Thresholds **unchanged since original definitions**
-- December 2025 core update appeared to weight **mobile CWV more heavily**
-- As of October 2025: 57.1% desktop, 49.7% mobile sites pass all three CWV
-- **Mobile-first indexing 100% complete** since July 5, 2024
-
-## LCP Diagnostic Subparts (Feb 2025 CrUX)
-
-| Subpart | Description | Target |
-|---------|-------------|--------|
-| TTFB | Server response time | <800ms |
-| Resource Load Delay | TTFB to resource request | Minimize |
-| Resource Load Time | LCP resource download | Size-dependent |
-| Element Render Delay | Loaded to painted | Minimize |
-
-**Total LCP = TTFB + Load Delay + Load Time + Render Delay**
-
-## Common Bottlenecks
-
-### LCP
-- Unoptimized hero images → use WebP/AVIF, add `<link rel="preload">`
-- Render-blocking CSS/JS → defer, async, critical CSS inline
-- Slow TTFB (>200ms) → CDN, caching, edge compute
-- Third-party blocking → defer analytics, chat widgets
-- Font delay → `font-display: swap` + preload
-
-### INP
-- Long JS tasks on main thread → break tasks <50ms, use `scheduler.yield()`
-- Heavy event handlers → debounce, requestAnimationFrame
-- Excessive DOM (>1,500 elements)
-- Third-party scripts hijacking main thread
-- Layout thrashing (forced reflows)
-
-### CLS
-- Images/iframes without width/height dimensions
-- Dynamic content injected above existing content
-- Font swap causing layout shift → preload + font-display
-- Ads/embeds without reserved space
-
-## Measurement Sources
-
-### Field Data (used for ranking)
-- Chrome User Experience Report (CrUX)
-- PageSpeed Insights (uses CrUX)
-- Search Console Core Web Vitals report
-
-### Lab Data (for debugging)
-- Lighthouse 13.0 (Oct 2025, restructured audits)
-- WebPageTest
-- Chrome DevTools
-
-## Optimization Priority
-1. **LCP** — Most impactful for perceived performance
-2. **CLS** — Most common UX issue
-3. **INP** — Critical for interactive applications
-
-## API Tools
-```bash
-# PageSpeed Insights API
-curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=URL&key=API_KEY"
-
-# Lighthouse CLI
-npx lighthouse URL --output json --output-path report.json
-```
-
-## 2025–2026 Updates
-- **Lighthouse 13.0** (Oct 2025): reorganized performance categories
-- **CrUX Vis** replaced CrUX Dashboard (Nov 2025) → cruxvis.withgoogle.com
-- **LCP subparts** in CrUX (Feb 2025)
-- **Soft Navigations API** (Chrome 139+, July 2025): experimental SPA CWV measurement — no ranking impact yet
+# Core Web Vitals — Thresholds & Optimization Guide (March 2026)
+
+> Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
+
+## Current Metrics
+
+| Metric | Good | Needs Improvement | Poor |
+|--------|------|-------------------|------|
+| **LCP** (Largest Contentful Paint) | ≤2.5s | 2.5–4.0s | >4.0s |
+| **INP** (Interaction to Next Paint) | ≤200ms | 200–500ms | >500ms |
+| **CLS** (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
+
+> **INP replaced FID on March 12, 2024.** FID was fully removed from all Chrome tools on September 9, 2024. Never reference FID.
+
+## Key Facts
+- Evaluation uses the **75th percentile** of real user data (CrUX field data)
+- Assessment at **page level** AND **origin level**
+- CWV is a **tiebreaker** signal — matters most when content quality is similar
+- Thresholds **unchanged since original definitions**
+- December 2025 core update appeared to weight **mobile CWV more heavily**
+- As of October 2025: 57.1% desktop, 49.7% mobile sites pass all three CWV
+- **Mobile-first indexing 100% complete** since July 5, 2024
+
+## LCP Diagnostic Subparts (Feb 2025 CrUX)
+
+| Subpart | Description | Target |
+|---------|-------------|--------|
+| TTFB | Server response time | <800ms |
+| Resource Load Delay | TTFB to resource request | Minimize |
+| Resource Load Time | LCP resource download | Size-dependent |
+| Element Render Delay | Loaded to painted | Minimize |
+
+**Total LCP = TTFB + Load Delay + Load Time + Render Delay**
+
+## Common Bottlenecks
+
+### LCP
+- Unoptimized hero images → use WebP/AVIF, add `<link rel="preload">`
+- Render-blocking CSS/JS → defer, async, critical CSS inline
+- Slow TTFB (>200ms) → CDN, caching, edge compute
+- Third-party blocking → defer analytics, chat widgets
+- Font delay → `font-display: swap` + preload
+
+### INP
+- Long JS tasks on main thread → break tasks <50ms, use `scheduler.yield()`
+- Heavy event handlers → debounce, requestAnimationFrame
+- Excessive DOM (>1,500 elements)
+- Third-party scripts hijacking main thread
+- Layout thrashing (forced reflows)
+
+### CLS
+- Images/iframes without width/height dimensions
+- Dynamic content injected above existing content
+- Font swap causing layout shift → preload + font-display
+- Ads/embeds without reserved space
+
+## Measurement Sources
+
+### Field Data (used for ranking)
+- Chrome User Experience Report (CrUX)
+- PageSpeed Insights (uses CrUX)
+- Search Console Core Web Vitals report
+
+### Lab Data (for debugging)
+- Lighthouse 13.0 (Oct 2025, restructured audits)
+- WebPageTest
+- Chrome DevTools
+
+## Optimization Priority
+1. **LCP** — Most impactful for perceived performance
+2. **CLS** — Most common UX issue
+3. **INP** — Critical for interactive applications
+
+## API Tools
+```bash
+# PageSpeed Insights API
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=URL&key=API_KEY"
+
+# Lighthouse CLI
+npx lighthouse URL --output json --output-path report.json
+```
+
+## 2025–2026 Updates
+- **Lighthouse 13.0** (Oct 2025): reorganized performance categories
+- **CrUX Vis** replaced CrUX Dashboard (Nov 2025) → cruxvis.withgoogle.com
+- **LCP subparts** in CrUX (Feb 2025)
+- **Soft Navigations API** (Chrome 139+, July 2025): experimental SPA CWV measurement — no ranking impact yet