coderev-cli 1.0.21 → 1.0.23

package/README.md

@@ -836,6 +836,10 @@ A：可以，审查时加 `--no-cache` 参数即可跳过缓存。
 A：在 `.coderevrc.json` 的 `rules.custom` 数组中添加。详见上方「自定义规则」章节。
 
 ---
+## Contributing
+
+欢迎贡献！详见 [CONTRIBUTING.md](CONTRIBUTING.md)
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coderev-cli",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Multi-agent AI code review for git -- parallel agents with confidence scoring",
   "main": "src/index.js",
   "bin": {

package/src/cli.js

@@ -640,6 +640,7 @@ program
   .command('init')
   .description('Create a default coderev config file')
   .option('--gitlab-ci', 'Generate a .gitlab-ci.yml template for GitLab CI/CD review')
+  .option('--github-action', 'Generate a GitHub Actions workflow for PR review')
   .action((options) => {
     const fs = require('fs');
     const path = require('path');
@@ -766,6 +767,64 @@ coderev-review:
       console.log(chalk.blue('  3. (Optional) Add GITLAB_TOKEN with api scope for MR comments'));
       console.log(chalk.blue('  4. Push to GitLab — coderev runs on every MR!'));
     }
+
+    // --github-action: generate GitHub Actions workflow
+    if (options.githubAction) {
+      const gaDir = path.join(process.cwd(), '.github', 'workflows');
+      const gaPath = path.join(gaDir, 'coderev.yml');
+      if (fs.existsSync(gaPath)) {
+        console.log(chalk.yellow(`⚠ ${gaPath} already exists. Skipping.`));
+      } else {
+        const templatePath = path.join(__dirname, '..', 'templates', 'github-action.yml');
+        if (fs.existsSync(templatePath)) {
+          fs.mkdirSync(gaDir, { recursive: true });
+          fs.copyFileSync(templatePath, gaPath);
+          console.log(chalk.green(`✔ GitHub Actions workflow created at ${gaPath}`));
+        } else {
+          // Fallback: write minimal workflow
+          const gaContent = `name: coderev AI Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  coderev:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install -g coderev-cli
+      - run: |
+          git diff \${{ github.event.pull_request.base.sha }}...\${{ github.event.pull_request.head.sha }} > /tmp/coderev-pr.diff
+      - env:
+          DEEPSEEK_API_KEY: \${{ secrets.DEEPSEEK_API_KEY }}
+        run: |
+          cat /tmp/coderev-pr.diff | coderev review --output markdown --ci --min-confidence 60 > /tmp/coderev-report.md
+      - uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: coderev-review
+          path: /tmp/coderev-report.md
+`;
+          fs.mkdirSync(gaDir, { recursive: true });
+          fs.writeFileSync(gaPath, gaContent);
+          console.log(chalk.green(`✔ GitHub Actions workflow created at ${gaPath}`));
+        }
+      }
+      console.log(chalk.blue('  Next steps:'));
+      console.log(chalk.blue('  1. Go to GitHub → Settings → Secrets and variables → Actions'));
+      console.log(chalk.blue('  2. Add secret DEEPSEEK_API_KEY with your API key'));
+      console.log(chalk.blue('  3. Push to GitHub — coderev reviews every PR!'));
+    }
   });
 
 // ── Serve (GitHub App) ────────────────────────────────────────────
@@ -789,6 +848,118 @@ program
     }
   });
 
+// ── Rules Marketplace ─────────────────────────────────────────────
+program
+  .command('rules <action>')
+  .description('Manage rule packs from the coderev marketplace')
+  .option('-q, --query <text>', 'Search query')
+  .option('-n, --name <name>', 'Rule pack name')
+  .option('--version <ver>', 'Version for publish', '1.0.0')
+  .option('--desc <text>', 'Description for publish')
+  .option('--api-url <url>', 'Marketplace API URL')
+  .action(async (action, options) => {
+    try {
+      const { searchRules, installRule, publishRules, listInstalled, uninstallRule, DEFAULT_API_URL } = require('./rules-market');
+      const apiUrl = options.apiUrl || process.env.CODEREV_MARKETPLACE_URL || DEFAULT_API_URL;
+
+      switch (action) {
+        case 'search': {
+          console.log(chalk.blue(`🔍 Searching marketplace for "${options.query || ''}"...`));
+          const results = await searchRules(options.query || '', apiUrl);
+          if (!Array.isArray(results) || results.length === 0) {
+            console.log(chalk.yellow('No rule packs found.'));
+          } else {
+            console.log(chalk.bold(`\nFound ${results.length} rule pack(s):\n`));
+            for (const pack of results) {
+              console.log(chalk.green(`  📦 ${pack.name}`) + chalk.gray(` v${pack.version}`));
+              console.log(`     ${pack.description || '(no description)'}`);
+              console.log(chalk.gray(`     ${pack.rules || 0} rules  •  ${pack.downloads || 0} downloads  •  by ${pack.author || 'unknown'}`));
+              console.log('');
+            }
+            console.log(chalk.blue(`Install: coderev rules install <name>`));
+          }
+          break;
+        }
+
+        case 'install': {
+          const name = options.name || options.query;
+          if (!name) {
+            console.error(chalk.red('✖ Please specify a rule pack name: coderev rules install <name>'));
+            process.exit(1);
+          }
+          console.log(chalk.blue(`📥 Installing "${name}"...`));
+          const result = await installRule(name, apiUrl);
+          console.log(chalk.green(`✔ Installed ${result.name} v${result.version}`));
+          console.log(chalk.gray(`  ${result.added}/${result.total} rules added to .coderevrc.json`));
+          break;
+        }
+
+        case 'publish': {
+          console.log(chalk.blue('📤 Publishing rules to marketplace...'));
+          const result = await publishRules(apiUrl, {
+            name: options.name,
+            version: options.version,
+            description: options.desc,
+          });
+          console.log(chalk.green(`✔ Published "${result.name}" v${options.version} (${result.rules} rules)`));
+          break;
+        }
+
+        case 'list': {
+          const result = listInstalled();
+          if (result.packs.length === 0) {
+            console.log(chalk.yellow(result.message));
+          } else {
+            console.log(chalk.bold(`\n📦 Installed rule packs (${result.packs.length}):\n`));
+            for (const pack of result.packs) {
+              console.log(chalk.green(`  📦 ${pack.name}`) + chalk.gray(` v${pack.version}`));
+              console.log(chalk.gray(`     ${pack.rules} rules  •  installed ${new Date(pack.installedAt).toLocaleDateString()}`));
+            }
+          }
+          break;
+        }
+
+        case 'uninstall': {
+          const name = options.name || options.query;
+          if (!name) {
+            console.error(chalk.red('✖ Please specify a rule pack name: coderev rules uninstall <name>'));
+            process.exit(1);
+          }
+          const result = uninstallRule(name);
+          console.log(chalk.green(`✔ Uninstalled "${result.name}"`));
+          break;
+        }
+
+        case 'info': {
+          const name = options.name || options.query;
+          if (!name) {
+            console.error(chalk.red('✖ Please specify a rule pack name: coderev rules info <name>'));
+            process.exit(1);
+          }
+          const pack = await apiRequest(apiUrl, `/rules/${encodeURIComponent(name)}`);
+          console.log(chalk.bold(`\n📦 ${pack.name}`) + chalk.gray(` v${pack.version}`));
+          console.log(`   ${pack.description || '(no description)'}`);
+          console.log(chalk.gray(`   ${pack.rules?.length || 0} rules  •  by ${pack.author || 'unknown'}`));
+          if (pack.rules && pack.rules.length > 0) {
+            console.log(chalk.bold('\n   Rules:'));
+            for (const r of pack.rules) {
+              const sev = r.severity === 'error' ? chalk.red(r.severity) : r.severity === 'warning' ? chalk.yellow(r.severity) : chalk.gray(r.severity);
+              console.log(`   - ${r.name} [${sev}] ${r.message || ''}`);
+            }
+          }
+          break;
+        }
+
+        default:
+          console.error(chalk.red(`✖ Unknown action "${action}". Use: search | install | publish | list | uninstall | info`));
+          process.exit(1);
+      }
+    } catch (err) {
+      console.error(chalk.red(`✖ ${err.message}`));
+      process.exit(1);
+    }
+  });
+
 program.parse(process.argv);
 
 // ── Helpers ───────────────────────────────────────────────────

package/src/rules-market.js

@@ -0,0 +1,257 @@
+/**
+ * Rules Market — SaaS cloud rule repository for coderev.
+ *
+ * Commands:
+ *   coderev rules search <query>   Search the rule marketplace
+ *   coderev rules install <name>   Install a rule pack from the marketplace
+ *   coderev rules publish          Publish local rules to the marketplace
+ *   coderev rules list             List installed rule packs
+ *
+ * API Base: configurable via .coderevrc.json → marketplace.apiUrl
+ * Default: https://rules.coderev.dev/api
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const http = require('http');
+
+const DEFAULT_API_URL = 'https://rules.coderev.dev/api';
+const MARKETPLACE_DIR = '.coderev-marketplace';
+const INSTALLED_MANIFEST = 'installed.json';
+
+// ── API Client ───────────────────────────────────────────
+
+/**
+ * Make an HTTP request to the marketplace API.
+ */
+function apiRequest(apiUrl, endpoint, method = 'GET', body = null) {
+  const url = new URL(`${apiUrl}${endpoint}`);
+  const isHttps = url.protocol === 'https:';
+  const transport = isHttps ? https : http;
+
+  return new Promise((resolve, reject) => {
+    const options = {
+      hostname: url.hostname,
+      port: url.port || (isHttps ? 443 : 80),
+      path: url.pathname + url.search,
+      method,
+      headers: {
+        'Accept': 'application/json',
+        'User-Agent': 'coderev-cli',
+        ...(body ? { 'Content-Type': 'application/json' } : {}),
+      },
+      timeout: 15000,
+    };
+
+    const req = transport.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => (data += chunk));
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          if (res.statusCode >= 400) {
+            reject(new Error(json.error || `API error: ${res.statusCode}`));
+          } else {
+            resolve(json);
+          }
+        } catch (e) {
+          reject(new Error(`Invalid API response: ${data.slice(0, 200)}`));
+        }
+      });
+    });
+
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error('API request timed out'));
+    });
+    req.on('error', (err) => reject(new Error(`API connection failed: ${err.message}`)));
+
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+// ── Marketplace Directory ────────────────────────────────
+
+function getMarketplaceDir() {
+  return path.join(process.cwd(), MARKETPLACE_DIR);
+}
+
+function getInstalledManifest() {
+  const dir = getMarketplaceDir();
+  const manifestPath = path.join(dir, INSTALLED_MANIFEST);
+  if (!fs.existsSync(manifestPath)) return { packs: [] };
+  return JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+}
+
+function saveInstalledManifest(manifest) {
+  const dir = getMarketplaceDir();
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(path.join(dir, INSTALLED_MANIFEST), JSON.stringify(manifest, null, 2));
+}
+
+// ── Search ───────────────────────────────────────────────
+
+async function searchRules(query, apiUrl) {
+  const endpoint = query
+    ? `/rules?q=${encodeURIComponent(query)}`
+    : '/rules';
+  const result = await apiRequest(apiUrl, endpoint);
+  return result.rules || result;
+}
+
+// ── Install ──────────────────────────────────────────────
+
+async function installRule(packName, apiUrl) {
+  // Fetch rule pack from marketplace
+  const pack = await apiRequest(apiUrl, `/rules/${encodeURIComponent(packName)}`);
+
+  if (!pack || !pack.rules) {
+    throw new Error(`Rule pack "${packName}" not found or empty`);
+  }
+
+  // Merge into local .coderevrc.json
+  const configPath = path.join(process.cwd(), '.coderevrc.json');
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  }
+
+  // Ensure custom rules array exists
+  if (!config.rules) config.rules = {};
+  if (!config.rules.custom) config.rules.custom = [];
+
+  // Add pack rules (skip duplicates by name)
+  let added = 0;
+  for (const rule of pack.rules) {
+    const exists = config.rules.custom.some(r => r.name === rule.name);
+    if (!exists) {
+      config.rules.custom.push({
+        ...rule,
+        _source: packName,
+        _version: pack.version,
+      });
+      added++;
+    }
+  }
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  // Record installation
+  const manifest = getInstalledManifest();
+  const existing = manifest.packs.findIndex(p => p.name === packName);
+  if (existing >= 0) {
+    manifest.packs[existing] = {
+      name: packName,
+      version: pack.version,
+      rules: pack.rules.length,
+      installedAt: new Date().toISOString(),
+    };
+  } else {
+    manifest.packs.push({
+      name: packName,
+      version: pack.version,
+      rules: pack.rules.length,
+      installedAt: new Date().toISOString(),
+    });
+  }
+  saveInstalledManifest(manifest);
+
+  return { name: packName, version: pack.version, added, total: pack.rules.length };
+}
+
+// ── Publish ───────────────────────────────────────────────
+
+async function publishRules(apiUrl, options = {}) {
+  const configPath = path.join(process.cwd(), '.coderevrc.json');
+  if (!fs.existsSync(configPath)) {
+    throw new Error('No .coderevrc.json found. Run `coderev init` first.');
+  }
+
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  const rules = config.rules?.custom || [];
+
+  if (rules.length === 0) {
+    throw new Error('No custom rules found in .coderevrc.json');
+  }
+
+  const packName = options.name || path.basename(process.cwd());
+  const payload = {
+    name: packName,
+    version: options.version || '1.0.0',
+    description: options.description || `Rules from ${packName}`,
+    rules: rules.map(r => ({
+      name: r.name,
+      pattern: r.pattern,
+      severity: r.severity || 'warning',
+      message: r.message,
+      filePattern: r.filePattern,
+      category: r.category || 'style',
+    })),
+  };
+
+  const result = await apiRequest(apiUrl, '/rules', 'POST', payload);
+
+  return { name: packName, version: payload.version, rules: rules.length, published: true };
+}
+
+// ── List Installed ───────────────────────────────────────
+
+function listInstalled() {
+  const manifest = getInstalledManifest();
+
+  if (manifest.packs.length === 0) {
+    return { packs: [], message: 'No rule packs installed. Use `coderev rules search` to find rules.' };
+  }
+
+  return { packs: manifest.packs };
+}
+
+// ── Uninstall ─────────────────────────────────────────────
+
+function uninstallRule(packName) {
+  const manifest = getInstalledManifest();
+  const idx = manifest.packs.findIndex(p => p.name === packName);
+  if (idx < 0) {
+    throw new Error(`Rule pack "${packName}" is not installed.`);
+  }
+
+  manifest.packs.splice(idx, 1);
+  saveInstalledManifest(manifest);
+
+  // Also remove from .coderevrc.json
+  const configPath = path.join(process.cwd(), '.coderevrc.json');
+  if (fs.existsSync(configPath)) {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    if (config.rules?.custom) {
+      config.rules.custom = config.rules.custom.filter(r => r._source !== packName);
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+  }
+
+  return { name: packName, removed: true };
+}
+
+// ── Search Local ──────────────────────────────────────────
+
+function searchLocalRules(query) {
+  const manifest = getInstalledManifest();
+  if (!query) return manifest.packs;
+
+  const q = query.toLowerCase();
+  return manifest.packs.filter(
+    p => p.name.toLowerCase().includes(q)
+  );
+}
+
+module.exports = {
+  searchRules,
+  installRule,
+  publishRules,
+  listInstalled,
+  uninstallRule,
+  searchLocalRules,
+  DEFAULT_API_URL,
+  getMarketplaceDir,
+};

package/templates/github-action.yml

@@ -0,0 +1,143 @@
+# coderev — Multi-Agent AI Code Review for GitHub Actions
+# Quick start:
+#   1. Copy this file to .github/workflows/coderev.yml
+#      Or run: npx coderev-cli init --github-action
+#   2. Set Secrets: DEEPSEEK_API_KEY in Settings → Secrets and variables → Actions
+#   3. (Optional) Set GITHUB_TOKEN is auto-provided, no setup needed
+#
+# Usage:
+#   - Review on every PR: default trigger
+#   - Block merging on issues: enable CODEREV_BLOCK or comment with coderev status
+#
+# Variables (set in workflow or as env):
+#   CODEREV_PROVIDER     AI provider (default: deepseek)
+#   CODEREV_MODEL        Model name (default: deepseek-chat)
+#   CODEREV_CONFIDENCE   Minimum confidence 0-100 (default: 60)
+#   CODEREV_BLOCK        Block PR on issues (default: false)
+#   CODEREV_BLAME        Enable git blame context (default: false)
+#   CODEREV_MODE         Review mode: comment | check (default: comment)
+
+name: coderev AI Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: 'Git ref to review (branch/commit)'
+        required: false
+
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
+jobs:
+  coderev:
+    name: AI Code Review
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install coderev
+        run: npm install -g coderev-cli
+
+      - name: Generate diff
+        id: diff
+        run: |
+          if [ -n "${{ github.event.pull_request.base.sha }}" ]; then
+            git diff ${{ github.event.pull_request.base.sha }}...${{ github.event.pull_request.head.sha }} > /tmp/coderev-pr.diff
+          else
+            git diff HEAD~1 > /tmp/coderev-pr.diff
+          fi
+          echo "Diff size: $(wc -c < /tmp/coderev-pr.diff) bytes"
+
+      - name: Run coderev review
+        id: review
+        env:
+          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
+          CODEREV_PROVIDER: ${{ env.CODEREV_PROVIDER || 'deepseek' }}
+          CODEREV_MODEL: ${{ env.CODEREV_MODEL || 'deepseek-chat' }}
+        run: |
+          BLAME_FLAG=""
+          if [ "${{ env.CODEREV_BLAME || 'false' }}" = "true" ]; then
+            BLAME_FLAG="--blame"
+          fi
+
+          cat /tmp/coderev-pr.diff | coderev review \
+            --output markdown \
+            --ci $BLAME_FLAG \
+            --min-confidence ${{ env.CODEREV_CONFIDENCE || '60' }} \
+            > /tmp/coderev-report.md 2>/tmp/coderev-stderr.log
+
+          echo "Exit code: $?"
+
+      - name: Post review as PR comment
+        if: github.event_name == 'pull_request' && env.CODEREV_MODE != 'check'
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: coderev-review
+          path: /tmp/coderev-report.md
+
+      - name: Post review as GitHub Check
+        if: env.CODEREV_MODE == 'check'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const report = fs.readFileSync('/tmp/coderev-report.md', 'utf8');
+
+            // Parse score from report
+            const scoreMatch = report.match(/\*\*Score:\*\*\s*(\d+)\/100/);
+            const score = scoreMatch ? parseInt(scoreMatch[1]) : 0;
+            const conclusion = score >= 80 ? 'success' : score >= 50 ? 'neutral' : 'failure';
+
+            // Count issues
+            const issueMatches = report.match(/\*\*ERROR\*\*/g);
+            const warnMatches = report.match(/\*\*WARNING\*\*/g);
+
+            await github.rest.checks.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              name: 'coderev AI Review',
+              head_sha: context.payload.pull_request?.head?.sha || context.sha,
+              status: 'completed',
+              conclusion: conclusion,
+              output: {
+                title: `Code Review: ${score}/100`,
+                summary: report.substring(0, 65535),
+                annotations: []
+              }
+            });
+
+      - name: Block on issues (optional)
+        if: env.CODEREV_BLOCK == 'true'
+        run: |
+          SCORE=$(grep -oP '\*\*Score:\*\*\s*\K\d+' /tmp/coderev-report.md || echo 0)
+          if [ "$SCORE" -lt 60 ]; then
+            echo "⛔ Score $SCORE/100 below threshold (60). Blocking PR."
+            cat /tmp/coderev-report.md
+            exit 1
+          fi
+          echo "✅ Score $SCORE/100 — passed."
+
+      - name: Upload review artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coderev-report
+          path: |
+            /tmp/coderev-report.md
+            /tmp/coderev-stderr.log
+          retention-days: 7