=== SOCHQ AI Log Agent ===
Contributors: cyberneticsplus
Tags: logging, monitoring, AI-Security, log analysis, security
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Capture PHP request telemetry and ship JSON batches to your HTTPS webhook every 15 minutes. Minimal setup: set a Webhook URL.

== Description ==

**SOCHQ Log Agent** collects lightweight PHP request telemetry from your WordPress site and periodically ships it as JSON to your HTTPS Webhook. Designed for minimal footprint and simple setup: paste a Webhook URL and you’re set.

> **Ownership/Trademark:** SOCHQ is a product of **Cyberneticsplus Services Pvt. Ltd.** (https://cyberneticsplus.com). Service homepage: https://sochq.com/

### Key features
- **Batched delivery** via WP-Cron (default: every 15 minutes).
- **Minimal fields by default** to reduce sensitivity and payload size.
- **Configurable Webhook URL** (HTTPS required).
- **Graceful failures**: queues and retries when delivery fails.
- **Opt-out fields**: ability to disable optional fields if present in settings.

### What data is sent?
By default, the plugin aims to send low-sensitivity request telemetry such as:
- Timestamp, HTTP method, request URI/path, response status code
- Execution time (ms) and memory usage (if available)
- Site identifier (non-PII, e.g., hashed home URL)
- Optional: user agent, referrer, client IP (can be disabled)

> **Note:** Exact fields depend on your configuration and the plugin settings available in your version. Review your settings before enabling optional fields.

### Security & performance
- Uses **HTTPS** for outbound webhook calls.
- Sends **batched** JSON to reduce overhead.
- Non-blocking operation—collection is lightweight and scheduled via WP-Cron.

== Installation ==
1. Upload the plugin ZIP via **Plugins → Add New → Upload Plugin** or place the folder in `/wp-content/plugins/`.
2. Activate the plugin from **Plugins**.
3. Go to **Settings → SOCHQ Log Agent**.
4. Enter your **HTTPS Webhook URL** and save.
5. Ensure WP-Cron is enabled (it is by default). If you disable WP-Cron, set up a system cron to call `wp-cron.php`.

== Frequently Asked Questions ==

= What data leaves my site? =
Only the telemetry fields described above and configured in settings. Review and adjust optional fields before enabling in production.

= How often are batches sent? =
Every 15 minutes by default, via WP-Cron.

= Will this slow down my site? =
Telemetry collection is lightweight and sending happens on a scheduled task, not on front-end request path.

= Where is data stored before sending? =
Temporarily in WordPress (options/transients or similar queue mechanism) until the next scheduled send.

= Can I pause sending? =
Yes. Remove or blank the Webhook URL to stop outbound requests; queued data will not be transmitted.

= Does this plugin store personal data? =
By default, the plugin avoids collecting PII. Optional fields (like IP, user agent) can be disabled. You are responsible for configuring the plugin in line with your privacy obligations.

= How do I uninstall safely? =
Deactivate and delete the plugin. It will stop collecting and sending data. (If the plugin created options/queues, they may be removed on uninstall.)

== Privacy ==
This plugin can send site telemetry to an external endpoint you control. Configure it to avoid personal data unless you have a lawful basis and have disclosed it to users. For your privacy policy, disclose:
- What you collect (telemetry fields),
- Why you collect it,
- Where you send it (your Webhook),
- How long you retain it.

Cyberneticsplus Services Pvt. Ltd. product site: https://sochq.com  
Company site: https://cyberneticsplus.com

== Screenshots ==
1. Settings screen: Webhook configuration.

== Changelog ==

= 1.0.0 =
* Initial stable release.

== Upgrade Notice ==

= 1.0.0 =
Initial public release with scheduled batched telemetry delivery.

== Ownership and Trademark ==
SOCHQ is a product of **Cyberneticsplus Services Pvt. Ltd.** (https://cyberneticsplus.com). This is an official plugin authored and maintained by Cyberneticsplus.

