 姚章浩
|
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 |
|
|
姚章浩
|
a42b101a7b
|
fix(library): 基线崩溃续作与维护原状态保留
build / build (push) Successful in 1m25s
父审发现三处会让目标卡死或状态对不上实际入口，逐条修：
1. 登记成功但没来得及收尾：崩溃重入会撞上"已有生效版本"直接失败，
目标留在维护里、占用也不释放。现在按「本作业+同一快照」识别为自己的
版本，只做收尾（恢复服务/开入口/释放两把占用），不重新捕获、不重写；
别人的版本仍然拒绝。捕获完成但登记失败则明确失败并写"未对目标写入"。
2. 重入覆盖原运行状态：崩溃时服务已被停住，再读一次只会读到 stopped，
写回去会让恢复阶段永远不启动写入者。AcquireInstance/LibraryMaintenance
在 owner 相同的重入时保留已持久化原状态；新作业接管已释放窗口用自己的观察。
真实 PostgreSQL 集成用例覆盖（先红后绿）。
3. 版本登记移进维护窗口：捕获/校验/登记要么一起成立、要么目标原样恢复；
记录失败时窗口已开放，治理状态同步释放，不再"显示维护中、实际已开"。
索引映射读不到时拒绝登记，不再用空摘要写证据。
顺带：
- 基线窗口统一收尾抽成 settleBaselineWindow，四种结局各有测试（成功/健康失败/
held 保持维护/已恢复则释放），并用真实 DB 用例证明 baseline 与 sync/restore
共用写互斥、幂等重试不产生第二个作业。
- 新增 cmd/librarydrill：维护隔离 → 整库预备份 → 一致性校验 → canary 漂移检测
→ 按预备份恢复 → 逐类复核 → 按原状态恢复服务。用与 worker 相同的 LIBRARY_*
配置，绝不触碰封存源。
- 目标/预备份/维护栈装配收成 internal/librarystack 一份（worker 与演练共用）。
验证：go build/vet/test 全过；TEST_DATABASE_URL 指向临时 PostgreSQL 跑
TestMaintenanceReentryKeepsOriginalServiceState（修复前失败：got app=stopped）
与 TestLibraryWriteMutexCoversBaselineJobs；本地门禁 15/15。
|
2026-10-29 19:08:58 +08:00 |
|
|
姚章浩
|
517d5f862d
|
feat(library): 首次发布接上目标权威基线与整库空判定
目标非空又没有生效版本时，首次发布以前只能停在"权威版本未知"。现在有了
真实入口：管理员发起 baseline 作业，worker 在维护隔离下把目标整库捕获成
归档快照，再用同一套 Verify 证明目标与快照逐类一致，最后登记
production_effective（证据写明 origin=target_baseline、快照 ID、逐表行数、
目标索引映射）。不写目标内容、不清空目标、不手写版本。
同时修两处会误导人的判定：
- productionScopeEmpty 原来只数 knowledges，"文档删了但分块/Wiki/资源还在"
的目标会被当成空库；改用适配层同一份表清单与范围过滤逐表计数。
- 概览里的"测试封存候选"原来取该 scope 最新一份归档，而归档里还有生产
预备份与目标基线快照；改为只认版本登记里 kind=test_sealed 的那一份。
迁移 075 放开 kind='baseline' 并把它并入 sync/restore 的写互斥索引；
worker 重启时用同一作业 id 接管未完成的基线窗口。维护接口补 capability，
页面才能区分"未运行维护"与"维护能力没接线"。
验证：go build ./... / go vet ./... 通过；新增用例覆盖管理员校验、已有生效
版本拒绝、目标读不到时零作业零版本、候选来自登记、缺项文案指向基线入口、
capability 逐项缺失；反向自检（把候选改回按最新归档取、把文案改回旧句、
去掉管理员判断）三项均按预期变红后复原。
|
2026-10-29 18:16:21 +08:00 |
|