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.Authority/Checks/AuthorityPluginConfigurationCheck.cs
View File

@@ -122,7 +122,8 @@ public sealed class AuthorityPluginConfigurationCheck : IDoctorCheck
CommandType.FileEdit)
.AddStep(3, "Run setup wizard to configure",
"stella setup --step authority",
CommandType.Shell))
CommandType.Shell)
.WithRunbookUrl("docs/doctor/articles/auth/authority-plugin-configured.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}
@@ -139,7 +140,8 @@ public sealed class AuthorityPluginConfigurationCheck : IDoctorCheck
.WithCauses(issues.ToArray())
.WithRemediation(r => r
.AddManualStep(1, "Review configuration", "Check Authority:Plugins section for missing values")
.AddStep(2, "Run setup wizard", "stella setup --step authority", CommandType.Shell))
.AddStep(2, "Run setup wizard", "stella setup --step authority", CommandType.Shell)
.WithRunbookUrl("docs/doctor/articles/auth/authority-plugin-configured.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}

1
src/__Libraries/StellaOps.Doctor.Plugins.Authority/Checks/AuthorityPluginConnectivityCheck.cs
View File

@@ -98,6 +98,7 @@ public sealed class AuthorityPluginConnectivityCheck : IDoctorCheck
r.AddManualStep(3, "Check LDAP server", "Verify LDAP server is accessible from this network");
r.AddManualStep(4, "Verify LDAP credentials", "Check Authority:Plugins:Ldap:BindDn and BindPassword");
}
r.WithRunbookUrl("docs/doctor/articles/auth/authority-plugin-connectivity.md");
})
.WithVerification($"stella doctor --check {CheckId}")
.Build();

6
src/__Libraries/StellaOps.Doctor.Plugins.Authority/Checks/BootstrapUserExistsCheck.cs
View File

@@ -81,7 +81,8 @@ public sealed class BootstrapUserExistsCheck : IDoctorCheck
CommandType.FileEdit)
.AddStep(2, "Or run setup wizard to create user",
"stella setup --step users",
CommandType.Shell))
CommandType.Shell)
.WithRunbookUrl("docs/doctor/articles/auth/authority-bootstrap-exists.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}
@@ -123,7 +124,8 @@ public sealed class BootstrapUserExistsCheck : IDoctorCheck
.WithCauses(issues.ToArray())
.WithRemediation(r => r
.AddManualStep(1, "Complete configuration", "Set missing bootstrap user fields")
.AddStep(2, "Run setup wizard", "stella setup --step users", CommandType.Shell))
.AddStep(2, "Run setup wizard", "stella setup --step users", CommandType.Shell)
.WithRunbookUrl("docs/doctor/articles/auth/authority-bootstrap-exists.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}

3
src/__Libraries/StellaOps.Doctor.Plugins.Authority/Checks/SuperUserExistsCheck.cs
View File

@@ -106,7 +106,8 @@ public sealed class SuperUserExistsCheck : IDoctorCheck
"\"Authority\": {\n" +
" \"Bootstrap\": { \"Enabled\": true }\n" +
"}",
CommandType.FileEdit))
CommandType.FileEdit)
.WithRunbookUrl("docs/doctor/articles/auth/users-superuser-exists.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}

6
src/__Libraries/StellaOps.Doctor.Plugins.Authority/Checks/UserPasswordPolicyCheck.cs
View File

@@ -115,7 +115,8 @@ public sealed class UserPasswordPolicyCheck : IDoctorCheck
" \"RequireSpecialCharacter\": true\n" +
" }\n" +
"}",
CommandType.FileEdit))
CommandType.FileEdit)
.WithRunbookUrl("docs/doctor/articles/auth/users-password-policy.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}
@@ -134,7 +135,8 @@ public sealed class UserPasswordPolicyCheck : IDoctorCheck
.WithCauses(recommendations.ToArray())
.WithRemediation(r => r
.AddManualStep(1, "Review recommendations", "Consider strengthening password policy")
.AddStep(2, "Run setup wizard", "stella setup --step authority", CommandType.Shell))
.AddStep(2, "Run setup wizard", "stella setup --step authority", CommandType.Shell)
.WithRunbookUrl("docs/doctor/articles/auth/users-password-policy.md"))
.WithVerification($"stella doctor --check {CheckId}")
.Build());
}