@chongyan/autospec 1.0.1

package/plugins/hooks/constitution-guard.js

@@ -0,0 +1,211 @@
+#!/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

@@ -0,0 +1,264 @@
+#!/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();