npm - @yss123/cage-cli - Versions diffs - 0.3.1 → 0.4.0 - Mend

@yss123/cage-cli 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (388) hide show

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,6 +1,6 @@
 # CAGE-STATE-003：状态名称格式错误
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
@@ -12,7 +12,7 @@
 ## 修复步骤
-1. 状态标识使用 pending_approval 等，中文名称通过页面/graph.labels 显示。
+1. 状态标识使用 pending_approval 等，业务名称在 states 的 labels 中填写，graph.labels 可覆盖显示；页面文案和普通注释不会自动进入本体。
 ## 正例

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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:73`
+- `packages/cli/src/sync.ts:80`
+- `packages/cli/src/sync.ts:91`
 实现片段（位置随框架版本更新）：

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -3,11 +3,17 @@
 这是本业务项目自带的离线诊断手册。先使用错误码、声明位置、reason/fix 定位；不需要克隆框架仓库。
 - [HTTP 运行时错误与业务码](runtime.md)：401/403/404、状态冲突、约束拒绝、DOMAIN_ERROR 等。
-- [业务排错顺序](../ai/troubleshooting.md)：启动、权限、审批人、worker、死信与导入导出。
+- [业务排错顺序](../development/tools/troubleshooting.md)：启动、权限、审批人、worker、死信与导入导出。
 - CAGE-* 是声明、工具链或内部运行诊断；HTTP code 与业务 domainCode 是另一层，不要混为一谈。
 每页包含触发阶段、具体原因、修复步骤、正反例、验证方法与当前版实现位置。例子为局部说明，不能替代完整业务输入。
+## 本体业务名称
+| 诊断码 | 含义 |
+| --- | --- |
+| [CAGE-ONTOLOGY-001](CAGE-ONTOLOGY-001.md) | 本体节点缺少结构化业务名称 |
 ## 智能运行时
 | 诊断码 | 含义 |
@@ -181,7 +187,7 @@
 | 诊断码 | 含义 |
 | --- | --- |
-| [CAGE-GRANT-001](CAGE-GRANT-001.md) | 授予超出自己的能力或额度 |
+| [CAGE-GRANT-001](CAGE-GRANT-001.md) | 授予超出自己的能力或参数 |
 | [CAGE-GRANT-002](CAGE-GRANT-002.md) | 授予超出自己的数据范围 |
 | [CAGE-GRANT-003](CAGE-GRANT-003.md) | 能力不在代码目录中 |

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

@@ -1,6 +1,6 @@
 # HTTP 运行时错误与业务码
-[返回错误码册](README.md) · [排错方法](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [排错方法](../development/tools/troubleshooting.md)
 框架诊断分三层：`CAGE-APPR-007` 等内部/工具码、HTTP 响应的通用 `code`、业务拒绝的 `domainCode`。同一次失败可以同时涉及几层；例如审批人配置问题出现在 worker 死信，前端提交此前可能已成功。
@@ -13,7 +13,7 @@
 | NOT_FOUND | 404 | 记录不存在或超出范围 | 用当前用户检查 id/租户/范围，不泄漏范围外数据 |
 | INVALID_INPUT | 400 | Zod/协议输入错误、外键或检查约束等 | 按输入 schema 修正字段和格式，不直接扩大 schema |
 | INVALID_TRANSITION | 409 | 当前状态不允许该命令 | 刷新记录，按真实生命周期显示允许操作 |
-| CONSTRAINT_VIOLATED | 403 | 职责分离、额度、二次认证、防提权等拒绝 | 看约束原因，调整业务操作或由有权管理员配置；不删除约束 |
+| CONSTRAINT_VIOLATED | 403 | 职责分离、二次认证、防提权等拒绝 | 看约束原因，调整业务操作或由有权管理员配置；不删除约束 |
 | INVARIANT_VIOLATED | 409 | 命令结果不满足聚合不变量 | 修正输入或 handler，保持合法结果 |
 | CONFLICT | 409 | 版本、唯一性、数据库串行化/死锁等冲突 | 看 detail、重新读取再决定是否重试；不要盲目重复创建 |
 | DOMAIN_ERROR | 422 | handler 返回 fail | 读取 domainCode，展示业务文案和必要 detail |

package/templates/app/package.json CHANGED Viewed

@@ -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.1",
-    "@yss123/cage-testkit": "0.3.1",
-    "@yss123/cage-lint": "0.3.1",
+    "@yss123/cage-cli": "0.4.0",
+    "@yss123/cage-testkit": "0.4.0",
+    "@yss123/cage-lint": "0.4.0",
     "@types/node": "^24.3.0",
     "typescript": "~5.9.3",
     "vitest": "^4.1.12",

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

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

package/templates/app/packages/contracts/src/aggregates/role/index.ts CHANGED Viewed

@@ -31,7 +31,7 @@ export const RoleInputs = {
 };
 /** Role.archive 可能返回的错误码 */
-export type RoleArchiveError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+export type RoleArchiveError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** Role.create 可能返回的错误码 */
 export type RoleCreateError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT';
 /** Role.grantCapability 可能返回的错误码 */
@@ -39,7 +39,7 @@ export type RoleGrantCapabilityError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOM
 /** Role.rename 可能返回的错误码 */
 export type RoleRenameError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** Role.revokeCapability 可能返回的错误码 */
-export type RoleRevokeCapabilityError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+export type RoleRevokeCapabilityError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** Role.setScope 可能返回的错误码 */
 export type RoleSetScopeError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';

package/templates/app/packages/contracts/src/aggregates/user/index.ts CHANGED Viewed

@@ -38,11 +38,11 @@ export type UserAssignRolesError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_
 /** User.create 可能返回的错误码 */
 export type UserCreateError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT';
 /** User.disable 可能返回的错误码 */
-export type UserDisableError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+export type UserDisableError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** User.enable 可能返回的错误码 */
-export type UserEnableError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+export type UserEnableError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** User.setPassword 可能返回的错误码 */
-export type UserSetPasswordError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
+export type UserSetPasswordError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
 /** User.update 可能返回的错误码 */
 export type UserUpdateError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';

package/templates/app/packages/domain/package.json CHANGED Viewed

@@ -14,11 +14,11 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@yss123/cage-kernel": "0.3.1",
-    "@yss123/cage-admin": "0.3.1",
-    "@yss123/cage-approval": "0.3.1",
-    "@yss123/cage-connectors": "0.3.1",
-    "@yss123/cage-ai": "0.3.1",
+    "@yss123/cage-kernel": "0.4.0",
+    "@yss123/cage-admin": "0.4.0",
+    "@yss123/cage-approval": "0.4.0",
+    "@yss123/cage-connectors": "0.4.0",
+    "@yss123/cage-ai": "0.4.0",
     "zod": "^4.1.5"
   }
 }

package/templates/app/packages/domain/src/modules/purchase/approval-members.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * 采购协作名录：由业务管理员登记可参与采购复核的账号、公开业务姓名和专业领域，供草稿选人及任务操作使用。
  * 聚合通过标准命令维护，浏览器读取 safe.approval_member；名录与 sys.user 的私密资料、角色授权分离。
- * 名录在同租户内向具 ApprovalMember.read 且显式获 all 范围的采购参与者公开；加入名录不授予审批权限、范围或额度。
+ * 名录在同租户内向具 ApprovalMember.read 且显式获 all 范围的采购参与者公开；加入名录不授予审批权限或范围。
  */
 import { aggregate, command, ref, scope, states, text } from '@yss123/cage-kernel';
 import { z } from 'zod';

package/templates/app/packages/domain/src/modules/purchase/approvals.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * 采购实际审批路由：AI 预审、部门审核、可选专业会签和大额财务候选受理，共用一个采购流程实例。
  * 人工节点显式开放转办、委派和前后/并行加签；步骤/政策随提交保存，旧实例保持自己的快照。
- * 路由只决定任务分配与签序，最终结论仍执行领域命令的职责分离、额度与库存约束。
+ * 路由只决定任务分配与签序，最终结论仍执行领域命令的职责分离与库存约束。
  */
 import { approval } from '@yss123/cage-kernel';
 import { approver, eq, gt, route, step, when } from '@yss123/cage-approval';
@@ -28,7 +28,7 @@ export const poApproval = approval(PurchaseOrder, {
  * needsSpecialistReview=true 才增加专业会签，名单来自提交快照且全部人必须通过；金额严格大于 50000 元才增加财务节点。
  * AI 只读取 reason/amount/items，pass 仅推进到经理，return 回到草稿，manual 在当前节点交部门负责人。
  * 模型失败同样转人工，最多四轮/五次工具调用/120 秒；不以失败兜底为自动批准。
- * 财务共享一项未分配任务，finance 当前成员须先领取；所有人工动作仍需真实命令能力、范围、额度和职责分离。
+ * 财务共享一项未分配任务，finance 当前成员须先领取；所有人工动作仍需真实命令能力、范围和职责分离。
  * AI 人工接管保持原节点规则；经理、专业和财务才开放三项管理动作，新实例自动保存允许的加签位置。
  */
 export const poRoute = route('po-approval', [

package/templates/app/packages/domain/src/modules/purchase/intelligence.test.ts CHANGED Viewed

@@ -25,7 +25,7 @@ beforeAll(async () => {
   env = await createTestEnv({ domain: { ...purchase, intelligence }, migrations: readMigrations(fileURLToPath(new URL('../../../../../db/migrations/', import.meta.url))) });
   buyer = await env.user({ caps: ['PurchaseOrder.read', 'PurchaseOrder.create', 'PurchaseOrder.explainPurpose', 'PurchaseOrder.submit', 'PurchaseOrder.setReviewers', 'ApprovalMember.read'],
     scopes: { ApprovalMember: 'all' } });
-  reviewer = await env.user({ caps: ['PurchaseOrder.read', 'PurchaseOrder.approve', 'PurchaseOrder.returnForChanges'], scopes: { PurchaseOrder: 'dept' }, params: { 'PurchaseOrder.approve': { ceiling: 50000 } } });
+  reviewer = await env.user({ caps: ['PurchaseOrder.read', 'PurchaseOrder.approve', 'PurchaseOrder.returnForChanges'], scopes: { PurchaseOrder: 'dept' } });
   await env.kernel.execute('Dept.update', { id: env.rootDeptId, leaderId: reviewer.id }, env.system());
   await env.kernel.execute('Inventory.create', { sku: 'AI-01', available: 100 }, env.system());
   const role = await env.kernel.execute('Role.create', { code: 'purchase_ai_reviewer', name: '材料预审角色' }, env.system());
@@ -39,12 +39,12 @@ beforeAll(async () => {
 afterAll(() => env?.close());
 /**
- * 通过组织和业务命令登记同部门协作人；10 万元额度只供本隔离库验证大额流程，名录本身不授予能力。
+ * 通过组织和业务命令登记同部门协作人；名录本身不授予能力。
  * 专业和财务共享这些真实审批能力，财务候选身份由额外的 finance 角色单独赋予。
  */
 async function collaborator(specialty: string) {
   const user = await env.user({ caps: ['PurchaseOrder.read', 'PurchaseOrder.approve', 'PurchaseOrder.reject', 'PurchaseOrder.returnForChanges'],
-    scopes: { PurchaseOrder: 'dept' }, params: { 'PurchaseOrder.approve': { ceiling: 100000 } } });
+    scopes: { PurchaseOrder: 'dept' } });
   await env.kernel.execute('ApprovalMember.create', { userId: user.id, displayName: specialty, specialty }, env.system());
   return user;
 }
@@ -145,7 +145,7 @@ it('经理后开启所选专业人员 all 会签，全部通过才批准并锁
   expect((await env.query('select status from core.inventory_lock where id=$1', [order.id]))[0].status).toBe('held');
 });
-/** gt 阈值必须保持严格大于；恰好 5 万元时经理的同额 ceiling 足够，不创建财务候选任务。 */
+/** gt 阈值必须保持严格大于；恰好 5 万元时不创建财务候选任务。 */
 it('恰好 50000 元经理通过后直接批准，不产生财务候选待办', async () => {
   decision = 'pass'; const order = await submit({ amount: '50000.00' });
   await approveBy(reviewer, order.id);