fba2713b4e
build / build (push) Successful in 1m54s
整库发布写入路径原先按 0.7.1 的固定表集合工作:0.9.0 没有 wiki_log_entries, Current/清理/编目/整实例指纹都会在不存在表上失败,跨版本闸门也因快照丢掉 SchemaVersion 而失效(未知版本被当作 74)。 改为在装配时解析目标 profile,表集合与清理顺序按解析结果;快照复制与范围改写 带上 SchemaVersion/Profile;跨版本发布显式拒绝并同时点名两个版本。单文档发布包 仍只支持 0.7.1,但改为明确拒绝并说明原因。 本机隔离验证:真实 0.9.0 schema 源库→导出→封存→写入干净 134 目标→逐表核对→ 写前镜像回滚;74→134 拒绝与 134 缺表不报错两个负例通过。make verify 17 项全绿。
192 lines
8.0 KiB
Go
192 lines
8.0 KiB
Go
package releasebundle
|
|
|
|
import (
|
|
"encoding/json"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
)
|
|
|
|
func TestSealAndValidateV071Manifest(t *testing.T) {
|
|
manifest := Manifest{
|
|
FormatVersion: "weknora-release-bundle/v1",
|
|
ExecutionID: "rx-safe", PublicationID: "tp-safe", SourceItemVersionID: "sv-safe",
|
|
SourceRevision: "source-v1", ParseRevision: "parser-v1@index-v1", ReleaseRevision: "release-v1",
|
|
CreatedAt: time.Date(2026, 9, 6, 8, 0, 0, 0, time.UTC),
|
|
Contract: Contract{
|
|
WeKnoraVersion: "v0.7.1", MigrationVersion: 74, TenantID: 10000,
|
|
KnowledgeBaseID: "kb-safe", KnowledgeID: "knowledge-safe",
|
|
RetrieverEngine: "elasticsearch_v8", EmbeddingModel: "bge-m3", EmbeddingDimension: 1024,
|
|
ElasticsearchMappingSHA256: strings.Repeat("a", 64),
|
|
},
|
|
Tables: []TableDigest{
|
|
{Name: "chunks", RowCount: 2, SHA256: strings.Repeat("b", 64)},
|
|
{Name: "knowledge_tags", RowCount: 1, SHA256: strings.Repeat("f", 64)},
|
|
{Name: "knowledges", RowCount: 1, SHA256: strings.Repeat("c", 64)},
|
|
},
|
|
Search: SearchDigest{DocumentCount: 2, SHA256: strings.Repeat("d", 64)},
|
|
Assets: AssetDigest{ObjectCount: 1, TotalBytes: 42, SHA256: strings.Repeat("e", 64)},
|
|
}
|
|
sealed, err := Seal(manifest)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if len(sealed.BundleSHA256) != 64 {
|
|
t.Fatalf("bundle sha=%q", sealed.BundleSHA256)
|
|
}
|
|
target := TargetContract{
|
|
WeKnoraVersion: "v0.7.1", MigrationVersion: 74, TenantID: 10000,
|
|
KnowledgeBaseID: "kb-safe", RetrieverEngine: "elasticsearch_v8",
|
|
EmbeddingModel: "bge-m3", EmbeddingDimension: 1024,
|
|
ElasticsearchMappingSHA256: strings.Repeat("a", 64),
|
|
}
|
|
if err := Validate(sealed, target, sameIDMapping()); err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
encoded, err := json.Marshal(sealed)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
for _, forbidden := range []string{"endpoint", "password", "secret", "api_key", "physical_path", "database_url"} {
|
|
if strings.Contains(strings.ToLower(string(encoded)), forbidden) {
|
|
t.Fatalf("manifest leaked forbidden field %q", forbidden)
|
|
}
|
|
}
|
|
}
|
|
|
|
func TestSealCanonicalizesTableOrder(t *testing.T) {
|
|
base := validManifest()
|
|
first, err := Seal(base)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
base.Tables[0], base.Tables[1] = base.Tables[1], base.Tables[0]
|
|
second, err := Seal(base)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if first.BundleSHA256 != second.BundleSHA256 {
|
|
t.Fatalf("digest differs: %s vs %s", first.BundleSHA256, second.BundleSHA256)
|
|
}
|
|
}
|
|
|
|
func TestValidateRejectsContractDriftAndUnknownTables(t *testing.T) {
|
|
manifest, err := Seal(validManifest())
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
target := validTarget()
|
|
tests := []struct {
|
|
name string
|
|
mutate func(*Manifest, *TargetContract)
|
|
}{
|
|
{name: "version", mutate: func(_ *Manifest, target *TargetContract) { target.WeKnoraVersion = "v0.7.2" }},
|
|
{name: "migration", mutate: func(_ *Manifest, target *TargetContract) { target.MigrationVersion = 73 }},
|
|
{name: "kb", mutate: func(_ *Manifest, target *TargetContract) { target.KnowledgeBaseID = "other" }},
|
|
{name: "embedding", mutate: func(_ *Manifest, target *TargetContract) { target.EmbeddingDimension = 768 }},
|
|
{name: "mapping", mutate: func(_ *Manifest, target *TargetContract) { target.ElasticsearchMappingSHA256 = strings.Repeat("f", 64) }},
|
|
{name: "unknown table", mutate: func(manifest *Manifest, _ *TargetContract) {
|
|
manifest.Tables = append(manifest.Tables, TableDigest{Name: "users", RowCount: 1, SHA256: strings.Repeat("1", 64)})
|
|
}},
|
|
{name: "tampered bundle", mutate: func(manifest *Manifest, _ *TargetContract) { manifest.Search.DocumentCount++ }},
|
|
{name: "missing parse revision", mutate: func(manifest *Manifest, _ *TargetContract) { manifest.ParseRevision = "" }},
|
|
}
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
candidate, contract := manifest, target
|
|
candidate.Tables = append([]TableDigest(nil), manifest.Tables...)
|
|
tt.mutate(&candidate, &contract)
|
|
if err := Validate(candidate, contract, sameIDMapping()); err == nil {
|
|
t.Fatal("Validate() error=nil")
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
func validManifest() Manifest {
|
|
return Manifest{
|
|
FormatVersion: "weknora-release-bundle/v1", ExecutionID: "rx-safe", PublicationID: "tp-safe",
|
|
SourceItemVersionID: "sv-safe", SourceRevision: "source-v1", ParseRevision: "parser-v1@index-v1", ReleaseRevision: "release-v1",
|
|
CreatedAt: time.Date(2026, 9, 6, 8, 0, 0, 0, time.UTC),
|
|
Contract: Contract{WeKnoraVersion: "v0.7.1", MigrationVersion: 74, TenantID: 10000, KnowledgeBaseID: "kb-safe", KnowledgeID: "knowledge-safe", RetrieverEngine: "elasticsearch_v8", EmbeddingModel: "bge-m3", EmbeddingDimension: 1024, ElasticsearchMappingSHA256: strings.Repeat("a", 64)},
|
|
Tables: []TableDigest{{Name: "knowledges", RowCount: 1, SHA256: strings.Repeat("b", 64)}, {Name: "chunks", RowCount: 1, SHA256: strings.Repeat("c", 64)}},
|
|
Search: SearchDigest{DocumentCount: 1, SHA256: strings.Repeat("d", 64)}, Assets: AssetDigest{SHA256: strings.Repeat("e", 64)},
|
|
}
|
|
}
|
|
|
|
func validTarget() TargetContract {
|
|
return TargetContract{WeKnoraVersion: "v0.7.1", MigrationVersion: 74, TenantID: 10000, KnowledgeBaseID: "kb-safe", RetrieverEngine: "elasticsearch_v8", EmbeddingModel: "bge-m3", EmbeddingDimension: 1024, ElasticsearchMappingSHA256: strings.Repeat("a", 64)}
|
|
}
|
|
|
|
// sameIDMapping is the historical semantics: no declared target, so the
|
|
// production base must carry the tested base's id.
|
|
func sameIDMapping() KnowledgeBaseMapping {
|
|
return KnowledgeBaseMapping{SourceKnowledgeBaseID: "kb-safe"}
|
|
}
|
|
|
|
// A declared 源库 → 目标库 mapping lets the bundle land in a DIFFERENT base,
|
|
// which is the whole point of the production binding setting.
|
|
func TestValidateAcceptsDeclaredCrossBaseMapping(t *testing.T) {
|
|
manifest, err := Seal(validManifest())
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
target := validTarget()
|
|
target.KnowledgeBaseID = "prod-kb"
|
|
mapping := KnowledgeBaseMapping{SourceKnowledgeBaseID: "kb-safe", TargetKnowledgeBaseID: "prod-kb"}
|
|
if err := Validate(manifest, target, mapping); err != nil {
|
|
t.Fatalf("declared cross-base release must validate: %v", err)
|
|
}
|
|
}
|
|
|
|
// An undeclared, stale or self-inconsistent mapping must fail closed: neither
|
|
// "target drifted somewhere else" nor "mapping points at the source" passes.
|
|
func TestValidateRejectsUndeclaredOrDriftedMapping(t *testing.T) {
|
|
manifest, err := Seal(validManifest())
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
tests := []struct {
|
|
name string
|
|
mapping KnowledgeBaseMapping
|
|
target string
|
|
}{
|
|
{name: "mapping source does not match bundle", mapping: KnowledgeBaseMapping{SourceKnowledgeBaseID: "other"}, target: "other"},
|
|
{name: "target differs from declared mapping", mapping: KnowledgeBaseMapping{SourceKnowledgeBaseID: "kb-safe", TargetKnowledgeBaseID: "prod-kb"}, target: "another-kb"},
|
|
{name: "mapping target differs while target keeps source id", mapping: KnowledgeBaseMapping{SourceKnowledgeBaseID: "kb-safe", TargetKnowledgeBaseID: "prod-kb"}, target: "kb-safe"},
|
|
}
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
target := validTarget()
|
|
target.KnowledgeBaseID = tt.target
|
|
if err := Validate(manifest, target, tt.mapping); err == nil {
|
|
t.Fatal("Validate() error=nil")
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
// 单文档发布包只支持 0.7.1 契约。0.9.0(134)的包必须被**明确拒绝并说明原因**:
|
|
// 静默按 74 处理会让 0.9.0 的表集合/索引文档走错写入路径,而泛化错误又让人分不清
|
|
// "版本不支持"和"字段写错"。
|
|
func TestSealRejectsNonV071SchemaContractExplicitly(t *testing.T) {
|
|
manifest := validManifest()
|
|
manifest.Contract.WeKnoraVersion = "v0.9.0"
|
|
manifest.Contract.MigrationVersion = 134
|
|
_, err := Seal(manifest)
|
|
if err == nil {
|
|
t.Fatal("0.9.0 release bundle must be refused")
|
|
}
|
|
for _, want := range []string{"v0.9.0", "134", "74", "library-level publish"} {
|
|
if !strings.Contains(err.Error(), want) {
|
|
t.Fatalf("rejection message must name %q, got %v", want, err)
|
|
}
|
|
}
|
|
// 只改版本号、不改 WeKnora 版本同样必须拒绝:两者必须成对出现。
|
|
manifest = validManifest()
|
|
manifest.Contract.MigrationVersion = 134
|
|
if _, err := Seal(manifest); err == nil {
|
|
t.Fatal("schema version 134 with a v0.7.1 label must be refused")
|
|
}
|
|
}
|