98294b9583
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 集成、故障注入、部署。
74 lines
2.7 KiB
Go
74 lines
2.7 KiB
Go
package libraryfreeze
|
||
|
||
import (
|
||
"context"
|
||
"errors"
|
||
"strings"
|
||
"testing"
|
||
)
|
||
|
||
// F03:接管一个已经持久化 ContentRisk 的半写窗口时,前置检查(后台静默/停写者/排空)
|
||
// 任何一个失败都必须保持目标关闭。原实现所有早退都走 abandonWindow → restore,
|
||
// 于是"本进程尚未写"被当成"此窗口从未写",半写内容被重新对外开放。
|
||
func TestAdoptedHalfWrittenWindowPreflightFailureStaysClosed(t *testing.T) {
|
||
_, c, e := instanceFixture(t)
|
||
stopAllServices(c)
|
||
j := heldJournal("audit-adopt", strings.Repeat("a", 64), strings.Repeat("b", 64))
|
||
if err := e.save(j); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
// 后台仍有任务:前置检查在 work 之前失败。
|
||
if err := e.SetQuiescer(&idleQuiescer{busy: true}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
e.quiesceWait = 1 // 极短等待,让前置检查尽快失败
|
||
worked := false
|
||
_, err := e.RunWindow(context.Background(), j.Job, func(context.Context) error { return nil },
|
||
func(context.Context, *Window) (string, error) {
|
||
worked = true
|
||
return "", nil
|
||
}, func(error) bool { return false })
|
||
if err == nil || worked {
|
||
t.Fatalf("fixture did not fail before work: err=%v worked=%v", err, worked)
|
||
}
|
||
for _, call := range c.calls {
|
||
if strings.HasPrefix(call, "start:") || call == "gate:open" {
|
||
t.Fatalf("半写目标在前置检查失败后被重新开放:calls=%v", c.calls)
|
||
}
|
||
}
|
||
after, loadErr := e.load(j.Job)
|
||
if loadErr != nil {
|
||
t.Fatal(loadErr)
|
||
}
|
||
if terminal(after.State) {
|
||
t.Fatalf("半写窗口必须保持非终态(等恢复),实际 %s", after.State)
|
||
}
|
||
if !after.ContentRisk || !after.RestoreBlocked {
|
||
t.Fatalf("持久内容风险被清掉了:contentRisk=%v restoreBlocked=%v", after.ContentRisk, after.RestoreBlocked)
|
||
}
|
||
}
|
||
|
||
// F04:任何一个"原本在跑"的写入者启动失败,都不能调用 OpenIngress。
|
||
// 原实现在 restore() 里累积 Start/健康/save 错误,却仍然开门:状态说"保持关闭",
|
||
// 外部动作却把流量打向没准备好的目标。
|
||
func TestRestartFailureMustNotOpenGate(t *testing.T) {
|
||
_, c, e := instanceFixture(t)
|
||
e.control = &restartFailControl{exitControl: c}
|
||
_, err := e.RunWindow(context.Background(), "audit-restart", func(context.Context) error { return nil },
|
||
func(context.Context, *Window) (string, error) { return "", nil }, func(error) bool { return true })
|
||
if err == nil {
|
||
t.Fatal("fixture 预期重启失败")
|
||
}
|
||
for _, call := range c.calls {
|
||
if call == "gate:open" {
|
||
t.Fatalf("重启失败后仍然打开了入口:calls=%v", c.calls)
|
||
}
|
||
}
|
||
}
|
||
|
||
type restartFailControl struct{ *exitControl }
|
||
|
||
func (c *restartFailControl) Start(context.Context, string) error {
|
||
return errors.New("synthetic restart failure")
|
||
}
|