Deforester：写给 Janet 的结构化日志库与一套日志设计哲学

概述

Deforester 是一套纯 Janet 写的小型日志库（100% Janet），readme 本身就是一篇关于'如何正确地写日志'的设计心得。它遵循'事件（table）→ 处理器 → 格式化（table→string）→ 写出'的现代生产流程：先由 :level 过滤再求值参数、默认落到 stderr 让日志失败不致崩溃、输出 NDJSON（配 json/encode 用 jq 消费）；针对个人计算还提供 file-writer 与 text-format。绑定包括 log、set-logger!、with-log-ctx、with-duration-logged、with-config 等；with-config 特别适合测试（可把日志捕获进缓冲区、甚至覆盖 :msg/:time 做快照断言）；还可写 processor 仿 Go 的 Zap 转发错误事件到 Sentry 之类，或做采样。文章借此阐述日志哲学：日志 wide events 记结果而非动作、记录决策与原因、键名保持一致且 msg 应作事件名而非散文、凡 I/O 都量 :ms；只把发现点写进日志，事实留在 state 里别把日志当数据库。对 level 的态度也很有意思——level 混淆了'值得多少注意'与'作为过滤值的含义'，因此建议 :debug/:info/:warn/:error 只按'注意程度与受众'划分。