姚章浩
1aa60c159e
test(library): F4 正例按基线计数标记转发
...
写入精确 marker 本身会经过 wire;断言应比较确认前后的增量,而不是绝对值。
2026-11-02 20:39:01 +08:00
姚章浩
245cefd6b0
fix(library): 收紧 DS01 派发租约/投递/治理身份与绑定冲突
...
F2.a:Acquire/Confirm 在取得 effect 行锁后用数据库时钟重核 job/attempt/
恢复投递租约,等锁跨过到期零许可且状态保持 prepared。
F2.b:同一 CAS 事务锁 recovery queue 与 operation,复核 window/scope、
idempotency、owner/attempt/lease,并按原 window 锚点重算恢复请求摘要。
F3.identity:激活证据 v3 携带 PG 集群 system_identifier + 库 OID、完整构建
SHA 与协议批次;激活与使用点都现场重读并拒绝同名异域/副本/unknown/不兼容 SHA。
F4.binding:区分绑定冲突与仅禁止重发的 Held,准入/确认/续作/收尾在所有状态
拒绝冲突,合法 dispatching + 精确 marker 仍可确认。
2026-11-02 20:36:36 +08:00
姚章浩
1e2bb385c7
test(library): 激活时留档 journal 原始字节
...
build / build (push) Successful in 1m36s
为什么:同一维护窗口在激活后还会继续写 journal(failed/recovered),事后无法从
最终目录重算 activation 登记的摘要。激活当即把字节原样复制为 05b-journal-snapshot,
让"摘要 == 当时证据"可独立复核。
2026-11-02 18:57:47 +08:00
姚章浩
bf7f5fa03c
test(library): P1 用只读可用性投影核对恢复后业务准入
...
为什么:POST /api/v1/library/restores 是"新建恢复作业"的入口,恢复后重复 POST
会制造第二次恢复;原任务的"同一受保护入口 409→200"应映射到零写副作用的
GET /library/restore-availability:held 时报维护原因且 allowed=false,恢复后
维护原因消失。不重复 POST,也不放宽权限。
2026-11-02 18:56:55 +08:00
姚章浩
24608e132b
fix(library): 区分维护窗口指纹与恢复目标指纹
...
为什么:维护窗口记录的是部署/实例指纹(journal 与 library_instance_maintenance),
observeRestoreTarget 返回的是内容/索引/桶身份;两者本来不同层(r38 实测
dbe7… vs bb3f…)。v2 证据拆成 target_fingerprint 与 restore_target_fingerprint:
前者绑定窗口与治理行,后者绑定激活时的实时只读观察,避免用一个值冒充两层。
2026-11-02 18:54:18 +08:00
姚章浩
80254756f1
test(library): adapter 激活夹具绑定维护窗口时间
...
为什么:维护行由 attach 以 now() 建立,而 journal 的停写/排空观察早于它;
激活门正确拒绝"窗口在观察之后才开"。夹具把 acquired_at 校正到观察之前。
2026-11-02 18:52:15 +08:00
姚章浩
37f2dc73f9
test(library): 修正激活台账 JSONB 断言与 PG runner 工作目录
...
为什么:jsonb::text 带空格,紧凑匹配才对;测试二进制必须在包目录下运行,
否则读不到 migrations/000078 的下迁移文件(这是 runner 的调用方式问题,
不是产品行为)。
2026-11-02 18:50:55 +08:00
姚章浩
9e31a6f956
fix(library): 激活台账沿用协议版本 1,夹具绑定维护窗口时间
...
为什么:迁移 78 的 activation.protocol_version 约束是派发协议身份(=1),
证据文档 v2 只改变激活输入契约,不应触发 schema 变更;把两者混成一个数字会让
"证据格式升级"变成一次不必要的 DDL。测试夹具补建/校正维护行(owner job、
services、acquired_at 早于停写观察),否则真实校验会正确拒绝"窗口在排空之后才开"。
2026-11-02 18:49:55 +08:00
姚章浩
1c58f1ef7e
fix(library): DS01 激活消费真实维护 journal 证据
...
为什么:v1 激活门只重算调用方自填 JSON 的 sha256,stopped/queue_drained 仍是声明,
不是排空事实。v2 证据只声明身份,事实改由 Store 读取维护窗口 journal(入口
drained+active_at_close=0、quiesce 全零且停写后复核、writer stop_requested+退出码)
与治理库实例维护行(同作业/实例/指纹/level、未释放、writer 集合一致)核出;缺受信
journal 根或构建身份未注入即失败关闭。
同时把 r38 激活移到维护窗口 held 的当下(barrier 点,真实只读观察),更新 PG/adapter
夹具与 F3 反例(伪造/替换摘要、错 writer 集合、未退出、未排空、过期、库/指纹/构建
不符、窗口已释放、journal 已 recovered、未配置受信根),并更名 beforeCommit 用例。
2026-11-02 18:48:10 +08:00
姚章浩
3b7ad9061c
test(library): 补 DS01 正式 worker 的 dispatching/legacy 负例
...
build / build (push) Successful in 1m33s
新增两个隔离场景:N1 在 CAS 已提交、发送前终止旧 worker,新 worker 从 recover
路径必须零新写并保持 dispatching;N2 让旧协议只留下 mark-intent、无台账,协议开启
后的新 worker 同样 held 且不回填。两者都核对 PG/索引/对象零增量与入口仍 409。
2026-11-02 18:15:27 +08:00
姚章浩
882e38591d
fix(library): 恢复投递身份不进入 effect 摘要
...
build / build (push) Successful in 1m37s
自动回滚先建立 prepared(没有 recovery queue),随后 recovery worker 用同一
window/backup/plan 续作时带了新的投递身份;把它算进摘要会让合法续作被判成
"绑定与不可变计划冲突"。owner/epoch 与 recovery queue/operation 属于执行锚点,
继续在同一事务里逐项核对,但不改变逻辑 effect 身份。
2026-11-02 18:12:41 +08:00
姚章浩
a1112d368a
test(library): DS01 重启旧 worker 时接受预期 kill 退出
...
build / build (push) Has been cancelled
主动终止的进程 Wait 返回 signal: killed,不是失败;改为显式读回 /proc/<pid>
不存在后,再用同一冻结二进制启动新 worker。
2026-11-02 18:11:42 +08:00
姚章浩
ca32f2e661
test(library): DS01 正式 worker 场景按零目标写断言
...
build / build (push) Has been cancelled
D16 分支在派发 CAS 之前被拒,目标不该出现恢复标记;旧断言沿用 ES clean 分支,
期待 chunk-target 仍在。改为:DS01 held 边界要求 chunk-target 缺失、0 次 marker
create、0 次传输层拒绝,并在 recovery 后核对台账 marker_confirmed 且只转发一次。
2026-11-02 18:10:56 +08:00
姚章浩
513aa9e6f5
fix(library): 收紧恢复派发真实绑定与同事务授权
...
build / build (push) Has been cancelled
为什么:Astra 复核证实五组实现缺陷——正式装配缺 scope/快照且来源与 before-image
混用;激活撤销不在 CAS 事务内、lease 用事务起始时间;激活只接受任意字符串且撤销可
被 SQL 重置/删除;准入忽略绑定冲突与 prepared 矛盾、收尾只看当前 plan;prepared 已
提交但 mark-intent 未落盘时被误判 legacy。
改了什么:
- 绑定来自原锚点(scope/来源快照/backup/实例/目标指纹/索引 UUID/恢复投递),每次
重建都实时重读目标身份并与冻结值比较;
- activation 行锁与 CAS 同事务,lease 用 clock_timestamp(),同事务核对 job/operation/
attempt/维护窗口/恢复 queue 与 operation,同 effect 换 plan 摘要拒绝;
- 激活消费带摘要的证据文件(writer 退出+排空、目标/治理库身份、有效期),撤销终局,
down 在 activation 有行时拒绝;
- 前置/收尾共用权威窗口全集,绑定冲突与 prepared 矛盾零写 held,合法 dispatching+
精确 marker 仍可确认;
- prepared 无 mark-intent 仅在绑定一致且无矛盾时补同内容意图,旧无台账意图仍 held。
验证:真 PG 锁等待覆盖撤销先胜/CAS 先胜/等锁跨租约/错锚点/plan 别名/恢复投递;
COMMIT 已到服务端但回包丢失与未决事务分别读回;真 ES+PG+对象存储的 DS01 用例全部
通过;go test ./... 全绿。未迁移正式库、未部署、未激活。
2026-11-02 18:09:26 +08:00
姚章浩
3bce6c7a3f
fix(library): 撤销派发激活后不得用旧证据重开
...
build / build (push) Successful in 1m37s
为什么:撤销若只是把 revoked_at 置空,等于"撤销"变成界面动作;
部署想重开必须给出新的排空证据或换目标身份,不能复用同一条。
验证:真 PG 用例先绿,再把 SQL 变异回 DO UPDATE ⇒ 用例红于
"revoked activation was reopened with the same evidence",还原后再绿。
2026-11-02 16:41:06 +08:00
姚章浩
18a4b83f78
test(library): 派发用例输出台账状态与回执证据
...
build / build (push) Successful in 1m36s
用例本身要能在 raw 里留下"转发次数 + 台账 state/owner/nonce/绑定/回执",
否则审核只能看到 PASS 字样,无法核对状态链与许可归属。
2026-11-02 16:33:15 +08:00
姚章浩
7b2ab642f7
docs(changelog): 记录 DS01 恢复派发开发快照
...
写明能力边界(只续作新协议 prepared、不碰 r33、不声称 ES fence)、
激活两步与 down 拒绝抹证据;操作细节放在架构文档,避免散落在提交里。
2026-11-02 16:28:04 +08:00
姚章浩
0a7c9f8510
feat(worker): 接线恢复派发台账并按激活登记启用
...
为什么:派发协议只在 worker 里装配却没人接,就等于只写了 store
mock。同步失败的自动 rollback 与维护恢复都必须拿到同一份台账;
baseline 只读装配永远不传,避免建基线顺带获得恢复写许可。
开关 LIBRARY_RESTORE_DISPATCH_V2 默认关闭,且只是"允许装配":
治理库没有该目标的未撤销激活登记时,Prepare/Acquire 直接 fail closed。
验证:cmd/worker 单测覆盖默认关闭/显式开启/无台账三态;
v071 真 ES 用例里自动 rollback 与手动恢复走的是同一个 Restore。
2026-11-02 16:28:01 +08:00
姚章浩
e09fddcb74
feat(library): 删除型恢复按台账准入并唯一发送
...
为什么:恢复在发现 index held 之前可能已经回放 database/resources;
"最后数据相同"不等于"本次零派发"。改为 Restore 在任何写之前按整份
冻结计划做纯读准入,收尾前再拒绝未决 effect。
删除型恢复的 _create 只从唯一 dispatcher 发出:preflight/故障钩子
在 CAS 之前,许可来自 COMMIT 明确的短事务;发送请求 GetBody=nil,
传输层无法重放。旧意图无台账、dispatching 无精确 marker 一律 held。
验证:真 ES+真 PG 覆盖旧意图零写 held、prepared 续作到终态
(create 恰 1 次)、dispatching+missing 两轮零写、新 OS 进程续作正例。
2026-11-02 16:27:57 +08:00
姚章浩
fad26166a4
feat(library): 新增恢复标记派发台账与一次性许可
...
为什么:删除型恢复的独占 create 在 ES 侧没有"从未写过"的持久证据,
missing/stats/内存计数都不能当未派发证明。改成为每个固定 effect 维护
单调台账:prepared -> dispatching -> marker_confirmed,绑定换不了、
状态回退不了、行删不掉。
许可只在独立短事务里 CAS 并 COMMIT 明确成功后返回,消费一次即作废;
提交结果不明时不发许可。激活登记是配置之外的第二个条件。
验证:真实 PG(隔离 schema)覆盖并发唯一赢家、旧 epoch 拒绝、
单调/绑定/删行拒绝、提交不明零许可、无激活 fail closed、down 拒绝抹证据。
2026-11-02 16:27:49 +08:00
姚章浩
47be4ae502
fix(web): 未读到目标观测不再误报非空并标注旧观测
...
build / build (push) Successful in 1m46s
根因:ReleaseTargetsView 在 overview 缺失时自己补 {state:'unknown'},而
productionTargetClass 把"unknown 且没有 empty_baseline"一律当成非空。后端对
"已探测且非空"发的正是这个形状(Go struct 上 omitempty),所以页面本地默认值
与真实观测在 JSON 上无法区分:首次加载、整库状态读取失败、当前范围没有数据
三条路径都会显示"目标非空,尚无权威版本",管理员还会拿到会返回 409 的
"建立目标权威基线"入口。
修法:没有 overview 时 production 保持 null,分类走新的 no-observation 分支;
四类有效响应(known / 已读且为空 / 非空无版本 / 不可读)的判定与入口不变。
刷新失败保留上一份 overview 时标注"上次观测 · 刷新失败,可能已过期",不把旧
结果当成刚验证的状态。后端 gate、权限、预备份与 API 拒绝一律未改。
测试:把旧"三次 SSR 当刷新"的用例撤掉,改为同一挂载 + 可控 fetch 的真实行为
测试(首次读取未返回 / 空→不可读→恢复 / 刷新失败保留旧观测 / 内外切换 /
overview 属于别的范围);缺观测的三条路径另以 SSR 负例复用审核者的反例。
新增 jsdom 仅作为 vitest 的 DOM 环境(商品代码零改动,npm ci 与锁文件已核)。
验证:make verify 16 项 success(tests-web 504 passed、tsc 无错、npm audit 0);
新用例先在原实现上红(断言收到"目标非空"),修后绿。未部署、未合并、未改
候选运行栈。
2026-11-02 12:29:48 +08:00
姚章浩
6827fa922f
fix(candidate): 夹具用产品探针证空并复用真实索引 mapping
...
build / build (push) Successful in 1m55s
首轮试跑暴露三处夹具缺陷(都在 test-only 文件里,产品代码未动):
- 目标骨架只核 knowledge_bases:最小夹具 schema 没有 tenants 表,改为按 KB 行数与
产品 ScopeContentEmpty 的十表计数证空;
- 运行期索引曾把 GET _mapping 的结果再包一层 mappings,ES 400;
现在直接回放原 mapping 文档(properties 层级与封存时完全一致);
- 目标指纹改在夹具分配桶名之后用同一份 env 计算,运行器再把桶名写进 API/worker env。
试跑两次均按 cleanup_empty_target_ui.py 精确清理并读回(resources 全不存在)。
2026-11-02 11:11:08 +08:00
姚章浩
c31a7df4ca
style(test-scope): 可选范围只追加两条,恢复原有紧凑格式
...
build / build (push) Successful in 1m50s
上一笔把 scripts/test-scope.json 整体重排成缩进格式,diff 变成 196 行噪音。
这里恢复文件原本的一行一条格式,只保留新增的 TestCandidateEmptyTargetFixture /
TestCandidateAttestation 两条;内容(112 条可选)未变。
2026-11-02 11:02:52 +08:00
姚章浩
770252b55a
test(candidate): 空目标候选夹具与网关审计续签
...
父要在真实浏览器里点"签发授权 → 启动同步",需要一个目标确实为空、来源确实存在
的候选环境。两个 test-only 入口(默认 skip,已登记 scripts/test-scope.json 的可选范围):
- TestCandidateEmptyTargetFixture:用已有 DS02/r38 夹具装配十表全非空的独立 fullshape
测试来源并封存,登记为 test_sealed;同时用产品自己的 ScopeContentEmpty 证明目标范围
为空(KB/tenant 骨架在、十表内容 0 行),并另建同 mapping 的运行期索引(夹具索引会在
测试结束时删除)。目标指纹用夹具真实桶名重算,保证与 API/worker 同一份 env 一致。
- TestCandidateAttestation:签发/续签 object-gateway 审计(有效期上限 1 小时),
四个证据摘要绑真实文件(写入者清单、只读策略、reader 拒写探测、真实排空记录)。
不改产品代码、不放宽任何准入;来源明确标 fixture-assembled-legal-fullshape,
不冒称原 C01 两份封存或 Capture/Export HTTP。
2026-11-02 11:02:38 +08:00
姚章浩
c256f2985c
fix(web): 空/非空/不可读目标分开呈现并收窄建基线入口
...
build / build (push) Successful in 1m42s
后端 overview 早已区分 known / unknown+empty_baseline / unknown 非空 / unreachable,
页面只判断 state === 'known',把"已证空"和"读不到"都写成"未知",并在两种情况下
都给出"建立目标权威基线"入口——而该接口对空目标返回 409
library_baseline_target_empty、对读不到的目标返回 503 library_baseline_unprobeable。
按后端真实契约做最小分类:
- LibraryKnown 补 empty_baseline 与 unreachable 两个已存在的字段/状态;
- 页面按四类分别呈现:known 显示生效版本+快照摘要;空目标写明"已读且为空/首次发布/
写前仍生成完整预备份";非空缺权威版本才指向基线入口;不可读照实说读取失败;
- baselineNeeded 从"非 known"收窄为"非空且无权威版本",不动授权、写闸、预备份、
容量与 worker 执行准入等任何后端检查,也不放宽后端的 409。
行为测试新增四类状态、空→不可读→空刷新不残留旧状态、空目标无候选时按钮禁用;
原"非 known 一律未知"的断言随文案更正。本地门禁 16 项 success
(tests-web 498 passed,tsc -b 无错)。
2026-11-02 10:56:29 +08:00
姚章浩
f1cddfb601
test(r39): 重放前后逐对象实取字节摘要比对
...
build / build (push) Successful in 1m55s
原重放段只比 Listing 的 key@versionId#etag#size,同一版本号下的字节
被改写它看不见,因此"重放后字节不变"缺实测证据。
改为重放前后各调一次 r38ObjectVersionDigests:逐 key+versionId 真实
GET 并本地算 SHA256,落完整版本清单(含版本、ETag、size、摘要),
再逐项比较;GET 失败、清单缺条目、版本增减或摘要不同都判失败。
治理 PG/ES/ledger/receipt 零新增断言保持原样。
离线负控 TestR39ReplayObjectByteControl:固定"旧判据对字节改写报相同"
的盲区,并要求新判据在同一元数据上报 bytes changed、正例不误报、
空清单/缺摘要必须红;用变异(去掉摘要比较)确认该负控会红后恢复。
台账:04-baseline-and-auth.json 分开记录授权 201 与基线 202,
不再让后一次状态码覆盖前一次。
2026-11-02 10:14:00 +08:00
姚章浩
d2ff089b95
ci(checkout): 补取事件 before 失败时重试一次并保留错误
...
build / build (push) Successful in 1m27s
浅克隆里用 fetch --depth 取一个未公开的对象(改写推送后的旧提交就是这种)时,
git 会在这次 fetch 中途重写 .git/shallow,随后中止:
fatal: shallow file has changed since we read it。
before 取不到 ⇒ commits 检查算不出范围 ⇒ 整条流水线红,红的原因与代码质量无关。
证据(真实 CI):run 305–317 共 13 次(含 317 的原地重跑)全部停在这一步;
同一仓库里紧接着重试同一条命令即成功。用同一 runner 镜像在容器里跑
"bootstrap + ci_checkout.sh --post-checkout"(真实事件负载)复现出该 fatal,
原脚本报"取不到事件 before",改后报"已补取事件 before eaf389e506f5",
随后 ci_gate 算出 事件 Git 范围 eaf389e..12b3769|1 条提交 并通过。
只加一次重试与错误回显:范围选择、判红口径、fail-closed 语义都没动 ——
两次都失败仍明确报警,由 commits 检查判红,不收缩范围、不放行。
2026-11-02 09:25:06 +08:00
姚章浩
12b37690ec
test(r39): 真实HTTP发布成功闭环与同请求幂等
...
build / build (push) Failing after 10s
新增单场景用例 TestFormalPublishHTTPReplaySucceededR39:发布作业只来自
真实监听的 POST /api/v1/library/syncs(管理员会话+真实授权),不再用
store.CreateLibraryDispatch 或 httptest 冒充。链路覆盖 handoff 队列
(capture 角色)→ 真实 libraryctl pack/unpack/verify → 独立 executor
archive → release-executor 队列 → succeeded/production_effective/维护释放
/入口恢复,以及同一 body 原样重放的零新增执行。
来源身份先声明后封存:source_id 由独立配置推导,来源行真实落进隔离 PG
schema 再读回后封存;目标基线走正式 POST /api/v1/library/baselines 的
真实整库捕获,不手写生效版本。旧 r38 故障恢复分支一行未改。
2026-11-02 09:02:12 +08:00
姚章浩
a1472ff29f
fix(ds03): 早段held断言按发布代次比较整份索引
...
build / build (push) Successful in 1m25s
首轮到达held时按chunk-target取文档失败:早段数据库阶段失败前索引仍是
发布写入的源码分块,before-image的chunk-target本就不该出现。改为整份
读回等于applied,并显式断言chunk-target未提前回来。
2026-11-02 07:10:56 +08:00
姚章浩
f076c3af9c
fix(ds03): 负控行复用声明形状以满足非空列
...
build / build (push) Successful in 1m25s
首轮真实早段运行在插入 pending=1 负控行时被 knowledges 的 NOT NULL
约束拒绝(enable_status),说明控制行缺少声明形状。改为复制本轮
canonical 来源行再覆盖 id/范围/pending,负控仍由正式结算拒绝。
2026-11-02 07:07:25 +08:00
姚章浩
59eb12296a
docs(ds03): 记录早段PG恢复与工具登记/读回修复
build / build (push) Successful in 1m27s
2026-11-02 07:04:56 +08:00
姚章浩
6ec1821294
test(ds03): 新增合法来源早段PG恢复用例
...
复用一个已证明的 after:wiki 发布失败入口,唯一新增故障是恢复第一段 database
的真实主键冲突(外部范围同主键 knowledges 行,SQLSTATE 23505)。来源输入改用
R38 专用副本(未删除文档 completed/pending=0),封版前用产品自己的
checkLibrarySourceSettlement 在真实 PG 上结算,并保留原 pending=1 被正式契约
拒绝的负控;共享 ds02SourceRows 与 quiesce 都不改。
2026-11-02 07:04:53 +08:00
姚章浩
099e58b5dc
docs(ds03): 修正PG用例变更记录与故障机制
...
build / build (push) Successful in 1m21s
为什么:上一条提交的 CHANGELOG 还写着最初设想的触发器注入(ERRCODE 42501),
实际收敛后的用例是"外部范围同主键行"让恢复 wiki 阶段的真实 INSERT 报 23505;
held 也改成真实的部分恢复现场。文档与代码不一致比缺文档更糟。
验证:scripts/check_changelog.py 通过;真实 PG 运行按本提交的新 SHA 重跑并留 raw。
2026-11-02 06:35:20 +08:00
姚章浩
e760d85427
test(ds03): 新增PG恢复失败后同窗口续作用例
...
build / build (push) Successful in 1m25s
为什么:B29.2 的 PG 子断言缺一条真实命中 PG 恢复步骤的失败闭环。故障不改产品
返回值、不停共享 PG、不扩 ACL、不改 schema:恢复最后一段 PG 写入(wiki 阶段)
会把 before-image 的日志行按原 id 插回目标范围;先用一行"外部范围、同主键"的
日志占住这个 id,那条真实 INSERT 就得到 23505。用例记录服务器 SQLSTATE、同一
语句的探针读回(没有多出行)、失败阶段事务回滚,以及真实的部分恢复现场:
database 阶段已提交、wiki 表仍是发布写入、共享 resources 的新增行按设计留到
四阶段全部成功后再清。解除只删这一行,随后走同一 window_job_id 的正式 recover。
同时把夹具的索引登记接通运行器(KG_R38_INDEX 被真实消费),并落实际 namespace,
使 wrapper 在夹具未执行 t.Cleanup 时也只清登记的那一个索引。
验证:make verify 16/16 success(local 档案,identity=skipped 属本地常态);
PG 闭环的真实运行在提交后按同一 SHA 单独执行并留 raw。
2026-11-02 06:29:43 +08:00
姚章浩
98e7279632
test(ds03): 新增对象版本逐条绑定移除回执
...
build / build (push) Successful in 1m24s
把"发布真实新增的版本在恢复后消失"从"桶里没有这个 key"加强到:每个新增
versionId 都必须有同 key + 同 versionId 的网关 removed 回执,并断言绑定条数>0;
回执/投递的 plan 仍必须等于发布期写集合摘要。
验证:go vet 通过;make verify 在本提交前的同一源码状态已 16 项全 success,
最终证据用提交后的完整 SHA 重跑。
2026-11-02 05:23:43 +08:00
姚章浩
30f223bcc4
test(ds03): 对象恢复补十表全形状与版本字节指纹
...
build / build (push) Successful in 1m25s
为什么:
- 上一版对象恢复证据里 knowledge_tags/knowledge_tag_relations/wiki_folders/
wiki_page_issues/wiki_log_entries 五张表 before/source 都是 0,把"空表相等"
当成全形状恢复,父复验据此不能关整项。
- 对象"字节摘要"只用了 ETag+size,不能称逐字节指纹。
改了什么:
- 复用 DS02 已验的十表声明与独立 oracle(ds02SourceRows/ds02Expected/本地号
mapping oracle),对象分支改用真实 v071 十表 catalog 建表;目标 before-image
与来源快照十表全非空,邻库/外部租户哨兵逐表非空。
- 逐种引用承诺(父子分块、标签关系、资源绑定、目录父子、wiki 引用、页面问题、
日志)在声明来源、发布实际写入、恢复后 before-image 三处都要求 matched>0。
- 对 before-image 每个受保护 versionId 单独 GET 算 SHA256,恢复后同 version
再独立算一次并比较;真实新增版本消失且必须有网关 removed 回执。
- 发布期写集合摘要与预备份版本证据、网关回执/投递计划一致;恢复意图
request_digest 独立重算后逐字符比较。
- 重放后的 PG/ES/对象/回执原始读回全部落盘,供父独立比对。
- 运行器写 run-identity.json(主命令/label/完整 SHA/版本/二进制摘要),
报告头与 raw 统一;label 前缀统一为 ds03-object-*(清理器同步)。
验证:make verify 16 项全 success(RC=0);真实隔离对象故障→held→同窗口
recover 用例已在本地跑通(dev5),最终证据用提交后的完整 SHA 重跑。
2026-11-02 05:16:41 +08:00
姚章浩
2cbeca8d1d
test(ds03): 记录对象拒绝的网关原始响应
...
build / build (push) Successful in 1m26s
拒绝事件补 503 与原始正文,证据可直接引用网关响应,而不只依赖客户端错误文本。
2026-11-02 04:47:26 +08:00
姚章浩
b39902ef90
test(ds03): 修正对象效果文件字段读取
...
build / build (push) Successful in 1m25s
对象效果 JSON 使用 resource_id/key 小写标签;按 Key 匹配会得到空集合,
导致已发生的 delete-intent 被误报为缺失。
2026-11-02 04:39:37 +08:00
姚章浩
68f03bb30e
test(ds03): 对象恢复传输失败后同窗口恢复
...
build / build (push) Successful in 1m26s
对象分支在对象网关前拒绝一次回滚删除请求(派发前 503、转发 0、无 intent),
让自动回滚真实失败并进入 held;撤障后用同一 recover API/窗口/备份恢复,
并读回十表整行、ES 完整 _source、对象全版本与 delete markers。
同时补四类进程 executable/hash 身份与对象清单分页;旧的 ES 分支保持不变。
2026-11-02 04:37:16 +08:00
姚章浩
93c0f34aac
test(ds02): 同租户不同知识库十表同输入对照
...
build / build (push) Successful in 1m26s
跨租户 bundle 的旧侧必须在 wiki 之前省略 resources/resource_bindings,
不能据此声称"同输入已收口"。新增同租户、不同知识库场景:旧 6fe98c9 的
resources 阶段只按 tenant_id 查资源行,同租户下不再提前失败,因此两侧
都能消费完整十表归档。
新增 ds02_identical_input_test.go:导出十表 bundle;两侧在执行前各自导出
逐表来源归档、实际目标种子、完整 DDL、三条序列、ES 文档与对象字节;
唯一 namespace 替换(桶名 %BUCKET%)按同一规范归一,物理身份单列。
2026-11-02 04:05:03 +08:00
姚章浩
98ccb9366e
test(ds02): 负控制落盘并修正 gofmt
...
build / build (push) Successful in 1m26s
为什么:CI 在 07a9caf 上 format 红(ds02_identity_test.go 未 gofmt),本地那次
make verify 跑在文件生成之前,不能算数;同时 /v1/encode 负控制只有断言、没有
落盘证据,复验时无法回看分类结果。
改了什么:gofmt 两个测试文件;负控制把实际出站条目与被判为 embedding 的差异
写进 raw(negative-control),正例仍只对发布段计数。
验证:make verify 16 项全绿;随后以新 SHA 重跑 DS02 隔离套件。
2026-11-02 03:48:52 +08:00
姚章浩
07a9caf22b
test(ds02): 收紧映射/引用/哨兵与进程身份 oracle
...
build / build (push) Failing after 19s
为什么:Astra 复验已独立复现旧 LocalIDs 循环的三种盲区——目标互换、错误来源集合、
不存在的目标都能绿;引用把 pre/next/parent 混在一个 OR 里,parent 分支没有覆盖;
成功路径没有序列非空比对;零 Embedding 只测了一个 client;旧侧对照用 rev-list 的
258 冒充 0.1.258(该工作树 identity 实际是 0.1.148);runner 在异常/超时路径不保证
清理,读回把任何非零退出都当"不存在"。
改了什么:
- 抽出独立语义 mapping checker:三表 (table,column,source,target) 精确集合 + 真实行
对应;持久账本正例与语义副本变异走同一 checker,digest gate 与语义 gate 分开。
- 测试自带十表 scope 声明并与 schema 列集合对拍;逐种引用非空命中,软导航字段显式
列为范围外;外围 ES 完整 _source、res-other 字节各补负控制。
- 零 Embedding 改为发布段独立记账:ES + 对象存储两个可达 client,自定义 /v1/encode
负控制;范围只声明本测试可达 client,正式全链留给 DS03。
- 冻结输入 bundle(十表行/目标种子/序列/ES/对象/DDL,逐表 hash):旧 6fe98c9 与新源码
同一 bundle 文件;旧侧真实 23505,新侧发布成功 + 独立 oracle。
- 测试进程身份:runner 注入 test-only nonce/commit/树摘要,进程自报 executable hash。
- 历史兼容矩阵改同 catalog 初始化,三条序列显式存在并逐例 before/after。
- runner v2(证据根,不在本仓):失败关闭、finally 清理、所有权重核、keep-failure。
验证:make verify 16 项全绿;ds02_runner_v2 三次隔离运行(含负控制与 keep-failure)
raw 见 handoffs/develop-release-contract/ds02-v2-*;旧侧探针 ds02-bundle-old2。
2026-11-02 03:46:26 +08:00
姚章浩
eea0a0ec3b
test(release): 整库发布独立oracle与历史兼容矩阵
...
build / build (push) Successful in 1m25s
十表全形状夹具补独立 oracle:逐列内容、全部引用、索引正文/向量、对象字节与
零 Embedding 调用;期望由夹具声明推导,不调用被测映射器生成。Wiki 日志本地号
映射断言双射;正文/向量/引用/映射对真实目标变异后 oracle 必须红、改回必须绿。
补历史兼容矩阵:旧 manifest、V1 台账、空作业/目标身份等缺证明组合在正式入口
被拒绝,拒绝前后 PG/索引/对象版本/序列哈希不变;不做 V1→V2 迁移。
旧版对照:0.1.258(6fe98c9)在同一隔离库/桶/索引以相同输入复现
wiki_log_entries_pkey/23505;当前代码同一输入发布成功并分配本地号。
2026-11-02 02:58:50 +08:00
姚章浩
1d2fff8639
test(release): 正式 worker 与维护恢复入口的 held→恢复闭环验收
...
build / build (push) Successful in 1m25s
真实 publish 在四类写入完成后由校验不一致失败进入回滚;回滚在
restore-finalize-intent 落盘、marker 仍在自身世代时被拒绝 clean 派发,
窗口 held、两个维护记录 needs_restore、写入口 409;撤故障后
POST /library/maintenance/recover 以同一 window/job/backup 续作成功,
PG 逐行/对象版本/ES _source 全量恢复并重开入口。仅新增验收与运行器,
产品行为与判据未改。
2026-11-02 01:44:03 +08:00
姚章浩
066dc45a25
fix(release): 删除型索引恢复不再用 ES 统计计数放行
...
build / build (push) Successful in 1m34s
- ES `_stats` 写计数是分片生命周期统计(官方文档:分片迁到另一节点时该分片统计清零),
索引 uuid 不变不绑定统计生命周期,清零后重新累计到同一数值(ABA)无法排除。
撤销 r36 的"写计数器栅栏"授权:既不落盘也不读取,统计仅作诊断。
- 删除型恢复(独占 `_create`)只有在本次尝试开始时不存在任何恢复意图、且文档确实缺失时
才可重做;既存 restore-mark-intent 配缺失文档一律 held、零写入。
- 保留可证明路径:marker 仍在且世代一致的 clean 收尾重试;文档仍是 applied 结果、
世代一致的 DELETE 补偿重试。
- 新增 ABA 反例(传输层 stats 故障模拟、真实 ES 文档写删、未重启共享 ES);
B19 / clean / delete 安全正例全回归。
验证(真实 PG/ES/MinIO 隔离夹具):
- ABA 反例:旧代码 RED(restoration must be held, not rebuilt),新代码 PASS
- 索引/恢复回归 13 项 PASS
- 回滚回归 2 项 PASS
- make verify 16 项 success(identity 仅 CI 可核)
未部署、未写生产/云、未重启共享 ES。
2026-11-02 01:19:00 +08:00
姚章浩
ff257064c3
fix(release): 索引恢复用写计数器栅栏与世代证明续作
...
build / build (push) Successful in 1m31s
- 删除型恢复写入(独占 _create)不再把"文档缺失"当成"证明从未发送":
marker 写成功、回执丢失、随后被删除与从未写过完全同形。现在在第一次
派发前把索引写计数器(uuid/index_total/delete_total)与意图一起原子
落盘;只有栅栏逐位未变才允许重做,推进/缺失/读取失败一律 held。
- restore-finalize-intent 已落盘、干净写入在派发前被拒绝后,标记体仍在
自己那份世代即可证明干净写入没有落地,按同一 CAS 继续收尾。
- 删除补偿(Before 为空)在派发前被拒绝后可按 applied 世代重放 DELETE;
文档已变或世代不符仍 held。
- 对象验收证据改用 ListObjectVersions,不再用 ListObjectsV2 冒充版本枚举。
真实 PG/ES/MinIO 隔离夹具:3 个新用例先 RED 后 GREEN;索引/恢复回归 12 项、
回滚回归 2 项全绿;make verify 16 项 success(identity 仅 CI 可核)。
2026-11-02 00:49:30 +08:00
姚章浩
de867078c6
style(release): gofmt 索引恢复验收测试
...
build / build (push) Successful in 1m39s
CI 的 format 项只在已跟踪文件上扫,提交前测试文件还是未跟踪状态,本机 make verify
没看到它;补一次 gofmt,不改行为。
2026-11-02 00:08:07 +08:00
姚章浩
b15633d37c
fix(release): 索引恢复在确定没写进去时按世代证据重做
...
build / build (push) Failing after 20s
恢复/回滚的索引步骤如果在"持久意图落盘之后、派发之前"确定失败,重试会被判成
unknown restoration lacks exact operation marker/content/CAS 而永久 held:代码
只看标记在不在,没看"这份意图到底发出去没有"。新增 restorationProvablyUnsent:
观察到的内容仍等于自己确认过的 applied 结果(删除即缺失)、且世代与那份回执完全
一致时,成功写入必然产生新世代这一事实就证明恢复写入一次都没到达索引,按原
before-image 重做不会覆盖任何别人的字节。内容对但世代对不上、或应用期停在标记态
却对不上标记体/世代,仍然 held(B19 不放宽)。
新增一次性恢复写入派发边界 restoreMarkerFault(生产恒为 nil),用来把"边界上确定
没写进去"与"写入结果不确定"分开演练。
验:新增 TestContractKnownIndexRecoveryAfterRestoreBoundaryFaultIsolated 在真实
ES/PostgreSQL/MinIO 上跑:故障前 applied 回执已落盘、失败时派发次数 0、状态为
rollback_failed;撤故障后同一 job/预备份恢复完成,PG 逐行字节、索引 ID+字节+新世代、
对象键集合全部回到 before-image,重放不再派发。RED 证据是重试报 held,GREEN 后
TestContract(Index|KnownIndex).*Isolated 11 项与两条 rollback 用例全绿,make verify
success。
2026-11-02 00:06:54 +08:00
姚章浩
c938a4f4bf
fix(freeze): 归档改为不可覆盖副本,保留 current 到新请求写入成功
build / build (push) Successful in 1m31s
2026-11-01 23:06:48 +08:00
姚章浩
ba1989b042
fix(freeze): 收尾后的同作业续作可开新尝试并归档旧请求
build / build (push) Successful in 1m31s
2026-11-01 22:53:41 +08:00