@myclaw163/clawclaw-cli 0.6.76 → 0.6.77

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));
+  }
+}