sdd-tool 0.5.0 → 0.5.1

package/dist/cli/index.js

@@ -2503,28 +2503,9 @@ sdd transition guide
 }
 
 // src/cli/commands/init.ts
-function registerInitCommand(program2) {
-  program2.command("init").description("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4").option("-f, --force", "\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC \uB36E\uC5B4\uC4F0\uAE30").action(async (options) => {
-    try {
-      await runInit(options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-}
-async function runInit(options) {
-  const cwd = process.cwd();
-  const sddPath = path2.join(cwd, ".sdd");
-  if (await directoryExists(sddPath)) {
-    if (!options.force) {
-      error(".sdd/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. --force \uC635\uC158\uC73C\uB85C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-    warn("\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC\uB97C \uB36E\uC5B4\uC501\uB2C8\uB2E4.");
-  }
-  info("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4...");
-  const directories = [
+init_types();
+function getInitDirectories() {
+  return [
     ".sdd",
     ".sdd/specs",
     ".sdd/changes",
@@ -2533,48 +2514,10 @@ async function runInit(options) {
     ".claude",
     ".claude/commands"
   ];
-  for (const dir of directories) {
-    const result = await ensureDir(path2.join(cwd, dir));
-    if (!result.success) {
-      error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${dir}`);
-      process.exit(ExitCode.FILE_SYSTEM_ERROR);
-    }
-  }
-  await createDefaultFiles(cwd);
-  await copyTemplates(cwd);
-  await createClaudeCommands(cwd);
-  success2("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
-  newline();
-  info("\uC0DD\uC131\uB41C \uAD6C\uC870:");
-  listItem(".sdd/");
-  listItem("AGENTS.md", 1);
-  listItem("constitution.md", 1);
-  listItem("specs/", 1);
-  listItem("changes/", 1);
-  listItem("archive/", 1);
-  listItem("templates/", 1);
-  listItem(".claude/");
-  listItem("commands/", 1);
-  newline();
-  info("Claude \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC:");
-  listItem("/sdd.start - \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC2DC\uC791 (\uD1B5\uD569 \uC9C4\uC785\uC810)");
-  listItem("/sdd.constitution - \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59 \uAD00\uB9AC");
-  listItem("/sdd.new - \uC0C8 \uAE30\uB2A5 \uBA85\uC138 \uC791\uC131");
-  listItem("/sdd.plan - \uAD6C\uD604 \uACC4\uD68D \uC791\uC131");
-  listItem("/sdd.tasks - \uC791\uC5C5 \uBD84\uD574");
-  listItem("/sdd.implement - \uAD6C\uD604 \uC9C4\uD589");
-  listItem("/sdd.validate - \uC2A4\uD399 \uAC80\uC99D");
-  listItem("/sdd.status - \uC0C1\uD0DC \uD655\uC778");
-  listItem("/sdd.change - \uBCC0\uACBD \uC81C\uC548");
-  newline();
-  info("\uB2E4\uC74C \uB2E8\uACC4:");
-  listItem("constitution.md\uB97C \uC218\uC815\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59\uC744 \uC815\uC758\uD558\uC138\uC694");
-  listItem("/sdd.new \uB85C \uCCAB \uBC88\uC9F8 \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694");
 }
-async function createDefaultFiles(cwd) {
-  const projectName = path2.basename(cwd);
+function generateConstitutionContent(projectName) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const constitution = `---
+  return `---
 version: 1.0.0
 created: ${today}
 ---
@@ -2609,13 +2552,10 @@ created: ${today}
 
 - \uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0: 80% \uC774\uC0C1(SHOULD)
 `;
-  await writeFile(path2.join(cwd, ".sdd", "constitution.md"), constitution);
-  const agents = generateAgentsMd({ projectName });
-  await writeFile(path2.join(cwd, ".sdd", "AGENTS.md"), agents);
 }
-async function copyTemplates(cwd) {
+function generateSpecTemplate() {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const specTemplate = `---
+  return `---
 status: draft
 created: ${today}
 depends: null
@@ -2643,7 +2583,69 @@ depends: null
 
 \uCD94\uAC00 \uC124\uBA85\uC774\uB098 \uC81C\uC57D \uC870\uAC74
 `;
-  const proposalTemplate = `---
+}
+async function executeInit(projectPath, options) {
+  const sddPath = path2.join(projectPath, ".sdd");
+  const claudePath = path2.join(projectPath, ".claude");
+  if (await directoryExists(sddPath)) {
+    if (!options.force) {
+      return failure(new Error(".sdd/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. --force \uC635\uC158\uC73C\uB85C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4."));
+    }
+  }
+  const directories = getInitDirectories();
+  const createdDirs = [];
+  for (const dir of directories) {
+    const result = await ensureDir(path2.join(projectPath, dir));
+    if (!result.success) {
+      return failure(new Error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${dir}`));
+    }
+    createdDirs.push(dir);
+  }
+  const createdFiles = [];
+  const projectName = path2.basename(projectPath);
+  const constitutionContent = generateConstitutionContent(projectName);
+  await writeFile(path2.join(sddPath, "constitution.md"), constitutionContent);
+  createdFiles.push(".sdd/constitution.md");
+  const agentsContent = generateAgentsMd({ projectName });
+  await writeFile(path2.join(sddPath, "AGENTS.md"), agentsContent);
+  createdFiles.push(".sdd/AGENTS.md");
+  const templateFiles = await createTemplateFiles(projectPath);
+  createdFiles.push(...templateFiles);
+  const commandFiles = await createCommandFiles(projectPath);
+  createdFiles.push(...commandFiles);
+  return success({
+    sddPath,
+    claudePath,
+    directories: createdDirs,
+    files: createdFiles
+  });
+}
+async function createTemplateFiles(projectPath) {
+  const templatesPath = path2.join(projectPath, ".sdd", "templates");
+  const files = [];
+  await writeFile(path2.join(templatesPath, "spec.md"), generateSpecTemplate());
+  files.push(".sdd/templates/spec.md");
+  await writeFile(path2.join(templatesPath, "proposal.md"), generateProposalTemplate());
+  files.push(".sdd/templates/proposal.md");
+  await writeFile(path2.join(templatesPath, "delta.md"), generateDeltaTemplate());
+  files.push(".sdd/templates/delta.md");
+  await writeFile(path2.join(templatesPath, "tasks.md"), generateTasksTemplate());
+  files.push(".sdd/templates/tasks.md");
+  return files;
+}
+async function createCommandFiles(projectPath) {
+  const commandsPath = path2.join(projectPath, ".claude", "commands");
+  const files = [];
+  const commands = generateClaudeCommands();
+  for (const cmd of commands) {
+    await writeFile(path2.join(commandsPath, `${cmd.name}.md`), cmd.content);
+    files.push(`.claude/commands/${cmd.name}.md`);
+  }
+  return files;
+}
+function generateProposalTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 id: CHG-{{ID}}
 status: draft
 created: ${today}
@@ -2706,7 +2708,10 @@ created: ${today}
 - \uC601\uD5A5\uB3C4: \uB0AE\uC74C/\uC911\uAC04/\uB192\uC74C
 - \uBCF5\uC7A1\uB3C4: \uB0AE\uC74C/\uC911\uAC04/\uB192\uC74C
 `;
-  const deltaTemplate = `---
+}
+function generateDeltaTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 proposal: CHG-{{ID}}
 created: ${today}
 ---
@@ -2737,7 +2742,10 @@ created: ${today}
 
 (\uC0AD\uC81C\uB418\uB294 \uC2A4\uD399 \uCC38\uC870)
 `;
-  const tasksTemplate = `---
+}
+function generateTasksTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 spec: {{SPEC_ID}}
 created: ${today}
 ---
@@ -2788,19 +2796,57 @@ graph LR
 | [\u2192T] | \uD14C\uC2A4\uD2B8 \uD544\uC694 |
 | [US] | \uBD88\uD655\uC2E4/\uAC80\uD1A0 \uD544\uC694 |
 `;
-  await writeFile(path2.join(cwd, ".sdd", "templates", "spec.md"), specTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "proposal.md"), proposalTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "delta.md"), deltaTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "tasks.md"), tasksTemplate);
 }
-async function createClaudeCommands(cwd) {
-  const commands = generateClaudeCommands();
-  for (const cmd of commands) {
-    await writeFile(
-      path2.join(cwd, ".claude", "commands", `${cmd.name}.md`),
-      cmd.content
-    );
+function registerInitCommand(program2) {
+  program2.command("init").description("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4").option("-f, --force", "\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC \uB36E\uC5B4\uC4F0\uAE30").action(async (options) => {
+    try {
+      await runInit(options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runInit(options) {
+  const cwd = process.cwd();
+  if (await directoryExists(path2.join(cwd, ".sdd"))) {
+    if (options.force) {
+      warn("\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC\uB97C \uB36E\uC5B4\uC501\uB2C8\uB2E4.");
+    }
+  }
+  info("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4...");
+  const result = await executeInit(cwd, options);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
   }
+  success2("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+  newline();
+  info("\uC0DD\uC131\uB41C \uAD6C\uC870:");
+  listItem(".sdd/");
+  listItem("AGENTS.md", 1);
+  listItem("constitution.md", 1);
+  listItem("specs/", 1);
+  listItem("changes/", 1);
+  listItem("archive/", 1);
+  listItem("templates/", 1);
+  listItem(".claude/");
+  listItem("commands/", 1);
+  newline();
+  info("Claude \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC:");
+  listItem("/sdd.start - \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC2DC\uC791 (\uD1B5\uD569 \uC9C4\uC785\uC810)");
+  listItem("/sdd.constitution - \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59 \uAD00\uB9AC");
+  listItem("/sdd.new - \uC0C8 \uAE30\uB2A5 \uBA85\uC138 \uC791\uC131");
+  listItem("/sdd.plan - \uAD6C\uD604 \uACC4\uD68D \uC791\uC131");
+  listItem("/sdd.tasks - \uC791\uC5C5 \uBD84\uD574");
+  listItem("/sdd.implement - \uAD6C\uD604 \uC9C4\uD589");
+  listItem("/sdd.validate - \uC2A4\uD399 \uAC80\uC99D");
+  listItem("/sdd.status - \uC0C1\uD0DC \uD655\uC778");
+  listItem("/sdd.change - \uBCC0\uACBD \uC81C\uC548");
+  newline();
+  info("\uB2E4\uC74C \uB2E8\uACC4:");
+  listItem("constitution.md\uB97C \uC218\uC815\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59\uC744 \uC815\uC758\uD558\uC138\uC694");
+  listItem("/sdd.new \uB85C \uCCAB \uBC88\uC9F8 \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694");
 }
 
 // src/cli/commands/validate.ts
@@ -3661,26 +3707,15 @@ async function findSpecFiles(dirPath) {
 // src/cli/commands/validate.ts
 init_errors();
 init_fs();
-function registerValidateCommand(program2) {
-  program2.command("validate").description("\uC2A4\uD399 \uD30C\uC77C \uD615\uC2DD\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").argument("[path]", "\uAC80\uC99D\uD560 \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC", "").option("-s, --strict", "\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC").option("-q, --quiet", "\uC694\uC57D\uB9CC \uCD9C\uB825").option("-l, --check-links", "\uCC38\uC870 \uB9C1\uD06C \uC720\uD6A8\uC131 \uAC80\uC0AC").option("-c, --constitution", "Constitution \uC704\uBC18 \uAC80\uC0AC (\uAE30\uBCF8\uAC12)").option("--no-constitution", "Constitution \uAC80\uC0AC \uAC74\uB108\uB6F0\uAE30").action(async (targetPath, options) => {
-    try {
-      await runValidate(targetPath, options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-}
-async function runValidate(targetPath, options) {
+init_types();
+async function createValidateContext(targetPath, options, sddRoot) {
   let resolvedPath;
   let specsRoot;
-  const sddRoot = await findSddRoot();
   if (targetPath) {
     resolvedPath = path4.resolve(targetPath);
   } else {
     if (!sddRoot) {
-      error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-      process.exit(ExitCode.GENERAL_ERROR);
+      return failure(new Error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694."));
     }
     resolvedPath = path4.join(sddRoot, ".sdd", "specs");
   }
@@ -3693,39 +3728,75 @@ async function runValidate(targetPath, options) {
     const constitutionPath = path4.join(sddRoot, ".sdd", "constitution.md");
     hasConstitution = await fileExists(constitutionPath);
   }
+  return success({
+    resolvedPath,
+    specsRoot,
+    checkConstitution,
+    hasConstitution,
+    sddRoot: sddRoot || void 0
+  });
+}
+async function executeValidate(options, context) {
+  const result = await validateSpecs(context.resolvedPath, {
+    strict: options.strict,
+    checkLinks: options.checkLinks,
+    specsRoot: context.specsRoot,
+    checkConstitution: context.checkConstitution && context.hasConstitution,
+    sddRoot: context.sddRoot
+  });
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+function formatValidateSummary(result, useColors = true) {
+  const { passed, failed, warnings } = result;
+  const passedText = useColors ? chalk2.green(`${passed} passed`) : `${passed} passed`;
+  const failedText = failed > 0 ? useColors ? chalk2.red(`${failed} failed`) : `${failed} failed` : `${failed} failed`;
+  const warningsText = warnings > 0 ? useColors ? chalk2.yellow(`${warnings} warnings`) : `${warnings} warnings` : "";
+  return [passedText, failedText, warningsText].filter(Boolean).join(", ");
+}
+function registerValidateCommand(program2) {
+  program2.command("validate").description("\uC2A4\uD399 \uD30C\uC77C \uD615\uC2DD\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").argument("[path]", "\uAC80\uC99D\uD560 \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC", "").option("-s, --strict", "\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC").option("-q, --quiet", "\uC694\uC57D\uB9CC \uCD9C\uB825").option("-l, --check-links", "\uCC38\uC870 \uB9C1\uD06C \uC720\uD6A8\uC131 \uAC80\uC0AC").option("-c, --constitution", "Constitution \uC704\uBC18 \uAC80\uC0AC (\uAE30\uBCF8\uAC12)").option("--no-constitution", "Constitution \uAC80\uC0AC \uAC74\uB108\uB6F0\uAE30").action(async (targetPath, options) => {
+    try {
+      await runValidate(targetPath, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runValidate(targetPath, options) {
+  const sddRoot = await findSddRoot();
+  const contextResult = await createValidateContext(targetPath, options, sddRoot);
+  if (!contextResult.success) {
+    error(contextResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const context = contextResult.data;
   if (!options.quiet) {
-    info(`\uAC80\uC99D \uC911: ${resolvedPath}`);
+    info(`\uAC80\uC99D \uC911: ${context.resolvedPath}`);
     if (options.checkLinks) {
       info("(\uCC38\uC870 \uB9C1\uD06C \uAC80\uC99D \uD3EC\uD568)");
     }
-    if (checkConstitution && hasConstitution) {
+    if (context.checkConstitution && context.hasConstitution) {
       info("(Constitution \uC704\uBC18 \uAC80\uC0AC \uD3EC\uD568)");
     }
     newline();
   }
-  const result = await validateSpecs(resolvedPath, {
-    strict: options.strict,
-    checkLinks: options.checkLinks,
-    specsRoot,
-    checkConstitution: checkConstitution && hasConstitution,
-    sddRoot: sddRoot || void 0
-  });
+  const result = await executeValidate(options, context);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const { passed, failed, warnings, files } = result.data;
+  const { failed, files } = result.data;
   if (!options.quiet) {
     for (const file of files) {
-      printFileResult(file, resolvedPath);
+      printFileResult(file, context.resolvedPath);
     }
     newline();
   }
-  const passedText = chalk2.green(`${passed} passed`);
-  const failedText = failed > 0 ? chalk2.red(`${failed} failed`) : `${failed} failed`;
-  const warningsText = warnings > 0 ? chalk2.yellow(`${warnings} warnings`) : "";
-  const summary = [passedText, failedText, warningsText].filter(Boolean).join(", ");
-  console.log(`Result: ${summary}`);
+  console.log(`Result: ${formatValidateSummary(result.data)}`);
   if (failed > 0) {
     process.exit(ExitCode.VALIDATION_FAILED);
   }
@@ -4917,57 +4988,200 @@ async function listPendingChanges(sddPath) {
 // src/cli/commands/change.ts
 init_fs();
 init_errors();
-function registerChangeCommand(program2) {
-  const change = program2.command("change [id]").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC0DD\uC131\uD558\uAC70\uB098 \uAD00\uB9AC\uD569\uB2C8\uB2E4").option("-l, --list", "\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-s, --spec <spec>", "\uB300\uC0C1 \uC2A4\uD399 \uACBD\uB85C").action(async (id, options) => {
-    try {
-      await runChange(id, options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-  change.command("apply <id>").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC2A4\uD399\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runApply(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+init_types();
+async function getChangeListItems(sddPath) {
+  const result = await listPendingChanges(sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data.map((change) => ({
+    id: change.id,
+    title: change.title || null,
+    status: change.status
+  })));
+}
+async function getChangeInfo(changePath) {
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (!await fileExists(proposalPath)) {
+    return failure(new Error("proposal.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const contentResult = await readFile(proposalPath);
+  if (!contentResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseProposal(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`proposal.md \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    id: parseResult.data.metadata.id,
+    title: parseResult.data.title,
+    status: parseResult.data.metadata.status,
+    created: parseResult.data.metadata.created,
+    affectedSpecs: parseResult.data.affectedSpecs
   });
-  change.command("archive <id>").description("\uC644\uB8CC\uB41C \uBCC0\uACBD\uC744 \uC544\uCE74\uC774\uBE0C\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runArchive(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+}
+async function createChange(sddPath, options) {
+  const changesPath = path6.join(sddPath, "changes");
+  await ensureDir(changesPath);
+  const existingIds = [];
+  try {
+    const dirs = await fs3.readdir(changesPath);
+    existingIds.push(...dirs.filter((d) => d.startsWith("CHG-")));
+  } catch {
+  }
+  const newId = generateChangeId(existingIds);
+  const title2 = options.title || "\uC0C8 \uBCC0\uACBD \uC81C\uC548";
+  const affectedSpecs = options.spec ? [options.spec] : [];
+  const changePath = path6.join(changesPath, newId);
+  await ensureDir(changePath);
+  const proposal = generateProposal({
+    id: newId,
+    title: title2,
+    affectedSpecs
   });
-  change.command("diff <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 diff\uB97C \uD45C\uC2DC\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runDiff(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+  const proposalPath = path6.join(changePath, "proposal.md");
+  await writeFile(proposalPath, proposal);
+  const delta = generateDelta({
+    proposalId: newId,
+    title: title2
   });
-  change.command("validate <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 \uC720\uD6A8\uC131\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runValidateChange(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+  const deltaPath = path6.join(changePath, "delta.md");
+  await writeFile(deltaPath, delta);
+  return success({
+    id: newId,
+    proposalPath,
+    deltaPath
   });
 }
-async function runChange(id, options) {
-  const projectRoot = await findSddRoot();
-  if (!projectRoot) {
-    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
+async function applyChange(changePath) {
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (!await fileExists(proposalPath)) {
+    return failure(new Error("proposal.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
   }
-  const sddPath = path6.join(projectRoot, ".sdd");
-  if (options.list) {
-    const result = await listPendingChanges(sddPath);
+  const contentResult = await readFile(proposalPath);
+  if (!contentResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const updateResult = updateProposalStatus(contentResult.data, "applied");
+  if (!updateResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC5C5\uB370\uC774\uD2B8\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  await writeFile(proposalPath, updateResult.data);
+  return success(void 0);
+}
+async function getDeltaInfo(changePath) {
+  const deltaPath = path6.join(changePath, "delta.md");
+  if (!await fileExists(deltaPath)) {
+    return failure(new Error("delta.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const deltaResult = await readFile(deltaPath);
+  if (!deltaResult.success) {
+    return failure(new Error("delta.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseDelta(deltaResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`Delta \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    added: parseResult.data.added,
+    modified: parseResult.data.modified,
+    removed: parseResult.data.removed
+  });
+}
+async function validateChange(changePath) {
+  const result = {
+    proposalValid: false,
+    deltaValid: false,
+    hasDelta: false
+  };
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (await fileExists(proposalPath)) {
+    const proposalResult = await readFile(proposalPath);
+    if (proposalResult.success) {
+      const parsed = parseProposal(proposalResult.data);
+      if (parsed.success) {
+        result.proposalValid = true;
+        result.proposalTitle = parsed.data.title;
+      } else {
+        result.proposalError = parsed.error.message;
+      }
+    }
+  } else {
+    result.proposalError = "proposal.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  }
+  const deltaPath = path6.join(changePath, "delta.md");
+  if (await fileExists(deltaPath)) {
+    result.hasDelta = true;
+    const deltaResult = await readFile(deltaPath);
+    if (deltaResult.success) {
+      const validation = validateDelta(deltaResult.data);
+      if (validation.valid) {
+        result.deltaValid = true;
+        const types = [];
+        if (validation.hasAdded) types.push("ADDED");
+        if (validation.hasModified) types.push("MODIFIED");
+        if (validation.hasRemoved) types.push("REMOVED");
+        result.deltaTypes = types;
+        result.deltaWarnings = validation.warnings;
+      } else {
+        result.deltaErrors = validation.errors;
+      }
+    }
+  }
+  return success(result);
+}
+function registerChangeCommand(program2) {
+  const change = program2.command("change [id]").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC0DD\uC131\uD558\uAC70\uB098 \uAD00\uB9AC\uD569\uB2C8\uB2E4").option("-l, --list", "\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-s, --spec <spec>", "\uB300\uC0C1 \uC2A4\uD399 \uACBD\uB85C").action(async (id, options) => {
+    try {
+      await runChange(id, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("apply <id>").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC2A4\uD399\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runApply(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("archive <id>").description("\uC644\uB8CC\uB41C \uBCC0\uACBD\uC744 \uC544\uCE74\uC774\uBE0C\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runArchive(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("diff <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 diff\uB97C \uD45C\uC2DC\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runDiff(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("validate <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 \uC720\uD6A8\uC131\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runValidateChange(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runChange(id, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const sddPath = path6.join(projectRoot, ".sdd");
+  if (options.list) {
+    const result = await getChangeListItems(sddPath);
     if (!result.success) {
       error(result.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
@@ -4985,53 +5199,31 @@ async function runChange(id, options) {
     return;
   }
   if (id) {
-    const changePath2 = path6.join(sddPath, "changes", id);
-    if (!await directoryExists(changePath2)) {
+    const changePath = path6.join(sddPath, "changes", id);
+    if (!await directoryExists(changePath)) {
       error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
       process.exit(ExitCode.GENERAL_ERROR);
     }
-    const proposalPath = path6.join(changePath2, "proposal.md");
-    try {
-      const content = await fs3.readFile(proposalPath, "utf-8");
-      const parseResult = parseProposal(content);
-      if (parseResult.success) {
-        info(`\uBCC0\uACBD \uC81C\uC548: ${parseResult.data.title}`);
-        info(`\uC0C1\uD0DC: ${parseResult.data.metadata.status}`);
-        info(`\uC0DD\uC131: ${parseResult.data.metadata.created}`);
-        if (parseResult.data.affectedSpecs.length > 0) {
-          info("\uC601\uD5A5 \uC2A4\uD399:");
-          parseResult.data.affectedSpecs.forEach((spec) => listItem(spec, 1));
-        }
+    const infoResult = await getChangeInfo(changePath);
+    if (infoResult.success) {
+      info(`\uBCC0\uACBD \uC81C\uC548: ${infoResult.data.title}`);
+      info(`\uC0C1\uD0DC: ${infoResult.data.status}`);
+      info(`\uC0DD\uC131: ${infoResult.data.created}`);
+      if (infoResult.data.affectedSpecs.length > 0) {
+        info("\uC601\uD5A5 \uC2A4\uD399:");
+        infoResult.data.affectedSpecs.forEach((spec) => listItem(spec, 1));
       }
-    } catch {
-      error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    } else {
+      error(infoResult.error.message);
     }
     return;
   }
-  const changesPath = path6.join(sddPath, "changes");
-  await ensureDir(changesPath);
-  const existingIds = [];
-  try {
-    const dirs = await fs3.readdir(changesPath);
-    existingIds.push(...dirs.filter((d) => d.startsWith("CHG-")));
-  } catch {
+  const createResult = await createChange(sddPath, options);
+  if (!createResult.success) {
+    error(createResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
   }
-  const newId = generateChangeId(existingIds);
-  const title2 = options.title || "\uC0C8 \uBCC0\uACBD \uC81C\uC548";
-  const affectedSpecs = options.spec ? [options.spec] : [];
-  const changePath = path6.join(changesPath, newId);
-  await ensureDir(changePath);
-  const proposal = generateProposal({
-    id: newId,
-    title: title2,
-    affectedSpecs
-  });
-  await writeFile(path6.join(changePath, "proposal.md"), proposal);
-  const delta = generateDelta({
-    proposalId: newId,
-    title: title2
-  });
-  await writeFile(path6.join(changePath, "delta.md"), delta);
+  const newId = createResult.data.id;
   success2(`\uBCC0\uACBD \uC81C\uC548\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${newId}`);
   newline();
   info("\uC0DD\uC131\uB41C \uD30C\uC77C:");
@@ -5055,15 +5247,9 @@ async function runApply(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const proposalPath = path6.join(changePath, "proposal.md");
-  try {
-    const content = await fs3.readFile(proposalPath, "utf-8");
-    const updateResult = updateProposalStatus(content, "applied");
-    if (updateResult.success) {
-      await fs3.writeFile(proposalPath, updateResult.data);
-    }
-  } catch {
-    error("proposal.md\uB97C \uC5C5\uB370\uC774\uD2B8\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await applyChange(changePath);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
   success2(`\uBCC0\uACBD\uC774 \uC801\uC6A9 \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${id}`);
@@ -5099,22 +5285,12 @@ async function runDiff(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const deltaPath = path6.join(changePath, "delta.md");
-  if (!await fileExists(deltaPath)) {
-    error("delta.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
-  const deltaResult = await readFile(deltaPath);
+  const deltaResult = await getDeltaInfo(changePath);
   if (!deltaResult.success) {
-    error("delta.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    error(deltaResult.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseDelta(deltaResult.data);
-  if (!parseResult.success) {
-    error(`Delta \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const delta = parseResult.data;
+  const delta = deltaResult.data;
   info(`\uBCC0\uACBD Diff: ${id}`);
   newline();
   if (delta.added.length > 0 && delta.added[0].content !== "(\uCD94\uAC00\uB418\uB294 \uC2A4\uD399 \uB0B4\uC6A9)") {
@@ -5162,44 +5338,35 @@ async function runValidateChange(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
+  const validationResult = await validateChange(changePath);
+  if (!validationResult.success) {
+    error(validationResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const result = validationResult.data;
   let hasErrors = false;
-  const proposalPath = path6.join(changePath, "proposal.md");
-  if (await fileExists(proposalPath)) {
-    const proposalResult = await readFile(proposalPath);
-    if (proposalResult.success) {
-      const parsed = parseProposal(proposalResult.data);
-      if (parsed.success) {
-        success2(`\u2713 proposal.md \uC720\uD6A8 (${parsed.data.title})`);
-      } else {
-        error(`\u2717 proposal.md \uC624\uB958: ${parsed.error.message}`);
-        hasErrors = true;
-      }
-    }
+  if (result.proposalValid) {
+    success2(`\u2713 proposal.md \uC720\uD6A8 (${result.proposalTitle})`);
   } else {
-    error("\u2717 proposal.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    error(`\u2717 proposal.md \uC624\uB958: ${result.proposalError}`);
     hasErrors = true;
   }
-  const deltaPath = path6.join(changePath, "delta.md");
-  if (await fileExists(deltaPath)) {
-    const deltaResult = await readFile(deltaPath);
-    if (deltaResult.success) {
-      const validation = validateDelta(deltaResult.data);
-      if (validation.valid) {
-        const types = [];
-        if (validation.hasAdded) types.push("ADDED");
-        if (validation.hasModified) types.push("MODIFIED");
-        if (validation.hasRemoved) types.push("REMOVED");
-        success2(`\u2713 delta.md \uC720\uD6A8 (${types.join(", ")})`);
-        for (const warning of validation.warnings) {
+  if (result.hasDelta) {
+    if (result.deltaValid) {
+      success2(`\u2713 delta.md \uC720\uD6A8 (${result.deltaTypes?.join(", ")})`);
+      if (result.deltaWarnings) {
+        for (const warning of result.deltaWarnings) {
           warn(`  \u26A0 ${warning}`);
         }
-      } else {
-        error(`\u2717 delta.md \uC624\uB958:`);
-        for (const error2 of validation.errors) {
+      }
+    } else {
+      error(`\u2717 delta.md \uC624\uB958:`);
+      if (result.deltaErrors) {
+        for (const error2 of result.deltaErrors) {
           error(`  - ${error2}`);
         }
-        hasErrors = true;
       }
+      hasErrors = true;
     }
   } else {
     warn("\u26A0 delta.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
@@ -5207,7 +5374,7 @@ async function runValidateChange(id) {
   newline();
   if (hasErrors) {
     error(`\uAC80\uC99D \uC2E4\uD328: ${id}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
+    process.exit(ExitCode.VALIDATION_FAILED);
   } else {
     success2(`\uAC80\uC99D \uD1B5\uACFC: ${id}`);
   }
@@ -6635,6 +6802,108 @@ function formatCodeImpactResult(result) {
 // src/cli/commands/impact.ts
 init_fs();
 init_errors();
+init_types();
+function resolveProposalPath(proposalPath, sddPath) {
+  if (path10.isAbsolute(proposalPath)) {
+    return proposalPath;
+  }
+  const changesPath = path10.join(sddPath, "changes", proposalPath);
+  if (proposalPath.endsWith(".md")) {
+    return changesPath;
+  }
+  return path10.join(changesPath, "proposal.md");
+}
+async function executeImpactAnalysis(sddPath, feature) {
+  const result = await analyzeImpact(sddPath, feature);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeGraphAnalysis(specsPath, feature, asJson = false) {
+  const graphResult = await buildDependencyGraph(specsPath);
+  if (!graphResult.success) {
+    return failure(graphResult.error);
+  }
+  const mermaid = generateMermaidGraph(graphResult.data, feature);
+  if (asJson) {
+    return success({
+      mermaid,
+      nodes: Array.from(graphResult.data.nodes.values()),
+      edges: graphResult.data.edges
+    });
+  }
+  return success({ mermaid });
+}
+async function executeCodeImpactAnalysis(projectRoot, sddPath, feature) {
+  const result = await analyzeCodeImpact(projectRoot, sddPath, feature);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeImpactReport(sddPath) {
+  const result = await generateImpactReport(sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeChangeImpact(sddPath, changeId) {
+  const result = await analyzeChangeImpact(sddPath, changeId);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+function formatChangeImpactOutput(data) {
+  const lines = [];
+  lines.push(`\u{1F4CA} \uBCC0\uACBD \uC601\uD5A5 \uBD84\uC11D: ${data.changeId}`);
+  if (data.title) {
+    lines.push(`\uC81C\uBAA9: ${data.title}`);
+  }
+  lines.push(`\uC0C1\uD0DC: ${data.status}`);
+  lines.push("");
+  if (data.affectedSpecs.length > 0) {
+    lines.push("\u26A0\uFE0F  \uC9C1\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
+    for (const spec of data.affectedSpecs) {
+      lines.push(`  - ${spec.id} - ${spec.reason}`);
+    }
+    lines.push("");
+  }
+  if (data.transitiveAffected.length > 0) {
+    lines.push("\u{1F504} \uAC04\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
+    for (const spec of data.transitiveAffected) {
+      lines.push(`  - ${spec.id} (${spec.reason})`);
+    }
+    lines.push("");
+  }
+  const riskIcon = data.riskLevel === "high" ? "\u{1F534}" : data.riskLevel === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
+  lines.push(`\uCD1D \uC601\uD5A5 \uBC94\uC704: ${data.totalImpact}\uAC1C \uC2A4\uD399 ${riskIcon}`);
+  lines.push("");
+  if (data.recommendations.length > 0) {
+    lines.push("\u{1F4A1} \uAD8C\uC7A5\uC0AC\uD56D:");
+    for (const rec of data.recommendations) {
+      lines.push(`  - ${rec}`);
+    }
+  }
+  return lines.join("\n");
+}
+async function executeSimulation(specsPath, feature, proposalPath) {
+  const deltaResult = await parseDeltaFromProposal(proposalPath);
+  if (!deltaResult.success) {
+    return failure(deltaResult.error);
+  }
+  const deltas = deltaResult.data;
+  if (deltas.length === 0) {
+    return failure(new Error("\uBCC0\uACBD \uC81C\uC548\uC5D0\uC11C \uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const simResult = await runSimulation(specsPath, feature, deltas);
+  if (!simResult.success) {
+    return failure(simResult.error);
+  }
+  return success({ deltas, result: simResult.data });
+}
 function registerImpactCommand(program2) {
   const impact = program2.command("impact [feature]").description("\uC2A4\uD399 \uBCC0\uACBD\uC758 \uC601\uD5A5\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4").option("-g, --graph", "\uC758\uC874\uC131 \uADF8\uB798\uD504 \uCD9C\uB825 (Mermaid)").option("-r, --reverse", "\uC5ED\uBC29\uD5A5 \uC601\uD5A5\uB3C4 \uBD84\uC11D").option("-c, --code", "\uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").action(async (feature, options) => {
     try {
@@ -6676,25 +6945,25 @@ async function runImpact(feature, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
+  const specsPath = path10.join(sddPath, "specs");
   if (options.graph) {
-    const graphResult = await buildDependencyGraph(path10.join(sddPath, "specs"));
+    const graphResult = await executeGraphAnalysis(specsPath, feature, options.json);
     if (!graphResult.success) {
       error(graphResult.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
     }
-    const mermaid = generateMermaidGraph(graphResult.data, feature);
     if (options.json) {
       console.log(JSON.stringify({
         format: "mermaid",
-        content: mermaid,
-        nodes: Array.from(graphResult.data.nodes.values()),
+        content: graphResult.data.mermaid,
+        nodes: graphResult.data.nodes,
         edges: graphResult.data.edges
       }, null, 2));
     } else {
       info("\uC758\uC874\uC131 \uADF8\uB798\uD504 (Mermaid):");
       newline();
       console.log("```mermaid");
-      console.log(mermaid);
+      console.log(graphResult.data.mermaid);
       console.log("```");
     }
     return;
@@ -6708,7 +6977,7 @@ async function runImpact(feature, options) {
     }
     info(`\u{1F4BB} \uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D: ${feature}`);
     newline();
-    const codeResult = await analyzeCodeImpact(projectRoot, sddPath, feature);
+    const codeResult = await executeCodeImpactAnalysis(projectRoot, sddPath, feature);
     if (!codeResult.success) {
       error(codeResult.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
@@ -6726,7 +6995,7 @@ async function runImpact(feature, options) {
     info("\uC608\uC2DC: sdd impact auth");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const result = await analyzeImpact(sddPath, feature);
+  const result = await executeImpactAnalysis(sddPath, feature);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6744,7 +7013,7 @@ async function runImpactReport(options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
-  const result = await generateImpactReport(sddPath);
+  const result = await executeImpactReport(sddPath);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6762,7 +7031,7 @@ async function runChangeImpact(changeId, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
-  const result = await analyzeChangeImpact(sddPath, changeId);
+  const result = await executeChangeImpact(sddPath, changeId);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6770,36 +7039,7 @@ async function runChangeImpact(changeId, options) {
   if (options.json) {
     console.log(JSON.stringify(result.data, null, 2));
   } else {
-    const data = result.data;
-    info(`\u{1F4CA} \uBCC0\uACBD \uC601\uD5A5 \uBD84\uC11D: ${data.changeId}`);
-    if (data.title) {
-      info(`\uC81C\uBAA9: ${data.title}`);
-    }
-    info(`\uC0C1\uD0DC: ${data.status}`);
-    newline();
-    if (data.affectedSpecs.length > 0) {
-      info("\u26A0\uFE0F  \uC9C1\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
-      for (const spec of data.affectedSpecs) {
-        listItem(`${spec.id} - ${spec.reason}`, 1);
-      }
-      newline();
-    }
-    if (data.transitiveAffected.length > 0) {
-      info("\u{1F504} \uAC04\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
-      for (const spec of data.transitiveAffected) {
-        listItem(`${spec.id} (${spec.reason})`, 1);
-      }
-      newline();
-    }
-    const riskIcon = data.riskLevel === "high" ? "\u{1F534}" : data.riskLevel === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
-    info(`\uCD1D \uC601\uD5A5 \uBC94\uC704: ${data.totalImpact}\uAC1C \uC2A4\uD399 ${riskIcon}`);
-    newline();
-    if (data.recommendations.length > 0) {
-      info("\u{1F4A1} \uAD8C\uC7A5\uC0AC\uD56D:");
-      for (const rec of data.recommendations) {
-        listItem(rec, 1);
-      }
-    }
+    console.log(formatChangeImpactOutput(result.data));
   }
 }
 async function runSimulate(feature, proposalPath, options) {
@@ -6810,65 +7050,208 @@ async function runSimulate(feature, proposalPath, options) {
   }
   const sddPath = path10.join(projectRoot, ".sdd");
   const specsPath = path10.join(sddPath, "specs");
-  let fullProposalPath = proposalPath;
-  if (!path10.isAbsolute(proposalPath)) {
-    const changesPath = path10.join(sddPath, "changes", proposalPath);
-    if (proposalPath.endsWith(".md")) {
-      fullProposalPath = changesPath;
-    } else {
-      fullProposalPath = path10.join(changesPath, "proposal.md");
-    }
-  }
+  const fullProposalPath = resolveProposalPath(proposalPath, sddPath);
   info(`\u{1F4CA} What-if \uC2DC\uBBAC\uB808\uC774\uC158`);
   info(`\uB300\uC0C1 \uC2A4\uD399: ${feature}`);
   info(`\uBCC0\uACBD \uC81C\uC548: ${fullProposalPath}`);
   newline();
-  const deltaResult = await parseDeltaFromProposal(fullProposalPath);
-  if (!deltaResult.success) {
-    error(deltaResult.error.message);
+  const result = await executeSimulation(specsPath, feature, fullProposalPath);
+  if (!result.success) {
+    if (result.error.message.includes("\uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4")) {
+      warn(result.error.message);
+      info("ADDED, MODIFIED, REMOVED \uC139\uC158\uC744 \uD655\uC778\uD558\uC138\uC694.");
+      return;
+    }
+    error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const deltas = deltaResult.data;
-  if (deltas.length === 0) {
-    warn("\uBCC0\uACBD \uC81C\uC548\uC5D0\uC11C \uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    info("ADDED, MODIFIED, REMOVED \uC139\uC158\uC744 \uD655\uC778\uD558\uC138\uC694.");
-    return;
-  }
+  const { deltas, result: simResult } = result.data;
   info(`\uAC10\uC9C0\uB41C \uBCC0\uACBD: ${deltas.length}\uAC74`);
   for (const delta of deltas) {
     const icon = delta.type === "ADDED" ? "\u2795" : delta.type === "REMOVED" ? "\u2796" : "\u270F\uFE0F";
     listItem(`${icon} ${delta.type}: ${delta.specId}`, 1);
   }
   newline();
-  const simResult = await runSimulation(specsPath, feature, deltas);
-  if (!simResult.success) {
-    error(simResult.error.message);
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
   if (options.json) {
-    console.log(JSON.stringify(simResult.data, null, 2));
+    console.log(JSON.stringify(simResult, null, 2));
   } else {
-    console.log(formatSimulationResult(simResult.data, feature));
+    console.log(formatSimulationResult(simResult, feature));
   }
 }
 
 // src/cli/commands/new.ts
 init_new();
 import path12 from "path";
-import { promises as fs7 } from "fs";
 
 // src/utils/index.ts
 init_fs();
 
 // src/cli/commands/new.ts
 init_fs();
-function registerNewCommand(program2) {
-  const newCmd = program2.command("new").description("\uC0C8\uB85C\uC6B4 \uAE30\uB2A5 \uC0DD\uC131").argument("[name]", "\uAE30\uB2A5 \uC774\uB984").option("--title <title>", "\uAE30\uB2A5 \uC81C\uBAA9").option("--description <desc>", "\uAE30\uB2A5 \uC124\uBA85").option("--no-branch", "\uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC548 \uD568").option("--numbered", "\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC (feature/001-name \uD615\uC2DD)").option("--plan", "\uACC4\uD68D \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--tasks", "\uC791\uC5C5 \uBD84\uD574 \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--all", "\uBAA8\uB4E0 \uD30C\uC77C \uC0DD\uC131 (spec, plan, tasks)").option("--checklist", "\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uD30C\uC77C \uC0DD\uC131").action(async (name, options) => {
-    await handleNew(name, options);
-  });
-  newCmd.command("plan").description("\uAE30\uB2A5 \uAD6C\uD604 \uACC4\uD68D \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").option("--title <title>", "\uACC4\uD68D \uC81C\uBAA9").action(async (feature, opts) => {
-    await handlePlan(feature, opts);
-  });
+init_types();
+async function getConstitutionVersion(sddPath) {
+  const constitutionPath = path12.join(sddPath, "constitution.md");
+  if (!await fileExists(constitutionPath)) {
+    return void 0;
+  }
+  const constResult = await readFile(constitutionPath);
+  if (!constResult.success) {
+    return void 0;
+  }
+  const parseResult = parseConstitution(constResult.data);
+  if (!parseResult.success) {
+    return void 0;
+  }
+  return parseResult.data.metadata.version;
+}
+async function createFeature(sddPath, name, options) {
+  let featureId;
+  let branchName;
+  if (options.numbered) {
+    const numberResult = await getNextFeatureNumber(sddPath, name);
+    if (!numberResult.success) {
+      return failure(new Error(`\uBC88\uD638 \uC0DD\uC131 \uC2E4\uD328: ${numberResult.error.message}`));
+    }
+    featureId = numberResult.data.fullId;
+    branchName = numberResult.data.branchName;
+  } else {
+    featureId = generateFeatureId(name);
+  }
+  const title2 = options.title || name;
+  const description = options.description || `${title2} \uAE30\uB2A5 \uBA85\uC138`;
+  const featurePath = path12.join(sddPath, "specs", featureId);
+  const dirResult = await ensureDir(featurePath);
+  if (!dirResult.success) {
+    return failure(new Error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${featurePath}`));
+  }
+  const constitutionVersion = await getConstitutionVersion(sddPath);
+  const filesCreated = [];
+  const specContent = generateSpec({
+    id: featureId,
+    title: title2,
+    description,
+    constitutionVersion
+  });
+  await writeFile(path12.join(featurePath, "spec.md"), specContent);
+  filesCreated.push("spec.md");
+  if (options.plan || options.all) {
+    const planContent = generatePlan({
+      featureId,
+      featureTitle: title2,
+      overview: description
+    });
+    await writeFile(path12.join(featurePath, "plan.md"), planContent);
+    filesCreated.push("plan.md");
+  }
+  if (options.tasks || options.all) {
+    const tasksContent = generateTasks({
+      featureId,
+      featureTitle: title2,
+      tasks: [
+        { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
+        { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
+        { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
+        { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
+      ]
+    });
+    await writeFile(path12.join(featurePath, "tasks.md"), tasksContent);
+    filesCreated.push("tasks.md");
+  }
+  if (options.checklist || options.all) {
+    const checklistContent = generateFullChecklistMarkdown();
+    await writeFile(path12.join(featurePath, "checklist.md"), checklistContent);
+    filesCreated.push("checklist.md");
+  }
+  return success({
+    featureId,
+    featurePath,
+    branchName,
+    filesCreated
+  });
+}
+async function createPlan(featurePath, featureId, title2) {
+  if (!await fileExists(featurePath)) {
+    return failure(new Error(`\uAE30\uB2A5 '${featureId}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+  }
+  let featureTitle = title2 || featureId;
+  const specPath = path12.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    const specResult = await readFile(specPath);
+    if (specResult.success) {
+      const titleMatch = specResult.data.match(/title:\s*"?([^"\n]+)"?/);
+      if (titleMatch) {
+        featureTitle = titleMatch[1];
+      }
+    }
+  }
+  const planContent = generatePlan({
+    featureId,
+    featureTitle,
+    overview: `${featureTitle} \uAD6C\uD604 \uACC4\uD68D`
+  });
+  const planPath = path12.join(featurePath, "plan.md");
+  await writeFile(planPath, planContent);
+  return success(planPath);
+}
+async function createTasks(featurePath, featureId) {
+  if (!await fileExists(featurePath)) {
+    return failure(new Error(`\uAE30\uB2A5 '${featureId}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+  }
+  let featureTitle = featureId;
+  const specPath = path12.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    const specResult = await readFile(specPath);
+    if (specResult.success) {
+      const titleMatch = specResult.data.match(/title:\s*"?([^"\n]+)"?/);
+      if (titleMatch) {
+        featureTitle = titleMatch[1];
+      }
+    }
+  }
+  const tasksContent = generateTasks({
+    featureId,
+    featureTitle,
+    tasks: [
+      { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
+      { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
+      { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
+      { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
+    ]
+  });
+  const tasksPath = path12.join(featurePath, "tasks.md");
+  await writeFile(tasksPath, tasksContent);
+  return success(tasksPath);
+}
+async function createChecklist2(sddPath) {
+  if (!await fileExists(sddPath)) {
+    return failure(new Error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const checklistContent = generateFullChecklistMarkdown();
+  const outputPath = path12.join(sddPath, "checklist.md");
+  await writeFile(outputPath, checklistContent);
+  return success(outputPath);
+}
+async function getCounterStatus(sddPath) {
+  const peekResult = await peekNextFeatureNumber(sddPath);
+  if (!peekResult.success) {
+    return failure(new Error(`\uCE74\uC6B4\uD130 \uC870\uD68C \uC2E4\uD328: ${peekResult.error.message}`));
+  }
+  const historyResult = await getFeatureHistory(sddPath);
+  if (!historyResult.success) {
+    return failure(new Error(`\uC774\uB825 \uC870\uD68C \uC2E4\uD328: ${historyResult.error.message}`));
+  }
+  return success({
+    nextNumber: peekResult.data,
+    totalFeatures: historyResult.data.length
+  });
+}
+function registerNewCommand(program2) {
+  const newCmd = program2.command("new").description("\uC0C8\uB85C\uC6B4 \uAE30\uB2A5 \uC0DD\uC131").argument("[name]", "\uAE30\uB2A5 \uC774\uB984").option("--title <title>", "\uAE30\uB2A5 \uC81C\uBAA9").option("--description <desc>", "\uAE30\uB2A5 \uC124\uBA85").option("--no-branch", "\uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC548 \uD568").option("--numbered", "\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC (feature/001-name \uD615\uC2DD)").option("--plan", "\uACC4\uD68D \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--tasks", "\uC791\uC5C5 \uBD84\uD574 \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--all", "\uBAA8\uB4E0 \uD30C\uC77C \uC0DD\uC131 (spec, plan, tasks)").option("--checklist", "\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uD30C\uC77C \uC0DD\uC131").action(async (name, options) => {
+    await handleNew(name, options);
+  });
+  newCmd.command("plan").description("\uAE30\uB2A5 \uAD6C\uD604 \uACC4\uD68D \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").option("--title <title>", "\uACC4\uD68D \uC81C\uBAA9").action(async (feature, opts) => {
+    await handlePlan(feature, opts);
+  });
   newCmd.command("tasks").description("\uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").action(async (feature) => {
     await handleTasks(feature);
   });
@@ -6886,193 +7269,88 @@ async function handleNew(name, options) {
   }
   const cwd = process.cwd();
   const sddPath = path12.join(cwd, ".sdd");
-  let featureId;
-  let branchName;
-  if (options.numbered) {
-    const numberResult = await getNextFeatureNumber(sddPath, name);
-    if (!numberResult.success) {
-      logger_exports.error(`\uBC88\uD638 \uC0DD\uC131 \uC2E4\uD328: ${numberResult.error.message}`);
-      process.exit(1);
-    }
-    featureId = numberResult.data.fullId;
-    branchName = numberResult.data.branchName;
-    logger_exports.info(`\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC: #${numberResult.data.number.toString().padStart(3, "0")}`);
-  } else {
-    featureId = generateFeatureId(name);
+  if (!await fileExists(sddPath)) {
+    logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
+    process.exit(1);
   }
-  const title2 = options.title || name;
-  const description = options.description || `${title2} \uAE30\uB2A5 \uBA85\uC138`;
-  const featurePath = path12.join(sddPath, "specs", featureId);
-  try {
-    if (!await fileExists(sddPath)) {
-      logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
-      process.exit(1);
-    }
-    await ensureDir(featurePath);
-    let constitutionVersion;
-    const constitutionPath = path12.join(sddPath, "constitution.md");
-    if (await fileExists(constitutionPath)) {
-      const constResult = await readFile(constitutionPath);
-      if (constResult.success) {
-        const parseResult = parseConstitution(constResult.data);
-        if (parseResult.success) {
-          constitutionVersion = parseResult.data.metadata.version;
-        }
-      }
+  const result = await createFeature(sddPath, name, options);
+  if (!result.success) {
+    logger_exports.error(`\uAE30\uB2A5 \uC0DD\uC131 \uC2E4\uD328: ${result.error.message}`);
+    process.exit(1);
+  }
+  const { featureId, featurePath, branchName, filesCreated } = result.data;
+  if (options.numbered && branchName) {
+    const numberMatch = branchName.match(/feature\/(\d+)-/);
+    if (numberMatch) {
+      logger_exports.info(`\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC: #${numberMatch[1]}`);
     }
-    const specContent = generateSpec({
-      id: featureId,
-      title: title2,
-      description,
-      constitutionVersion
-    });
-    await fs7.writeFile(path12.join(featurePath, "spec.md"), specContent, "utf-8");
-    logger_exports.info(`\u2705 \uBA85\uC138 \uC0DD\uC131: ${featurePath}/spec.md`);
-    if (options.branch !== false) {
-      if (await isGitRepository(cwd)) {
-        const branchToCreate = branchName || featureId;
-        const result = await createBranch(branchToCreate, { checkout: true, cwd });
-        if (result.success) {
-          logger_exports.info(`\u2705 \uBE0C\uB79C\uCE58 \uC0DD\uC131: ${result.data}`);
-        } else {
-          logger_exports.warn(`\u26A0\uFE0F \uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC2E4\uD328: ${result.error.message}`);
-        }
+  }
+  for (const file of filesCreated) {
+    logger_exports.info(`\u2705 ${file} \uC0DD\uC131: ${featurePath}/${file}`);
+  }
+  if (options.branch !== false) {
+    if (await isGitRepository(cwd)) {
+      const branchToCreate = branchName || featureId;
+      const branchResult = await createBranch(branchToCreate, { checkout: true, cwd });
+      if (branchResult.success) {
+        logger_exports.info(`\u2705 \uBE0C\uB79C\uCE58 \uC0DD\uC131: ${branchResult.data}`);
       } else {
-        logger_exports.warn("\u26A0\uFE0F Git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uBE0C\uB79C\uCE58 \uC0DD\uC131\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4.");
+        logger_exports.warn(`\u26A0\uFE0F \uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC2E4\uD328: ${branchResult.error.message}`);
       }
+    } else {
+      logger_exports.warn("\u26A0\uFE0F Git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uBE0C\uB79C\uCE58 \uC0DD\uC131\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4.");
     }
-    if (options.plan || options.all) {
-      const planContent = generatePlan({
-        featureId,
-        featureTitle: title2,
-        overview: description
-      });
-      await fs7.writeFile(path12.join(featurePath, "plan.md"), planContent, "utf-8");
-      logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${featurePath}/plan.md`);
-    }
-    if (options.tasks || options.all) {
-      const tasksContent = generateTasks({
-        featureId,
-        featureTitle: title2,
-        tasks: [
-          { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
-          { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
-          { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
-          { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
-        ]
-      });
-      await fs7.writeFile(path12.join(featurePath, "tasks.md"), tasksContent, "utf-8");
-      logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${featurePath}/tasks.md`);
-    }
-    if (options.checklist || options.all) {
-      const checklistContent = generateFullChecklistMarkdown();
-      await fs7.writeFile(path12.join(featurePath, "checklist.md"), checklistContent, "utf-8");
-      logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${featurePath}/checklist.md`);
-    }
-    logger_exports.info("");
-    logger_exports.info(`\u{1F389} \uAE30\uB2A5 '${featureId}' \uC0DD\uC131 \uC644\uB8CC!`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/spec.md \uD3B8\uC9D1`);
-    if (!(options.plan || options.all)) {
-      logger_exports.info("  2. sdd new plan " + featureId + " - \uACC4\uD68D \uC791\uC131");
-    }
-    if (!(options.tasks || options.all)) {
-      logger_exports.info("  3. sdd new tasks " + featureId + " - \uC791\uC5C5 \uBD84\uD574");
-    }
-    logger_exports.info("  4. sdd validate - \uBA85\uC138 \uAC80\uC99D");
-  } catch (error2) {
-    logger_exports.error(`\uAE30\uB2A5 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
-    process.exit(1);
   }
+  logger_exports.info("");
+  logger_exports.info(`\u{1F389} \uAE30\uB2A5 '${featureId}' \uC0DD\uC131 \uC644\uB8CC!`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/spec.md \uD3B8\uC9D1`);
+  if (!(options.plan || options.all)) {
+    logger_exports.info("  2. sdd new plan " + featureId + " - \uACC4\uD68D \uC791\uC131");
+  }
+  if (!(options.tasks || options.all)) {
+    logger_exports.info("  3. sdd new tasks " + featureId + " - \uC791\uC5C5 \uBD84\uD574");
+  }
+  logger_exports.info("  4. sdd validate - \uBA85\uC138 \uAC80\uC99D");
 }
 async function handlePlan(feature, options) {
   const cwd = process.cwd();
   const featurePath = path12.join(cwd, ".sdd", "specs", feature);
-  try {
-    if (!await fileExists(featurePath)) {
-      logger_exports.error(`\uAE30\uB2A5 '${feature}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-      process.exit(1);
-    }
-    let title2 = options.title || feature;
-    const specPath = path12.join(featurePath, "spec.md");
-    if (await fileExists(specPath)) {
-      const specContent = await fs7.readFile(specPath, "utf-8");
-      const titleMatch = specContent.match(/title:\s*"?([^"\n]+)"?/);
-      if (titleMatch) {
-        title2 = titleMatch[1];
-      }
-    }
-    const planContent = generatePlan({
-      featureId: feature,
-      featureTitle: title2,
-      overview: `${title2} \uAD6C\uD604 \uACC4\uD68D`
-    });
-    await fs7.writeFile(path12.join(featurePath, "plan.md"), planContent, "utf-8");
-    logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${featurePath}/plan.md`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/plan.md \uD3B8\uC9D1`);
-    logger_exports.info("  2. sdd new tasks " + feature + " - \uC791\uC5C5 \uBD84\uD574");
-  } catch (error2) {
-    logger_exports.error(`\uACC4\uD68D \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createPlan(featurePath, feature, options.title);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${result.data}`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/plan.md \uD3B8\uC9D1`);
+  logger_exports.info("  2. sdd new tasks " + feature + " - \uC791\uC5C5 \uBD84\uD574");
 }
 async function handleTasks(feature) {
   const cwd = process.cwd();
   const featurePath = path12.join(cwd, ".sdd", "specs", feature);
-  try {
-    if (!await fileExists(featurePath)) {
-      logger_exports.error(`\uAE30\uB2A5 '${feature}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-      process.exit(1);
-    }
-    let title2 = feature;
-    const specPath = path12.join(featurePath, "spec.md");
-    if (await fileExists(specPath)) {
-      const specContent = await fs7.readFile(specPath, "utf-8");
-      const titleMatch = specContent.match(/title:\s*"?([^"\n]+)"?/);
-      if (titleMatch) {
-        title2 = titleMatch[1];
-      }
-    }
-    const tasksContent = generateTasks({
-      featureId: feature,
-      featureTitle: title2,
-      tasks: [
-        { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
-        { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
-        { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
-        { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
-      ]
-    });
-    await fs7.writeFile(path12.join(featurePath, "tasks.md"), tasksContent, "utf-8");
-    logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${featurePath}/tasks.md`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/tasks.md \uD3B8\uC9D1`);
-    logger_exports.info("  2. \uAC01 \uC791\uC5C5 \uC21C\uCC28\uC801\uC73C\uB85C \uAD6C\uD604");
-  } catch (error2) {
-    logger_exports.error(`\uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createTasks(featurePath, feature);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${result.data}`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/tasks.md \uD3B8\uC9D1`);
+  logger_exports.info("  2. \uAC01 \uC791\uC5C5 \uC21C\uCC28\uC801\uC73C\uB85C \uAD6C\uD604");
 }
 async function handleChecklist() {
   const cwd = process.cwd();
   const sddPath = path12.join(cwd, ".sdd");
-  try {
-    if (!await fileExists(sddPath)) {
-      logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
-      process.exit(1);
-    }
-    const checklistContent = generateFullChecklistMarkdown();
-    const outputPath = path12.join(sddPath, "checklist.md");
-    await fs7.writeFile(outputPath, checklistContent, "utf-8");
-    logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${outputPath}`);
-  } catch (error2) {
-    logger_exports.error(`\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createChecklist2(sddPath);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${result.data}`);
 }
 async function handleCounter(options) {
   const cwd = process.cwd();
@@ -7131,39 +7409,65 @@ async function handleCounter(options) {
     }
     return;
   }
-  const peekResult = await peekNextFeatureNumber(sddPath);
-  const historyResult = await getFeatureHistory(sddPath);
-  if (peekResult.success && historyResult.success) {
+  const statusResult = await getCounterStatus(sddPath);
+  if (statusResult.success) {
     logger_exports.info("=== \uAE30\uB2A5 \uBC88\uD638 \uCE74\uC6B4\uD130 \uC0C1\uD0DC ===");
     logger_exports.info("");
-    logger_exports.info(`\uB2E4\uC74C \uBC88\uD638: #${String(peekResult.data).padStart(3, "0")}`);
-    logger_exports.info(`\uC0DD\uC131\uB41C \uAE30\uB2A5 \uC218: ${historyResult.data.length}\uAC1C`);
+    logger_exports.info(`\uB2E4\uC74C \uBC88\uD638: #${String(statusResult.data.nextNumber).padStart(3, "0")}`);
+    logger_exports.info(`\uC0DD\uC131\uB41C \uAE30\uB2A5 \uC218: ${statusResult.data.totalFeatures}\uAC1C`);
     logger_exports.info("");
     logger_exports.info("\uC635\uC158:");
     logger_exports.info("  --peek     \uB2E4\uC74C \uBC88\uD638 \uD655\uC778");
     logger_exports.info("  --history  \uC0DD\uC131 \uC774\uB825 \uC870\uD68C");
     logger_exports.info("  --set <n>  \uB2E4\uC74C \uBC88\uD638 \uC124\uC815");
   } else {
-    logger_exports.error("\uCE74\uC6B4\uD130 \uC0C1\uD0DC \uC870\uD68C \uC2E4\uD328");
+    logger_exports.error(statusResult.error.message);
     process.exit(1);
   }
 }
 
 // src/cli/commands/status.ts
 import path13 from "path";
-import { promises as fs8 } from "fs";
+import { promises as fs7 } from "fs";
 init_fs();
 init_spec_generator();
 init_task_generator();
 init_branch();
-function registerStatusCommand(program2) {
-  program2.command("status").description("SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC870\uD68C").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--verbose", "\uC0C1\uC138 \uC815\uBCF4 \uCD9C\uB825").action(async (options) => {
-    await handleStatus(options);
-  });
+async function getFeatureInfo(id, featurePath) {
+  const info2 = {
+    id,
+    title: id,
+    status: "unknown",
+    hasSpec: false,
+    hasPlan: false,
+    hasTasks: false
+  };
+  const specPath = path13.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    info2.hasSpec = true;
+    const content = await fs7.readFile(specPath, "utf-8");
+    const metadata = parseSpecMetadata(content);
+    if (metadata) {
+      info2.title = metadata.title;
+      info2.status = metadata.status;
+    }
+  }
+  info2.hasPlan = await fileExists(path13.join(featurePath, "plan.md"));
+  const tasksPath = path13.join(featurePath, "tasks.md");
+  if (await fileExists(tasksPath)) {
+    info2.hasTasks = true;
+    const content = await fs7.readFile(tasksPath, "utf-8");
+    const tasks = parseTasks(content);
+    const completed = tasks.filter((t) => t.status === "completed").length;
+    info2.taskProgress = {
+      completed,
+      total: tasks.length
+    };
+  }
+  return info2;
 }
-async function handleStatus(options) {
-  const cwd = process.cwd();
-  const sddPath = path13.join(cwd, ".sdd");
+async function getProjectStatus(projectPath) {
+  const sddPath = path13.join(projectPath, ".sdd");
   const status = {
     initialized: false,
     hasConstitution: false,
@@ -7175,13 +7479,7 @@ async function handleStatus(options) {
   };
   status.initialized = await fileExists(sddPath);
   if (!status.initialized) {
-    if (options.json) {
-      console.log(JSON.stringify(status, null, 2));
-    } else {
-      logger_exports.warn("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
-      logger_exports.info("sdd init \uBA85\uB839\uC5B4\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
-    }
-    return;
+    return status;
   }
   status.hasConstitution = await fileExists(path13.join(sddPath, "constitution.md"));
   status.hasAgents = await fileExists(path13.join(sddPath, "AGENTS.md"));
@@ -7191,7 +7489,7 @@ async function handleStatus(options) {
     if (specsResult.success) {
       for (const entry of specsResult.data) {
         const featurePath = path13.join(specsPath, entry);
-        const stat = await fs8.stat(featurePath);
+        const stat = await fs7.stat(featurePath);
         if (stat.isDirectory()) {
           const featureInfo = await getFeatureInfo(entry, featurePath);
           status.features.push(featureInfo);
@@ -7207,52 +7505,56 @@ async function handleStatus(options) {
   if (archiveResult.success) {
     status.archivedChanges = archiveResult.data.length;
   }
-  const currentBranchResult = await getCurrentBranch(cwd);
+  const currentBranchResult = await getCurrentBranch(projectPath);
   if (currentBranchResult.success) {
     status.currentBranch = currentBranchResult.data;
   }
-  const featureBranchesResult = await listFeatureBranches(cwd);
+  const featureBranchesResult = await listFeatureBranches(projectPath);
   if (featureBranchesResult.success) {
     status.featureBranches = featureBranchesResult.data;
   }
-  if (options.json) {
-    console.log(JSON.stringify(status, null, 2));
-  } else {
-    printStatus(status, options.verbose);
+  return status;
+}
+function getStatusIcon(status) {
+  switch (status) {
+    case "draft":
+      return "\u{1F4DD}";
+    case "specified":
+      return "\u{1F4C4}";
+    case "planned":
+      return "\u{1F4CB}";
+    case "tasked":
+      return "\u270F\uFE0F";
+    case "implementing":
+      return "\u{1F528}";
+    case "completed":
+      return "\u2705";
+    default:
+      return "\u2753";
   }
 }
-async function getFeatureInfo(id, featurePath) {
-  const info2 = {
-    id,
-    title: id,
-    status: "unknown",
-    hasSpec: false,
-    hasPlan: false,
-    hasTasks: false
-  };
-  const specPath = path13.join(featurePath, "spec.md");
-  if (await fileExists(specPath)) {
-    info2.hasSpec = true;
-    const content = await fs8.readFile(specPath, "utf-8");
-    const metadata = parseSpecMetadata(content);
-    if (metadata) {
-      info2.title = metadata.title;
-      info2.status = metadata.status;
+function registerStatusCommand(program2) {
+  program2.command("status").description("SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC870\uD68C").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--verbose", "\uC0C1\uC138 \uC815\uBCF4 \uCD9C\uB825").action(async (options) => {
+    await handleStatus(options);
+  });
+}
+async function handleStatus(options) {
+  const cwd = process.cwd();
+  const status = await getProjectStatus(cwd);
+  if (!status.initialized) {
+    if (options.json) {
+      console.log(JSON.stringify(status, null, 2));
+    } else {
+      logger_exports.warn("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+      logger_exports.info("sdd init \uBA85\uB839\uC5B4\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
     }
+    return;
   }
-  info2.hasPlan = await fileExists(path13.join(featurePath, "plan.md"));
-  const tasksPath = path13.join(featurePath, "tasks.md");
-  if (await fileExists(tasksPath)) {
-    info2.hasTasks = true;
-    const content = await fs8.readFile(tasksPath, "utf-8");
-    const tasks = parseTasks(content);
-    const completed = tasks.filter((t) => t.status === "completed").length;
-    info2.taskProgress = {
-      completed,
-      total: tasks.length
-    };
+  if (options.json) {
+    console.log(JSON.stringify(status, null, 2));
+  } else {
+    printStatus(status, options.verbose);
   }
-  return info2;
 }
 function printStatus(status, verbose) {
   console.log("");
@@ -7331,32 +7633,155 @@ function printStatus(status, verbose) {
       }
     }
   }
-  console.log("");
-}
-function getStatusIcon(status) {
-  switch (status) {
-    case "draft":
-      return "\u{1F4DD}";
-    case "specified":
-      return "\u{1F4C4}";
-    case "planned":
-      return "\u{1F4CB}";
-    case "tasked":
-      return "\u270F\uFE0F";
-    case "implementing":
-      return "\u{1F528}";
-    case "completed":
-      return "\u2705";
-    default:
-      return "\u2753";
-  }
+  console.log("");
+}
+
+// src/cli/commands/list.ts
+import path14 from "path";
+import { promises as fs8 } from "fs";
+init_fs();
+init_spec_generator();
+function getListStatusIcon(status) {
+  switch (status) {
+    case "draft":
+      return "\u{1F4DD}";
+    case "specified":
+      return "\u{1F4C4}";
+    case "planned":
+      return "\u{1F4CB}";
+    case "tasked":
+      return "\u270F\uFE0F";
+    case "implementing":
+      return "\u{1F528}";
+    case "completed":
+      return "\u2705";
+    default:
+      return "\u2753";
+  }
+}
+async function getFeatureList(projectPath, options = {}) {
+  const specsPath = path14.join(projectPath, ".sdd", "specs");
+  if (!await fileExists(specsPath)) {
+    return [];
+  }
+  const result = await readDir(specsPath);
+  if (!result.success) {
+    return [];
+  }
+  const features = [];
+  for (const entry of result.data) {
+    const featurePath = path14.join(specsPath, entry);
+    const stat = await fs8.stat(featurePath);
+    if (stat.isDirectory()) {
+      const specPath = path14.join(featurePath, "spec.md");
+      if (await fileExists(specPath)) {
+        const content = await fs8.readFile(specPath, "utf-8");
+        const metadata = parseSpecMetadata(content);
+        if (metadata) {
+          if (!options.status || metadata.status === options.status) {
+            features.push({
+              id: entry,
+              title: metadata.title,
+              status: metadata.status
+            });
+          }
+        }
+      }
+    }
+  }
+  return features;
+}
+async function getChangeList(projectPath, options = {}) {
+  const sddPath = path14.join(projectPath, ".sdd");
+  const result = {
+    pending: [],
+    archived: []
+  };
+  if (!await fileExists(sddPath)) {
+    return result;
+  }
+  if (!options.archived) {
+    const pendingResult = await listPendingChanges(sddPath);
+    if (pendingResult.success) {
+      result.pending = pendingResult.data.map((c) => String(c));
+    }
+  }
+  if (!options.pending) {
+    const archiveResult = await listArchives(sddPath);
+    if (archiveResult.success) {
+      result.archived = archiveResult.data.map((a) => a.id);
+    }
+  }
+  return result;
+}
+async function getSpecFileTree(specsPath) {
+  if (!await fileExists(specsPath)) {
+    return [];
+  }
+  return walkSpecsTree(specsPath);
+}
+async function walkSpecsTree(basePath) {
+  const result = await readDir(basePath);
+  if (!result.success) return [];
+  const items = [];
+  for (const entry of result.data) {
+    const fullPath = path14.join(basePath, entry);
+    const stat = await fs8.stat(fullPath);
+    if (stat.isDirectory()) {
+      const children = await walkSpecsTree(fullPath);
+      items.push({
+        path: fullPath,
+        name: entry,
+        isDirectory: true,
+        children
+      });
+    } else if (entry.endsWith(".md")) {
+      items.push({
+        path: fullPath,
+        name: entry,
+        isDirectory: false
+      });
+    }
+  }
+  return items;
+}
+async function getTemplateList(projectPath) {
+  const templatesPath = path14.join(projectPath, ".sdd", "templates");
+  if (!await fileExists(templatesPath)) {
+    return [];
+  }
+  const result = await readDir(templatesPath);
+  if (!result.success) {
+    return [];
+  }
+  return result.data.filter((f) => f.endsWith(".md"));
+}
+async function getProjectSummary(projectPath) {
+  const sddPath = path14.join(projectPath, ".sdd");
+  if (!await fileExists(sddPath)) {
+    return null;
+  }
+  const specsPath = path14.join(sddPath, "specs");
+  let featureCount = 0;
+  if (await fileExists(specsPath)) {
+    const result = await readDir(specsPath);
+    if (result.success) {
+      for (const entry of result.data) {
+        const stat = await fs8.stat(path14.join(specsPath, entry));
+        if (stat.isDirectory()) featureCount++;
+      }
+    }
+  }
+  const pendingResult = await listPendingChanges(sddPath);
+  const pendingChangeCount = pendingResult.success ? pendingResult.data.length : 0;
+  const archiveResult = await listArchives(sddPath);
+  const archivedChangeCount = archiveResult.success ? archiveResult.data.length : 0;
+  return {
+    featureCount,
+    pendingChangeCount,
+    archivedChangeCount
+  };
 }
-
-// src/cli/commands/list.ts
-import path14 from "path";
-import { promises as fs9 } from "fs";
-init_fs();
-init_spec_generator();
 function registerListCommand(program2) {
   const listCmd = program2.command("list").alias("ls").description("\uD56D\uBAA9 \uBAA9\uB85D \uC870\uD68C");
   listCmd.command("features").alias("f").description("\uAE30\uB2A5 \uBAA9\uB85D \uC870\uD68C").option("--status <status>", "\uC0C1\uD0DC\uBCC4 \uD544\uD130 (draft, specified, planned, etc.)").action(async (options) => {
@@ -7376,38 +7801,7 @@ function registerListCommand(program2) {
   });
 }
 async function listFeatures(options) {
-  const cwd = process.cwd();
-  const specsPath = path14.join(cwd, ".sdd", "specs");
-  if (!await fileExists(specsPath)) {
-    logger_exports.warn("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    return;
-  }
-  const result = await readDir(specsPath);
-  if (!result.success) {
-    logger_exports.error("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    return;
-  }
-  const features = [];
-  for (const entry of result.data) {
-    const featurePath = path14.join(specsPath, entry);
-    const stat = await fs9.stat(featurePath);
-    if (stat.isDirectory()) {
-      const specPath = path14.join(featurePath, "spec.md");
-      if (await fileExists(specPath)) {
-        const content = await fs9.readFile(specPath, "utf-8");
-        const metadata = parseSpecMetadata(content);
-        if (metadata) {
-          if (!options.status || metadata.status === options.status) {
-            features.push({
-              id: entry,
-              title: metadata.title,
-              status: metadata.status
-            });
-          }
-        }
-      }
-    }
-  }
+  const features = await getFeatureList(process.cwd(), options);
   if (features.length === 0) {
     logger_exports.info("\uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
@@ -7416,25 +7810,19 @@ async function listFeatures(options) {
   console.log("\u{1F4CB} \uAE30\uB2A5 \uBAA9\uB85D");
   console.log("\u2500".repeat(50));
   for (const f of features) {
-    const statusIcon = getStatusIcon2(f.status);
+    const statusIcon = getListStatusIcon(f.status);
     console.log(`${statusIcon} ${f.title} (${f.id}) - ${f.status}`);
   }
   console.log("");
 }
 async function listChanges(options) {
-  const cwd = process.cwd();
-  const sddPath = path14.join(cwd, ".sdd");
-  if (!await fileExists(sddPath)) {
-    logger_exports.warn(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    return;
-  }
+  const result = await getChangeList(process.cwd(), options);
   console.log("");
   if (!options.archived) {
-    const pendingResult = await listPendingChanges(sddPath);
-    if (pendingResult.success && pendingResult.data.length > 0) {
+    if (result.pending.length > 0) {
       console.log("\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD");
       console.log("\u2500".repeat(30));
-      for (const change of pendingResult.data) {
+      for (const change of result.pending) {
         console.log(`  - ${change}`);
       }
       console.log("");
@@ -7443,11 +7831,10 @@ async function listChanges(options) {
     }
   }
   if (!options.pending) {
-    const archiveResult = await listArchives(sddPath);
-    if (archiveResult.success && archiveResult.data.length > 0) {
+    if (result.archived.length > 0) {
       console.log("\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD");
       console.log("\u2500".repeat(30));
-      for (const archive of archiveResult.data) {
+      for (const archive of result.archived) {
         console.log(`  - ${archive}`);
       }
       console.log("");
@@ -7457,80 +7844,56 @@ async function listChanges(options) {
   }
 }
 async function listSpecs() {
-  const cwd = process.cwd();
-  const specsPath = path14.join(cwd, ".sdd", "specs");
-  if (!await fileExists(specsPath)) {
+  const specsPath = path14.join(process.cwd(), ".sdd", "specs");
+  const tree = await getSpecFileTree(specsPath);
+  if (tree.length === 0) {
     logger_exports.warn("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
   }
   console.log("");
   console.log("\u{1F4C4} \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D");
   console.log("\u2500".repeat(50));
-  await walkSpecs(specsPath, "");
+  printSpecTree(tree, "");
   console.log("");
 }
-async function walkSpecs(basePath, prefix) {
-  const result = await readDir(basePath);
-  if (!result.success) return;
-  for (const entry of result.data) {
-    const fullPath = path14.join(basePath, entry);
-    const stat = await fs9.stat(fullPath);
-    if (stat.isDirectory()) {
-      console.log(`${prefix}\u{1F4C1} ${entry}/`);
-      await walkSpecs(fullPath, prefix + "   ");
-    } else if (entry.endsWith(".md")) {
-      console.log(`${prefix}\u{1F4C4} ${entry}`);
+function printSpecTree(items, prefix) {
+  for (const item of items) {
+    if (item.isDirectory) {
+      console.log(`${prefix}\u{1F4C1} ${item.name}/`);
+      if (item.children) {
+        printSpecTree(item.children, prefix + "   ");
+      }
+    } else {
+      console.log(`${prefix}\u{1F4C4} ${item.name}`);
     }
   }
 }
 async function listTemplates() {
-  const cwd = process.cwd();
-  const templatesPath = path14.join(cwd, ".sdd", "templates");
-  if (!await fileExists(templatesPath)) {
+  const templates = await getTemplateList(process.cwd());
+  if (templates.length === 0) {
     logger_exports.warn("\uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
   }
-  const result = await readDir(templatesPath);
-  if (!result.success) {
-    logger_exports.error("\uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    return;
-  }
   console.log("");
   console.log("\u{1F4D1} \uD15C\uD50C\uB9BF \uBAA9\uB85D");
   console.log("\u2500".repeat(30));
-  for (const template of result.data.filter((f) => f.endsWith(".md"))) {
+  for (const template of templates) {
     console.log(`  - ${template}`);
   }
   console.log("");
 }
 async function listSummary() {
-  const cwd = process.cwd();
-  const sddPath = path14.join(cwd, ".sdd");
-  if (!await fileExists(sddPath)) {
+  const summary = await getProjectSummary(process.cwd());
+  if (!summary) {
     logger_exports.warn(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     return;
   }
   console.log("");
   console.log("\u{1F4CA} SDD \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D");
   console.log("\u2550".repeat(40));
-  const specsPath = path14.join(sddPath, "specs");
-  let featureCount = 0;
-  if (await fileExists(specsPath)) {
-    const result = await readDir(specsPath);
-    if (result.success) {
-      for (const entry of result.data) {
-        const stat = await fs9.stat(path14.join(specsPath, entry));
-        if (stat.isDirectory()) featureCount++;
-      }
-    }
-  }
-  console.log(`\u{1F4CB} \uAE30\uB2A5: ${featureCount}\uAC1C`);
-  const pendingResult = await listPendingChanges(sddPath);
-  const pendingCount = pendingResult.success ? pendingResult.data.length : 0;
-  console.log(`\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD: ${pendingCount}\uAC1C`);
-  const archiveResult = await listArchives(sddPath);
-  const archiveCount = archiveResult.success ? archiveResult.data.length : 0;
-  console.log(`\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD: ${archiveCount}\uAC1C`);
+  console.log(`\u{1F4CB} \uAE30\uB2A5: ${summary.featureCount}\uAC1C`);
+  console.log(`\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD: ${summary.pendingChangeCount}\uAC1C`);
+  console.log(`\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD: ${summary.archivedChangeCount}\uAC1C`);
   console.log("");
   console.log("\uC0C1\uC138 \uC815\uBCF4:");
   console.log("  sdd list features - \uAE30\uB2A5 \uBAA9\uB85D");
@@ -7539,29 +7902,134 @@ async function listSummary() {
   console.log("  sdd status        - \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC");
   console.log("");
 }
-function getStatusIcon2(status) {
-  switch (status) {
-    case "draft":
-      return "\u{1F4DD}";
-    case "specified":
-      return "\u{1F4C4}";
-    case "planned":
-      return "\u{1F4CB}";
-    case "tasked":
-      return "\u270F\uFE0F";
-    case "implementing":
-      return "\u{1F528}";
-    case "completed":
-      return "\u2705";
-    default:
-      return "\u2753";
-  }
-}
 
 // src/cli/commands/constitution.ts
 init_fs();
 init_errors();
 import path15 from "path";
+init_types();
+function determineBumpType(options) {
+  if (options.major) return "major";
+  if (options.minor) return "minor";
+  if (options.patch) return "patch";
+  return null;
+}
+async function readConstitution(projectPath) {
+  const constitutionPath = path15.join(projectPath, ".sdd", "constitution.md");
+  if (!await fileExists(constitutionPath)) {
+    return failure(new Error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694."));
+  }
+  const contentResult = await readFile(constitutionPath);
+  if (!contentResult.success) {
+    return failure(new Error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseConstitution(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    content: contentResult.data,
+    parsed: parseResult.data
+  });
+}
+function constitutionToJson(constitution) {
+  return {
+    projectName: constitution.projectName,
+    version: constitution.metadata.version,
+    created: constitution.metadata.created,
+    updated: constitution.metadata.updated,
+    principles: constitution.principles,
+    forbidden: constitution.forbidden,
+    techStack: constitution.techStack,
+    qualityStandards: constitution.qualityStandards
+  };
+}
+async function executeBump(projectPath, bumpType, message) {
+  const constitutionPath = path15.join(projectPath, ".sdd", "constitution.md");
+  const changelogPath = path15.join(projectPath, ".sdd", "CHANGELOG.md");
+  const readResult = await readConstitution(projectPath);
+  if (!readResult.success) {
+    return failure(readResult.error);
+  }
+  const { content, parsed } = readResult.data;
+  const currentVersion = parsed.metadata.version;
+  const newVersion = bumpVersion(currentVersion, bumpType);
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  let updatedContent = content;
+  updatedContent = updatedContent.replace(
+    /^version:\s*.+$/m,
+    `version: ${newVersion}`
+  );
+  if (/^updated:/m.test(updatedContent)) {
+    updatedContent = updatedContent.replace(
+      /^updated:\s*.+$/m,
+      `updated: ${today}`
+    );
+  } else {
+    updatedContent = updatedContent.replace(
+      /^(version:\s*.+)$/m,
+      `$1
+updated: ${today}`
+    );
+  }
+  await writeFile(constitutionPath, updatedContent);
+  const changeType = bumpType === "major" ? "changed" : bumpType === "minor" ? "added" : "fixed";
+  const changeDescription = message || `Constitution ${bumpType} \uC5C5\uB370\uC774\uD2B8`;
+  const newEntry = createChangelogEntry(
+    currentVersion,
+    bumpType,
+    [{ type: changeType, description: changeDescription }],
+    message
+  );
+  let existingEntries = [];
+  if (await fileExists(changelogPath)) {
+    const changelogContent = await readFile(changelogPath);
+    if (changelogContent.success) {
+      const parsed2 = parseChangelog(changelogContent.data);
+      if (parsed2.success) {
+        existingEntries = parsed2.data;
+      }
+    }
+  }
+  const allEntries = [newEntry, ...existingEntries];
+  const newChangelog = generateChangelog(allEntries);
+  await writeFile(changelogPath, newChangelog);
+  return success({
+    previousVersion: currentVersion,
+    newVersion,
+    changelogPath
+  });
+}
+async function executeValidateConstitution(projectPath) {
+  const readResult = await readConstitution(projectPath);
+  if (!readResult.success) {
+    return failure(readResult.error);
+  }
+  const validationResult = validateConstitution(readResult.data.parsed);
+  if (!validationResult.success) {
+    return failure(new Error(`Constitution \uAC80\uC99D \uC2E4\uD328: ${validationResult.error.message}`));
+  }
+  return success(readResult.data.parsed);
+}
+async function getHistory(projectPath, count = 10) {
+  const changelogPath = path15.join(projectPath, ".sdd", "CHANGELOG.md");
+  if (!await fileExists(changelogPath)) {
+    return success({ entries: [], totalCount: 0 });
+  }
+  const contentResult = await readFile(changelogPath);
+  if (!contentResult.success) {
+    return failure(new Error("CHANGELOG \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseChangelog(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`CHANGELOG \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  const entries = parseResult.data.slice(0, count);
+  return success({
+    entries,
+    totalCount: parseResult.data.length
+  });
+}
 function registerConstitutionCommand(program2) {
   const constitution = program2.command("constitution").description("Constitution(\uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59) \uAD00\uB9AC");
   constitution.command("show").description("\uD604\uC7AC Constitution \uB0B4\uC6A9 \uD45C\uC2DC").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").action(async (options) => {
@@ -7610,33 +8078,14 @@ function registerConstitutionCommand(program2) {
 }
 async function runShow(options) {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await readConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const constitution = parseResult.data;
+  const constitution = result.data.parsed;
   if (options.json) {
-    console.log(JSON.stringify({
-      projectName: constitution.projectName,
-      version: constitution.metadata.version,
-      created: constitution.metadata.created,
-      updated: constitution.metadata.updated,
-      principles: constitution.principles,
-      forbidden: constitution.forbidden,
-      techStack: constitution.techStack,
-      qualityStandards: constitution.qualityStandards
-    }, null, 2));
+    console.log(JSON.stringify(constitutionToJson(constitution), null, 2));
     return;
   }
   info(`Constitution: ${constitution.projectName}`);
@@ -7675,119 +8124,40 @@ async function runShow(options) {
       listItem(standard);
     }
   }
-}
-async function runVersion() {
-  const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_SYSTEM_ERROR);
-  }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  console.log(parseResult.data.metadata.version);
-}
-async function runBump(options) {
-  const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  const changelogPath = path15.join(cwd, ".sdd", "CHANGELOG.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  let bumpType;
-  if (options.major) {
-    bumpType = "major";
-  } else if (options.minor) {
-    bumpType = "minor";
-  } else if (options.patch) {
-    bumpType = "patch";
-  } else {
-    error("\uBC84\uC804 \uC720\uD615\uC744 \uC9C0\uC815\uD558\uC138\uC694: --major, --minor, \uB610\uB294 --patch");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_SYSTEM_ERROR);
-  }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const currentVersion = parseResult.data.metadata.version;
-  const newVersion = bumpVersion(currentVersion, bumpType);
-  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  let updatedContent = contentResult.data;
-  updatedContent = updatedContent.replace(
-    /^version:\s*.+$/m,
-    `version: ${newVersion}`
-  );
-  if (/^updated:/m.test(updatedContent)) {
-    updatedContent = updatedContent.replace(
-      /^updated:\s*.+$/m,
-      `updated: ${today}`
-    );
-  } else {
-    updatedContent = updatedContent.replace(
-      /^(version:\s*.+)$/m,
-      `$1
-updated: ${today}`
-    );
-  }
-  await writeFile(constitutionPath, updatedContent);
-  const changeType = bumpType === "major" ? "changed" : bumpType === "minor" ? "added" : "fixed";
-  const changeDescription = options.message || `Constitution ${bumpType} \uC5C5\uB370\uC774\uD2B8`;
-  const newEntry = createChangelogEntry(
-    currentVersion,
-    bumpType,
-    [{ type: changeType, description: changeDescription }],
-    options.message
-  );
-  let existingEntries = [];
-  if (await fileExists(changelogPath)) {
-    const changelogContent = await readFile(changelogPath);
-    if (changelogContent.success) {
-      const parsed = parseChangelog(changelogContent.data);
-      if (parsed.success) {
-        existingEntries = parsed.data;
-      }
-    }
+}
+async function runVersion() {
+  const cwd = process.cwd();
+  const result = await readConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const allEntries = [newEntry, ...existingEntries];
-  const newChangelog = generateChangelog(allEntries);
-  await writeFile(changelogPath, newChangelog);
-  success2(`Constitution \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8: ${currentVersion} \u2192 ${newVersion}`);
-  info(`CHANGELOG \uC5C5\uB370\uC774\uD2B8: ${changelogPath}`);
+  console.log(result.data.parsed.metadata.version);
 }
-async function runHistory(options) {
+async function runBump(options) {
   const cwd = process.cwd();
-  const changelogPath = path15.join(cwd, ".sdd", "CHANGELOG.md");
-  if (!await fileExists(changelogPath)) {
-    warn("CHANGELOG\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd constitution bump`\uB85C \uBC84\uC804\uC744 \uC5C5\uB370\uC774\uD2B8\uD558\uBA74 \uC0DD\uC131\uB429\uB2C8\uB2E4.");
-    return;
+  const bumpType = determineBumpType(options);
+  if (!bumpType) {
+    error("\uBC84\uC804 \uC720\uD615\uC744 \uC9C0\uC815\uD558\uC138\uC694: --major, --minor, \uB610\uB294 --patch");
+    process.exit(ExitCode.GENERAL_ERROR);
   }
-  const contentResult = await readFile(changelogPath);
-  if (!contentResult.success) {
-    error("CHANGELOG \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await executeBump(cwd, bumpType, options.message);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseChangelog(contentResult.data);
-  if (!parseResult.success) {
-    error(`CHANGELOG \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
+  success2(`Constitution \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8: ${result.data.previousVersion} \u2192 ${result.data.newVersion}`);
+  info(`CHANGELOG \uC5C5\uB370\uC774\uD2B8: ${result.data.changelogPath}`);
+}
+async function runHistory(options) {
+  const cwd = process.cwd();
   const count = parseInt(options.count, 10) || 10;
-  const entries = parseResult.data.slice(0, count);
+  const result = await getHistory(cwd, count);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.FILE_SYSTEM_ERROR);
+  }
+  const { entries } = result.data;
   if (entries.length === 0) {
     info("\uBCC0\uACBD \uC774\uB825\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
@@ -7807,36 +8177,22 @@ async function runHistory(options) {
 }
 async function runValidate2() {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_SYSTEM_ERROR);
-  }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const validationResult = validateConstitution(parseResult.data);
-  if (!validationResult.success) {
-    error(`Constitution \uAC80\uC99D \uC2E4\uD328: ${validationResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
+  const result = await executeValidateConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.VALIDATION_FAILED);
   }
+  const constitution = result.data;
   success2("Constitution \uAC80\uC99D \uD1B5\uACFC");
-  info(`\uD504\uB85C\uC81D\uD2B8: ${parseResult.data.projectName}`);
-  info(`\uBC84\uC804: ${parseResult.data.metadata.version}`);
-  info(`\uC6D0\uCE59 \uC218: ${parseResult.data.principles.length}`);
-  info(`\uAE08\uC9C0 \uC0AC\uD56D \uC218: ${parseResult.data.forbidden.length}`);
+  info(`\uD504\uB85C\uC81D\uD2B8: ${constitution.projectName}`);
+  info(`\uBC84\uC804: ${constitution.metadata.version}`);
+  info(`\uC6D0\uCE59 \uC218: ${constitution.principles.length}`);
+  info(`\uAE08\uC9C0 \uC0AC\uD56D \uC218: ${constitution.forbidden.length}`);
 }
 
 // src/cli/commands/start.ts
 import path16 from "path";
-import { promises as fs10 } from "fs";
+import { promises as fs9 } from "fs";
 init_errors();
 init_fs();
 function registerStartCommand(program2) {
@@ -7850,7 +8206,7 @@ function registerStartCommand(program2) {
   });
 }
 async function runStart(options) {
-  const projectStatus = await getProjectStatus();
+  const projectStatus = await getProjectStatus2();
   if (!projectStatus.initialized) {
     info("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
     newline();
@@ -7874,7 +8230,7 @@ async function runStart(options) {
   newline();
   displayWorkflowMenu(projectStatus);
 }
-async function getProjectStatus() {
+async function getProjectStatus2() {
   const projectRoot = await findSddRoot();
   if (!projectRoot) {
     return {
@@ -7903,7 +8259,7 @@ async function getProjectStatus() {
   const specs = [];
   if (await directoryExists(specsPath)) {
     try {
-      const dirs = await fs10.readdir(specsPath);
+      const dirs = await fs9.readdir(specsPath);
       for (const dir of dirs) {
         const specPath = path16.join(specsPath, dir, "spec.md");
         if (await fileExists(specPath)) {
@@ -8140,7 +8496,7 @@ function displayConstitutionGuide() {
 
 // src/cli/commands/migrate.ts
 import path18 from "path";
-import { promises as fs12 } from "fs";
+import { promises as fs11 } from "fs";
 init_errors();
 init_fs();
 init_new();
@@ -8151,7 +8507,7 @@ init_types();
 init_errors();
 init_fs();
 import path17 from "path";
-import fs11 from "fs/promises";
+import fs10 from "fs/promises";
 async function detectExternalTools(projectRoot) {
   try {
     const results = [];
@@ -8188,13 +8544,13 @@ async function detectOpenSpec(projectRoot) {
   }
   const specs = [];
   if (hasSpecs) {
-    const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
     for (const entry of specDirs) {
       if (entry.isDirectory()) {
         const specPath = path17.join(specsPath, entry.name);
         const specFile = path17.join(specPath, "spec.md");
         if (await fileExists(specFile)) {
-          const content = await fs11.readFile(specFile, "utf-8");
+          const content = await fs10.readFile(specFile, "utf-8");
           const title2 = extractTitle2(content);
           const status = extractFrontmatterField(content, "status");
           specs.push({
@@ -8229,7 +8585,7 @@ async function detectSpecKit(projectRoot) {
     return null;
   }
   const specs = [];
-  const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+  const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
   for (const entry of specDirs) {
     if (entry.isDirectory()) {
       const specPath = path17.join(specsPath, entry.name);
@@ -8243,7 +8599,7 @@ async function detectSpecKit(projectRoot) {
         let title2;
         let status;
         if (hasSpec) {
-          const content = await fs11.readFile(specFile, "utf-8");
+          const content = await fs10.readFile(specFile, "utf-8");
           title2 = extractTitle2(content);
           status = extractFrontmatterField(content, "status");
         }
@@ -8275,13 +8631,13 @@ async function detectSdd(projectRoot) {
     return null;
   }
   const specs = [];
-  const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+  const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
   for (const entry of specDirs) {
     if (entry.isDirectory()) {
       const specPath = path17.join(specsPath, entry.name);
       const specFile = path17.join(specPath, "spec.md");
       if (await fileExists(specFile)) {
-        const content = await fs11.readFile(specFile, "utf-8");
+        const content = await fs10.readFile(specFile, "utf-8");
         const title2 = extractTitle2(content);
         const status = extractFrontmatterField(content, "status");
         specs.push({
@@ -8311,7 +8667,7 @@ async function migrateFromOpenSpec(sourcePath, targetPath, options = {}) {
     if (!await directoryExists(specsPath)) {
       return failure(new ChangeError("OpenSpec specs \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     }
-    const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
     for (const entry of specDirs) {
       if (!entry.isDirectory()) continue;
       const sourceSpecPath = path17.join(specsPath, entry.name);
@@ -8324,18 +8680,18 @@ async function migrateFromOpenSpec(sourcePath, targetPath, options = {}) {
       }
       try {
         if (!options.dryRun) {
-          await fs11.mkdir(targetSpecPath, { recursive: true });
-          const files = await fs11.readdir(sourceSpecPath);
+          await fs10.mkdir(targetSpecPath, { recursive: true });
+          const files = await fs10.readdir(sourceSpecPath);
           for (const file of files) {
             const sourceFile = path17.join(sourceSpecPath, file);
             const targetFile = path17.join(targetSpecPath, file);
-            const stat = await fs11.stat(sourceFile);
+            const stat = await fs10.stat(sourceFile);
             if (stat.isFile()) {
-              let content = await fs11.readFile(sourceFile, "utf-8");
+              let content = await fs10.readFile(sourceFile, "utf-8");
               if (file === "spec.md") {
                 content = convertOpenSpecToSdd(content, entry.name);
               }
-              await fs11.writeFile(targetFile, content);
+              await fs10.writeFile(targetFile, content);
             }
           }
         }
@@ -8365,7 +8721,7 @@ async function migrateFromSpecKit(sourcePath, targetPath, options = {}) {
     if (!await directoryExists(specsPath)) {
       return failure(new ChangeError("Spec Kit specs \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     }
-    const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
     for (const entry of specDirs) {
       if (!entry.isDirectory()) continue;
       const sourceSpecPath = path17.join(specsPath, entry.name);
@@ -8378,18 +8734,18 @@ async function migrateFromSpecKit(sourcePath, targetPath, options = {}) {
       }
       try {
         if (!options.dryRun) {
-          await fs11.mkdir(targetSpecPath, { recursive: true });
-          const files = await fs11.readdir(sourceSpecPath);
+          await fs10.mkdir(targetSpecPath, { recursive: true });
+          const files = await fs10.readdir(sourceSpecPath);
           for (const file of files) {
             const sourceFile = path17.join(sourceSpecPath, file);
             const targetFile = path17.join(targetSpecPath, file);
-            const stat = await fs11.stat(sourceFile);
+            const stat = await fs10.stat(sourceFile);
             if (stat.isFile()) {
-              let content = await fs11.readFile(sourceFile, "utf-8");
+              let content = await fs10.readFile(sourceFile, "utf-8");
               if (file === "spec.md") {
                 content = convertSpecKitToSdd(content, entry.name);
               }
-              await fs11.writeFile(targetFile, content);
+              await fs10.writeFile(targetFile, content);
             }
           }
         }
@@ -8547,7 +8903,7 @@ async function runMigrateDocs(source, options) {
   const sourcePath = path18.resolve(source);
   let files = [];
   try {
-    const stat = await fs12.stat(sourcePath);
+    const stat = await fs11.stat(sourcePath);
     if (stat.isDirectory()) {
       files = await collectMarkdownFiles(sourcePath);
     } else if (stat.isFile()) {
@@ -8590,7 +8946,7 @@ async function runMigrateDocs(source, options) {
 }
 async function migrateDocument(filePath, outputDir, dryRun) {
   try {
-    const content = await fs12.readFile(filePath, "utf-8");
+    const content = await fs11.readFile(filePath, "utf-8");
     const analysis = analyzeDocument(content);
     const featureId = generateFeatureId(analysis.title || path18.basename(filePath, ".md"));
     const specContent = generateSpec({
@@ -8658,7 +9014,7 @@ async function runAnalyze(file) {
     error(`\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${file}`);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const content = await fs12.readFile(filePath, "utf-8");
+  const content = await fs11.readFile(filePath, "utf-8");
   const analysis = analyzeDocument(content);
   info(`\u{1F4CA} \uBB38\uC11C \uBD84\uC11D: ${path18.basename(file)}`);
   newline();
@@ -8719,7 +9075,7 @@ async function runScan(dir, options) {
   const results = [];
   for (const file of files) {
     try {
-      const content = await fs12.readFile(file, "utf-8");
+      const content = await fs11.readFile(file, "utf-8");
       const analysis = analyzeDocument(content);
       results.push({ file, analysis });
     } catch {
@@ -8781,7 +9137,7 @@ async function collectMarkdownFiles(dirPath) {
 async function collectFilesWithExtensions(dirPath, extensions) {
   const files = [];
   async function scan(dir) {
-    const entries = await fs12.readdir(dir, { withFileTypes: true });
+    const entries = await fs11.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       const fullPath = path18.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -9294,8 +9650,129 @@ async function runCiCheck(options) {
 
 // src/cli/commands/transition.ts
 import path20 from "path";
+import { promises as fs12 } from "fs";
 init_errors();
 init_fs();
+init_types();
+async function getExistingChangeIds(sddPath) {
+  const changesPath = path20.join(sddPath, "changes");
+  try {
+    const dirs = await fs12.readdir(changesPath);
+    return dirs.filter((d) => d.startsWith("CHG-"));
+  } catch {
+    return [];
+  }
+}
+async function extractProposalTitle(proposalPath) {
+  if (!await fileExists(proposalPath)) {
+    return "";
+  }
+  const content = await readFile(proposalPath);
+  if (!content.success) {
+    return "";
+  }
+  const titleMatch = content.data.match(/^#\s+(.+)$/m);
+  return titleMatch ? titleMatch[1] : "";
+}
+async function transitionNewToChange(sddPath, specId, options) {
+  const specsPath = path20.join(sddPath, "specs");
+  const specPath = path20.join(specsPath, specId, "spec.md");
+  if (!await fileExists(specPath)) {
+    return failure(new Error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`));
+  }
+  const existingIds = await getExistingChangeIds(sddPath);
+  const changeId = generateChangeId(existingIds);
+  const changesPath = path20.join(sddPath, "changes");
+  const changePath = path20.join(changesPath, changeId);
+  await ensureDir(changePath);
+  const title2 = options.title || `${specId} \uAE30\uB2A5 \uD655\uC7A5`;
+  const reason = options.reason || "new \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
+  const proposalContent = generateTransitionProposal(specId, title2, reason, "new-to-change");
+  await writeFile(path20.join(changePath, "proposal.md"), proposalContent);
+  const deltaContent = generateDeltaTemplate2(specId);
+  await writeFile(path20.join(changePath, "delta.md"), deltaContent);
+  const tasksContent = generateTasksTemplate2();
+  await writeFile(path20.join(changePath, "tasks.md"), tasksContent);
+  return success({
+    changeId,
+    changePath,
+    filesCreated: ["proposal.md", "delta.md", "tasks.md"]
+  });
+}
+async function transitionChangeToNew(sddPath, changeId, options) {
+  const changePath = path20.join(sddPath, "changes", changeId);
+  if (!await directoryExists(changePath)) {
+    return failure(new Error(`\uBCC0\uACBD \uC81C\uC548\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${changeId}`));
+  }
+  const proposalPath = path20.join(changePath, "proposal.md");
+  const extractedTitle = await extractProposalTitle(proposalPath);
+  const featureName = options.name || extractedTitle.toLowerCase().replace(/\s+/g, "-") || `feature-from-${changeId}`;
+  const specsPath = path20.join(sddPath, "specs");
+  const newSpecPath = path20.join(specsPath, featureName);
+  if (await directoryExists(newSpecPath)) {
+    return failure(new Error(`\uC2A4\uD399\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${featureName}`));
+  }
+  await ensureDir(newSpecPath);
+  const reason = options.reason || "change \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
+  const specContent = generateTransitionSpec(featureName, extractedTitle || featureName, reason, changeId);
+  await writeFile(path20.join(newSpecPath, "spec.md"), specContent);
+  const planContent = generatePlanTemplate(featureName);
+  await writeFile(path20.join(newSpecPath, "plan.md"), planContent);
+  const tasksContent = generateTasksTemplate2();
+  await writeFile(path20.join(newSpecPath, "tasks.md"), tasksContent);
+  const statusPath = path20.join(changePath, ".status");
+  await writeFile(statusPath, JSON.stringify({
+    status: "transitioned",
+    transitionedTo: featureName,
+    transitionedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    reason
+  }, null, 2));
+  return success({
+    featureName,
+    featurePath: newSpecPath,
+    filesCreated: ["spec.md", "plan.md", "tasks.md"],
+    originalChangeId: changeId
+  });
+}
+function getTransitionGuide() {
+  return `=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658 \uAC00\uC774\uB4DC ===
+
+## new \u2192 change \uC804\uD658
+
+\uC0AC\uC6A9 \uC2DC\uC810:
+- \uC0C8 \uAE30\uB2A5 \uC791\uC131 \uC911 \uAE30\uC874 \uC2A4\uD399\uACFC \uC911\uBCF5 \uBC1C\uACAC
+- \uAE30\uC874 \uAE30\uB2A5 \uD655\uC7A5\uC774 \uB354 \uC801\uC808\uD55C \uACBD\uC6B0
+- \uC758\uC874\uC131 \uBD84\uC11D \uACB0\uACFC \uAE30\uC874 \uC2A4\uD399 \uC218\uC815 \uD544\uC694
+
+\uBA85\uB839\uC5B4:
+sdd transition new-to-change <spec-id>
+  -t, --title <title>  : \uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9
+  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720
+
+## change \u2192 new \uC804\uD658
+
+\uC0AC\uC6A9 \uC2DC\uC810:
+- \uBCC0\uACBD \uBC94\uC704\uAC00 \uB108\uBB34 \uCEE4\uC11C \uBCC4\uB3C4 \uAE30\uB2A5\uC73C\uB85C \uBD84\uB9AC \uD544\uC694
+- \uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC778 \uC0C8 \uAE30\uB2A5\uC73C\uB85C \uBC1C\uC804
+- \uC601\uD5A5\uB3C4 \uBD84\uC11D \uACB0\uACFC \uBD84\uB9AC\uAC00 \uC548\uC804
+
+\uBA85\uB839\uC5B4:
+sdd transition change-to-new <change-id>
+  -n, --name <name>    : \uC0C8 \uAE30\uB2A5 \uC774\uB984
+  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720
+
+## \uC804\uD658 \uD310\uB2E8 \uAE30\uC900
+
+new \u2192 change:
+- \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 \u2264 3\uAC1C
+- \uBCC0\uACBD\uC774 \uAE30\uC874 \uAE30\uB2A5\uC758 \uC790\uC5F0\uC2A4\uB7EC\uC6B4 \uD655\uC7A5
+- \uC0C8 \uC2DC\uB098\uB9AC\uC624 \uCD94\uAC00\uBCF4\uB2E4 \uAE30\uC874 \uC2DC\uB098\uB9AC\uC624 \uC218\uC815 \uC911\uC2EC
+
+change \u2192 new:
+- \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 > 3\uAC1C
+- \uC0C8\uB85C\uC6B4 \uAC1C\uB150/\uB3C4\uBA54\uC778 \uB3C4\uC785
+- \uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC73C\uB85C \uD14C\uC2A4\uD2B8 \uAC00\uB2A5`;
+}
 function registerTransitionCommand(program2) {
   const transition = program2.command("transition").description("\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uAC04 \uC804\uD658\uC744 \uC218\uD589\uD569\uB2C8\uB2E4");
   transition.command("new-to-change <spec-id>").description("\uC0C8 \uAE30\uB2A5 \uC791\uC5C5\uC744 \uAE30\uC874 \uC2A4\uD399 \uBCC0\uACBD\uC73C\uB85C \uC804\uD658\uD569\uB2C8\uB2E4").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-r, --reason <reason>", "\uC804\uD658 \uC0AC\uC720").action(async (specId, options) => {
@@ -9325,32 +9802,16 @@ async function runNewToChange(specId, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path20.join(projectRoot, ".sdd");
-  const specsPath = path20.join(sddPath, "specs");
-  const specPath = path20.join(specsPath, specId, "spec.md");
-  if (!await fileExists(specPath)) {
-    error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`);
-    info("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC2A4\uD399 \uBAA9\uB85D\uC740 `sdd list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: new \u2192 change ===");
   newline();
   info(`\uB300\uC0C1 \uC2A4\uD399: ${specId}`);
-  const changeId = generateChangeId();
-  const changePath = path20.join(sddPath, "changes", changeId);
-  await ensureDir(changePath);
-  const specContent = await readFile(specPath);
-  if (!specContent.success) {
-    error("\uC2A4\uD399 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await transitionNewToChange(sddPath, specId, options);
+  if (!result.success) {
+    error(result.error.message);
+    info("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC2A4\uD399 \uBAA9\uB85D\uC740 `sdd list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const title2 = options.title || `${specId} \uAE30\uB2A5 \uD655\uC7A5`;
-  const reason = options.reason || "new \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
-  const proposalContent = generateTransitionProposal(specId, title2, reason, "new-to-change");
-  await writeFile(path20.join(changePath, "proposal.md"), proposalContent);
-  const deltaContent = generateDeltaTemplate(specId);
-  await writeFile(path20.join(changePath, "delta.md"), deltaContent);
-  const tasksContent = generateTasksTemplate();
-  await writeFile(path20.join(changePath, "tasks.md"), tasksContent);
+  const { changeId } = result.data;
   newline();
   success2(`\uC804\uD658 \uC644\uB8CC! \uBCC0\uACBD \uC81C\uC548\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
@@ -9373,55 +9834,26 @@ async function runChangeToNew(changeId, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path20.join(projectRoot, ".sdd");
-  const changePath = path20.join(sddPath, "changes", changeId);
-  if (!await directoryExists(changePath)) {
-    error(`\uBCC0\uACBD \uC81C\uC548\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${changeId}`);
-    info("\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D\uC740 `sdd change -l`\uB85C \uD655\uC778\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: change \u2192 new ===");
   newline();
   info(`\uC6D0\uBCF8 \uBCC0\uACBD: ${changeId}`);
-  const proposalPath = path20.join(changePath, "proposal.md");
-  let extractedTitle = "";
-  if (await fileExists(proposalPath)) {
-    const proposalContent = await readFile(proposalPath);
-    if (proposalContent.success) {
-      const titleMatch = proposalContent.data.match(/^#\s+(.+)$/m);
-      if (titleMatch) {
-        extractedTitle = titleMatch[1];
-      }
+  const result = await transitionChangeToNew(sddPath, changeId, options);
+  if (!result.success) {
+    error(result.error.message);
+    if (result.error.message.includes("\uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4")) {
+      info("\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D\uC740 `sdd change -l`\uB85C \uD655\uC778\uD558\uC138\uC694.");
+    } else if (result.error.message.includes("\uC774\uBBF8 \uC874\uC7AC")) {
+      info("\uB2E4\uB978 \uC774\uB984\uC744 \uC9C0\uC815\uD558\uC138\uC694: --name <name>");
     }
-  }
-  const featureName = options.name || extractedTitle.toLowerCase().replace(/\s+/g, "-") || `feature-from-${changeId}`;
-  const specsPath = path20.join(sddPath, "specs");
-  const newSpecPath = path20.join(specsPath, featureName);
-  if (await directoryExists(newSpecPath)) {
-    error(`\uC2A4\uD399\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${featureName}`);
-    info("\uB2E4\uB978 \uC774\uB984\uC744 \uC9C0\uC815\uD558\uC138\uC694: --name <name>");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  await ensureDir(newSpecPath);
-  const reason = options.reason || "change \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
-  const specContent = generateTransitionSpec(featureName, extractedTitle || featureName, reason, changeId);
-  await writeFile(path20.join(newSpecPath, "spec.md"), specContent);
-  const planContent = generatePlanTemplate(featureName);
-  await writeFile(path20.join(newSpecPath, "plan.md"), planContent);
-  const tasksContent = generateTasksTemplate();
-  await writeFile(path20.join(newSpecPath, "tasks.md"), tasksContent);
-  const statusPath = path20.join(changePath, ".status");
-  await writeFile(statusPath, JSON.stringify({
-    status: "transitioned",
-    transitionedTo: featureName,
-    transitionedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    reason
-  }, null, 2));
+  const { featureName, originalChangeId } = result.data;
   newline();
   success2(`\uC804\uD658 \uC644\uB8CC! \uC0C8 \uAE30\uB2A5 \uC2A4\uD399\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
   info(`\uAE30\uB2A5 \uC774\uB984: ${featureName}`);
   info(`\uC704\uCE58: .sdd/specs/${featureName}/`);
-  info(`\uC6D0\uBCF8 \uBCC0\uACBD ${changeId}\uC740 'transitioned' \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
+  info(`\uC6D0\uBCF8 \uBCC0\uACBD ${originalChangeId}\uC740 'transitioned' \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
   info("\uB2E4\uC74C \uB2E8\uACC4:");
   listItem(`1. .sdd/specs/${featureName}/spec.md \uD3B8\uC9D1`);
@@ -9433,43 +9865,7 @@ async function runChangeToNew(changeId, options) {
   listItem("/sdd.new - \uBA85\uC138 \uC791\uC131 \uB3C4\uC6C0");
 }
 function displayTransitionGuide() {
-  info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658 \uAC00\uC774\uB4DC ===");
-  newline();
-  info("## new \u2192 change \uC804\uD658");
-  newline();
-  info("\uC0AC\uC6A9 \uC2DC\uC810:");
-  listItem("\uC0C8 \uAE30\uB2A5 \uC791\uC131 \uC911 \uAE30\uC874 \uC2A4\uD399\uACFC \uC911\uBCF5 \uBC1C\uACAC");
-  listItem("\uAE30\uC874 \uAE30\uB2A5 \uD655\uC7A5\uC774 \uB354 \uC801\uC808\uD55C \uACBD\uC6B0");
-  listItem("\uC758\uC874\uC131 \uBD84\uC11D \uACB0\uACFC \uAE30\uC874 \uC2A4\uD399 \uC218\uC815 \uD544\uC694");
-  newline();
-  info("\uBA85\uB839\uC5B4:");
-  listItem("sdd transition new-to-change <spec-id>");
-  listItem("  -t, --title <title>  : \uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9");
-  listItem("  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720");
-  newline();
-  info("## change \u2192 new \uC804\uD658");
-  newline();
-  info("\uC0AC\uC6A9 \uC2DC\uC810:");
-  listItem("\uBCC0\uACBD \uBC94\uC704\uAC00 \uB108\uBB34 \uCEE4\uC11C \uBCC4\uB3C4 \uAE30\uB2A5\uC73C\uB85C \uBD84\uB9AC \uD544\uC694");
-  listItem("\uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC778 \uC0C8 \uAE30\uB2A5\uC73C\uB85C \uBC1C\uC804");
-  listItem("\uC601\uD5A5\uB3C4 \uBD84\uC11D \uACB0\uACFC \uBD84\uB9AC\uAC00 \uC548\uC804");
-  newline();
-  info("\uBA85\uB839\uC5B4:");
-  listItem("sdd transition change-to-new <change-id>");
-  listItem("  -n, --name <name>    : \uC0C8 \uAE30\uB2A5 \uC774\uB984");
-  listItem("  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720");
-  newline();
-  info("## \uC804\uD658 \uD310\uB2E8 \uAE30\uC900");
-  newline();
-  info("new \u2192 change:");
-  listItem("\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 \u2264 3\uAC1C");
-  listItem("\uBCC0\uACBD\uC774 \uAE30\uC874 \uAE30\uB2A5\uC758 \uC790\uC5F0\uC2A4\uB7EC\uC6B4 \uD655\uC7A5");
-  listItem("\uC0C8 \uC2DC\uB098\uB9AC\uC624 \uCD94\uAC00\uBCF4\uB2E4 \uAE30\uC874 \uC2DC\uB098\uB9AC\uC624 \uC218\uC815 \uC911\uC2EC");
-  newline();
-  info("change \u2192 new:");
-  listItem("\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 > 3\uAC1C");
-  listItem("\uC0C8\uB85C\uC6B4 \uAC1C\uB150/\uB3C4\uBA54\uC778 \uB3C4\uC785");
-  listItem("\uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC73C\uB85C \uD14C\uC2A4\uD2B8 \uAC00\uB2A5");
+  console.log(getTransitionGuide());
 }
 function generateTransitionProposal(specId, title2, reason, direction) {
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -9511,7 +9907,7 @@ transition_reason: "${reason}"
 <!-- \uCD94\uAC00 \uCC38\uACE0 \uC815\uBCF4\uAC00 \uC788\uB2E4\uBA74 \uC791\uC131\uD558\uC138\uC694 -->
 `;
 }
-function generateDeltaTemplate(specId) {
+function generateDeltaTemplate2(specId) {
   return `---
 target: ${specId}
 ---
@@ -9622,7 +10018,7 @@ status: draft
 <!-- \uAD6C\uD604 \uC2DC \uACE0\uB824\uD560 \uC704\uD5D8 \uC694\uC18C -->
 `;
 }
-function generateTasksTemplate() {
+function generateTasksTemplate2() {
   return `---
 status: pending
 ---
@@ -9965,8 +10361,8 @@ function scoreDependencies(spec) {
   const details = [];
   const suggestions = [];
   let score = 0;
-  if (spec.frontmatter.depends) {
-    const deps = Array.isArray(spec.frontmatter.depends) ? spec.frontmatter.depends : [spec.frontmatter.depends];
+  if (spec.metadata.depends) {
+    const deps = Array.isArray(spec.metadata.depends) ? spec.metadata.depends : [spec.metadata.depends];
     if (deps.length > 0 && deps[0] !== null) {
       score = maxScore;
       details.push(`\uC758\uC874\uC131: ${deps.join(", ")}`);
@@ -9975,8 +10371,8 @@ function scoreDependencies(spec) {
       details.push("\uC758\uC874\uC131 \uC5C6\uC74C (\uBA85\uC2DC\uC801 \uC120\uC5B8)");
     }
   } else {
-    details.push("\uC758\uC874\uC131 \uD544\uB4DC\uAC00 \uC5C6\uC74C");
-    suggestions.push("frontmatter\uC5D0 depends \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694");
+    score = 5;
+    details.push("\uC758\uC874\uC131 \uD544\uB4DC \uC5C6\uC74C (\uC554\uC2DC\uC801 \uC5C6\uC74C)");
   }
   return {
     name: "\uC758\uC874\uC131 \uBA85\uC2DC",
@@ -10041,9 +10437,9 @@ function scoreConstitution(spec, hasConstitution) {
   if (!hasConstitution) {
     score = maxScore;
     details.push("Constitution \uBBF8\uC124\uC815 (\uAC80\uC0AC \uC0DD\uB7B5)");
-  } else if (spec.frontmatter.constitution_version) {
+  } else if (spec.metadata.constitution_version) {
     score = maxScore;
-    details.push(`Constitution \uBC84\uC804: ${spec.frontmatter.constitution_version}`);
+    details.push(`Constitution \uBC84\uC804: ${spec.metadata.constitution_version}`);
   } else {
     details.push("constitution_version \uD544\uB4DC \uC5C6\uC74C");
     suggestions.push("frontmatter\uC5D0 constitution_version\uC744 \uCD94\uAC00\uD558\uC138\uC694");
@@ -10089,20 +10485,20 @@ function scoreMetadata(spec) {
   let score = 0;
   const missingRequired = [];
   for (const field of requiredFields) {
-    if (spec.frontmatter[field]) {
+    if (spec.metadata[field]) {
       score += 2;
     } else {
       missingRequired.push(field);
     }
   }
   for (const field of optionalFields) {
-    if (spec.frontmatter[field]) {
+    if (spec.metadata[field]) {
       score += 1;
     }
   }
   score = Math.min(maxScore, score);
-  const presentFields = Object.keys(spec.frontmatter).filter(
-    (k) => spec.frontmatter[k] !== null && spec.frontmatter[k] !== void 0
+  const presentFields = Object.keys(spec.metadata).filter(
+    (k) => spec.metadata[k] !== null && spec.metadata[k] !== void 0
   );
   details.push(`\uBA54\uD0C0\uB370\uC774\uD130 \uD544\uB4DC: ${presentFields.length}\uAC1C`);
   if (missingRequired.length > 0) {
@@ -10149,7 +10545,7 @@ async function analyzeSpecQuality(specPath, sddPath) {
     const percentage = Math.round(totalScore / maxScore * 100);
     const grade = getGrade(percentage);
     const topSuggestions = items.filter((item) => item.suggestions.length > 0).sort((a, b) => a.percentage - b.percentage).slice(0, 3).flatMap((item) => item.suggestions);
-    const specId = spec.frontmatter.id || path23.basename(path23.dirname(specPath));
+    const specId = spec.metadata.id || path23.basename(path23.dirname(specPath));
     const summary = `\uC2A4\uD399 '${specId}'\uC758 \uD488\uC9C8 \uC810\uC218: ${totalScore}/${maxScore} (${percentage}%, \uB4F1\uAE09: ${grade})`;
     return success({
       specId,
@@ -10279,6 +10675,36 @@ function formatProjectQualityResult(result) {
 // src/cli/commands/quality.ts
 init_fs();
 init_errors();
+init_types();
+async function executeQuality(feature, options, projectRoot) {
+  const sddPath = path24.join(projectRoot, ".sdd");
+  const minScore = parseInt(options.minScore || "0", 10);
+  if (options.all || !feature) {
+    const result2 = await analyzeProjectQuality(sddPath);
+    if (!result2.success) {
+      return failure(result2.error);
+    }
+    const formatted2 = options.json ? JSON.stringify(result2.data, null, 2) : formatProjectQualityResult(result2.data);
+    return success({
+      type: "project",
+      data: result2.data,
+      formatted: formatted2,
+      passed: result2.data.averagePercentage >= minScore
+    });
+  }
+  const specPath = path24.join(sddPath, "specs", feature, "spec.md");
+  const result = await analyzeSpecQuality(specPath, sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  const formatted = options.json ? JSON.stringify(result.data, null, 2) : formatQualityResult(result.data);
+  return success({
+    type: "spec",
+    data: result.data,
+    formatted,
+    passed: result.data.percentage >= minScore
+  });
+}
 function registerQualityCommand(program2) {
   program2.command("quality [feature]").description("\uC2A4\uD399 \uD488\uC9C8\uC744 \uBD84\uC11D\uD558\uACE0 \uC810\uC218\uB97C \uC0B0\uCD9C\uD569\uB2C8\uB2E4").option("-a, --all", "\uC804\uCCB4 \uD504\uB85C\uC81D\uD2B8 \uBD84\uC11D").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").option("--min-score <score>", "\uCD5C\uC18C \uC810\uC218 \uAE30\uC900 (\uC774\uD558 \uC2DC \uC5D0\uB7EC)", "0").action(async (feature, options) => {
     try {
@@ -10295,41 +10721,17 @@ async function runQuality(feature, options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const sddPath = path24.join(projectRoot, ".sdd");
-  const minScore = parseInt(options.minScore || "0", 10);
-  if (options.all || !feature) {
-    const result2 = await analyzeProjectQuality(sddPath);
-    if (!result2.success) {
-      error(result2.error.message);
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-    if (options.json) {
-      console.log(JSON.stringify(result2.data, null, 2));
-    } else {
-      console.log(formatProjectQualityResult(result2.data));
-    }
-    if (result2.data.averagePercentage < minScore) {
-      newline();
-      error(`\uD488\uC9C8 \uC810\uC218\uAC00 \uCD5C\uC18C \uAE30\uC900(${minScore}%) \uBBF8\uB2EC\uC785\uB2C8\uB2E4.`);
-      process.exit(ExitCode.VALIDATION_ERROR);
-    }
-    return;
-  }
-  const specPath = path24.join(sddPath, "specs", feature, "spec.md");
-  const result = await analyzeSpecQuality(specPath, sddPath);
+  const result = await executeQuality(feature, options, projectRoot);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  if (options.json) {
-    console.log(JSON.stringify(result.data, null, 2));
-  } else {
-    console.log(formatQualityResult(result.data));
-  }
-  if (result.data.percentage < minScore) {
+  console.log(result.data.formatted);
+  if (!result.data.passed) {
+    const minScore = parseInt(options.minScore || "0", 10);
     newline();
     error(`\uD488\uC9C8 \uC810\uC218\uAC00 \uCD5C\uC18C \uAE30\uC900(${minScore}%) \uBBF8\uB2EC\uC785\uB2C8\uB2E4.`);
-    process.exit(ExitCode.VALIDATION_ERROR);
+    process.exit(ExitCode.VALIDATION_FAILED);
   }
 }
 
@@ -10498,7 +10900,7 @@ function renderHtmlReport(data) {
       <td>${spec.description || "-"}</td>
     </tr>
   `).join("");
-  const qualityRows = data.quality?.results.map((q) => `
+  const qualityRows = data.quality?.specResults?.map((q) => `
     <tr>
       <td>${q.specId}</td>
       <td>${q.percentage}%</td>
@@ -10506,7 +10908,7 @@ function renderHtmlReport(data) {
       <td>${q.totalScore}/${q.maxScore}</td>
     </tr>
   `).join("") || "";
-  const validationRows = data.validation?.results.map((v) => `
+  const validationRows = data.validation?.files?.map((v) => `
     <tr>
       <td>${v.file}</td>
       <td style="color:${v.errors.length > 0 ? "#ef4444" : "#22c55e"};">${v.errors.length > 0 ? "\u274C \uC2E4\uD328" : "\u2705 \uD1B5\uACFC"}</td>
@@ -10676,11 +11078,11 @@ function renderMarkdownReport(data) {
   if (data.quality) {
     lines.push("## \uD488\uC9C8 \uBD84\uC11D");
     lines.push("");
-    lines.push(`\uD3C9\uADE0 \uC810\uC218: **${data.quality.averagePercentage.toFixed(1)}%** (${data.quality.averageGrade})`);
+    lines.push(`\uD3C9\uADE0 \uC810\uC218: **${data.quality.averagePercentage.toFixed(1)}%** (${data.quality.grade})`);
     lines.push("");
     lines.push("| \uC2A4\uD399 ID | \uC810\uC218 | \uB4F1\uAE09 |");
     lines.push("|---------|------|------|");
-    for (const q of data.quality.results) {
+    for (const q of data.quality.specResults || []) {
       lines.push(`| ${q.specId} | ${q.percentage}% | ${q.grade} |`);
     }
     lines.push("");
@@ -10688,14 +11090,14 @@ function renderMarkdownReport(data) {
   if (data.validation) {
     lines.push("## \uAC80\uC99D \uACB0\uACFC");
     lines.push("");
-    lines.push(`- \uAC80\uC99D\uB41C \uC2A4\uD399: ${data.validation.validCount}\uAC1C`);
-    lines.push(`- \uC5D0\uB7EC: ${data.validation.errorCount}\uAC1C`);
-    lines.push(`- \uACBD\uACE0: ${data.validation.warningCount}\uAC1C`);
+    lines.push(`- \uD1B5\uACFC: ${data.validation.passed}\uAC1C`);
+    lines.push(`- \uC2E4\uD328: ${data.validation.failed}\uAC1C`);
+    lines.push(`- \uACBD\uACE0: ${data.validation.warnings}\uAC1C`);
     lines.push("");
-    if (data.validation.errorCount > 0 || data.validation.warningCount > 0) {
+    if (data.validation.failed > 0 || data.validation.warnings > 0) {
       lines.push("### \uC0C1\uC138 \uACB0\uACFC");
       lines.push("");
-      for (const v of data.validation.results) {
+      for (const v of data.validation.files || []) {
         if (v.errors.length > 0 || v.warnings.length > 0) {
           lines.push(`#### ${v.file}`);
           for (const e of v.errors) {
@@ -10717,6 +11119,41 @@ function renderMarkdownReport(data) {
 // src/cli/commands/report.ts
 init_fs();
 init_errors();
+init_types();
+function isValidReportFormat(format) {
+  return ["html", "markdown", "json"].includes(format);
+}
+function resolveOutputPath(format, output, projectRoot) {
+  if (!output) {
+    const ext = format === "markdown" ? "md" : format;
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    return path26.join(projectRoot, `sdd-report-${timestamp}.${ext}`);
+  }
+  return path26.isAbsolute(output) ? output : path26.join(projectRoot, output);
+}
+async function executeReport(options, projectRoot) {
+  const sddPath = path26.join(projectRoot, ".sdd");
+  const format = options.format || "html";
+  if (!isValidReportFormat(format)) {
+    return failure(new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4: ${format}. \uC9C0\uC6D0 \uD615\uC2DD: html, markdown, json`));
+  }
+  const outputPath = resolveOutputPath(format, options.output, projectRoot);
+  const result = await generateReport(sddPath, {
+    format,
+    outputPath,
+    title: options.title,
+    includeQuality: options.quality !== false,
+    includeValidation: options.validation !== false
+  });
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success({
+    format,
+    outputPath: result.data.outputPath || outputPath,
+    content: result.data.content
+  });
+}
 function registerReportCommand(program2) {
   program2.command("report").description("\uC2A4\uD399 \uB9AC\uD3EC\uD2B8\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4").option("-f, --format <format>", "\uCD9C\uB825 \uD615\uC2DD (html, markdown, json)", "html").option("-o, --output <path>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C").option("--title <title>", "\uB9AC\uD3EC\uD2B8 \uC81C\uBAA9").option("--no-quality", "\uD488\uC9C8 \uBD84\uC11D \uC81C\uC678").option("--no-validation", "\uAC80\uC99D \uACB0\uACFC \uC81C\uC678").action(async (options) => {
     try {
@@ -10733,33 +11170,13 @@ async function runReport(options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const sddPath = path26.join(projectRoot, ".sdd");
   const format = options.format || "html";
-  if (!["html", "markdown", "json"].includes(format)) {
-    error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4: ${format}`);
-    info("\uC9C0\uC6D0 \uD615\uC2DD: html, markdown, json");
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  let outputPath = options.output;
-  if (!outputPath) {
-    const ext = format === "markdown" ? "md" : format;
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    outputPath = path26.join(projectRoot, `sdd-report-${timestamp}.${ext}`);
-  } else if (!path26.isAbsolute(outputPath)) {
-    outputPath = path26.join(projectRoot, outputPath);
-  }
   info("\u{1F4CA} \uB9AC\uD3EC\uD2B8 \uC0DD\uC131 \uC911...");
   info(`   \uD615\uC2DD: ${format}`);
   info(`   \uD488\uC9C8 \uBD84\uC11D: ${options.quality !== false ? "\uD3EC\uD568" : "\uC81C\uC678"}`);
   info(`   \uAC80\uC99D \uACB0\uACFC: ${options.validation !== false ? "\uD3EC\uD568" : "\uC81C\uC678"}`);
   newline();
-  const result = await generateReport(sddPath, {
-    format,
-    outputPath,
-    title: options.title,
-    includeQuality: options.quality !== false,
-    includeValidation: options.validation !== false
-  });
+  const result = await executeReport(options, projectRoot);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);