From f6c8a4815034b0801ec257809f23172b52e9a8bc Mon Sep 17 00:00:00 2001 From: djmil Date: Wed, 3 Jun 2026 20:04:52 +0000 Subject: [PATCH] pkg/logger: document INFO field-hiding as design contract, not limitation Co-Authored-By: Claude Sonnet 4.6 --- pkg/logger/handler.go | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pkg/logger/handler.go b/pkg/logger/handler.go index 30580e0..cf9a23c 100644 --- a/pkg/logger/handler.go +++ b/pkg/logger/handler.go @@ -47,6 +47,10 @@ type writeState struct { // INFO: message: k=v, … full fields — debug mode dumps everything // WARN: warning: msg: k=v, … // ERROR: error: msg: k=v, … +// +// INFO fields are intentionally hidden in normal mode: they are context for a +// debug session, not alerts for the operator. Put fields on WARN or ERROR when +// the reader needs them immediately to understand a problem. type humanHandler struct { w io.Writer level slog.Level