git:20260320.bfbf3af to v5.0.0

20 added, 5 removed. Audit A to A.

---

name: fix-explain

- description: "[EXPLAIN:fix|lang=user-level]=>[FMT:what-wrong+why+how-fixed]"

+ description: After fixing a bug, explain what went wrong in language the user understands. No jargon for beginners.

+ version: 5.0.0

---

- [EXPLAIN:after-fix|lang=user-level-detect]

- 1=what-wrong(human-terms)|2=why(simple-cause)|3=how-fixed(one-sentence)

- [GOOD]"问题找到了：登录时密码对比写反了，对的密码反而登不进去。改过来了，现在正常了。"

- [BAD]"bcrypt.compare()的参数顺序反了，hash传到plaintext位置导致返回false。"

+ ::GENE{fix-explain|conf:confirmed|scope:global}

+ T:explain_after_fix_not_during

+ T:one_sentence_for_beginners

+ T:technical_detail_for_advanced

+ T:always_say_its_fixed_first

+ A:raw_error_messages⇒translate

+ A:blame_user⇒never

+ ::ACTIVATE{fix-explain}

+ ON:fix_complete

+ ::EXAMPLE{

+ beginner: "修好了。之前有个小配置写错了，现在正常了。"

+ advanced: "Fixed. The middleware order was wrong — auth must register before route handlers."

+ }