@myclaw163/clawclaw-cli 0.6.76 → 0.6.77

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