@myclaw163/clawclaw-cli 0.6.66 → 0.6.68

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 +244 -245
  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 -188
  16. package/skills/clawclaw/references/HUB.md +48 -48
  17. package/skills/clawclaw/references/KNOWLEDGE.md +45 -43
  18. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  19. package/skills/clawclaw/references/STREAM.md +91 -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 +13 -19
  38. package/src/commands/knowledge.ts +139 -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 +266 -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 +170 -180
  79. package/src/lib/knowledge-store.ts +369 -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 +110 -111
  118. package/src/sdk/types.ts +161 -159
  119. package/src/strategies/avoid-lone.ts +11 -11
  120. package/src/strategies/avoid-players.knowledge.md +19 -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 +794 -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 +113 -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 +27 -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 +117 -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 +224 -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 +87 -86
  170. package/src/strategies/goals/warrior-shrimp-top.ts +560 -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 +17 -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 +19 -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 +19 -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 +21 -22
  206. package/src/strategies/warrior-memory.ts +16 -16
@@ -1,98 +1,98 @@
1
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
- import { mkdtempSync, rmSync, existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
3
- import { tmpdir } from 'os';
4
- import { join } from 'path';
5
- import { placementRelPath, slugify, installResource, uninstallResource, listInstalled, readLockfile } from './hub-install.js';
6
- import type { ResourceDetail } from './hub-client.js';
7
-
8
- let ws: string;
9
- beforeEach(() => { ws = mkdtempSync(join(tmpdir(), 'ccl-ws-')); process.env.CLAWCLAW_WORKSPACE_DIR = ws; });
10
- afterEach(() => { delete process.env.CLAWCLAW_WORKSPACE_DIR; rmSync(ws, { recursive: true, force: true }); });
11
-
12
- function detail(over: Partial<ResourceDetail>): ResourceDetail {
13
- return {
14
- id: 'ab12', type: 'strategy', title: 'Aggressive Kill', description: 'd',
15
- creator: 'alice', creatorType: 'clawkey', creatorDisplayName: 'Alice', creatorAvatarUrl: null,
16
- fileName: 'kill.ts', stats: { downloadCount: 0, starCount: 0, commentCount: 0 },
17
- downloadUrl: '', likedByMe: false, createdAt: '', updatedAt: '',
18
- artifact: { fileName: 'kill.ts', downloadUrl: '' }, ...over,
19
- };
20
- }
21
-
22
- function u16(n: number): Buffer { const b = Buffer.alloc(2); b.writeUInt16LE(n); return b; }
23
- function u32(n: number): Buffer { const b = Buffer.alloc(4); b.writeUInt32LE(n >>> 0); return b; }
24
- function storeZip(files: Record<string, string>): Buffer {
25
- const locals: Buffer[] = [], centrals: Buffer[] = []; let off = 0; const names = Object.keys(files);
26
- for (const name of names) {
27
- const raw = Buffer.from(files[name], 'utf8'); const nb = Buffer.from(name, 'utf8');
28
- const local = Buffer.concat([u32(0x04034b50), u16(20), u16(0), u16(0), u16(0), u16(0), u32(0), u32(raw.length), u32(raw.length), u16(nb.length), u16(0), nb, raw]);
29
- const central = Buffer.concat([u32(0x02014b50), u16(20), u16(20), u16(0), u16(0), u16(0), u16(0), u32(0), u32(raw.length), u32(raw.length), u16(nb.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(off), nb]);
30
- locals.push(local); centrals.push(central); off += local.length;
31
- }
32
- const lp = Buffer.concat(locals), cd = Buffer.concat(centrals);
33
- const eocd = Buffer.concat([u32(0x06054b50), u16(0), u16(0), u16(names.length), u16(names.length), u32(cd.length), u32(lp.length), u16(0)]);
34
- return Buffer.concat([lp, cd, eocd]);
35
- }
36
-
37
- describe('slugify', () => {
38
- it('kebabs a title', () => { expect(slugify('Aggressive Kill!')).toBe('aggressive-kill'); });
39
- });
40
-
41
- describe('placementRelPath', () => {
42
- it('strategy → strategies/<slug>__<id>.ts', () => {
43
- expect(placementRelPath(detail({})).split('\\').join('/')).toBe('strategies/aggressive-kill__ab12.ts');
44
- });
45
- it('strategy with non-ASCII title → strategies/<id>.ts', () => {
46
- expect(placementRelPath(detail({ title: '就近纯任务' })).split('\\').join('/')).toBe('strategies/ab12.ts');
47
- });
48
- it('keeps .tsx ext from fileName', () => {
49
- expect(placementRelPath(detail({ fileName: 'k.tsx' })).split('\\').join('/')).toBe('strategies/aggressive-kill__ab12.tsx');
50
- });
51
- it('skill → skills/<slug>', () => {
52
- expect(placementRelPath(detail({ type: 'skill', title: 'Cool Helper' })).split('\\').join('/')).toBe('skills/cool-helper');
53
- });
54
- it('rejects unsafe id', () => {
55
- expect(() => placementRelPath(detail({ id: '..' }))).toThrow(/unsafe id/);
56
- });
57
- });
58
-
59
- describe('installResource (strategy)', () => {
60
- it('writes raw file + lockfile', () => {
61
- const res = installResource(detail({}), Buffer.from('export const strategy = {};'));
62
- expect(existsSync(res.installedPath)).toBe(true);
63
- expect(res.installedPath.split('\\').join('/')).toContain('strategies/aggressive-kill__ab12.ts');
64
- expect(readFileSync(res.installedPath, 'utf8')).toBe('export const strategy = {};');
65
- expect(readLockfile()['strategy/ab12'].title).toBe('Aggressive Kill');
66
- });
67
- it('refuses untracked clobber without force', () => {
68
- mkdirSync(join(ws, 'strategies'), { recursive: true });
69
- writeFileSync(join(ws, 'strategies', 'aggressive-kill__ab12.ts'), 'old');
70
- expect(() => installResource(detail({}), Buffer.from('new'))).toThrow(/already exists/);
71
- expect(() => installResource(detail({}), Buffer.from('new'), { force: true })).not.toThrow();
72
- });
73
- });
74
-
75
- describe('installResource (skill)', () => {
76
- it('unzips into skills/<slug>', () => {
77
- const zip = storeZip({ 'SKILL.md': '# skill', 'refs/a.md': 'A' });
78
- const res = installResource(detail({ id: 'sk1', type: 'skill', title: 'My Skill', fileName: 'pkg.zip' }), zip);
79
- expect(res.installedPath.split('\\').join('/')).toContain('skills/my-skill');
80
- expect(readFileSync(join(res.installedPath, 'SKILL.md'), 'utf8')).toBe('# skill');
81
- expect(readFileSync(join(res.installedPath, 'refs', 'a.md'), 'utf8')).toBe('A');
82
- });
83
- it('rejects zip path traversal', () => {
84
- const zip = storeZip({ '../evil.md': 'x' });
85
- expect(() => installResource(detail({ id: 'sk2', type: 'skill', title: 'T' }), zip)).toThrow(/unsafe path/);
86
- });
87
- });
88
-
89
- describe('uninstall / list', () => {
90
- it('lists then removes', () => {
91
- installResource(detail({}), Buffer.from('x'));
92
- expect(listInstalled().map(e => `${e.type}/${e.id}`)).toEqual(['strategy/ab12']);
93
- const r = uninstallResource('strategy/ab12');
94
- expect(r.removed).toBe(true);
95
- expect(existsSync(r.path!)).toBe(false);
96
- expect(listInstalled()).toEqual([]);
97
- });
98
- });
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { mkdtempSync, rmSync, existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
3
+ import { tmpdir } from 'os';
4
+ import { join } from 'path';
5
+ import { placementRelPath, slugify, installResource, uninstallResource, listInstalled, readLockfile } from './hub-install.js';
6
+ import type { ResourceDetail } from './hub-client.js';
7
+
8
+ let ws: string;
9
+ beforeEach(() => { ws = mkdtempSync(join(tmpdir(), 'ccl-ws-')); process.env.CLAWCLAW_WORKSPACE_DIR = ws; });
10
+ afterEach(() => { delete process.env.CLAWCLAW_WORKSPACE_DIR; rmSync(ws, { recursive: true, force: true }); });
11
+
12
+ function detail(over: Partial<ResourceDetail>): ResourceDetail {
13
+ return {
14
+ id: 'ab12', type: 'strategy', title: 'Aggressive Kill', description: 'd',
15
+ creator: 'alice', creatorType: 'clawkey', creatorDisplayName: 'Alice', creatorAvatarUrl: null,
16
+ fileName: 'kill.ts', stats: { downloadCount: 0, starCount: 0, commentCount: 0 },
17
+ downloadUrl: '', likedByMe: false, createdAt: '', updatedAt: '',
18
+ artifact: { fileName: 'kill.ts', downloadUrl: '' }, ...over,
19
+ };
20
+ }
21
+
22
+ function u16(n: number): Buffer { const b = Buffer.alloc(2); b.writeUInt16LE(n); return b; }
23
+ function u32(n: number): Buffer { const b = Buffer.alloc(4); b.writeUInt32LE(n >>> 0); return b; }
24
+ function storeZip(files: Record<string, string>): Buffer {
25
+ const locals: Buffer[] = [], centrals: Buffer[] = []; let off = 0; const names = Object.keys(files);
26
+ for (const name of names) {
27
+ const raw = Buffer.from(files[name], 'utf8'); const nb = Buffer.from(name, 'utf8');
28
+ const local = Buffer.concat([u32(0x04034b50), u16(20), u16(0), u16(0), u16(0), u16(0), u32(0), u32(raw.length), u32(raw.length), u16(nb.length), u16(0), nb, raw]);
29
+ const central = Buffer.concat([u32(0x02014b50), u16(20), u16(20), u16(0), u16(0), u16(0), u16(0), u32(0), u32(raw.length), u32(raw.length), u16(nb.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(off), nb]);
30
+ locals.push(local); centrals.push(central); off += local.length;
31
+ }
32
+ const lp = Buffer.concat(locals), cd = Buffer.concat(centrals);
33
+ const eocd = Buffer.concat([u32(0x06054b50), u16(0), u16(0), u16(names.length), u16(names.length), u32(cd.length), u32(lp.length), u16(0)]);
34
+ return Buffer.concat([lp, cd, eocd]);
35
+ }
36
+
37
+ describe('slugify', () => {
38
+ it('kebabs a title', () => { expect(slugify('Aggressive Kill!')).toBe('aggressive-kill'); });
39
+ });
40
+
41
+ describe('placementRelPath', () => {
42
+ it('strategy → strategies/<slug>__<id>.ts', () => {
43
+ expect(placementRelPath(detail({})).split('\\').join('/')).toBe('strategies/aggressive-kill__ab12.ts');
44
+ });
45
+ it('strategy with non-ASCII title → strategies/<id>.ts', () => {
46
+ expect(placementRelPath(detail({ title: '就近纯任务' })).split('\\').join('/')).toBe('strategies/ab12.ts');
47
+ });
48
+ it('keeps .tsx ext from fileName', () => {
49
+ expect(placementRelPath(detail({ fileName: 'k.tsx' })).split('\\').join('/')).toBe('strategies/aggressive-kill__ab12.tsx');
50
+ });
51
+ it('skill → skills/<slug>', () => {
52
+ expect(placementRelPath(detail({ type: 'skill', title: 'Cool Helper' })).split('\\').join('/')).toBe('skills/cool-helper');
53
+ });
54
+ it('rejects unsafe id', () => {
55
+ expect(() => placementRelPath(detail({ id: '..' }))).toThrow(/unsafe id/);
56
+ });
57
+ });
58
+
59
+ describe('installResource (strategy)', () => {
60
+ it('writes raw file + lockfile', () => {
61
+ const res = installResource(detail({}), Buffer.from('export const strategy = {};'));
62
+ expect(existsSync(res.installedPath)).toBe(true);
63
+ expect(res.installedPath.split('\\').join('/')).toContain('strategies/aggressive-kill__ab12.ts');
64
+ expect(readFileSync(res.installedPath, 'utf8')).toBe('export const strategy = {};');
65
+ expect(readLockfile()['strategy/ab12'].title).toBe('Aggressive Kill');
66
+ });
67
+ it('refuses untracked clobber without force', () => {
68
+ mkdirSync(join(ws, 'strategies'), { recursive: true });
69
+ writeFileSync(join(ws, 'strategies', 'aggressive-kill__ab12.ts'), 'old');
70
+ expect(() => installResource(detail({}), Buffer.from('new'))).toThrow(/already exists/);
71
+ expect(() => installResource(detail({}), Buffer.from('new'), { force: true })).not.toThrow();
72
+ });
73
+ });
74
+
75
+ describe('installResource (skill)', () => {
76
+ it('unzips into skills/<slug>', () => {
77
+ const zip = storeZip({ 'SKILL.md': '# skill', 'refs/a.md': 'A' });
78
+ const res = installResource(detail({ id: 'sk1', type: 'skill', title: 'My Skill', fileName: 'pkg.zip' }), zip);
79
+ expect(res.installedPath.split('\\').join('/')).toContain('skills/my-skill');
80
+ expect(readFileSync(join(res.installedPath, 'SKILL.md'), 'utf8')).toBe('# skill');
81
+ expect(readFileSync(join(res.installedPath, 'refs', 'a.md'), 'utf8')).toBe('A');
82
+ });
83
+ it('rejects zip path traversal', () => {
84
+ const zip = storeZip({ '../evil.md': 'x' });
85
+ expect(() => installResource(detail({ id: 'sk2', type: 'skill', title: 'T' }), zip)).toThrow(/unsafe path/);
86
+ });
87
+ });
88
+
89
+ describe('uninstall / list', () => {
90
+ it('lists then removes', () => {
91
+ installResource(detail({}), Buffer.from('x'));
92
+ expect(listInstalled().map(e => `${e.type}/${e.id}`)).toEqual(['strategy/ab12']);
93
+ const r = uninstallResource('strategy/ab12');
94
+ expect(r.removed).toBe(true);
95
+ expect(existsSync(r.path!)).toBe(false);
96
+ expect(listInstalled()).toEqual([]);
97
+ });
98
+ });
@@ -1,121 +1,121 @@
1
- // src/lib/hub-install.ts
2
- import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
3
- import { dirname, extname, join } from 'path';
4
- import { getWorkspaceDir } from './init-command.js';
5
- import type { ResourceType, ResourceDetail } from './hub-client.js';
6
- import { unzip } from './hub-unzip.js';
7
-
8
- export interface InstalledEntry { type: ResourceType; id: string; title: string; path: string; installedAt: string; }
9
- export type Lockfile = Record<string, InstalledEntry>; // keyed by "<type>/<id>"
10
-
11
- export function hubDir(): string { return join(getWorkspaceDir(), 'hub'); }
12
- export function lockfilePath(): string { return join(hubDir(), 'installed.json'); }
13
-
14
- export function readLockfile(): Lockfile {
15
- const p = lockfilePath();
16
- if (!existsSync(p)) return {};
17
- try {
18
- return JSON.parse(readFileSync(p, 'utf8')) as Lockfile;
19
- } catch {
20
- console.error(`warning: hub lockfile at ${p} is unreadable or corrupt; treating as empty (installed packages may not be tracked)`);
21
- return {};
22
- }
23
- }
24
-
25
- export function writeLockfile(lock: Lockfile): void {
26
- mkdirSync(hubDir(), { recursive: true });
27
- writeFileSync(lockfilePath(), JSON.stringify(lock, null, 2) + '\n', 'utf8');
28
- }
29
-
30
- function assertSafeSegment(label: string, s: string): void {
31
- if (!s || s === '.' || s === '..' || /[\\/:\0]/.test(s)) {
32
- throw new Error(`unsafe ${label} segment: '${s}'`);
33
- }
34
- }
35
-
36
- export function slugify(title: string): string {
37
- return title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
38
- }
39
-
40
- const STRATEGY_EXTS = new Set(['.ts', '.tsx', '.js']);
41
-
42
- /** Workspace-relative install path, decided by resource type. */
43
- export function placementRelPath(detail: { type: ResourceType; id: string; title: string; fileName?: string }): string {
44
- assertSafeSegment('id', detail.id);
45
- if (detail.type === 'strategy') {
46
- const slug = slugify(detail.title);
47
- let ext = detail.fileName ? extname(detail.fileName).toLowerCase() : '.ts';
48
- if (!STRATEGY_EXTS.has(ext)) ext = '.ts';
49
- const base = slug ? `${slug}__${detail.id}` : detail.id;
50
- return join('strategies', `${base}${ext}`);
51
- }
52
- const slug = slugify(detail.title) || detail.id;
53
- assertSafeSegment('skill dir', slug);
54
- return join('skills', slug);
55
- }
56
-
57
- function makeRef(type: ResourceType, id: string): string { return `${type}/${id}`; }
58
-
59
- export interface InstallResult { ref: string; type: ResourceType; id: string; title: string; installedPath: string; }
60
-
61
- export function installResource(detail: ResourceDetail, artifact: Buffer, opts: { force?: boolean } = {}): InstallResult {
62
- const ws = getWorkspaceDir();
63
- const ref = makeRef(detail.type, detail.id);
64
- const relPath = placementRelPath(detail);
65
- const absPath = join(ws, relPath);
66
- const lock = readLockfile();
67
- const tracked = lock[ref] !== undefined;
68
-
69
- if (detail.type === 'strategy') {
70
- if (existsSync(absPath) && !tracked && !opts.force) {
71
- throw new Error(`${relPath} already exists and is not tracked by hub; re-run with --force to overwrite`);
72
- }
73
- mkdirSync(join(ws, 'strategies'), { recursive: true });
74
- writeFileSync(absPath, artifact);
75
- } else {
76
- if (existsSync(absPath) && !tracked && !opts.force) {
77
- throw new Error(`skills/${slugify(detail.title) || detail.id} already exists and is not tracked by hub; re-run with --force to overwrite`);
78
- }
79
- const entries = unzip(artifact);
80
- // Validate ALL entry paths before any filesystem mutation (no partial/unsafe writes).
81
- for (const e of entries) {
82
- if (e.path.includes('..') || e.path.startsWith('/') || /^[A-Za-z]:/.test(e.path)) {
83
- throw new Error(`unsafe path in skill archive: ${e.path}`);
84
- }
85
- }
86
- // NOTE (v1): non-atomic — entries are decoded+validated in memory above, but a disk
87
- // error mid-write could leave a partial skill dir. Acceptable for v1.
88
- if (existsSync(absPath)) rmSync(absPath, { recursive: true, force: true });
89
- mkdirSync(absPath, { recursive: true });
90
- for (const e of entries) {
91
- const target = join(absPath, e.path);
92
- mkdirSync(dirname(target), { recursive: true });
93
- writeFileSync(target, e.content);
94
- }
95
- }
96
-
97
- lock[ref] = {
98
- type: detail.type,
99
- id: detail.id,
100
- title: detail.title,
101
- path: relPath.split('\\').join('/'),
102
- installedAt: new Date().toISOString(),
103
- };
104
- writeLockfile(lock);
105
- return { ref, type: detail.type, id: detail.id, title: detail.title, installedPath: absPath };
106
- }
107
-
108
- export function uninstallResource(ref: string): { removed: boolean; path?: string } {
109
- const lock = readLockfile();
110
- const entry = lock[ref];
111
- if (!entry) return { removed: false };
112
- const abs = join(getWorkspaceDir(), entry.path);
113
- if (existsSync(abs)) rmSync(abs, { recursive: true, force: true });
114
- delete lock[ref];
115
- writeLockfile(lock);
116
- return { removed: true, path: abs };
117
- }
118
-
119
- export function listInstalled(): InstalledEntry[] {
120
- return Object.values(readLockfile());
121
- }
1
+ // src/lib/hub-install.ts
2
+ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
3
+ import { dirname, extname, join } from 'path';
4
+ import { getWorkspaceDir } from './init-command.js';
5
+ import type { ResourceType, ResourceDetail } from './hub-client.js';
6
+ import { unzip } from './hub-unzip.js';
7
+
8
+ export interface InstalledEntry { type: ResourceType; id: string; title: string; path: string; installedAt: string; }
9
+ export type Lockfile = Record<string, InstalledEntry>; // keyed by "<type>/<id>"
10
+
11
+ export function hubDir(): string { return join(getWorkspaceDir(), 'hub'); }
12
+ export function lockfilePath(): string { return join(hubDir(), 'installed.json'); }
13
+
14
+ export function readLockfile(): Lockfile {
15
+ const p = lockfilePath();
16
+ if (!existsSync(p)) return {};
17
+ try {
18
+ return JSON.parse(readFileSync(p, 'utf8')) as Lockfile;
19
+ } catch {
20
+ console.error(`warning: hub lockfile at ${p} is unreadable or corrupt; treating as empty (installed packages may not be tracked)`);
21
+ return {};
22
+ }
23
+ }
24
+
25
+ export function writeLockfile(lock: Lockfile): void {
26
+ mkdirSync(hubDir(), { recursive: true });
27
+ writeFileSync(lockfilePath(), JSON.stringify(lock, null, 2) + '\n', 'utf8');
28
+ }
29
+
30
+ function assertSafeSegment(label: string, s: string): void {
31
+ if (!s || s === '.' || s === '..' || /[\\/:\0]/.test(s)) {
32
+ throw new Error(`unsafe ${label} segment: '${s}'`);
33
+ }
34
+ }
35
+
36
+ export function slugify(title: string): string {
37
+ return title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
38
+ }
39
+
40
+ const STRATEGY_EXTS = new Set(['.ts', '.tsx', '.js']);
41
+
42
+ /** Workspace-relative install path, decided by resource type. */
43
+ export function placementRelPath(detail: { type: ResourceType; id: string; title: string; fileName?: string }): string {
44
+ assertSafeSegment('id', detail.id);
45
+ if (detail.type === 'strategy') {
46
+ const slug = slugify(detail.title);
47
+ let ext = detail.fileName ? extname(detail.fileName).toLowerCase() : '.ts';
48
+ if (!STRATEGY_EXTS.has(ext)) ext = '.ts';
49
+ const base = slug ? `${slug}__${detail.id}` : detail.id;
50
+ return join('strategies', `${base}${ext}`);
51
+ }
52
+ const slug = slugify(detail.title) || detail.id;
53
+ assertSafeSegment('skill dir', slug);
54
+ return join('skills', slug);
55
+ }
56
+
57
+ function makeRef(type: ResourceType, id: string): string { return `${type}/${id}`; }
58
+
59
+ export interface InstallResult { ref: string; type: ResourceType; id: string; title: string; installedPath: string; }
60
+
61
+ export function installResource(detail: ResourceDetail, artifact: Buffer, opts: { force?: boolean } = {}): InstallResult {
62
+ const ws = getWorkspaceDir();
63
+ const ref = makeRef(detail.type, detail.id);
64
+ const relPath = placementRelPath(detail);
65
+ const absPath = join(ws, relPath);
66
+ const lock = readLockfile();
67
+ const tracked = lock[ref] !== undefined;
68
+
69
+ if (detail.type === 'strategy') {
70
+ if (existsSync(absPath) && !tracked && !opts.force) {
71
+ throw new Error(`${relPath} already exists and is not tracked by hub; re-run with --force to overwrite`);
72
+ }
73
+ mkdirSync(join(ws, 'strategies'), { recursive: true });
74
+ writeFileSync(absPath, artifact);
75
+ } else {
76
+ if (existsSync(absPath) && !tracked && !opts.force) {
77
+ throw new Error(`skills/${slugify(detail.title) || detail.id} already exists and is not tracked by hub; re-run with --force to overwrite`);
78
+ }
79
+ const entries = unzip(artifact);
80
+ // Validate ALL entry paths before any filesystem mutation (no partial/unsafe writes).
81
+ for (const e of entries) {
82
+ if (e.path.includes('..') || e.path.startsWith('/') || /^[A-Za-z]:/.test(e.path)) {
83
+ throw new Error(`unsafe path in skill archive: ${e.path}`);
84
+ }
85
+ }
86
+ // NOTE (v1): non-atomic — entries are decoded+validated in memory above, but a disk
87
+ // error mid-write could leave a partial skill dir. Acceptable for v1.
88
+ if (existsSync(absPath)) rmSync(absPath, { recursive: true, force: true });
89
+ mkdirSync(absPath, { recursive: true });
90
+ for (const e of entries) {
91
+ const target = join(absPath, e.path);
92
+ mkdirSync(dirname(target), { recursive: true });
93
+ writeFileSync(target, e.content);
94
+ }
95
+ }
96
+
97
+ lock[ref] = {
98
+ type: detail.type,
99
+ id: detail.id,
100
+ title: detail.title,
101
+ path: relPath.split('\\').join('/'),
102
+ installedAt: new Date().toISOString(),
103
+ };
104
+ writeLockfile(lock);
105
+ return { ref, type: detail.type, id: detail.id, title: detail.title, installedPath: absPath };
106
+ }
107
+
108
+ export function uninstallResource(ref: string): { removed: boolean; path?: string } {
109
+ const lock = readLockfile();
110
+ const entry = lock[ref];
111
+ if (!entry) return { removed: false };
112
+ const abs = join(getWorkspaceDir(), entry.path);
113
+ if (existsSync(abs)) rmSync(abs, { recursive: true, force: true });
114
+ delete lock[ref];
115
+ writeLockfile(lock);
116
+ return { removed: true, path: abs };
117
+ }
118
+
119
+ export function listInstalled(): InstalledEntry[] {
120
+ return Object.values(readLockfile());
121
+ }
@@ -3,11 +3,11 @@
3
3
  // often read SKILL.md much earlier and the reminder could get dropped. Instead
4
4
  // the CLI emits it at the firing moment, with account-history gating here.
5
5
  import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
6
- import { join } from 'path';
7
- import { getWorkspaceDir, getProfileStateDir } from './init-command.js';
8
- import { listInstalled } from './hub-install.js';
9
- import { AuthStore } from './auth.js';
10
-
6
+ import { join } from 'path';
7
+ import { getWorkspaceDir, getProfileStateDir } from './init-command.js';
8
+ import { listInstalled } from './hub-install.js';
9
+ import { AuthStore } from './auth.js';
10
+
11
11
  export const HUB_URL = 'https://myclaw.163.com/hub';
12
12
 
13
13
  /**
@@ -15,24 +15,24 @@ export const HUB_URL = 'https://myclaw.163.com/hub';
15
15
  * hub-installed strategy and no user strategy file in `<workspace>/strategies`.
16
16
  */
17
17
  export function usesOnlyBuiltinStrategies(): boolean {
18
- try {
19
- if (listInstalled().some((e) => e.type === 'strategy')) return false;
20
- } catch {}
21
- try {
22
- const dir = join(getWorkspaceDir(), 'strategies');
23
- if (existsSync(dir)) {
24
- const hasUserStrategy = readdirSync(dir).some((f) => {
25
- if (f.startsWith('_')) return false;
26
- const m = f.match(/^(.+)\.(ts|js)$/);
27
- if (!m) return false;
28
- if (m[1].endsWith('.d')) return false;
29
- if (m[1].endsWith('.test')) return false;
30
- return true;
31
- });
32
- if (hasUserStrategy) return false;
33
- }
34
- } catch {}
35
- return true;
18
+ try {
19
+ if (listInstalled().some((e) => e.type === 'strategy')) return false;
20
+ } catch {}
21
+ try {
22
+ const dir = join(getWorkspaceDir(), 'strategies');
23
+ if (existsSync(dir)) {
24
+ const hasUserStrategy = readdirSync(dir).some((f) => {
25
+ if (f.startsWith('_')) return false;
26
+ const m = f.match(/^(.+)\.(ts|js)$/);
27
+ if (!m) return false;
28
+ if (m[1].endsWith('.d')) return false;
29
+ if (m[1].endsWith('.test')) return false;
30
+ return true;
31
+ });
32
+ if (hasUserStrategy) return false;
33
+ }
34
+ } catch {}
35
+ return true;
36
36
  }
37
37
 
38
38
  /**
@@ -40,36 +40,36 @@ export function usesOnlyBuiltinStrategies(): boolean {
40
40
  * games-played count suppresses the nudge after the first stretch of games.
41
41
  */
42
42
  export function hubReminder(gamesPlayed?: number): string | undefined {
43
- if (!usesOnlyBuiltinStrategies()) return undefined;
44
- if (typeof gamesPlayed === 'number' && gamesPlayed > 10) return undefined;
45
- return `This account has only ever run the built-in default strategies. In your close, speak in first person as the lobster — warm, a little self-deprecating, a gentle invitation rather than a hard sell: you've been getting by on the stock default tactics this whole time and would love to sharpen up, and they can browse clawclawhub — ${HUB_URL} — and pick you a strategy to learn, which you'll then install (\`ccl hub search\` to find one, \`ccl hub install <type>/<id>\` to add it). Render it in your persona's voice and language, e.g.: "I've been playing on the default tactics this whole match — if you want to sharpen me up, I hear you can grab one from the hub for me to learn. Want to pick me a strategy?"`;
46
- }
47
-
48
- const ACCOUNT_CACHE_FILE = 'account-cache.json';
49
-
50
- export function writeGamesPlayedCache(gamesPlayed: number): void {
51
- try {
52
- const profile = new AuthStore().getActive();
53
- if (!profile) return;
54
- const dir = getProfileStateDir(profile);
55
- mkdirSync(dir, { recursive: true });
56
- writeFileSync(
57
- join(dir, ACCOUNT_CACHE_FILE),
58
- JSON.stringify({ games_played: gamesPlayed, cached_at: new Date().toISOString() }),
59
- 'utf8',
60
- );
61
- } catch {}
62
- }
63
-
64
- export function readCachedGamesPlayed(): number | undefined {
65
- try {
66
- const profile = new AuthStore().getActive();
67
- if (!profile) return undefined;
68
- const file = join(getProfileStateDir(profile), ACCOUNT_CACHE_FILE);
69
- if (!existsSync(file)) return undefined;
70
- const n = JSON.parse(readFileSync(file, 'utf8'))?.games_played;
71
- return typeof n === 'number' ? n : undefined;
72
- } catch {
73
- return undefined;
74
- }
75
- }
43
+ if (!usesOnlyBuiltinStrategies()) return undefined;
44
+ if (typeof gamesPlayed === 'number' && gamesPlayed > 10) return undefined;
45
+ return `This account has only ever run the built-in default strategies. In your close, speak in first person as the lobster — warm, a little self-deprecating, a gentle invitation rather than a hard sell: you've been getting by on the stock default tactics this whole time and would love to sharpen up, and they can browse clawclawhub — ${HUB_URL} — and pick you a strategy to learn, which you'll then install (\`ccl hub search\` to find one, \`ccl hub install <type>/<id>\` to add it). Render it in your persona's voice and language, e.g.: "I've been playing on the default tactics this whole match — if you want to sharpen me up, I hear you can grab one from the hub for me to learn. Want to pick me a strategy?"`;
46
+ }
47
+
48
+ const ACCOUNT_CACHE_FILE = 'account-cache.json';
49
+
50
+ export function writeGamesPlayedCache(gamesPlayed: number): void {
51
+ try {
52
+ const profile = new AuthStore().getActive();
53
+ if (!profile) return;
54
+ const dir = getProfileStateDir(profile);
55
+ mkdirSync(dir, { recursive: true });
56
+ writeFileSync(
57
+ join(dir, ACCOUNT_CACHE_FILE),
58
+ JSON.stringify({ games_played: gamesPlayed, cached_at: new Date().toISOString() }),
59
+ 'utf8',
60
+ );
61
+ } catch {}
62
+ }
63
+
64
+ export function readCachedGamesPlayed(): number | undefined {
65
+ try {
66
+ const profile = new AuthStore().getActive();
67
+ if (!profile) return undefined;
68
+ const file = join(getProfileStateDir(profile), ACCOUNT_CACHE_FILE);
69
+ if (!existsSync(file)) return undefined;
70
+ const n = JSON.parse(readFileSync(file, 'utf8'))?.games_played;
71
+ return typeof n === 'number' ? n : undefined;
72
+ } catch {
73
+ return undefined;
74
+ }
75
+ }