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

package/.agents/skills/common/create-proposal/SKILL.md

@@ -15,7 +15,7 @@ compatibility: Requires an OpenSpec workspace, local .agents/rules constraints,
 | 层 | 职责 | 产物位置 |
 |----|------|----------|
 | **本技能** | 需求前置分析 + 上下文注入 + 后置检查 | 无独立产物（分析结论注入 OpenSpec 上下文） |
-| **OpenSpec** | 生成 proposal.md / specs/ / design.md / tasks.md | `openspec/changes/<name>/` |
+| **OpenSpec** | 生成 proposal.md / specs/ / tasks.md | `openspec/changes/<name>/` |
 | **config.yaml** | 桥接 ai-spec-auto  规范到 OpenSpec rules | `openspec/config.yaml` |
 
 ## 使用时机
@@ -49,9 +49,9 @@ compatibility: Requires an OpenSpec workspace, local .agents/rules constraints,
 |------|------|------|
 | **是否有设计稿或 UI 要求描述** | 有 / 无 | 有 → 步骤 2 触发 design-analysis；OpenSpec 的 tasks 中应包含 UI 验收任务 |
 | **是否有接口（已提供或约定）** | 有 / 无 / 未就绪 | 有 → 正常对接；无 → 可不做数据层；未就绪 → mock，见项目 Mock 数据策略 |
-| **交付形态** | 新页面 / 功能组件 / 能力模块 / 其它 | 决定目录结构（routes vs components）与 OpenSpec design.md 中的技术方案 |
+| **交付形态** | 新页面 / 功能组件 / 能力模块 / 其它 | 决定目录结构（routes vs components）与 OpenSpec tasks.md 中的技术方案 |
 | **是否仅样式/还原类** | 是 / 否 | 是 → 重点在 design-analysis + 验收 |
-| **是否存在复杂交互** | 有 / 无 | 有 → 先按 `references/interaction-spec-template.md` 收口搜索、表单、弹窗、批量操作等交互说明，再写 proposal/design/tasks |
+| **是否存在复杂交互** | 有 / 无 | 有 → 先按 `references/interaction-spec-template.md` 收口搜索、表单、弹窗、批量操作等交互说明，再写 proposal/tasks |
 
 ---
 
@@ -62,9 +62,9 @@ compatibility: Requires an OpenSpec workspace, local .agents/rules constraints,
 - **使用技能**：`.agents/skills/design-analysis/SKILL.md`
 - **产出**：`docs/样式还原/<名称>-UI分析清单.md`
 
-分析清单应在 OpenSpec 生成提案前或同步完成，以便 OpenSpec 的 specs/、design.md、tasks.md 能引用分析结果。
+分析清单应在 OpenSpec 生成提案前或同步完成，以便 OpenSpec 的 specs/、tasks.md 能引用分析结果。
 
-若页面包含搜索、表单、弹窗、批量操作、复杂状态切换等交互，先参考 `references/interaction-spec-template.md` 把交互说明整理成摘要，再写入 `proposal.md / design.md / tasks.md`，避免实现阶段自己补口径。
+若页面包含搜索、表单、弹窗、批量操作、复杂状态切换等交互，先参考 `references/interaction-spec-template.md` 把交互说明整理成摘要，再写入 `proposal.md / tasks.md`，避免实现阶段自己补口径。
 
 ---
 
@@ -81,7 +81,6 @@ openspec/changes/<change-name>/
 ├── specs/              # Delta specs（新增/修改/删除的需求）
 │   └── <domain>/
 │       └── spec.md
-├── design.md           # 技术设计（方案选型、组件拆分、数据结构）
 └── tasks.md            # 实施任务清单
 ```
 
@@ -100,7 +99,7 @@ openspec/changes/<change-name>/
 
 OpenSpec 生成提案后，检查以下项目并按需补充：
 
-### 4.1 design.md 检查
+### 4.1 tasks.md 前置检查
 - 技术方案是否遵循 `.agents/rules/` 中的架构约束
 - 涉及页面时，是否参考了 `.agents/rules/06-路由规范.md`
 - 涉及组件时，是否参考了 `.agents/rules/04-组件规范.md`
@@ -150,7 +149,7 @@ OpenSpec 生成提案且本步骤 4 检查完毕后，**必须**以独立小节
 
 适合小改动或用户明确要求「快扫清单」、不强制每步输出四步标题时，提供**可复制**提示语：
 
-> 请直接按 `openspec/changes/<change-name>/tasks.md` 顺序逐项实现，每完成一项将对应 `- [ ]` 改为 `- [x]`，并保证与 `design.md`、`specs/` 一致。**凡产生代码变更**，仍须按 `.agents/rules/14-审计汇报规范.md` 输出审计报告，不得因未走 execute-task 四步而省略。
+> 请直接按 `openspec/changes/<change-name>/tasks.md` 顺序逐项实现，每完成一项将对应 `- [ ]` 改为 `- [x]`，并保证与 `specs/` 一致。**凡产生代码变更**，仍须按 `.agents/rules/14-审计汇报规范.md` 输出审计报告，不得因未走 execute-task 四步而省略。
 
 #### 4.5.4 可选说明
 

package/.agents/skills/common/execute-task/SKILL.md

@@ -44,7 +44,7 @@ metadata:
 ## 前置要求
 
 1. 当前工作区必须存在 `tasks.md` 文件，且包含未完成的任务 (`- [ ]`)。
-2. 必须已完整读取对应变更目录下的 `proposal.md` 或 `design.md` 获取上下文。
+2. 必须已完整读取对应变更目录下的 `proposal.md` 或 `specs/` 获取上下文。
 3. 必须已读取 `.agents/rules/12-Superpowers执行规范.md` 确认执行原则。
 4. 必须已读取 `.agents/rules/14-审计汇报规范.md` 确认审计报告格式。
 
@@ -111,7 +111,7 @@ metadata:
 
 | 维度 | 检查项 | 结论 |
 |------|--------|------|
-| 架构对齐 | 实现是否符合 `design.md` / `specs/` | 通过 / 偏差说明 |
+| 架构对齐 | 实现是否符合 `specs/` | 通过 / 偏差说明 |
 | 代码健壮性 | 异常捕获、类型严谨、边界处理 | 通过 / 待补充项 |
 | 规范合规 | 是否符合步骤 1 加载的规范 | 通过 / 偏差说明 |
 
@@ -124,7 +124,7 @@ metadata:
 
 | 维度 | 检查项 | 结论 |
 |------|--------|------|
-| 架构对齐 | 符合 design.md 组件拆分方案 | 通过 |
+| 架构对齐 | 符合 specs/ 组件拆分方案 | 通过 |
 | 代码健壮性 | Props 均有默认值，loading 防重复点击 | 通过 |
 | 规范合规 | 目录 PascalCase、barrel export（04-组件规范） | 通过 |
 ```

package/.agents/skills/profiles/react/create-api/SKILL.md

@@ -72,7 +72,7 @@ export type UpdateBannerParams = CreateBannerParams & { id: number };
 
 ```ts
 // src/api/banner.ts
-import { request } from '@koi-design/vix-tools';
+import { request } from '@/utils/request';
 import type {
   GetBannerListParams,
   GetBannerListResult,
@@ -140,6 +140,6 @@ const loadData = async () => {
 
 - [ ] 类型在 `src/api/types/<module>.ts`，请求在 `src/api/<module>.ts`？
 - [ ] 命名符合 `getXxxApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`？
-- [ ] 使用 `import { request } from '@koi-design/vix-tools'`？
+- [ ] 使用项目统一的 `request` 工具函数（如 `@/utils/request`）？
 - [ ] 未重复处理接口错误？
 - [ ] 类型与接口文档一致？

package/.agents/skills/profiles/vue/create-api/SKILL.md

@@ -51,7 +51,7 @@ export type UpdateBannerParams = CreateBannerParams & { id: number };
 
 ```ts
 // src/api/banner.ts
-import { request } from '@koi-design/vix-tools';
+import { request } from '@/utils/request';
 import type {
   GetBannerListParams,
   GetBannerListResult,
@@ -100,6 +100,6 @@ export function deleteBannerApi(id: number): Promise<void> {
 
 - [ ] 类型在 `src/api/types/<name>.ts`，请求在 `src/api/<name>.ts`？
 - [ ] 命名符合 `getXxxApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`？
-- [ ] 使用 `import { request } from '@koi-design/vix-tools'`？
+- [ ] 使用项目统一的 `request` 工具函数（如 `@/utils/request`）？
 - [ ] 未重复处理接口错误？
 - [ ] 类型与接口文档一致？

package/bin/archive-change.js

@@ -118,132 +118,6 @@ function countTaskCompletion(tasksPath) {
   return { completed, total };
 }
 
-function generateArchiveSummary(archivedPath, changeId) {
-  const proposalPath = path.join(archivedPath, 'proposal.md');
-  const designPath = path.join(archivedPath, 'design.md');
-  const tasksPath = path.join(archivedPath, 'tasks.md');
-  const checklistPath = path.join(archivedPath, 'checklist.md');
-  const specMdPath = path.join(archivedPath, 'spec.md');
-
-  // 提取标题
-  let title = changeId;
-  if (fs.existsSync(proposalPath)) {
-    const content = fs.readFileSync(proposalPath, 'utf8');
-    const titleMatch = content.match(/^#\s+(.+)$/m);
-    if (titleMatch) title = titleMatch[1].trim();
-  }
-
-  // 提取业务目标（从 proposal）
-  let businessGoal = '';
-  if (fs.existsSync(proposalPath)) {
-    const content = fs.readFileSync(proposalPath, 'utf8');
-    // 找“业务目标”或“目标”部分
-    const goalMatch = content.match(/(?:业务目标|目标|## Goal)[^#]*?([\s\S]*?)(?=#|$)/i);
-    if (goalMatch) businessGoal = goalMatch[1].trim().slice(0, 300);
-  }
-
-  // 提取任务完成情况
-  const taskStats = countTaskCompletion(tasksPath);
-
-  // 提取关键设计决策（从 design）
-  let designDecisions = '';
-  if (fs.existsSync(designPath)) {
-    const content = fs.readFileSync(designPath, 'utf8');
-    const decisionMatch = content.match(/(?:设计决策|关键决策|技术方案|## Decision)[^#]*?([\s\S]*?)(?=##|$)/i);
-    if (decisionMatch) designDecisions = decisionMatch[1].trim().slice(0, 200);
-  }
-
-  // 提取验收结论（从 checklist）
-  let acceptance = '';
-  if (fs.existsSync(checklistPath)) {
-    const content = fs.readFileSync(checklistPath, 'utf8');
-    // 先匹配 ## 结论 / ## Conclusion 二级标题，再回退匹配 # 验收 / # 结论 一级标题
-    const conclusionMatch = content.match(/## (?:结论|Conclusion)[^#]*?([\s\S]*?)(?=##?\s|$)/i)
-      || content.match(/# (?:验收|结论)[^#]*?([\s\S]*?)(?=##?\s|$)/i);
-    if (conclusionMatch) acceptance = conclusionMatch[1].trim().slice(0, 200);
-  }
-
-  // 提取规格（从 spec.md 或 specs/ 目录）
-  let specSummary = '';
-  if (fs.existsSync(specMdPath)) {
-    specSummary = fs.readFileSync(specMdPath, 'utf8').trim().slice(0, 300);
-  }
-
-  const now = new Date().toISOString().slice(0, 10);
-  const summary = [
-    `# ${title}`,
-    '',
-    `> 归档日期：${now}  |  任务完成：${taskStats.completed}/${taskStats.total}`,
-    '',
-    businessGoal ? `## 业务目标\n\n${businessGoal}\n` : '',
-    specSummary ? `## 需求规格\n\n${specSummary}\n` : '',
-    designDecisions ? `## 设计决策\n\n${designDecisions}\n` : '',
-    acceptance ? `## 验收结论\n\n${acceptance}\n` : '',
-  ].filter(Boolean).join('\n');
-
-  const summaryPath = path.join(archivedPath, 'summary.md');
-  fs.writeFileSync(summaryPath, summary, 'utf8');
-  return summaryPath;
-}
-
-function cleanupProcessFiles(archivedPath) {
-  const processFiles = ['proposal.md', 'design.md', 'tasks.md', 'checklist.md', 'iterations.md', 'spec.md'];
-  const removed = [];
-  for (const file of processFiles) {
-    const filePath = path.join(archivedPath, file);
-    if (fs.existsSync(filePath)) {
-      fs.unlinkSync(filePath);
-      removed.push(file);
-    }
-  }
-  return removed;
-}
-
-function normalizeMarkdown(content) {
-  return String(content || '').replace(/\r\n/g, '\n').trim();
-}
-
-function normalizeSpecsArtifactPath(relPath) {
-  const value = String(relPath || '').trim();
-  if (!value) {
-    return null;
-  }
-
-  const normalized = value.replace(/[\\/]+$/, '');
-  if (/[\\/]specs$/.test(normalized)) {
-    return normalized;
-  }
-
-  const match = normalized.match(/^(.*[\\/]specs)(?:[\\/].+)?$/);
-  return match ? match[1] : normalized;
-}
-
-function mergeSpecFile(targetPath, incomingContent, changeId) {
-  if (!fs.existsSync(targetPath)) {
-    fs.writeFileSync(targetPath, `${incomingContent.trim()}\n`, 'utf8');
-    return 'added';
-  }
-
-  const existingContent = fs.readFileSync(targetPath, 'utf8');
-  const normalizedExisting = normalizeMarkdown(existingContent);
-  const normalizedIncoming = normalizeMarkdown(incomingContent);
-
-  if (!normalizedIncoming || normalizedExisting === normalizedIncoming || normalizedExisting.includes(normalizedIncoming)) {
-    return 'unchanged';
-  }
-
-  const merged = [
-    existingContent.trimEnd(),
-    '',
-    `<!-- merged from change: ${changeId} -->`,
-    '',
-    normalizedIncoming,
-    '',
-  ].join('\n');
-  fs.writeFileSync(targetPath, merged, 'utf8');
-  return 'updated';
-}
-
 function resolveChangeId(targetDir, explicitChangeId) {
   if (explicitChangeId) {
     return explicitChangeId;
@@ -253,68 +127,28 @@ function resolveChangeId(targetDir, explicitChangeId) {
   return currentRun?.task?.change_id || currentRun?.anchor?.task?.change_id || null;
 }
 
-function buildArchiveDestination(baseArchiveDir, changeId, now = new Date()) {
-  const day = now.toISOString().slice(0, 10);
-  const baseName = `${day}-${changeId}`;
-  let candidate = path.join(baseArchiveDir, baseName);
-  let suffix = 1;
-
-  while (fs.existsSync(candidate)) {
-    suffix += 1;
-    candidate = path.join(baseArchiveDir, `${baseName}-${suffix}`);
-  }
-
-  return candidate;
-}
-
 function buildAlreadyArchivedResult(targetDir, changeId) {
-  const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
-  const proposalPath = currentRun?.artifacts?.proposal
-    ? path.join(targetDir, currentRun.artifacts.proposal)
-    : null;
-  const specsPath = currentRun?.artifacts?.specs
-    ? path.join(targetDir, normalizeSpecsArtifactPath(currentRun.artifacts.specs))
-    : null;
-  const designPath = currentRun?.artifacts?.design
-    ? path.join(targetDir, currentRun.artifacts.design)
-    : null;
-
-  if (!proposalPath || !specsPath || !designPath) {
-    return null;
-  }
-  if (!proposalPath.includes(`${path.sep}openspec${path.sep}changes${path.sep}archive${path.sep}`)) {
-    return null;
-  }
-  if (!fs.existsSync(proposalPath) || !fs.existsSync(specsPath) || !fs.existsSync(designPath)) {
+  // 检查 specs 是否已存储到 openspec/specs/{changeId}.md
+  const specFile = path.join(targetDir, 'openspec', 'specs', `${changeId}.md`);
+  if (!fs.existsSync(specFile)) {
     return null;
   }
+  const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
   if ((currentRun?.task?.change_id || currentRun?.anchor?.task?.change_id || null) !== changeId) {
     return null;
   }
 
-  const archivedDir = path.dirname(proposalPath);
-  const archivedRel = path.relative(targetDir, archivedDir);
   return {
     kind: 'archive-change-result',
     status: 'success',
     target: targetDir,
     change_id: changeId,
-    archived_to: archivedRel,
-    archived_artifacts: {
-      proposal: path.relative(targetDir, proposalPath),
-      specs: path.relative(targetDir, specsPath),
-      design: path.relative(targetDir, designPath),
-      tasks: currentRun?.artifacts?.tasks || null,
-      checklist: currentRun?.artifacts?.checklist || null,
-      iterations: currentRun?.artifacts?.iterations || null,
-    },
-    merged: {
-      added_domains: [],
+    specs_stored_at: path.relative(targetDir, specFile),
+    archived: {
       added_specs: [],
-      updated_specs: [],
-      unchanged_specs: [],
+      updated_specs: [path.relative(targetDir, specFile)],
     },
-    task_completion: countTaskCompletion(path.join(archivedDir, 'tasks.md')),
+    task_completion: { completed: 0, total: 0 },
     already_archived: true,
   };
 }
@@ -360,8 +194,10 @@ function completeRunAfterArchive(targetDir, archiveResult) {
     fromRole: currentRun.current_role || 'archive-change',
     toRole: 'archive-change',
     status: 'success',
-    message: '归档完成，增量规范已合并并已写入归档目录。',
-    artifactsData: archiveResult.archived_artifacts,
+    message: '归档完成，规范已存储到 openspec/specs/。',
+    artifactsData: {
+      specs: archiveResult.specs_stored_at,
+    },
     skipArtifactCheck: true,
     clearPendingGate: true,
   });
@@ -373,25 +209,6 @@ function completeRunAfterArchive(targetDir, archiveResult) {
   };
 }
 
-function buildArchivedAdditionalArtifacts(currentArtifacts, changeId, archivedRelBase) {
-  const currentAdditional = Array.isArray(currentArtifacts?.additional) ? currentArtifacts.additional : [];
-  if (currentAdditional.length === 0) {
-    return [];
-  }
-
-  const activeBase = `openspec/changes/${changeId}`;
-  return currentAdditional
-    .map((item) => String(item || '').trim())
-    .filter(Boolean)
-    .map((item) => item.replace(/[\\/]+$/, ''))
-    .map((item) => {
-      if (item === activeBase || item.startsWith(`${activeBase}/`)) {
-        return item.replace(activeBase, archivedRelBase);
-      }
-      return item;
-    });
-}
-
 function archiveChange(options = {}) {
   const targetDir = path.resolve(options.target || '.');
   const changeId = resolveChangeId(targetDir, options.changeId);
@@ -413,7 +230,6 @@ function archiveChange(options = {}) {
 
   const proposalPath = path.join(changeDir, 'proposal.md');
   const tasksPath = path.join(changeDir, 'tasks.md');
-  const designPath = path.join(changeDir, 'design.md');
   const checklistPath = path.join(changeDir, 'checklist.md');
   const iterationsPath = path.join(changeDir, 'iterations.md');
   const specsDir = path.join(changeDir, 'specs');
@@ -424,63 +240,37 @@ function archiveChange(options = {}) {
   if (!fs.existsSync(tasksPath)) {
     throw new Error(`tasks.md is missing for change ${changeId}`);
   }
-  if (!fs.existsSync(designPath)) {
-    throw new Error(`design.md is missing for change ${changeId}`);
-  }
   if (!fs.existsSync(specsDir)) {
     throw new Error(`specs/ is missing for change ${changeId}`);
   }
 
-  const targetSpecsDir = path.join(targetDir, 'openspec', 'specs');
-  ensureDir(targetSpecsDir);
+  // 先统计任务完成情况（在清理之前）
+  const taskCompletionStats = countTaskCompletion(path.join(changeDir, 'tasks.md'));
+
+  // 合并所有 spec 文件为单个文件
+  const targetSpecFile = path.join(targetDir, 'openspec', 'specs', `${changeId}.md`);
+  ensureDir(path.dirname(targetSpecFile));
+
+  const sourceSpecFiles = listFilesRecursive(specsDir);
+  const specContents = sourceSpecFiles.map((f) => fs.readFileSync(f, 'utf8').trim()).filter(Boolean);
+  const mergedContent = specContents.join('\n\n---\n\n');
 
-  const merged = {
-    added_domains: [],
+  const archived = {
     added_specs: [],
     updated_specs: [],
-    unchanged_specs: [],
   };
-  const seenDomains = new Set();
-  const sourceSpecFiles = listFilesRecursive(specsDir);
-  for (const sourceFile of sourceSpecFiles) {
-    const relFromSpecs = path.relative(specsDir, sourceFile);
-    const domain = relFromSpecs.split(path.sep)[0] || null;
-    const targetFile = path.join(targetSpecsDir, relFromSpecs);
-    const targetDomainDir = path.dirname(targetFile);
-    const domainRel = domain ? path.join('openspec', 'specs', domain) : null;
-
-    if (domainRel && !fs.existsSync(targetDomainDir) && !seenDomains.has(domainRel)) {
-      ensureDir(targetDomainDir);
-      merged.added_domains.push(domainRel);
-      seenDomains.add(domainRel);
-    } else {
-      ensureDir(targetDomainDir);
-    }
 
-    const mergeStatus = mergeSpecFile(targetFile, fs.readFileSync(sourceFile, 'utf8'), changeId);
-    const relTargetFile = path.relative(targetDir, targetFile);
-    if (mergeStatus === 'added') {
-      merged.added_specs.push(relTargetFile);
-    } else if (mergeStatus === 'updated') {
-      merged.updated_specs.push(relTargetFile);
-    } else {
-      merged.unchanged_specs.push(relTargetFile);
-    }
+  if (fs.existsSync(targetSpecFile)) {
+    fs.writeFileSync(targetSpecFile, mergedContent, 'utf8');
+    archived.updated_specs.push(path.relative(targetDir, targetSpecFile));
+  } else {
+    fs.writeFileSync(targetSpecFile, mergedContent, 'utf8');
+    archived.added_specs.push(path.relative(targetDir, targetSpecFile));
   }
 
-  const archiveRoot = path.join(targetDir, 'openspec', 'changes', 'archive');
-  ensureDir(archiveRoot);
-  const archivedPath = buildArchiveDestination(archiveRoot, changeId, options.now || new Date());
-  fs.renameSync(changeDir, archivedPath);
+  // 清理变更目录（不保留归档）
+  fs.rmSync(changeDir, { recursive: true, force: true });
 
-  // 先统计任务完成情况（在清理之前）
-  const taskCompletionStats = countTaskCompletion(path.join(archivedPath, 'tasks.md'));
-
-  // 生成精简 summary 并清理过程文件
-  const summaryPath = generateArchiveSummary(archivedPath, changeId);
-  const removedFiles = cleanupProcessFiles(archivedPath);
-
-  const archivedRelBase = path.relative(targetDir, archivedPath);
   const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
 
   const result = {
@@ -488,17 +278,8 @@ function archiveChange(options = {}) {
     status: 'success',
     target: targetDir,
     change_id: changeId,
-    archived_to: archivedRelBase,
-    summary: path.relative(targetDir, summaryPath),
-    removed_process_files: removedFiles,
-    archived_artifacts: {
-      summary: path.relative(targetDir, summaryPath),
-      specs: fs.existsSync(path.join(archivedPath, 'specs'))
-        ? path.relative(targetDir, path.join(archivedPath, 'specs'))
-        : null,
-      additional: buildArchivedAdditionalArtifacts(currentRun?.artifacts || null, changeId, archivedRelBase),
-    },
-    merged,
+    specs_stored_at: path.relative(targetDir, targetSpecFile),
+    archived,
     task_completion: taskCompletionStats,
   };
 
@@ -515,13 +296,10 @@ function printPretty(result) {
   console.log('archive-change');
   console.log(`  target: ${result.target}`);
   console.log(`  change_id: ${result.change_id}`);
-  console.log(`  archived_to: ${result.archived_to}`);
-  console.log(`  summary: ${result.summary}`);
-  console.log(`  cleaned: ${result.removed_process_files.join(', ') || '(none)'}`);
-  console.log(`  added_domains: ${result.merged.added_domains.length}`);
-  console.log(`  added_specs: ${result.merged.added_specs.length}`);
-  console.log(`  updated_specs: ${result.merged.updated_specs.length}`);
-  console.log(`  unchanged_specs: ${result.merged.unchanged_specs.length}`);
+  console.log(`  specs_stored_at: ${result.specs_stored_at}`);
+  console.log(`  added_specs: ${result.archived.added_specs.length}`);
+  console.log(`  updated_specs: ${result.archived.updated_specs.length}`);
+  console.log(`  task_completion: ${result.task_completion.completed}/${result.task_completion.total}`);
   if (result.runtime_transition?.state?.status) {
     console.log(`  run_status: ${result.runtime_transition.state.status}`);
   }

package/bin/cli.js

@@ -154,6 +154,11 @@ function shouldUseIntegrityCommand(args, cwd) {
       process.exit(await repairCommand.main(args.slice(1)));
     }
 
+    if (args[0] === 'refresh') {
+      const refreshCommand = require('./refresh-command');
+      process.exit(refreshCommand.main(args.slice(1)));
+    }
+
     if (args[0] === 'report') {
       const reportCommand = require('./report-command');
       process.exit(await reportCommand.main(args.slice(1)));