draftgo-cli 4.0.22 → 4.0.23

package/README.md

@@ -134,7 +134,7 @@ draftgo test custom-services <id> --source draft --handler route:POST:/path --in
 
 `commit custom-services` 会自动完成提交、验证和发布，并输出明确的 published 提示；`validate`、`test`、`publish` 仍可作为单独的兼容入口。`test` 只运行 cloud draft，不调用线上版本；发布后如需再试运行，先修改并提交形成新草稿。默认拒绝外部副作用；外部调用用 `--side-effect-policy mock` 模拟，只有明确需要真实副作用时才组合 `--side-effect-policy live --test-write`。数据库等写操作也必须显式加 `--test-write`。
 
-`--source` 支持 `draft`（默认）、`auto`、`published`。Selector 支持 `route:METHOD:/path`、`event:name`、`scheduled:name` 或 handler 名；`--input`、`--headers`、`--user` 都读取 UTF-8 JSON object。普通 SDK 调用继承已验证的 `platform` 或 `space` 上下文；可信服务可对单次操作显式使用 `ctx.Admin.*`，该提升会审计且不会泄漏到后续调用。余额扣款、权益、支付和订阅使用 `ctx.Billing` / `ctx.Admin.Billing`，精确签名查看 checkout 后只读的 `.draftgo-sdk/billing.go`。完整字段与规则见[自定义服务方法指南](resources/skill/references/custom-services.md)。
+`--source` 支持 `draft`（默认）、`auto`、`published`。Selector 支持 `route:METHOD:/path`、`event:name`、`scheduled:name` 或 handler 名；`--input`、`--headers`、`--user` 都读取 UTF-8 JSON object。普通 SDK 调用继承已验证的 `platform` 或 `space` 上下文；自定义服务可对单次操作显式使用 `ctx.Admin.*`，该次调用按系统内置 `*:*:all` 全权限执行、进入审计且不会泄漏到后续调用。余额扣款、权益、支付和订阅使用 `ctx.Billing` / `ctx.Admin.Billing`，精确签名查看 checkout 后只读的 `.draftgo-sdk/billing.go`。完整字段与规则见[自定义服务方法指南](resources/skill/references/custom-services.md)。
 
 ### MCP/API
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "draftgo-cli",
-  "version": "4.0.22",
+  "version": "4.0.23",
   "description": "Install and manage the DraftGo skill across AI coding agents (Claude Code, Codex, Cursor, Windsurf, Antigravity, Copilot, Gemini, Kiro, Pi).",
   "bin": {
     "draftgo": "bin/draftgo.js"

package/resources/custom-service-sdk/auth_test.go

@@ -0,0 +1,56 @@
+package sdk
+
+import (
+	"context"
+	"errors"
+	"testing"
+)
+
+type authRecordingClient struct {
+	operation string
+	args      map[string]any
+	err       error
+}
+
+func (client *authRecordingClient) Call(_ context.Context, operation string, args any) (any, error) {
+	client.operation = operation
+	client.args, _ = args.(map[string]any)
+	return true, client.err
+}
+
+func TestAuthAssertionsUseHostAuthorization(t *testing.T) {
+	client := &authRecordingClient{}
+	draftgo := NewContext(context.Background(), nil, map[string]any{
+		"id": float64(7), "is_admin": false, "role_code": "member",
+	}, nil, client)
+
+	if err := draftgo.Auth.RequireAdmin(); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_admin" {
+		t.Fatalf("operation = %q", client.operation)
+	}
+	if err := draftgo.Auth.RequireRole(" workspace_owner "); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_role" || client.args["role"] != "workspace_owner" {
+		t.Fatalf("operation=%q args=%#v", client.operation, client.args)
+	}
+
+	client.err = errors.New("denied by host")
+	if err := draftgo.Auth.RequireAdmin(); err == nil || err.Error() != "denied by host" {
+		t.Fatalf("host denial was not returned: %v", err)
+	}
+}
+
+func TestAdminAuthCallCarriesScopedElevation(t *testing.T) {
+	client := &authRecordingClient{}
+	draftgo := NewContext(context.Background(), nil, nil, nil, client)
+
+	if err := draftgo.Admin.Auth.RequireAdmin(); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_admin" || client.args["__draftgo_admin"] != true {
+		t.Fatalf("operation=%q args=%#v", client.operation, client.args)
+	}
+}

package/resources/custom-service-sdk/manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "module": "draftgo/sdk",
-  "fingerprint": "c750610f8d4b1652da259ea436d47d9856104261c9af1b0e3753c073d36d4693",
+  "fingerprint": "94d0b5064c3d5c3d742ddf2856ed6e37196ff81bd16696aa88cd8267c3f57889",
   "files": [
     {
       "path": "ai.go",
@@ -13,6 +13,11 @@
       "sha256": "d5a906ea3d9d0451f116d2acac54bfb83669e5e471d1d5ada7c0e1fdabef13b6",
       "bytes": 6531
     },
+    {
+      "path": "auth_test.go",
+      "sha256": "f0a02db739c8c5fa9d2856c59bd7ec823194cae50c1445f7b1340ce3dc0a616f",
+      "bytes": 1604
+    },
     {
       "path": "billing.go",
       "sha256": "9ce87c80885aa8b8996710622ec0f14cc7a74d3ca78e5ed4168b6c135994d583",
@@ -30,8 +35,8 @@
     },
     {
       "path": "platform.go",
-      "sha256": "ec0d8621a8bb677578001d029fe191af58df9d275204eced5e8061b339ad085b",
-      "bytes": 12373
+      "sha256": "deb0ab4a91dbb9a1f07974982ffb218d89f719b3691cf5e9a955abcc86a6d2ba",
+      "bytes": 11923
     },
     {
       "path": "platform_logger_test.go",
@@ -65,8 +70,8 @@
     },
     {
       "path": "sdk.go",
-      "sha256": "95ffcc335416ac842e06ea51b75e6739a04ddd5573a946e4175d6c5f8c110a67",
-      "bytes": 8167
+      "sha256": "b67db621642c389a2000e52b1640bacccf23a6d94f1fdcc1989e6a4244821924",
+      "bytes": 8224
     }
   ]
 }

package/resources/custom-service-sdk/platform.go

@@ -6,6 +6,7 @@ import (
 	"errors"
 	"fmt"
 	"net/http"
+	"strings"
 	"sync"
 	"time"
 )
@@ -320,41 +321,25 @@ func asInt(value any) int {
 	}
 }
 
-type authClient struct{ user map[string]any }
+type authClient struct {
+	platformClient
+	user map[string]any
+}
 
 func (a authClient) CurrentUser() map[string]any { return a.user }
 func (a authClient) RequireLogin() error {
-	if a.user == nil {
-		return errors.New("require_login failed: user is not authenticated")
-	}
-	return nil
+	_, err := a.call(a.context, "auth.require_login", map[string]any{})
+	return err
 }
 func (a authClient) RequireAdmin() error {
-	if err := a.RequireLogin(); err != nil {
-		return err
-	}
-	if a.user["is_admin"] == true || a.user["role_code"] == "admin" {
-		return nil
-	}
-	for _, role := range asSlice(a.user["roles"]) {
-		if item, ok := role.(map[string]any); ok && item["code"] == "admin" {
-			return nil
-		}
-	}
-	return errors.New("require_admin failed: user is not an administrator")
+	_, err := a.call(a.context, "auth.require_admin", map[string]any{})
+	return err
 }
 func (a authClient) RequireRole(role string) error {
-	if err := a.RequireLogin(); err != nil {
-		return err
-	}
-	if a.user["role_code"] == role {
-		return nil
+	role = strings.TrimSpace(role)
+	if role == "" {
+		return errors.New("require_role failed: role is required")
 	}
-	for _, raw := range asSlice(a.user["roles"]) {
-		if item, ok := raw.(map[string]any); ok && item["code"] == role {
-			return nil
-		}
-	}
-	return fmt.Errorf("require_role failed: missing role %q", role)
+	_, err := a.call(a.context, "auth.require_role", map[string]any{"role": role})
+	return err
 }
-func asSlice(value any) []any { items, _ := value.([]any); return items }

package/resources/custom-service-sdk/sdk.go

@@ -151,11 +151,11 @@ func NewContextWithResource(draftgo context.Context, input, user map[string]any,
 	return &Context{
 		Input: input, User: user, Headers: headers, context: draftgo,
 		Platform: resource.ScopeType == ScopePlatform, WorkspaceID: resource.WorkspaceID, SpaceID: resource.SpaceID, Principal: principal,
-		DB: dbClient{platform}, Users: usersClient{platform}, Auth: authClient{user: user}, Notify: notifierClient{platform},
+		DB: dbClient{platform}, Users: usersClient{platform}, Auth: authClient{platformClient: platform, user: user}, Notify: notifierClient{platform},
 		HTTP: httpClient{platform}, Cache: cacheClient{platform}, Config: configClient{platform}, AIHub: aiHubClient{platform},
 		Knowledge: knowledgeClient{platform}, Memory: memoryClient{platform}, Files: fileStoreClient{platform}, Scope: scopeClient{platform}, Billing: billingClient{platform},
 		Admin: Admin{
-			DB: dbClient{adminPlatform}, Users: usersClient{adminPlatform}, Auth: authClient{user: user}, Notify: notifierClient{adminPlatform},
+			DB: dbClient{adminPlatform}, Users: usersClient{adminPlatform}, Auth: authClient{platformClient: adminPlatform, user: user}, Notify: notifierClient{adminPlatform},
 			HTTP: httpClient{adminPlatform}, Cache: cacheClient{adminPlatform}, Config: configClient{adminPlatform}, AIHub: aiHubClient{adminPlatform},
 			Knowledge: knowledgeClient{adminPlatform}, Memory: memoryClient{adminPlatform},
 			Files: fileStoreClient{adminPlatform}, Scope: scopeClient{adminPlatform}, Billing: billingClient{adminPlatform},

package/resources/skill/SKILL.md

@@ -47,7 +47,7 @@ description: Use this skill to inspect, develop, debug, or deliver a DraftGo app
 - 同一文件或 DraftGo 资源全程只能由一个 Agent 修改；不同资源、operation 和 owner 不冲突的单元可以并发，不设置客户端并发上限；同一资源的依赖步骤保持串行。主 Agent 负责 owner 分配、汇总、验证、交付和 worklog 状态。
 - 用户 API Key 只保存在 `.draftgo/config.json`，不得进入宿主配置、命令参数、Skill、日志、manifest 或错误消息。宿主 MCP 配置只运行 `draftgo mcp serve`。
 - 页面优先使用可信本地资源；禁止境外 CDN。净化不可信 HTML，关键状态不能只靠颜色或动效表达。页面通过 `window.parent.App` 使用认证、权限、反馈和主题；详细规则见前端与运行时 Reference。
-- 普通自定义服务 SDK 调用继承调用者、服务归属和 AccessGrant；`ctx.Admin.*` 是可信服务显式选择的单次管理提升，允许跨用户/空间操作且必须进入审计，不会泄漏到后续调用。高风险 MCP operation 仅在用户意图明确且影响范围已核对时设置 `confirm=true`。
+- 普通自定义服务 SDK 调用继承调用者、服务归属和 AccessGrant；`ctx.Admin.*` 是仅供自定义服务显式选择的单次系统内部授权，按 `*:*:all` 全权限执行并进入审计，不会泄漏到后续调用。高风险 MCP operation 仅在用户意图明确且影响范围已核对时设置 `confirm=true`。
 - `.draftgo/tmp/` 可清理；先运行 `draftgo clean --dry-run`，再在需要时使用 `--yes`。用户可查验的证据放入已注册的 `.draftgo/artifacts/`。
 
 ## 完成条件

package/resources/skill/manifest.json

@@ -2,7 +2,7 @@
   "schema_version": "1.0",
   "id": "draftgo",
   "name": "DraftGo 开发助手",
-  "version": "4.0.22",
+  "version": "4.0.23",
   "entry": "SKILL.md",
   "description": "以 Skill/reference 任务路由、MCP 实时发现、长正文 checkout/commit、统一验证和完成日志为边界的 DraftGo 工作流。",
   "license": "MIT",

package/resources/skill/references/custom-services.md

@@ -62,7 +62,7 @@ func health(ctx *sdk.Context) (any, error) {
 
 输入字段为 `method`、`headers`、`body`、`query_params`、`path_params`。身份由 `ctx.Auth.CurrentUser()` 获取。普通 `ctx.DB`、`ctx.Users`、`ctx.Billing` 等调用继承请求调用者权限；管理员创建服务、持有服务凭据或 `RequireAdmin` 都不会自动提升 SDK 调用。
 
-`ctx.Admin.*` 是可信服务显式选择的单次管理提升：保持服务主体与已验证执行上下文，但可执行平台级或跨用户/空间管理操作；每次调用都会进入审计，提升不会泄漏到后续普通调用。服务代码仍拿不到服务凭据、数据库连接或管理员凭据。公开 Route 不应无条件调用 Admin；先完成业务鉴权、参数校验和幂等设计，返回值仍需自行脱敏。
+`ctx.Admin.*` 是自定义服务显式选择的单次系统内部授权：该次 RPC 按 `*:*:all` 全权限执行，可跨用户/空间，不检查调用者或服务主体 AccessGrant；服务主体仅保留用于 ownership 与审计。每次调用都会进入审计，内部授权不会泄漏到后续普通调用。服务代码仍拿不到服务凭据、数据库连接或管理员凭据。公开 Route 不应无条件调用 Admin；先完成业务鉴权、参数校验和幂等设计，返回值仍需自行脱敏。
 
 ### Event
 
@@ -126,7 +126,7 @@ response, err := ctx.HTTP.Get(ctx.Context(), "https://api.example.com/health", n
 | 场景 | 方法 |
 |---|---|
 | 当前调用者操作服务归属内账务 | `ctx.Billing.*` |
-| 可信服务执行需要管理员权限的账务管理 | `ctx.Admin.Billing.*`；目标仍由服务端资源归属决定 |
+| 自定义服务执行系统级账务管理 | `ctx.Admin.Billing.*`；单次调用按系统全权限执行并审计 |
 | 金额已确定且应立即扣除 | `DebitAccount` |
 | 最终金额不确定或业务可能失败 | `HoldFunds` -> `SettleHold`；失败时 `ReleaseHold` |
 | 更正已入账流水 | `ReverseJournal`，不要用反向充值伪造冲正 |
@@ -179,7 +179,7 @@ typed helper 未覆盖的新端点可使用 `ctx.AIHub.Request`，但 path 只
 - Role 不带作用域；服务必须通过覆盖持久化 ResourceOwnership 的有效 AccessGrant 授权。工作区成员关系不能单独授权。
 - platform Grant 可跨空间但只能使用显式权限；space Grant 不能跨根。请求中的范围不能覆盖服务已保存的归属。
 - 普通服务调用访问动态 DB 时仍受目标 DB 的 DataRange（`none` / `own` / `all`）限制；`ctx.Admin.*` 只应用于源码明确选择的单次可信管理操作，不能从请求参数隐式开启。
-- Route 仍受服务 `permission` 与 `config.route_security` 控制。
+- Route 不接受服务级 `permission`；入口由宿主认证、服务 ownership 和调用者 `scripts:execute` AccessGrant 控制，业务级公开/登录规则在 handler 内显式实现。
 - 定时任务和无可解析用户的事件默认使用服务主体及其持久化空间；需要平台级或跨归属管理时必须在对应单次调用显式使用 `ctx.Admin.*`。
 - 服务 principal 由平台运行时注入；不要在 `service.json`、源码、测试参数或日志中保存/模拟服务身份凭据。Route/Event 取调用者与服务 Grant 的权限交集，Scheduled 使用服务持久化 ownership，而不是假造用户 API Key。
 - `config.timeout`、`max_concurrency`、`queue_timeout_ms` 控制执行；Route 饱和返回 429。

package/resources/skill/references/modules.md

@@ -88,7 +88,7 @@ AI 新建或扩展受保护模块时，按以下最小闭环逐项确认；缺
 - `Event`：响应平台事件，如 `db.created` / `db.updated` / `user.registered`；用 `app.On(event, handler)` 注册，可为同一事件注册多个 handler。
 - `Scheduled`：用 `app.Schedule("分 时 日 月 周", handler)` 注册 cron；同一服务可声明多个定时 handler。
 - 新 Go 服务的 `Register` 是唯一触发器事实来源；旧 `triggers` 字段不参与注册。
-- 管理面由角色 RBAC 的 `scripts:*` 动作控制；Route 调用面继续由每个服务的 `permission` / `route_security` 独立控制，不要把两层权限混为一谈。
+- 管理面由角色 RBAC 的 `scripts:*` 动作控制；Route 不再读取服务级 `permission`，由宿主认证、持久化 ownership 和 `scripts:execute` AccessGrant 统一控制。
 - Go 服务在独立子进程中构建/运行；只有可信角色才能获得 `scripts:create` / `scripts:update`。
 - 自定义服务适合服务端加工、鉴权后聚合、第三方回调、定时任务和事件响应；普通 CRUD 管理界面优先用“页面 + 动态 DB”，不要把所有业务后台都塞进 route 脚本。
 - 脚本内读动态 DB 用 `ctx.DB.Query(type, sdk.QueryOptions{...})`；返回 `sdk.QueryResult`，分页和筛选见 `references/custom-services.md`。

package/src/mcp/protocol.js

@@ -44,6 +44,24 @@ function jsonRpcMessages(value) {
   return value && typeof value === 'object' ? [value] : [];
 }
 
+function routingHeaders(message) {
+  const messages = jsonRpcMessages(message);
+  if (messages.length !== 1 || typeof messages[0].method !== 'string' || !messages[0].method) return {};
+  const request = messages[0];
+  const headers = { 'Mcp-Method': request.method };
+  const params = request.params && typeof request.params === 'object' && !Array.isArray(request.params)
+    ? request.params
+    : {};
+  if (request.method === 'tools/call' && typeof params.name === 'string' && params.name) {
+    headers['Mcp-Name'] = params.name;
+  } else if (request.method === 'prompts/get' && typeof params.name === 'string' && params.name) {
+    headers['Mcp-Name'] = params.name;
+  } else if (request.method === 'resources/read' && typeof params.uri === 'string' && params.uri) {
+    headers['Mcp-Name'] = params.uri;
+  }
+  return headers;
+}
+
 async function parseEventStream(body, onMessage) {
   if (!body) return [];
   const reader = body.getReader();
@@ -113,6 +131,7 @@ async function postJsonRpc(config, message, options = {}) {
     Accept: 'application/json, text/event-stream',
     'Content-Type': 'application/json',
     'MCP-Protocol-Version': options.protocolVersion || DEFAULT_PROTOCOL_VERSION,
+    ...routingHeaders(message),
   };
   if (options.sessionId) headers['Mcp-Session-Id'] = options.sessionId;
 
@@ -169,6 +188,7 @@ module.exports = {
   McpHttpError,
   redactText,
   endpointFor,
+  routingHeaders,
   postJsonRpc,
   parseEventStream,
 };