@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,172 +1,172 @@
1
- import { existsSync, readdirSync, readFileSync, realpathSync, mkdtempSync, writeFileSync, rmSync } from 'fs';
2
- import { dirname, join, resolve, basename } from 'path';
3
- import { tmpdir } from 'os';
4
- import { fileURLToPath, pathToFileURL } from 'url';
5
- import { getWorkspaceDir } from '../lib/init-command.js';
6
- import type { Plugin, OnResolveArgs } from 'esbuild';
7
- import type { Strategy, StrategyEntry } from './types.js';
8
-
9
- const __filename = fileURLToPath(import.meta.url);
10
- const __dirname = dirname(__filename);
11
-
12
- // Resolve SDK path for user strategy imports (raw filesystem path, not URL).
13
- // realpathSync ensures dedup against built-in strategies even under --preserve-symlinks.
14
- const SDK_PATH = realpathSync(resolve(__dirname, '../sdk/index.ts'));
15
-
16
- const strategyMap = new Map<string, StrategyEntry>();
17
- const knowledgeDocMap = new Map<string, string>();
18
- let loaded = false;
19
-
20
- const INFRA_FILES = new Set(['loader', 'types', 'game-utils', 'player-targets', 'greeting', 'spawn', 'strategy-loop', 'new-events-backfill']);
21
-
22
- function resolveUserStrategiesDir(): string | undefined {
23
- const workspaceDir = getWorkspaceDir();
24
- if (!existsSync(workspaceDir)) return undefined;
25
- const strategiesDir = join(workspaceDir, 'strategies');
26
- if (!existsSync(strategiesDir)) return undefined;
27
- return strategiesDir;
28
- }
29
-
30
- /**
31
- * Create an esbuild plugin that intercepts `@myclaw163/clawclaw-cli` and
32
- * `@myclaw163/clawclaw-cli/*` imports (and the legacy bare `clawclaw-cli`
33
- * name for backward compat) and redirects them to the local SDK path
34
- * (marked external so Node resolves the same module instance at runtime).
35
- *
36
- * `require()` calls fail the build with a clear error, since `require` is
37
- * unavailable in ESM output and would otherwise crash at runtime.
38
- */
39
- function createSdkPlugin(): { plugin: Plugin } {
40
- const sdkUrl = pathToFileURL(SDK_PATH).href;
41
-
42
- const plugin: Plugin = {
43
- name: 'clawclaw-cli-sdk',
44
- setup(build) {
45
- build.onResolve({ filter: /^(?:@myclaw163\/)?clawclaw-cli(?:\/.*)?$/ }, (args: OnResolveArgs) => {
46
- if (args.kind === 'require-call') {
47
- return {
48
- errors: [{
49
- text: `require('${args.path}') is not supported in user strategies. Use static imports: import { ... } from '${args.path}'.`,
50
- }],
51
- };
52
- }
53
- return { path: sdkUrl, external: true };
54
- });
55
- },
56
- };
57
-
58
- return { plugin };
59
- }
60
-
61
- // Returns Record<string, unknown> — slightly less precise than native import()'s
62
- // Module type, but both are cast to StrategyEntry via `as` in loadFromDir.
63
- export async function importUserFile(filePath: string): Promise<Record<string, unknown>> {
64
- const { plugin } = createSdkPlugin();
65
- const { build } = await import('esbuild');
66
- const result = await build({
67
- stdin: {
68
- contents: readFileSync(filePath, 'utf8'),
69
- resolveDir: dirname(filePath),
70
- sourcefile: basename(filePath),
71
- loader: filePath.endsWith('.ts') ? 'ts' : 'js',
72
- },
73
- bundle: true,
74
- format: 'esm',
75
- write: false,
76
- platform: 'node',
77
- packages: 'external',
78
- plugins: [plugin],
79
- });
80
-
81
- // Write to temporary file so Node's module cache deduplicates the SDK —
82
- // data URLs load as separate module instances, breaking instanceof checks.
83
- const tmpDir = mkdtempSync(join(tmpdir(), 'ccl-strategy-'));
84
- const tmpFile = join(tmpDir, basename(filePath).replace(/\.(ts|js)$/, '.mjs'));
85
- try {
86
- writeFileSync(tmpFile, result.outputFiles[0].text);
87
- return await import(pathToFileURL(tmpFile).href);
88
- } finally {
89
- try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
90
- }
91
- }
92
-
93
- async function loadFromDir(dir: string, skipInfra: boolean): Promise<void> {
94
- let files: string[];
95
- try {
96
- files = readdirSync(dir).filter(f => {
97
- if (f.startsWith('_')) return false;
98
- const match = f.match(/^(.+)\.(ts|js)$/);
99
- if (!match) return false;
100
- if (match[1].endsWith('.d')) return false;
101
- if (match[1].endsWith('.test')) return false;
102
- return !skipInfra || !INFRA_FILES.has(match[1]);
103
- });
104
- } catch {
105
- return;
106
- }
107
- for (const file of files) {
108
- try {
109
- const filePath = realpathSync(join(dir, file));
110
- const mod = skipInfra
111
- ? await import(pathToFileURL(filePath).href)
112
- : await importUserFile(filePath);
113
- const entry: StrategyEntry | undefined = mod.strategy as StrategyEntry | undefined;
114
- if (entry?.id && typeof entry.description === 'string' && typeof entry.create === 'function') {
115
- strategyMap.set(entry.id, entry);
116
- const sidecar = filePath.replace(/\.(ts|js)$/, '.knowledge.md');
117
- if (existsSync(sidecar)) knowledgeDocMap.set(entry.id, sidecar);
118
- }
119
- } catch (err) {
120
- if (!skipInfra) {
121
- // Strip temp-dir paths from error messages — they leak internal
122
- // implementation details (e.g., /tmp/ccl-strategy-XXXX/strategy.mjs)
123
- const raw = err instanceof Error ? err.message : String(err);
124
- const cleaned = raw.replace(/\S*ccl-strategy-[^/]*\//g, '');
125
- console.error(`[ccl] Failed to load user strategy ${file}: ${cleaned}`);
126
- }
127
- }
128
- }
129
- }
130
-
131
- async function ensureLoaded(): Promise<void> {
132
- if (loaded) return;
133
- loaded = true;
134
- await loadFromDir(__dirname, true);
135
- const userDir = resolveUserStrategiesDir();
136
- if (userDir) await loadFromDir(userDir, false);
137
- }
138
-
139
- export async function getStrategyEntry(id: string): Promise<StrategyEntry | undefined> {
140
- await ensureLoaded();
141
- return strategyMap.get(id);
142
- }
143
-
144
- export async function listStrategyEntries(): Promise<StrategyEntry[]> {
145
- await ensureLoaded();
146
- return [...strategyMap.values()];
147
- }
148
-
149
- export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
150
- await ensureLoaded();
151
- const path = knowledgeDocMap.get(id);
152
- if (!path || !existsSync(path)) return undefined;
153
- try {
154
- return readFileSync(path, 'utf8');
155
- } catch {
156
- return undefined;
157
- }
158
- }
159
-
160
- export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
161
- const entry = await getStrategyEntry(id);
162
- if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
163
- return entry.create(args);
164
- }
165
-
166
- /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
167
- export async function reload(): Promise<void> {
168
- loaded = false;
169
- strategyMap.clear();
170
- knowledgeDocMap.clear();
171
- await ensureLoaded();
172
- }
1
+ import { existsSync, readdirSync, readFileSync, realpathSync, mkdtempSync, writeFileSync, rmSync } from 'fs';
2
+ import { dirname, join, resolve, basename } from 'path';
3
+ import { tmpdir } from 'os';
4
+ import { fileURLToPath, pathToFileURL } from 'url';
5
+ import { getWorkspaceDir } from '../lib/init-command.js';
6
+ import type { Plugin, OnResolveArgs } from 'esbuild';
7
+ import type { Strategy, StrategyEntry } from './types.js';
8
+
9
+ const __filename = fileURLToPath(import.meta.url);
10
+ const __dirname = dirname(__filename);
11
+
12
+ // Resolve SDK path for user strategy imports (raw filesystem path, not URL).
13
+ // realpathSync ensures dedup against built-in strategies even under --preserve-symlinks.
14
+ const SDK_PATH = realpathSync(resolve(__dirname, '../sdk/index.ts'));
15
+
16
+ const strategyMap = new Map<string, StrategyEntry>();
17
+ const knowledgeDocMap = new Map<string, string>();
18
+ let loaded = false;
19
+
20
+ const INFRA_FILES = new Set(['loader', 'types', 'game-utils', 'player-targets', 'greeting', 'spawn', 'strategy-loop', 'new-events-backfill']);
21
+
22
+ function resolveUserStrategiesDir(): string | undefined {
23
+ const workspaceDir = getWorkspaceDir();
24
+ if (!existsSync(workspaceDir)) return undefined;
25
+ const strategiesDir = join(workspaceDir, 'strategies');
26
+ if (!existsSync(strategiesDir)) return undefined;
27
+ return strategiesDir;
28
+ }
29
+
30
+ /**
31
+ * Create an esbuild plugin that intercepts `@myclaw163/clawclaw-cli` and
32
+ * `@myclaw163/clawclaw-cli/*` imports (and the legacy bare `clawclaw-cli`
33
+ * name for backward compat) and redirects them to the local SDK path
34
+ * (marked external so Node resolves the same module instance at runtime).
35
+ *
36
+ * `require()` calls fail the build with a clear error, since `require` is
37
+ * unavailable in ESM output and would otherwise crash at runtime.
38
+ */
39
+ function createSdkPlugin(): { plugin: Plugin } {
40
+ const sdkUrl = pathToFileURL(SDK_PATH).href;
41
+
42
+ const plugin: Plugin = {
43
+ name: 'clawclaw-cli-sdk',
44
+ setup(build) {
45
+ build.onResolve({ filter: /^(?:@myclaw163\/)?clawclaw-cli(?:\/.*)?$/ }, (args: OnResolveArgs) => {
46
+ if (args.kind === 'require-call') {
47
+ return {
48
+ errors: [{
49
+ text: `require('${args.path}') is not supported in user strategies. Use static imports: import { ... } from '${args.path}'.`,
50
+ }],
51
+ };
52
+ }
53
+ return { path: sdkUrl, external: true };
54
+ });
55
+ },
56
+ };
57
+
58
+ return { plugin };
59
+ }
60
+
61
+ // Returns Record<string, unknown> — slightly less precise than native import()'s
62
+ // Module type, but both are cast to StrategyEntry via `as` in loadFromDir.
63
+ export async function importUserFile(filePath: string): Promise<Record<string, unknown>> {
64
+ const { plugin } = createSdkPlugin();
65
+ const { build } = await import('esbuild');
66
+ const result = await build({
67
+ stdin: {
68
+ contents: readFileSync(filePath, 'utf8'),
69
+ resolveDir: dirname(filePath),
70
+ sourcefile: basename(filePath),
71
+ loader: filePath.endsWith('.ts') ? 'ts' : 'js',
72
+ },
73
+ bundle: true,
74
+ format: 'esm',
75
+ write: false,
76
+ platform: 'node',
77
+ packages: 'external',
78
+ plugins: [plugin],
79
+ });
80
+
81
+ // Write to temporary file so Node's module cache deduplicates the SDK —
82
+ // data URLs load as separate module instances, breaking instanceof checks.
83
+ const tmpDir = mkdtempSync(join(tmpdir(), 'ccl-strategy-'));
84
+ const tmpFile = join(tmpDir, basename(filePath).replace(/\.(ts|js)$/, '.mjs'));
85
+ try {
86
+ writeFileSync(tmpFile, result.outputFiles[0].text);
87
+ return await import(pathToFileURL(tmpFile).href);
88
+ } finally {
89
+ try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
90
+ }
91
+ }
92
+
93
+ async function loadFromDir(dir: string, skipInfra: boolean): Promise<void> {
94
+ let files: string[];
95
+ try {
96
+ files = readdirSync(dir).filter(f => {
97
+ if (f.startsWith('_')) return false;
98
+ const match = f.match(/^(.+)\.(ts|js)$/);
99
+ if (!match) return false;
100
+ if (match[1].endsWith('.d')) return false;
101
+ if (match[1].endsWith('.test')) return false;
102
+ return !skipInfra || !INFRA_FILES.has(match[1]);
103
+ });
104
+ } catch {
105
+ return;
106
+ }
107
+ for (const file of files) {
108
+ try {
109
+ const filePath = realpathSync(join(dir, file));
110
+ const mod = skipInfra
111
+ ? await import(pathToFileURL(filePath).href)
112
+ : await importUserFile(filePath);
113
+ const entry: StrategyEntry | undefined = mod.strategy as StrategyEntry | undefined;
114
+ if (entry?.id && typeof entry.description === 'string' && typeof entry.create === 'function') {
115
+ strategyMap.set(entry.id, entry);
116
+ const sidecar = filePath.replace(/\.(ts|js)$/, '.knowledge.md');
117
+ if (existsSync(sidecar)) knowledgeDocMap.set(entry.id, sidecar);
118
+ }
119
+ } catch (err) {
120
+ if (!skipInfra) {
121
+ // Strip temp-dir paths from error messages — they leak internal
122
+ // implementation details (e.g., /tmp/ccl-strategy-XXXX/strategy.mjs)
123
+ const raw = err instanceof Error ? err.message : String(err);
124
+ const cleaned = raw.replace(/\S*ccl-strategy-[^/]*\//g, '');
125
+ console.error(`[ccl] Failed to load user strategy ${file}: ${cleaned}`);
126
+ }
127
+ }
128
+ }
129
+ }
130
+
131
+ async function ensureLoaded(): Promise<void> {
132
+ if (loaded) return;
133
+ loaded = true;
134
+ await loadFromDir(__dirname, true);
135
+ const userDir = resolveUserStrategiesDir();
136
+ if (userDir) await loadFromDir(userDir, false);
137
+ }
138
+
139
+ export async function getStrategyEntry(id: string): Promise<StrategyEntry | undefined> {
140
+ await ensureLoaded();
141
+ return strategyMap.get(id);
142
+ }
143
+
144
+ export async function listStrategyEntries(): Promise<StrategyEntry[]> {
145
+ await ensureLoaded();
146
+ return [...strategyMap.values()];
147
+ }
148
+
149
+ export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
150
+ await ensureLoaded();
151
+ const path = knowledgeDocMap.get(id);
152
+ if (!path || !existsSync(path)) return undefined;
153
+ try {
154
+ return readFileSync(path, 'utf8');
155
+ } catch {
156
+ return undefined;
157
+ }
158
+ }
159
+
160
+ export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
161
+ const entry = await getStrategyEntry(id);
162
+ if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
163
+ return entry.create(args);
164
+ }
165
+
166
+ /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
167
+ export async function reload(): Promise<void> {
168
+ loaded = false;
169
+ strategyMap.clear();
170
+ knowledgeDocMap.clear();
171
+ await ensureLoaded();
172
+ }
@@ -1,21 +1,21 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { LoneKillTaskTop } from './goals/lone-kill-task-top.js';
4
- import { ConversationGoal } from './goals/conversation-goal.js';
5
- import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
6
-
7
- export const strategy: StrategyEntry = {
8
- id: 'lone-kill-task',
9
- description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。(章鱼默认)',
10
- create(args?: string[]) {
11
- const role = args?.[0] ?? 'neutral_octopus';
12
- let convo: ConversationGoal | null = null;
13
- return new GoalRootStrategy('lone-kill-task', () => {
14
- convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
15
- return convo;
16
- }, {
17
- resetOnMeetingResume: false,
18
- onUpdateRole: role => convo?.updateConfig(role),
19
- });
20
- },
21
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { LoneKillTaskTop } from './goals/lone-kill-task-top.js';
4
+ import { ConversationGoal } from './goals/conversation-goal.js';
5
+ import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
6
+
7
+ export const strategy: StrategyEntry = {
8
+ id: 'lone-kill-task',
9
+ description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。(章鱼默认)',
10
+ create(args?: string[]) {
11
+ const role = args?.[0] ?? 'neutral_octopus';
12
+ let convo: ConversationGoal | null = null;
13
+ return new GoalRootStrategy('lone-kill-task', () => {
14
+ convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
15
+ return convo;
16
+ }, {
17
+ resetOnMeetingResume: false,
18
+ onUpdateRole: role => convo?.updateConfig(role),
19
+ });
20
+ },
21
+ };
@@ -1,59 +1,59 @@
1
- import { describe, expect, it } from 'vitest';
2
- import {
3
- meetingEndedInEvents,
4
- meetingStartedInEvents,
5
- shouldPauseForMeeting,
6
- } from './meeting-gate.js';
7
- import type { GameState } from '../sdk/types.js';
8
-
9
- function baseState(overrides: Partial<GameState> = {}): GameState {
10
- return {
11
- phase: 'wandering',
12
- tick: 1,
13
- you: {
14
- name: 'me',
15
- x: 0,
16
- y: 0,
17
- room: '酒吧',
18
- role: 'crab_generic',
19
- faction: 'crab',
20
- is_alive: true,
21
- },
22
- your_tasks: [],
23
- players: [],
24
- corpses: [],
25
- stale: false,
26
- ...overrides,
27
- };
28
- }
29
-
30
- describe('meeting-gate', () => {
31
- it('detects meeting end events', () => {
32
- expect(meetingEndedInEvents([{ type: 'meeting_ended' }])).toBe(true);
33
- expect(meetingEndedInEvents([{ type: 'meeting_result_pending' }])).toBe(true);
34
- expect(meetingEndedInEvents([{ type: 'speech' }])).toBe(false);
35
- });
36
-
37
- it('keeps pausing during meeting until end events arrive', () => {
38
- const during = baseState({ phase: 'meeting', new_events: [{ type: 'speech' }] });
39
- expect(shouldPauseForMeeting(during)).toBe(true);
40
-
41
- const ending = baseState({ phase: 'meeting', new_events: [{ type: 'meeting_ended' }] });
42
- expect(shouldPauseForMeeting(ending)).toBe(false);
43
-
44
- const wandering = baseState({ phase: 'wandering' });
45
- expect(shouldPauseForMeeting(wandering)).toBe(false);
46
- });
47
-
48
- it('does not re-pause after releasedEarly while HTTP phase still meeting', () => {
49
- const lingering = baseState({ phase: 'meeting', new_events: [] });
50
- expect(shouldPauseForMeeting(lingering, true)).toBe(false);
51
- expect(shouldPauseForMeeting(lingering, false)).toBe(true);
52
- });
53
-
54
- it('detects meeting start events for cycle reset', () => {
55
- expect(meetingStartedInEvents([{ type: 'meeting_start' }])).toBe(true);
56
- expect(meetingStartedInEvents([{ type: 'meeting_started' }])).toBe(true);
57
- expect(meetingStartedInEvents([{ type: 'speech' }])).toBe(false);
58
- });
59
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ meetingEndedInEvents,
4
+ meetingStartedInEvents,
5
+ shouldPauseForMeeting,
6
+ } from './meeting-gate.js';
7
+ import type { GameState } from '../sdk/types.js';
8
+
9
+ function baseState(overrides: Partial<GameState> = {}): GameState {
10
+ return {
11
+ phase: 'wandering',
12
+ tick: 1,
13
+ you: {
14
+ name: 'me',
15
+ x: 0,
16
+ y: 0,
17
+ room: '酒吧',
18
+ role: 'crab_generic',
19
+ faction: 'crab',
20
+ is_alive: true,
21
+ },
22
+ your_tasks: [],
23
+ players: [],
24
+ corpses: [],
25
+ stale: false,
26
+ ...overrides,
27
+ };
28
+ }
29
+
30
+ describe('meeting-gate', () => {
31
+ it('detects meeting end events', () => {
32
+ expect(meetingEndedInEvents([{ type: 'meeting_ended' }])).toBe(true);
33
+ expect(meetingEndedInEvents([{ type: 'meeting_result_pending' }])).toBe(true);
34
+ expect(meetingEndedInEvents([{ type: 'speech' }])).toBe(false);
35
+ });
36
+
37
+ it('keeps pausing during meeting until end events arrive', () => {
38
+ const during = baseState({ phase: 'meeting', new_events: [{ type: 'speech' }] });
39
+ expect(shouldPauseForMeeting(during)).toBe(true);
40
+
41
+ const ending = baseState({ phase: 'meeting', new_events: [{ type: 'meeting_ended' }] });
42
+ expect(shouldPauseForMeeting(ending)).toBe(false);
43
+
44
+ const wandering = baseState({ phase: 'wandering' });
45
+ expect(shouldPauseForMeeting(wandering)).toBe(false);
46
+ });
47
+
48
+ it('does not re-pause after releasedEarly while HTTP phase still meeting', () => {
49
+ const lingering = baseState({ phase: 'meeting', new_events: [] });
50
+ expect(shouldPauseForMeeting(lingering, true)).toBe(false);
51
+ expect(shouldPauseForMeeting(lingering, false)).toBe(true);
52
+ });
53
+
54
+ it('detects meeting start events for cycle reset', () => {
55
+ expect(meetingStartedInEvents([{ type: 'meeting_start' }])).toBe(true);
56
+ expect(meetingStartedInEvents([{ type: 'meeting_started' }])).toBe(true);
57
+ expect(meetingStartedInEvents([{ type: 'speech' }])).toBe(false);
58
+ });
59
+ });
@@ -1,23 +1,23 @@
1
- import type { GameState } from '../sdk/types.js';
2
-
3
- const MEETING_END_EVENT_TYPES = new Set(['meeting_ended', 'meeting_result_pending']);
4
- const MEETING_START_EVENT_TYPES = new Set(['meeting_start', 'meeting_started']);
5
-
6
- export function meetingEndedInEvents(events: any[] | undefined): boolean {
7
- return (events ?? []).some((e) => MEETING_END_EVENT_TYPES.has(e.type));
8
- }
9
-
10
- export function meetingStartedInEvents(events: any[] | undefined): boolean {
11
- return (events ?? []).some((e) => MEETING_START_EVENT_TYPES.has(e.type));
12
- }
13
-
14
- /**
15
- * Keep pausing while HTTP phase is still `meeting`.
16
- * `releasedEarly` is set after we have seen meeting end once — avoids re-pausing
17
- * on later polls where phase lags but `new_events` no longer repeats `meeting_ended`.
18
- */
19
- export function shouldPauseForMeeting(state: GameState, releasedEarly = false): boolean {
20
- if (state.phase !== 'meeting') return false;
21
- if (releasedEarly) return false;
22
- return !meetingEndedInEvents(state.new_events);
23
- }
1
+ import type { GameState } from '../sdk/types.js';
2
+
3
+ const MEETING_END_EVENT_TYPES = new Set(['meeting_ended', 'meeting_result_pending']);
4
+ const MEETING_START_EVENT_TYPES = new Set(['meeting_start', 'meeting_started']);
5
+
6
+ export function meetingEndedInEvents(events: any[] | undefined): boolean {
7
+ return (events ?? []).some((e) => MEETING_END_EVENT_TYPES.has(e.type));
8
+ }
9
+
10
+ export function meetingStartedInEvents(events: any[] | undefined): boolean {
11
+ return (events ?? []).some((e) => MEETING_START_EVENT_TYPES.has(e.type));
12
+ }
13
+
14
+ /**
15
+ * Keep pausing while HTTP phase is still `meeting`.
16
+ * `releasedEarly` is set after we have seen meeting end once — avoids re-pausing
17
+ * on later polls where phase lags but `new_events` no longer repeats `meeting_ended`.
18
+ */
19
+ export function shouldPauseForMeeting(state: GameState, releasedEarly = false): boolean {
20
+ if (state.phase !== 'meeting') return false;
21
+ if (releasedEarly) return false;
22
+ return !meetingEndedInEvents(state.new_events);
23
+ }
@@ -1,15 +1,15 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { MoveRoomGoal } from './goals/move-room-goal.js';
4
-
5
- export const strategy: StrategyEntry = {
6
- id: 'move-room',
7
- description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
8
- create(args?: string[]) {
9
- const targetRoom = args?.join(' ').trim() ?? '';
10
- if (!targetRoom) {
11
- throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
12
- }
13
- return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
14
- },
15
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { MoveRoomGoal } from './goals/move-room-goal.js';
4
+
5
+ export const strategy: StrategyEntry = {
6
+ id: 'move-room',
7
+ description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
8
+ create(args?: string[]) {
9
+ const targetRoom = args?.join(' ').trim() ?? '';
10
+ if (!targetRoom) {
11
+ throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
12
+ }
13
+ return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
14
+ },
15
+ };