Files
knowledge-governance/internal/releaseadapter/v071/library_resource_references.go
T
姚章浩 fba2713b4e
build / build (push) Successful in 1m54s
feat(library): 发布写入支持 WeKnora 0.9.0 schema 134
整库发布写入路径原先按 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 项全绿。
2026-11-16 20:42:23 +08:00

78 lines
3.2 KiB
Go

package v071
import (
"context"
"errors"
"fmt"
"strings"
"knowledge-governance/internal/libraryrelease"
)
// Keep capture/verification and deletion protection on the same set of bodies.
// predicate is an internal SQL fragment, never caller-supplied content; tables comes
// from the resolved schema profile (0.9.0 has no wiki_log_entries to scan).
func libraryResourceBodyReferenceSQL(tables []string, predicate string) string {
queries := []string{}
for _, table := range tables {
if table == "resources" || table == "resource_bindings" || table == "knowledge_tag_relations" {
continue
}
queries = append(queries, fmt.Sprintf(`SELECT 1 FROM %s c WHERE (%s) AND coalesce(resources.handle,'')<>'' AND position('resource://'||resources.handle IN to_jsonb(c)::text)>0`, table, predicate))
}
return strings.Join(queries, " UNION ALL ")
}
// This must precede *all* restore mutations, including ES and object deletes.
// A created row is not permission to invalidate a later out-of-plan reader.
func ensureRestorableResourceReferences(ctx context.Context, q libraryClosureReader, tables []string, set libraryrelease.WriteSet) error {
ids := set.CreatedIDs("resources")
if len(ids) == 0 {
return nil
}
if e := verifyLibraryResourceOwners(ctx, q, ids); e != nil {
return e
}
bindings := []string{}
for _, row := range set.Rows {
if row.Table == "resource_bindings" {
bindings = append(bindings, row.ID)
}
}
var referenced bool
err := q.QueryRow(ctx, `SELECT EXISTS(SELECT 1 FROM resource_bindings b WHERE b.resource_id=ANY($1::text[]) AND
(NOT(b.id=ANY($2::text[])) OR b.tenant_id IS DISTINCT FROM $3 OR NOT (
(b.owner_type='knowledge' AND EXISTS(SELECT 1 FROM knowledges k WHERE k.id=b.owner_id AND k.tenant_id=$3 AND k.knowledge_base_id=$4)) OR
(b.owner_type='chunk' AND EXISTS(SELECT 1 FROM chunks c WHERE c.id=b.owner_id AND c.tenant_id=$3 AND c.knowledge_base_id=$4)))))`, ids, bindings, set.TenantID, set.KnowledgeBaseID).Scan(&referenced)
if err != nil {
return err
}
if referenced {
return errors.New("created resource has out-of-plan bindings; restore held before writes")
}
bodySQL := libraryResourceBodyReferenceSQL(tables, "c.tenant_id IS DISTINCT FROM $2 OR c.knowledge_base_id IS DISTINCT FROM $3")
err = q.QueryRow(ctx, `SELECT EXISTS(SELECT 1 FROM resources WHERE id=ANY($1::text[]) AND EXISTS (`+bodySQL+`))`, ids, set.TenantID, set.KnowledgeBaseID).Scan(&referenced)
if err != nil {
return err
}
if referenced {
return errors.New("created resource has foreign body/metadata references; restore held before writes")
}
return nil
}
// Recheck under the already-held resource parent locks. This does not claim
// cross-store isolation from uncontrolled writers; deployed exclusivity is separate.
func ensureCreatedResourcesUnreferenced(ctx context.Context, q libraryClosureReader, tables, ids []string) error {
var referenced bool
err := q.QueryRow(ctx, `SELECT EXISTS(SELECT 1 FROM resources WHERE id=ANY($1::text[]) AND
(EXISTS(SELECT 1 FROM resource_bindings b WHERE b.resource_id=resources.id) OR EXISTS (`+libraryResourceBodyReferenceSQL(tables, "TRUE")+`)))`, ids).Scan(&referenced)
if err != nil {
return err
}
if referenced {
return errors.New("created resource is still referenced; refusing row deletion")
}
return nil
}