@yss123/cage-cli 0.1.0 → 0.2.0

package/managed/errors/CAGE-STATE-011.md

@@ -1,32 +0,0 @@
-# CAGE-STATE-011
-
-## 什么时候出现
-
-命中以下实现中的检查时触发。终端会附具体声明位置、原因和修复方法。
-
-来源：[packages/cli/src/rules.ts:67](../../packages/cli/src/rules.ts)
-
-```ts
-
-/** CAGE-STATE-010：每个状态都能从初始状态到达；CAGE-STATE-011：非终态必须有出边 */
-export function checkStates(g: Ontology): Finding[] {
-  const { get } = index(g);
-  const findings: Finding[] = [];
-  for (const a of g.nodes.filter((n) => n.kind === 'aggregate')) {
-```
-
-## 怎么修
-
-让 from/to 引用已声明的状态，初始状态可达，非终态有出边，结束状态列入 terminal。
-
-## 正例
-
-```text
-states('draft', 'done', { terminal: ['done'] });
-```
-
-## 反例
-
-```text
-command(Order, { from: 'missing', to: 'done', handler: o => o });
-```

package/managed/errors/CAGE-SYNC-001.md

@@ -1,35 +0,0 @@
-# CAGE-SYNC-001
-
-## 什么时候出现
-
-命中以下实现中的检查时触发。终端会附具体声明位置、原因和修复方法。
-
-来源：[packages/cli/src/sync.ts:25](../../packages/cli/src/sync.ts)
-
-```ts
-  if (starts.length !== 1 || ends.length !== 1 || ends[0].index! < starts[0].index!) {
-    throw new Error('[CAGE-SYNC-001] 托管区标记不完整或重复，请修复 AGENTS.md 的 begin/end 标记');
-  }
-  return current.slice(0, starts[0].index) + latest + current.slice(ends[0].index! + ends[0][0].length);
-}
-
-```
-
-## 怎么修
-
-修复唯一的 begin/end 标记，再执行 cage sync；托管区之外的内容会保留。
-
-## 正例
-
-```text
-<!-- cage:begin v0.1.0 -->
-框架约定
-<!-- cage:end -->
-```
-
-## 反例
-
-```text
-<!-- cage:begin old -->
-没有结束标记
-```

package/managed/errors/CAGE-TEST-001.md

@@ -1,33 +0,0 @@
-# CAGE-TEST-001
-
-## 什么时候出现
-
-命中以下实现中的检查时触发。终端会附具体声明位置、原因和修复方法。
-
-来源：[packages/cli/src/verify.ts:36](../../packages/cli/src/verify.ts)
-
-```ts
-  if (code !== 0) return code;
-  if (!existsSync(report)) throw new Error('[CAGE-TEST-001] 测试进程未输出结果报告，不能判定通过');
-  const result = JSON.parse(readFileSync(report, 'utf8'));
-  if (result.numPendingTests) console.log(`覆盖提示：${result.numPendingTests} 个用例跳过，请结合业务测试验收。`);
-  return result.success ? 0 : 1;
-}
-```
-
-## 怎么修
-
-检查 Vitest 的输出及配置。必须生成当前运行的 JSON 报告，失败不能当作通过。
-
-## 正例
-
-```text
-cage test
-// .cage/test-results.json 中 success: true
-```
-
-## 反例
-
-```text
-// 测试启动失败却复用上一次结果
-```

package/managed/errors/CAGE-UNSAFE-001.md

@@ -1,32 +0,0 @@
-# CAGE-UNSAFE-001
-
-## 什么时候出现
-
-命中以下实现中的检查时触发。终端会附具体声明位置、原因和修复方法。
-
-来源：[packages/kernel/src/primitives/flow.ts:219](../../packages/kernel/src/primitives/flow.ts)
-
-```ts
-export function unsafe<T>(tag: UnsafeTag, fn: () => T): T {
-  if (!tag?.reason || !tag?.owner) throw declError('CAGE-UNSAFE-001', 'unsafe 必须写明 reason 和 owner');
-  return fn();
-}
-(unsafe as any)[UNSAFE] = true;
-
-```
-
-## 怎么修
-
-优先改为声明或命令；确需逃生口时填写非空 reason、owner，并记录评审。
-
-## 正例
-
-```text
-unsafe({ reason: '一次性修复历史数据', owner: '数据负责人' }, action)
-```
-
-## 反例
-
-```text
-unsafe({ reason: '', owner: '' }, action)
-```

package/managed/errors/CAGE-UPGRADE-001.md

@@ -1,32 +0,0 @@
-# CAGE-UPGRADE-001
-
-## 什么时候出现
-
-命中以下实现中的检查时触发。终端会附具体声明位置、原因和修复方法。
-
-来源：[packages/cli/src/upgrade.ts:45](../../packages/cli/src/upgrade.ts)
-
-```ts
-    if (old && obj?.getProperty('invokedBy'))
-      throw new Error('[CAGE-UPGRADE-001] command 同时包含 caller 与 invokedBy，请手工消除歧义');
-    old?.rename('invokedBy');
-  }
-  return file.getFullText();
-}
-```
-
-## 怎么修
-
-先安装目标版本 CLI，再运行对应 codemod；遇到同时存在新旧字段时手工消除歧义。
-
-## 正例
-
-```text
-cage upgrade --dry-run
-```
-
-## 反例
-
-```text
-command(A, { caller: 'user', invokedBy: 'process' })
-```

package/managed/errors/README.md

@@ -1,99 +0,0 @@
-# 错误码册
-
-每个错误码包含触发位置、修复建议和正反例。框架源码更新后运行 `node scripts/build-error-docs.mjs` 刷新索引。
-
-- [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-007](CAGE-APPR-007.md)
-- [CAGE-APPR-010](CAGE-APPR-010.md)
-- [CAGE-AUTH-001](CAGE-AUTH-001.md)
-- [CAGE-BUDGET-001](CAGE-BUDGET-001.md)
-- [CAGE-BUDGET-002](CAGE-BUDGET-002.md)
-- [CAGE-BUDGET-003](CAGE-BUDGET-003.md)
-- [CAGE-CMD-002](CAGE-CMD-002.md)
-- [CAGE-CMD-003](CAGE-CMD-003.md)
-- [CAGE-CONN-001](CAGE-CONN-001.md)
-- [CAGE-CONN-002](CAGE-CONN-002.md)
-- [CAGE-CONN-003](CAGE-CONN-003.md)
-- [CAGE-CONN-004](CAGE-CONN-004.md)
-- [CAGE-CONN-005](CAGE-CONN-005.md)
-- [CAGE-CONN-006](CAGE-CONN-006.md)
-- [CAGE-CONN-007](CAGE-CONN-007.md)
-- [CAGE-CONN-008](CAGE-CONN-008.md)
-- [CAGE-CONN-009](CAGE-CONN-009.md)
-- [CAGE-CONN-010](CAGE-CONN-010.md)
-- [CAGE-CONN-011](CAGE-CONN-011.md)
-- [CAGE-CONN-012](CAGE-CONN-012.md)
-- [CAGE-CREATE-001](CAGE-CREATE-001.md)
-- [CAGE-DECL-001](CAGE-DECL-001.md)
-- [CAGE-DECL-002](CAGE-DECL-002.md)
-- [CAGE-DECL-003](CAGE-DECL-003.md)
-- [CAGE-DECL-004](CAGE-DECL-004.md)
-- [CAGE-DEP-001](CAGE-DEP-001.md)
-- [CAGE-DEP-002](CAGE-DEP-002.md)
-- [CAGE-DEP-003](CAGE-DEP-003.md)
-- [CAGE-DEP-004](CAGE-DEP-004.md)
-- [CAGE-DEP-005](CAGE-DEP-005.md)
-- [CAGE-DLQ-001](CAGE-DLQ-001.md)
-- [CAGE-ENV-001](CAGE-ENV-001.md)
-- [CAGE-EVENT-001](CAGE-EVENT-001.md)
-- [CAGE-EVENT-002](CAGE-EVENT-002.md)
-- [CAGE-FIELD-001](CAGE-FIELD-001.md)
-- [CAGE-FIELD-002](CAGE-FIELD-002.md)
-- [CAGE-FIELD-003](CAGE-FIELD-003.md)
-- [CAGE-FIELD-004](CAGE-FIELD-004.md)
-- [CAGE-GEN-001](CAGE-GEN-001.md)
-- [CAGE-GEN-002](CAGE-GEN-002.md)
-- [CAGE-GRANT-001](CAGE-GRANT-001.md)
-- [CAGE-GRANT-002](CAGE-GRANT-002.md)
-- [CAGE-GRANT-003](CAGE-GRANT-003.md)
-- [CAGE-IMPACT-001](CAGE-IMPACT-001.md)
-- [CAGE-JOB-001](CAGE-JOB-001.md)
-- [CAGE-JOB-002](CAGE-JOB-002.md)
-- [CAGE-JOB-003](CAGE-JOB-003.md)
-- [CAGE-LINT-001](CAGE-LINT-001.md)
-- [CAGE-MIG-001](CAGE-MIG-001.md)
-- [CAGE-MIG-002](CAGE-MIG-002.md)
-- [CAGE-MIG-003](CAGE-MIG-003.md)
-- [CAGE-MIG-004](CAGE-MIG-004.md)
-- [CAGE-MIG-005](CAGE-MIG-005.md)
-- [CAGE-NAME-001](CAGE-NAME-001.md)
-- [CAGE-NAME-002](CAGE-NAME-002.md)
-- [CAGE-NAME-003](CAGE-NAME-003.md)
-- [CAGE-NAME-004](CAGE-NAME-004.md)
-- [CAGE-NAME-005](CAGE-NAME-005.md)
-- [CAGE-NAME-006](CAGE-NAME-006.md)
-- [CAGE-ORG-001](CAGE-ORG-001.md)
-- [CAGE-PAIR-002](CAGE-PAIR-002.md)
-- [CAGE-QUERY-001](CAGE-QUERY-001.md)
-- [CAGE-QUERY-002](CAGE-QUERY-002.md)
-- [CAGE-QUERY-003](CAGE-QUERY-003.md)
-- [CAGE-REACT-001](CAGE-REACT-001.md)
-- [CAGE-REACT-002](CAGE-REACT-002.md)
-- [CAGE-READS-001](CAGE-READS-001.md)
-- [CAGE-REG-001](CAGE-REG-001.md)
-- [CAGE-REG-002](CAGE-REG-002.md)
-- [CAGE-REG-003](CAGE-REG-003.md)
-- [CAGE-ROUTE-001](CAGE-ROUTE-001.md)
-- [CAGE-SCOPE-001](CAGE-SCOPE-001.md)
-- [CAGE-SCOPE-002](CAGE-SCOPE-002.md)
-- [CAGE-SECRET-001](CAGE-SECRET-001.md)
-- [CAGE-SECRET-002](CAGE-SECRET-002.md)
-- [CAGE-SENS-001](CAGE-SENS-001.md)
-- [CAGE-SQL-001](CAGE-SQL-001.md)
-- [CAGE-SQL-002](CAGE-SQL-002.md)
-- [CAGE-STATE-001](CAGE-STATE-001.md)
-- [CAGE-STATE-002](CAGE-STATE-002.md)
-- [CAGE-STATE-003](CAGE-STATE-003.md)
-- [CAGE-STATE-004](CAGE-STATE-004.md)
-- [CAGE-STATE-005](CAGE-STATE-005.md)
-- [CAGE-STATE-010](CAGE-STATE-010.md)
-- [CAGE-STATE-011](CAGE-STATE-011.md)
-- [CAGE-SYNC-001](CAGE-SYNC-001.md)
-- [CAGE-TEST-001](CAGE-TEST-001.md)
-- [CAGE-UNSAFE-001](CAGE-UNSAFE-001.md)
-- [CAGE-UPGRADE-001](CAGE-UPGRADE-001.md)

package/templates/app/compose.yaml

@@ -1,39 +0,0 @@
-# 开发库和测试库使用不同 PostgreSQL 集群。testkit 会初始化集群角色，
-# 因此不能把测试超级用户连接串指向持久化的开发库或生产库。
-services:
-  postgres:
-    image: postgres:18-bookworm
-    restart: unless-stopped
-    environment:
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?先运行 pnpm db:setup 生成本地凭证}
-      POSTGRES_DB: postgres
-    ports:
-      - '127.0.0.1:${CAGE_POSTGRES_PORT:-54329}:5432'
-    volumes:
-      # PostgreSQL 18 官方镜像把数据目录放在此父目录的 18/docker 中。
-      - postgres-data:/var/lib/postgresql
-    healthcheck:
-      test: ['CMD-SHELL', 'pg_isready -U postgres -d postgres']
-      interval: 2s
-      timeout: 5s
-      retries: 30
-
-  postgres-test:
-    image: postgres:18-bookworm
-    profiles: [test]
-    environment:
-      POSTGRES_PASSWORD: ${CAGE_TEST_POSTGRES_PASSWORD:?先运行 pnpm db:setup}
-      POSTGRES_DB: postgres
-    ports:
-      - '127.0.0.1:${CAGE_TEST_POSTGRES_PORT:-54330}:5432'
-    # 测试数据可丢弃：停止并重新创建容器后，由测试环境重新建临时库。
-    tmpfs:
-      - /var/lib/postgresql
-    healthcheck:
-      test: ['CMD-SHELL', 'pg_isready -U postgres -d postgres']
-      interval: 2s
-      timeout: 5s
-      retries: 30
-
-volumes:
-  postgres-data: