@yss123/cage-cli 0.3.0 → 0.3.2

package/templates/blank/docs/errors/CAGE-APPR-001.md

@@ -1,6 +1,6 @@
-# CAGE-APPR-001：可路由字段不存在
+# CAGE-APPR-001：审批字段声明无效
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -8,11 +8,12 @@
 
 阶段：声明、图规则或 worker。
 
-approval.routable 引用了所属聚合没有声明的字段。
+approval.routable 引用了不存在字段，或 approver.field 指向未声明、隐藏、未进入 routable 的字段。
 
 ## 修复步骤
 
-1. 先在聚合声明实际字段，再将需要给审批路由的字段放入 routable；不要把任意输入直接交给流程。
+1. 先在聚合声明实际字段，再将需要给审批路由的非隐藏字段放入 routable；不要把任意输入直接交给流程。
+2. 字段选人值应为 UUID 或非空 UUID 数组，见 docs/development/guides/approvals.md；字段公开并不自动授予审批能力。
 
 ## 正例
 
@@ -34,15 +35,17 @@ routable: ['managerName'] // 聚合没有该字段
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/approval/src/route.ts:159`
+- `packages/approval/src/route.ts:215`
+- `packages/approval/src/route.ts:220`
+- `packages/approval/src/route.ts:229`
 - `packages/kernel/src/primitives/flow.ts:245`
 
 实现片段（位置随框架版本更新）：
 
 ```ts
-        for (const field of s.context.fields) if (!binding.agg.fields[field] || binding.agg.fields[field].isHidden)
-          throw declError('CAGE-APPR-001', `AI 上下文字段 ${field} 不存在或不可公开`);
-        for (const query of s.context.queries ?? []) if (!registry.queries.some(q => q.name === query))
-          throw declError('CAGE-REG-001', `AI 步骤引用的查询 ${query} 未导出`);
-      }
+      if (reminders && (!routeBinding?.routable.includes(reminders.requesterField) || !routeBinding.agg.fields[reminders.requesterField] || routeBinding.agg.fields[reminders.requesterField].isHidden))
+        throw declError('CAGE-APPR-001', `申请人字段 ${reminders.requesterField} 必须存在、可公开且进入 routable`);
+      for (const node of declaredSteps) {
+        const selector = node.kind === 'ai' ? node.handoff : node.approver;
+        // 新字段选择器必须能从 routable 快照取值；不追溯改变历史部门选人的声明校验行为。
 ```

package/templates/blank/docs/errors/CAGE-APPR-002.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-002：审批结论落到其他聚合
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-APPR-003.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-003：审批结论未允许流程调用
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-APPR-004.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-004：路由没有对应审批绑定
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-APPR-005.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-005：流程名称格式错误
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -34,14 +34,14 @@ route('采购审批', nodes)
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/approval/src/route.ts:126`
+- `packages/approval/src/route.ts:176`
 
 实现片段（位置随框架版本更新）：
 
 ```ts
-export function route(process: string, nodes: RouteNode[]): Route {
+export function route(process: string, nodes: RouteNode[], options: { reminders?: ApprovalReminderPolicy } = {}): Route {
   if (!/^[a-z][a-z0-9-]*$/.test(process)) throw declError('CAGE-APPR-005', `流程名 ${process} 必须是小写短横线`);
   if (nodes.length === 0) throw declError('CAGE-APPR-006', `流程 ${process} 至少需要一个步骤`);
-  const fields = new Set<string>();
-  for (const n of nodes) {
+  const inspection = inspectRoute(nodes);
+  const fields = new Set<string>(inspection.fields);
 ```

package/templates/blank/docs/errors/CAGE-APPR-006.md

@@ -1,6 +1,6 @@
-# CAGE-APPR-006：流程没有步骤
+# CAGE-APPR-006：审批步骤配置无效
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -8,11 +8,13 @@
 
 阶段：声明、图规则或 worker。
 
-route 接收了空步骤数组。
+route 没有步骤、展开后为空，或人工 actions/assignment、候选池与 all 组合、AI 步骤必填配置或预算不合法。
 
 ## 修复步骤
 
 1. 声明至少一个实际审批步骤，并检查条件后能否形成预期流程。
+2. candidate 只支持 any；逐人会签用默认 direct。actions 只接受 transfer/delegate/addSign 布尔值。
+3. AI 步骤需模型、要求、上下文字段、接管规则及正整数预算，并绑定 AI 运行时、退回命令和自动角色。
 
 ## 正例
 
@@ -35,12 +37,25 @@ route('po-approval', [])
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
 - `packages/approval/src/bridge.ts:16`
-- `packages/approval/src/engine.ts:70`
-- `packages/approval/src/route.ts:66`
-- `packages/approval/src/route.ts:68`
-- `packages/approval/src/route.ts:127`
-- `packages/approval/src/route.ts:154`
-- `packages/approval/src/route.ts:156`
+- `packages/approval/src/deadlines.ts:34`
+- `packages/approval/src/deadlines.ts:41`
+- `packages/approval/src/engine.ts:75`
+- `packages/approval/src/execution.ts:40`
+- `packages/approval/src/execution.ts:42`
+- `packages/approval/src/execution.ts:47`
+- `packages/approval/src/execution.ts:49`
+- `packages/approval/src/execution.ts:54`
+- `packages/approval/src/execution.ts:55`
+- `packages/approval/src/execution.ts:88`
+- `packages/approval/src/operations.ts:375`
+- `packages/approval/src/route.ts:109`
+- `packages/approval/src/route.ts:111`
+- `packages/approval/src/route.ts:115`
+- `packages/approval/src/route.ts:117`
+- `packages/approval/src/route.ts:177`
+- `packages/approval/src/route.ts:213`
+- `packages/approval/src/route.ts:224`
+- `packages/approval/src/route.ts:226`
 
 实现片段（位置随框架版本更新）：
 
@@ -49,5 +64,5 @@ route('po-approval', [])
   if (!cmd) throw new Error('[CAGE-APPR-006] 审批未绑定退回修改命令');
   let ctx: Ctx;
   if (r.lastApprover) {
-    const user = await k.contextFor(r.lastApprover, r.tenantId);
+    // 待办决定已持有事务连接时复用它；同实例并发排队不能耗尽池后让锁持有者再等新连接。
 ```

package/templates/blank/docs/errors/CAGE-APPR-007.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-007：找不到审批人
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -8,14 +8,15 @@
 
 阶段：声明、图规则或 worker。
 
-worker 启动或推进审批步骤时，选人器没有找到人。
+worker 启动或推进审批步骤时选人器没有找到人，或字段选人/候选节点中存在非当前租户启用账号。
 
 ## 修复步骤
 
 1. 先看本项目 approvals.ts：deptLeader 读取单据部门的负责人；role 使用角色 code；user 使用实际用户 UUID。
 2. 在 /admin 设置单据所属部门的负责人，或创建对应 code 的角色并分配实际用户。给用户经理角色，并不等于设置了部门负责人。
-3. 再核对审批人的结论能力、数据范围、ceiling 额度和职责分离。选中审批人不等于允许完成审批。
-4. 若 OrderSubmitted 已入死信，修复后在 /admin 按 outboxId 重放，确认待办生成；原提交已成功时不重复提交或 SQL 改回草稿。
+3. field 使用提交时保存的 routable 人员字段；检查 UUID 对应账号是否全部在当前租户且 active。不能删掉不合格人员后默认为审批通过；字段快照错误需按业务撤回/重提修正。
+4. 再核对审批人的结论能力、数据范围、ceiling 额度和职责分离。选中审批人不等于允许完成审批。
+5. 若 OrderSubmitted 已入死信，修复后在 /admin 按 outboxId 重放，确认待办生成；原提交已成功时不重复提交或 SQL 改回草稿。
 
 ## 正例
 
@@ -37,7 +38,8 @@ deptLeader('deptId')：给该部门设置负责人；role('finance')：给实际
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/approval/src/engine.ts:81`
+- `packages/approval/src/engine.ts:87`
+- `packages/approval/src/engine.ts:94`
 
 实现片段（位置随框架版本更新）：
 
@@ -45,6 +47,6 @@ deptLeader('deptId')：给该部门设置负责人；role('finance')：给实际
     if (who.length === 0) {
       throw new Error(`[CAGE-APPR-007] 流程 ${this.route.process} 第 ${index + 1} 步「${title}」找不到审批人，请在 /admin 配置部门负责人或角色`);
     }
-    for (const assignee of new Set(who)) {
-      await tx.insertInto('flow.approval_task').values({ instance_id: instanceId, tenant_id: tenantId, step: index, title, assignee }).execute();
+    if (selector.kind === 'field' || assignment === 'candidate') {
+      // 新字段/候选声明不允许创建指向停用或其他租户账号的票；整批拒绝，不静默减少会签人数。
 ```

package/templates/blank/docs/errors/CAGE-APPR-010.md

@@ -1,6 +1,6 @@
 # CAGE-APPR-010：流程专用命令没有调用者
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-AUDIT-001.md

@@ -1,6 +1,6 @@
 # CAGE-AUDIT-001：可靠读取审计失败
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-AUTH-001.md

@@ -1,6 +1,6 @@
 # CAGE-AUTH-001：OIDC 发现文档获取失败
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-BIZ-001.md

@@ -1,6 +1,6 @@
 # CAGE-BIZ-001：业务流程声明无效
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-BIZ-002.md

@@ -1,6 +1,6 @@
 # CAGE-BIZ-002：业务流程与真实声明不一致
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-BUDGET-001.md

@@ -1,6 +1,6 @@
 # CAGE-BUDGET-001：内核超出体积预算
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-BUDGET-002.md

@@ -1,6 +1,6 @@
 # CAGE-BUDGET-002：公共原语超过词汇预算
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-BUDGET-003.md

@@ -1,6 +1,6 @@
 # CAGE-BUDGET-003：新增未经基线认可的 unsafe
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CMD-002.md

@@ -1,6 +1,6 @@
 # CAGE-CMD-002：已有记录命令缺少 id
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CMD-003.md

@@ -1,6 +1,6 @@
 # CAGE-CMD-003：新建命令没有目标状态
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-001.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-001：连接器名称格式错误
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-002.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-002：外部操作路径格式错误
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-003.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-003：地址白名单包含协议或路径
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-004.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-004：只读操作被用作出站写映射
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-005.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-005：入站事件名称格式错误
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-006.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-006：回调命令未允许 external
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-007.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-007：当前环境没有连接器地址
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-008.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-008：外部请求发生网络错误或超时
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-009.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-009：外部服务返回非成功状态
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-010.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-010：外部响应不符合 schema
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-011.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-011：出站永久失败进入死信
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-012.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-012：外部专用命令没有声明调用者
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-013.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-013：出站幂等键无效或请求冲突
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-014.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-014：不可重试外部写入结果未知
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CONN-015.md

@@ -1,6 +1,6 @@
 # CAGE-CONN-015：连接器超时或限流参数无效
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-CREATE-001.md

@@ -1,6 +1,6 @@
 # CAGE-CREATE-001：项目创建参数或模板资源有误
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -29,7 +29,7 @@ cage create . 覆盖当前已有业务项目
 
 ## 修复后验证
 
-向一个新目录创建，检查 AGENTS.md、业务源码、docs/ai 和 docs/errors，然后按 README 安装/构建。
+向一个新目录创建，检查 AGENTS.md、业务源码、docs/development 和 docs/errors，然后按 README 安装/构建。
 
 ## 框架内的检查位置
 

package/templates/blank/docs/errors/CAGE-DECL-001.md

@@ -1,6 +1,6 @@
 # CAGE-DECL-001：声明不在可抽取的顶层常量
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DECL-002.md

@@ -1,6 +1,6 @@
 # CAGE-DECL-002：声明没有从 domain 入口导出
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DECL-003.md

@@ -1,6 +1,6 @@
 # CAGE-DECL-003：声明不是 export const
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DECL-004.md

@@ -1,6 +1,6 @@
 # CAGE-DECL-004：跨文件导出名冲突
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DEP-001.md

@@ -1,6 +1,6 @@
 # CAGE-DEP-001：领域声明直接依赖 IO
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DEP-002.md

@@ -1,6 +1,6 @@
 # CAGE-DEP-002：适配器绕过命令写库
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DEP-003.md

@@ -1,6 +1,6 @@
 # CAGE-DEP-003：前端依赖服务端实现
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DEP-004.md

@@ -1,6 +1,6 @@
 # CAGE-DEP-004：声明或 handler 直接发请求/动态导入
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DEP-005.md

@@ -1,6 +1,6 @@
 # CAGE-DEP-005：domain 反向依赖生成物
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DIAG-001.md

@@ -1,6 +1,6 @@
 # CAGE-DIAG-001：运行诊断输入或连接失败
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-DLQ-001.md

@@ -1,6 +1,6 @@
 # CAGE-DLQ-001：死信不存在或已经处理
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-ENV-001.md

@@ -1,6 +1,6 @@
 # CAGE-ENV-001：缺少数据库连接配置
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-ENV-002.md

@@ -1,6 +1,6 @@
 # CAGE-ENV-002：运行配置不满足安全边界
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-ENV-003.md

@@ -1,6 +1,6 @@
 # CAGE-ENV-003：服务启动不能隐式初始化组织
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/blank/docs/errors/CAGE-EVENT-001.md

@@ -1,6 +1,6 @@
 # CAGE-EVENT-001：事件载荷不满足声明
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -34,7 +34,7 @@ emit(OrderCancelled, (o, _i, prev) => ({ orderId: o.id, previousStatus: prev.sta
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/kernel/src/kernel.ts:456`
+- `packages/kernel/src/kernel.ts:461`
 
 实现片段（位置随框架版本更新）：
 

package/templates/blank/docs/errors/CAGE-EVENT-002.md

@@ -1,6 +1,6 @@
 # CAGE-EVENT-002：事件变更不向后兼容
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。