spaxel/mothership/internal/api
jedarden 4a4e8a114a feat: implement guided troubleshooting with proactive contextual help
Implements Component 36: Guided Troubleshooting system with proactive
contextual help and post-feedback explanations.

Backend (mothership/internal/guidedtroubleshoot/):
- Manager: Coordinates all guided troubleshooting features
- EditTracker: Monitors repeated settings edits (3 in 60min triggers hint)
- ZoneQualityTracker: Detects quality degradation (<60% for >24h)
- DiscoveryTracker: First-time feature discovery tooltips
- FleetNotifier: Node offline event handling with 2min grace period

API (mothership/internal/api/guided.go):
- GET /api/guided/issues - List active troubleshooting issues
- POST /api/guided/issues/quality/{zoneId}/dismiss - Dismiss quality banner
- POST /api/guided/feedback/response - Inline feedback response
- POST /api/guided/calibration/complete - Calibration reinforcement
- GET /api/guided/node/{mac}/troubleshoot - Node troubleshooting steps
- GET /api/guided/tooltip/{featureId} - Feature discovery tooltips
- POST /api/guided/tooltip/{featureId}/dismiss - Dismiss tooltip

Frontend:
- troubleshoot.js: Node offline cards, quality banners, calibration reinforcement
- guided-help.js: Step-by-step guides for common troubleshooting scenarios
- tooltips.js: First-time feature discovery with localStorage persistence
- feedback.js: Thumbs-up/down feedback with inline responses

Integration:
- Settings edit tracking via SetEditTracker on settingsHandler
- WebSocket events for quality_drop, repeated_edit, calibration_complete
- Hub broadcasts node status changes for FleetNotifier
- Main.go initializes guidedMgr with zones and fleet callbacks

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 04:25:31 -04:00
..
analytics.go feat: complete anomaly detection & security mode dashboard UI 2026-04-09 05:59:54 -04:00
backup.go feat: implement SQLite Online Backup API streaming endpoint 2026-04-07 02:15:51 -04:00
backup_test.go feat: implement SQLite Online Backup API streaming endpoint 2026-04-07 02:15:51 -04:00
ble_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
briefing.go feat: complete morning briefing feature with provider adapters and API fixes 2026-04-10 04:25:31 -04:00
briefing_test.go feat: implement morning briefing feature 2026-04-10 00:25:33 -04:00
diurnal.go feat: add diurnal baseline REST API endpoints 2026-04-09 08:53:31 -04:00
diurnal_test.go feat: add diurnal baseline REST API endpoints 2026-04-09 08:53:31 -04:00
events.go feat: add anomaly_detected and sleep_session_end to valid event types 2026-04-09 15:30:45 -04:00
events_test.go feat: implement POST /api/events/{id}/feedback endpoint 2026-04-09 15:17:47 -04:00
feedback.go feat: implement guided troubleshooting with proactive contextual help 2026-04-10 04:25:31 -04:00
guided.go feat: implement guided troubleshooting with proactive contextual help 2026-04-10 04:25:31 -04:00
localization.go feat: add self-improving localization REST API 2026-04-09 10:06:06 -04:00
localization_test.go feat: add self-improving localization REST API 2026-04-09 10:06:06 -04:00
notifications.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
notifications_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
prediction.go feat: implement presence prediction REST API endpoints 2026-04-09 09:59:42 -04:00
prediction_test.go feat: implement presence prediction REST API endpoints 2026-04-09 09:59:42 -04:00
replay.go feat: implement time-travel debugging and CSI replay 2026-04-09 19:27:42 -04:00
replay_test.go feat: implement CSI simulator CLI with GDOP overlay 2026-04-09 12:31:13 -04:00
security.go feat: implement anomaly detection and security mode 2026-04-09 09:48:44 -04:00
security_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 14:47:44 -04:00
settings.go feat: implement guided troubleshooting with proactive contextual help 2026-04-10 04:25:31 -04:00
settings_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
simulator.go feat: complete pre-deployment simulator implementation 2026-04-09 21:30:47 -04:00
tracks.go feat: complete anomaly detection & security mode dashboard UI 2026-04-09 05:59:54 -04:00
tracks_test.go feat: complete anomaly detection & security mode dashboard UI 2026-04-09 05:59:54 -04:00
triggers.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
triggers_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
utils.go feat: verify dashboard WebSocket feed supports events, alerts, BLE, triggers, health 2026-04-07 09:54:14 -04:00
volume_triggers.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
volume_triggers_test.go feat: wire anomaly detection & security mode API endpoints 2026-04-07 15:09:34 -04:00
zones.go feat: verify zones CRUD REST endpoints with full test coverage 2026-04-07 15:00:32 -04:00
zones_test.go feat: add missing name-required validation test for zone creation 2026-04-07 15:00:32 -04:00