@superspec/cli 1.0.0 → 1.1.0

package/dist/cli/index.js

@@ -5,7 +5,7 @@ import { createRequire } from "module";
 import { program } from "commander";
 
 // src/commands/init.ts
-import { existsSync as existsSync5, writeFileSync as writeFileSync3, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync6, writeFileSync as writeFileSync3, readdirSync as readdirSync3 } from "fs";
 import { join as join5 } from "path";
 import { execSync as execSync2 } from "child_process";
 
@@ -13,11 +13,12 @@ import { execSync as execSync2 } from "child_process";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 var DEFAULT_CONFIG = {
-  lang: "zh",
+  lang: "en",
   aiEditor: "cursor",
   specDir: "superspec",
-  branchPrefix: "spec/",
-  branchTemplate: "{prefix}{name}",
+  branchPrefix: "",
+  branchTemplate: "{prefix}{intentType}-{date}-{feature}-{user}",
+  changeNameTemplate: "{prefix}{intentType}-{date}-{feature}-{user}",
   boost: false,
   strategy: "follow",
   context: [],
@@ -26,7 +27,8 @@ var DEFAULT_CONFIG = {
     proposal: "proposal.md",
     tasks: "tasks.md",
     clarify: "clarify.md",
-    checklist: "checklist.md"
+    checklist: "checklist.md",
+    design: "design.md"
   },
   archive: {
     dir: "archive",
@@ -37,16 +39,18 @@ var DEFAULT_CONFIG = {
     hardLines: 400
   },
   artifacts: ["proposal"],
-  boostArtifacts: ["proposal", "spec", "tasks", "checklist"]
+  boostArtifacts: ["proposal", "spec", "design", "tasks", "checklist"]
 };
-function loadConfig(projectRoot = process.cwd()) {
+function loadConfig(projectRoot = process.cwd(), silent = false) {
   const configPath = join(projectRoot, "superspec.config.json");
   let userConfig = {};
   if (existsSync(configPath)) {
     try {
       userConfig = JSON.parse(readFileSync(configPath, "utf-8"));
     } catch (e) {
-      console.warn(`\u26A0 \u914D\u7F6E\u6587\u4EF6\u89E3\u6790\u5931\u8D25: ${e.message}`);
+      if (!silent) {
+        console.warn(`\u26A0 Config file parsing failed: ${e.message}`);
+      }
     }
   }
   return deepMerge(DEFAULT_CONFIG, userConfig);
@@ -57,43 +61,58 @@ function getDefaultConfig() {
 function deepMerge(target, source) {
   const result = { ...target };
   for (const key of Object.keys(source)) {
-    if (source[key] && typeof source[key] === "object" && !Array.isArray(source[key]) && target[key] && typeof target[key] === "object") {
-      result[key] = deepMerge(target[key], source[key]);
+    const val = source[key];
+    if (val === null || val === void 0) continue;
+    if (typeof val === "object" && !Array.isArray(val) && target[key] && typeof target[key] === "object") {
+      result[key] = deepMerge(target[key], val);
     } else {
-      result[key] = source[key];
+      result[key] = val;
     }
   }
   return result;
 }
 
 // src/core/template.ts
-import { existsSync as existsSync3, copyFileSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { existsSync as existsSync4, copyFileSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join3, dirname as dirname2 } from "path";
 
 // src/utils/paths.ts
 import { dirname, join as join2 } from "path";
+import { existsSync as existsSync2 } from "fs";
 import { fileURLToPath } from "url";
 function getPackageRoot() {
   const __filename2 = fileURLToPath(import.meta.url);
-  const __dirname2 = dirname(__filename2);
-  return join2(__dirname2, "..", "..");
+  let dir = dirname(__filename2);
+  while (dir !== dirname(dir)) {
+    if (existsSync2(join2(dir, "package.json")) && existsSync2(join2(dir, "templates"))) {
+      return dir;
+    }
+    dir = dirname(dir);
+  }
+  return join2(dirname(__filename2), "..", "..");
 }
 
 // src/utils/fs.ts
-import { mkdirSync, existsSync as existsSync2 } from "fs";
+import { mkdirSync, existsSync as existsSync3, readdirSync } from "fs";
 function ensureDir(dir) {
-  if (!existsSync2(dir)) {
+  if (!existsSync3(dir)) {
     mkdirSync(dir, { recursive: true });
   }
 }
+function resolveChangeNames(changesDir, name, archiveDirName) {
+  if (!existsSync3(changesDir)) return [];
+  if (name) return [name];
+  return readdirSync(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== archiveDirName).map((e) => e.name);
+}
 
 // src/core/template.ts
 function resolveTemplatePath(templateName, lang = "zh") {
   const root = getPackageRoot();
   const langPath = join3(root, "templates", lang, templateName);
-  if (existsSync3(langPath)) return langPath;
-  const fallback = join3(root, "templates", "zh", templateName);
-  if (existsSync3(fallback)) return fallback;
+  if (existsSync4(langPath)) return langPath;
+  const fallbackLang = lang === "zh" ? "en" : "zh";
+  const fallback = join3(root, "templates", fallbackLang, templateName);
+  if (existsSync4(fallback)) return fallback;
   throw new Error(`Template not found: ${templateName} (lang: ${lang})`);
 }
 function copyTemplate(templateName, destPath, lang = "zh") {
@@ -128,9 +147,10 @@ function writeRenderedTemplate(templateName, destPath, vars = {}, lang = "zh") {
 
 // src/utils/git.ts
 import { execSync } from "child_process";
+var GIT_TIMEOUT = 1e4;
 function isGitRepo() {
   try {
-    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" });
+    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore", timeout: GIT_TIMEOUT });
     return true;
   } catch {
     return false;
@@ -141,15 +161,15 @@ function createBranch(branchName) {
   if (!SAFE_BRANCH_RE.test(branchName)) {
     throw new Error(`invalid branch name: ${branchName}`);
   }
-  execSync(`git checkout -b ${branchName}`, { stdio: "inherit" });
+  execSync(`git checkout -b ${branchName}`, { stdio: "inherit", timeout: GIT_TIMEOUT });
 }
 function getDefaultBranch() {
   try {
-    const ref = execSync("git symbolic-ref refs/remotes/origin/HEAD", { encoding: "utf-8" }).trim();
+    const ref = execSync("git symbolic-ref refs/remotes/origin/HEAD", { encoding: "utf-8", timeout: GIT_TIMEOUT }).trim();
     return ref.replace("refs/remotes/origin/", "");
   } catch {
     try {
-      execSync("git rev-parse --verify main", { stdio: "ignore" });
+      execSync("git rev-parse --verify main", { stdio: "ignore", timeout: GIT_TIMEOUT });
       return "main";
     } catch {
       return "master";
@@ -159,8 +179,8 @@ function getDefaultBranch() {
 function getDiffFiles(base) {
   const baseBranch = base || getDefaultBranch();
   try {
-    const mergeBase = execSync(`git merge-base ${baseBranch} HEAD`, { encoding: "utf-8" }).trim();
-    const output = execSync(`git diff --name-status ${mergeBase}`, { encoding: "utf-8" }).trim();
+    const mergeBase = execSync(`git merge-base ${baseBranch} HEAD`, { encoding: "utf-8", timeout: GIT_TIMEOUT }).trim();
+    const output = execSync(`git diff --name-status ${mergeBase}`, { encoding: "utf-8", timeout: 3e4 }).trim();
     if (!output) return [];
     return output.split("\n").map((line) => {
       const [status, ...parts] = line.split("	");
@@ -172,7 +192,7 @@ function getDiffFiles(base) {
 }
 
 // src/prompts/index.ts
-import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync as readdirSync2 } from "fs";
 import { join as join4 } from "path";
 
 // src/ui/index.ts
@@ -263,11 +283,19 @@ var symbol = {
   folder: theme.primary("\u{1F4C1}"),
   file: theme.info("\u{1F4C4}"),
   git: theme.warning("\u{1F33F}"),
-  ai: theme.boost("\u{1F916}")
+  ai: theme.boost("\u{1F916}"),
+  info: theme.info("\u2139")
 };
 function printLogo(size = "small") {
   console.log(logo[size]);
 }
+var _lang = "en";
+function setLang(lang) {
+  _lang = lang;
+}
+function t(en, zh) {
+  return _lang === "zh" ? zh : en;
+}
 function printSummary(items) {
   const maxLabel = Math.max(...items.map((i) => i.label.length));
   const width = 50;
@@ -275,7 +303,7 @@ function printSummary(items) {
   for (const { label, value } of items) {
     const padding = " ".repeat(maxLabel - label.length);
     const line = `${theme.dim(label)}${padding} ${symbol.arrow} ${theme.highlight(value)}`;
-    const plainLine = line.replace(/\u001b\[\d+m/g, "");
+    const plainLine = line.replace(/\u001b\[\d+(?:;\d+)*m/g, "");
     const rightPad = " ".repeat(Math.max(0, width - plainLine.length - 4));
     console.log(theme.border("\u2502 ") + line + rightPad + theme.border(" \u2502"));
   }
@@ -325,8 +353,8 @@ function installRules(cwd, editor) {
   }
   const rulesDir = join4(cwd, config.rules);
   ensureDir(rulesDir);
-  const promptSrc = join4(getPackageRoot(), "prompts", "cursor-rules.md");
-  if (existsSync4(promptSrc)) {
+  const promptSrc = join4(getPackageRoot(), "prompts", "rules.md");
+  if (existsSync5(promptSrc)) {
     const content = readFileSync3(promptSrc, "utf-8");
     const rulesFile = "rulesFile" in config ? config.rulesFile : "superspec.md";
     const destPath = join4(rulesDir, rulesFile);
@@ -339,12 +367,12 @@ var SS_END = "<!-- superspec:end -->";
 function installAgentsMd(cwd) {
   const agentsMdPath = join4(cwd, "AGENTS.md");
   const agentPromptSrc = join4(getPackageRoot(), "prompts", "agents.md");
-  if (!existsSync4(agentPromptSrc)) return;
+  if (!existsSync5(agentPromptSrc)) return;
   const newContent = readFileSync3(agentPromptSrc, "utf-8");
   const wrapped = `${SS_START}
 ${newContent}
 ${SS_END}`;
-  if (existsSync4(agentsMdPath)) {
+  if (existsSync5(agentsMdPath)) {
     const existing = readFileSync3(agentsMdPath, "utf-8");
     const startIdx = existing.indexOf(SS_START);
     const endIdx = existing.indexOf(SS_END);
@@ -368,12 +396,12 @@ function installCommands(cwd, editor, lang = "zh") {
   ensureDir(commandsDir);
   const templatesDir = join4(getPackageRoot(), "templates", lang, "commands");
   const fallbackDir = join4(getPackageRoot(), "templates", "zh", "commands");
-  const sourceDir = existsSync4(templatesDir) ? templatesDir : fallbackDir;
-  if (!existsSync4(sourceDir)) {
+  const sourceDir = existsSync5(templatesDir) ? templatesDir : fallbackDir;
+  if (!existsSync5(sourceDir)) {
     log.warn(`${symbol.warn} Commands templates not found: ${sourceDir}`);
     return;
   }
-  const commandFiles = readdirSync(sourceDir).filter((f) => f.endsWith(".md"));
+  const commandFiles = readdirSync2(sourceDir).filter((f) => f.endsWith(".md"));
   for (const file of commandFiles) {
     const srcPath = join4(sourceDir, file);
     const destPath = join4(commandsDir, file);
@@ -387,11 +415,12 @@ function installCommands(cwd, editor, lang = "zh") {
 async function initCommand(options) {
   const cwd = process.cwd();
   const configPath = join5(cwd, "superspec.config.json");
-  if (existsSync5(configPath) && !options.force) {
-    log.warn(`${symbol.warn} superspec.config.json already exists, use --force to overwrite`);
+  if (existsSync6(configPath) && !options.force) {
+    log.warn(`${symbol.warn} ${t("superspec.config.json already exists, use --force to overwrite", "superspec.config.json \u5DF2\u5B58\u5728\uFF0C\u4F7F\u7528 --force \u8986\u76D6")}`);
     return;
   }
   const lang = options.lang || "zh";
+  setLang(lang);
   printLogo("small");
   console.log(theme.dim("  Spec-Driven Development Toolkit\n"));
   const config = getDefaultConfig();
@@ -401,27 +430,30 @@ async function initCommand(options) {
     config.aiEditor = aiEditor;
   }
   const specDir = join5(cwd, config.specDir);
-  const existingFiles = readdirSync2(cwd).filter((f) => !f.startsWith(".") && f !== "node_modules");
+  const existingFiles = readdirSync3(cwd).filter((f) => !f.startsWith(".") && f !== "node_modules");
   if (existingFiles.length > 0 && !options.force) {
-    log.warn(`${symbol.warn} Current directory is not empty (${existingFiles.length} items)`);
-    log.dim("  Template files will be merged with existing content");
+    log.warn(`${symbol.warn} ${t(`current directory is not empty (${existingFiles.length} items)`, `\u5F53\u524D\u76EE\u5F55\u975E\u7A7A\uFF08${existingFiles.length} \u9879\uFF09`)}`);
+    log.dim(`  ${t("template files will be merged with existing content", "\u6A21\u677F\u6587\u4EF6\u5C06\u4E0E\u73B0\u6709\u5185\u5BB9\u5408\u5E76")}`);
     console.log();
   }
-  log.section("Creating Configuration");
+  log.section(t("Creating Configuration", "\u521B\u5EFA\u914D\u7F6E"));
   writeFileSync3(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
   log.success(`${symbol.file} superspec.config.json`);
-  log.section("Creating Directory Structure");
+  log.section(t("Creating Directory Structure", "\u521B\u5EFA\u76EE\u5F55\u7ED3\u6784"));
   ensureDir(join5(specDir, "changes"));
   ensureDir(join5(specDir, "templates"));
   log.success(`${symbol.folder} ${config.specDir}/changes/`);
   log.success(`${symbol.folder} ${config.specDir}/templates/`);
-  log.section("Installing Templates");
-  const templates = ["spec.md", "proposal.md", "tasks.md", "clarify.md", "checklist.md"];
-  for (const tpl of templates) {
-    copyTemplate(tpl, join5(specDir, "templates", tpl), lang);
+  log.section(t("Installing Templates", "\u5B89\u88C5\u6A21\u677F"));
+  const templateNames = Object.values(config.templates).map((v) => v.endsWith(".md") ? v : `${v}.md`);
+  for (const tpl of templateNames) {
+    try {
+      copyTemplate(tpl, join5(specDir, "templates", tpl), lang);
+    } catch {
+    }
   }
-  log.success(`${symbol.ok} ${templates.length} templates (${lang})`);
-  log.section("Installing AI Agent Files");
+  log.success(`${symbol.ok} ${templateNames.length} ${t("templates", "\u4E2A\u6A21\u677F")} (${lang})`);
+  log.section(t("Installing AI Agent Files", "\u5B89\u88C5 AI Agent \u6587\u4EF6"));
   installAgentsMd(cwd);
   if (aiEditor && AI_EDITORS[aiEditor]) {
     installRules(cwd, aiEditor);
@@ -438,52 +470,79 @@ async function initCommand(options) {
     { label: "AI agent", value: options.ai },
     { label: "Language", value: lang }
   ]);
-  log.done("SuperSpec initialized successfully!");
-  log.dim("Next: Run superspec create <name> to create a change");
+  log.done(t("SuperSpec initialized successfully!", "SuperSpec \u521D\u59CB\u5316\u6210\u529F\uFF01"));
+  log.dim(`${t("Next", "\u4E0B\u4E00\u6B65")}: superspec create <feature>`);
 }
 
 // src/commands/create.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { join as join6 } from "path";
 
 // src/utils/date.ts
 function getDateString() {
   const d = /* @__PURE__ */ new Date();
-  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+  return `${d.getFullYear()}${String(d.getMonth() + 1).padStart(2, "0")}${String(d.getDate()).padStart(2, "0")}`;
+}
+
+// src/utils/template.ts
+function renderNameTemplate(template, vars, strict = false) {
+  let result = template;
+  for (const [key, value] of Object.entries(vars)) {
+    if (value !== void 0) {
+      result = result.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+    }
+  }
+  result = result.replace(/\{[^}]+\}/g, "");
+  if (strict) {
+    return result.replace(/[^a-zA-Z0-9._\-/]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  }
+  return result.replace(/[^\p{L}\p{N}._\-/]/gu, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
 
 // src/commands/create.ts
-async function createCommand(name, options) {
+async function createCommand(feature, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const specDir = options.specDir || config.specDir;
   const branchPrefix = options.branchPrefix || config.branchPrefix;
   const boost = options.boost || config.boost;
   const strategy = options.creative ? "create" : config.strategy;
-  const lang = config.lang || "zh";
   const description = options.description || "";
-  const changePath = join6(cwd, specDir, "changes", name);
-  if (existsSync6(changePath)) {
-    log.warn(`${symbol.warn} Change "${name}" already exists: ${changePath}`);
+  const lang = options.lang || config.lang || "en";
+  const templateVars = {
+    prefix: branchPrefix,
+    intentType: options.intentType,
+    feature,
+    date: getDateString(),
+    user: options.user
+  };
+  const changeNameTemplate = options.changeNameTemplate || config.changeNameTemplate || "{date}-{feature}";
+  const changeFolderName = renderNameTemplate(changeNameTemplate, templateVars, false);
+  const changePath = join6(cwd, specDir, "changes", changeFolderName);
+  if (existsSync7(changePath)) {
+    log.warn(`${symbol.warn} ${t(`change "${changeFolderName}" already exists`, `\u53D8\u66F4 "${changeFolderName}" \u5DF2\u5B58\u5728`)}: ${changePath}`);
     return;
   }
-  log.title(`Creating Change: ${name}`);
+  log.title(`${t("Creating Change", "\u521B\u5EFA\u53D8\u66F4")}: ${changeFolderName}`);
+  if (options.intentType) {
+    log.info(`${t("Intent Type", "\u610F\u56FE\u7C7B\u578B")}: ${options.intentType}`);
+  }
   if (boost) {
-    log.boost(`${symbol.bolt} Boost mode enabled`);
+    log.boost(`${symbol.bolt} ${t("Boost mode enabled", "\u589E\u5F3A\u6A21\u5F0F\u5DF2\u542F\u7528")}`);
   }
   if (strategy === "create") {
-    log.boost(`${symbol.bolt} Creative mode: exploring new solutions`);
+    log.boost(`${symbol.bolt} ${t("Creative mode: exploring new solutions", "\u521B\u9020\u6A21\u5F0F\uFF1A\u63A2\u7D22\u65B0\u65B9\u6848")}`);
   }
   ensureDir(changePath);
   const vars = {
-    name,
-    date: getDateString(),
+    name: changeFolderName,
+    date: templateVars.date,
     boost: boost ? "true" : "false",
     strategy,
     description
   };
   const artifacts = boost ? config.boostArtifacts : config.artifacts;
-  log.section("Generating Artifacts");
+  log.section(t("Generating Artifacts", "\u751F\u6210 Artifacts"));
   for (const artifact of artifacts) {
     const templateFile = config.templates[artifact] || `${artifact}.md`;
     const destPath = join6(changePath, `${artifact}.md`);
@@ -495,69 +554,70 @@ async function createCommand(name, options) {
     }
   }
   if (options.branch !== false && isGitRepo()) {
-    const branchTemplate = config.branchTemplate || "{prefix}{name}";
-    const branchName = branchTemplate.replace("{prefix}", branchPrefix).replace("{name}", name);
+    const branchTemplate = options.branchTemplate || config.branchTemplate || "{prefix}{date}-{feature}";
+    const branchName = renderNameTemplate(branchTemplate, templateVars, true);
     try {
       createBranch(branchName);
       log.success(`${symbol.ok} Branch: ${branchName}`);
     } catch (e) {
-      log.warn(`${symbol.warn} Branch creation failed: ${e.message}`);
+      log.warn(`${symbol.warn} ${t("branch creation failed", "\u5206\u652F\u521B\u5EFA\u5931\u8D25")}: ${e.message}`);
     }
   }
-  log.done("Change created successfully!");
-  log.dim(`Path: ${specDir}/changes/${name}/`);
+  log.done(t("Change created successfully!", "\u53D8\u66F4\u521B\u5EFA\u6210\u529F\uFF01"));
+  log.dim(`${t("Path", "\u8DEF\u5F84")}: ${specDir}/changes/${changeFolderName}/`);
   if (boost) {
-    log.dim(`Workflow: /ss-create \u2192 /ss-tasks \u2192 /ss-apply (boost)`);
+    log.dim(`${t("Workflow", "\u5DE5\u4F5C\u6D41")}: /ss-create \u2192 /ss-tasks \u2192 /ss-apply (boost)`);
   } else {
-    log.dim(`Workflow: /ss-tasks \u2192 /ss-apply`);
+    log.dim(`${t("Workflow", "\u5DE5\u4F5C\u6D41")}: /ss-tasks \u2192 /ss-apply`);
   }
+  log.dim(`${t("Next", "\u4E0B\u4E00\u6B65")}: superspec lint ${changeFolderName}`);
 }
 
 // src/commands/archive.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, renameSync } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync4, renameSync } from "fs";
 import { join as join7 } from "path";
 async function archiveCommand(name, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const changesDir = join7(cwd, config.specDir, "changes");
   const archiveDir = join7(cwd, config.specDir, "changes", config.archive.dir);
-  if (!existsSync7(changesDir)) {
-    log.warn(`${symbol.warn} \u6CA1\u6709\u627E\u5230 changes \u76EE\u5F55`);
+  if (!existsSync8(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
   if (options.all) {
-    const entries = readdirSync3(changesDir, { withFileTypes: true }).filter(
+    const entries = readdirSync4(changesDir, { withFileTypes: true }).filter(
       (e) => e.isDirectory() && e.name !== config.archive.dir
     );
     if (entries.length === 0) {
-      log.warn(`${symbol.warn} \u6CA1\u6709\u53EF\u5F52\u6863\u7684\u53D8\u66F4`);
+      log.warn(`${symbol.warn} ${t("no changes to archive", "\u6CA1\u6709\u53EF\u5F52\u6863\u7684\u53D8\u66F4")}`);
       return;
     }
-    log.info(`${symbol.start} \u5F52\u6863\u6240\u6709\u53D8\u66F4...`);
+    log.info(`${symbol.start} ${t("archiving all changes...", "\u5F52\u6863\u6240\u6709\u53D8\u66F4...")}`);
     for (const entry of entries) {
       archiveOne(entry.name, changesDir, archiveDir, config);
     }
   } else if (name) {
     const changePath = join7(changesDir, name);
-    if (!existsSync7(changePath)) {
-      log.warn(`${symbol.warn} \u53D8\u66F4 "${name}" \u4E0D\u5B58\u5728`);
+    if (!existsSync8(changePath)) {
+      log.warn(`${symbol.warn} ${t(`change "${name}" not found`, `\u53D8\u66F4 "${name}" \u4E0D\u5B58\u5728`)}`);
       return;
     }
-    log.info(`${symbol.start} \u5F52\u6863\u53D8\u66F4: ${name}`);
+    log.info(`${symbol.start} ${t(`archiving: ${name}`, `\u5F52\u6863\u53D8\u66F4: ${name}`)}`);
     archiveOne(name, changesDir, archiveDir, config);
   } else {
-    log.warn(`${symbol.warn} \u8BF7\u6307\u5B9A\u53D8\u66F4\u540D\u79F0\u6216\u4F7F\u7528 --all`);
+    log.warn(`${symbol.warn} ${t("specify a name or use --all", "\u8BF7\u6307\u5B9A\u53D8\u66F4\u540D\u79F0\u6216\u4F7F\u7528 --all")}`);
     return;
   }
-  log.info(`${symbol.start} \u5F52\u6863\u5B8C\u6210\uFF01`);
+  log.info(`${symbol.start} ${t("archive done!", "\u5F52\u6863\u5B8C\u6210\uFF01")}`);
 }
 function archiveOne(name, changesDir, archiveDir, config) {
   ensureDir(archiveDir);
   const src = join7(changesDir, name);
   const dateStr = config.archive.datePrefix ? `${getDateString()}-` : "";
   const dest = join7(archiveDir, `${dateStr}${name}`);
-  if (existsSync7(dest)) {
-    log.warn(`  ${symbol.warn} \u5F52\u6863\u76EE\u6807\u5DF2\u5B58\u5728: ${dest}`);
+  if (existsSync8(dest)) {
+    log.warn(`  ${symbol.warn} ${t("archive target exists", "\u5F52\u6863\u76EE\u6807\u5DF2\u5B58\u5728")}: ${dest}`);
     return;
   }
   renameSync(src, dest);
@@ -565,43 +625,46 @@ function archiveOne(name, changesDir, archiveDir, config) {
 }
 
 // src/commands/update.ts
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 import { join as join8 } from "path";
 async function updateCommand() {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const specDir = join8(cwd, config.specDir);
   const lang = config.lang || "zh";
-  if (!existsSync8(join8(cwd, "superspec.config.json"))) {
-    log.warn(`${symbol.warn} \u5F53\u524D\u76EE\u5F55\u672A\u521D\u59CB\u5316 SuperSpec\uFF0C\u8BF7\u5148\u8FD0\u884C superspec init`);
+  if (!existsSync9(join8(cwd, "superspec.config.json"))) {
+    log.warn(`${symbol.warn} ${t("not initialized, run superspec init first", "\u5F53\u524D\u76EE\u5F55\u672A\u521D\u59CB\u5316 SuperSpec\uFF0C\u8BF7\u5148\u8FD0\u884C superspec init")}`);
     return;
   }
-  log.info(`${symbol.start} \u66F4\u65B0 SuperSpec...`);
-  const templates = ["spec.md", "proposal.md", "tasks.md", "clarify.md", "checklist.md"];
+  log.info(`${symbol.start} ${t("updating SuperSpec...", "\u66F4\u65B0 SuperSpec...")}`);
+  const templateNames = Object.values(config.templates).map((v) => v.endsWith(".md") ? v : `${v}.md`);
   ensureDir(join8(specDir, "templates"));
-  for (const tpl of templates) {
-    copyTemplate(tpl, join8(specDir, "templates", tpl), lang);
+  for (const tpl of templateNames) {
+    try {
+      copyTemplate(tpl, join8(specDir, "templates", tpl), lang);
+    } catch {
+    }
   }
-  log.success(`  ${symbol.ok} \u6A21\u677F\u66F4\u65B0 (${lang})`);
+  log.success(`  ${symbol.ok} ${t("templates updated", "\u6A21\u677F\u66F4\u65B0")} (${lang})`);
   installAgentsMd(cwd);
   const aiEditor = config.aiEditor;
   if (aiEditor && AI_EDITORS[aiEditor]) {
     installRules(cwd, aiEditor);
     installCommands(cwd, aiEditor, lang);
   }
-  log.info(`${symbol.start} \u66F4\u65B0\u5B8C\u6210\uFF01`);
+  log.info(`${symbol.start} ${t("update done!", "\u66F4\u65B0\u5B8C\u6210\uFF01")}`);
 }
 
 // src/commands/lint.ts
-import { existsSync as existsSync10, readdirSync as readdirSync5 } from "fs";
+import { existsSync as existsSync11 } from "fs";
 import { join as join10 } from "path";
 
 // src/core/lint.ts
-import { readFileSync as readFileSync4, existsSync as existsSync9, readdirSync as readdirSync4 } from "fs";
+import { readFileSync as readFileSync4, existsSync as existsSync10, readdirSync as readdirSync5 } from "fs";
 import { join as join9, basename } from "path";
 function lintArtifact(filePath, targetLines, hardLines) {
   const artifact = basename(filePath);
-  if (!existsSync9(filePath)) {
+  if (!existsSync10(filePath)) {
     return { artifact, lines: 0, status: "ok", message: "not found" };
   }
   const content = readFileSync4(filePath, "utf-8");
@@ -615,8 +678,8 @@ function lintArtifact(filePath, targetLines, hardLines) {
   return { artifact, lines, status: "ok", message: `${lines} lines` };
 }
 function lintChange(changePath, targetLines, hardLines) {
-  if (!existsSync9(changePath)) return [];
-  const files = readdirSync4(changePath).filter((f) => f.endsWith(".md"));
+  if (!existsSync10(changePath)) return [];
+  const files = readdirSync5(changePath).filter((f) => f.endsWith(".md"));
   return files.map((f) => lintArtifact(join9(changePath, f), targetLines, hardLines));
 }
 
@@ -626,26 +689,16 @@ async function lintCommand(name) {
   const config = loadConfig(cwd);
   const changesDir = join10(cwd, config.specDir, "changes");
   const { targetLines, hardLines } = config.limits;
-  if (!existsSync10(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
-    return;
-  }
-  const names = [];
-  if (name) {
-    names.push(name);
-  } else {
-    const entries = readdirSync5(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
-    names.push(...entries.map((e) => e.name));
-  }
+  const names = resolveChangeNames(changesDir, name, config.archive.dir);
   if (names.length === 0) {
-    log.warn(`${symbol.warn} no changes to lint`);
+    log.warn(`${symbol.warn} ${t("no changes to lint", "\u6CA1\u6709\u53EF\u68C0\u67E5\u7684\u53D8\u66F4")}`);
     return;
   }
   let hasIssues = false;
   for (const n of names) {
     const changePath = join10(changesDir, n);
-    if (!existsSync10(changePath)) {
-      log.warn(`${symbol.warn} "${n}" not found`);
+    if (!existsSync11(changePath)) {
+      log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
       continue;
     }
     const results = lintChange(changePath, targetLines, hardLines);
@@ -663,16 +716,16 @@ async function lintCommand(name) {
     }
   }
   if (!hasIssues) {
-    log.info(`${symbol.start} all artifacts within limits`);
+    log.info(`${symbol.start} ${t("all artifacts within limits", "\u6240\u6709 artifact \u5747\u5728\u9650\u5236\u8303\u56F4\u5185")}`);
   }
 }
 
 // src/commands/validate.ts
-import { existsSync as existsSync12, readdirSync as readdirSync7 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { join as join12 } from "path";
 
 // src/core/validate.ts
-import { readFileSync as readFileSync5, existsSync as existsSync11 } from "fs";
+import { readFileSync as readFileSync5, existsSync as existsSync12 } from "fs";
 import { join as join11 } from "path";
 
 // src/core/frontmatter.ts
@@ -689,6 +742,7 @@ function parseFrontmatter(content) {
     if (idx === -1) continue;
     const key = line.slice(0, idx).trim();
     let value = line.slice(idx + 1).trim();
+    if (key === "") continue;
     if (value === "[]") {
       value = [];
     } else if (value.startsWith("[") && value.endsWith("]")) {
@@ -720,17 +774,17 @@ function serializeFrontmatter(meta) {
 }
 function addDependency(content, depName) {
   const { meta, body } = parseFrontmatter(content);
-  const deps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
-  if (!deps.includes(depName)) {
-    deps.push(depName);
+  const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+  if (!deps2.includes(depName)) {
+    deps2.push(depName);
   }
-  meta.depends_on = deps;
+  meta.depends_on = deps2;
   return serializeFrontmatter(meta) + "\n" + body;
 }
 function removeDependency(content, depName) {
   const { meta, body } = parseFrontmatter(content);
-  const deps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
-  meta.depends_on = deps.filter((d) => d !== depName);
+  const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+  meta.depends_on = deps2.filter((d) => d !== depName);
   return serializeFrontmatter(meta) + "\n" + body;
 }
 
@@ -743,7 +797,7 @@ function validateChange(changePath, checkDeps = false) {
   const issues = [];
   const read = (name) => {
     const p = join11(changePath, name);
-    return existsSync11(p) ? readFileSync5(p, "utf-8") : null;
+    return existsSync12(p) ? readFileSync5(p, "utf-8") : null;
   };
   const proposal = read("proposal.md");
   const spec = read("spec.md");
@@ -796,7 +850,7 @@ function validateChange(changePath, checkDeps = false) {
     }
     const changesDir = join11(changePath, "..");
     for (const dep of fmDeps) {
-      if (!existsSync11(join11(changesDir, dep))) {
+      if (!existsSync12(join11(changesDir, dep))) {
         issues.push({ level: "error", artifact: "proposal.md", message: `depends_on "${dep}" not found in changes` });
       }
     }
@@ -809,32 +863,22 @@ async function validateCommand(name, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const changesDir = join12(cwd, config.specDir, "changes");
-  if (!existsSync12(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
-    return;
-  }
-  const names = [];
-  if (name) {
-    names.push(name);
-  } else {
-    const entries = readdirSync7(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
-    names.push(...entries.map((e) => e.name));
-  }
+  const names = resolveChangeNames(changesDir, name, config.archive.dir);
   if (names.length === 0) {
-    log.warn(`${symbol.warn} no changes to validate`);
+    log.warn(`${symbol.warn} ${t("no changes to validate", "\u6CA1\u6709\u53EF\u9A8C\u8BC1\u7684\u53D8\u66F4")}`);
     return;
   }
   let totalIssues = 0;
   for (const n of names) {
     const changePath = join12(changesDir, n);
-    if (!existsSync12(changePath)) {
-      log.warn(`${symbol.warn} "${n}" not found`);
+    if (!existsSync13(changePath)) {
+      log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
       continue;
     }
     const issues = validateChange(changePath, options.checkDeps);
     log.info(`${symbol.start} ${n}`);
     if (issues.length === 0) {
-      log.success(`  ${symbol.ok} all checks passed`);
+      log.success(`  ${symbol.ok} ${t("all checks passed", "\u6240\u6709\u68C0\u67E5\u901A\u8FC7")}`);
     } else {
       for (const issue of issues) {
         totalIssues++;
@@ -849,42 +893,55 @@ async function validateCommand(name, options) {
     }
   }
   if (totalIssues === 0) {
-    log.success(`${symbol.ok} all validations passed`);
+    log.success(`${symbol.ok} ${t("all validations passed", "\u6240\u6709\u9A8C\u8BC1\u901A\u8FC7")}`);
   } else {
-    log.warn(`${symbol.warn} ${totalIssues} issue(s) found`);
+    log.warn(`${symbol.warn} ${totalIssues} ${t("issue(s) found", "\u4E2A\u95EE\u9898")}`);
   }
 }
 
 // src/commands/search.ts
-import { existsSync as existsSync13, readFileSync as readFileSync6, readdirSync as readdirSync8 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync6, readdirSync as readdirSync7 } from "fs";
 import { join as join13, basename as basename3 } from "path";
+var DEFAULT_LIMIT = 50;
 async function searchCommand(query, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const changesDir = join13(cwd, config.specDir, "changes");
-  if (!existsSync13(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
+  if (!existsSync14(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
   const dirs = [];
-  const activeEntries = readdirSync8(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
+  const activeEntries = readdirSync7(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
   for (const e of activeEntries) {
     dirs.push({ name: e.name, path: join13(changesDir, e.name) });
   }
   if (options.archived) {
     const archiveDir = join13(changesDir, config.archive.dir);
-    if (existsSync13(archiveDir)) {
-      const archivedEntries = readdirSync8(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+    if (existsSync14(archiveDir)) {
+      const archivedEntries = readdirSync7(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
       for (const e of archivedEntries) {
         dirs.push({ name: `${config.archive.dir}/${e.name}`, path: join13(archiveDir, e.name) });
       }
     }
   }
-  const queryLower = query.toLowerCase();
+  let matcher;
+  if (options.regex) {
+    try {
+      const re = new RegExp(query, "i");
+      matcher = (line) => re.test(line);
+    } catch (e) {
+      log.error(`${symbol.fail} ${t("invalid regex", "\u65E0\u6548\u6B63\u5219")}: ${e.message}`);
+      return;
+    }
+  } else {
+    const queryLower = query.toLowerCase();
+    matcher = (line) => line.toLowerCase().includes(queryLower);
+  }
   const hits = [];
   for (const dir of dirs) {
-    if (!existsSync13(dir.path)) continue;
-    const files = readdirSync8(dir.path).filter((f) => f.endsWith(".md"));
+    if (!existsSync14(dir.path)) continue;
+    const files = readdirSync7(dir.path).filter((f) => f.endsWith(".md"));
     for (const file of files) {
       if (options.artifact) {
         const artType = basename3(file, ".md");
@@ -894,7 +951,7 @@ async function searchCommand(query, options) {
       const content = readFileSync6(filePath, "utf-8");
       const lines = content.split("\n");
       for (let i = 0; i < lines.length; i++) {
-        if (lines[i].toLowerCase().includes(queryLower)) {
+        if (matcher(lines[i])) {
           hits.push({
             change: dir.name,
             artifact: file,
@@ -906,81 +963,86 @@ async function searchCommand(query, options) {
     }
   }
   if (hits.length === 0) {
-    log.warn(`${symbol.warn} no results for "${query}"`);
+    log.warn(`${symbol.warn} ${t(`no results for "${query}"`, `"${query}" \u65E0\u7ED3\u679C`)}`);
     return;
   }
-  log.info(`${symbol.start} ${hits.length} result(s) for "${query}"`);
-  for (const hit of hits) {
+  const limit = options.limit ? parseInt(options.limit, 10) : DEFAULT_LIMIT;
+  const shown = hits.slice(0, limit);
+  log.info(`${symbol.start} ${hits.length} ${t("result(s) for", "\u6761\u7ED3\u679C\uFF0C\u641C\u7D22")} "${query}"`);
+  for (const hit of shown) {
     log.dim(`  ${hit.change}/${hit.artifact}:${hit.line}  ${hit.text}`);
   }
+  if (hits.length > limit) {
+    log.dim(`  ... ${hits.length - limit} ${t("more result(s), use --limit to show more", "\u6761\u66F4\u591A\u7ED3\u679C\uFF0C\u4F7F\u7528 --limit \u663E\u793A\u66F4\u591A")}`);
+  }
 }
 
-// src/commands/link.ts
-import { existsSync as existsSync14, readFileSync as readFileSync7, writeFileSync as writeFileSync4, readdirSync as readdirSync9 } from "fs";
+// src/commands/deps.ts
+import { existsSync as existsSync15, readFileSync as readFileSync7, writeFileSync as writeFileSync4, readdirSync as readdirSync8 } from "fs";
 import { join as join14 } from "path";
-async function linkCommand(name, options) {
+async function depsAddCommand(name, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const proposalPath = join14(cwd, config.specDir, "changes", name, "proposal.md");
-  if (!existsSync14(proposalPath)) {
-    log.warn(`${symbol.warn} "${name}" not found`);
+  if (!existsSync15(proposalPath)) {
+    log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
     return;
   }
   const content = readFileSync7(proposalPath, "utf-8");
-  const updated = addDependency(content, options.dependsOn);
+  const updated = addDependency(content, options.on);
   writeFileSync4(proposalPath, updated, "utf-8");
-  log.success(`${symbol.ok} ${name} \u2192 depends_on: ${options.dependsOn}`);
+  log.success(`${symbol.ok} ${name} \u2192 depends_on: ${options.on}`);
 }
-async function unlinkCommand(name, options) {
+async function depsRemoveCommand(name, options) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const proposalPath = join14(cwd, config.specDir, "changes", name, "proposal.md");
-  if (!existsSync14(proposalPath)) {
-    log.warn(`${symbol.warn} "${name}" not found`);
+  if (!existsSync15(proposalPath)) {
+    log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
     return;
   }
   const content = readFileSync7(proposalPath, "utf-8");
-  const updated = removeDependency(content, options.dependsOn);
+  const updated = removeDependency(content, options.on);
   writeFileSync4(proposalPath, updated, "utf-8");
-  log.success(`${symbol.ok} ${name} \u2192 removed dependency: ${options.dependsOn}`);
+  log.success(`${symbol.ok} ${name} \u2192 ${t("removed dependency", "\u79FB\u9664\u4F9D\u8D56")}: ${options.on}`);
 }
-async function depsCommand(name) {
+async function depsListCommand(name) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const changesDir = join14(cwd, config.specDir, "changes");
   if (name) {
     const proposalPath = join14(changesDir, name, "proposal.md");
-    if (!existsSync14(proposalPath)) {
-      log.warn(`${symbol.warn} "${name}" not found`);
+    if (!existsSync15(proposalPath)) {
+      log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
       return;
     }
     const content = readFileSync7(proposalPath, "utf-8");
     const { meta } = parseFrontmatter(content);
-    const deps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+    const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
     log.info(`${symbol.start} ${name}`);
-    if (deps.length === 0) {
-      log.dim("  no dependencies");
+    if (deps2.length === 0) {
+      log.dim(`  ${t("no dependencies", "\u65E0\u4F9D\u8D56")}`);
     } else {
-      for (const d of deps) {
+      for (const d of deps2) {
         log.dim(`  \u2192 ${d}`);
       }
     }
     return;
   }
-  if (!existsSync14(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory`);
+  if (!existsSync15(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
-  const entries = readdirSync9(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
-  log.info(`${symbol.start} dependency graph`);
+  const entries = readdirSync8(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
+  log.info(`${symbol.start} ${t("dependency graph", "\u4F9D\u8D56\u5173\u7CFB")}`);
   for (const entry of entries) {
     const proposalPath = join14(changesDir, entry.name, "proposal.md");
-    if (!existsSync14(proposalPath)) continue;
+    if (!existsSync15(proposalPath)) continue;
     const content = readFileSync7(proposalPath, "utf-8");
     const { meta } = parseFrontmatter(content);
-    const deps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
-    if (deps.length > 0) {
-      log.dim(`  ${entry.name} \u2192 [${deps.join(", ")}]`);
+    const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+    if (deps2.length > 0) {
+      log.dim(`  ${entry.name} \u2192 [${deps2.join(", ")}]`);
     } else {
       log.dim(`  ${entry.name}`);
     }
@@ -988,12 +1050,12 @@ async function depsCommand(name) {
 }
 
 // src/commands/status.ts
-import { existsSync as existsSync15, readFileSync as readFileSync8, readdirSync as readdirSync10 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync8, readdirSync as readdirSync9 } from "fs";
 import { join as join15 } from "path";
 var ARTIFACT_TYPES = ["proposal", "spec", "tasks", "clarify", "checklist"];
 function readStatus(changePath, artifact) {
   const filePath = join15(changePath, `${artifact}.md`);
-  if (!existsSync15(filePath)) return "\u2014";
+  if (!existsSync16(filePath)) return "\u2014";
   const content = readFileSync8(filePath, "utf-8");
   const { meta } = parseFrontmatter(content);
   if (meta.status) return meta.status;
@@ -1018,13 +1080,13 @@ async function statusCommand() {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
   const changesDir = join15(cwd, config.specDir, "changes");
-  if (!existsSync15(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
+  if (!existsSync16(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
-  const entries = readdirSync10(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir).sort((a, b) => a.name.localeCompare(b.name));
+  const entries = readdirSync9(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir).sort((a, b) => a.name.localeCompare(b.name));
   if (entries.length === 0) {
-    log.dim("  no active changes");
+    log.dim(`  ${t("no active changes", "\u65E0\u6D3B\u8DC3\u53D8\u66F4")}`);
     return;
   }
   const header = ["Change", ...ARTIFACT_TYPES.map((a) => a.slice(0, 8).padEnd(8)), "Status"];
@@ -1047,31 +1109,50 @@ async function statusCommand() {
   });
   const divider = colWidths.map((w) => "-".repeat(w + 2)).join("+");
   const formatRow = (row) => row.map((cell, i) => ` ${cell.padEnd(colWidths[i])} `).join("|");
-  log.info(`${symbol.start} changes`);
+  log.info(`${symbol.start} ${t("changes", "\u53D8\u66F4\u5217\u8868")}`);
   console.log(formatRow(header));
   console.log(divider);
   for (const row of rows) {
     console.log(formatRow(row));
   }
   const archiveDir = join15(changesDir, config.archive.dir);
-  if (existsSync15(archiveDir)) {
-    const archived = readdirSync10(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+  if (existsSync16(archiveDir)) {
+    const archived = readdirSync9(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
     if (archived.length > 0) {
       log.dim(`
-  ${archived.length} archived change(s)`);
+  ${archived.length} ${t("archived change(s)", "\u4E2A\u5DF2\u5F52\u6863\u53D8\u66F4")}`);
+    }
+  }
+}
+async function listCommand(options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const changesDir = join15(cwd, config.specDir, "changes");
+  if (!existsSync16(changesDir)) return;
+  const entries = readdirSync9(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir).sort((a, b) => a.name.localeCompare(b.name));
+  for (const e of entries) {
+    console.log(e.name);
+  }
+  if (options.archived) {
+    const archiveDir = join15(changesDir, config.archive.dir);
+    if (existsSync16(archiveDir)) {
+      const archived = readdirSync9(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+      for (const e of archived) {
+        console.log(`${config.archive.dir}/${e.name}`);
+      }
     }
   }
 }
 function stripAnsi(str) {
-  return str.replace(/\u001b\[[0-9;]*m/g, "").replace(/[✅🟢🟡]/g, "XX");
+  return str.replace(/\u001b\[\d+(?:;\d+)*m/g, "").replace(/[✅🟢🟡—]/g, "XX");
 }
 
-// src/commands/context.ts
-import { existsSync as existsSync17, writeFileSync as writeFileSync5, readdirSync as readdirSync11 } from "fs";
+// src/commands/sync.ts
+import { existsSync as existsSync18, writeFileSync as writeFileSync5 } from "fs";
 import { join as join17 } from "path";
 
 // src/core/context.ts
-import { readFileSync as readFileSync9, existsSync as existsSync16 } from "fs";
+import { readFileSync as readFileSync9, existsSync as existsSync17 } from "fs";
 import { join as join16 } from "path";
 function extractSection(body, heading) {
   const regex = new RegExp(`^##\\s+${heading}[\\s\\S]*?$`, "im");
@@ -1151,7 +1232,7 @@ function classifyGitChanges(gitChanges, taskFiles) {
 function generateContext(changePath, changeName, options = {}) {
   const read = (name) => {
     const p = join16(changePath, name);
-    return existsSync16(p) ? readFileSync9(p, "utf-8") : null;
+    return existsSync17(p) ? readFileSync9(p, "utf-8") : null;
   };
   const proposal = read("proposal.md");
   const spec = read("spec.md");
@@ -1220,7 +1301,7 @@ function generateContext(changePath, changeName, options = {}) {
     }
     lines.push("");
   }
-  if (options.gitDiff !== false) {
+  if (options.gitDiff === true) {
     const gitChanges = getDiffFiles(options.baseBranch);
     if (gitChanges.length > 0) {
       const classified = classifyGitChanges(gitChanges, files);
@@ -1235,95 +1316,51 @@ function generateContext(changePath, changeName, options = {}) {
   return lines.join("\n");
 }
 
-// src/commands/context.ts
-async function contextCommand(name) {
-  const cwd = process.cwd();
-  const config = loadConfig(cwd);
-  const changesDir = join17(cwd, config.specDir, "changes");
-  if (!existsSync17(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
-    return;
-  }
-  const names = [];
-  if (name) {
-    names.push(name);
-  } else {
-    const entries = readdirSync11(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
-    names.push(...entries.map((e) => e.name));
-  }
-  if (names.length === 0) {
-    log.warn(`${symbol.warn} no changes found`);
-    return;
-  }
-  for (const n of names) {
-    const changePath = join17(changesDir, n);
-    if (!existsSync17(changePath)) {
-      log.warn(`${symbol.warn} "${n}" not found`);
-      continue;
-    }
-    const content = generateContext(changePath, n);
-    const destPath = join17(changePath, "context.md");
-    writeFileSync5(destPath, content, "utf-8");
-    log.success(`${symbol.ok} ${n}/context.md`);
-  }
-}
-
 // src/commands/sync.ts
-import { existsSync as existsSync18, writeFileSync as writeFileSync6, readdirSync as readdirSync12 } from "fs";
-import { join as join18 } from "path";
 async function syncCommand(name, opts) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
-  const changesDir = join18(cwd, config.specDir, "changes");
-  if (!existsSync18(changesDir)) {
-    log.warn(`${symbol.warn} no changes directory found`);
-    return;
-  }
-  const names = [];
-  if (name) {
-    names.push(name);
-  } else {
-    const entries = readdirSync12(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
-    names.push(...entries.map((e) => e.name));
-  }
+  const changesDir = join17(cwd, config.specDir, "changes");
+  const names = resolveChangeNames(changesDir, name, config.archive.dir);
   if (names.length === 0) {
-    log.warn(`${symbol.warn} no changes found`);
+    log.warn(`${symbol.warn} ${t("no changes found", "\u672A\u627E\u5230\u53D8\u66F4")}`);
     return;
   }
+  const useGit = opts.git !== false;
   for (const n of names) {
-    const changePath = join18(changesDir, n);
+    const changePath = join17(changesDir, n);
     if (!existsSync18(changePath)) {
-      log.warn(`${symbol.warn} "${n}" not found`);
+      log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
       continue;
     }
     const content = generateContext(changePath, n, {
-      gitDiff: true,
+      gitDiff: useGit,
       baseBranch: opts.base
     });
-    const destPath = join18(changePath, "context.md");
-    writeFileSync6(destPath, content, "utf-8");
-    log.success(`${symbol.ok} synced ${n}/context.md`);
+    const destPath = join17(changePath, "context.md");
+    writeFileSync5(destPath, content, "utf-8");
+    log.success(`${symbol.ok} ${t("synced", "\u5DF2\u540C\u6B65")} ${n}/context.md`);
   }
 }
 
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
-var isZh = loadConfig().lang === "zh";
-var t = (en, zh) => isZh ? zh : en;
+setLang(loadConfig(process.cwd(), true).lang);
 program.name("superspec").description(t("Spec-driven development for AI coding assistants", "AI \u7F16\u7801\u52A9\u624B\u7684\u89C4\u683C\u9A71\u52A8\u5F00\u53D1\u5DE5\u5177")).version(pkg.version);
 program.command("init").description(t("Initialize SuperSpec in current project", "\u521D\u59CB\u5316 SuperSpec \u5230\u5F53\u524D\u9879\u76EE")).option("--ai <agent>", t("AI assistant type: claude, cursor, qwen, opencode, codex, codebuddy, qoder", "AI \u52A9\u624B\u7C7B\u578B: claude, cursor, qwen, opencode, codex, codebuddy, qoder"), "cursor").option("--lang <lang>", t("Template language: zh, en", "\u6A21\u677F\u8BED\u8A00: zh, en"), "en").option("--force", t("Force overwrite existing config", "\u5F3A\u5236\u8986\u76D6\u5DF2\u6709\u914D\u7F6E")).option("--no-git", t("Skip git initialization", "\u8DF3\u8FC7 git \u521D\u59CB\u5316")).action(initCommand);
-program.command("create <name>").description(t("Create change and generate proposal (-b boost mode)", "\u521B\u5EFA\u53D8\u66F4\u5E76\u751F\u6210 proposal\uFF08-b \u589E\u5F3A\u6A21\u5F0F\uFF09")).option("-b, --boost", t("Boost mode, also generate spec + checklist", "\u589E\u5F3A\u6A21\u5F0F\uFF0C\u989D\u5916\u751F\u6210 spec + checklist")).option("-c, --creative", t("Creative mode, encourage new approaches", "\u521B\u9020\u6A21\u5F0F\uFF0C\u9F13\u52B1\u63A2\u7D22\u65B0\u65B9\u6848")).option("-d, --description <desc>", t("Change description for context", "\u53D8\u66F4\u63CF\u8FF0\uFF0C\u7528\u4E8E\u751F\u6210\u4E0A\u4E0B\u6587")).option("--no-branch", t("Skip git branch creation", "\u4E0D\u521B\u5EFA git \u5206\u652F")).option("--spec-dir <dir>", t("Custom spec folder name", "\u81EA\u5B9A\u4E49 spec \u6587\u4EF6\u5939\u540D\u79F0")).option("--branch-prefix <prefix>", t("Custom branch prefix", "\u81EA\u5B9A\u4E49\u5206\u652F\u524D\u7F00")).action(createCommand);
+program.command("create <feature>").description(t("Create change and generate proposal (-b boost mode)", "\u521B\u5EFA\u53D8\u66F4\u5E76\u751F\u6210 proposal\uFF08-b \u589E\u5F3A\u6A21\u5F0F\uFF09")).option("-b, --boost", t("Boost mode, also generate spec + checklist", "\u589E\u5F3A\u6A21\u5F0F\uFF0C\u989D\u5916\u751F\u6210 spec + checklist")).option("-c, --creative", t("Creative mode, encourage new approaches", "\u521B\u9020\u6A21\u5F0F\uFF0C\u9F13\u52B1\u63A2\u7D22\u65B0\u65B9\u6848")).option("-d, --description <desc>", t("Change description for context", "\u53D8\u66F4\u63CF\u8FF0\uFF0C\u7528\u4E8E\u751F\u6210\u4E0A\u4E0B\u6587")).option("--spec-dir <dir>", t("Custom spec folder name", "\u81EA\u5B9A\u4E49 spec \u6587\u4EF6\u5939\u540D\u79F0")).option("--no-branch", t("Skip git branch creation", "\u4E0D\u521B\u5EFA git \u5206\u652F")).option("--intent-type <type>", t("Intent type: feature, hotfix, bugfix, refactor, chore", "\u610F\u56FE\u7C7B\u578B\uFF1Afeature, hotfix, bugfix, refactor, chore")).option("--branch-prefix <prefix>", t("Custom branch prefix", "\u81EA\u5B9A\u4E49\u5206\u652F\u524D\u7F00")).option("--branch-template <template>", t("Branch name template: {prefix}{date}-{feature}-{user}", "\u5206\u652F\u540D\u79F0\u6A21\u677F\uFF1A{prefix}-{date}-{feature}-{user}")).option("--change-name-template <template>", t("Folder name template: {date}-{feature}-{user}", "\u6587\u4EF6\u5939\u540D\u79F0\u6A21\u677F\uFF1A{date}-{feature}-{user}")).option("--user <user>", t("Developer identifier (e.g. jay)", "\u5F00\u53D1\u8005\u6807\u8BC6\uFF08\u5982 jay\uFF09")).option("--lang <lang>", t("SDD document language: zh, en", "SDD \u6587\u6863\u8BED\u8A00: zh, en")).action(createCommand);
 program.command("archive [name]").description(t("Archive completed changes", "\u5F52\u6863\u5DF2\u5B8C\u6210\u7684\u53D8\u66F4")).option("--all", t("Archive all completed changes", "\u5F52\u6863\u6240\u6709\u5DF2\u5B8C\u6210\u7684\u53D8\u66F4")).action(archiveCommand);
 program.command("update").description(t("Refresh agent instructions and templates", "\u5237\u65B0 agent \u6307\u4EE4\u548C\u6A21\u677F")).action(updateCommand);
 program.command("lint [name]").description(t("Check artifact line limits", "\u68C0\u67E5 artifact \u884C\u6570\u662F\u5426\u8D85\u9650")).action(lintCommand);
 program.command("validate [name]").description(t("Cross-validate artifact consistency", "\u4EA4\u53C9\u9A8C\u8BC1 artifact \u4E00\u81F4\u6027")).option("--check-deps", t("Also check dependency consistency", "\u540C\u65F6\u68C0\u67E5\u4F9D\u8D56\u4E00\u81F4\u6027")).action(validateCommand);
-program.command("search <query>").description(t("Search change contents", "\u641C\u7D22\u53D8\u66F4\u5185\u5BB9")).option("--archived", t("Include archived changes", "\u5305\u542B\u5DF2\u5F52\u6863\u7684\u53D8\u66F4")).option("--artifact <type>", t("Filter by artifact type (proposal/spec/tasks/clarify/checklist)", "\u6309 artifact \u7C7B\u578B\u8FC7\u6EE4 (proposal/spec/tasks/clarify/checklist)")).action(searchCommand);
-program.command("link <name>").description(t("Add spec dependency", "\u6DFB\u52A0 spec \u4F9D\u8D56")).requiredOption("--depends-on <other>", t("Dependency spec name", "\u4F9D\u8D56\u7684 spec \u540D\u79F0")).action(linkCommand);
-program.command("unlink <name>").description(t("Remove spec dependency", "\u79FB\u9664 spec \u4F9D\u8D56")).requiredOption("--depends-on <other>", t("Dependency to remove", "\u8981\u79FB\u9664\u7684\u4F9D\u8D56\u540D\u79F0")).action(unlinkCommand);
-program.command("deps [name]").description(t("View dependency graph", "\u67E5\u770B\u4F9D\u8D56\u5173\u7CFB")).action(depsCommand);
+program.command("search <query>").description(t("Search change contents", "\u641C\u7D22\u53D8\u66F4\u5185\u5BB9")).option("--archived", t("Include archived changes", "\u5305\u542B\u5DF2\u5F52\u6863\u7684\u53D8\u66F4")).option("--artifact <type>", t("Filter by artifact type (proposal/spec/tasks/clarify/checklist)", "\u6309 artifact \u7C7B\u578B\u8FC7\u6EE4 (proposal/spec/tasks/clarify/checklist)")).option("--limit <n>", t("Max results to show (default: 50)", "\u6700\u5927\u663E\u793A\u7ED3\u679C\u6570\uFF08\u9ED8\u8BA4 50\uFF09")).option("-E, --regex", t("Use regex pattern matching", "\u4F7F\u7528\u6B63\u5219\u8868\u8FBE\u5F0F\u5339\u914D")).action(searchCommand);
+var deps = program.command("deps").description(t("Manage spec dependencies", "\u7BA1\u7406 spec \u4F9D\u8D56"));
+deps.command("list [name]").description(t("View dependency graph", "\u67E5\u770B\u4F9D\u8D56\u5173\u7CFB")).action(depsListCommand);
+deps.command("add <name>").description(t("Add spec dependency", "\u6DFB\u52A0 spec \u4F9D\u8D56")).requiredOption("--on <other>", t("Dependency spec name", "\u4F9D\u8D56\u7684 spec \u540D\u79F0")).action(depsAddCommand);
+deps.command("remove <name>").description(t("Remove spec dependency", "\u79FB\u9664 spec \u4F9D\u8D56")).requiredOption("--on <other>", t("Dependency to remove", "\u8981\u79FB\u9664\u7684\u4F9D\u8D56\u540D\u79F0")).action(depsRemoveCommand);
 program.command("status").description(t("View all change statuses", "\u67E5\u770B\u6240\u6709\u53D8\u66F4\u72B6\u6001")).action(statusCommand);
-program.command("context [name]").description(t("Generate/refresh context.md summary (for vibe coding)", "\u751F\u6210/\u5237\u65B0 context.md \u4E0A\u4E0B\u6587\u6458\u8981\uFF08\u7528\u4E8E vibe coding\uFF09")).action(contextCommand);
-program.command("sync [name]").description(t("Sync git changes to context.md (collect facts, no auto-check tasks)", "\u540C\u6B65 git \u53D8\u66F4\u5230 context.md\uFF08\u6536\u96C6\u4E8B\u5B9E\uFF0C\u4E0D\u81EA\u52A8\u52FE\u9009 task\uFF09")).option("--base <branch>", t("Base branch (default: main/master)", "\u57FA\u51C6\u5206\u652F\uFF08\u9ED8\u8BA4 main/master\uFF09")).action(syncCommand);
+program.command("list").description(t("List change names (for scripting)", "\u5217\u51FA\u53D8\u66F4\u540D\u79F0\uFF08\u7528\u4E8E\u811A\u672C\uFF09")).option("--archived", t("Include archived changes", "\u5305\u542B\u5DF2\u5F52\u6863\u7684\u53D8\u66F4")).action(listCommand);
+program.command("sync [name]").description(t("Sync git changes to context.md", "\u540C\u6B65 git \u53D8\u66F4\u5230 context.md")).option("--base <branch>", t("Base branch (default: main/master)", "\u57FA\u51C6\u5206\u652F\uFF08\u9ED8\u8BA4 main/master\uFF09")).option("--no-git", t("Skip git diff collection", "\u4E0D\u6536\u96C6 git diff \u4FE1\u606F")).action(syncCommand);
 program.parse();
 //# sourceMappingURL=index.js.map