@softspark/ai-toolkit 4.2.2 → 4.2.3

package/CHANGELOG.md

@@ -7,6 +7,21 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v4.2.3 - SEO FAQ rich results deprecation (2026-05-12)
+
+Patch release. Updates `seo-specialist` guidance after Google deprecated FAQ rich results.
+
+### Changed
+
+- **SEO structured data guidance** - `seo-specialist` now treats `FAQPage` as deprecated for Google rich results and recommends keeping it only when explicitly targeting non-Google engines.
+- **Citability schema checklist** - Prioritizes `Article`, `HowTo`, `QAPage`, and `Person` schema guidance for Google-facing SEO/GEO work.
+
+### Verification
+
+- Source checked against [Google Search Central `FAQPage` structured data documentation](https://developers.google.com/search/docs/appearance/structured-data/faqpage).
+
+---
+
 ## v4.2.2 - Legacy hook duplicate cleanup (2026-05-12)
 
 Patch release. Cleans up legacy untagged hook duplicates found during post-release verification of v4.2.1.

package/README.md

@@ -8,13 +8,13 @@
 [![Agents](https://img.shields.io/badge/agents-44-blue)](app/agents/)
 [![Tests](https://img.shields.io/badge/tests-1051%20passing-success)](tests/)
 
-## What's New in v4.2.2
+## What's New in v4.2.3
 
-Patch release focused on cleaning legacy hook duplicates found during post-release verification.
+Patch release updating SEO guidance after Google's FAQ rich result deprecation.
 
-- **Legacy notification cleanup**: `merge-hooks.py` now removes old direct `osascript` notification hooks from pre-script installs.
-- **External hook cleanup**: `inject-hook` now removes legacy untagged duplicates that match the re-injected external hook payload.
-- **Regression coverage**: added tests for both cleanup paths so repeated updates keep hook settings idempotent.
+- **SEO agent guidance**: `seo-specialist` now treats `FAQPage` as deprecated for Google rich results.
+- **Schema recommendations**: citability guidance now prioritizes `Article`, `HowTo`, `QAPage`, and `Person` for Google-facing surfaces.
+- **GEO audit checklist**: FAQ markup is now scoped to non-Google engines instead of recommended as a default.
 
 See [CHANGELOG.md](CHANGELOG.md) for full history.
 

package/app/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-toolkit",
   "description": "Professional-grade Claude Code toolkit with persona presets, skill security auditor, expanded lifecycle hooks, experimental opt-in plugin packs, benchmark harvesting, and multi-tool support.",
-  "version": "4.2.2",
+  "version": "4.2.3",
   "author": {
     "name": "SoftSpark",
     "url": "https://github.com/softspark"

package/app/agents/seo-specialist.md

@@ -39,7 +39,7 @@ Optimization for both classical search engines AND generative engines (ChatGPT,
 
 ### Structured Data
 - Schema.org markup
-- Rich snippets
+- Rich snippets (note: Google dropped FAQ rich results on May 7, 2026; Search Console API support removed August 2026)
 - Knowledge graph
 - Breadcrumbs
 
@@ -157,7 +157,7 @@ Goal: get cited by ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews
 5. **Named author + author bio with credentials.** Authority signal that survives synthesis.
 6. **Original quotes from named experts.** Quotation blocks are over-represented in LLM citations.
 7. **Comparison tables with explicit labels.** Tables are extracted whole; vague prose is summarised away.
-8. **Schema.org `Article`, `FAQPage`, `HowTo`, `QAPage`, `Person`.** Mandatory for entity disambiguation.
+8. **Schema.org `Article`, `HowTo`, `QAPage`, `Person`.** Mandatory for entity disambiguation. `FAQPage` schema: Google dropped FAQ rich results on **May 7, 2026** (Search Console API removed August 2026) — keep markup only if targeting other engines (Bing, etc.).
 9. **`llms.txt` at site root.** Curated index of canonical pages for LLM crawlers (Anthropic-proposed convention).
 10. **Stable URLs with semantic slugs.** LLMs cache citations — URL changes erase your authority overnight.
 11. **Cross-linking with descriptive anchors.** "this article" is dead anchor text; use the actual claim.
@@ -189,7 +189,7 @@ Goal: get cited by ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews
 - [ ] At least one comparison table OR numbered list per long-form page
 - [ ] Author block with real name (not "Admin"), role, and ≥30 words of bio
 - [ ] Schema.org `Article` with `author` (`Person` + `sameAs`), `datePublished`, `dateModified`
-- [ ] Schema.org `FAQPage` for any page with Q/A structure
+  - [ ] ~~Schema.org `FAQPage`~~ — Google dropped FAQ rich results on **May 7, 2026**; Search Console reporting ends June 2026, API removed August 2026. Remove or keep only if targeting non-Google engines.
 - [ ] `dateModified` updated AND visible "Updated: [date]" text present
 - [ ] `llms.txt` at site root with curated canonical URLs
 - [ ] Page contains at least 3 unique data points (numbers, dates, version strings)

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.2.2",
+  "version": "4.2.3",
   "components": {
     "agents": {
       "description": "44 specialized agents (orchestrator, backend, frontend, security, devops, etc.)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/ai-toolkit",
-  "version": "4.2.2",
+  "version": "4.2.3",
   "description": "AI coding toolkit: 107 skills, 44 agents, 12-editor write-through (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo, Aider, Augment, Antigravity, Codex, opencode), machine-enforced safety constitution, SARIF audit, signed npm provenance.",
   "keywords": [
     "claude",