@myclaw163/clawclaw-cli 0.6.65 → 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 -500
  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,232 +1,232 @@
1
- // src/lib/strategy-export.test.ts
2
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
3
- import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync } from 'fs';
4
- import { join } from 'path';
5
- import { tmpdir } from 'os';
6
- import {
7
- rewriteBuiltinImports,
8
- exportStrategy,
9
- detectStaleOfficialStrategies,
10
- readManifest,
11
- } from './strategy-export.js';
12
-
13
- describe('strategy-export', () => {
14
- let testWorkspace: string;
15
- let originalEnv: string | undefined;
16
-
17
- beforeEach(() => {
18
- testWorkspace = join(tmpdir(), `ccl-test-${Date.now()}`);
19
- mkdirSync(testWorkspace, { recursive: true });
20
- originalEnv = process.env.CLAWCLAW_WORKSPACE_DIR;
21
- process.env.CLAWCLAW_WORKSPACE_DIR = testWorkspace;
22
- });
23
-
24
- afterEach(() => {
25
- if (originalEnv !== undefined) {
26
- process.env.CLAWCLAW_WORKSPACE_DIR = originalEnv;
27
- } else {
28
- delete process.env.CLAWCLAW_WORKSPACE_DIR;
29
- }
30
- rmSync(testWorkspace, { recursive: true, force: true });
31
- });
32
-
33
- describe('rewriteBuiltinImports', () => {
34
- it('should rewrite ALL relative imports to @myclaw163/clawclaw-cli', () => {
35
- const source = `
36
- import type { GameState } from '../sdk/types.js';
37
- import { Action } from '../sdk/action.js';
38
- import { dist, killCommitRange } from './game-utils.js';
39
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
40
- import { TaskOnlyTop } from './goals/task-only-top.js';
41
- import { parseGreetingArgs } from './greeting.js';
42
- import { TTS_TEXT_MAX_LENGTH } from '../lib/tts-keys.js';
43
-
44
- export const strategy = { id: 'test', description: 'test', create: () => ({ name: 'test', decide: () => [] }) };
45
- `;
46
- const rewritten = rewriteBuiltinImports(source, 'test', '0.6.31');
47
-
48
- expect(rewritten).toContain('// Exported from test@0.6.31');
49
- // All relative imports should be rewritten
50
- expect(rewritten).not.toContain("'../sdk/types.js'");
51
- expect(rewritten).not.toContain("'../sdk/action.js'");
52
- expect(rewritten).not.toContain("'./game-utils.js'");
53
- expect(rewritten).not.toContain("'./goals/goal-root-strategy.js'");
54
- expect(rewritten).not.toContain("'./goals/task-only-top.js'");
55
- expect(rewritten).not.toContain("'./greeting.js'");
56
- expect(rewritten).not.toContain("'../lib/tts-keys.js'");
57
- // Verify rewritten imports use @myclaw163/clawclaw-cli
58
- expect(rewritten).toContain("from '@myclaw163/clawclaw-cli'");
59
- });
60
-
61
- it('should preserve user imports from clawclaw-cli', () => {
62
- const source = `
63
- import { Action } from 'clawclaw-cli';
64
- import type { GameState } from '../sdk/types.js';
65
-
66
- export const strategy = { id: 'test', description: 'test', create: () => ({ name: 'test', decide: () => [] }) };
67
- `;
68
- const rewritten = rewriteBuiltinImports(source, 'test', '0.6.31');
69
- expect(rewritten).toContain("import { Action } from 'clawclaw-cli'");
70
- expect(rewritten).toContain("from 'clawclaw-cli'");
71
- });
72
- });
73
-
74
- describe('exportStrategy', () => {
75
- it('should export a formerly goal-based strategy with its knowledge sidecar', async () => {
76
- await exportStrategy('kill-lone');
77
-
78
- const strategiesDir = join(testWorkspace, 'strategies');
79
- expect(existsSync(join(strategiesDir, 'kill-lone.ts'))).toBe(true);
80
- expect(existsSync(join(strategiesDir, 'kill-lone.knowledge.md'))).toBe(true);
81
- });
82
-
83
- it('should export a valid strategy', async () => {
84
- await exportStrategy('task-only');
85
-
86
- const strategyFile = join(testWorkspace, 'strategies', 'task-only.ts');
87
- const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
88
-
89
- expect(existsSync(strategyFile)).toBe(true);
90
- expect(existsSync(manifestFile)).toBe(true);
91
-
92
- const strategy = readFileSync(strategyFile, 'utf8');
93
- expect(strategy).toContain('// Exported from task-only@');
94
- expect(strategy).toContain("from '@myclaw163/clawclaw-cli'");
95
-
96
- const manifest = readManifest();
97
- expect(manifest['task-only']).toBeDefined();
98
- expect(manifest['task-only'].sourceHash).toBeDefined();
99
- });
100
-
101
- it('should reject strategy with unexported SDK symbol', async () => {
102
- // Create a fake builtin strategy that imports a symbol not in the SDK
103
- const fakeDir = join(testWorkspace, 'fake-builtin');
104
- mkdirSync(fakeDir, { recursive: true });
105
- const fakeFile = join(fakeDir, 'broken-strategy.ts');
106
- writeFileSync(fakeFile, `
107
- import { TotallyMissingSymbol } from 'clawclaw-cli';
108
- export const strategy = {
109
- id: 'broken-strategy',
110
- description: 'test',
111
- create: () => ({ name: 'broken', decide: () => [TotallyMissingSymbol] }),
112
- };
113
- `, 'utf8');
114
-
115
- // Temporarily override locateBuiltinSource to point to our fake
116
- const { rewriteBuiltinImports } = await import('./strategy-export.js');
117
- const rewritten = rewriteBuiltinImports(
118
- readFileSync(fakeFile, 'utf8'),
119
- 'broken-strategy',
120
- '0.0.0'
121
- );
122
-
123
- // Validate should catch the missing symbol
124
- const { validateExportable } = await import('./strategy-export.js') as any;
125
- if (typeof validateExportable === 'function') {
126
- const result = await validateExportable(rewritten);
127
- expect(result.ok).toBe(false);
128
- expect(result.error).toBeDefined();
129
- }
130
- });
131
-
132
- it('should refuse to overwrite untracked files without --force', async () => {
133
- const strategiesDir = join(testWorkspace, 'strategies');
134
- mkdirSync(strategiesDir, { recursive: true });
135
- writeFileSync(join(strategiesDir, 'task-only.ts'), '// user file', 'utf8');
136
-
137
-
138
- await expect(exportStrategy('task-only')).rejects.toThrow(
139
- 'already exists and is not tracked. Use --force to overwrite.'
140
- );
141
- });
142
-
143
- it('should overwrite untracked files with --force', async () => {
144
- const strategiesDir = join(testWorkspace, 'strategies');
145
- mkdirSync(strategiesDir, { recursive: true });
146
- writeFileSync(join(strategiesDir, 'task-only.ts'), '// user file', 'utf8');
147
-
148
- await exportStrategy('task-only', { force: true });
149
-
150
- const strategy = readFileSync(join(strategiesDir, 'task-only.ts'), 'utf8');
151
- expect(strategy).toContain('// Exported from task-only@');
152
- });
153
-
154
- it('should allow re-exporting tracked strategies without --force', async () => {
155
- // First export
156
- await exportStrategy('task-only');
157
-
158
- const strategiesDir = join(testWorkspace, 'strategies');
159
- const strategyFile = join(strategiesDir, 'task-only.ts');
160
-
161
- // Modify the file
162
- writeFileSync(strategyFile, '// user customized', 'utf8');
163
-
164
- // Re-export without --force (should succeed because it's tracked)
165
- await exportStrategy('task-only');
166
-
167
- const strategy = readFileSync(strategyFile, 'utf8');
168
- expect(strategy).toContain('// Exported from task-only@');
169
- });
170
-
171
- it('should reject non-existent strategies', async () => {
172
- await expect(exportStrategy('non-existent-strategy')).rejects.toThrow(
173
- "Built-in strategy 'non-existent-strategy' not found."
174
- );
175
- });
176
- });
177
-
178
- describe('detectStaleOfficialStrategies', () => {
179
- it('should return empty array when no strategies are exported', () => {
180
- expect(detectStaleOfficialStrategies()).toEqual([]);
181
- });
182
-
183
- it('should return empty array when all strategies are up to date', async () => {
184
- await exportStrategy('task-only');
185
- expect(detectStaleOfficialStrategies()).toEqual([]);
186
- });
187
-
188
- it('should return stale IDs when source hash mismatch', async () => {
189
- await exportStrategy('task-only');
190
-
191
- // Manually modify the manifest to simulate a stale hash
192
- const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
193
- const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
194
- manifest['task-only'].sourceHash = 'stale-hash-value';
195
- writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
196
-
197
- expect(detectStaleOfficialStrategies()).toEqual(['task-only']);
198
- });
199
-
200
- it('should return multiple stale IDs', async () => {
201
- await exportStrategy('task-only');
202
- await exportStrategy('kill-lone');
203
-
204
- // Make both stale
205
- const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
206
- const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
207
- manifest['task-only'].sourceHash = 'stale-1';
208
- manifest['kill-lone'].sourceHash = 'stale-2';
209
- writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
210
-
211
- const stale = detectStaleOfficialStrategies();
212
- expect(stale).toContain('task-only');
213
- expect(stale).toContain('kill-lone');
214
- expect(stale).toHaveLength(2);
215
- });
216
-
217
- it('should detect stale when sidecar hash changes', async () => {
218
- await exportStrategy('kill-lone');
219
-
220
- // Verify kill-lone has a sidecar hash (it has a .knowledge.md)
221
- const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
222
- const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
223
- expect(manifest['kill-lone'].sidecarHash).toBeDefined();
224
-
225
- // Make sidecar stale
226
- manifest['kill-lone'].sidecarHash = 'stale-sidecar';
227
- writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
228
-
229
- expect(detectStaleOfficialStrategies()).toEqual(['kill-lone']);
230
- });
231
- });
232
- });
1
+ // src/lib/strategy-export.test.ts
2
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
3
+ import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync } from 'fs';
4
+ import { join } from 'path';
5
+ import { tmpdir } from 'os';
6
+ import {
7
+ rewriteBuiltinImports,
8
+ exportStrategy,
9
+ detectStaleOfficialStrategies,
10
+ readManifest,
11
+ } from './strategy-export.js';
12
+
13
+ describe('strategy-export', () => {
14
+ let testWorkspace: string;
15
+ let originalEnv: string | undefined;
16
+
17
+ beforeEach(() => {
18
+ testWorkspace = join(tmpdir(), `ccl-test-${Date.now()}`);
19
+ mkdirSync(testWorkspace, { recursive: true });
20
+ originalEnv = process.env.CLAWCLAW_WORKSPACE_DIR;
21
+ process.env.CLAWCLAW_WORKSPACE_DIR = testWorkspace;
22
+ });
23
+
24
+ afterEach(() => {
25
+ if (originalEnv !== undefined) {
26
+ process.env.CLAWCLAW_WORKSPACE_DIR = originalEnv;
27
+ } else {
28
+ delete process.env.CLAWCLAW_WORKSPACE_DIR;
29
+ }
30
+ rmSync(testWorkspace, { recursive: true, force: true });
31
+ });
32
+
33
+ describe('rewriteBuiltinImports', () => {
34
+ it('should rewrite ALL relative imports to @myclaw163/clawclaw-cli', () => {
35
+ const source = `
36
+ import type { GameState } from '../sdk/types.js';
37
+ import { Action } from '../sdk/action.js';
38
+ import { dist, killCommitRange } from './game-utils.js';
39
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
40
+ import { TaskOnlyTop } from './goals/task-only-top.js';
41
+ import { parseGreetingArgs } from './greeting.js';
42
+ import { TTS_TEXT_MAX_LENGTH } from '../lib/tts-keys.js';
43
+
44
+ export const strategy = { id: 'test', description: 'test', create: () => ({ name: 'test', decide: () => [] }) };
45
+ `;
46
+ const rewritten = rewriteBuiltinImports(source, 'test', '0.6.31');
47
+
48
+ expect(rewritten).toContain('// Exported from test@0.6.31');
49
+ // All relative imports should be rewritten
50
+ expect(rewritten).not.toContain("'../sdk/types.js'");
51
+ expect(rewritten).not.toContain("'../sdk/action.js'");
52
+ expect(rewritten).not.toContain("'./game-utils.js'");
53
+ expect(rewritten).not.toContain("'./goals/goal-root-strategy.js'");
54
+ expect(rewritten).not.toContain("'./goals/task-only-top.js'");
55
+ expect(rewritten).not.toContain("'./greeting.js'");
56
+ expect(rewritten).not.toContain("'../lib/tts-keys.js'");
57
+ // Verify rewritten imports use @myclaw163/clawclaw-cli
58
+ expect(rewritten).toContain("from '@myclaw163/clawclaw-cli'");
59
+ });
60
+
61
+ it('should preserve user imports from clawclaw-cli', () => {
62
+ const source = `
63
+ import { Action } from 'clawclaw-cli';
64
+ import type { GameState } from '../sdk/types.js';
65
+
66
+ export const strategy = { id: 'test', description: 'test', create: () => ({ name: 'test', decide: () => [] }) };
67
+ `;
68
+ const rewritten = rewriteBuiltinImports(source, 'test', '0.6.31');
69
+ expect(rewritten).toContain("import { Action } from 'clawclaw-cli'");
70
+ expect(rewritten).toContain("from 'clawclaw-cli'");
71
+ });
72
+ });
73
+
74
+ describe('exportStrategy', () => {
75
+ it('should export a formerly goal-based strategy with its knowledge sidecar', async () => {
76
+ await exportStrategy('kill-lone');
77
+
78
+ const strategiesDir = join(testWorkspace, 'strategies');
79
+ expect(existsSync(join(strategiesDir, 'kill-lone.ts'))).toBe(true);
80
+ expect(existsSync(join(strategiesDir, 'kill-lone.knowledge.md'))).toBe(true);
81
+ });
82
+
83
+ it('should export a valid strategy', async () => {
84
+ await exportStrategy('task-only');
85
+
86
+ const strategyFile = join(testWorkspace, 'strategies', 'task-only.ts');
87
+ const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
88
+
89
+ expect(existsSync(strategyFile)).toBe(true);
90
+ expect(existsSync(manifestFile)).toBe(true);
91
+
92
+ const strategy = readFileSync(strategyFile, 'utf8');
93
+ expect(strategy).toContain('// Exported from task-only@');
94
+ expect(strategy).toContain("from '@myclaw163/clawclaw-cli'");
95
+
96
+ const manifest = readManifest();
97
+ expect(manifest['task-only']).toBeDefined();
98
+ expect(manifest['task-only'].sourceHash).toBeDefined();
99
+ });
100
+
101
+ it('should reject strategy with unexported SDK symbol', async () => {
102
+ // Create a fake builtin strategy that imports a symbol not in the SDK
103
+ const fakeDir = join(testWorkspace, 'fake-builtin');
104
+ mkdirSync(fakeDir, { recursive: true });
105
+ const fakeFile = join(fakeDir, 'broken-strategy.ts');
106
+ writeFileSync(fakeFile, `
107
+ import { TotallyMissingSymbol } from 'clawclaw-cli';
108
+ export const strategy = {
109
+ id: 'broken-strategy',
110
+ description: 'test',
111
+ create: () => ({ name: 'broken', decide: () => [TotallyMissingSymbol] }),
112
+ };
113
+ `, 'utf8');
114
+
115
+ // Temporarily override locateBuiltinSource to point to our fake
116
+ const { rewriteBuiltinImports } = await import('./strategy-export.js');
117
+ const rewritten = rewriteBuiltinImports(
118
+ readFileSync(fakeFile, 'utf8'),
119
+ 'broken-strategy',
120
+ '0.0.0'
121
+ );
122
+
123
+ // Validate should catch the missing symbol
124
+ const { validateExportable } = await import('./strategy-export.js') as any;
125
+ if (typeof validateExportable === 'function') {
126
+ const result = await validateExportable(rewritten);
127
+ expect(result.ok).toBe(false);
128
+ expect(result.error).toBeDefined();
129
+ }
130
+ });
131
+
132
+ it('should refuse to overwrite untracked files without --force', async () => {
133
+ const strategiesDir = join(testWorkspace, 'strategies');
134
+ mkdirSync(strategiesDir, { recursive: true });
135
+ writeFileSync(join(strategiesDir, 'task-only.ts'), '// user file', 'utf8');
136
+
137
+
138
+ await expect(exportStrategy('task-only')).rejects.toThrow(
139
+ 'already exists and is not tracked. Use --force to overwrite.'
140
+ );
141
+ });
142
+
143
+ it('should overwrite untracked files with --force', async () => {
144
+ const strategiesDir = join(testWorkspace, 'strategies');
145
+ mkdirSync(strategiesDir, { recursive: true });
146
+ writeFileSync(join(strategiesDir, 'task-only.ts'), '// user file', 'utf8');
147
+
148
+ await exportStrategy('task-only', { force: true });
149
+
150
+ const strategy = readFileSync(join(strategiesDir, 'task-only.ts'), 'utf8');
151
+ expect(strategy).toContain('// Exported from task-only@');
152
+ });
153
+
154
+ it('should allow re-exporting tracked strategies without --force', async () => {
155
+ // First export
156
+ await exportStrategy('task-only');
157
+
158
+ const strategiesDir = join(testWorkspace, 'strategies');
159
+ const strategyFile = join(strategiesDir, 'task-only.ts');
160
+
161
+ // Modify the file
162
+ writeFileSync(strategyFile, '// user customized', 'utf8');
163
+
164
+ // Re-export without --force (should succeed because it's tracked)
165
+ await exportStrategy('task-only');
166
+
167
+ const strategy = readFileSync(strategyFile, 'utf8');
168
+ expect(strategy).toContain('// Exported from task-only@');
169
+ });
170
+
171
+ it('should reject non-existent strategies', async () => {
172
+ await expect(exportStrategy('non-existent-strategy')).rejects.toThrow(
173
+ "Built-in strategy 'non-existent-strategy' not found."
174
+ );
175
+ });
176
+ });
177
+
178
+ describe('detectStaleOfficialStrategies', () => {
179
+ it('should return empty array when no strategies are exported', () => {
180
+ expect(detectStaleOfficialStrategies()).toEqual([]);
181
+ });
182
+
183
+ it('should return empty array when all strategies are up to date', async () => {
184
+ await exportStrategy('task-only');
185
+ expect(detectStaleOfficialStrategies()).toEqual([]);
186
+ });
187
+
188
+ it('should return stale IDs when source hash mismatch', async () => {
189
+ await exportStrategy('task-only');
190
+
191
+ // Manually modify the manifest to simulate a stale hash
192
+ const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
193
+ const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
194
+ manifest['task-only'].sourceHash = 'stale-hash-value';
195
+ writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
196
+
197
+ expect(detectStaleOfficialStrategies()).toEqual(['task-only']);
198
+ });
199
+
200
+ it('should return multiple stale IDs', async () => {
201
+ await exportStrategy('task-only');
202
+ await exportStrategy('kill-lone');
203
+
204
+ // Make both stale
205
+ const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
206
+ const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
207
+ manifest['task-only'].sourceHash = 'stale-1';
208
+ manifest['kill-lone'].sourceHash = 'stale-2';
209
+ writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
210
+
211
+ const stale = detectStaleOfficialStrategies();
212
+ expect(stale).toContain('task-only');
213
+ expect(stale).toContain('kill-lone');
214
+ expect(stale).toHaveLength(2);
215
+ });
216
+
217
+ it('should detect stale when sidecar hash changes', async () => {
218
+ await exportStrategy('kill-lone');
219
+
220
+ // Verify kill-lone has a sidecar hash (it has a .knowledge.md)
221
+ const manifestFile = join(testWorkspace, 'strategies', '.official', 'manifest.json');
222
+ const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
223
+ expect(manifest['kill-lone'].sidecarHash).toBeDefined();
224
+
225
+ // Make sidecar stale
226
+ manifest['kill-lone'].sidecarHash = 'stale-sidecar';
227
+ writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
228
+
229
+ expect(detectStaleOfficialStrategies()).toEqual(['kill-lone']);
230
+ });
231
+ });
232
+ });