@chongyan/autospec 1.0.2 → 1.0.4

package/plugins/hooks/environment-autocommit.js

@@ -1,606 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec Hook: Environment Autocommit
- *
- * 环境知识自动提交 Hook（智能决策版）
- * 触发时机：Stop 事件
- *
- * 智能决策机制：
- * 1. 变更分类评估：纯新增/配置更新/文档更新 → 自动提交；删除/敏感字段 → 需确认
- * 2. 安全检查：文件大小异常/敏感信息泄露/格式验证
- * 3. 版本管理：本地提交自动执行；推送远端默认关闭；冲突检测
- * 4. 决策报告：生成提交/跳过/需确认的决策报告
- */
-
-import fs from 'fs';
-import path from 'path';
-import { createHookLogger, readStdin, findProjectRootAsync } from './lib/hook-logger.js';
-
-const logger = createHookLogger('environment-autocommit');
-
-// 敏感字段模式（需要确认）
-const SENSITIVE_PATTERNS = [
-  /password/i,
-  /secret/i,
-  /api[_-]?key/i,
-  /token/i,
-  /private[_-]?key/i,
-  /credential/i,
-  /auth/i,
-  /encrypt/i,
-  /salt/i,
-  /hash/i
-];
-
-// 配置文件模式（高安全度）
-const CONFIG_PATTERNS = [
-  /port/i,
-  /host/i,
-  /endpoint/i,
-  /version/i,
-  /timeout/i,
-  /retry/i,
-  /pool/i,
-  /connection/i
-];
-
-/**
- * 检查是否为 git 仓库
- */
-function isGitRepo(dir) {
-  return fs.existsSync(path.join(dir, '.git'));
-}
-
-/**
- * 检测是否有冲突
- */
-function hasConflicts(repoDir) {
-  const { execSync } = require('child_process');
-  try {
-    const status = execSync('git status --porcelain', {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    });
-    return status.split('\n').some(line => line.startsWith('UU') || line.startsWith('AA') || line.startsWith('DD'));
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * 获取 git 状态
- */
-function getGitStatus(repoDir) {
-  const { execSync } = require('child_process');
-
-  try {
-    const status = execSync('git status --porcelain', {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    });
-    return status;
-  } catch (e) {
-    return '';
-  }
-}
-
-/**
- * 获取文件变更类型和原始路径
- */
-function parseGitStatusLine(line) {
-  const statusCode = line.substring(0, 2);
-  const filePath = line.substring(3).trim();
-
-  // 状态码解析
-  const staged = statusCode[0];
-  const unstaged = statusCode[1];
-
-  let changeType = 'unknown';
-  if (staged === 'A' || unstaged === 'A') changeType = 'added';
-  else if (staged === 'M' || unstaged === 'M') changeType = 'modified';
-  else if (staged === 'D' || unstaged === 'D') changeType = 'deleted';
-  else if (staged === 'R') changeType = 'renamed';
-  else if (staged === 'C') changeType = 'copied';
-  else if (staged === '?' || unstaged === '?') changeType = 'untracked';
-
-  return { changeType, filePath, statusCode };
-}
-
-/**
- * 获取文件内容
- */
-function getFileContent(repoDir, filePath) {
-  try {
-    const fullPath = path.join(repoDir, filePath);
-    if (!fs.existsSync(fullPath)) return null;
-    return fs.readFileSync(fullPath, 'utf-8');
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * 获取文件大小
- */
-function getFileSize(repoDir, filePath) {
-  try {
-    const fullPath = path.join(repoDir, filePath);
-    if (!fs.existsSync(fullPath)) return 0;
-    const stats = fs.statSync(fullPath);
-    return stats.size;
-  } catch (e) {
-    return 0;
-  }
-}
-
-/**
- * 获取文件的 git 历史大小（用于比较）
- */
-function getGitFileSize(repoDir, filePath) {
-  const { execSync } = require('child_process');
-  try {
-    const size = execSync(`git cat-file -s HEAD:"${filePath}" 2>/dev/null || echo 0`, {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    }).trim();
-    return parseInt(size, 10) || 0;
-  } catch (e) {
-    return 0;
-  }
-}
-
-/**
- * 检查是否包含敏感信息
- */
-function containsSensitiveInfo(content) {
-  if (!content) return false;
-  return SENSITIVE_PATTERNS.some(pattern => pattern.test(content));
-}
-
-/**
- * 检查是否为纯配置更新（高安全度）
- */
-function isConfigUpdate(content) {
-  if (!content) return false;
-  // 如果内容主要是配置项（包含多个配置模式），则认为是配置更新
-  const configMatches = CONFIG_PATTERNS.filter(pattern => pattern.test(content));
-  return configMatches.length >= 2;
-}
-
-/**
- * 检查 JSON/YAML 格式有效性
- */
-function validateFormat(filePath, content) {
-  const ext = path.extname(filePath).toLowerCase();
-
-  if (ext === '.json') {
-    try {
-      JSON.parse(content);
-      return { valid: true, error: null };
-    } catch (e) {
-      return { valid: false, error: `JSON 格式错误: ${e.message}` };
-    }
-  }
-
-  if (ext === '.yaml' || ext === '.yml') {
-    // 基础 YAML 检查（缩进、冒号等）
-    const lines = content.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-      // 检查混合缩进
-      if (line.match(/\t/) && line.match(/ /)) {
-        return { valid: false, error: `YAML 格式错误: 第 ${i + 1} 行混用空格和制表符` };
-      }
-    }
-    return { valid: true, error: null };
-  }
-
-  return { valid: true, error: null };
-}
-
-/**
- * 评估单个文件的变更风险
- */
-function assessFileRisk(repoDir, changeInfo) {
-  const { changeType, filePath } = changeInfo;
-  const content = getFileContent(repoDir, filePath);
-  const currentSize = getFileSize(repoDir, filePath);
-  const originalSize = getGitFileSize(repoDir, filePath);
-
-  const assessment = {
-    filePath,
-    changeType,
-    decision: 'pending',
-    reason: [],
-    riskLevel: 'low'
-  };
-
-  // 1. 变更类型评估
-  if (changeType === 'deleted') {
-    assessment.decision = 'confirm';
-    assessment.reason.push('删除操作需要确认');
-    assessment.riskLevel = 'high';
-    return assessment;
-  }
-
-  if (changeType === 'added') {
-    assessment.decision = 'auto';
-    assessment.reason.push('纯新增文件');
-  }
-
-  // 2. 文件大小异常检查（变化 > 50% 需确认）
-  if (originalSize > 0 && currentSize > 0) {
-    const sizeChangeRatio = Math.abs(currentSize - originalSize) / originalSize;
-    if (sizeChangeRatio > 0.5) {
-      assessment.decision = 'confirm';
-      assessment.reason.push(`文件大小变化超过 50% (${(sizeChangeRatio * 100).toFixed(1)}%)`);
-      assessment.riskLevel = 'medium';
-      return assessment;
-    }
-  }
-
-  // 3. 敏感信息泄露扫描
-  if (containsSensitiveInfo(content)) {
-    assessment.decision = 'confirm';
-    assessment.reason.push('包含敏感字段（password/secret/key 等）');
-    assessment.riskLevel = 'high';
-    return assessment;
-  }
-
-  // 4. 格式有效性验证
-  if (content) {
-    const formatCheck = validateFormat(filePath, content);
-    if (!formatCheck.valid) {
-      assessment.decision = 'skip';
-      assessment.reason.push(formatCheck.error);
-      assessment.riskLevel = 'high';
-      return assessment;
-    }
-  }
-
-  // 5. 配置更新识别（高安全度）
-  if (changeType === 'modified' && content && isConfigUpdate(content)) {
-    assessment.decision = 'auto';
-    assessment.reason.push('配置值更新（端口、版本、超时等）');
-    assessment.riskLevel = 'low';
-  }
-
-  // 6. 文档内容更新
-  if (changeType === 'modified' && filePath.endsWith('.md')) {
-    assessment.decision = 'auto';
-    assessment.reason.push('文档内容更新');
-    assessment.riskLevel = 'low';
-  }
-
-  // 默认决策
-  if (assessment.decision === 'pending') {
-    if (changeType === 'modified') {
-      assessment.decision = 'auto';
-      assessment.reason.push('常规内容更新');
-      assessment.riskLevel = 'low';
-    } else {
-      assessment.decision = 'confirm';
-      assessment.reason.push('未识别的变更类型');
-      assessment.riskLevel = 'medium';
-    }
-  }
-
-  return assessment;
-}
-
-/**
- * 获取当前分支名
- */
-function getCurrentBranch(repoDir) {
-  const { execSync } = require('child_process');
-
-  try {
-    const branch = execSync('git branch --show-current', {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    }).trim();
-    return branch;
-  } catch (e) {
-    return 'main';
-  }
-  }
-
-/**
- * 执行 git add
- */
-function gitAdd(repoDir, files) {
-  const { execSync } = require('child_process');
-
-  try {
-    execSync(`git add ${files.join(' ')}`, {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    });
-    return true;
-  } catch (e) {
-    logger.error('git add failed', { error: e.message });
-    return false;
-  }
-}
-
-/**
- * 执行 git commit
- */
-function gitCommit(repoDir, message) {
-  const { execSync } = require('child_process');
-
-  try {
-    execSync(`git commit -m "${message}"`, {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    });
-    return true;
-  } catch (e) {
-    logger.error('git commit failed', { error: e.message });
-    return false;
-  }
-}
-
-/**
- * 执行 git push
- */
-function gitPush(repoDir) {
-  const { execSync } = require('child_process');
-
-  try {
-    execSync('git push', {
-      cwd: repoDir,
-      encoding: 'utf-8'
-    });
-    return true;
-  } catch (e) {
-    logger.error('git push failed', { error: e.message });
-    return false;
-  }
-}
-
-/**
- * 加载配置
- */
-function loadConfig(projectRoot) {
-  const configPath = path.join(projectRoot, '.autospec', 'environment', 'autocommit.json');
-
-  if (!fs.existsSync(configPath)) {
-    // 返回默认配置
-    return {
-      enabled: false,
-      autoPush: false,  // 默认关闭自动推送
-      messageTemplate: 'chore: 更新环境知识 {date}',
-      paths: ['.autospec/environment/'],
-      smartCommit: true,  // 启用智能决策
-      confirmOnDelete: true,
-      confirmOnSensitive: true,
-      maxAutoSizeChange: 0.5  // 50% 大小变化阈值
-    };
-  }
-
-  try {
-    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    // 合并默认值
-    return {
-      smartCommit: true,
-      confirmOnDelete: true,
-      confirmOnSensitive: true,
-      maxAutoSizeChange: 0.5,
-      ...config
-    };
-  } catch (e) {
-    logger.warn('Failed to load autocommit config', { error: e.message });
-    return { enabled: false };
-  }
-}
-
-/**
- * 生成提交消息
- */
-function generateCommitMessage(template, assessments) {
-  const date = new Date().toISOString().split('T')[0];
-  let message = template.replace('{date}', date);
-
-  // 统计变更类型
-  const autoFiles = assessments.filter(a => a.decision === 'auto');
-  const confirmFiles = assessments.filter(a => a.decision === 'confirm');
-
-  if (autoFiles.length > 0) {
-    const summary = autoFiles.map(a => path.basename(a.filePath)).join(', ');
-    message += `\n\n自动提交 (${autoFiles.length} 个): ${summary}`;
-  }
-
-  if (confirmFiles.length > 0) {
-    const summary = confirmFiles.map(a => path.basename(a.filePath)).join(', ');
-    message += `\n\n需确认 (${confirmFiles.length} 个): ${summary}`;
-  }
-
-  return message;
-}
-
-/**
- * 生成决策报告
- */
-function generateDecisionReport(assessments) {
-  const auto = assessments.filter(a => a.decision === 'auto');
-  const confirm = assessments.filter(a => a.decision === 'confirm');
-  const skip = assessments.filter(a => a.decision === 'skip');
-
-  let report = '\n📊 智能提交决策报告\n';
-  report += '═'.repeat(50) + '\n';
-
-  if (auto.length > 0) {
-    report += `\n✅ 自动提交 (${auto.length} 个):\n`;
-    auto.forEach(a => {
-      report += `   • ${path.basename(a.filePath)} - ${a.reason[0]}\n`;
-    });
-  }
-
-  if (confirm.length > 0) {
-    report += `\n⚠️  需人工确认 (${confirm.length} 个):\n`;
-    confirm.forEach(a => {
-      report += `   • ${path.basename(a.filePath)}\n`;
-      a.reason.forEach(r => {
-        report += `     - ${r}\n`;
-      });
-    });
-  }
-
-  if (skip.length > 0) {
-    report += `\n❌ 已跳过 (${skip.length} 个):\n`;
-    skip.forEach(a => {
-      report += `   • ${path.basename(a.filePath)} - ${a.reason[0]}\n`;
-    });
-  }
-
-  report += '\n' + '═'.repeat(50) + '\n';
-  report += `总计: ${assessments.length} 个文件 | 自动: ${auto.length} | 确认: ${confirm.length} | 跳过: ${skip.length}\n`;
-
-  return { report, auto, confirm, skip };
-}
-
-/**
- * 处理 Stop 事件
- */
-async function handleStop(projectRoot) {
-  // 检查是否为 git 仓库
-  if (!isGitRepo(projectRoot)) {
-    logger.debug('Not a git repo, skipping autocommit');
-    process.exit(0);
-  }
-
-  // 检查是否有冲突
-  if (hasConflicts(projectRoot)) {
-    logger.warn('Git conflicts detected, skipping autocommit');
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: 'Stop',
-        additionalContext: '[AutoSpec] 检测到 Git 冲突，跳过自动提交。请手动解决冲突后再提交。',
-      },
-    };
-    process.stdout.write(JSON.stringify(output));
-    process.exit(0);
-  }
-
-  // 加载配置
-  const config = loadConfig(projectRoot);
-
-  if (!config.enabled) {
-    logger.debug('Autocommit is disabled');
-    process.exit(0);
-  }
-
-  // 检查环境知识目录
-  const envDir = path.join(projectRoot, '.autospec', 'environment');
-  if (!fs.existsSync(envDir)) {
-    process.exit(0);
-  }
-
-  // 获取 git 状态
-  const status = getGitStatus(projectRoot);
-
-  // 过滤出环境知识目录的变更
-  const envPaths = config.paths || ['.autospec/environment/'];
-  const changedFiles = status.split('\n')
-    .filter(line => line.trim())
-    .map(line => parseGitStatusLine(line))
-    .filter(info => envPaths.some(p => info.filePath.startsWith(p)));
-
-  if (changedFiles.length === 0) {
-    logger.debug('No environment knowledge changes');
-    process.exit(0);
-  }
-
-  logger.info('Detected environment knowledge changes', { files: changedFiles.map(f => f.filePath) });
-
-  // 智能决策评估
-  const assessments = changedFiles.map(info => assessFileRisk(projectRoot, info));
-  const { report, auto, confirm, skip } = generateDecisionReport(assessments);
-
-  logger.info(report);
-
-  // 如果没有可以自动提交的文件，直接退出
-  if (auto.length === 0) {
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: 'Stop',
-        additionalContext: `[AutoSpec] 环境知识变更需要人工确认。${confirm.length} 个文件待确认，${skip.length} 个文件已跳过。`,
-      },
-    };
-    process.stdout.write(JSON.stringify(output));
-    process.exit(0);
-  }
-
-  // 执行 git add（只添加自动提交的文件）
-  const autoFilePaths = auto.map(a => a.filePath);
-  const addResult = gitAdd(projectRoot, autoFilePaths);
-  if (!addResult) {
-    process.exit(0);
-  }
-
-  // 生成提交消息
-  const message = generateCommitMessage(config.messageTemplate || 'chore: 更新环境知识', assessments);
-
-  // 执行 git commit
-  const commitResult = gitCommit(projectRoot, message);
-  if (!commitResult) {
-    process.exit(0);
-  }
-
-  logger.info('Committed environment knowledge changes', { message });
-
-  // 如果配置了自动 push（默认关闭）
-  let pushResult = false;
-  if (config.autoPush) {
-    pushResult = gitPush(projectRoot);
-    if (pushResult) {
-      logger.info('Pushed environment knowledge changes');
-    }
-  }
-
-  // 输出结果
-  const branch = getCurrentBranch(projectRoot);
-  const output = {
-    hookSpecificOutput: {
-      hookEventName: 'Stop',
-      additionalContext: `[AutoSpec] 环境知识已智能提交到 ${branch} 分支。自动: ${auto.length} 个${config.autoPush && pushResult ? '并推送' : ''}，需确认: ${confirm.length} 个，跳过: ${skip.length} 个`,
-    },
-  };
-
-  process.stdout.write(JSON.stringify(output));
-}
-
-/**
- * 主函数
- */
-async function main() {
-  try {
-    const inputRaw = await readStdin(1000);
-    const input = JSON.parse(inputRaw);
-
-    const eventName = input.event_name;
-
-    if (eventName === 'Stop') {
-      const cwd = input.cwd || process.cwd();
-      const projectRoot = await findProjectRootAsync(cwd);
-
-      if (!projectRoot) {
-        process.exit(0);
-      }
-
-      await handleStop(projectRoot);
-    } else {
-      logger.debug('Unknown event type, skipping', { eventName });
-    }
-
-    process.exit(0);
-
-  } catch (e) {
-    logger.error('Hook error', { error: e.message });
-    process.exit(0);
-  }
-}
-
-main();