用途：通过 Warden Service 只读 API 查询并返回有边界、基于证据的答案，用于检查、搜索、汇总或导出 Warden 的运行记录（runs）、发现项（findings）、成本与结果等。
主要能力：读取 /api/v1/runs 与 /api/v1/findings 等文档化路由，支持按仓库、时间范围、技能、严重级别等过滤，使用游标分页（nextCursor 视为不透明值原样回传），并汇总相关 JSON 字段。
使用方式：先确认 Warden Service 源地址并检查 WARDEN_PAT 是否已设置（不要显示其值）；若缺失，引导用户在 Warden Service 仪表盘的 API access 中创建个人令牌并导出为 WARDEN_PAT，切勿要求粘贴到聊天或命令字面量中。查阅 references/read-api.md 选择确切路由、过滤器、分页行为与响应字段。请求示例：
curl --fail-with-body --silent --show-error --get
-H 'Accept: application/json'
-H "Authorization: Bearer ${WARDEN_PAT}"
--data-urlencode 'severity=high'
--data-urlencode 'skill=security-review'
--data-urlencode 'limit=30'
"${WARDEN_SERVICE_URL%/}/api/v1/findings"
所有查询值需 URL 编码，仅在需要更多结果时跟随 nextCursor，并保留原过滤器。
错误处理：结合 HTTP 状态与 JSON 的 error.code、error.message 判断。400 表示过滤参数无效，需修正参数名、值或 RFC 3339 时间戳；401 表示认证缺失、无效或过期，需核对源地址并通过 API access 更换令牌；403 表示角色不足或个人令牌操作不被允许，应保持只读并限制在令牌的仓库范围内；404 表示路由或资源未知/未授权，需核对文档化路由或 ID；429 表示被限流，应等待后重试，不要紧密循环重试。
限制：个人令牌仅用于 GET 或 HEAD，禁止 POST、PUT、PATCH、DELETE；不得泄露、记录、持久化、嵌入命令字面量或要求用户粘贴令牌；须遵守令牌的租户、角色与仓库限制，不得绕过；仅使用 references/read-api.md 中记录的路由、过滤器与响应字段；仅获取并展示用户所述范围所需的数据，仅在用户明确要求导出时使用导出路由；若只读 API 无法回答问题，应如实说明，不得改用 ingest、memory-recall、token-management、retention 或 deletion 请求。