@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
package/src/cli.ts CHANGED
@@ -1,110 +1,110 @@
1
- import { Command } from 'commander';
2
- import { readFileSync, appendFileSync } from 'fs';
3
- import { fileURLToPath } from 'url';
4
- import { dirname, resolve } from 'path';
5
- import { ApiError } from './lib/http-transport.js';
6
- import { createGameCommand } from './commands/game.js';
7
- import { createDoCommand } from './commands/do.js';
8
- import { createEventsCommand } from './commands/events.js';
9
- import { createStateCommand } from './commands/state.js';
10
- import { createAccountCommand } from './commands/account.js';
11
- import { createPeekCommand } from './commands/peek.js';
12
- import { createUpgradeCommand } from './commands/upgrade.js';
13
- import { createLoadCommand } from './commands/load.js';
14
- import { createMemoryCommand } from './commands/memory.js';
15
- import { createKnowledgeCommand } from './commands/knowledge.js';
16
- import { createPersonaCommand } from './commands/persona.js';
17
- import { createTTSCommand } from './commands/tts.js';
18
- import { createStrategyCommand } from './commands/strategy.js';
19
- import { createHubCommand } from './commands/hub.js';
20
- import { createSkillCommand } from './commands/skill.js';
21
- import { createSetupCommand } from './commands/setup/index.js';
22
- import { createConfigCommand } from './commands/config.js';
23
- import { createSchemaCommand } from './commands/_schema.js';
24
- import { createHistoryCommand } from './commands/history.js';
25
- import { initHttpKeepAlive } from './lib/http-keepalive.js';
26
- import { applyWorkspaceArgv } from './lib/workspace-argv.js';
27
-
28
- initHttpKeepAlive();
29
- applyWorkspaceArgv(process.argv, process.env);
30
-
31
- // ─── Internal entry: _pipeline (forked by `do` command for multi-action sequences) ───
32
- if (process.argv[2] === '_pipeline') {
33
- const actions = JSON.parse(process.argv[3]);
34
- const initialWaitMs = process.argv[4] ? Number(process.argv[4]) : 0;
35
- const { runPipeline } = await import('./pipeline/pipeline.js');
36
- await runPipeline(actions, initialWaitMs);
37
- process.exit(0);
38
- }
39
-
40
- // ─── Internal entry: _strategy (spawned by `strategy` command) ───
41
- if (process.argv[2] === '_strategy') {
42
- const _logFile = process.env.CLAWCLAW_LOG_FILE;
43
- const _earlyLog = (label: string, err: any) => {
44
- const msg = `[${new Date().toISOString()}] [${label}] ${err?.stack ?? err}\n`;
45
- if (_logFile) try { appendFileSync(_logFile, msg); } catch {}
46
- try { process.stderr.write(msg); } catch {}
47
- };
48
- process.on('uncaughtException', (err) => { _earlyLog('FATAL', err); process.exit(1); });
49
- process.on('unhandledRejection', (reason) => { _earlyLog('FATAL:unhandledRejection', reason); process.exit(1); });
50
-
51
- const strategyId = process.argv[3];
52
- const dashDashIdx = process.argv.indexOf('--');
53
- const strategyArgs = dashDashIdx >= 0 ? process.argv.slice(dashDashIdx + 1) : [];
54
- const { runStrategyLoop } = await import('./strategies/strategy-loop.js');
55
- try {
56
- await runStrategyLoop(strategyId, strategyArgs.length > 0 ? strategyArgs : undefined);
57
- } catch (e: any) {
58
- const { EventStore } = await import('./pipeline/event-store.js');
59
- try { EventStore.forActiveAccount().append({ type: 'auto_fatal', error: e?.message ?? String(e), stack: e?.stack }); } catch {}
60
- }
61
- process.exit(0);
62
- }
63
-
64
- // ─── Normal CLI ───
65
- const __filename = fileURLToPath(import.meta.url);
66
- const __dirname = dirname(__filename);
67
- const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
68
-
69
- const program = new Command()
70
- .name('clawclaw-cli')
71
- .description('ClawClaw social deduction game CLI')
72
- .version(pkg.version)
73
- .option('--workspace-dir <dir>', 'workspace directory');
74
-
75
- program.addCommand(createDoCommand());
76
- program.addCommand(createStateCommand());
77
- program.addCommand(createEventsCommand());
78
- program.addCommand(createGameCommand());
79
- program.addCommand(createAccountCommand());
80
- program.addCommand(createLoadCommand());
81
- program.addCommand(createMemoryCommand());
82
- program.addCommand(createKnowledgeCommand());
83
- program.addCommand(createPersonaCommand());
84
- program.addCommand(createUpgradeCommand());
85
- program.addCommand(createPeekCommand());
86
- program.addCommand(createHistoryCommand());
87
- program.addCommand(createTTSCommand(), { hidden: true }); // 暂时屏蔽:不在 help 中暴露,命令仍可执行(do -s 自动 TTS 依赖其 config)
88
- program.addCommand(createStrategyCommand());
89
- program.addCommand(createSkillCommand());
90
- program.addCommand(createHubCommand());
91
- program.addCommand(createSetupCommand());
92
- program.addCommand(createConfigCommand());
93
- program.addCommand(createSchemaCommand(() => program), { hidden: true });
94
-
95
- try {
96
- await program.parseAsync();
97
- } catch (err) {
98
- if (err instanceof ApiError) {
99
- if (err.status === 422) {
100
- console.info(`API key is missing or malformed. Run: clawclaw-cli account register`);
101
- } else if (err.status === 401) {
102
- console.info(`Account not found or API key expired. Run: clawclaw-cli account register`);
103
- } else {
104
- console.info(`Request failed (${err.status}): ${err.body}`);
105
- }
106
- } else {
107
- console.error(err instanceof Error ? err.message : String(err));
108
- }
109
- process.exit(1);
110
- }
1
+ import { Command } from 'commander';
2
+ import { readFileSync, appendFileSync } from 'fs';
3
+ import { fileURLToPath } from 'url';
4
+ import { dirname, resolve } from 'path';
5
+ import { ApiError } from './lib/http-transport.js';
6
+ import { createGameCommand } from './commands/game.js';
7
+ import { createDoCommand } from './commands/do.js';
8
+ import { createEventsCommand } from './commands/events.js';
9
+ import { createStateCommand } from './commands/state.js';
10
+ import { createAccountCommand } from './commands/account.js';
11
+ import { createPeekCommand } from './commands/peek.js';
12
+ import { createUpgradeCommand } from './commands/upgrade.js';
13
+ import { createLoadCommand } from './commands/load.js';
14
+ import { createMemoryCommand } from './commands/memory.js';
15
+ import { createKnowledgeCommand } from './commands/knowledge.js';
16
+ import { createPersonaCommand } from './commands/persona.js';
17
+ import { createTTSCommand } from './commands/tts.js';
18
+ import { createStrategyCommand } from './commands/strategy.js';
19
+ import { createHubCommand } from './commands/hub.js';
20
+ import { createSkillCommand } from './commands/skill.js';
21
+ import { createSetupCommand } from './commands/setup/index.js';
22
+ import { createConfigCommand } from './commands/config.js';
23
+ import { createSchemaCommand } from './commands/_schema.js';
24
+ import { createHistoryCommand } from './commands/history.js';
25
+ import { initHttpKeepAlive } from './lib/http-keepalive.js';
26
+ import { applyWorkspaceArgv } from './lib/workspace-argv.js';
27
+
28
+ initHttpKeepAlive();
29
+ applyWorkspaceArgv(process.argv, process.env);
30
+
31
+ // ─── Internal entry: _pipeline (forked by `do` command for multi-action sequences) ───
32
+ if (process.argv[2] === '_pipeline') {
33
+ const actions = JSON.parse(process.argv[3]);
34
+ const initialWaitMs = process.argv[4] ? Number(process.argv[4]) : 0;
35
+ const { runPipeline } = await import('./pipeline/pipeline.js');
36
+ await runPipeline(actions, initialWaitMs);
37
+ process.exit(0);
38
+ }
39
+
40
+ // ─── Internal entry: _strategy (spawned by `strategy` command) ───
41
+ if (process.argv[2] === '_strategy') {
42
+ const _logFile = process.env.CLAWCLAW_LOG_FILE;
43
+ const _earlyLog = (label: string, err: any) => {
44
+ const msg = `[${new Date().toISOString()}] [${label}] ${err?.stack ?? err}\n`;
45
+ if (_logFile) try { appendFileSync(_logFile, msg); } catch {}
46
+ try { process.stderr.write(msg); } catch {}
47
+ };
48
+ process.on('uncaughtException', (err) => { _earlyLog('FATAL', err); process.exit(1); });
49
+ process.on('unhandledRejection', (reason) => { _earlyLog('FATAL:unhandledRejection', reason); process.exit(1); });
50
+
51
+ const strategyId = process.argv[3];
52
+ const dashDashIdx = process.argv.indexOf('--');
53
+ const strategyArgs = dashDashIdx >= 0 ? process.argv.slice(dashDashIdx + 1) : [];
54
+ const { runStrategyLoop } = await import('./strategies/strategy-loop.js');
55
+ try {
56
+ await runStrategyLoop(strategyId, strategyArgs.length > 0 ? strategyArgs : undefined);
57
+ } catch (e: any) {
58
+ const { EventStore } = await import('./pipeline/event-store.js');
59
+ try { EventStore.forActiveAccount().append({ type: 'auto_fatal', error: e?.message ?? String(e), stack: e?.stack }); } catch {}
60
+ }
61
+ process.exit(0);
62
+ }
63
+
64
+ // ─── Normal CLI ───
65
+ const __filename = fileURLToPath(import.meta.url);
66
+ const __dirname = dirname(__filename);
67
+ const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
68
+
69
+ const program = new Command()
70
+ .name('clawclaw-cli')
71
+ .description('ClawClaw social deduction game CLI')
72
+ .version(pkg.version)
73
+ .option('--workspace-dir <dir>', 'workspace directory');
74
+
75
+ program.addCommand(createDoCommand());
76
+ program.addCommand(createStateCommand());
77
+ program.addCommand(createEventsCommand());
78
+ program.addCommand(createGameCommand());
79
+ program.addCommand(createAccountCommand());
80
+ program.addCommand(createLoadCommand());
81
+ program.addCommand(createMemoryCommand());
82
+ program.addCommand(createKnowledgeCommand());
83
+ program.addCommand(createPersonaCommand());
84
+ program.addCommand(createUpgradeCommand());
85
+ program.addCommand(createPeekCommand());
86
+ program.addCommand(createHistoryCommand());
87
+ program.addCommand(createTTSCommand(), { hidden: true }); // 暂时屏蔽:不在 help 中暴露,命令仍可执行(do -s 自动 TTS 依赖其 config)
88
+ program.addCommand(createStrategyCommand());
89
+ program.addCommand(createSkillCommand());
90
+ program.addCommand(createHubCommand());
91
+ program.addCommand(createSetupCommand());
92
+ program.addCommand(createConfigCommand());
93
+ program.addCommand(createSchemaCommand(() => program), { hidden: true });
94
+
95
+ try {
96
+ await program.parseAsync();
97
+ } catch (err) {
98
+ if (err instanceof ApiError) {
99
+ if (err.status === 422) {
100
+ console.info(`API key is missing or malformed. Run: clawclaw-cli account register`);
101
+ } else if (err.status === 401) {
102
+ console.info(`Account not found or API key expired. Run: clawclaw-cli account register`);
103
+ } else {
104
+ console.info(`Request failed (${err.status}): ${err.body}`);
105
+ }
106
+ } else {
107
+ console.error(err instanceof Error ? err.message : String(err));
108
+ }
109
+ process.exit(1);
110
+ }
@@ -1,109 +1,109 @@
1
- /**
2
- * `_schema` — internal hidden command exposing the entire commander tree as JSON.
3
- *
4
- * Adapter consumers (e.g. `openclaw-clawclaw`) call this to auto-generate one tool
5
- * per leaf subcommand without having to hand-translate each `ccl` command.
6
- *
7
- * Hidden by convention: name starts with `_` so the walker excludes it from output,
8
- * and `--help` listings of regular tooling generally skip underscore-prefixed entries.
9
- */
10
-
11
- import { Command, Option, Argument } from 'commander';
12
- import { getMeta, type CommandMeta } from '../lib/command-meta.js';
13
-
14
- interface OptionSchema {
15
- flags: string;
16
- long?: string | null;
17
- short?: string | null;
18
- attributeName: string;
19
- description?: string;
20
- defaultValue?: unknown;
21
- /** option marked with `<value>` — value required */
22
- required: boolean;
23
- /** option marked with `[value]` — value optional */
24
- optional: boolean;
25
- /** option marked with `.makeOptionMandatory()` — option itself required */
26
- mandatory: boolean;
27
- negate: boolean;
28
- takesValue: boolean;
29
- }
30
-
31
- interface ArgumentSchema {
32
- name: string;
33
- description?: string;
34
- required: boolean;
35
- variadic: boolean;
36
- defaultValue?: unknown;
37
- }
38
-
39
- interface CommandSchema {
40
- name: string;
41
- description?: string;
42
- aliases: string[];
43
- options: OptionSchema[];
44
- arguments: ArgumentSchema[];
45
- subcommands: CommandSchema[];
46
- /** path from root, joined by space, e.g. "account leaderboard" */
47
- path: string;
48
- /** true when the command has no subcommands and is therefore directly invocable */
49
- leaf: boolean;
50
- /** Adapter-facing metadata (omitted if no metadata is set on this command). */
51
- meta?: CommandMeta;
52
- }
53
-
54
- function dumpOption(o: Option): OptionSchema {
55
- const flags = o.flags;
56
- const takesValue = flags.includes('<') || flags.includes('[');
57
- return {
58
- flags,
59
- long: o.long ?? null,
60
- short: o.short ?? null,
61
- attributeName: o.attributeName(),
62
- description: o.description || undefined,
63
- defaultValue: o.defaultValue,
64
- required: o.required,
65
- optional: o.optional,
66
- mandatory: o.mandatory,
67
- negate: o.negate,
68
- takesValue,
69
- };
70
- }
71
-
72
- function dumpArgument(a: Argument): ArgumentSchema {
73
- return {
74
- name: a.name(),
75
- description: a.description || undefined,
76
- required: a.required,
77
- variadic: a.variadic,
78
- defaultValue: a.defaultValue,
79
- };
80
- }
81
-
82
- function walkCommand(cmd: Command, parentPath: string[] = []): CommandSchema {
83
- const path = [...parentPath, cmd.name()];
84
- const visibleSubs = (cmd.commands || []).filter((c) => !c.name().startsWith('_'));
85
- const meta = getMeta(cmd);
86
- return {
87
- name: cmd.name(),
88
- description: cmd.description() || undefined,
89
- aliases: cmd.aliases() ?? [],
90
- options: (cmd.options || []).map(dumpOption),
91
- arguments: (cmd.registeredArguments || []).map(dumpArgument),
92
- subcommands: visibleSubs.map((c) => walkCommand(c, path)),
93
- path: path.slice(1).join(' '), // exclude root program name from path
94
- leaf: visibleSubs.length === 0,
95
- ...(meta && Object.keys(meta).length > 0 ? { meta } : {}),
96
- };
97
- }
98
-
99
- export function createSchemaCommand(getProgram: () => Command): Command {
100
- return new Command('_schema')
101
- .description('[internal] dump full command tree as JSON for adapter auto-generation')
102
- .option('--pretty', 'Indent JSON output')
103
- .action((opts: { pretty?: boolean }) => {
104
- const tree = walkCommand(getProgram());
105
- console.log(JSON.stringify(tree, null, opts.pretty ? 2 : 0));
106
- });
107
- // Note: to hide from `ccl --help`, the parent passes { hidden: true } to addCommand().
108
- // See cli.ts registration site.
109
- }
1
+ /**
2
+ * `_schema` — internal hidden command exposing the entire commander tree as JSON.
3
+ *
4
+ * Adapter consumers (e.g. `openclaw-clawclaw`) call this to auto-generate one tool
5
+ * per leaf subcommand without having to hand-translate each `ccl` command.
6
+ *
7
+ * Hidden by convention: name starts with `_` so the walker excludes it from output,
8
+ * and `--help` listings of regular tooling generally skip underscore-prefixed entries.
9
+ */
10
+
11
+ import { Command, Option, Argument } from 'commander';
12
+ import { getMeta, type CommandMeta } from '../lib/command-meta.js';
13
+
14
+ interface OptionSchema {
15
+ flags: string;
16
+ long?: string | null;
17
+ short?: string | null;
18
+ attributeName: string;
19
+ description?: string;
20
+ defaultValue?: unknown;
21
+ /** option marked with `<value>` — value required */
22
+ required: boolean;
23
+ /** option marked with `[value]` — value optional */
24
+ optional: boolean;
25
+ /** option marked with `.makeOptionMandatory()` — option itself required */
26
+ mandatory: boolean;
27
+ negate: boolean;
28
+ takesValue: boolean;
29
+ }
30
+
31
+ interface ArgumentSchema {
32
+ name: string;
33
+ description?: string;
34
+ required: boolean;
35
+ variadic: boolean;
36
+ defaultValue?: unknown;
37
+ }
38
+
39
+ interface CommandSchema {
40
+ name: string;
41
+ description?: string;
42
+ aliases: string[];
43
+ options: OptionSchema[];
44
+ arguments: ArgumentSchema[];
45
+ subcommands: CommandSchema[];
46
+ /** path from root, joined by space, e.g. "account leaderboard" */
47
+ path: string;
48
+ /** true when the command has no subcommands and is therefore directly invocable */
49
+ leaf: boolean;
50
+ /** Adapter-facing metadata (omitted if no metadata is set on this command). */
51
+ meta?: CommandMeta;
52
+ }
53
+
54
+ function dumpOption(o: Option): OptionSchema {
55
+ const flags = o.flags;
56
+ const takesValue = flags.includes('<') || flags.includes('[');
57
+ return {
58
+ flags,
59
+ long: o.long ?? null,
60
+ short: o.short ?? null,
61
+ attributeName: o.attributeName(),
62
+ description: o.description || undefined,
63
+ defaultValue: o.defaultValue,
64
+ required: o.required,
65
+ optional: o.optional,
66
+ mandatory: o.mandatory,
67
+ negate: o.negate,
68
+ takesValue,
69
+ };
70
+ }
71
+
72
+ function dumpArgument(a: Argument): ArgumentSchema {
73
+ return {
74
+ name: a.name(),
75
+ description: a.description || undefined,
76
+ required: a.required,
77
+ variadic: a.variadic,
78
+ defaultValue: a.defaultValue,
79
+ };
80
+ }
81
+
82
+ function walkCommand(cmd: Command, parentPath: string[] = []): CommandSchema {
83
+ const path = [...parentPath, cmd.name()];
84
+ const visibleSubs = (cmd.commands || []).filter((c) => !c.name().startsWith('_'));
85
+ const meta = getMeta(cmd);
86
+ return {
87
+ name: cmd.name(),
88
+ description: cmd.description() || undefined,
89
+ aliases: cmd.aliases() ?? [],
90
+ options: (cmd.options || []).map(dumpOption),
91
+ arguments: (cmd.registeredArguments || []).map(dumpArgument),
92
+ subcommands: visibleSubs.map((c) => walkCommand(c, path)),
93
+ path: path.slice(1).join(' '), // exclude root program name from path
94
+ leaf: visibleSubs.length === 0,
95
+ ...(meta && Object.keys(meta).length > 0 ? { meta } : {}),
96
+ };
97
+ }
98
+
99
+ export function createSchemaCommand(getProgram: () => Command): Command {
100
+ return new Command('_schema')
101
+ .description('[internal] dump full command tree as JSON for adapter auto-generation')
102
+ .option('--pretty', 'Indent JSON output')
103
+ .action((opts: { pretty?: boolean }) => {
104
+ const tree = walkCommand(getProgram());
105
+ console.log(JSON.stringify(tree, null, opts.pretty ? 2 : 0));
106
+ });
107
+ // Note: to hide from `ccl --help`, the parent passes { hidden: true } to addCommand().
108
+ // See cli.ts registration site.
109
+ }