@coda-console/protocol 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 按 semver。协议自己的大版本写在协议名里（如 `coda/run@1`），与 npm 包版本、插件清单的 v2 独立；更早的版本见 git 历史。
 
+## 3.1.0 — 2026-11-08
+
+- 流程种类 `prebuild`（预编）：开发流程推出执行者的提交后，在审查的同时调用一次、不等它的结果，为随后验收要装的客户端先编好；任何提交都能跑，不算部署类。设置选项的 `workflowKind` 也接受它。
+
 ## 3.0.0 — 2026-11-05
 
 不兼容变更：

package/README.md

@@ -80,7 +80,7 @@ fieldsProblem(JSON.parse(fieldsJSON), 'ask');
 
 ## 项目中的多选选项
 
-设置的 `items.anyOf` 选项可附带 `workflowKind`（`check`、`premerge`、`deploy`、`preview`、`release`）。全局设置显示全部选项；项目设置只显示该项目有的流程类别，未写此字段的选项始终显示。宿主负责按项目提供可选项，流程执行时仍需按运行的提交判断可用操作。
+设置的 `items.anyOf` 选项可附带 `workflowKind`（`check`、`premerge`、`prebuild`、`deploy`、`preview`、`release`）。全局设置显示全部选项；项目设置只显示该项目有的流程类别，未写此字段的选项始终显示。宿主负责按项目提供可选项，流程执行时仍需按运行的提交判断可用操作。
 
 ## 输入框模式
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coda-console/protocol",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Coda 的协议：插件清单的类型（JSON Schema）、通用校验器、协议定义与调用信封、流程方言与 Agent 接入协议",
   "type": "module",
   "license": "MIT",

package/schemas/plugin/setting.json

@@ -168,7 +168,7 @@
               "const": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"},
               "title": {"type": "string", "maxLength": 400},
               "description": {"type": "string", "maxLength": 400},
-              "workflowKind": {"description": "在项目设置里只在该项目有这一类流程时显示；全局设置列出全部选项", "enum": ["check", "premerge", "deploy", "preview", "release"]}
+              "workflowKind": {"description": "在项目设置里只在该项目有这一类流程时显示；全局设置列出全部选项", "enum": ["check", "premerge", "prebuild", "deploy", "preview", "release"]}
             },
             "required": ["const"],
             "additionalProperties": false

package/workflow/dialect.json

@@ -5,7 +5,8 @@
     "preview": "发布预览版客户端；只跑合并进默认分支的提交",
     "release": "发布正式版客户端；只跑合并进默认分支的提交",
     "check": "检查一个提交，PR 的流程在评审前调用；任何提交都能跑",
-    "premerge": "合并前检查：批准合并后，在要合并的提交上只跑一次；任何提交都能跑"
+    "premerge": "合并前检查：批准合并后，在要合并的提交上只跑一次；任何提交都能跑",
+    "prebuild": "预编：开发流程推出执行者的提交后，在审查的同时调用一次、不等它的结果，为随后验收要装的客户端先编好；任何提交都能跑"
   },
   "deploying": ["deploy", "preview", "release"],
   "events": {

package/workflow/values.json

@@ -10,7 +10,7 @@
         "concurrency": {"type": "string", "minLength": 1, "maxLength": 200, "description": "coda:concurrency 须为 1–200 个字符"},
         "key": {"type": "string", "pattern": "\\S", "maxLength": 4000, "x-feel": {"names": ["inputs", "github", "vars"]}, "description": "coda:key 须为 1–4000 个字符"},
         "title": {"type": "string", "pattern": "\\S", "maxLength": 200, "x-feel": true, "description": "coda:title 须为 1–200 个字符"},
-        "kind": {"enum": ["deploy", "preview", "release", "check", "premerge"], "description": "coda:kind 只能是 deploy、preview、release、check、premerge"},
+        "kind": {"enum": ["deploy", "preview", "release", "check", "premerge", "prebuild"], "description": "coda:kind 只能是 deploy、preview、release、check、premerge、prebuild"},
         "agents": {"type": "string", "pattern": "^[\\s,]*[a-z][a-z0-9-]{0,39}(?:[\\s,]+[a-z][a-z0-9-]{0,39})*[\\s,]*$",
           "description": "coda:agents 写 Agent 的 ID，用逗号或空格分隔（小写字母、数字和「-」，以字母开头，至多 40 个字符），不能为空"}
       }