How michaelgrant-libato/rigmd works
RigMD is a Windows PC diagnostic and controlled-remediation platform. A user submits symptoms through the frontend; the API combines them with live Windows telemetry, runs deterministic diagnosis, adds a constrained explanation, and persists a session. Users can review history and system health, then request guarded remediation with verification, rollback, or pivots. The README documents broader capabilities including recurring-pattern and warning-sign analysis, an optional remote agent, real-time updates, and optional database synchronization. Some frontend-to-API and unsampled subsystem links are documented only generally, so those edges are dashed.
Main entry points: DiagnosticEngineService.cs Diagnosis service · AutonomyController.cs Remediation endpoints · DiagnosticSessionRepository.cs Session repository · Program.cs ASP.NET API
Components 20
User experience
- RigMD frontend
frontend/src/App.jsx - Diagnosis views
frontend/src/pages/NewDiagnosisView.tsx - Health and history views
frontend/src/pages/DiagnosticHistoryView.tsx
Diagnosis and insights
- Diagnosis endpoints
backend-dotnet/RigMD.Api/Controllers/DiagnosticController.cs - Diagnosis service
backend-dotnet/RigMD.Application/Services/DiagnosticEngineService.cs - Deterministic rules
backend-dotnet/RigMD.Domain/Rules/DiagnosticEngine.cs - AI explanations
backend-dotnet/RigMD.Infrastructure/Ai/GeminiAiExplainer.cs - Pattern and warning analysis
backend-dotnet/RigMD.Application/Services/RecurringPatternService.cs
Controlled remediation
- Remediation endpoints
backend-dotnet/RigMD.Api/Controllers/AutonomyController.cs - Remediation orchestrator
backend-dotnet/RigMD.Application/Services/Autonomy/AutonomousOrchestrator.cs - Windows actions and verification
backend-dotnet/RigMD.Infrastructure/Remediation/WindowsRemediationExecutor.cs - Rollback manager
backend-dotnet/RigMD.Infrastructure/Remediation/RollbackManager.cs - Remediation updates
backend-dotnet/RigMD.Api/Hubs/RemediationHub.cs
Windows and persistence
- ASP.NET API
backend-dotnet/RigMD.Api/Program.cs - Session repository
backend-dotnet/RigMD.Infrastructure/Persistence/DiagnosticSessionRepository.cs - Local SQLite store
backend-dotnet/RigMD.Infrastructure/Persistence/RigMdDbContext.cs - Optional Supabase sync
backend-dotnet/RigMD.Infrastructure/Persistence/DatabaseSyncService.cs - Windows telemetry
backend-dotnet/RigMD.Infrastructure/Windows/WindowsSystemProfileService.cs - Remote Windows agent
backend-dotnet/RigMD.Agent/Worker.cs
Other components
- PC user
Connections 22
- PC user → RigMD frontend: uses
README.md - RigMD frontend → Diagnosis views: presents
frontend/src/App.jsx - PC user → Diagnosis views: submits symptoms
- Diagnosis views → ASP.NET API: submits diagnosis
- ASP.NET API → Diagnosis endpoints: routes requests
- Diagnosis endpoints → Diagnosis service: calls
backend-dotnet/RigMD.Api/Controllers/DiagnosticController.cs - Diagnosis service → Windows telemetry: reads profile
backend-dotnet/RigMD.Application/Services/DiagnosticEngineService.cs - Diagnosis service → Deterministic rules: runs rules
backend-dotnet/RigMD.Application/Services/DiagnosticEngineService.cs - Diagnosis service → AI explanations: requests explanation
backend-dotnet/RigMD.Application/Services/DiagnosticEngineService.cs - Diagnosis endpoints → Session repository: persists diagnosis
backend-dotnet/RigMD.Api/Controllers/DiagnosticController.cs - Session repository → Local SQLite store: reads and writes
backend-dotnet/RigMD.Infrastructure/Persistence/DiagnosticSessionRepository.cs - Local SQLite store → Optional Supabase sync: optional sync
README.md - Health and history views → ASP.NET API: requests insights
- Session repository → Pattern and warning analysis: supplies session data
- Remote Windows agent → ASP.NET API: sends telemetry
README.md - PC user → Remediation endpoints: requests remediation
- Remediation endpoints → Session repository: loads diagnosis
backend-dotnet/RigMD.Api/Controllers/AutonomyController.cs - Remediation endpoints → Remediation orchestrator: runs dry run
backend-dotnet/RigMD.Api/Controllers/AutonomyController.cs - Remediation orchestrator → Windows actions and verification: executes approved actions
README.md - Remediation orchestrator → Rollback manager: manages rollback
README.md - Remediation endpoints → Remediation updates: publishes updates
backend-dotnet/RigMD.Api/Controllers/AutonomyController.cs - RigMD frontend → Remediation updates: receives updates
README.md