@softspark/ai-toolkit 4.2.2 → 4.2.4

package/CHANGELOG.md

@@ -7,6 +7,36 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v4.2.4 - GitHub Actions Node 24 readiness (2026-05-12)
+
+Patch release. Removes GitHub Actions Node 20 action-runtime deprecation warnings from CI, publish, and reusable action surfaces.
+
+### Changed
+
+- **GitHub Actions runtime** - Updated `actions/setup-node` from `v4` to `v6` in CI, publish, and reusable composite action workflows.
+- **Generated CI guidance** - Refreshed CI templates, CI/CD skill examples, Docker DevOps examples, and LLM index output to use current GitHub Actions action versions.
+
+### Verification
+
+- Source checked against the official [`actions/setup-node` documentation](https://github.com/actions/setup-node), which documents `v6` usage and Node 24 action runtime support.
+
+---
+
+## 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.4
 
-Patch release focused on cleaning legacy hook duplicates found during post-release verification.
+Patch release removing Node 20 action-runtime warnings from GitHub Actions.
 
-- **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.
+- **CI action runtime**: `ci.yml`, `publish.yml`, and the reusable `action.yml` now use `actions/setup-node@v6`.
+- **Generated guidance**: CI templates and CI/CD skill examples now use current GitHub Actions versions.
+- **Release readiness**: the next publish run executes on the Node 24-compatible action runtime.
 
 See [CHANGELOG.md](CHANGELOG.md) for full history.
 

package/action.yml

@@ -28,7 +28,7 @@ runs:
   using: 'composite'
   steps:
     - name: Setup Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v6
       with:
         node-version: ${{ inputs.node-version }}
 

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.4",
   "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/app/skills/ci/SKILL.md

@@ -88,7 +88,7 @@ Use `ci-cd-patterns` skill for pipeline templates and best practices.
 - GitHub Actions YAML parses `on:` as a reserved word only when unquoted. Writing `"on":` (quoted) produces a valid-looking file whose workflow **never triggers**. YAML anchors in this field also silently break.
 - GitLab CI's `rules:` and `only:/except:` are mutually exclusive at the job level. Mixing them fails parse on pipeline run but not at `git push` time — test with `gitlab-ci-lint` before committing.
 - `secrets.*` in GitHub Actions is undefined in workflows triggered from **forked** PRs (security boundary). Jobs that need secrets must gate on `github.event.pull_request.head.repo.full_name == github.repository` or use `pull_request_target` carefully.
-- `actions/checkout@v4` defaults to `fetch-depth: 1` (shallow). Commands that need history (`git log`, `git describe`, conventional-commit tools) fail with misleading errors — set `fetch-depth: 0` for those jobs.
+- `actions/checkout@v6` defaults to `fetch-depth: 1` (shallow). Commands that need history (`git log`, `git describe`, conventional-commit tools) fail with misleading errors — set `fetch-depth: 0` for those jobs.
 
 ## When NOT to Use
 

package/app/skills/ci/templates/github-actions-node.yml

@@ -14,10 +14,10 @@ jobs:
         node-version: [18, 20, 22]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: 'npm'

package/app/skills/ci/templates/github-actions-python.yml

@@ -14,7 +14,7 @@ jobs:
         python-version: ["3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5

package/app/skills/ci-cd-patterns/SKILL.md

@@ -23,8 +23,8 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: "npm"
@@ -39,8 +39,8 @@ jobs:
       matrix:
         node-version: [18, 20, 22]
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: "npm"
@@ -55,8 +55,8 @@ jobs:
     runs-on: ubuntu-latest
     needs: test
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: "npm"
@@ -73,7 +73,7 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
@@ -90,7 +90,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: test
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: docker/setup-buildx-action@v3
       - uses: docker/login-action@v3
         with:

package/app/skills/csharp-patterns/SKILL.md

@@ -417,7 +417,7 @@ dotnet_diagnostic.CA1848.severity = warning
 ### CI (GitHub Actions)
 ```yaml
 steps:
-  - uses: actions/checkout@v4
+  - uses: actions/checkout@v6
   - uses: actions/setup-dotnet@v4
     with: { dotnet-version: '9.0.x' }
   - run: dotnet restore

package/app/skills/docker-devops/SKILL.md

@@ -157,8 +157,8 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'npm'
@@ -172,7 +172,7 @@ jobs:
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Deploy to production
         run: |
           # Deploy commands
@@ -192,7 +192,7 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'

package/kb/procedures/ecosystem-sync-sop.md

@@ -231,7 +231,7 @@ jobs:
   doctor:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - run: python3 scripts/ecosystem_doctor.py --format text | tee /tmp/doctor.txt
       - run: python3 scripts/ecosystem_doctor.py --check
 ```

package/kb/reference/ci-integration.md

@@ -25,7 +25,7 @@ jobs:
   validate:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: softspark/ai-toolkit@v1
         with:
           command: validate
@@ -50,7 +50,7 @@ jobs:
 For simpler setups without the action:
 
 ```yaml
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 20
       - run: npx @softspark/ai-toolkit validate

package/llms-full.txt

@@ -4372,7 +4372,7 @@ jobs:
   doctor:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - run: python3 scripts/ecosystem_doctor.py --format text | tee /tmp/doctor.txt
       - run: python3 scripts/ecosystem_doctor.py --check
 ```
@@ -6534,7 +6534,7 @@ jobs:
   validate:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: softspark/ai-toolkit@v1
         with:
           command: validate
@@ -6559,7 +6559,7 @@ jobs:
 For simpler setups without the action:
 
 ```yaml
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 20
       - run: npx @softspark/ai-toolkit validate

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.2.2",
+  "version": "4.2.4",
   "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.4",
   "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",