feat(p1-c1): 类型契约 + ChatContext.taskType + pending 测试矩阵

P1 commit #1 (spec v0.4.1 §7) — 类型层 + schema 字段铺底，**无产品逻辑改动**。
所有运行时测试都是 `it.todo` 占位，对应 product commit (#4 / deepcoldy#5) 才打开。

## 类型 / Schema

### src/services/chat-context-store.ts
- 新增 `export type TaskType = 'prd' | 'bug' | 'misc'`
- `ChatContext.taskType?: TaskType`（向后兼容：旧 JSON 不写此字段；
  caller 没传 → undefined → JSON.stringify 不写出 → 旧 reader 不知道新字段）
- `CreateOpts.taskType?: TaskType` + `create()` body 写入

### src/services/group-creator.ts
- `CreateGroupOpts.chatContext?: { taskType / relatedRefs / activeTodoRefs
  / rules / participants / parentDigest }` — types-only
- 注释明确：(a) participants 由 caller (Playbook) 推导后传入，
  group-creator 只透传不推导；(b) idempotencyKey 故意不加，幂等主责
  完全在 Playbook + spawn-idempotency-store（v0.4 妹妹 #2）
- **body 无任何改动**（commit #4 才接 chatContext → dispatchChatCreated）

### src/im/lark/chat-created-handler.ts
- `DispatchChatCreatedOpts` 加 rich fields（relatedRefs / activeTodoRefs
  / rules / parentDigest / taskType）— types-only
- **body 无任何改动**（commit deepcoldy#5 才写入 ChatContext）

## 测试

### test/group-creator-chatcontext.test.ts（新）
- 6 tests：C1 真跑（类型 backward compat） + C2/C3/C9/C10/C-PP-pass `it.todo`
- C4/C5/C6/C7/C7b/C8（v0.1-v0.3 老 case）按 v0.4 妹妹 #2 已挪到
  spawn-idempotency-store / Playbook 测试

### test/dispatch-chat-created-rich-context.test.ts（新）
- 5 tests：1 个类型断言真跑（rich opts 可编译） + D1/D2/D3/D-PP `it.todo`

## 验证

- `pnpm tsc --noEmit` ✅
- focused 3 文件 / 63 pass + 9 todo / 0 fail
- 全量 vitest 2579 pass / 6 fail（全部跟 commit #1 无关：3 个老 CLI binary
  缺失测试 + 3 个 EMFILE 系统 fd 耗尽，错误堆栈在 `src/workflows/fanout.ts:93`
  系统 watch() 直接抛，跟 schema 改动无关）
- **向后兼容回归 e2e**（真飞书建群）：
  - `botmux create-group --bot 克劳德 --name "..."` → Lark 真群建成功
  - 写出 ChatContext.json 12 个旧字段全在 + `taskType` 字段缺席
    （caller 没传 → JSON 不写）= 老 reader 完全感知不到 schema 变化
  - dashboard `/api/topology` HTTP 200，新群被收录 (originType=bot_spawned)
  - 测试群已归档清理

## 边界遵守（妹妹 review v0.1-v0.4.1 后五版定下）

- group-creator 只建群 + dispatch，不知道 idempotency 概念
- Playbook 独占任务模板 + 权限校验 + 幂等（commit deepcoldy#6 实现）
- CLI 是 IPC 薄壳（commit deepcoldy#7 实现）
- session 真凭证从 session-store 反查，CLI 不能伪造（commit deepcoldy#6/deepcoldy#8 实现）
- BOTMUX_SESSION_ID env 由 worker-spawner 唯一注入（commit deepcoldy#8 实现）

下一步: commit #2 (config mainTopicChatId + 同步 ChatTopology.rootChatId)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: bdjasonzjs

src/im/lark/chat-created-handler.ts

@@ -134,6 +134,16 @@ export interface DispatchChatCreatedOpts {
   parentChatId?: string | null;
   purpose?: string;
   participants?: { openId: string; role: string }[];
+  /** P1 main-bot mode (spec v0.4.1 §1.3) — richer ChatContext fields
+   *  plumbed through from group-creator / Playbook so the FIRST welcome
+   *  card is complete. dispatchChatCreated body writes these straight
+   *  into ChatContext.create() (chat-context-store has承载位 already).
+   *  Implementation is wired in commit #5, here is types-only (commit #1). */
+  relatedRefs?: string[];
+  activeTodoRefs?: string[];
+  rules?: string[];
+  parentDigest?: string;
+  taskType?: 'prd' | 'bug' | 'misc';
 }
 
 /**

src/services/chat-context-store.ts

@@ -39,6 +39,12 @@ export interface ChatContextInherited {
  *  board and skip escalation rule evaluation (R1-R5 / R6). */
 export type ChatStatus = 'active' | 'archived';
 
+/** Task category for chats spawned by the main bot via
+ *  `MainBotPlaybook.spawnSubTask`. Drives dashboard filtering + template
+ *  selection (rules/welcome-card wording). undefined for non-task chats
+ *  (p2p / human-created / legacy bot_spawned without a task type). */
+export type TaskType = 'prd' | 'bug' | 'misc';
+
 export interface ChatContext {
   chatId: string;
   /** One-line summary of what this chat is for. */
@@ -62,6 +68,9 @@ export interface ChatContext {
   status?: ChatStatus;
   /** ISO timestamp when archived (null/undefined when status='active'). */
   archivedAt?: string | null;
+  /** P1: task category — set by MainBotPlaybook.spawnSubTask, used by
+   *  dashboard filter + template logic. undefined for non-task chats. */
+  taskType?: TaskType;
   /** ISO timestamp of last write (for cache invalidation). */
   updatedAt: string;
 }
@@ -126,6 +135,8 @@ export interface CreateOpts {
   activeTodoRefs?: string[];
   rules?: string[];
   injectionPolicy?: InjectionPolicy;
+  /** P1: optional task category for MainBotPlaybook-spawned chats. */
+  taskType?: TaskType;
 }
 
 /**
@@ -157,6 +168,7 @@ export function create(chatId: string, opts: CreateOpts): ChatContext {
     injectionPolicy: opts.injectionPolicy ?? 'eager',
     status: 'active',
     archivedAt: null,
+    taskType: opts.taskType,
     updatedAt: new Date().toISOString(),
   };
   write(ctx);

src/services/group-creator.ts

@@ -43,6 +43,33 @@ export interface CreateGroupOpts {
   /** P0/4 main-bot mode: one-line purpose statement. Defaults to a placeholder
    *  that the L2 缇蕾 scout replaces on its next tick. */
   purpose?: string;
+  /**
+   * P1 main-bot mode (spec v0.4.1 §1.1) — richer ChatContext fields,
+   * passed straight through to `dispatchChatCreated()` so the FIRST
+   * welcome card is complete (no "send empty card, then update" anti-
+   * pattern). Optional: callers that don't care (legacy `/group`,
+   * dashboard `build-group`) can omit and get current purpose-only
+   * behavior.
+   *
+   * Note: `participants` here is what caller already resolved
+   * (MainBotPlaybook is responsible for推导 bot ref → openId+role).
+   * group-creator does NOT auto-推导 — it只透传给 dispatchChatCreated.
+   *
+   * `idempotencyKey` is deliberately absent (v0.4 妹妹 #2): idempotency
+   * 主责完全在 MainBotPlaybook + spawn-idempotency-store, group-creator
+   * 不知道幂等概念。
+   *
+   * Wiring (commit #4): pass these into `dispatchChatCreated` opts.
+   * Commit #1 (this commit) is types-only — no body change yet.
+   */
+  chatContext?: {
+    taskType?: 'prd' | 'bug' | 'misc';
+    relatedRefs?: string[];
+    activeTodoRefs?: string[];
+    rules?: string[];
+    participants?: Array<{ openId: string; role: string }>;
+    parentDigest?: string;
+  };
 }
 
 export interface CreateGroupResult {

test/dispatch-chat-created-rich-context.test.ts

@@ -0,0 +1,54 @@
+/**
+ * Test matrix for `DispatchChatCreatedOpts` richer fields persisting into
+ * ChatContext + welcome card on FIRST dispatch (no "send empty card, then
+ * update" anti-pattern).
+ *
+ * Spec: docs/superpowers/plans/2026-05-24-p1-main-bot-subtask-spawn.md §1.5
+ *
+ * **Commit #1 (this commit)** — types-only. All runtime assertions are
+ * `it.todo` placeholders; opened in commit #5 when dispatchChatCreated
+ * body actually persists the new fields.
+ *
+ * Run:  pnpm vitest run test/dispatch-chat-created-rich-context.test.ts
+ */
+import { describe, it, expect } from 'vitest';
+import type { DispatchChatCreatedOpts } from '../src/im/lark/chat-created-handler.js';
+
+describe('dispatchChatCreated: rich context plumbing', () => {
+  describe('Types — opts contract', () => {
+    it('DispatchChatCreatedOpts accepts the richer fields (compile-time only)', () => {
+      const opts: DispatchChatCreatedOpts = {
+        chatId: 'oc_compile_test',
+        larkAppId: 'cli_x',
+        originType: 'bot_spawned',
+        parentChatId: 'oc_parent',
+        purpose: 'analyse PRD',
+        participants: [{ openId: 'ou_a', role: 'main bot' }],
+        relatedRefs: ['https://wiki/p1'],
+        activeTodoRefs: ['om_root_msg'],
+        rules: ['先读 PRD 全文'],
+        parentDigest: 'parent chat 24h digest text',
+        taskType: 'prd',
+      };
+      // Compile-time success is the assertion. Runtime sanity:
+      expect(opts.taskType).toBe('prd');
+      expect(opts.rules?.length).toBe(1);
+    });
+  });
+
+  describe('D1 — ChatContext.read() after dispatch has all rich fields', () => {
+    it.todo('dispatch with rich opts persists taskType / rules / relatedRefs / activeTodoRefs / parentDigest into ChatContext');
+  });
+
+  describe('D2 — first welcome card sees rich ctx (mock sendContextCard)', () => {
+    it.todo('first welcome card render receives ctx containing rules + relatedRefs + activeTodoRefs + participants — not empty defaults');
+  });
+
+  describe('D3 — second dispatch is idempotent (no rewrite/resend)', () => {
+    it.todo('same chatId second dispatch hits ChatContext.create idempotency, no second card sent');
+  });
+
+  describe('D-PP — three-bot participants array persists fully', () => {
+    it.todo('participants=三 bot 数组 → ChatContext.participants length=3, all three openIds present');
+  });
+});

test/group-creator-chatcontext.test.ts

@@ -0,0 +1,54 @@
+/**
+ * Test matrix for `CreateGroupOpts.chatContext` plumbing.
+ *
+ * Spec: docs/superpowers/plans/2026-05-24-p1-main-bot-subtask-spawn.md §1.5
+ *
+ * **Commit #1 (this commit)** — types-only, body not yet implemented.
+ * Most cases are `it.todo` placeholders that real product commits
+ * (#4 `createGroupWithBots` body, #5 `dispatchChatCreated` body) open up.
+ * Only C1 (existing-behavior regression) runs for real now.
+ *
+ * Run:  pnpm vitest run test/group-creator-chatcontext.test.ts
+ */
+import { describe, it, expect } from 'vitest';
+import type { CreateGroupOpts } from '../src/services/group-creator.js';
+
+describe('group-creator: chatContext plumbing', () => {
+  describe('C1 — backward compat: chatContext omitted', () => {
+    it('CreateGroupOpts.chatContext is optional in the type', () => {
+      // Type-level assertion: omitting chatContext compiles.
+      const opts: CreateGroupOpts = {
+        creatorLarkAppId: 'cli_x',
+        larkAppIds: ['cli_y'],
+        name: 'legacy /group call without chatContext',
+      };
+      expect(opts.chatContext).toBeUndefined();
+    });
+  });
+
+  describe('C2 — chatContext fields plumb to dispatchChatCreated', () => {
+    it.todo('createGroupWithBots forwards chatContext.taskType/rules/relatedRefs to dispatchChatCreated (spy)');
+  });
+
+  describe('C3 — parentDigest + sourceChatId → ChatContext.inheritedFrom.parentDigest', () => {
+    it.todo('chatContext.parentDigest with sourceChatId writes both into ChatContext.inheritedFrom');
+  });
+
+  describe('C9 — transferOwnerTo conditional', () => {
+    it.todo('omitting transferOwnerTo skips the transfer call (no Lark transferChatOwner)');
+  });
+
+  describe('C10 — notifyOwnerOpenId conditional', () => {
+    it.todo('omitting notifyOwnerOpenId skips the @-mention notify call (no sendMessage to owner)');
+  });
+
+  describe('C-PP-pass — Playbook-resolved participants pass through unchanged', () => {
+    it.todo('chatContext.participants array (already resolved by caller) is forwarded to dispatchChatCreated verbatim — group-creator does no derivation');
+  });
+
+  // The following cases used to live here in spec v0.1-v0.3, but per spec
+  // v0.4 they belong to the idempotency-store / Playbook test files
+  // because group-creator no longer knows about idempotency at all:
+  //   C4 / C5 / C6 / C7 / C7b / C8 → test/spawn-idempotency-store.test.ts
+  //                                → test/main-bot-playbook-spawn-subtask.test.ts
+});