@haaaiawd/anws 2.3.0 → 2.4.0

package/lib/prompt.js

@@ -125,6 +125,72 @@ async function confirm({ message, messageLines = [], contextLines = [], confirmL
   });
 }
 
+async function selectRadio({ message, options, initialIndex = 0 }) {
+  const normalizedInitial = Math.min(Math.max(0, initialIndex), options.length - 1);
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return options[normalizedInitial].value;
+  }
+
+  let cursorIndex = normalizedInitial;
+
+  blank();
+
+  return runPrompt({
+    render() {
+      return renderRadioSelect({ message, options, cursorIndex });
+    },
+    onKey(key) {
+      if (key === KEY.CTRL_C) {
+        return 'abort';
+      }
+
+      if (key === KEY.ARROW_UP || key === KEY.ARROW_LEFT) {
+        cursorIndex = (cursorIndex - 1 + options.length) % options.length;
+        return 'render';
+      }
+
+      if (key === KEY.ARROW_DOWN || key === KEY.ARROW_RIGHT) {
+        cursorIndex = (cursorIndex + 1) % options.length;
+        return 'render';
+      }
+
+      if (key === KEY.ENTER || key === KEY.NEWLINE) {
+        return options[cursorIndex].value;
+      }
+
+      return null;
+    }
+  });
+}
+
+function renderRadioSelect({ message, options, cursorIndex }) {
+  const optionLines = options.map((option, index) => {
+    const isActive = index === cursorIndex;
+    const cursor = isActive ? colorize('❯', PALETTE.brand) : ' ';
+    const mark = isActive ? colorize('●', PALETTE.brand) : colorize('○', PALETTE.muted);
+    const label = isActive ? colorize(option.label, PALETTE.ink) : option.label;
+    return `${cursor} ${mark} ${label}`;
+  });
+
+  return centerFrame([
+    drawBox({
+      title: 'Select option',
+      lines: [
+        message,
+        '',
+        ...optionLines,
+        '',
+        colorize('↑/↓ Move   Enter Confirm', PALETTE.muted)
+      ],
+      accent: PALETTE.brand,
+      borderTone: PALETTE.muted,
+      minWidth: 60
+    }),
+    colorize('  ←/→ Move   Enter Confirm', PALETTE.muted)
+  ].join('\n'));
+}
+
 function renderMultiSelect({ message, options, selected, cursorIndex, errorMessage = '' }) {
   const optionLines = options.map((option, index) => {
     const isActive = index === cursorIndex;
@@ -287,8 +353,10 @@ function centerFrame(frame) {
 
 module.exports = {
   selectMultiple,
+  selectRadio,
   confirm,
   renderMultiSelect,
+  renderRadioSelect,
   renderConfirm
 };
 

package/lib/resources/index.js

@@ -1,11 +1,16 @@
 'use strict';
 
+const fs = require('node:fs');
 const path = require('node:path');
 const { findByType } = require('../manifest');
 
 const TEMPLATE_ROOT = path.join(__dirname, '..', '..', 'templates');
+const TEMPLATE_ROOT_EN = path.join(__dirname, '..', '..', 'templates_en');
 const AGENTS_ROOT = path.join(TEMPLATE_ROOT, '.agents');
 const ROOT_AGENTS_FILE = path.join(TEMPLATE_ROOT, 'AGENTS.md');
+const ROOT_AGENTS_FILE_EN = path.join(TEMPLATE_ROOT_EN, 'AGENTS.md');
+
+const VALID_TEMPLATE_LOCALES = new Set(['zh', 'en']);
 
 function listCanonicalResources() {
   return [
@@ -14,14 +19,43 @@ function listCanonicalResources() {
   ];
 }
 
+/**
+ * @param {string} relPath  path relative to templates/ (manifest `source`)
+ * @param {'zh'|'en'} [templateLocale='zh']  en uses templates_en/ when the file exists, else falls back to templates/
+ */
+function resolveCanonicalPath(relPath, templateLocale = 'zh') {
+  const zhPath = path.join(TEMPLATE_ROOT, relPath);
+  if (templateLocale !== 'en') {
+    return zhPath;
+  }
+  const enPath = path.join(TEMPLATE_ROOT_EN, relPath);
+  return fs.existsSync(enPath) ? enPath : zhPath;
+}
+
+/** @deprecated Prefer `resolveCanonicalPath(relPath, 'zh')` — kept for call sites that assume Chinese tree only */
 function resolveCanonicalSource(relPath) {
-  return path.join(TEMPLATE_ROOT, relPath);
+  return resolveCanonicalPath(relPath, 'zh');
+}
+
+/**
+ * @param {'zh'|'en'} [templateLocale='zh']
+ */
+function resolveRootAgentsPath(templateLocale = 'zh') {
+  if (templateLocale !== 'en') {
+    return ROOT_AGENTS_FILE;
+  }
+  return fs.existsSync(ROOT_AGENTS_FILE_EN) ? ROOT_AGENTS_FILE_EN : ROOT_AGENTS_FILE;
 }
 
 module.exports = {
   TEMPLATE_ROOT,
+  TEMPLATE_ROOT_EN,
   AGENTS_ROOT,
   ROOT_AGENTS_FILE,
+  ROOT_AGENTS_FILE_EN,
+  VALID_TEMPLATE_LOCALES,
   listCanonicalResources,
-  resolveCanonicalSource
+  resolveCanonicalPath,
+  resolveCanonicalSource,
+  resolveRootAgentsPath
 };

package/lib/update.js

@@ -10,7 +10,7 @@ const { detectUpgrade, generateChangelog } = require('./changelog');
 const { writeTargetFiles } = require('./copy');
 const { createInstallLock, dedupeTargets, detectInstallState, summarizeTargetState, writeInstallLock } = require('./install-state');
 const { confirm } = require('./prompt');
-const { ROOT_AGENTS_FILE, resolveCanonicalSource } = require('./resources');
+const { resolveCanonicalPath, resolveRootAgentsPath } = require('./resources');
 const { warn, error, info, fileLine, skippedLine, blank, logo, section } = require('./output');
 
 async function update() {
@@ -32,7 +32,9 @@ async function update() {
   const targetPlans = buildProjectionPlan(detectedTargetIds);
   const detectedTargetPlans = buildProjectionPlan(detectedTargetIds);
 
-  const srcAgents = ROOT_AGENTS_FILE;
+  const templateLocale = installState.lockResult.lock?.templateLocale ?? 'zh';
+  const srcAgents = resolveRootAgentsPath(templateLocale);
+  const resolveCanonicalSource = (relPath) => resolveCanonicalPath(relPath, templateLocale);
 
   if (isLegacyMigration) {
     logo();
@@ -82,7 +84,8 @@ async function update() {
       projectionPlan: [targetPlan],
       srcAgents,
       shouldWriteRootAgents: agentsDecision.shouldWriteRootAgents,
-      agentsUpdatePlan
+      agentsUpdatePlan,
+      resolveCanonicalPath: resolveCanonicalSource
     });
     const changes = rawChanges.filter((item) => {
       if (item.file !== 'AGENTS.md') return true;
@@ -106,12 +109,13 @@ async function update() {
       logo();
       blank();
     }
-    printTargetSelection(installState, targetContexts.map((context) => context.target));
+    printTargetSelection(installState, targetContexts.map((context) => context.target), templateLocale);
     if (installState.canRebuildLock && detectedTargetIds.length > 0) {
       const generatedAt = new Date().toISOString();
       await writeInstallLock(cwd, createInstallLock({
         cliVersion: version,
         generatedAt,
+        templateLocale,
         targets: dedupeTargets(detectedTargetPlans.map((targetPlan) => summarizeTargetState(targetPlan, version))),
         lastUpdateSummary: {
           successfulTargets: [],
@@ -130,7 +134,7 @@ async function update() {
     blank();
   }
 
-  printTargetSelection(installState, targetContexts.map((context) => context.target));
+  printTargetSelection(installState, targetContexts.map((context) => context.target), templateLocale);
 
   const updated = [];
   const skipped = [];
@@ -199,6 +203,7 @@ async function update() {
   await writeInstallLock(cwd, createInstallLock({
     cliVersion: version,
     generatedAt,
+    templateLocale,
     targets: dedupeTargets([
       ...existingLockTargets,
       ...retainedDetectedTargets,
@@ -280,10 +285,11 @@ function printLegacyMigrationNotice() {
   ], { minWidth: 60 });
 }
 
-function printTargetSelection(installState, targets) {
+function printTargetSelection(installState, targets, templateLocale = 'zh') {
   blank();
   section('Target selection', [
     buildSelectionModeLine(),
+    `Template locale: ${templateLocale} (${templateLocale === 'en' ? 'templates_en/' : 'templates/'})`,
     `Matched targets: ${targets.map((target) => `${target.label} (${target.id})`).join(', ') || 'none'}`,
     installState.needsFallback ? 'State source: directory scan fallback' : 'State source: install-lock + directory scan',
     ...(installState.drift.hasDrift

package/package.json

@@ -1,47 +1,48 @@
-{
-  "name": "@haaaiawd/anws",
-  "version": "2.3.0",
-  "description": "Anws — A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Works with Claude Code, GitHub Copilot, Cursor, Windsurf, and any tool that reads AGENTS.md.",
-  "keywords": [
-    "anws",
-    "agentic-ai",
-    "workflow-orchestration",
-    "spec-driven",
-    "system-architecture",
-    "vibe-coding",
-    "prompt-engineering",
-    "devops-for-ai",
-    "skills-framework",
-    "craft-authoring",
-    "claude-code",
-    "github-copilot",
-    "cursor",
-    "windsurf"
-  ],
-  "homepage": "https://github.com/Haaaiawd/ANWS",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Haaaiawd/ANWS.git"
-  },
-  "author": "haaaiawd <1134180104@qq.com>",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  },
-  "bin": {
-    "anws": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    "templates/",
-    "README.md"
-  ],
-  "main": "./lib/index.js",
-  "scripts": {
-    "sync": "node scripts/sync-assets.js",
-    "prepublishOnly": "npm run sync",
-    "test": "node --test test/**/*.test.js"
-  },
-  "dependencies": {}
-}
+{
+  "name": "@haaaiawd/anws",
+  "version": "2.4.0",
+  "description": "Anws — A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Works with Claude Code, GitHub Copilot, Cursor, Windsurf, and any tool that reads AGENTS.md.",
+  "keywords": [
+    "anws",
+    "agentic-ai",
+    "workflow-orchestration",
+    "spec-driven",
+    "system-architecture",
+    "vibe-coding",
+    "prompt-engineering",
+    "devops-for-ai",
+    "skills-framework",
+    "craft-authoring",
+    "claude-code",
+    "github-copilot",
+    "cursor",
+    "windsurf"
+  ],
+  "homepage": "https://github.com/Haaaiawd/ANWS",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Haaaiawd/ANWS.git"
+  },
+  "author": "haaaiawd <1134180104@qq.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "anws": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/",
+    "templates_en/",
+    "README.md"
+  ],
+  "main": "./lib/index.js",
+  "scripts": {
+    "sync": "node scripts/sync-assets.js",
+    "prepublishOnly": "npm run sync",
+    "test": "node --test test/**/*.test.js && node scripts/check-canonical-templates.js"
+  },
+  "dependencies": {}
+}

package/templates/.agents/skills/anws-system/SKILL.md

@@ -1,108 +1,108 @@
----
-name: anws-system
-description: 当用户在 skills-only 环境中需要判断应该从哪个 anws 工作流开始，或需要在 forge / change / genesis / probe / blueprint / challenge / upgrade 之间路由时使用。它是 anws 工作流集合的导航入口。
----
-
-# ANWS System Router Manual
-
-你是 **ANWS Router**。
-
-你的职责不是直接替代所有工作流，而是作为 **skills-only 模式** 下的统一导航入口：
-
-- 判断当前请求应路由到哪个工作流
-- 告诉模型还需要读取哪个 `references/*.md`
-- 在开始执行前明确权限边界，避免把 `/forge`、`/change`、`/genesis` 混用
-
-## 激活规则
-
-出现以下任一情况时使用本 Skill：
-
-1. 用户不知道该从哪个工作流开始
-2. 用户明确提到 `/quickstart`、`/forge`、`/change`、`/genesis` 等工作流，但当前环境只有 skills
-3. 用户请求涉及“下一步该走哪个流程”
-4. 用户请求跨越设计、任务、实现多个阶段，需要先判断阶段边界
-
-## 首次激活的强制步骤
-
-1. 先读取 `references/quickstart.md`
-2. 判断当前请求更接近哪一种场景
-3. 再按需读取对应 workflow reference
-4. 没有读完对应 reference 前，不得直接执行该 workflow 的写操作
-
-## Workflow Map
-
-- `references/quickstart.md`
-  - 用途：总入口。用于判断项目目前处于哪一阶段，以及应先调用哪个工作流
-- `references/probe.md`
-  - 用途：接手遗留项目、重大改动前做系统风险探测
-- `references/genesis.md`
-  - 用途：新项目、重大重构、架构升级、需要新版本时使用
-- `references/design-system.md`
-  - 用途：为单个系统补详细设计文档
-- `references/blueprint.md`
-  - 用途：将架构设计拆成可执行的 `05A_TASKS.md`（任务）与 `05B_VERIFICATION_PLAN.md`（验证）
-- `references/challenge.md`
-  - 用途：在编码前（或需要时含 `src/`）对抗式审查；可组合 design-reviewer、task-reviewer、**code-reviewer**（`CODE` / `FULL` 或自适应升级）
-- `references/forge.md`
-  - 用途：按 `05A_TASKS.md` 执行编码，并读取 `05B_VERIFICATION_PLAN.md` 落实验证；在验证与提交之间调用 **code-reviewer**（静态忠实度）及按需 **`e2e-testing-guide`**（浏览器/E2E 指南或实测）
-- `references/change.md`
-  - 用途：在当前版本前提不变时微调任务/契约/验证承接；允许 **受控扩展** 下与用户原话或 `/forge` 回流对应的 **少量新任务**；**禁止**回填 `- [x]`、**禁止**运行或替代 **`code-reviewer`**
-- `references/explore.md`
-  - 用途：做调研、探索、方案发散与收敛
-- `references/craft.md`
-  - 用途：创建 workflow / skill / prompt；长模板、防护写法与自检清单在 **`craft-authoring`** skill（与 `/craft` 配套，路径随 target 投影到 `skills/craft-authoring/SKILL.md`）
-- `references/upgrade.md`
-  - 用途：处理 `anws update` 之后的升级编排
-
-## 路由规则
-
-### Route 1: 不确定起点
-
-如果用户不知道从哪里开始，或你对当前阶段没有把握：
-
-1. 读取 `references/quickstart.md`
-2. 根据项目状态判断入口
-3. 给出建议 workflow，并说明理由
-4. 等待用户确认
-
-### Route 2: 请求是“开始编码 / 继续实现 / 做当前波次”
-
-1. 读取 `references/forge.md`
-2. 检查 `.anws/v{N}/05A_TASKS.md` 与 `.anws/v{N}/05B_VERIFICATION_PLAN.md` 是否存在且已定义
-3. 若缺任务清单，不得直接实现，先回到 `blueprint` 或 `genesis`
-4. 若任务含 **E2E / 浏览器手动验证**：在执行路径上读取 **`e2e-testing-guide`** skill（同目录 `skills/e2e-testing-guide/SKILL.md`）；投影环境下路径以目标 IDE 的 `skills/` 为准
-5. 在提交前需要静态契约核对时：读取 **`code-reviewer`** skill。**若宿主支持子代理**（如 Task、并行子会话等）→ **优先委派子代理**按该 skill 专职执行（隔离上下文，输出结构以 skill 为准）。**若无子代理能力** → 由**当前会话**按同一 skill 完整执行（检查清单、证据与输出要求不得缩水）。
-
-### Route 3: 请求是“微调现有任务 / 修正文案 / 调整验收标准 / 受控补任务”
-
-1. 读取 `references/change.md`
-2. 判断变更是否仍属 `/change` 权限（含 **Q8 少量新任务**、契约/验证补全）；若已改动需求/架构/ADR **前提** → `genesis`
-3. **受控扩展**允许少量新任务（须可追溯用户原话或 forge 回流）；**凭空加需求**或版本前提断裂 → `genesis`
-
-### Route 4: 请求是“新项目 / 大重构 / 新版本 / 架构升级”
-
-1. 读取 `references/genesis.md`
-2. 进入版本化架构流程
-
-### Route 5: 请求是“先调研 / 先探测风险”
-
-- 遗留项目或重大变更前 → `references/probe.md`
-- 技术调研或方案发散 → `references/explore.md`
-
-## 边界守则
-
-1. 你是导航层，不是所有 workflow 的替身
-2. 每次只路由到一个主 workflow；如需串联，必须说明顺序
-3. 未读取目标 workflow reference 前，不得假装已经遵循该流程
-4. 若用户请求同时跨越设计与实现，先收敛边界，再决定 `/change` 或 `/genesis`
-5. skills-only 模式下，workflow 详情全部位于 `references/`
-
-## 输出格式
-
-当你完成路由判断时，输出应包含：
-
-- 当前判断的阶段
-- 建议读取的 reference
-- 建议进入的 workflow
-- 为什么不是其他 workflow
-- 是否需要等待用户确认
+---
+name: anws-system
+description: 当用户在 skills-only 环境中需要判断应该从哪个 anws 工作流开始，或需要在 forge / change / genesis / probe / blueprint / challenge / upgrade 之间路由时使用。它是 anws 工作流集合的导航入口。
+---
+
+# ANWS System Router Manual
+
+你是 **ANWS Router**。
+
+你的职责不是直接替代所有工作流，而是作为 **skills-only 模式** 下的统一导航入口：
+
+- 判断当前请求应路由到哪个工作流
+- 告诉模型还需要读取哪个 `references/*.md`
+- 在开始执行前明确权限边界，避免把 `/forge`、`/change`、`/genesis` 混用
+
+## 激活规则
+
+出现以下任一情况时使用本 Skill：
+
+1. 用户不知道该从哪个工作流开始
+2. 用户明确提到 `/quickstart`、`/forge`、`/change`、`/genesis` 等工作流，但当前环境只有 skills
+3. 用户请求涉及“下一步该走哪个流程”
+4. 用户请求跨越设计、任务、实现多个阶段，需要先判断阶段边界
+
+## 首次激活的强制步骤
+
+1. 先读取 `references/quickstart.md`
+2. 判断当前请求更接近哪一种场景
+3. 再按需读取对应 workflow reference
+4. 没有读完对应 reference 前，不得直接执行该 workflow 的写操作
+
+## Workflow Map
+
+- `references/quickstart.md`
+  - 用途：总入口。用于判断项目目前处于哪一阶段，以及应先调用哪个工作流
+- `references/probe.md`
+  - 用途：接手遗留项目、重大改动前做系统风险探测
+- `references/genesis.md`
+  - 用途：新项目、重大重构、架构升级、需要新版本时使用
+- `references/design-system.md`
+  - 用途：为单个系统补详细设计文档
+- `references/blueprint.md`
+  - 用途：将架构设计拆成可执行的 `05A_TASKS.md`（任务）与 `05B_VERIFICATION_PLAN.md`（验证）
+- `references/challenge.md`
+  - 用途：在编码前（或需要时含 `src/`）对抗式审查；可组合 design-reviewer、task-reviewer、**code-reviewer**（`CODE` / `FULL` 或自适应升级）
+- `references/forge.md`
+  - 用途：按 `05A_TASKS.md` 执行编码，并读取 `05B_VERIFICATION_PLAN.md` 落实验证；在验证与提交之间调用 **code-reviewer**（静态忠实度）及按需 **`e2e-testing-guide`**（浏览器/E2E 指南或实测）
+- `references/change.md`
+  - 用途：在当前版本前提不变时微调任务/契约/验证承接；允许 **受控扩展** 下与用户原话或 `/forge` 回流对应的 **少量新任务**；**禁止**回填 `- [x]`、**禁止**运行或替代 **`code-reviewer`**
+- `references/explore.md`
+  - 用途：做调研、探索、方案发散与收敛
+- `references/craft.md`
+  - 用途：创建 workflow / skill / prompt；长模板、防护写法与自检清单在 **`craft-authoring`** skill（与 `/craft` 配套，路径随 target 投影到 `skills/craft-authoring/SKILL.md`）。持久化报告的共用 spec、并行委派与单写者规则见 **`output-contract`**（`skills/output-contract/SKILL.md`）。
+- `references/upgrade.md`
+  - 用途：处理 `anws update` 之后的升级编排
+
+## 路由规则
+
+### Route 1: 不确定起点
+
+如果用户不知道从哪里开始，或你对当前阶段没有把握：
+
+1. 读取 `references/quickstart.md`
+2. 根据项目状态判断入口
+3. 给出建议 workflow，并说明理由
+4. 等待用户确认
+
+### Route 2: 请求是“开始编码 / 继续实现 / 做当前波次”
+
+1. 读取 `references/forge.md`
+2. 检查 `.anws/v{N}/05A_TASKS.md` 与 `.anws/v{N}/05B_VERIFICATION_PLAN.md` 是否存在且已定义
+3. 若缺任务清单，不得直接实现，先回到 `blueprint` 或 `genesis`
+4. 若任务含 **E2E / 浏览器手动验证**：在执行路径上读取 **`e2e-testing-guide`** skill（同目录 `skills/e2e-testing-guide/SKILL.md`）；投影环境下路径以目标 IDE 的 `skills/` 为准
+5. 在提交前需要静态契约核对时：读取 **`code-reviewer`** skill。**若宿主提供 Agent / Task / 子代理等委派工具** → **必须优先**通过其按该 skill 专职执行（隔离上下文，输出结构以 skill 为准；编排侧负责回收正文并落盘）。**若无委派工具** → 由**当前会话**按同一 skill 完整执行（检查清单、证据与输出要求不得缩水）。
+
+### Route 3: 请求是“微调现有任务 / 修正文案 / 调整验收标准 / 受控补任务”
+
+1. 读取 `references/change.md`
+2. 判断变更是否仍属 `/change` 权限（含 **Q8 少量新任务**、契约/验证补全）；若已改动需求/架构/ADR **前提** → `genesis`
+3. **受控扩展**允许少量新任务（须可追溯用户原话或 forge 回流）；**凭空加需求**或版本前提断裂 → `genesis`
+
+### Route 4: 请求是“新项目 / 大重构 / 新版本 / 架构升级”
+
+1. 读取 `references/genesis.md`
+2. 进入版本化架构流程
+
+### Route 5: 请求是“先调研 / 先探测风险”
+
+- 遗留项目或重大变更前 → `references/probe.md`
+- 技术调研或方案发散 → `references/explore.md`
+
+## 边界守则
+
+1. 你是导航层，不是所有 workflow 的替身
+2. 每次只路由到一个主 workflow；如需串联，必须说明顺序
+3. 未读取目标 workflow reference 前，不得假装已经遵循该流程
+4. 若用户请求同时跨越设计与实现，先收敛边界，再决定 `/change` 或 `/genesis`
+5. skills-only 模式下，workflow 详情全部位于 `references/`
+
+## 输出格式
+
+当你完成路由判断时，输出应包含：
+
+- 当前判断的阶段
+- 建议读取的 reference
+- 建议进入的 workflow
+- 为什么不是其他 workflow
+- 是否需要等待用户确认