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 集成、故障注入、部署。
90 lines
4.0 KiB
Go
90 lines
4.0 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"knowledge-governance/internal/governance"
|
|
"knowledge-governance/internal/librarysnapshot"
|
|
postgresstore "knowledge-governance/internal/platform/postgres"
|
|
)
|
|
|
|
// takeoverBaselineMaxBlobBytes 与其它归档读取点保持一致:基线清单只校验自身与
|
|
// 分区哈希,不把整份快照读进内存。
|
|
const takeoverBaselineMaxBlobBytes = 256 * 1024 * 1024
|
|
|
|
// loadTakeoverResumeFacts 收集"能否安全续写"的持久事实。
|
|
//
|
|
// 任何一项读不到都按**不成立**处理(fail closed):这条路径的用途是允许一次
|
|
// 恢复覆盖"已被更新版本顶替"的历史快照,证据缺一条就必须退回拒绝,不能把
|
|
// "查不到"当成"没问题"。
|
|
func loadTakeoverResumeFacts(ctx context.Context, store libraryResumeFactsStore,
|
|
archiveRoot string, job governance.LibraryJob, now time.Time) takeoverResumeFacts {
|
|
facts := takeoverResumeFacts{}
|
|
// 授权必须绑定本作业的请求摘要,且**签发于顶替之后**:顶替前签的旧授权
|
|
// 不知道这个快照已成历史,不能当作"恢复历史版本"的新意图。
|
|
if job.RequestDigest != "" && job.TargetSnapshotID != "" {
|
|
if grant, found, err := store.ActiveLibraryAuthorization(ctx, job.Scope,
|
|
job.TargetSnapshotID, job.RequestDigest, now); err == nil && found {
|
|
facts.AuthorizedAt = grant.CreatedAt
|
|
}
|
|
}
|
|
if job.SnapshotID != "" {
|
|
// 基线必须先有本作业自己的预备份登记,再证明清单字节仍是那个摘要。
|
|
if _, found, err := store.LibraryVersionByRef(ctx, job.Scope,
|
|
governance.LibraryVersionProductionPrebackup, job.ID, job.SnapshotID); err == nil && found {
|
|
facts.BaselineRecorded = true
|
|
}
|
|
facts.BaselineVerified = snapshotManifestIntact(archiveRoot, job.SnapshotID)
|
|
}
|
|
facts.MaintenanceOwned = takeoverWindowOwnedBy(ctx, store, job)
|
|
return facts
|
|
}
|
|
|
|
// libraryResumeFactsStore 是接管判定需要的只读面(writer 与裸 Store 都满足)。
|
|
type libraryResumeFactsStore interface {
|
|
ActiveLibraryAuthorization(ctx context.Context, scope, snapshotID, paramsDigest string, now time.Time) (governance.LibraryReleaseAuthorization, bool, error)
|
|
LibraryVersionByRef(ctx context.Context, scope string, kind governance.LibraryVersionKind, sourceJobID, snapshotID string) (governance.LibraryVersion, bool, error)
|
|
LibraryMaintenanceOf(ctx context.Context, scope string) (*postgresstore.LibraryMaintenance, error)
|
|
HeldInstanceMaintenance(ctx context.Context) ([]postgresstore.LibraryInstanceMaintenance, error)
|
|
}
|
|
|
|
// takeoverWindowOwnedBy 要求 scope 与 instance 两把锁都由本作业持有且未释放,
|
|
// 且两行的目标指纹一致:只有本作业自己开的那扇窗口才允许续写,别人的窗口
|
|
// 即使作业号碰巧相同也进不来(Acquire* 的互斥语义在接管判定里同样成立)。
|
|
func takeoverWindowOwnedBy(ctx context.Context, store libraryResumeFactsStore, job governance.LibraryJob) bool {
|
|
scopeRow, err := store.LibraryMaintenanceOf(ctx, job.Scope)
|
|
if err != nil || scopeRow == nil || scopeRow.OwnerJobID != job.ID || scopeRow.ReleasedAt != nil {
|
|
return false
|
|
}
|
|
held, err := store.HeldInstanceMaintenance(ctx)
|
|
if err != nil {
|
|
return false
|
|
}
|
|
for _, row := range held {
|
|
if row.OwnerJobID == job.ID && row.OwnerScope == job.Scope && row.ReleasedAt == nil &&
|
|
scopeRow.TargetFingerprint != "" && row.TargetFingerprint == scopeRow.TargetFingerprint {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
// snapshotManifestIntact 校验预备份清单未被改动:归档的清单文件名就是内容摘要,
|
|
// LoadManifest 会重算比对,字节被换过就失败。分区 blob 的完整复核留给恢复流程,
|
|
// 这里只回答"基线定义是否还是那一份"。
|
|
func snapshotManifestIntact(root, snapshotID string) bool {
|
|
if root == "" || snapshotID == "" {
|
|
return false
|
|
}
|
|
archive, err := librarysnapshot.Open(root, takeoverBaselineMaxBlobBytes)
|
|
if err != nil {
|
|
return false
|
|
}
|
|
defer archive.Close()
|
|
if _, err := archive.LoadManifest(snapshotID); err != nil {
|
|
return false
|
|
}
|
|
return true
|
|
}
|