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