refactor: infer flags type from options definition in defineCommand

Generify CommandSpec and defineCommand so the `run` callback's `flags`
parameter is typed as `GlobalFlags & InferFlags<Options>`, where
InferFlags derives typed properties from the command's `options` array.

This removes ~150 manual `as string` / `as number` / `as string[]`
type assertions across 46 command files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lishengzxc

packages/cli/src/args.ts

@@ -147,14 +147,12 @@ export function parseFlags(argv: string[], options: OptionDef[]): GlobalFlags {
         );
       }
 
-      // Switch-style flags (--quiet, --dry-run): no value. Value flags need a non-flag next token.
       if (schema.booleans.has(camelKey)) {
         (flags as Record<string, unknown>)[camelKey] = true;
         i++;
         continue;
       }
 
-      // --prompt <text>, --watermark <bool>, …
       if (value === undefined) {
         i++;
         const next = argv[i];

packages/cli/src/commands/advisor/recommend.ts

@@ -1,11 +1,9 @@
 import {
   analyzeIntent,
   buildDocLink,
-  type Config,
   defineCommand,
   detectOutputFormat,
   type GetModelsOptions,
-  type GlobalFlags,
   getModels,
   type IntentProfile,
   isInteractive,
@@ -241,9 +239,9 @@ export default defineCommand({
     'bl advisor recommend --message "Long document summarization" --dry-run',
     "bl advisor recommend                                          # Interactive input",
   ],
-  async run(config: Config, flags: GlobalFlags) {
+  async run(config, flags) {
     const positional = ((flags as Record<string, unknown>)._positional as string[]) ?? [];
-    let userInput = (flags.message as string) || positional.join(" ");
+    let userInput = flags.message || positional.join(" ");
 
     if (!userInput.trim()) {
       if (isInteractive({ nonInteractive: config.nonInteractive })) {

packages/cli/src/commands/app/call.ts

@@ -5,8 +5,6 @@ import {
   appCompletionEndpoint,
   parseSSE,
   detectOutputFormat,
-  type Config,
-  type GlobalFlags,
   type AppCompletionRequest,
   type AppStreamChunk,
   type AppCompletionResponse,
@@ -42,11 +40,11 @@ export default defineCommand({
     'bl app call --app-id abc123 --prompt "搜索资料" --pipeline-ids pipe1,pipe2',
     'bl app call --app-id abc123 --prompt "开始" --biz-params \'{"key":"value"}\'',
   ],
-  async run(config: Config, flags: GlobalFlags) {
-    const appId = flags.appId as string;
+  async run(config, flags) {
+    const appId = flags.appId;
     if (!appId) failIfMissing("app-id", "bl app call --app-id <id> --prompt <text>");
 
-    const prompt = flags.prompt as string;
+    const prompt = flags.prompt;
     if (!prompt) failIfMissing("prompt", "bl app call --app-id <id> --prompt <text>");
 
     const shouldStream =
@@ -61,17 +59,17 @@ export default defineCommand({
     };
 
     if (flags.sessionId) {
-      body.input.session_id = flags.sessionId as string;
+      body.input.session_id = flags.sessionId;
     }
 
     // Pass image URLs via image_list
-    const imageUrls = flags.image as string[] | undefined;
+    const imageUrls = flags.image;
     if (imageUrls && imageUrls.length > 0) {
       body.input.image_list = imageUrls;
     }
 
     // Pass pre-uploaded file IDs
-    const fileIds = flags.fileId as string[] | undefined;
+    const fileIds = flags.fileId;
     if (fileIds && fileIds.length > 0) {
       body.input.file_ids = fileIds;
     }
@@ -81,20 +79,20 @@ export default defineCommand({
     }
 
     if (flags.pipelineIds) {
-      const ids = (flags.pipelineIds as string)
+      const ids = flags.pipelineIds
         .split(",")
         .map((s) => s.trim())
         .filter(Boolean);
       body.parameters!.rag_options = { pipeline_ids: ids };
     }
 
     if (flags.memoryId) {
-      body.parameters!.memory_id = flags.memoryId as string;
+      body.parameters!.memory_id = flags.memoryId;
     }
 
     if (flags.bizParams) {
       try {
-        body.input.biz_params = JSON.parse(flags.bizParams as string);
+        body.input.biz_params = JSON.parse(flags.bizParams);
       } catch {
         process.stderr.write("Error: --biz-params must be valid JSON\n");
         process.exit(1);

packages/cli/src/commands/app/list.ts

@@ -3,8 +3,6 @@ import {
   callConsoleGateway,
   resolveConsoleGatewayCredential,
   detectOutputFormat,
-  type Config,
-  type GlobalFlags,
 } from "bailian-cli-core";
 import { emitResult } from "../../output/output.ts";
 
@@ -46,10 +44,10 @@ export default defineCommand({
     "bl app list --page 2 --page-size 10",
     "bl app list --output json",
   ],
-  async run(config: Config, flags: GlobalFlags) {
-    const name = (flags.name as string) || "";
-    const pageNo = (flags.page as number) || 1;
-    const pageSize = (flags.pageSize as number) || 30;
+  async run(config, flags) {
+    const name = flags.name || "";
+    const pageNo = flags.page || 1;
+    const pageSize = flags.pageSize || 30;
     const format = detectOutputFormat(config.output);
 
     const credential = await resolveConsoleGatewayCredential(config);

packages/cli/src/commands/auth/login.ts

@@ -4,8 +4,6 @@ import {
   maskToken,
   readConfigFile,
   writeConfigFile,
-  type Config,
-  type GlobalFlags,
 } from "bailian-cli-core";
 import { printQuickStart } from "../../output/banner.ts";
 import { emitBare } from "../../output/output.ts";
@@ -34,7 +32,7 @@ export default defineCommand({
     },
   ],
   examples: ["bl auth login --api-key sk-xxxxx", "bl auth login --console"],
-  async run(config: Config, flags: GlobalFlags) {
+  async run(config, flags) {
     if (flags.console) {
       if (config.dryRun) {
         emitBare(
@@ -66,13 +64,13 @@ export default defineCommand({
       }
     }
 
-    const key = (flags.apiKey as string) || config.apiKey;
+    const key = flags.apiKey || config.apiKey;
     if (!key) {
       printCurrentCommandHelp(process.stderr);
       process.exit(0);
     }
 
-    const baseUrl = (flags.baseUrl as string) || undefined;
+    const baseUrl = flags.baseUrl || undefined;
     const effectiveConfig = baseUrl ? { ...config, baseUrl } : config;
 
     if (!config.dryRun) {

packages/cli/src/commands/auth/logout.ts

@@ -4,8 +4,6 @@ import {
   readConfigFile,
   writeConfigFile,
   getConfigPath,
-  type Config,
-  type GlobalFlags,
 } from "bailian-cli-core";
 import { emitBare } from "../../output/output.ts";
 
@@ -35,7 +33,7 @@ export default defineCommand({
     "bl auth logout --dry-run",
     "bl auth logout --yes",
   ],
-  async run(config: Config, flags: GlobalFlags) {
+  async run(config, flags) {
     const file = readConfigFile();
 
     if (flags.console) {

packages/cli/src/commands/auth/status.ts

@@ -5,7 +5,6 @@ import {
   detectOutputFormat,
   maskToken,
   type Config,
-  type GlobalFlags,
   type ResolvedCredential,
 } from "bailian-cli-core";
 import { emitResult, emitBare } from "../../output/output.ts";
@@ -155,7 +154,7 @@ export default defineCommand({
     },
   ],
   examples: ["bl auth status", "bl auth status --output json"],
-  async run(config: Config, _flags: GlobalFlags) {
+  async run(config, _flags) {
     const format = detectOutputFormat(config.output);
     const status = await buildStatus(config);
 

packages/cli/src/commands/config/export-schema.ts

@@ -1,6 +1,4 @@
 import { defineCommand, generateToolSchema } from "bailian-cli-core";
-import type { Config } from "bailian-cli-core";
-import type { GlobalFlags } from "bailian-cli-core";
 import { BailianError } from "bailian-cli-core";
 import { ExitCode } from "bailian-cli-core";
 
@@ -21,9 +19,9 @@ export default defineCommand({
     },
   ],
   examples: ["bl config export-schema", 'bl config export-schema --command "video generate"'],
-  async run(config: Config, flags: GlobalFlags) {
+  async run(config, flags) {
     const { commands } = await import("../catalog.ts");
-    const targetCommand = flags.command as string | undefined;
+    const targetCommand = flags.command;
 
     if (targetCommand) {
       const command = commands[targetCommand];

packages/cli/src/commands/config/set.ts

@@ -5,8 +5,6 @@ import {
   readConfigFile,
   writeConfigFile,
   BailianError,
-  type Config,
-  type GlobalFlags,
   ExitCode,
 } from "bailian-cli-core";
 import { emitResult } from "../../output/output.ts";
@@ -67,9 +65,9 @@ export default defineCommand({
     "bl config set --key timeout --value 600",
     "bl config set --key base_url --value https://dashscope.aliyuncs.com",
   ],
-  async run(config: Config, flags: GlobalFlags) {
-    const key = flags.key as string | undefined;
-    const value = flags.value as string | undefined;
+  async run(config, flags) {
+    const key = flags.key;
+    const value = flags.value;
 
     if (!key || value === undefined) {
       throw new BailianError(

packages/cli/src/commands/config/show.ts

@@ -4,8 +4,6 @@ import {
   getConfigPath,
   detectOutputFormat,
   maskToken,
-  type Config,
-  type GlobalFlags,
 } from "bailian-cli-core";
 import { emitResult } from "../../output/output.ts";
 
@@ -14,7 +12,7 @@ export default defineCommand({
   description: "Display current configuration",
   usage: "bl config show",
   examples: ["bl config show", "bl config show --output json"],
-  async run(config: Config, _flags: GlobalFlags) {
+  async run(config, _flags) {
     const file = loadConfigFile();
     const format = detectOutputFormat(config.output);