=== UCPtools - AI Agent Discovery for WooCommerce ===
Contributors: ucptools
Tags: woocommerce, ai, agents, ucp, agentic commerce
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Serve your UCP profile at /.well-known/ucp so AI shopping agents can find your store - and see which agents actually read it.

== Description ==

AI shopping agents (ChatGPT, Gemini, Perplexity, Claude) look for a UCP profile at
`/.well-known/ucp` to understand what a store sells and how to buy from it. Shopify
generates one automatically. WooCommerce does not - so to an AI agent, most Woo stores
return a 404 and simply do not exist.

This plugin serves that profile from your own origin, built from your WooCommerce store.

**It works with no account and makes zero network calls until you enter a key.**

= How it works =

Your server answers the agent. UCPtools is never in the request path, so this plugin
cannot become a point of failure for your storefront - it only reports what happened
afterwards, and only if you connect it.

* **Free, no account:** generates a UCP profile from your store and serves it at
  `/.well-known/ucp`. Shows you the last AI agent that read it, in wp-admin.
* **Connected (optional):** paste an analytics key from your UCPtools dashboard. Your
  profile stays in sync with the dashboard, and every agent read is recorded over time -
  by agent, with timestamps.

= The self-check =

Intercepting `/.well-known/` can be defeated by a physical `.well-known` folder, an nginx
rule denying dot-directories, or a subdirectory multisite install - and every one of those
fails silently, leaving you invisible while you believe you are discoverable. So the plugin
fetches its own profile over the network and tells you exactly what an agent would get.

== Frequently Asked Questions ==

= Do I need a UCPtools account? =

No. Serving the profile - the part that makes agents able to find you - is free and needs
no account. An account adds the record of which agents read it, over time.

= Does this send my customer data anywhere? =

No. It reports that an agent requested your profile: which agent, when, and the HTTP
status. No customer data, no order data, no card data. With no key entered, it sends
nothing at all.

= Will this slow down my store? =

No. The report to UCPtools is non-blocking - it is fired and forgotten, so neither our
latency nor our downtime can be added to your page load.

= I use a page cache. Does that break it? =

Possibly, and the plugin will warn you. The profile still serves, but if your cache answers
`/.well-known/ucp` without running PHP, agent reads cannot be counted. Exclude that path
from caching.

== Changelog ==

= 1.0.0 =
* Serves /.well-known/ucp from the WooCommerce origin
* Agent detection and local "last agent seen" record, free and account-less
* Optional connected mode: canonical profile sync + agent read reporting
* wp-admin self-check and page-cache warning
