@superspec/cli 1.0.0

package/dist/cli/index.js

@@ -0,0 +1,1329 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+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 { join as join5 } from "path";
+import { execSync as execSync2 } from "child_process";
+
+// src/core/config.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+var DEFAULT_CONFIG = {
+  lang: "zh",
+  aiEditor: "cursor",
+  specDir: "superspec",
+  branchPrefix: "spec/",
+  branchTemplate: "{prefix}{name}",
+  boost: false,
+  strategy: "follow",
+  context: [],
+  templates: {
+    spec: "spec.md",
+    proposal: "proposal.md",
+    tasks: "tasks.md",
+    clarify: "clarify.md",
+    checklist: "checklist.md"
+  },
+  archive: {
+    dir: "archive",
+    datePrefix: true
+  },
+  limits: {
+    targetLines: 300,
+    hardLines: 400
+  },
+  artifacts: ["proposal"],
+  boostArtifacts: ["proposal", "spec", "tasks", "checklist"]
+};
+function loadConfig(projectRoot = process.cwd()) {
+  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}`);
+    }
+  }
+  return deepMerge(DEFAULT_CONFIG, userConfig);
+}
+function getDefaultConfig() {
+  return structuredClone(DEFAULT_CONFIG);
+}
+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]);
+    } else {
+      result[key] = source[key];
+    }
+  }
+  return result;
+}
+
+// src/core/template.ts
+import { existsSync as existsSync3, 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 { fileURLToPath } from "url";
+function getPackageRoot() {
+  const __filename2 = fileURLToPath(import.meta.url);
+  const __dirname2 = dirname(__filename2);
+  return join2(__dirname2, "..", "..");
+}
+
+// src/utils/fs.ts
+import { mkdirSync, existsSync as existsSync2 } from "fs";
+function ensureDir(dir) {
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+// 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;
+  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";
+function isGitRepo() {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" });
+    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" });
+}
+function getDefaultBranch() {
+  try {
+    const ref = execSync("git symbolic-ref refs/remotes/origin/HEAD", { encoding: "utf-8" }).trim();
+    return ref.replace("refs/remotes/origin/", "");
+  } catch {
+    try {
+      execSync("git rev-parse --verify main", { stdio: "ignore" });
+      return "main";
+    } catch {
+      return "master";
+    }
+  }
+}
+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();
+    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 existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync } from "fs";
+import { join as join4 } from "path";
+
+// src/ui/index.ts
+import chalk from "chalk";
+var theme = {
+  primary: chalk.hex("#6366f1"),
+  success: chalk.hex("#22c55e"),
+  warning: chalk.hex("#f59e0b"),
+  error: chalk.hex("#ef4444"),
+  info: chalk.hex("#3b82f6"),
+  boost: chalk.hex("#a855f7"),
+  dim: chalk.hex("#6b7280"),
+  highlight: chalk.hex("#f472b6"),
+  border: chalk.hex("#374151"),
+  gradient1: chalk.hex("#818cf8"),
+  gradient2: chalk.hex("#6366f1"),
+  gradient3: chalk.hex("#4f46e5")
+};
+var logo = {
+  small: `
+${theme.gradient1("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${theme.gradient2("   \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")}
+${theme.gradient3("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     ")}
+${theme.gradient2("   \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     ")}
+${theme.gradient1("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${theme.gradient1("   \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D")}
+  `,
+  tiny: `
+${theme.gradient1("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${theme.gradient2("   \u255A\u2550\u2550\u2550\u2550\u2550\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2550\u2550\u2550\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")}
+${theme.gradient3("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     ")}  ${theme.highlight("Spec-Driven Development")}
+${theme.gradient2("   \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     ")}
+${theme.gradient1("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${theme.gradient1("   \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D")}
+  `
+};
+var box = {
+  topLeft: "\u256D",
+  topRight: "\u256E",
+  bottomLeft: "\u2570",
+  bottomRight: "\u256F",
+  horizontal: "\u2500",
+  vertical: "\u2502"
+};
+function boxText(text, width = 50) {
+  const padding = " ".repeat(Math.max(0, width - text.length - 4));
+  return `${theme.border(box.vertical)} ${theme.highlight(text)}${padding} ${theme.border(box.vertical)}`;
+}
+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 middle = lines.map((line) => boxText(line, width));
+  return [top, ...middle, bottom].join("\n");
+}
+var log = {
+  info: (msg) => console.log(theme.info(msg)),
+  success: (msg) => console.log(theme.success(msg)),
+  warn: (msg) => console.log(theme.warning(msg)),
+  error: (msg) => console.log(theme.error(msg)),
+  dim: (msg) => console.log(theme.dim(msg)),
+  boost: (msg) => console.log(theme.boost(msg)),
+  highlight: (msg) => console.log(theme.highlight(msg)),
+  title: (msg) => {
+    console.log();
+    console.log(createBox([msg]));
+    console.log();
+  },
+  section: (msg) => {
+    console.log();
+    console.log(theme.primary(`\u25C6 ${msg}`));
+    console.log(theme.border("\u2500".repeat(50)));
+  },
+  done: (msg) => {
+    console.log();
+    console.log(theme.success(`\u2728 ${msg}`));
+    console.log();
+  }
+};
+var symbol = {
+  start: theme.primary("\u25C6"),
+  ok: theme.success("\u2713"),
+  fail: theme.error("\u2717"),
+  warn: theme.warning("\u26A0"),
+  bolt: theme.boost("\u26A1"),
+  arrow: theme.dim("\u2192"),
+  bullet: theme.dim("\u2022"),
+  sparkle: theme.highlight("\u2728"),
+  folder: theme.primary("\u{1F4C1}"),
+  file: theme.info("\u{1F4C4}"),
+  git: theme.warning("\u{1F33F}"),
+  ai: theme.boost("\u{1F916}")
+};
+function printLogo(size = "small") {
+  console.log(logo[size]);
+}
+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"));
+  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 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"));
+}
+
+// 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"
+  }
+};
+function installRules(cwd, editor) {
+  const config = AI_EDITORS[editor];
+  if (!config.rules) {
+    return;
+  }
+  const rulesDir = join4(cwd, config.rules);
+  ensureDir(rulesDir);
+  const promptSrc = join4(getPackageRoot(), "prompts", "cursor-rules.md");
+  if (existsSync4(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 (!existsSync4(agentPromptSrc)) return;
+  const newContent = readFileSync3(agentPromptSrc, "utf-8");
+  const wrapped = `${SS_START}
+${newContent}
+${SS_END}`;
+  if (existsSync4(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");
+    }
+  } else {
+    writeFileSync2(agentsMdPath, wrapped, "utf-8");
+  }
+  log.success(`${symbol.ok} AGENTS.md`);
+}
+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 = existsSync4(templatesDir) ? templatesDir : fallbackDir;
+  if (!existsSync4(sourceDir)) {
+    log.warn(`${symbol.warn} Commands templates not found: ${sourceDir}`);
+    return;
+  }
+  const commandFiles = readdirSync(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)`);
+}
+
+// src/commands/init.ts
+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`);
+    return;
+  }
+  const lang = options.lang || "zh";
+  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 = join5(cwd, config.specDir);
+  const existingFiles = readdirSync2(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");
+    console.log();
+  }
+  log.section("Creating Configuration");
+  writeFileSync3(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  log.success(`${symbol.file} superspec.config.json`);
+  log.section("Creating Directory Structure");
+  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.success(`${symbol.ok} ${templates.length} templates (${lang})`);
+  log.section("Installing AI Agent Files");
+  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("SuperSpec initialized successfully!");
+  log.dim("Next: Run superspec create <name> to create a change");
+}
+
+// src/commands/create.ts
+import { existsSync as existsSync6 } 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/commands/create.ts
+async function createCommand(name, 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}`);
+    return;
+  }
+  log.title(`Creating Change: ${name}`);
+  if (boost) {
+    log.boost(`${symbol.bolt} Boost mode enabled`);
+  }
+  if (strategy === "create") {
+    log.boost(`${symbol.bolt} Creative mode: exploring new solutions`);
+  }
+  ensureDir(changePath);
+  const vars = {
+    name,
+    date: getDateString(),
+    boost: boost ? "true" : "false",
+    strategy,
+    description
+  };
+  const artifacts = boost ? config.boostArtifacts : config.artifacts;
+  log.section("Generating 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 = config.branchTemplate || "{prefix}{name}";
+    const branchName = branchTemplate.replace("{prefix}", branchPrefix).replace("{name}", name);
+    try {
+      createBranch(branchName);
+      log.success(`${symbol.ok} Branch: ${branchName}`);
+    } catch (e) {
+      log.warn(`${symbol.warn} Branch creation failed: ${e.message}`);
+    }
+  }
+  log.done("Change created successfully!");
+  log.dim(`Path: ${specDir}/changes/${name}/`);
+  if (boost) {
+    log.dim(`Workflow: /ss-create \u2192 /ss-tasks \u2192 /ss-apply (boost)`);
+  } else {
+    log.dim(`Workflow: /ss-tasks \u2192 /ss-apply`);
+  }
+}
+
+// src/commands/archive.ts
+import { existsSync as existsSync7, readdirSync as readdirSync3, 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`);
+    return;
+  }
+  if (options.all) {
+    const entries = readdirSync3(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`);
+      return;
+    }
+    log.info(`${symbol.start} \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`);
+      return;
+    }
+    log.info(`${symbol.start} \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`);
+    return;
+  }
+  log.info(`${symbol.start} \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}`);
+    return;
+  }
+  renameSync(src, dest);
+  log.success(`  ${symbol.ok} ${name} \u2192 archive/${dateStr}${name}`);
+}
+
+// src/commands/update.ts
+import { existsSync as existsSync8 } 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`);
+    return;
+  }
+  log.info(`${symbol.start} \u66F4\u65B0 SuperSpec...`);
+  const templates = ["spec.md", "proposal.md", "tasks.md", "clarify.md", "checklist.md"];
+  ensureDir(join8(specDir, "templates"));
+  for (const tpl of templates) {
+    copyTemplate(tpl, join8(specDir, "templates", tpl), lang);
+  }
+  log.success(`  ${symbol.ok} \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`);
+}
+
+// src/commands/lint.ts
+import { existsSync as existsSync10, readdirSync as readdirSync5 } 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 { join as join9, basename } from "path";
+function lintArtifact(filePath, targetLines, hardLines) {
+  const artifact = basename(filePath);
+  if (!existsSync9(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 (!existsSync9(changePath)) return [];
+  const files = readdirSync4(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;
+  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));
+  }
+  if (names.length === 0) {
+    log.warn(`${symbol.warn} no changes to lint`);
+    return;
+  }
+  let hasIssues = false;
+  for (const n of names) {
+    const changePath = join10(changesDir, n);
+    if (!existsSync10(changePath)) {
+      log.warn(`${symbol.warn} "${n}" not found`);
+      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} all artifacts within limits`);
+  }
+}
+
+// src/commands/validate.ts
+import { existsSync as existsSync12, readdirSync as readdirSync7 } from "fs";
+import { join as join12 } from "path";
+
+// src/core/validate.ts
+import { readFileSync as readFileSync5, existsSync as existsSync11 } from "fs";
+import { join as join11 } from "path";
+
+// src/core/frontmatter.ts
+var FM_REGEX = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+function parseFrontmatter(content) {
+  const match = content.match(FM_REGEX);
+  if (!match) {
+    return { meta: {}, body: content };
+  }
+  const meta = {};
+  const lines = match[1].split("\n");
+  for (const line of lines) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    let value = line.slice(idx + 1).trim();
+    if (value === "[]") {
+      value = [];
+    } else if (value.startsWith("[") && value.endsWith("]")) {
+      value = value.slice(1, -1).split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+    } else if (value === "true") {
+      value = true;
+    } else if (value === "false") {
+      value = false;
+    }
+    meta[key] = value;
+  }
+  return { meta, body: match[2] };
+}
+function serializeFrontmatter(meta) {
+  const lines = ["---"];
+  for (const [key, value] of Object.entries(meta)) {
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        lines.push(`${key}: []`);
+      } else {
+        lines.push(`${key}: [${value.map((v) => `"${v}"`).join(", ")}]`);
+      }
+    } else {
+      lines.push(`${key}: ${value}`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+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);
+  }
+  meta.depends_on = deps;
+  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);
+  return serializeFrontmatter(meta) + "\n" + body;
+}
+
+// src/core/validate.ts
+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 = join11(changePath, name);
+    return existsSync11(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` });
+      }
+    }
+  }
+  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 = join11(changePath, "..");
+    for (const dep of fmDeps) {
+      if (!existsSync11(join11(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 = 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));
+  }
+  if (names.length === 0) {
+    log.warn(`${symbol.warn} no changes to validate`);
+    return;
+  }
+  let totalIssues = 0;
+  for (const n of names) {
+    const changePath = join12(changesDir, n);
+    if (!existsSync12(changePath)) {
+      log.warn(`${symbol.warn} "${n}" not found`);
+      continue;
+    }
+    const issues = validateChange(changePath, options.checkDeps);
+    log.info(`${symbol.start} ${n}`);
+    if (issues.length === 0) {
+      log.success(`  ${symbol.ok} all checks passed`);
+    } 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} all validations passed`);
+  } else {
+    log.warn(`${symbol.warn} ${totalIssues} issue(s) found`);
+  }
+}
+
+// src/commands/search.ts
+import { existsSync as existsSync13, readFileSync as readFileSync6, readdirSync as readdirSync8 } from "fs";
+import { join as join13, basename as basename3 } from "path";
+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`);
+    return;
+  }
+  const dirs = [];
+  const activeEntries = readdirSync8(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());
+      for (const e of archivedEntries) {
+        dirs.push({ name: `${config.archive.dir}/${e.name}`, path: join13(archiveDir, e.name) });
+      }
+    }
+  }
+  const queryLower = query.toLowerCase();
+  const hits = [];
+  for (const dir of dirs) {
+    if (!existsSync13(dir.path)) continue;
+    const files = readdirSync8(dir.path).filter((f) => f.endsWith(".md"));
+    for (const file of files) {
+      if (options.artifact) {
+        const artType = basename3(file, ".md");
+        if (artType !== options.artifact) continue;
+      }
+      const filePath = join13(dir.path, file);
+      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)) {
+          hits.push({
+            change: dir.name,
+            artifact: file,
+            line: i + 1,
+            text: lines[i].trim()
+          });
+        }
+      }
+    }
+  }
+  if (hits.length === 0) {
+    log.warn(`${symbol.warn} no results for "${query}"`);
+    return;
+  }
+  log.info(`${symbol.start} ${hits.length} result(s) for "${query}"`);
+  for (const hit of hits) {
+    log.dim(`  ${hit.change}/${hit.artifact}:${hit.line}  ${hit.text}`);
+  }
+}
+
+// src/commands/link.ts
+import { existsSync as existsSync14, readFileSync as readFileSync7, writeFileSync as writeFileSync4, readdirSync as readdirSync9 } from "fs";
+import { join as join14 } from "path";
+async function linkCommand(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`);
+    return;
+  }
+  const content = readFileSync7(proposalPath, "utf-8");
+  const updated = addDependency(content, options.dependsOn);
+  writeFileSync4(proposalPath, updated, "utf-8");
+  log.success(`${symbol.ok} ${name} \u2192 depends_on: ${options.dependsOn}`);
+}
+async function unlinkCommand(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`);
+    return;
+  }
+  const content = readFileSync7(proposalPath, "utf-8");
+  const updated = removeDependency(content, options.dependsOn);
+  writeFileSync4(proposalPath, updated, "utf-8");
+  log.success(`${symbol.ok} ${name} \u2192 removed dependency: ${options.dependsOn}`);
+}
+async function depsCommand(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`);
+      return;
+    }
+    const content = readFileSync7(proposalPath, "utf-8");
+    const { meta } = parseFrontmatter(content);
+    const deps = Array.isArray(meta.depends_on) ? meta.depends_on : [];
+    log.info(`${symbol.start} ${name}`);
+    if (deps.length === 0) {
+      log.dim("  no dependencies");
+    } else {
+      for (const d of deps) {
+        log.dim(`  \u2192 ${d}`);
+      }
+    }
+    return;
+  }
+  if (!existsSync14(changesDir)) {
+    log.warn(`${symbol.warn} no changes directory`);
+    return;
+  }
+  const entries = readdirSync9(changesDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name !== config.archive.dir);
+  log.info(`${symbol.start} dependency graph`);
+  for (const entry of entries) {
+    const proposalPath = join14(changesDir, entry.name, "proposal.md");
+    if (!existsSync14(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(", ")}]`);
+    } else {
+      log.dim(`  ${entry.name}`);
+    }
+  }
+}
+
+// src/commands/status.ts
+import { existsSync as existsSync15, readFileSync as readFileSync8, readdirSync as readdirSync10 } 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";
+  const content = readFileSync8(filePath, "utf-8");
+  const { meta } = parseFrontmatter(content);
+  if (meta.status) return meta.status;
+  if (content.includes("\u2705")) return "done";
+  if (content.includes("\u{1F7E2}")) return "ready";
+  return "draft";
+}
+function statusIcon(s) {
+  if (s === "\u2014") return "\u2014";
+  if (s === "done" || s === "complete") return "\u2705";
+  if (s === "ready") return "\u{1F7E2}";
+  return "\u{1F7E1}";
+}
+function overallStatus(statuses) {
+  const vals = Object.values(statuses).filter((v) => v !== "\u2014");
+  if (vals.length === 0) return "empty";
+  if (vals.every((v) => v === "done" || v === "complete")) return "\u2705 Done";
+  if (vals.every((v) => v === "ready" || v === "done" || v === "complete")) return "\u{1F7E2} Ready";
+  return "\u{1F7E1} Draft";
+}
+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`);
+    return;
+  }
+  const entries = readdirSync10(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");
+    return;
+  }
+  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 statuses = {};
+    for (const art of ARTIFACT_TYPES) {
+      statuses[art] = readStatus(changePath, art);
+    }
+    rows.push([
+      entry.name,
+      ...ARTIFACT_TYPES.map((a) => statusIcon(statuses[a])),
+      overallStatus(statuses)
+    ]);
+  }
+  const colWidths = header.map((h, i) => {
+    const maxData = rows.reduce((max, row) => Math.max(max, stripAnsi(row[i]).length), 0);
+    return Math.max(stripAnsi(h).length, maxData);
+  });
+  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`);
+  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 (archived.length > 0) {
+      log.dim(`
+  ${archived.length} archived change(s)`);
+    }
+  }
+}
+function stripAnsi(str) {
+  return str.replace(/\u001b\[[0-9;]*m/g, "").replace(/[✅🟢🟡]/g, "XX");
+}
+
+// src/commands/context.ts
+import { existsSync as existsSync17, writeFileSync as writeFileSync5, readdirSync as readdirSync11 } from "fs";
+import { join as join17 } from "path";
+
+// src/core/context.ts
+import { readFileSync as readFileSync9, existsSync as existsSync16 } from "fs";
+import { join as join16 } from "path";
+function extractSection(body, heading) {
+  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;
+  const rest = body.slice(startIdx);
+  const nextSection = rest.match(/^##\s+/m);
+  const sectionContent = nextSection ? rest.slice(0, nextSection.index) : rest;
+  return sectionContent.split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("<!--"));
+}
+function parseTaskItems(body) {
+  const lines = body.split("\n");
+  const items = [];
+  let done = 0;
+  let total = 0;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    const checked = trimmed.match(/^-\s*\[x\]\s+(.*)/i);
+    const unchecked = trimmed.match(/^-\s*\[\s\]\s+(.*)/);
+    if (checked) {
+      total++;
+      done++;
+      const desc = checked[1].trim();
+      items.push(`- [x] ${desc}`);
+    } else if (unchecked) {
+      total++;
+      const desc = unchecked[1].trim();
+      items.push(`- [ ] ${desc}`);
+    }
+  }
+  return { total, done, items };
+}
+function extractFilePaths(body) {
+  const paths = /* @__PURE__ */ new Set();
+  const regex = /`([^`]+\.[a-zA-Z]+)`/g;
+  let match;
+  while ((match = regex.exec(body)) !== null) {
+    const p = match[1];
+    if (p.includes("/") && !p.startsWith("http") && !p.includes(" ")) {
+      paths.add(p);
+    }
+  }
+  return [...paths];
+}
+function extractDecisions(body) {
+  const lines = body.split("\n");
+  const decisions = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (/^\|?\s*D\d+\s*\|/.test(trimmed)) {
+      const cells = trimmed.split("|").map((c) => c.trim()).filter(Boolean);
+      if (cells.length >= 2) {
+        decisions.push(`- ${cells[0]}: ${cells[1]}`);
+      }
+    }
+  }
+  return decisions;
+}
+var STATUS_LABELS = {
+  A: "added",
+  M: "modified",
+  D: "deleted",
+  R: "renamed"
+};
+function classifyGitChanges(gitChanges, taskFiles) {
+  const taskFileSet = new Set(taskFiles);
+  const lines = [];
+  for (const { status, file } of gitChanges) {
+    const label = STATUS_LABELS[status] || status;
+    const inTasks = taskFileSet.has(file) || taskFiles.some((tf) => file.endsWith(tf) || tf.endsWith(file));
+    const tag = inTasks ? "" : " (unplanned)";
+    lines.push(`- ${label}: ${file}${tag}`);
+  }
+  return lines;
+}
+function generateContext(changePath, changeName, options = {}) {
+  const read = (name) => {
+    const p = join16(changePath, name);
+    return existsSync16(p) ? readFileSync9(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 goals = [];
+  if (proposal) {
+    const { body } = parseFrontmatter(proposal);
+    const goalLines = extractSection(body, "\u76EE\u6807|Goals");
+    for (const line of goalLines) {
+      const cleaned = line.replace(/^-\s*\[.\]\s*/, "- ").replace(/^-\s*/, "");
+      if (cleaned) goals.push(`- ${cleaned}`);
+    }
+  }
+  let progress = { total: 0, done: 0, items: [] };
+  let files = [];
+  if (tasks) {
+    const { body } = parseFrontmatter(tasks);
+    progress = parseTaskItems(body);
+    files = extractFilePaths(body);
+  }
+  const decisions = [];
+  if (clarify) {
+    const { body } = parseFrontmatter(clarify);
+    decisions.push(...extractDecisions(body));
+  }
+  const existingContext = read("context.md");
+  let notes = "";
+  if (existingContext) {
+    const { body } = parseFrontmatter(existingContext);
+    const notesSection = extractSection(body, "Notes");
+    if (notesSection.length > 0) {
+      notes = notesSection.join("\n");
+    }
+  }
+  const fm = serializeFrontmatter({
+    name: changeName,
+    status,
+    strategy,
+    mode,
+    updated: getDateString()
+  });
+  const lines = [fm, ""];
+  if (goals.length > 0) {
+    lines.push("## Goals", ...goals, "");
+  }
+  if (progress.total > 0) {
+    lines.push(`## Progress (${progress.done}/${progress.total} tasks)`);
+    lines.push(...progress.items, "");
+  }
+  if (decisions.length > 0) {
+    lines.push("## Decisions", ...decisions, "");
+  }
+  if (files.length > 0) {
+    lines.push("## Affected Files");
+    for (const f of files) {
+      lines.push(`- ${f}`);
+    }
+    lines.push("");
+  }
+  if (options.gitDiff !== false) {
+    const gitChanges = getDiffFiles(options.baseBranch);
+    if (gitChanges.length > 0) {
+      const classified = classifyGitChanges(gitChanges, files);
+      lines.push("## Git Changes", ...classified, "");
+    }
+  }
+  lines.push("## Notes");
+  if (notes) {
+    lines.push(notes);
+  }
+  lines.push("");
+  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));
+  }
+  if (names.length === 0) {
+    log.warn(`${symbol.warn} no changes found`);
+    return;
+  }
+  for (const n of names) {
+    const changePath = join18(changesDir, n);
+    if (!existsSync18(changePath)) {
+      log.warn(`${symbol.warn} "${n}" not found`);
+      continue;
+    }
+    const content = generateContext(changePath, n, {
+      gitDiff: true,
+      baseBranch: opts.base
+    });
+    const destPath = join18(changePath, "context.md");
+    writeFileSync6(destPath, content, "utf-8");
+    log.success(`${symbol.ok} synced ${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;
+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("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("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.parse();
+//# sourceMappingURL=index.js.map