@chongyan/autospec 1.0.2 → 1.0.4

package/scripts/config/hooks.config.js

@@ -1,197 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSpec 声明式 Hook 配置
- *
- * 替代硬编码的 hook 注册逻辑，使用声明式配置管理所有 hooks。
- *
- * 优先级规则（大数字先执行）：
- * - 200: trace-initialization (最高优先级，Trace ID 初始化)
- * - 100: frozen-zone (保护核心文件)
- * - 90: scope-sentinel (范围保护)
- * - 85: constitution-guard (宪法门禁)
- * - 80: layer1-validator (Layer 1 强制检查 + 结果捕获 + 质量追踪)
- * - 75: environment-manager (环境知识验证 + 环境进化检查)
- * - 50: ai-project-guard (AI 安全检查 + 效果验证)
- * - 35: execution-tracker (执行追踪)
- *
- * 注意：evolution-trigger 和 practice-log-reminder 已合并到 skill：
- * - knowledge/03-guides/18-log-practice.md
- *
- * 缓存键规范：
- * - ai-project:{projectRoot} - AI 项目检测结果
- * - stage-check:{projectRoot}:stage - 当前阶段缓存
- */
-
-export const HOOKS_CONFIG = {
-  // PreToolUse - 工具执行前检查
-  PreToolUse: [
-    {
-      name: 'trace-initialization',
-      script: 'plugins/hooks/trace-initialization.js',
-      matcher: 'Write',
-      priority: 200,
-      description: '流程启动时初始化 Trace ID'
-    },
-    {
-      name: 'frozen-zone',
-      script: 'plugins/hooks/frozen-zone-guard.js',
-      matcher: 'Write|Edit',
-      priority: 100,
-      description: '保护冻结区文件不被修改'
-    },
-    {
-      name: 'scope-sentinel',
-      script: 'plugins/hooks/scope-sentinel.js',
-      matcher: 'Write|Edit',
-      priority: 90,
-      description: '实现阶段范围防漂移'
-    },
-    {
-      name: 'constitution-guard',
-      script: 'plugins/hooks/constitution-guard.js',
-      matcher: 'Write|Edit',
-      priority: 85,
-      description: '检查启动门禁是否遵循'
-    },
-    {
-      name: 'layer1-validator',
-      script: 'plugins/hooks/layer1-validator.js',
-      matcher: 'Write|Edit|Bash',
-      priority: 80,
-      description: 'Layer 1 强制检查（PreToolUse）+ 结果捕获（PostToolUse）+ 质量追踪'
-    },
-    {
-      name: 'environment-manager',
-      script: 'plugins/hooks/environment-manager.js',
-      matcher: 'Write|Edit',
-      priority: 75,
-      description: '环境知识验证（PreToolUse）+ 环境进化检查（Stop）'
-    },
-    {
-      name: 'ai-project-guard',
-      script: 'plugins/hooks/ai-project-guard.js',
-      matcher: '', // 所有 Bash 命令
-      priority: 50,
-      condition: 'isAIProject', // 条件执行：仅 AI 项目
-      description: 'AI 项目安全检查 + 效果验证'
-    }
-  ],
-
-  // PostToolUse - 工具执行后处理
-  PostToolUse: [
-    {
-      name: 'artifact-evaluation',
-      script: 'plugins/hooks/artifact-evaluation-hook.js',
-      matcher: 'Write',
-      priority: 36,
-      description: '产出物评测（结构检查 + AI 质量评估触发）'
-    },
-    {
-      name: 'execution-tracker',
-      script: 'plugins/hooks/execution-tracker.js',
-      matcher: 'Write|Edit|Agent',
-      priority: 35,
-      description: '追踪关键步骤执行日志（skill 加载、agent 调用、产物生成、阶段完成）'
-    },
-    {
-      name: 'layer1-validator',
-      script: 'plugins/hooks/layer1-validator.js',
-      matcher: 'Write|Edit|Bash|Agent|AskUserQuestion',
-      priority: 40,
-      description: 'Layer 1 结果捕获 + 质量指标追踪'
-    },
-    {
-      name: 'ai-project-guard',
-      script: 'plugins/hooks/ai-project-guard.js',
-      matcher: 'Bash',
-      priority: 50,
-      condition: 'isAIProject',
-      description: 'AI 项目安全检查 + 效果验证'
-    },
-    {
-      name: 'pipeline-observer',
-      script: 'plugins/hooks/pipeline-observer.js',
-      matcher: '',
-      priority: 10,
-      description: '全链路事件采集和分析'
-    }
-  ],
-
-  // Stop - 会话结束
-  Stop: [
-    {
-      name: 'pipeline-observer',
-      script: 'plugins/hooks/pipeline-observer.js',
-      priority: 10,
-      description: '会话结束时生成评测报告'
-    },
-    {
-      name: 'environment-manager',
-      script: 'plugins/hooks/environment-manager.js',
-      priority: 15,
-      description: '环境知识验证 + 环境进化检查'
-    }
-  ]
-};
-
-/**
- * 获取指定事件类型的 hooks，按优先级排序
- */
-export function getHooksForEvent(eventName) {
-  const hooks = HOOKS_CONFIG[eventName] || [];
-  return hooks.sort((a, b) => b.priority - a.priority);
-}
-
-/**
- * 检查 hook 是否应该对某个工具执行
- */
-export function shouldHookRun(hook, toolName) {
-  // 无条件执行（matcher 为空）
-  if (!hook.matcher) {
-    return true;
-  }
-
-  // 检查工具名匹配
-  const matchers = hook.matcher.split('|').map(m => m.trim());
-  return matchers.includes(toolName);
-}
-
-/**
- * 构建完整的 hook 路径
- */
-export function resolveHookPath(scriptPath, baseDir) {
-  if (scriptPath.startsWith('/')) {
-    return scriptPath;
-  }
-  return `${baseDir}/${scriptPath}`;
-}
-
-/**
- * 生成 Claude Code hooks 配置
- * 输出格式与 claude-integration.js 兼容
- */
-export function generateClaudeHooksConfig(autospecDir) {
-  const configs = [];
-
-  for (const [event, hooks] of Object.entries(HOOKS_CONFIG)) {
-    for (const hook of hooks) {
-      // 构建命令
-      const scriptPath = resolveHookPath(hook.script, autospecDir);
-      const command = `node ${scriptPath}`;
-
-      configs.push({
-        event,
-        command,
-        name: hook.name,
-        priority: hook.priority,
-        matcher: hook.matcher || '',
-        description: hook.description
-      });
-    }
-  }
-
-  return configs;
-}
-
-export default HOOKS_CONFIG;

package/scripts/install/agents.js

@@ -1,106 +0,0 @@
-/**
- * Agents generator for Claude Code integration
- *
- * Generates agent files from templates directory with variable replacement.
- * Source: plugins/agents/
- * Target: .claude/agents/
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-// ESM __dirname equivalent
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Replace template variables in content
- * @param {string} content - Template content
- * @returns {string} - Content with variables replaced
- */
-function replaceVariables(content) {
-  // Replace ${FW} with .autospec/knowledge (backward compat)
-  // Replace ${KNOWLEDGE} with .autospec/knowledge
-  return content
-    .replace(/\$\{FW\}/g, '.autospec/knowledge')
-    .replace(/\$\{KNOWLEDGE\}/g, '.autospec/knowledge');
-}
-
-/**
- * Generate all agent files from templates
- * @param {string} claudeDir - Target .claude directory path
- */
-export function generateAgents(claudeDir) {
-  const agentsDir = path.join(claudeDir, 'agents');
-  fs.mkdirSync(agentsDir, { recursive: true });
-
-  // Get templates directory path (relative to this file)
-  // __dirname is scripts/install/, templates are in ../../plugins/agents/
-  const templatesDir = path.join(__dirname, '../../plugins/agents');
-
-  // Check if templates directory exists
-  if (!fs.existsSync(templatesDir)) {
-    console.warn('Warning: plugins/agents/ directory not found, skipping agent generation');
-    return;
-  }
-
-  // Process roles directory
-  const rolesDir = path.join(templatesDir, 'roles');
-  if (fs.existsSync(rolesDir)) {
-    const roleAgents = fs.readdirSync(rolesDir).filter(f => f.endsWith('.md'));
-    for (const file of roleAgents) {
-      const sourcePath = path.join(rolesDir, file);
-      const content = fs.readFileSync(sourcePath, 'utf-8');
-      const processed = replaceVariables(content);
-      const targetPath = path.join(agentsDir, file);
-      fs.writeFileSync(targetPath, processed, 'utf-8');
-    }
-  }
-
-  // Process support directory
-  const supportDir = path.join(templatesDir, 'support');
-  if (fs.existsSync(supportDir)) {
-    const supportAgents = fs.readdirSync(supportDir).filter(f => f.endsWith('.md'));
-    for (const file of supportAgents) {
-      const sourcePath = path.join(supportDir, file);
-      const content = fs.readFileSync(sourcePath, 'utf-8');
-      const processed = replaceVariables(content);
-      const targetPath = path.join(agentsDir, file);
-      fs.writeFileSync(targetPath, processed, 'utf-8');
-    }
-  }
-}
-
-/**
- * Get list of available agent names
- * @returns {string[]} - Array of agent names
- */
-export function getAvailableAgents() {
-  const templatesDir = path.join(__dirname, '../../plugins/agents');
-  const agents = [];
-
-  if (!fs.existsSync(templatesDir)) {
-    return agents;
-  }
-
-  // Get agents from roles directory
-  const rolesDir = path.join(templatesDir, 'roles');
-  if (fs.existsSync(rolesDir)) {
-    const roleAgents = fs.readdirSync(rolesDir)
-      .filter(f => f.endsWith('.md'))
-      .map(f => f.replace('.md', ''));
-    agents.push(...roleAgents);
-  }
-
-  // Get agents from support directory
-  const supportDir = path.join(templatesDir, 'support');
-  if (fs.existsSync(supportDir)) {
-    const supportAgents = fs.readdirSync(supportDir)
-      .filter(f => f.endsWith('.md'))
-      .map(f => f.replace('.md', ''));
-    agents.push(...supportAgents);
-  }
-
-  return agents;
-}

package/scripts/install/commands.js

@@ -1,133 +0,0 @@
-/**
- * Generates Claude Code slash command files (.claude/commands/autospec/)
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { COMMAND_DEFINITIONS } from '../config/commands.config.js';
-
-// ESM __dirname equivalent
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Template cache to avoid repeated file reads
-const templateCache = new Map();
-
-/**
- * Load template from file with caching
- */
-function loadTemplate(templateFile) {
-  // Check cache first
-  if (templateCache.has(templateFile)) {
-    return templateCache.get(templateFile);
-  }
-
-  // Resolve template path (templates are in plugins/commands/)
-  // __dirname is scripts/install/, so we need ../../plugins/commands/
-  const templatePath = path.join(__dirname, '../../plugins/commands', templateFile);
-
-  if (!fs.existsSync(templatePath)) {
-    throw new Error(`Template file not found: ${templatePath}`);
-  }
-
-  const content = fs.readFileSync(templatePath, 'utf-8');
-
-  // Cache the template
-  templateCache.set(templateFile, content);
-
-  return content;
-}
-
-/**
- * Replace variables in template
- */
-function replaceVariables(template, variables) {
-  let result = template;
-  for (const [key, value] of Object.entries(variables)) {
-    const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
-    result = result.replace(regex, value);
-  }
-  return result;
-}
-
-/**
- * Generate all Claude Code slash commands
- */
-export function generateCommands(commandsDir) {
-  if (!fs.existsSync(commandsDir)) {
-    fs.mkdirSync(commandsDir, { recursive: true });
-  }
-
-  // Use relative path (always forward slashes for cross-platform)
-  const knowledge = '.autospec/knowledge';
-  const variables = { knowledge, framework: knowledge }; // Keep framework for backward compat
-
-  // Generate all commands from configuration (skip internal commands)
-  for (const [name, config] of Object.entries(COMMAND_DEFINITIONS)) {
-    // Skip internal commands (only for AutoSpec itself)
-    if (config.internal) {
-      continue;
-    }
-    const content = generateCommandFromTemplate(config, variables);
-    writeCommand(commandsDir, name, content);
-  }
-}
-
-/**
- * Generate a single command from template
- */
-function generateCommandFromTemplate(config, variables) {
-  const template = loadTemplate(config.templateFile);
-  return replaceVariables(template, variables);
-}
-
-function writeCommand(dir, name, content) {
-  fs.writeFileSync(path.join(dir, `${name}.md`), content, 'utf-8');
-}
-
-/**
- * Clear template cache (useful for testing or when templates change)
- */
-export function clearTemplateCache() {
-  templateCache.clear();
-}
-
-/**
- * Get cache stats for debugging
- */
-export function getTemplateCacheStats() {
-  return {
-    size: templateCache.size,
-    keys: Array.from(templateCache.keys())
-  };
-}
-
-/**
- * Get list of internal command names
- */
-export function getInternalCommandNames() {
-  return Object.entries(COMMAND_DEFINITIONS)
-    .filter(([, config]) => config.internal)
-    .map(([name]) => name);
-}
-
-/**
- * Generate internal commands (for AutoSpec itself)
- */
-export function generateInternalCommands(commandsDir) {
-  if (!fs.existsSync(commandsDir)) {
-    fs.mkdirSync(commandsDir, { recursive: true });
-  }
-
-  const knowledge = '.autospec/knowledge';
-  const variables = { knowledge, framework: knowledge };
-
-  // Generate only internal commands
-  for (const [name, config] of Object.entries(COMMAND_DEFINITIONS)) {
-    if (config.internal) {
-      const content = generateCommandFromTemplate(config, variables);
-      writeCommand(commandsDir, name, content);
-    }
-  }
-}