用途：集成、运行或修改 @wardx/server。Wardx 在一个受限进程内提供两个应用面：客户端使用 POST /v1/sync，智能体使用 stdio 或可选的仅回环 Streamable HTTP 上的 MCP。没有管理 REST API，也不支持多副本模式。
主要能力：程序化集成与 handler/server 生命周期、配置与内部机制；MCP 调查工具（list_projects、get_project_overview、get_aggregates、get_aggregate_history、get_recent_events、get_recent_logs）；Remote Config 条件规则；实验（assignmentUnitKind、goalMetric、terminalRetentionMs，客户端分配，XXHash64 账本去重）；历史遥测与留存（get_retention 提供 D1/D7/D30 精确计数）。
使用方式：框架自有 HTTP/HTTPS 传输用 createWardxHandler(config) 并保留其 stop 函数；由 Wardx 拥有监听器与进程信号时用 startServer。本地 MCP 客户端以 stdio 启动 wardx-server <config.json>；远程保持 mcpHttp.host 在回环，令牌经环境变量提供并通过 SSH 本地转发访问。使用新 API 前先检查已安装包的导出。
限制：只读调查不授权目录/配置/实验变更；每次授权变更需当前 expectedVersion 和非空 reason，冲突时重读状态而非盲目重试。首次可信曝光后不得更改 salt、变体、角色、目标、分配单元或分析策略。单进程对应单个本地 SQLite WAL 数据库，不得共享文件或放在 NFS。生产操作需明确授权。GET /health 仅存活，/ready 用于就绪。容量上限会拒绝超额同步处理器、历史批次、账本行、MCP 读取、序列与查询范围。5,000 sync/s 是发布目标而非证明。故障排查：unknown project 用 list_projects 名称；version conflict 重读项目；role not allowed 用对应角色凭据；not ready to ship 收集可信证据；empty history 检查层级/范围/终结与工具选择；no tools 检查 MCP 启动或 SSH 隧道。其余细节暂未提供。