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-CREATE-001.md CHANGED Viewed

@@ -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/app/docs/errors/CAGE-DECL-001.md CHANGED Viewed

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

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

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

package/templates/app/docs/errors/CAGE-DECL-003.md CHANGED Viewed

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-DEP-003.md CHANGED Viewed

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

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

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

package/templates/app/docs/errors/CAGE-DEP-005.md CHANGED Viewed

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

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

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-ENV-003.md CHANGED Viewed

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

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

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-FIELD-003.md CHANGED Viewed

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

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

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-GEN-003.md CHANGED Viewed

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

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

@@ -1,6 +1,6 @@
-# CAGE-GRANT-001：授予超出自己的能力或额度
+# CAGE-GRANT-001：授予超出自己的能力或参数
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
@@ -8,16 +8,16 @@
 阶段：组织命令。
-管理员授予自己没有的能力/更高参数，或分配含越权能力的角色。
+管理员授予自己没有的能力/更高数值参数、分配含越权能力的角色，或尝试维护受保护的超级管理员角色与账号。
 ## 修复步骤
-1. 由具备足够能力和参数的管理员操作；降低授予范围到自身权限内，不禁用防提权约束。
+1. 由具备足够能力和参数的管理员操作；超级管理员角色和账号由超级管理员维护。目标用户的角色不可见时需先取得角色读取能力和全部范围，不禁用防提权约束。
 ## 正例
 ```text
-有 approve=100000 额度的管理员授予不超过自身的额度
+自己有采购审批能力时，给普通角色授予该能力
 ```
 ## 反例
@@ -34,16 +34,22 @@
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
-- `packages/admin/src/domain/constraints.ts:39`
-- `packages/admin/src/domain/constraints.ts:42`
-- `packages/admin/src/domain/constraints.ts:78`
+- `packages/admin/src/domain/constraints.ts:38`
+- `packages/admin/src/domain/constraints.ts:40`
+- `packages/admin/src/domain/constraints.ts:55`
+- `packages/admin/src/domain/constraints.ts:61`
+- `packages/admin/src/domain/constraints.ts:67`
+- `packages/admin/src/domain/constraints.ts:69`
+- `packages/admin/src/domain/constraints.ts:85`
+- `packages/admin/src/domain/constraints.ts:88`
+- `packages/admin/src/domain/constraints.ts:124`
 实现片段（位置随框架版本更新）：
 ```ts
-    const mine = ctx.capabilities.get(input.capability);
-    if (!mine) return violation('[CAGE-GRANT-001] 不能授出自己没有的能力点');
-    for (const [k, v] of Object.entries(input.params ?? {})) {
-      if (typeof v === 'number' && typeof mine[k] === 'number' && v > (mine[k] as number)) {
-        return violation(`[CAGE-GRANT-001] 参数 ${k}=${v} 超过了你自己的 ${mine[k]}`);
+    if (!role.capabilities?.some((entry: { capability: string }) => entry.capability === '*') || ctx.actor?.kind === 'system') return ok();
+    if (!ctx.capabilities.has('*')) return violation('[CAGE-GRANT-001] 只有超级管理员可以维护超级管理员角色');
+    if (meta.capability === 'Role.archive' || (meta.capability === 'Role.revokeCapability' && input.capability === '*'))
+      return violation('[CAGE-GRANT-001] 不能停用超级管理员角色或移除全部能力标记');
+    return ok();
 ```

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

@@ -1,6 +1,6 @@
 # CAGE-GRANT-002：授予超出自己的数据范围
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
@@ -34,8 +34,8 @@
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
-- `packages/admin/src/domain/constraints.ts:59`
-- `packages/admin/src/domain/constraints.ts:82`
+- `packages/admin/src/domain/constraints.ts:105`
+- `packages/admin/src/domain/constraints.ts:128`
 实现片段（位置随框架版本更新）：

package/templates/app/docs/errors/CAGE-GRANT-003.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # CAGE-GRANT-003：能力不在代码目录中
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
@@ -8,11 +8,11 @@
 阶段：组织命令。
-授权请求引用了注册表没有声明的能力点。
+授权请求引用了注册表没有声明的能力点，或普通授权操作使用了初始化专用的全部能力标记。
 ## 修复步骤
-1. 先在 domain 声明并导出相应命令/聚合，再查看能力目录；不要在管理页面凭空发明能力名称。
+1. 先在 domain 声明并导出相应命令/聚合，再查看能力目录；不要在管理页面凭空发明能力名称。全部能力标记仅由首次初始化写入。
 ## 正例
@@ -35,7 +35,7 @@ PurchaseOrder.anything // 没有对应声明
 以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
 - `packages/admin/src/domain/constraints.ts:21`
-- `packages/admin/src/domain/constraints.ts:26`
+- `packages/admin/src/domain/constraints.ts:27`
 实现片段（位置随框架版本更新）：

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

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-INIT-003.md CHANGED Viewed

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

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

@@ -1,6 +1,6 @@
 # CAGE-INIT-004：账号已创建但 .env 替换失败
-[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
 > 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。

package/templates/app/docs/errors/CAGE-INIT-005.md CHANGED Viewed

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

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

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

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

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

package/templates/app/docs/errors/CAGE-JOB-003.md CHANGED Viewed

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

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

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

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

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

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

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

package/templates/app/docs/errors/CAGE-MIG-005.md CHANGED Viewed

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

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

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

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

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

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

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

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

@@ -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-ONTOLOGY-001.md ADDED Viewed

@@ -0,0 +1,52 @@
+# CAGE-ONTOLOGY-001：本体节点缺少结构化业务名称
+[返回错误码册](README.md) · [业务排错](../development/tools/troubleshooting.md)
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+## 何时出现
+阶段：check / gen / verify / 图谱与上下文诊断。
+当前项目可定位的聚合、字段、状态、命令、事件、查询或任务没有非空业务名称，图谱只能回退机器标识。默认警告，graph.naming 为 required 时作为门禁错误。
+## 修复步骤
+1. 按 reason 的完整节点 key 定位声明。字段和状态的位置指向所属聚合，继续在其中查找成员；无本地源码位置的依赖节点不在本检查范围。
+2. 对象、命令、查询和任务填写 description；事件在第三个参数填写 description；字段用 .describe(...) 或关系选项 description；每个状态都在 states 的 labels 中命名。旧声明可用 graph.labels 的完整 key 覆盖显示。
+3. 普通注释与前端 statusLabel 不会自动进入本体。名称用用户的业务用语，不为翻译改表名、状态值或能力点；详见 docs/development/guides/ontology-modeling.md。
+4. 补齐后重跑 check 并查看 graph/context；完整性不验证语言、名称质量或任意业务关系，仍按已明确规则验证外键方向、基数、状态迁移及真实触发链。
+## 正例
+```text
+states('active', 'archived', { terminal: ['archived'], labels: { active: '使用中', archived: '已归档' } })
+```
+## 反例
+```text
+states('active', 'archived', { terminal: ['archived'] }) // 只在页面或注释中翻译状态，没有结构化名称
+```
+## 修复后验证
+重跑 cage check，再在 graph/context 中按业务用语核对名称；对象关系与运行行为仍需独立业务用例验证。
+## 框架内的检查位置
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+- `packages/cli/src/ontology-names.ts:27`
+- `packages/cli/src/ontology-names.ts:42`
+- `packages/cli/src/sync.ts:42`
+实现片段（位置随框架版本更新）：
+```ts
+ * @param presentation 与图谱同一次抽取产生的名称，配置短标题优先于声明文案。
+ * @returns 每个缺名节点一条 CAGE-ONTOLOGY-001；不推断语言、不从注释或前端反推业务名称。
+ */
+export function checkOntologyNames(cfg: CageConfig, graph: Ontology, presentation: GraphPresentation): Finding[] {
+  const aggregates = new Map(graph.nodes.filter(node => node.kind === 'aggregate').map(node => [node.id, node]));
+```

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

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

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

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