pqm-cli 1.0.0

package/src/commands/ai.js

@@ -0,0 +1,317 @@
+import chalk from 'chalk';
+import { logger } from '../utils/logger.js';
+import { Spinner } from '../utils/spinner.js';
+import {
+  loadGlobalConfig,
+  saveGlobalConfig,
+  getAIConfig,
+  updateAIConfig,
+  isAIConfigured,
+  CONFIG_FILE
+} from '../config/global.js';
+import { createProvider, getSupportedProviders } from '../ai/index.js';
+import { promptUser, select, promptPassword } from '../utils/prompt.js';
+
+export default function (program) {
+  const aiCmd = program
+    .command('ai')
+    .description('AI Provider 配置管理');
+
+  // ai config - Interactive configuration
+  aiCmd
+    .command('config')
+    .description('交互式配置 AI Provider')
+    .option('--list', '查看当前配置')
+    .action(async (options) => {
+      if (options.list) {
+        await showCurrentConfig();
+        return;
+      }
+
+      await interactiveConfig();
+    });
+
+  // ai status - Check connection status
+  aiCmd
+    .command('status')
+    .description('检查 AI Provider 连接状态')
+    .action(async () => {
+      await checkStatus();
+    });
+
+  // ai providers - List supported providers
+  aiCmd
+    .command('providers')
+    .description('列出支持的 AI Provider')
+    .action(async () => {
+      await listProviders();
+    });
+
+  // ai set - Quick set config
+  aiCmd
+    .command('set <key> <value>')
+    .description('设置配置值')
+    .action(async (key, value) => {
+      await setConfigValue(key, value);
+    });
+}
+
+/**
+ * Show current AI configuration
+ */
+async function showCurrentConfig() {
+  const config = loadGlobalConfig();
+  const aiConfig = config.ai || {};
+
+  console.log('');
+  console.log(chalk.bold('当前 AI 配置:'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(`  Provider:    ${aiConfig.provider || '(未设置)'}`);
+  console.log(`  Model:       ${aiConfig.model || '(未设置)'}`);
+  console.log(`  API Key:     ${aiConfig.apiKey ? maskAPIKey(aiConfig.apiKey) : '(未设置)'}`);
+  console.log(`  Enabled:     ${aiConfig.enabled !== false ? '是' : '否'}`);
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(`  配置文件: ${CONFIG_FILE}`);
+  console.log('');
+}
+
+/**
+ * Interactive configuration
+ */
+async function interactiveConfig() {
+  console.log('');
+  console.log(chalk.bold('🤖 AI Provider 配置向导'));
+  console.log('');
+
+  const providers = getSupportedProviders();
+
+  // Step 1: Select provider
+  console.log(chalk.cyan('步骤 1: 选择 AI Provider'));
+  console.log('');
+
+  providers.forEach((p, index) => {
+    const freeText = p.free ? chalk.green(' (免费额度)') : '';
+    console.log(`  ${index + 1}. ${chalk.white(p.displayName)}${freeText}`);
+    console.log(`     ${chalk.gray(p.description)}`);
+    console.log(`     ${chalk.gray('支持模型: ' + p.models.join(', '))}`);
+    console.log('');
+  });
+
+  const providerAnswer = await promptUser('请输入序号', '1');
+  const providerIndex = parseInt(providerAnswer, 10) - 1;
+
+  if (isNaN(providerIndex) || providerIndex < 0 || providerIndex >= providers.length) {
+    logger.error('无效的选择');
+    return;
+  }
+
+  const selectedProvider = providers[providerIndex];
+  console.log('');
+  console.log(chalk.green(`已选择: ${selectedProvider.displayName}`));
+  console.log('');
+
+  // Step 2: Enter API Key
+  console.log(chalk.cyan('步骤 2: 输入 API Key'));
+  console.log('');
+  console.log(chalk.gray(`获取 API Key: ${selectedProvider.website}`));
+  console.log('');
+
+  const apiKey = await promptPassword(`请输入 ${selectedProvider.displayName} API Key`);
+
+  if (!apiKey || apiKey.trim() === '') {
+    logger.error('API Key 不能为空');
+    return;
+  }
+
+  // Step 3: Select model
+  console.log('');
+  console.log(chalk.cyan('步骤 3: 选择模型'));
+  console.log('');
+
+  selectedProvider.models.forEach((model, index) => {
+    const isDefault = model === selectedProvider.defaultModel;
+    const marker = isDefault ? chalk.green(' (推荐)') : '';
+    console.log(`  ${index + 1}. ${model}${marker}`);
+  });
+
+  console.log('');
+  const modelAnswer = await promptUser('请输入序号', '1');
+  const modelIndex = parseInt(modelAnswer, 10) - 1;
+
+  let selectedModel;
+  if (isNaN(modelIndex) || modelIndex < 0 || modelIndex >= selectedProvider.models.length) {
+    selectedModel = selectedProvider.defaultModel;
+  } else {
+    selectedModel = selectedProvider.models[modelIndex];
+  }
+
+  console.log('');
+  console.log(chalk.green(`已选择模型: ${selectedModel}`));
+  console.log('');
+
+  // Step 4: Confirm
+  console.log(chalk.cyan('步骤 4: 确认配置'));
+  console.log('');
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log(`  Provider:  ${selectedProvider.displayName}`);
+  console.log(`  Model:     ${selectedModel}`);
+  console.log(`  API Key:   ${maskAPIKey(apiKey)}`);
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log('');
+
+  const confirm = await promptUser('确认保存配置? (y/N)', 'y');
+
+  if (confirm.toLowerCase() !== 'y') {
+    logger.info('配置已取消');
+    return;
+  }
+
+  // Save configuration
+  updateAIConfig({
+    provider: selectedProvider.name,
+    apiKey: apiKey.trim(),
+    model: selectedModel,
+    enabled: true
+  });
+
+  // Try to validate
+  console.log('');
+  const spinner = new Spinner('正在验证 API 连接...').start();
+
+  try {
+    const provider = createProvider(selectedProvider.name, {
+      apiKey: apiKey.trim(),
+      model: selectedModel
+    });
+
+    const isValid = await provider.validateConfig();
+
+    if (isValid) {
+      spinner.succeed(chalk.green('API 连接验证成功'));
+    } else {
+      spinner.warn(chalk.yellow('API 连接验证失败，请检查 API Key'));
+    }
+  } catch (error) {
+    spinner.warn(chalk.yellow(`验证出错: ${error.message}`));
+  }
+
+  console.log('');
+  logger.success(`配置已保存到: ${CONFIG_FILE}`);
+  console.log('');
+}
+
+/**
+ * Check AI connection status
+ */
+async function checkStatus() {
+  console.log('');
+  console.log(chalk.bold('🔍 AI Provider 状态检查'));
+  console.log('');
+
+  const aiConfig = getAIConfig();
+
+  if (!aiConfig || !aiConfig.apiKey) {
+    logger.warn('尚未配置 AI Provider');
+    console.log('');
+    console.log(chalk.gray('运行 pqm ai config 进行配置'));
+    console.log('');
+    return;
+  }
+
+  console.log(`Provider: ${aiConfig.provider}`);
+  console.log(`Model:    ${aiConfig.model}`);
+  console.log('');
+
+  const spinner = new Spinner('正在连接...').start();
+
+  try {
+    const provider = createProvider(aiConfig.provider, {
+      apiKey: aiConfig.apiKey,
+      model: aiConfig.model
+    });
+
+    const isValid = await provider.validateConfig();
+
+    if (isValid) {
+      spinner.succeed(chalk.green('连接成功'));
+    } else {
+      spinner.fail(chalk.red('连接失败'));
+      console.log('');
+      console.log(chalk.yellow('可能的原因:'));
+      console.log('  - API Key 无效或已过期');
+      console.log('  - 网络连接问题');
+      console.log('  - API 服务不可用');
+    }
+  } catch (error) {
+    spinner.fail(chalk.red('连接失败'));
+    console.log('');
+    console.log(chalk.red(`错误: ${error.message}`));
+  }
+
+  console.log('');
+}
+
+/**
+ * List supported providers
+ */
+async function listProviders() {
+  console.log('');
+  console.log(chalk.bold('📋 支持的 AI Provider'));
+  console.log('');
+
+  const providers = getSupportedProviders();
+
+  providers.forEach(p => {
+    const freeText = p.free ? chalk.green(' ✓ 免费') : '';
+    console.log(`  ${chalk.cyan(p.displayName)}${freeText}`);
+    console.log(`    ${chalk.gray(p.description)}`);
+    console.log(`    默认模型: ${p.defaultModel}`);
+    console.log(`    支持模型: ${p.models.join(', ')}`);
+    console.log(`    获取 API Key: ${p.website}`);
+    console.log('');
+  });
+}
+
+/**
+ * Set configuration value
+ */
+async function setConfigValue(key, value) {
+  const validKeys = ['provider', 'model', 'apiKey', 'enabled'];
+
+  if (!validKeys.includes(key)) {
+    logger.error(`无效的配置项: ${key}`);
+    console.log('');
+    console.log(`有效的配置项: ${validKeys.join(', ')}`);
+    return;
+  }
+
+  const config = loadGlobalConfig();
+
+  if (!config.ai) {
+    config.ai = {};
+  }
+
+  // Handle boolean values
+  if (value === 'true') {
+    config.ai[key] = true;
+  } else if (value === 'false') {
+    config.ai[key] = false;
+  } else {
+    config.ai[key] = value;
+  }
+
+  saveGlobalConfig(config);
+  logger.success(`已设置 ${key} = ${key === 'apiKey' ? maskAPIKey(value) : value}`);
+}
+
+/**
+ * Mask API key for display
+ * @param {string} key - API key
+ * @returns {string} Masked key
+ */
+function maskAPIKey(key) {
+  if (!key || key.length < 8) {
+    return '****';
+  }
+  return key.substring(0, 4) + '****' + key.substring(key.length - 4);
+}

package/src/commands/build.js

@@ -0,0 +1,24 @@
+import { logger } from '../utils/logger.js';
+
+export default function (program) {
+  program
+    .command('build')
+    .description('Trigger a manual build')
+    .option('-t, --tool <tool>', 'Build tool (vite/rollup)', 'vite')
+    .option('-m, --mode <mode>', 'Build mode (development/production)', 'production')
+    .action(async (options) => {
+      logger.info(`Starting build with ${options.tool}...`);
+
+      try {
+        const { buildProject } = await import('../core/builder.js');
+        await buildProject({
+          tool: options.tool,
+          mode: options.mode
+        });
+        logger.success('Build completed successfully');
+      } catch (err) {
+        logger.error(`Build failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}

package/src/commands/commit.js

@@ -0,0 +1,68 @@
+import { execSync } from 'child_process';
+import { logger } from '../utils/logger.js';
+
+export default function (program) {
+  program
+    .command('commit [message]')
+    .description('Commit and push changes to git')
+    .option('-m, --message <message>', 'Commit message')
+    .action((message, options) => {
+      const commitMessage = message || options.message;
+
+      if (!commitMessage) {
+        logger.error('请提供提交信息');
+        console.log('用法: pqm commit "提交信息"');
+        process.exit(1);
+      }
+
+      // 检查是否有远程仓库
+      const remoteUrl = execSync('git remote get-url origin 2>/dev/null', {
+        encoding: 'utf8'
+      }).trim();
+
+      if (!remoteUrl) {
+        logger.error('未配置远程仓库');
+        process.exit(1);
+      }
+
+      // 获取当前分支
+      const branch = execSync('git branch --show-current', {
+        encoding: 'utf8'
+      }).trim();
+
+      logger.info(`远程: ${remoteUrl}`);
+      logger.info(`分支: ${branch}`);
+
+      // 检查是否有变更
+      const status = execSync('git status --porcelain', {
+        encoding: 'utf8'
+      }).trim();
+
+      if (!status) {
+        logger.warn('没有变更需要提交');
+        process.exit(0);
+      }
+
+      console.log('\n变更文件:');
+      status.split('\n').forEach(line => {
+        console.log(`  ${line}`);
+      });
+
+      // 执行提交
+      try {
+        logger.info('执行: git add .');
+        execSync('git add .', { stdio: 'inherit' });
+
+        logger.info(`执行: git commit -m "${commitMessage}"`);
+        execSync(`git commit -m "${commitMessage}"`, { stdio: 'inherit' });
+
+        logger.info(`执行: git push origin ${branch}`);
+        execSync(`git push origin ${branch}`, { stdio: 'inherit' });
+
+        logger.success('提交并推送成功！');
+      } catch (error) {
+        logger.error(`操作失败: ${error.message}`);
+        process.exit(1);
+      }
+    });
+}

package/src/commands/config.js

@@ -0,0 +1,113 @@
+import fs from 'fs';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+
+const CONFIG_FILE = '.pqmrc';
+
+export default function (program) {
+  const configCmd = program
+    .command('config')
+    .description('View or manage configuration');
+
+  configCmd
+    .command('list')
+    .description('List current configuration')
+    .action(() => {
+      const config = loadConfig();
+      console.log('\nCurrent Configuration:');
+      console.log(JSON.stringify(config, null, 2));
+    });
+
+  configCmd
+    .command('get <key>')
+    .description('Get a configuration value')
+    .action((key) => {
+      const config = loadConfig();
+      const value = getNestedValue(config, key);
+      if (value === undefined) {
+        logger.warn(`Key '${key}' not found`);
+      } else if (typeof value === 'object') {
+        console.log(JSON.stringify(value, null, 2));
+      } else {
+        console.log(value);
+      }
+    });
+
+  configCmd
+    .command('set <key> <value>')
+    .description('Set a configuration value')
+    .action((key, value) => {
+      const configPath = path.resolve(process.cwd(), CONFIG_FILE);
+      let config = {};
+
+      if (fs.existsSync(configPath)) {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      }
+
+      setNestedValue(config, key, parseValue(value));
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      logger.success(`Set ${key} = ${value}`);
+    });
+}
+
+function loadConfig() {
+  const configPath = path.resolve(process.cwd(), CONFIG_FILE);
+  const defaultConfig = {
+    root: './src',
+    exclude: ['node_modules', 'dist', '.git', '**/*.test.js', '**/*.spec.js'],
+    buildTool: 'auto',
+    buildMode: 'incremental',
+    buildOnStart: true,
+    webhook: {
+      enabled: false,
+      port: 3200
+    },
+    log: {
+      level: 'info',
+      file: '.pqm/pqm.log'
+    }
+  };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      const userConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      return { ...defaultConfig, ...userConfig };
+    } catch (err) {
+      logger.warn('Failed to parse .pqmrc, using defaults');
+    }
+  }
+
+  return defaultConfig;
+}
+
+function getNestedValue(obj, key) {
+  const keys = key.split('.');
+  let result = obj;
+  for (const k of keys) {
+    result = result?.[k];
+  }
+  return result;
+}
+
+function setNestedValue(obj, key, value) {
+  const keys = key.split('.');
+  let current = obj;
+  for (let i = 0; i < keys.length - 1; i++) {
+    if (!current[keys[i]]) {
+      current[keys[i]] = {};
+    }
+    current = current[keys[i]];
+  }
+  current[keys[keys.length - 1]] = value;
+}
+
+function parseValue(value) {
+  // Try to parse as JSON for booleans, numbers, arrays, objects
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+export { loadConfig };

package/src/commands/doctor.js

@@ -0,0 +1,146 @@
+import { execSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { logger } from '../utils/logger.js';
+import chalk from 'chalk';
+
+export default function (program) {
+  program
+    .command('doctor')
+    .description('Diagnose the environment and configuration')
+    .action(() => {
+      console.log('\n' + chalk.bold('PQM Environment Diagnostics\n'));
+
+      const checks = [
+        checkNodeVersion,
+        checkNpmVersion,
+        checkConfigFile,
+        checkSrcDirectory,
+        checkBuildTools,
+        checkDependencies
+      ];
+
+      let passed = 0;
+      let failed = 0;
+
+      for (const check of checks) {
+        try {
+          const result = check();
+          if (result.passed) {
+            logger.success(result.message);
+            passed++;
+          } else {
+            logger.error(result.message);
+            if (result.hint) {
+              console.log(chalk.gray(`  → ${result.hint}`));
+            }
+            failed++;
+          }
+        } catch (err) {
+          logger.error(`Check failed: ${err.message}`);
+          failed++;
+        }
+      }
+
+      console.log('\n' + chalk.bold('Summary:'));
+      console.log(`  ${chalk.green('Passed')}: ${passed}`);
+      console.log(`  ${chalk.red('Failed')}: ${failed}`);
+
+      if (failed === 0) {
+        console.log(`\n${chalk.green("All checks passed! You're ready to use pqm.")}`);
+      } else {
+        console.log(`\n${chalk.yellow('Some checks failed. Please fix the issues above.')}`);
+      }
+    });
+}
+
+function checkNodeVersion() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split('.')[0], 10);
+  return {
+    passed: major >= 18,
+    message: `Node.js version: ${version}`,
+    hint: major < 18 ? 'Upgrade to Node.js 18 or later' : null
+  };
+}
+
+function checkNpmVersion() {
+  try {
+    const version = execSync('npm --version', { encoding: 'utf-8' }).trim();
+    return { passed: true, message: `npm version: ${version}` };
+  } catch {
+    return { passed: false, message: 'npm not found' };
+  }
+}
+
+function checkConfigFile() {
+  const configPath = resolve(process.cwd(), '.pqmrc');
+  const exists = existsSync(configPath);
+  return {
+    passed: exists,
+    message: exists ? '.pqmrc found' : '.pqmrc not found',
+    hint: exists ? null : 'Run `pqm init` to create configuration'
+  };
+}
+
+function checkSrcDirectory() {
+  const srcPath = resolve(process.cwd(), 'src');
+  const exists = existsSync(srcPath);
+  return {
+    passed: exists,
+    message: exists ? 'src/ directory found' : 'src/ directory not found',
+    hint: exists ? null : 'Create a src/ directory or update .pqmrc root path'
+  };
+}
+
+function checkBuildTools() {
+  const cwd = process.cwd();
+  const tools = [];
+
+  if (existsSync(join(cwd, 'vite.config.js')) ||
+      existsSync(join(cwd, 'vite.config.ts'))) {
+    tools.push('vite');
+  }
+
+  if (existsSync(join(cwd, 'rollup.config.js')) ||
+      existsSync(join(cwd, 'rollup.config.mjs'))) {
+    tools.push('rollup');
+  }
+
+  if (existsSync(join(cwd, 'tsconfig.json'))) {
+    tools.push('typescript');
+  }
+
+  return {
+    passed: tools.length > 0,
+    message: tools.length > 0
+      ? `Build tools detected: ${tools.join(', ')}`
+      : 'No build tools detected',
+    hint: tools.length === 0 ? 'Install vite, rollup, or typescript' : null
+  };
+}
+
+function checkDependencies() {
+  const pkgPath = join(process.cwd(), 'package.json');
+
+  if (!existsSync(pkgPath)) {
+    return {
+      passed: false,
+      message: 'package.json not found',
+      hint: 'Run `npm init` to create package.json'
+    };
+  }
+
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const hasVite = pkg.devDependencies?.vite || pkg.dependencies?.vite;
+    const hasRollup = pkg.devDependencies?.rollup || pkg.dependencies?.rollup;
+
+    if (hasVite || hasRollup) {
+      return { passed: true, message: 'Build dependencies found' };
+    }
+    return { passed: true, message: 'package.json found (no build deps)' };
+  } catch {
+    return { passed: false, message: 'Failed to parse package.json' };
+  }
+}