docs(buglog): P0 defects fixed (bug-1936..bug-1955; 1936 and 1955 partial), bug-1956 cannot-reproduce

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

.wolf/bugs/bug-1948.md

@@ -1,8 +1,8 @@
 ---
 id: "bug-1948"
-status: "open"
+status: "fixed"
 status_updated: "2026-10-10"
-status_note: "newly logged"
+status_note: ""
 component: "apiserver"
 severity: "security"
 timestamp: "2026-10-10T08:15:06Z"
@@ -11,6 +11,7 @@ occurrences: 1
 files: ["src/frontend/apiserver/router/routers.go"]
 tags: ["apiserver", "security", "whitelist"]
 related: []
+fix_commits: ["c4c63f11"]
 ---
 
 # bug-1948: apiserver trusts X-Forwarded-For from any client, so IP whitelist and JWT IP binding can be spoofed
@@ -36,15 +37,16 @@ The router uses `gin.Default()` (`router/routers.go:19`) and never calls `SetTru
 - Frequency: deterministic (by code reading; confirmed by the RED test of the fix)
 - Evidence: the code sites quoted in Description; no logs kept.
 ## Root cause
-TODO: required for fixed/partial
+`router.Router()` used `gin.Default()` without `SetTrustedProxies`, so `ClientIP()` honoured X-Forwarded-For from any peer.
 
 ## Fix
-TODO: required for fixed/partial
+New `app.yaml` option `security.trusted_proxies` (IP/CIDR, default empty = none), validated at startup; `Router()` passes it to `SetTrustedProxies` (falls back to none if invalid); schema and nginx samples documented.
 
 ## Verification
-- Test: TODO: name + file; RED before the fix, GREEN after
-- Suites: TODO: suite results and build profile
-- Live: TODO: soak/deploy run, or n/a and why
+- Test: `TestRouter_IgnoresForwardedForByDefault` (`router/routers_test.go`, real `Router()`): RED `non-whitelisted peer spoofing X-Forwarded-For: status = 200, want 403`, GREEN after; plus `TestRouter_HonoursForwardedForFromTrustedProxy`, `TestResolveTrustedProxies`.
+- Suites: `xce-build.sh all asan xce.build --incremental` on the merged branch, 2026-10-10: all C suites Ok 155 / Fail 0, frontend Go unit tests ok, xceadmin tests ok; apiserver `CGO_ENABLED=0 go test ./...` (incl. middleware, router, cmd) ok
+- Live: n/a: unit/fixture-level verification only; no live deployment was run (follow-up)
 
 ## References
-- Related: none
+- Fix commit: `c4c63f11` (on `scheduler-framework`; worker-branch original in the merge)
+- Review: `.kiro/reviews/project-gap-review-2026-10-10.md`