@gong-ym/ai-spec-auto 0.2.15 → 0.2.19

package/bin/protocol-workflow.js

@@ -348,7 +348,7 @@ function printUpdate(result) {
     console.log(`  action: ${result.fast_path.action || '(none)'}`);
     console.log(`  run_status: ${result.fast_path.run_status || '(none)'}`);
     console.log(`  current_role: ${result.fast_path.current_role || '(none)'}`);
-    console.log(`  archived_to: ${result.fast_path.archived_to || '(none)'}`);
+    console.log(`  specs_stored_at: ${result.fast_path.specs_stored_at || '(none)'}`);
     console.log(`  requires_followup_turn: ${result.fast_path.requires_followup_turn ? 'yes' : 'no'}`);
   }
   console.log('turn:');
@@ -431,7 +431,12 @@ async function main(mode, argv) {
   }
 
   if (options.json) {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    const output = `${JSON.stringify(result, null, 2)}\n`;
+    // 确保 stdout 完整写入后再退出，避免 spawnSync 截断
+    process.stdout.write(output);
+    if (process.stdout.writableLength > 0) {
+      await new Promise((resolve) => process.stdout.once('drain', resolve));
+    }
   } else {
     if (mode === 'advance') {
       printStep(result);

package/bin/refresh-command.js

@@ -0,0 +1,185 @@
+const path = require('path');
+const fs = require('fs');
+
+function parseArgs(argv) {
+  const options = {
+    target: '.',
+    json: false,
+    help: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--json') {
+      options.json = true;
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (!arg.startsWith('-')) {
+      options.target = arg;
+    } else {
+      throw new Error(`未知 refresh 参数：${arg}`);
+    }
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log(`ai-spec-auto refresh [目录] [--json]
+
+说明：
+  轻量更新命令。仅同步流程编排相关资产（commands、flows、orchestration、registry、templates）。
+  不覆盖项目已定制的 rules、skills、roles。
+  不重新扫描项目、不重建 manifest、不触发交互确认。
+
+选项：
+  --json    以 JSON 格式输出
+
+示例：
+  npx @gong-ym/ai-spec-auto@latest refresh
+  npx @gong-ym/ai-spec-auto@latest refresh .
+  npx @gong-ym/ai-spec-auto@latest refresh /path/to/project`);
+}
+
+function copyDirSync(src, 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 {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function refresh(targetDir, pkgRoot) {
+  const agentsDir = path.join(targetDir, '.agents');
+  if (!fs.existsSync(agentsDir)) {
+    throw new Error(`${targetDir} 未找到 .agents/，请先运行 init`);
+  }
+
+  const sourceDir = pkgRoot;
+  const sourceAgentsDir = path.join(sourceDir, '.agents');
+  const updated = [];
+  const skipped = [];
+
+  if (!fs.existsSync(sourceAgentsDir)) {
+    throw new Error(`包内 .agents/ 源目录不存在：${sourceAgentsDir}`);
+  }
+
+  // 1. 同步流程编排相关目录（不覆盖项目已定制的 rules/skills/roles）
+  const flowDirs = ['commands', 'flows', 'orchestration', 'registry', 'templates'];
+  for (const dir of flowDirs) {
+    const srcDir = path.join(sourceAgentsDir, dir);
+    const destDir = path.join(agentsDir, dir);
+    if (!fs.existsSync(srcDir)) continue;
+
+    try {
+      if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+      }
+      copyDirSync(srcDir, destDir);
+      updated.push(`.agents/${dir}/`);
+    } catch (error) {
+      skipped.push({ path: `.agents/${dir}/`, reason: error.message });
+    }
+  }
+
+  // 2. 同步 openspec 模板
+  const sourceTemplates = path.join(sourceDir, 'openspec', 'schemas', 'expert-delivery', 'templates');
+  const targetTemplates = path.join(targetDir, 'openspec', 'schemas', 'expert-delivery', 'templates');
+  if (fs.existsSync(sourceTemplates) && fs.existsSync(targetTemplates)) {
+    try {
+      const templateFiles = fs.readdirSync(sourceTemplates);
+      for (const file of templateFiles) {
+        const srcFile = path.join(sourceTemplates, file);
+        const destFile = path.join(targetTemplates, file);
+        if (fs.statSync(srcFile).isFile()) {
+          fs.copyFileSync(srcFile, destFile);
+        }
+      }
+      updated.push('openspec/schemas/expert-delivery/templates/');
+    } catch (error) {
+      skipped.push({ path: 'openspec/schemas/expert-delivery/templates/', reason: error.message });
+    }
+  }
+
+  // 3. 同步 openspec/config.yaml.template
+  const sourceConfig = path.join(sourceDir, 'openspec', 'config.yaml.template');
+  const targetConfig = path.join(targetDir, 'openspec', 'config.yaml.template');
+  if (fs.existsSync(sourceConfig) && fs.existsSync(targetConfig)) {
+    fs.copyFileSync(sourceConfig, targetConfig);
+    updated.push('openspec/config.yaml.template');
+  }
+
+  // 4. 同步 IDE 配置文件（跳过指针文件，只同步实际目录）
+  // IDE 的 commands/rules/skills 可能是指向 .agents/ 的指针文件（非目录），
+  // 这些指针文件不需要替换，因为 .agents/ 已经在步骤 1 中同步过了。
+  const ides = ['cursor', 'claude', 'qoder', 'trae', 'opencode'];
+  for (const ide of ides) {
+    const sourceIdeDir = path.join(sourceDir, `.${ide}`);
+    const targetIdeDir = path.join(targetDir, `.${ide}`);
+    if (!fs.existsSync(sourceIdeDir) || !fs.existsSync(targetIdeDir)) continue;
+
+    // 同步 IDE 特有配置文件（如 mcp.json）
+    try {
+      const sourceEntries = fs.readdirSync(sourceIdeDir);
+      for (const entry of sourceEntries) {
+        const srcPath = path.join(sourceIdeDir, entry);
+        const destPath = path.join(targetIdeDir, entry);
+        // 只同步文件，不同步目录（commands/rules/skills 目录由 .agents/ 指针管理）
+        if (fs.statSync(srcPath).isFile()) {
+          fs.copyFileSync(srcPath, destPath);
+          updated.push(`.${ide}/${entry}`);
+        }
+      }
+    } catch (error) {
+      skipped.push({ path: `.${ide}/`, reason: error.message });
+    }
+  }
+
+  return { updated, skipped };
+}
+
+function isSymlink(p) {
+  try {
+    return fs.lstatSync(p).isSymbolicLink();
+  } catch (_) {
+    return false;
+  }
+}
+
+function main(argv = process.argv.slice(2)) {
+  const options = parseArgs(argv);
+  if (options.help) {
+    printUsage();
+    return 0;
+  }
+
+  const targetDir = path.resolve(process.cwd(), options.target);
+  const pkgRoot = path.join(__dirname, '..');
+  const result = refresh(targetDir, pkgRoot);
+
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log('refresh 完成');
+    console.log(`  更新 ${result.updated.length} 项：`);
+    for (const item of result.updated) {
+      console.log(`    ✓ ${item}`);
+    }
+    if (result.skipped.length > 0) {
+      console.log(`  跳过 ${result.skipped.length} 项：`);
+      for (const item of result.skipped) {
+        console.log(`    ✗ ${item.path} (${item.reason})`);
+      }
+    }
+  }
+
+  return result.skipped.length > 0 ? 1 : 0;
+}
+
+module.exports = { main, parseArgs, refresh };

package/bin/runtime-state.js

@@ -683,6 +683,17 @@ function normalizeSpecsArtifactPath(relPath) {
     return null;
   }
 
+  // 新格式: openspec/specs/{changeId}.md 直接返回
+  if (/openspec[/\\]specs[/\\][^/\\]+\.md$/.test(value)) {
+    return value.replace(/[\\/]+$/, '');
+  }
+
+  // 兼容旧目录格式: openspec/specs/{changeId} 或 openspec/specs/{changeId}/...
+  if (/openspec[/\\]specs[/\\][^/\\]+$/.test(value)) {
+    return value.replace(/[\\/]+$/, '');
+  }
+
+  // 旧格式兼容: 提取 openspec/specs 部分
   const normalized = value.replace(/[\\/]+$/, '');
   if (/[\\/]specs$/.test(normalized)) {
     return normalized;
@@ -702,7 +713,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: `${historyDir}/bugfix.md`,
       implementation_notes: `${historyDir}/implementation-notes.md`,
@@ -716,7 +726,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: null,
       implementation_notes: null,
@@ -730,7 +739,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
   return {
     proposal: `${baseDir}/proposal.md`,
     specs: `${baseDir}/specs`,
-    design: `${baseDir}/design.md`,
     tasks: `${baseDir}/tasks.md`,
     bugfix: null,
     implementation_notes: null,
@@ -743,14 +751,14 @@ function buildDefaultArtifacts(changeId, options = {}) {
 function mergeArtifacts(baseArtifacts, inferredArtifacts) {
   const proposal = inferredArtifacts?.proposal || baseArtifacts?.proposal || null;
   const specs = normalizeSpecsArtifactPath(inferredArtifacts?.specs || baseArtifacts?.specs || null);
-  const design = inferredArtifacts?.design || baseArtifacts?.design || null;
   const tasks = inferredArtifacts?.tasks || baseArtifacts?.tasks || null;
   const bugfix = inferredArtifacts?.bugfix || baseArtifacts?.bugfix || null;
   const implementationNotes = inferredArtifacts?.implementation_notes || baseArtifacts?.implementation_notes || null;
   const checklist = inferredArtifacts?.checklist || baseArtifacts?.checklist || null;
   const iterations = inferredArtifacts?.iterations || baseArtifacts?.iterations || null;
+  const summary = inferredArtifacts?.summary || baseArtifacts?.summary || null;
   const primaryArtifacts = new Set(
-    [proposal, specs, design, tasks, bugfix, implementationNotes, checklist, iterations]
+    [proposal, specs, tasks, bugfix, implementationNotes, checklist, iterations, summary]
       .map((item) => (typeof item === 'string' ? item.trim().replace(/[\\/]+$/, '') : null))
       .filter(Boolean),
   );
@@ -766,12 +774,12 @@ function mergeArtifacts(baseArtifacts, inferredArtifacts) {
   const merged = {
     proposal,
     specs,
-    design,
     tasks,
     bugfix,
     implementation_notes: implementationNotes,
     checklist,
     iterations,
+    summary,
     additional: Array.from(new Set(additional.filter(Boolean))),
   };
 
@@ -786,12 +794,12 @@ function inferArtifacts(artifacts) {
   const normalized = {
     proposal: null,
     specs: null,
-    design: null,
     tasks: null,
     bugfix: null,
     implementation_notes: null,
     checklist: null,
     iterations: null,
+    summary: null,
     additional: [],
   };
 
@@ -800,7 +808,7 @@ function inferArtifacts(artifacts) {
   }
 
   if (artifacts && typeof artifacts === 'object' && !Array.isArray(artifacts)) {
-    const directKeys = ['proposal', 'specs', 'design', 'tasks', 'bugfix', 'implementation_notes', 'checklist', 'iterations'];
+    const directKeys = ['proposal', 'specs', 'tasks', 'bugfix', 'implementation_notes', 'checklist', 'iterations', 'summary'];
     for (const key of directKeys) {
       if (typeof artifacts[key] === 'string' && artifacts[key].trim()) {
         normalized[key] = key === 'specs'
@@ -839,10 +847,6 @@ function inferArtifacts(artifacts) {
       normalized.specs = normalizeSpecsArtifactPath(item);
       continue;
     }
-    if (item.endsWith('/design.md')) {
-      normalized.design = item;
-      continue;
-    }
     if (item.endsWith('/tasks.md')) {
       normalized.tasks = item;
       continue;
@@ -1134,9 +1138,9 @@ function assertRequiredOpenSpecArtifacts(targetDir, state, action, toRole) {
 
   let requiredArtifacts = [];
   if (action === 'handoff' && toRole === 'frontend-implementer') {
-    requiredArtifacts = ['proposal', 'specs', 'design', 'tasks'];
+    requiredArtifacts = ['proposal', 'specs', 'tasks'];
   } else if (action === 'complete') {
-    requiredArtifacts = ['proposal', 'specs', 'design', 'tasks', 'checklist', 'iterations'];
+    requiredArtifacts = ['proposal', 'specs', 'tasks', 'checklist', 'iterations'];
   }
 
   if (requiredArtifacts.length === 0) {

package/bin/task-orchestrator-runner.js

@@ -940,8 +940,8 @@ function advanceRunner(options) {
     };
     const autoRuntimeAction = buildAutoRuntimeAction(targetDir, recorded.execution.payload);
     if (autoRuntimeAction) {
-      if (recorded.execution.archive_result?.archived_artifacts) {
-        autoRuntimeAction.artifacts = recorded.execution.archive_result.archived_artifacts;
+      if (recorded.execution.archive_result?.specs_stored_at) {
+        autoRuntimeAction.artifacts = { specs: recorded.execution.archive_result.specs_stored_at };
         autoRuntimeAction.skip_artifact_check = true;
       }
       recorded.runtime_action = {