=== Dante GEO Shield ===
Contributors: danteix
Donate link: https://danteix.com
Tags: ai-crawler, robots-txt, webmcp, schema-jsonld, geo
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 15.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI Bot Firewall (Search vs. Training robots.txt), live AI Crawler Radar, Site Health audit, WebMCP, ARD v0.91, Brand Facts JSON-LD & /llms.txt.

== Description ==

**Dante GEO Shield is a standalone Web Governance, AI Bot Firewall, and Agentic Browsing Suite for WordPress—100% functional locally with zero external account required.**

While basic plugins only print a static `/llms.txt` text file, **Dante GEO Shield** gives site owners granular control over how AI Search and Model Training crawlers access, verify, and interact with their WordPress site:

1. **AI Bot Firewall (`Search` vs. `Training` in `robots.txt`)**:
   Set per-bot `Allow` or `Disallow: /` policies across 10 major AI crawlers grouped into **AI Citation Search** (`OAI-SearchBot`, `ChatGPT-User`, `PerplexityBot`, `Claude-Web`) and **AI Model Training** (`GPTBot`, `ClaudeBot`, `Google-Extended`, `Applebot-Extended`, `Bytespider`, `Amazonbot`), including a 1-click **"Allow AI Citation Search · Block Model Training"** preset.
2. **100% Local AI Crawler Radar & Top Crawled URLs**:
   Track real-time hits from AI crawlers separated by Search vs. Training traffic, inspect the **Top 10 AI-Crawled URLs**, and view recent crawl timestamps inside a strictly bounded FIFO ring-buffer (`<= 500` events / `<= 256 KB`) with a 1-click log reset.
3. **WordPress Site Health Integration (`Tools -> Site Health`)**:
   Registers a native `dante_geo_agentic_readiness` health check verifying search visibility (`blog_public`), Search-vs-Training firewall posture, ARD v0.91 and `/llms.txt` discovery, WebMCP form readiness, and SEO plugin coexistence.
4. **Local Brand Facts & Counter-Hallucination JSON-LD Builder (`Organization` + `FAQPage`)**:
   Declare your official brand summary, verified pricing truth, canonical pricing/contact URL, and up to 5 verified Q&A pairs locally in `wp-admin`. Automatically emitted into `Schema.org JSON-LD (@graph)` (escaped safely via `wp_print_inline_script_tag()` and `JSON_HEX_TAG`) and `/llms.txt`.
5. **Agentic Resource Discovery (ARD v0.91) & W3C WebMCP Forms**:
   Publishes `/.well-known/ard.json` (`/?dante_ard=1` fallback) and annotates WordPress search forms (`get_search_form`) with `toolname` / `tooldescription` WebMCP attributes for modern agentic browsing audits.
6. **Live Agentic Inspector & Peaceful SEO Coexistence**:
   Preview live `/llms.txt`, `/.well-known/ard.json`, compiled `robots.txt` rules, and escaped `Schema.org JSON-LD` directly inside **Settings -> Dante GEO Shield**. Automatically detects Yoast SEO, Rank Math, AIOSEO, SEOPress, and WooCommerce without duplicating `<title>` or `<meta>` tags.
7. **Optional Dante IX Cloud Sync (Explicit Admin Opt-In Only)**:
   By default, zero external HTTP requests are made. Administrators can optionally opt in to connect `https://danteix.com` for multi-model Share of Model (`SoM`) audits and synchronized schema defense.

== External Services Disclosure (WordPress.org Guideline 6 & 7) ==

By default, **Dante GEO Shield operates 100% locally** on your installation and transmits **zero** data to any external server.

When an administrator explicitly clicks **"Connect Free Cloud Preview & Audit My Brand Visibility (Opt-In)"** or **"Save Key & Sync Shield Now"** inside **Settings -> Dante GEO Shield -> 4. Dante IX Cloud (Opt-In)**, the plugin communicates with the **Dante IX Cloud API** (`https://danteix.com/api/wp-plugin/v1/register` and `https://danteix.com/api/wp-plugin/v1/sync`) to:
* Register your domain and retrieve your Share of Model (`SoM`) benchmark.
* Download your cryptographically signed `/llms.txt` and `Schema.org JSON-LD` counterweight graph.
* Service Provider: Dante IX (`https://danteix.com`)
* Terms of Service: `https://danteix.com/terms`
* Privacy Policy: `https://danteix.com/privacy`

== Installation ==

1. Upload the `dante-geo-shield` folder to `/wp-content/plugins/` or upload `dante-geo-shield.zip` via **Plugins -> Add New -> Upload Plugin**.
2. Activate the plugin through the **Plugins** menu.
3. Visit **Settings -> Dante GEO Shield** to configure your **AI Bot Firewall** (`Search` vs. `Training`), declare **Local Brand Facts & FAQs**, inspect live outputs in **Live Agentic Inspector**, or view **Tools -> Site Health**.

== Frequently Asked Questions ==

= Does this plugin require a Dante IX account to work? =
No. All AI Bot Firewall rules (`robots.txt`), AI Crawler Radar metrics, Site Health checks, Brand Facts & FAQ JSON-LD generation, W3C WebMCP search annotations, ARD v0.91 (`/.well-known/ard.json`), `/llms.txt`, and the Live Agentic Inspector work 100% locally without any account or external connection.

= How can I allow AI search citations while blocking AI training scrapers? =
Open **Settings -> Dante GEO Shield -> 1. Crawler Radar & Firewall** and click **"Allow AI Citation Search · Block Model Training"**. That sets `OAI-SearchBot`, `ChatGPT-User`, `PerplexityBot`, and `Claude-Web` to `Allow` while setting `GPTBot`, `ClaudeBot`, `Google-Extended`, `Applebot-Extended`, `Bytespider`, and `Amazonbot` to `Disallow: /` in `robots.txt`.

= Can I use Dante GEO Shield alongside Yoast SEO, Rank Math, AIOSEO, or SEOPress? =
Yes. Dante GEO Shield automatically detects active SEO plugins and operates in complementary coexistence mode without modifying your `<title>` or `<meta>` tags.

= Does the AI Crawler Radar bloat my database? =
No. The local radar uses a strict FIFO ring-buffer capped at a maximum of `500` events (`<= 256 KB`), and you can clear it anytime with one click.

== Screenshots ==

1. Plugin activation & automatic SEO plugin coexistence detection (Yoast SEO, Rank Math, AIOSEO, WooCommerce).
2. Live AI Bot Crawler Radar & Search vs. Training Firewall inside `Settings -> Dante GEO Shield`.
3. Explicit Opt-In Cloud Synchronization & Share of Model (`SoM`) Competitive Benchmark.
4. Live `/llms.txt`, `/.well-known/ard.json`, and `Schema.org JSON-LD` verification output.

== Changelog ==

= 15.3.0 =
* Security: Replaced direct `<script>` concatenation and `JSON_UNESCAPED_*` flags in JSON-LD and ARD output with `wp_print_inline_script_tag()`, `JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT`, recursive JSON sanitization (`emit_safe_jsonld_script()`), `X-Content-Type-Options: nosniff` headers, and proper `wp_die()` HTTP 403 response argument handling (`manifest_hash: 0985a51efb5e68d4ffc709e9b6f13d95d52b54d6f063a3c2cc7e4842b6881140`).
* Feature: Added standalone AI Bot Firewall (`Search` vs. `Training` `robots.txt` rules across 10 bots), WordPress Site Health integration (`Tools -> Site Health`), Local Brand Facts & FAQ `JSON-LD` / `/llms.txt` builder, Top 10 AI-Crawled URLs breakdown, radar reset action, and 4-tab `wp-admin` console with Live Agentic Inspector.

= 15.2.0 =
* Added ARD v0.91 (`/.well-known/ard.json`) discovery endpoint, W3C WebMCP search form annotations (`toolname` / `tooldescription`), and domain-locked 1:1 cloud sync (`manifest_hash: a6fe70df1fd762a368a1fe4bf790f55ac29cfa162d617c2c86ac625e82fab85d`).

= 15.1.0 =
* WordPress.org Plugin Check (PCP) zero-warning hardening (`wp_parse_url()`, inline `wp_json_encode()` and `esc_html()`, Guideline 17 trademark compliance; `manifest_hash: 22c23e00e17d04657117343d64f31fbd79e89002d373f009a30e4e1dea7f7610`).

= 15.0.0 =
* Initial commercial & freemium release (`manifest_hash: 672ce3abf84223577bcdfa6a869b2044e42fb381afc4adcaf665c5bc2b2e750e`).
