docs(ds03): 记录早段PG恢复与工具登记/读回修复
build / build (push) Successful in 1m27s

This commit is contained in:
姚章浩
2026-11-02 07:04:56 +08:00
parent 6ec1821294
commit 59eb12296a
+42
View File
@@ -1,5 +1,47 @@
# Changelog
## 开发快照(DS03 早段 PG 恢复:合法来源 + database 23505 → held → 同窗口恢复)
### Added
- 新增早段 database 恢复失败用例 `TestFormalMaintenanceRecoveryPGEarlyRestoreHeldThenRecovered`
(`KG_R38_SCENARIO=pg-early`):仍然复用 `after:wiki` 发布校验失败入口,唯一新增故障是恢复
**第一段 database** 的真实主键冲突——发布整库替换已删掉 before-image 目标文档,先用一行
"外部范围、同主键"的 `knowledges` 占住该 id,恢复自己那条 `INSERT` 得到服务器
`SQLSTATE 23505`。失败文案必须同时含 `恢复阶段 database 失败` 与 `SQLSTATE 23505`,
且不得出现 wiki 阶段或 ES/对象文案。
- 新增本轮专用来源副本 `r38LegalSourceSpec`:只把未删除来源文档改成
`parse_status=completed`、`pending_subtasks_count=0`,共享 `ds02SourceRows` 一行不改。
封版前用产品自己的 `checkLibrarySourceSettlement` 在真实 PostgreSQL 上结算这份声明
(隔离 schema,避免来源 id 与发布写入共用主键),并保留原 pending=1 被正式契约拒绝的负控;
负控行按 id+租户+库精确删除并读回 0。
- 新增早段 held 证据 `r38PGEarlyFaultHeld`:故障行仍在;同一 `INSERT` 复测仍被服务器以
23505 拒绝且没有多出行;database 阶段整段回滚,所以十张表都还是发布写入后的内容
(与 applied 逐表多重集相等,且至少一张表不同于 before-image);索引仍是发布那一代,
既没有恢复 marker 也没有 restored 回执。
### Changed
- `r38_runner.py` 的隔离资源改为**先登记再创建**:network/DB/container 在创建调用之前把
名字与归属写进 `state.resources`,创建成功后补不可变 ID(DB 补 oid),创建响应丢失时
保留 `create-unknown` 清单;登记保存失败直接中止,不再先创建后登记。
- `r38_cleanup.py` 的网络读回只接受 daemon 明确的 not-found(`no such network`/`not found`):
rm/inspect 的连接、认证、解析错误一律落 `cleanup-incomplete` 且非零,绝不当作"不存在";
name/label 必须与本轮登记一致,否则零删除。创建响应丢失的 container/DB 按登记名 +
项目 label 重新证明归属,归属不明失败关闭、不猜删。
### Fixed
- `r38_runner.py` 的末次(finally)provenance 快照此前只记录不比较:现在 HEAD/tree_digest/
干净状态任一项变化都会让整体非零,状态保留原测试结果并附加
`source-gate-failed-after-final`,精确清理照走,不再出现只有最后一次采集变化却
`passed-cleaned`。
- 离线控件补齐对应精确反例(末次 tree/HEAD/dirty、网络 daemon 错误/rm 失败/label 不符/
未登记名、创建响应丢失的 container/DB、登记保存失败),期望条数由程序统计,
原 10+7 案例与旧失败证据保持不变。
---
## 开发快照(DS03 PG 恢复失败:held → 同窗口二次恢复)
### Added