feat(server): integrate MCP queries and investigation messaging

Add project-bound OAuth MCP queries and controlled analysis with scoped evidence,
limits, timeouts and a nearby-model spatial query using EPSG:4326 inputs.
Default nearby searches to 200 meters and five results.

Integrate investigation messaging/presentation, health/readiness and typed history;
remove duplicate web search and fix online simulation and compressed baseline writes.
Include project migrations 023-025; keep local credentials and demo seeding excluded.

Validation: 319 focused pytest checks; real PostGIS temporary-table regression;
read-only Jinqian bridge radius comparison; cross-language MCP discovery/calls.

README.md

@@ -43,6 +43,13 @@ conda run -n server uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
 conda activate server
 ```
 
+`GET /health` 是无需鉴权的 HTTP 服务存活检查，返回 `200` 和 `{"status":"ok"}`，不查询数据库。
+`GET /ready` 检查应用启动状态、元数据库 `SELECT 1` 及已启用的 MCP 传输生命周期；
+全部就绪返回 `200`，否则返回 `503`，元数据库探测预算为2秒。MCP 关闭时标记为
+`disabled`，不阻止就绪。返回结果不包含数据库地址、凭据或原始异常，禁止缓存。
+就绪状态不等同于 OAuth、用户权限或真实工具调用成功；指定项目的业务库和时序库仍通过
+带身份与 `X-Project-Id` 的 `GET /api/v1/projects/current/database-health` 检查。
+
 ## 常用命令
 
 外围接入样板是独立进程，复用 PostgreSQL，不自动建表；启动、授权边界和契约见 [外围样板说明](docs/peripheral-sample.md)。
@@ -76,6 +83,16 @@ docker compose -f infra/docker/docker-compose.yml config
 - `iot_data` DSN 用于 TimescaleDB，始终使用元数据配置的完整 DSN，不再从项目代码推导数据库名。
 - 元数据、业务库和 TimescaleDB 可以部署在同一主机，也可以分别部署。
 
+在线重算会原子替换一个时刻的节点、管段基线。历史分块已经压缩时，写入事务使用
+`TIMESCALEDB_REALTIME_MAX_DECOMPRESSED_TUPLES` 设置解压预算，默认100万条；配置必须
+为正整数，不允许0。该设置仅在实时快照写入事务内生效，不改变数据库全局设置或普通读取。
+预算按需根据受影响压缩批次的规模调整，超过预算仍会失败并回滚当前快照；此前完成的其他
+时刻不会一起回滚。同步、异步及单表批量快照入口使用同一预算。
+
+压缩写入回归位于 `tests/integration/test_realtime_compression.py`；仅在设置
+`REALTIME_COMPRESSION_TEST_DSN` 时执行，并且只接受库名以 `tjw_test_realtime_` 开头的
+独立可丢弃数据库。测试会创建和删除该库内的 `realtime` schema，禁止指向项目数据库。
+
 完整新建供水项目使用 `POST /api/v1/admin/project-provisions`，以
 `multipart/form-data` 同时提交 `name`、小写 `code`、可选的
 `description`、`gs_workspace`、`map_zoom` 和 INP `file`。工作流会按顺序完成：
@@ -119,3 +136,7 @@ Gitea 包工作流位于 `.gitea/workflows/package.yml`，通常由 tag 触发
 ## 安全规则
 
 不要提交 `.env`、客户数据、数据库 dump、日志、生成缓存、`db_inp/`、`temp/`、`data/` 或本地密钥。CI/CD 凭据应放在 Gitea secrets 和仓库变量中。
+
+## 产品 MCP 查询
+
+Server 可选启用 MCP 2026-07-28 的25项项目查询及10项受控分析，默认关闭。它使用专用 OAuth resource Bearer、宿主绑定上下文及现有项目/任务权限，调查查询返回前持久化证据。启用需更新依赖、应用项目 SQL 迁移和配置 Keycloak token exchange；这些生产操作尚未执行。详见 [实施与启用](docs/mcp-query-implementation.md) 和 [协议/旧 CLI 能力对照](docs/mcp-query-design.md)。