=== AI Semantic Handshake ===
Contributors: lethaldiranmx
Tags: ai, schema, json-ld, seo, eeat
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build AI-readable trust relationships between partner sites using JSON-LD handshake signals to boost E-E-A-T for modern AI and search engines.

== Description ==

**AI Semantic Handshake** is a next-generation SEO tool designed to help website owners establish verifiable, bidirectional trust relationships with partner websites.

In the era of AI Search (like ChatGPT, Perplexity, and Google SGE), search engines increasingly rely on **E-E-A-T** (Experience, Expertise, Authoritativeness, and Trustworthiness). This plugin allows you to mathematically prove your site's professional network by generating standardized JSON-LD schema signals that AI engines can easily read and verify. 

Instead of relying on unverified "link exchanges," this plugin uses a secure, peer-to-peer cryptographic handshake over the WordPress REST API to ensure both sites mutually confirm the relationship.

### Core Features (Based on V3.2)

* **Comprehensive Identity Management**
  Define your Business Name, Industry, and Schema Entity Type (Organization or Person). The plugin automatically generates a secure "Public ID" (a truncated hash of your private site secret) for safe, anonymous peer identification.

* **Send & Receive Handshake Requests**
  Send partnership requests directly to another WordPress site's URL. You can specify the exact relationship type (Collaboration, Client, Vendor, Sister Site, Media Mention, Strategic Partner, etc.) and attach a personalized note. 

* **Incoming Request Workflow**
  A dedicated admin queue to review inbound handshake requests. You can see the applicant's Site Name, Public ID, Declared Relation, Note, and their "Snapshot Score" before deciding to **Approve, Reject, or Reject & Blacklist**.

* **Automated Verification & Sync**
  The plugin runs scheduled daily background checks (`wp-cron`) to verify the health of your partner network. It includes advanced automatic retry and backoff logic for temporary network failures, ensuring your network state is always accurate.

* **Frontend JSON-LD Injection**
  Automatically injects perfectly formatted Schema.org JSON-LD into your site's frontend (configurable to "Front Page Only" or "All Pages") to signal your verified relationships to search engine crawlers.

* **Site Quality Scoring**
  Features a built-in "Self Score" and "Snapshot Score" system to evaluate site quality. The Snapshot Score provides helpful guidance and a suggested handshake capacity limit to help you build a high-quality, non-spammy partner ecosystem, without restricting your professional freedom.

* **Email Invitations**
  Want to partner with a site that doesn't have the plugin yet? Send them a customizable email invitation directly from your WordPress dashboard.

* **100% Privacy & Data Ownership**
  Operates entirely locally. Peer-to-peer communication uses the native WordPress HTTP API (`wp_remote_get`/`post`). **No central third-party SaaS endpoints, no data harvesting, and zero hidden API fees.**

* **Seamless Compatibility**
  Works perfectly as a standalone solution or alongside your favorite existing SEO plugins (like RankMath or Yoast) without conflicts. Includes a clean uninstall option to ensure no database bloat is left behind.

---

* **Public project page:** https://aeosub.com/ai-semantic-handshake/
* **Privacy Policy:** https://aeosub.com/privacy-policy/
* **Contact / Support:** https://aeosub.com/contact/
* **Note:** Optional Semantic Support can publish an independent Schema node referencing `aeosub.com` when explicitly enabled by the site owner in wp-admin. It is disabled by default.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install the ZIP from **Plugins > Add New > Upload Plugin**.
2. Ensure dependencies are included in the package (`vendor/` directory).
3. Activate **AI Semantic Handshake** in WordPress admin.
4. Open **AI Semantic Handshake** in wp-admin and complete your identity/settings fields.
5. Add partner sites and start sending/receiving handshake requests.

== Frequently Asked Questions ==

= Do both sites need this plugin? =

Yes. For full bidirectional handshake confirmation, both sites should install and activate AI Semantic Handshake.

= Does this plugin require an external API key? =

No. The core handshake and verification workflow does not require an external API key.

= Does this plugin send data to a central service? =

No. The core handshake flow works by communicating directly with partner websites that the site owner explicitly configures.

= What is the optional Semantic Support setting? =

Semantic Support is an optional setting that can output an additional front-end Schema node referencing the AI Semantic Handshake protocol page on aeosub.com. It is disabled by default and can be enabled only by the site owner.

= What happens when I uninstall? =

By default, plugin data is kept. If you enable "Delete all plugin data on uninstall", plugin options/transients are removed during uninstall.

= Is SSL verification enabled for remote checks? =

Yes. SSL verification is enabled by default for outbound requests.

= Is the Partner Network fully manageable? =

Yes. As of v3.2, you can fully manage, remove, cancel requests, and monitor all relationships directly from the admin interface.

== Changelog ==

= 3.2.2 =
Fixes a critical bug in the handshake initiation process. Recommended for all users to ensure seamless partner connectivity.

= 3.2.1 =

* Reworked score-based handshake limits into non-blocking guidance for WordPress.org compliance.
* Hardened JSON-LD escaping and updated project/support documentation links.
* Updated bundled dependencies and aligned plugin header/readme metadata.

= 3.2.0 =

* Added `Remove Partner` for active / broken local partner cleanup.
* Added `Cancel Request` for local outbound pending requests.
* Added normalized-domain async guardrails to reduce duplicate / cross-send ambiguity.
* Allowed `broken` relationships to recover through a fresh handshake cycle.
* Added independent Semantic Support module with separate front-end schema output and consent storage.
* Improved admin responsive behavior and sidebar card stability across smaller screens.
* Switched operational logs to fixed English output for clearer diagnostics.

= 3.1.0 =

* Partner Network UI moved to read-only maintenance mode for stabilization safety.
* Added canonical partner store `aish_partner_network_v1` and decoupled it from Carbon field rendering.
* Migrated REST/admin/cron/frontend/scorer partner reads and writes to canonical store with legacy mirror compatibility.
* Updated local regression baseline to `43 tests` / `160 assertions`.

= 3.0.0 =

* Introduced signed REST handshake flow and callback sync.
* Added incoming request review/approval tooling in admin.
* Added scheduled verification and richer diagnostics.
* Added relation model fields (`my_relation_to_partner`, `partner_relation_to_me`, `relation_note`, `partner_claim`).
* Improved frontend JSON-LD output and compatibility handling.

== Upgrade Notice ==

= 3.2.2 =
Critical bug fix for handshake initiation. All users should update to ensure the partner request system functions correctly.

= 3.2.1 =

Recommended update with WordPress.org review fixes, safer JSON-LD output, and refreshed project/support metadata.

= 3.2.0 =

Adds partner removal / cancel controls, broken-relationship recovery flow, semantic-support module, and admin responsiveness improvements.
