@yss123/cage-cli 0.3.0 → 0.3.2

package/templates/app/docs/errors/CAGE-NAME-002.md

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

package/templates/app/docs/errors/CAGE-NAME-003.md

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

package/templates/app/docs/errors/CAGE-NAME-004.md

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

package/templates/app/docs/errors/CAGE-NAME-005.md

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

package/templates/app/docs/errors/CAGE-NAME-006.md

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

package/templates/app/docs/errors/CAGE-ORG-001.md

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

package/templates/app/docs/errors/CAGE-PAIR-002.md

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

package/templates/app/docs/errors/CAGE-QUERY-001.md

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

package/templates/app/docs/errors/CAGE-QUERY-002.md

@@ -1,6 +1,6 @@
 # CAGE-QUERY-002：自定义查询直接访问基表
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/app/docs/errors/CAGE-QUERY-003.md

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

package/templates/app/docs/errors/CAGE-REACT-001.md

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

package/templates/app/docs/errors/CAGE-REACT-002.md

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

package/templates/app/docs/errors/CAGE-REACT-003.md

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

package/templates/app/docs/errors/CAGE-READS-001.md

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

package/templates/app/docs/errors/CAGE-REG-001.md

@@ -1,6 +1,6 @@
 # CAGE-REG-001：注册表缺少被引用声明
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -34,7 +34,7 @@ export * from './inventory.js'; export * from './purchase-order.js';
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/approval/src/route.ts:161`
+- `packages/approval/src/route.ts:231`
 - `packages/kernel/src/kernel.ts:161`
 - `packages/kernel/src/registry.ts:209`
 - `packages/kernel/src/registry.ts:215`

package/templates/app/docs/errors/CAGE-REG-002.md

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

package/templates/app/docs/errors/CAGE-REG-003.md

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

package/templates/app/docs/errors/CAGE-REL-001.md

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

package/templates/app/docs/errors/CAGE-ROUTE-001.md

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

package/templates/app/docs/errors/CAGE-SCOPE-001.md

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

package/templates/app/docs/errors/CAGE-SCOPE-002.md

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

package/templates/app/docs/errors/CAGE-SECRET-001.md

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

package/templates/app/docs/errors/CAGE-SECRET-002.md

@@ -1,6 +1,6 @@
 # CAGE-SECRET-002：源码疑似包含密钥字面量
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/app/docs/errors/CAGE-SENS-001.md

@@ -1,6 +1,6 @@
 # CAGE-SENS-001：敏感字段未标注就进入事件
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/app/docs/errors/CAGE-SQL-001.md

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

package/templates/app/docs/errors/CAGE-SQL-002.md

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

package/templates/app/docs/errors/CAGE-STATE-001.md

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

package/templates/app/docs/errors/CAGE-STATE-002.md

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

package/templates/app/docs/errors/CAGE-STATE-003.md

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

package/templates/app/docs/errors/CAGE-STATE-004.md

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

package/templates/app/docs/errors/CAGE-STATE-005.md

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

package/templates/app/docs/errors/CAGE-STATE-010.md

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

package/templates/app/docs/errors/CAGE-STATE-011.md

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

package/templates/app/docs/errors/CAGE-STRUCT-001.md

@@ -1,6 +1,6 @@
 # CAGE-STRUCT-001：业务源码目录不符合模块约定
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -14,7 +14,7 @@
 
 1. 前端使用 app / modules / shared，src 根目录只保留 main.tsx；领域使用 modules / workflows / integrations / shared，根目录只保留 index.ts。
 2. 把页面、表单、hooks 和业务辅助代码放在同一业务模块，需要时再拆文件；不要创建空目录凑层级。测试就近放置，类型声明 .d.ts 不受入口约束。
-3. 目录调整后修正导入并运行 cage check、gen、verify；完整规范见 docs/ai/project-structure.md。
+3. 目录调整后修正导入并运行 cage check、gen、verify；完整规范见 docs/development/reference/project-structure.md。
 
 ## 正例
 
@@ -32,7 +32,7 @@ packages/domain/src/expense.ts
 
 ## 修复后验证
 
-按 docs/ai/project-structure.md 整理归属和导入后重跑 cage check 与 verify；不关闭目录规则，也不改业务表或能力标识。
+按 docs/development/reference/project-structure.md 整理归属和导入后重跑 cage check 与 verify；不关闭目录规则，也不改业务表或能力标识。
 
 ## 框架内的检查位置
 
@@ -47,5 +47,5 @@ packages/domain/src/expense.ts
           code: 'CAGE-STRUCT-001',
           at,
           reason: `${kind} 源码没有放入约定模块：${from.path}`,
-          fix: `src 根目录只保留${kind === 'domain' ? '领域 index.ts' : '浏览器 main.tsx'}；业务按归属放入 ${layers.join(' / ')}，见 docs/ai/project-structure.md`,
+          fix: `src 根目录只保留${kind === 'domain' ? '领域 index.ts' : '浏览器 main.tsx'}；业务按归属放入 ${layers.join(' / ')}，见 docs/development/reference/project-structure.md`,
 ```

package/templates/app/docs/errors/CAGE-STRUCT-002.md

@@ -1,6 +1,6 @@
 # CAGE-STRUCT-002：源码依赖越过模块边界
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -32,7 +32,7 @@ import { ExpensePage } from '../../modules/expense/pages/expense-page';
 
 ## 修复后验证
 
-按 docs/ai/project-structure.md 整理归属和导入后重跑 cage check 与 verify；不关闭目录规则，也不改业务表或能力标识。
+按 docs/development/reference/project-structure.md 整理归属和导入后重跑 cage check 与 verify；不关闭目录规则，也不改业务表或能力标识。
 
 ## 框架内的检查位置
 
@@ -47,5 +47,5 @@ import { ExpensePage } from '../../modules/expense/pages/expense-page';
             code: 'CAGE-STRUCT-002',
             at: `${at}:${source.slice(0, spec.pos).split('\n').length}`,
             reason: `${reason}（${spec.fileName}）`,
-            fix: '调整依赖归属；共用纯逻辑下沉到 shared，页面协作由 app 传参，领域交互通过模块公开声明。见 docs/ai/project-structure.md',
+            fix: '调整依赖归属；共用纯逻辑下沉到 shared，页面协作由 app 传参，领域交互通过模块公开声明。见 docs/development/reference/project-structure.md',
 ```

package/templates/app/docs/errors/CAGE-SYNC-001.md

@@ -1,6 +1,6 @@
 # CAGE-SYNC-001：AGENTS 托管区过期或标记损坏
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 
@@ -34,9 +34,9 @@ sync --check 发现框架规则需更新，或 begin/end 标记缺失一边、
 
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 
-- `packages/cli/src/sync.ts:149`
-- `packages/cli/src/sync.ts:156`
-- `packages/cli/src/sync.ts:167`
+- `packages/cli/src/sync.ts:66`
+- `packages/cli/src/sync.ts:73`
+- `packages/cli/src/sync.ts:84`
 
 实现片段（位置随框架版本更新）：
 

package/templates/app/docs/errors/CAGE-TEST-001.md

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

package/templates/app/docs/errors/CAGE-TEST-002.md

@@ -1,6 +1,6 @@
 # CAGE-TEST-002：派生测试准备或初始夹具失败
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/app/docs/errors/CAGE-TEST-003.md

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

package/templates/app/docs/errors/CAGE-UNSAFE-001.md

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

package/templates/app/docs/errors/CAGE-UPGRADE-001.md

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

package/templates/app/docs/errors/CAGE-WORKER-001.md

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

package/templates/app/docs/errors/CAGE-WORKER-002.md

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

package/templates/app/docs/errors/CAGE-WORKER-003.md

@@ -1,6 +1,6 @@
 # CAGE-WORKER-003：后台任务未在停机时限内结束
 
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
 

package/templates/app/docs/errors/README.md

@@ -3,7 +3,7 @@
 这是本业务项目自带的离线诊断手册。先使用错误码、声明位置、reason/fix 定位；不需要克隆框架仓库。
 
 - [HTTP 运行时错误与业务码](runtime.md)：401/403/404、状态冲突、约束拒绝、DOMAIN_ERROR 等。
-- [业务排错顺序](../ai/troubleshooting.md)：启动、权限、审批人、worker、死信与导入导出。
+- [业务排错顺序](../development/tools/troubleshooting.md)：启动、权限、审批人、worker、死信与导入导出。
 - CAGE-* 是声明、工具链或内部运行诊断；HTTP code 与业务 domainCode 是另一层，不要混为一谈。
 
 每页包含触发阶段、具体原因、修复步骤、正反例、验证方法与当前版实现位置。例子为局部说明，不能替代完整业务输入。
@@ -44,12 +44,12 @@
 
 | 诊断码 | 含义 |
 | --- | --- |
-| [CAGE-APPR-001](CAGE-APPR-001.md) | 可路由字段不存在 |
+| [CAGE-APPR-001](CAGE-APPR-001.md) | 审批字段声明无效 |
 | [CAGE-APPR-002](CAGE-APPR-002.md) | 审批结论落到其他聚合 |
 | [CAGE-APPR-003](CAGE-APPR-003.md) | 审批结论未允许流程调用 |
 | [CAGE-APPR-004](CAGE-APPR-004.md) | 路由没有对应审批绑定 |
 | [CAGE-APPR-005](CAGE-APPR-005.md) | 流程名称格式错误 |
-| [CAGE-APPR-006](CAGE-APPR-006.md) | 流程没有步骤 |
+| [CAGE-APPR-006](CAGE-APPR-006.md) | 审批步骤配置无效 |
 | [CAGE-APPR-007](CAGE-APPR-007.md) | 找不到审批人 |
 | [CAGE-APPR-010](CAGE-APPR-010.md) | 流程专用命令没有调用者 |
 

package/templates/app/docs/errors/runtime.md

@@ -1,6 +1,6 @@
 # HTTP 运行时错误与业务码
 
-[返回错误码册](README.md) · [排错方法](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [排错方法](../development/tools/troubleshooting.md)
 
 框架诊断分三层：`CAGE-APPR-007` 等内部/工具码、HTTP 响应的通用 `code`、业务拒绝的 `domainCode`。同一次失败可以同时涉及几层；例如审批人配置问题出现在 worker 死信，前端提交此前可能已成功。
 

package/templates/app/package.json

@@ -11,9 +11,9 @@
     "build:app": "pnpm --filter @app/domain build && pnpm --filter @app/api build && pnpm --filter @app/web build"
   },
   "devDependencies": {
-    "@yss123/cage-cli": "0.3.0",
-    "@yss123/cage-testkit": "0.3.0",
-    "@yss123/cage-lint": "0.3.0",
+    "@yss123/cage-cli": "0.3.2",
+    "@yss123/cage-testkit": "0.3.2",
+    "@yss123/cage-lint": "0.3.2",
     "@types/node": "^24.3.0",
     "typescript": "~5.9.3",
     "vitest": "^4.1.12",

package/templates/app/packages/contracts/package.json

@@ -10,7 +10,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@yss123/cage-client": "0.3.0",
+    "@yss123/cage-client": "0.3.2",
     "zod": "^4.1.5"
   }
 }

package/templates/app/packages/contracts/src/aggregates/approval-member/index.ts

@@ -0,0 +1,70 @@
+// 生成物：由 cage gen 从 domain 声明生成，不要手改。
+/* eslint-disable */
+
+import { z } from 'zod';
+import { client, useCageList, useCageQuery, type TransferTask, type RequestOptions } from '@yss123/cage-client';
+
+/** 采购审批协作名录：读侧快照（敏感字段是按权限掩码后的值） */
+export const ApprovalMemberSchema = z.object({
+  id: z.string().uuid(),
+  userId: z.string().uuid(),
+  displayName: z.string(),
+  specialty: z.string(),
+  status: z.enum(["active", "retired"]),
+  version: z.number().int(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+export type ApprovalMember = z.infer<typeof ApprovalMemberSchema>;
+export type ApprovalMemberStatus = ApprovalMember['status'];
+export const ApprovalMemberStates = ['active', 'retired'] as const;
+
+/** 命令输入：和后端命令的输入校验完全一致 */
+export const ApprovalMemberInputs = {
+  create: z.object({ userId: z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")), displayName: z.unknown(), specialty: z.unknown() }),
+  retire: z.object({ id: z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")) }),
+  update: z.object({ id: z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")), displayName: z.unknown(), specialty: z.unknown() }),
+};
+
+/** ApprovalMember.create 可能返回的错误码 */
+export type ApprovalMemberCreateError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT';
+/** ApprovalMember.retire 可能返回的错误码 */
+export type ApprovalMemberRetireError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+/** ApprovalMember.update 可能返回的错误码 */
+export type ApprovalMemberUpdateError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+
+export type ApprovalMemberSortKey = 'createdAt' | 'updatedAt' | 'userId' | 'displayName' | 'specialty';
+export interface ApprovalMemberListParams {
+  page?: number;
+  pageSize?: number;
+  /** 排序：字段名，前面加 - 表示倒序 */
+  sort?: ApprovalMemberSortKey | `-${ApprovalMemberSortKey}`;
+  /** 可以逗号分隔多个状态 */
+  status?: string;
+  createdAfter?: string;
+  createdBefore?: string;
+  userId?: string | number | boolean;
+  displayName?: string | number | boolean;
+  specialty?: string | number | boolean;
+}
+
+/** 调用方法：每个命令一个；client 自动生成并附带幂等键和 CSRF 令牌 */
+export const approvalMember = {
+  /** 登记采购审批协作人 */
+  create: (input: z.input<typeof ApprovalMemberInputs.create>, options: RequestOptions = {}) => client.post<ApprovalMember, ApprovalMemberCreateError>('/api/approval-member/create', input, options),
+  /** 停用采购审批协作名录成员 */
+  retire: (id: string, expectedVersion?: number, options: RequestOptions = {}) => client.post<ApprovalMember, ApprovalMemberRetireError>(`/api/approval-member/${encodeURIComponent(id)}/retire`, { expectedVersion }, options),
+  /** 修改采购协作人的公开资料 */
+  update: (id: string, input: Omit<z.input<typeof ApprovalMemberInputs.update>, 'id'>, expectedVersion?: number, options: RequestOptions = {}) => client.post<ApprovalMember, ApprovalMemberUpdateError>(`/api/approval-member/${encodeURIComponent(id)}/update`, { ...input, expectedVersion }, options),
+  /** 异步导出 CSV：返回任务，使用 client.transfer(id) 查状态，完成后下载。需要 ApprovalMember.export 能力。 */
+  export: (params: ApprovalMemberListParams = {}, options: RequestOptions = {}) => client.post<TransferTask, 'CONFLICT'>('/api/approval-member/export', params, options),
+  get: (id: string, options: RequestOptions = {}) => client.get<ApprovalMember>(`/api/approval-member/${encodeURIComponent(id)}`, undefined, options),
+  list: (params: ApprovalMemberListParams = {}, options: RequestOptions = {}) => client.get<{ items: ApprovalMember[]; total: number; page: number; pageSize: number }>('/api/approval-member', params as Record<string, unknown>, options),
+};
+
+/** 详情查询 hook：响应也用 schema 校验；范围外返回 NOT_FOUND */
+export const useApprovalMember = (id: string) => useCageQuery(['approval-member', id], `/api/approval-member/${encodeURIComponent(id)}`, ApprovalMemberSchema, { enabled: !!id });
+/** 列表查询 hook：走读侧账号与安全视图 */
+export const useApprovalMemberList = (params: ApprovalMemberListParams = {}) => useCageList(['approval-member'], '/api/approval-member', params as Record<string, unknown>, ApprovalMemberSchema);
+/** 查询缓存键前缀：命令成功后让它失效 */
+export const approvalMemberKeys = { all: ['approval-member'] as const, one: (id: string) => ['approval-member', id] as const };