@myclaw163/clawclaw-cli 0.6.64 → 0.6.66

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 (206) hide show
  1. package/README.md +427 -427
  2. package/package.json +48 -48
  3. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  4. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  5. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  6. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  7. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  8. package/scripts/find-hide-spots.py +157 -157
  9. package/scripts/postinstall.mjs +20 -20
  10. package/scripts/sync-bundled-skill.mjs +244 -244
  11. package/scripts/sync-bundled-skill.test.mjs +152 -152
  12. package/skills/clawclaw/SKILL.md +245 -244
  13. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  14. package/skills/clawclaw/references/COMMANDS.md +148 -148
  15. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -186
  16. package/skills/clawclaw/references/HUB.md +48 -48
  17. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  18. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  19. package/skills/clawclaw/references/STREAM.md +92 -92
  20. package/skills/clawclaw/references/TACTICS.md +65 -65
  21. package/src/assets/clawclaw-ascii-map.txt +40 -40
  22. package/src/cli.ts +110 -110
  23. package/src/commands/_schema.ts +109 -109
  24. package/src/commands/account.ts +209 -209
  25. package/src/commands/config.ts +30 -30
  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 +248 -248
  46. package/src/commands/setup/hermes.test.ts +96 -96
  47. package/src/commands/setup/hermes.ts +76 -76
  48. package/src/commands/setup/index.ts +13 -13
  49. package/src/commands/setup/openclaw.test.ts +114 -114
  50. package/src/commands/setup/openclaw.ts +147 -147
  51. package/src/commands/skill.ts +128 -128
  52. package/src/commands/state.ts +46 -46
  53. package/src/commands/strategy.test.ts +135 -135
  54. package/src/commands/strategy.ts +180 -180
  55. package/src/commands/tts.ts +128 -128
  56. package/src/commands/upgrade.test.ts +82 -82
  57. package/src/commands/upgrade.ts +148 -148
  58. package/src/commands/watch.test.ts +966 -966
  59. package/src/commands/watch.ts +659 -659
  60. package/src/lib/auth.test.ts +59 -59
  61. package/src/lib/auth.ts +186 -186
  62. package/src/lib/command-meta.ts +37 -37
  63. package/src/lib/game-client.ts +391 -391
  64. package/src/lib/host-config-patcher.test.ts +130 -130
  65. package/src/lib/host-config-patcher.ts +151 -151
  66. package/src/lib/http-keepalive.ts +15 -15
  67. package/src/lib/http-transport.test.ts +42 -42
  68. package/src/lib/http-transport.ts +113 -113
  69. package/src/lib/hub-client.test.ts +56 -56
  70. package/src/lib/hub-client.ts +88 -88
  71. package/src/lib/hub-install.test.ts +98 -98
  72. package/src/lib/hub-install.ts +121 -121
  73. package/src/lib/hub-reminder.ts +56 -56
  74. package/src/lib/hub-unzip.test.ts +69 -69
  75. package/src/lib/hub-unzip.ts +62 -62
  76. package/src/lib/init-command.test.ts +75 -75
  77. package/src/lib/init-command.ts +120 -120
  78. package/src/lib/knowledge-store.test.ts +180 -180
  79. package/src/lib/knowledge-store.ts +374 -374
  80. package/src/lib/load-context.test.ts +52 -52
  81. package/src/lib/load-context.ts +52 -52
  82. package/src/lib/match-state.test.ts +134 -134
  83. package/src/lib/match-state.ts +94 -94
  84. package/src/lib/netease-tts.ts +83 -83
  85. package/src/lib/normalize.ts +42 -42
  86. package/src/lib/persona.test.ts +41 -41
  87. package/src/lib/persona.ts +72 -72
  88. package/src/lib/server-registry.ts +152 -152
  89. package/src/lib/skill-version.test.ts +48 -48
  90. package/src/lib/skill-version.ts +19 -19
  91. package/src/lib/strategy-export.test.ts +232 -232
  92. package/src/lib/strategy-export.ts +242 -242
  93. package/src/lib/tts-keys.ts +7 -7
  94. package/src/lib/tts-speech.test.ts +63 -63
  95. package/src/lib/tts-speech.ts +76 -76
  96. package/src/lib/workspace-argv.test.ts +49 -49
  97. package/src/lib/workspace-argv.ts +44 -44
  98. package/src/perception/player-history-store.test.ts +87 -87
  99. package/src/perception/player-history-store.ts +194 -194
  100. package/src/pipeline/event-format.test.ts +135 -135
  101. package/src/pipeline/event-format.ts +376 -376
  102. package/src/pipeline/event-hints.ts +173 -173
  103. package/src/pipeline/event-store.test.ts +28 -28
  104. package/src/pipeline/event-store.ts +193 -193
  105. package/src/pipeline/pipeline.ts +35 -35
  106. package/src/runtime/auto-upgrade.test.ts +66 -66
  107. package/src/runtime/auto-upgrade.ts +31 -31
  108. package/src/runtime/event-daemon.test.ts +107 -107
  109. package/src/runtime/event-daemon.ts +409 -409
  110. package/src/runtime/owner-control.ts +150 -150
  111. package/src/runtime/raw-ws-log.test.ts +33 -33
  112. package/src/runtime/raw-ws-log.ts +32 -32
  113. package/src/runtime/runtime-logger.ts +107 -107
  114. package/src/runtime/ws-client.test.ts +104 -104
  115. package/src/runtime/ws-client.ts +272 -272
  116. package/src/sdk/action.ts +166 -166
  117. package/src/sdk/index.ts +111 -111
  118. package/src/sdk/types.ts +159 -159
  119. package/src/strategies/avoid-lone.ts +11 -11
  120. package/src/strategies/avoid-players.knowledge.md +20 -20
  121. package/src/strategies/avoid-players.ts +15 -15
  122. package/src/strategies/corpse-patrol.ts +22 -22
  123. package/src/strategies/crab-sabotage.ts +21 -21
  124. package/src/strategies/custom-module.test.ts +269 -269
  125. package/src/strategies/find-player.ts +16 -16
  126. package/src/strategies/game-utils.test.ts +190 -190
  127. package/src/strategies/game-utils.ts +782 -782
  128. package/src/strategies/goals/anchor-linger.ts +77 -77
  129. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  130. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  131. package/src/strategies/goals/avoid-players-top.ts +121 -121
  132. package/src/strategies/goals/conversation-goal.ts +51 -51
  133. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  134. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  135. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  136. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  137. package/src/strategies/goals/find-player-top.ts +93 -93
  138. package/src/strategies/goals/flee-players-goal.ts +53 -53
  139. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  140. package/src/strategies/goals/goal-manager.ts +41 -41
  141. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  142. package/src/strategies/goals/goal.ts +28 -28
  143. package/src/strategies/goals/hide-top.ts +197 -197
  144. package/src/strategies/goals/keep-away-goal.ts +217 -217
  145. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  146. package/src/strategies/goals/kill-lone-top.ts +160 -160
  147. package/src/strategies/goals/kill-target-goal.ts +59 -59
  148. package/src/strategies/goals/kill-target-top.ts +109 -109
  149. package/src/strategies/goals/leaf-goal.ts +25 -25
  150. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  151. package/src/strategies/goals/lone-kill-core.ts +82 -82
  152. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  153. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  154. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  155. package/src/strategies/goals/move-room-goal.ts +60 -60
  156. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  157. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  158. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  159. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  160. package/src/strategies/goals/patrol-top.ts +57 -57
  161. package/src/strategies/goals/report-patrol-top.ts +80 -80
  162. package/src/strategies/goals/safe-task-goal.ts +102 -102
  163. package/src/strategies/goals/social-task-top.ts +161 -161
  164. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  165. package/src/strategies/goals/task-only-top.ts +57 -57
  166. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  167. package/src/strategies/goals/task-report-top.ts +57 -57
  168. package/src/strategies/goals/wander-task-goal.ts +33 -33
  169. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  170. package/src/strategies/goals/warrior-shrimp-top.ts +500 -497
  171. package/src/strategies/greeting.ts +53 -53
  172. package/src/strategies/hide-spots.ts +123 -123
  173. package/src/strategies/hide.ts +23 -23
  174. package/src/strategies/kill-frenzy.ts +12 -12
  175. package/src/strategies/kill-lone.knowledge.md +20 -20
  176. package/src/strategies/kill-lone.ts +13 -13
  177. package/src/strategies/kill-target.ts +18 -18
  178. package/src/strategies/loader.test.ts +678 -678
  179. package/src/strategies/loader.ts +172 -172
  180. package/src/strategies/lone-kill-task.ts +21 -21
  181. package/src/strategies/meeting-gate.test.ts +59 -59
  182. package/src/strategies/meeting-gate.ts +23 -23
  183. package/src/strategies/move-room.ts +15 -15
  184. package/src/strategies/new-events-backfill.ts +98 -98
  185. package/src/strategies/paradise-fish.knowledge.md +20 -20
  186. package/src/strategies/paradise-fish.ts +25 -25
  187. package/src/strategies/pathfind/distance-field.ts +150 -150
  188. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  189. package/src/strategies/pathfind/escape-planner.ts +355 -355
  190. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  191. package/src/strategies/patrol.ts +11 -11
  192. package/src/strategies/player-targets.ts +13 -13
  193. package/src/strategies/report-patrol.ts +11 -11
  194. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  195. package/src/strategies/shrimp-memory.ts +25 -25
  196. package/src/strategies/social-task.test.ts +28 -28
  197. package/src/strategies/social-task.ts +49 -49
  198. package/src/strategies/spawn.ts +82 -82
  199. package/src/strategies/speech-module.ts +123 -123
  200. package/src/strategies/strategy-loop.ts +771 -771
  201. package/src/strategies/task-kill-report.ts +17 -17
  202. package/src/strategies/task-only.ts +11 -11
  203. package/src/strategies/task-report.ts +22 -22
  204. package/src/strategies/types.ts +102 -102
  205. package/src/strategies/warrior-memory.knowledge.md +22 -22
  206. 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
+ });