=== Suita — AI Commerce Connector ===
Contributors: suita
Tags: woocommerce, ai, mcp, seo, agents
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
WC requires at least: 7.0
Stable tag: 0.1.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WooCommerce store AI-native: a structured product feed, an MCP endpoint for AI agents, AI traffic detection, and a live AEO checklist.

== Description ==

Suita turns your WooCommerce store into something AI agents — ChatGPT,
Claude, Gemini, Perplexity — can actually read and shop from, instead of
scraping your HTML.

Once activated, this plugin adds directly to your site:

* **`/ai/products`** — a structured JSON feed of your full catalog (price,
  stock, colors, dimensions, material, brand, shipping, return policy).
* **`/mcp`** — a Model Context Protocol-style endpoint agents can call to
  list products, check inventory, get shipping rates, and more.
* **AI Traffic detection** — logs GPTBot, ClaudeBot, PerplexityBot, and
  other known AI user-agents hitting your store, right in wp-admin.
* **AEO (Agent Engine Optimization)** — a live checklist of which products
  are missing the fields AI agents need (dimensions, material, return
  policy, color variants) to recommend you confidently.
* **AI Readiness Score** — one number summarizing how AI-native your
  catalog currently is.
* Optional connection to your **Suita Cloud dashboard** at
  app.suita.xyz, syncing your real catalog and AI traffic so you can see
  it outside of wp-admin too.

= Requirements =

* WooCommerce must be installed and active.
* PHP 7.4+.

== Installation ==

1. Upload the `suita` folder to `/wp-content/plugins/`, or install the
   zip via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin.
3. Visit **Suita → Settings** to review the defaults (the product feed
   and MCP endpoint are on by default) and, optionally, connect to your
   Suita Cloud dashboard.

== Frequently Asked Questions ==

= Does this work without connecting to the cloud? =

Yes. `/ai/products`, `/mcp`, and the local AI Traffic / AEO / Readiness
Score pages in wp-admin all work immediately using only your site's own
data — no cloud account required.

= What does "Connect to Suita Cloud" do? =

It registers your store domain with api.suita.xyz, gets back an API key,
and starts syncing your product catalog and detected AI traffic so the
same numbers show up on app.suita.xyz.

== Screenshots ==

1. Suita dashboard in wp-admin — AI Readiness Score and AEO checklist for your live catalog.
2. AI Traffic log — GPTBot, ClaudeBot, PerplexityBot and other AI agents hitting your store, in real time.
3. Settings — MCP server, product feed, AI Checkout, and Suita Cloud connection controls.
4. The `/ai/products` structured feed, viewed directly in a browser.

== Changelog ==

= 0.1.13 =
* Security: the `create_checkout` MCP tool now requires its own Bearer-token
  key (shown in Suita → Settings once AI Checkout is enabled) — previously
  any caller who could reach `/mcp` could create real orders. Every other
  MCP tool (search, inventory, shipping) stays public and unauthenticated,
  by design, same as browsing the store.
* Declares compatibility with WooCommerce High-Performance Order Storage
  (custom order tables).
* "Enable Cloud Sync" now defaults to off, consistent with every other
  cloud-connected feature being opt-in rather than on by default.

= 0.1.12 =
* AI Checkout: a new `create_checkout` MCP tool lets a connected agent prepare
  a real WooCommerce order (stock-checked, pending payment) and hand the
  shopper a checkout link — no payment method is ever touched by the agent.
  Off by default; enable it per store under Suita → Settings.

= 0.1.0 =
* Initial release: product feed, MCP endpoint, AI traffic detection, AEO
  checklist, readiness score, and Suita Cloud connector.
