 姚章浩
|
98294b9583
|
fix(library): 统一执行身份、终态收尾、准入与数据身份
build / build (push) Failing after 24s
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 |
|
|
姚章浩
|
0088004cd6
|
fix(library): 当前生效版本改按精确查询
接管分类、基线判定、已知索引映射、同步闸口的创建判据与归档保留的保护标记，
原来都用 LibraryVersions(scope, 50/100) 这个分页窗口再在内存里筛。生效版本每
scope 只有一行、可能很久以前登记，历史一长就被挤出窗口 —— 于是"已生效"被读成
"没有生效"：接管会把已经上线的目标重写一遍，基线入口会给已有权威版本的目标
再建一次基线。
现在统一走两条精确查询：LibraryCurrentVersion（kind='production_effective' AND
superseded_at IS NULL，每 scope 至多一行）与 LibraryVersionOfSnapshot（按快照
身份取回"已顶替"证据）。多行、自相矛盾、读不到一律 fail closed；同一含义只留
一份实现（knownIndexMapping 同步与恢复共用）。LibraryVersions 仍是 1..100 的
展示窗口，只用于列表。
验证：真实 PG 上先复现（窗口实现 ⇒ found=false），改后 7 条 store 契约用例与
worker 端到端判定用例全绿；本机 make verify 15 项 success（用例 1264 通过 /
0 失败 / 93 已声明可选跳过）。
|
2026-10-30 03:09:21 +08:00 |
|
|
姚章浩
|
fe6e218d9c
|
fix(library): 整库只读接口改清单级读取，修掉真实超时
build / build (push) Successful in 1m17s
候选归档 79 版 / 56MB blob 上，overview、storage、snapshots 三个只读接口
都在 10s 请求期限后返回 503。分段计时定位到唯一瓶颈是按版本重读全部 blob：
Open 0ms、LoadManifest×79 11~22ms、ContentUsage 15~25ms、
Usage（逐版 Load 验字节）13.75~14.11s；单版 Load 261~290ms。
- Usage 拆成 Usage（逐版复核字节，同步/恢复与运维 CLI 用）与
UsageFromManifests（同一份去重实现，只做清单级校验），列举路径改用后者；
- library_storage.go 每版两次 Load、snapshots 每版一次 Load 改为一次清单读取；
- wiki/文档差异只读所需部件，被读部件仍由 OpenPart 复核摘要；
- LoadManifest 与 Load 共用同一套清单判据（严格解码 + 重新编码校验）；
- 列举响应带 verification=manifest / verified=false，详情整版复核后才是 content，
避免把"清单可读"读成"完整性已验证"；
- libraryWithDeadline 去掉超时后再写已结束响应的 goroutine 写法
（候选环境实测 http: superfluous response.WriteHeader call）。
回归：多版本共享大 blob 时枚举不读 blob 字节（篡改后枚举仍成功），
而 Load/OpenPart/Usage 仍拒绝坏 blob；坏清单两条路径都整条报错。
make verify 15 项全绿（local 档案）。
|
2026-10-28 21:52:14 +08:00 |
|
|
姚章浩
|
f91359f881
|
feat(library): 存储管理真实化——容量门禁、依赖保护与清理预览
build / build (push) Successful in 1m15s
为什么：存储页原来只有占用数字，保留/依赖保护/清理预览写"未接线"；这些都不需要生产写权限，
按"未设置就不做决定"的口径实现成只读计算。
- internal/libraryretention：按保留数量/天数生成预览；生产生效、每库最近封存、每次生产预备份、
在飞作业引用一律受保护；回收预览只算独占字节，共享 blob 不计。
- internal/libraryretention.CheckCapacity：预算未设置即不放行（无法证明装得下），超预算阻断；
已并入 POST /library/syncs 的 gate 缺项。
- 新增 GET /api/v1/library/storage：真实归档用量 + 三类版本保护依据 + 策略 + 预览 + 容量，只读。
- 系统设置→存储管理改为读该接口：策略未设置时明确"全部保留、不生成候选"，自动清理恒关闭。
- 配置项 LIBRARY_CAPACITY_BUDGET_BYTES / LIBRARY_RETENTION_VERSIONS / LIBRARY_RETENTION_DAYS（未设=0）。
|
2026-10-28 15:04:44 +08:00 |
|