@chongyan/autospec 1.0.2 → 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 knowledge/02-process/00-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 });
-  }
-}