# Sentinel Versioned Roadmap
## Focus: What's MISSING vs What Can Be Improved

---

## 🎯 VERSION 1.2.0 - "Observation Enhancement"
**Release Theme:** Make existing observation better and fill critical gaps

### Core Features (Free)
1. **Full Request Timeline Tracking** ⭐ CRITICAL
   - Track: `init` → `plugins_loaded` → `wp_loaded` → `template_redirect` → `shutdown`
   - Time deltas between hooks
   - Memory deltas per hook
   - Response time per request
   - **Why:** Memory monitor exists but doesn't show full flow or timing
   - **Storage:** New table `wp_sentinel_request_timelines` or extend logs

2. **Per-URL Hotspot Detection** ⭐ CRITICAL
   - Calculate error rate per URL
   - Compare to site average
   - Alert on URLs with >20% error rate
   - **Why:** URL is logged but never analyzed
   - **Storage:** Transient cache, recalc hourly

3. **AJAX Request Detection** ⭐ HIGH
   - Distinguish: admin/frontend/ajax/cron/rest-api
   - Add `request_type` field to logs
   - Filter in dashboard
   - **Why:** No way to see AJAX-specific issues
   - **Storage:** Detect from `DOING_AJAX` or URL pattern

4. **Error Fingerprinting** ⭐ HIGH
   - Hash error messages (normalize variables)
   - Group PHP errors by file:line
   - Group database errors by query pattern
   - **Why:** Can't auto-group similar errors
   - **Storage:** Add `error_fingerprint` column to logs

5. **Self-Diagnostics Page** ⭐ HIGH
   - Check: tables, queue size, cron health, DB connectivity
   - Check: file permissions, disk space, memory limits
   - Show: "All systems operational" or specific issues
   - **Why:** No centralized health check
   - **UI:** New "System Health" page

### Missing Core Features
6. **IP Geolocation** ⭐ MEDIUM
   - Country, city, ISP detection
   - Show on map in incident details
   - **Why:** IP logged but no context
   - **Integration:** MaxMind GeoIP2 or ipapi.co

7. **User Agent Parsing** ⭐ MEDIUM
   - Browser, OS, device type detection
   - Mobile vs desktop breakdown
   - **Why:** User agent logged but not parsed
   - **Library:** Use existing WordPress functions or ua-parser-php

8. **Session Tracking** ⭐ MEDIUM
   - Track user sessions across requests
   - Session duration, page views per session
   - **Why:** No user journey tracking
   - **Storage:** New table `wp_sentinel_sessions`

9. **Search Functionality** ⭐ HIGH
   - Full-text search in logs
   - Search by event data content
   - **Why:** Can only filter, not search
   - **Storage:** Add fulltext index to logs table

10. **Bulk Actions on Logs** ⭐ MEDIUM
    - Delete selected logs
    - Export selected logs
    - Mark as reviewed
    - **Why:** Can only work with one log at a time
    - **UI:** Checkboxes + bulk action dropdown

---

## 🎯 VERSION 1.3.0 - "Explanation & Clarity"
**Release Theme:** Help users understand what's happening

### Core Features (Free)
1. **"Why This Matters" Panel** ⭐ CRITICAL
   - Add `impact_level` and `impact_description` to event config
   - Show in event detail modal
   - Color-code by severity
   - **Why:** Events have descriptions but no impact explanation
   - **Storage:** Extend event definitions

2. **Auto-Grouping Similar Errors** ⭐ CRITICAL
   - Group by error fingerprint
   - Show "Similar Errors" section
   - Count of occurrences
   - **Why:** Can't see patterns in errors
   - **UI:** Collapsible groups in logs view

3. **First-Seen vs Recurring Tagging** ⭐ MEDIUM
   - Track first occurrence per event_key+data_hash
   - Add `is_first_occurrence` flag
   - Show badge in UI
   - **Why:** All events treated equally
   - **Storage:** Transient cache of first occurrences

4. **Environment Hints** ⭐ MEDIUM
   - Check PHP version vs WordPress requirements
   - Check memory_limit vs recommended
   - Check active plugin count
   - Show warnings in dashboard
   - **Why:** No environment validation
   - **Storage:** Transient cache, recalc daily

5. **Error Age Awareness** ⭐ LOW
   - "This started after Plugin X update"
   - "This error is 47 days old"
   - **Why:** Timestamps exist but no context
   - **UI:** Show in error detail view

### Missing Core Features
6. **Saved Searches/Filters** ⭐ HIGH
   - Save filter combinations
   - Quick access to common views
   - **Why:** Have to rebuild filters every time
   - **Storage:** User meta or options

7. **Custom Dashboards** ⭐ MEDIUM
   - Create custom dashboard views
   - Choose widgets to display
   - **Why:** One-size-fits-all dashboard
   - **Storage:** User meta per dashboard

8. **Activity Timeline View** ⭐ MEDIUM
   - Visual timeline of user activity
   - See user journey
   - **Why:** Logs are linear, not visual
   - **UI:** Timeline component

---

## 🎯 VERSION 1.4.0 - "Integrations Expansion"
**Release Theme:** Support more WordPress ecosystem

### New Integrations (Free)
1. **Elementor Integration** ⭐ CRITICAL
   - Page builder events
   - Template saves
   - Widget usage
   - **Why:** Most popular page builder, missing

2. **Advanced Custom Fields (ACF) Integration** ⭐ HIGH
   - Field group saves
   - Field value changes
   - **Why:** Very popular, missing

3. **Rank Math SEO Integration** ⭐ HIGH
   - Meta updates
   - Schema changes
   - **Why:** Popular Yoast alternative, missing

4. **All in One SEO Integration** ⭐ HIGH
   - SEO settings changes
   - Sitemap updates
   - **Why:** Popular SEO plugin, missing

5. **Jetpack Integration** ⭐ MEDIUM
   - Jetpack module activations
   - Stats tracking
   - **Why:** Very popular, missing

6. **MonsterInsights Integration** ⭐ MEDIUM
   - Analytics settings
   - Report views
   - **Why:** Popular GA plugin, missing

7. **UpdraftPlus Integration** ⭐ MEDIUM
   - Backup events
   - Restore events
   - **Why:** Popular backup plugin, missing

8. **Wordfence Integration** ⭐ MEDIUM
   - Security event correlation
   - Block events
   - **Why:** Popular security plugin, missing

9. **iThemes Security Integration** ⭐ MEDIUM
   - Security settings changes
   - Block events
   - **Why:** Popular security plugin, missing

10. **WPML Integration** ⭐ LOW
    - Translation events
    - Language switches
    - **Why:** Popular multilingual plugin, missing

11. **Polylang Integration** ⭐ LOW
    - Translation events
    - Language switches
    - **Why:** Popular multilingual plugin, missing

12. **BuddyPress Integration** ⭐ LOW
    - Social events
    - Group activities
    - **Why:** Popular social plugin, missing

13. **bbPress Integration** ⭐ LOW
    - Forum events
    - Topic/reply events
    - **Why:** Popular forum plugin, missing

14. **Easy Digital Downloads Integration** ⭐ LOW
    - Download events
    - Purchase events
    - **Why:** Popular ecommerce plugin, missing

15. **MemberPress Integration** ⭐ LOW
    - Membership events
    - Subscription events
    - **Why:** Popular membership plugin, missing

---

## 🎯 VERSION 1.5.0 - "Notifications & Communication"
**Release Theme:** Get alerts where you need them

### Core Features (Free)
1. **Webhooks (Outbound)** ⭐ CRITICAL
   - Send events to external URLs
   - Custom payloads
   - Retry logic
   - **Why:** Only email exists, need programmatic access
   - **Storage:** New table `wp_sentinel_webhooks`

2. **Quiet Hours** ⭐ HIGH
   - Time range setting (e.g., 10pm-8am)
   - Queue notifications during quiet hours
   - Send digest at end of quiet period
   - **Why:** All notifications sent immediately
   - **Storage:** Settings option

3. **Environment-Aware Alerts** ⭐ MEDIUM
   - Detect environment (WP_DEBUG, domain pattern)
   - Suppress non-critical alerts in staging
   - **Why:** Same alerts for prod/staging
   - **Storage:** Environment detection in settings

### New Integrations (Free)
4. **Slack Integration** ⭐ HIGH
   - Send alerts to Slack channels
   - Rich formatting
   - **Why:** Teams use Slack, missing
   - **Storage:** Webhook URL in settings

5. **Discord Integration** ⭐ MEDIUM
   - Send alerts to Discord channels
   - Rich formatting
   - **Why:** Teams use Discord, missing
   - **Storage:** Webhook URL in settings

6. **Microsoft Teams Integration** ⭐ LOW
   - Send alerts to Teams channels
   - **Why:** Enterprise teams use Teams, missing
   - **Storage:** Webhook URL in settings

7. **SMS Notifications (Twilio)** ⭐ LOW (Premium)
   - Critical alerts via SMS
   - **Why:** Email might be missed
   - **Integration:** Twilio API

8. **Push Notifications** ⭐ LOW (Premium)
   - Browser push notifications
   - **Why:** Real-time alerts
   - **Technology:** Service Workers

---

## 🎯 VERSION 1.6.0 - "Stability & Reliability"
**Release Theme:** Don't let Sentinel become the problem

### Core Features (Free)
1. **Degraded Mode Notices** ⭐ HIGH
   - Track failed DB writes
   - Track queue overflow
   - Show admin notice when degraded
   - **Why:** Silent failures
   - **Storage:** Transient flags

2. **One-Click Diagnostic Bundle** ⭐ MEDIUM
   - ZIP: recent logs, settings (sanitized), system info, error logs
   - Generate on-demand
   - **Why:** Manual export only
   - **Storage:** Temporary file, auto-delete after 24h

3. **Settings Backup/Restore** ⭐ MEDIUM
   - Export all settings
   - Import settings
   - **Why:** No way to backup config
   - **Storage:** JSON export/import

4. **Log Import** ⭐ LOW
   - Import logs from export
   - Merge with existing logs
   - **Why:** Can export but not import
   - **Storage:** Import via UI

5. **Database Optimization UI** ⭐ MEDIUM
   - Manual optimization button
   - Show table sizes
   - Show optimization results
   - **Why:** Only automatic optimization exists
   - **UI:** Settings → Maintenance tab

6. **Log Archiving UI** ⭐ MEDIUM
   - Manual archive trigger
   - View archived logs
   - Restore from archive
   - **Why:** Automatic only, no UI
   - **UI:** Settings → Maintenance tab

---

## 🎯 VERSION 1.7.0 - "Sentinel+ Automation"
**Release Theme:** Where "ACT" begins (opt-in, ruled, reversible)

### Premium Features
1. **Rule Engine** ⭐ CRITICAL
   - UI: Rule builder (IF event X happens Y times → DO action Z)
   - Actions: disable plugin, pause cron, clear transients, send email, block IP
   - Rate limiting per rule
   - Dry-run mode
   - **Why:** Incidents trigger actions but no custom rules
   - **Storage:** New table `wp_sentinel_rules`

2. **Action Audit Log** ⭐ CRITICAL
   - New table `wp_sentinel_action_log`
   - Log: who, what, when, why (rule ID or manual)
   - Show in dashboard
   - **Why:** Actions logged but not centralized
   - **Storage:** New table

3. **Kill-Switch Per Rule** ⭐ HIGH
   - Add `enabled` flag per rule
   - Quick toggle in UI
   - **Why:** Rules would be all-or-nothing
   - **Storage:** Rule table

4. **Manual Approval Mode** ⭐ MEDIUM
   - Require approval before actions execute
   - Email notification for approval
   - **Why:** Safety for critical actions
   - **Storage:** Rule settings

5. **Action Cooldowns** ⭐ MEDIUM
   - Prevent same action from firing too frequently
   - Per-rule cooldown settings
   - **Why:** Prevent action spam
   - **Storage:** Transient cache

6. **Suggested Actions** ⭐ MEDIUM
   - AI-suggested actions based on patterns
   - "Do this again?" prompts
   - **Why:** Help users discover automation
   - **UI:** Dashboard widget

---

## 🎯 VERSION 1.8.0 - "Sentinel+ Insights"
**Release Theme:** Tell me what's about to break

### Premium Features
1. **Performance Regression Detection** ⭐ CRITICAL
   - Compare current week vs last week
   - Alert on >20% memory increase
   - Alert on >50% slower response times
   - **Why:** Memory tracking exists but no trend analysis
   - **Storage:** Aggregate stats in options, recalc daily

2. **Change Correlation** ⭐ CRITICAL
   - Track: plugin activation, theme switch, core update
   - Compare error rates before/after
   - Show: "Errors increased 3x after Plugin X activation"
   - **Why:** Events logged but no correlation
   - **Storage:** Event correlation table or analysis on-demand

3. **Plugin Impact Scoring** ⭐ HIGH
   - Track memory usage per plugin (via memory monitor)
   - Track errors per plugin (via blame hints)
   - Score: (memory_impact + error_rate) / 2
   - **Why:** No plugin performance data
   - **Storage:** Transient cache, recalc weekly

4. **Update Risk Assessment** ⭐ HIGH
   - Track errors 24h before/after update
   - Calculate error rate change
   - Show: "This update increased errors by X%"
   - **Why:** Updates logged but no risk assessment
   - **Storage:** Compare pre/post update stats

5. **Long-Term Trends** ⭐ MEDIUM
   - 30/60/90 day trend analysis
   - Performance graphs
   - **Why:** Only short-term data visible
   - **Storage:** Aggregate daily stats

6. **Forecasting** ⭐ LOW
   - Predict when issues might occur
   - Based on historical patterns
   - **Why:** Reactive, not predictive
   - **Storage:** ML model or simple regression

---

## 🎯 VERSION 1.9.0 - "Developer Experience"
**Release Theme:** Make it easier for developers

### Core Features (Free)
1. **WP-CLI Commands** ⭐ HIGH
   - `wp sentinel logs list`
   - `wp sentinel logs export`
   - `wp sentinel events list`
   - `wp sentinel test`
   - **Why:** No CLI access
   - **File:** `includes/class-sentinel-cli.php`

2. **GraphQL API** ⭐ MEDIUM
   - GraphQL endpoint for logs
   - Flexible queries
   - **Why:** REST API exists but GraphQL is more flexible
   - **Integration:** WPGraphQL plugin or custom

3. **Webhook Receiver (Inbound)** ⭐ MEDIUM
   - Accept events from external sources
   - Validate webhook signatures
   - **Why:** Only outbound webhooks
   - **Storage:** Webhook config in settings

4. **Event Replay/Simulation** ⭐ LOW
   - Replay past events
   - Test event handling
   - **Why:** Debugging tool
   - **UI:** Developer tools page

5. **API Documentation** ⭐ HIGH
   - Interactive API docs
   - Code examples
   - **Why:** REST API exists but no docs
   - **Location:** `/wp-json/sentinel-plugin/v1/docs` or separate page

6. **Developer Hooks Documentation** ⭐ MEDIUM
   - List all available hooks
   - Examples for each hook
   - **Why:** Hooks exist but not documented
   - **Location:** Developer docs page

---

## 🎯 VERSION 2.0.0 - "Multi-Site & External"
**Release Theme:** I run more than one site

### Premium Features
1. **Cross-Site Dashboard** ⭐ CRITICAL
   - New plugin: "Sentinel Network"
   - Central dashboard aggregating all sites
   - **Why:** Single-site only
   - **Note:** Major architectural change

2. **External Sentinel Console** ⭐ CRITICAL
   - Web app at getsentinel.dev/console
   - OAuth authentication
   - Pull data via REST API
   - **Why:** REST API exists but no external UI
   - **Note:** Requires theme/website integration

3. **Central Alerting** ⭐ HIGH
   - Aggregate alerts from all sites
   - Single notification stream
   - **Why:** Managing multiple sites
   - **Storage:** External service or network admin

4. **Site Health Comparisons** ⭐ MEDIUM
   - Compare sites side-by-side
   - Identify problem sites
   - **Why:** Multi-site management
   - **UI:** Network dashboard

5. **Client-Friendly Summaries** ⭐ MEDIUM
   - Simplified reports for clients
   - Hide technical details
   - **Why:** Agency use case
   - **UI:** Report templates

6. **White-Label Reports** ⭐ LOW
   - Custom branding
   - Custom domains
   - **Why:** Agency white-labeling
   - **Storage:** Branding settings

---

## 🎯 VERSION 2.1.0 - "User Experience"
**Release Theme:** Make it beautiful and accessible

### Core Features (Free)
1. **Dark Mode** ⭐ HIGH
   - Toggle dark/light theme
   - Remember preference
   - **Why:** Eye strain, modern expectation
   - **Storage:** User meta

2. **Accessibility Improvements** ⭐ HIGH
   - WCAG 2.1 AA compliance
   - Screen reader support
   - Keyboard navigation
   - **Why:** Legal requirement, inclusivity
   - **Implementation:** ARIA labels, focus management

3. **Mobile Responsive Improvements** ⭐ MEDIUM
   - Better mobile dashboard
   - Touch-friendly controls
   - **Why:** Admin on mobile
   - **Implementation:** Responsive CSS improvements

4. **PWA Support** ⭐ LOW
   - Installable app
   - Offline support
   - **Why:** Modern web app experience
   - **Implementation:** Service Worker, manifest

5. **Browser Notifications** ⭐ MEDIUM
   - Real-time browser notifications
   - Permission management
   - **Why:** Don't miss critical alerts
   - **Implementation:** Web Notifications API

6. **Activity Feed Widget (Frontend)** ⭐ LOW
   - Shortcode for displaying activity
   - Public activity feed
   - **Why:** Transparency, engagement
   - **UI:** Shortcode `[sentinel_activity]`

---

## 🎯 VERSION 2.2.0 - "Advanced Monitoring"
**Release Theme:** Monitor everything

### Premium Features
1. **Query Monitoring** ⭐ HIGH
   - Track slow queries
   - Query performance analysis
   - **Why:** Database performance
   - **Storage:** New table `wp_sentinel_queries`

2. **Cache Monitoring** ⭐ MEDIUM
   - Object cache hits/misses
   - Page cache status
   - **Why:** Performance optimization
   - **Storage:** Transient cache stats

3. **CDN Integration Monitoring** ⭐ MEDIUM
   - CDN cache status
   - CDN error rates
   - **Why:** CDN is critical
   - **Integration:** Cloudflare, MaxCDN APIs

4. **Backup Monitoring** ⭐ MEDIUM
   - Backup success/failure
   - Backup age alerts
   - **Why:** Backup is critical
   - **Integration:** UpdraftPlus, BackupBuddy

5. **SSL Certificate Monitoring** ⭐ MEDIUM
   - Expiration alerts
   - Certificate health
   - **Why:** Security critical
   - **Storage:** Cron job checking certificates

6. **Domain Expiration Monitoring** ⭐ LOW
   - Expiration date tracking
   - Renewal reminders
   - **Why:** Prevent site downtime
   - **Integration:** WHOIS API

7. **Email Delivery Monitoring** ⭐ LOW
   - Track email sends
   - Delivery failures
   - **Why:** Email is critical
   - **Storage:** Email log table

8. **Payment Gateway Monitoring** ⭐ LOW
   - Payment success/failure rates
   - Gateway health
   - **Why:** Ecommerce critical
   - **Integration:** WooCommerce, EDD

9. **API Endpoint Monitoring** ⭐ MEDIUM
   - External API health
   - Response time tracking
   - **Why:** Third-party dependencies
   - **Storage:** API health table

10. **Server Resource Monitoring** ⭐ LOW
    - CPU, RAM, disk usage
    - Server health alerts
    - **Why:** Infrastructure monitoring
    - **Integration:** Server monitoring APIs

---

## 🎯 VERSION 2.3.0 - "Internationalization"
**Release Theme:** Speak everyone's language

### Core Features (Free)
1. **Translation System** ⭐ HIGH
   - Full i18n/l10n support
   - Translation files
   - **Why:** Global audience
   - **Implementation:** WordPress translation system

2. **RTL Support** ⭐ MEDIUM
   - Right-to-left language support
   - **Why:** Arabic, Hebrew users
   - **Implementation:** CSS RTL styles

3. **Date/Time Localization** ⭐ MEDIUM
   - User timezone support
   - Localized date formats
   - **Why:** Global users
   - **Storage:** User meta timezone

4. **Currency Localization** ⭐ LOW
   - Multi-currency support
   - **Why:** Global ecommerce
   - **Storage:** Settings option

---

## SUMMARY: What Sentinel DOESN'T Have (Priority Order)

### CRITICAL GAPS:
1. ❌ Full request timeline (time tracking)
2. ❌ Per-URL hotspot detection
3. ❌ Error fingerprinting
4. ❌ Webhooks (outbound)
5. ❌ Rule engine (Sentinel+)
6. ❌ Action audit log (Sentinel+)
7. ❌ Performance regression detection (Sentinel+)
8. ❌ Change correlation (Sentinel+)
9. ❌ Self-diagnostics page
10. ❌ Major integrations (Elementor, ACF, Rank Math, etc.)

### HIGH PRIORITY GAPS:
11. ❌ IP geolocation
12. ❌ User agent parsing
13. ❌ Session tracking
14. ❌ Search functionality
15. ❌ Bulk actions
16. ❌ Saved searches
17. ❌ Slack/Discord integration
18. ❌ WP-CLI commands
19. ❌ API documentation
20. ❌ Dark mode

### MEDIUM PRIORITY GAPS:
21. ❌ Custom dashboards
22. ❌ Activity timeline view
23. ❌ Settings backup/restore
24. ❌ Quiet hours
25. ❌ Environment detection
26. ❌ GraphQL API
27. ❌ Accessibility improvements
28. ❌ Query monitoring
29. ❌ Cache monitoring
30. ❌ Translation system

---

## VERSION STRATEGY

**v1.2.0** - Fix observation gaps (timeline, hotspots, errors)
**v1.3.0** - Add explanation features (why matters, grouping)
**v1.4.0** - Expand integrations (Elementor, ACF, etc.)
**v1.5.0** - Add notification channels (webhooks, Slack, Discord)
**v1.6.0** - Stability features (diagnostics, backup)
**v1.7.0** - Sentinel+ automation (rules, actions)
**v1.8.0** - Sentinel+ insights (regression, correlation)
**v1.9.0** - Developer tools (WP-CLI, GraphQL, docs)
**v2.0.0** - Multi-site & external console (major)
**v2.1.0** - UX improvements (dark mode, accessibility)
**v2.2.0** - Advanced monitoring (queries, cache, SSL)
**v2.3.0** - Internationalization

---

**Total Missing Features Identified: 100+**
**Critical Gaps: 10**
**High Priority: 10**
**Medium Priority: 10**
**Low Priority: 70+**

