stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

Doctor plugin checks: implement health check classes and documentation

Browse Source 
Implement remediation-aware health checks across all Doctor plugin modules
(Agent, Attestor, Auth, BinaryAnalysis, Compliance, Crypto, Environment,
EvidenceLocker, Notify, Observability, Operations, Policy, Postgres, Release,
Scanner, Storage, Vex) and their backing library counterparts (AI, Attestation,
Authority, Core, Cryptography, Database, Docker, Integration, Notify,
Observability, Security, ServiceGraph, Sources, Verification).

Each check now emits structured remediation metadata (severity, category,
runbook links, and fix suggestions) consumed by the Doctor dashboard
remediation panel.

Also adds:
- docs/doctor/articles/ knowledge base for check explanations
- Advisory AI search seed and allowlist updates for doctor content
- Sprint plan for doctor checks documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
master
2026-03-27 12:28:00 +02:00
parent fbd24e71de
commit c58a236d70
326 changed files with 18500 additions and 463 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
src/__Libraries/StellaOps.Doctor.Plugins.Sources/Checks/MirrorServerAuthCheck.cs
View File

@@ -94,7 +94,8 @@ public sealed class MirrorServerAuthCheck : IDoctorCheck
"Missing required OAuth issuer configuration")
.WithRemediation(r => r
.AddManualStep(1, "Configure OAuth settings", "Add 'sources:mirrorServer:oauth' section with issuer URL")
.AddShellStep(2, "Run setup wizard", "stella setup --step sources"))
.AddShellStep(2, "Run setup wizard", "stella setup --step sources")
.WithRunbookUrl(""))
.WithVerification("stella doctor --check check.sources.mirror.auth")
.Build());
}
@@ -112,7 +113,8 @@ public sealed class MirrorServerAuthCheck : IDoctorCheck
.WithCauses("OAuth Issuer URL not configured")
.WithRemediation(r => r
.AddManualStep(1, "Configure OAuth issuer", "Set 'sources:mirrorServer:oauth:issuer' to your OIDC provider URL")
.AddShellStep(2, "Verify issuer metadata", "curl -s {issuer}/.well-known/openid-configuration"))
.AddShellStep(2, "Verify issuer metadata", "curl -s {issuer}/.well-known/openid-configuration")
.WithRunbookUrl(""))
.WithVerification("stella doctor --check check.sources.mirror.auth")
.Build());
}

3
src/__Libraries/StellaOps.Doctor.Plugins.Sources/Checks/MirrorServerRateLimitCheck.cs
View File

@@ -133,7 +133,8 @@ public sealed class MirrorServerRateLimitCheck : IDoctorCheck
.WithCauses(warnings.ToArray())
.WithRemediation(r => r
.AddManualStep(1, "Review rate limit configuration", "Check sources:mirrorServer:rateLimits in configuration")
.AddManualStep(2, "Set appropriate limits", "Configure MaxRequests and PerSeconds for your expected traffic"))
.AddManualStep(2, "Set appropriate limits", "Configure MaxRequests and PerSeconds for your expected traffic")
.WithRunbookUrl(""))
.WithVerification("stella doctor --check check.sources.mirror.ratelimit")
.Build());
}

6
src/__Libraries/StellaOps.Doctor.Plugins.Sources/Checks/SourceConnectivityCheck.cs
View File

@@ -121,7 +121,8 @@ public sealed class SourceConnectivityCheck : IDoctorCheck
}
})
.WithCauses(checkResult.PossibleReasons.ToArray())
.WithRemediation(r => BuildRemediation(r, checkResult))
.WithRemediation(r => BuildRemediation(r, checkResult
.WithRunbookUrl(""))
.WithVerification($"stella doctor --check {CheckId}")
.Build();
}
@@ -148,7 +149,8 @@ public sealed class SourceConnectivityCheck : IDoctorCheck
}
})
.WithCauses(checkResult.PossibleReasons.ToArray())
.WithRemediation(r => BuildRemediation(r, checkResult))
.WithRemediation(r => BuildRemediation(r, checkResult
.WithRunbookUrl(""))
.WithVerification($"stella doctor --check {CheckId}")
.Build();
}

6
src/__Libraries/StellaOps.Doctor.Plugins.Sources/Checks/SourceModeConfiguredCheck.cs
View File

@@ -61,7 +61,8 @@ public sealed class SourceModeConfiguredCheck : IDoctorCheck
"Configuration not loaded properly")
.WithRemediation(r => r
.AddManualStep(1, "Add sources section to configuration", "Add 'sources:' section to appsettings.json or environment-specific config")
.AddShellStep(2, "Run setup wizard", "stella setup --step sources"))
.AddShellStep(2, "Run setup wizard", "stella setup --step sources")
.WithRunbookUrl(""))
.WithVerification("stella doctor --check check.sources.mode.configured")
.Build());
}
@@ -87,7 +88,8 @@ public sealed class SourceModeConfiguredCheck : IDoctorCheck
"Mirror server URL not specified")
.WithRemediation(r => r
.AddManualStep(1, "Configure mirror server", "Add 'sources:mirrorServer' section with URL and authentication settings")
.AddShellStep(2, "Run setup wizard", "stella setup --step sources"))
.AddShellStep(2, "Run setup wizard", "stella setup --step sources")
.WithRunbookUrl(""))
.WithVerification("stella doctor --check check.sources.mode.configured")
.Build());
}