Files
ssw-ontology/server/mcp_progress_integration_test.go
adminandClaude Code d14440a3ed feat(server): v1.8.0 本体导入 + 分区 + 行级归属 + 认证位 + 结构 diff + 分页 + 进度回报
一次收口 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]>
2026-11-06 13:51:48 +08:00

150 lines
4.6 KiB
Go
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//go:build integration
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"strings"
"testing"
"time"
)
// mcpCallSSE 以 SSE 模式调一次 MCP tools/call,返回原始响应体(多帧拼接)。
//
// 与 mcpCallRaw 的区别:mcpCallRaw 只取第一帧 data(单响应场景),
// 这里要拿到「进度帧 + 最终帧」的全序列。
func mcpCallSSE(t *testing.T, e *testEnv, headers map[string]string, tool string, args map[string]any, meta map[string]any) string {
t.Helper()
if args == nil {
args = map[string]any{}
}
params := map[string]any{"name": tool, "arguments": args}
if meta != nil {
params["_meta"] = meta
}
body, _ := json.Marshal(map[string]any{
"jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": params,
})
req, err := http.NewRequest("POST", e.srv.URL+"/api/v1/mcp", bytes.NewReader(body))
if err != nil {
t.Fatalf("req: %v", err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "application/json, text/event-stream")
for k, v := range headers {
req.Header.Set(k, v)
}
resp, err := e.srv.Client().Do(req)
if err != nil {
t.Fatalf("do: %v", err)
}
defer resp.Body.Close()
raw, _ := io.ReadAll(resp.Body)
return string(raw)
}
// sseFrames 拆 SSE 响应体里的 data 帧内容。
func sseFrames(body string) []string {
var out []string
for _, line := range strings.Split(body, "\n") {
line = strings.TrimSpace(line)
if strings.HasPrefix(line, "data: ") {
out = append(out, strings.TrimPrefix(line, "data: "))
}
}
return out
}
// TestIntegration_MCPProgress 长任务的进度回报(benchmark §2.6)。
//
// 三个容易翻车的点,本用例逐个钉住:
// 1. 客户端带 _meta.progressToken → 服务端以 SSE 帧吐 notifications/progress,
// 且最终结果帧仍然在(进度不能顶掉结果);
// 2. 不带 progressToken → 行为与从前完全一致(单响应,无进度帧)——不回归老客户端;
// 3. 进度帧里的 progressToken 必须原样回带,客户端才知道对应哪次请求。
func TestIntegration_MCPProgress(t *testing.T) {
env, a := setupTestEnv(t)
mh := authHeaderFor(t, a, "manager")
typ := env.typeKey + "_prog"
zoneProbeType(t, env, a, typ)
items := make([]map[string]any, 0, 5)
for i := 0; i < 5; i++ {
items = append(items, map[string]any{
"type": typ,
"pk": fmt.Sprintf("prog-%d-%d", time.Now().UnixNano(), i),
"properties": map[string]any{
"name": fmt.Sprintf("进度探针%d", i),
},
})
}
// ---- 带 progressToken:应有进度帧 + 最终结果帧 ----
body := mcpCallSSE(t, env, mh, "batch_create_objects",
map[string]any{"items": items, "stop_on_error": false},
map[string]any{"progressToken": "tok-progress-1"})
if !strings.Contains(body, "event: message") {
t.Fatalf("进度模式应返回 SSE 帧:%q", body)
}
frames := sseFrames(body)
if len(frames) < 2 {
t.Fatalf("应至少有进度帧 + 结果帧,实到 %d 帧:%q", len(frames), body)
}
progressFrames := 0
sawToken := false
sawResult := false
for _, f := range frames {
var out map[string]any
if err := json.Unmarshal([]byte(f), &out); err != nil {
t.Fatalf("帧不是合法 JSON: %v (%q)", err, f)
}
if out["method"] == "notifications/progress" {
progressFrames++
params, _ := out["params"].(map[string]any)
if params["progressToken"] != "tok-progress-1" {
t.Fatalf("进度帧应原样回带 progressToken,实到 %v", params["progressToken"])
}
sawToken = true
continue
}
if res, ok := out["result"].(map[string]any); ok {
if isErr, _ := res["isError"].(bool); isErr {
t.Fatalf("批量写入不应失败:%s", f)
}
sawResult = true
}
}
if progressFrames == 0 {
t.Fatalf("应至少有一条进度帧:%q", body)
}
if !sawToken {
t.Fatalf("应回带 progressToken:%q", body)
}
if !sawResult {
t.Fatalf("进度帧不能顶掉最终结果帧:%q", body)
}
// ---- 不带 progressToken:仍是单响应,无进度帧(老客户端行为不变)----
body = mcpCallSSE(t, env, mh, "batch_create_objects",
map[string]any{"items": items[:1], "stop_on_error": false}, nil)
if strings.Contains(body, "notifications/progress") {
t.Fatalf("不带 progressToken 不应吐进度帧:%q", body)
}
frames = sseFrames(body)
if len(frames) != 1 {
t.Fatalf("不带 progressToken 应只有 1 帧(单响应),实到 %d 帧:%q", len(frames), body)
}
var out map[string]any
if err := json.Unmarshal([]byte(frames[0]), &out); err != nil {
t.Fatalf("单响应帧不是合法 JSON: %v (%q)", err, frames[0])
}
if _, ok := out["result"]; !ok {
t.Fatalf("单响应帧应含 result:%q", frames[0])
}
}