@ai-content-space/loopx 0.1.7 → 0.1.9

package/README.md

@@ -498,6 +498,7 @@ node --test test/*.test.mjs
 node scripts/install-skills.mjs --check
 node --test plugins/loopx/scripts/plugin-install.test.mjs
 node src/cli.mjs --help
+node src/cli.mjs --version
 node src/cli.mjs doctor
 node src/cli.mjs status --json
 ```
@@ -521,4 +522,4 @@ node src/cli.mjs status --json
 
 ## Version
 
-Current npm package version: `0.1.7`.
+Current npm package version: `0.1.9`.

package/README.zh-CN.md

@@ -509,6 +509,7 @@ node --test test/*.test.mjs
 node scripts/install-skills.mjs --check
 node --test plugins/loopx/scripts/plugin-install.test.mjs
 node src/cli.mjs --help
+node src/cli.mjs --version
 node src/cli.mjs doctor
 node src/cli.mjs status --json
 ```
@@ -532,4 +533,4 @@ node src/cli.mjs status --json
 
 ## 版本
 
-当前 npm 包版本：`0.1.7`。
+当前 npm 包版本：`0.1.9`。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-content-space/loopx",
   "type": "module",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Skill-first loopx workflow product for Codex",
   "repository": {
     "type": "git",

package/plugins/loopx/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "loopx",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Skill-first loopx workflow product for Codex",
   "skills": "./skills/",
   "interface": {

package/plugins/loopx/skills/archive/SKILL.md

@@ -3,7 +3,7 @@ name: archive
 description: "Archives an approved loopx change delta into long-lived specs and writes an ADR candidate after done approval. Not for active builds or unapproved reviews."
 when_to_use: "archive, done workflow, spec delta, long-lived specs, ADR candidate, review approved, 归档, 同步规格"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<workflow slug>"
 ---
 

package/plugins/loopx/skills/autopilot/SKILL.md

@@ -3,7 +3,7 @@ name: autopilot
 description: "Runs one bounded autonomous loopx orchestration over clarify, plan, build, and review while preserving canonical artifacts. Not for manual gate-by-gate control."
 when_to_use: "autopilot, autonomous loopx run, end-to-end workflow, run all stages, bounded orchestration, 自动执行, 全流程"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<workflow slug>"
 ---
 

package/plugins/loopx/skills/build/SKILL.md

@@ -3,7 +3,7 @@ name: build
 description: "Executes an approved loopx plan or review rework contract with evidence, verification, deslop, and regression gates. Not for unclear requirements or independent review."
 when_to_use: "build, implement approved plan, execute PRD, --from-review, review rework, implementation fixes, 执行, 实现, 修改"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "[--no-deslop] <approved PRD path or workflow slug> | --from-review <review artifact path>"
 ---
 

package/plugins/loopx/skills/clarify/SKILL.md

@@ -3,7 +3,7 @@ name: clarify
 description: "Clarifies ambiguous loopx work into requirements, non-goals, decision boundaries, and design-ready specs before planning. Not for already-approved plans or concrete implementation tasks."
 when_to_use: "clarify, requirements, ambiguous request, unclear scope, non-goals, decision boundaries, acceptance criteria, 需求澄清, 范围不清"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # loopx Clarify

package/plugins/loopx/skills/debug/SKILL.md

@@ -3,7 +3,7 @@ name: debug
 description: "Finds root cause for bugs, failing tests, build failures, regressions, and unexpected behavior before fixes. Not for new feature planning or routine code review."
 when_to_use: "debug, bug, test failure, build failure, regression, unexpected behavior, root cause, 报错, 失败, 回归, 排查"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Systematic Debugging

package/plugins/loopx/skills/go-style/SKILL.md

@@ -3,7 +3,7 @@ name: go-style
 description: "Applies loopx Go coding style for .go edits, tests, errors, context, naming, and interface boundaries. Not for non-Go code or Kratos-specific architecture by itself."
 when_to_use: "go-style, Go, golang, .go files, go tests, gofmt, idiomatic Go, Go style, Go 代码"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Go Style

package/plugins/loopx/skills/kratos/SKILL.md

@@ -3,7 +3,7 @@ name: kratos
 description: "Supports Go-Kratos microservices, proto/buf APIs, service/biz/data layers, middleware, auth, config, and troubleshooting. Not for generic Go style alone."
 when_to_use: "kratos, Go-Kratos, proto, buf, service layer, biz layer, data layer, middleware, auth, config, Kratos 微服务"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Kratos

package/plugins/loopx/skills/plan/SKILL.md

@@ -3,7 +3,7 @@ name: plan
 description: "Creates a consensus-first loopx plan package with Planner, Architect, and Critic review from an approved spec. Not for unresolved requirements or direct implementation."
 when_to_use: "plan, planning, consensus planning, PRD, architecture plan, test plan, approved clarify spec, 规划, 方案, 架构评审"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "[--interactive] [--deliberate] [--direct <spec-path>] <clarified task or spec path>"
 ---
 

package/plugins/loopx/skills/review/SKILL.md

@@ -3,7 +3,7 @@ name: review
 description: "Reviews a loopx build execution record for acceptance, code risks, evidence quality, and architecture smells. Not for doing implementation work or replanning."
 when_to_use: "review, code review, acceptance, go no-go, execution-record, architecture smell, build complete, 审查, 验收"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<execution-record path or workflow slug>"
 ---
 
@@ -101,13 +101,16 @@ For approval:
 
 ```text
 Next:
-loopx approve <slug> --from review --to done
+$archive <slug>
 ```
 
-After the workflow reaches `done`, run:
+`$archive` consumes the pending `review -> done` completion transition before syncing specs. Do not ask the user to run a separate `loopx approve <slug> --from review --to done` command in the normal Codex-facing flow.
 
-```text
-$archive <slug>
+For CLI/runtime debugging only, the equivalent explicit sequence is:
+
+```bash
+loopx approve <slug> --from review --to done
+loopx archive <slug>
 ```
 
 This syncs the approved `.loopx/changes/active/<change-id>/spec-delta.md` into long-lived `.loopx/specs/` files and moves the change folder under `.loopx/changes/archive/<change-id>/`.

package/plugins/loopx/skills/tdd/SKILL.md

@@ -3,7 +3,7 @@ name: tdd
 description: "Guides feature and bugfix implementation through a failing test before production code and red-green-refactor discipline. Not for generated files or throwaway prototypes."
 when_to_use: "tdd, failing test first, feature implementation, bugfix, regression test, red green refactor, 测试先行"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Test-Driven Development (TDD)

package/plugins/loopx/skills/verify/SKILL.md

@@ -3,7 +3,7 @@ name: verify
 description: "Requires fresh verification evidence before claiming work is complete, fixed, passing, review-ready, or ready to commit. Not for speculative confidence or stale results."
 when_to_use: "verify, completion claim, fixed claim, tests pass, review-ready, commit, fresh evidence, 验证, 完成前检查"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Verification Before Completion

package/scripts/codex-workflow-hook.mjs

@@ -40,6 +40,13 @@ function nextSkill(state) {
     && state.archive_status !== 'archived') {
     return `$archive ${state.slug}`;
   }
+  if (state.current_stage === 'review'
+    && state.review_verdict === 'approve'
+    && state.pending_user_decision === 'review->done'
+    && ['requested', 'approved'].includes(state.approval?.complete)
+    && state.archive_status !== 'archived') {
+    return `$archive ${state.slug}`;
+  }
   if (state.stage_status === 'awaiting-approval'
     && state.current_stage === 'plan'
     && Array.isArray(state.plan_blockers)
@@ -84,9 +91,6 @@ function nextSkill(state) {
     && state.approval?.rollback === 'approved') {
     return `$clarify ${state.slug}`;
   }
-  if (state.current_stage === 'review' && state.review_verdict === 'approve' && state.pending_user_decision === 'review->done') {
-    return `loopx approve ${state.slug} --from review --to done`;
-  }
   return null;
 }
 

package/skills/archive/SKILL.md

@@ -3,7 +3,7 @@ name: archive
 description: "Archives an approved loopx change delta into long-lived specs and writes an ADR candidate after done approval. Not for active builds or unapproved reviews."
 when_to_use: "archive, done workflow, spec delta, long-lived specs, ADR candidate, review approved, 归档, 同步规格"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<workflow slug>"
 ---
 

package/skills/autopilot/SKILL.md

@@ -3,7 +3,7 @@ name: autopilot
 description: "Runs one bounded autonomous loopx orchestration over clarify, plan, build, and review while preserving canonical artifacts. Not for manual gate-by-gate control."
 when_to_use: "autopilot, autonomous loopx run, end-to-end workflow, run all stages, bounded orchestration, 自动执行, 全流程"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<workflow slug>"
 ---
 

package/skills/build/SKILL.md

@@ -3,7 +3,7 @@ name: build
 description: "Executes an approved loopx plan or review rework contract with evidence, verification, deslop, and regression gates. Not for unclear requirements or independent review."
 when_to_use: "build, implement approved plan, execute PRD, --from-review, review rework, implementation fixes, 执行, 实现, 修改"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "[--no-deslop] <approved PRD path or workflow slug> | --from-review <review artifact path>"
 ---
 

package/skills/clarify/SKILL.md

@@ -3,7 +3,7 @@ name: clarify
 description: "Clarifies ambiguous loopx work into requirements, non-goals, decision boundaries, and design-ready specs before planning. Not for already-approved plans or concrete implementation tasks."
 when_to_use: "clarify, requirements, ambiguous request, unclear scope, non-goals, decision boundaries, acceptance criteria, 需求澄清, 范围不清"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # loopx Clarify

package/skills/debug/SKILL.md

@@ -3,7 +3,7 @@ name: debug
 description: "Finds root cause for bugs, failing tests, build failures, regressions, and unexpected behavior before fixes. Not for new feature planning or routine code review."
 when_to_use: "debug, bug, test failure, build failure, regression, unexpected behavior, root cause, 报错, 失败, 回归, 排查"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Systematic Debugging

package/skills/go-style/SKILL.md

@@ -3,7 +3,7 @@ name: go-style
 description: "Applies loopx Go coding style for .go edits, tests, errors, context, naming, and interface boundaries. Not for non-Go code or Kratos-specific architecture by itself."
 when_to_use: "go-style, Go, golang, .go files, go tests, gofmt, idiomatic Go, Go style, Go 代码"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Go Style

package/skills/kratos/SKILL.md

@@ -3,7 +3,7 @@ name: kratos
 description: "Supports Go-Kratos microservices, proto/buf APIs, service/biz/data layers, middleware, auth, config, and troubleshooting. Not for generic Go style alone."
 when_to_use: "kratos, Go-Kratos, proto, buf, service layer, biz layer, data layer, middleware, auth, config, Kratos 微服务"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Kratos

package/skills/plan/SKILL.md

@@ -3,7 +3,7 @@ name: plan
 description: "Creates a consensus-first loopx plan package with Planner, Architect, and Critic review from an approved spec. Not for unresolved requirements or direct implementation."
 when_to_use: "plan, planning, consensus planning, PRD, architecture plan, test plan, approved clarify spec, 规划, 方案, 架构评审"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "[--interactive] [--deliberate] [--direct <spec-path>] <clarified task or spec path>"
 ---
 

package/skills/review/SKILL.md

@@ -3,7 +3,7 @@ name: review
 description: "Reviews a loopx build execution record for acceptance, code risks, evidence quality, and architecture smells. Not for doing implementation work or replanning."
 when_to_use: "review, code review, acceptance, go no-go, execution-record, architecture smell, build complete, 审查, 验收"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 argument-hint: "<execution-record path or workflow slug>"
 ---
 
@@ -101,13 +101,16 @@ For approval:
 
 ```text
 Next:
-loopx approve <slug> --from review --to done
+$archive <slug>
 ```
 
-After the workflow reaches `done`, run:
+`$archive` consumes the pending `review -> done` completion transition before syncing specs. Do not ask the user to run a separate `loopx approve <slug> --from review --to done` command in the normal Codex-facing flow.
 
-```text
-$archive <slug>
+For CLI/runtime debugging only, the equivalent explicit sequence is:
+
+```bash
+loopx approve <slug> --from review --to done
+loopx archive <slug>
 ```
 
 This syncs the approved `.loopx/changes/active/<change-id>/spec-delta.md` into long-lived `.loopx/specs/` files and moves the change folder under `.loopx/changes/archive/<change-id>/`.

package/skills/tdd/SKILL.md

@@ -3,7 +3,7 @@ name: tdd
 description: "Guides feature and bugfix implementation through a failing test before production code and red-green-refactor discipline. Not for generated files or throwaway prototypes."
 when_to_use: "tdd, failing test first, feature implementation, bugfix, regression test, red green refactor, 测试先行"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Test-Driven Development (TDD)

package/skills/verify/SKILL.md

@@ -3,7 +3,7 @@ name: verify
 description: "Requires fresh verification evidence before claiming work is complete, fixed, passing, review-ready, or ready to commit. Not for speculative confidence or stale results."
 when_to_use: "verify, completion claim, fixed claim, tests pass, review-ready, commit, fresh evidence, 验证, 完成前检查"
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
 ---
 
 # Verification Before Completion

package/src/cli.mjs

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'node:fs';
+
 import { archiveStage, autopilotStage, approveStage, buildStage, clarifyStage, initWorkspace, planStage, reviewStage, statusSummary } from './workflow.mjs';
 import { renderHtmlViews } from './html-views.mjs';
 import { installBundledSkills } from './install-discovery.mjs';
@@ -7,9 +9,12 @@ import { nextSkillCommand, withNextSkill } from './next-skill.mjs';
 import { doctorRuntime, migrateLegacyRuntime } from './runtime-maintenance.mjs';
 import { setupWorkspaceContext } from './workspace-context.mjs';
 
+const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+
 function usage() {
   return [
     'Usage:',
+    '  loopx --version',
     '  loopx init [--slug <slug>]',
     '  loopx clarify <slug> [--standard|--deep]',
     '  loopx approve <slug> --from <stage> --to <stage>',
@@ -139,6 +144,10 @@ function printHumanStatus(status) {
 
 async function main() {
   const { command, positionals, options } = parseArgs(process.argv.slice(2));
+  if (command === 'version' || command === '--version' || command === '-v') {
+    console.log(packageJson.version);
+    return;
+  }
   if (!command || command === 'help' || command === '--help' || command === '-h') {
     console.log(usage());
     return;

package/src/html-views.mjs

@@ -11,13 +11,14 @@ const WORKFLOW_ARTIFACTS = [
   { name: 'architecture.md', label: '架构', page: 'plan.html' },
   { name: 'development-plan.md', label: '开发计划', page: 'plan.html' },
   { name: 'test-plan.md', label: '测试计划', page: 'plan.html' },
+  { name: 'requirement-traceability.md', label: '需求覆盖矩阵', page: 'plan.html' },
   { name: 'execution-record.md', label: '执行记录', page: 'build.html' },
   { name: 'review-report.md', label: '评审报告', page: 'review.html' },
 ];
 
 const PAGE_GROUPS = [
   { file: 'intake.html', title: '需求澄清', artifacts: ['spec.md'] },
-  { file: 'plan.html', title: '计划与架构', artifacts: ['plan.md', 'architecture.md', 'development-plan.md', 'test-plan.md'] },
+  { file: 'plan.html', title: '计划与架构', artifacts: ['plan.md', 'architecture.md', 'development-plan.md', 'test-plan.md', 'requirement-traceability.md'] },
   { file: 'build.html', title: '执行与验证', artifacts: ['execution-record.md'] },
   { file: 'review.html', title: '评审结论', artifacts: ['review-report.md'] },
 ];
@@ -84,15 +85,43 @@ function markdownToHtml(markdown) {
   const html = [];
   let inCode = false;
   let listOpen = false;
+  let orderedListOpen = false;
 
   const closeList = () => {
     if (listOpen) {
       html.push('</ul>');
       listOpen = false;
     }
+    if (orderedListOpen) {
+      html.push('</ol>');
+      orderedListOpen = false;
+    }
+  };
+  const tableCells = (line) => line.split('|').slice(1, -1).map((cell) => cell.trim());
+  const isTableDelimiter = (line) => /^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(line);
+  const inlineMarkdown = (value) => escapeHtml(value)
+    .replace(/`([^`]+)`/g, '<code>$1</code>')
+    .replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+  const renderTable = (start) => {
+    const header = tableCells(lines[start]);
+    const rows = [];
+    let index = start + 2;
+    while (index < lines.length && lines[index].trim().startsWith('|')) {
+      rows.push(tableCells(lines[index]));
+      index += 1;
+    }
+    html.push('<table>');
+    html.push(`<thead><tr>${header.map((cell) => `<th>${inlineMarkdown(cell)}</th>`).join('')}</tr></thead>`);
+    html.push('<tbody>');
+    for (const row of rows) {
+      html.push(`<tr>${header.map((_, cellIndex) => `<td>${inlineMarkdown(row[cellIndex] || '')}</td>`).join('')}</tr>`);
+    }
+    html.push('</tbody></table>');
+    return index - 1;
   };
 
-  for (const line of lines) {
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
     if (line.startsWith('```')) {
       if (inCode) {
         html.push('</code></pre>');
@@ -114,12 +143,33 @@ function markdownToHtml(markdown) {
       html.push(`<h${level}>${escapeHtml(line.replace(/^#{1,4}\s+/, ''))}</h${level}>`);
       continue;
     }
+    if (line.trim().startsWith('|') && lines[index + 1] && isTableDelimiter(lines[index + 1])) {
+      closeList();
+      index = renderTable(index);
+      continue;
+    }
     if (line.startsWith('- ')) {
+      if (orderedListOpen) {
+        html.push('</ol>');
+        orderedListOpen = false;
+      }
       if (!listOpen) {
         html.push('<ul>');
         listOpen = true;
       }
-      html.push(`<li>${escapeHtml(line.slice(2))}</li>`);
+      html.push(`<li>${inlineMarkdown(line.slice(2))}</li>`);
+      continue;
+    }
+    if (/^\d+[.)]\s+/.test(line)) {
+      if (listOpen) {
+        html.push('</ul>');
+        listOpen = false;
+      }
+      if (!orderedListOpen) {
+        html.push('<ol>');
+        orderedListOpen = true;
+      }
+      html.push(`<li>${inlineMarkdown(line.replace(/^\d+[.)]\s+/, ''))}</li>`);
       continue;
     }
     if (!line.trim()) {
@@ -127,7 +177,7 @@ function markdownToHtml(markdown) {
       continue;
     }
     closeList();
-    html.push(`<p>${escapeHtml(line)}</p>`);
+    html.push(`<p>${inlineMarkdown(line)}</p>`);
   }
   closeList();
   if (inCode) {
@@ -150,6 +200,7 @@ function statusPanels(status) {
     '<section class="grid">',
     `<div class="panel"><strong>阶段</strong><br>${escapeHtml(state.current_stage || '(none)')}</div>`,
     `<div class="panel"><strong>状态</strong><br>${escapeHtml(state.stage_status || '(unknown)')}</div>`,
+    `<div class="panel"><strong>需求覆盖</strong><br>${escapeHtml(state.source_requirements_status || 'unknown')}</div>`,
     `<div class="panel"><strong>下一步</strong><br><code>${escapeHtml(nextSkill || status.next_action || 'none')}</code></div>`,
     `<div class="panel"><strong>归档</strong><br>${escapeHtml(state.archive_status || 'pending')}</div>`,
     '</section>',

package/src/next-skill.mjs

@@ -19,6 +19,13 @@ export function nextSkillCommand(state) {
     && state.archive_status !== 'archived') {
     return `$archive ${state.slug}`;
   }
+  if (state.current_stage === 'review'
+    && state.review_verdict === 'approve'
+    && state.pending_user_decision === 'review->done'
+    && ['requested', 'approved'].includes(state.approval?.complete)
+    && state.archive_status !== 'archived') {
+    return `$archive ${state.slug}`;
+  }
   if (state.stage_status !== 'awaiting-approval') {
     return null;
   }

package/src/workflow.mjs

@@ -720,21 +720,21 @@ async function writeRequirementTraceabilityArtifact({ root, sourceSpecPath, sour
   const status = blockers.length > 0 ? 'partial' : 'complete';
 
   await writeText(traceabilityPath, [
-    '# Source Requirements Traceability',
+    '# 原始需求覆盖矩阵',
     '',
-    `- source: ${sourceSpecPath}`,
-    `- status: ${status}`,
-    `- extracted_items: ${rows.length}`,
+    `- 来源：${sourceSpecPath}`,
+    `- 状态：${status}`,
+    `- 提取项数量：${rows.length}`,
     '',
-    '## Coverage Matrix',
+    '## 覆盖矩阵',
     '',
-    '| Source requirement | Status |',
+    '| 原始需求项 | 覆盖状态 |',
     '| --- | --- |',
     ...(rows.length > 0
       ? rows.map((row) => `| ${row.item.replace(/\|/g, '\\|')} | ${row.status} |`)
-      : ['| No explicit source coverage items detected | covered |']),
+      : ['| 未检测到显式需求覆盖项 | covered |']),
     '',
-    '## Gate',
+    '## 门禁',
     '',
     ...(blockers.length > 0
       ? blockers.map((blocker) => `- ${blocker}`)
@@ -2248,7 +2248,7 @@ function buildCurrentEvidenceChain(state, readiness = buildReadiness(state), aut
     evidence.push(evidenceEntry(
       'review_approved',
       'Review verdict is approve.',
-      authorization.done.authorized ? 'The approved review -> done transition can be consumed.' : 'Completion still requires explicit review -> done authorization.',
+      authorization.done.authorized ? 'Archive can consume the approved review -> done transition before syncing specs.' : 'Completion still requires explicit review -> done authorization.',
     ));
   }
   if (state.archive_status === 'archived' && state.spec_sync_status === 'synced') {
@@ -2371,9 +2371,7 @@ function recommendedAction(state, legacy = false) {
         : 'Approve build -> review when execution-record.md is complete.';
     case STAGES.REVIEW:
       if (state.review_verdict === 'approve') {
-        return state.approval.complete === APPROVAL_STATES.APPROVED
-          ? 'Run loopx review again to consume the approved review -> done transition.'
-          : 'Approve review -> done to complete the workflow.';
+        return 'Run loopx archive; archive consumes the pending review -> done completion transition before syncing specs.';
       }
       if (state.review_verdict === 'request-changes') {
         if (state.requested_transition === TRANSITIONS.REVIEW_TO_BUILD && state.approval.build === APPROVAL_STATES.APPROVED) {
@@ -2574,7 +2572,11 @@ function nextCommandForRollbackTarget(slug, target) {
   if (target === 'none') {
     return [
       'Next:',
+      `$archive ${slug}`,
+      '',
+      'CLI-only equivalent:',
       `loopx approve ${slug} --from review --to done`,
+      `loopx archive ${slug}`,
     ].join('\n');
   }
   return [
@@ -2587,7 +2589,7 @@ function nextCommandForRollbackTarget(slug, target) {
 function reviewUserMessageZh({ slug, verdict, rollbackTarget, findings }) {
   const label = reviewVerdictLabel(verdict);
   const next = verdict === 'APPROVE'
-    ? `下一步：批准 review -> done 后完成工作流。\n${nextCommandForRollbackTarget(slug, 'none')}`
+    ? `下一步：直接归档；archive 会先消费 pending 的 review -> done 完成态。\n${nextCommandForRollbackTarget(slug, 'none')}`
     : `下一步：按审查发现处理，并${rollbackTargetLabel(rollbackTarget)}。\n${nextCommandForRollbackTarget(slug, rollbackTarget)}`;
   const findingText = Array.isArray(findings) && findings.length > 0 ? findings.join('；') : '无额外发现。';
   return `Review 结果：${slug} ${label}。审查发现：${findingText} ${next}`;
@@ -3929,7 +3931,7 @@ export async function reviewStage(cwd, slug, { reviewer = 'independent-reviewer'
         verdict: reviewInput.verdict,
         reviewMessageZh: reviewMessage,
         evidenceManifest: reviewInput.evidenceManifest,
-        followUps: ['等待 review -> done 审批。'],
+        followUps: ['执行 $archive；archive 会消费 pending 的 review -> done 完成态。'],
       });
     } catch (error) {
       journalWarning = error instanceof Error ? error.message : String(error);