抓大鹅B3实现

packages/shared/src/contracts/match3dAgent.ts

@@ -1,6 +1,13 @@
+/**
+ * 抓大鹅 Match3D 创作 Agent 共享契约。
+ * 字段按 HTTP facade 的 camelCase DTO 命名，后端领域层 snake_case 字段由 facade 映射。
+ */
 export type Match3DCreationStage =
+  | 'collecting'
   | 'collecting_config'
+  | 'ready_to_compile'
   | 'draft_ready'
+  | 'draft_compiled'
   | 'ready_to_publish'
   | 'published'
   | string;

packages/shared/src/contracts/match3dRuntime.ts

@@ -1,3 +1,7 @@
+/**
+ * 抓大鹅 Match3D 运行态共享契约。
+ * 前端可以使用 Flying 做即时表现；后端权威快照只应返回 InBoard、InTray、Cleared。
+ */
 export type Match3DRunStatus =
   | 'running'
   | 'won'

packages/shared/src/contracts/match3dWorks.ts

@@ -1,3 +1,7 @@
+/**
+ * 抓大鹅 Match3D 作品读写共享契约。
+ * 首版作品发布必须补齐游戏名称、标签、封面、题材、消除次数和难度。
+ */
 export type Match3DWorkPublicationStatus = 'draft' | 'published' | string;
 
 export interface PutMatch3DWorkRequest {