@myclaw163/clawclaw-cli 0.6.66 → 0.6.67

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 (199) hide show
  1. package/README.md +427 -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/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +245 -245
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +244 -245
  14. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  15. package/skills/clawclaw/references/COMMANDS.md +148 -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 +43 -43
  19. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  20. package/skills/clawclaw/references/STREAM.md +91 -92
  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 +109 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/do.test.ts +73 -73
  27. package/src/commands/do.ts +126 -126
  28. package/src/commands/events.test.ts +71 -71
  29. package/src/commands/events.ts +155 -155
  30. package/src/commands/game-map.test.ts +28 -28
  31. package/src/commands/game-start-plan.test.ts +84 -84
  32. package/src/commands/game.ts +1027 -1027
  33. package/src/commands/history-player.test.ts +102 -102
  34. package/src/commands/history.ts +573 -573
  35. package/src/commands/hub.test.ts +96 -96
  36. package/src/commands/hub.ts +234 -234
  37. package/src/commands/knowledge.test.ts +19 -19
  38. package/src/commands/knowledge.ts +168 -168
  39. package/src/commands/load.test.ts +51 -51
  40. package/src/commands/load.ts +13 -13
  41. package/src/commands/meeting-history.test.ts +106 -106
  42. package/src/commands/memory.ts +40 -40
  43. package/src/commands/peek.ts +45 -45
  44. package/src/commands/persona.ts +57 -57
  45. package/src/commands/setup/codex.ts +266 -248
  46. package/src/commands/skill.ts +128 -128
  47. package/src/commands/state.ts +46 -46
  48. package/src/commands/strategy.test.ts +135 -135
  49. package/src/commands/strategy.ts +180 -180
  50. package/src/commands/tts.ts +128 -128
  51. package/src/commands/upgrade.test.ts +82 -82
  52. package/src/commands/upgrade.ts +148 -148
  53. package/src/commands/watch.test.ts +966 -966
  54. package/src/commands/watch.ts +659 -659
  55. package/src/lib/auth.test.ts +59 -59
  56. package/src/lib/auth.ts +186 -186
  57. package/src/lib/command-meta.ts +37 -37
  58. package/src/lib/game-client.ts +391 -391
  59. package/src/lib/http-keepalive.ts +15 -15
  60. package/src/lib/http-transport.test.ts +42 -42
  61. package/src/lib/http-transport.ts +113 -113
  62. package/src/lib/hub-client.test.ts +56 -56
  63. package/src/lib/hub-client.ts +88 -88
  64. package/src/lib/hub-install.test.ts +98 -98
  65. package/src/lib/hub-install.ts +121 -121
  66. package/src/lib/hub-reminder.ts +75 -75
  67. package/src/lib/hub-unzip.test.ts +69 -69
  68. package/src/lib/hub-unzip.ts +62 -62
  69. package/src/lib/init-command.test.ts +75 -75
  70. package/src/lib/init-command.ts +120 -120
  71. package/src/lib/knowledge-store.test.ts +180 -180
  72. package/src/lib/knowledge-store.ts +374 -374
  73. package/src/lib/load-context.test.ts +52 -52
  74. package/src/lib/load-context.ts +52 -52
  75. package/src/lib/match-state.test.ts +134 -134
  76. package/src/lib/match-state.ts +94 -94
  77. package/src/lib/netease-tts.ts +83 -83
  78. package/src/lib/normalize.ts +42 -42
  79. package/src/lib/persona.test.ts +41 -41
  80. package/src/lib/persona.ts +72 -72
  81. package/src/lib/server-registry.ts +152 -152
  82. package/src/lib/skill-version.test.ts +48 -48
  83. package/src/lib/skill-version.ts +19 -19
  84. package/src/lib/strategy-export.test.ts +232 -232
  85. package/src/lib/strategy-export.ts +242 -242
  86. package/src/lib/tts-keys.ts +7 -7
  87. package/src/lib/tts-speech.test.ts +63 -63
  88. package/src/lib/tts-speech.ts +76 -76
  89. package/src/lib/workspace-argv.test.ts +49 -49
  90. package/src/lib/workspace-argv.ts +44 -44
  91. package/src/perception/player-history-store.test.ts +87 -87
  92. package/src/perception/player-history-store.ts +194 -194
  93. package/src/pipeline/event-format.test.ts +135 -135
  94. package/src/pipeline/event-format.ts +376 -376
  95. package/src/pipeline/event-hints.ts +173 -173
  96. package/src/pipeline/event-store.test.ts +28 -28
  97. package/src/pipeline/event-store.ts +193 -193
  98. package/src/pipeline/pipeline.ts +35 -35
  99. package/src/runtime/auto-upgrade.test.ts +66 -66
  100. package/src/runtime/auto-upgrade.ts +31 -31
  101. package/src/runtime/event-daemon.test.ts +107 -107
  102. package/src/runtime/event-daemon.ts +409 -409
  103. package/src/runtime/owner-control.ts +150 -150
  104. package/src/runtime/raw-ws-log.test.ts +33 -33
  105. package/src/runtime/raw-ws-log.ts +32 -32
  106. package/src/runtime/runtime-logger.ts +107 -107
  107. package/src/runtime/ws-client.test.ts +104 -104
  108. package/src/runtime/ws-client.ts +272 -272
  109. package/src/sdk/action.ts +166 -166
  110. package/src/sdk/index.ts +111 -111
  111. package/src/sdk/types.ts +159 -159
  112. package/src/strategies/avoid-lone.ts +11 -11
  113. package/src/strategies/avoid-players.knowledge.md +20 -20
  114. package/src/strategies/avoid-players.ts +15 -15
  115. package/src/strategies/corpse-patrol.ts +22 -22
  116. package/src/strategies/crab-sabotage.ts +21 -21
  117. package/src/strategies/custom-module.test.ts +269 -269
  118. package/src/strategies/find-player.ts +16 -16
  119. package/src/strategies/game-utils.test.ts +190 -190
  120. package/src/strategies/game-utils.ts +782 -782
  121. package/src/strategies/goals/anchor-linger.ts +77 -77
  122. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  123. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  124. package/src/strategies/goals/avoid-players-top.ts +121 -121
  125. package/src/strategies/goals/conversation-goal.ts +51 -51
  126. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  127. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  128. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  129. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  130. package/src/strategies/goals/find-player-top.ts +93 -93
  131. package/src/strategies/goals/flee-players-goal.ts +53 -53
  132. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  133. package/src/strategies/goals/goal-manager.ts +41 -41
  134. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  135. package/src/strategies/goals/goal.ts +28 -28
  136. package/src/strategies/goals/hide-top.ts +197 -197
  137. package/src/strategies/goals/keep-away-goal.ts +217 -217
  138. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  139. package/src/strategies/goals/kill-lone-top.ts +160 -160
  140. package/src/strategies/goals/kill-target-goal.ts +59 -59
  141. package/src/strategies/goals/kill-target-top.ts +109 -109
  142. package/src/strategies/goals/leaf-goal.ts +25 -25
  143. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  144. package/src/strategies/goals/lone-kill-core.ts +82 -82
  145. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  146. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  147. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  148. package/src/strategies/goals/move-room-goal.ts +60 -60
  149. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  150. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  151. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  152. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  153. package/src/strategies/goals/patrol-top.ts +57 -57
  154. package/src/strategies/goals/report-patrol-top.ts +80 -80
  155. package/src/strategies/goals/safe-task-goal.ts +102 -102
  156. package/src/strategies/goals/social-task-top.ts +161 -161
  157. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  158. package/src/strategies/goals/task-only-top.ts +57 -57
  159. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  160. package/src/strategies/goals/task-report-top.ts +57 -57
  161. package/src/strategies/goals/wander-task-goal.ts +33 -33
  162. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  163. package/src/strategies/goals/warrior-shrimp-top.ts +500 -500
  164. package/src/strategies/greeting.ts +53 -53
  165. package/src/strategies/hide-spots.ts +123 -123
  166. package/src/strategies/hide.ts +23 -23
  167. package/src/strategies/kill-frenzy.ts +12 -12
  168. package/src/strategies/kill-lone.knowledge.md +20 -20
  169. package/src/strategies/kill-lone.ts +13 -13
  170. package/src/strategies/kill-target.ts +18 -18
  171. package/src/strategies/loader.test.ts +678 -678
  172. package/src/strategies/loader.ts +172 -172
  173. package/src/strategies/lone-kill-task.ts +21 -21
  174. package/src/strategies/meeting-gate.test.ts +59 -59
  175. package/src/strategies/meeting-gate.ts +23 -23
  176. package/src/strategies/move-room.ts +15 -15
  177. package/src/strategies/new-events-backfill.ts +98 -98
  178. package/src/strategies/paradise-fish.knowledge.md +20 -20
  179. package/src/strategies/paradise-fish.ts +25 -25
  180. package/src/strategies/pathfind/distance-field.ts +150 -150
  181. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  182. package/src/strategies/pathfind/escape-planner.ts +355 -355
  183. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  184. package/src/strategies/patrol.ts +11 -11
  185. package/src/strategies/player-targets.ts +13 -13
  186. package/src/strategies/report-patrol.ts +11 -11
  187. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  188. package/src/strategies/shrimp-memory.ts +25 -25
  189. package/src/strategies/social-task.test.ts +28 -28
  190. package/src/strategies/social-task.ts +49 -49
  191. package/src/strategies/spawn.ts +82 -82
  192. package/src/strategies/speech-module.ts +123 -123
  193. package/src/strategies/strategy-loop.ts +771 -771
  194. package/src/strategies/task-kill-report.ts +17 -17
  195. package/src/strategies/task-only.ts +11 -11
  196. package/src/strategies/task-report.ts +22 -22
  197. package/src/strategies/types.ts +102 -102
  198. package/src/strategies/warrior-memory.knowledge.md +22 -22
  199. package/src/strategies/warrior-memory.ts +16 -16
@@ -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
+ }