@myclaw163/clawclaw-cli 0.6.71 → 0.6.74

package/src/commands/watch.test.ts

@@ -1,977 +1,999 @@
-import { describe, expect, it } from 'vitest';
-import {
-  classifyEvent,
-  compactEventForMonitor,
-  compactSummaryForMonitor,
-  DELAYABLE_EVENT_CONFIG,
-  eventKey,
-  MONITOR_EVENT_CONFIG,
-  NOTABLE_EVENT_TYPES,
-  nextStepFor,
-  POLL_INTERVAL_MS,
-  readFeedSummary,
-  runStreaming,
-  snapshotOnce,
-  sortEventsForMonitor,
-} from './watch.js';
-
-describe('classifyEvent + NOTABLE_EVENT_TYPES', () => {
-  it('NOTABLE_EVENT_TYPES contains the headline events', () => {
-    for (const t of [
-      'exile', 'speech_skipped', 'meeting_briefing',
-      'speech', 'vote_phase_start', 'game_over',
-      'speech_your_turn', 'vote_speech_phase_ended',
-      'crab_teammates', 'no_exile',
-    ]) {
-      expect(NOTABLE_EVENT_TYPES.has(t)).toBe(true);
-    }
-    expect(NOTABLE_EVENT_TYPES.has('vote_cast')).toBe(false);
-    expect(NOTABLE_EVENT_TYPES.has('meeting_ended')).toBe(false);
-  });
-
-  it('derives NOTABLE_EVENT_TYPES from MONITOR_EVENT_CONFIG', () => {
-    expect([...NOTABLE_EVENT_TYPES].sort()).toEqual(Object.keys(MONITOR_EVENT_CONFIG).sort());
-  });
-
-  it('registers monitor event priorities in the same config as notable events', () => {
-    expect(MONITOR_EVENT_CONFIG.speech_your_turn.priority).toBe(99);
-    expect(MONITOR_EVENT_CONFIG.vote_phase_start.priority).toBe(99);
-    expect(MONITOR_EVENT_CONFIG.killed.priority).toBe(99);
-    expect(MONITOR_EVENT_CONFIG.speech.priority).toBe(50);
-    expect(MONITOR_EVENT_CONFIG.vote_speech_phase_ended.priority).toBe(50);
-    expect(MONITOR_EVENT_CONFIG.crab_teammates.priority).toBe(50);
-    expect(MONITOR_EVENT_CONFIG.vote_speech).toBeUndefined();
-    expect(MONITOR_EVENT_CONFIG.vote_cast).toBeUndefined();
-    expect(MONITOR_EVENT_CONFIG.meeting_ended).toBeUndefined();
-  });
-
-  it('classifyEvent returns notable=true for known types', () => {
-    expect(classifyEvent({ type: 'killed', tick: 1 }).notable).toBe(true);
-  });
-
-  it('classifyEvent returns notable=false for unknown types', () => {
-    expect(classifyEvent({ type: 'heartbeat', tick: 1 }).notable).toBe(false);
-  });
-
-  it('DELAYABLE_EVENT_CONFIG contains the delayable events', () => {
-    for (const t of ['kill', 'emergency_started', 'corpse_spotted']) {
-      expect(DELAYABLE_EVENT_CONFIG[t]).toBeGreaterThan(0);
-    }
-  });
-
-  it('classifyEvent marks speech_your_turn as notable', () => {
-    expect(
-      classifyEvent({ type: 'speech_your_turn', tick: 1, actor_name: 'me' }, 'me').notable,
-    ).toBe(true);
-  });
-
-  it('classifyEvent marks speech as notable', () => {
-    const cls = classifyEvent({ type: 'speech', tick: 1, actor_name: 'me' }, 'me');
-    expect(cls.notable).toBe(true);
-  });
-
-  it('does not wake the monitor for private vote_cast or meeting_ended', () => {
-    expect(classifyEvent({ type: 'vote_cast', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
-    expect(classifyEvent({ type: 'meeting_ended', tick: 2 }, 'me').notable).toBe(false);
-  });
-
-  it('classifyEvent marks speech_skipped as notable', () => {
-    expect(
-      classifyEvent({ type: 'speech_skipped', tick: 1, actor_name: 'me' }, 'me').notable,
-    ).toBe(true);
-  });
-
-  it('classifyEvent ignores vote_speech but marks vote_speech_phase_ended as notable', () => {
-    expect(classifyEvent({ type: 'vote_speech', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
-    expect(classifyEvent({ type: 'vote_speech_phase_ended', tick: 2 }, 'me').notable).toBe(true);
-  });
-
-  it('eventKey ignores fields that are not part of the dedup key (e.g. ts)', () => {
-    const a = { type: 'speech_your_turn', tick: 5, actor_name: 'me' };
-    const b = { type: 'speech_your_turn', tick: 5, actor_name: 'me', ts: '2026-01-01T00:00:00Z' };
-    expect(eventKey(a)).toBe(eventKey(b));
-  });
-
-  it('eventKey differs across distinct logical events', () => {
-    const a = { type: 'speech_your_turn', tick: 5, actor_name: 'me' };
-    const b = { type: 'speech_your_turn', tick: 6, actor_name: 'me' };  // different tick
-    const c = { type: 'speech_your_turn', tick: 5, actor_name: 'them' }; // different actor
-    expect(eventKey(a)).not.toBe(eventKey(b));
-    expect(eventKey(a)).not.toBe(eventKey(c));
-  });
-
-  it('classifyEvent returns notable=false for non-notable types regardless of actor', () => {
-    expect(classifyEvent({ type: 'heartbeat', tick: 1, actor_name: 'them' }, 'me').notable).toBe(false);
-    expect(classifyEvent({ type: 'heartbeat', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
-  });
-});
-
-describe('sortEventsForMonitor', () => {
-  it('puts speech_your_turn before default-priority events', () => {
-    const sorted = sortEventsForMonitor([
-      { type: 'speech_skipped', tick: 1 },
-      { type: 'speech_your_turn', tick: 2 },
-    ]);
-    expect(sorted.map((e) => e.type)).toEqual(['speech_your_turn', 'speech_skipped']);
-  });
-
-  it('puts vote_phase_start before default-priority events', () => {
-    const sorted = sortEventsForMonitor([
-      { type: 'speech_skipped', tick: 1 },
-      { type: 'vote_phase_start', tick: 2 },
-    ]);
-    expect(sorted.map((e) => e.type)).toEqual(['vote_phase_start', 'speech_skipped']);
-  });
-
-  it('keeps original order for events with the same priority', () => {
-    const sorted = sortEventsForMonitor([
-      { type: 'speech', tick: 1 },
-      { type: 'speech_skipped', tick: 2 },
-      { type: 'vote_cast', tick: 3 },
-    ]);
-    expect(sorted.map((e) => e.type)).toEqual(['speech', 'speech_skipped', 'vote_cast']);
-  });
-});
-
-describe('watch defaults', () => {
-  it('uses 220ms as the default poll interval', () => {
-    expect(POLL_INTERVAL_MS).toBe(220);
-  });
-});
-
-describe('monitor payload compaction', () => {
-  it('routes role_assigned to a dedicated opening next step', () => {
-    expect(nextStepFor('role_assigned')).toMatch(/role/i);
-    expect(nextStepFor('role_assigned')).toMatch(/faction/i);
-  });
-
-  it('compacts ordinary lobster role_assigned without inventing extra task kind labels', () => {
-    const compact = compactEventForMonitor({
-      type: 'role_assigned',
-      tick: 1,
-      actor_name: 'me',
-      room: '厨房',
-      role: 'shrimp',
-      role_display_name: '普通虾',
-      faction: 'lobster',
-      role_description: '完成任务或投出所有蟹方。',
-      hint: 'long human hint',
-      assigned_tasks: [
-        { name: '修电线', room: '电气', x: 1, y: 2, task_note: 'long note', is_fake_shrimp: false },
-      ],
-      all_task_locations: [{ name: '修电线', room: '电气', x: 1, y: 2 }],
-    });
-
-    expect(compact).toEqual({
-      type: 'role_assigned',
-      tick: 1,
-      room: '厨房',
-      role: 'shrimp',
-      role_display: '普通虾',
-      faction: 'lobster',
-      win_condition: '完成任务或投出所有蟹方。',
-      tasks: [{ name: '修电线', room: '电气' }],
-      hint: 'You are 普通虾 (lobster). 完成任务或投出所有蟹方。 Announce your role, faction and win condition to your user.',
-    });
-  });
-
-  it('compacts all-fake neutral role_assigned into one top-level task kind', () => {
-    const compact = compactEventForMonitor({
-      type: 'role_assigned',
-      tick: 2,
-      room: '仓库',
-      role: 'octopus',
-      role_display_name: '章鱼',
-      faction: 'neutral',
-      role_description: '伪装成虾方并达成自己的胜利条件。',
-      fake_task_briefing: 'These are fake tasks.',
-      assigned_tasks: [
-        { name: '下载数据', room: '通讯', x: 3, y: 4, is_fake_shrimp: true },
-        { name: '清理垃圾', room: '餐厅', x: 5, y: 6, is_fake_shrimp: true },
-      ],
-    });
-
-    expect(compact).toEqual({
-      type: 'role_assigned',
-      tick: 2,
-      room: '仓库',
-      role: 'octopus',
-      role_display: '章鱼',
-      faction: 'neutral',
-      win_condition: '伪装成虾方并达成自己的胜利条件。',
-      task_kind: 'fake_shrimp',
-      task_note: 'Fake shrimp tasks: disguise only; no lobster progress.',
-      tasks: [
-        { name: '下载数据', room: '通讯' },
-        { name: '清理垃圾', room: '餐厅' },
-      ],
-      hint: 'You are 章鱼 (neutral). 伪装成虾方并达成自己的胜利条件。 These are fake tasks. Announce your role, faction and win condition to your user.',
-    });
-  });
-
-  it('keeps per-task kind labels for mixed crab role_assigned tasks', () => {
-    const compact = compactEventForMonitor({
-      type: 'role_assigned',
-      tick: 3,
-      room: '电气',
-      role: 'crab',
-      role_display_name: '蟹',
-      faction: 'crab',
-      role_description: '击杀虾方并避免被投出。',
-      fake_task_briefing: 'Fake task exists.',
-      assigned_tasks: [
-        { name: '破坏电力', room: '电气', x: 7, y: 8, is_fake_shrimp: false },
-        { name: '刷卡', room: '管理', x: 9, y: 10, is_fake_shrimp: true },
-      ],
-    });
-
-    expect(compact).toEqual({
-      type: 'role_assigned',
-      tick: 3,
-      room: '电气',
-      role: 'crab',
-      role_display: '蟹',
-      faction: 'crab',
-      win_condition: '击杀虾方并避免被投出。',
-      task_note: 'Fake shrimp tasks: disguise only; no lobster progress.',
-      tasks: [
-        { name: '破坏电力', room: '电气', kind: 'crab_sabotage' },
-        { name: '刷卡', room: '管理', kind: 'fake_shrimp' },
-      ],
-      hint: 'You are 蟹 (crab). 击杀虾方并避免被投出。 Fake task exists. Announce your role, faction and win condition to your user.',
-    });
-  });
-
-  it('removes room from meeting_briefing monitor events only', () => {
-    const compact = compactEventForMonitor({
-      type: 'meeting_briefing',
-      tick: 10,
-      room: '会议室',
-      caller: '红虾',
-      speech_order: ['红虾', '蓝虾'],
-    });
-
-    expect(compact).toEqual({
-      type: 'meeting_briefing',
-      tick: 10,
-      caller: '红虾',
-      speech_order: ['红虾', '蓝虾'],
-    });
-  });
-
-  it('rewrites corpse_spotted hint for monitor perspective', () => {
-    const compact = compactEventForMonitor({
-      type: 'corpse_spotted',
-      tick: 326,
-      room: 'Intel',
-      corpse_name: 'Garlic',
-      corpse_room: 'Intel',
-      hint: 'BODY FOUND: Garlic at (1, 2) in Intel.',
-    });
-
-    expect(compact).toMatchObject({
-      type: 'corpse_spotted',
-      tick: 326,
-      corpse_name: 'Garlic',
-      corpse_room: 'Intel',
-      hint: 'BODY FOUND: Garlic at (?, ?) in Intel. This is leverage soaked in blood — report before the killer rewrites the room.',
-    });
-  });
-
-  it('rewrites meeting_briefing hint for another caller', () => {
-    const compact = compactEventForMonitor({
-      type: 'meeting_briefing',
-      tick: 487,
-      room: 'Control',
-      meeting_caller_name: 'Drifter',
-      meeting_caller_seat: 4,
-      your_seat: 3,
-      reported_corpses: [{ name: 'Chef', seat: 9 }],
-      hint: 'Meeting started — seat 4 Drifter called this meeting.',
-    });
-
-    expect(compact).toMatchObject({
-      type: 'meeting_briefing',
-      tick: 487,
-      meeting_caller_name: 'Drifter',
-      reported_corpses: [{ name: 'Chef', seat: 9 }],
-      hint: 'Meeting started — seat 4 Drifter called this meeting after reporting the body of seat 9 Chef. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.',
-    });
-    expect(compact).not.toHaveProperty('room');
-  });
-
-  it('rewrites meeting_briefing hint when you are the caller', () => {
-    const compact = compactEventForMonitor({
-      type: 'meeting_briefing',
-      tick: 487,
-      meeting_caller_name: 'Player',
-      meeting_caller_seat: 3,
-      your_seat: 3,
-      reported_corpses: [{ name: 'Chef', seat: 9 }],
-      hint: 'Meeting started — seat 3 Player called this meeting.',
-    });
-
-    expect(compact.hint).toBe('Meeting started — seat 3 Player called this meeting after reporting the body of seat 9 Chef. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.');
-  });
-
-  it('compacts meeting summary and hard-overrides speech_your_turn fields', () => {
-    const compact = compactSummaryForMonitor({
-      phase: 'meeting',
-      you: {
-        name: '我',
-        seat: 1,
-        role: 'shrimp',
-        faction: 'lobster',
-        x: 11,
-        y: 12,
-        kill_cooldown_secs: 0,
-      },
-      game: { id: 'game-1', tick: 50 },
-      urgent: { meeting_started: true },
-      meeting: {
-        caller: '红虾',
-        sub_phase: 'speech',
-        current_speaker: '红虾',
-        is_my_turn: false,
-        alive_players: ['我', '红虾'],
-        speech_history: [{ speaker: '红虾', text: 'long speech' }],
-        votes_submitted: ['红虾'],
-      },
-      automation: { strategy: 'default', running: true },
-    }, ['speech_your_turn']);
-
-    expect(compact).toEqual({
-      phase: 'meeting',
-      you: { name: '我', role: 'shrimp', faction: 'lobster' },
-      game: { id: 'game-1', tick: 50 },
-      meeting: {
-        caller: '红虾',
-        sub_phase: 'speech',
-        alive_players: ['我', '红虾'],
-        current_speaker: '我',
-        is_my_turn: true,
-      },
-      automation: { strategy: 'default', running: true },
-    });
-  });
-
-  it('compacts vote-phase meeting summary into a submitted-vote count', () => {
-    const compact = compactSummaryForMonitor({
-      phase: 'meeting',
-      you: { name: '我', role: 'shrimp', faction: 'lobster' },
-      game: { id: 'game-1' },
-      meeting: {
-        caller: '红虾',
-        sub_phase: 'speech',
-        current_speaker: '我',
-        is_my_turn: true,
-        alive_players: ['我', '红虾', '蓝虾'],
-        votes_submitted: ['红虾', '蓝虾'],
-      },
-    }, ['vote_phase_start']);
-
-    expect(compact).toEqual({
-      phase: 'meeting',
-      you: { name: '我', role: 'shrimp', faction: 'lobster' },
-      game: { id: 'game-1' },
-      meeting: {
-        caller: '红虾',
-        sub_phase: 'vote',
-        alive_players: ['我', '红虾', '蓝虾'],
-        votes_submitted_count: 2,
-      },
-    });
-  });
-});
-
-import { mkdtempSync, writeFileSync, appendFileSync, unlinkSync, existsSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-
-function makeTmpFiles(opts?: { seedFeed?: boolean }) {
-  const dir = mkdtempSync(join(tmpdir(), 'watch-stream-'));
-  const feedPath = join(dir, 'feed.json');
-  const sessionPath = join(dir, 'session.jsonl');
-  writeFileSync(sessionPath, '');
-  if (opts?.seedFeed !== false) {
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }),
-    );
-  }
-  return { dir, feedPath, sessionPath };
-}
-
-describe('runStreaming — emission shape', () => {
-  it('emits one NDJSON line per notable event with required fields', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({
-        you: { name: 'me' },
-        meeting: { is_my_turn: false },
-        urgent: {},
-      }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-    });
-
-    appendFileSync(
-      sessionPath,
-      JSON.stringify({ type: 'killed', tick: 1, actor_name: 'a' }) + '\n',
-    );
-
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort();
-    await run;
-
-    expect(lines.length).toBeGreaterThanOrEqual(1);
-    for (const raw of lines) {
-      const obj = JSON.parse(raw);
-      expect(Array.isArray(obj.events)).toBe(true);
-      expect(Array.isArray(obj.messages)).toBe(true);
-      expect(obj).not.toHaveProperty('trigger');
-      expect(obj).not.toHaveProperty('triggers');
-      expect(obj).not.toHaveProperty('all_events');
-      expect(obj).not.toHaveProperty('summary');
-      expect(obj).not.toHaveProperty('next_step');
-      expect(obj).toHaveProperty('state');
-      expect(raw.endsWith('\n')).toBe(true);
-    }
-  });
-
-  it('emits vote_speech_phase_ended but ignores vote_speech', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({
-        you: { name: 'me' },
-        meeting: { is_my_turn: false },
-        urgent: {},
-      }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-    });
-
-    await new Promise((r) => setTimeout(r, 60));
-    appendFileSync(
-      sessionPath,
-      JSON.stringify({ type: 'vote_speech', tick: 1, actor_name: 'a', text: 'vote talk' }) + '\n'
-      + JSON.stringify({ type: 'vote_speech_phase_ended', tick: 2, hint: 'The vote speech window has closed.' }) + '\n',
-    );
-
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort();
-    await run;
-
-    expect(lines.length).toBe(1);
-    const obj = JSON.parse(lines[0]);
-    expect(obj.events).toEqual(['vote_speech_phase_ended']);
-    expect(obj.events).toHaveLength(1);
-    expect(obj.messages[0]).toContain('vote_speech_phase_ended');
-  });
-
-  it('expands nested new_events from action wrapper records', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({
-        you: { name: 'me' },
-        meeting: { is_my_turn: false },
-        urgent: {},
-      }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      delayableEventMs: { kill: 0 },
-    });
-
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(
-      sessionPath,
-      JSON.stringify({
-        type: 'auto',
-        action: 'kill',
-        result: {
-          ok: true,
-          new_events: [{ type: 'kill', tick: 42, target_name: 'target' }],
-        },
-      }) + '\n',
-    );
-
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort();
-    await run;
-
-    expect(lines.some((l) => JSON.parse(l).events?.includes('kill'))).toBe(true);
-  });
-
-  it('keeps reading after the .jsonl is truncated in place', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, meeting: { is_my_turn: false }, urgent: {} }),
-    );
-    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 1, actor_name: 'a_really_long_name' }) + '\n');
-
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-    });
-
-    // Wait for the initial event to be processed (and absorbed as backlog).
-    await new Promise((r) => setTimeout(r, 60));
-    const beforeTruncate = lines.length;
-
-    // Truncate the file in place (simulating runtime log rotation that keeps the inode).
-    writeFileSync(sessionPath, '');
-    // Append a fresh notable event after truncation.
-    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 100, actor_name: 'b' }) + '\n');
-
-    // Give the loop time to detect the truncation and re-read.
-    await new Promise((r) => setTimeout(r, 120));
-    ctrl.abort();
-    await run;
-
-    // The post-truncation event must produce a new line.
-    expect(lines.length).toBeGreaterThan(beforeTruncate);
-    expect(lines.some((l) => JSON.parse(l).events?.includes('killed'))).toBe(true);
-  });
-
-  it('throws WatchNotReadyError when feed.json never appears', async () => {
-    const { dir, sessionPath } = makeTmpFiles();
-    const lines: string[] = [];
-    await expect(
-      runStreaming({
-        feedPath: join(dir, 'no-feed.json'),
-        sessionPath,
-        stdout: (s) => lines.push(s),
-        pollIntervalMs: 20,
-        runtimeWaitMs: 80,
-      }),
-    ).rejects.toThrow(/not ready/i);
-    expect(lines.length).toBe(0);
-  });
-
-  it('waits for feed.json before tailing (parallel game start)', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles({ seedFeed: false });
-    if (existsSync(feedPath)) unlinkSync(feedPath);
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      runtimeWaitMs: 2000,
-    });
-    setTimeout(() => {
-      writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }));
-    }, 100);
-    await new Promise((r) => setTimeout(r, 250));
-    ctrl.abort();
-    await run;
-    expect(lines.length).toBeGreaterThanOrEqual(0);
-  });
-});
-
-
-describe('snapshotOnce', () => {
-  it('writes one NDJSON line with exit_reason=snapshot', () => {
-    const { feedPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
-    const lines: string[] = [];
-    snapshotOnce({ feedPath, stdout: (s) => lines.push(s) });
-    expect(lines.length).toBe(1);
-    const obj = JSON.parse(lines[0]);
-    expect(obj.events).toEqual(['snapshot']);
-    expect(obj.messages[0]).toContain('snapshot');
-    expect(obj).not.toHaveProperty('trigger');
-    expect(obj).not.toHaveProperty('triggers');
-    expect(obj).not.toHaveProperty('all_events');
-    expect(obj).not.toHaveProperty('summary');
-    expect(obj).toHaveProperty('state');
-  });
-
-  it('errors clearly if feed.json is missing', () => {
-    const { dir } = makeTmpFiles();
-    const lines: string[] = [];
-    expect(() =>
-      snapshotOnce({ feedPath: join(dir, 'nope.json'), stdout: (s) => lines.push(s) }),
-    ).toThrow(/game runtime is not running/);
-  });
-});
-
-describe('runStreaming — startup backlog', () => {
-  it('attaches caught_up to the first line; subsequent lines have no caught_up', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
-    for (let i = 0; i < 5; i++) {
-      appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: i, actor_name: 'p' + i }) + '\n');
-    }
-
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
-    await new Promise((r) => setTimeout(r, 60));
-
-    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 100, actor_name: 'late' }) + '\n');
-    await new Promise((r) => setTimeout(r, 60));
-
-    ctrl.abort(); await run;
-
-    expect(lines.length).toBeGreaterThanOrEqual(2);
-    const first = JSON.parse(lines[0]);
-    expect(first.events).toHaveLength(5);
-    expect(first.events.every((event: string) => event === 'killed')).toBe(true);
-    for (const raw of lines.slice(1)) {
-      expect(JSON.parse(raw)).not.toHaveProperty('caught_up');
-    }
-  });
-
-  it('emits attached + caught_up on the first line when re-attaching mid-game', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({
-        you: { name: 'me' },
-        meeting: { current_speaker: 'a', alive_players: ['a', 'me'], caller: 'a' },
-        urgent: { meeting_started: true },
-      }),
-    );
-    for (let i = 0; i < 3; i++) {
-      appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: i, actor_name: 'p' + i }) + '\n');
-    }
-
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort(); await run;
-
-    expect(lines.length).toBeGreaterThanOrEqual(1);
-    const first = JSON.parse(lines[0]);
-    expect(first.events).toEqual(['killed', 'killed', 'killed']);
-    expect(first).not.toHaveProperty('active_sticky_on_attach');
-  });
-});
-
-describe('runStreaming — game_over exits', () => {
-  it('returns from the loop after a game_over event', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
-    const lines: string[] = [];
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), pollIntervalMs: 20 });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'game_over', tick: 1 }) + '\n');
-    await Promise.race([run, new Promise((_, rej) => setTimeout(() => rej(new Error('did not exit')), 3000))]);
-    expect(lines.some((l) => JSON.parse(l).events?.includes('game_over'))).toBe(true);
-  });
-});
-
-describe('runStreaming — NDJSON discipline', () => {
-  it('every emitted line is JSON.parse-able', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: { is_my_turn: false }, urgent: {} }));
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
-    for (const t of ['killed', 'meeting_started', 'vote_phase_start']) {
-      appendFileSync(sessionPath, JSON.stringify({ type: t, tick: Date.now() }) + '\n');
-      await new Promise((r) => setTimeout(r, 40));
-    }
-    ctrl.abort(); await run;
-    for (const raw of lines) {
-      expect(() => JSON.parse(raw)).not.toThrow();
-    }
-  });
-});
-
-describe('runStreaming — matchmaking synthetic events', () => {
-  it('classifyEvent treats match_waiting / match_timeout as notable', () => {
-    expect(classifyEvent({ type: 'match_waiting', tick: 1, waited_secs: 0 }).notable).toBe(true);
-    expect(classifyEvent({ type: 'match_timeout', tick: 1, waited_secs: 600 }).notable).toBe(true);
-  });
-
-  it('emits lowercase exit_reason for each match_* event with a dedicated next_step', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ phase: 'matching', urgent: {}, meeting: null, you: { name: 'me' } }));
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'match_waiting', tick: 2, waited_secs: 0 }) + '\n');
-    await new Promise((r) => setTimeout(r, 60));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'match_timeout', tick: 3, waited_secs: 600 }) + '\n');
-    await new Promise((r) => setTimeout(r, 60));
-    ctrl.abort(); await run;
-
-    const eventNames = lines.flatMap((l) => JSON.parse(l).events);
-    expect(eventNames).toContain('match_waiting');
-    expect(eventNames).toContain('match_timeout');
-
-    const timeout = lines.map((l) => JSON.parse(l)).find((o) => o.events?.includes('match_timeout'));
-    expect(timeout.messages[0]).toContain('600');
-  });
-});
-
-describe('runStreaming — speech_your_turn fires as notable event', () => {
-  it('fires speech_your_turn as exit_reason when speech_your_turn event arrives', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(feedPath, JSON.stringify({ phase: 'meeting', urgent: {}, meeting: { current_speaker: 'other' }, you: { name: 'me' } }));
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'speech_your_turn', tick: 1, actor_name: 'me' }) + '\n');
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort(); await run;
-
-    const parsed = lines.map((l) => JSON.parse(l));
-    const myTurn = parsed.find((o) => o.events?.includes('speech_your_turn'));
-    expect(myTurn).toBeDefined();
-    expect(myTurn!.events).toContain('speech_your_turn');
-  });
-});
-
-describe('runStreaming — delay buffer', () => {
-  it('delays a delayable event (kill) and emits after the delay expires', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      delayableEventMs: { kill: 100 },
-    });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
-    await new Promise((r) => setTimeout(r, 50));
-    expect(lines.length).toBe(0);
-    await new Promise((r) => setTimeout(r, 100));
-    ctrl.abort(); await run;
-
-    const parsed = lines.map((l) => JSON.parse(l));
-    const killNotif = parsed.find((o) => o.events?.includes('kill'));
-    expect(killNotif).toBeDefined();
-  });
-
-  it('merges multiple events arriving during the delay window into one notification', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      delayableEventMs: { kill: 200, emergency_started: 200 },
-    });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
-    await new Promise((r) => setTimeout(r, 50));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'emergency_started', tick: 2 }) + '\n');
-    await new Promise((r) => setTimeout(r, 50));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'task_completed', tick: 3, task_name: 'wires' }) + '\n');
-    await new Promise((r) => setTimeout(r, 250));
-    ctrl.abort(); await run;
-
-    const parsed = lines.map((l) => JSON.parse(l));
-    const merged = parsed.find((o) => o.events?.includes('kill'));
-    expect(merged).toBeDefined();
-    expect(merged!.events).toContain('emergency_started');
-    expect(merged!.events).toContain('task_completed');
-    const notableLines = parsed.filter((o) => !o.events?.includes('heartbeat'));
-    expect(notableLines.length).toBe(1);
-  });
-
-  it('does not extend delay when a second delayable event arrives mid-delay', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      delayableEventMs: { kill: 150, emergency_started: 5000 },
-    });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
-    await new Promise((r) => setTimeout(r, 50));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'emergency_started', tick: 2 }) + '\n');
-    await new Promise((r) => setTimeout(r, 200));
-    ctrl.abort(); await run;
-
-    const parsed = lines.map((l) => JSON.parse(l));
-    const merged = parsed.find((o) => o.events?.includes('kill'));
-    expect(merged).toBeDefined();
-    expect(merged!.events).toContain('emergency_started');
-  });
-
-  it('non-delayable events fire immediately when no delay is active', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      delayableEventMs: { kill: 200 },
-    });
-    await new Promise((r) => setTimeout(r, 30));
-    appendFileSync(sessionPath, JSON.stringify({ type: 'task_completed', tick: 1, task_name: 'wires' }) + '\n');
-    await new Promise((r) => setTimeout(r, 80));
-    ctrl.abort(); await run;
-
-    const parsed = lines.map((l) => JSON.parse(l));
-    expect(parsed.some((o) => o.events?.includes('task_completed'))).toBe(true);
-  });
-});
-
-describe('readFeedSummary', () => {
-  it('includes automation strategy from the feed projection without exposing pid', () => {
-    const { feedPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({
-        phase: 'wandering',
-        you: { name: 'me' },
-        game: { id: 'game-1' },
-        urgent: {},
-        meeting: null,
-        automation: { strategy: 'default', running: true },
-      }),
-    );
-
-    const summary = readFeedSummary(feedPath);
-    expect(summary?.automation).toEqual({ strategy: 'default', running: true });
-    expect(summary?.automation).not.toHaveProperty('pid');
-    expect(summary?.automation).not.toHaveProperty('source');
-  });
-});
-
-describe('runStreaming startup monitor payload', () => {
-  it('emits game_start without initial_payload when requested by game start', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }),
-    );
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-      emitGameStart: true,
-    });
-
-    await new Promise((r) => setTimeout(r, 60));
-    ctrl.abort();
-    await run;
-
-    expect(lines.length).toBeGreaterThanOrEqual(1);
-    const first = JSON.parse(lines[0]);
-    expect(first.events).toEqual(['game_start']);
-    expect(first).not.toHaveProperty('initial_payload');
-    expect(first.messages[0]).toContain('game_start');
-  });
-
-  it('compacts role_assigned inside caught_up notable events', async () => {
-    const { feedPath, sessionPath } = makeTmpFiles();
-    writeFileSync(
-      feedPath,
-      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
-    );
-    appendFileSync(sessionPath, JSON.stringify({
-      type: 'role_assigned',
-      tick: 1,
-      room: '仓库',
-      role: 'octopus',
-      role_display_name: '章鱼',
-      faction: 'neutral',
-      role_description: '伪装成虾方并达成自己的胜利条件。',
-      fake_task_briefing: 'These are fake tasks.',
-      hint: 'long hint',
-      assigned_tasks: [
-        { name: '下载数据', room: '通讯', x: 3, y: 4, is_fake_shrimp: true },
-      ],
-    }) + '\n');
-    const lines: string[] = [];
-    const ctrl = new AbortController();
-
-    const run = runStreaming({
-      feedPath,
-      sessionPath,
-      stdout: (s) => lines.push(s),
-      signal: ctrl.signal,
-      pollIntervalMs: 20,
-    });
-
-    await new Promise((r) => setTimeout(r, 60));
-    ctrl.abort();
-    await run;
-
-    expect(lines.length).toBeGreaterThanOrEqual(1);
-    const first = JSON.parse(lines[0]);
-    expect(first.events).toEqual(['role_assigned']);
-    expect(first.messages[0]).toContain('role_assigned');
-    expect(first).not.toHaveProperty('caught_up');
-  });
-});
+import { describe, expect, it } from 'vitest';
+import {
+  classifyEvent,
+  compactEventForMonitor,
+  compactSummaryForMonitor,
+  DELAYABLE_EVENT_CONFIG,
+  eventKey,
+  MONITOR_EVENT_CONFIG,
+  NOTABLE_EVENT_TYPES,
+  nextStepFor,
+  POLL_INTERVAL_MS,
+  readFeedSummary,
+  runStreaming,
+  snapshotOnce,
+  sortEventsForMonitor,
+} from './watch.js';
+
+describe('classifyEvent + NOTABLE_EVENT_TYPES', () => {
+  it('NOTABLE_EVENT_TYPES contains the headline events', () => {
+    for (const t of [
+      'exile', 'speech_skipped', 'meeting_briefing',
+      'speech', 'vote_phase_start', 'game_over', 'user_left_game',
+      'speech_your_turn', 'vote_speech_phase_ended',
+      'crab_teammates', 'no_exile', 'game_started',
+    ]) {
+      expect(NOTABLE_EVENT_TYPES.has(t)).toBe(true);
+    }
+    expect(NOTABLE_EVENT_TYPES.has('vote_cast')).toBe(false);
+    expect(NOTABLE_EVENT_TYPES.has('meeting_ended')).toBe(false);
+  });
+
+  it('derives NOTABLE_EVENT_TYPES from MONITOR_EVENT_CONFIG', () => {
+    expect([...NOTABLE_EVENT_TYPES].sort()).toEqual(Object.keys(MONITOR_EVENT_CONFIG).sort());
+  });
+
+  it('registers monitor event priorities in the same config as notable events', () => {
+    expect(MONITOR_EVENT_CONFIG.speech_your_turn.priority).toBe(99);
+    expect(MONITOR_EVENT_CONFIG.vote_phase_start.priority).toBe(99);
+    expect(MONITOR_EVENT_CONFIG.killed.priority).toBe(99);
+    expect(MONITOR_EVENT_CONFIG.game_started.priority).toBe(50);
+    expect(MONITOR_EVENT_CONFIG.speech.priority).toBe(50);
+    expect(MONITOR_EVENT_CONFIG.vote_speech_phase_ended.priority).toBe(50);
+    expect(MONITOR_EVENT_CONFIG.crab_teammates.priority).toBe(50);
+    expect(MONITOR_EVENT_CONFIG.user_left_game.priority).toBe(50);
+    expect(MONITOR_EVENT_CONFIG.vote_speech).toBeUndefined();
+    expect(MONITOR_EVENT_CONFIG.vote_cast).toBeUndefined();
+    expect(MONITOR_EVENT_CONFIG.meeting_ended).toBeUndefined();
+  });
+
+  it('classifyEvent returns notable=true for known types', () => {
+    expect(classifyEvent({ type: 'killed', tick: 1 }).notable).toBe(true);
+  });
+
+  it('classifyEvent returns notable=false for unknown types', () => {
+    expect(classifyEvent({ type: 'heartbeat', tick: 1 }).notable).toBe(false);
+  });
+
+  it('DELAYABLE_EVENT_CONFIG contains the delayable events', () => {
+    for (const t of ['kill', 'emergency_started', 'corpse_spotted']) {
+      expect(DELAYABLE_EVENT_CONFIG[t]).toBeGreaterThan(0);
+    }
+  });
+
+  it('classifyEvent marks speech_your_turn as notable', () => {
+    expect(
+      classifyEvent({ type: 'speech_your_turn', tick: 1, actor_name: 'me' }, 'me').notable,
+    ).toBe(true);
+  });
+
+  it('classifyEvent marks speech as notable', () => {
+    const cls = classifyEvent({ type: 'speech', tick: 1, actor_name: 'me' }, 'me');
+    expect(cls.notable).toBe(true);
+  });
+
+  it('does not wake the monitor for private vote_cast or meeting_ended', () => {
+    expect(classifyEvent({ type: 'vote_cast', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
+    expect(classifyEvent({ type: 'meeting_ended', tick: 2 }, 'me').notable).toBe(false);
+  });
+
+  it('classifyEvent marks speech_skipped as notable', () => {
+    expect(
+      classifyEvent({ type: 'speech_skipped', tick: 1, actor_name: 'me' }, 'me').notable,
+    ).toBe(true);
+  });
+
+  it('classifyEvent ignores vote_speech but marks vote_speech_phase_ended as notable', () => {
+    expect(classifyEvent({ type: 'vote_speech', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
+    expect(classifyEvent({ type: 'vote_speech_phase_ended', tick: 2 }, 'me').notable).toBe(true);
+  });
+
+  it('eventKey ignores fields that are not part of the dedup key (e.g. ts)', () => {
+    const a = { type: 'speech_your_turn', tick: 5, actor_name: 'me' };
+    const b = { type: 'speech_your_turn', tick: 5, actor_name: 'me', ts: '2026-01-01T00:00:00Z' };
+    expect(eventKey(a)).toBe(eventKey(b));
+  });
+
+  it('eventKey differs across distinct logical events', () => {
+    const a = { type: 'speech_your_turn', tick: 5, actor_name: 'me' };
+    const b = { type: 'speech_your_turn', tick: 6, actor_name: 'me' };  // different tick
+    const c = { type: 'speech_your_turn', tick: 5, actor_name: 'them' }; // different actor
+    expect(eventKey(a)).not.toBe(eventKey(b));
+    expect(eventKey(a)).not.toBe(eventKey(c));
+  });
+
+  it('classifyEvent returns notable=false for non-notable types regardless of actor', () => {
+    expect(classifyEvent({ type: 'heartbeat', tick: 1, actor_name: 'them' }, 'me').notable).toBe(false);
+    expect(classifyEvent({ type: 'heartbeat', tick: 1, actor_name: 'me' }, 'me').notable).toBe(false);
+  });
+});
+
+describe('sortEventsForMonitor', () => {
+  it('puts speech_your_turn before default-priority events', () => {
+    const sorted = sortEventsForMonitor([
+      { type: 'speech_skipped', tick: 1 },
+      { type: 'speech_your_turn', tick: 2 },
+    ]);
+    expect(sorted.map((e) => e.type)).toEqual(['speech_your_turn', 'speech_skipped']);
+  });
+
+  it('puts vote_phase_start before default-priority events', () => {
+    const sorted = sortEventsForMonitor([
+      { type: 'speech_skipped', tick: 1 },
+      { type: 'vote_phase_start', tick: 2 },
+    ]);
+    expect(sorted.map((e) => e.type)).toEqual(['vote_phase_start', 'speech_skipped']);
+  });
+
+  it('keeps original order for events with the same priority', () => {
+    const sorted = sortEventsForMonitor([
+      { type: 'speech', tick: 1 },
+      { type: 'speech_skipped', tick: 2 },
+      { type: 'vote_cast', tick: 3 },
+    ]);
+    expect(sorted.map((e) => e.type)).toEqual(['speech', 'speech_skipped', 'vote_cast']);
+  });
+});
+
+describe('watch defaults', () => {
+  it('uses 220ms as the default poll interval', () => {
+    expect(POLL_INTERVAL_MS).toBe(220);
+  });
+});
+
+describe('monitor payload compaction', () => {
+  it('routes role_assigned to a dedicated opening next step', () => {
+    expect(nextStepFor('role_assigned')).toMatch(/role/i);
+    expect(nextStepFor('role_assigned')).toMatch(/faction/i);
+  });
+
+  it('routes game_started to the opening context lookup', () => {
+    expect(nextStepFor('game_started')).toContain('ccl events game_started');
+    expect(nextStepFor('game_started')).toContain('ccl events role_assigned');
+  });
+
+  it('compacts ordinary lobster role_assigned without inventing extra task kind labels', () => {
+    const compact = compactEventForMonitor({
+      type: 'role_assigned',
+      tick: 1,
+      actor_name: 'me',
+      room: '厨房',
+      role: 'shrimp',
+      role_display_name: '普通虾',
+      faction: 'lobster',
+      role_description: '完成任务或投出所有蟹方。',
+      hint: 'long human hint',
+      assigned_tasks: [
+        { name: '修电线', room: '电气', x: 1, y: 2, task_note: 'long note', is_fake_shrimp: false },
+      ],
+      all_task_locations: [{ name: '修电线', room: '电气', x: 1, y: 2 }],
+    });
+
+    expect(compact).toEqual({
+      type: 'role_assigned',
+      tick: 1,
+      room: '厨房',
+      role: 'shrimp',
+      role_display: '普通虾',
+      faction: 'lobster',
+      win_condition: '完成任务或投出所有蟹方。',
+      tasks: [{ name: '修电线', room: '电气' }],
+      hint: 'You are 普通虾 (lobster). 完成任务或投出所有蟹方。 Announce your role, faction and win condition to your user.',
+    });
+  });
+
+  it('compacts all-fake neutral role_assigned into one top-level task kind', () => {
+    const compact = compactEventForMonitor({
+      type: 'role_assigned',
+      tick: 2,
+      room: '仓库',
+      role: 'octopus',
+      role_display_name: '章鱼',
+      faction: 'neutral',
+      role_description: '伪装成虾方并达成自己的胜利条件。',
+      fake_task_briefing: 'These are fake tasks.',
+      assigned_tasks: [
+        { name: '下载数据', room: '通讯', x: 3, y: 4, is_fake_shrimp: true },
+        { name: '清理垃圾', room: '餐厅', x: 5, y: 6, is_fake_shrimp: true },
+      ],
+    });
+
+    expect(compact).toEqual({
+      type: 'role_assigned',
+      tick: 2,
+      room: '仓库',
+      role: 'octopus',
+      role_display: '章鱼',
+      faction: 'neutral',
+      win_condition: '伪装成虾方并达成自己的胜利条件。',
+      task_kind: 'fake_shrimp',
+      task_note: 'Fake shrimp tasks: disguise only; no lobster progress.',
+      tasks: [
+        { name: '下载数据', room: '通讯' },
+        { name: '清理垃圾', room: '餐厅' },
+      ],
+      hint: 'You are 章鱼 (neutral). 伪装成虾方并达成自己的胜利条件。 These are fake tasks. Announce your role, faction and win condition to your user.',
+    });
+  });
+
+  it('keeps per-task kind labels for mixed crab role_assigned tasks', () => {
+    const compact = compactEventForMonitor({
+      type: 'role_assigned',
+      tick: 3,
+      room: '电气',
+      role: 'crab',
+      role_display_name: '蟹',
+      faction: 'crab',
+      role_description: '击杀虾方并避免被投出。',
+      fake_task_briefing: 'Fake task exists.',
+      assigned_tasks: [
+        { name: '破坏电力', room: '电气', x: 7, y: 8, is_fake_shrimp: false },
+        { name: '刷卡', room: '管理', x: 9, y: 10, is_fake_shrimp: true },
+      ],
+    });
+
+    expect(compact).toEqual({
+      type: 'role_assigned',
+      tick: 3,
+      room: '电气',
+      role: 'crab',
+      role_display: '蟹',
+      faction: 'crab',
+      win_condition: '击杀虾方并避免被投出。',
+      task_note: 'Fake shrimp tasks: disguise only; no lobster progress.',
+      tasks: [
+        { name: '破坏电力', room: '电气', kind: 'crab_sabotage' },
+        { name: '刷卡', room: '管理', kind: 'fake_shrimp' },
+      ],
+      hint: 'You are 蟹 (crab). 击杀虾方并避免被投出。 Fake task exists. Announce your role, faction and win condition to your user.',
+    });
+  });
+
+  it('removes room from meeting_briefing monitor events only', () => {
+    const compact = compactEventForMonitor({
+      type: 'meeting_briefing',
+      tick: 10,
+      room: '会议室',
+      caller: '红虾',
+      speech_order: ['红虾', '蓝虾'],
+    });
+
+    expect(compact).toEqual({
+      type: 'meeting_briefing',
+      tick: 10,
+      caller: '红虾',
+      speech_order: ['红虾', '蓝虾'],
+    });
+  });
+
+  it('rewrites corpse_spotted hint for monitor perspective', () => {
+    const compact = compactEventForMonitor({
+      type: 'corpse_spotted',
+      tick: 326,
+      room: 'Intel',
+      corpse_name: 'Garlic',
+      corpse_room: 'Intel',
+      hint: 'BODY FOUND: Garlic at (1, 2) in Intel.',
+    });
+
+    expect(compact).toMatchObject({
+      type: 'corpse_spotted',
+      tick: 326,
+      corpse_name: 'Garlic',
+      corpse_room: 'Intel',
+      hint: 'BODY FOUND: Garlic at (?, ?) in Intel. This is leverage soaked in blood — report before the killer rewrites the room.',
+    });
+  });
+
+  it('rewrites meeting_briefing hint for another caller', () => {
+    const compact = compactEventForMonitor({
+      type: 'meeting_briefing',
+      tick: 487,
+      room: 'Control',
+      meeting_caller_name: 'Drifter',
+      meeting_caller_seat: 4,
+      your_seat: 3,
+      reported_corpses: [{ name: 'Chef', seat: 9 }],
+      hint: 'Meeting started — seat 4 Drifter called this meeting.',
+    });
+
+    expect(compact).toMatchObject({
+      type: 'meeting_briefing',
+      tick: 487,
+      meeting_caller_name: 'Drifter',
+      reported_corpses: [{ name: 'Chef', seat: 9 }],
+      hint: 'Meeting started — seat 4 Drifter called this meeting after reporting the body of seat 9 Chef. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.',
+    });
+    expect(compact).not.toHaveProperty('room');
+  });
+
+  it('rewrites meeting_briefing hint when you are the caller', () => {
+    const compact = compactEventForMonitor({
+      type: 'meeting_briefing',
+      tick: 487,
+      meeting_caller_name: 'Player',
+      meeting_caller_seat: 3,
+      your_seat: 3,
+      reported_corpses: [{ name: 'Chef', seat: 9 }],
+      hint: 'Meeting started — seat 3 Player called this meeting.',
+    });
+
+    expect(compact.hint).toBe('Meeting started — seat 3 Player called this meeting after reporting the body of seat 9 Chef. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.');
+  });
+
+  it('compacts meeting summary and hard-overrides speech_your_turn fields', () => {
+    const compact = compactSummaryForMonitor({
+      phase: 'meeting',
+      you: {
+        name: '我',
+        seat: 1,
+        role: 'shrimp',
+        faction: 'lobster',
+        x: 11,
+        y: 12,
+        kill_cooldown_secs: 0,
+      },
+      game: { id: 'game-1', tick: 50 },
+      urgent: { meeting_started: true },
+      meeting: {
+        caller: '红虾',
+        sub_phase: 'speech',
+        current_speaker: '红虾',
+        is_my_turn: false,
+        alive_players: ['我', '红虾'],
+        speech_history: [{ speaker: '红虾', text: 'long speech' }],
+        votes_submitted: ['红虾'],
+      },
+      automation: { strategy: 'default', running: true },
+    }, ['speech_your_turn']);
+
+    expect(compact).toEqual({
+      phase: 'meeting',
+      you: { name: '我', role: 'shrimp', faction: 'lobster' },
+      game: { id: 'game-1', tick: 50 },
+      meeting: {
+        caller: '红虾',
+        sub_phase: 'speech',
+        alive_players: ['我', '红虾'],
+        current_speaker: '我',
+        is_my_turn: true,
+      },
+      automation: { strategy: 'default', running: true },
+    });
+  });
+
+  it('compacts vote-phase meeting summary into a submitted-vote count', () => {
+    const compact = compactSummaryForMonitor({
+      phase: 'meeting',
+      you: { name: '我', role: 'shrimp', faction: 'lobster' },
+      game: { id: 'game-1' },
+      meeting: {
+        caller: '红虾',
+        sub_phase: 'speech',
+        current_speaker: '我',
+        is_my_turn: true,
+        alive_players: ['我', '红虾', '蓝虾'],
+        votes_submitted: ['红虾', '蓝虾'],
+      },
+    }, ['vote_phase_start']);
+
+    expect(compact).toEqual({
+      phase: 'meeting',
+      you: { name: '我', role: 'shrimp', faction: 'lobster' },
+      game: { id: 'game-1' },
+      meeting: {
+        caller: '红虾',
+        sub_phase: 'vote',
+        alive_players: ['我', '红虾', '蓝虾'],
+        votes_submitted_count: 2,
+      },
+    });
+  });
+});
+
+import { mkdtempSync, writeFileSync, appendFileSync, unlinkSync, existsSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+
+function makeTmpFiles(opts?: { seedFeed?: boolean }) {
+  const dir = mkdtempSync(join(tmpdir(), 'watch-stream-'));
+  const feedPath = join(dir, 'feed.json');
+  const sessionPath = join(dir, 'session.jsonl');
+  writeFileSync(sessionPath, '');
+  if (opts?.seedFeed !== false) {
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }),
+    );
+  }
+  return { dir, feedPath, sessionPath };
+}
+
+describe('runStreaming — emission shape', () => {
+  it('emits one NDJSON line per notable event with required fields', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({
+        you: { name: 'me' },
+        meeting: { is_my_turn: false },
+        urgent: {},
+      }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+    });
+
+    appendFileSync(
+      sessionPath,
+      JSON.stringify({ type: 'killed', tick: 1, actor_name: 'a' }) + '\n',
+    );
+
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort();
+    await run;
+
+    expect(lines.length).toBeGreaterThanOrEqual(1);
+    for (const raw of lines) {
+      const obj = JSON.parse(raw);
+      expect(Array.isArray(obj.events)).toBe(true);
+      expect(Array.isArray(obj.messages)).toBe(true);
+      expect(obj).not.toHaveProperty('trigger');
+      expect(obj).not.toHaveProperty('triggers');
+      expect(obj).not.toHaveProperty('all_events');
+      expect(obj).not.toHaveProperty('summary');
+      expect(obj).not.toHaveProperty('next_step');
+      expect(obj).toHaveProperty('state');
+      expect(raw.endsWith('\n')).toBe(true);
+    }
+  });
+
+  it('emits vote_speech_phase_ended but ignores vote_speech', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({
+        you: { name: 'me' },
+        meeting: { is_my_turn: false },
+        urgent: {},
+      }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+    });
+
+    await new Promise((r) => setTimeout(r, 60));
+    appendFileSync(
+      sessionPath,
+      JSON.stringify({ type: 'vote_speech', tick: 1, actor_name: 'a', text: 'vote talk' }) + '\n'
+      + JSON.stringify({ type: 'vote_speech_phase_ended', tick: 2, hint: 'The vote speech window has closed.' }) + '\n',
+    );
+
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort();
+    await run;
+
+    expect(lines.length).toBe(1);
+    const obj = JSON.parse(lines[0]);
+    expect(obj.events).toEqual(['vote_speech_phase_ended']);
+    expect(obj.events).toHaveLength(1);
+    expect(obj.messages[0]).toContain('vote_speech_phase_ended');
+  });
+
+  it('expands nested new_events from action wrapper records', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({
+        you: { name: 'me' },
+        meeting: { is_my_turn: false },
+        urgent: {},
+      }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      delayableEventMs: { kill: 0 },
+    });
+
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(
+      sessionPath,
+      JSON.stringify({
+        type: 'auto',
+        action: 'kill',
+        result: {
+          ok: true,
+          new_events: [{ type: 'kill', tick: 42, target_name: 'target' }],
+        },
+      }) + '\n',
+    );
+
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort();
+    await run;
+
+    expect(lines.some((l) => JSON.parse(l).events?.includes('kill'))).toBe(true);
+  });
+
+  it('keeps reading after the .jsonl is truncated in place', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, meeting: { is_my_turn: false }, urgent: {} }),
+    );
+    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 1, actor_name: 'a_really_long_name' }) + '\n');
+
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+    });
+
+    // Wait for the initial event to be processed (and absorbed as backlog).
+    await new Promise((r) => setTimeout(r, 60));
+    const beforeTruncate = lines.length;
+
+    // Truncate the file in place (simulating runtime log rotation that keeps the inode).
+    writeFileSync(sessionPath, '');
+    // Append a fresh notable event after truncation.
+    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 100, actor_name: 'b' }) + '\n');
+
+    // Give the loop time to detect the truncation and re-read.
+    await new Promise((r) => setTimeout(r, 120));
+    ctrl.abort();
+    await run;
+
+    // The post-truncation event must produce a new line.
+    expect(lines.length).toBeGreaterThan(beforeTruncate);
+    expect(lines.some((l) => JSON.parse(l).events?.includes('killed'))).toBe(true);
+  });
+
+  it('throws WatchNotReadyError when feed.json never appears', async () => {
+    const { dir, sessionPath } = makeTmpFiles();
+    const lines: string[] = [];
+    await expect(
+      runStreaming({
+        feedPath: join(dir, 'no-feed.json'),
+        sessionPath,
+        stdout: (s) => lines.push(s),
+        pollIntervalMs: 20,
+        runtimeWaitMs: 80,
+      }),
+    ).rejects.toThrow(/not ready/i);
+    expect(lines.length).toBe(0);
+  });
+
+  it('waits for feed.json before tailing (parallel game start)', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles({ seedFeed: false });
+    if (existsSync(feedPath)) unlinkSync(feedPath);
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      runtimeWaitMs: 2000,
+    });
+    setTimeout(() => {
+      writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }));
+    }, 100);
+    await new Promise((r) => setTimeout(r, 250));
+    ctrl.abort();
+    await run;
+    expect(lines.length).toBeGreaterThanOrEqual(0);
+  });
+});
+
+
+describe('snapshotOnce', () => {
+  it('writes one NDJSON line with exit_reason=snapshot', () => {
+    const { feedPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
+    const lines: string[] = [];
+    snapshotOnce({ feedPath, stdout: (s) => lines.push(s) });
+    expect(lines.length).toBe(1);
+    const obj = JSON.parse(lines[0]);
+    expect(obj.events).toEqual(['snapshot']);
+    expect(obj.messages[0]).toContain('snapshot');
+    expect(obj).not.toHaveProperty('trigger');
+    expect(obj).not.toHaveProperty('triggers');
+    expect(obj).not.toHaveProperty('all_events');
+    expect(obj).not.toHaveProperty('summary');
+    expect(obj).toHaveProperty('state');
+  });
+
+  it('errors clearly if feed.json is missing', () => {
+    const { dir } = makeTmpFiles();
+    const lines: string[] = [];
+    expect(() =>
+      snapshotOnce({ feedPath: join(dir, 'nope.json'), stdout: (s) => lines.push(s) }),
+    ).toThrow(/game runtime is not running/);
+  });
+});
+
+describe('runStreaming — startup backlog', () => {
+  it('attaches caught_up to the first line; subsequent lines have no caught_up', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
+    for (let i = 0; i < 5; i++) {
+      appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: i, actor_name: 'p' + i }) + '\n');
+    }
+
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 60));
+
+    appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: 100, actor_name: 'late' }) + '\n');
+    await new Promise((r) => setTimeout(r, 60));
+
+    ctrl.abort(); await run;
+
+    expect(lines.length).toBeGreaterThanOrEqual(2);
+    const first = JSON.parse(lines[0]);
+    expect(first.events).toHaveLength(5);
+    expect(first.events.every((event: string) => event === 'killed')).toBe(true);
+    for (const raw of lines.slice(1)) {
+      expect(JSON.parse(raw)).not.toHaveProperty('caught_up');
+    }
+  });
+
+  it('emits attached + caught_up on the first line when re-attaching mid-game', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({
+        you: { name: 'me' },
+        meeting: { current_speaker: 'a', alive_players: ['a', 'me'], caller: 'a' },
+        urgent: { meeting_started: true },
+      }),
+    );
+    for (let i = 0; i < 3; i++) {
+      appendFileSync(sessionPath, JSON.stringify({ type: 'killed', tick: i, actor_name: 'p' + i }) + '\n');
+    }
+
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort(); await run;
+
+    expect(lines.length).toBeGreaterThanOrEqual(1);
+    const first = JSON.parse(lines[0]);
+    expect(first.events).toEqual(['killed', 'killed', 'killed']);
+    expect(first).not.toHaveProperty('active_sticky_on_attach');
+  });
+});
+
+describe('runStreaming — game_over exits', () => {
+  it('returns from the loop after a game_over event', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: {}, urgent: {} }));
+    const lines: string[] = [];
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'game_over', tick: 1 }) + '\n');
+    await Promise.race([run, new Promise((_, rej) => setTimeout(() => rej(new Error('did not exit')), 3000))]);
+    expect(lines.some((l) => JSON.parse(l).events?.includes('game_over'))).toBe(true);
+  });
+
+  it('returns from the loop after a user_left_game event', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ phase: 'user_left_game', you: { name: 'me' }, meeting: {}, urgent: {} }));
+    const lines: string[] = [];
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'user_left_game', close_code: 1000, close_reason: 'Left game' }) + '\n');
+    await Promise.race([run, new Promise((_, rej) => setTimeout(() => rej(new Error('did not exit')), 3000))]);
+
+    const notice = lines.map((l) => JSON.parse(l)).find((line) => line.events?.includes('user_left_game'));
+    expect(notice).toBeTruthy();
+    expect(notice.messages.some((message: string) => message.includes('The user left the game from the web page. This match has ended; stop playing and do not restart unless the user asks.'))).toBe(true);
+    expect(notice.state).toContain('user_left_game');
+  });
+});
+
+describe('runStreaming — NDJSON discipline', () => {
+  it('every emitted line is JSON.parse-able', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ you: { name: 'me' }, meeting: { is_my_turn: false }, urgent: {} }));
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
+    for (const t of ['killed', 'meeting_started', 'vote_phase_start']) {
+      appendFileSync(sessionPath, JSON.stringify({ type: t, tick: Date.now() }) + '\n');
+      await new Promise((r) => setTimeout(r, 40));
+    }
+    ctrl.abort(); await run;
+    for (const raw of lines) {
+      expect(() => JSON.parse(raw)).not.toThrow();
+    }
+  });
+});
+
+describe('runStreaming — matchmaking synthetic events', () => {
+  it('classifyEvent treats match_waiting / match_timeout as notable', () => {
+    expect(classifyEvent({ type: 'match_waiting', tick: 1, waited_secs: 0 }).notable).toBe(true);
+    expect(classifyEvent({ type: 'match_timeout', tick: 1, waited_secs: 600 }).notable).toBe(true);
+  });
+
+  it('emits lowercase exit_reason for each match_* event with a dedicated next_step', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ phase: 'matching', urgent: {}, meeting: null, you: { name: 'me' } }));
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'match_waiting', tick: 2, waited_secs: 0 }) + '\n');
+    await new Promise((r) => setTimeout(r, 60));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'match_timeout', tick: 3, waited_secs: 600 }) + '\n');
+    await new Promise((r) => setTimeout(r, 60));
+    ctrl.abort(); await run;
+
+    const eventNames = lines.flatMap((l) => JSON.parse(l).events);
+    expect(eventNames).toContain('match_waiting');
+    expect(eventNames).toContain('match_timeout');
+
+    const timeout = lines.map((l) => JSON.parse(l)).find((o) => o.events?.includes('match_timeout'));
+    expect(timeout.messages[0]).toContain('600');
+  });
+});
+
+describe('runStreaming — speech_your_turn fires as notable event', () => {
+  it('fires speech_your_turn as exit_reason when speech_your_turn event arrives', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(feedPath, JSON.stringify({ phase: 'meeting', urgent: {}, meeting: { current_speaker: 'other' }, you: { name: 'me' } }));
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({ feedPath, sessionPath, stdout: (s) => lines.push(s), signal: ctrl.signal, pollIntervalMs: 20 });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'speech_your_turn', tick: 1, actor_name: 'me' }) + '\n');
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort(); await run;
+
+    const parsed = lines.map((l) => JSON.parse(l));
+    const myTurn = parsed.find((o) => o.events?.includes('speech_your_turn'));
+    expect(myTurn).toBeDefined();
+    expect(myTurn!.events).toContain('speech_your_turn');
+  });
+});
+
+describe('runStreaming — delay buffer', () => {
+  it('delays a delayable event (kill) and emits after the delay expires', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      delayableEventMs: { kill: 100 },
+    });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
+    await new Promise((r) => setTimeout(r, 50));
+    expect(lines.length).toBe(0);
+    await new Promise((r) => setTimeout(r, 100));
+    ctrl.abort(); await run;
+
+    const parsed = lines.map((l) => JSON.parse(l));
+    const killNotif = parsed.find((o) => o.events?.includes('kill'));
+    expect(killNotif).toBeDefined();
+  });
+
+  it('merges multiple events arriving during the delay window into one notification', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      delayableEventMs: { kill: 200, emergency_started: 200 },
+    });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
+    await new Promise((r) => setTimeout(r, 50));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'emergency_started', tick: 2 }) + '\n');
+    await new Promise((r) => setTimeout(r, 50));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'task_completed', tick: 3, task_name: 'wires' }) + '\n');
+    await new Promise((r) => setTimeout(r, 250));
+    ctrl.abort(); await run;
+
+    const parsed = lines.map((l) => JSON.parse(l));
+    const merged = parsed.find((o) => o.events?.includes('kill'));
+    expect(merged).toBeDefined();
+    expect(merged!.events).toContain('emergency_started');
+    expect(merged!.events).toContain('task_completed');
+    const notableLines = parsed.filter((o) => !o.events?.includes('heartbeat'));
+    expect(notableLines.length).toBe(1);
+  });
+
+  it('does not extend delay when a second delayable event arrives mid-delay', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      delayableEventMs: { kill: 150, emergency_started: 5000 },
+    });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'kill', tick: 1, actor_name: '蟹A', target_name: '虾B' }) + '\n');
+    await new Promise((r) => setTimeout(r, 50));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'emergency_started', tick: 2 }) + '\n');
+    await new Promise((r) => setTimeout(r, 200));
+    ctrl.abort(); await run;
+
+    const parsed = lines.map((l) => JSON.parse(l));
+    const merged = parsed.find((o) => o.events?.includes('kill'));
+    expect(merged).toBeDefined();
+    expect(merged!.events).toContain('emergency_started');
+  });
+
+  it('non-delayable events fire immediately when no delay is active', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      delayableEventMs: { kill: 200 },
+    });
+    await new Promise((r) => setTimeout(r, 30));
+    appendFileSync(sessionPath, JSON.stringify({ type: 'task_completed', tick: 1, task_name: 'wires' }) + '\n');
+    await new Promise((r) => setTimeout(r, 80));
+    ctrl.abort(); await run;
+
+    const parsed = lines.map((l) => JSON.parse(l));
+    expect(parsed.some((o) => o.events?.includes('task_completed'))).toBe(true);
+  });
+});
+
+describe('readFeedSummary', () => {
+  it('includes automation strategy from the feed projection without exposing pid', () => {
+    const { feedPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({
+        phase: 'wandering',
+        you: { name: 'me' },
+        game: { id: 'game-1' },
+        urgent: {},
+        meeting: null,
+        automation: { strategy: 'default', running: true },
+      }),
+    );
+
+    const summary = readFeedSummary(feedPath);
+    expect(summary?.automation).toEqual({ strategy: 'default', running: true });
+    expect(summary?.automation).not.toHaveProperty('pid');
+    expect(summary?.automation).not.toHaveProperty('source');
+  });
+});
+
+describe('runStreaming startup monitor payload', () => {
+  it('emits game_start without initial_payload when requested by game start', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'lobby', urgent: {}, meeting: null }),
+    );
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+      emitGameStart: true,
+    });
+
+    await new Promise((r) => setTimeout(r, 60));
+    ctrl.abort();
+    await run;
+
+    expect(lines.length).toBeGreaterThanOrEqual(1);
+    const first = JSON.parse(lines[0]);
+    expect(first.events).toEqual(['game_start']);
+    expect(first).not.toHaveProperty('initial_payload');
+    expect(first.messages[0]).toContain('game_start');
+  });
+
+  it('compacts role_assigned inside caught_up notable events', async () => {
+    const { feedPath, sessionPath } = makeTmpFiles();
+    writeFileSync(
+      feedPath,
+      JSON.stringify({ you: { name: 'me' }, phase: 'wandering', urgent: {}, meeting: null }),
+    );
+    appendFileSync(sessionPath, JSON.stringify({
+      type: 'role_assigned',
+      tick: 1,
+      room: '仓库',
+      role: 'octopus',
+      role_display_name: '章鱼',
+      faction: 'neutral',
+      role_description: '伪装成虾方并达成自己的胜利条件。',
+      fake_task_briefing: 'These are fake tasks.',
+      hint: 'long hint',
+      assigned_tasks: [
+        { name: '下载数据', room: '通讯', x: 3, y: 4, is_fake_shrimp: true },
+      ],
+    }) + '\n');
+    const lines: string[] = [];
+    const ctrl = new AbortController();
+
+    const run = runStreaming({
+      feedPath,
+      sessionPath,
+      stdout: (s) => lines.push(s),
+      signal: ctrl.signal,
+      pollIntervalMs: 20,
+    });
+
+    await new Promise((r) => setTimeout(r, 60));
+    ctrl.abort();
+    await run;
+
+    expect(lines.length).toBeGreaterThanOrEqual(1);
+    const first = JSON.parse(lines[0]);
+    expect(first.events).toEqual(['role_assigned']);
+    expect(first.messages[0]).toContain('role_assigned');
+    expect(first).not.toHaveProperty('caught_up');
+  });
+});