sdd-tool 0.5.1 → 0.6.1

package/dist/cli/index.js

@@ -128,10 +128,10 @@ var init_base = __esm({
     };
     FileSystemError = class extends SddError {
       path;
-      constructor(code, path27) {
-        super(code, formatMessage(code, path27), ExitCode.FILE_SYSTEM_ERROR);
+      constructor(code, path29) {
+        super(code, formatMessage(code, path29), ExitCode.FILE_SYSTEM_ERROR);
         this.name = "FileSystemError";
-        this.path = path27;
+        this.path = path29;
       }
     };
     ValidationError = class extends SddError {
@@ -2497,6 +2497,263 @@ sdd transition change-to-new <change-id>
 \`\`\`bash
 sdd transition guide
 \`\`\`
+`
+    },
+    // CLI 래퍼 커맨드들
+    {
+      name: "sdd.search",
+      content: `---
+description: SDD \uC2A4\uD399\uC744 \uAC80\uC0C9\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [query] [--status draft] [--phase phase1]
+---
+
+sdd search \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd search $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--status <status>\`: \uC0C1\uD0DC \uD544\uD130 (draft, review, approved)
+- \`--phase <phase>\`: Phase \uD544\uD130
+- \`--author <name>\`: \uC791\uC131\uC790 \uD544\uD130
+- \`--tags <tags>\`: \uD0DC\uADF8 \uD544\uD130 (\uCF64\uB9C8 \uAD6C\uBD84)
+- \`--depends-on <spec>\`: \uC758\uC874\uC131 \uD544\uD130
+- \`--limit <n>\`: \uACB0\uACFC \uC81C\uD55C
+- \`--sort-by <field>\`: \uC815\uB82C \uAE30\uC900 (relevance, created, updated, title, status)
+- \`-r, --regex\`: \uC815\uADDC\uC2DD \uAC80\uC0C9
+- \`-c, --case-sensitive\`: \uB300\uC18C\uBB38\uC790 \uAD6C\uBD84
+- \`--json\`: JSON \uCD9C\uB825
+
+\uAC80\uC0C9 \uACB0\uACFC\uB97C \uBD84\uC11D\uD558\uACE0 \uAD00\uB828 \uC2A4\uD399 \uC815\uBCF4\uB97C \uC694\uC57D\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.quality",
+      content: `---
+description: SDD \uC2A4\uD399 \uD488\uC9C8\uC744 \uBD84\uC11D\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [specId] [--all] [--json]
+---
+
+sdd quality \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd quality $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--all\`: \uBAA8\uB4E0 \uC2A4\uD399 \uBD84\uC11D
+- \`--json\`: JSON \uD615\uC2DD \uCD9C\uB825
+- \`--min-score <n>\`: \uCD5C\uC18C \uC810\uC218 \uAE30\uC900
+
+## \uB4F1\uAE09 \uAE30\uC900
+
+| \uB4F1\uAE09 | \uC810\uC218 | \uC124\uBA85 |
+|------|------|------|
+| A | 90-100 | \uC6B0\uC218 |
+| B | 80-89 | \uC591\uD638 |
+| C | 70-79 | \uBCF4\uD1B5 |
+| D | 60-69 | \uBBF8\uD761 |
+| F | 0-59 | \uBD80\uC871 |
+
+\uBD84\uC11D \uACB0\uACFC\uB97C \uBC14\uD0D5\uC73C\uB85C \uD488\uC9C8 \uAC1C\uC120 \uBC29\uC548\uC744 \uC81C\uC548\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.report",
+      content: `---
+description: SDD \uD504\uB85C\uC81D\uD2B8 \uB9AC\uD3EC\uD2B8\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read, Write
+argument-hint: [--format html] [-o report.html]
+---
+
+sdd report \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd report $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--format <type>\`: \uCD9C\uB825 \uD615\uC2DD (html, markdown, json)
+- \`-o, --output <path>\`: \uD30C\uC77C\uB85C \uC800\uC7A5
+- \`--title <title>\`: \uB9AC\uD3EC\uD2B8 \uC81C\uBAA9
+- \`--no-quality\`: \uD488\uC9C8 \uBD84\uC11D \uC81C\uC678
+- \`--no-validation\`: \uAC80\uC99D \uACB0\uACFC \uC81C\uC678
+
+\uB9AC\uD3EC\uD2B8 \uB0B4\uC6A9\uC744 \uC694\uC57D\uD558\uACE0 \uC8FC\uC694 \uC9C0\uD45C\uB97C \uC124\uBA85\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.impact",
+      content: `---
+description: SDD \uC2A4\uD399 \uBCC0\uACBD\uC758 \uC601\uD5A5\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: <specId> [--graph] [--code] [--json]
+---
+
+sdd impact \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd impact $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--graph\`: Mermaid \uC758\uC874\uC131 \uADF8\uB798\uD504 \uCD9C\uB825
+- \`--code\`: \uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D
+- \`--json\`: JSON \uD615\uC2DD \uCD9C\uB825
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`report\`: \uC804\uCCB4 \uD504\uB85C\uC81D\uD2B8 \uC601\uD5A5\uB3C4 \uB9AC\uD3EC\uD2B8
+- \`change <id>\`: \uBCC0\uACBD \uC81C\uC548\uC758 \uC601\uD5A5\uB3C4
+- \`simulate --remove <spec>\`: What-if \uC2DC\uBBAC\uB808\uC774\uC158
+
+\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399\uACFC \uCF54\uB4DC\uB97C \uBD84\uC11D\uD558\uACE0 \uBCC0\uACBD \uC804\uB7B5\uC744 \uC81C\uC548\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.list",
+      content: `---
+description: SDD \uD56D\uBAA9 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [features|changes|specs|templates] [--status draft]
+---
+
+sdd list \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd list $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- (\uC5C6\uC74C): \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D
+- \`features\` (f): \uAE30\uB2A5 \uBAA9\uB85D
+- \`changes\` (c): \uBCC0\uACBD \uBAA9\uB85D
+- \`specs\` (s): \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D
+- \`templates\` (t): \uD15C\uD50C\uB9BF \uBAA9\uB85D
+
+## \uC635\uC158
+
+- \`--status <status>\`: \uC0C1\uD0DC\uBCC4 \uD544\uD130 (features)
+- \`--pending\`: \uB300\uAE30 \uC911\uB9CC (changes)
+- \`--archived\`: \uC544\uCE74\uC774\uBE0C\uB9CC (changes)
+
+\uBAA9\uB85D\uC744 \uBD84\uC11D\uD558\uACE0 \uC694\uC57D\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.migrate",
+      content: `---
+description: \uAE30\uC874 \uD504\uB85C\uC81D\uD2B8\uB97C SDD\uB85C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [detect|openspec|speckit|docs] [--dry-run]
+---
+
+sdd migrate \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd migrate $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`detect\`: \uAE30\uC874 \uB3C4\uAD6C \uAC10\uC9C0
+- \`openspec\`: OpenSpec\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158
+- \`speckit\`: SpecKit\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158
+- \`docs\`: \uB9C8\uD06C\uB2E4\uC6B4 \uBB38\uC11C \uBCC0\uD658
+
+## \uC635\uC158
+
+- \`--dry-run\`: \uBBF8\uB9AC\uBCF4\uAE30
+- \`--overwrite\`: \uAE30\uC874 \uC2A4\uD399 \uB36E\uC5B4\uC4F0\uAE30
+- \`--source <path>\`: \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC
+
+\uB9C8\uC774\uADF8\uB808\uC774\uC158 \uACB0\uACFC\uB97C \uD655\uC778\uD558\uACE0 \uD544\uC694\uD55C \uD6C4\uC18D \uC791\uC5C5\uC744 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.cicd",
+      content: `---
+description: CI/CD \uD30C\uC774\uD504\uB77C\uC778\uC744 \uC124\uC815\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read, Write
+argument-hint: [setup|hooks|check] [--platform github]
+---
+
+sdd cicd \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd cicd $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`setup\`: CI/CD \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0DD\uC131
+- \`hooks\`: Git hooks \uC124\uC815
+- \`check\`: CI \uAC80\uC99D \uC2E4\uD589
+
+## \uC635\uC158
+
+- \`--platform <type>\`: github, gitlab, all
+
+\uC0DD\uC131\uB41C CI/CD \uC124\uC815\uC744 \uD655\uC778\uD558\uACE0 \uCD94\uAC00 \uC124\uC815\uC774 \uD544\uC694\uD558\uBA74 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.watch",
+      content: `---
+description: \uC2A4\uD399 \uD30C\uC77C \uBCC0\uACBD\uC744 \uAC10\uC2DC\uD569\uB2C8\uB2E4
+allowed-tools: Bash
+argument-hint: [--validate] [--path .sdd/specs]
+---
+
+sdd watch \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd watch $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--path <dir>\`: \uAC10\uC2DC\uD560 \uB514\uB809\uD1A0\uB9AC
+- \`--validate\`: \uBCC0\uACBD \uC2DC \uC790\uB3D9 \uAC80\uC99D
+- \`--quality\`: \uBCC0\uACBD \uC2DC \uD488\uC9C8 \uAC80\uC0AC
+
+Ctrl+C\uB85C \uC885\uB8CC\uD569\uB2C8\uB2E4.
+`
+    },
+    {
+      name: "sdd.prompt",
+      content: `---
+description: SDD \uC791\uC5C5\uC6A9 AI \uD504\uB86C\uD504\uD2B8\uB97C \uCD9C\uB825\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [change|apply|archive|validate] [--list]
+---
+
+sdd prompt \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd prompt $ARGUMENTS
+\`\`\`
+
+## \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uD504\uB86C\uD504\uD2B8
+
+- \`change\`: \uBCC0\uACBD \uC81C\uC548 \uC791\uC131
+- \`apply\`: \uBCC0\uACBD \uC801\uC6A9
+- \`archive\`: \uBCC0\uACBD \uC544\uCE74\uC774\uBE0C
+- \`validate\`: \uC2A4\uD399 \uAC80\uC99D
+
+## \uC635\uC158
+
+- \`--list\`: \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uD504\uB86C\uD504\uD2B8 \uBAA9\uB85D
+
+\uD504\uB86C\uD504\uD2B8 \uB0B4\uC6A9\uC744 \uCD9C\uB825\uD558\uACE0 \uC0AC\uC6A9 \uBC29\uBC95\uC744 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
 `
     }
   ];
@@ -3677,9 +3934,9 @@ async function validateSpecs(targetPath, options = {}) {
 async function findSpecFiles(dirPath) {
   const files = [];
   async function scanDir(dir) {
-    const { promises: fs15 } = await import("fs");
+    const { promises: fs16 } = await import("fs");
     try {
-      const entries = await fs15.readdir(dir, { withFileTypes: true });
+      const entries = await fs16.readdir(dir, { withFileTypes: true });
       for (const entry of entries) {
         const fullPath = path3.join(dir, entry.name);
         if (entry.isDirectory()) {
@@ -5802,19 +6059,19 @@ function detectCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recStack = /* @__PURE__ */ new Set();
-  function dfs(nodeId, path27) {
+  function dfs(nodeId, path29) {
     visited.add(nodeId);
     recStack.add(nodeId);
     const node = graph.nodes.get(nodeId);
     if (!node) return false;
     for (const depId of node.dependsOn) {
       if (!visited.has(depId)) {
-        if (dfs(depId, [...path27, nodeId])) {
+        if (dfs(depId, [...path29, nodeId])) {
           return true;
         }
       } else if (recStack.has(depId)) {
-        const cycleStart = path27.indexOf(depId);
-        const cycle = cycleStart >= 0 ? [...path27.slice(cycleStart), nodeId, depId] : [nodeId, depId];
+        const cycleStart = path29.indexOf(depId);
+        const cycle = cycleStart >= 0 ? [...path29.slice(cycleStart), nodeId, depId] : [nodeId, depId];
         cycles.push({
           cycle,
           description: `\uC21C\uD658 \uC758\uC874\uC131: ${cycle.join(" \u2192 ")}`
@@ -11189,6 +11446,395 @@ async function runReport(options) {
   }
 }
 
+// src/cli/commands/search.ts
+import path28 from "path";
+init_fs();
+
+// src/core/search/searcher.ts
+init_types();
+init_errors();
+init_fs();
+import path27 from "path";
+import { promises as fs15 } from "fs";
+async function searchSpecs(sddPath, options = {}) {
+  const startTime = Date.now();
+  try {
+    const specsPath = path27.join(sddPath, "specs");
+    if (!await directoryExists(specsPath)) {
+      return failure(new ChangeError("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const indexResult = await buildSearchIndex(specsPath);
+    if (!indexResult.success) {
+      return failure(indexResult.error);
+    }
+    const index = indexResult.data;
+    let results = filterByOptions(index, options);
+    if (options.query) {
+      results = searchByQuery(results, options.query, options);
+    } else {
+      results = results.map((item) => ({ ...item, score: 100, matches: [] }));
+    }
+    results = sortResults(results, options);
+    if (options.limit && options.limit > 0) {
+      results = results.slice(0, options.limit);
+    }
+    const duration = Date.now() - startTime;
+    return success({
+      query: options.query || "*",
+      options,
+      totalCount: results.length,
+      items: results,
+      duration
+    });
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uAC80\uC0C9 \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function buildSearchIndex(specsPath) {
+  try {
+    const index = [];
+    await collectSpecs(specsPath, specsPath, index);
+    return success(index);
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uC778\uB371\uC2A4 \uAD6C\uCD95 \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function collectSpecs(basePath, currentPath, index) {
+  const entries = await fs15.readdir(currentPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path27.join(currentPath, entry.name);
+    if (entry.isDirectory()) {
+      await collectSpecs(basePath, fullPath, index);
+    } else if (entry.name === "spec.md") {
+      const content = await fs15.readFile(fullPath, "utf-8");
+      const relativePath = path27.relative(basePath, fullPath);
+      const specId = path27.dirname(relativePath);
+      const metadata = parseMetadata(content);
+      const stat = await fs15.stat(fullPath);
+      index.push({
+        id: specId === "." ? entry.name : specId,
+        path: relativePath,
+        title: metadata.title || specId,
+        content,
+        status: metadata.status || "unknown",
+        phase: metadata.phase || "unknown",
+        author: metadata.author || "",
+        created: metadata.created || "",
+        updated: metadata.updated || stat.mtime.toISOString().split("T")[0],
+        depends: parseDependencies(metadata.depends),
+        tags: parseTags(metadata.tags)
+      });
+    }
+  }
+}
+function parseMetadata(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const metadata = {};
+  const lines = match[1].split("\n");
+  for (const line of lines) {
+    const kvMatch = line.match(/^(\w+):\s*(.*)$/);
+    if (kvMatch) {
+      let value = kvMatch[2].trim();
+      if (value.startsWith('"') && value.endsWith('"')) {
+        value = value.slice(1, -1);
+      }
+      if (value === "null" || value === "~") {
+        value = null;
+      }
+      metadata[kvMatch[1]] = value;
+    }
+  }
+  return metadata;
+}
+function parseDependencies(depends) {
+  if (!depends) return [];
+  if (Array.isArray(depends)) return depends.filter(Boolean);
+  if (typeof depends === "string" && depends !== "null") {
+    return depends.split(",").map((d) => d.trim()).filter(Boolean);
+  }
+  return [];
+}
+function parseTags(tags) {
+  if (!tags) return [];
+  if (Array.isArray(tags)) return tags.filter(Boolean);
+  if (typeof tags === "string") {
+    return tags.split(",").map((t) => t.trim()).filter(Boolean);
+  }
+  return [];
+}
+function filterByOptions(index, options) {
+  return index.filter((item) => {
+    if (options.status) {
+      const statuses = Array.isArray(options.status) ? options.status : [options.status];
+      if (!statuses.includes(item.status)) return false;
+    }
+    if (options.phase) {
+      const phases = Array.isArray(options.phase) ? options.phase : [options.phase];
+      if (!phases.includes(item.phase)) return false;
+    }
+    if (options.author) {
+      if (!item.author.toLowerCase().includes(options.author.toLowerCase())) {
+        return false;
+      }
+    }
+    if (options.createdAfter && item.created) {
+      if (item.created < options.createdAfter) return false;
+    }
+    if (options.createdBefore && item.created) {
+      if (item.created > options.createdBefore) return false;
+    }
+    if (options.updatedAfter && item.updated) {
+      if (item.updated < options.updatedAfter) return false;
+    }
+    if (options.updatedBefore && item.updated) {
+      if (item.updated > options.updatedBefore) return false;
+    }
+    if (options.dependsOn) {
+      if (!item.depends.includes(options.dependsOn)) return false;
+    }
+    if (options.tags && options.tags.length > 0) {
+      const hasTag = options.tags.some(
+        (tag) => item.tags.some((t) => t.toLowerCase() === tag.toLowerCase())
+      );
+      if (!hasTag) return false;
+    }
+    return true;
+  });
+}
+function searchByQuery(items, query, options) {
+  const results = [];
+  let pattern;
+  try {
+    if (options.regex) {
+      pattern = new RegExp(query, options.caseSensitive ? "g" : "gi");
+    } else {
+      const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      pattern = new RegExp(escaped, options.caseSensitive ? "g" : "gi");
+    }
+  } catch {
+    const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    pattern = new RegExp(escaped, "gi");
+  }
+  for (const item of items) {
+    const matches = [];
+    let score = 0;
+    if (pattern.test(item.title)) {
+      score += 50;
+      pattern.lastIndex = 0;
+    }
+    if (pattern.test(item.id)) {
+      score += 30;
+      pattern.lastIndex = 0;
+    }
+    const lines = item.content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      pattern.lastIndex = 0;
+      if (pattern.test(line)) {
+        score += 10;
+        const highlighted = line.replace(
+          pattern,
+          (match) => `**${match}**`
+        );
+        matches.push({
+          line: i + 1,
+          content: highlighted.trim(),
+          original: line.trim()
+        });
+      }
+    }
+    if (score > 0) {
+      results.push({
+        id: item.id,
+        path: item.path,
+        title: item.title,
+        status: item.status,
+        phase: item.phase,
+        author: item.author || void 0,
+        created: item.created || void 0,
+        updated: item.updated || void 0,
+        depends: item.depends.length > 0 ? item.depends : void 0,
+        tags: item.tags.length > 0 ? item.tags : void 0,
+        score: Math.min(100, score),
+        matches: matches.slice(0, 5)
+        // 최대 5개 매칭 컨텍스트
+      });
+    }
+  }
+  return results;
+}
+function sortResults(results, options) {
+  const sortBy = options.sortBy || "relevance";
+  const sortOrder = options.sortOrder || "desc";
+  return [...results].sort((a, b) => {
+    let comparison = 0;
+    switch (sortBy) {
+      case "relevance":
+        comparison = a.score - b.score;
+        break;
+      case "created":
+        comparison = (a.created || "").localeCompare(b.created || "");
+        break;
+      case "updated":
+        comparison = (a.updated || "").localeCompare(b.updated || "");
+        break;
+      case "title":
+        comparison = (a.title || "").localeCompare(b.title || "");
+        break;
+      case "status":
+        comparison = (a.status || "").localeCompare(b.status || "");
+        break;
+      default:
+        comparison = a.score - b.score;
+    }
+    return sortOrder === "asc" ? comparison : -comparison;
+  });
+}
+function formatSearchResult(result) {
+  const lines = [];
+  lines.push(`\u{1F50D} \uAC80\uC0C9 \uACB0\uACFC: "${result.query}"`);
+  lines.push(`   ${result.totalCount}\uAC1C \uBC1C\uACAC (${result.duration}ms)`);
+  lines.push("");
+  if (result.items.length === 0) {
+    lines.push("   \uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return lines.join("\n");
+  }
+  for (const item of result.items) {
+    const statusIcon = getStatusIcon2(item.status);
+    const scoreBar = getScoreBar(item.score);
+    lines.push(`${statusIcon} ${item.id}`);
+    if (item.title && item.title !== item.id) {
+      lines.push(`   \uC81C\uBAA9: ${item.title}`);
+    }
+    lines.push(`   \uC0C1\uD0DC: ${item.status || "unknown"} | Phase: ${item.phase || "unknown"} | \uC810\uC218: ${scoreBar}`);
+    if (item.matches && item.matches.length > 0) {
+      lines.push("   \uB9E4\uCE6D:");
+      for (const match of item.matches.slice(0, 3)) {
+        const truncated = match.content.length > 60 ? match.content.slice(0, 60) + "..." : match.content;
+        lines.push(`     L${match.line}: ${truncated}`);
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getStatusIcon2(status) {
+  switch (status) {
+    case "draft":
+      return "\u{1F4DD}";
+    case "review":
+      return "\u{1F440}";
+    case "approved":
+      return "\u2705";
+    case "implemented":
+      return "\u{1F680}";
+    case "deprecated":
+      return "\u26A0\uFE0F";
+    default:
+      return "\u{1F4C4}";
+  }
+}
+function getScoreBar(score) {
+  const filled = Math.round(score / 10);
+  const empty = 10 - filled;
+  return "\u2588".repeat(filled) + "\u2591".repeat(empty) + ` ${score}%`;
+}
+function formatSearchResultJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+
+// src/cli/commands/search.ts
+function parseSearchCliOptions(query, options) {
+  const searchOptions = {};
+  if (query) {
+    searchOptions.query = query;
+  }
+  if (options.status) {
+    searchOptions.status = options.status.includes(",") ? options.status.split(",").map((s) => s.trim()) : options.status;
+  }
+  if (options.phase) {
+    searchOptions.phase = options.phase.includes(",") ? options.phase.split(",").map((p) => p.trim()) : options.phase;
+  }
+  if (options.author) {
+    searchOptions.author = options.author;
+  }
+  if (options.tags) {
+    searchOptions.tags = options.tags.split(",").map((t) => t.trim());
+  }
+  if (options.createdAfter) {
+    searchOptions.createdAfter = options.createdAfter;
+  }
+  if (options.createdBefore) {
+    searchOptions.createdBefore = options.createdBefore;
+  }
+  if (options.updatedAfter) {
+    searchOptions.updatedAfter = options.updatedAfter;
+  }
+  if (options.updatedBefore) {
+    searchOptions.updatedBefore = options.updatedBefore;
+  }
+  if (options.dependsOn) {
+    searchOptions.dependsOn = options.dependsOn;
+  }
+  if (options.limit) {
+    const limit = parseInt(options.limit, 10);
+    if (!isNaN(limit) && limit > 0) {
+      searchOptions.limit = limit;
+    }
+  }
+  if (options.sortBy) {
+    const validSortBy = ["relevance", "created", "updated", "title", "status"];
+    if (validSortBy.includes(options.sortBy)) {
+      searchOptions.sortBy = options.sortBy;
+    }
+  }
+  if (options.sortOrder) {
+    if (options.sortOrder === "asc" || options.sortOrder === "desc") {
+      searchOptions.sortOrder = options.sortOrder;
+    }
+  }
+  if (options.regex) {
+    searchOptions.regex = true;
+  }
+  if (options.caseSensitive) {
+    searchOptions.caseSensitive = true;
+  }
+  return searchOptions;
+}
+function registerSearchCommand(program2) {
+  program2.command("search [query]").description("\uC2A4\uD399 \uAC80\uC0C9").option("--status <status>", "\uC0C1\uD0DC \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--phase <phase>", "Phase \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--author <author>", "\uC791\uC131\uC790 \uD544\uD130").option("--tags <tags>", "\uD0DC\uADF8 \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--created-after <date>", "\uC0DD\uC131\uC77C \uC774\uD6C4 (YYYY-MM-DD)").option("--created-before <date>", "\uC0DD\uC131\uC77C \uC774\uC804 (YYYY-MM-DD)").option("--updated-after <date>", "\uC218\uC815\uC77C \uC774\uD6C4 (YYYY-MM-DD)").option("--updated-before <date>", "\uC218\uC815\uC77C \uC774\uC804 (YYYY-MM-DD)").option("--depends-on <specId>", "\uC758\uC874\uC131 \uD544\uD130").option("--limit <n>", "\uACB0\uACFC \uC81C\uD55C \uC218").option("--sort-by <field>", "\uC815\uB82C \uAE30\uC900 (relevance, created, updated, title, status)").option("--sort-order <order>", "\uC815\uB82C \uBC29\uD5A5 (asc, desc)").option("-r, --regex", "\uC815\uADDC\uC2DD \uAC80\uC0C9").option("-c, --case-sensitive", "\uB300\uC18C\uBB38\uC790 \uAD6C\uBD84").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").action(async (query, options) => {
+    await executeSearch(query, options);
+  });
+}
+async function executeSearch(query, options) {
+  const sddPath = path28.join(process.cwd(), ".sdd");
+  if (!await fileExists(sddPath)) {
+    logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    return;
+  }
+  const searchOptions = parseSearchCliOptions(query, options);
+  const result = await searchSpecs(sddPath, searchOptions);
+  if (!result.success) {
+    logger_exports.error(`\uAC80\uC0C9 \uC2E4\uD328: ${result.error.message}`);
+    return;
+  }
+  if (options.json) {
+    console.log(formatSearchResultJson(result.data));
+  } else {
+    console.log("");
+    console.log(formatSearchResult(result.data));
+  }
+}
+
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
@@ -11210,6 +11856,7 @@ registerTransitionCommand(program);
 registerWatchCommand(program);
 registerQualityCommand(program);
 registerReportCommand(program);
+registerSearchCommand(program);
 function run() {
   program.parse();
 }