v0.5.15: add AI & Automation docs, bump manifest, update roadmap

- Bump manifest.json version to 0.5.15
- Add CHANGELOG entry for get_drive_data service (PR #38, @nsleigh)
- Add AI-ready drive analysis feature bullet to README
- Add AI & Automation section to README
- Mark multi-variant diagnostic split as shipped in roadmap
- Add get_drive_data service to roadmap as shipped

Author: DAB-LABS

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to SMART Sniffer are documented here.
 
+## v0.5.15 -- 2026-06-09
+
+Integration-only release. No agent or installer changes. Community contribution by @nsleigh.
+
+### Added
+- **`smart_sniffer.get_drive_data` service call** -- returns the full cached SMART dataset for any agent, including raw attributes, our attention evaluation (state, severity, reasons), filesystem usage, and agent metadata. Designed for automation workflows that pipe drive data to an AI for analysis. Call it from an automation, pass the JSON to a conversation agent (Google AI, OpenAI, Claude, Ollama), and get back a plain-English health report. Also works from Developer Tools > Services for manual inspection. Implements #37, contributed by @nsleigh in PR #38.
+
+### Upgrade Notes
+- **Integration-only update.** Update via HACS or manually replace `custom_components/smart_sniffer/`. No agent update needed.
+- **New service:** after updating, the `smart_sniffer.get_drive_data` service appears in Developer Tools > Services. Select your agent from the dropdown and call it to see the full response.
+
 ## v0.5.14 -- 2026-05-30
 
 Integration-only release. No agent or installer changes.

README.md

@@ -34,6 +34,8 @@ SMART Sniffer follows the trail, sniffing out the [early warning signs](https://
 
 **Auto-discovery** — Agents advertise themselves on the local network via mDNS/Zeroconf. Home Assistant discovers them automatically — no manual IP entry needed.
 
+**AI-ready drive analysis** -- A service call returns full SMART data, health assessments, and storage metrics for any agent. Pipe it to Google AI, ChatGPT, Claude, or Ollama for automated drive health reports with zero parsing.
+
 **Secure by default** — Optional bearer token authentication between agent and integration. SHA256-verified binary downloads.
 
 <br>
@@ -368,6 +370,26 @@ The agent requires smartmontools **7.0+** for JSON output support. Most current
 
 <br>
 
+## AI & Automation
+
+SMART Sniffer includes a `smart_sniffer.get_drive_data` service call that returns the complete cached SMART dataset for any agent. The response includes raw SMART attributes, our attention evaluation (state, severity, and reasons), filesystem usage, and agent metadata -- everything an LLM needs to produce a meaningful health assessment.
+
+**What's in the response:**
+
+| Key | Content |
+|-----|---------|
+| `agent` | Name, host, OS, uptime, version |
+| `drives` | Per-drive: model, serial, protocol, device path, attention state/severity/reasons, full SMART JSON |
+| `filesystems` | Per-mount: mountpoint, total bytes, used bytes, percentage |
+
+**Example use case: automated weekly health report.** Create an HA automation that runs every Monday morning, calls `smart_sniffer.get_drive_data` for each agent, passes the JSON to a conversation agent (Google AI, OpenAI, Claude, Ollama) with a prompt like "Analyze these SMART readings and flag anything concerning," then emails you the AI's response. The AI can catch patterns like rising reallocated sector counts, aging drives approaching end-of-life, or storage filling up -- things the raw sensor values alone don't always make obvious.
+
+The service uses `supports_response: only`, so it also works from **Developer Tools > Services** for manual inspection of the full response payload.
+
+For one-off analysis without automation, use **Download Diagnostics** (Settings > Devices & Services > SMART Sniffer > three-dot menu). The downloaded JSON contains the same raw SMART data and can be pasted directly into any AI chat interface. See [Raw SMART data](#raw-smart-data) above.
+
+<br>
+
 ## Screenshots
 
 <table>
@@ -505,7 +527,8 @@ Drive-specific `smartctl -a --json` output samples are especially welcome — th
 - [ ] Agent: container-aware filesystem reporting (MNT_PREFIX path mapping for Docker deployments)
 - [ ] Agent: runtime interface detection (replace static prefix list with OS-level physical NIC detection)
 - [ ] Integration: parent-agent device hierarchy + optional area-on-setup (drives nest under agent via `via_device`, area inherits via HA prompt)
-- [ ] Integration: split consolidated wear-leveling / uncorrectable / pending-sector sensors into separate diagnostic entities when a drive reports multiple variants (v0.5.7 follow-up; affects multi-variant drives like Silicon Motion SSDs)
+- [x] Integration: split consolidated wear-leveling / uncorrectable / pending-sector sensors into separate diagnostic entities when a drive reports multiple variants -- shipped v0.5.14
+- [x] Integration: `smart_sniffer.get_drive_data` service call for AI/automation access to full SMART data -- shipped v0.5.15, community PR by @nsleigh
 
 ---
 

custom_components/smart_sniffer/manifest.json

@@ -9,6 +9,6 @@
   "iot_class": "local_polling",
   "issue_tracker": "https://github.com/DAB-LABS/smart-sniffer/issues",
   "requirements": [],
-  "version": "0.5.7",
+  "version": "0.5.15",
   "zeroconf": [{"type": "_smartha._tcp.local."}]
 }