package main import ( "context" "errors" "os" "path/filepath" "strings" "testing" "time" "knowledge-governance/internal/governance" "knowledge-governance/internal/libraryrelease" v071 "knowledge-governance/internal/releaseadapter/v071" ) // 这里验证的是"治理侧的锚点":摘要真的写进版本证据、能按作业+目标+预备份取回, // 并且任何一步对不上都返回错误(调用方据此不写目标 / 保持维护)。 // 归档文件的读写在 v071 的写集合用例里用真实文件验证。 type fakeVersionStore struct { versions []governance.LibraryVersion recorded *governance.LibraryVersion err error } func (f *fakeVersionStore) LibraryVersions(context.Context, string, int) ([]governance.LibraryVersion, error) { if f.err != nil { return nil, f.err } return f.versions, nil } func (f *fakeVersionStore) RecordLibraryVersion(_ context.Context, version governance.LibraryVersion) error { f.recorded = &version return nil } func sealedLedger(t *testing.T, digest string) libraryrelease.WriteSet { t.Helper() set := libraryrelease.WriteSet{Version: libraryrelease.WriteSetVersion, JobID: "job-1", Target: "internal", TenantID: 10001, KnowledgeBaseID: "kb", BackupSnapshotID: "backup-snap", TargetSnapshotID: "target-snap", CreatedAt: time.Now().UTC(), Rows: []libraryrelease.WriteSetRow{{Table: "resources", ID: "res-new"}}, Universe: map[string]libraryrelease.TableFingerprint{"resources": {Count: 2, Digest: "d"}}} if err := set.Seal(); err != nil { t.Fatal(err) } return set } func TestWriteSetEvidenceKeepsBackupEvidenceAndAddsAnchor(t *testing.T) { set := sealedLedger(t, "") evidence := writeSetEvidence(map[string]any{"backup_bytes": int64(4096), "index_mapping_sha256": "old"}, set, "mapping-1") if evidence["backup_bytes"] != int64(4096) { t.Fatalf("原预备份证据必须保留:%v", evidence) } if evidence["writeset_digest"] != set.Digest { t.Fatalf("writeset_digest = %v, want %s", evidence["writeset_digest"], set.Digest) } if evidence["writeset_universe_digest"] != set.UniverseDigest() || evidence["writeset_universe_digest"] == "" { t.Fatalf("整实例证据摘要必须登记:%v", evidence) } if evidence["index_mapping_sha256"] != "mapping-1" { t.Fatalf("当前索引映射必须覆盖旧值:%v", evidence) } if evidence["writeset_job"] != nil && evidence["job"] != "job-1" { t.Fatalf("写集合必须绑定作业:%v", evidence) } } func TestWriteSetDigestLookupRequiresJobTargetAndSnapshotMatch(t *testing.T) { store := &fakeVersionStore{versions: []governance.LibraryVersion{ {ID: "v1", Scope: "internal", Kind: governance.LibraryVersionProductionPrebackup, SnapshotID: "backup-snap", SourceJobID: "job-1", Evidence: map[string]any{"writeset_digest": "digest-1"}}, {ID: "v2", Scope: "internal", Kind: governance.LibraryVersionProductionPrebackup, SnapshotID: "backup-snap", SourceJobID: "job-2", Evidence: map[string]any{"writeset_digest": "digest-2"}}, }} digest, err := writeSetDigestOf(context.Background(), store, "internal", "job-1", "backup-snap") if err != nil || digest != "digest-1" { t.Fatalf("digest = %q, err = %v", digest, err) } // 别的作业的版本不能被拿来用。 if _, err := writeSetDigestOf(context.Background(), store, "internal", "job-3", "backup-snap"); err == nil { t.Fatal("找不到本作业的版本时必须失败") } // 有版本但没登记摘要 → 失败(不许当成"没有写集合"降级)。 missing := &fakeVersionStore{versions: []governance.LibraryVersion{{Kind: governance.LibraryVersionProductionPrebackup, SnapshotID: "backup-snap", SourceJobID: "job-1", Evidence: map[string]any{}}}} if _, err := writeSetDigestOf(context.Background(), missing, "internal", "job-1", "backup-snap"); err == nil { t.Fatal("没有写集合摘要时必须失败") } // 读不到版本 → 失败。 if _, err := writeSetDigestOf(context.Background(), &fakeVersionStore{err: errors.New("db down")}, "internal", "job-1", "backup-snap"); err == nil { t.Fatal("版本查询失败必须向上传递") } } func TestLoadWriteSetForJobChecksBinding(t *testing.T) { root := t.TempDir() set := sealedLedger(t, "") if _, err := v071.PersistWriteSet(root, &set); err != nil { t.Fatal(err) } store := &fakeVersionStore{versions: []governance.LibraryVersion{{Kind: governance.LibraryVersionProductionPrebackup, SnapshotID: "backup-snap", SourceJobID: "job-1", Evidence: map[string]any{"writeset_digest": set.Digest}}}} loaded, err := loadWriteSetForJob(context.Background(), store, root, "internal", "job-1", "backup-snap") if err != nil { t.Fatalf("load: %v", err) } if loaded.Digest != set.Digest { t.Fatalf("digest = %s", loaded.Digest) } // 目标不一致 → 拒绝(同一份记录不能被拿去恢复另一个目标)。 if _, err := loadWriteSetForJob(context.Background(), store, root, "external", "job-1", "backup-snap"); err == nil { t.Fatal("目标不一致时必须失败") } // 作业不一致 → 拒绝。 if _, err := loadWriteSetForJob(context.Background(), store, root, "internal", "job-2", "backup-snap"); err == nil { t.Fatal("作业不一致时必须失败") } // 记录文件被删 → 拒绝。 if err := os.Chmod(filepath.Join(root, "writesets", set.Digest+".json"), 0600); err != nil { t.Fatal(err) } if err := os.Remove(filepath.Join(root, "writesets", set.Digest+".json")); err != nil { t.Fatal(err) } if _, err := loadWriteSetForJob(context.Background(), store, root, "internal", "job-1", "backup-snap"); err == nil { t.Fatal("写集合文件缺失时必须失败") } } // 接管用的预备份来源:没有写集合就不许继续(返回错误,而不是给一个空引用)。 func TestLedgerBackupStoreRefusesWithoutWriteSet(t *testing.T) { store := ledgerBackupStore{ref: libraryrelease.BackupRef{ID: "backup-1", SnapshotID: "backup-snap"}} if _, err := store.Prepare(context.Background(), "target-snap", libraryrelease.CurrentState{}); err == nil { t.Fatal("没有写集合时接管必须失败") } set := sealedLedger(t, "") store.write = &set ref, err := store.Prepare(context.Background(), "target-snap", libraryrelease.CurrentState{}) if err != nil { t.Fatalf("prepare: %v", err) } if ref.WriteSet == nil || ref.WriteSet.Digest != set.Digest { t.Fatalf("接管必须带上持久化的写集合:%+v", ref) } } // 包装层必须把"写集合预检"这件事透出去:orchestrator 用的是类型断言, // 少一个方法就等于静默跳过台账(真实后果:真作业没有 writeset_digest、也没有 // writesets/ 文件,崩溃接管无台账可读)。 type plainTarget struct{ applied int } func (t *plainTarget) Current(context.Context) (libraryrelease.CurrentState, error) { return libraryrelease.CurrentState{}, nil } func (t *plainTarget) Apply(context.Context, libraryrelease.Stage, string) error { t.applied++ return nil } func (t *plainTarget) Verify(context.Context, libraryrelease.Expectation) error { return nil } func (t *plainTarget) Restore(context.Context, libraryrelease.BackupRef) error { return nil } type planningTarget struct { plainTarget planned int } func (t *planningTarget) PlanWriteSet(context.Context, libraryrelease.WriteSetPlan) (libraryrelease.WriteSet, error) { t.planned++ return libraryrelease.WriteSet{Version: libraryrelease.WriteSetVersion, JobID: "job-1", Target: "internal"}, nil } func TestContentTrackedTargetForwardsWriteSetPlanning(t *testing.T) { inner := &planningTarget{} wrapped := &contentTrackedTarget{inner: inner, onApply: func() {}} planner, ok := libraryrelease.Target(wrapped).(libraryrelease.WriteSetPlanner) if !ok { t.Fatal("包装后的目标必须仍然实现 WriteSetPlanner,否则写集合会被静默跳过") } if _, err := planner.PlanWriteSet(context.Background(), libraryrelease.WriteSetPlan{JobID: "job-1", Target: "internal"}); err != nil { t.Fatalf("plan: %v", err) } if inner.planned != 1 { t.Fatalf("预检必须落到内层目标,planned=%d", inner.planned) } // 内层不支持预检 ⇒ 硬错误,不许"没有台账也照写"。 strict := &contentTrackedTarget{inner: &plainTarget{}, onApply: func() {}} if _, err := strict.PlanWriteSet(context.Background(), libraryrelease.WriteSetPlan{}); err == nil { t.Fatal("内层不支持写集合预检时必须报错") } else if !strings.Contains(err.Error(), "写集合") { t.Fatalf("错误必须点名写集合:%v", err) } }