v2.0.0 — 55-item BotVisibility Checklist with byte-for-byte parity to the npm scanner

BotVisibility for WordPress v2.0.0

Major release aligning with botvisibility npm v2.0.0. The plugin now scans your WordPress site against the
full 55-item BotVisibility Checklist across 5 levels, with byte-for-byte parity to the npm scanner — plus seven Agent-Native checks verified
from inside WordPress that the external scanner can't see.

What's new

🎯 Level 4: Indexable (NEW — 12 checks)

Twelve checks that determine whether AI search systems (Google AI Overviews, ChatGPT browse, Perplexity, etc.) can find, index, and ground answers in
your site:

Googlebot Allowed · Google-Extended Policy · Homepage Indexable · Sitemap Present · HTTPS · Mobile Viewport · JSON-LD Present · Entity Schema · Canonical
URL · Heading Hierarchy · Image Alt Coverage · Substantive Content

Every check mirrors the npm scanner's rules exactly.

🤖 Level 5: Agent-Native via inside-WP introspection (7 checks)

The npm scanner marks these "CLI-only" because they need source-code or auth access. The WP plugin runs inside WordPress, so it natively verifies them
by probing REST routes, database tables, filter hooks, and running synthetic dry-run dispatches against its own intent endpoints:

Intent-Based Endpoints · Agent Sessions · Scoped Agent Tokens · Agent Audit Logs · Sandbox Environment · Consequence Labels · Native Tool Schemas

🤝 SEO plugin coexistence

Detects Yoast, Rank Math, All in One SEO, and SEOPress. When any of these are active, BotVisibility automatically defers canonical,
sitemap, and Organization JSON-LD generation to them — no duplicate output, no conflicts.

🛠️ Five new one-click L4 fixers

• User-agent: Google-Extended block injected into robots.txt
• Virtual /sitemap.xml → 301 redirect to detected sitemap (wp-sitemap.xml or your SEO plugin's)
• Opt-in mobile viewport fallback (when your theme doesn't emit one)
• Organization JSON-LD on the homepage
• Self-referential homepage canonical

🔌 Platform integration

• Public REST endpoints: GET /wp-json/botvisibility/v1/score and /self-report — npm-compatible JSON shape, cached 1 hour
• WP Site Health: 4 critical/recommended checks surface in Tools → Site Health
• WP-CLI: wp botvis {scan,status,fix,self-report,migrate}
• Public badge block: drop a "BotVisibility Level N" badge anywhere on your site
• Media Library alt-coverage tool under Tools → BotVisibility Alt
• Opt-in per-page audit: run the 12 L4 checks against your N most-recent posts (informational, doesn't affect score)

🎨 Dashboard refresh

Sticky header with score chips per level, filterable 55-row check list with per-row Fix / Defer-to-SEO / Docs actions, five-tab settings page aligned to
levels (General / Discoverability / Indexable / Agent-Native / Advanced), and a "Fix all available" CTA with a one-time level-up confetti burst.

🩹 Loopback hardening

For hosts where the WP server can't reach its own public URL (hairpin NAT, Docker hostnames, restrictive reverse proxies), a new Site Origin Override
option in Settings → Advanced lets you point the scanner at an internally-reachable URL. L4 fail messages now include the actual loopback error and link
to the override.

⚠ Breaking changes (read before upgrading)

1. Agent-Native checks renumbered from Level 4 to Level 5. Scoring expanded from 4 to 5 levels. Stored scan results from v1.x are automatically
   invalidated on upgrade — the next admin pageload or scheduled scan repopulates with v2.0 IDs. A one-time admin notice prompts re-scan.
2. BotVisibility_Scoring::get_agent_native_status() removed. L5 results now surface as standard level_progress[5] data. If you've extended the
   plugin with code that called this method, read $level_progress[5]['passed'] and ['total'] directly.
3. Five new option keys added via idempotent merge on plugins_loaded@4: _schema_version, seo_compat_mode, inject_viewport_fallback,
   entity_schema_same_as, sitemap_redirect_target, site_origin_override. The agent_features option promotes from empty array to a keyed dict of
   feature flags.

✅ Verified

• 197 PHPUnit tests (1308 assertions), all green, against WordPress 6.4 + PHP 8.0 via wp-env
• L1–L4 logic mirrors npm scanner.ts byte-for-byte (parity test available with BOTVIS_PARITY=1)
• L5 introspection probes real WP infrastructure surfaces (REST routes, custom tables, registered filters) — not regex over source

Install / upgrade

Fresh install: download the release zip, upload via Plugins → Add New, activate.

Upgrade from v1.x: plugin update flow works as normal. The migration runs automatically on the first admin pageload after upgrade. You'll see a
one-time notice prompting a re-scan.

SEO plugin users: no action required — detect-and-defer is automatic.

Behind a reverse proxy / hairpin NAT: if scans fail with "Could not fetch homepage", set the Site Origin Override in Settings → Advanced.

Documentation

• Full changelog: CHANGELOG.md
• 55-item checklist reference: botvisibility.com
• npm scanner: botvisibility@2.0.0

Credits

Designed and built to mirror the canonical npm botvisibility scanner. Major thanks to the agent-native ecosystem standards that informed the checklist
(llms.txt, agent cards, x402, MCP, RFC 9728, RFC 9727, Content-Signals, WebMCP).

v1.0.0 — Full 37-Item AI Agent Readiness Checklist

BotVisibility for WordPress v1.0.0

The first public release of the BotVisibility WordPress plugin — scan your site for AI agent readiness and fix
what's missing with one click.

What's Included

4-Level Scoring System (37 checks)

• Level 1: Discoverable (14 checks) — llms.txt, agent cards, OpenAPI spec, AI meta tags, MCP server, and more
• Level 2: Usable (9 checks) — API operations, authentication, structured errors, idempotency
• Level 3: Optimized (7 checks) — sparse fields, cursor pagination, bulk operations, caching
• Level 4: Agent-Native (7 checks) — intent endpoints, agent sessions, scoped tokens, audit logs, sandbox
  mode, consequence labels, tool schemas

Features

• Automated scanning with weekly auto-scan and email alerts
• One-click fixes for discovery files and REST API enhancements
• Discovery file generation — llms.txt, agent-card.json, ai.json, skill.md, skills-index.json, openapi.json,
  mcp.json
• Agent-Native infrastructure — opt-in REST endpoints for sessions, scoped tokens, audit logging, dry-run
  mode, and tool schema generation (OpenAI + Anthropic formats)
• Detect-and-defer — never overwrites existing capabilities from other plugins
• Dark-themed admin dashboard with progress bars, confetti on level-up, and detailed check cards

Requirements

• WordPress 6.0+
• PHP 7.4+

For Contributors

• Full PHPUnit test suite (104 tests, all passing)
• Docker-based test environment via wp-env
• See CONTRIBUTING.md for setup instructions