bmad-plus 0.7.5 → 0.8.0

package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md

@@ -0,0 +1,91 @@
+# Schema.org — Type Catalog & Deprecation Status (March 2026)
+
+> Author: Laurent Rochetta | BMAD+ SEO Engine v2.0 | Schema.org v29.4
+
+## Format: Always JSON-LD
+`<script type="application/ld+json">` — Google's explicit recommendation.
+Content with schema has ~2.5× higher AI citation probability (Google/Microsoft, March 2025).
+
+## Active — Recommend Freely
+
+| Type | Use Case | Key Properties |
+|------|----------|----------------|
+| Organization | Company/brand | name, url, logo, contactPoint, sameAs |
+| LocalBusiness | Physical location | name, address, telephone, openingHours, geo, priceRange |
+| SoftwareApplication | Apps | name, operatingSystem, applicationCategory, offers |
+| WebApplication | SaaS | name, applicationCategory, offers, featureList |
+| Product | Products | name, image, description, sku, brand, offers, review |
+| ProductGroup | Variants | name, productGroupID, variesBy, hasVariant |
+| Offer | Pricing | price, priceCurrency, availability, url |
+| Service | Services | name, provider, areaServed, description, offers |
+| Article | Articles | headline, author, datePublished, dateModified, image, publisher |
+| BlogPosting | Blog content | Same as Article + blog context |
+| NewsArticle | News | Same as Article + news context |
+| Review | Reviews | reviewRating, author, itemReviewed, reviewBody |
+| AggregateRating | Ratings | ratingValue, reviewCount, bestRating |
+| BreadcrumbList | Navigation | itemListElement with position, name, item |
+| WebSite | Site-level | name, url, potentialAction (SearchAction) |
+| WebPage | Page-level | name, description, datePublished, dateModified |
+| Person | Authors/team | name, jobTitle, url, sameAs, image, worksFor |
+| ProfilePage | Profiles | mainEntity (Person), name, sameAs |
+| ContactPage | Contact | name, url |
+| VideoObject | Video | name, description, thumbnailUrl, uploadDate, duration |
+| ImageObject | Images | contentUrl, caption, creator |
+| Event | Events | name, startDate, endDate, location, organizer |
+| JobPosting | Jobs | title, description, datePosted, hiringOrganization |
+| Course | Education | name, description, provider, hasCourseInstance |
+| DiscussionForumPosting | Forums | headline, author, datePublished, text |
+| Certification | Certifications | certificationIdentification, issuedBy (April 2025) |
+| BroadcastEvent | Live streams | isLiveBroadcast, startDate, endDate |
+| Clip | Video chapters | name, startOffset, endOffset, url |
+| SeekToAction | Video seek | target with timestamp parameter |
+| SoftwareSourceCode | Repos | codeRepository, programmingLanguage, license |
+
+## Restricted — Specific Sites Only
+
+| Type | Restriction | Since |
+|------|------------|-------|
+| FAQPage | Government & healthcare ONLY | Aug 2023 |
+
+> FAQPage still benefits AI/LLM citation (ChatGPT, Perplexity) even without Google rich results. Existing FAQPage on commercial sites: Info priority, not Critical.
+
+## Deprecated — NEVER Recommend
+
+| Type | Since | Notes |
+|------|-------|-------|
+| HowTo | Sept 2023 | Rich results fully removed |
+| SpecialAnnouncement | July 2025 | COVID-era, no longer processed |
+| CourseInfo | June 2025 | Merged into Course |
+| EstimatedSalary | June 2025 | No longer displayed |
+| LearningVideo | June 2025 | Use VideoObject instead |
+| ClaimReview | June 2025 | Fact-check markup discontinued |
+| VehicleListing | June 2025 | Vehicle listings discontinued |
+| Practice Problem | Late 2025 | Educational problems discontinued |
+| Dataset | Late 2025 | Dataset Search discontinued |
+
+## Recent Additions (2024–2026)
+
+| Feature | When | Notes |
+|---------|------|-------|
+| Product Certification | April 2025 | Replaces EnergyConsumptionDetails |
+| ProductGroup | 2025 | E-commerce variants |
+| ProfilePage | 2025 | E-E-A-T author pages |
+| DiscussionForumPosting | 2024 | Forum content |
+| LoyaltyProgram | June 2025 | Member pricing |
+| ConferenceEvent | Dec 2025 | Schema.org v29.4 |
+| PerformingArtsEvent | Dec 2025 | Schema.org v29.4 |
+
+## Validation Checklist
+1. ✅ `@context` = `"https://schema.org"` (not http)
+2. ✅ `@type` valid + non-deprecated
+3. ✅ Required properties present
+4. ✅ Correct data types
+5. ✅ No placeholder text
+6. ✅ Absolute URLs only
+7. ✅ ISO 8601 dates
+8. ✅ Valid image URLs
+
+## E-Commerce Notes
+- `returnPolicyCountry` required in MerchantReturnPolicy (March 2025)
+- Content API for Shopping sunsets August 18, 2026 → migrate to Merchant API
+- JS-injected Product schema may face delayed processing → include in server HTML

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

@@ -0,0 +1,356 @@
+{
+  "meta": {
+    "author": "Laurent Rochetta",
+    "engine": "BMAD+ SEO Engine v2.0",
+    "schema_org_version": "29.4",
+    "last_updated": "2026-03-19"
+  },
+  "templates": [
+    {
+      "type": "Organization",
+      "use_case": "Company/brand homepage",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Organization",
+        "name": "[Company Name]",
+        "url": "[Website URL]",
+        "logo": "[Logo URL]",
+        "description": "[Company description]",
+        "foundingDate": "[YYYY]",
+        "contactPoint": {
+          "@type": "ContactPoint",
+          "telephone": "[Phone]",
+          "contactType": "customer service",
+          "availableLanguage": ["English", "French"]
+        },
+        "sameAs": [
+          "[Facebook URL]",
+          "[LinkedIn URL]",
+          "[Twitter URL]",
+          "[YouTube URL]"
+        ]
+      }
+    },
+    {
+      "type": "LocalBusiness",
+      "use_case": "Physical business location",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "LocalBusiness",
+        "name": "[Business Name]",
+        "url": "[Website URL]",
+        "image": "[Photo URL]",
+        "telephone": "[Phone]",
+        "priceRange": "[$$]",
+        "address": {
+          "@type": "PostalAddress",
+          "streetAddress": "[Street]",
+          "addressLocality": "[City]",
+          "addressRegion": "[State/Region]",
+          "postalCode": "[ZIP]",
+          "addressCountry": "[Country Code]"
+        },
+        "geo": {
+          "@type": "GeoCoordinates",
+          "latitude": "[Lat]",
+          "longitude": "[Long]"
+        },
+        "openingHoursSpecification": [
+          {
+            "@type": "OpeningHoursSpecification",
+            "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
+            "opens": "09:00",
+            "closes": "18:00"
+          }
+        ]
+      }
+    },
+    {
+      "type": "Article",
+      "use_case": "Blog posts, articles",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        "headline": "[Title - max 110 chars]",
+        "description": "[Summary]",
+        "author": {
+          "@type": "Person",
+          "name": "[Author Name]",
+          "url": "[Author Profile URL]"
+        },
+        "datePublished": "[YYYY-MM-DD]",
+        "dateModified": "[YYYY-MM-DD]",
+        "image": "[Featured Image URL]",
+        "publisher": {
+          "@type": "Organization",
+          "name": "[Publisher Name]",
+          "logo": {
+            "@type": "ImageObject",
+            "url": "[Logo URL]"
+          }
+        },
+        "mainEntityOfPage": {
+          "@type": "WebPage",
+          "@id": "[Page URL]"
+        }
+      }
+    },
+    {
+      "type": "Product",
+      "use_case": "E-commerce product pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Product",
+        "name": "[Product Name]",
+        "image": "[Product Image URL]",
+        "description": "[Product Description]",
+        "sku": "[SKU]",
+        "brand": {
+          "@type": "Brand",
+          "name": "[Brand Name]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "url": "[Product URL]",
+          "price": "[Price]",
+          "priceCurrency": "[Currency Code]",
+          "availability": "https://schema.org/InStock",
+          "seller": {
+            "@type": "Organization",
+            "name": "[Seller Name]"
+          }
+        },
+        "aggregateRating": {
+          "@type": "AggregateRating",
+          "ratingValue": "[4.5]",
+          "reviewCount": "[120]"
+        }
+      }
+    },
+    {
+      "type": "WebSite",
+      "use_case": "Site-level with sitelinks search box",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "WebSite",
+        "name": "[Site Name]",
+        "url": "[Homepage URL]",
+        "potentialAction": {
+          "@type": "SearchAction",
+          "target": {
+            "@type": "EntryPoint",
+            "urlTemplate": "[Search URL]?q={search_term_string}"
+          },
+          "query-input": "required name=search_term_string"
+        }
+      }
+    },
+    {
+      "type": "BreadcrumbList",
+      "use_case": "Navigation breadcrumbs",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": [
+          {
+            "@type": "ListItem",
+            "position": 1,
+            "name": "Home",
+            "item": "[Homepage URL]"
+          },
+          {
+            "@type": "ListItem",
+            "position": 2,
+            "name": "[Category]",
+            "item": "[Category URL]"
+          },
+          {
+            "@type": "ListItem",
+            "position": 3,
+            "name": "[Current Page]"
+          }
+        ]
+      }
+    },
+    {
+      "type": "Person",
+      "use_case": "Author/team member profiles (E-E-A-T)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Person",
+        "name": "[Full Name]",
+        "jobTitle": "[Job Title]",
+        "url": "[Profile URL]",
+        "image": "[Photo URL]",
+        "description": "[Professional bio]",
+        "worksFor": {
+          "@type": "Organization",
+          "name": "[Company Name]"
+        },
+        "sameAs": [
+          "[LinkedIn URL]",
+          "[Twitter URL]",
+          "[GitHub URL]"
+        ]
+      }
+    },
+    {
+      "type": "Service",
+      "use_case": "Service business pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Service",
+        "name": "[Service Name]",
+        "description": "[Service Description]",
+        "provider": {
+          "@type": "Organization",
+          "name": "[Provider Name]",
+          "url": "[Provider URL]"
+        },
+        "areaServed": {
+          "@type": "City",
+          "name": "[Service Area]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "price": "[Starting Price]",
+          "priceCurrency": "[Currency]"
+        }
+      }
+    },
+    {
+      "type": "VideoObject",
+      "use_case": "Video content pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "VideoObject",
+        "name": "[Video Title]",
+        "description": "[Video Description]",
+        "thumbnailUrl": "[Thumbnail URL]",
+        "uploadDate": "[YYYY-MM-DD]",
+        "duration": "[PT1H30M]",
+        "contentUrl": "[Video File URL]",
+        "embedUrl": "[Embed URL]",
+        "publisher": {
+          "@type": "Organization",
+          "name": "[Publisher]"
+        }
+      }
+    },
+    {
+      "type": "Event",
+      "use_case": "Events and conferences",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Event",
+        "name": "[Event Name]",
+        "description": "[Event Description]",
+        "startDate": "[YYYY-MM-DDTHH:MM]",
+        "endDate": "[YYYY-MM-DDTHH:MM]",
+        "location": {
+          "@type": "Place",
+          "name": "[Venue Name]",
+          "address": {
+            "@type": "PostalAddress",
+            "streetAddress": "[Street]",
+            "addressLocality": "[City]",
+            "addressCountry": "[Country]"
+          }
+        },
+        "organizer": {
+          "@type": "Organization",
+          "name": "[Organizer Name]",
+          "url": "[Organizer URL]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "price": "[Price]",
+          "priceCurrency": "[Currency]",
+          "url": "[Ticket URL]",
+          "availability": "https://schema.org/InStock"
+        }
+      }
+    },
+    {
+      "type": "SoftwareApplication",
+      "use_case": "SaaS and app pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "SoftwareApplication",
+        "name": "[App Name]",
+        "description": "[App Description]",
+        "applicationCategory": "[Category]",
+        "operatingSystem": "[OS]",
+        "offers": {
+          "@type": "Offer",
+          "price": "[Price or 0]",
+          "priceCurrency": "[Currency]"
+        },
+        "aggregateRating": {
+          "@type": "AggregateRating",
+          "ratingValue": "[Rating]",
+          "ratingCount": "[Count]"
+        }
+      }
+    },
+    {
+      "type": "ProfilePage",
+      "use_case": "Author/creator profile pages (E-E-A-T)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "ProfilePage",
+        "mainEntity": {
+          "@type": "Person",
+          "name": "[Author Name]",
+          "url": "[Profile URL]",
+          "description": "[Bio and expertise]",
+          "sameAs": ["[LinkedIn]", "[Twitter]"]
+        }
+      }
+    },
+    {
+      "type": "ProductGroup",
+      "use_case": "E-commerce product variants",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "ProductGroup",
+        "name": "[Product Name]",
+        "description": "[Group description]",
+        "productGroupID": "[Group ID]",
+        "variesBy": ["https://schema.org/size", "https://schema.org/color"],
+        "hasVariant": [
+          {
+            "@type": "Product",
+            "name": "[Variant Name]",
+            "sku": "[SKU]",
+            "color": "[Color]",
+            "size": "[Size]",
+            "offers": {
+              "@type": "Offer",
+              "price": "[Price]",
+              "priceCurrency": "[Currency]",
+              "availability": "https://schema.org/InStock"
+            }
+          }
+        ]
+      }
+    },
+    {
+      "type": "Certification",
+      "use_case": "Product certifications (April 2025)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Product",
+        "name": "[Product Name]",
+        "hasCertification": {
+          "@type": "Certification",
+          "certificationIdentification": "[Certification Name]",
+          "issuedBy": {
+            "@type": "Organization",
+            "name": "[Issuing Organization]"
+          }
+        }
+      }
+    }
+  ]
+}