@chongyan/autospec 1.0.2 → 1.0.3

package/scripts/cli/init.js

@@ -1,408 +0,0 @@
-/**
- * AutoSpec init command
- *
- * Merged from src/cli/commands/init.js and src/core/init.js
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-import { FRAMEWORK_SRC, FRAMEWORK_DEST } from '../install/constants.js';
-import { generateCommands, generateIntegration } from '../install/index.js';
-import { initGlobalMemory, initProjectMemory, hasGlobalMemory } from '../../plugins/hooks/lib/memory-manager.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
-
-/**
- * Check if file should be excluded from copy
- * Exclude README files to avoid noise in user projects
- */
-function shouldExclude(filename) {
-  // Exclude all README files (README.md, README.en.md, README.zh-CN.md, etc.)
-  if (filename.startsWith('README')) {
-    return true;
-  }
-  return false;
-}
-
-/**
- * Copy directory recursively, excluding README files
- */
-function copyDirSync(src, dest) {
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDirSync(srcPath, destPath);
-    } else {
-      // Skip README files
-      if (shouldExclude(entry.name)) {
-        continue;
-      }
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-/**
- * Initialize autospec in target project directory
- *
- * Init copies knowledge files and hooks, generates commands/skills/agents.
- * Runtime directories (runtime/, evolution/, environment/) are auto-created
- * by hooks when slash commands are executed in Claude Code.
- */
-export function initProject(targetDir, options = {}) {
-  const knowledgeSrc = path.join(PACKAGE_ROOT, FRAMEWORK_SRC);
-  const knowledgeDest = path.join(targetDir, FRAMEWORK_DEST);
-  const pluginsSrc = path.join(PACKAGE_ROOT, 'plugins');
-  const pluginsDest = path.join(targetDir, '.autospec', 'plugins');
-  const commandsDir = path.join(targetDir, '.claude', 'commands', 'autospec');
-
-  const results = {
-    frameworkCopied: false,
-    pluginsCopied: false,
-    commandsGenerated: false,
-    integrationGenerated: false,
-    claudeMdUpdated: false,
-    globalMemoryInitialized: false,
-    projectMemoryInitialized: false,
-    errors: []
-  };
-
-  // 1. Copy entire knowledge/ directory
-  try {
-    copyDirSync(knowledgeSrc, knowledgeDest);
-    results.frameworkCopied = true;
-  } catch (e) {
-    results.errors.push(`Knowledge copy failed: ${e.message}`);
-  }
-
-  // 1.5 Copy plugins/hooks/ directory (hooks need to be accessible at runtime)
-  try {
-    const hooksSrc = path.join(pluginsSrc, 'hooks');
-    const hooksDest = path.join(pluginsDest, 'hooks');
-    if (fs.existsSync(hooksSrc)) {
-      copyDirSync(hooksSrc, hooksDest);
-      results.pluginsCopied = true;
-    }
-  } catch (e) {
-    results.errors.push(`Plugins copy failed: ${e.message}`);
-  }
-
-  // 2. Generate Claude Code slash commands
-  try {
-    generateCommands(commandsDir);
-    results.commandsGenerated = true;
-  } catch (e) {
-    results.errors.push(`Command generation failed: ${e.message}`);
-  }
-
-  // 3. Generate Claude Code integration (skills + agents + hooks)
-  try {
-    generateIntegration(targetDir);
-    results.integrationGenerated = true;
-  } catch (e) {
-    results.errors.push(`Integration generation failed: ${e.message}`);
-  }
-
-  // 4. Create/update CLAUDE.md
-  try {
-    updateClaudeMd(targetDir);
-    results.claudeMdUpdated = true;
-  } catch (e) {
-    results.errors.push(`CLAUDE.md update failed: ${e.message}`);
-  }
-
-  // 5. Create .autospec directory (hooks will auto-create subdirectories when needed)
-  const autospecDir = path.join(targetDir, '.autospec');
-  if (!fs.existsSync(autospecDir)) {
-    fs.mkdirSync(autospecDir, { recursive: true });
-  }
-
-  // 6. Create .autospec/package.json with "type": "module" to support ESM hooks
-  const autospecPackageJson = path.join(autospecDir, 'package.json');
-  if (!fs.existsSync(autospecPackageJson)) {
-    fs.writeFileSync(autospecPackageJson, JSON.stringify({
-      name: 'autospec-config',
-      version: '1.0.0',
-      type: 'module',
-      description: 'AutoSpec configuration directory'
-    }, null, 2), 'utf-8');
-  }
-
-  // 6.5. Create evolution subdirectories
-  const evolutionDirs = [
-    path.join(autospecDir, 'practice-log'),
-    path.join(autospecDir, 'evolution'),
-    path.join(autospecDir, 'evolution', 'proposals'),
-    path.join(autospecDir, 'evolution', 'distilled-skills'),
-    path.join(autospecDir, 'benchmarks'),
-    path.join(autospecDir, 'runtime'),
-  ];
-
-  for (const dir of evolutionDirs) {
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-  }
-
-  // 6.6. Create evolution-log.json
-  const evolutionLogPath = path.join(autospecDir, 'evolution', 'evolution-log.json');
-  if (!fs.existsSync(evolutionLogPath)) {
-    fs.writeFileSync(evolutionLogPath, JSON.stringify({
-      version: '1.0',
-      createdAt: new Date().toISOString(),
-      entries: []
-    }, null, 2), 'utf-8');
-  }
-
-  // 7. Initialize memory system (global + project)
-  try {
-    // Initialize global memory if not exists
-    if (!hasGlobalMemory()) {
-      initGlobalMemory();
-      results.globalMemoryInitialized = true;
-    }
-  } catch (e) {
-    results.errors.push(`Global memory init failed: ${e.message}`);
-  }
-
-  try {
-    // Initialize project memory
-    initProjectMemory(targetDir);
-    results.projectMemoryInitialized = true;
-  } catch (e) {
-    results.errors.push(`Project memory init failed: ${e.message}`);
-  }
-
-  return results;
-}
-
-function updateClaudeMd(targetDir) {
-  const claudeMd = path.join(targetDir, 'CLAUDE.md');
-  const block = `
-# AutoSpec Integration
-
-本项目使用 AutoSpec 自动化研发流程。
-
-## 启动门禁
-
-收到任何开发类任务时，**必须先执行启动门禁**（startup-guard skill 会自动提醒）：
-1. 读取 \`.autospec/knowledge/02-process/00-overview.md\`
-2. 读取 \`.autospec/knowledge/01-principles/09-constitution.md\`
-3. 确认执行模式（自主/交互）和工作流类型
-4. 向用户确认任务范围
-
-**违反 = 宪法违规 → 立即停止。**
-
-## 命令速查
-
-| 命令 | 说明 |
-|------|------|
-| \`/autospec:run\` | 全流程自主执行（推荐） |
-| \`/autospec:explore\` | 需求探索 |
-| \`/autospec:propose\` | 方案设计 |
-| \`/autospec:apply\` | 实施（编码 + 审查 + 测试） |
-| \`/autospec:archive\` | 交付归档 |
-| \`/autospec:evolve\` | 自进化触发 |
-| \`/autospec:status\` | 查看状态 |
-| \`/autospec:test\` | 统一测试命令（验证+修复+评测） |
-
-**迭代模式选择**（通过 /autospec:run）：
-- \`--workflow=waterfall\` Waterfall (default)
-- \`--workflow=agile\` Agile
-- \`--workflow=experiment\` Experiment (AI/ML)
-- \`--workflow=hotfix\` Hotfix
-
-## 推荐组合
-
-先探索后执行效果更佳：
-1. /autospec:explore → 需求探索澄清
-2. 将探索结果作为上下文输入 → /autospec:run <探索结果>
-
-这样可以让 AI 更准确地理解需求，避免方向偏差。
-
-**也可以直接运行**：直接使用 /autospec:run 时，AI 会通过内部 agent 对抗博弈自动整理需求，但可能不如先探索再运行准确。
-
-## Skills（自动感知）
-
-以下 skills 会根据场景自动触发，为 Claude 注入对应阶段的流程意识：
-
-| Skill | 触发场景 |
-|-------|---------|
-| startup-guard | 检测到开发类任务 → 强制启动门禁 |
-| layer1-validation | 代码变更后 → 提醒运行 Layer 1 验证 |
-| requirement-stage | 需求分析场景 → 加载需求分析流程 |
-| design-stage | 方案设计场景 → 加载设计流程 |
-| implementation-stage | 编码实现场景 → 加载实现流程 |
-| testing-stage | 测试场景 → 加载测试流程 |
-| delivery-stage | 交付部署场景 → 加载交付流程 + 自动记录 practice-log + 进化扫描 |
-| field-evolve-* | 领域进化场景 → 加载进化流程（扫描/执行/分析/修复/验证/学习/蒸馏） |
-| pending-dashboard | 新会话启动 → 扫描待处理提案/practice-log/中断流程 |
-
-## 审查 Agent（做审分离）
-
-Layer 2 审查使用独立 Agent，实现信息隔离（DP2）：
-
-| Agent | 用途 | 隔离方式 |
-|-------|------|---------|
-| independent-reviewer | 需求/设计/代码审查 | 只读权限，不知生产过程 |
-| test-coverage-reviewer | 测试充分性审查 | 只读权限，独立评估覆盖度 |
-| consistency-checker | 跨产物一致性检查（DP18） | 只读权限，六维检测 |
-| ceo | CEO/战略视角需求探索 | 只读权限，聚焦商业价值 |
-| product-owner | 产品落地挑战（与 CEO 博弈） | 只读权限，聚焦可行性 |
-| stage-gate-evaluator | 自主阶段产出审批（替代人工确认） | 只读权限，客观评估产出质量 |
-| safety-auditor | 不可逆操作安全审计（DB 迁移/部署） | 只读权限，安全风险评估 |
-| failure-diagnostician | 自主故障诊断 | 只读权限，根因分析 + 决策 |
-
-**CEO 探索机制**：需求分析阶段前置步骤。
-- 自主模式：ceo + product-owner 自动对话博弈
-- 交互模式：围绕 5 个战略维度与用户交互
-
-调用方式：Agent 工具，只传入产出物 + 审查标准 + 上游契约，不传入生产过程上下文。
-
-## Hooks
-
-已配置确定性 hooks（见 .claude/settings.json）：
-- **frozen-zone-guard**: 阻止修改宪法/进化规则等冻结区文件
-- **constitution-guard**: 提醒执行启动门禁协议（读取宪法 + 概述）
-- **scope-sentinel**: 编码阶段偏航检测（修改范围外文件时三级递增提醒）
-- **layer1-validator**: Layer 1 强制检查 + 结果捕获 + 质量指标追踪
-- **environment-manager**: 环境知识验证 + 未注册中间件检测
-- **ai-project-guard**: AI 项目安全检查 + 效果验证
-- **execution-tracker**: 执行日志追踪（skill 加载、agent 调用、产物生成）
-`;
-
-  if (fs.existsSync(claudeMd)) {
-    const content = fs.readFileSync(claudeMd, 'utf-8');
-    if (!content.includes('# AutoSpec Integration')) {
-      fs.appendFileSync(claudeMd, '\n' + block);
-    }
-  } else {
-    fs.writeFileSync(claudeMd, block.trim() + '\n');
-  }
-}
-
-/**
- * Check if running as root and warn user
- */
-function checkRootPermission() {
-  if (process.getuid && process.getuid() === 0) {
-    console.log('');
-    console.log(chalk.bold.yellow('  ⚠️  权限警告'));
-    console.log('');
-    console.log('  正在以 root 身份运行 autospec init');
-    console.log('  创建的 .autospec 和 .claude 目录将属于 root 用户');
-    console.log('');
-    console.log(chalk.bold('  后续操作建议：'));
-    console.log('');
-    console.log('  方案一：后续命令也用 sudo 运行');
-    console.log(chalk.dim('    sudo claude'));
-    console.log('');
-    console.log('  方案二：修复权限后用普通用户运行');
-    console.log(chalk.dim('    sudo chown -R $(whoami) .autospec .claude CLAUDE.md'));
-    console.log('');
-    console.log('  方案三：删除后不使用 sudo 重新初始化');
-    console.log(chalk.dim('    sudo rm -rf .autospec .claude CLAUDE.md'));
-    console.log(chalk.dim('    autospec init'));
-    console.log('');
-  }
-}
-
-export function initCommand(options) {
-  const targetDir = process.cwd();
-
-  // Pass verbose option to initProject
-  if (options.verbose) {
-    process.env.AUTOSPEC_VERBOSE = 'true';
-  }
-
-  console.log(chalk.bold('\n  AutoSpec Init\n'));
-  console.log(`  Target:   ${targetDir}`);
-  console.log(`  Workflow: ${options.workflow}`);
-  console.log(`  Roles:    ${options.roles || '(none)'}`);
-  console.log(`  Domain:   ${options.domain}`);
-  if (options.verbose) {
-    console.log(chalk.dim('  Verbose:  enabled'));
-  }
-  console.log();
-
-  const roles = options.roles ? options.roles.split(',').map(r => r.trim()) : [];
-
-  const result = initProject(targetDir, {
-    workflow: options.workflow,
-    roles,
-    domain: options.domain,
-    verbose: options.verbose
-  });
-
-  // Results
-  if (result.frameworkCopied) {
-    console.log(chalk.green('  ✓') + ' Knowledge      .autospec/knowledge/');
-  }
-  if (result.commandsGenerated) {
-    console.log(chalk.green('  ✓') + ' Commands (17)  .claude/commands/autospec/');
-  }
-  if (result.integrationGenerated) {
-    console.log(chalk.green('  ✓') + ' Skills (9)     .claude/skills/');
-    console.log(chalk.green('  ✓') + ' Agents (16)    .claude/agents/');
-    console.log(chalk.green('  ✓') + ' Hooks          .claude/settings.json');
-  }
-  if (result.claudeMdUpdated) {
-    console.log(chalk.green('  ✓') + ' CLAUDE.md      updated');
-  }
-  if (result.globalMemoryInitialized) {
-    console.log(chalk.green('  ✓') + ' Global Memory  ~/.autospec-global/memory/');
-  }
-  if (result.projectMemoryInitialized) {
-    console.log(chalk.green('  ✓') + ' Project Memory .autospec/memory/');
-  }
-
-  if (result.errors.length > 0) {
-    console.log(chalk.red('\n  Errors:'));
-    result.errors.forEach(e => console.log(chalk.red('    ✗ ' + e)));
-  }
-
-  // 使用指南
-  console.log(chalk.bold('\n  快速开始\n'));
-
-  console.log(chalk.cyan('  自主模式（推荐）'));
-  console.log('    /autospec:run <任务描述>   启动完整流程，AI 自主执行');
-  console.log('    /autospec:run              基于已有探索上下文继续执行');
-  console.log('');
-  console.log(chalk.dim('  💡 建议先执行需求探索，再启动自主运行，可以更精准地完成任务'));
-  console.log(chalk.dim('    /autospec:explore          需求探索 - 澄清需求、识别约束'));
-  console.log('');
-
-  console.log(chalk.cyan('  交互模式'));
-  console.log('  分阶段执行，每阶段人工确认：');
-  console.log('');
-  console.log('    /autospec:explore      需求探索 - 澄清需求、识别约束');
-  console.log('    /autospec:propose      方案设计 - 技术方案、任务拆分');
-  console.log('    /autospec:apply        实施 - 编码、审查、测试');
-  console.log('    /autospec:archive      交付归档 - 文档、部署、复盘');
-  console.log('');
-
-  console.log(chalk.cyan('  环境同步'));
-  console.log('    /autospec:env-sync     同步环境知识到 AI 上下文');
-  console.log('');
-
-  console.log(chalk.cyan('  记忆管理'));
-  console.log('    /autospec:memory status     查看记忆系统状态');
-  console.log('    /autospec:memory show core  显示北极星指标');
-  console.log('');
-
-  console.log(chalk.dim('  更多命令: autospec list'));
-  console.log(chalk.dim('  帮助信息: autospec help <command>'));
-  console.log('');
-  console.log(chalk.green('  准备就绪，运行 /autospec:run <任务描述> 开始') + '\n');
-
-  // 权限检查：放在最后，确保用户能看到
-  checkRootPermission();
-}

package/scripts/cli/list.js

@@ -1,70 +0,0 @@
-/**
- * autospec list command - 显示所有可用的斜杠命令
- */
-
-import chalk from 'chalk';
-import { COMMAND_DEFINITIONS } from '../config/commands.config.js';
-
-export function listCommand() {
-  console.log(chalk.bold('\n  AutoSpec 斜杠命令\n'));
-
-  // 核心流程命令
-  console.log(chalk.cyan('  核心流程'));
-  console.log('    /autospec:run <任务>   启动完整流程（瀑布/敏捷/实验/热修复）');
-  console.log('    /autospec:run          基于已有探索上下文继续执行');
-  console.log('    /autospec:explore      需求探索阶段');
-  console.log('    /autospec:propose      方案设计阶段');
-  console.log('    /autospec:apply        实施阶段（编码+审查+测试）');
-  console.log('    /autospec:archive      交付归档阶段');
-  console.log('    /autospec:evolve       自进化循环');
-  console.log('');
-
-  // 状态与验证命令
-  console.log(chalk.cyan('  状态与验证'));
-  console.log('    /autospec:status       查看流程状态');
-  console.log('    /autospec:test         统一测试命令（验证+修复+评测）');
-  console.log('    /autospec:review       审查交付物');
-  console.log('    /autospec:evaluate     生成评测报告');
-  console.log('');
-
-  // 环境管理命令
-  console.log(chalk.cyan('  环境管理'));
-  console.log('    /autospec:env          查看环境配置');
-  console.log('    /autospec:env-validate 验证环境配置');
-  console.log('    /autospec:env-sync     同步环境知识（含初始化）');
-  console.log('    /autospec:env-export   导出知识库');
-  console.log('    /autospec:env-update   提交变更到知识源');
-  console.log('    /autospec:env-template 管理环境模板');
-  console.log('');
-
-  // 组件命令
-  console.log(chalk.cyan('  组件管理'));
-  console.log('    /autospec:component    列出已注册组件');
-  console.log('    /autospec:component-add 添加组件知识');
-  console.log('');
-
-  // 迭代模式
-  console.log(chalk.cyan('  迭代模式 (via /autospec:run)'));
-  console.log('    --workflow=waterfall   瀑布模式（默认）');
-  console.log('    --workflow=agile       敏捷模式');
-  console.log('    --workflow=experiment  实验模式（AI/ML）');
-  console.log('    --workflow=hotfix      热修复模式');
-  console.log('');
-
-  // 提示
-  console.log(chalk.dim('  文档: .autospec/knowledge/'));
-  console.log(chalk.dim('  配置: .claude/settings.json'));
-  console.log('');
-}
-
-/**
- * 获取命令列表（供其他模块使用）
- */
-export function getCommandList() {
-  return Object.entries(COMMAND_DEFINITIONS)
-    .filter(([, config]) => !config.internal)
-    .map(([name, config]) => ({
-      name: `/autospec:${name}`,
-      description: config.description
-    }));
-}