Document what the cert and auth sweeps will not do

This commit is contained in:
Gmer4Lfe
2026-08-25 16:39:01 -04:00
parent 68c835f33b
commit c0e7a97a56
3 changed files with 83 additions and 0 deletions
+15
View File
@@ -40,6 +40,21 @@
// downstream of something else here, and listing it alongside its own cause invites fixing the
// symptom.
//
// OPERATIONAL SAFEGUARDS
// Read-only. Opens certbot's logs and nothing else — no certificate is requested, renewed or
// deleted here, and no log is rotated or truncated.
//
// Bounded by file count and by bytes per file, so a directory that has grown to 639 MB across
// 1001 files cannot turn a page load into an unbounded read. Only the tail of each log is
// examined, because a run explains its failure at the end rather than the beginning.
//
// An unrecognised failure is reported as unclassified, never folded into the nearest category.
// A tidy chart that is wrong sends the operator to fix a domain that was never broken.
//
// The log directory is discovered from the NPM container rather than assumed, so a container
// path change surfaces as "no logs found" instead of an empty triage that reads as "no
// failures".
//
// RUNTIME MODES
// cert_triage.php summary — categories, affected domains, and the causal reading
// cert_triage.php --json the same as JSON, for the Certs tab