@myclaw163/clawclaw-cli 0.6.71 → 0.6.76

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 (209) hide show
  1. package/README.md +387 -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/check-skill-command-surface.mjs +116 -0
  10. package/scripts/find-hide-spots.py +157 -157
  11. package/scripts/postinstall.mjs +20 -20
  12. package/scripts/sync-bundled-skill.mjs +245 -245
  13. package/scripts/sync-bundled-skill.test.mjs +152 -152
  14. package/skills/clawclaw/SKILL.md +248 -244
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  16. package/skills/clawclaw/references/COMMANDS.md +160 -148
  17. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  18. package/skills/clawclaw/references/HUB.md +48 -48
  19. package/skills/clawclaw/references/KNOWLEDGE.md +42 -45
  20. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  21. package/skills/clawclaw/references/STREAM.md +93 -91
  22. package/skills/clawclaw/references/TACTICS.md +65 -65
  23. package/src/assets/clawclaw-ascii-map.txt +40 -40
  24. package/src/cli.ts +112 -110
  25. package/src/commands/_schema.ts +124 -109
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/data.test.ts +33 -0
  28. package/src/commands/data.ts +22 -0
  29. package/src/commands/do.test.ts +84 -73
  30. package/src/commands/do.ts +130 -126
  31. package/src/commands/events.test.ts +100 -71
  32. package/src/commands/events.ts +250 -155
  33. package/src/commands/game-map.test.ts +28 -28
  34. package/src/commands/game-start-plan.test.ts +84 -84
  35. package/src/commands/game.ts +1113 -1047
  36. package/src/commands/history-player.test.ts +102 -102
  37. package/src/commands/history.ts +573 -573
  38. package/src/commands/hub.test.ts +96 -96
  39. package/src/commands/hub.ts +234 -234
  40. package/src/commands/knowledge.test.ts +13 -13
  41. package/src/commands/knowledge.ts +139 -139
  42. package/src/commands/load.test.ts +51 -51
  43. package/src/commands/load.ts +13 -13
  44. package/src/commands/meeting-history.test.ts +106 -106
  45. package/src/commands/memory.ts +40 -40
  46. package/src/commands/peek.ts +45 -45
  47. package/src/commands/persona.ts +57 -57
  48. package/src/commands/setup/codex.ts +266 -266
  49. package/src/commands/skill.ts +128 -128
  50. package/src/commands/state.ts +46 -46
  51. package/src/commands/strategy.test.ts +153 -145
  52. package/src/commands/strategy.ts +183 -181
  53. package/src/commands/tts.ts +128 -128
  54. package/src/commands/upgrade.test.ts +82 -82
  55. package/src/commands/upgrade.ts +148 -148
  56. package/src/commands/watch.test.ts +999 -977
  57. package/src/commands/watch.ts +660 -658
  58. package/src/lib/auth.test.ts +86 -74
  59. package/src/lib/auth.ts +223 -186
  60. package/src/lib/command-meta.ts +37 -37
  61. package/src/lib/game-client.ts +403 -391
  62. package/src/lib/game-context.ts +92 -0
  63. package/src/lib/http-keepalive.ts +15 -15
  64. package/src/lib/http-transport.test.ts +42 -42
  65. package/src/lib/http-transport.ts +113 -113
  66. package/src/lib/hub-client.test.ts +56 -56
  67. package/src/lib/hub-client.ts +88 -88
  68. package/src/lib/hub-install.test.ts +98 -98
  69. package/src/lib/hub-install.ts +160 -121
  70. package/src/lib/hub-reminder.ts +78 -75
  71. package/src/lib/hub-unzip.test.ts +69 -69
  72. package/src/lib/hub-unzip.ts +62 -62
  73. package/src/lib/init-command.test.ts +75 -75
  74. package/src/lib/init-command.ts +130 -120
  75. package/src/lib/knowledge-store.test.ts +170 -170
  76. package/src/lib/knowledge-store.ts +369 -369
  77. package/src/lib/load-context.test.ts +52 -52
  78. package/src/lib/load-context.ts +52 -52
  79. package/src/lib/match-state.test.ts +134 -134
  80. package/src/lib/match-state.ts +94 -94
  81. package/src/lib/netease-tts.ts +83 -83
  82. package/src/lib/normalize.ts +42 -42
  83. package/src/lib/persona.test.ts +41 -41
  84. package/src/lib/persona.ts +72 -72
  85. package/src/lib/server-registry.ts +152 -152
  86. package/src/lib/skill-version.test.ts +48 -48
  87. package/src/lib/skill-version.ts +19 -19
  88. package/src/lib/strategy-export.test.ts +240 -232
  89. package/src/lib/strategy-export.ts +247 -242
  90. package/src/lib/tts-keys.ts +7 -7
  91. package/src/lib/tts-speech.test.ts +63 -63
  92. package/src/lib/tts-speech.ts +76 -76
  93. package/src/lib/user-data.test.ts +96 -0
  94. package/src/lib/user-data.ts +400 -0
  95. package/src/lib/workspace-argv.test.ts +49 -49
  96. package/src/lib/workspace-argv.ts +44 -44
  97. package/src/perception/player-history-store.test.ts +87 -87
  98. package/src/perception/player-history-store.ts +194 -194
  99. package/src/pipeline/event-format.test.ts +243 -215
  100. package/src/pipeline/event-format.ts +501 -485
  101. package/src/pipeline/event-hints.ts +195 -190
  102. package/src/pipeline/event-store.test.ts +28 -28
  103. package/src/pipeline/event-store.ts +193 -193
  104. package/src/pipeline/pipeline.ts +35 -35
  105. package/src/pipeline/player-projection.test.ts +168 -0
  106. package/src/pipeline/player-projection.ts +370 -0
  107. package/src/runtime/auto-upgrade.test.ts +66 -66
  108. package/src/runtime/auto-upgrade.ts +31 -31
  109. package/src/runtime/event-daemon.test.ts +209 -141
  110. package/src/runtime/event-daemon.ts +519 -457
  111. package/src/runtime/owner-control.ts +150 -150
  112. package/src/runtime/raw-ws-log.test.ts +33 -33
  113. package/src/runtime/raw-ws-log.ts +32 -32
  114. package/src/runtime/runtime-logger.ts +107 -107
  115. package/src/runtime/ws-client.test.ts +125 -104
  116. package/src/runtime/ws-client.ts +287 -272
  117. package/src/sdk/action.ts +166 -166
  118. package/src/sdk/index.ts +110 -110
  119. package/src/sdk/types.ts +161 -161
  120. package/src/strategies/avoid-lone.ts +12 -12
  121. package/src/strategies/avoid-players.knowledge.md +19 -19
  122. package/src/strategies/avoid-players.ts +16 -16
  123. package/src/strategies/corpse-patrol.ts +23 -23
  124. package/src/strategies/crab-sabotage.ts +22 -22
  125. package/src/strategies/custom-module.test.ts +270 -270
  126. package/src/strategies/find-player.ts +17 -17
  127. package/src/strategies/game-utils.test.ts +242 -242
  128. package/src/strategies/game-utils.ts +846 -846
  129. package/src/strategies/goals/anchor-linger.ts +77 -77
  130. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  131. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  132. package/src/strategies/goals/avoid-players-top.ts +121 -121
  133. package/src/strategies/goals/conversation-goal.ts +51 -51
  134. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  135. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  136. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  137. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  138. package/src/strategies/goals/find-player-top.ts +93 -93
  139. package/src/strategies/goals/flee-players-goal.ts +53 -53
  140. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  141. package/src/strategies/goals/goal-manager.ts +41 -41
  142. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  143. package/src/strategies/goals/goal.ts +28 -28
  144. package/src/strategies/goals/hide-top.ts +197 -197
  145. package/src/strategies/goals/keep-away-goal.ts +221 -221
  146. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  147. package/src/strategies/goals/kill-lone-top.ts +160 -160
  148. package/src/strategies/goals/kill-target-goal.ts +59 -59
  149. package/src/strategies/goals/kill-target-top.ts +109 -109
  150. package/src/strategies/goals/leaf-goal.ts +27 -27
  151. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  152. package/src/strategies/goals/lone-kill-core.ts +82 -82
  153. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  154. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  155. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  156. package/src/strategies/goals/move-room-goal.ts +60 -60
  157. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  158. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  159. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  160. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  161. package/src/strategies/goals/patrol-top.ts +57 -57
  162. package/src/strategies/goals/report-patrol-top.ts +80 -80
  163. package/src/strategies/goals/safe-task-goal.ts +102 -102
  164. package/src/strategies/goals/social-task-top.ts +161 -161
  165. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  166. package/src/strategies/goals/task-only-top.ts +57 -57
  167. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  168. package/src/strategies/goals/task-report-top.ts +57 -57
  169. package/src/strategies/goals/wander-task-goal.ts +33 -33
  170. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  171. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  172. package/src/strategies/greeting.ts +53 -53
  173. package/src/strategies/hide-spots.ts +59 -59
  174. package/src/strategies/hide.ts +24 -24
  175. package/src/strategies/kill-frenzy.ts +13 -13
  176. package/src/strategies/kill-lone.knowledge.md +17 -17
  177. package/src/strategies/kill-lone.ts +14 -14
  178. package/src/strategies/kill-target.ts +19 -19
  179. package/src/strategies/loader.test.ts +678 -678
  180. package/src/strategies/loader.ts +181 -179
  181. package/src/strategies/lone-kill-task.ts +22 -22
  182. package/src/strategies/meeting-gate.test.ts +59 -59
  183. package/src/strategies/meeting-gate.ts +23 -23
  184. package/src/strategies/move-room.ts +16 -16
  185. package/src/strategies/new-events-backfill.ts +98 -98
  186. package/src/strategies/off-route-points.ts +105 -105
  187. package/src/strategies/paradise-fish.knowledge.md +19 -19
  188. package/src/strategies/paradise-fish.ts +26 -26
  189. package/src/strategies/pathfind/distance-field.ts +150 -150
  190. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  191. package/src/strategies/pathfind/escape-planner.ts +355 -355
  192. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  193. package/src/strategies/patrol.ts +12 -12
  194. package/src/strategies/player-targets.ts +13 -13
  195. package/src/strategies/report-patrol.ts +12 -12
  196. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  197. package/src/strategies/shrimp-memory.ts +26 -26
  198. package/src/strategies/social-task.test.ts +28 -28
  199. package/src/strategies/social-task.ts +50 -50
  200. package/src/strategies/spawn.ts +82 -82
  201. package/src/strategies/speech-module.ts +123 -123
  202. package/src/strategies/strategy-loop.test.ts +15 -0
  203. package/src/strategies/strategy-loop.ts +776 -771
  204. package/src/strategies/task-kill-report.ts +18 -18
  205. package/src/strategies/task-only.ts +12 -12
  206. package/src/strategies/task-report.ts +23 -23
  207. package/src/strategies/types.ts +109 -109
  208. package/src/strategies/warrior-memory.knowledge.md +21 -21
  209. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,141 +1,209 @@
1
- import { mkdtempSync, rmSync } from 'fs';
2
- import { tmpdir } from 'os';
3
- import { join } from 'path';
4
- import { afterEach, describe, expect, it, vi } from 'vitest';
5
- import { buildMeetingStateProjection, EventRuntime } from './event-daemon.js';
6
-
7
- const tempDirs: string[] = [];
8
-
9
- function makeRuntimeHarness() {
10
- const dir = mkdtempSync(join(tmpdir(), 'ccl-event-runtime-'));
11
- tempDirs.push(dir);
12
- const appended: Record<string, any>[] = [];
13
- const stops: string[] = [];
14
- const runtime = new EventRuntime({
15
- onStop: (stop) => stops.push(stop.reason),
16
- });
17
- (runtime as any).events = { append: vi.fn((event) => appended.push(event)) };
18
- (runtime as any).feedPath = join(dir, 'feed.json');
19
- (runtime as any).profileName = 'me';
20
- return { runtime, appended, stops };
21
- }
22
-
23
- afterEach(() => {
24
- while (tempDirs.length) {
25
- const dir = tempDirs.pop();
26
- if (dir) rmSync(dir, { recursive: true, force: true });
27
- }
28
- });
29
-
30
- describe('buildMeetingStateProjection', () => {
31
- it('keeps meeting state fields without historical speech text', () => {
32
- expect(buildMeetingStateProjection({
33
- caller: 'A',
34
- sub_phase: 'speech',
35
- first_speaker: 'A',
36
- speech_order: ['A', 'B'],
37
- current_speaker: 'B',
38
- speeches_so_far: { A: 'hello' },
39
- speech_skipped: ['C'],
40
- votes_submitted: ['A'],
41
- alive_players: ['A', 'B'],
42
- countdown: 12,
43
- })).toEqual({
44
- caller: 'A',
45
- sub_phase: 'speech',
46
- first_speaker: 'A',
47
- speech_order: ['A', 'B'],
48
- current_speaker: 'B',
49
- speech_skipped: ['C'],
50
- votes_submitted: ['A'],
51
- alive_players: ['A', 'B'],
52
- });
53
- });
54
- });
55
-
56
- describe('EventRuntime map seat cache', () => {
57
- it('keeps opening map seats in the owner snapshot for formatters', async () => {
58
- const { runtime } = makeRuntimeHarness();
59
- const updateMapCache = vi.fn();
60
- (runtime as any).client = {
61
- getMap: vi.fn().mockResolvedValue({
62
- all_players: [
63
- { name: 'me', seat: 6 },
64
- { name: '菜逼油条', seat: 8 },
65
- ],
66
- all_task_locations: [],
67
- }),
68
- };
69
- (runtime as any).playerHistory = { updateMapCache };
70
-
71
- (runtime as any).refreshPlayerHistoryMapCache();
72
- await new Promise((resolve) => setTimeout(resolve, 0));
73
-
74
- expect((runtime as any).currentGame).toMatchObject({
75
- all_players: [
76
- { name: 'me', seat: 6 },
77
- { name: '菜逼油条', seat: 8 },
78
- ],
79
- all_seats: {
80
- me: 6,
81
- 菜逼油条: 8,
82
- },
83
- });
84
- expect((runtime as any).currentYou.seat).toBe(6);
85
- expect((runtime as any).snapshot()?.game?.all_seats?.菜逼油条).toBe(8);
86
- expect(updateMapCache).toHaveBeenCalled();
87
- });
88
- });
89
-
90
- describe('EventRuntime game over detection', () => {
91
- it('stops when a state snapshot phase is game_over even without a game_over event', () => {
92
- const { runtime, appended, stops } = makeRuntimeHarness();
93
-
94
- (runtime as any).handleEvent({
95
- type: '_state',
96
- phase: 'game_over',
97
- tick: 12,
98
- winner: 'crab',
99
- reason: 'all_lobsters_dead',
100
- });
101
-
102
- expect(appended).toEqual(expect.arrayContaining([
103
- expect.objectContaining({
104
- type: 'game_over',
105
- synthetic: true,
106
- source: '_state',
107
- tick: 12,
108
- winner: 'crab',
109
- reason: 'all_lobsters_dead',
110
- }),
111
- expect.objectContaining({
112
- type: 'event_runtime_stopped',
113
- reason: 'game_over',
114
- }),
115
- ]));
116
- expect(stops).toEqual(['game_over']);
117
- });
118
-
119
- it('stops when state.new_events has already been dispatched as a game_over event', () => {
120
- const { runtime, appended, stops } = makeRuntimeHarness();
121
-
122
- (runtime as any).handleEvent({
123
- type: 'game_over',
124
- tick: 13,
125
- winner: 'lobster',
126
- });
127
-
128
- expect(appended).toEqual(expect.arrayContaining([
129
- expect.objectContaining({
130
- type: 'game_over',
131
- tick: 13,
132
- winner: 'lobster',
133
- }),
134
- expect.objectContaining({
135
- type: 'event_runtime_stopped',
136
- reason: 'game_over',
137
- }),
138
- ]));
139
- expect(stops).toEqual(['game_over']);
140
- });
141
- });
1
+ import { mkdtempSync, rmSync } from 'fs';
2
+ import { tmpdir } from 'os';
3
+ import { join } from 'path';
4
+ import { afterEach, describe, expect, it, vi } from 'vitest';
5
+ import { buildMeetingStateProjection, EventRuntime } from './event-daemon.js';
6
+
7
+ const tempDirs: string[] = [];
8
+
9
+ function makeRuntimeHarness() {
10
+ const dir = mkdtempSync(join(tmpdir(), 'ccl-event-runtime-'));
11
+ tempDirs.push(dir);
12
+ const appended: Record<string, any>[] = [];
13
+ const stops: string[] = [];
14
+ const runtime = new EventRuntime({
15
+ onStop: (stop) => stops.push(stop.reason),
16
+ });
17
+ (runtime as any).events = { append: vi.fn((event) => appended.push(event)) };
18
+ (runtime as any).feedPath = join(dir, 'feed.json');
19
+ (runtime as any).profileName = 'me';
20
+ return { runtime, appended, stops };
21
+ }
22
+
23
+ afterEach(() => {
24
+ while (tempDirs.length) {
25
+ const dir = tempDirs.pop();
26
+ if (dir) rmSync(dir, { recursive: true, force: true });
27
+ }
28
+ });
29
+
30
+ describe('buildMeetingStateProjection', () => {
31
+ it('keeps meeting state fields without historical speech text', () => {
32
+ expect(buildMeetingStateProjection({
33
+ caller: 'A',
34
+ sub_phase: 'speech',
35
+ first_speaker: 'A',
36
+ speech_order: ['A', 'B'],
37
+ current_speaker: 'B',
38
+ speeches_so_far: { A: 'hello' },
39
+ speech_skipped: ['C'],
40
+ votes_submitted: ['A'],
41
+ alive_players: ['A', 'B'],
42
+ countdown: 12,
43
+ })).toEqual({
44
+ caller: 'A',
45
+ sub_phase: 'speech',
46
+ first_speaker: 'A',
47
+ speech_order: ['A', 'B'],
48
+ current_speaker: 'B',
49
+ speech_skipped: ['C'],
50
+ votes_submitted: ['A'],
51
+ alive_players: ['A', 'B'],
52
+ });
53
+ });
54
+ });
55
+
56
+ describe('EventRuntime map seat cache', () => {
57
+ it('keeps opening map seats in the owner snapshot for formatters', async () => {
58
+ const { runtime } = makeRuntimeHarness();
59
+ const updateMapCache = vi.fn();
60
+ (runtime as any).client = {
61
+ getMap: vi.fn().mockResolvedValue({
62
+ all_players: [
63
+ { name: 'me', seat: 6 },
64
+ { name: '菜逼油条', seat: 8 },
65
+ ],
66
+ all_task_locations: [],
67
+ }),
68
+ };
69
+ (runtime as any).playerHistory = { updateMapCache };
70
+
71
+ (runtime as any).refreshPlayerHistoryMapCache();
72
+ await new Promise((resolve) => setTimeout(resolve, 0));
73
+
74
+ expect((runtime as any).currentGame).toMatchObject({
75
+ all_players: [
76
+ { name: 'me', seat: 6 },
77
+ { name: '菜逼油条', seat: 8 },
78
+ ],
79
+ all_seats: {
80
+ me: 6,
81
+ 菜逼油条: 8,
82
+ },
83
+ });
84
+ expect((runtime as any).currentYou.seat).toBe(6);
85
+ expect((runtime as any).snapshot()?.game?.all_seats?.菜逼油条).toBe(8);
86
+ expect(updateMapCache).toHaveBeenCalled();
87
+ });
88
+ });
89
+
90
+ describe('EventRuntime game over detection', () => {
91
+ it('stops when a state snapshot phase is game_over even without a game_over event', () => {
92
+ const { runtime, appended, stops } = makeRuntimeHarness();
93
+
94
+ (runtime as any).handleEvent({
95
+ type: '_state',
96
+ phase: 'game_over',
97
+ tick: 12,
98
+ winner: 'crab',
99
+ reason: 'all_lobsters_dead',
100
+ });
101
+
102
+ expect(appended).toEqual(expect.arrayContaining([
103
+ expect.objectContaining({
104
+ type: 'game_over',
105
+ synthetic: true,
106
+ source: '_state',
107
+ tick: 12,
108
+ winner: 'crab',
109
+ reason: 'all_lobsters_dead',
110
+ }),
111
+ expect.objectContaining({
112
+ type: 'event_runtime_stopped',
113
+ reason: 'game_over',
114
+ }),
115
+ ]));
116
+ expect(stops).toEqual(['game_over']);
117
+ });
118
+
119
+ it('stops when state.new_events has already been dispatched as a game_over event', () => {
120
+ const { runtime, appended, stops } = makeRuntimeHarness();
121
+
122
+ (runtime as any).handleEvent({
123
+ type: 'game_over',
124
+ tick: 13,
125
+ winner: 'lobster',
126
+ });
127
+
128
+ expect(appended).toEqual(expect.arrayContaining([
129
+ expect.objectContaining({
130
+ type: 'game_over',
131
+ tick: 13,
132
+ winner: 'lobster',
133
+ }),
134
+ expect.objectContaining({
135
+ type: 'event_runtime_stopped',
136
+ reason: 'game_over',
137
+ }),
138
+ ]));
139
+ expect(stops).toEqual(['game_over']);
140
+ });
141
+ });
142
+
143
+ describe('EventRuntime user-left-game detection', () => {
144
+ it('stops after writing user_left_game for a 1000 Left game WS close', () => {
145
+ const { runtime, appended, stops } = makeRuntimeHarness();
146
+ (runtime as any).currentPhase = 'wandering';
147
+ (runtime as any).currentTick = 42;
148
+ (runtime as any).currentYou = { name: 'me' };
149
+
150
+ (runtime as any).handleWsClose({ code: 1000, reason: 'Left game', wasClean: true });
151
+
152
+ expect(appended).toEqual(expect.arrayContaining([
153
+ expect.objectContaining({
154
+ type: 'user_left_game',
155
+ synthetic: true,
156
+ source: 'ws_close',
157
+ close_code: 1000,
158
+ close_reason: 'Left game',
159
+ message: 'The user left the game from the web page. This match has ended; stop playing and do not restart unless the user asks.',
160
+ phase: 'wandering',
161
+ tick: 42,
162
+ player_name: 'me',
163
+ }),
164
+ expect.objectContaining({
165
+ type: 'event_runtime_stopped',
166
+ reason: 'user_left_game',
167
+ }),
168
+ ]));
169
+ expect(stops).toEqual(['user_left_game']);
170
+ expect((runtime as any).latestFeed.phase).toBe('user_left_game');
171
+ });
172
+
173
+ it('treats Already left the game close as user_left_game', () => {
174
+ const { runtime, appended, stops } = makeRuntimeHarness();
175
+
176
+ (runtime as any).handleWsClose({ code: 4001, reason: 'Already left the game' });
177
+
178
+ expect(appended).toEqual(expect.arrayContaining([
179
+ expect.objectContaining({
180
+ type: 'user_left_game',
181
+ close_code: 4001,
182
+ close_reason: 'Already left the game',
183
+ already_left: true,
184
+ }),
185
+ ]));
186
+ expect(stops).toEqual(['user_left_game']);
187
+ });
188
+ });
189
+
190
+ describe('EventRuntime event dedup', () => {
191
+ it('does not append repeated runtime events with the same key', () => {
192
+ const { runtime, appended } = makeRuntimeHarness();
193
+
194
+ (runtime as any).handleEvent({ type: 'game_started', tick: 0, player_count: 10 });
195
+ (runtime as any).handleEvent({ type: 'game_started', tick: 0, player_count: 10 });
196
+ (runtime as any).handleEvent({ type: 'role_assigned', tick: 0, role: 'shrimp_generic' });
197
+ (runtime as any).handleEvent({ type: 'role_assigned', tick: 0, role: 'shrimp_generic' });
198
+ (runtime as any).handleEvent({ type: 'player_spotted', tick: 7, spotted_name: 'A' });
199
+ (runtime as any).handleEvent({ type: 'player_spotted', tick: 7, spotted_name: 'A' });
200
+ (runtime as any).handleEvent({ type: 'player_spotted', tick: 7, spotted_name: 'B' });
201
+
202
+ expect(appended.map((event) => [event.type, event.tick, event.spotted_name])).toEqual([
203
+ ['game_started', 0, undefined],
204
+ ['role_assigned', 0, undefined],
205
+ ['player_spotted', 7, 'A'],
206
+ ['player_spotted', 7, 'B'],
207
+ ]);
208
+ });
209
+ });