@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,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
+ });