devassist-agent 1.0.0

package/bin/devassist.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+/**
+ * DevAssist CLI - entry point
+ *
+ * Commands:
+ *   devassist init              Initialize project (create .devassist/ config)
+ *   devassist check             Run all dev-time checks
+ *   devassist deploy --check    Pre-deployment validation
+ *   devassist debt              Show tech debt board
+ *   devassist convention <add|list|remove>  Manage conventions
+ *   devassist schema <import|list>          Manage schema registry
+ *   devassist backup [label]                Create incremental backup
+ *   devassist restore <versionId>           Restore from backup (non-destructive)
+ *   devassist ask <question>                Ask AI a question
+ *   devassist ai --status|--setup|--test    AI configuration and testing
+ *   devassist inject [--format <fmt>]       Generate convention file for AI agents
+ *   devassist doctor                        Environment diagnostics
+ *   devassist clean [--days <n>]            Clean old reports/backups/history
+ *   devassist fix [--all|--dry-run]         Auto-fix common code issues
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// Resolve project root: look for .devassist or package.json
+function findProjectRoot() {
+  let dir = process.cwd();
+  for (let i = 0; i < 10; i++) {
+    if (fs.existsSync(path.join(dir, '.devassist')) || fs.existsSync(path.join(dir, 'package.json'))) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return process.cwd();
+}
+
+const args = process.argv.slice(2);
+const command = args[0];
+const projectRoot = findProjectRoot();
+
+// Color helpers
+const c = {
+  red: s => `\x1b[31m${s}\x1b[0m`,
+  green: s => `\x1b[32m${s}\x1b[0m`,
+  yellow: s => `\x1b[33m${s}\x1b[0m`,
+  blue: s => `\x1b[36m${s}\x1b[0m`,
+  cyan: s => `\x1b[36m${s}\x1b[0m`,
+  magenta: s => `\x1b[35m${s}\x1b[0m`,
+  gray: s => `\x1b[90m${s}\x1b[0m`,
+  bold: s => `\x1b[1m${s}\x1b[0m`,
+};
+
+const pkg = require('../package.json');
+const VERSION = pkg.version;
+
+function printHeader(title) {
+  console.log(`\n${c.bold(c.blue('DevAssist'))} ${c.gray('v' + VERSION)} — ${title}\n`);
+}
+
+function printFinding(f) {
+  const sev = f.severity === 'block' ? c.red('[阻断]') :
+              f.severity === 'warn'  ? c.yellow('[警告]') :
+              c.gray('[提示]');
+  console.log(`  ${sev} ${f.message}`);
+  if (f.file) console.log(`         ${c.gray(f.file)}${f.line ? `:${f.line}` : ''}`);
+  if (f.suggestion) console.log(`         ${c.gray('→ ' + f.suggestion)}`);
+
+  // N-engine: iterate aiAnalyses array
+  if (f.aiAnalyses && f.aiAnalyses.length > 0) {
+    const colors = [c.blue, c.magenta, c.green, c.cyan, c.yellow];
+    for (let i = 0; i < f.aiAnalyses.length; i++) {
+      const ea = f.aiAnalyses[i];
+      const colorFn = colors[i % colors.length];
+      if (ea.available && ea.analysis) {
+        const a = ea.analysis;
+        console.log(`         ${colorFn(`AI[${ea.engineName}]：`)} ${a.rootCause || a.fix || '（无详情）'}`);
+        if (a.confidence !== undefined) console.log(`         ${c.gray('置信度：' + (a.confidence * 100).toFixed(0) + '%')}`);
+      } else {
+        console.log(`         ${c.gray(`AI[${ea.engineName}]：不可用`)}`);
+      }
+    }
+  } else if (f.aiAnalysis && !f.aiAnalysisUnavailable) {
+    // Backward compat: single engine legacy field
+    console.log(`         ${c.blue('AI：')} ${f.aiAnalysis.rootCause || f.aiAnalysis.fix || '（无详情）'}`);
+    if (f.aiAnalysis.confidence) console.log(`         ${c.gray('置信度：' + f.aiAnalysis.confidence)}`);
+  }
+  if (f.aiAnalysisUnavailable && (!f.aiAnalyses || f.aiAnalyses.length === 0)) {
+    console.log(`         ${c.gray('（AI 分析不可用）')}`);
+  }
+  console.log();
+}
+
+function printStats(stats) {
+  console.log(c.gray('  ────────────────────────────────────────'));
+  console.log(`  规则：    ${stats.passed} 通过，${stats.failed} 触发`);
+  console.log(`  发现：    ${c.red(stats.blocks + ' 阻断')}，${c.yellow(stats.warnings + ' 警告')}，${stats.infos + ' 提示'}`);
+  console.log(c.gray('  ────────────────────────────────────────\n'));
+}
+
+// Resolve paths relative to this file
+const cmdDir = path.join(__dirname, '..', 'src', 'cli', 'commands');
+
+// Route to command handler
+async function main() {
+  try {
+    switch (command) {
+      case 'init':
+        return require(path.join(cmdDir, 'init'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'check':
+        return require(path.join(cmdDir, 'check'))(projectRoot, args.slice(1), { printHeader, printFinding, printStats, c });
+      case 'deploy':
+        return require(path.join(cmdDir, 'deploy'))(projectRoot, args.slice(1), { printHeader, printFinding, c });
+      case 'debt':
+        return require(path.join(cmdDir, 'debt'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'convention':
+        return require(path.join(cmdDir, 'convention'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'schema':
+        return require(path.join(cmdDir, 'schema'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'backup':
+        return require(path.join(cmdDir, 'backup'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'restore':
+        return require(path.join(cmdDir, 'restore'))(projectRoot, args.slice(1), { printHeader, printFinding, c });
+      case 'ask':
+        return require(path.join(cmdDir, 'ask'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'ai':
+        return require(path.join(cmdDir, 'ai'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'inject':
+        return require(path.join(cmdDir, 'inject'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'doctor':
+        return require(path.join(cmdDir, 'doctor'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'clean':
+        return require(path.join(cmdDir, 'clean'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'fix':
+        return require(path.join(cmdDir, 'fix'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'watch':
+        return require(path.join(cmdDir, 'watch'))(projectRoot, args.slice(1), { printHeader, printFinding, c });
+      case 'report':
+        return require(path.join(cmdDir, 'report'))(projectRoot, args.slice(1), { printHeader, printFinding, c });
+      case 'diff':
+        return require(path.join(cmdDir, 'diff'))(projectRoot, args.slice(1), { printHeader, printFinding, printStats, c });
+      case 'version':
+      case '--version':
+      case '-v':
+        console.log('DevAssist v' + VERSION);
+        return;
+      case 'help':
+      case '--help':
+      case '-h':
+      default:
+        printHelp();
+    }
+  } catch (err) {
+    console.error(`\n${c.red('错误：')} ${err.message}\n`);
+    if (process.env.DEVASSIST_DEBUG) {
+      console.error(err.stack);
+    }
+    process.exit(1);
+  }
+}
+
+function printHelp() {
+  printHeader('开发守护 CLI');
+  console.log(`${c.bold('用法：')} devassist <命令> [选项]\n`);
+  console.log(`${c.bold('命令：')}`);
+  console.log(`  ${c.green('init')}                  初始化项目——创建 .devassist/ 配置与基础代码`);
+  console.log(`  ${c.green('check')}                 运行全部开发时检查（代码质量 + 约定 + 模式 + 架构）`);
+  console.log(`  ${c.green('watch')}                 实时监控文件变更并运行检查`);
+  console.log(`  ${c.green('diff')} ${c.gray('--staged|--base <分支>')}  仅检查变更文件（CI 模式）`);
+  console.log(`  ${c.green('report')} ${c.gray('[--open]')}          生成 HTML 检查报告`);
+  console.log(`  ${c.green('deploy')} ${c.gray('--check')}           部署前验证（端口 + 路由 + MIME + 清单）`);
+  console.log(`  ${c.green('debt')} ${c.gray('--scan')}              查看技术债务看板（按优先级排序）`);
+  console.log(`  ${c.green('convention')} ${c.gray('add|list|remove')}  管理项目约定`);
+  console.log(`  ${c.green('schema')} ${c.gray('import|list')}        导入数据库 DDL 模式 / 列出已注册模式`);
+  console.log(`  ${c.green('backup')} ${c.gray('[标签]')}              创建增量备份`);
+  console.log(`  ${c.green('restore')} ${c.gray('<版本ID>')}            从备份恢复（非破坏性）`);
+  console.log(`  ${c.green('ask')} ${c.gray('<问题>')}                 向 AI 提问关于代码库的问题`);
+  console.log(`  ${c.green('ai')} ${c.gray('--status|--setup|--add-engine|--compare|--watch-list')}  AI 配置/多引擎/对比/待观察`);
+  console.log(`  ${c.green('inject')} ${c.gray('[--format <fmt>]')}      生成约定文件供 AI Agent 读取`);
+  console.log(`  ${c.green('doctor')}                  环境诊断——检查 Node/Git/配置完整性`);
+  console.log(`  ${c.green('clean')} ${c.gray('[--days <n>]')}           清理旧报告/备份/历史`);
+  console.log(`  ${c.green('fix')} ${c.gray('[--all|--dry-run]')}         自动修复常见代码问题`);
+  console.log(`\n${c.bold('选项：')}`);
+  console.log(`  ${c.gray('--port <n>')}          指定部署检查的端口`);
+  console.log(`  ${c.gray('--ai')}                启用 AI 深度分析（需配置）`);
+  console.log(`  ${c.gray('--compare')}           多引擎对比分析（所有引擎并行）`);
+  console.log(`  ${c.gray('--json')}              输出 JSON 格式（用于 CI 集成）`);
+  console.log(`  ${c.gray('--fail-on <级别>')}    在以下级别非零退出：block（默认）或 warn`);
+  console.log(`  ${c.gray('--base-code')}         安装运行时基础设施（Layer 2）`);
+  console.log(`  ${c.gray('--force')}             覆盖已有配置`);
+  console.log(`  ${c.gray('-v, --version')}       显示版本`);
+  console.log(`  ${c.gray('-h, --help')}          显示帮助\n`);
+  console.log(`${c.bold('示例：')}`);
+  console.log(`  ${c.gray('$')} devassist init`);
+  console.log(`  ${c.gray('$')} devassist check --ai`);
+  console.log(`  ${c.gray('$')} devassist watch              # 开发时实时监控`);
+  console.log(`  ${c.gray('$')} devassist diff --staged       # 提交前检查暂存文件`);
+  console.log(`  ${c.gray('$')} devassist report --open       # 生成并查看 HTML 报告`);
+  console.log(`  ${c.gray('$')} devassist convention add --id naming-list --rule "使用 data.list 而非 data.items" --severity block`);
+  console.log(`  ${c.gray('$')} devassist deploy --check --port 8080`);
+  console.log(`  ${c.gray('$')} devassist schema import schema.sql`);
+  console.log(`  ${c.gray('$')} devassist ask "为什么 API 返回 data.items 而不是 data.list？"`);
+  console.log(`  ${c.gray('$')} devassist ai --setup --provider qwen --key sk-xxxx`);
+  console.log(`  ${c.gray('$')} devassist ai --add-engine --provider hunyuan --key sk-xxxx`);
+  console.log(`  ${c.gray('$')} devassist ai --add-engine --provider openai --key sk-xxxx   # 三引擎`);
+  console.log(`  ${c.gray('$')} devassist ai --list-engines                              # 查看所有引擎`);
+  console.log(`  ${c.gray('$')} devassist ai --compare                                   # 多引擎对比分析`);
+  console.log(`  ${c.gray('$')} devassist check --ai --compare                            # 检查 + 多引擎对比`);
+  console.log(`  ${c.gray('$')} devassist ai --watch-list                                # 查看待观察列表`);
+  console.log(`  ${c.gray('$')} devassist ai --watch-list --resolve 0                    # 标记为已修复`);
+  console.log(`  ${c.gray('$')} devassist ai --watch-list --dismiss 0                    # 标记为无问题`);
+  console.log(`  ${c.gray('$')} devassist ai --test`);
+  console.log(`  ${c.gray('$')} devassist inject --format cursor       # 生成 .cursorrules 约定文件`);
+  console.log(`  ${c.gray('$')} devassist doctor                        # 环境诊断`);
+  console.log(`  ${c.gray('$')} devassist clean --days 30               # 清理30天前的旧文件`);
+  console.log(`  ${c.gray('$')} devassist fix --all --dry-run           # 预览自动修复\n`);
+}
+
+main();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "devassist-agent",
+  "version": "1.0.0",
+  "description": "AI Agent 开发质量守护工具 — 30+规则检测代码缺陷/安全漏洞/性能反模式，多引擎AI根因分析，零外部依赖",
+  "main": "src/index.js",
+  "bin": {
+    "devassist": "bin/devassist.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "tests/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node tests/run-all.js",
+    "test:layer2": "node tests/test-layer2.js",
+    "devassist": "node bin/devassist.js"
+  },
+  "keywords": [
+    "ai-agent",
+    "code-quality",
+    "code-review",
+    "lint",
+    "security",
+    "static-analysis",
+    "guardrails",
+    "convention",
+    "tech-debt",
+    "cli",
+    "zero-dependency",
+    "qwen",
+    "hunyuan",
+    "codeguard"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {}
+}