=== Vemula AI Content Layer ===
Contributors: vemuladinesh
Tags: ai, markdown, json, llms-txt, rag
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Expose your WordPress content as Markdown, JSON, RAG chunks, and an llms.txt index so LLMs and AI agents can read it cleanly.

== Description ==

Vemula AI Content Layer converts your WordPress content into AI-friendly structured formats that LLMs, RAG pipelines, and AI search agents can actually understand.

Core Features:

* Markdown Endpoints - Access any post or page as clean Markdown at `/your-post.md`
* JSON Endpoints - Structured JSON output with metadata at `/your-post.json`
* RAG Mode - Chunked, embedding-ready content at `/your-post.rag`
* llms.txt Generator - Auto-generated site index at `/llms.txt`
* AI Content Cleaning - Strips scripts, styles, nav, and layout clutter
* AI Analytics - Track GPTBot, ClaudeBot, Perplexity, and other AI crawlers
* Privacy Controls - Exclude post types or individual posts from AI endpoints
* Caching Layer - Fast responses with WordPress transient caching
* Rate Limiting - Protect against abuse with per-IP rate limiting

YAML Front Matter is automatically prepended to all Markdown output:

    ---
    title: "My Post"
    description: "Post excerpt..."
    date: "2026-03-24"
    tags: ["seo", "ai"]
    reading_time: 5
    ---

== Installation ==

1. Upload the `vemula-ai-content-layer` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Settings > Permalinks and click Save Changes to flush rewrite rules
4. Access your content at `/your-post.md`, `/your-post.json`, or `/llms.txt`

== Frequently Asked Questions ==

= Will this create duplicate content issues? =

No. All AI-format endpoints send `X-Robots-Tag: noindex` headers by default, preventing search engines from indexing them.

= Does it work with custom post types? =

Yes. All public post types are supported automatically.

= How do I exclude a page from AI access? =

Go to Vemula AI Content Layer > Privacy Controls and either exclude the post type or add the specific post ID.

= Are password-protected posts exposed? =

No. Password-protected posts return a 403 Forbidden response on all AI endpoints.

= Does it collect any personal data? =

The analytics feature stores hashed IP addresses (SHA-256 + site salt) — never raw IPs. Analytics can be disabled entirely from the Settings page.

== Screenshots ==

1. General Settings page
2. Privacy Controls page
3. AI Crawl Analytics dashboard

== Changelog ==

= 1.0.0 =
* Initial release
* Markdown, JSON, and RAG endpoints
* llms.txt generation
* AI analytics dashboard
* Privacy controls (exclude post types or individual posts)
* Rate limiting and transient-based caching

== Upgrade Notice ==

= 1.0.0 =
Initial release.
