@yss123/cage-cli 0.1.0 → 0.3.0

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

@@ -0,0 +1,47 @@
+# CAGE-CONN-011：出站永久失败进入死信
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：声明、图规则或 worker。
+
+出站消费者将不可重试的 ConnectorError 包装为永久错误；真正原因是内层错误码。
+
+## 修复步骤
+
+1. 先按内层 CAGE-CONN-007/009/010 等修正配置/协议，再重放死信；检查远端是否已完成写入并复用业务幂等键。
+
+## 正例
+
+```text
+修复响应 schema，核对远端幂等结果，再重放指定 outboxId
+```
+
+## 反例
+
+```text
+只重启 worker，希望永久错误自动恢复或直接删 outbox
+```
+
+## 修复后验证
+
+先 cage check；涉及网络时检查同步记录、外部幂等结果与成功回写。fake 与真实联调分别报告。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/connectors/src/runtime.ts:283`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+          // 不可重试：标成永久错误，直接进死信
+          throw Object.assign(new Error(`[CAGE-CONN-011] ${e.message}`), { permanent: true });
+        }
+        throw e;
+      }
+```

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

@@ -0,0 +1,47 @@
+# CAGE-CONN-012：外部专用命令没有声明调用者
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：声明、图规则或 worker。
+
+external 专用命令没有 inbound 或 outbound.onSuccess 等图内调用者；当前图规则给出 warning。
+
+## 修复步骤
+
+1. 补真实回调/成功映射并从入口导出，或明确这是暂未接线的功能。warning 不代表外部链路已完成。
+
+## 正例
+
+```text
+recordErpNo 被 pushToErp.onSuccess.command 引用
+```
+
+## 反例
+
+```text
+定义 markReceived，却没有验签回调或其他外部调用入口
+```
+
+## 修复后验证
+
+先 cage check；涉及网络时检查同步记录、外部幂等结果与成功回写。fake 与真实联调分别报告。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/rules.ts:197`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+      findings.push({
+        code: 'CAGE-CONN-012',
+        at: at(c),
+        reason: `命令 ${c.id} 只接受外部调用，但没有入站回调或出站映射调用它`,
+        fix: '用 inbound(...) 或 outbound(..., { onSuccess }) 调用它',
+```

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

@@ -0,0 +1,49 @@
+# CAGE-CONN-013：出站幂等键无效或请求冲突
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：声明、图规则或 worker。
+
+幂等键不是非空字符串，或同租户、连接器、操作、幂等键已经对应另一份请求。
+
+## 修复步骤
+
+1. 使用同一业务操作的稳定声明键；重试保持键和请求内容不变。
+2. 新业务操作使用新键，不能覆盖已有执行记录。远端收到的键还包含租户隔离前缀。
+
+## 正例
+
+```text
+idempotencyKey: payload => payload.id // 同业务操作的稳定键
+```
+
+## 反例
+
+```text
+复用旧键发送不同金额，或每次重试生成随机键
+```
+
+## 修复后验证
+
+先 cage check；涉及网络时检查同步记录、外部幂等结果与成功回写。fake 与真实联调分别报告。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/connectors/src/runtime.ts:219`
+- `packages/connectors/src/runtime.ts:244`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+  const key = ob.idempotencyKey(row.payload as any);
+  if (!key || typeof key !== 'string') throw new ConnectorError('[CAGE-CONN-013] 出站幂等键必须为非空字符串', null, false);
+  const requestHash = createHash('sha256').update(canonical(body)).digest('hex');
+  const identity = { tenant_id: row.tenant_id, connector: ob.op.connector.name, operation: ob.op.name, idempotency_key: key };
+  const locate = (db: typeof k.app) => db.selectFrom('sys.connector_execution').selectAll()
+```

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

@@ -0,0 +1,48 @@
+# CAGE-CONN-014：不可重试外部写入结果未知
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：声明、图规则或 worker。
+
+不可安全重试的外部写入超时或中断，无法确认远端是否已经生效。
+
+## 修复步骤
+
+1. 先凭远端幂等键和同步记录人工核对结果，再选择连接器专用的受控恢复或业务补偿。当前没有通用回执确认或解除 unknown 的入口，普通死信重放不会解除。
+2. 需要自动恢复时先让远端提供可靠幂等协议，再使用 retryableWrite；不盲目重放未知结果写入。
+
+## 正例
+
+```text
+核对远端已生成凭证，再通过受控命令落实本地结果
+```
+
+## 反例
+
+```text
+超时等于远端没执行，直接再次扣款
+```
+
+## 修复后验证
+
+先 cage check；涉及网络时检查同步记录、外部幂等结果与成功回写。fake 与真实联调分别报告。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/connectors/src/runtime.ts:245`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+  if (claim.kind === 'conflict') throw new ConnectorError(`[CAGE-CONN-013] ${consumer} 同一幂等键对应不同请求；禁止覆盖已有执行`, null, false);
+  if (claim.kind === 'unknown') throw new ConnectorError(`[CAGE-CONN-014] ${consumer} 的不可重试调用结果未知；人工核对远端后再恢复`, null, false, 'unknown');
+  if (claim.kind === 'busy') throw new ConnectorError(`${consumer} 的调用仍由其他执行者持有`, null, true);
+  if (claim.kind === 'receipt') return { skipped: false, response: ob.op.response.parse(claim.response) };
+  let response: unknown;
+```

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

@@ -0,0 +1,49 @@
+# CAGE-CONN-015：连接器超时或限流参数无效
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：声明、图规则或 worker。
+
+timeoutMs 不是 1 至 300000 的整数，或 rateLimit.perSecond 不是有限正数。
+
+## 修复步骤
+
+1. 按第三方服务的实际边界设置有界超时和每秒限额。
+2. 首阶段额度在单进程内生效；多进程共享限额需要额外设计，不能按本地额度推断全局限流。
+
+## 正例
+
+```text
+timeoutMs: 10000, rateLimit: { perSecond: 5 }
+```
+
+## 反例
+
+```text
+timeoutMs: Infinity 或 rateLimit: { perSecond: 0 }
+```
+
+## 修复后验证
+
+先 cage check；涉及网络时检查同步记录、外部幂等结果与成功回写。fake 与真实联调分别报告。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/connectors/src/primitives.ts:65`
+- `packages/connectors/src/primitives.ts:68`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+  if (def.timeoutMs !== undefined && (!Number.isSafeInteger(def.timeoutMs) || def.timeoutMs <= 0 || def.timeoutMs > 300_000)) {
+    throw declError('CAGE-CONN-015', '连接器 timeoutMs 必须是 1～300000 毫秒的整数');
+  }
+  if (def.rateLimit && (!Number.isFinite(def.rateLimit.perSecond) || def.rateLimit.perSecond <= 0)) {
+    throw declError('CAGE-CONN-015', '连接器 rateLimit.perSecond 必须为有限正数');
+```

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

@@ -0,0 +1,53 @@
+# CAGE-CREATE-001：项目创建参数或模板资源有误
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：create-cage-app / cage create。
+
+目标目录已存在、模板参数不属于 blank/purchase、非交互环境缺少目录或模板，或 CLI 包缺少所选模板。
+
+## 修复步骤
+
+1. 选择未存在的目录；若是缺模板，核对 CLI 安装版本/分发包，框架维护者检查构建资源。不要覆盖现有项目。
+2. 交互终端可直接运行脚手架选择；CI/管道中显式传入目录及 --template blank 或 --template purchase。
+
+## 正例
+
+```text
+pnpm exec cage create ../new-business-app --template blank
+```
+
+## 反例
+
+```text
+cage create . 覆盖当前已有业务项目
+```
+
+## 修复后验证
+
+向一个新目录创建，检查 AGENTS.md、业务源码、docs/ai 和 docs/errors，然后按 README 安装/构建。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/create-prompt.ts:17`
+- `packages/cli/src/create-prompt.ts:24`
+- `packages/cli/src/create-prompt.ts:29`
+- `packages/cli/src/create.ts:45`
+- `packages/cli/src/create.ts:47`
+- `packages/cli/src/create.ts:54`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+ * @returns 完整创建选择；用户取消返回 null，由入口转换为取消退出码。
+ * @throws 非交互缺项或模板名无效时抛出 CAGE-CREATE-001。
+ */
+export async function chooseApp(
+  target?: string,
+```

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

@@ -0,0 +1,48 @@
+# CAGE-DECL-001：声明不在可抽取的顶层常量
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / 注册。
+
+原语调用藏在函数、条件、循环中，或没有赋给顶层常量。
+
+## 修复步骤
+
+1. 改为模块顶层 export const，让注册表和静态抽取器都能看到；动态部分放在受支持的 handler/map 等函数。
+
+## 正例
+
+```text
+export const Order = aggregate('Order', definition)
+```
+
+## 反例
+
+```text
+export function build() { return aggregate('Order', definition); }
+```
+
+## 修复后验证
+
+重跑 cage check/analyze，确认声明出现在本体图，再运行 gen。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/static-check.ts:232`
+- `packages/cli/src/static-check.ts:239`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+            findings.push({
+              code: 'CAGE-DECL-001',
+              at: loc(node),
+              reason: `原语 ${name}() 写在函数、条件或循环里，抽取器看不到它`,
+              fix: '原语必须在模块顶层用 export const 声明',
+```

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

@@ -0,0 +1,48 @@
+# CAGE-DECL-002：声明没有从 domain 入口导出
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / 注册。
+
+文件里有声明，但 domain/index.ts 最终导出集合中没有它。
+
+## 修复步骤
+
+1. 在统一入口 re-export，确认没有 export * 的同名冲突；只创建文件不会自动注册。
+
+## 正例
+
+```text
+export * from './purchase-order.js'; // index.ts
+```
+
+## 反例
+
+```text
+文件存在，但 index.ts 未导出
+```
+
+## 修复后验证
+
+重跑 cage check/analyze，确认声明出现在本体图，再运行 gen。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/doctor.ts:96`
+- `packages/cli/src/static-check.ts:304`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+    exports: result.registration?.find(entry => entry.name === site.exportName && entry.file === site.file),
+    registered: !result.findings.some(f => f.code === 'CAGE-DECL-002' && f.at === `${site.file}:${site.line}`),
+    nodes: result.graph?.nodes.filter(n => n.file === site.file && n.line === site.line).map(n => ({ key: `${n.kind}:${n.id}`, attrs: n.kind === 'reaction' ? { event: n.attrs.event, command: n.attrs.command, tx: n.attrs.tx, order: n.attrs.order, collection: n.attrs.collection } : undefined })) ?? [] }));
+  const verifyFile = abs(cfg, '.cage/verify.json');
+  return { schemaVersion: 1, cliVersion: VERSION, observedAt, project: cfg.name, registryHash, sourceHash, registryHashSource: compiledExists ? compiledEntry : /\.js$/.test(cfg.domain) ? cfg.domain : null, ok: checks.every(c => c.status !== 'fail'), complete: checks.every(c => c.status !== 'unknown'), checks, findings, registration,
+```

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

@@ -0,0 +1,47 @@
+# CAGE-DECL-003：声明不是 export const
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / 注册。
+
+顶层声明没有同时使用 export 和 const。
+
+## 修复步骤
+
+1. 使用稳定的模块顶层 export const；不要用可变声明或只保留文件内私有声明。
+
+## 正例
+
+```text
+export const OrderSubmitted = event('OrderSubmitted', fields)
+```
+
+## 反例
+
+```text
+const OrderSubmitted = event('OrderSubmitted', fields)
+```
+
+## 修复后验证
+
+重跑 cage check/analyze，确认声明出现在本体图，再运行 gen。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/static-check.ts:251`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+                findings.push({
+                  code: 'CAGE-DECL-003',
+                  at: loc(node),
+                  reason: `声明 ${topDecl.name.getText()} 没有用 export const 导出`,
+                  fix: '加上 export const，并确认它从 domain 的 index.ts 导出',
+```

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

@@ -0,0 +1,47 @@
+# CAGE-DECL-004：跨文件导出名冲突
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / 注册。
+
+多个文件导出了同名声明，export * 汇总会产生歧义并丢失导出。
+
+## 修复步骤
+
+1. 给导出变量唯一名字；需要保留最终命令名时用 command 的 name 覆盖。
+
+## 正例
+
+```text
+export const createNote = command(Note, { name: 'create', ... })
+```
+
+## 反例
+
+```text
+note.ts 与 order.ts 都 export const create，再 export *
+```
+
+## 修复后验证
+
+重跑 cage check/analyze，确认声明出现在本体图，再运行 gen。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/static-check.ts:283`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+      findings.push({
+        code: 'CAGE-DECL-004',
+        at: `${list[0].file}:${list[0].line}`,
+        reason: `导出名 ${n} 在 ${list.map((s) => s.file).join('、')} 里重复，export * 会把它们都丢掉`,
+        fix: '改成不重复的导出名；命令可以用 command(X, { name: "原名" }) 保持能力点不变',
+```

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

@@ -0,0 +1,48 @@
+# CAGE-DEP-001：领域声明直接依赖 IO
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / verify。
+
+domain 引入数据库、文件、网络或 HTTP 运行时等越界依赖。
+
+## 修复步骤
+
+1. 读取通过 reads，第三方交给连接器，框架装配放 apps/api；不要把 IO 移进 helper 后继续从 domain 间接调用。
+
+## 正例
+
+```text
+reads: { stock: Inventory }；handler 使用 deps.stock.findOne(...)
+```
+
+## 反例
+
+```text
+import pg from 'pg'; // domain 直接操作数据库
+```
+
+## 修复后验证
+
+重跑 cage check 和 verify，确认边界修复而不是禁用规则。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/static-check.ts:188`
+- `packages/lint/dependency-cruiser.cjs:13`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+          findings.push({
+            code: 'CAGE-DEP-001',
+            at: loc(node),
+            reason: `声明文件导入了 IO 模块 ${spec}`,
+            fix: '需要外部数据就声明 reads；需要通知外部系统就发事件，由连接器的出站映射处理',
+```

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

@@ -0,0 +1,47 @@
+# CAGE-DEP-002：适配器绕过命令写库
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / verify。
+
+packages/adapters 依赖数据库访问包并可能直接写业务表。
+
+## 修复步骤
+
+1. 将适配器输出映射为领域命令输入，通过命令网关落实状态、审计和权限。
+
+## 正例
+
+```text
+验签后调用 external 命令
+```
+
+## 反例
+
+```text
+适配器直接 update core.purchase_order
+```
+
+## 修复后验证
+
+重跑 cage check 和 verify，确认边界修复而不是禁用规则。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/lint/dependency-cruiser.cjs:22`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+      severity: 'error',
+      comment: '[CAGE-DEP-002] 适配器必须通过命令网关写数据',
+      from: { path: '^packages/adapters' },
+      to: { path: 'node_modules/(pg|kysely)/' },
+    },
+```

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

@@ -0,0 +1,47 @@
+# CAGE-DEP-003：前端依赖服务端实现
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / verify。
+
+apps/web 导入 domain 或 kernel/http/admin/connectors/approval/testkit 等服务端包。
+
+## 修复步骤
+
+1. 前端使用 @app/contracts 与 @yss123/cage-client；共享快照类型通过生成契约取得。
+
+## 正例
+
+```text
+import { purchaseOrder } from '@app/contracts'
+```
+
+## 反例
+
+```text
+import { approve } from '@app/domain'
+```
+
+## 修复后验证
+
+重跑 cage check 和 verify，确认边界修复而不是禁用规则。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/lint/dependency-cruiser.cjs:29`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+      severity: 'error',
+      comment: '[CAGE-DEP-003] 前端只能依赖 @app/contracts',
+      from: { path: '^apps/web' },
+      to: { path: '^packages/domain|node_modules/@yss123/cage-(kernel|http|files|admin|connectors|approval|testkit|ai|ontology)/' },
+    },
+```

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

@@ -0,0 +1,47 @@
+# CAGE-DEP-004：声明或 handler 直接发请求/动态导入
+
+[返回错误码册](README.md) · [业务排错](../ai/troubleshooting.md)
+
+> 本页由框架生成。正反例为局部声明或操作说明，完整写法见业务开发指南及本项目 domain。
+
+## 何时出现
+
+阶段：静态检查 / verify。
+
+静态检查发现 domain 调用 fetch 或动态 import。
+
+## 修复步骤
+
+1. 把外部 IO 声明成连接器，把声明改为静态导出，避免在运行时动态生成业务规格。
+
+## 正例
+
+```text
+event → outbound → onSuccess.command
+```
+
+## 反例
+
+```text
+handler 里 await fetch(...) 或动态 import 数据库模块
+```
+
+## 修复后验证
+
+重跑 cage check 和 verify，确认边界修复而不是禁用规则。
+
+## 框架内的检查位置
+
+以下路径相对框架源码仓库，不是要求业务项目创建这些文件。当前项目先修业务声明、配置或授权；明确属于框架缺口时反馈错误码和脱敏上下文。
+
+- `packages/cli/src/static-check.ts:199`
+
+实现片段（位置随框架版本更新）：
+
+```ts
+          findings.push({
+            code: 'CAGE-DEP-004',
+            at: loc(node),
+            reason: name === 'fetch' ? 'handler 里直接发网络请求' : '声明文件里使用了动态 import',
+            fix: '第三方调用改为连接器声明 + outbound 出站映射',
+```