一次收口 2026-11-06 的九项能力(CHANGELOG 1.5.4 → 1.8.0): - 自检探针(readiness.go):check_readiness / check_answerable 两个只读探针,把 「本体里没有」「我没权限看」「模型没抽全」三种空结果原因拆开 - 读路径语义钉死(scope.go):标记与分级的可见范围统一由 Scope 产出,实例分级 为空时继承类型默认级(fail-closed),列表与详情口径一致 - 行级可改性轴(object_owner.go):归属只收窄不宽于 grants,所有对象写路径统一 走 canWriteObject,归属查询失败即拒绝 - 公理第 6 类 certification:认证位保护人工策展内容,AI 重摄取不再覆盖已认证条目 - 跨版本结构 diff(schema_diff.go):schema_snapshots 全量快照 + diff 端点,机器 事实与人工策展分组呈现 - 分区维度 zone:分区绑类型、命中任一即可见,读路径一律带 zone 条件 - 统一分页信封(pagination.go):列表回包统一 count/total/limit/offset/has_more/ truncated,total 与 items 同源 - MCP 长任务进度(mcp_progress.go):客户端带 progressToken 才走 SSE 进度帧 - 本体 schema 导入(ontology_import.go):Turtle 导入 + 四道 fail-fast 闸门 + 整事务 + (source, external_id) 幂等 + IRI 往返不变式 MCP 工具清单并入单一注册表(mcp_registry.go),对外声明与实际可调不再各说各话; 工具数 42 → 54(只读 27 / 写入 27),注册表与分发 case 的双向漂移由 AST 单测拦截。 CHANGELOG 编号整理:新「认证位 + 行级归属」条目由 1.6.0 改为 1.5.6(1.6.x 留给 分区与结构 diff),2026-09-20 的 GB/T 规划稿改标「规划稿·未发布」——该能力已并入 v1.5.1,避免与正式发布的版本号重复。 Co-Authored-By: Claude Code <[email protected]>
146 lines
4.6 KiB
Go
146 lines
4.6 KiB
Go
package main
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
)
|
||
|
||
// TestZoneDeniedTypesSemantics 钉死分区的判定口径(纯函数):
|
||
//
|
||
// - 类型不属于任何分区 → 公共区,任何主体可见;
|
||
// - 类型属于分区 Z → 主体持有 Z 中**至少一个**即可见(目录分区的直觉);
|
||
// - 主体一个分区都没有 → 所有被分区的类型都不可见(fail-closed)。
|
||
func TestZoneDeniedTypesSemantics(t *testing.T) {
|
||
typeZones := map[string][]string{
|
||
"PublicType": {}, // 公共区
|
||
"Finance": {"fin"}, // 单分区
|
||
"Shared": {"fin", "corp"}, // 双分区:命中任一即可见
|
||
"Secret": {"sec"}, // 主体没有的分区
|
||
}
|
||
|
||
// 主体持有 fin(没有 corp / sec)
|
||
held := map[string]bool{"fin": true}
|
||
denied := zoneDeniedTypes(held, typeZones)
|
||
|
||
if denied["PublicType"] {
|
||
t.Error("公共区类型不应被分区挡住")
|
||
}
|
||
if denied["Finance"] {
|
||
t.Error("持有 fin 的主体应能看到 Finance 类型的实例")
|
||
}
|
||
if denied["Shared"] {
|
||
t.Error("持有 fin 的主体应能看到 Shared 类型(命中任一分区即可)")
|
||
}
|
||
if !denied["Secret"] {
|
||
t.Error("主体不持有 sec,Secret 类型必须不可见(fail-closed)")
|
||
}
|
||
|
||
// 一个分区都没有的主体:所有被分区的类型都不可见,公共区照旧可见
|
||
none := zoneDeniedTypes(map[string]bool{}, typeZones)
|
||
if none["PublicType"] {
|
||
t.Error("公共区类型对任何主体都可见")
|
||
}
|
||
for _, typ := range []string{"Finance", "Shared", "Secret"} {
|
||
if !none[typ] {
|
||
t.Errorf("无分区的主体不应看到 %s 类型的实例", typ)
|
||
}
|
||
}
|
||
|
||
// 持有 corp 的主体:Shared 可见,Finance 不可见(不持有 fin)
|
||
corp := zoneDeniedTypes(map[string]bool{"corp": true}, typeZones)
|
||
if corp["Shared"] {
|
||
t.Error("持有 corp 的主体应能看到 Shared 类型")
|
||
}
|
||
if !corp["Finance"] {
|
||
t.Error("未持有 fin 的主体不应看到 Finance 类型的实例")
|
||
}
|
||
}
|
||
|
||
// TestZoneCondSQL 生成的 SQL 条件:
|
||
// - 无权访问的类型为空 → "TRUE"(不配置分区 = 零影响);
|
||
// - 否则用「类型不在黑名单里」表达,且占位符编号与 args 一致。
|
||
func TestZoneCondSQL(t *testing.T) {
|
||
args := []interface{}{"x"}
|
||
cond, args := zoneCondSQL("o", "type_api_name", nil, args)
|
||
if cond != "TRUE" {
|
||
t.Errorf("无分区配置时应返回 TRUE,实到 %q", cond)
|
||
}
|
||
if len(args) != 1 {
|
||
t.Errorf("args 不应变化,实到 %v", args)
|
||
}
|
||
|
||
cond, args = zoneCondSQL("o", "type_api_name", []string{"SecretType"}, args)
|
||
if !strings.Contains(cond, "o.type_api_name") {
|
||
t.Errorf("条件应引用别名.类型列,实到 %q", cond)
|
||
}
|
||
if !strings.Contains(cond, "$2") {
|
||
t.Errorf("条件应引用第 2 个占位符,实到 %q", cond)
|
||
}
|
||
if len(args) != 2 {
|
||
t.Fatalf("args 应追加 1 个,实到 %v", args)
|
||
}
|
||
denied, ok := args[1].([]string)
|
||
if !ok || len(denied) != 1 || denied[0] != "SecretType" {
|
||
t.Errorf("追加的参数应是被屏蔽的类型清单,实到 %v", args[1])
|
||
}
|
||
}
|
||
|
||
// TestZoneFilterAllows 过滤器本身的语义:manager 豁免、fail-closed 时全拒。
|
||
func TestZoneFilterAllows(t *testing.T) {
|
||
var nilFilter *zoneFilter
|
||
if !nilFilter.allows("AnyType") {
|
||
t.Error("nil 过滤器应放行(等价于未启用分区)")
|
||
}
|
||
empty := &zoneFilter{}
|
||
if !empty.allows("AnyType") {
|
||
t.Error("空过滤器应放行")
|
||
}
|
||
fc := &zoneFilter{failClosed: true}
|
||
if fc.allows("AnyType") {
|
||
t.Error("fail-closed 时不应放行任何类型")
|
||
}
|
||
f := &zoneFilter{denied: map[string]bool{"Secret": true}}
|
||
if f.allows("Secret") {
|
||
t.Error("被屏蔽的类型不应放行")
|
||
}
|
||
if !f.allows("Public") {
|
||
t.Error("未列入屏蔽的类型应放行")
|
||
}
|
||
dl := f.deniedTypes()
|
||
if len(dl) != 1 || dl[0] != "Secret" {
|
||
t.Errorf("deniedTypes 应返回有序清单,实到 %v", dl)
|
||
}
|
||
}
|
||
|
||
// TestNormalizeZoneName 分区名校验。
|
||
func TestNormalizeZoneName(t *testing.T) {
|
||
if _, err := normalizeZoneName(" "); err == nil {
|
||
t.Error("空分区名应报错")
|
||
}
|
||
long := strings.Repeat("x", 65)
|
||
if _, err := normalizeZoneName(long); err == nil {
|
||
t.Error("超长分区名应报错")
|
||
}
|
||
name, err := normalizeZoneName(" 财务 ")
|
||
if err != nil {
|
||
t.Fatalf("合法分区名不应报错: %v", err)
|
||
}
|
||
if name != "财务" {
|
||
t.Errorf("分区名应去空白,实到 %q", name)
|
||
}
|
||
}
|
||
|
||
// TestNormalizeNameList 清单归一:去空白、去重、保序。
|
||
func TestNormalizeNameList(t *testing.T) {
|
||
got := normalizeNameList([]string{" a ", "b", "a", "", " ", "c"})
|
||
want := []string{"a", "b", "c"}
|
||
if len(got) != len(want) {
|
||
t.Fatalf("长度不符:实到 %v", got)
|
||
}
|
||
for i := range want {
|
||
if got[i] != want[i] {
|
||
t.Fatalf("实到 %v,期望 %v", got, want)
|
||
}
|
||
}
|
||
}
|