@myclaw163/clawclaw-cli 0.6.74 → 0.6.77

package/src/perception/player-history-store.test.ts

@@ -1,87 +1,87 @@
-import { existsSync, mkdtempSync, readFileSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { describe, expect, it } from 'vitest';
-import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
-
-describe('PlayerHistoryStore', () => {
-  it('derives sidecar path from the session jsonl path', () => {
-    expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
-    expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
-  });
-
-  it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
-
-    expect(store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 10,
-      spotted_name: '砂锅猎手',
-      spotted_room: '动力监控室',
-      spotted_x: 1,
-      spotted_y: 2,
-    }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
-    store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 13,
-      spotted_name: '洋流王子',
-      spotted_room: 'hallway',
-      spotted_x: 3,
-      spotted_y: 4,
-    }, Date.parse('2026-05-21T00:00:02.000Z'));
-    store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 13,
-      spotted_name: '测试-浮沉-0bc9',
-      spotted_room: 'hallway',
-      spotted_x: 5,
-      spotted_y: 6,
-    }, Date.parse('2026-05-21T00:00:02.000Z'));
-
-    const data = store.read()!;
-    expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
-    expect(data.visible_frames[1].players).toEqual({});
-    expect(data.visible_frames[2].players).toEqual({});
-    expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
-    expect(data.last_history_tick).toBe(13);
-  });
-
-  it('does not backfill a missing old tick after later ticks have been processed', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset();
-    store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
-    store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
-    expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
-    expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
-  });
-
-  it('caches seats and lobster task locations from map data', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset();
-    store.updateMapCache({
-      all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
-      all_task_locations: [
-        { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
-        { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
-      ],
-    });
-    const data = store.read()!;
-    expect(data.seats).toEqual({ A: 1, B: 2 });
-    expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
-  });
-
-  it('deletes the sidecar when requested', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const path = join(dir, 'session.player-history.json');
-    const store = new PlayerHistoryStore(path);
-    store.reset();
-    expect(existsSync(path)).toBe(true);
-    expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
-    store.delete();
-    expect(existsSync(path)).toBe(false);
-  });
-});
+import { existsSync, mkdtempSync, readFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { describe, expect, it } from 'vitest';
+import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
+
+describe('PlayerHistoryStore', () => {
+  it('derives sidecar path from the session jsonl path', () => {
+    expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
+    expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
+  });
+
+  it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
+
+    expect(store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 10,
+      spotted_name: '砂锅猎手',
+      spotted_room: '动力监控室',
+      spotted_x: 1,
+      spotted_y: 2,
+    }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
+    store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 13,
+      spotted_name: '洋流王子',
+      spotted_room: 'hallway',
+      spotted_x: 3,
+      spotted_y: 4,
+    }, Date.parse('2026-05-21T00:00:02.000Z'));
+    store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 13,
+      spotted_name: '测试-浮沉-0bc9',
+      spotted_room: 'hallway',
+      spotted_x: 5,
+      spotted_y: 6,
+    }, Date.parse('2026-05-21T00:00:02.000Z'));
+
+    const data = store.read()!;
+    expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
+    expect(data.visible_frames[1].players).toEqual({});
+    expect(data.visible_frames[2].players).toEqual({});
+    expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
+    expect(data.last_history_tick).toBe(13);
+  });
+
+  it('does not backfill a missing old tick after later ticks have been processed', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset();
+    store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
+    store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
+    expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
+    expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
+  });
+
+  it('caches seats and lobster task locations from map data', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset();
+    store.updateMapCache({
+      all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
+      all_task_locations: [
+        { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
+        { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
+      ],
+    });
+    const data = store.read()!;
+    expect(data.seats).toEqual({ A: 1, B: 2 });
+    expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
+  });
+
+  it('deletes the sidecar when requested', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const path = join(dir, 'session.player-history.json');
+    const store = new PlayerHistoryStore(path);
+    store.reset();
+    expect(existsSync(path)).toBe(true);
+    expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
+    store.delete();
+    expect(existsSync(path)).toBe(false);
+  });
+});

package/src/perception/player-history-store.ts

@@ -1,194 +1,194 @@
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
-import { dirname } from 'path';
-
-export interface FramePlayer {
-  x: number;
-  y: number;
-  room?: string | null;
-}
-
-export interface VisibleFrame {
-  tick: number;
-  time: string;
-  players: Record<string, FramePlayer>;
-}
-
-export interface LobsterTaskPoint {
-  name: string;
-  room?: string | null;
-  x: number;
-  y: number;
-}
-
-export interface PlayerHistoryData {
-  time: string;
-  visible_frames: VisibleFrame[];
-  seats: Record<string, number>;
-  lobster_tasks: LobsterTaskPoint[];
-  last_raw_frame: null;
-  last_history_tick: number | null;
-}
-
-const TICK_MS = 100;
-
-function nowIso(nowMs = Date.now()): string {
-  return new Date(nowMs).toISOString();
-}
-
-function isFiniteNumber(value: unknown): value is number {
-  return typeof value === 'number' && Number.isFinite(value);
-}
-
-function frameTimeFromPrevious(data: PlayerHistoryData, tick: number, nowMs: number): string {
-  const lastTick = data.last_history_tick;
-  if (lastTick == null || tick <= lastTick) return nowIso(nowMs);
-  const lastFrame = data.visible_frames.find((frame) => frame.tick === lastTick);
-  const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
-  const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
-  return nowIso(baseMs + (tick - lastTick) * TICK_MS);
-}
-
-function createEmptyData(nowMs = Date.now()): PlayerHistoryData {
-  return {
-    time: nowIso(nowMs),
-    visible_frames: [],
-    seats: {},
-    lobster_tasks: [],
-    last_raw_frame: null,
-    last_history_tick: null,
-  };
-}
-
-function normalizeData(raw: Partial<PlayerHistoryData> | null, nowMs = Date.now()): PlayerHistoryData {
-  return {
-    time: typeof raw?.time === 'string' ? raw.time : nowIso(nowMs),
-    visible_frames: Array.isArray(raw?.visible_frames) ? raw.visible_frames : [],
-    seats: raw?.seats && typeof raw.seats === 'object' ? raw.seats : {},
-    lobster_tasks: Array.isArray(raw?.lobster_tasks) ? raw.lobster_tasks : [],
-    last_raw_frame: null,
-    last_history_tick: isFiniteNumber(raw?.last_history_tick) ? raw.last_history_tick : null,
-  };
-}
-
-function ensureFrame(data: PlayerHistoryData, tick: number, time: string): VisibleFrame {
-  let frame = data.visible_frames.find((candidate) => candidate.tick === tick);
-  if (!frame) {
-    frame = { tick, time, players: {} };
-    data.visible_frames.push(frame);
-    data.visible_frames.sort((a, b) => a.tick - b.tick);
-  }
-  return frame;
-}
-
-export function playerHistoryPathForSession(sessionPath: string): string {
-  return sessionPath.endsWith('.jsonl')
-    ? `${sessionPath.slice(0, -'.jsonl'.length)}.player-history.json`
-    : `${sessionPath}.player-history.json`;
-}
-
-export class PlayerHistoryStore {
-  constructor(private filePath: string) {}
-
-  get path(): string {
-    return this.filePath;
-  }
-
-  static forSession(sessionPath: string): PlayerHistoryStore {
-    return new PlayerHistoryStore(playerHistoryPathForSession(sessionPath));
-  }
-
-  read(): PlayerHistoryData | null {
-    if (!existsSync(this.filePath)) return null;
-    try {
-      return normalizeData(JSON.parse(readFileSync(this.filePath, 'utf8')));
-    } catch {
-      return null;
-    }
-  }
-
-  reset(nowMs = Date.now()): PlayerHistoryData {
-    const data = createEmptyData(nowMs);
-    this.write(data);
-    return data;
-  }
-
-  delete(): void {
-    try { unlinkSync(this.filePath); } catch {}
-  }
-
-  updateMapCache(mapData: any, nowMs = Date.now()): void {
-    if (!mapData || typeof mapData !== 'object') return;
-    const data = this.read() ?? createEmptyData(nowMs);
-    const seats: Record<string, number> = {};
-    for (const player of Array.isArray(mapData.all_players) ? mapData.all_players : []) {
-      if (typeof player?.name !== 'string' || !isFiniteNumber(player.seat)) continue;
-      seats[player.name] = player.seat;
-    }
-    const lobsterTasks: LobsterTaskPoint[] = [];
-    for (const task of Array.isArray(mapData.all_task_locations) ? mapData.all_task_locations : []) {
-      if (task?.faction !== 'lobster') continue;
-      if (typeof task.name !== 'string' || !isFiniteNumber(task.x) || !isFiniteNumber(task.y)) continue;
-      lobsterTasks.push({
-        name: task.name,
-        room: typeof task.room === 'string' ? task.room : null,
-        x: task.x,
-        y: task.y,
-      });
-    }
-    data.seats = seats;
-    data.lobster_tasks = lobsterTasks;
-    data.time = nowIso(nowMs);
-    this.write(data);
-  }
-
-  recordPlayerSpotted(event: Record<string, any>, nowMs = Date.now()): boolean {
-    if (event.type !== 'player_spotted') return false;
-    const tick = event.tick;
-    const name = event.spotted_name;
-    const x = event.spotted_x;
-    const y = event.spotted_y;
-    if (!isFiniteNumber(tick) || !Number.isInteger(tick)) return false;
-    if (typeof name !== 'string' || name.length === 0) return false;
-    if (!isFiniteNumber(x) || !isFiniteNumber(y)) return false;
-
-    const data = this.read() ?? createEmptyData(nowMs);
-    let frame: VisibleFrame | undefined;
-    const lastTick = data.last_history_tick;
-
-    if (lastTick == null) {
-      frame = ensureFrame(data, tick, nowIso(nowMs));
-      data.last_history_tick = tick;
-    } else if (tick > lastTick) {
-      const lastFrame = data.visible_frames.find((candidate) => candidate.tick === lastTick);
-      const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
-      const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
-      for (let emptyTick = lastTick + 1; emptyTick < tick; emptyTick++) {
-        ensureFrame(data, emptyTick, nowIso(baseMs + (emptyTick - lastTick) * TICK_MS));
-      }
-      frame = ensureFrame(data, tick, nowIso(baseMs + (tick - lastTick) * TICK_MS));
-      data.last_history_tick = tick;
-    } else {
-      frame = data.visible_frames.find((candidate) => candidate.tick === tick);
-      if (!frame && tick === lastTick) frame = ensureFrame(data, tick, frameTimeFromPrevious(data, tick, nowMs));
-      if (!frame) return false;
-    }
-
-    frame.players[name] = {
-      x,
-      y,
-      room: typeof event.spotted_room === 'string'
-        ? event.spotted_room
-        : typeof event.room === 'string'
-          ? event.room
-          : null,
-    };
-    data.time = nowIso(nowMs);
-    this.write(data);
-    return true;
-  }
-
-  private write(data: PlayerHistoryData): void {
-    mkdirSync(dirname(this.filePath), { recursive: true });
-    writeFileSync(this.filePath, JSON.stringify(data, null, 2));
-  }
-}
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+
+export interface FramePlayer {
+  x: number;
+  y: number;
+  room?: string | null;
+}
+
+export interface VisibleFrame {
+  tick: number;
+  time: string;
+  players: Record<string, FramePlayer>;
+}
+
+export interface LobsterTaskPoint {
+  name: string;
+  room?: string | null;
+  x: number;
+  y: number;
+}
+
+export interface PlayerHistoryData {
+  time: string;
+  visible_frames: VisibleFrame[];
+  seats: Record<string, number>;
+  lobster_tasks: LobsterTaskPoint[];
+  last_raw_frame: null;
+  last_history_tick: number | null;
+}
+
+const TICK_MS = 100;
+
+function nowIso(nowMs = Date.now()): string {
+  return new Date(nowMs).toISOString();
+}
+
+function isFiniteNumber(value: unknown): value is number {
+  return typeof value === 'number' && Number.isFinite(value);
+}
+
+function frameTimeFromPrevious(data: PlayerHistoryData, tick: number, nowMs: number): string {
+  const lastTick = data.last_history_tick;
+  if (lastTick == null || tick <= lastTick) return nowIso(nowMs);
+  const lastFrame = data.visible_frames.find((frame) => frame.tick === lastTick);
+  const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
+  const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
+  return nowIso(baseMs + (tick - lastTick) * TICK_MS);
+}
+
+function createEmptyData(nowMs = Date.now()): PlayerHistoryData {
+  return {
+    time: nowIso(nowMs),
+    visible_frames: [],
+    seats: {},
+    lobster_tasks: [],
+    last_raw_frame: null,
+    last_history_tick: null,
+  };
+}
+
+function normalizeData(raw: Partial<PlayerHistoryData> | null, nowMs = Date.now()): PlayerHistoryData {
+  return {
+    time: typeof raw?.time === 'string' ? raw.time : nowIso(nowMs),
+    visible_frames: Array.isArray(raw?.visible_frames) ? raw.visible_frames : [],
+    seats: raw?.seats && typeof raw.seats === 'object' ? raw.seats : {},
+    lobster_tasks: Array.isArray(raw?.lobster_tasks) ? raw.lobster_tasks : [],
+    last_raw_frame: null,
+    last_history_tick: isFiniteNumber(raw?.last_history_tick) ? raw.last_history_tick : null,
+  };
+}
+
+function ensureFrame(data: PlayerHistoryData, tick: number, time: string): VisibleFrame {
+  let frame = data.visible_frames.find((candidate) => candidate.tick === tick);
+  if (!frame) {
+    frame = { tick, time, players: {} };
+    data.visible_frames.push(frame);
+    data.visible_frames.sort((a, b) => a.tick - b.tick);
+  }
+  return frame;
+}
+
+export function playerHistoryPathForSession(sessionPath: string): string {
+  return sessionPath.endsWith('.jsonl')
+    ? `${sessionPath.slice(0, -'.jsonl'.length)}.player-history.json`
+    : `${sessionPath}.player-history.json`;
+}
+
+export class PlayerHistoryStore {
+  constructor(private filePath: string) {}
+
+  get path(): string {
+    return this.filePath;
+  }
+
+  static forSession(sessionPath: string): PlayerHistoryStore {
+    return new PlayerHistoryStore(playerHistoryPathForSession(sessionPath));
+  }
+
+  read(): PlayerHistoryData | null {
+    if (!existsSync(this.filePath)) return null;
+    try {
+      return normalizeData(JSON.parse(readFileSync(this.filePath, 'utf8')));
+    } catch {
+      return null;
+    }
+  }
+
+  reset(nowMs = Date.now()): PlayerHistoryData {
+    const data = createEmptyData(nowMs);
+    this.write(data);
+    return data;
+  }
+
+  delete(): void {
+    try { unlinkSync(this.filePath); } catch {}
+  }
+
+  updateMapCache(mapData: any, nowMs = Date.now()): void {
+    if (!mapData || typeof mapData !== 'object') return;
+    const data = this.read() ?? createEmptyData(nowMs);
+    const seats: Record<string, number> = {};
+    for (const player of Array.isArray(mapData.all_players) ? mapData.all_players : []) {
+      if (typeof player?.name !== 'string' || !isFiniteNumber(player.seat)) continue;
+      seats[player.name] = player.seat;
+    }
+    const lobsterTasks: LobsterTaskPoint[] = [];
+    for (const task of Array.isArray(mapData.all_task_locations) ? mapData.all_task_locations : []) {
+      if (task?.faction !== 'lobster') continue;
+      if (typeof task.name !== 'string' || !isFiniteNumber(task.x) || !isFiniteNumber(task.y)) continue;
+      lobsterTasks.push({
+        name: task.name,
+        room: typeof task.room === 'string' ? task.room : null,
+        x: task.x,
+        y: task.y,
+      });
+    }
+    data.seats = seats;
+    data.lobster_tasks = lobsterTasks;
+    data.time = nowIso(nowMs);
+    this.write(data);
+  }
+
+  recordPlayerSpotted(event: Record<string, any>, nowMs = Date.now()): boolean {
+    if (event.type !== 'player_spotted') return false;
+    const tick = event.tick;
+    const name = event.spotted_name;
+    const x = event.spotted_x;
+    const y = event.spotted_y;
+    if (!isFiniteNumber(tick) || !Number.isInteger(tick)) return false;
+    if (typeof name !== 'string' || name.length === 0) return false;
+    if (!isFiniteNumber(x) || !isFiniteNumber(y)) return false;
+
+    const data = this.read() ?? createEmptyData(nowMs);
+    let frame: VisibleFrame | undefined;
+    const lastTick = data.last_history_tick;
+
+    if (lastTick == null) {
+      frame = ensureFrame(data, tick, nowIso(nowMs));
+      data.last_history_tick = tick;
+    } else if (tick > lastTick) {
+      const lastFrame = data.visible_frames.find((candidate) => candidate.tick === lastTick);
+      const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
+      const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
+      for (let emptyTick = lastTick + 1; emptyTick < tick; emptyTick++) {
+        ensureFrame(data, emptyTick, nowIso(baseMs + (emptyTick - lastTick) * TICK_MS));
+      }
+      frame = ensureFrame(data, tick, nowIso(baseMs + (tick - lastTick) * TICK_MS));
+      data.last_history_tick = tick;
+    } else {
+      frame = data.visible_frames.find((candidate) => candidate.tick === tick);
+      if (!frame && tick === lastTick) frame = ensureFrame(data, tick, frameTimeFromPrevious(data, tick, nowMs));
+      if (!frame) return false;
+    }
+
+    frame.players[name] = {
+      x,
+      y,
+      room: typeof event.spotted_room === 'string'
+        ? event.spotted_room
+        : typeof event.room === 'string'
+          ? event.room
+          : null,
+    };
+    data.time = nowIso(nowMs);
+    this.write(data);
+    return true;
+  }
+
+  private write(data: PlayerHistoryData): void {
+    mkdirSync(dirname(this.filePath), { recursive: true });
+    writeFileSync(this.filePath, JSON.stringify(data, null, 2));
+  }
+}