@yss123/cage-cli 0.1.0 → 0.3.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:

package/templates/app/packages/contracts/src/purchase-order.ts

@@ -1,72 +0,0 @@
-// 生成物：由 cage gen 从 domain 声明生成，不要手改。
-/* eslint-disable */
-
-import { z } from 'zod';
-import { client, useCageList, useCageQuery } from '@yss123/cage-client';
-
-/** PurchaseOrder：读侧快照（敏感字段是按权限掩码后的值） */
-export const PurchaseOrderSchema = z.object({
-  id: z.string().uuid(),
-  deptId: z.string().uuid(),
-  createdBy: z.string().uuid(),
-  supplierPhone: z.string().nullable().optional(),
-  amount: z.string(),
-  items: z.array(z.object({ sku: z.string(), qty: z.number().int() })),
-  erpNo: z.string().nullable().optional(),
-  status: z.enum(["draft", "pending_approval", "approved", "received", "rejected", "cancelled"]),
-  version: z.number().int(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-export type PurchaseOrder = z.infer<typeof PurchaseOrderSchema>;
-export type PurchaseOrderStatus = PurchaseOrder['status'];
-export const PurchaseOrderStates = ['draft', 'pending_approval', 'approved', 'received', 'rejected', 'cancelled'] as const;
-
-/** 命令输入：和后端命令的输入校验完全一致 */
-export const PurchaseOrderInputs = {
-  cancel: z.object({ id: z.string().uuid() }),
-  create: z.object({ amount: z.string(), items: z.array(z.object({ sku: z.string(), qty: z.number().int().max(9007199254740991).gt(0) })).min(1), supplierPhone: z.string().optional(), deptId: z.string().uuid().optional() }),
-  submit: z.object({ id: z.string().uuid() }),
-};
-
-/** PurchaseOrder.cancel 可能返回的错误码 */
-export type PurchaseOrderCancelError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'INVARIANT_VIOLATED' | 'NOT_FOUND';
-/** PurchaseOrder.create 可能返回的错误码 */
-export type PurchaseOrderCreateError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVARIANT_VIOLATED';
-/** PurchaseOrder.submit 可能返回的错误码；业务码（domainCode）：NO_ITEMS */
-export type PurchaseOrderSubmitError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'INVARIANT_VIOLATED' | 'NOT_FOUND';
-export type PurchaseOrderSubmitDomainCode = 'NO_ITEMS';
-
-export type PurchaseOrderSortKey = 'createdAt' | 'updatedAt' | 'deptId' | 'createdBy' | 'supplierPhone' | 'amount' | 'erpNo';
-export interface PurchaseOrderListParams {
-  page?: number;
-  pageSize?: number;
-  /** 排序：字段名，前面加 - 表示倒序 */
-  sort?: PurchaseOrderSortKey | `-${PurchaseOrderSortKey}`;
-  /** 可以逗号分隔多个状态 */
-  status?: string;
-  createdAfter?: string;
-  createdBefore?: string;
-  deptId?: string | number | boolean;
-  createdBy?: string | number | boolean;
-  amount?: string | number | boolean;
-  erpNo?: string | number | boolean;
-}
-
-/** 调用方法：每个命令一个；client 自动生成并附带幂等键和 CSRF 令牌 */
-export const purchaseOrder = {
-  cancel: (id: string, expectedVersion?: number) => client.post<PurchaseOrder, PurchaseOrderCancelError>(`/api/purchase-order/${encodeURIComponent(id)}/cancel`, { expectedVersion }),
-  create: (input: z.input<typeof PurchaseOrderInputs.create>) => client.post<PurchaseOrder, PurchaseOrderCreateError>('/api/purchase-order/create', input),
-  submit: (id: string, expectedVersion?: number) => client.post<PurchaseOrder, PurchaseOrderSubmitError>(`/api/purchase-order/${encodeURIComponent(id)}/submit`, { expectedVersion }),
-  /** 导出 CSV：需要 PurchaseOrder.export 能力 */
-  export: (params: PurchaseOrderListParams = {}) => client.post<string, never>('/api/purchase-order/export', params),
-  get: (id: string) => client.get<PurchaseOrder>(`/api/purchase-order/${encodeURIComponent(id)}`),
-  list: (params: PurchaseOrderListParams = {}) => client.get<{ items: PurchaseOrder[]; total: number; page: number; pageSize: number }>('/api/purchase-order', params as Record<string, unknown>),
-};
-
-/** 详情查询 hook：响应也用 schema 校验；范围外返回 NOT_FOUND */
-export const usePurchaseOrder = (id: string) => useCageQuery(['purchase-order', id], `/api/purchase-order/${encodeURIComponent(id)}`, PurchaseOrderSchema, { enabled: !!id });
-/** 列表查询 hook：走读侧账号与安全视图 */
-export const usePurchaseOrderList = (params: PurchaseOrderListParams = {}) => useCageList(['purchase-order'], '/api/purchase-order', params as Record<string, unknown>, PurchaseOrderSchema);
-/** 查询缓存键前缀：命令成功后让它失效 */
-export const purchaseOrderKeys = { all: ['purchase-order'] as const, one: (id: string) => ['purchase-order', id] as const };

package/templates/app/packages/contracts/src/user.ts

@@ -1,89 +0,0 @@
-// 生成物：由 cage gen 从 domain 声明生成，不要手改。
-/* eslint-disable */
-
-import { z } from 'zod';
-import { client, useCageList, useCageQuery } from '@yss123/cage-client';
-
-/** 用户：读侧快照（敏感字段是按权限掩码后的值） */
-export const UserSchema = z.object({
-  id: z.string().uuid(),
-  username: z.string(),
-  name: z.string(),
-  deptId: z.string().uuid(),
-  roleIds: z.array(z.string().uuid()),
-  phone: z.string().nullable().optional(),
-  email: z.string().nullable().optional(),
-  ssoSubject: z.string().nullable().optional(),
-  status: z.enum(["active", "disabled"]),
-  version: z.number().int(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-export type User = z.infer<typeof UserSchema>;
-export type UserStatus = User['status'];
-export const UserStates = ['active', 'disabled'] as const;
-
-/** 命令输入：和后端命令的输入校验完全一致 */
-export const UserInputs = {
-  assignRoles: z.object({ id: z.string().uuid(), roleIds: z.array(z.string().uuid()).max(50) }),
-  create: z.object({ username: z.string().min(2).max(64).regex(new RegExp("^[A-Za-z0-9_.@-]+$")), name: z.string().min(1).max(100), deptId: z.string().uuid(), phone: z.string().max(32).nullable().optional(), email: z.string().email().max(200).nullable().optional(), ssoSubject: z.string().max(200).nullable().optional() }),
-  disable: z.object({ id: z.string().uuid() }),
-  enable: z.object({ id: z.string().uuid() }),
-  setPassword: z.object({ id: z.string().uuid(), password: z.string().min(8).max(200) }),
-  update: z.object({ id: z.string().uuid(), name: z.string().min(1).max(100).optional(), deptId: z.string().uuid().optional(), phone: z.string().max(32).nullable().optional(), email: z.string().email().max(200).nullable().optional() }),
-};
-
-/** User.assignRoles 可能返回的错误码 */
-export type UserAssignRolesError = 'CONFLICT' | 'CONSTRAINT_VIOLATED' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
-/** 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';
-/** User.enable 可能返回的错误码 */
-export type UserEnableError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
-/** User.setPassword 可能返回的错误码 */
-export type UserSetPasswordError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
-/** User.update 可能返回的错误码 */
-export type UserUpdateError = 'CONFLICT' | 'DOMAIN_ERROR' | 'FORBIDDEN' | 'INVALID_INPUT' | 'INVALID_TRANSITION' | 'NOT_FOUND';
-
-export type UserSortKey = 'createdAt' | 'updatedAt' | 'username' | 'name' | 'deptId' | 'phone' | 'email' | 'ssoSubject';
-export interface UserListParams {
-  page?: number;
-  pageSize?: number;
-  /** 排序：字段名，前面加 - 表示倒序 */
-  sort?: UserSortKey | `-${UserSortKey}`;
-  /** 可以逗号分隔多个状态 */
-  status?: string;
-  createdAfter?: string;
-  createdBefore?: string;
-  username?: string | number | boolean;
-  deptId?: string | number | boolean;
-  ssoSubject?: string | number | boolean;
-}
-
-/** 调用方法：每个命令一个；client 自动生成并附带幂等键和 CSRF 令牌 */
-export const user = {
-  /** 设置用户的角色（不能分配包含自己没有的能力的角色） */
-  assignRoles: (id: string, input: Omit<z.input<typeof UserInputs.assignRoles>, 'id'>, expectedVersion?: number) => client.post<User, UserAssignRolesError>(`/api/user/${encodeURIComponent(id)}/assign-roles`, { ...input, expectedVersion }),
-  /** 新建用户（默认没有任何角色） */
-  create: (input: z.input<typeof UserInputs.create>) => client.post<User, UserCreateError>('/api/user/create', input),
-  /** 停用用户 */
-  disable: (id: string, expectedVersion?: number) => client.post<User, UserDisableError>(`/api/user/${encodeURIComponent(id)}/disable`, { expectedVersion }),
-  /** 启用用户 */
-  enable: (id: string, expectedVersion?: number) => client.post<User, UserEnableError>(`/api/user/${encodeURIComponent(id)}/enable`, { expectedVersion }),
-  /** 重置密码 */
-  setPassword: (id: string, input: Omit<z.input<typeof UserInputs.setPassword>, 'id'>, expectedVersion?: number) => client.post<User, UserSetPasswordError>(`/api/user/${encodeURIComponent(id)}/set-password`, { ...input, expectedVersion }),
-  /** 修改用户信息 */
-  update: (id: string, input: Omit<z.input<typeof UserInputs.update>, 'id'>, expectedVersion?: number) => client.post<User, UserUpdateError>(`/api/user/${encodeURIComponent(id)}/update`, { ...input, expectedVersion }),
-  /** 导出 CSV：需要 User.export 能力 */
-  export: (params: UserListParams = {}) => client.post<string, never>('/api/user/export', params),
-  get: (id: string) => client.get<User>(`/api/user/${encodeURIComponent(id)}`),
-  list: (params: UserListParams = {}) => client.get<{ items: User[]; total: number; page: number; pageSize: number }>('/api/user', params as Record<string, unknown>),
-};
-
-/** 详情查询 hook：响应也用 schema 校验；范围外返回 NOT_FOUND */
-export const useUser = (id: string) => useCageQuery(['user', id], `/api/user/${encodeURIComponent(id)}`, UserSchema, { enabled: !!id });
-/** 列表查询 hook：走读侧账号与安全视图 */
-export const useUserList = (params: UserListParams = {}) => useCageList(['user'], '/api/user', params as Record<string, unknown>, UserSchema);
-/** 查询缓存键前缀：命令成功后让它失效 */
-export const userKeys = { all: ['user'] as const, one: (id: string) => ['user', id] as const };

package/templates/app/packages/domain/src/approvals.ts

@@ -1,18 +0,0 @@
-// 路由只决定由谁审批；最终结论仍调用领域命令，执行职责分离和额度约束。
-import { approval } from '@yss123/cage-kernel';
-import { approver, gt, route, step, when } from '@yss123/cage-approval';
-import { PurchaseOrder, OrderSubmitted, OrderCancelled, approve, reject } from './purchase-order.js';
-
-export const poApproval = approval(PurchaseOrder, {
-  process: 'po-approval',
-  start: OrderSubmitted,
-  cancelOn: [OrderCancelled],
-  routable: ['amount', 'deptId'],
-  onApproved: approve,
-  onRejected: reject,
-});
-
-export const poRoute = route('po-approval', [
-  step('部门经理审批', approver.deptLeader('deptId')),
-  when(gt('amount', 50000), step('财务审批', approver.role('finance'), { mode: 'any' })),
-]);

package/templates/app/packages/domain/src/purchase-order.ts

@@ -1,122 +0,0 @@
-// 采购单声明集中列出状态、范围、不变量、命令和事件。
-// handler 只读声明的依赖；数据库写入、版本检查、审计由内核完成。
-import {
-  aggregate,
-  ceiling,
-  command,
-  emit,
-  event,
-  fail,
-  id,
-  int,
-  list,
-  money,
-  ref,
-  scope,
-  sod,
-  states,
-  text,
-} from '@yss123/cage-kernel';
-import { z } from 'zod';
-import { Inventory } from './inventory.js';
-
-export const POStatus = states('draft', 'pending_approval', 'approved', 'received', 'rejected', 'cancelled', {
-  terminal: ['received', 'rejected', 'cancelled'],
-});
-
-export const PurchaseOrder = aggregate('PurchaseOrder', {
-  fields: {
-    deptId: ref('Dept'),
-    createdBy: ref('User'),
-    supplierPhone: text(32).sensitive('phone').optional(),
-    amount: money(),
-    items: list({ sku: text(64), qty: int() }),
-    erpNo: text(64).optional(),
-  },
-  states: POStatus,
-  scope: scope.deptSubtree('deptId'),
-  invariants: {
-    amountPositive: (o) => Number(o.amount) > 0,
-    hasItems: (o) => o.items.length > 0,
-  },
-});
-
-export const OrderSubmitted = event('OrderSubmitted', { orderId: id(), amount: money(), deptId: id() });
-export const OrderApproved = event('OrderApproved', {
-  orderId: id(),
-  items: list({ sku: text(64), qty: int() }),
-});
-export const OrderCancelled = event('OrderCancelled', { orderId: id(), previousStatus: text() });
-export const OrderReceived = event('OrderReceived', { orderId: id() });
-
-const itemsInput = z.array(z.object({ sku: z.string(), qty: z.number().int().positive() })).min(1);
-
-export const create = command(PurchaseOrder, {
-  from: 'new',
-  to: 'draft',
-  input: z.object({
-    amount: z.string(),
-    items: itemsInput,
-    supplierPhone: z.string().optional(),
-    deptId: z.string().uuid().optional(),
-  }),
-  handler: (o) => o,
-});
-
-export const submit = command(PurchaseOrder, {
-  from: 'draft',
-  to: 'pending_approval',
-  emits: [OrderSubmitted],
-  handler: (o) => (o.items.length === 0 ? fail('NO_ITEMS') : o),
-});
-
-export const approve = command(PurchaseOrder, {
-  from: 'pending_approval',
-  to: 'approved',
-  invokedBy: 'process',
-  constraints: [sod.notSameAs('createdBy'), ceiling('amount')],
-  reads: { stock: Inventory },
-  emits: [OrderApproved],
-  handler: async (o, _input, { stock }) => {
-    const short = [];
-    for (const i of o.items) {
-      const s = await stock.findOne({ sku: i.sku });
-      if (!s || s.available < i.qty) short.push(i.sku);
-    }
-    return short.length ? fail('STOCK_SHORT', short) : o;
-  },
-});
-
-export const reject = command(PurchaseOrder, {
-  from: 'pending_approval',
-  to: 'rejected',
-  invokedBy: 'process',
-  handler: (o) => o,
-});
-
-export const cancel = command(PurchaseOrder, {
-  from: ['draft', 'pending_approval', 'approved'],
-  to: 'cancelled',
-  emits: [emit(OrderCancelled, (o, _i, prev) => ({ orderId: o.id, previousStatus: prev.status }))],
-  handler: (o) => o,
-});
-
-// 仅连接器能回写 ERP 单号和收货结论，浏览器无法直接调用这两个命令。
-export const recordErpNo = command(PurchaseOrder, {
-  // ERP 推送可能早于取消发出、晚于取消返回；收货回调也可能先于推送应答到达。
-  // 这里只记录外部回执，保留当前生命周期，保证 outbox 后续的解锁事件能够继续投递。
-  from: ['approved', 'received', 'cancelled'],
-  to: null,
-  invokedBy: 'external',
-  input: z.object({ id: z.string().uuid(), erpNo: z.string() }),
-  handler: (_o, input) => ({ erpNo: input.erpNo }),
-});
-
-export const markReceived = command(PurchaseOrder, {
-  from: 'approved',
-  to: 'received',
-  invokedBy: 'external',
-  input: z.object({ id: z.string().uuid() }),
-  emits: [OrderReceived],
-  handler: (o) => o,
-});