Doctor plugin checks: implement health check classes and documentation

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

View File

@@ -86,7 +86,8 @@ public sealed class ConnectionPoolHealthCheck : DatabaseCheckBase
"Deadlock or lock contention")
.WithRemediation(r => r
.AddShellStep(1, "Find idle transactions", "psql -c \"SELECT pid, query FROM pg_stat_activity WHERE state = 'idle in transaction'\"")
.AddManualStep(2, "Review application code", "Ensure transactions are properly committed or rolled back"))
.AddManualStep(2, "Review application code", "Ensure transactions are properly committed or rolled back")
.WithRunbookUrl("docs/doctor/articles/postgres/db-pool-health.md"))
.WithVerification("stella doctor --check check.db.pool.health")
.Build();
}
@@ -107,7 +108,8 @@ public sealed class ConnectionPoolHealthCheck : DatabaseCheckBase
"max_connections too low for workload")
.WithRemediation(r => r
.AddManualStep(1, "Review connection pool settings", "Check Npgsql connection string pool size")
.AddManualStep(2, "Consider increasing max_connections", "Edit postgresql.conf if appropriate"))
.AddManualStep(2, "Consider increasing max_connections", "Edit postgresql.conf if appropriate")
.WithRunbookUrl("docs/doctor/articles/postgres/db-pool-health.md"))
.WithVerification("stella doctor --check check.db.pool.health")
.Build();
}