fix(api): expose kb_ready and gate E2E/nightly on shared KB

Health reports kb_ready; PI E2E uses layered Load + require-online;
nightly preflights SELECT 1 before product suite.

Co-authored-by: Cursor <cursoragent@cursor.com>

configs/.env.dev.example

@@ -21,6 +21,8 @@ SYSTEM_DB_NAME=agent_system_dev
 SYSTEM_DB_PUBLISH_PORT=5433
 
 # 4. 共享知识库（容器 app 经 shuimu-kb-shared 访问）
+# KB_DB_PASSWORD 必须在仓库根 .env 提供；config.Load("") 会分层合并根 .env + 本文件。
+# 勿依赖代码内默认口令（已清空）；宿主机 go test / 本地进程同样走分层 Load。
 KB_DB_USER=regkb
 KB_DB_NAME=regulations
 KB_DB_HOST=shuimu-kb-shared