@myclaw163/clawclaw-cli 0.6.71 → 0.6.74

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 (205) hide show
  1. package/README.md +377 -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 +246 -244
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  16. package/skills/clawclaw/references/COMMANDS.md +155 -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 +110 -110
  25. package/src/commands/_schema.ts +124 -109
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/do.test.ts +84 -73
  28. package/src/commands/do.ts +130 -126
  29. package/src/commands/events.test.ts +71 -71
  30. package/src/commands/events.ts +221 -155
  31. package/src/commands/game-map.test.ts +28 -28
  32. package/src/commands/game-start-plan.test.ts +84 -84
  33. package/src/commands/game.ts +1113 -1047
  34. package/src/commands/history-player.test.ts +102 -102
  35. package/src/commands/history.ts +573 -573
  36. package/src/commands/hub.test.ts +96 -96
  37. package/src/commands/hub.ts +234 -234
  38. package/src/commands/knowledge.test.ts +13 -13
  39. package/src/commands/knowledge.ts +139 -139
  40. package/src/commands/load.test.ts +51 -51
  41. package/src/commands/load.ts +13 -13
  42. package/src/commands/meeting-history.test.ts +106 -106
  43. package/src/commands/memory.ts +40 -40
  44. package/src/commands/peek.ts +45 -45
  45. package/src/commands/persona.ts +57 -57
  46. package/src/commands/setup/codex.ts +266 -266
  47. package/src/commands/skill.ts +128 -128
  48. package/src/commands/state.ts +46 -46
  49. package/src/commands/strategy.test.ts +145 -145
  50. package/src/commands/strategy.ts +181 -181
  51. package/src/commands/tts.ts +128 -128
  52. package/src/commands/upgrade.test.ts +82 -82
  53. package/src/commands/upgrade.ts +148 -148
  54. package/src/commands/watch.test.ts +999 -977
  55. package/src/commands/watch.ts +660 -658
  56. package/src/lib/auth.test.ts +74 -74
  57. package/src/lib/auth.ts +186 -186
  58. package/src/lib/command-meta.ts +37 -37
  59. package/src/lib/game-client.ts +403 -391
  60. package/src/lib/game-context.ts +92 -0
  61. package/src/lib/http-keepalive.ts +15 -15
  62. package/src/lib/http-transport.test.ts +42 -42
  63. package/src/lib/http-transport.ts +113 -113
  64. package/src/lib/hub-client.test.ts +56 -56
  65. package/src/lib/hub-client.ts +88 -88
  66. package/src/lib/hub-install.test.ts +98 -98
  67. package/src/lib/hub-install.ts +121 -121
  68. package/src/lib/hub-reminder.ts +75 -75
  69. package/src/lib/hub-unzip.test.ts +69 -69
  70. package/src/lib/hub-unzip.ts +62 -62
  71. package/src/lib/init-command.test.ts +75 -75
  72. package/src/lib/init-command.ts +120 -120
  73. package/src/lib/knowledge-store.test.ts +170 -170
  74. package/src/lib/knowledge-store.ts +369 -369
  75. package/src/lib/load-context.test.ts +52 -52
  76. package/src/lib/load-context.ts +52 -52
  77. package/src/lib/match-state.test.ts +134 -134
  78. package/src/lib/match-state.ts +94 -94
  79. package/src/lib/netease-tts.ts +83 -83
  80. package/src/lib/normalize.ts +42 -42
  81. package/src/lib/persona.test.ts +41 -41
  82. package/src/lib/persona.ts +72 -72
  83. package/src/lib/server-registry.ts +152 -152
  84. package/src/lib/skill-version.test.ts +48 -48
  85. package/src/lib/skill-version.ts +19 -19
  86. package/src/lib/strategy-export.test.ts +232 -232
  87. package/src/lib/strategy-export.ts +242 -242
  88. package/src/lib/tts-keys.ts +7 -7
  89. package/src/lib/tts-speech.test.ts +63 -63
  90. package/src/lib/tts-speech.ts +76 -76
  91. package/src/lib/workspace-argv.test.ts +49 -49
  92. package/src/lib/workspace-argv.ts +44 -44
  93. package/src/perception/player-history-store.test.ts +87 -87
  94. package/src/perception/player-history-store.ts +194 -194
  95. package/src/pipeline/event-format.test.ts +243 -215
  96. package/src/pipeline/event-format.ts +501 -485
  97. package/src/pipeline/event-hints.ts +195 -190
  98. package/src/pipeline/event-store.test.ts +28 -28
  99. package/src/pipeline/event-store.ts +193 -193
  100. package/src/pipeline/pipeline.ts +35 -35
  101. package/src/pipeline/player-projection.test.ts +119 -0
  102. package/src/pipeline/player-projection.ts +380 -0
  103. package/src/runtime/auto-upgrade.test.ts +66 -66
  104. package/src/runtime/auto-upgrade.ts +31 -31
  105. package/src/runtime/event-daemon.test.ts +209 -141
  106. package/src/runtime/event-daemon.ts +519 -457
  107. package/src/runtime/owner-control.ts +150 -150
  108. package/src/runtime/raw-ws-log.test.ts +33 -33
  109. package/src/runtime/raw-ws-log.ts +32 -32
  110. package/src/runtime/runtime-logger.ts +107 -107
  111. package/src/runtime/ws-client.test.ts +125 -104
  112. package/src/runtime/ws-client.ts +287 -272
  113. package/src/sdk/action.ts +166 -166
  114. package/src/sdk/index.ts +110 -110
  115. package/src/sdk/types.ts +161 -161
  116. package/src/strategies/avoid-lone.ts +12 -12
  117. package/src/strategies/avoid-players.knowledge.md +19 -19
  118. package/src/strategies/avoid-players.ts +16 -16
  119. package/src/strategies/corpse-patrol.ts +23 -23
  120. package/src/strategies/crab-sabotage.ts +22 -22
  121. package/src/strategies/custom-module.test.ts +270 -270
  122. package/src/strategies/find-player.ts +17 -17
  123. package/src/strategies/game-utils.test.ts +242 -242
  124. package/src/strategies/game-utils.ts +846 -846
  125. package/src/strategies/goals/anchor-linger.ts +77 -77
  126. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  127. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  128. package/src/strategies/goals/avoid-players-top.ts +121 -121
  129. package/src/strategies/goals/conversation-goal.ts +51 -51
  130. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  131. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  132. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  133. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  134. package/src/strategies/goals/find-player-top.ts +93 -93
  135. package/src/strategies/goals/flee-players-goal.ts +53 -53
  136. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  137. package/src/strategies/goals/goal-manager.ts +41 -41
  138. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  139. package/src/strategies/goals/goal.ts +28 -28
  140. package/src/strategies/goals/hide-top.ts +197 -197
  141. package/src/strategies/goals/keep-away-goal.ts +221 -221
  142. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  143. package/src/strategies/goals/kill-lone-top.ts +160 -160
  144. package/src/strategies/goals/kill-target-goal.ts +59 -59
  145. package/src/strategies/goals/kill-target-top.ts +109 -109
  146. package/src/strategies/goals/leaf-goal.ts +27 -27
  147. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  148. package/src/strategies/goals/lone-kill-core.ts +82 -82
  149. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  150. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  151. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  152. package/src/strategies/goals/move-room-goal.ts +60 -60
  153. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  154. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  155. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  156. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  157. package/src/strategies/goals/patrol-top.ts +57 -57
  158. package/src/strategies/goals/report-patrol-top.ts +80 -80
  159. package/src/strategies/goals/safe-task-goal.ts +102 -102
  160. package/src/strategies/goals/social-task-top.ts +161 -161
  161. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  162. package/src/strategies/goals/task-only-top.ts +57 -57
  163. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  164. package/src/strategies/goals/task-report-top.ts +57 -57
  165. package/src/strategies/goals/wander-task-goal.ts +33 -33
  166. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  167. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  168. package/src/strategies/greeting.ts +53 -53
  169. package/src/strategies/hide-spots.ts +59 -59
  170. package/src/strategies/hide.ts +24 -24
  171. package/src/strategies/kill-frenzy.ts +13 -13
  172. package/src/strategies/kill-lone.knowledge.md +17 -17
  173. package/src/strategies/kill-lone.ts +14 -14
  174. package/src/strategies/kill-target.ts +19 -19
  175. package/src/strategies/loader.test.ts +678 -678
  176. package/src/strategies/loader.ts +179 -179
  177. package/src/strategies/lone-kill-task.ts +22 -22
  178. package/src/strategies/meeting-gate.test.ts +59 -59
  179. package/src/strategies/meeting-gate.ts +23 -23
  180. package/src/strategies/move-room.ts +16 -16
  181. package/src/strategies/new-events-backfill.ts +98 -98
  182. package/src/strategies/off-route-points.ts +105 -105
  183. package/src/strategies/paradise-fish.knowledge.md +19 -19
  184. package/src/strategies/paradise-fish.ts +26 -26
  185. package/src/strategies/pathfind/distance-field.ts +150 -150
  186. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  187. package/src/strategies/pathfind/escape-planner.ts +355 -355
  188. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  189. package/src/strategies/patrol.ts +12 -12
  190. package/src/strategies/player-targets.ts +13 -13
  191. package/src/strategies/report-patrol.ts +12 -12
  192. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  193. package/src/strategies/shrimp-memory.ts +26 -26
  194. package/src/strategies/social-task.test.ts +28 -28
  195. package/src/strategies/social-task.ts +50 -50
  196. package/src/strategies/spawn.ts +82 -82
  197. package/src/strategies/speech-module.ts +123 -123
  198. package/src/strategies/strategy-loop.test.ts +15 -0
  199. package/src/strategies/strategy-loop.ts +776 -771
  200. package/src/strategies/task-kill-report.ts +18 -18
  201. package/src/strategies/task-only.ts +12 -12
  202. package/src/strategies/task-report.ts +23 -23
  203. package/src/strategies/types.ts +109 -109
  204. package/src/strategies/warrior-memory.knowledge.md +21 -21
  205. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,76 +1,76 @@
1
- import { AuthStore } from './auth.js';
2
- import type { GameClient } from './game-client.js';
3
- import { synthesizeNeteaseTTS } from './netease-tts.js';
4
- import {
5
- DEFAULT_TTS_VOICE,
6
- TTS_PROVIDER_LEIHUO,
7
- TTS_TEXT_MAX_LENGTH,
8
- } from './tts-keys.js';
9
-
10
- export interface SynthesizeSpeechAudioOptions {
11
- voice?: string;
12
- provider?: string;
13
- authStore?: AuthStore;
14
- }
15
-
16
- /**
17
- * Synthesize speech audio via the configured TTS provider and upload to OSS.
18
- * @throws when the provider key is missing, text is too long, or synthesis/upload fails.
19
- */
20
- export async function synthesizeAndUploadSpeechAudio(
21
- text: string,
22
- client: GameClient,
23
- opts: SynthesizeSpeechAudioOptions = {},
24
- ): Promise<string> {
25
- const store = opts.authStore ?? new AuthStore();
26
- const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
27
- const apiKey = store.getTtsKey(provider);
28
- if (!apiKey) {
29
- throw new Error(
30
- `TTS API key for provider "${provider}" is not configured. Use \`clawclaw-cli tts config <apiKey>\` first.`,
31
- );
32
- }
33
- if (text.length > TTS_TEXT_MAX_LENGTH) {
34
- throw new Error(`TTS text must be ${TTS_TEXT_MAX_LENGTH} characters or fewer.`);
35
- }
36
-
37
- const audio = await synthesizeNeteaseTTS({
38
- apiKey,
39
- text,
40
- voice: opts.voice ?? store.getTtsDefaultVoice() ?? DEFAULT_TTS_VOICE,
41
- });
42
- const upload = await client.uploadAudio(audio.audio, 'tts-audio.mp3', audio.contentType);
43
- return upload.audio_url;
44
- }
45
-
46
- /**
47
- * When the active account has a Leihuo TTS key, synthesize and upload audio for speech.
48
- * Returns undefined if no key, a URL was already provided, or auto-TTS was skipped (e.g. text too long).
49
- */
50
- export async function maybeSynthesizeSpeechAudioUrl(
51
- text: string,
52
- existingUrl: string | undefined,
53
- client: GameClient,
54
- opts: SynthesizeSpeechAudioOptions = {},
55
- ): Promise<string | undefined> {
56
- if (existingUrl) return existingUrl;
57
-
58
- const store = opts.authStore ?? new AuthStore();
59
- const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
60
- const apiKey = store.getTtsKey(provider);
61
- if (!apiKey) return undefined;
62
-
63
- if (text.length > TTS_TEXT_MAX_LENGTH) {
64
- console.error(
65
- `Speech is ${text.length} characters; auto TTS supports up to ${TTS_TEXT_MAX_LENGTH}. Sending without audio.`,
66
- );
67
- return undefined;
68
- }
69
-
70
- try {
71
- return await synthesizeAndUploadSpeechAudio(text, client, opts);
72
- } catch (err: any) {
73
- console.error(`Auto TTS failed: ${err?.message ?? String(err)}. Sending speech without audio.`);
74
- return undefined;
75
- }
76
- }
1
+ import { AuthStore } from './auth.js';
2
+ import type { GameClient } from './game-client.js';
3
+ import { synthesizeNeteaseTTS } from './netease-tts.js';
4
+ import {
5
+ DEFAULT_TTS_VOICE,
6
+ TTS_PROVIDER_LEIHUO,
7
+ TTS_TEXT_MAX_LENGTH,
8
+ } from './tts-keys.js';
9
+
10
+ export interface SynthesizeSpeechAudioOptions {
11
+ voice?: string;
12
+ provider?: string;
13
+ authStore?: AuthStore;
14
+ }
15
+
16
+ /**
17
+ * Synthesize speech audio via the configured TTS provider and upload to OSS.
18
+ * @throws when the provider key is missing, text is too long, or synthesis/upload fails.
19
+ */
20
+ export async function synthesizeAndUploadSpeechAudio(
21
+ text: string,
22
+ client: GameClient,
23
+ opts: SynthesizeSpeechAudioOptions = {},
24
+ ): Promise<string> {
25
+ const store = opts.authStore ?? new AuthStore();
26
+ const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
27
+ const apiKey = store.getTtsKey(provider);
28
+ if (!apiKey) {
29
+ throw new Error(
30
+ `TTS API key for provider "${provider}" is not configured. Use \`clawclaw-cli tts config <apiKey>\` first.`,
31
+ );
32
+ }
33
+ if (text.length > TTS_TEXT_MAX_LENGTH) {
34
+ throw new Error(`TTS text must be ${TTS_TEXT_MAX_LENGTH} characters or fewer.`);
35
+ }
36
+
37
+ const audio = await synthesizeNeteaseTTS({
38
+ apiKey,
39
+ text,
40
+ voice: opts.voice ?? store.getTtsDefaultVoice() ?? DEFAULT_TTS_VOICE,
41
+ });
42
+ const upload = await client.uploadAudio(audio.audio, 'tts-audio.mp3', audio.contentType);
43
+ return upload.audio_url;
44
+ }
45
+
46
+ /**
47
+ * When the active account has a Leihuo TTS key, synthesize and upload audio for speech.
48
+ * Returns undefined if no key, a URL was already provided, or auto-TTS was skipped (e.g. text too long).
49
+ */
50
+ export async function maybeSynthesizeSpeechAudioUrl(
51
+ text: string,
52
+ existingUrl: string | undefined,
53
+ client: GameClient,
54
+ opts: SynthesizeSpeechAudioOptions = {},
55
+ ): Promise<string | undefined> {
56
+ if (existingUrl) return existingUrl;
57
+
58
+ const store = opts.authStore ?? new AuthStore();
59
+ const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
60
+ const apiKey = store.getTtsKey(provider);
61
+ if (!apiKey) return undefined;
62
+
63
+ if (text.length > TTS_TEXT_MAX_LENGTH) {
64
+ console.error(
65
+ `Speech is ${text.length} characters; auto TTS supports up to ${TTS_TEXT_MAX_LENGTH}. Sending without audio.`,
66
+ );
67
+ return undefined;
68
+ }
69
+
70
+ try {
71
+ return await synthesizeAndUploadSpeechAudio(text, client, opts);
72
+ } catch (err: any) {
73
+ console.error(`Auto TTS failed: ${err?.message ?? String(err)}. Sending speech without audio.`);
74
+ return undefined;
75
+ }
76
+ }
@@ -1,49 +1,49 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { CLAWCLAW_WORKSPACE_DIR, applyWorkspaceArgv, extractWorkspaceDirArgv } from './workspace-argv.js';
3
-
4
- describe('extractWorkspaceDirArgv', () => {
5
- it('supports --workspace-dir X', () => {
6
- expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'])).toBe('tmp/workspace');
7
- });
8
-
9
- it('supports --workspace-dir=X', () => {
10
- expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir=tmp/workspace'])).toBe('tmp/workspace');
11
- });
12
-
13
- it('returns undefined when the option is not provided', () => {
14
- expect(extractWorkspaceDirArgv(['node', 'cli', 'do'])).toBeUndefined();
15
- });
16
-
17
- it('returns undefined for an empty value', () => {
18
- expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir='])).toBeUndefined();
19
- expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', ' '])).toBeUndefined();
20
- });
21
- });
22
-
23
- describe('applyWorkspaceArgv', () => {
24
- it('writes an absolute workspace dir using the injected cwd', () => {
25
- const env: NodeJS.ProcessEnv = {};
26
-
27
- expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'], env, 'D:\\open-claw-kill')).toBe(
28
- 'D:\\open-claw-kill\\tmp\\workspace',
29
- );
30
- expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\tmp\\workspace');
31
- });
32
-
33
- it('lets explicit argv override an existing workspace env value', () => {
34
- const env: NodeJS.ProcessEnv = { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\old\\workspace' };
35
-
36
- expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'new/workspace'], env, 'D:\\open-claw-kill')).toBe(
37
- 'D:\\open-claw-kill\\new\\workspace',
38
- );
39
- expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\new\\workspace');
40
- });
41
-
42
- it('leaves env untouched when the option is absent or empty', () => {
43
- const env: NodeJS.ProcessEnv = { EXISTING: 'keep' };
44
-
45
- expect(applyWorkspaceArgv(['node', 'cli', 'do'], env, 'D:\\open-claw-kill')).toBeUndefined();
46
- expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir='], env, 'D:\\open-claw-kill')).toBeUndefined();
47
- expect(env).toEqual({ EXISTING: 'keep' });
48
- });
49
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import { CLAWCLAW_WORKSPACE_DIR, applyWorkspaceArgv, extractWorkspaceDirArgv } from './workspace-argv.js';
3
+
4
+ describe('extractWorkspaceDirArgv', () => {
5
+ it('supports --workspace-dir X', () => {
6
+ expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'])).toBe('tmp/workspace');
7
+ });
8
+
9
+ it('supports --workspace-dir=X', () => {
10
+ expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir=tmp/workspace'])).toBe('tmp/workspace');
11
+ });
12
+
13
+ it('returns undefined when the option is not provided', () => {
14
+ expect(extractWorkspaceDirArgv(['node', 'cli', 'do'])).toBeUndefined();
15
+ });
16
+
17
+ it('returns undefined for an empty value', () => {
18
+ expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir='])).toBeUndefined();
19
+ expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', ' '])).toBeUndefined();
20
+ });
21
+ });
22
+
23
+ describe('applyWorkspaceArgv', () => {
24
+ it('writes an absolute workspace dir using the injected cwd', () => {
25
+ const env: NodeJS.ProcessEnv = {};
26
+
27
+ expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'], env, 'D:\\open-claw-kill')).toBe(
28
+ 'D:\\open-claw-kill\\tmp\\workspace',
29
+ );
30
+ expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\tmp\\workspace');
31
+ });
32
+
33
+ it('lets explicit argv override an existing workspace env value', () => {
34
+ const env: NodeJS.ProcessEnv = { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\old\\workspace' };
35
+
36
+ expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'new/workspace'], env, 'D:\\open-claw-kill')).toBe(
37
+ 'D:\\open-claw-kill\\new\\workspace',
38
+ );
39
+ expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\new\\workspace');
40
+ });
41
+
42
+ it('leaves env untouched when the option is absent or empty', () => {
43
+ const env: NodeJS.ProcessEnv = { EXISTING: 'keep' };
44
+
45
+ expect(applyWorkspaceArgv(['node', 'cli', 'do'], env, 'D:\\open-claw-kill')).toBeUndefined();
46
+ expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir='], env, 'D:\\open-claw-kill')).toBeUndefined();
47
+ expect(env).toEqual({ EXISTING: 'keep' });
48
+ });
49
+ });
@@ -1,44 +1,44 @@
1
- import { resolve, win32 } from 'path';
2
- import { CLAWCLAW_WORKSPACE_DIR } from './init-command.js';
3
-
4
- const WORKSPACE_DIR_OPTION = '--workspace-dir';
5
- export { CLAWCLAW_WORKSPACE_DIR };
6
-
7
- function isPresent(value: string | undefined): value is string {
8
- return typeof value === 'string' && value.trim() !== '' && !value.startsWith('-');
9
- }
10
-
11
- export function extractWorkspaceDirArgv(argv: readonly string[]): string | undefined {
12
- for (let i = 0; i < argv.length; i += 1) {
13
- const current = argv[i];
14
- if (current === WORKSPACE_DIR_OPTION) {
15
- const next = argv[i + 1];
16
- return isPresent(next) ? next : undefined;
17
- }
18
-
19
- if (current.startsWith(`${WORKSPACE_DIR_OPTION}=`)) {
20
- const value = current.slice(WORKSPACE_DIR_OPTION.length + 1);
21
- return isPresent(value) ? value : undefined;
22
- }
23
- }
24
-
25
- return undefined;
26
- }
27
-
28
- export function applyWorkspaceArgv(
29
- argv: readonly string[],
30
- env: NodeJS.ProcessEnv,
31
- cwd: string = process.cwd(),
32
- ): string | undefined {
33
- const workspaceDir = extractWorkspaceDirArgv(argv);
34
- if (!workspaceDir) {
35
- return undefined;
36
- }
37
-
38
- const useWin32Path = /^[A-Za-z]:[\\/]/.test(cwd) || /^[A-Za-z]:[\\/]/.test(workspaceDir);
39
- const resolvedWorkspaceDir = useWin32Path
40
- ? win32.resolve(cwd, workspaceDir)
41
- : resolve(cwd, workspaceDir);
42
- env[CLAWCLAW_WORKSPACE_DIR] = resolvedWorkspaceDir;
43
- return resolvedWorkspaceDir;
44
- }
1
+ import { resolve, win32 } from 'path';
2
+ import { CLAWCLAW_WORKSPACE_DIR } from './init-command.js';
3
+
4
+ const WORKSPACE_DIR_OPTION = '--workspace-dir';
5
+ export { CLAWCLAW_WORKSPACE_DIR };
6
+
7
+ function isPresent(value: string | undefined): value is string {
8
+ return typeof value === 'string' && value.trim() !== '' && !value.startsWith('-');
9
+ }
10
+
11
+ export function extractWorkspaceDirArgv(argv: readonly string[]): string | undefined {
12
+ for (let i = 0; i < argv.length; i += 1) {
13
+ const current = argv[i];
14
+ if (current === WORKSPACE_DIR_OPTION) {
15
+ const next = argv[i + 1];
16
+ return isPresent(next) ? next : undefined;
17
+ }
18
+
19
+ if (current.startsWith(`${WORKSPACE_DIR_OPTION}=`)) {
20
+ const value = current.slice(WORKSPACE_DIR_OPTION.length + 1);
21
+ return isPresent(value) ? value : undefined;
22
+ }
23
+ }
24
+
25
+ return undefined;
26
+ }
27
+
28
+ export function applyWorkspaceArgv(
29
+ argv: readonly string[],
30
+ env: NodeJS.ProcessEnv,
31
+ cwd: string = process.cwd(),
32
+ ): string | undefined {
33
+ const workspaceDir = extractWorkspaceDirArgv(argv);
34
+ if (!workspaceDir) {
35
+ return undefined;
36
+ }
37
+
38
+ const useWin32Path = /^[A-Za-z]:[\\/]/.test(cwd) || /^[A-Za-z]:[\\/]/.test(workspaceDir);
39
+ const resolvedWorkspaceDir = useWin32Path
40
+ ? win32.resolve(cwd, workspaceDir)
41
+ : resolve(cwd, workspaceDir);
42
+ env[CLAWCLAW_WORKSPACE_DIR] = resolvedWorkspaceDir;
43
+ return resolvedWorkspaceDir;
44
+ }
@@ -1,87 +1,87 @@
1
- import { existsSync, mkdtempSync, readFileSync } from 'fs';
2
- import { tmpdir } from 'os';
3
- import { join } from 'path';
4
- import { describe, expect, it } from 'vitest';
5
- import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
6
-
7
- describe('PlayerHistoryStore', () => {
8
- it('derives sidecar path from the session jsonl path', () => {
9
- expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
10
- expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
11
- });
12
-
13
- it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
14
- const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
15
- const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
16
- store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
17
-
18
- expect(store.recordPlayerSpotted({
19
- type: 'player_spotted',
20
- tick: 10,
21
- spotted_name: '砂锅猎手',
22
- spotted_room: '动力监控室',
23
- spotted_x: 1,
24
- spotted_y: 2,
25
- }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
26
- store.recordPlayerSpotted({
27
- type: 'player_spotted',
28
- tick: 13,
29
- spotted_name: '洋流王子',
30
- spotted_room: 'hallway',
31
- spotted_x: 3,
32
- spotted_y: 4,
33
- }, Date.parse('2026-05-21T00:00:02.000Z'));
34
- store.recordPlayerSpotted({
35
- type: 'player_spotted',
36
- tick: 13,
37
- spotted_name: '测试-浮沉-0bc9',
38
- spotted_room: 'hallway',
39
- spotted_x: 5,
40
- spotted_y: 6,
41
- }, Date.parse('2026-05-21T00:00:02.000Z'));
42
-
43
- const data = store.read()!;
44
- expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
45
- expect(data.visible_frames[1].players).toEqual({});
46
- expect(data.visible_frames[2].players).toEqual({});
47
- expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
48
- expect(data.last_history_tick).toBe(13);
49
- });
50
-
51
- it('does not backfill a missing old tick after later ticks have been processed', () => {
52
- const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
53
- const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
54
- store.reset();
55
- store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
56
- store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
57
- expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
58
- expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
59
- });
60
-
61
- it('caches seats and lobster task locations from map data', () => {
62
- const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
63
- const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
64
- store.reset();
65
- store.updateMapCache({
66
- all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
67
- all_task_locations: [
68
- { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
69
- { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
70
- ],
71
- });
72
- const data = store.read()!;
73
- expect(data.seats).toEqual({ A: 1, B: 2 });
74
- expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
75
- });
76
-
77
- it('deletes the sidecar when requested', () => {
78
- const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
79
- const path = join(dir, 'session.player-history.json');
80
- const store = new PlayerHistoryStore(path);
81
- store.reset();
82
- expect(existsSync(path)).toBe(true);
83
- expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
84
- store.delete();
85
- expect(existsSync(path)).toBe(false);
86
- });
87
- });
1
+ import { existsSync, mkdtempSync, readFileSync } from 'fs';
2
+ import { tmpdir } from 'os';
3
+ import { join } from 'path';
4
+ import { describe, expect, it } from 'vitest';
5
+ import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
6
+
7
+ describe('PlayerHistoryStore', () => {
8
+ it('derives sidecar path from the session jsonl path', () => {
9
+ expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
10
+ expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
11
+ });
12
+
13
+ it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
14
+ const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
15
+ const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
16
+ store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
17
+
18
+ expect(store.recordPlayerSpotted({
19
+ type: 'player_spotted',
20
+ tick: 10,
21
+ spotted_name: '砂锅猎手',
22
+ spotted_room: '动力监控室',
23
+ spotted_x: 1,
24
+ spotted_y: 2,
25
+ }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
26
+ store.recordPlayerSpotted({
27
+ type: 'player_spotted',
28
+ tick: 13,
29
+ spotted_name: '洋流王子',
30
+ spotted_room: 'hallway',
31
+ spotted_x: 3,
32
+ spotted_y: 4,
33
+ }, Date.parse('2026-05-21T00:00:02.000Z'));
34
+ store.recordPlayerSpotted({
35
+ type: 'player_spotted',
36
+ tick: 13,
37
+ spotted_name: '测试-浮沉-0bc9',
38
+ spotted_room: 'hallway',
39
+ spotted_x: 5,
40
+ spotted_y: 6,
41
+ }, Date.parse('2026-05-21T00:00:02.000Z'));
42
+
43
+ const data = store.read()!;
44
+ expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
45
+ expect(data.visible_frames[1].players).toEqual({});
46
+ expect(data.visible_frames[2].players).toEqual({});
47
+ expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
48
+ expect(data.last_history_tick).toBe(13);
49
+ });
50
+
51
+ it('does not backfill a missing old tick after later ticks have been processed', () => {
52
+ const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
53
+ const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
54
+ store.reset();
55
+ store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
56
+ store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
57
+ expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
58
+ expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
59
+ });
60
+
61
+ it('caches seats and lobster task locations from map data', () => {
62
+ const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
63
+ const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
64
+ store.reset();
65
+ store.updateMapCache({
66
+ all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
67
+ all_task_locations: [
68
+ { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
69
+ { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
70
+ ],
71
+ });
72
+ const data = store.read()!;
73
+ expect(data.seats).toEqual({ A: 1, B: 2 });
74
+ expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
75
+ });
76
+
77
+ it('deletes the sidecar when requested', () => {
78
+ const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
79
+ const path = join(dir, 'session.player-history.json');
80
+ const store = new PlayerHistoryStore(path);
81
+ store.reset();
82
+ expect(existsSync(path)).toBe(true);
83
+ expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
84
+ store.delete();
85
+ expect(existsSync(path)).toBe(false);
86
+ });
87
+ });