@chongyan/autospec 1.0.1 → 1.0.2

package/plugins/hooks/environment-autocommit.js

@@ -3,12 +3,14 @@
 /**
  * AutoSpec Hook: Environment Autocommit
  *
- * 环境知识自动提交 Hook
+ * 环境知识自动提交 Hook（智能决策版）
  * 触发时机：Stop 事件
- * 功能：
- * 1. 检测 .autospec/environment/ 目录的变化
- * 2. 自动执行 git add + commit
- * 3. 可配置是否自动 push
+ *
+ * 智能决策机制：
+ * 1. 变更分类评估：纯新增/配置更新/文档更新 → 自动提交；删除/敏感字段 → 需确认
+ * 2. 安全检查：文件大小异常/敏感信息泄露/格式验证
+ * 3. 版本管理：本地提交自动执行；推送远端默认关闭；冲突检测
+ * 4. 决策报告：生成提交/跳过/需确认的决策报告
  */
 
 import fs from 'fs';
@@ -17,6 +19,32 @@ import { createHookLogger, readStdin, findProjectRootAsync } from './lib/hook-lo
 
 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 仓库
  */
@@ -24,6 +52,22 @@ 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 状态
  */
@@ -41,6 +85,210 @@ function getGitStatus(repoDir) {
   }
 }
 
+/**
+ * 获取文件变更类型和原始路径
+ */
+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;
+}
+
 /**
  * 获取当前分支名
  */
@@ -56,7 +304,7 @@ function getCurrentBranch(repoDir) {
   } catch (e) {
     return 'main';
   }
-}
+  }
 
 /**
  * 执行 git add
@@ -122,14 +370,26 @@ function loadConfig(projectRoot) {
     // 返回默认配置
     return {
       enabled: false,
-      autoPush: false,
+      autoPush: false,  // 默认关闭自动推送
       messageTemplate: 'chore: 更新环境知识 {date}',
-      paths: ['.autospec/environment/']
+      paths: ['.autospec/environment/'],
+      smartCommit: true,  // 启用智能决策
+      confirmOnDelete: true,
+      confirmOnSensitive: true,
+      maxAutoSizeChange: 0.5  // 50% 大小变化阈值
     };
   }
 
   try {
-    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    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 };
@@ -139,19 +399,68 @@ function loadConfig(projectRoot) {
 /**
  * 生成提交消息
  */
-function generateCommitMessage(template, changes) {
+function generateCommitMessage(template, assessments) {
   const date = new Date().toISOString().split('T')[0];
   let message = template.replace('{date}', date);
 
-  // 如果有具体变更，添加到消息中
-  if (changes.length > 0) {
-    const summary = changes.map(c => path.basename(c)).join(', ');
-    message += `\n\n变更文件: ${summary}`;
+  // 统计变更类型
+  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 事件
  */
@@ -162,6 +471,19 @@ async function handleStop(projectRoot) {
     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);
 
@@ -183,24 +505,43 @@ async function handleStop(projectRoot) {
   const envPaths = config.paths || ['.autospec/environment/'];
   const changedFiles = status.split('\n')
     .filter(line => line.trim())
-    .map(line => line.substring(3).trim())
-    .filter(file => envPaths.some(p => file.startsWith(p)));
+    .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 });
+  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 addResult = gitAdd(projectRoot, changedFiles);
+  // 执行 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: 更新环境知识', changedFiles);
+  const message = generateCommitMessage(config.messageTemplate || 'chore: 更新环境知识', assessments);
 
   // 执行 git commit
   const commitResult = gitCommit(projectRoot, message);
@@ -210,9 +551,10 @@ async function handleStop(projectRoot) {
 
   logger.info('Committed environment knowledge changes', { message });
 
-  // 如果配置了自动 push
+  // 如果配置了自动 push（默认关闭）
+  let pushResult = false;
   if (config.autoPush) {
-    const pushResult = gitPush(projectRoot);
+    pushResult = gitPush(projectRoot);
     if (pushResult) {
       logger.info('Pushed environment knowledge changes');
     }
@@ -223,7 +565,7 @@ async function handleStop(projectRoot) {
   const output = {
     hookSpecificOutput: {
       hookEventName: 'Stop',
-      additionalContext: `[AutoSpec] 环境知识已自动提交到 ${branch} 分支${config.autoPush ? '并推送' : ''}。变更文件: ${changedFiles.length} 个`,
+      additionalContext: `[AutoSpec] 环境知识已智能提交到 ${branch} 分支。自动: ${auto.length} 个${config.autoPush && pushResult ? '并推送' : ''}，需确认: ${confirm.length} 个，跳过: ${skip.length} 个`,
     },
   };
 
@@ -261,4 +603,4 @@ async function main() {
   }
 }
 
-main();
+main();

package/plugins/hooks/environment-manager.js

@@ -590,12 +590,13 @@ function detectDesignDocChanges(projectRoot) {
 }
 
 /**
- * 检测业务知识变更 - 扫描 knowledge/domain/ 目录
+ * 检测业务知识变更 - 扫描业务知识目录
  */
 function detectBusinessKnowledgeChanges(projectRoot) {
   const changes = [];
   const dirsToCheck = [
-    'knowledge/domain',
+    'knowledge/09-templates/05-business-glossary.md',
+    'knowledge/09-templates/06-business-rules.md',
     'docs/business'
   ];
 

package/plugins/hooks/execution-tracker.js

@@ -19,7 +19,7 @@
 
 import { createHookLogger, safeJsonParse, handleHookError, readStdin, findProjectRootAsync } from './lib/hook-logger.js';
 import { recordHookExecution } from './lib/hook-error-recorder.js';
-import { getState } from './lib/hook-state-manager.js';
+import { getState, getCurrentStageSubsystems, updateState } from './lib/hook-state-manager.js';
 import { generateEventId, getTraceId, appendTraceEvent } from './lib/trace-context.js';
 import fs from 'fs';
 import path from 'path';
@@ -173,7 +173,7 @@ async function main() {
   const toolName = input.tool_name;
 
   // Track Write operations for artifact generation
-  if (toolName === 'Write') {
+  if (toolName === 'Write' || toolName === 'Edit') {
     const filePath = input.tool_input?.file_path || '';
 
     // Find project root
@@ -185,6 +185,60 @@ async function main() {
       process.exit(0);
     }
 
+    // ========== 子系统代码变更追踪 ==========
+    const state = getState(projectRoot, true);
+    const subsystems = getCurrentStageSubsystems(projectRoot);
+
+    if (subsystems.length > 0 && filePath && !filePath.includes('.autospec')) {
+      // 检测文件变更属于哪个子系统
+      const relativePath = filePath.replace(projectRoot + '/', '').replace(projectRoot + '\\\\', '');
+      const matchedSubsystem = subsystems.find(sub =>
+        relativePath.startsWith(sub.path + '/') ||
+        relativePath.startsWith(sub.path + '\\') ||
+        relativePath.startsWith(sub.name + '/')
+      );
+
+      if (matchedSubsystem) {
+        // 更新子系统的变更计数
+        const subsystemKey = `stages.${state.currentStage}.subsystems`;
+        const stageData = state.stages[state.currentStage];
+
+        if (stageData?.subsystems) {
+          const subsystem = stageData.subsystems.find(s => s.name === matchedSubsystem.name);
+          if (subsystem) {
+            // 初始化或更新变更计数
+            if (!subsystem.changeCount) {
+              subsystem.changeCount = 0;
+            }
+            subsystem.changeCount++;
+            subsystem.lastChangeAt = new Date().toISOString();
+
+            // 记录变更文件列表
+            if (!subsystem.changedFiles) {
+              subsystem.changedFiles = [];
+            }
+            if (!subsystem.changedFiles.includes(relativePath)) {
+              subsystem.changedFiles.push(relativePath);
+            }
+
+            // 标记子系统为进行中（如果还是 pending 状态）
+            if (subsystem.status === 'pending') {
+              subsystem.status = 'in_progress';
+              subsystem.startedAt = subsystem.startedAt || new Date().toISOString();
+            }
+
+            updateState(projectRoot, state);
+            logger.debug('Subsystem code change tracked', {
+              subsystem: matchedSubsystem.name,
+              file: relativePath,
+              changeCount: subsystem.changeCount
+            });
+          }
+        }
+      }
+    }
+    // ==========================================
+
     // Check if this is a key artifact
     const artifactInfo = detectArtifactType(filePath);
     if (artifactInfo) {
@@ -222,8 +276,9 @@ async function main() {
       const traceEvent = createEvent(projectRoot, 'artifact_created', {
         stage: artifactInfo.stage,
         tool: 'Write',
-        action: 'create_artifact',
-        data: {
+        action: "create_artifact",
+        data:
+         {
           file: filePath,
           artifactType: artifactInfo.type,
           // 完整内容用于深度评测（仅关键文件）
@@ -332,6 +387,56 @@ async function main() {
                 }
               });
               appendTraceEvent(projectRoot, traceEvent);
+
+              // ========== 自动创建 practice-log 条目 ==========
+              // 当阶段完成时，自动记录到 practice-log
+              if (state.completedAt && !state.stageLogged) {
+                const practiceLogDir = path.join(projectRoot, '.autospec', 'practice-log');
+                if (!fs.existsSync(practiceLogDir)) {
+                  fs.mkdirSync(practiceLogDir, { recursive: true });
+                }
+
+                const date = new Date().toISOString().split('T')[0];
+                const stageName = state.currentStage.replace('0', '').replace('-', '');
+                const logFile = path.join(practiceLogDir, `${date}-${stageName}.md`);
+
+                // 如果文件已存在，不重复创建
+                if (!fs.existsSync(logFile)) {
+                  const template = `# 实践日志 - ${state.currentStage}
+
+日期：${date}
+阶段：${state.currentStage}
+完成时间：${state.completedAt}
+
+## 问题描述
+
+<!-- 描述遇到的问题 -->
+
+## 解决方案
+
+<!-- 描述解决方案 -->
+
+## 经验总结
+
+<!-- 描述可以复用的经验 -->
+
+## 相关文件
+
+<!-- 列出相关文件 -->
+
+## 标签
+
+<!-- 添加标签，如：bugfix, optimization, pattern -->
+`;
+                  fs.writeFileSync(logFile, template, 'utf-8');
+                  logger.info('Practice-log auto-created', { file: logFile });
+
+                  // 标记已记录，防止重复
+                  state.stageLogged = true;
+                  fs.writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf-8');
+                }
+              }
+              // ==============================================
             }
           } catch {
             // Ignore state.json parsing errors