feat: 实现 Sense↔Brain 配置与运行状态 connector (#152) #164

Merged
ila merged 1 commits from feature/152-brain-control into dev 2026-08-31 15:15:49 +08:00
Owner

关联工单

Closes #152(验收后由工作流关闭工单;本 PR 不自动合并)

实现

  • Sense 生成 credential-free source-config/v1 快照,持久分配 revision,并通过机器身份发送
  • Brain 严格校验版本、摘要、Profile/几何/状态,幂等持久应用并保留 last-known-good
  • Brain 生成持久单调 sequence 的 runtime-status/v1;Sense 做只读持久投影、陈旧/离线/恢复及 revision mismatch 判定
  • 双端使用 #151 可注入 replay 接口,各自数据库内原子持久防重放,覆盖重启
  • 支持安全停用、超时、指数退避和 correlation ID;未实现模型分发、Bell、根级部署或 E2E

验证

  • Brain .venv Python 3.11.15:connector 5/5;全量 48/48
  • Sense:go test ./... 全量通过
  • Sense connector/migration:通过;独立集成模块通过
  • Sense connector 与集成模块定向 -race:通过
  • go vet(connector + migration):通过
  • 冻结契约:source-config 11/11、runtime-status 14/14、machine-identity 10/10
  • python dev_scripts/harness.py check --strict:通过
  • git diff --check、秘密扫描、精确 write_paths 审计:通过

边界与未验证

  • 严格未修改 Bell/**、contracts/**、docs/**、根级部署和其他未授权路径
  • 未做真实双机 TLS/网络故障注入、PostgreSQL 实例集成与生产部署验证;这些属于后续 E2E/部署范围
  • 按工单要求不更新 Wiki/docs,待人工验收后由主流程处理长期文档
## 关联工单 Closes #152(验收后由工作流关闭工单;本 PR 不自动合并) ## 实现 - Sense 生成 credential-free `source-config/v1` 快照,持久分配 revision,并通过机器身份发送 - Brain 严格校验版本、摘要、Profile/几何/状态,幂等持久应用并保留 last-known-good - Brain 生成持久单调 sequence 的 `runtime-status/v1`;Sense 做只读持久投影、陈旧/离线/恢复及 revision mismatch 判定 - 双端使用 #151 可注入 replay 接口,各自数据库内原子持久防重放,覆盖重启 - 支持安全停用、超时、指数退避和 correlation ID;未实现模型分发、Bell、根级部署或 E2E ## 验证 - Brain `.venv` Python 3.11.15:connector 5/5;全量 48/48 - Sense:`go test ./...` 全量通过 - Sense connector/migration:通过;独立集成模块通过 - Sense connector 与集成模块定向 `-race`:通过 - `go vet`(connector + migration):通过 - 冻结契约:source-config 11/11、runtime-status 14/14、machine-identity 10/10 - `python dev_scripts/harness.py check --strict`:通过 - `git diff --check`、秘密扫描、精确 write_paths 审计:通过 ## 边界与未验证 - 严格未修改 `Bell/**`、`contracts/**`、`docs/**`、根级部署和其他未授权路径 - 未做真实双机 TLS/网络故障注入、PostgreSQL 实例集成与生产部署验证;这些属于后续 E2E/部署范围 - 按工单要求不更新 Wiki/docs,待人工验收后由主流程处理长期文档
ila added 1 commit 2026-08-31 11:52:01 +08:00
ila force-pushed feature/152-brain-control from ce1778b47a to 82afce1f81 2026-08-31 11:52:01 +08:00 Compare
Author
Owner

主审修订完成(2026-08-31)

  • 双端统一严格校验 X-Request-ID:^[A-Za-z0-9][A-Za-z0-9._:-]{15,127}$,即 16–128 字符,拒绝短值、换行/控制字符、非法字符与超长值。
  • Brain source-config/v1 consumer 补齐 extensions Schema:必须为 object;namespace 必须匹配 ^[A-Za-z][A-Za-z0-9.-]{0,127}$;每个 value 必须为 object;合法未知 namespace 保持忽略。
  • 修订提交(amend):82afce111f62cbb7518932d56682d533525130dd。

复验:Brain 冻结 Python 3.11.15 connector 14/14、全量 57/57;Sense 全量 go test ./... 通过,connector 定向 race/vet 通过,独立集成模块 race 通过;source-config 冻结契约 11/11;Harness strict、diff/write_paths/秘密审计通过。

## 主审修订完成(2026-08-31) - 双端统一严格校验 `X-Request-ID`:`^[A-Za-z0-9][A-Za-z0-9._:-]{15,127}$`,即 16–128 字符,拒绝短值、换行/控制字符、非法字符与超长值。 - Brain `source-config/v1` consumer 补齐 `extensions` Schema:必须为 object;namespace 必须匹配 `^[A-Za-z][A-Za-z0-9.-]{0,127}$`;每个 value 必须为 object;合法未知 namespace 保持忽略。 - 修订提交(amend):`82afce111f62cbb7518932d56682d533525130dd`。 复验:Brain 冻结 Python 3.11.15 connector 14/14、全量 57/57;Sense 全量 `go test ./...` 通过,connector 定向 race/vet 通过,独立集成模块 race 通过;source-config 冻结契约 11/11;Harness strict、diff/write_paths/秘密审计通过。
Author
Owner

更正:上一条主审修订评论中的完整提交哈希抄写有误;远端 PR #164 与本地实际提交均为 82afce1f81b98ee835f9bc49798cf48ffa880434。测试与修订内容不变。

更正:上一条主审修订评论中的完整提交哈希抄写有误;远端 PR #164 与本地实际提交均为 `82afce1f81b98ee835f9bc49798cf48ffa880434`。测试与修订内容不变。
ila merged commit 0e53e04e95 into dev 2026-08-31 15:15:49 +08:00
Sign in to join this conversation.