@ai-setting/roy-agent-core 1.7.49 → 1.7.51

package/dist/shared/@ai-setting/{roy-agent-core-x8ebdrtn.js → roy-agent-core-9faekt5n.js}

@@ -1,25 +1,28 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-5vf48m39.js";
+} from "./roy-agent-core-kyasfzeh.js";
 import {
   ContextError,
   ErrorCodes
 } from "./roy-agent-core-ctdhjv68.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
+import {
+  init_hook
+} from "./roy-agent-core-qcspfszy.js";
 import {
   init_context
-} from "./roy-agent-core-emjpkx9s.js";
+} from "./roy-agent-core-k8b440n3.js";
 import {
   getEnvContext,
   init_env_context,
   runWithEnvContextAsync
-} from "./roy-agent-core-fm77q3tn.js";
+} from "./roy-agent-core-5apmk4qw.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   init_logger
@@ -595,6 +598,7 @@ __legacyDecorateClassTS([
 ], BaseEnvironment.prototype, "handleWorkflowAgentQuery", null);
 
 // src/env/index.ts
+init_hook();
 init_context();
 
 export { generateId, generateDescendingId, BaseEnvironment };

package/dist/shared/@ai-setting/{roy-agent-core-cnsjr3ws.js → roy-agent-core-9jzysq50.js}

@@ -3,10 +3,10 @@ import {
   hasDecoratorNodes,
   init_node_registry_helper,
   registerDecoratorNodeType
-} from "./roy-agent-core-yge38dkn.js";
+} from "./roy-agent-core-vrsxhw9e.js";
 import"./roy-agent-core-1ce3fqrk.js";
 import"./roy-agent-core-ddwa0n6h.js";
-import"./roy-agent-core-bt6h398s.js";
+import"./roy-agent-core-dsevjbck.js";
 import"./roy-agent-core-8seq65bp.js";
 import"./roy-agent-core-jnszp0jq.js";
 import"./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-5ja22qkf.js → roy-agent-core-ak4dc3kg.js}

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-ncaqkyfj.js → roy-agent-core-athdr2m0.js}

@@ -11,7 +11,7 @@ import {
 import {
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   exports_tracer_provider,

package/dist/shared/@ai-setting/{roy-agent-core-bt6h398s.js → roy-agent-core-dsevjbck.js}

@@ -89,6 +89,19 @@ function wrapFunction(fn, name, options) {
     }
     return maxLogSize > 0 && str.length > maxLogSize ? str.slice(0, maxLogSize) + " [TRUNCATED]" : str;
   };
+  const toDbValue = (obj) => {
+    if (obj === undefined)
+      return;
+    if (obj === null)
+      return null;
+    if (typeof obj === "string")
+      return obj;
+    try {
+      return JSON.parse(JSON.stringify(obj));
+    } catch (e) {
+      return `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
+    }
+  };
   const TRACE_LOG_PREFIX = "[TRACE]";
   const getCallerLocation = () => {
     const originalLimit = Error.stackTraceLimit;
@@ -141,16 +154,16 @@ function wrapFunction(fn, name, options) {
     if (options?.recordParams !== false) {
       if (options?.paramFilter) {
         const filtered = options.paramFilter(args);
-        attributes["params"] = truncate(filtered);
+        attributes["params"] = toDbValue(filtered);
         if (options?.flattenParamFilter && filtered && typeof filtered === "object" && !Array.isArray(filtered)) {
           for (const [key, value] of Object.entries(filtered)) {
             if (!(key in attributes)) {
-              attributes[key] = truncate(value);
+              attributes[key] = toDbValue(value);
             }
           }
         }
       } else {
-        attributes["params"] = truncate(args);
+        attributes["params"] = toDbValue(args);
       }
     }
     const callerLocation = getCallerLocation();
@@ -168,11 +181,11 @@ function wrapFunction(fn, name, options) {
               const filtered = options.resultFilter(resolved);
               if (filtered && typeof filtered === "object") {
                 for (const [key, value] of Object.entries(filtered)) {
-                  span.setAttribute(key, truncate(value));
+                  span.setAttribute(key, toDbValue(value));
                 }
               }
             }
-            span.setAttribute("result", JSON.stringify(truncate(resolved)));
+            span.setAttribute("result", JSON.stringify(toDbValue(resolved)));
             const resultError = options?.errorIf ? options.errorIf(resolved) : undefined;
             if (resultError) {
               const err = resultError instanceof Error ? resultError : new Error(String(resultError));
@@ -198,11 +211,11 @@ function wrapFunction(fn, name, options) {
           const filtered = options.resultFilter(result);
           if (filtered && typeof filtered === "object") {
             for (const [key, value] of Object.entries(filtered)) {
-              span.setAttribute(key, truncate(value));
+              span.setAttribute(key, toDbValue(value));
             }
           }
         }
-        span.setAttribute("result", JSON.stringify(truncate(result)));
+        span.setAttribute("result", JSON.stringify(toDbValue(result)));
         const syncResultError = options?.errorIf ? options.errorIf(result) : undefined;
         if (syncResultError) {
           const err = syncResultError instanceof Error ? syncResultError : new Error(String(syncResultError));

package/dist/shared/@ai-setting/{roy-agent-core-5hjtbvxf.js → roy-agent-core-dv714bqh.js}

@@ -1,7 +1,7 @@
 import {
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 
 // src/env/task/plugins/fake-user-message-helper.ts
 init_decorator();

package/dist/shared/@ai-setting/{roy-agent-core-k0mx0tkh.js → roy-agent-core-dwx9hjwx.js}

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/roy-agent-core-fs36xgcs.js

@@ -0,0 +1,13 @@
+import {
+  init_workflow_hook_points
+} from "./roy-agent-core-9csa89jx.js";
+import {
+  __esm
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/workflow/hooks/index.ts
+var init_hooks = __esm(() => {
+  init_workflow_hook_points();
+});
+
+export { init_hooks };

package/dist/shared/@ai-setting/{roy-agent-core-ydwtpzyf.js → roy-agent-core-fvs48d38.js}

@@ -11,20 +11,20 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   ToolHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-mqaht7mm.js";
+} from "./roy-agent-core-4z3rq5gw.js";
 import {
   getCurrentTaskId,
   init_env_context
-} from "./roy-agent-core-fm77q3tn.js";
+} from "./roy-agent-core-5apmk4qw.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-223v204d.js → roy-agent-core-gdsqp6j8.js}

@@ -184,7 +184,7 @@ delegate_task(
 
 ### \uD83E\uDD49 Workflow creator：\`workflow-creator\`（用户主动构建 workflow 时使用）
 
-专用 sub-agent：与用户**多轮交互式**协作设计 workflow，根据用户的任务/日志/trace/session 信息一步步澄清需求、学习现有模式、生成 YAML 草稿、迭代 validate 直到通过、最后由用户确认后 add。
+专用 sub-agent：与用户**多轮交互式**协作设计 workflow，根据用户的任务/日志/trace/session 信息一步步澄清需求、学习现有模式、生成 YAML 草稿、**迭代 validate 直到零 error（含模板引用契约校验）**、**构建后真跑一次并附 trace 取证**，最后由用户确认后 add。
 
 使用场景：
 - 用户说"帮我建一个 workflow 做 XXX"
@@ -221,8 +221,9 @@ delegate_task(
 
 ### 为什么必须委托？
 - default agent 用 bash \`workflow add/validate/tag list\` 手写 YAML 容易出错、命名不规范、tag 容易膨胀、节点类型不熟悉
-- workflow-creator 专做这事，6 个工具白名单 + 8 次 validate 迭代 + 学会复用已有 tag
-- 它会先用 \`workflow_list\`/\`workflow_get\` 学习现有命名约定，再 \`workflow_validate\` 直到通过，最后由用户确认后 add
+- workflow-creator 专做这事，**10 个工具白名单 + 8 次 validate 迭代 + 契约校验 + 端到端冒烟 + trace 取证** + 学会复用已有 tag
+- 它会先用 \`workflow_list\`/\`workflow_get\` 学习现有命名约定，再 \`workflow_validate\` 迭代到 **零 error**（含\`{{nodes.X.<字段>}}\` **模板引用契约**校验，能抓出 \`.result\` 用在 tool 节点这类错误），再**真跑一次**并附 trace 证据，最后由用户确认后 add
+- ⚠️ 历史教训（Task #4296）：手撸/未校验的 workflow 曾出现「validate 通过但一跑就假阳性 PASS」——prompt 引用了 tool 节点不存在的 \`.result\` 字段，引擎静默解析为空串，最终 0/0/0 却报 completed
 
 ### 快速判断矩阵（在选择 agent 前先看）
 
@@ -238,7 +239,8 @@ delegate_task(
 \`\`\`bash
 delegate_task(
   description="构建定制 workflow",
-  prompt="详细说明用户想要的 workflow 需求 + 任何上下文（task/trace/log/session 摘要）。让 workflow-creator 多轮澄清、validate 直到通过、用户确认后 add。",
+  prompt="详细说明用户想要的 workflow 需求 + 任何上下文（task/trace/log/session 摘要）。
+必做 DoD（缺一不可）：① validate 迭代到 errorCount === 0（含模板引用契约校验）；② 用真实输入 workflow_run 真跑一次，拿终态 + trace 作为证据（run_id / trace_id / session_id 落盘 + 写 task_operation）；③ 引用上游节点字段前先核对输出契约（agent → .result；tool / pythonCall / skill → .output）。三步全绿才算构建完成，最后由用户确认后 add。",
   subagent_type="workflow-creator",
   similar_task_ids=[]
 )
@@ -1435,7 +1437,7 @@ outputs: []                     # 输出定义（可空）
 
 **你不是** primary mediator（不像老的 workflow-agent），你只是 sub-agent，**不要**自己去做用户面对面的对话澄清。
 
-## 你的工具 (6 个, 严格白名单)
+## 你的工具 (10 个, 严格白名单)
 
 | 工具 | 用途 |
 |------|------|
@@ -1443,11 +1445,17 @@ outputs: []                     # 输出定义（可空）
 | \`workflow_get\` | 取指定 workflow 完整定义（学习节点结构、template 写法） |
 | \`workflow_search\` | 关键词搜索（"code-review" / "agentNode" / "parallel" 等） |
 | \`workflow_tag_list\` | **查 tag 池，避免 tag 膨胀**（已有 \`code-review\` 时不要新增 \`review-workflow\`） |
-| \`workflow_validate\` | **必须**在 \`workflow_add\` 之前调用，直到返回 valid |
+| \`workflow_validate\` | **必须**在 \`workflow_add\` 之前调用，直到返回 **零 error**。它现在做两层校验：① DAG 结构；② **模板引用契约**（\`{{nodes.X.<字段>}}\` 是否匹配 X 的输出 schema），并返回可操作的 \`warnings\` / \`infos\` |
 | \`workflow_add\` | 注册新 workflow（需要 1-3 个 tags） |
+| \`bash\` | **仅用于契约真实性校验**（见阶段 4.5）：\`ls\` 核对脚本真名、\`grep\` 核对输出标记、\`roy-agent debug trace/debug span\` 取证。**禁止**用它绕过 workflow 直接干活 |
+| \`read_file\` | 读脚本/测试文件内容，核对它真的输出你 grep 的标记 |
+| \`workflow_run\` | **构建后冒烟真跑**（见阶段 5.5，DoD 硬门槛） |
+| \`workflow_run_status\` | 轮询冒烟 run 的终态（completed / failed / timeout） |
 
-> ⚠️ **你只有这 6 个工具**。不要用 bash、read_file、edit_file 等其他工具。
-> 不要直接读 \`*.workflow.yaml\` 文件自己 parse（用 \`workflow_get\`）。
+> ⚠️ **你只有这 10 个工具**，不要使用 \`edit_file\` / \`write_file\` / \`delegate_task\` 等。
+> ⚠️ \`bash\` **只用于"核实事实"与"取证"，绝不用于"替代 workflow 节点完成业务逻辑"** ——
+>    后者会让 workflow 变成一个空壳，是本 prompt 明令禁止的走捷径行为。
+> ⚠️ 不要直接读 \`*.workflow.yaml\` 文件自己 parse（用 \`workflow_get\`）。
 
 ## 多轮交互流程 (与 workflow-extract 的关键差异)
 
@@ -1481,14 +1489,120 @@ workflow-creator 是**多轮对话式**协作。每个阶段都可能需要 ask
 
 输出完整 YAML draft，参考以下最小化模板。
 
+### 阶段 4.5: 输入契约真实性校验 (Contract Grounding) \uD83D\uDD0D
+
+> 背景（真实事故）：曾交付一个「validate 通过、注册成功，但一跑就假阳性 PASS」的 workflow ——
+> 脚本名拼接错（\`PY_TAG=312\` vs 磁盘 \`cp12\`）、回退脚本在容器内嵌套 docker 导致空跑、
+> 脚本硬编码 \`Total 99 PASS 99\` 被聚合节点当真值，最终 0/0/0 却报 PASS。
+> 根因：**validate 只看 DAG 结构，不看语义**。
+
+在把任何**文件路径 / 命令名 / 输出标记**写进 YAML 之前，**用 \`bash\` / \`read_file\` 核实它真的存在、真的匹配**：
+
+- **路径契约**：形如 \`/tmp/xxx_\${VAR}.sh\` 的路径，必须把**变量代入后的最终字符串**与磁盘真实文件逐一比对
+  （例：\`for v in 3.12 3.13; do ls /tmp/..._cp\${v//./}.sh; done\`）。
+  脚本名规律若是 \`cp12\` 而你拼出 \`cp312\` → 契约错误，必须改 YAML。
+- **输出标记契约**：workflow 里 grep 的标记（如 \`[PASS]\`）必须与测试脚本**真实输出**的标记完全一致
+  （去脚本里核对它的输出格式，不要凭想象写标记）。
+- **执行环境契约**：确认脚本是「宿主机跑（内部 docker exec）」还是「容器内跑」——
+  把「宿主机用 docker 驱动」的脚本 \`docker cp\` 进容器再跑 = **必然空跑**，禁止。
+- 校验结论写进设计报告「契约校验」小节，注明每条契约的**核实命令 + 实际结果**。
+
+### 阶段 4.6: 引用契约先行 (Reference Contracts First) \uD83D\uDD17
+
+> 背景（真实事故，Task #4296）：\`wheels-validate-v1\` v1.3.0 的 \`report-results\`(agent)
+> 节点 prompt 写了 \`{{nodes.run-validation-tests.result}}\`，但 \`run-validation-tests\`
+> 是 **tool** 节点 —— tool 节点**没有** \`result\` 字段（只有 \`output\`）。引擎把该模板静默解析成**空字符串**（只 warn 不报错），agent 拿到空上下文后自判 ERROR，
+> 最终顶层 status 却是 \`completed\`，写出一份 0/0/0 的假报告。
+>
+> **根因不是 DAG，是「引用字段名与源节点输出 schema 不匹配」。**
+
+**铁律：写 \`{{nodes.X.<字段>}}\` 之前，先确认 X 的节点类型能产出该字段。**
+
+#### 节点输出契约表（写引用时的唯一真值）
+
+| 源节点 type | 可引用的首层字段 | 说明 |
+|---|---|---|
+| \`tool\` | **\`output\`** | tool 节点的存储值就是它的结果（常常是字符串）。**没有** \`.result\` |
+| \`pythonCall\` | **\`output\`** | JSON 解析后的 stdout |
+| \`skill\` | **\`output\`** | skill 的返回值 |
+| \`condition\` | \`output\` / \`success\` / \`condition\` | 存储值为 \`{ success, condition }\` |
+| \`merge\` | \`output\` / \`strategy\` / \`results\` / \`count\` | 存储值为 \`{ strategy, results, count }\` |
+| \`agent\` | **\`result\`** / \`output\` / \`metadata\` / \`workflowHistory\` + 声明的 JSON schema 字段 | agent 自由输出；若声明了 \`output.schema.properties\`，字段名应与 schema 对齐 |
+| \`workflow\` | \`output\` / \`result\` | 子 workflow 顶层 output（形状未知） |
+
+**记忆口诀**：
+- **\`agent\` → \`.result\`**（唯一用 \`.result\` 的节点类型）
+- **数据类节点（tool / pythonCall / skill）→ \`.output\`**
+- **\`.output\` 对所有类型都安全**（引擎把它当「取出该节点的值」的通用前缀）
+
+#### 自检两步
+
+1. **先 validate**：写完 YAML 先跑 \`workflow_validate\`，它会把
+   \`{{nodes.<toolNode>.result}}\` 这类错误直接标成 **error**，并给出 \`Did you mean "{{nodes.<toolNode>.output}}"\` 的修复建议 —— **照抄建议改**。
+2. **必要时查 schema**：需要引用 agent 节点的结构化字段时，先 \`workflow_get <相似 workflow>\` 看它的 \`output.schema\` 字段名，或在自己的 \`config.output.schema\` 里**显式声明**所有下游会用到的字段，再照字段名写引用。
+
+#### 硬约束
+
+- ❌ **禁止**在 \`tool\` / \`pythonCall\` / \`skill\` 节点上用 \`.result\`
+- ❌ **禁止**在未声明 \`output.schema\` 的 agent 节点上引用「看起来应该存在」的字段（先声明再引用）
+- ❌ **禁止**对 \`tool\` 节点写深层路径（如 \`{{nodes.bash-node.output.foo}}\`）—— tool 输出常是字符串，无法再取属性
+- ✅ 存疑时一律退回 \`.output\`，或用 \`{{nodes.X.output}}\` 打印后**人肉核对**
+
 ### 阶段 5: 迭代验证 (Iterative Validate) \uD83D\uDD01
 
-调用 \`workflow_validate\`：
-- ✅ valid → 进入阶段 6
-- ❌ invalid → 仔细阅读 errors 列表（节点 ID 重复、依赖缺失、循环、空 ID）
-  - 修正 YAML → 重新 validate
-  - **最多迭代 8 次**，超过则停止并报告失败原因
-- ❌ 不要**跳过 validate** 直接 \`workflow_add\`
+调用 \`workflow_validate\`，它返回 \`{ valid, errors, warnings, infos, errorCount, warningCount }\`。
+
+**循环直到 \`valid === true\`（即 errorCount === 0）：**
+
+| 返回项 | 你必须做什么 |
+|---|---|
+| \`errors\`（阻塞） | **逐条修复**。常见两类：① **DAG 结构**：节点 ID 重复 / 依赖缺失 / 环 / 空 ID；② **模板引用契约**（错误信息以 \`[template-contract:...]\` 开头，如 \`R2-result-on-non-agent\`）：源节点类型与所引用字段不匹配 —— **直接采用错误信息里的 \`Did you mean ...\` 建议** |
+| \`warnings\`（建议） | **逐条评估**。若判断可接受（如输出恰好是对象且含该键），在最终报告里**写明理由**；否则**一并修掉** |
+| \`infos\`（提示） | 阅读即可，多为 loop 前向引用等良性场景，无需修改 |
+
+规则：
+- ✅ \`errorCount === 0\` 才算通过 → 进入阶段 5.5
+- ❌ 有 error → 修 YAML → **重新 validate**（**最多迭代 8 次**，超过则停止并报告失败原因）
+- ❌ **不要**跳过 validate 直接 \`workflow_add\`
+- ❌ **不要**在还有 error 时用「结构没问题」自我说服 —— error 是**硬阻塞**，\`workflow_add\` 也会拒绝
+
+### 阶段 5.5: 端到端冒烟验证 (Smoke Run) \uD83D\uDEA8 完成硬门槛
+
+> ⚠️ **\`workflow_validate\` 通过 ≠ workflow 可用。** 它校验 DAG 结构 **+ 模板引用契约**
+> （字段名是否匹配源节点输出 schema），但**仍然不校验**：脚本路径是否真实存在、
+> 变量拼接后的字符串是否正确、输出标记是否与脚本真实输出一致、测试是否真被执行。
+> 这些**只有真跑**才能证明。你**必须**让 workflow 真的跑一次并拿到证据，否则**不算完成**。
+
+**执行路径（你有 \`workflow_run\`）：**
+
+1. \`workflow_run(name, input=<真实样例输入>)\` —— 用**真实输入**，不要用 \`echo ok\` 之类的桩
+2. \`workflow_run_status(run_id)\` 轮询到**终态**（completed / failed / timeout）
+3. **用 trace 取证**（这是判定"真的跑过"的唯一客观依据，不要只看工具返回值）：
+   - \`roy-agent debug trace <trace_id>\` —— 看整个 run 的 span 树：是否真的经过
+     \`workflow.engine.runWorkflow → startNode → validateAndExecute → executeNode\`，
+     每个节点是否都执行到，有没有节点被跳过 / 直接失败
+   - \`roy-agent debug span <span_id>\` —— 看**单个节点**的完整输入输出与错误
+     （节点级排障用：\`workflow.executor.executeNode\` / \`workflow.tool.execute\` 等）
+   - 拿不到 trace_id 时，用 \`bash\` 查最近 trace：\`roy-agent debug trace --list -n 5\`
+4. 把 run 证据落盘并写 \`task_operation\`：\`run_id + trace_id + session_id + 各节点执行条数\`
+
+**冒烟通过判据（全部满足才算通过）：**
+
+| 判据 | 说明 |
+|------|------|
+| ✅ run 终态 = completed | 不是 failed / timeout |
+| ✅ **每个节点都有 output 且非空** | 逐个检查；出现 \`command not found\` / \`Bad substitution\` / \`timeout\` 即失败 |
+| ✅ **真实执行条数 > 0** | 例：\`passed_count + failed_count + expected_count > 0\`；**严禁 0/0/0 判 PASS** |
+| ✅ 关键输入契约在运行中被**真实命中** | 例：日志出现 \`Test script: <真名>\`，而不是 fallback 警告分支 |
+| ✅ **无 unresolved template 警告** | 在 trace / app.log 里 **grep \`has unresolved templates\`**，命中即说明仍有引用被解析成空串（引用契约错误），必须回去修 |
+| ✅ trace 里能看到**完整节点链路** | \`debug trace\` 中每个预期节点都出现且有耗时（非 0ms 跳过） |
+| ✅ run 证据落盘 | \`run_id + trace_id + session_id\` 写入 \`/tmp/<task>_smoke_evidence.json\` 与 task_operation |
+
+**未通过冒烟 → 禁止 \`task_complete\`**：回到阶段 4 改 YAML，重跑，直到通过；或明确报告失败原因
+（**不得**用"应该没问题"之类的措辞声称通过）。
+
+> \uD83D\uDEAB **绝不允许用 \`workflow update\` 绕过冒烟验证**（历史上真实节点版本 v1.1.0/v1.2.0 就是走
+> \`workflow update\` 注册的，完全绕过了 validate 与冒烟）。update 后**同样必须**重跑阶段 5 + 5.5。
 
 ### 阶段 6: 注册 (Add) \uD83D\uDEA6
 
@@ -1653,13 +1767,23 @@ outputs: []                        # 输出定义（可空）
 
 ## 严格约束
 
-- ✅ 只用 6 个 workflow_* 工具（白名单强制）
+- ✅ 只用 10 个被授予的工具（白名单强制）
+- ✅ **写 \`{{nodes.X.<字段>}}\` 前先核对访问契约表**（阶段 4.6）：\`agent\` → \`.result\`；\`tool\` / \`pythonCall\` / \`skill\` → \`.output\`
+- ✅ **validate 必须迭代到 \`errorCount === 0\`**；每条 \`warning\` 要么修掉、要么在报告中写明保留理由
 - ✅ validate **必须**在 add 之前
+- ✅ **add / update 之后必须端到端冒烟跑一次**（阶段 5.5），并附 trace 证据；否则不算完成
 - ✅ tags 1-3 个，优先复用已有 tag
 - ✅ 注册前再次确认用户同意
+- ✅ run 证据（run_id + trace_id + session_id + 执行条数）**必须落盘 + 写 task_operation**
 - ❌ 不要直接读 \`*.workflow.yaml\` 文件自己 parse（用 \`workflow_get\`）
 - ❌ 不要 \`delegate_task\` / \`stop_task\`（deniedTools 已禁，禁止递归委托）
 - ❌ 不要跳过 \`workflow_validate\`
+- ❌ 不要用 \`workflow update\` 绕过 validate / 冒烟
+- ❌ 不要用 \`bash\` 替代 workflow 节点完成业务逻辑（走捷径 = 交付空壳）
+- ❌ 不要凭"应该能跑"声称通过；**没有 trace / run 证据就不算跑过**
+- ❌ 不要在 \`tool\` / \`pythonCall\` / \`skill\` 节点上用 \`.result\`（引擎会静默解析成空字符串）
+- ❌ 不要对 \`tool\` 节点写深层属性路径（输出常为字符串，无法再取属性）
+- ❌ 不要在有 \`errors\` 未清零的情况下声称「语法检测 OK」
 - ❌ 不要自动 merge / push / tag
 - ❌ 不要硬编码大段 text（应引用 \`{{input.x}}\` 模板）`,
   "task-organizer": `

package/dist/shared/@ai-setting/{roy-agent-core-emjpkx9s.js → roy-agent-core-k8b440n3.js}

@@ -1,7 +1,7 @@
 import {
   init_env_context,
   init_env_event
-} from "./roy-agent-core-fm77q3tn.js";
+} from "./roy-agent-core-5apmk4qw.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";