knowledge-governance

Weknora/knowledge-governance

Fork 0

Commit Graph

Author	SHA1	Message	Date
姚章浩	afe9affc2a	style: gofmt 新增的三个文件 build / build (push) Successful in 1m27s Details 为什么：远端 CI 的格式门在推送后判红（run 258，job build，format=failure），本地 `make verify` 那次跑的是"拉取前"的文件集，漏掉了随后新增/改写的三个文件。失败项：internal/httpapi/library_intent_test.go、internal/jobs/lease_loss_test.go、 internal/platform/postgres/library_protection.go。怎么验：`gofmt -l internal/ cmd/` 输出为空；`python3 scripts/check_format.py` rc=0 （Go：✅，前端：✅）。只改空白，不改逻辑。	2026-10-30 16:16:45 +08:00
姚章浩	98294b9583	fix(library): 统一执行身份、终态收尾、准入与数据身份 build / build (push) Failing after 24s Details why：审计 19 项（12 P1 / 7 P2）来自同一批根因，逐点试错会把协议撕成十几份： · 意图与执行混为一谈（F01/F15）：`library.sync:<scope>:<快照>` 是终身幂等键， A→B→A 的第三次发布拿到第一次的历史成功作业，什么都不做； · 版本行既是实体又是事件（F02/F09）：主键只由 (kind,scope,快照) 决定、写入是 upsert，第二个作业覆盖 `source_job_id`/`evidence`/`created_at`； · 接管没有代次（F13）：两个 worker 都能认领同一 pending 作业，失租的旧执行还能写业务状态、释放别人的维护锁； · 早退与终态没有统一政策（F03/F04/F05/F06）：半写窗口的前置检查失败会重新开门、服务起不来也照样开入口、journal 终态后收尾不可重建、恢复成功不回写 current； · 数据身份与准入各写一套（F07/F08/F14/F17）：接管丢了复用语义、全库搬运不改 location_hash、通用入口可造 library.* 作业、目标模型从没被问过； · 存储/容量/UI/CI 判据各自为政（F10/F11/F12/F16/F18/F19）。 what：按批准的一套协议集中实施（详见 handoffs/release-consolidated-implementation/ current-contract.md）： · operation（一次明确意图）/ attempt（epoch 代次）/ 不可变版本事件 / current 指针；治理库迁移 76，只动治理库，不碰 WeKnora Schema/源码/镜像； · 所有业务状态、阶段、版本事件、维护锁写入带 epoch 守卫（失租代次写不进去）；心跳失租立刻取消 handler； · 半写窗口早退保持关闭；服务未全部健康绝不开入口；journal 终态可从持久事实重建收尾；恢复成功登记 recovery 事件并推进 current； · worker 在动维护前核对业务行/kind/scope/队列关联；通用入口拒绝 library.*； · 全库搬运重算 location_hash 并与文档级导入共用实现；接管消费写集合的复用决定；发布前核目标实时模型契约、容量门禁前置； · 存储保护闭包改为全量依赖、类型只认显式登记、保护未知则不出可删候选； · 页面核 HTTP 状态与结构、恢复纳入轮询、Wiki 差异覆盖标题/摘要/父级。 how：`make verify` rc=0（16 项必需检查全绿，含 go test 全量与前端 485 例）； `go vet ./...` rc=0；`npx tsc -p tsconfig.json --noEmit` rc=0；逐项负例见各包测试（F03/F04/F08/F12/F13/F14/F16/F18/F19 都有先红后绿记录）。未执行：治理库迁移到任何已有库、真实 PG/ES/S3/WeKnora 集成、故障注入、部署。	2026-10-30 16:14:54 +08:00

Author

SHA1

Message

Date

姚章浩

afe9affc2a

style: gofmt 新增的三个文件

build / build (push) Successful in 1m27s

Details

为什么：远端 CI 的格式门在推送后判红（run 258，job build，format=failure），
本地 `make verify` 那次跑的是"拉取前"的文件集，漏掉了随后新增/改写的三个文件。
失败项：internal/httpapi/library_intent_test.go、internal/jobs/lease_loss_test.go、
internal/platform/postgres/library_protection.go。

怎么验：`gofmt -l internal/ cmd/` 输出为空；`python3 scripts/check_format.py` rc=0
（Go：✅，前端：✅）。只改空白，不改逻辑。

2026-10-30 16:16:45 +08:00

姚章浩

98294b9583

fix(library): 统一执行身份、终态收尾、准入与数据身份

build / build (push) Failing after 24s

Details

why：审计 19 项（12 P1 / 7 P2）来自同一批根因，逐点试错会把协议撕成十几份：
  · 意图与执行混为一谈（F01/F15）：`library.sync:<scope>:<快照>` 是终身幂等键，
    A→B→A 的第三次发布拿到第一次的历史成功作业，什么都不做；
  · 版本行既是实体又是事件（F02/F09）：主键只由 (kind,scope,快照) 决定、写入是
    upsert，第二个作业覆盖 `source_job_id`/`evidence`/`created_at`；
  · 接管没有代次（F13）：两个 worker 都能认领同一 pending 作业，失租的旧执行还能
    写业务状态、释放别人的维护锁；
  · 早退与终态没有统一政策（F03/F04/F05/F06）：半写窗口的前置检查失败会重新开门、
    服务起不来也照样开入口、journal 终态后收尾不可重建、恢复成功不回写 current；
  · 数据身份与准入各写一套（F07/F08/F14/F17）：接管丢了复用语义、全库搬运不改
    location_hash、通用入口可造 library.* 作业、目标模型从没被问过；
  · 存储/容量/UI/CI 判据各自为政（F10/F11/F12/F16/F18/F19）。

what：按批准的一套协议集中实施（详见 handoffs/release-consolidated-implementation/
current-contract.md）：
  · operation（一次明确意图）/ attempt（epoch 代次）/ 不可变版本事件 / current 指针；
    治理库迁移 76，只动治理库，不碰 WeKnora Schema/源码/镜像；
  · 所有业务状态、阶段、版本事件、维护锁写入带 epoch 守卫（失租代次写不进去）；
    心跳失租立刻取消 handler；
  · 半写窗口早退保持关闭；服务未全部健康绝不开入口；journal 终态可从持久事实重建
    收尾；恢复成功登记 recovery 事件并推进 current；
  · worker 在动维护前核对业务行/kind/scope/队列关联；通用入口拒绝 library.*；
  · 全库搬运重算 location_hash 并与文档级导入共用实现；接管消费写集合的复用决定；
    发布前核目标实时模型契约、容量门禁前置；
  · 存储保护闭包改为全量依赖、类型只认显式登记、保护未知则不出可删候选；
  · 页面核 HTTP 状态与结构、恢复纳入轮询、Wiki 差异覆盖标题/摘要/父级。

how：`make verify` rc=0（16 项必需检查全绿，含 go test 全量与前端 485 例）；
`go vet ./...` rc=0；`npx tsc -p tsconfig.json --noEmit` rc=0；逐项负例见各包测试
（F03/F04/F08/F12/F13/F14/F16/F18/F19 都有先红后绿记录）。
未执行：治理库迁移到任何已有库、真实 PG/ES/S3/WeKnora 集成、故障注入、部署。

2026-10-30 16:14:54 +08:00

2 Commits