@chongyan/autospec 1.0.1 → 1.0.3

package/plugins/hooks/constitution-guard.js

@@ -1,211 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec PreToolUse Hook: Constitution Guard
- *
- * Enforces startup gate protocol (DP6 Constitution compliance) for development tasks.
- * When code changes (Write/Edit) are about to be made, checks if the startup gate
- * has been properly followed (reading constitution, overview, state tracking).
- *
- * This is a WARNING hook (does not block) to remind about constitutional requirements.
- * See CLAUDE.md section "启动门禁（硬性规则）"
- *
- * 增强功能：
- * - 门禁执行统计：记录每次门禁检查结果
- * - 与 metrics.json 集成
- *
- * Security Level: HIGH - fail-open + alert
- */
-
-import { createHookLogger, safeJsonParse, handleHookError, readStdin, findProjectRootAsync, fileExists } from './lib/hook-logger.js';
-import { recordHookExecution } from './lib/hook-error-recorder.js';
-import { getMetrics, updateMetrics } from './lib/hook-state-manager.js';
-import { getTraceId, recordEvent } from './lib/trace-context.js';
-import { recordGate } from './lib/execution-path.js';
-
-const logger = createHookLogger('constitution-guard');
-
-const DEVELOPMENT_PATTERNS = [
-  /\.(js|ts|jsx|tsx|py|java|go|rs|cpp|c|h|php|rb|swift|kt|scala)$/i,
-  /package\.json$/,
-  /pom\.xml$/,
-  /build\.gradle$/,
-  /go\.mod$/,
-  /Cargo\.toml$/,
-  /requirements\.txt$/,
-  /pyproject\.toml$/
-];
-
-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 filePath = (input.tool_input?.file_path || '').replace(/\\/g, '/');
-
-  // Check if this is a code/development file
-  const isDevelopmentFile = DEVELOPMENT_PATTERNS.some(p => p.test(filePath));
-  if (!isDevelopmentFile) {
-    logger.debug('Not a development file, skipping', { filePath });
-    process.exit(0);
-  }
-
-  logger.debug('Development file detected', { filePath });
-
-  // Check if startup gate has been followed
-  const statePath = path.join(projectRoot, '.autospec', 'state.json');
-
-  // If state.json doesn't exist, startup gate wasn't followed
-  if (!(await fileExists(statePath))) {
-    logger.info('No state.json found - startup gate may not have been followed');
-
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        additionalContext:
-          `[AutoSpec Constitution Guard] ⚠️ CONSTITUTION ALERT (DP6)\n` +
-          `Development activity detected but no state.json found.\n` +
-          `Startup gate protocol may not have been followed:\n` +
-          `  1. Read framework/pipeline/overview.md → 确定迭代模式\n` +
-          `  2. Read framework/constitution.md → 确认红线\n` +
-          `  3. 向用户确认任务范围\n` +
-          `Consider using /autospec:run to properly start the workflow.`
-      }
-    };
-    process.stdout.write(JSON.stringify(output));
-    process.exit(0);
-  }
-
-  // State exists, check basic record
-  try {
-    const content = await fs.promises.readFile(statePath, 'utf-8');
-    const state = safeJsonParse(content, null, 'state.json');
-
-    if (!state) {
-      logger.debug('Failed to parse state.json');
-      process.exit(0);
-    }
-
-    // Check if there's any layer 1/2 execution record
-    const hasExecutionRecord = state.stages && Object.values(state.stages).some(
-      s => s.layer1Results || s.layer2Results
-    );
-
-    // Check if constitution was read (stored in metadata)
-    const hasConstitutionRead = state.metadata && state.metadata.constitutionRead;
-
-    logger.debug('State check complete', { hasExecutionRecord, hasConstitutionRead });
-
-    // 记录门禁执行结果
-    const gatePassed = hasExecutionRecord || hasConstitutionRead;
-    recordGateResult(projectRoot, 'constitution', gatePassed, gatePassed ? null : '缺少执行记录');
-
-    if (!hasExecutionRecord && !hasConstitutionRead) {
-      // File is being written but no verification records exist
-      // This might indicate that the startup steps weren't properly followed
-      // We don't block, just warn once per session
-      logger.info('No execution records found in state');
-    }
-
-    process.exit(0);
-  } catch (err) {
-    logger.debug('Failed to read state', { error: err.message });
-    process.exit(0);
-  }
-}
-
-main().catch((err) => {
-  const result = handleHookError('constitution-guard', err, {
-    eventName: 'PreToolUse'
-  });
-  process.stdout.write(JSON.stringify(result.hookSpecificOutput));
-  // High 优先级 hook：fail-open，但记录错误
-  process.exit(0);
-});
-
-/**
- * 记录门禁执行结果
- * @param {string} projectRoot - 项目根目录
- * @param {string} gate - 门禁名称
- * @param {boolean} passed - 是否通过
- * @param {string|null} reason - 原因（未通过时）
- */
-function recordGateResult(projectRoot, gate, passed, reason = null) {
-  try {
-    // 更新 metrics.json 的 gates 统计
-    const metrics = getMetrics(projectRoot, false);
-
-    if (!metrics.gates) {
-      metrics.gates = {};
-    }
-
-    if (!metrics.gates[gate]) {
-      metrics.gates[gate] = { passed: 0, blocked: 0, history: [] };
-    }
-
-    if (passed) {
-      metrics.gates[gate].passed++;
-    } else {
-      metrics.gates[gate].blocked++;
-    }
-
-    // 添加历史记录（保留最近 50 条）
-    metrics.gates[gate].history.push({
-      timestamp: new Date().toISOString(),
-      passed,
-      reason
-    });
-
-    if (metrics.gates[gate].history.length > 50) {
-      metrics.gates[gate].history = metrics.gates[gate].history.slice(-50);
-    }
-
-    updateMetrics(projectRoot, metrics);
-
-    // 记录到执行路径
-    recordGate(projectRoot, gate, passed, reason);
-
-    // 记录到 trace 日志
-    const traceId = getTraceId(projectRoot);
-    if (traceId) {
-      recordEvent(projectRoot, passed ? 'gate_pass' : 'gate_block', {
-        source: 'constitution-guard',
-        action: 'gate_check',
-         data: {
-          gate,
-          reason
-        }
-      });
-    }
-  } catch (e) {
-    logger.debug('Failed to record gate result', { error: e.message });
-  }
-}

package/plugins/hooks/environment-autocommit.js

@@ -1,264 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec Hook: Environment Autocommit
- *
- * 环境知识自动提交 Hook
- * 触发时机：Stop 事件
- * 功能：
- * 1. 检测 .autospec/environment/ 目录的变化
- * 2. 自动执行 git add + commit
- * 3. 可配置是否自动 push
- */
-
-import fs from 'fs';
-import path from 'path';
-import { createHookLogger, readStdin, findProjectRootAsync } from './lib/hook-logger.js';
-
-const logger = createHookLogger('environment-autocommit');
-
-/**
- * 检查是否为 git 仓库
- */
-function isGitRepo(dir) {
-  return fs.existsSync(path.join(dir, '.git'));
-}
-
-/**
- * 获取 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 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/']
-    };
-  }
-
-  try {
-    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-  } catch (e) {
-    logger.warn('Failed to load autocommit config', { error: e.message });
-    return { enabled: false };
-  }
-}
-
-/**
- * 生成提交消息
- */
-function generateCommitMessage(template, changes) {
-  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}`;
-  }
-
-  return message;
-}
-
-/**
- * 处理 Stop 事件
- */
-async function handleStop(projectRoot) {
-  // 检查是否为 git 仓库
-  if (!isGitRepo(projectRoot)) {
-    logger.debug('Not a git repo, skipping autocommit');
-    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 => line.substring(3).trim())
-    .filter(file => envPaths.some(p => file.startsWith(p)));
-
-  if (changedFiles.length === 0) {
-    logger.debug('No environment knowledge changes');
-    process.exit(0);
-  }
-
-  logger.info('Detected environment knowledge changes', { files: changedFiles });
-
-  // 执行 git add
-  const addResult = gitAdd(projectRoot, changedFiles);
-  if (!addResult) {
-    process.exit(0);
-  }
-
-  // 生成提交消息
-  const message = generateCommitMessage(config.messageTemplate || 'chore: 更新环境知识', changedFiles);
-
-  // 执行 git commit
-  const commitResult = gitCommit(projectRoot, message);
-  if (!commitResult) {
-    process.exit(0);
-  }
-
-  logger.info('Committed environment knowledge changes', { message });
-
-  // 如果配置了自动 push
-  if (config.autoPush) {
-    const pushResult = gitPush(projectRoot);
-    if (pushResult) {
-      logger.info('Pushed environment knowledge changes');
-    }
-  }
-
-  // 输出结果
-  const branch = getCurrentBranch(projectRoot);
-  const output = {
-    hookSpecificOutput: {
-      hookEventName: 'Stop',
-      additionalContext: `[AutoSpec] 环境知识已自动提交到 ${branch} 分支${config.autoPush ? '并推送' : ''}。变更文件: ${changedFiles.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();