@superspec/cli 1.1.1 → 1.2.1

package/dist/cli/index.js

@@ -4,13 +4,12 @@
 import { createRequire } from "module";
 import { program } from "commander";
 
-// src/commands/init.ts
-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";
+// src/commands/archive.ts
+import { existsSync as existsSync3, readdirSync as readdirSync2, renameSync } from "fs";
+import { join as join2 } from "path";
 
 // src/core/config.ts
-import { readFileSync, existsSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 var DEFAULT_CONFIG = {
   lang: "en",
@@ -72,129 +71,6 @@ function deepMerge(target, source) {
   return result;
 }
 
-// src/core/template.ts
-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);
-  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 existsSync3, readdirSync } from "fs";
-function ensureDir(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 (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") {
-  const srcPath = resolveTemplatePath(templateName, lang);
-  ensureDir(dirname2(destPath));
-  copyFileSync(srcPath, destPath);
-}
-function renderTemplate(templateName, vars = {}, lang = "zh") {
-  const srcPath = resolveTemplatePath(templateName, lang);
-  let content = readFileSync2(srcPath, "utf-8");
-  content = processConditionals(content, vars);
-  for (const [key, value] of Object.entries(vars)) {
-    content = content.replaceAll(`{{${key}}}`, value);
-  }
-  return content;
-}
-function processConditionals(content, vars) {
-  const ifRegex = /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g;
-  return content.replace(ifRegex, (match, varName, innerContent) => {
-    const value = vars[varName];
-    if (value && value.trim() !== "") {
-      return innerContent;
-    }
-    return "";
-  });
-}
-function writeRenderedTemplate(templateName, destPath, vars = {}, lang = "zh") {
-  const content = renderTemplate(templateName, vars, lang);
-  ensureDir(dirname2(destPath));
-  writeFileSync(destPath, content, "utf-8");
-}
-
-// 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", timeout: GIT_TIMEOUT });
-    return true;
-  } catch {
-    return false;
-  }
-}
-var SAFE_BRANCH_RE = /^[a-zA-Z0-9._\-/]+$/;
-function createBranch(branchName) {
-  if (!SAFE_BRANCH_RE.test(branchName)) {
-    throw new Error(`invalid branch name: ${branchName}`);
-  }
-  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", timeout: GIT_TIMEOUT }).trim();
-    return ref.replace("refs/remotes/origin/", "");
-  } catch {
-    try {
-      execSync("git rev-parse --verify main", { stdio: "ignore", timeout: GIT_TIMEOUT });
-      return "main";
-    } catch {
-      return "master";
-    }
-  }
-}
-function getDiffFiles(base) {
-  const baseBranch = base || getDefaultBranch();
-  try {
-    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("	");
-      return { status: status.charAt(0), file: parts.join("	") };
-    });
-  } catch {
-    return [];
-  }
-}
-
-// src/prompts/index.ts
-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
 import chalk from "chalk";
 var theme = {
@@ -243,7 +119,9 @@ function boxText(text, width = 50) {
 }
 function createBox(lines, width = 52) {
   const top = theme.border(`${box.topLeft}${box.horizontal.repeat(width - 2)}${box.topRight}`);
-  const bottom = theme.border(`${box.bottomLeft}${box.horizontal.repeat(width - 2)}${box.bottomRight}`);
+  const bottom = theme.border(
+    `${box.bottomLeft}${box.horizontal.repeat(width - 2)}${box.bottomRight}`
+  );
   const middle = lines.map((line) => boxText(line, width));
   return [top, ...middle, bottom].join("\n");
 }
@@ -299,7 +177,7 @@ function t(en, zh) {
 function printSummary(items) {
   const maxLabel = Math.max(...items.map((i) => i.label.length));
   const width = 50;
-  console.log(theme.border("\u256D" + "\u2500".repeat(width - 2) + "\u256E"));
+  console.log(theme.border(`\u256D${"\u2500".repeat(width - 2)}\u256E`));
   for (const { label, value } of items) {
     const padding = " ".repeat(maxLabel - label.length);
     const line = `${theme.dim(label)}${padding} ${symbol.arrow} ${theme.highlight(value)}`;
@@ -307,181 +185,150 @@ function printSummary(items) {
     const rightPad = " ".repeat(Math.max(0, width - plainLine.length - 4));
     console.log(theme.border("\u2502 ") + line + rightPad + theme.border(" \u2502"));
   }
-  console.log(theme.border("\u2570" + "\u2500".repeat(width - 2) + "\u256F"));
+  console.log(theme.border(`\u2570${"\u2500".repeat(width - 2)}\u256F`));
 }
 
-// src/prompts/index.ts
-var AI_EDITORS = {
-  claude: {
-    commands: ".claude/commands",
-    rules: null
-    // Claude doesn't use rules files
-  },
-  cursor: {
-    commands: ".cursor/commands",
-    rules: ".cursor/rules",
-    rulesFile: "superspec.mdc"
-  },
-  qwen: {
-    commands: ".qwen/commands",
-    rules: ".qwen/rules",
-    rulesFile: "superspec.md"
-  },
-  opencode: {
-    commands: ".opencode/commands",
-    rules: null
-  },
-  codex: {
-    commands: ".codex/commands",
-    rules: null
-  },
-  codebuddy: {
-    commands: ".codebuddy/commands",
-    rules: ".codebuddy/rules",
-    rulesFile: "superspec.md"
-  },
-  qoder: {
-    commands: ".qoder/commands",
-    rules: ".qoder/rules",
-    rulesFile: "superspec.md"
+// 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")}`;
+}
+
+// src/utils/fs.ts
+import { existsSync as existsSync2, mkdirSync, readdirSync } from "fs";
+function ensureDir(dir) {
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
   }
-};
-function installRules(cwd, editor) {
-  const config = AI_EDITORS[editor];
-  if (!config.rules) {
+}
+function resolveChangeNames(changesDir, name, archiveDirName) {
+  if (!existsSync2(changesDir)) return [];
+  if (name) return [name];
+  return readdirSync(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== archiveDirName).map((e) => e.name);
+}
+
+// src/commands/archive.ts
+async function archiveCommand(name, options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const changesDir = join2(cwd, config.specDir, "changes");
+  const archiveDir = join2(cwd, config.specDir, "changes", config.archive.dir);
+  if (!existsSync3(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
-  const rulesDir = join4(cwd, config.rules);
-  ensureDir(rulesDir);
-  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);
-    writeFileSync2(destPath, content, "utf-8");
-    log.success(`${symbol.ok} ${config.rules}/${rulesFile}`);
-  }
-}
-var SS_START = "<!-- superspec:start -->";
-var SS_END = "<!-- superspec:end -->";
-function installAgentsMd(cwd) {
-  const agentsMdPath = join4(cwd, "AGENTS.md");
-  const agentPromptSrc = join4(getPackageRoot(), "prompts", "agents.md");
-  if (!existsSync5(agentPromptSrc)) return;
-  const newContent = readFileSync3(agentPromptSrc, "utf-8");
-  const wrapped = `${SS_START}
-${newContent}
-${SS_END}`;
-  if (existsSync5(agentsMdPath)) {
-    const existing = readFileSync3(agentsMdPath, "utf-8");
-    const startIdx = existing.indexOf(SS_START);
-    const endIdx = existing.indexOf(SS_END);
-    if (startIdx !== -1 && endIdx !== -1) {
-      const before = existing.slice(0, startIdx);
-      const after = existing.slice(endIdx + SS_END.length);
-      writeFileSync2(agentsMdPath, before + wrapped + after, "utf-8");
-    } else if (existing.includes("SuperSpec")) {
-      writeFileSync2(agentsMdPath, existing, "utf-8");
-    } else {
-      writeFileSync2(agentsMdPath, existing + "\n\n" + wrapped, "utf-8");
+  if (options.all) {
+    const entries = readdirSync2(changesDir, { withFileTypes: true }).filter(
+      (e) => e.isDirectory() && e.name !== config.archive.dir
+    );
+    if (entries.length === 0) {
+      log.warn(`${symbol.warn} ${t("no changes to archive", "\u6CA1\u6709\u53EF\u5F52\u6863\u7684\u53D8\u66F4")}`);
+      return;
+    }
+    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 = join2(changesDir, name);
+    if (!existsSync3(changePath)) {
+      log.warn(`${symbol.warn} ${t(`change "${name}" not found`, `\u53D8\u66F4 "${name}" \u4E0D\u5B58\u5728`)}`);
+      return;
     }
+    log.info(`${symbol.start} ${t(`archiving: ${name}`, `\u5F52\u6863\u53D8\u66F4: ${name}`)}`);
+    archiveOne(name, changesDir, archiveDir, config);
   } else {
-    writeFileSync2(agentsMdPath, wrapped, "utf-8");
+    log.warn(`${symbol.warn} ${t("specify a name or use --all", "\u8BF7\u6307\u5B9A\u53D8\u66F4\u540D\u79F0\u6216\u4F7F\u7528 --all")}`);
+    return;
   }
-  log.success(`${symbol.ok} AGENTS.md`);
+  log.info(`${symbol.start} ${t("archive done!", "\u5F52\u6863\u5B8C\u6210\uFF01")}`);
 }
-function installCommands(cwd, editor, lang = "zh") {
-  const config = AI_EDITORS[editor];
-  const commandsDir = join4(cwd, config.commands);
-  ensureDir(commandsDir);
-  const templatesDir = join4(getPackageRoot(), "templates", lang, "commands");
-  const fallbackDir = join4(getPackageRoot(), "templates", "zh", "commands");
-  const sourceDir = existsSync5(templatesDir) ? templatesDir : fallbackDir;
-  if (!existsSync5(sourceDir)) {
-    log.warn(`${symbol.warn} Commands templates not found: ${sourceDir}`);
+function archiveOne(name, changesDir, archiveDir, config) {
+  ensureDir(archiveDir);
+  const src = join2(changesDir, name);
+  const dateStr = config.archive.datePrefix ? `${getDateString()}-` : "";
+  const dest = join2(archiveDir, `${dateStr}${name}`);
+  if (existsSync3(dest)) {
+    log.warn(`  ${symbol.warn} ${t("archive target exists", "\u5F52\u6863\u76EE\u6807\u5DF2\u5B58\u5728")}: ${dest}`);
     return;
   }
-  const commandFiles = readdirSync2(sourceDir).filter((f) => f.endsWith(".md"));
-  for (const file of commandFiles) {
-    const srcPath = join4(sourceDir, file);
-    const destPath = join4(commandsDir, file);
-    const content = readFileSync3(srcPath, "utf-8");
-    writeFileSync2(destPath, content, "utf-8");
-  }
-  log.success(`${symbol.ok} ${config.commands}/ (${commandFiles.length} commands)`);
+  renameSync(src, dest);
+  log.success(`  ${symbol.ok} ${name} \u2192 archive/${dateStr}${name}`);
 }
 
-// src/commands/init.ts
-async function initCommand(options) {
-  const cwd = process.cwd();
-  const configPath = join5(cwd, "superspec.config.json");
-  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();
-  config.lang = lang;
-  const aiEditor = options.ai;
-  if (aiEditor && AI_EDITORS[aiEditor]) {
-    config.aiEditor = aiEditor;
+// src/commands/create.ts
+import { existsSync as existsSync5 } from "fs";
+import { join as join4 } from "path";
+
+// 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", timeout: GIT_TIMEOUT });
+    return true;
+  } catch {
+    return false;
   }
-  const specDir = join5(cwd, config.specDir);
-  const existingFiles = readdirSync3(cwd).filter((f) => !f.startsWith(".") && f !== "node_modules");
-  if (existingFiles.length > 0 && !options.force) {
-    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();
+}
+var SAFE_BRANCH_RE = /^[a-zA-Z0-9._\-/]+$/;
+function createBranch(branchName) {
+  if (!SAFE_BRANCH_RE.test(branchName)) {
+    throw new Error(`invalid branch name: ${branchName}`);
   }
-  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(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(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) {
+  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",
+      timeout: GIT_TIMEOUT
+    }).trim();
+    return ref.replace("refs/remotes/origin/", "");
+  } catch {
     try {
-      copyTemplate(tpl, join5(specDir, "templates", tpl), lang);
+      execSync("git rev-parse --verify main", { stdio: "ignore", timeout: GIT_TIMEOUT });
+      return "main";
     } catch {
+      return "master";
     }
   }
-  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);
-    installCommands(cwd, aiEditor, lang);
-  }
-  if (options.git !== false && !isGitRepo()) {
-    execSync2("git init", { cwd, stdio: "inherit" });
-    log.success(`${symbol.git} git init`);
+}
+function getDiffFiles(base) {
+  const baseBranch = base || getDefaultBranch();
+  try {
+    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("	");
+      return { status: status.charAt(0), file: parts.join("	") };
+    });
+  } catch {
+    return [];
   }
-  console.log();
-  printSummary([
-    { label: "Config", value: "superspec.config.json" },
-    { label: "Spec dir", value: `${config.specDir}/` },
-    { label: "AI agent", value: options.ai },
-    { label: "Language", value: lang }
-  ]);
-  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 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")}`;
+// src/utils/paths.ts
+import { existsSync as existsSync4 } from "fs";
+import { dirname, join as join3 } from "path";
+import { fileURLToPath } from "url";
+function getPackageRoot() {
+  const __filename2 = fileURLToPath(import.meta.url);
+  let dir = dirname(__filename2);
+  while (dir !== dirname(dir)) {
+    if (existsSync4(join3(dir, "package.json")) && existsSync4(join3(dir, "templates"))) {
+      return dir;
+    }
+    dir = dirname(dir);
+  }
+  return join3(dirname(__filename2), "..", "..");
 }
 
 // src/utils/template.ts
@@ -507,8 +354,6 @@ async function createCommand(feature, options) {
   const branchPrefix = options.branchPrefix || config.branchPrefix;
   const boost = options.boost || config.boost;
   const strategy = options.creative ? "create" : config.strategy;
-  const description = options.description || "";
-  const lang = options.lang || config.lang || "en";
   const templateVars = {
     prefix: branchPrefix,
     intentType: options.intentType,
@@ -518,9 +363,11 @@ async function createCommand(feature, options) {
   };
   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}`);
+  const changePath = join4(cwd, specDir, "changes", changeFolderName);
+  if (existsSync5(changePath)) {
+    log.warn(
+      `${symbol.warn} ${t(`change "${changeFolderName}" already exists`, `\u53D8\u66F4 "${changeFolderName}" \u5DF2\u5B58\u5728`)}: ${changePath}`
+    );
     return;
   }
   log.title(`${t("Creating Change", "\u521B\u5EFA\u53D8\u66F4")}: ${changeFolderName}`);
@@ -531,28 +378,11 @@ async function createCommand(feature, options) {
     log.boost(`${symbol.bolt} ${t("Boost mode enabled", "\u589E\u5F3A\u6A21\u5F0F\u5DF2\u542F\u7528")}`);
   }
   if (strategy === "create") {
-    log.boost(`${symbol.bolt} ${t("Creative mode: exploring new solutions", "\u521B\u9020\u6A21\u5F0F\uFF1A\u63A2\u7D22\u65B0\u65B9\u6848")}`);
+    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: changeFolderName,
-    date: templateVars.date,
-    boost: boost ? "true" : "false",
-    strategy,
-    description
-  };
-  const artifacts = boost ? config.boostArtifacts : config.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`);
-    try {
-      writeRenderedTemplate(templateFile, destPath, vars, lang);
-      log.success(`${symbol.ok} ${artifact}.md`);
-    } catch (e) {
-      log.error(`${symbol.fail} ${artifact}.md: ${e.message}`);
-    }
-  }
   if (options.branch !== false && isGitRepo()) {
     const branchTemplate = options.branchTemplate || config.branchTemplate || "{prefix}{date}-{feature}";
     const branchName = renderNameTemplate(branchTemplate, templateVars, true);
@@ -565,168 +395,17 @@ async function createCommand(feature, options) {
   }
   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(`${t("Workflow", "\u5DE5\u4F5C\u6D41")}: /ss-create \u2192 /ss-tasks \u2192 /ss-apply (boost)`);
-  } else {
-    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 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 (!existsSync8(changesDir)) {
-    log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
-    return;
-  }
-  if (options.all) {
-    const entries = readdirSync4(changesDir, { withFileTypes: true }).filter(
-      (e) => e.isDirectory() && e.name !== config.archive.dir
-    );
-    if (entries.length === 0) {
-      log.warn(`${symbol.warn} ${t("no changes to archive", "\u6CA1\u6709\u53EF\u5F52\u6863\u7684\u53D8\u66F4")}`);
-      return;
-    }
-    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 (!existsSync8(changePath)) {
-      log.warn(`${symbol.warn} ${t(`change "${name}" not found`, `\u53D8\u66F4 "${name}" \u4E0D\u5B58\u5728`)}`);
-      return;
-    }
-    log.info(`${symbol.start} ${t(`archiving: ${name}`, `\u5F52\u6863\u53D8\u66F4: ${name}`)}`);
-    archiveOne(name, changesDir, archiveDir, config);
-  } else {
-    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} ${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 (existsSync8(dest)) {
-    log.warn(`  ${symbol.warn} ${t("archive target exists", "\u5F52\u6863\u76EE\u6807\u5DF2\u5B58\u5728")}: ${dest}`);
-    return;
-  }
-  renameSync(src, dest);
-  log.success(`  ${symbol.ok} ${name} \u2192 archive/${dateStr}${name}`);
+  log.dim(`${t("Templates", "\u6A21\u677F\u53C2\u8003")}: ${specDir}/templates/`);
+  const expectedArtifacts = boost ? config.boostArtifacts : config.artifacts;
+  log.dim(`${t("Expected artifacts", "\u9884\u671F Artifacts")}: ${expectedArtifacts.join(", ")}`);
+  log.dim(
+    `${t("Next", "\u4E0B\u4E00\u6B65")}: ${t("AI generates artifacts on demand via /ss-create", "AI \u6309\u9700\u901A\u8FC7 /ss-create \u751F\u6210 artifacts")}`
+  );
 }
 
-// src/commands/update.ts
-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 (!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} ${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 templateNames) {
-    try {
-      copyTemplate(tpl, join8(specDir, "templates", tpl), lang);
-    } catch {
-    }
-  }
-  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} ${t("update done!", "\u66F4\u65B0\u5B8C\u6210\uFF01")}`);
-}
-
-// src/commands/lint.ts
-import { existsSync as existsSync11 } from "fs";
-import { join as join10 } from "path";
-
-// src/core/lint.ts
-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 (!existsSync10(filePath)) {
-    return { artifact, lines: 0, status: "ok", message: "not found" };
-  }
-  const content = readFileSync4(filePath, "utf-8");
-  const lines = content.split("\n").length;
-  if (lines > hardLines) {
-    return { artifact, lines, status: "error", message: `${lines} lines exceeds hard limit (${hardLines}). Must split.` };
-  }
-  if (lines > targetLines) {
-    return { artifact, lines, status: "warn", message: `${lines} lines exceeds target (${targetLines}). Consider splitting.` };
-  }
-  return { artifact, lines, status: "ok", message: `${lines} lines` };
-}
-function lintChange(changePath, targetLines, hardLines) {
-  if (!existsSync10(changePath)) return [];
-  const files = readdirSync5(changePath).filter((f) => f.endsWith(".md"));
-  return files.map((f) => lintArtifact(join9(changePath, f), targetLines, hardLines));
-}
-
-// src/commands/lint.ts
-async function lintCommand(name) {
-  const cwd = process.cwd();
-  const config = loadConfig(cwd);
-  const changesDir = join10(cwd, config.specDir, "changes");
-  const { targetLines, hardLines } = config.limits;
-  const names = resolveChangeNames(changesDir, name, config.archive.dir);
-  if (names.length === 0) {
-    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 (!existsSync11(changePath)) {
-      log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
-      continue;
-    }
-    const results = lintChange(changePath, targetLines, hardLines);
-    log.info(`${symbol.start} ${n}`);
-    for (const r of results) {
-      if (r.status === "error") {
-        log.error(`  ${symbol.fail} ${r.artifact}: ${r.message}`);
-        hasIssues = true;
-      } else if (r.status === "warn") {
-        log.warn(`  ${symbol.warn} ${r.artifact}: ${r.message}`);
-        hasIssues = true;
-      } else {
-        log.success(`  ${symbol.ok} ${r.artifact}: ${r.message}`);
-      }
-    }
-  }
-  if (!hasIssues) {
-    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 existsSync13 } from "fs";
-import { join as join12 } from "path";
-
-// src/core/validate.ts
-import { readFileSync as readFileSync5, existsSync as existsSync12 } from "fs";
-import { join as join11 } from "path";
+// src/commands/deps.ts
+import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { join as join5 } from "path";
 
 // src/core/frontmatter.ts
 var FM_REGEX = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
@@ -779,149 +458,391 @@ function addDependency(content, depName) {
     deps2.push(depName);
   }
   meta.depends_on = deps2;
-  return serializeFrontmatter(meta) + "\n" + body;
+  return `${serializeFrontmatter(meta)}
+${body}`;
 }
 function removeDependency(content, depName) {
   const { meta, body } = parseFrontmatter(content);
   const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
   meta.depends_on = deps2.filter((d) => d !== depName);
-  return serializeFrontmatter(meta) + "\n" + body;
+  return `${serializeFrontmatter(meta)}
+${body}`;
 }
 
-// src/core/validate.ts
-function extractIds(content, pattern) {
-  const matches = content.match(pattern);
-  return matches ? [...new Set(matches)] : [];
+// src/commands/deps.ts
+async function depsAddCommand(name, options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const proposalPath = join5(cwd, config.specDir, "changes", name, "proposal.md");
+  if (!existsSync6(proposalPath)) {
+    log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
+    return;
+  }
+  const content = readFileSync2(proposalPath, "utf-8");
+  const updated = addDependency(content, options.on);
+  writeFileSync(proposalPath, updated, "utf-8");
+  log.success(`${symbol.ok} ${name} \u2192 depends_on: ${options.on}`);
 }
-function validateChange(changePath, checkDeps = false) {
-  const issues = [];
-  const read = (name) => {
-    const p = join11(changePath, name);
-    return existsSync12(p) ? readFileSync5(p, "utf-8") : null;
-  };
-  const proposal = read("proposal.md");
-  const spec = read("spec.md");
-  const tasks = read("tasks.md");
-  if (!proposal) issues.push({ level: "warn", artifact: "proposal.md", message: "missing" });
-  if (!tasks) issues.push({ level: "warn", artifact: "tasks.md", message: "missing" });
-  if (proposal && spec) {
-    const proposalGoals = extractIds(proposal, /US-\d+/g);
-    const specUS = extractIds(spec, /US-\d+/g);
-    for (const id of proposalGoals) {
-      if (!specUS.includes(id)) {
-        issues.push({ level: "error", artifact: "spec.md", message: `${id} from proposal not found in spec` });
-      }
-    }
+async function depsRemoveCommand(name, options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const proposalPath = join5(cwd, config.specDir, "changes", name, "proposal.md");
+  if (!existsSync6(proposalPath)) {
+    log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
+    return;
   }
-  if (spec && tasks) {
-    const specFR = extractIds(spec, /FR-\d+/g);
-    const tasksFR = extractIds(tasks, /FR-\d+/g);
-    for (const id of specFR) {
-      if (!tasksFR.includes(id)) {
-        issues.push({ level: "warn", artifact: "tasks.md", message: `${id} from spec not referenced in tasks` });
-      }
+  const content = readFileSync2(proposalPath, "utf-8");
+  const updated = removeDependency(content, options.on);
+  writeFileSync(proposalPath, updated, "utf-8");
+  log.success(`${symbol.ok} ${name} \u2192 ${t("removed dependency", "\u79FB\u9664\u4F9D\u8D56")}: ${options.on}`);
+}
+async function depsListCommand(name) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const changesDir = join5(cwd, config.specDir, "changes");
+  if (name) {
+    const proposalPath = join5(changesDir, name, "proposal.md");
+    if (!existsSync6(proposalPath)) {
+      log.warn(`${symbol.warn} "${name}" ${t("not found", "\u672A\u627E\u5230")}`);
+      return;
     }
-    for (const id of tasksFR) {
-      if (!specFR.includes(id)) {
-        issues.push({ level: "error", artifact: "tasks.md", message: `${id} referenced but not defined in spec` });
+    const content = readFileSync2(proposalPath, "utf-8");
+    const { meta } = parseFrontmatter(content);
+    const deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+    log.info(`${symbol.start} ${name}`);
+    if (deps2.length === 0) {
+      log.dim(`  ${t("no dependencies", "\u65E0\u4F9D\u8D56")}`);
+    } else {
+      for (const d of deps2) {
+        log.dim(`  \u2192 ${d}`);
       }
     }
+    return;
   }
-  if (spec) {
-    const acIds = extractIds(spec, /AC-\d+\.\d+/g);
-    const frIds = extractIds(spec, /FR-\d+/g);
-    for (const ac of acIds) {
-      const frNum = ac.replace("AC-", "").split(".")[0];
-      const parentFR = `FR-${frNum}`;
-      if (!frIds.includes(parentFR)) {
-        issues.push({ level: "warn", artifact: "spec.md", message: `${ac} has no parent ${parentFR}` });
-      }
+  if (!existsSync6(changesDir)) {
+    log.warn(`${symbol.warn} ${t("no changes directory", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
+    return;
+  }
+  const entries = readdirSync3(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 = join5(changesDir, entry.name, "proposal.md");
+    if (!existsSync6(proposalPath)) continue;
+    const content = readFileSync2(proposalPath, "utf-8");
+    const { meta } = parseFrontmatter(content);
+    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}`);
     }
   }
-  if (checkDeps && proposal) {
-    const { meta, body } = parseFrontmatter(proposal);
-    const fmDeps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
-    const contentRefs = extractIds(body, /depends[_ ]on[:\s]+(\S+)/gi);
-    const mentioned = contentRefs.map((m) => m.replace(/depends[_ ]on[:\s]+/i, ""));
-    for (const dep of mentioned) {
-      if (!fmDeps.includes(dep)) {
-        issues.push({ level: "warn", artifact: "proposal.md", message: `content mentions "${dep}" but not in frontmatter depends_on` });
-      }
+}
+
+// src/commands/init.ts
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync9, readdirSync as readdirSync5, writeFileSync as writeFileSync4 } from "fs";
+import { join as join8 } from "path";
+
+// src/core/template.ts
+import { copyFileSync, existsSync as existsSync7, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join6 } from "path";
+function resolveTemplatePath(templateName, lang = "zh") {
+  const root = getPackageRoot();
+  const langPath = join6(root, "templates", lang, templateName);
+  if (existsSync7(langPath)) return langPath;
+  const fallbackLang = lang === "zh" ? "en" : "zh";
+  const fallback = join6(root, "templates", fallbackLang, templateName);
+  if (existsSync7(fallback)) return fallback;
+  throw new Error(`Template not found: ${templateName} (lang: ${lang})`);
+}
+function copyTemplate(templateName, destPath, lang = "zh") {
+  const srcPath = resolveTemplatePath(templateName, lang);
+  ensureDir(dirname2(destPath));
+  copyFileSync(srcPath, destPath);
+}
+
+// src/prompts/index.ts
+import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7 } from "path";
+var AI_EDITORS = {
+  claude: {
+    commands: ".claude/commands",
+    rules: null
+    // Claude doesn't use rules files
+  },
+  cursor: {
+    commands: ".cursor/commands",
+    rules: ".cursor/rules",
+    rulesFile: "superspec.mdc"
+  },
+  qwen: {
+    commands: ".qwen/commands",
+    rules: ".qwen/rules",
+    rulesFile: "superspec.md"
+  },
+  opencode: {
+    commands: ".opencode/commands",
+    rules: null
+  },
+  codex: {
+    commands: ".codex/commands",
+    rules: null
+  },
+  codebuddy: {
+    commands: ".codebuddy/commands",
+    rules: ".codebuddy/rules",
+    rulesFile: "superspec.md"
+  },
+  qoder: {
+    commands: ".qoder/commands",
+    rules: ".qoder/rules",
+    rulesFile: "superspec.md"
+  }
+};
+function installRules(cwd, editor) {
+  const config = AI_EDITORS[editor];
+  if (!config.rules) {
+    return;
+  }
+  const rulesDir = join7(cwd, config.rules);
+  ensureDir(rulesDir);
+  const promptSrc = join7(getPackageRoot(), "prompts", "rules.md");
+  if (existsSync8(promptSrc)) {
+    const content = readFileSync4(promptSrc, "utf-8");
+    const rulesFile = "rulesFile" in config ? config.rulesFile : "superspec.md";
+    const destPath = join7(rulesDir, rulesFile);
+    writeFileSync3(destPath, content, "utf-8");
+    log.success(`${symbol.ok} ${config.rules}/${rulesFile}`);
+  }
+}
+var SS_START = "<!-- superspec:start -->";
+var SS_END = "<!-- superspec:end -->";
+function installAgentsMd(cwd) {
+  const agentsMdPath = join7(cwd, "AGENTS.md");
+  const agentPromptSrc = join7(getPackageRoot(), "prompts", "agents.md");
+  if (!existsSync8(agentPromptSrc)) return;
+  const newContent = readFileSync4(agentPromptSrc, "utf-8");
+  const wrapped = `${SS_START}
+${newContent}
+${SS_END}`;
+  if (existsSync8(agentsMdPath)) {
+    const existing = readFileSync4(agentsMdPath, "utf-8");
+    const startIdx = existing.indexOf(SS_START);
+    const endIdx = existing.indexOf(SS_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+      const before = existing.slice(0, startIdx);
+      const after = existing.slice(endIdx + SS_END.length);
+      writeFileSync3(agentsMdPath, before + wrapped + after, "utf-8");
+    } else if (existing.includes("SuperSpec")) {
+      writeFileSync3(agentsMdPath, existing, "utf-8");
+    } else {
+      writeFileSync3(agentsMdPath, `${existing}
+
+${wrapped}`, "utf-8");
     }
-    const changesDir = join11(changePath, "..");
-    for (const dep of fmDeps) {
-      if (!existsSync12(join11(changesDir, dep))) {
-        issues.push({ level: "error", artifact: "proposal.md", message: `depends_on "${dep}" not found in changes` });
-      }
+  } else {
+    writeFileSync3(agentsMdPath, wrapped, "utf-8");
+  }
+  log.success(`${symbol.ok} AGENTS.md`);
+}
+function installCommands(cwd, editor, lang = "zh") {
+  const config = AI_EDITORS[editor];
+  const commandsDir = join7(cwd, config.commands);
+  ensureDir(commandsDir);
+  const templatesDir = join7(getPackageRoot(), "templates", lang, "commands");
+  const fallbackDir = join7(getPackageRoot(), "templates", "zh", "commands");
+  const sourceDir = existsSync8(templatesDir) ? templatesDir : fallbackDir;
+  if (!existsSync8(sourceDir)) {
+    log.warn(`${symbol.warn} Commands templates not found: ${sourceDir}`);
+    return;
+  }
+  const commandFiles = readdirSync4(sourceDir).filter((f) => f.endsWith(".md"));
+  for (const file of commandFiles) {
+    const srcPath = join7(sourceDir, file);
+    const destPath = join7(commandsDir, file);
+    const content = readFileSync4(srcPath, "utf-8");
+    writeFileSync3(destPath, content, "utf-8");
+  }
+  log.success(`${symbol.ok} ${config.commands}/ (${commandFiles.length} commands)`);
+}
+
+// src/commands/init.ts
+async function initCommand(options) {
+  const cwd = process.cwd();
+  const configPath = join8(cwd, "superspec.config.json");
+  if (existsSync9(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();
+  config.lang = lang;
+  const aiEditor = options.ai;
+  if (aiEditor && AI_EDITORS[aiEditor]) {
+    config.aiEditor = aiEditor;
+  }
+  const specDir = join8(cwd, config.specDir);
+  const existingFiles = readdirSync5(cwd).filter((f) => !f.startsWith(".") && f !== "node_modules");
+  if (existingFiles.length > 0 && !options.force) {
+    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(t("Creating Configuration", "\u521B\u5EFA\u914D\u7F6E"));
+  writeFileSync4(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf-8");
+  log.success(`${symbol.file} superspec.config.json`);
+  log.section(t("Creating Directory Structure", "\u521B\u5EFA\u76EE\u5F55\u7ED3\u6784"));
+  ensureDir(join8(specDir, "changes"));
+  ensureDir(join8(specDir, "templates"));
+  log.success(`${symbol.folder} ${config.specDir}/changes/`);
+  log.success(`${symbol.folder} ${config.specDir}/templates/`);
+  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, join8(specDir, "templates", tpl), lang);
+    } catch {
     }
   }
-  return issues;
+  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);
+    installCommands(cwd, aiEditor, lang);
+  }
+  if (options.git !== false && !isGitRepo()) {
+    execSync2("git init", { cwd, stdio: "inherit" });
+    log.success(`${symbol.git} git init`);
+  }
+  console.log();
+  printSummary([
+    { label: "Config", value: "superspec.config.json" },
+    { label: "Spec dir", value: `${config.specDir}/` },
+    { label: "AI agent", value: options.ai },
+    { label: "Language", value: lang }
+  ]);
+  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/lint.ts
+import { existsSync as existsSync11 } from "fs";
+import { join as join10 } from "path";
+
+// src/core/lint.ts
+import { existsSync as existsSync10, readdirSync as readdirSync6, readFileSync as readFileSync5 } from "fs";
+import { basename, join as join9 } from "path";
+function lintArtifact(filePath, targetLines, hardLines) {
+  const artifact = basename(filePath);
+  if (!existsSync10(filePath)) {
+    return { artifact, lines: 0, status: "ok", message: "not found" };
+  }
+  const content = readFileSync5(filePath, "utf-8");
+  const lines = content.split("\n").length;
+  if (lines > hardLines) {
+    return {
+      artifact,
+      lines,
+      status: "error",
+      message: `${lines} lines exceeds hard limit (${hardLines}). Must split.`
+    };
+  }
+  if (lines > targetLines) {
+    return {
+      artifact,
+      lines,
+      status: "warn",
+      message: `${lines} lines exceeds target (${targetLines}). Consider splitting.`
+    };
+  }
+  return { artifact, lines, status: "ok", message: `${lines} lines` };
+}
+function lintChange(changePath, targetLines, hardLines) {
+  if (!existsSync10(changePath)) return [];
+  const files = readdirSync6(changePath).filter((f) => f.endsWith(".md"));
+  return files.map((f) => lintArtifact(join9(changePath, f), targetLines, hardLines));
 }
 
-// src/commands/validate.ts
-async function validateCommand(name, options) {
+// src/commands/lint.ts
+async function lintCommand(name) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
-  const changesDir = join12(cwd, config.specDir, "changes");
+  const changesDir = join10(cwd, config.specDir, "changes");
+  const { targetLines, hardLines } = config.limits;
   const names = resolveChangeNames(changesDir, name, config.archive.dir);
   if (names.length === 0) {
-    log.warn(`${symbol.warn} ${t("no changes to validate", "\u6CA1\u6709\u53EF\u9A8C\u8BC1\u7684\u53D8\u66F4")}`);
+    log.warn(`${symbol.warn} ${t("no changes to lint", "\u6CA1\u6709\u53EF\u68C0\u67E5\u7684\u53D8\u66F4")}`);
     return;
   }
-  let totalIssues = 0;
+  let hasIssues = false;
   for (const n of names) {
-    const changePath = join12(changesDir, n);
-    if (!existsSync13(changePath)) {
+    const changePath = join10(changesDir, n);
+    if (!existsSync11(changePath)) {
       log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
       continue;
     }
-    const issues = validateChange(changePath, options.checkDeps);
+    const results = lintChange(changePath, targetLines, hardLines);
     log.info(`${symbol.start} ${n}`);
-    if (issues.length === 0) {
-      log.success(`  ${symbol.ok} ${t("all checks passed", "\u6240\u6709\u68C0\u67E5\u901A\u8FC7")}`);
-    } else {
-      for (const issue of issues) {
-        totalIssues++;
-        if (issue.level === "error") {
-          log.error(`  ${symbol.fail} [${issue.artifact}] ${issue.message}`);
-        } else if (issue.level === "warn") {
-          log.warn(`  ${symbol.warn} [${issue.artifact}] ${issue.message}`);
-        } else {
-          log.dim(`  \u2139 [${issue.artifact}] ${issue.message}`);
-        }
+    for (const r of results) {
+      if (r.status === "error") {
+        log.error(`  ${symbol.fail} ${r.artifact}: ${r.message}`);
+        hasIssues = true;
+      } else if (r.status === "warn") {
+        log.warn(`  ${symbol.warn} ${r.artifact}: ${r.message}`);
+        hasIssues = true;
+      } else {
+        log.success(`  ${symbol.ok} ${r.artifact}: ${r.message}`);
       }
     }
   }
-  if (totalIssues === 0) {
-    log.success(`${symbol.ok} ${t("all validations passed", "\u6240\u6709\u9A8C\u8BC1\u901A\u8FC7")}`);
-  } else {
-    log.warn(`${symbol.warn} ${totalIssues} ${t("issue(s) found", "\u4E2A\u95EE\u9898")}`);
+  if (!hasIssues) {
+    log.info(`${symbol.start} ${t("all artifacts within limits", "\u6240\u6709 artifact \u5747\u5728\u9650\u5236\u8303\u56F4\u5185")}`);
   }
 }
 
 // src/commands/search.ts
-import { existsSync as existsSync14, readFileSync as readFileSync6, readdirSync as readdirSync7 } from "fs";
-import { join as join13, basename as basename3 } from "path";
+import { existsSync as existsSync12, readdirSync as readdirSync7, readFileSync as readFileSync6 } from "fs";
+import { basename as basename2, join as join11 } 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 (!existsSync14(changesDir)) {
+  const changesDir = join11(cwd, config.specDir, "changes");
+  if (!existsSync12(changesDir)) {
     log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
   const dirs = [];
-  const activeEntries = readdirSync7(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) });
+    dirs.push({ name: e.name, path: join11(changesDir, e.name) });
   }
   if (options.archived) {
-    const archiveDir = join13(changesDir, config.archive.dir);
-    if (existsSync14(archiveDir)) {
-      const archivedEntries = readdirSync7(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+    const archiveDir = join11(changesDir, config.archive.dir);
+    if (existsSync12(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) });
+        dirs.push({ name: `${config.archive.dir}/${e.name}`, path: join11(archiveDir, e.name) });
       }
     }
   }
@@ -940,14 +861,14 @@ async function searchCommand(query, options) {
   }
   const hits = [];
   for (const dir of dirs) {
-    if (!existsSync14(dir.path)) continue;
+    if (!existsSync12(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");
+        const artType = basename2(file, ".md");
         if (artType !== options.artifact) continue;
       }
-      const filePath = join13(dir.path, file);
+      const filePath = join11(dir.path, file);
       const content = readFileSync6(filePath, "utf-8");
       const lines = content.split("\n");
       for (let i = 0; i < lines.length; i++) {
@@ -973,90 +894,20 @@ async function searchCommand(query, options) {
     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/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 depsAddCommand(name, options) {
-  const cwd = process.cwd();
-  const config = loadConfig(cwd);
-  const proposalPath = join14(cwd, config.specDir, "changes", name, "proposal.md");
-  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.on);
-  writeFileSync4(proposalPath, updated, "utf-8");
-  log.success(`${symbol.ok} ${name} \u2192 depends_on: ${options.on}`);
-}
-async function depsRemoveCommand(name, options) {
-  const cwd = process.cwd();
-  const config = loadConfig(cwd);
-  const proposalPath = join14(cwd, config.specDir, "changes", name, "proposal.md");
-  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.on);
-  writeFileSync4(proposalPath, updated, "utf-8");
-  log.success(`${symbol.ok} ${name} \u2192 ${t("removed dependency", "\u79FB\u9664\u4F9D\u8D56")}: ${options.on}`);
-}
-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 (!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 deps2 = Array.isArray(meta.depends_on) ? meta.depends_on : [];
-    log.info(`${symbol.start} ${name}`);
-    if (deps2.length === 0) {
-      log.dim(`  ${t("no dependencies", "\u65E0\u4F9D\u8D56")}`);
-    } else {
-      for (const d of deps2) {
-        log.dim(`  \u2192 ${d}`);
-      }
-    }
-    return;
-  }
-  if (!existsSync15(changesDir)) {
-    log.warn(`${symbol.warn} ${t("no changes directory", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
-    return;
-  }
-  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 (!existsSync15(proposalPath)) continue;
-    const content = readFileSync7(proposalPath, "utf-8");
-    const { meta } = parseFrontmatter(content);
-    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}`);
-    }
+    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/status.ts
-import { existsSync as existsSync16, readFileSync as readFileSync8, readdirSync as readdirSync9 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync13, readdirSync as readdirSync8, readFileSync as readFileSync7 } from "fs";
+import { join as join12 } from "path";
 var ARTIFACT_TYPES = ["proposal", "spec", "tasks", "clarify", "checklist"];
 function readStatus(changePath, artifact) {
-  const filePath = join15(changePath, `${artifact}.md`);
-  if (!existsSync16(filePath)) return "\u2014";
-  const content = readFileSync8(filePath, "utf-8");
+  const filePath = join12(changePath, `${artifact}.md`);
+  if (!existsSync13(filePath)) return "\u2014";
+  const content = readFileSync7(filePath, "utf-8");
   const { meta } = parseFrontmatter(content);
   if (meta.status) return meta.status;
   if (content.includes("\u2705")) return "done";
@@ -1079,12 +930,12 @@ function overallStatus(statuses) {
 async function statusCommand() {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
-  const changesDir = join15(cwd, config.specDir, "changes");
-  if (!existsSync16(changesDir)) {
+  const changesDir = join12(cwd, config.specDir, "changes");
+  if (!existsSync13(changesDir)) {
     log.warn(`${symbol.warn} ${t("no changes directory found", "\u672A\u627E\u5230 changes \u76EE\u5F55")}`);
     return;
   }
-  const entries = readdirSync9(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir).sort((a, b) => a.name.localeCompare(b.name));
+  const entries = readdirSync8(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(`  ${t("no active changes", "\u65E0\u6D3B\u8DC3\u53D8\u66F4")}`);
     return;
@@ -1092,7 +943,7 @@ async function statusCommand() {
   const header = ["Change", ...ARTIFACT_TYPES.map((a) => a.slice(0, 8).padEnd(8)), "Status"];
   const rows = [];
   for (const entry of entries) {
-    const changePath = join15(changesDir, entry.name);
+    const changePath = join12(changesDir, entry.name);
     const statuses = {};
     for (const art of ARTIFACT_TYPES) {
       statuses[art] = readStatus(changePath, art);
@@ -1115,9 +966,11 @@ async function statusCommand() {
   for (const row of rows) {
     console.log(formatRow(row));
   }
-  const archiveDir = join15(changesDir, config.archive.dir);
-  if (existsSync16(archiveDir)) {
-    const archived = readdirSync9(archiveDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+  const archiveDir = join12(changesDir, config.archive.dir);
+  if (existsSync13(archiveDir)) {
+    const archived = readdirSync8(archiveDir, { withFileTypes: true }).filter(
+      (e) => e.isDirectory()
+    );
     if (archived.length > 0) {
       log.dim(`
   ${archived.length} ${t("archived change(s)", "\u4E2A\u5DF2\u5F52\u6863\u53D8\u66F4")}`);
@@ -1127,16 +980,18 @@ async function statusCommand() {
 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));
+  const changesDir = join12(cwd, config.specDir, "changes");
+  if (!existsSync13(changesDir)) return;
+  const entries = readdirSync8(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());
+    const archiveDir = join12(changesDir, config.archive.dir);
+    if (existsSync13(archiveDir)) {
+      const archived = readdirSync8(archiveDir, { withFileTypes: true }).filter(
+        (e) => e.isDirectory()
+      );
       for (const e of archived) {
         console.log(`${config.archive.dir}/${e.name}`);
       }
@@ -1144,18 +999,18 @@ async function listCommand(options) {
   }
 }
 function stripAnsi(str) {
-  return str.replace(/\u001b\[\d+(?:;\d+)*m/g, "").replace(/[✅🟢🟡—]/g, "XX");
+  return str.replace(/\u001b\[\d+(?:;\d+)*m/g, "").replace(/[✅🟢🟡—]/gu, "XX");
 }
 
 // src/commands/sync.ts
-import { existsSync as existsSync18, writeFileSync as writeFileSync5 } from "fs";
-import { join as join17 } from "path";
+import { existsSync as existsSync15, writeFileSync as writeFileSync5 } from "fs";
+import { join as join14 } from "path";
 
 // src/core/context.ts
-import { readFileSync as readFileSync9, existsSync as existsSync17 } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync8 } from "fs";
+import { join as join13 } from "path";
 function extractSection(body, heading) {
-  const regex = new RegExp(`^##\\s+${heading}[\\s\\S]*?$`, "im");
+  const regex = new RegExp(`^##\\s+(?:${heading})[\\s\\S]*?$`, "im");
   const match = body.match(regex);
   if (!match) return [];
   const startIdx = body.indexOf(match[0]) + match[0].length;
@@ -1189,12 +1044,13 @@ function parseTaskItems(body) {
 function extractFilePaths(body) {
   const paths = /* @__PURE__ */ new Set();
   const regex = /`([^`]+\.[a-zA-Z]+)`/g;
-  let match;
-  while ((match = regex.exec(body)) !== null) {
+  let match = regex.exec(body);
+  while (match !== null) {
     const p = match[1];
     if (p.includes("/") && !p.startsWith("http") && !p.includes(" ")) {
       paths.add(p);
     }
+    match = regex.exec(body);
   }
   return [...paths];
 }
@@ -1231,21 +1087,17 @@ function classifyGitChanges(gitChanges, taskFiles) {
 }
 function generateContext(changePath, changeName, options = {}) {
   const read = (name) => {
-    const p = join16(changePath, name);
-    return existsSync17(p) ? readFileSync9(p, "utf-8") : null;
+    const p = join13(changePath, name);
+    return existsSync14(p) ? readFileSync8(p, "utf-8") : null;
   };
   const proposal = read("proposal.md");
   const spec = read("spec.md");
   const tasks = read("tasks.md");
   const clarify = read("clarify.md");
-  let strategy = "follow";
-  let status = "in-progress";
   const mode = spec ? "boost" : "standard";
-  if (proposal) {
-    const { meta } = parseFrontmatter(proposal);
-    if (meta.strategy) strategy = meta.strategy;
-    if (meta.status) status = meta.status;
-  }
+  const proposalMeta = proposal ? parseFrontmatter(proposal).meta : {};
+  const strategy = proposalMeta.strategy || "follow";
+  const status = proposalMeta.status || "in-progress";
   const goals = [];
   if (proposal) {
     const { body } = parseFrontmatter(proposal);
@@ -1276,13 +1128,15 @@ function generateContext(changePath, changeName, options = {}) {
       notes = notesSection.join("\n");
     }
   }
-  const fm = serializeFrontmatter({
+  const fmData = {
     name: changeName,
     status,
     strategy,
     mode,
     updated: getDateString()
-  });
+  };
+  if (proposalMeta.input) fmData.input = proposalMeta.input;
+  const fm = serializeFrontmatter(fmData);
   const lines = [fm, ""];
   if (goals.length > 0) {
     lines.push("## Goals", ...goals, "");
@@ -1320,7 +1174,7 @@ function generateContext(changePath, changeName, options = {}) {
 async function syncCommand(name, opts) {
   const cwd = process.cwd();
   const config = loadConfig(cwd);
-  const changesDir = join17(cwd, config.specDir, "changes");
+  const changesDir = join14(cwd, config.specDir, "changes");
   const names = resolveChangeNames(changesDir, name, config.archive.dir);
   if (names.length === 0) {
     log.warn(`${symbol.warn} ${t("no changes found", "\u672A\u627E\u5230\u53D8\u66F4")}`);
@@ -1328,8 +1182,8 @@ async function syncCommand(name, opts) {
   }
   const useGit = opts.git !== false;
   for (const n of names) {
-    const changePath = join17(changesDir, n);
-    if (!existsSync18(changePath)) {
+    const changePath = join14(changesDir, n);
+    if (!existsSync15(changePath)) {
       log.warn(`${symbol.warn} "${n}" ${t("not found", "\u672A\u627E\u5230")}`);
       continue;
     }
@@ -1337,30 +1191,256 @@ async function syncCommand(name, opts) {
       gitDiff: useGit,
       baseBranch: opts.base
     });
-    const destPath = join17(changePath, "context.md");
+    const destPath = join14(changePath, "context.md");
     writeFileSync5(destPath, content, "utf-8");
     log.success(`${symbol.ok} ${t("synced", "\u5DF2\u540C\u6B65")} ${n}/context.md`);
   }
 }
 
+// src/commands/update.ts
+import { existsSync as existsSync16 } from "fs";
+import { join as join15 } from "path";
+async function updateCommand() {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const specDir = join15(cwd, config.specDir);
+  const lang = config.lang || "zh";
+  if (!existsSync16(join15(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} ${t("updating SuperSpec...", "\u66F4\u65B0 SuperSpec...")}`);
+  const templateNames = Object.values(config.templates).map(
+    (v) => v.endsWith(".md") ? v : `${v}.md`
+  );
+  ensureDir(join15(specDir, "templates"));
+  for (const tpl of templateNames) {
+    try {
+      copyTemplate(tpl, join15(specDir, "templates", tpl), lang);
+    } catch {
+    }
+  }
+  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} ${t("update done!", "\u66F4\u65B0\u5B8C\u6210\uFF01")}`);
+}
+
+// src/commands/validate.ts
+import { existsSync as existsSync18 } from "fs";
+import { join as join17 } from "path";
+
+// src/core/validate.ts
+import { existsSync as existsSync17, readFileSync as readFileSync9 } from "fs";
+import { join as join16 } from "path";
+function extractIds(content, pattern) {
+  const matches = content.match(pattern);
+  return matches ? [...new Set(matches)] : [];
+}
+function validateChange(changePath, checkDeps = false) {
+  const issues = [];
+  const read = (name) => {
+    const p = join16(changePath, name);
+    return existsSync17(p) ? readFileSync9(p, "utf-8") : null;
+  };
+  const proposal = read("proposal.md");
+  const spec = read("spec.md");
+  const tasks = read("tasks.md");
+  if (!proposal) issues.push({ level: "warn", artifact: "proposal.md", message: "missing" });
+  if (!tasks) issues.push({ level: "warn", artifact: "tasks.md", message: "missing" });
+  if (proposal && spec) {
+    const proposalGoals = extractIds(proposal, /US-\d+/g);
+    const specUS = extractIds(spec, /US-\d+/g);
+    for (const id of proposalGoals) {
+      if (!specUS.includes(id)) {
+        issues.push({
+          level: "error",
+          artifact: "spec.md",
+          message: `${id} from proposal not found in spec`
+        });
+      }
+    }
+  }
+  if (spec && tasks) {
+    const specFR = extractIds(spec, /FR-\d+/g);
+    const tasksFR = extractIds(tasks, /FR-\d+/g);
+    for (const id of specFR) {
+      if (!tasksFR.includes(id)) {
+        issues.push({
+          level: "warn",
+          artifact: "tasks.md",
+          message: `${id} from spec not referenced in tasks`
+        });
+      }
+    }
+    for (const id of tasksFR) {
+      if (!specFR.includes(id)) {
+        issues.push({
+          level: "error",
+          artifact: "tasks.md",
+          message: `${id} referenced but not defined in spec`
+        });
+      }
+    }
+  }
+  if (spec) {
+    const acIds = extractIds(spec, /AC-\d+\.\d+/g);
+    const frIds = extractIds(spec, /FR-\d+/g);
+    for (const ac of acIds) {
+      const frNum = ac.replace("AC-", "").split(".")[0];
+      const parentFR = `FR-${frNum}`;
+      if (!frIds.includes(parentFR)) {
+        issues.push({
+          level: "warn",
+          artifact: "spec.md",
+          message: `${ac} has no parent ${parentFR}`
+        });
+      }
+    }
+  }
+  if (checkDeps && proposal) {
+    const { meta, body } = parseFrontmatter(proposal);
+    const fmDeps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+    const contentRefs = extractIds(body, /depends[_ ]on[:\s]+(\S+)/gi);
+    const mentioned = contentRefs.map((m) => m.replace(/depends[_ ]on[:\s]+/i, ""));
+    for (const dep of mentioned) {
+      if (!fmDeps.includes(dep)) {
+        issues.push({
+          level: "warn",
+          artifact: "proposal.md",
+          message: `content mentions "${dep}" but not in frontmatter depends_on`
+        });
+      }
+    }
+    const changesDir = join16(changePath, "..");
+    for (const dep of fmDeps) {
+      if (!existsSync17(join16(changesDir, dep))) {
+        issues.push({
+          level: "error",
+          artifact: "proposal.md",
+          message: `depends_on "${dep}" not found in changes`
+        });
+      }
+    }
+  }
+  return issues;
+}
+
+// src/commands/validate.ts
+async function validateCommand(name, options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const changesDir = join17(cwd, config.specDir, "changes");
+  const names = resolveChangeNames(changesDir, name, config.archive.dir);
+  if (names.length === 0) {
+    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 = join17(changesDir, n);
+    if (!existsSync18(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} ${t("all checks passed", "\u6240\u6709\u68C0\u67E5\u901A\u8FC7")}`);
+    } else {
+      for (const issue of issues) {
+        totalIssues++;
+        if (issue.level === "error") {
+          log.error(`  ${symbol.fail} [${issue.artifact}] ${issue.message}`);
+        } else if (issue.level === "warn") {
+          log.warn(`  ${symbol.warn} [${issue.artifact}] ${issue.message}`);
+        } else {
+          log.dim(`  \u2139 [${issue.artifact}] ${issue.message}`);
+        }
+      }
+    }
+  }
+  if (totalIssues === 0) {
+    log.success(`${symbol.ok} ${t("all validations passed", "\u6240\u6709\u9A8C\u8BC1\u901A\u8FC7")}`);
+  } else {
+    log.warn(`${symbol.warn} ${totalIssues} ${t("issue(s) found", "\u4E2A\u95EE\u9898")}`);
+  }
+}
+
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
 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 <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.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 <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 + design + checklist",
+    "\u589E\u5F3A\u6A21\u5F0F\uFF0C\u989D\u5916\u751F\u6210 spec + design + 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)")).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);
+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("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.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