@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,152 +1,152 @@
1
- // src/lib/server-registry.ts
2
- import { AuthStore } from './auth.js';
3
-
4
- export interface ServerAddresses {
5
- lobbyUrl: string;
6
- gameServerUrl: string | null;
7
- wsUrl: string | null;
8
- }
9
-
10
- export class ServerRegistry {
11
- private lobbyUrl: string;
12
- private _gameServerUrl: string | null;
13
- private _gatewayWsUrl: string | null;
14
- private agentName: string | undefined;
15
- /** True when gameServerUrl was pre-configured (e.g. from auth) — prevents
16
- * discoverGameServer() from clearing it during queue status polling. */
17
- private _urlPreconfigured: boolean;
18
-
19
- constructor(opts: { lobbyUrl: string; gameServerUrl?: string; agentName?: string }) {
20
- this.lobbyUrl = opts.lobbyUrl.replace(/\/$/, '');
21
- this._gatewayWsUrl = null;
22
- if (opts.gameServerUrl) {
23
- const raw = opts.gameServerUrl.replace(/\/$/, '');
24
- try {
25
- const u = new URL(raw);
26
- if (u.pathname && u.pathname !== '/') {
27
- // Gateway URL — restore _gatewayWsUrl so wsUrl path prefix is preserved
28
- this._gatewayWsUrl = raw;
29
- this._gameServerUrl = raw;
30
- } else {
31
- this._gameServerUrl = raw.replace(/^https:\/\//, 'http://');
32
- }
33
- } catch {
34
- this._gameServerUrl = raw.replace(/^https:\/\//, 'http://');
35
- }
36
- this._urlPreconfigured = true;
37
- } else {
38
- this._gameServerUrl = null;
39
- this._urlPreconfigured = false;
40
- }
41
- this.agentName = opts.agentName;
42
- }
43
-
44
- get addresses(): ServerAddresses {
45
- return {
46
- lobbyUrl: this.lobbyUrl,
47
- gameServerUrl: this._gameServerUrl,
48
- wsUrl: this.wsUrl,
49
- };
50
- }
51
-
52
- get gameServerUrl(): string | null {
53
- return this._gameServerUrl;
54
- }
55
-
56
- /**
57
- * Determine the correct base URL for a given API path.
58
- *
59
- * Game Server routes: /api/v1/game/current, /api/v1/game/action, /api/v1/game/map, /api/v1/game/leave, /api/v1/game/role_info
60
- * Lobby routes: everything else (/api/v1/agents/*, /api/v1/queue/*, etc.)
61
- */
62
- baseUrlFor(path: string): string {
63
- if (
64
- path.startsWith('/api/v1/game/current') ||
65
- path.startsWith('/api/v1/game/action') ||
66
- path.startsWith('/api/v1/game/map') ||
67
- path.startsWith('/api/v1/game/leave') ||
68
- path.startsWith('/api/v1/game/role_info')
69
- ) {
70
- const base = this._gatewayWsUrl ?? this._gameServerUrl;
71
- if (!base) throw new Error('No game server allocated');
72
- return base;
73
- }
74
- return this.lobbyUrl;
75
- }
76
-
77
- /**
78
- * Extract game server address from a queue response and update gameServerUrl.
79
- * Prefers ws_url (Gateway route) over raw address:port.
80
- * Returns true if the address changed.
81
- */
82
- updateFromQueueResponse(data: any): boolean {
83
- if (!data || typeof data !== 'object') return false;
84
- const qs = data.data ?? data;
85
- if (qs.status && qs.status !== 'allocated') {
86
- // Never clear a pre-configured URL just because queue status changed —
87
- // the game may already be in progress. Only clear if the URL was
88
- // originally discovered via queue (not pre-set from auth).
89
- if (this._urlPreconfigured) return false;
90
- if (this._gameServerUrl !== null || this._gatewayWsUrl !== null) {
91
- this._gameServerUrl = null;
92
- this._gatewayWsUrl = null;
93
- this.persistGameServerUrl();
94
- return true;
95
- }
96
- return false;
97
- }
98
-
99
- const wsUrl = qs.ws_url;
100
- if (wsUrl && typeof wsUrl === 'string') {
101
- const httpUrl = wsUrl.replace(/^wss:/, 'https:').replace(/^ws:/, 'http:');
102
- if (this._gatewayWsUrl !== httpUrl) {
103
- this._gatewayWsUrl = httpUrl;
104
- this._gameServerUrl = httpUrl;
105
- this.persistGameServerUrl();
106
- return true;
107
- }
108
- return false;
109
- }
110
-
111
- const addr = qs.address ?? qs.game_server?.address;
112
- const port = qs.port ?? qs.game_server?.port;
113
- if (addr && port) {
114
- const url = `http://${addr}:${port}`;
115
- if (this._gameServerUrl !== url) {
116
- this._gameServerUrl = url;
117
- this._gatewayWsUrl = null;
118
- this.persistGameServerUrl();
119
- return true;
120
- }
121
- }
122
- return false;
123
- }
124
-
125
- /** Manually set the game server URL. */
126
- setGameServerUrl(url: string): void {
127
- this._gameServerUrl = url.replace(/\/$/, '');
128
- this._urlPreconfigured = true;
129
- this.persistGameServerUrl();
130
- }
131
-
132
- /** WS URL derived from gameServerUrl (Gateway or direct). */
133
- get wsUrl(): string | null {
134
- if (!this._gameServerUrl) return null;
135
- try {
136
- const u = new URL(this._gameServerUrl);
137
- const protocol = u.protocol === 'https:' || u.protocol === 'wss:' ? 'wss:' : 'ws:';
138
- const basePath = this._gatewayWsUrl ? u.pathname.replace(/\/$/, '') : '';
139
- return `${protocol}//${u.host}${basePath}/api/v1/game/stream`;
140
- } catch {
141
- return null;
142
- }
143
- }
144
-
145
- /** Persist gameServerUrl to auth profile (best-effort). */
146
- private persistGameServerUrl(): void {
147
- if (!this.agentName) return;
148
- try {
149
- new AuthStore().updateGameServerUrl(this._gameServerUrl ?? undefined, this.agentName);
150
- } catch { /* non-critical */ }
151
- }
152
- }
1
+ // src/lib/server-registry.ts
2
+ import { AuthStore } from './auth.js';
3
+
4
+ export interface ServerAddresses {
5
+ lobbyUrl: string;
6
+ gameServerUrl: string | null;
7
+ wsUrl: string | null;
8
+ }
9
+
10
+ export class ServerRegistry {
11
+ private lobbyUrl: string;
12
+ private _gameServerUrl: string | null;
13
+ private _gatewayWsUrl: string | null;
14
+ private agentName: string | undefined;
15
+ /** True when gameServerUrl was pre-configured (e.g. from auth) — prevents
16
+ * discoverGameServer() from clearing it during queue status polling. */
17
+ private _urlPreconfigured: boolean;
18
+
19
+ constructor(opts: { lobbyUrl: string; gameServerUrl?: string; agentName?: string }) {
20
+ this.lobbyUrl = opts.lobbyUrl.replace(/\/$/, '');
21
+ this._gatewayWsUrl = null;
22
+ if (opts.gameServerUrl) {
23
+ const raw = opts.gameServerUrl.replace(/\/$/, '');
24
+ try {
25
+ const u = new URL(raw);
26
+ if (u.pathname && u.pathname !== '/') {
27
+ // Gateway URL — restore _gatewayWsUrl so wsUrl path prefix is preserved
28
+ this._gatewayWsUrl = raw;
29
+ this._gameServerUrl = raw;
30
+ } else {
31
+ this._gameServerUrl = raw.replace(/^https:\/\//, 'http://');
32
+ }
33
+ } catch {
34
+ this._gameServerUrl = raw.replace(/^https:\/\//, 'http://');
35
+ }
36
+ this._urlPreconfigured = true;
37
+ } else {
38
+ this._gameServerUrl = null;
39
+ this._urlPreconfigured = false;
40
+ }
41
+ this.agentName = opts.agentName;
42
+ }
43
+
44
+ get addresses(): ServerAddresses {
45
+ return {
46
+ lobbyUrl: this.lobbyUrl,
47
+ gameServerUrl: this._gameServerUrl,
48
+ wsUrl: this.wsUrl,
49
+ };
50
+ }
51
+
52
+ get gameServerUrl(): string | null {
53
+ return this._gameServerUrl;
54
+ }
55
+
56
+ /**
57
+ * Determine the correct base URL for a given API path.
58
+ *
59
+ * Game Server routes: /api/v1/game/current, /api/v1/game/action, /api/v1/game/map, /api/v1/game/leave, /api/v1/game/role_info
60
+ * Lobby routes: everything else (/api/v1/agents/*, /api/v1/queue/*, etc.)
61
+ */
62
+ baseUrlFor(path: string): string {
63
+ if (
64
+ path.startsWith('/api/v1/game/current') ||
65
+ path.startsWith('/api/v1/game/action') ||
66
+ path.startsWith('/api/v1/game/map') ||
67
+ path.startsWith('/api/v1/game/leave') ||
68
+ path.startsWith('/api/v1/game/role_info')
69
+ ) {
70
+ const base = this._gatewayWsUrl ?? this._gameServerUrl;
71
+ if (!base) throw new Error('No game server allocated');
72
+ return base;
73
+ }
74
+ return this.lobbyUrl;
75
+ }
76
+
77
+ /**
78
+ * Extract game server address from a queue response and update gameServerUrl.
79
+ * Prefers ws_url (Gateway route) over raw address:port.
80
+ * Returns true if the address changed.
81
+ */
82
+ updateFromQueueResponse(data: any): boolean {
83
+ if (!data || typeof data !== 'object') return false;
84
+ const qs = data.data ?? data;
85
+ if (qs.status && qs.status !== 'allocated') {
86
+ // Never clear a pre-configured URL just because queue status changed —
87
+ // the game may already be in progress. Only clear if the URL was
88
+ // originally discovered via queue (not pre-set from auth).
89
+ if (this._urlPreconfigured) return false;
90
+ if (this._gameServerUrl !== null || this._gatewayWsUrl !== null) {
91
+ this._gameServerUrl = null;
92
+ this._gatewayWsUrl = null;
93
+ this.persistGameServerUrl();
94
+ return true;
95
+ }
96
+ return false;
97
+ }
98
+
99
+ const wsUrl = qs.ws_url;
100
+ if (wsUrl && typeof wsUrl === 'string') {
101
+ const httpUrl = wsUrl.replace(/^wss:/, 'https:').replace(/^ws:/, 'http:');
102
+ if (this._gatewayWsUrl !== httpUrl) {
103
+ this._gatewayWsUrl = httpUrl;
104
+ this._gameServerUrl = httpUrl;
105
+ this.persistGameServerUrl();
106
+ return true;
107
+ }
108
+ return false;
109
+ }
110
+
111
+ const addr = qs.address ?? qs.game_server?.address;
112
+ const port = qs.port ?? qs.game_server?.port;
113
+ if (addr && port) {
114
+ const url = `http://${addr}:${port}`;
115
+ if (this._gameServerUrl !== url) {
116
+ this._gameServerUrl = url;
117
+ this._gatewayWsUrl = null;
118
+ this.persistGameServerUrl();
119
+ return true;
120
+ }
121
+ }
122
+ return false;
123
+ }
124
+
125
+ /** Manually set the game server URL. */
126
+ setGameServerUrl(url: string): void {
127
+ this._gameServerUrl = url.replace(/\/$/, '');
128
+ this._urlPreconfigured = true;
129
+ this.persistGameServerUrl();
130
+ }
131
+
132
+ /** WS URL derived from gameServerUrl (Gateway or direct). */
133
+ get wsUrl(): string | null {
134
+ if (!this._gameServerUrl) return null;
135
+ try {
136
+ const u = new URL(this._gameServerUrl);
137
+ const protocol = u.protocol === 'https:' || u.protocol === 'wss:' ? 'wss:' : 'ws:';
138
+ const basePath = this._gatewayWsUrl ? u.pathname.replace(/\/$/, '') : '';
139
+ return `${protocol}//${u.host}${basePath}/api/v1/game/stream`;
140
+ } catch {
141
+ return null;
142
+ }
143
+ }
144
+
145
+ /** Persist gameServerUrl to auth profile (best-effort). */
146
+ private persistGameServerUrl(): void {
147
+ if (!this.agentName) return;
148
+ try {
149
+ new AuthStore().updateGameServerUrl(this._gameServerUrl ?? undefined, this.agentName);
150
+ } catch { /* non-critical */ }
151
+ }
152
+ }
@@ -1,48 +1,48 @@
1
- import { mkdtempSync, writeFileSync } from 'fs';
2
- import { tmpdir } from 'os';
3
- import { join } from 'path';
4
- import { describe, expect, it } from 'vitest';
5
- import { parseSkillVersion, readSkillVersion } from './skill-version.js';
6
-
7
- describe('parseSkillVersion', () => {
8
- it('returns version from a normal frontmatter block', () => {
9
- const md = '---\nname: clawclaw\ndescription: x\nversion: 3.2.8\n---\n\n# body\n';
10
- expect(parseSkillVersion(md)).toBe('3.2.8');
11
- });
12
-
13
- it('handles CRLF line endings', () => {
14
- const md = '---\r\nname: x\r\nversion: 1.0.0\r\n---\r\nbody';
15
- expect(parseSkillVersion(md)).toBe('1.0.0');
16
- });
17
-
18
- it('returns null when frontmatter is missing', () => {
19
- expect(parseSkillVersion('# just a heading\n')).toBeNull();
20
- });
21
-
22
- it('returns null when version key is absent', () => {
23
- expect(parseSkillVersion('---\nname: x\n---\nbody')).toBeNull();
24
- });
25
-
26
- it('ignores a version: outside the frontmatter block', () => {
27
- const md = '---\nname: x\n---\n\nversion: 9.9.9 (in body)\n';
28
- expect(parseSkillVersion(md)).toBeNull();
29
- });
30
-
31
- it('strips surrounding whitespace from the value', () => {
32
- const md = '---\nversion: 2.1.0 \n---\nbody';
33
- expect(parseSkillVersion(md)).toBe('2.1.0');
34
- });
35
- });
36
-
37
- describe('readSkillVersion', () => {
38
- it('reads version from a file on disk', () => {
39
- const dir = mkdtempSync(join(tmpdir(), 'skill-version-'));
40
- const path = join(dir, 'SKILL.md');
41
- writeFileSync(path, '---\nversion: 4.0.0\n---\nbody');
42
- expect(readSkillVersion(path)).toBe('4.0.0');
43
- });
44
-
45
- it('returns null when file does not exist', () => {
46
- expect(readSkillVersion('/nonexistent/path/SKILL.md')).toBeNull();
47
- });
48
- });
1
+ import { mkdtempSync, writeFileSync } from 'fs';
2
+ import { tmpdir } from 'os';
3
+ import { join } from 'path';
4
+ import { describe, expect, it } from 'vitest';
5
+ import { parseSkillVersion, readSkillVersion } from './skill-version.js';
6
+
7
+ describe('parseSkillVersion', () => {
8
+ it('returns version from a normal frontmatter block', () => {
9
+ const md = '---\nname: clawclaw\ndescription: x\nversion: 3.2.8\n---\n\n# body\n';
10
+ expect(parseSkillVersion(md)).toBe('3.2.8');
11
+ });
12
+
13
+ it('handles CRLF line endings', () => {
14
+ const md = '---\r\nname: x\r\nversion: 1.0.0\r\n---\r\nbody';
15
+ expect(parseSkillVersion(md)).toBe('1.0.0');
16
+ });
17
+
18
+ it('returns null when frontmatter is missing', () => {
19
+ expect(parseSkillVersion('# just a heading\n')).toBeNull();
20
+ });
21
+
22
+ it('returns null when version key is absent', () => {
23
+ expect(parseSkillVersion('---\nname: x\n---\nbody')).toBeNull();
24
+ });
25
+
26
+ it('ignores a version: outside the frontmatter block', () => {
27
+ const md = '---\nname: x\n---\n\nversion: 9.9.9 (in body)\n';
28
+ expect(parseSkillVersion(md)).toBeNull();
29
+ });
30
+
31
+ it('strips surrounding whitespace from the value', () => {
32
+ const md = '---\nversion: 2.1.0 \n---\nbody';
33
+ expect(parseSkillVersion(md)).toBe('2.1.0');
34
+ });
35
+ });
36
+
37
+ describe('readSkillVersion', () => {
38
+ it('reads version from a file on disk', () => {
39
+ const dir = mkdtempSync(join(tmpdir(), 'skill-version-'));
40
+ const path = join(dir, 'SKILL.md');
41
+ writeFileSync(path, '---\nversion: 4.0.0\n---\nbody');
42
+ expect(readSkillVersion(path)).toBe('4.0.0');
43
+ });
44
+
45
+ it('returns null when file does not exist', () => {
46
+ expect(readSkillVersion('/nonexistent/path/SKILL.md')).toBeNull();
47
+ });
48
+ });
@@ -1,19 +1,19 @@
1
- import { readFileSync } from 'fs';
2
-
3
- const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
4
- const VERSION_RE = /^version:\s*(\S.*?)\s*$/m;
5
-
6
- export function parseSkillVersion(content: string): string | null {
7
- const fm = FRONTMATTER_RE.exec(content);
8
- if (!fm) return null;
9
- const v = VERSION_RE.exec(fm[1]);
10
- return v ? v[1] : null;
11
- }
12
-
13
- export function readSkillVersion(path: string): string | null {
14
- try {
15
- return parseSkillVersion(readFileSync(path, 'utf8'));
16
- } catch {
17
- return null;
18
- }
19
- }
1
+ import { readFileSync } from 'fs';
2
+
3
+ const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
4
+ const VERSION_RE = /^version:\s*(\S.*?)\s*$/m;
5
+
6
+ export function parseSkillVersion(content: string): string | null {
7
+ const fm = FRONTMATTER_RE.exec(content);
8
+ if (!fm) return null;
9
+ const v = VERSION_RE.exec(fm[1]);
10
+ return v ? v[1] : null;
11
+ }
12
+
13
+ export function readSkillVersion(path: string): string | null {
14
+ try {
15
+ return parseSkillVersion(readFileSync(path, 'utf8'));
16
+ } catch {
17
+ return null;
18
+ }
19
+ }