@myclaw163/clawclaw-cli 0.6.71 → 0.6.76

package/src/commands/strategy.ts

@@ -1,181 +1,183 @@
-import { Command } from 'commander';
-import { join } from 'path';
-import { GameClient } from '../lib/game-client.js';
-import { getProfileStateDir, getWorkspaceDir } from '../lib/init-command.js';
-import { AuthStore } from '../lib/auth.js';
-import { sendOwnerControlRequest } from '../runtime/owner-control.js';
-
-const KILL_STRATEGIES = new Set([
-  'kill-frenzy', 'kill-lone', 'kill-target', 'warrior-memory',
-  'crab-sabotage', 'lone-kill-task', 'task-kill-report',
-]);
-const KILL_CAPABLE_ROLES = new Set([
-  'crab_generic', 'shrimp_warrior', 'shrimp_pistol', 'neutral_octopus',
-]);
-
-export function createStrategyCommand(): Command {
-  const cmd = new Command('strategy')
-    .alias('stg')
-    .description('Run a named strategy, or manage exported strategies')
-    .argument('[name]', 'Strategy name to start')
-    .argument('[args...]', 'Strategy arguments')
-    .option('--list', 'List all available strategies')
-    .option('--stop', 'Stop any running strategy')
-    .option('--info <id>', 'Show a strategy\'s knowledge contract')
-    .option('--export <id>', 'Export an official strategy to workspace for customization')
-    .option('--force', 'Force overwrite if strategy file already exists (use with --export)')
-    .allowUnknownOption()
-    .addHelpText('after', () => {
-      const strategiesDir = join(getWorkspaceDir(), 'strategies');
-      return `
-Custom strategies:
-  Place .ts or .js files in ${strategiesDir}
-  (or $CLAWCLAW_WORKSPACE_DIR/strategies/)
-  Each file must export a 'strategy' object with id, name (中文别名), description, and create() function.
-  Use 'import { ... } from "@myclaw163/clawclaw-cli"' to access Action, GameState, and utilities.
-  See docs/自定义策略.md for full API reference and examples.
-`;
-    })
-    .action(async (name: string | undefined, args: string[], opts: { list?: boolean; stop?: boolean; info?: string; export?: string; force?: boolean }) => {
-      if (opts.info) {
-        const { getStrategyEntry, getStrategyKnowledgeDoc, listStrategyEntries } = await import('../strategies/loader.js');
-        const entry = await getStrategyEntry(opts.info);
-        if (!entry) {
-          const available = await listStrategyEntries();
-          console.error(JSON.stringify({
-            error: 'unknown_strategy',
-            message: `Unknown strategy '${opts.info}'.`,
-            available: available.map(e => e.id),
-          }, null, 2));
-          process.exit(1);
-        }
-        const knowledge = await getStrategyKnowledgeDoc(entry.id);
-        console.log(JSON.stringify({ id: entry.id, name: entry.name ?? entry.id, description: entry.description, knowledge: knowledge ?? null }, null, 2));
-        return;
-      }
-
-      if (opts.export) {
-        try {
-          const { exportStrategy } = await import('../lib/strategy-export.js');
-          await exportStrategy(opts.export, { force: opts.force ?? false });
-          console.log(JSON.stringify({ message: `Strategy '${opts.export}' exported to workspace.`, path: `${opts.export}.ts` }, null, 2));
-        } catch (err: any) {
-          console.error(JSON.stringify({ error: 'export_failed', message: err?.message ?? String(err) }, null, 2));
-          process.exit(1);
-        }
-
-        // After exporting, check if there are other stale strategies.
-        try {
-          const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
-          const staleIds = detectStaleOfficialStrategies().filter(id => id !== opts.export);
-          if (staleIds.length > 0) {
-            const ids = staleIds.join(', ');
-            console.error(`[提示] 还有其他官方策略有更新 (${ids})，运行 \`ccl strategy --export <id> --force\` 重新导出`);
-          }
-        } catch {
-          // Silently ignore
-        }
-
-        return;
-      }
-
-      if (opts.list) {
-        const { listStrategyEntries } = await import('../strategies/loader.js');
-        const entries = await listStrategyEntries();
-        if (entries.length === 0) {
-          console.log(JSON.stringify({ strategies: [], message: 'No strategies found.' }, null, 2));
-          return;
-        }
-        console.log(JSON.stringify({
-          strategies: entries.map(e => ({ id: e.id, name: e.name ?? e.id, description: e.description })),
-        }, null, 2));
-        return;
-      }
-
-      if (opts.stop) {
-        const profile = new AuthStore().getActive();
-        const response = profile
-          ? await sendOwnerControlRequest(getProfileStateDir(profile), 'stop_strategy')
-          : null;
-        if (!response?.ok) {
-          console.error(JSON.stringify({
-            error: 'no_game_start_owner',
-            message: 'No active ccl game start owner is available to stop strategy.',
-          }, null, 2));
-          process.exit(1);
-        }
-        console.log(JSON.stringify({ message: 'Strategy stopped.' }, null, 2));
-        return;
-      }
-
-      if (!name) {
-        cmd.help();
-        return;
-      }
-
-      const { listStrategyEntries, getStrategyEntry } = await import('../strategies/loader.js');
-      const entry = await getStrategyEntry(name);
-      if (!entry) {
-        const available = await listStrategyEntries();
-        console.error(JSON.stringify({
-          error: 'unknown_strategy',
-          message: `Unknown strategy '${name}'.`,
-          available: available.map(e => ({ id: e.id, name: e.name ?? e.id, description: e.description })),
-        }, null, 2));
-        process.exit(1);
-      }
-
-      try {
-        entry.create(args.length > 0 ? args : undefined);
-      } catch (err: any) {
-        console.error(JSON.stringify({
-          error: 'strategy_create_failed',
-          message: err?.message ?? String(err),
-          strategy: name,
-        }, null, 2));
-        process.exit(1);
-      }
-
-      if (KILL_STRATEGIES.has(entry.id)) {
-        try {
-          const client = GameClient.fromAuth();
-          await client.discoverGameServer();
-          const roleInfo = await client.getRoleInfo();
-          const role: string = roleInfo?.data?.role ?? roleInfo?.role ?? '';
-          const displayName: string = roleInfo?.data?.display_name ?? role;
-          if (role && !KILL_CAPABLE_ROLES.has(role)) {
-            console.error(JSON.stringify({
-              error: 'role_incompatible',
-              message: `Strategy '${entry.id}' requires kill ability, but your role '${displayName}' (${role}) cannot kill. Use a non-kill strategy like task-report, patrol, or report-patrol.`,
-              strategy: entry.id,
-              role,
-            }, null, 2));
-            process.exit(1);
-          }
-        } catch {}
-      }
-
-      const profile = new AuthStore().getActive();
-      const response = profile
-        ? await sendOwnerControlRequest(getProfileStateDir(profile), 'switch_strategy', {
-          strategy: entry.id,
-          args: args.length > 0 ? args : undefined,
-        })
-        : null;
-      if (!response?.ok) {
-        console.error(JSON.stringify({
-          error: 'no_game_start_owner',
-          message: 'Run `ccl game start` before switching strategy; strategy processes are owned by the game start runtime.',
-        }, null, 2));
-        process.exit(1);
-      }
-      console.log(JSON.stringify({
-        message: `Strategy started: ${entry.id}`,
-        name: entry.name ?? entry.id,
-        description: entry.description,
-        pid: response.pid,
-      }, null, 2));
-    });
-
-  return cmd;
-}
+import { Command, Option } from 'commander';
+import { GameClient } from '../lib/game-client.js';
+import { getProfileStateDir, getWorkspaceDir } from '../lib/init-command.js';
+import { AuthStore } from '../lib/auth.js';
+import { sendOwnerControlRequest } from '../runtime/owner-control.js';
+import { ensureUserDataLayout, getUserDataStrategiesDir } from '../lib/user-data.js';
+
+const KILL_STRATEGIES = new Set([
+  'kill-frenzy', 'kill-lone', 'kill-target', 'warrior-memory',
+  'crab-sabotage', 'lone-kill-task', 'task-kill-report',
+]);
+const KILL_CAPABLE_ROLES = new Set([
+  'crab_generic', 'shrimp_warrior', 'shrimp_pistol', 'neutral_octopus',
+]);
+
+export function createStrategyCommand(): Command {
+  const cmd = new Command('strategy')
+    .alias('stg')
+    .description('Run a named strategy, or manage exported strategies')
+    .argument('[name]', 'Strategy name to start')
+    .argument('[args...]', 'Strategy arguments')
+    .option('--list', 'List all available strategies')
+    .addOption(new Option('--stop', 'Stop any running strategy').hideHelp())
+    .option('--info <id>', 'Show a strategy\'s knowledge contract')
+    .addOption(new Option('--export <id>', 'Export an official strategy to workspace for customization').hideHelp())
+    .addOption(new Option('--force', 'Force overwrite if strategy file already exists (use with --export)').hideHelp())
+    .allowUnknownOption()
+    .addHelpText('after', () => {
+      const workspaceDir = getWorkspaceDir();
+      ensureUserDataLayout(workspaceDir);
+      const strategiesDir = getUserDataStrategiesDir(workspaceDir);
+      return `
+Custom strategies:
+  Place .ts or .js files in ${strategiesDir}
+  (or $CLAWCLAW_WORKSPACE_DIR/user-data/strategies/)
+  Each file must export a 'strategy' object with id, name (中文别名), description, and create() function.
+  Use 'import { ... } from "@myclaw163/clawclaw-cli"' to access Action, GameState, and utilities.
+  See docs/自定义策略.md for full API reference and examples.
+`;
+    })
+    .action(async (name: string | undefined, args: string[], opts: { list?: boolean; stop?: boolean; info?: string; export?: string; force?: boolean }) => {
+      if (opts.info) {
+        const { getStrategyEntry, getStrategyKnowledgeDoc, listStrategyEntries } = await import('../strategies/loader.js');
+        const entry = await getStrategyEntry(opts.info);
+        if (!entry) {
+          const available = await listStrategyEntries();
+          console.error(JSON.stringify({
+            error: 'unknown_strategy',
+            message: `Unknown strategy '${opts.info}'.`,
+            available: available.map(e => e.id),
+          }, null, 2));
+          process.exit(1);
+        }
+        const knowledge = await getStrategyKnowledgeDoc(entry.id);
+        console.log(JSON.stringify({ id: entry.id, name: entry.name ?? entry.id, description: entry.description, knowledge: knowledge ?? null }, null, 2));
+        return;
+      }
+
+      if (opts.export) {
+        try {
+          const { exportStrategy } = await import('../lib/strategy-export.js');
+          await exportStrategy(opts.export, { force: opts.force ?? false });
+          console.log(JSON.stringify({ message: `Strategy '${opts.export}' exported to user-data strategies.`, path: `${opts.export}.ts` }, null, 2));
+        } catch (err: any) {
+          console.error(JSON.stringify({ error: 'export_failed', message: err?.message ?? String(err) }, null, 2));
+          process.exit(1);
+        }
+
+        // After exporting, check if there are other stale strategies.
+        try {
+          const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
+          const staleIds = detectStaleOfficialStrategies().filter(id => id !== opts.export);
+          if (staleIds.length > 0) {
+            const ids = staleIds.join(', ');
+            console.error(`[提示] 还有其他官方策略有更新 (${ids})，运行 \`ccl strategy --export <id> --force\` 重新导出`);
+          }
+        } catch {
+          // Silently ignore
+        }
+
+        return;
+      }
+
+      if (opts.list) {
+        const { listStrategyEntries } = await import('../strategies/loader.js');
+        const entries = await listStrategyEntries();
+        if (entries.length === 0) {
+          console.log(JSON.stringify({ strategies: [], message: 'No strategies found.' }, null, 2));
+          return;
+        }
+        console.log(JSON.stringify({
+          strategies: entries.map(e => ({ id: e.id, name: e.name ?? e.id, description: e.description })),
+        }, null, 2));
+        return;
+      }
+
+      if (opts.stop) {
+        const profile = new AuthStore().getActive();
+        const response = profile
+          ? await sendOwnerControlRequest(getProfileStateDir(profile), 'stop_strategy')
+          : null;
+        if (!response?.ok) {
+          console.error(JSON.stringify({
+            error: 'no_game_start_owner',
+            message: 'No active ccl game start owner is available to stop strategy.',
+          }, null, 2));
+          process.exit(1);
+        }
+        console.log(JSON.stringify({ message: 'Strategy stopped.' }, null, 2));
+        return;
+      }
+
+      if (!name) {
+        cmd.help();
+        return;
+      }
+
+      const { listStrategyEntries, getStrategyEntry } = await import('../strategies/loader.js');
+      const entry = await getStrategyEntry(name);
+      if (!entry) {
+        const available = await listStrategyEntries();
+        console.error(JSON.stringify({
+          error: 'unknown_strategy',
+          message: `Unknown strategy '${name}'.`,
+          available: available.map(e => ({ id: e.id, name: e.name ?? e.id, description: e.description })),
+        }, null, 2));
+        process.exit(1);
+      }
+
+      try {
+        entry.create(args.length > 0 ? args : undefined);
+      } catch (err: any) {
+        console.error(JSON.stringify({
+          error: 'strategy_create_failed',
+          message: err?.message ?? String(err),
+          strategy: name,
+        }, null, 2));
+        process.exit(1);
+      }
+
+      if (KILL_STRATEGIES.has(entry.id)) {
+        try {
+          const client = GameClient.fromAuth();
+          await client.discoverGameServer();
+          const roleInfo = await client.getRoleInfo();
+          const role: string = roleInfo?.data?.role ?? roleInfo?.role ?? '';
+          const displayName: string = roleInfo?.data?.display_name ?? role;
+          if (role && !KILL_CAPABLE_ROLES.has(role)) {
+            console.error(JSON.stringify({
+              error: 'role_incompatible',
+              message: `Strategy '${entry.id}' requires kill ability, but your role '${displayName}' (${role}) cannot kill. Use a non-kill strategy like task-report, patrol, or report-patrol.`,
+              strategy: entry.id,
+              role,
+            }, null, 2));
+            process.exit(1);
+          }
+        } catch {}
+      }
+
+      const profile = new AuthStore().getActive();
+      const response = profile
+        ? await sendOwnerControlRequest(getProfileStateDir(profile), 'switch_strategy', {
+          strategy: entry.id,
+          args: args.length > 0 ? args : undefined,
+        })
+        : null;
+      if (!response?.ok) {
+        console.error(JSON.stringify({
+          error: 'no_game_start_owner',
+          message: 'Run `ccl game start` before switching strategy; strategy processes are owned by the game start runtime.',
+        }, null, 2));
+        process.exit(1);
+      }
+      console.log(JSON.stringify({
+        message: `Strategy started: ${entry.id}`,
+        name: entry.name ?? entry.id,
+        description: entry.description,
+        pid: response.pid,
+      }, null, 2));
+    });
+
+  return cmd;
+}