@superspec/cli 1.0.0

package/dist/index.js

@@ -0,0 +1,607 @@
+// 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/core/lint.ts
+import { readFileSync as readFileSync3, existsSync as existsSync4, readdirSync } from "fs";
+import { join as join4, basename } from "path";
+
+// src/core/validate.ts
+import { readFileSync as readFileSync4, existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
+
+// src/core/context.ts
+import { readFileSync as readFileSync5, 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/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" });
+}
+
+// src/commands/init.ts
+import { existsSync as existsSync8, writeFileSync as writeFileSync3, readdirSync as readdirSync4 } from "fs";
+import { join as join8 } from "path";
+import { execSync as execSync2 } from "child_process";
+
+// src/prompts/index.ts
+import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync2, readdirSync as readdirSync3 } from "fs";
+import { join as join7 } 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 = join7(cwd, config.rules);
+  ensureDir(rulesDir);
+  const promptSrc = join7(getPackageRoot(), "prompts", "cursor-rules.md");
+  if (existsSync7(promptSrc)) {
+    const content = readFileSync6(promptSrc, "utf-8");
+    const rulesFile = "rulesFile" in config ? config.rulesFile : "superspec.md";
+    const destPath = join7(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 = join7(cwd, "AGENTS.md");
+  const agentPromptSrc = join7(getPackageRoot(), "prompts", "agents.md");
+  if (!existsSync7(agentPromptSrc)) return;
+  const newContent = readFileSync6(agentPromptSrc, "utf-8");
+  const wrapped = `${SS_START}
+${newContent}
+${SS_END}`;
+  if (existsSync7(agentsMdPath)) {
+    const existing = readFileSync6(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 = join7(cwd, config.commands);
+  ensureDir(commandsDir);
+  const templatesDir = join7(getPackageRoot(), "templates", lang, "commands");
+  const fallbackDir = join7(getPackageRoot(), "templates", "zh", "commands");
+  const sourceDir = existsSync7(templatesDir) ? templatesDir : fallbackDir;
+  if (!existsSync7(sourceDir)) {
+    log.warn(`${symbol.warn} Commands templates not found: ${sourceDir}`);
+    return;
+  }
+  const commandFiles = readdirSync3(sourceDir).filter((f) => f.endsWith(".md"));
+  for (const file of commandFiles) {
+    const srcPath = join7(sourceDir, file);
+    const destPath = join7(commandsDir, file);
+    const content = readFileSync6(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 = join8(cwd, "superspec.config.json");
+  if (existsSync8(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 = join8(cwd, config.specDir);
+  const existingFiles = readdirSync4(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(join8(specDir, "changes"));
+  ensureDir(join8(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, join8(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 existsSync9 } from "fs";
+import { join as join9 } from "path";
+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 = join9(cwd, specDir, "changes", name);
+  if (existsSync9(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 = join9(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 existsSync10, readdirSync as readdirSync5, renameSync } from "fs";
+import { join as join10 } from "path";
+async function archiveCommand(name, options) {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const changesDir = join10(cwd, config.specDir, "changes");
+  const archiveDir = join10(cwd, config.specDir, "changes", config.archive.dir);
+  if (!existsSync10(changesDir)) {
+    log.warn(`${symbol.warn} \u6CA1\u6709\u627E\u5230 changes \u76EE\u5F55`);
+    return;
+  }
+  if (options.all) {
+    const entries = readdirSync5(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 = join10(changesDir, name);
+    if (!existsSync10(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 = join10(changesDir, name);
+  const dateStr = config.archive.datePrefix ? `${getDateString()}-` : "";
+  const dest = join10(archiveDir, `${dateStr}${name}`);
+  if (existsSync10(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 existsSync11 } from "fs";
+import { join as join11 } from "path";
+async function updateCommand() {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const specDir = join11(cwd, config.specDir);
+  const lang = config.lang || "zh";
+  if (!existsSync11(join11(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(join11(specDir, "templates"));
+  for (const tpl of templates) {
+    copyTemplate(tpl, join11(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 existsSync12, readdirSync as readdirSync6 } from "fs";
+import { join as join12 } from "path";
+
+// src/commands/validate.ts
+import { existsSync as existsSync13, readdirSync as readdirSync7 } from "fs";
+import { join as join13 } from "path";
+
+// src/commands/search.ts
+import { existsSync as existsSync14, readFileSync as readFileSync7, readdirSync as readdirSync8 } from "fs";
+import { join as join14, basename as basename3 } from "path";
+
+// src/commands/link.ts
+import { existsSync as existsSync15, readFileSync as readFileSync8, writeFileSync as writeFileSync4, readdirSync as readdirSync9 } from "fs";
+import { join as join15 } from "path";
+
+// src/commands/status.ts
+import { existsSync as existsSync16, readFileSync as readFileSync9, readdirSync as readdirSync10 } from "fs";
+import { join as join16 } from "path";
+
+// src/commands/context.ts
+import { existsSync as existsSync17, writeFileSync as writeFileSync5, readdirSync as readdirSync11 } from "fs";
+import { join as join17 } from "path";
+
+// src/commands/sync.ts
+import { existsSync as existsSync18, writeFileSync as writeFileSync6, readdirSync as readdirSync12 } from "fs";
+import { join as join18 } from "path";
+export {
+  archiveCommand,
+  createCommand,
+  getDefaultConfig,
+  initCommand,
+  loadConfig,
+  updateCommand
+};
+//# sourceMappingURL=index.js.map