=== Axiom AI EntryPoints ===
Contributors: axiomfeed
Tags: llms, llms.txt, ai, markdown, endpoints
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds AI-readable entrypoints to your WordPress site: /llms.txt, /ai/index.json, and /ai/pages/<id>.md — clean, fast, and no-tracking.

== Description ==

Axiom AI EntryPoints is a thin, no-tracking plugin that exposes clean, machine-readable endpoints for AI tools and crawlers.

It does NOT modify themes, does NOT inject front-end scripts, and does NOT require any external server. Endpoints are generated dynamically (no filesystem writes), with caching and a built-in diagnostics page to help troubleshoot common hosting/CDN/WAF issues.

### What it adds

* `/llms.txt` — a simple LLM entrypoint file for your site
* `/ai/index.json` — a structured index of published pages (plus a `home` entry)
* `/ai/pages/<id>.md` — markdown output for published pages
* `<head>` discovery links for `/llms.txt` and `/ai/index.json`
* `robots.txt` allow hints for `/llms.txt` and `/ai/`
* Tools → **Axiom Diagnostics** page (endpoint self-check)
* Transient caching with automatic invalidation on content updates

### Notes

* Endpoints are public URLs by design. The plugin only outputs **published** content and skips password-protected content.
* This plugin does not promise rankings or citations. It focuses on clean, stable, machine-readable entrypoints.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/axiom-ai-entrypoints/` or install via the Plugins screen.
2. Activate the plugin.
3. Visit:
   * `https://your-domain.com/llms.txt`
   * `https://your-domain.com/ai/index.json`
4. If any endpoint returns **404**, go to **Settings → Permalinks** and click **Save Changes** once.

== Frequently Asked Questions ==

= Does it create real files on disk? =
No. Endpoints are generated dynamically by WordPress. This avoids filesystem permission issues on many hosts.

= Does it track users or bots? =
No tracking. No analytics. No external requests.

= Which content is included? =
Published pages are listed in `/ai/index.json` (plus a `home` entry). `/ai/pages/<id>.md` outputs markdown for published pages. Password-protected content is not output.

= What if a firewall or security plugin blocks the endpoints? =
Use Tools → **Axiom Diagnostics** to check status codes. If you see **403**, whitelist paths:
* `/llms.txt`
* `/ai/*`

= Why do I still need Settings → Permalinks → Save? =
Some WordPress environments require a permalink refresh after new rewrite rules are added.

= Does it work with WooCommerce? =
This Free v0.1 focuses on standard WordPress pages. WooCommerce-specific output can be added later.

== Screenshots ==

1. Tools → Axiom Diagnostics (endpoint self-check)

== Changelog ==

= 0.1.0 =
* Initial release
* Added /llms.txt
* Added /ai/index.json
* Added /ai/pages/<id>.md
* Added caching (transients) and invalidation on content updates
* Added Tools → Axiom Diagnostics
* Added <head> discovery links
* Added robots.txt allow hints for /llms.txt and /ai/

== Upgrade Notice ==

= 0.1.0 =
Initial release.