=== Limy Agent Analytics ===
Contributors: limyai
Donate link: https://limy.ai
Tags: analytics, bot detection, ai agents, traffic
Requires at least: 6.2
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight HTTP request logging for advanced bot detection and AI agent traffic insights.

== Description ==

Limy Agent Analytics captures HTTP request metadata from your WordPress site and sends it to Limy's analytics platform for bot detection and traffic analysis.

**What it does:**

* Logs request method, path, status code, user agent, and timing
* Queues logs locally and sends them in compressed batches via cron
* Provides an admin dashboard to configure and monitor the plugin
* Redacts sensitive query parameters automatically

**Key features:**

* Gzip-compressed API delivery — saves 60-80% bandwidth
* Size-aware batch chunking — no oversized payloads
* Jittered retry backoff — prevents thundering-herd failures
* O(1) event capture — zero overhead on every page load
* Lazy service loading — admin code never loads on the frontend

**External Service**

This plugin sends request log data to the Limy analytics API at `https://stream.getlimy.ai`. An API key is required.

* [Limy Terms of Service](https://limy.ai/legal/terms-and-conditions)
* [Limy Privacy Policy](https://limy.ai/legal/privacy-policy)

Data sent includes: HTTP method, request path, response status code, client IP, user agent, referer, request duration, and content length. No personally identifiable information beyond IP address is collected, and sensitive query parameters are redacted before transmission.

== Installation ==

1. Upload the `limy-agent-analytics` folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins menu.
3. Go to Settings > Limy Agent Analytics and enter your API key.
4. Check the "Activate Tracking" checkbox and save.

== Frequently Asked Questions ==

= Where do I get an API key? =

Sign up at [getlimy.ai](https://limy.ai) to obtain your API key.

= What data is sent? =

Request metadata only: method, path, status code, IP, user agent, referer, timing, and content length. Sensitive query parameters are automatically redacted.

= Does this slow down my site? =

No. Event capture uses a single O(1) database insert on the `shutdown` hook. No external HTTP calls are made during the page load — events are dispatched in the background via WP-Cron.

== Screenshots ==

1. Connection settings — configure your API key and dispatch settings.
2. Monitor section — view queue size, circuit breaker status, and dispatch schedule.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Performance improvements: gzip compression, O(1) event capture, jittered retry backoff, and redesigned admin UI.

= 1.0.0 =
Initial release.