@chongyan/autospec 1.0.2 → 1.0.3

package/plugins/hooks/pipeline-observer.js

@@ -1,413 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec Hook: Pipeline Observer
- *
- * 全链路事件采集和分析 Hook
- * - PostToolUse: 采集标准化事件
- * - Stop: 生成评测报告
- *
- * 职责：
- * 1. 采集标准化事件
- * 2. 实时计算指标
- * 3. 检测异常模式
- * 4. Stop 时触发评测报告生成
- */
-
-import { createHookLogger, safeJsonParse, handleHookError, readStdin, findProjectRootAsync } from './lib/hook-logger.js';
-import { getState, getMetrics, updateMetrics } from './lib/hook-state-manager.js';
-import { getTraceId, recordEvent } from './lib/trace-context.js';
-import { recordPathEvent, recordTool, recordDecision, PATH_EVENT_TYPES } from './lib/execution-path.js';
-import { calculateFrameworkQualityScore, detectErrorPatterns } from './lib/metrics-analyzer.js';
-
-const logger = createHookLogger('pipeline-observer');
-
-/**
- * PostToolUse 处理
- */
-async function handlePostToolUse(input, projectRoot) {
-  const toolName = input.tool_name;
-  const toolInput = input.tool_input || {};
-  const response = input.tool_response || {};
-
-  // 记录工具调用到执行路径
-  recordTool(projectRoot, toolName, detectAction(toolName, toolInput));
-
-  // 采集特定事件
-  switch (toolName) {
-    case 'AskUserQuestion':
-      handleUserQuestion(projectRoot, toolInput, response);
-      break;
-
-    case 'Agent':
-      handleAgentCall(projectRoot, toolInput, response);
-      break;
-
-    case 'Bash':
-      handleBashCommand(projectRoot, toolInput, response);
-      break;
-  }
-
-  // 实时检测异常模式
-  checkAnomalies(projectRoot);
-}
-
-/**
- * Stop 处理：生成评测报告 + 自动触发一致性检测
- */
-async function handleStop(projectRoot) {
-  logger.info('Session ending, generating evaluation report');
-
-  // 计算质量分数
-  const qualityScore = calculateFrameworkQualityScore(projectRoot);
-
-  // 检测错误模式
-  const errorPatterns = detectErrorPatterns(getMetrics(projectRoot, false));
-
-  // 更新 metrics.json
-  const metrics = getMetrics(projectRoot, false);
-  metrics.qualityScore = qualityScore;
-  metrics.errorPatterns = errorPatterns;
-  metrics.pipelineEnd = new Date().toISOString();
-
-  updateMetrics(projectRoot, metrics);
-
-  // 记录事件
-  const traceId = getTraceId(projectRoot);
-  if (traceId) {
-    recordEvent(projectRoot, 'pipeline_end', {
-      source: 'pipeline-observer',
-      action: 'generate_evaluation',
-       data: {
-        qualityScore: qualityScore.overall,
-        errorPatternCount: errorPatterns.length
-      }
-    });
-  }
-
-  // 自动触发一致性检测（如果有多个产出物）
-  const consistencyResult = await autoTriggerConsistencyCheck(projectRoot, metrics);
-
-  // 输出评测摘要
-  outputEvaluationSummary(qualityScore, errorPatterns, consistencyResult);
-}
-
-/**
- * 自动触发一致性检测
- */
-async function autoTriggerConsistencyCheck(projectRoot, metrics) {
-  const artifacts = metrics?.artifacts || {};
-  const artifactPaths = Object.keys(artifacts);
-
-  // 如果有 2 个以上产出物，触发一致性检测
-  if (artifactPaths.length < 2) {
-    return null;
-  }
-
-  logger.info('Auto-triggering consistency check', { artifactCount: artifactPaths.length });
-
-  // 记录一致性检测触发事件
-  const traceId = getTraceId(projectRoot);
-  if (traceId) {
-    recordEvent(projectRoot, 'consistency_check_triggered', {
-      source: 'pipeline-observer',
-      action: 'auto_consistency_check',
-       data: {
-        artifactCount: artifactPaths.length,
-        artifacts: artifactPaths
-      }
-    });
-  }
-
-  // 返回一致性检测提示
-  return {
-    triggered: true,
-    artifactCount: artifactPaths.length,
-    message: `
-[AutoSpec] 自动触发一致性检测
-
-检测到 ${artifactPaths.length} 个产出物，建议执行一致性分析：
-- 需求→设计 覆盖检查
-- 设计→实现 覆盖检查
-- 术语一致性检查
-
-详细评测请执行: /autospec:evaluate
-`
-  };
-}
-
-/**
- * 处理用户问题
- */
-function handleUserQuestion(projectRoot, toolInput, response) {
-  const questions = toolInput.questions || [];
-
-  // 记录决策点
-  recordDecision(projectRoot, 'human', {
-    questionCount: questions.length,
-    questionTypes: questions.map(q => q.header || 'unknown')
-  });
-
-  // 记录事件
-  const traceId = getTraceId(projectRoot);
-  if (traceId) {
-    recordEvent(projectRoot, 'human_intervention', {
-      source: 'pipeline-observer',
-      tool: 'AskUserQuestion',
-      action: 'ask_user',
-       data: {
-        questionCount: questions.length,
-        questions: questions.map(q => ({ header: q.header, question: q.question }))
-      }
-    });
-  }
-}
-
-/**
- * 处理 Agent 调用
- */
-function handleAgentCall(projectRoot, toolInput, response) {
-  const subagentType = toolInput.subagent_type || 'unknown';
-
-  // 记录决策点（Agent 调用通常是自动决策）
-  recordDecision(projectRoot, 'auto', {
-    agentType: subagentType
-  });
-
-  // 记录事件
-  const traceId = getTraceId(projectRoot);
-  if (traceId) {
-    const success = !response.error;
-    recordEvent(projectRoot, success ? 'agent_success' : 'agent_fail', {
-      source: 'pipeline-observer',
-      tool: 'Agent',
-      action: 'call_agent',
-       data: {
-        subagentType,
-        success
-      }
-    });
-  }
-}
-
-/**
- * 处理 Bash 命令
- */
-function handleBashCommand(projectRoot, toolInput, response) {
-  const command = toolInput.command || '';
-
-  // 检测命令类型
-  const commandType = detectCommandType(command);
-
-  if (commandType) {
-    const traceId = getTraceId(projectRoot);
-    if (traceId) {
-      const success = response.exitCode === 0;
-      recordEvent(projectRoot, success ? 'command_success' : 'command_fail', {
-        source: 'pipeline-observer',
-        tool: 'Bash',
-        action: commandType,
-        data: {
-          command: command.substring(0, 100),
-          exitCode: response.exitCode
-        }
-      });
-    }
-  }
-}
-
-/**
- * 检测工具动作
- */
-function detectAction(toolName, toolInput) {
-  switch (toolName) {
-    case 'Read':
-      return 'read_file';
-    case 'Write':
-      return 'write_file';
-    case 'Edit':
-      return 'edit_file';
-    case 'Bash':
-      return 'run_command';
-    case 'Agent':
-      return `call_${toolInput.subagent_type || 'agent'}`;
-    case 'AskUserQuestion':
-      return 'ask_user';
-    default:
-      return 'unknown';
-  }
-}
-
-/**
- * 检测命令类型
- */
-function detectCommandType(command) {
-  if (/npm\s+(test|run\s+test)/.test(command)) return 'test';
-  if (/npm\s+(run\s+)?build/.test(command)) return 'build';
-  if (/npm\s+run\s+lint/.test(command)) return 'lint';
-  if (/pytest|jest|mocha/.test(command)) return 'test';
-  if (/tsc|typescript/.test(command)) return 'typecheck';
-  return null;
-}
-
-/**
- * 检测异常模式
- */
-function checkAnomalies(projectRoot) {
-  const metrics = getMetrics(projectRoot, true);
-
-  // 检测连续失败
-  const recentErrors = (metrics?.totals?.errors || []).slice(-5);
-  if (recentErrors.length >= 3) {
-    const timeWindow = 5 * 60 * 1000; // 5 分钟
-    const now = Date.now();
-    const recentFailures = recentErrors.filter(e =>
-      now - new Date(e.time).getTime() < timeWindow
-    );
-
-    if (recentFailures.length >= 3) {
-      // 触发自动诊断建议
-      outputAnomalyWarning('consecutive_failures', {
-        count: recentFailures.length,
-        timeWindow: '5min',
-        suggestion: '短时间内多次失败，建议暂停检查环境配置',
-        requiredAction: '建议暂停当前流程，执行诊断后再继续',
-        diagnosisCommand: '读取 framework/skills/support/ai-anomaly-analyzer.md 获取诊断建议'
-      });
-    }
-  }
-
-  // 检测 Layer1 连续失败
-  const layer1Fails = (metrics?.totals?.errors || []).filter(e => e.type === 'layer1_fail');
-  if (layer1Fails.length >= 3) {
-    outputAnomalyWarning('layer1_consecutive_failures', {
-      count: layer1Fails.length,
-      suggestion: 'Layer1 验证连续失败，可能存在系统性问题',
-      requiredAction: '建议检查：1) 测试依赖是否就绪 2) 代码实现是否符合设计 3) 环境配置是否正确'
-    });
-  }
-}
-
-/**
- * 输出异常告警
- */
-function outputAnomalyWarning(type, details) {
-  const message = `
-[AutoSpec Anomaly Warning] 检测到异常模式
-
-类型: ${type}
-详情: ${JSON.stringify(details, null, 2)}
-
-建议: ${details.suggestion}
-${details.requiredAction ? `\n**建议操作**: ${details.requiredAction}` : ''}
-${details.diagnosisCommand ? `\n诊断: ${details.diagnosisCommand}` : ''}
-`;
-
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: message
-    }
-  }));
-}
-
-/**
- * 输出评测摘要
- */
-function outputEvaluationSummary(qualityScore, errorPatterns, consistencyResult = null) {
-  const gradeEmoji = {
-    'A': '🟢',
-    'B': '🟡',
-    'C': '🟠',
-    'D': '🔴',
-    'F': '⚫'
-  };
-
-  const emoji = gradeEmoji[qualityScore.grade] || '⚪';
-
-  let summary = `
-[AutoSpec Evaluation Summary] ${emoji}
-
-## 质量评分
-- 综合评分: ${qualityScore.overall}/100 (${qualityScore.grade})
-- 过程指标: ${qualityScore.breakdown.process.score}/100
-- 结果指标: ${qualityScore.breakdown.result.score}/100
-- 路径指标: ${qualityScore.breakdown.path.score}/100
-
-## 错误模式
-${errorPatterns.length > 0
-  ? errorPatterns.map(p => `- [${p.severity}] ${p.suggestion}`).join('\n')
-  : '- 无显著错误模式'
-}
-
-${consistencyResult?.message || ''}
-`;
-
-  // 低分时输出强制建议
-  if (qualityScore.overall < 70) {
-    summary += `
-## ⚠️ 质量告警
-
-综合评分低于 70 分，建议：
-1. 执行 /autospec:evaluate 获取详细评测报告
-2. 检查流程执行情况，优化低分维度
-3. 如有进化触发，执行 /autospec:evolve
-`;
-  } else {
-    summary += `
-## 建议
-流程执行良好，继续保持。
-
-详细报告请执行: /autospec:evaluate
-`;
-  }
-
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'Stop',
-      additionalContext: summary
-    }
-  }));
-}
-
-async function main() {
-  let input;
-  try {
-    const rawInput = await readStdin(1000);
-    input = safeJsonParse(rawInput, null, 'hook input');
-
-    if (!input) {
-      logger.debug('Empty or invalid input, skipping');
-      process.exit(0);
-    }
-  } catch (err) {
-    logger.error('Failed to parse input', { error: err.message });
-    process.exit(0);
-  }
-
-  const cwd = input.cwd || process.cwd();
-  const projectRoot = await findProjectRootAsync(cwd);
-
-  if (!projectRoot) {
-    logger.debug('No .autospec directory found, skipping');
-    process.exit(0);
-  }
-
-  const eventName = input.event_name;
-
-  if (eventName === 'PostToolUse') {
-    await handlePostToolUse(input, projectRoot);
-  } else if (eventName === 'Stop') {
-    await handleStop(projectRoot);
-  }
-
-  process.exit(0);
-}
-
-main().catch((err) => {
-  const result = handleHookError('pipeline-observer', err, {
-    eventName: 'PostToolUse'
-  });
-  process.stdout.write(JSON.stringify(result.hookSpecificOutput));
-  process.exit(0);
-});

package/plugins/hooks/scope-sentinel.js

@@ -1,204 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec PreToolUse Hook: Scope Sentinel
- *
- * During implementation stage (Stage 03), monitors Write/Edit operations
- * to detect scope creep — modifying files outside the planned scope.
- *
- * Detection strategy:
- * 1. If .autospec/state.json shows currentStage is 03 (implementation)
- * 2. Check if the target file path is reasonable for the current task
- * 3. Warn (not block) if editing framework/config files or unrelated modules
- *
- * This hook WARNS but never BLOCKS — it's a cognitive nudge, not a gate.
- *
- * 优化点：
- * 1. 使用共享工具函数
- * 2. 统一错误处理和日志
- * 3. 缓存状态避免重复读取
- */
-
-import { createHookLogger, safeJsonParse, handleHookError, readStdin, findProjectRootAsync, fileExists, globalHookCache } from './lib/hook-logger.js';
-
-const logger = createHookLogger('scope-sentinel');
-const stateCache = globalHookCache; // 使用全局单例缓存
-
-// 缓存键前缀
-const CACHE_KEY_PREFIX = 'scope-check:';
-
-async function main() {
-  let input;
-  try {
-    const rawInput = await readStdin(1000);
-    input = safeJsonParse(rawInput, null, 'hook input');
-
-    if (!input) {
-      logger.debug('Empty or invalid input, skipping');
-      process.exit(0);
-    }
-  } catch (err) {
-    logger.error('Failed to parse input', { error: err.message });
-    process.exit(0);
-  }
-
-  const toolName = input.tool_name;
-  if (toolName !== 'Write' && toolName !== 'Edit') {
-    logger.debug('Not a write/edit operation, skipping', { toolName });
-    process.exit(0);
-  }
-
-  const fs = await import('fs');
-  const path = await import('path');
-
-  // Find project root
-  const cwd = input.cwd || process.cwd();
-  const projectRoot = await findProjectRootAsync(cwd);
-
-  if (!projectRoot) {
-    logger.debug('No .autospec directory found, skipping');
-    process.exit(0);
-  }
-
-  const statePath = path.join(projectRoot, '.autospec', 'state.json');
-
-  // Check if we should skip based on cached stage check
-  const stageCacheKey = `${CACHE_KEY_PREFIX}${projectRoot}:stage`;
-  let isImplementationStage = stateCache.get(stageCacheKey);
-
-  if (isImplementationStage === undefined) {
-    isImplementationStage = await checkImplementationStage(statePath, fs);
-    stateCache.set(stageCacheKey, isImplementationStage, 30000); // 30s cache
-    logger.debug('Stage checked', { isImplementationStage });
-  } else {
-    logger.debug('Using cached stage check', { isImplementationStage });
-  }
-
-  if (!isImplementationStage) {
-    process.exit(0);
-  }
-
-  const filePath = (input.tool_input?.file_path || '').replace(/\\/g, '/');
-
-  // Skip autospec internal files (specs, state, metrics — those are expected)
-  if (filePath.includes('.autospec/') || filePath.includes('.claude/')) {
-    logger.debug('Skipping autospec internal file', { filePath });
-    process.exit(0);
-  }
-
-  // Detect potentially risky modifications
-  const warnings = [];
-
-  // 1. Modifying package.json / config files (potential scope creep)
-  const configPatterns = [
-    /package\.json$/,
-    /tsconfig.*\.json$/,
-    /\.eslintrc/,
-    /webpack|vite|rollup.*config/,
-    /docker/i,
-    /\.env/
-  ];
-  for (const pattern of configPatterns) {
-    if (pattern.test(filePath)) {
-      warnings.push(
-        `Modifying config file: ${path.basename(filePath)}. ` +
-        `Verify this change is required by the current task scope.`
-      );
-      logger.info('Config file modification detected', { filePath });
-      break;
-    }
-  }
-
-  // 2. Creating new directories (potential feature creep)
-  if (toolName === 'Write') {
-    const dir = path.dirname(filePath);
-    const relDir = path.relative(cwd, dir).replace(/\\/g, '/');
-    // Count directory depth — creating deeply nested new structures may signal scope creep
-    const parts = relDir.split('/').filter(Boolean);
-    if (parts.length > 4) {
-      warnings.push(
-        `Creating file in deeply nested path (${parts.length} levels). ` +
-        `Check if this aligns with the technical design.`
-      );
-      logger.info('Deep nesting detected', { depth: parts.length, path: relDir });
-    }
-  }
-
-  // Load metrics to track scope warnings count
-  const metricsPath = path.join(projectRoot, '.autospec', 'metrics.json');
-  let metrics;
-  try {
-    metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
-  } catch {
-    metrics = { totals: { scopeWarnings: 0 } };
-  }
-
-  if (warnings.length > 0) {
-    if (!metrics.totals.scopeWarnings) metrics.totals.scopeWarnings = 0;
-    metrics.totals.scopeWarnings++;
-
-    try {
-      fs.writeFileSync(metricsPath, JSON.stringify(metrics, null, 2));
-    } catch (err) {
-      logger.debug('Failed to write metrics', { error: err.message });
-    }
-
-    // Graduated response (CP8 三级偏航提醒)
-    let level = '';
-    const count = metrics.totals.scopeWarnings;
-    if (count <= 2) {
-      level = '(scope check — informational)';
-    } else if (count <= 5) {
-      level = '⚠️ (scope check — repeated, please verify)';
-    } else {
-      level = '🚨 (scope check — frequent deviations detected, review needed)';
-    }
-
-    logger.info('Scope warning generated', { level, warningCount: count });
-
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        additionalContext:
-          `[AutoSpec Scope Sentinel] ${level}\n` +
-          warnings.join('\n') + '\n' +
-          `Verify this change is within the scope defined in .autospec/specs/*/design.md`
-      }
-    };
-    process.stdout.write(JSON.stringify(output));
-  }
-
-  process.exit(0);
-}
-
-/**
- * Check if current stage is implementation (Stage 3)
- */
-async function checkImplementationStage(statePath, fs) {
-  if (!(await fileExists(statePath))) {
-    return false;
-  }
-
-  try {
-    const content = await fs.promises.readFile(statePath, 'utf-8');
-    const state = safeJsonParse(content, null, 'state.json');
-
-    if (!state) {
-      return false;
-    }
-
-    const stage = String(state.currentStage);
-    return stage === '3' || stage === '03';
-  } catch (err) {
-    logger.debug('Failed to read state', { error: err.message });
-    return false;
-  }
-}
-
-main().catch((err) => {
-  const result = handleHookError('scope-sentinel', err, {
-    eventName: 'PreToolUse'
-  });
-  process.stdout.write(JSON.stringify(result.hookSpecificOutput));
-  process.exit(0);
-});