@myclaw163/clawclaw-cli 0.6.55 → 0.6.57

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 (189) hide show
  1. package/README.md +440 -440
  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/postinstall.mjs +20 -20
  10. package/scripts/sync-bundled-skill.mjs +245 -245
  11. package/scripts/sync-bundled-skill.test.mjs +152 -152
  12. package/skills/clawclaw/SKILL.md +244 -240
  13. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  14. package/skills/clawclaw/references/COMMANDS.md +132 -132
  15. package/skills/clawclaw/references/GAME-MECHANICS.md +186 -186
  16. package/skills/clawclaw/references/HUB.md +48 -48
  17. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  18. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  19. package/skills/clawclaw/references/STREAM.md +59 -58
  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 -153
  23. package/src/commands/_schema.ts +109 -109
  24. package/src/commands/account.ts +209 -209
  25. package/src/commands/do.test.ts +37 -37
  26. package/src/commands/do.ts +95 -95
  27. package/src/commands/events.ts +22 -22
  28. package/src/commands/game-map.test.ts +28 -28
  29. package/src/commands/game-start-plan.test.ts +84 -142
  30. package/src/commands/game.ts +1027 -882
  31. package/src/commands/history-player.test.ts +102 -102
  32. package/src/commands/history.ts +573 -573
  33. package/src/commands/hub.test.ts +96 -96
  34. package/src/commands/hub.ts +234 -234
  35. package/src/commands/knowledge.test.ts +19 -19
  36. package/src/commands/knowledge.ts +168 -168
  37. package/src/commands/load.test.ts +51 -51
  38. package/src/commands/load.ts +13 -13
  39. package/src/commands/meeting-history.test.ts +106 -106
  40. package/src/commands/memory.ts +40 -40
  41. package/src/commands/peek.ts +45 -38
  42. package/src/commands/persona.ts +57 -57
  43. package/src/commands/skill.ts +128 -128
  44. package/src/commands/state.ts +46 -46
  45. package/src/commands/strategy.test.ts +135 -135
  46. package/src/commands/strategy.ts +180 -189
  47. package/src/commands/tts.ts +128 -128
  48. package/src/commands/upgrade.test.ts +82 -82
  49. package/src/commands/upgrade.ts +148 -148
  50. package/src/commands/watch.test.ts +969 -973
  51. package/src/commands/watch.ts +720 -709
  52. package/src/lib/auth.test.ts +59 -59
  53. package/src/lib/auth.ts +186 -186
  54. package/src/lib/command-meta.ts +37 -37
  55. package/src/lib/game-client.ts +391 -391
  56. package/src/lib/http-keepalive.ts +15 -15
  57. package/src/lib/http-transport.test.ts +42 -42
  58. package/src/lib/http-transport.ts +113 -113
  59. package/src/lib/hub-client.test.ts +56 -56
  60. package/src/lib/hub-client.ts +88 -88
  61. package/src/lib/hub-install.test.ts +98 -98
  62. package/src/lib/hub-install.ts +121 -121
  63. package/src/lib/hub-reminder.ts +75 -75
  64. package/src/lib/hub-unzip.test.ts +69 -69
  65. package/src/lib/hub-unzip.ts +62 -62
  66. package/src/lib/init-command.test.ts +75 -75
  67. package/src/lib/init-command.ts +120 -120
  68. package/src/lib/knowledge-store.test.ts +180 -180
  69. package/src/lib/knowledge-store.ts +374 -374
  70. package/src/lib/load-context.test.ts +52 -52
  71. package/src/lib/load-context.ts +52 -52
  72. package/src/lib/match-state.test.ts +134 -134
  73. package/src/lib/match-state.ts +94 -94
  74. package/src/lib/netease-tts.ts +83 -83
  75. package/src/lib/normalize.ts +42 -42
  76. package/src/lib/persona.test.ts +41 -41
  77. package/src/lib/persona.ts +72 -72
  78. package/src/lib/server-registry.ts +152 -152
  79. package/src/lib/skill-version.test.ts +48 -48
  80. package/src/lib/skill-version.ts +19 -19
  81. package/src/lib/strategy-export.test.ts +232 -232
  82. package/src/lib/strategy-export.ts +242 -242
  83. package/src/lib/tts-keys.ts +7 -7
  84. package/src/lib/tts-speech.test.ts +63 -63
  85. package/src/lib/tts-speech.ts +76 -76
  86. package/src/lib/workspace-argv.test.ts +49 -49
  87. package/src/lib/workspace-argv.ts +44 -44
  88. package/src/perception/player-history-store.test.ts +87 -87
  89. package/src/perception/player-history-store.ts +194 -194
  90. package/src/pipeline/event-store.ts +124 -124
  91. package/src/pipeline/pipeline.ts +35 -35
  92. package/src/runtime/auto-upgrade.test.ts +66 -66
  93. package/src/runtime/auto-upgrade.ts +31 -31
  94. package/src/runtime/event-daemon.test.ts +107 -28
  95. package/src/runtime/event-daemon.ts +409 -371
  96. package/src/runtime/owner-control.ts +150 -0
  97. package/src/runtime/raw-ws-log.test.ts +33 -33
  98. package/src/runtime/raw-ws-log.ts +32 -32
  99. package/src/runtime/runtime-logger.ts +107 -99
  100. package/src/runtime/ws-client.test.ts +104 -47
  101. package/src/runtime/ws-client.ts +272 -272
  102. package/src/sdk/action.ts +166 -166
  103. package/src/sdk/index.ts +110 -110
  104. package/src/sdk/types.ts +146 -146
  105. package/src/strategies/avoid-lone.ts +11 -11
  106. package/src/strategies/avoid-players.knowledge.md +20 -20
  107. package/src/strategies/avoid-players.ts +15 -15
  108. package/src/strategies/corpse-patrol.ts +22 -22
  109. package/src/strategies/crab-sabotage.ts +21 -21
  110. package/src/strategies/custom-module.test.ts +269 -269
  111. package/src/strategies/find-player.ts +16 -16
  112. package/src/strategies/game-utils.test.ts +164 -164
  113. package/src/strategies/game-utils.ts +737 -721
  114. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  115. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  116. package/src/strategies/goals/avoid-players-top.ts +121 -121
  117. package/src/strategies/goals/conversation-goal.ts +51 -51
  118. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  119. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  120. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  121. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  122. package/src/strategies/goals/find-player-top.ts +93 -93
  123. package/src/strategies/goals/flee-players-goal.ts +53 -53
  124. package/src/strategies/goals/goal-manager.ts +41 -41
  125. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  126. package/src/strategies/goals/goal.ts +28 -28
  127. package/src/strategies/goals/keep-away-goal.ts +206 -206
  128. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  129. package/src/strategies/goals/kill-lone-top.ts +160 -160
  130. package/src/strategies/goals/kill-target-goal.ts +59 -59
  131. package/src/strategies/goals/kill-target-top.ts +109 -109
  132. package/src/strategies/goals/leaf-goal.ts +25 -25
  133. package/src/strategies/goals/linger-corpse-goal.ts +79 -79
  134. package/src/strategies/goals/lone-kill-core.ts +82 -82
  135. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  136. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  137. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  138. package/src/strategies/goals/move-room-goal.ts +60 -60
  139. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  140. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  141. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  142. package/src/strategies/goals/paradise-fish-top.ts +219 -219
  143. package/src/strategies/goals/patrol-top.ts +57 -57
  144. package/src/strategies/goals/report-patrol-top.ts +80 -80
  145. package/src/strategies/goals/safe-task-goal.ts +102 -102
  146. package/src/strategies/goals/social-task-top.ts +161 -161
  147. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  148. package/src/strategies/goals/task-only-top.ts +57 -57
  149. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  150. package/src/strategies/goals/task-report-top.ts +57 -57
  151. package/src/strategies/goals/wander-task-goal.ts +33 -33
  152. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  153. package/src/strategies/goals/warrior-shrimp-top.ts +248 -248
  154. package/src/strategies/greeting.ts +53 -53
  155. package/src/strategies/kill-frenzy.ts +12 -12
  156. package/src/strategies/kill-lone.knowledge.md +20 -20
  157. package/src/strategies/kill-lone.ts +13 -13
  158. package/src/strategies/kill-target.ts +18 -18
  159. package/src/strategies/loader.test.ts +678 -678
  160. package/src/strategies/loader.ts +172 -172
  161. package/src/strategies/lone-kill-task.ts +21 -21
  162. package/src/strategies/meeting-gate.test.ts +59 -59
  163. package/src/strategies/meeting-gate.ts +23 -23
  164. package/src/strategies/move-room.ts +15 -15
  165. package/src/strategies/new-events-backfill.ts +98 -98
  166. package/src/strategies/paradise-fish.knowledge.md +20 -20
  167. package/src/strategies/paradise-fish.ts +25 -25
  168. package/src/strategies/pathfind/distance-field.ts +150 -150
  169. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  170. package/src/strategies/pathfind/escape-planner.ts +348 -348
  171. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  172. package/src/strategies/patrol.ts +11 -11
  173. package/src/strategies/player-targets.ts +13 -13
  174. package/src/strategies/report-patrol.ts +11 -11
  175. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  176. package/src/strategies/shrimp-memory.ts +25 -25
  177. package/src/strategies/social-task.test.ts +28 -28
  178. package/src/strategies/social-task.ts +49 -49
  179. package/src/strategies/spawn.ts +82 -71
  180. package/src/strategies/speech-module.ts +123 -123
  181. package/src/strategies/strategy-loop.ts +763 -757
  182. package/src/strategies/task-kill-report.ts +17 -17
  183. package/src/strategies/task-only.ts +11 -11
  184. package/src/strategies/task-report.ts +22 -22
  185. package/src/strategies/types.ts +96 -96
  186. package/src/strategies/warrior-memory.knowledge.md +20 -20
  187. package/src/strategies/warrior-memory.ts +16 -16
  188. package/src/runtime/daemon.ts +0 -100
  189. package/src/runtime/opening-mover.ts +0 -303
@@ -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
+ }
@@ -1,75 +1,75 @@
1
- // The hub nudge used to live only in SKILL.md, fired by the agent's own
2
- // judgement at the close of a post-game debrief. By debrief time the agent had
3
- // often read SKILL.md much earlier and the reminder could get dropped. Instead
4
- // the CLI emits it at the firing moment, with account-history gating here.
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
-
11
- export const HUB_URL = 'https://myclaw.163.com/hub';
12
-
13
- /**
14
- * True when this account has only ever run built-in default strategies: no
15
- * hub-installed strategy and no user strategy file in `<workspace>/strategies`.
16
- */
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;
36
- }
37
-
38
- /**
39
- * Agent-facing hub nudge for post-game debriefs / quit messages. The optional
40
- * games-played count suppresses the nudge after the first stretch of games.
41
- */
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
- }
1
+ // The hub nudge used to live only in SKILL.md, fired by the agent's own
2
+ // judgement at the close of a post-game debrief. By debrief time the agent had
3
+ // often read SKILL.md much earlier and the reminder could get dropped. Instead
4
+ // the CLI emits it at the firing moment, with account-history gating here.
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
+
11
+ export const HUB_URL = 'https://myclaw.163.com/hub';
12
+
13
+ /**
14
+ * True when this account has only ever run built-in default strategies: no
15
+ * hub-installed strategy and no user strategy file in `<workspace>/strategies`.
16
+ */
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;
36
+ }
37
+
38
+ /**
39
+ * Agent-facing hub nudge for post-game debriefs / quit messages. The optional
40
+ * games-played count suppresses the nudge after the first stretch of games.
41
+ */
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
+ }