pqm-cli 1.0.0

package/README.md

@@ -0,0 +1,254 @@
+# PQM CLI
+
+Package Quality Monitor CLI - 文件监控、构建、发布一体化工具。
+
+## 安装
+
+```bash
+cd pqm-cli
+npm install
+npm link
+```
+
+## 流程闭环
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      PQM 完整工作流                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                               │
+│  开发阶段          发布阶段                │
+│  ┌───────┐         ┌─────────┐        ┌─────────┐           │
+│  │ watch │ ──────▶ │ commit  │ ─────▶ │ release │           │
+│  └───────┘         └─────────┘        └─────────┘           │
+│      │                  │                  │                 │
+│      ▼                  ▼                  ▼                 │
+│  ┌───────┐         ┌─────────┐        ┌─────────┐           │
+│  │ build │         │ status  │        │ publish │           │
+│  └───────┘         └─────────┘        └─────────┘           │
+│                                           │                   │
+│                                           ▼                   │
+│                                     ┌─────────┐              │
+│                                     │ webhook │ ◀── Git Tag │
+│                                     └─────────┘              │
+│                                           │                   │
+│                                           ▼                   │
+│                                        npm 发布               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 命令总览
+
+### 开发流程
+
+```bash
+# 1. 初始化项目
+pqm init
+
+# 2. 启动文件监控（自动构建）
+pqm watch
+
+# 3. 查看项目状态
+pqm status
+```
+
+### 提交发布
+
+```bash
+# 4. 提交代码
+pqm commit "feat: 新功能"
+
+# 5. 创建发布版本
+pqm release patch   # 1.0.0 → 1.0.1
+pqm release minor   # 1.0.0 → 1.1.0
+pqm release major   # 1.0.0 → 2.0.0
+
+# 6. 发布到 npm
+pqm login           # 登录 npm
+pqm publish         # 发布包
+```
+
+### Webhook 自动发布
+
+```bash
+# 启动 webhook 服务器
+pqm webhook start
+
+# 在另一个终端测试
+pqm webhook test
+```
+
+## 命令详情
+
+### `pqm watch`
+
+启动文件监控，自动触发构建。
+
+```bash
+pqm watch                    # 监控 ./src
+pqm watch -p ./lib          # 监控 ./lib
+pqm watch -t vite           # 指定构建工具
+pqm watch --webhook         # 同时启动 webhook
+```
+
+### `pqm commit`
+
+提交并推送代码。
+
+```bash
+pqm commit "feat: 添加新功能"
+pqm commit "fix: 修复bug" -m "详细说明"
+```
+
+### `pqm release`
+
+创建版本发布。
+
+```bash
+pqm release          # 默认 patch
+pqm release patch    # 补丁版本 1.0.0 → 1.0.1
+pqm release minor    # 次要版本 1.0.0 → 1.1.0
+pqm release major    # 主要版本 1.0.0 → 2.0.0
+```
+
+### `pqm publish`
+
+发布到 npm。
+
+```bash
+pqm publish                  # 交互式发布
+pqm publish --access public  # 公开包
+pqm publish --skip-test      # 跳过测试
+pqm publish --skip-build     # 跳过构建
+```
+
+### `pqm webhook`
+
+自动发布 webhook 服务器。
+
+```bash
+# 设置 NPM_TOKEN 环境变量
+export NPM_TOKEN=npm_xxxxx
+
+# 启动服务器
+pqm webhook start
+
+# 指定端口
+pqm webhook start -p 3200
+
+# 启用签名验证
+pqm webhook start -s your-secret
+
+# 测试 webhook
+pqm webhook test
+```
+
+### `pqm status`
+
+查看项目状态。
+
+```bash
+pqm status
+```
+
+输出示例：
+```
+📦 包信息
+────────────────────────────────
+名称: my-package
+版本: v1.0.0
+
+🌿 Git 状态
+────────────────────────────────
+分支: main
+变更: 工作区干净
+
+📝 最近提交
+────────────────────────────────
+  abc1234 feat: 新功能
+  def5678 fix: 修复bug
+
+🔐 NPM 状态
+────────────────────────────────
+用户: your-username
+```
+
+### 其他命令
+
+```bash
+pqm init              # 初始化配置
+pqm config list       # 查看配置
+pqm config set <k> <v>  # 设置配置
+pqm doctor            # 环境诊断
+pqm build             # 手动构建
+pqm build -t vite     # 指定工具
+pqm login             # NPM 登录
+```
+
+## 配置文件 (.pqmrc)
+
+```json
+{
+  "root": "./src",
+  "exclude": ["node_modules", "dist", ".git"],
+  "buildTool": "auto",
+  "buildMode": "incremental",
+  "buildOnStart": true,
+  "webhook": {
+    "enabled": false,
+    "port": 3200
+  },
+  "log": {
+    "level": "info",
+    "file": ".pqm/pqm.log"
+  }
+}
+```
+
+## 典型工作流
+
+### 场景 1：日常开发
+
+```bash
+# 1. 开始开发
+pqm watch
+
+# 2. 修改文件...（自动构建）
+
+# 3. 提交
+pqm commit "feat: 添加新功能"
+
+# 4. 发布版本
+pqm release patch
+```
+
+### 场景 2：CI/CD 自动发布
+
+```bash
+# 服务器端运行
+export NPM_TOKEN=npm_xxxxx
+pqm webhook start -p 3000
+
+# 配置 Git 平台 Webhook:
+# URL: http://your-server:3000/webhook/npm-publish
+# 触发: Tag push
+```
+
+### 场景 3：手动发布
+
+```bash
+pqm status           # 检查状态
+pqm login            # 登录
+pqm release minor    # 创建版本
+pqm publish          # 发布
+```
+
+## 依赖
+
+- Node.js >= 18
+- Git
+- npm
+
+## License
+
+MIT

package/bin/pqm.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { registerCommands } from '../src/cli.js';
+
+registerCommands(program);
+program.parse();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "pqm-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Package Quality Monitor CLI - 文件监控、构建、发布一体化工具",
+  "bin": {
+    "pqm": "bin/pqm.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.0.0",
+    "chokidar": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "cli",
+    "watch",
+    "build",
+    "monitor"
+  ],
+  "license": "MIT"
+}

package/src/ai/analyzer/collector.js

@@ -0,0 +1,191 @@
+import fs from 'fs';
+import path from 'path';
+import { loadGlobalConfig } from '../../config/global.js';
+
+/**
+ * Default exclude patterns
+ */
+const DEFAULT_EXCLUDES = [
+  'node_modules',
+  'dist',
+  'build',
+  '.git',
+  '.svn',
+  '.hg',
+  'coverage',
+  '.nyc_output',
+  '**/*.min.js',
+  '**/*.min.css',
+  '**/*.map',
+  '**/*.lock',
+  'package-lock.json',
+  'yarn.lock',
+  'pnpm-lock.yaml'
+];
+
+/**
+ * Supported file extensions for analysis
+ */
+const SUPPORTED_EXTENSIONS = [
+  '.js', '.jsx', '.ts', '.tsx',
+  '.vue', '.svelte',
+  '.py', '.rb', '.go',
+  '.java', '.kt', '.rs',
+  '.c', '.cpp', '.h', '.hpp',
+  '.php', '.cs',
+  '.swift', '.m', '.mm',
+  '.sh', '.bash',
+  '.sql',
+  '.html', '.css', '.scss', '.less'
+];
+
+/**
+ * Check if path should be excluded
+ * @param {string} filePath - File path
+ * @param {Array<string>} excludes - Exclude patterns
+ * @returns {boolean} True if excluded
+ */
+function isExcluded(filePath, excludes) {
+  const normalized = filePath.replace(/\\/g, '/');
+
+  for (const pattern of excludes) {
+    // Simple pattern matching
+    if (pattern.startsWith('**/*.')) {
+      const ext = pattern.slice(2);
+      if (normalized.endsWith(ext)) {
+        return true;
+      }
+    } else if (pattern.startsWith('**/')) {
+      const name = pattern.slice(3);
+      if (normalized.includes('/' + name + '/') || normalized.endsWith('/' + name)) {
+        return true;
+      }
+    } else {
+      // Simple directory/name match
+      if (normalized.includes('/' + pattern + '/') || normalized.endsWith('/' + pattern)) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Check if file extension is supported
+ * @param {string} filePath - File path
+ * @returns {boolean} True if supported
+ */
+function isSupportedFile(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return SUPPORTED_EXTENSIONS.includes(ext);
+}
+
+/**
+ * Collect files from a directory
+ * @param {string} dir - Directory path
+ * @param {Object} options - Options
+ * @returns {Promise<Array<Object>>} File list with content
+ */
+export async function collectFiles(dir, options = {}) {
+  const config = loadGlobalConfig();
+  const exclude = options.exclude || config.scan?.exclude || DEFAULT_EXCLUDES;
+  const maxFileSize = options.maxFileSize || config.scan?.maxFileSize || 1048576;
+
+  const files = [];
+
+  async function walk(currentPath) {
+    try {
+      const entries = await fs.promises.readdir(currentPath, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const fullPath = path.join(currentPath, entry.name);
+
+        if (isExcluded(fullPath, exclude)) {
+          continue;
+        }
+
+        if (entry.isDirectory()) {
+          await walk(fullPath);
+        } else if (entry.isFile() && isSupportedFile(fullPath)) {
+          try {
+            const stat = await fs.promises.stat(fullPath);
+
+            if (stat.size > maxFileSize) {
+              continue;
+            }
+
+            const content = await fs.promises.readFile(fullPath, 'utf-8');
+
+            // Skip empty files
+            if (content.trim().length === 0) {
+              continue;
+            }
+
+            files.push({
+              path: fullPath,
+              relativePath: path.relative(dir, fullPath),
+              content,
+              size: stat.size
+            });
+          } catch (error) {
+            // Skip files that can't be read
+            continue;
+          }
+        }
+      }
+    } catch (error) {
+      // Handle permission errors etc.
+      console.error(`Warning: Could not read directory ${currentPath}: ${error.message}`);
+    }
+  }
+
+  await walk(dir);
+
+  return files;
+}
+
+/**
+ * Collect a single file
+ * @param {string} filePath - File path
+ * @returns {Promise<Object|null>} File object or null
+ */
+export async function collectSingleFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  const stat = await fs.promises.stat(filePath);
+
+  if (!stat.isFile()) {
+    return null;
+  }
+
+  const content = await fs.promises.readFile(filePath, 'utf-8');
+
+  return {
+    path: filePath,
+    relativePath: path.basename(filePath),
+    content,
+    size: stat.size
+  };
+}
+
+/**
+ * Get file count in directory
+ * @param {string} dir - Directory path
+ * @param {Object} options - Options
+ * @returns {Promise<number>} File count
+ */
+export async function getFileCount(dir, options = {}) {
+  const files = await collectFiles(dir, options);
+  return files.length;
+}
+
+export default {
+  collectFiles,
+  collectSingleFile,
+  getFileCount,
+  DEFAULT_EXCLUDES,
+  SUPPORTED_EXTENSIONS
+};