@myclaw163/clawclaw-cli 0.6.66 → 0.6.67

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/README.md +427 -427
  2. package/bin/clawclaw-cli.mjs +3 -3
  3. package/package.json +48 -48
  4. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  5. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  6. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  7. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  8. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  9. package/scripts/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +245 -245
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +244 -245
  14. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  15. package/skills/clawclaw/references/COMMANDS.md +148 -148
  16. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  17. package/skills/clawclaw/references/HUB.md +48 -48
  18. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  19. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  20. package/skills/clawclaw/references/STREAM.md +91 -92
  21. package/skills/clawclaw/references/TACTICS.md +65 -65
  22. package/src/assets/clawclaw-ascii-map.txt +40 -40
  23. package/src/cli.ts +110 -110
  24. package/src/commands/_schema.ts +109 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/do.test.ts +73 -73
  27. package/src/commands/do.ts +126 -126
  28. package/src/commands/events.test.ts +71 -71
  29. package/src/commands/events.ts +155 -155
  30. package/src/commands/game-map.test.ts +28 -28
  31. package/src/commands/game-start-plan.test.ts +84 -84
  32. package/src/commands/game.ts +1027 -1027
  33. package/src/commands/history-player.test.ts +102 -102
  34. package/src/commands/history.ts +573 -573
  35. package/src/commands/hub.test.ts +96 -96
  36. package/src/commands/hub.ts +234 -234
  37. package/src/commands/knowledge.test.ts +19 -19
  38. package/src/commands/knowledge.ts +168 -168
  39. package/src/commands/load.test.ts +51 -51
  40. package/src/commands/load.ts +13 -13
  41. package/src/commands/meeting-history.test.ts +106 -106
  42. package/src/commands/memory.ts +40 -40
  43. package/src/commands/peek.ts +45 -45
  44. package/src/commands/persona.ts +57 -57
  45. package/src/commands/setup/codex.ts +266 -248
  46. package/src/commands/skill.ts +128 -128
  47. package/src/commands/state.ts +46 -46
  48. package/src/commands/strategy.test.ts +135 -135
  49. package/src/commands/strategy.ts +180 -180
  50. package/src/commands/tts.ts +128 -128
  51. package/src/commands/upgrade.test.ts +82 -82
  52. package/src/commands/upgrade.ts +148 -148
  53. package/src/commands/watch.test.ts +966 -966
  54. package/src/commands/watch.ts +659 -659
  55. package/src/lib/auth.test.ts +59 -59
  56. package/src/lib/auth.ts +186 -186
  57. package/src/lib/command-meta.ts +37 -37
  58. package/src/lib/game-client.ts +391 -391
  59. package/src/lib/http-keepalive.ts +15 -15
  60. package/src/lib/http-transport.test.ts +42 -42
  61. package/src/lib/http-transport.ts +113 -113
  62. package/src/lib/hub-client.test.ts +56 -56
  63. package/src/lib/hub-client.ts +88 -88
  64. package/src/lib/hub-install.test.ts +98 -98
  65. package/src/lib/hub-install.ts +121 -121
  66. package/src/lib/hub-reminder.ts +75 -75
  67. package/src/lib/hub-unzip.test.ts +69 -69
  68. package/src/lib/hub-unzip.ts +62 -62
  69. package/src/lib/init-command.test.ts +75 -75
  70. package/src/lib/init-command.ts +120 -120
  71. package/src/lib/knowledge-store.test.ts +180 -180
  72. package/src/lib/knowledge-store.ts +374 -374
  73. package/src/lib/load-context.test.ts +52 -52
  74. package/src/lib/load-context.ts +52 -52
  75. package/src/lib/match-state.test.ts +134 -134
  76. package/src/lib/match-state.ts +94 -94
  77. package/src/lib/netease-tts.ts +83 -83
  78. package/src/lib/normalize.ts +42 -42
  79. package/src/lib/persona.test.ts +41 -41
  80. package/src/lib/persona.ts +72 -72
  81. package/src/lib/server-registry.ts +152 -152
  82. package/src/lib/skill-version.test.ts +48 -48
  83. package/src/lib/skill-version.ts +19 -19
  84. package/src/lib/strategy-export.test.ts +232 -232
  85. package/src/lib/strategy-export.ts +242 -242
  86. package/src/lib/tts-keys.ts +7 -7
  87. package/src/lib/tts-speech.test.ts +63 -63
  88. package/src/lib/tts-speech.ts +76 -76
  89. package/src/lib/workspace-argv.test.ts +49 -49
  90. package/src/lib/workspace-argv.ts +44 -44
  91. package/src/perception/player-history-store.test.ts +87 -87
  92. package/src/perception/player-history-store.ts +194 -194
  93. package/src/pipeline/event-format.test.ts +135 -135
  94. package/src/pipeline/event-format.ts +376 -376
  95. package/src/pipeline/event-hints.ts +173 -173
  96. package/src/pipeline/event-store.test.ts +28 -28
  97. package/src/pipeline/event-store.ts +193 -193
  98. package/src/pipeline/pipeline.ts +35 -35
  99. package/src/runtime/auto-upgrade.test.ts +66 -66
  100. package/src/runtime/auto-upgrade.ts +31 -31
  101. package/src/runtime/event-daemon.test.ts +107 -107
  102. package/src/runtime/event-daemon.ts +409 -409
  103. package/src/runtime/owner-control.ts +150 -150
  104. package/src/runtime/raw-ws-log.test.ts +33 -33
  105. package/src/runtime/raw-ws-log.ts +32 -32
  106. package/src/runtime/runtime-logger.ts +107 -107
  107. package/src/runtime/ws-client.test.ts +104 -104
  108. package/src/runtime/ws-client.ts +272 -272
  109. package/src/sdk/action.ts +166 -166
  110. package/src/sdk/index.ts +111 -111
  111. package/src/sdk/types.ts +159 -159
  112. package/src/strategies/avoid-lone.ts +11 -11
  113. package/src/strategies/avoid-players.knowledge.md +20 -20
  114. package/src/strategies/avoid-players.ts +15 -15
  115. package/src/strategies/corpse-patrol.ts +22 -22
  116. package/src/strategies/crab-sabotage.ts +21 -21
  117. package/src/strategies/custom-module.test.ts +269 -269
  118. package/src/strategies/find-player.ts +16 -16
  119. package/src/strategies/game-utils.test.ts +190 -190
  120. package/src/strategies/game-utils.ts +782 -782
  121. package/src/strategies/goals/anchor-linger.ts +77 -77
  122. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  123. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  124. package/src/strategies/goals/avoid-players-top.ts +121 -121
  125. package/src/strategies/goals/conversation-goal.ts +51 -51
  126. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  127. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  128. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  129. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  130. package/src/strategies/goals/find-player-top.ts +93 -93
  131. package/src/strategies/goals/flee-players-goal.ts +53 -53
  132. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  133. package/src/strategies/goals/goal-manager.ts +41 -41
  134. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  135. package/src/strategies/goals/goal.ts +28 -28
  136. package/src/strategies/goals/hide-top.ts +197 -197
  137. package/src/strategies/goals/keep-away-goal.ts +217 -217
  138. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  139. package/src/strategies/goals/kill-lone-top.ts +160 -160
  140. package/src/strategies/goals/kill-target-goal.ts +59 -59
  141. package/src/strategies/goals/kill-target-top.ts +109 -109
  142. package/src/strategies/goals/leaf-goal.ts +25 -25
  143. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  144. package/src/strategies/goals/lone-kill-core.ts +82 -82
  145. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  146. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  147. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  148. package/src/strategies/goals/move-room-goal.ts +60 -60
  149. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  150. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  151. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  152. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  153. package/src/strategies/goals/patrol-top.ts +57 -57
  154. package/src/strategies/goals/report-patrol-top.ts +80 -80
  155. package/src/strategies/goals/safe-task-goal.ts +102 -102
  156. package/src/strategies/goals/social-task-top.ts +161 -161
  157. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  158. package/src/strategies/goals/task-only-top.ts +57 -57
  159. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  160. package/src/strategies/goals/task-report-top.ts +57 -57
  161. package/src/strategies/goals/wander-task-goal.ts +33 -33
  162. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  163. package/src/strategies/goals/warrior-shrimp-top.ts +500 -500
  164. package/src/strategies/greeting.ts +53 -53
  165. package/src/strategies/hide-spots.ts +123 -123
  166. package/src/strategies/hide.ts +23 -23
  167. package/src/strategies/kill-frenzy.ts +12 -12
  168. package/src/strategies/kill-lone.knowledge.md +20 -20
  169. package/src/strategies/kill-lone.ts +13 -13
  170. package/src/strategies/kill-target.ts +18 -18
  171. package/src/strategies/loader.test.ts +678 -678
  172. package/src/strategies/loader.ts +172 -172
  173. package/src/strategies/lone-kill-task.ts +21 -21
  174. package/src/strategies/meeting-gate.test.ts +59 -59
  175. package/src/strategies/meeting-gate.ts +23 -23
  176. package/src/strategies/move-room.ts +15 -15
  177. package/src/strategies/new-events-backfill.ts +98 -98
  178. package/src/strategies/paradise-fish.knowledge.md +20 -20
  179. package/src/strategies/paradise-fish.ts +25 -25
  180. package/src/strategies/pathfind/distance-field.ts +150 -150
  181. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  182. package/src/strategies/pathfind/escape-planner.ts +355 -355
  183. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  184. package/src/strategies/patrol.ts +11 -11
  185. package/src/strategies/player-targets.ts +13 -13
  186. package/src/strategies/report-patrol.ts +11 -11
  187. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  188. package/src/strategies/shrimp-memory.ts +25 -25
  189. package/src/strategies/social-task.test.ts +28 -28
  190. package/src/strategies/social-task.ts +49 -49
  191. package/src/strategies/spawn.ts +82 -82
  192. package/src/strategies/speech-module.ts +123 -123
  193. package/src/strategies/strategy-loop.ts +771 -771
  194. package/src/strategies/task-kill-report.ts +17 -17
  195. package/src/strategies/task-only.ts +11 -11
  196. package/src/strategies/task-report.ts +22 -22
  197. package/src/strategies/types.ts +102 -102
  198. package/src/strategies/warrior-memory.knowledge.md +22 -22
  199. package/src/strategies/warrior-memory.ts +16 -16
@@ -1,194 +1,194 @@
1
- import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
2
- import { dirname } from 'path';
3
-
4
- export interface FramePlayer {
5
- x: number;
6
- y: number;
7
- room?: string | null;
8
- }
9
-
10
- export interface VisibleFrame {
11
- tick: number;
12
- time: string;
13
- players: Record<string, FramePlayer>;
14
- }
15
-
16
- export interface LobsterTaskPoint {
17
- name: string;
18
- room?: string | null;
19
- x: number;
20
- y: number;
21
- }
22
-
23
- export interface PlayerHistoryData {
24
- time: string;
25
- visible_frames: VisibleFrame[];
26
- seats: Record<string, number>;
27
- lobster_tasks: LobsterTaskPoint[];
28
- last_raw_frame: null;
29
- last_history_tick: number | null;
30
- }
31
-
32
- const TICK_MS = 100;
33
-
34
- function nowIso(nowMs = Date.now()): string {
35
- return new Date(nowMs).toISOString();
36
- }
37
-
38
- function isFiniteNumber(value: unknown): value is number {
39
- return typeof value === 'number' && Number.isFinite(value);
40
- }
41
-
42
- function frameTimeFromPrevious(data: PlayerHistoryData, tick: number, nowMs: number): string {
43
- const lastTick = data.last_history_tick;
44
- if (lastTick == null || tick <= lastTick) return nowIso(nowMs);
45
- const lastFrame = data.visible_frames.find((frame) => frame.tick === lastTick);
46
- const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
47
- const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
48
- return nowIso(baseMs + (tick - lastTick) * TICK_MS);
49
- }
50
-
51
- function createEmptyData(nowMs = Date.now()): PlayerHistoryData {
52
- return {
53
- time: nowIso(nowMs),
54
- visible_frames: [],
55
- seats: {},
56
- lobster_tasks: [],
57
- last_raw_frame: null,
58
- last_history_tick: null,
59
- };
60
- }
61
-
62
- function normalizeData(raw: Partial<PlayerHistoryData> | null, nowMs = Date.now()): PlayerHistoryData {
63
- return {
64
- time: typeof raw?.time === 'string' ? raw.time : nowIso(nowMs),
65
- visible_frames: Array.isArray(raw?.visible_frames) ? raw.visible_frames : [],
66
- seats: raw?.seats && typeof raw.seats === 'object' ? raw.seats : {},
67
- lobster_tasks: Array.isArray(raw?.lobster_tasks) ? raw.lobster_tasks : [],
68
- last_raw_frame: null,
69
- last_history_tick: isFiniteNumber(raw?.last_history_tick) ? raw.last_history_tick : null,
70
- };
71
- }
72
-
73
- function ensureFrame(data: PlayerHistoryData, tick: number, time: string): VisibleFrame {
74
- let frame = data.visible_frames.find((candidate) => candidate.tick === tick);
75
- if (!frame) {
76
- frame = { tick, time, players: {} };
77
- data.visible_frames.push(frame);
78
- data.visible_frames.sort((a, b) => a.tick - b.tick);
79
- }
80
- return frame;
81
- }
82
-
83
- export function playerHistoryPathForSession(sessionPath: string): string {
84
- return sessionPath.endsWith('.jsonl')
85
- ? `${sessionPath.slice(0, -'.jsonl'.length)}.player-history.json`
86
- : `${sessionPath}.player-history.json`;
87
- }
88
-
89
- export class PlayerHistoryStore {
90
- constructor(private filePath: string) {}
91
-
92
- get path(): string {
93
- return this.filePath;
94
- }
95
-
96
- static forSession(sessionPath: string): PlayerHistoryStore {
97
- return new PlayerHistoryStore(playerHistoryPathForSession(sessionPath));
98
- }
99
-
100
- read(): PlayerHistoryData | null {
101
- if (!existsSync(this.filePath)) return null;
102
- try {
103
- return normalizeData(JSON.parse(readFileSync(this.filePath, 'utf8')));
104
- } catch {
105
- return null;
106
- }
107
- }
108
-
109
- reset(nowMs = Date.now()): PlayerHistoryData {
110
- const data = createEmptyData(nowMs);
111
- this.write(data);
112
- return data;
113
- }
114
-
115
- delete(): void {
116
- try { unlinkSync(this.filePath); } catch {}
117
- }
118
-
119
- updateMapCache(mapData: any, nowMs = Date.now()): void {
120
- if (!mapData || typeof mapData !== 'object') return;
121
- const data = this.read() ?? createEmptyData(nowMs);
122
- const seats: Record<string, number> = {};
123
- for (const player of Array.isArray(mapData.all_players) ? mapData.all_players : []) {
124
- if (typeof player?.name !== 'string' || !isFiniteNumber(player.seat)) continue;
125
- seats[player.name] = player.seat;
126
- }
127
- const lobsterTasks: LobsterTaskPoint[] = [];
128
- for (const task of Array.isArray(mapData.all_task_locations) ? mapData.all_task_locations : []) {
129
- if (task?.faction !== 'lobster') continue;
130
- if (typeof task.name !== 'string' || !isFiniteNumber(task.x) || !isFiniteNumber(task.y)) continue;
131
- lobsterTasks.push({
132
- name: task.name,
133
- room: typeof task.room === 'string' ? task.room : null,
134
- x: task.x,
135
- y: task.y,
136
- });
137
- }
138
- data.seats = seats;
139
- data.lobster_tasks = lobsterTasks;
140
- data.time = nowIso(nowMs);
141
- this.write(data);
142
- }
143
-
144
- recordPlayerSpotted(event: Record<string, any>, nowMs = Date.now()): boolean {
145
- if (event.type !== 'player_spotted') return false;
146
- const tick = event.tick;
147
- const name = event.spotted_name;
148
- const x = event.spotted_x;
149
- const y = event.spotted_y;
150
- if (!isFiniteNumber(tick) || !Number.isInteger(tick)) return false;
151
- if (typeof name !== 'string' || name.length === 0) return false;
152
- if (!isFiniteNumber(x) || !isFiniteNumber(y)) return false;
153
-
154
- const data = this.read() ?? createEmptyData(nowMs);
155
- let frame: VisibleFrame | undefined;
156
- const lastTick = data.last_history_tick;
157
-
158
- if (lastTick == null) {
159
- frame = ensureFrame(data, tick, nowIso(nowMs));
160
- data.last_history_tick = tick;
161
- } else if (tick > lastTick) {
162
- const lastFrame = data.visible_frames.find((candidate) => candidate.tick === lastTick);
163
- const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
164
- const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
165
- for (let emptyTick = lastTick + 1; emptyTick < tick; emptyTick++) {
166
- ensureFrame(data, emptyTick, nowIso(baseMs + (emptyTick - lastTick) * TICK_MS));
167
- }
168
- frame = ensureFrame(data, tick, nowIso(baseMs + (tick - lastTick) * TICK_MS));
169
- data.last_history_tick = tick;
170
- } else {
171
- frame = data.visible_frames.find((candidate) => candidate.tick === tick);
172
- if (!frame && tick === lastTick) frame = ensureFrame(data, tick, frameTimeFromPrevious(data, tick, nowMs));
173
- if (!frame) return false;
174
- }
175
-
176
- frame.players[name] = {
177
- x,
178
- y,
179
- room: typeof event.spotted_room === 'string'
180
- ? event.spotted_room
181
- : typeof event.room === 'string'
182
- ? event.room
183
- : null,
184
- };
185
- data.time = nowIso(nowMs);
186
- this.write(data);
187
- return true;
188
- }
189
-
190
- private write(data: PlayerHistoryData): void {
191
- mkdirSync(dirname(this.filePath), { recursive: true });
192
- writeFileSync(this.filePath, JSON.stringify(data, null, 2));
193
- }
194
- }
1
+ import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
2
+ import { dirname } from 'path';
3
+
4
+ export interface FramePlayer {
5
+ x: number;
6
+ y: number;
7
+ room?: string | null;
8
+ }
9
+
10
+ export interface VisibleFrame {
11
+ tick: number;
12
+ time: string;
13
+ players: Record<string, FramePlayer>;
14
+ }
15
+
16
+ export interface LobsterTaskPoint {
17
+ name: string;
18
+ room?: string | null;
19
+ x: number;
20
+ y: number;
21
+ }
22
+
23
+ export interface PlayerHistoryData {
24
+ time: string;
25
+ visible_frames: VisibleFrame[];
26
+ seats: Record<string, number>;
27
+ lobster_tasks: LobsterTaskPoint[];
28
+ last_raw_frame: null;
29
+ last_history_tick: number | null;
30
+ }
31
+
32
+ const TICK_MS = 100;
33
+
34
+ function nowIso(nowMs = Date.now()): string {
35
+ return new Date(nowMs).toISOString();
36
+ }
37
+
38
+ function isFiniteNumber(value: unknown): value is number {
39
+ return typeof value === 'number' && Number.isFinite(value);
40
+ }
41
+
42
+ function frameTimeFromPrevious(data: PlayerHistoryData, tick: number, nowMs: number): string {
43
+ const lastTick = data.last_history_tick;
44
+ if (lastTick == null || tick <= lastTick) return nowIso(nowMs);
45
+ const lastFrame = data.visible_frames.find((frame) => frame.tick === lastTick);
46
+ const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
47
+ const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
48
+ return nowIso(baseMs + (tick - lastTick) * TICK_MS);
49
+ }
50
+
51
+ function createEmptyData(nowMs = Date.now()): PlayerHistoryData {
52
+ return {
53
+ time: nowIso(nowMs),
54
+ visible_frames: [],
55
+ seats: {},
56
+ lobster_tasks: [],
57
+ last_raw_frame: null,
58
+ last_history_tick: null,
59
+ };
60
+ }
61
+
62
+ function normalizeData(raw: Partial<PlayerHistoryData> | null, nowMs = Date.now()): PlayerHistoryData {
63
+ return {
64
+ time: typeof raw?.time === 'string' ? raw.time : nowIso(nowMs),
65
+ visible_frames: Array.isArray(raw?.visible_frames) ? raw.visible_frames : [],
66
+ seats: raw?.seats && typeof raw.seats === 'object' ? raw.seats : {},
67
+ lobster_tasks: Array.isArray(raw?.lobster_tasks) ? raw.lobster_tasks : [],
68
+ last_raw_frame: null,
69
+ last_history_tick: isFiniteNumber(raw?.last_history_tick) ? raw.last_history_tick : null,
70
+ };
71
+ }
72
+
73
+ function ensureFrame(data: PlayerHistoryData, tick: number, time: string): VisibleFrame {
74
+ let frame = data.visible_frames.find((candidate) => candidate.tick === tick);
75
+ if (!frame) {
76
+ frame = { tick, time, players: {} };
77
+ data.visible_frames.push(frame);
78
+ data.visible_frames.sort((a, b) => a.tick - b.tick);
79
+ }
80
+ return frame;
81
+ }
82
+
83
+ export function playerHistoryPathForSession(sessionPath: string): string {
84
+ return sessionPath.endsWith('.jsonl')
85
+ ? `${sessionPath.slice(0, -'.jsonl'.length)}.player-history.json`
86
+ : `${sessionPath}.player-history.json`;
87
+ }
88
+
89
+ export class PlayerHistoryStore {
90
+ constructor(private filePath: string) {}
91
+
92
+ get path(): string {
93
+ return this.filePath;
94
+ }
95
+
96
+ static forSession(sessionPath: string): PlayerHistoryStore {
97
+ return new PlayerHistoryStore(playerHistoryPathForSession(sessionPath));
98
+ }
99
+
100
+ read(): PlayerHistoryData | null {
101
+ if (!existsSync(this.filePath)) return null;
102
+ try {
103
+ return normalizeData(JSON.parse(readFileSync(this.filePath, 'utf8')));
104
+ } catch {
105
+ return null;
106
+ }
107
+ }
108
+
109
+ reset(nowMs = Date.now()): PlayerHistoryData {
110
+ const data = createEmptyData(nowMs);
111
+ this.write(data);
112
+ return data;
113
+ }
114
+
115
+ delete(): void {
116
+ try { unlinkSync(this.filePath); } catch {}
117
+ }
118
+
119
+ updateMapCache(mapData: any, nowMs = Date.now()): void {
120
+ if (!mapData || typeof mapData !== 'object') return;
121
+ const data = this.read() ?? createEmptyData(nowMs);
122
+ const seats: Record<string, number> = {};
123
+ for (const player of Array.isArray(mapData.all_players) ? mapData.all_players : []) {
124
+ if (typeof player?.name !== 'string' || !isFiniteNumber(player.seat)) continue;
125
+ seats[player.name] = player.seat;
126
+ }
127
+ const lobsterTasks: LobsterTaskPoint[] = [];
128
+ for (const task of Array.isArray(mapData.all_task_locations) ? mapData.all_task_locations : []) {
129
+ if (task?.faction !== 'lobster') continue;
130
+ if (typeof task.name !== 'string' || !isFiniteNumber(task.x) || !isFiniteNumber(task.y)) continue;
131
+ lobsterTasks.push({
132
+ name: task.name,
133
+ room: typeof task.room === 'string' ? task.room : null,
134
+ x: task.x,
135
+ y: task.y,
136
+ });
137
+ }
138
+ data.seats = seats;
139
+ data.lobster_tasks = lobsterTasks;
140
+ data.time = nowIso(nowMs);
141
+ this.write(data);
142
+ }
143
+
144
+ recordPlayerSpotted(event: Record<string, any>, nowMs = Date.now()): boolean {
145
+ if (event.type !== 'player_spotted') return false;
146
+ const tick = event.tick;
147
+ const name = event.spotted_name;
148
+ const x = event.spotted_x;
149
+ const y = event.spotted_y;
150
+ if (!isFiniteNumber(tick) || !Number.isInteger(tick)) return false;
151
+ if (typeof name !== 'string' || name.length === 0) return false;
152
+ if (!isFiniteNumber(x) || !isFiniteNumber(y)) return false;
153
+
154
+ const data = this.read() ?? createEmptyData(nowMs);
155
+ let frame: VisibleFrame | undefined;
156
+ const lastTick = data.last_history_tick;
157
+
158
+ if (lastTick == null) {
159
+ frame = ensureFrame(data, tick, nowIso(nowMs));
160
+ data.last_history_tick = tick;
161
+ } else if (tick > lastTick) {
162
+ const lastFrame = data.visible_frames.find((candidate) => candidate.tick === lastTick);
163
+ const lastMs = lastFrame ? Date.parse(lastFrame.time) : NaN;
164
+ const baseMs = Number.isFinite(lastMs) ? lastMs : nowMs - (tick - lastTick) * TICK_MS;
165
+ for (let emptyTick = lastTick + 1; emptyTick < tick; emptyTick++) {
166
+ ensureFrame(data, emptyTick, nowIso(baseMs + (emptyTick - lastTick) * TICK_MS));
167
+ }
168
+ frame = ensureFrame(data, tick, nowIso(baseMs + (tick - lastTick) * TICK_MS));
169
+ data.last_history_tick = tick;
170
+ } else {
171
+ frame = data.visible_frames.find((candidate) => candidate.tick === tick);
172
+ if (!frame && tick === lastTick) frame = ensureFrame(data, tick, frameTimeFromPrevious(data, tick, nowMs));
173
+ if (!frame) return false;
174
+ }
175
+
176
+ frame.players[name] = {
177
+ x,
178
+ y,
179
+ room: typeof event.spotted_room === 'string'
180
+ ? event.spotted_room
181
+ : typeof event.room === 'string'
182
+ ? event.room
183
+ : null,
184
+ };
185
+ data.time = nowIso(nowMs);
186
+ this.write(data);
187
+ return true;
188
+ }
189
+
190
+ private write(data: PlayerHistoryData): void {
191
+ mkdirSync(dirname(this.filePath), { recursive: true });
192
+ writeFileSync(this.filePath, JSON.stringify(data, null, 2));
193
+ }
194
+ }
@@ -1,135 +1,135 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { compactEventFields, formatEventMessage } from './event-format.js';
3
- import { EVENT_HINT_FORMATTERS } from './event-hints.js';
4
-
5
- describe('event-format', () => {
6
- it('formats killed as a short notice with seat and removes the long backend hint tail', () => {
7
- const event = {
8
- type: 'killed',
9
- tick: 5330,
10
- room: '情报室',
11
- killer_name: '哈基米南北绿豆',
12
- killer_seat: 8,
13
- hint: 'YOU ARE DEAD: 哈基米南北绿豆 removed you from play. Your hands are off the board now — alert your user, then spectate or leave while your teammates weaponize what you learned.',
14
- };
15
-
16
- const notice = formatEventMessage(event);
17
- const formatted = compactEventFields(event, {}, 1158);
18
-
19
- expect(notice).toContain('t5330 killed');
20
- expect(notice).toContain('8号哈基米南北绿豆');
21
- expect(formatted).not.toHaveProperty('notice');
22
- expect(formatted.hint).toBe('YOU ARE DEAD: 8号哈基米南北绿豆 removed you from play.');
23
- expect(JSON.stringify(formatted)).not.toContain('Your hands are off the board');
24
- });
25
-
26
- it('keeps meeting_briefing details aligned with the compact monitor payload', () => {
27
- const formatted = compactEventFields({
28
- type: 'meeting_briefing',
29
- tick: 979,
30
- room: '会议室',
31
- meeting_caller_name: '单钳渔夫',
32
- meeting_caller_seat: 1,
33
- reported_corpses: [{ name: '丹霞兄', seat: 3 }],
34
- your_seat: 6,
35
- all_seats: [{ name: '单钳渔夫', seat: 1 }],
36
- speech_order: ['单钳渔夫', '洋流王子'],
37
- crab_teammates: [{ name: '暗礁壳壳', seat: 5 }],
38
- hint: 'backend hint should not leak',
39
- }, {}, 941);
40
-
41
- expect(formatted).toMatchObject({
42
- line: 941,
43
- type: 'meeting_briefing',
44
- tick: 979,
45
- meeting_caller_name: '单钳渔夫',
46
- meeting_caller_seat: 1,
47
- reported_corpses: [{ name: '丹霞兄', seat: 3 }],
48
- your_seat: 6,
49
- all_seats: [{ name: '单钳渔夫', seat: 1 }],
50
- speech_order: ['单钳渔夫', '洋流王子'],
51
- crab_teammates: [{ name: '暗礁壳壳', seat: 5 }],
52
- hint: 'Meeting started — seat 1 单钳渔夫 called this meeting after reporting the body of seat 3 丹霞兄. Your Crab teammate(s): seat 5 暗礁壳壳. Shield them, redirect heat, split suspicion, and control the vote. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.',
53
- });
54
- expect(formatted).not.toHaveProperty('room');
55
- expect(JSON.stringify(formatted)).not.toContain('backend hint');
56
- });
57
-
58
- it('hides vote targets in event details', () => {
59
- const formatted = compactEventFields({
60
- type: 'vote_cast',
61
- tick: 3409,
62
- actor_name: '菜逼油条',
63
- actor_seat: 8,
64
- target: '单钳渔夫',
65
- target_name: '单钳渔夫',
66
- target_seat: 1,
67
- hint: 'backend target leak',
68
- });
69
-
70
- expect(formatted).toMatchObject({
71
- type: 'vote_cast',
72
- tick: 3409,
73
- actor_name: '菜逼油条',
74
- actor_seat: 8,
75
- hint: '8号菜逼油条 voted.',
76
- });
77
- expect(formatted).not.toHaveProperty('target');
78
- expect(formatted).not.toHaveProperty('target_name');
79
- expect(formatted).not.toHaveProperty('target_seat');
80
- expect(JSON.stringify(formatted)).not.toContain('单钳渔夫');
81
- });
82
-
83
- it('keeps monitor message formatting separate from event detail fields', () => {
84
- const notice = formatEventMessage({
85
- type: 'vote_phase_start',
86
- tick: 3408,
87
- message: 'Speech phase ended. All alive players, please cast your vote',
88
- });
89
-
90
- expect(notice).toContain('t3408 vote_phase_start');
91
- expect(notice).toContain('ccl do -v');
92
- });
93
-
94
- it('formats corpse_spotted monitor notices as my discovery with body owner', () => {
95
- const notice = formatEventMessage({
96
- type: 'corpse_spotted',
97
- tick: 3410,
98
- corpse_name: '丹霞兄',
99
- corpse_seat: 3,
100
- corpse_room: '情报室',
101
- });
102
-
103
- expect(notice).toBe('t3410 corpse_spotted 我发现了3号丹霞兄的尸体,在情报室。');
104
- });
105
-
106
- it('keeps local hint formatters for backend-hinted monitor events', () => {
107
- const backendHintedMonitorEvents = [
108
- 'corpse_spotted',
109
- 'death_speech',
110
- 'emergency_resolved',
111
- 'emergency_started',
112
- 'exile',
113
- 'game_over',
114
- 'kill',
115
- 'killed',
116
- 'meeting_briefing',
117
- 'meeting_ended',
118
- 'murder_witnessed',
119
- 'no_exile',
120
- 'octopus_time_start',
121
- 'role_assigned',
122
- 'speech_skipped',
123
- 'task_completed',
124
- 'task_sabotaged',
125
- 'vote_cast',
126
- 'vote_phase_start',
127
- 'vote_speech_phase_ended',
128
- 'wandering_speech',
129
- ];
130
-
131
- for (const type of backendHintedMonitorEvents) {
132
- expect(EVENT_HINT_FORMATTERS[type], type).toBeTypeOf('function');
133
- }
134
- });
135
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import { compactEventFields, formatEventMessage } from './event-format.js';
3
+ import { EVENT_HINT_FORMATTERS } from './event-hints.js';
4
+
5
+ describe('event-format', () => {
6
+ it('formats killed as a short notice with seat and removes the long backend hint tail', () => {
7
+ const event = {
8
+ type: 'killed',
9
+ tick: 5330,
10
+ room: '情报室',
11
+ killer_name: '哈基米南北绿豆',
12
+ killer_seat: 8,
13
+ hint: 'YOU ARE DEAD: 哈基米南北绿豆 removed you from play. Your hands are off the board now — alert your user, then spectate or leave while your teammates weaponize what you learned.',
14
+ };
15
+
16
+ const notice = formatEventMessage(event);
17
+ const formatted = compactEventFields(event, {}, 1158);
18
+
19
+ expect(notice).toContain('t5330 killed');
20
+ expect(notice).toContain('8号哈基米南北绿豆');
21
+ expect(formatted).not.toHaveProperty('notice');
22
+ expect(formatted.hint).toBe('YOU ARE DEAD: 8号哈基米南北绿豆 removed you from play.');
23
+ expect(JSON.stringify(formatted)).not.toContain('Your hands are off the board');
24
+ });
25
+
26
+ it('keeps meeting_briefing details aligned with the compact monitor payload', () => {
27
+ const formatted = compactEventFields({
28
+ type: 'meeting_briefing',
29
+ tick: 979,
30
+ room: '会议室',
31
+ meeting_caller_name: '单钳渔夫',
32
+ meeting_caller_seat: 1,
33
+ reported_corpses: [{ name: '丹霞兄', seat: 3 }],
34
+ your_seat: 6,
35
+ all_seats: [{ name: '单钳渔夫', seat: 1 }],
36
+ speech_order: ['单钳渔夫', '洋流王子'],
37
+ crab_teammates: [{ name: '暗礁壳壳', seat: 5 }],
38
+ hint: 'backend hint should not leak',
39
+ }, {}, 941);
40
+
41
+ expect(formatted).toMatchObject({
42
+ line: 941,
43
+ type: 'meeting_briefing',
44
+ tick: 979,
45
+ meeting_caller_name: '单钳渔夫',
46
+ meeting_caller_seat: 1,
47
+ reported_corpses: [{ name: '丹霞兄', seat: 3 }],
48
+ your_seat: 6,
49
+ all_seats: [{ name: '单钳渔夫', seat: 1 }],
50
+ speech_order: ['单钳渔夫', '洋流王子'],
51
+ crab_teammates: [{ name: '暗礁壳壳', seat: 5 }],
52
+ hint: 'Meeting started — seat 1 单钳渔夫 called this meeting after reporting the body of seat 3 丹霞兄. Your Crab teammate(s): seat 5 暗礁壳壳. Shield them, redirect heat, split suspicion, and control the vote. Prepare fast — every sentence is accusation, defense, or misdirection under a timer.',
53
+ });
54
+ expect(formatted).not.toHaveProperty('room');
55
+ expect(JSON.stringify(formatted)).not.toContain('backend hint');
56
+ });
57
+
58
+ it('hides vote targets in event details', () => {
59
+ const formatted = compactEventFields({
60
+ type: 'vote_cast',
61
+ tick: 3409,
62
+ actor_name: '菜逼油条',
63
+ actor_seat: 8,
64
+ target: '单钳渔夫',
65
+ target_name: '单钳渔夫',
66
+ target_seat: 1,
67
+ hint: 'backend target leak',
68
+ });
69
+
70
+ expect(formatted).toMatchObject({
71
+ type: 'vote_cast',
72
+ tick: 3409,
73
+ actor_name: '菜逼油条',
74
+ actor_seat: 8,
75
+ hint: '8号菜逼油条 voted.',
76
+ });
77
+ expect(formatted).not.toHaveProperty('target');
78
+ expect(formatted).not.toHaveProperty('target_name');
79
+ expect(formatted).not.toHaveProperty('target_seat');
80
+ expect(JSON.stringify(formatted)).not.toContain('单钳渔夫');
81
+ });
82
+
83
+ it('keeps monitor message formatting separate from event detail fields', () => {
84
+ const notice = formatEventMessage({
85
+ type: 'vote_phase_start',
86
+ tick: 3408,
87
+ message: 'Speech phase ended. All alive players, please cast your vote',
88
+ });
89
+
90
+ expect(notice).toContain('t3408 vote_phase_start');
91
+ expect(notice).toContain('ccl do -v');
92
+ });
93
+
94
+ it('formats corpse_spotted monitor notices as my discovery with body owner', () => {
95
+ const notice = formatEventMessage({
96
+ type: 'corpse_spotted',
97
+ tick: 3410,
98
+ corpse_name: '丹霞兄',
99
+ corpse_seat: 3,
100
+ corpse_room: '情报室',
101
+ });
102
+
103
+ expect(notice).toBe('t3410 corpse_spotted 我发现了3号丹霞兄的尸体,在情报室。');
104
+ });
105
+
106
+ it('keeps local hint formatters for backend-hinted monitor events', () => {
107
+ const backendHintedMonitorEvents = [
108
+ 'corpse_spotted',
109
+ 'death_speech',
110
+ 'emergency_resolved',
111
+ 'emergency_started',
112
+ 'exile',
113
+ 'game_over',
114
+ 'kill',
115
+ 'killed',
116
+ 'meeting_briefing',
117
+ 'meeting_ended',
118
+ 'murder_witnessed',
119
+ 'no_exile',
120
+ 'octopus_time_start',
121
+ 'role_assigned',
122
+ 'speech_skipped',
123
+ 'task_completed',
124
+ 'task_sabotaged',
125
+ 'vote_cast',
126
+ 'vote_phase_start',
127
+ 'vote_speech_phase_ended',
128
+ 'wandering_speech',
129
+ ];
130
+
131
+ for (const type of backendHintedMonitorEvents) {
132
+ expect(EVENT_HINT_FORMATTERS[type], type).toBeTypeOf('function');
133
+ }
134
+ });
135
+ });