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