@myclaw163/clawclaw-cli 0.6.71 → 0.6.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/README.md +377 -427
  2. package/bin/clawclaw-cli.mjs +3 -3
  3. package/package.json +48 -48
  4. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  5. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  6. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  7. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  8. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  9. package/scripts/check-skill-command-surface.mjs +116 -0
  10. package/scripts/find-hide-spots.py +157 -157
  11. package/scripts/postinstall.mjs +20 -20
  12. package/scripts/sync-bundled-skill.mjs +245 -245
  13. package/scripts/sync-bundled-skill.test.mjs +152 -152
  14. package/skills/clawclaw/SKILL.md +246 -244
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  16. package/skills/clawclaw/references/COMMANDS.md +155 -148
  17. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  18. package/skills/clawclaw/references/HUB.md +48 -48
  19. package/skills/clawclaw/references/KNOWLEDGE.md +42 -45
  20. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  21. package/skills/clawclaw/references/STREAM.md +93 -91
  22. package/skills/clawclaw/references/TACTICS.md +65 -65
  23. package/src/assets/clawclaw-ascii-map.txt +40 -40
  24. package/src/cli.ts +110 -110
  25. package/src/commands/_schema.ts +124 -109
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/do.test.ts +84 -73
  28. package/src/commands/do.ts +130 -126
  29. package/src/commands/events.test.ts +71 -71
  30. package/src/commands/events.ts +221 -155
  31. package/src/commands/game-map.test.ts +28 -28
  32. package/src/commands/game-start-plan.test.ts +84 -84
  33. package/src/commands/game.ts +1113 -1047
  34. package/src/commands/history-player.test.ts +102 -102
  35. package/src/commands/history.ts +573 -573
  36. package/src/commands/hub.test.ts +96 -96
  37. package/src/commands/hub.ts +234 -234
  38. package/src/commands/knowledge.test.ts +13 -13
  39. package/src/commands/knowledge.ts +139 -139
  40. package/src/commands/load.test.ts +51 -51
  41. package/src/commands/load.ts +13 -13
  42. package/src/commands/meeting-history.test.ts +106 -106
  43. package/src/commands/memory.ts +40 -40
  44. package/src/commands/peek.ts +45 -45
  45. package/src/commands/persona.ts +57 -57
  46. package/src/commands/setup/codex.ts +266 -266
  47. package/src/commands/skill.ts +128 -128
  48. package/src/commands/state.ts +46 -46
  49. package/src/commands/strategy.test.ts +145 -145
  50. package/src/commands/strategy.ts +181 -181
  51. package/src/commands/tts.ts +128 -128
  52. package/src/commands/upgrade.test.ts +82 -82
  53. package/src/commands/upgrade.ts +148 -148
  54. package/src/commands/watch.test.ts +999 -977
  55. package/src/commands/watch.ts +660 -658
  56. package/src/lib/auth.test.ts +74 -74
  57. package/src/lib/auth.ts +186 -186
  58. package/src/lib/command-meta.ts +37 -37
  59. package/src/lib/game-client.ts +403 -391
  60. package/src/lib/game-context.ts +92 -0
  61. package/src/lib/http-keepalive.ts +15 -15
  62. package/src/lib/http-transport.test.ts +42 -42
  63. package/src/lib/http-transport.ts +113 -113
  64. package/src/lib/hub-client.test.ts +56 -56
  65. package/src/lib/hub-client.ts +88 -88
  66. package/src/lib/hub-install.test.ts +98 -98
  67. package/src/lib/hub-install.ts +121 -121
  68. package/src/lib/hub-reminder.ts +75 -75
  69. package/src/lib/hub-unzip.test.ts +69 -69
  70. package/src/lib/hub-unzip.ts +62 -62
  71. package/src/lib/init-command.test.ts +75 -75
  72. package/src/lib/init-command.ts +120 -120
  73. package/src/lib/knowledge-store.test.ts +170 -170
  74. package/src/lib/knowledge-store.ts +369 -369
  75. package/src/lib/load-context.test.ts +52 -52
  76. package/src/lib/load-context.ts +52 -52
  77. package/src/lib/match-state.test.ts +134 -134
  78. package/src/lib/match-state.ts +94 -94
  79. package/src/lib/netease-tts.ts +83 -83
  80. package/src/lib/normalize.ts +42 -42
  81. package/src/lib/persona.test.ts +41 -41
  82. package/src/lib/persona.ts +72 -72
  83. package/src/lib/server-registry.ts +152 -152
  84. package/src/lib/skill-version.test.ts +48 -48
  85. package/src/lib/skill-version.ts +19 -19
  86. package/src/lib/strategy-export.test.ts +232 -232
  87. package/src/lib/strategy-export.ts +242 -242
  88. package/src/lib/tts-keys.ts +7 -7
  89. package/src/lib/tts-speech.test.ts +63 -63
  90. package/src/lib/tts-speech.ts +76 -76
  91. package/src/lib/workspace-argv.test.ts +49 -49
  92. package/src/lib/workspace-argv.ts +44 -44
  93. package/src/perception/player-history-store.test.ts +87 -87
  94. package/src/perception/player-history-store.ts +194 -194
  95. package/src/pipeline/event-format.test.ts +243 -215
  96. package/src/pipeline/event-format.ts +501 -485
  97. package/src/pipeline/event-hints.ts +195 -190
  98. package/src/pipeline/event-store.test.ts +28 -28
  99. package/src/pipeline/event-store.ts +193 -193
  100. package/src/pipeline/pipeline.ts +35 -35
  101. package/src/pipeline/player-projection.test.ts +119 -0
  102. package/src/pipeline/player-projection.ts +380 -0
  103. package/src/runtime/auto-upgrade.test.ts +66 -66
  104. package/src/runtime/auto-upgrade.ts +31 -31
  105. package/src/runtime/event-daemon.test.ts +209 -141
  106. package/src/runtime/event-daemon.ts +519 -457
  107. package/src/runtime/owner-control.ts +150 -150
  108. package/src/runtime/raw-ws-log.test.ts +33 -33
  109. package/src/runtime/raw-ws-log.ts +32 -32
  110. package/src/runtime/runtime-logger.ts +107 -107
  111. package/src/runtime/ws-client.test.ts +125 -104
  112. package/src/runtime/ws-client.ts +287 -272
  113. package/src/sdk/action.ts +166 -166
  114. package/src/sdk/index.ts +110 -110
  115. package/src/sdk/types.ts +161 -161
  116. package/src/strategies/avoid-lone.ts +12 -12
  117. package/src/strategies/avoid-players.knowledge.md +19 -19
  118. package/src/strategies/avoid-players.ts +16 -16
  119. package/src/strategies/corpse-patrol.ts +23 -23
  120. package/src/strategies/crab-sabotage.ts +22 -22
  121. package/src/strategies/custom-module.test.ts +270 -270
  122. package/src/strategies/find-player.ts +17 -17
  123. package/src/strategies/game-utils.test.ts +242 -242
  124. package/src/strategies/game-utils.ts +846 -846
  125. package/src/strategies/goals/anchor-linger.ts +77 -77
  126. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  127. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  128. package/src/strategies/goals/avoid-players-top.ts +121 -121
  129. package/src/strategies/goals/conversation-goal.ts +51 -51
  130. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  131. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  132. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  133. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  134. package/src/strategies/goals/find-player-top.ts +93 -93
  135. package/src/strategies/goals/flee-players-goal.ts +53 -53
  136. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  137. package/src/strategies/goals/goal-manager.ts +41 -41
  138. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  139. package/src/strategies/goals/goal.ts +28 -28
  140. package/src/strategies/goals/hide-top.ts +197 -197
  141. package/src/strategies/goals/keep-away-goal.ts +221 -221
  142. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  143. package/src/strategies/goals/kill-lone-top.ts +160 -160
  144. package/src/strategies/goals/kill-target-goal.ts +59 -59
  145. package/src/strategies/goals/kill-target-top.ts +109 -109
  146. package/src/strategies/goals/leaf-goal.ts +27 -27
  147. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  148. package/src/strategies/goals/lone-kill-core.ts +82 -82
  149. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  150. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  151. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  152. package/src/strategies/goals/move-room-goal.ts +60 -60
  153. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  154. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  155. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  156. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  157. package/src/strategies/goals/patrol-top.ts +57 -57
  158. package/src/strategies/goals/report-patrol-top.ts +80 -80
  159. package/src/strategies/goals/safe-task-goal.ts +102 -102
  160. package/src/strategies/goals/social-task-top.ts +161 -161
  161. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  162. package/src/strategies/goals/task-only-top.ts +57 -57
  163. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  164. package/src/strategies/goals/task-report-top.ts +57 -57
  165. package/src/strategies/goals/wander-task-goal.ts +33 -33
  166. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  167. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  168. package/src/strategies/greeting.ts +53 -53
  169. package/src/strategies/hide-spots.ts +59 -59
  170. package/src/strategies/hide.ts +24 -24
  171. package/src/strategies/kill-frenzy.ts +13 -13
  172. package/src/strategies/kill-lone.knowledge.md +17 -17
  173. package/src/strategies/kill-lone.ts +14 -14
  174. package/src/strategies/kill-target.ts +19 -19
  175. package/src/strategies/loader.test.ts +678 -678
  176. package/src/strategies/loader.ts +179 -179
  177. package/src/strategies/lone-kill-task.ts +22 -22
  178. package/src/strategies/meeting-gate.test.ts +59 -59
  179. package/src/strategies/meeting-gate.ts +23 -23
  180. package/src/strategies/move-room.ts +16 -16
  181. package/src/strategies/new-events-backfill.ts +98 -98
  182. package/src/strategies/off-route-points.ts +105 -105
  183. package/src/strategies/paradise-fish.knowledge.md +19 -19
  184. package/src/strategies/paradise-fish.ts +26 -26
  185. package/src/strategies/pathfind/distance-field.ts +150 -150
  186. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  187. package/src/strategies/pathfind/escape-planner.ts +355 -355
  188. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  189. package/src/strategies/patrol.ts +12 -12
  190. package/src/strategies/player-targets.ts +13 -13
  191. package/src/strategies/report-patrol.ts +12 -12
  192. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  193. package/src/strategies/shrimp-memory.ts +26 -26
  194. package/src/strategies/social-task.test.ts +28 -28
  195. package/src/strategies/social-task.ts +50 -50
  196. package/src/strategies/spawn.ts +82 -82
  197. package/src/strategies/speech-module.ts +123 -123
  198. package/src/strategies/strategy-loop.test.ts +15 -0
  199. package/src/strategies/strategy-loop.ts +776 -771
  200. package/src/strategies/task-kill-report.ts +18 -18
  201. package/src/strategies/task-only.ts +12 -12
  202. package/src/strategies/task-report.ts +23 -23
  203. package/src/strategies/types.ts +109 -109
  204. package/src/strategies/warrior-memory.knowledge.md +21 -21
  205. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,82 +1,82 @@
1
- import { mkdirSync, mkdtempSync, writeFileSync } from 'fs';
2
- import { tmpdir } from 'os';
3
- import { join, resolve } from 'path';
4
- import { describe, expect, it } from 'vitest';
5
- import { installLatestFromNpm, runUpgrade, syncSkillFromInstalledPackage } from './upgrade.js';
6
-
7
- describe('runUpgrade', () => {
8
- it('installs and returns the installed cli version without syncing skill again', () => {
9
- let installed = false;
10
- const result = runUpgrade({
11
- installLatest: () => { installed = true; },
12
- readInstalledCliVersion: () => '0.4.7',
13
- });
14
- expect(installed).toBe(true);
15
- expect(result).toEqual({ version: '0.4.7' });
16
- });
17
-
18
- it('reports error when npm install fails', () => {
19
- const result = runUpgrade({
20
- installLatest: () => { throw new Error('EACCES'); },
21
- readInstalledCliVersion: () => '0.3.4',
22
- });
23
- expect(result.version).toBeUndefined();
24
- expect(result.error).toMatch(/npm install failed/);
25
- });
26
-
27
- it('installs latest from npm without registry flag', () => {
28
- const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
29
- installLatestFromNpm('clawclaw-cli', (file, args, options) => {
30
- calls.push({ file, args, options });
31
- });
32
-
33
- expect(calls).toHaveLength(1);
34
- if (process.platform === 'win32') {
35
- expect(calls[0].file).toBe('cmd.exe');
36
- expect(calls[0].args).toEqual([
37
- '/d',
38
- '/c',
39
- 'npm.cmd install -g clawclaw-cli@latest --foreground-scripts --loglevel=error',
40
- ]);
41
- } else {
42
- expect(calls[0].args).toEqual([
43
- 'install',
44
- '-g',
45
- 'clawclaw-cli@latest',
46
- '--foreground-scripts',
47
- '--loglevel=error',
48
- ]);
49
- }
50
- expect(calls[0].options.stdio).toEqual(['ignore', 'ignore', 'inherit']);
51
- expect(calls[0].options.shell).toBe(false);
52
- });
53
-
54
- it('runs bundled skill sync script for explicit skill update', () => {
55
- const root = mkdtempSync(join(tmpdir(), 'upgrade-skill-'));
56
- const installDir = join(root, 'clawclaw-cli');
57
- const scriptPath = join(installDir, 'scripts', 'sync-bundled-skill.mjs');
58
- mkdirSync(join(installDir, 'scripts'), { recursive: true });
59
- writeFileSync(scriptPath, '');
60
-
61
- const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
62
- syncSkillFromInstalledPackage('clawclaw-cli', (file, args, options) => {
63
- calls.push({ file, args, options });
64
- if (args[0] === 'root' || args.at(-1)?.includes('root -g')) return root;
65
- return '';
66
- });
67
-
68
- expect(calls).toHaveLength(2);
69
- expect(calls[1].file).toBe(process.execPath);
70
- expect(calls[1].args).toEqual([resolve(scriptPath)]);
71
- expect(calls[1].options.stdio).toBe('inherit');
72
- });
73
-
74
- it('reports error when reading installed version fails', () => {
75
- const result = runUpgrade({
76
- installLatest: () => {},
77
- readInstalledCliVersion: () => { throw new Error('missing package'); },
78
- });
79
- expect(result.version).toBeUndefined();
80
- expect(result.error).toMatch(/read installed cli version failed/);
81
- });
82
- });
1
+ import { mkdirSync, mkdtempSync, writeFileSync } from 'fs';
2
+ import { tmpdir } from 'os';
3
+ import { join, resolve } from 'path';
4
+ import { describe, expect, it } from 'vitest';
5
+ import { installLatestFromNpm, runUpgrade, syncSkillFromInstalledPackage } from './upgrade.js';
6
+
7
+ describe('runUpgrade', () => {
8
+ it('installs and returns the installed cli version without syncing skill again', () => {
9
+ let installed = false;
10
+ const result = runUpgrade({
11
+ installLatest: () => { installed = true; },
12
+ readInstalledCliVersion: () => '0.4.7',
13
+ });
14
+ expect(installed).toBe(true);
15
+ expect(result).toEqual({ version: '0.4.7' });
16
+ });
17
+
18
+ it('reports error when npm install fails', () => {
19
+ const result = runUpgrade({
20
+ installLatest: () => { throw new Error('EACCES'); },
21
+ readInstalledCliVersion: () => '0.3.4',
22
+ });
23
+ expect(result.version).toBeUndefined();
24
+ expect(result.error).toMatch(/npm install failed/);
25
+ });
26
+
27
+ it('installs latest from npm without registry flag', () => {
28
+ const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
29
+ installLatestFromNpm('clawclaw-cli', (file, args, options) => {
30
+ calls.push({ file, args, options });
31
+ });
32
+
33
+ expect(calls).toHaveLength(1);
34
+ if (process.platform === 'win32') {
35
+ expect(calls[0].file).toBe('cmd.exe');
36
+ expect(calls[0].args).toEqual([
37
+ '/d',
38
+ '/c',
39
+ 'npm.cmd install -g clawclaw-cli@latest --foreground-scripts --loglevel=error',
40
+ ]);
41
+ } else {
42
+ expect(calls[0].args).toEqual([
43
+ 'install',
44
+ '-g',
45
+ 'clawclaw-cli@latest',
46
+ '--foreground-scripts',
47
+ '--loglevel=error',
48
+ ]);
49
+ }
50
+ expect(calls[0].options.stdio).toEqual(['ignore', 'ignore', 'inherit']);
51
+ expect(calls[0].options.shell).toBe(false);
52
+ });
53
+
54
+ it('runs bundled skill sync script for explicit skill update', () => {
55
+ const root = mkdtempSync(join(tmpdir(), 'upgrade-skill-'));
56
+ const installDir = join(root, 'clawclaw-cli');
57
+ const scriptPath = join(installDir, 'scripts', 'sync-bundled-skill.mjs');
58
+ mkdirSync(join(installDir, 'scripts'), { recursive: true });
59
+ writeFileSync(scriptPath, '');
60
+
61
+ const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
62
+ syncSkillFromInstalledPackage('clawclaw-cli', (file, args, options) => {
63
+ calls.push({ file, args, options });
64
+ if (args[0] === 'root' || args.at(-1)?.includes('root -g')) return root;
65
+ return '';
66
+ });
67
+
68
+ expect(calls).toHaveLength(2);
69
+ expect(calls[1].file).toBe(process.execPath);
70
+ expect(calls[1].args).toEqual([resolve(scriptPath)]);
71
+ expect(calls[1].options.stdio).toBe('inherit');
72
+ });
73
+
74
+ it('reports error when reading installed version fails', () => {
75
+ const result = runUpgrade({
76
+ installLatest: () => {},
77
+ readInstalledCliVersion: () => { throw new Error('missing package'); },
78
+ });
79
+ expect(result.version).toBeUndefined();
80
+ expect(result.error).toMatch(/read installed cli version failed/);
81
+ });
82
+ });
@@ -1,148 +1,148 @@
1
- import { Command } from 'commander';
2
- import { execFileSync } from 'child_process';
3
- import { existsSync, readFileSync } from 'fs';
4
- import { dirname, resolve } from 'path';
5
- import { fileURLToPath } from 'url';
6
-
7
- const NPM_INSTALL_TIMEOUT_MS = 30_000;
8
-
9
- export interface UpgradeDeps {
10
- installLatest: () => void;
11
- readInstalledCliVersion: () => string;
12
- }
13
-
14
- export interface UpgradeResult {
15
- version?: string;
16
- error?: string;
17
- }
18
-
19
- export function runUpgrade(deps: UpgradeDeps): UpgradeResult {
20
- try {
21
- deps.installLatest();
22
- } catch (err: any) {
23
- return { error: `npm install failed: ${err?.message ?? String(err)}` };
24
- }
25
-
26
- let version: string;
27
- try {
28
- version = deps.readInstalledCliVersion();
29
- } catch (err: any) {
30
- return { error: `read installed cli version failed: ${err?.message ?? String(err)}` };
31
- }
32
-
33
- return { version };
34
- }
35
-
36
- function npmBin(): string {
37
- return process.platform === 'win32' ? 'npm.cmd' : 'npm';
38
- }
39
-
40
- type ExecFileSyncLike = (file: string, args: string[], options: Record<string, unknown>) => unknown;
41
-
42
- function escapeCmdArg(arg: string): string {
43
- if (/\s/.test(arg)) throw new Error(`npm argument contains whitespace: ${arg}`);
44
- return arg.replace(/[()^!%<>&|]/g, '^$&');
45
- }
46
-
47
- function execNpmSync(args: string[], options: Record<string, unknown>, execFile: ExecFileSyncLike = execFileSync): unknown {
48
- if (process.platform !== 'win32') {
49
- return execFile(npmBin(), args, { ...options, shell: false });
50
- }
51
- const command = [npmBin(), ...args].map(escapeCmdArg).join(' ');
52
- return execFile('cmd.exe', ['/d', '/c', command], { ...options, shell: false });
53
- }
54
-
55
- function currentPackageName(): string {
56
- const __filename = fileURLToPath(import.meta.url);
57
- const pkgPath = resolve(dirname(__filename), '..', '..', 'package.json');
58
- const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
59
- const name = String(pkg?.name ?? '').trim();
60
- if (!name) throw new Error(`package name not found: ${pkgPath}`);
61
- return name;
62
- }
63
-
64
- export function installLatestFromNpm(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
65
- execNpmSync(
66
- [
67
- 'install',
68
- '-g',
69
- `${packageName}@latest`,
70
- '--foreground-scripts',
71
- '--loglevel=error',
72
- ],
73
- { timeout: NPM_INSTALL_TIMEOUT_MS, windowsHide: true, stdio: ['ignore', 'ignore', 'inherit'] },
74
- execFile,
75
- );
76
- }
77
-
78
- function readInstalledCliVersionFromNpm(packageName: string): string {
79
- const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true })).trim();
80
- const pkgPath = resolve(npmRoot, packageName, 'package.json');
81
- if (!existsSync(pkgPath)) throw new Error(`installed package not found: ${pkgPath}`);
82
- const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
83
- if (!pkg?.version) throw new Error(`installed package has no version: ${pkgPath}`);
84
- return pkg.version;
85
- }
86
-
87
- export function syncSkillFromInstalledPackage(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
88
- const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true }, execFile)).trim();
89
- const installDir = resolve(npmRoot, packageName);
90
- const syncScript = resolve(installDir, 'scripts', 'sync-bundled-skill.mjs');
91
- if (!existsSync(syncScript)) throw new Error(`bundled skill sync script not found: ${syncScript}`);
92
- execFile(
93
- process.execPath,
94
- [syncScript],
95
- {
96
- cwd: installDir,
97
- timeout: 60_000,
98
- windowsHide: true,
99
- stdio: 'inherit',
100
- },
101
- );
102
- }
103
-
104
- export function runDefaultUpgrade(): UpgradeResult {
105
- const packageName = currentPackageName();
106
- return runUpgrade({
107
- installLatest: () => installLatestFromNpm(packageName),
108
- readInstalledCliVersion: () => readInstalledCliVersionFromNpm(packageName),
109
- });
110
- }
111
-
112
- export function createUpgradeCommand(): Command {
113
- const cmd = new Command('upgrade')
114
- .description('Install latest @myclaw163/clawclaw-cli from npm.')
115
- .action(async () => {
116
- const result = runDefaultUpgrade();
117
- if (result.error) {
118
- console.error(result.error);
119
- process.exit(1);
120
- }
121
- console.log(result.version);
122
-
123
- // After upgrade, check if any exported strategies are now stale.
124
- try {
125
- const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
126
- const staleIds = detectStaleOfficialStrategies();
127
- if (staleIds.length > 0) {
128
- const ids = staleIds.join(', ');
129
- console.error(`[提示] 官方策略有更新 (${ids}),运行 \`ccl strategy --export <id> --force\` 重新导出`);
130
- }
131
- } catch {
132
- // Silently ignore detection failures
133
- }
134
- });
135
-
136
- cmd.command('skill')
137
- .description('Sync the bundled clawclaw skill from the installed CLI package.')
138
- .action(() => {
139
- try {
140
- syncSkillFromInstalledPackage(currentPackageName());
141
- } catch (err: any) {
142
- console.error(err?.message ?? String(err));
143
- process.exit(1);
144
- }
145
- });
146
-
147
- return cmd;
148
- }
1
+ import { Command } from 'commander';
2
+ import { execFileSync } from 'child_process';
3
+ import { existsSync, readFileSync } from 'fs';
4
+ import { dirname, resolve } from 'path';
5
+ import { fileURLToPath } from 'url';
6
+
7
+ const NPM_INSTALL_TIMEOUT_MS = 30_000;
8
+
9
+ export interface UpgradeDeps {
10
+ installLatest: () => void;
11
+ readInstalledCliVersion: () => string;
12
+ }
13
+
14
+ export interface UpgradeResult {
15
+ version?: string;
16
+ error?: string;
17
+ }
18
+
19
+ export function runUpgrade(deps: UpgradeDeps): UpgradeResult {
20
+ try {
21
+ deps.installLatest();
22
+ } catch (err: any) {
23
+ return { error: `npm install failed: ${err?.message ?? String(err)}` };
24
+ }
25
+
26
+ let version: string;
27
+ try {
28
+ version = deps.readInstalledCliVersion();
29
+ } catch (err: any) {
30
+ return { error: `read installed cli version failed: ${err?.message ?? String(err)}` };
31
+ }
32
+
33
+ return { version };
34
+ }
35
+
36
+ function npmBin(): string {
37
+ return process.platform === 'win32' ? 'npm.cmd' : 'npm';
38
+ }
39
+
40
+ type ExecFileSyncLike = (file: string, args: string[], options: Record<string, unknown>) => unknown;
41
+
42
+ function escapeCmdArg(arg: string): string {
43
+ if (/\s/.test(arg)) throw new Error(`npm argument contains whitespace: ${arg}`);
44
+ return arg.replace(/[()^!%<>&|]/g, '^$&');
45
+ }
46
+
47
+ function execNpmSync(args: string[], options: Record<string, unknown>, execFile: ExecFileSyncLike = execFileSync): unknown {
48
+ if (process.platform !== 'win32') {
49
+ return execFile(npmBin(), args, { ...options, shell: false });
50
+ }
51
+ const command = [npmBin(), ...args].map(escapeCmdArg).join(' ');
52
+ return execFile('cmd.exe', ['/d', '/c', command], { ...options, shell: false });
53
+ }
54
+
55
+ function currentPackageName(): string {
56
+ const __filename = fileURLToPath(import.meta.url);
57
+ const pkgPath = resolve(dirname(__filename), '..', '..', 'package.json');
58
+ const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
59
+ const name = String(pkg?.name ?? '').trim();
60
+ if (!name) throw new Error(`package name not found: ${pkgPath}`);
61
+ return name;
62
+ }
63
+
64
+ export function installLatestFromNpm(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
65
+ execNpmSync(
66
+ [
67
+ 'install',
68
+ '-g',
69
+ `${packageName}@latest`,
70
+ '--foreground-scripts',
71
+ '--loglevel=error',
72
+ ],
73
+ { timeout: NPM_INSTALL_TIMEOUT_MS, windowsHide: true, stdio: ['ignore', 'ignore', 'inherit'] },
74
+ execFile,
75
+ );
76
+ }
77
+
78
+ function readInstalledCliVersionFromNpm(packageName: string): string {
79
+ const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true })).trim();
80
+ const pkgPath = resolve(npmRoot, packageName, 'package.json');
81
+ if (!existsSync(pkgPath)) throw new Error(`installed package not found: ${pkgPath}`);
82
+ const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
83
+ if (!pkg?.version) throw new Error(`installed package has no version: ${pkgPath}`);
84
+ return pkg.version;
85
+ }
86
+
87
+ export function syncSkillFromInstalledPackage(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
88
+ const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true }, execFile)).trim();
89
+ const installDir = resolve(npmRoot, packageName);
90
+ const syncScript = resolve(installDir, 'scripts', 'sync-bundled-skill.mjs');
91
+ if (!existsSync(syncScript)) throw new Error(`bundled skill sync script not found: ${syncScript}`);
92
+ execFile(
93
+ process.execPath,
94
+ [syncScript],
95
+ {
96
+ cwd: installDir,
97
+ timeout: 60_000,
98
+ windowsHide: true,
99
+ stdio: 'inherit',
100
+ },
101
+ );
102
+ }
103
+
104
+ export function runDefaultUpgrade(): UpgradeResult {
105
+ const packageName = currentPackageName();
106
+ return runUpgrade({
107
+ installLatest: () => installLatestFromNpm(packageName),
108
+ readInstalledCliVersion: () => readInstalledCliVersionFromNpm(packageName),
109
+ });
110
+ }
111
+
112
+ export function createUpgradeCommand(): Command {
113
+ const cmd = new Command('upgrade')
114
+ .description('Install latest @myclaw163/clawclaw-cli from npm.')
115
+ .action(async () => {
116
+ const result = runDefaultUpgrade();
117
+ if (result.error) {
118
+ console.error(result.error);
119
+ process.exit(1);
120
+ }
121
+ console.log(result.version);
122
+
123
+ // After upgrade, check if any exported strategies are now stale.
124
+ try {
125
+ const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
126
+ const staleIds = detectStaleOfficialStrategies();
127
+ if (staleIds.length > 0) {
128
+ const ids = staleIds.join(', ');
129
+ console.error(`[提示] 官方策略有更新 (${ids}),运行 \`ccl strategy --export <id> --force\` 重新导出`);
130
+ }
131
+ } catch {
132
+ // Silently ignore detection failures
133
+ }
134
+ });
135
+
136
+ cmd.command('skill')
137
+ .description('Sync the bundled clawclaw skill from the installed CLI package.')
138
+ .action(() => {
139
+ try {
140
+ syncSkillFromInstalledPackage(currentPackageName());
141
+ } catch (err: any) {
142
+ console.error(err?.message ?? String(err));
143
+ process.exit(1);
144
+ }
145
+ });
146
+
147
+ return cmd;
148
+ }