@myclaw163/clawclaw-cli 0.6.71 → 0.6.76

package/src/pipeline/event-store.ts

@@ -1,193 +1,193 @@
-import { appendFileSync, readFileSync, existsSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
-import { dirname, join, basename } from 'path';
-import { AuthStore } from '../lib/auth.js';
-import { getProfileGamesDir } from '../lib/init-command.js';
-
-export const CCL_EVENTS_CURSOR_TYPE = '_ccl_events_cursor';
-export const CCL_EVENTS_CURSOR_NAME = 'agent_read';
-
-interface GameSessionFile {
-  path: string;
-  sessionId: string;
-  mtimeMs: number;
-}
-
-export interface EventRecord {
-  line: number;
-  event: Record<string, any>;
-}
-
-export interface EventsCursorRecord {
-  type: typeof CCL_EVENTS_CURSOR_TYPE;
-  cursor: typeof CCL_EVENTS_CURSOR_NAME;
-  line: number;
-  ts: string;
-}
-
-export function isLocalControlEvent(event: any): boolean {
-  return !!(
-    event
-    && typeof event === 'object'
-    && typeof event.type === 'string'
-    && event.type.startsWith('_ccl_')
-  );
-}
-
-export function extractNewEvents(source: any): Record<string, any>[] {
-  const candidates = [
-    source,
-    source?.new_events,
-    source?.data?.new_events,
-    source?.result?.new_events,
-    source?.result?.data?.new_events,
-  ];
-
-  for (const candidate of candidates) {
-    if (Array.isArray(candidate)) {
-      return candidate.filter((evt) => evt && typeof evt === 'object');
-    }
-  }
-
-  return [];
-}
-
-export class EventStore {
-  constructor(private filePath: string) {}
-
-  get path(): string {
-    return this.filePath;
-  }
-
-  static forActiveAccount(): EventStore {
-    return EventStore.forLatestGame();
-  }
-
-  static forLatestGame(): EventStore {
-    const store = new AuthStore();
-    const profile = store.getActive();
-    if (!profile) throw new Error('Not logged in.');
-
-    const latest = EventStore.latestSessionFile(getProfileGamesDir(profile));
-    if (!latest) {
-      throw new Error('No game events found. Join a game first.');
-    }
-
-    return new EventStore(latest.path);
-  }
-
-  /** Returns the path to the latest session jsonl, or null if none exists. */
-  static latestSessionPath(): string | null {
-    const store = new AuthStore();
-    const profile = store.getActive();
-    if (!profile) return null;
-    return EventStore.latestSessionFile(getProfileGamesDir(profile))?.path ?? null;
-  }
-
-  static createSessionForActiveAccount(sessionId = EventStore.createSessionId()): EventStore {
-    const store = new AuthStore();
-    const profile = store.getActive();
-    if (!profile) throw new Error('Not logged in.');
-
-    const dir = getProfileGamesDir(profile);
-    mkdirSync(dir, { recursive: true });
-    const filePath = join(dir, `${sessionId}.jsonl`);
-    if (!existsSync(filePath)) writeFileSync(filePath, '');
-    return new EventStore(filePath);
-  }
-
-  append(event: Record<string, any>): void {
-    mkdirSync(dirname(this.filePath), { recursive: true });
-    const line = JSON.stringify(event) + '\n';
-    appendFileSync(this.filePath, line);
-  }
-
-  appendNewEvents(events: any): void {
-    const extracted = extractNewEvents(events);
-    if (extracted.length === 0) return;
-    for (const evt of extracted) {
-      this.append(evt);
-    }
-  }
-
-  records(): EventRecord[] {
-    if (!existsSync(this.filePath)) return [];
-    const content = readFileSync(this.filePath, 'utf8');
-    if (!content.trim()) return [];
-    const records: EventRecord[] = [];
-    const lines = content.split('\n');
-    for (let i = 0; i < lines.length; i += 1) {
-      const line = lines[i].trim();
-      if (!line) continue;
-      try {
-        const event = JSON.parse(line);
-        if (event && typeof event === 'object') {
-          records.push({ line: i + 1, event });
-        }
-      } catch {}
-    }
-    return records;
-  }
-
-  eventRecords(): EventRecord[] {
-    return this.records().filter((record) => !isLocalControlEvent(record.event));
-  }
-
-  readEventsCursor(): number {
-    let cursor = 0;
-    for (const record of this.records()) {
-      const event = record.event;
-      if (
-        event.type === CCL_EVENTS_CURSOR_TYPE
-        && event.cursor === CCL_EVENTS_CURSOR_NAME
-        && typeof event.line === 'number'
-        && Number.isFinite(event.line)
-      ) {
-        cursor = event.line;
-      }
-    }
-    return cursor;
-  }
-
-  appendEventsCursor(line: number): void {
-    if (!Number.isFinite(line) || line <= 0) return;
-    const event: EventsCursorRecord = {
-      type: CCL_EVENTS_CURSOR_TYPE,
-      cursor: CCL_EVENTS_CURSOR_NAME,
-      line,
-      ts: new Date().toISOString(),
-    };
-    this.append(event);
-  }
-
-  tail(n: number): Record<string, any>[] {
-    return this.eventRecords().slice(-n).map((record) => record.event);
-  }
-
-  all(): Record<string, any>[] {
-    return this.eventRecords().map((record) => record.event);
-  }
-
-  clear(): void {
-    writeFileSync(this.filePath, '');
-  }
-
-  private static createSessionId(): string {
-    const id = new Date().toISOString();
-    return process.platform === 'win32' ? id.replace(/:/g, '_') : id;
-  }
-
-  private static latestSessionFile(dir: string): GameSessionFile | null {
-    if (!existsSync(dir)) return null;
-
-    const files = readdirSync(dir)
-      .filter(name => name.endsWith('.jsonl') && !name.endsWith('.raw-ws.jsonl') && !name.startsWith('index.'))
-      .map(name => {
-        const path = join(dir, name);
-        const stat = statSync(path);
-        return { path, sessionId: basename(name, '.jsonl'), mtimeMs: stat.mtimeMs };
-      })
-      .sort((a, b) => b.sessionId.localeCompare(a.sessionId) || b.mtimeMs - a.mtimeMs);
-
-    return files[0] ?? null;
-  }
-}
+import { appendFileSync, readFileSync, existsSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { dirname, join, basename } from 'path';
+import { AuthStore } from '../lib/auth.js';
+import { getProfileGamesDir } from '../lib/init-command.js';
+
+export const CCL_EVENTS_CURSOR_TYPE = '_ccl_events_cursor';
+export const CCL_EVENTS_CURSOR_NAME = 'agent_read';
+
+interface GameSessionFile {
+  path: string;
+  sessionId: string;
+  mtimeMs: number;
+}
+
+export interface EventRecord {
+  line: number;
+  event: Record<string, any>;
+}
+
+export interface EventsCursorRecord {
+  type: typeof CCL_EVENTS_CURSOR_TYPE;
+  cursor: typeof CCL_EVENTS_CURSOR_NAME;
+  line: number;
+  ts: string;
+}
+
+export function isLocalControlEvent(event: any): boolean {
+  return !!(
+    event
+    && typeof event === 'object'
+    && typeof event.type === 'string'
+    && event.type.startsWith('_ccl_')
+  );
+}
+
+export function extractNewEvents(source: any): Record<string, any>[] {
+  const candidates = [
+    source,
+    source?.new_events,
+    source?.data?.new_events,
+    source?.result?.new_events,
+    source?.result?.data?.new_events,
+  ];
+
+  for (const candidate of candidates) {
+    if (Array.isArray(candidate)) {
+      return candidate.filter((evt) => evt && typeof evt === 'object');
+    }
+  }
+
+  return [];
+}
+
+export class EventStore {
+  constructor(private filePath: string) {}
+
+  get path(): string {
+    return this.filePath;
+  }
+
+  static forActiveAccount(): EventStore {
+    return EventStore.forLatestGame();
+  }
+
+  static forLatestGame(): EventStore {
+    const store = new AuthStore();
+    const profile = store.getActive();
+    if (!profile) throw new Error('Not logged in.');
+
+    const latest = EventStore.latestSessionFile(getProfileGamesDir(profile));
+    if (!latest) {
+      throw new Error('No game events found. Join a game first.');
+    }
+
+    return new EventStore(latest.path);
+  }
+
+  /** Returns the path to the latest session jsonl, or null if none exists. */
+  static latestSessionPath(): string | null {
+    const store = new AuthStore();
+    const profile = store.getActive();
+    if (!profile) return null;
+    return EventStore.latestSessionFile(getProfileGamesDir(profile))?.path ?? null;
+  }
+
+  static createSessionForActiveAccount(sessionId = EventStore.createSessionId()): EventStore {
+    const store = new AuthStore();
+    const profile = store.getActive();
+    if (!profile) throw new Error('Not logged in.');
+
+    const dir = getProfileGamesDir(profile);
+    mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, `${sessionId}.jsonl`);
+    if (!existsSync(filePath)) writeFileSync(filePath, '');
+    return new EventStore(filePath);
+  }
+
+  append(event: Record<string, any>): void {
+    mkdirSync(dirname(this.filePath), { recursive: true });
+    const line = JSON.stringify(event) + '\n';
+    appendFileSync(this.filePath, line);
+  }
+
+  appendNewEvents(events: any): void {
+    const extracted = extractNewEvents(events);
+    if (extracted.length === 0) return;
+    for (const evt of extracted) {
+      this.append(evt);
+    }
+  }
+
+  records(): EventRecord[] {
+    if (!existsSync(this.filePath)) return [];
+    const content = readFileSync(this.filePath, 'utf8');
+    if (!content.trim()) return [];
+    const records: EventRecord[] = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+      const line = lines[i].trim();
+      if (!line) continue;
+      try {
+        const event = JSON.parse(line);
+        if (event && typeof event === 'object') {
+          records.push({ line: i + 1, event });
+        }
+      } catch {}
+    }
+    return records;
+  }
+
+  eventRecords(): EventRecord[] {
+    return this.records().filter((record) => !isLocalControlEvent(record.event));
+  }
+
+  readEventsCursor(): number {
+    let cursor = 0;
+    for (const record of this.records()) {
+      const event = record.event;
+      if (
+        event.type === CCL_EVENTS_CURSOR_TYPE
+        && event.cursor === CCL_EVENTS_CURSOR_NAME
+        && typeof event.line === 'number'
+        && Number.isFinite(event.line)
+      ) {
+        cursor = event.line;
+      }
+    }
+    return cursor;
+  }
+
+  appendEventsCursor(line: number): void {
+    if (!Number.isFinite(line) || line <= 0) return;
+    const event: EventsCursorRecord = {
+      type: CCL_EVENTS_CURSOR_TYPE,
+      cursor: CCL_EVENTS_CURSOR_NAME,
+      line,
+      ts: new Date().toISOString(),
+    };
+    this.append(event);
+  }
+
+  tail(n: number): Record<string, any>[] {
+    return this.eventRecords().slice(-n).map((record) => record.event);
+  }
+
+  all(): Record<string, any>[] {
+    return this.eventRecords().map((record) => record.event);
+  }
+
+  clear(): void {
+    writeFileSync(this.filePath, '');
+  }
+
+  private static createSessionId(): string {
+    const id = new Date().toISOString();
+    return process.platform === 'win32' ? id.replace(/:/g, '_') : id;
+  }
+
+  private static latestSessionFile(dir: string): GameSessionFile | null {
+    if (!existsSync(dir)) return null;
+
+    const files = readdirSync(dir)
+      .filter(name => name.endsWith('.jsonl') && !name.endsWith('.raw-ws.jsonl') && !name.startsWith('index.'))
+      .map(name => {
+        const path = join(dir, name);
+        const stat = statSync(path);
+        return { path, sessionId: basename(name, '.jsonl'), mtimeMs: stat.mtimeMs };
+      })
+      .sort((a, b) => b.sessionId.localeCompare(a.sessionId) || b.mtimeMs - a.mtimeMs);
+
+    return files[0] ?? null;
+  }
+}

package/src/pipeline/pipeline.ts

@@ -1,35 +1,35 @@
-import { GameClient } from '../lib/game-client.js';
-import { EventStore } from './event-store.js';
-
-interface PipelineAction {
-  action: Record<string, any>;
-  needsWait: boolean;
-}
-
-export async function runPipeline(actions: PipelineAction[], initialWaitMs?: number): Promise<void> {
-  const client = GameClient.fromAuth();
-  const store = EventStore.forActiveAccount();
-
-  if (initialWaitMs && initialWaitMs > 0) {
-    await new Promise(r => setTimeout(r, initialWaitMs));
-  }
-
-  for (const item of actions) {
-    const result = await client.submitAction(item.action as any);
-    store.appendNewEvents(result);
-    const durationSecs = result?.data?.duration_secs ?? result?.duration_secs ?? 0;
-
-    if (item.needsWait && durationSecs > 0) {
-      await new Promise(r => setTimeout(r, (durationSecs + 0.5) * 1000));
-      try {
-        const state = await client.getGameState();
-        if (state) store.appendNewEvents(state.new_events);
-      } catch {}
-      store.append({ type: 'pipeline', action: item.action, status: 'done' });
-    } else {
-      store.append({ type: 'pipeline', action: item.action, result });
-    }
-  }
-
-  store.append({ type: 'pipeline_done', count: actions.length });
-}
+import { GameClient } from '../lib/game-client.js';
+import { EventStore } from './event-store.js';
+
+interface PipelineAction {
+  action: Record<string, any>;
+  needsWait: boolean;
+}
+
+export async function runPipeline(actions: PipelineAction[], initialWaitMs?: number): Promise<void> {
+  const client = GameClient.fromAuth();
+  const store = EventStore.forActiveAccount();
+
+  if (initialWaitMs && initialWaitMs > 0) {
+    await new Promise(r => setTimeout(r, initialWaitMs));
+  }
+
+  for (const item of actions) {
+    const result = await client.submitAction(item.action as any);
+    store.appendNewEvents(result);
+    const durationSecs = result?.data?.duration_secs ?? result?.duration_secs ?? 0;
+
+    if (item.needsWait && durationSecs > 0) {
+      await new Promise(r => setTimeout(r, (durationSecs + 0.5) * 1000));
+      try {
+        const state = await client.getGameState();
+        if (state) store.appendNewEvents(state.new_events);
+      } catch {}
+      store.append({ type: 'pipeline', action: item.action, status: 'done' });
+    } else {
+      store.append({ type: 'pipeline', action: item.action, result });
+    }
+  }
+
+  store.append({ type: 'pipeline_done', count: actions.length });
+}

package/src/pipeline/player-projection.test.ts

@@ -0,0 +1,168 @@
+import { describe, expect, it } from 'vitest';
+import { projectPlayers } from './player-projection.js';
+
+describe('projectPlayers', () => {
+  it('projects known deaths from visible-safe events without inventing hidden deaths', () => {
+    const players = projectPlayers({
+      summary: {
+        you: { name: '我', seat: 1 },
+        game: {
+          all_players: [
+            { name: '我', seat: 1 },
+            { name: '蓝虾', seat: 2 },
+            { name: '红蟹', seat: 3 },
+            { name: '白虾', seat: 4 },
+          ],
+        },
+      },
+      events: [
+        { type: 'kill', target_name: '蓝虾', target_seat: 2, actor_name: '我' },
+        { type: 'murder_witnessed', killer_name: '红蟹', target_name: '白虾', target_seat: 4 },
+      ],
+    });
+
+    expect(players).toEqual([
+      {
+        name: '蓝虾',
+        seat: 2,
+        status: 'dead',
+        death: {
+          cause: 'killed',
+          killer: '我',
+          killer_is_you: true,
+          revealed: true,
+          source: 'event_log',
+        },
+      },
+      {
+        name: '红蟹',
+        seat: 3,
+        status: 'alive',
+        death: null,
+      },
+      {
+        name: '白虾',
+        seat: 4,
+        status: 'dead',
+        death: {
+          cause: 'killed',
+          killer: '红蟹',
+          killer_is_you: false,
+          revealed: true,
+          source: 'event_log',
+        },
+      },
+    ]);
+  });
+
+  it('uses meeting alive lists only as revealed meeting knowledge', () => {
+    const players = projectPlayers({
+      summary: { you: { name: '我' } },
+      events: [
+        { type: 'game_started', players: [{ name: '我', seat: 1 }, { name: '蓝虾', seat: 2 }, { name: '红蟹', seat: 3 }] },
+        { type: 'meeting_state', alive_players: [{ name: '我', seat: 1 }, { name: '红蟹', seat: 3 }] },
+      ],
+    });
+
+    expect(players.find((player) => player.name === '蓝虾')).toMatchObject({
+      status: 'dead',
+      death: {
+        cause: 'killed',
+        source: 'meeting_alive_list',
+      },
+    });
+    expect(players.find((player) => player.name === '红蟹')).toMatchObject({
+      status: 'alive',
+      death: null,
+    });
+  });
+
+  it('merges name-only death events into roster players with seats', () => {
+    const players = projectPlayers({
+      summary: { you: { name: 'Self' } },
+      events: [
+        {
+          type: 'game_started',
+          all_seats: { Self: 1, Blue: 2, Red: 3 },
+        },
+        {
+          type: 'corpse_spotted',
+          corpse_name: 'Blue',
+        },
+        {
+          type: 'meeting_state',
+          alive_players: ['Self', 'Red'],
+        },
+      ],
+    });
+
+    expect(players).toEqual([
+      {
+        name: 'Blue',
+        seat: 2,
+        status: 'dead',
+        death: {
+          cause: 'killed',
+          killer: null,
+          revealed: true,
+          source: 'corpse_spotted',
+        },
+      },
+      {
+        name: 'Red',
+        seat: 3,
+        status: 'alive',
+        death: null,
+      },
+    ]);
+  });
+
+  it('treats unconfirmed roster players as alive even if a backend snapshot omits proof', () => {
+    const players = projectPlayers({
+      summary: {
+        you: { name: 'Self', seat: 1 },
+        game: {
+          all_players: [
+            { name: 'Self', seat: 1 },
+            { name: 'Blue', seat: 2, is_alive: false },
+            { name: 'Red', seat: 3 },
+          ],
+        },
+      },
+      events: [],
+    });
+
+    expect(players).toEqual([
+      { name: 'Blue', seat: 2, status: 'alive', death: null },
+      { name: 'Red', seat: 3, status: 'alive', death: null },
+    ]);
+  });
+
+  it('keeps only confirmed meeting, witnessed, and self-caused deaths as dead', () => {
+    const players = projectPlayers({
+      summary: { you: { name: 'Self', seat: 1 } },
+      events: [
+        {
+          type: 'game_started',
+          players: [
+            { name: 'Self', seat: 1 },
+            { name: 'MeetingDead', seat: 2 },
+            { name: 'WitnessedDead', seat: 3 },
+            { name: 'SelfKilled', seat: 4 },
+            { name: 'NoProof', seat: 5 },
+          ],
+        },
+        { type: 'meeting_state', alive_players: [{ name: 'Self', seat: 1 }, { name: 'WitnessedDead', seat: 3 }, { name: 'SelfKilled', seat: 4 }, { name: 'NoProof', seat: 5 }] },
+        { type: 'murder_witnessed', killer_name: 'Crab', target_name: 'WitnessedDead', target_seat: 3 },
+        { type: 'kill', actor_name: 'Self', target_name: 'SelfKilled', target_seat: 4 },
+      ],
+    });
+
+    expect(players.map((player) => [player.name, player.status, player.death?.source ?? null])).toEqual([
+      ['MeetingDead', 'dead', 'meeting_alive_list'],
+      ['WitnessedDead', 'dead', 'event_log'],
+      ['SelfKilled', 'dead', 'event_log'],
+      ['NoProof', 'alive', null],
+    ]);
+  });
+});