shoivehossain Store AI Health Monitor & Recovery Engine

Description

shoivehossain Store AI Health Monitor & Recovery Engine continuously watches your WooCommerce store for issues, automatically recovers from common problems, and uses Claude AI to provide intelligent diagnostics and actionable recommendations.

Zero front-end performance impact — all code runs exclusively in wp-admin and WP-Cron. Assets are enqueued only on this plugin’s own pages.

Key Features

Health Monitoring
* 11 built-in health checks covering orders, inventory, payments, configuration, and database performance
* Real-time health score (0–100) with 14-day trend sparkline
* Per-check status cards with category tagging and time stamps

Automated Recovery Engine
* Safely removes orphaned order items (no matching parent order)
* Cleans expired WooCommerce sessions
* Removes orphaned postmeta and stale transients
* Resets active webhook failure counters
* Full audit log of every action taken

AI-Powered Analysis (requires Anthropic API key)
* One-click store analysis: executive summary, top-3 priority actions, root-cause patterns, estimated revenue impact
* AI Chat assistant with full health context
* Uses Anthropic Claude API — data sent only when you explicitly trigger analysis

Alerts
* Dashboard notification banner for active issues
* Email digest (throttled — max 1 per hour) for new warnings and critical issues
* Auto-dismiss when the underlying check returns to healthy
* Manual per-alert dismiss

Configuration
* Enable/disable individual checks
* Scan frequency: hourly, every 6 hours, every 12 hours, daily
* Configurable log retention (7–365 days)
* Separate alert email address

Health Checks

  • Orphaned Order Items — order item rows with no parent order
  • Stock Sync — products with stock management enabled but no quantity set
  • Failed Payments — failed orders in the last 7 days
  • Abandoned Carts — expired sessions still holding cart data
  • Duplicate SKUs — same SKU assigned to multiple products/variations
  • Tax Configuration — disabled tax calculation or missing rates
  • Shipping Zones — zones with no shipping methods assigned
  • Coupon Expiry — coupons expiring within 3 days
  • Database Performance — postmeta bloat, session table size, autoloaded options
  • Webhook Failures — webhooks with recorded delivery failures
  • Payment Gateway Status — verifies at least one gateway is active

WooCommerce Compatibility

  • HPOS (High-Performance Order Storage): Fully compatible. Order queries use wc_get_orders() and fall back gracefully between wc_orders and wp_posts tables.
  • Cart/Checkout Blocks: Declares full block checkout compatibility.
  • WooCommerce Subscriptions, Bookings, Memberships, Points & Rewards: Read-only queries — this plugin never modifies WooCommerce product, order, or subscription data.

Theme Compatibility

This plugin loads zero CSS or JavaScript on the front-end and on any admin page other than its own screens. It is fully compatible with:

  • Astra, Astra Pro
  • OceanWP
  • GeneratePress
  • Divi, Divi Builder
  • Avada
  • WPLMS (eLearning LMS theme)
  • LearnDash (plugin + LMS themes)
  • Elementor, Elementor Pro
  • WPBakery Page Builder
  • SeedProd, Beaver Builder
  • Any other WordPress theme or page builder

Plugin Compatibility

The plugin uses prefixed hooks (shoistai_), prefixed option keys (shoistai_), prefixed table names (shoistai_), and a namespaced PHP codebase (SHOISTAI\) to prevent conflicts with any other plugin, including:

  • WooCommerce extensions (Stripe, PayPal, Klarna, etc.)
  • WooCommerce Payments
  • YITH WooCommerce plugins
  • WooCommerce Google Analytics
  • WPForms, Gravity Forms, Contact Form 7
  • Rank Math, Yoast SEO
  • WP Rocket, W3 Total Cache, LiteSpeed Cache
  • Wordfence, Sucuri
  • MonsterInsights, PixelYourSite

Privacy

This plugin does not collect or transmit any personal data from your WordPress site. The optional AI analysis feature sends anonymised store health metric summaries to the Anthropic API only when triggered by an administrator. No customer names, emails, addresses, or order content are included.

Third-party service (Anthropic API):
AI features make requests to https://api.anthropic.com/v1/messages.
* This only happens when an administrator explicitly clicks “Generate Analysis” or sends a chat message.
* No data is sent automatically, on page load, or without user intent.
* Anthropic Privacy Policy: https://www.anthropic.com/privacy
* Anthropic Terms of Service: https://www.anthropic.com/terms

Support

For questions, bug reports, or feature requests, please contact:

  • Email: shoivehossain100@gmail.com
  • LinkedIn: https://www.linkedin.com/in/ronaninstain/

When contacting support, please include your WordPress version, WooCommerce version, and a description of the issue.

Screenshots

  • Main Dashboard — Health score ring, KPI counters, 14-day sparkline, and per-check status cards.
  • AI Insights — One-click store analysis and AI chat assistant.

Installation

Automatic

  1. Log in to your WordPress dashboard.
  2. Go to Plugins Add New.
  3. Search for “shoivehossain Store AI Health Monitor”.
  4. Click Install Now, then Activate.

Manual

  1. Download the plugin ZIP file.
  2. Go to Plugins Add New Upload Plugin.
  3. Choose the ZIP file and click Install Now.
  4. Click Activate Plugin.

After Activation

  1. Navigate to Store Health in the WordPress admin sidebar.
  2. Click Run Scan Now to perform your first health check.
  3. (Optional) Go to Store Health Settings and add your Anthropic API key to enable AI features.

FAQ

Do I need an Anthropic API key?

No. All health checks, the automated Recovery Engine, dashboard, alerts, and email notifications work without any API key. The key is only required for the AI Analysis and AI Chat features.

How do I get an Anthropic API key?

Visit console.anthropic.com, create an account, and generate an API key under API Keys.

Will this plugin slow down my site?

No. The plugin is designed to have zero impact on front-end performance:
* No CSS, JS, or PHP runs on your front-end pages.
* Admin assets are enqueued only on this plugin’s own pages.
* Health checks run in WP-Cron (background), not on page load.
* Results are cached in transients and the custom tables.

What does the Recovery Engine actually change?

The Recovery Engine only performs safe, targeted cleanups:
1. Deletes order item rows whose parent order no longer exists.
2. Deletes expired WooCommerce sessions (older than 2 hours past expiry).
3. Removes postmeta rows for deleted posts and expired WordPress transients.
4. Resets the failure_count column on active webhooks.

It never modifies product data, order content, customer records, or WooCommerce settings.

Is it compatible with HPOS (WooCommerce High-Performance Order Storage)?

Yes. All order queries use wc_get_orders() when WooCommerce’s public API is available, and the orphaned-order-item check auto-detects whether to query wc_orders or wp_posts.

Will it conflict with my caching plugin?

No. The plugin uses standard WordPress and WooCommerce data APIs. It registers its own WP-Cron hook and uses its own DB tables — it does not interfere with any caching layer.

Can I disable specific health checks?

Yes. Go to Store Health Settings Enabled Checks and toggle any check on or off.

Where is data stored?

All data is stored in three custom WordPress database tables:
* {prefix}shoistai_health_logs — per-check scan results
* {prefix}shoistai_recovery_log — recovery action audit log
* {prefix}shoistai_alerts — active alerts

Data is automatically cleaned up based on the configured retention period. All tables are removed when the plugin is deleted.

Does the plugin work on WordPress Multisite?

This version is designed for single sites. Multisite support is planned for a future release.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“shoivehossain Store AI Health Monitor & Recovery Engine” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.2

  • Addressed WordPress.org review feedback regarding plugin prefixes.
  • Updated Chart.js to the latest stable release (v4.4.8).
  • Pro options link configured for store.

1.0.1

  • Bundled dashboard charting asset to avoid external CDN usage.
  • Fixed Settings persistence edge cases and coupon expiry check (no feature scope changes).
  • Initial release.
  • 11 health checks covering orders, inventory, payments, configuration, and DB performance.
  • Automated Recovery Engine with 4 safe recovery actions.
  • AI Analysis and AI Chat powered by Anthropic Claude.
  • Real-time dashboard with health score ring and sparkline.
  • Email digest alerts (throttled, deduped).
  • HPOS and Cart/Checkout Blocks compatibility declarations.
  • Full PHP 7.4–8.3 support.
  • WordPress 5.8–6.7 tested.
  • WooCommerce 6.0–9.5 tested.