@simplysm/sd-claude 13.0.0-beta.11

package/claude/skills/sd-worktree/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: sd-worktree
+description: Use when starting new feature work, bug fixes, or any task that benefits from branch isolation - creates a git worktree under .worktrees/ and guides to next planning step
+model: haiku
+---
+
+# sd-worktree
+
+## Overview
+
+Create, merge, and clean up git worktrees under `.worktrees/`. Uses the current branch of the main working tree as the source branch.
+
+**Important**: Claude Code's working directory (cd) shifts between main and worktree, so always verify the cd location before and after each command.
+
+## Target Worktree Resolution
+
+For all commands, the target worktree name is resolved in this order:
+1. Explicitly provided in args → use as-is
+2. Current cd is inside `.worktrees/<name>/` → use that `<name>` (auto-detected)
+3. Neither applies → ask the user
+
+## Commands
+
+### add — Create a worktree
+
+Take a work description from args, determine a kebab-case name, then run:
+
+```bash
+# Run from main
+node .claude/skills/sd-worktree/sd-worktree.mjs add <name>
+cd .worktrees/<name>   # Move into the worktree
+```
+
+- All subsequent work should be done inside the worktree
+- Suggest next steps:
+  1. **brainstorming** (`/sd-brainstorm`)
+  2. **writing-plans** (`/sd-plan`)
+
+### rebase — Rebase onto main branch
+
+```bash
+# Can be run from inside the worktree
+node .claude/skills/sd-worktree/sd-worktree.mjs rebase [name]
+```
+
+- Rebases the worktree branch onto the latest commit of the main branch
+- Errors if uncommitted changes exist → commit or stash first
+- Use when you want a clean history before merging
+
+### merge — Merge into main branch
+
+```bash
+# Can be run from inside the worktree (script sets cwd to main)
+node .claude/skills/sd-worktree/sd-worktree.mjs merge [name]
+```
+
+- Merges the worktree branch into the main working tree's current branch with `--no-ff`
+- Errors if uncommitted changes exist → commit or stash first
+- After merge, always `cd <project-root>` (required for subsequent clean)
+
+### clean — Remove worktree and delete branch
+
+```bash
+# Must cd to main first (worktree directory will be deleted)
+cd <project-root>
+node .claude/skills/sd-worktree/sd-worktree.mjs clean <name>
+```
+
+- Runs `git worktree remove` + `git branch -d`
+- Script blocks execution if run from inside the worktree → must cd to main first
+
+## Full Workflow Example
+
+```
+(main: 13.x)  → /sd-worktree add modal-migration
+               → cd .worktrees/modal-migration
+(worktree)    → ... work ...
+(worktree)    → /sd-worktree rebase          # (optional) rebase onto latest main
+(worktree)    → /sd-worktree merge
+(worktree)    → cd <project-root>
+(main: 13.x)  → /sd-worktree clean modal-migration
+```

package/claude/skills/sd-worktree/sd-worktree.mjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+const [cmd, ...args] = process.argv.slice(2);
+
+function run(command, opts) {
+  execSync(command, { encoding: "utf-8", stdio: "inherit", ...opts });
+}
+
+function getOutput(command) {
+  return execSync(command, { encoding: "utf-8" }).trim();
+}
+
+// 메인 working tree 경로 (worktree 안에서 실행해도 정확)
+const mainWorktree = getOutput("git worktree list --porcelain").split("\n")[0].replace("worktree ", "");
+
+function detectWorktreeName() {
+  const cwd = process.cwd();
+  const worktreesDir = resolve(mainWorktree, ".worktrees");
+  if (cwd.startsWith(worktreesDir + "/")) {
+    return cwd.slice(worktreesDir.length + 1).split("/")[0];
+  }
+  return undefined;
+}
+
+function getMainBranch() {
+  return getOutput(`git -C "${mainWorktree}" rev-parse --abbrev-ref HEAD`);
+}
+
+switch (cmd) {
+  case "add": {
+    const name = args[0];
+    if (!name) {
+      console.error("Usage: sd-worktree.mjs add <kebab-case-name>");
+      process.exit(1);
+    }
+    const worktreePath = resolve(mainWorktree, ".worktrees", name);
+    if (existsSync(worktreePath)) {
+      console.error(`Already exists: ${worktreePath}`);
+      process.exit(1);
+    }
+    const branch = getMainBranch();
+    console.log(`Creating worktree: .worktrees/${name} (from ${branch})`);
+    run(`git worktree add "${worktreePath}" -b "${name}"`);
+    console.log("Installing dependencies...");
+    run("pnpm install", { cwd: worktreePath });
+    console.log(`\nReady: ${worktreePath}`);
+    break;
+  }
+
+  case "merge": {
+    const name = args[0] ?? detectWorktreeName();
+    if (!name) {
+      console.error("Usage: sd-worktree.mjs merge [name]  (or run inside .worktrees/<name>)");
+      process.exit(1);
+    }
+    // uncommitted 변경 확인
+    const worktreePath_m = resolve(mainWorktree, ".worktrees", name);
+    if (existsSync(worktreePath_m)) {
+      const status = getOutput(`git -C "${worktreePath_m}" status --porcelain`);
+      if (status) {
+        console.error(`Error: worktree '${name}' has uncommitted changes:\n${status}`);
+        console.error("Commit or stash changes before merging.");
+        process.exit(1);
+      }
+    }
+    const branch = getMainBranch();
+    console.log(`Merging '${name}' into '${branch}'...`);
+    run(`git merge "${name}" --no-ff`, { cwd: mainWorktree });
+    console.log(`\nMerged '${name}' into '${branch}'.`);
+    break;
+  }
+
+  case "rebase": {
+    const name = args[0] ?? detectWorktreeName();
+    if (!name) {
+      console.error("Usage: sd-worktree.mjs rebase [name]  (or run inside .worktrees/<name>)");
+      process.exit(1);
+    }
+    const worktreePath_r = resolve(mainWorktree, ".worktrees", name);
+    if (!existsSync(worktreePath_r)) {
+      console.error(`Error: worktree '${name}' does not exist.`);
+      process.exit(1);
+    }
+    // uncommitted 변경 확인
+    const statusR = getOutput(`git -C "${worktreePath_r}" status --porcelain`);
+    if (statusR) {
+      console.error(`Error: worktree '${name}' has uncommitted changes:\n${statusR}`);
+      console.error("Commit or stash changes before rebasing.");
+      process.exit(1);
+    }
+    const branchR = getMainBranch();
+    console.log(`Rebasing '${name}' onto '${branchR}'...`);
+    run(`git rebase "${branchR}"`, { cwd: worktreePath_r });
+    console.log(`\nRebased '${name}' onto '${branchR}'.`);
+    break;
+  }
+
+  case "clean": {
+    const name = args[0] ?? detectWorktreeName();
+    if (!name) {
+      console.error("Usage: sd-worktree.mjs clean [name]  (or run inside .worktrees/<name>)");
+      process.exit(1);
+    }
+    // worktree 안에서 실행 시 차단
+    const worktreePath = resolve(mainWorktree, ".worktrees", name);
+    const cwd = process.cwd();
+    if (cwd === worktreePath || cwd.startsWith(worktreePath + "/")) {
+      console.error(`Error: Cannot clean '${name}' from inside its worktree.`);
+      console.error(`Run: cd "${mainWorktree}" && node .claude/skills/sd-worktree/sd-worktree.mjs clean ${name}`);
+      process.exit(1);
+    }
+    if (existsSync(worktreePath)) {
+      console.log(`Removing worktree: .worktrees/${name}`);
+      run(`git worktree remove "${worktreePath}"`, { cwd: mainWorktree });
+    }
+    console.log(`Deleting branch: ${name}`);
+    run(`git branch -d "${name}"`, { cwd: mainWorktree });
+    console.log(`\nCleaned up '${name}'.`);
+    break;
+  }
+
+  default:
+    console.error("Usage: sd-worktree.mjs <add|merge|rebase|clean> [name]");
+    process.exit(1);
+}

package/dist/commands/install.js

@@ -0,0 +1,64 @@
+import path from "path";
+import fs from "fs";
+import { consola } from "consola";
+import { fsGlob, fsExists, fsCopy, fsRm, fsMkdir, fsReadJson, fsWriteJson } from "@simplysm/core-node";
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  while (!fs.existsSync(path.join(dir, "package.json"))) {
+    const parent = path.dirname(dir);
+    if (parent === dir) throw new Error("package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    dir = parent;
+  }
+  return dir;
+}
+async function findSdEntries(baseDir) {
+  const [rootEntries, subEntries] = await Promise.all([
+    fsGlob(path.join(baseDir, "sd-*")),
+    fsGlob(path.join(baseDir, "*/sd-*"))
+  ]);
+  return [...rootEntries, ...subEntries];
+}
+async function runInstall(_options) {
+  const cwd = process.cwd();
+  const logger = consola.withTag("sd:claude:install");
+  const pkgRoot = findPackageRoot(import.meta.dirname);
+  const sourceDir = path.join(pkgRoot, "claude");
+  if (!await fsExists(sourceDir)) {
+    consola.error(`\uC5D0\uC14B \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${sourceDir}`);
+    process.exitCode = 1;
+    return;
+  }
+  const sourceEntries = await findSdEntries(sourceDir);
+  if (sourceEntries.length === 0) {
+    logger.warn("\uC124\uCE58\uD560 sd-* \uC5D0\uC14B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const targetDir = path.join(cwd, ".claude");
+  if (await fsExists(targetDir)) {
+    const existingEntries = await findSdEntries(targetDir);
+    for (const entry of existingEntries) {
+      await fsRm(entry);
+      logger.debug(`\uC0AD\uC81C: ${path.relative(cwd, entry)}`);
+    }
+  }
+  await fsMkdir(targetDir);
+  for (const entry of sourceEntries) {
+    const relativePath = path.relative(sourceDir, entry);
+    const targetPath = path.join(targetDir, relativePath);
+    await fsCopy(entry, targetPath);
+    logger.info(`\uC124\uCE58: .claude/${relativePath}`);
+  }
+  const settingsPath = path.join(targetDir, "settings.json");
+  const sdStatusLineCommand = "node .claude/sd-statusline.js";
+  const settings = await fsExists(settingsPath) ? await fsReadJson(settingsPath) : {};
+  if (settings["statusLine"] == null) {
+    settings["statusLine"] = { type: "command", command: sdStatusLineCommand };
+    await fsWriteJson(settingsPath, settings, { space: 2 });
+    logger.info("settings.json\uC5D0 statusLine \uC124\uC815 \uCD94\uAC00");
+  }
+  logger.info(`${sourceEntries.length}\uAC1C\uC758 sd-* \uD56D\uBAA9\uC744 \uC124\uCE58\uD588\uC2B5\uB2C8\uB2E4.`);
+}
+export {
+  runInstall
+};
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/install.ts"],
+  "sourcesContent": ["import path from \"path\";\nimport fs from \"fs\";\nimport { consola } from \"consola\";\nimport { fsGlob, fsExists, fsCopy, fsRm, fsMkdir, fsReadJson, fsWriteJson } from \"@simplysm/core-node\";\n\n//#region Types\n\n/**\n * Install \uBA85\uB839 \uC635\uC158\n */\nexport interface InstallOptions {}\n\n//#endregion\n\n//#region Utilities\n\n/**\n * import.meta.dirname\uC5D0\uC11C \uC0C1\uC704\uB85C \uC62C\uB77C\uAC00\uBA70 package.json\uC744 \uCC3E\uC544 \uD328\uD0A4\uC9C0 \uB8E8\uD2B8\uB97C \uBC18\uD658\uD55C\uB2E4.\n */\nfunction findPackageRoot(startDir: string): string {\n  let dir = startDir;\n  while (!fs.existsSync(path.join(dir, \"package.json\"))) {\n    const parent = path.dirname(dir);\n    if (parent === dir) throw new Error(\"package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.\");\n    dir = parent;\n  }\n  return dir;\n}\n\n/**\n * sd-* \uD328\uD134\uC5D0 \uB9E4\uCE6D\uB418\uB294 \uD30C\uC77C/\uD3F4\uB354\uB97C \uD0D0\uC0C9\uD55C\uB2E4.\n */\nasync function findSdEntries(baseDir: string): Promise<string[]> {\n  const [rootEntries, subEntries] = await Promise.all([\n    fsGlob(path.join(baseDir, \"sd-*\")),\n    fsGlob(path.join(baseDir, \"*/sd-*\")),\n  ]);\n  return [...rootEntries, ...subEntries];\n}\n\n//#endregion\n\n//#region Main\n\n/**\n * Claude Code \uC2A4\uD0AC/\uC5D0\uC774\uC804\uD2B8\uB97C \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC124\uCE58\uD55C\uB2E4.\n *\n * \uD328\uD0A4\uC9C0\uC758 `claude/` \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C sd-* \uC5D0\uC14B\uC744 \uC77D\uC5B4\n * \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uC758 `.claude/`\uC5D0 \uBCF5\uC0AC\uD55C\uB2E4.\n * \uAE30\uC874 sd-* \uD56D\uBAA9\uC740 \uC804\uCCB4 \uC0AD\uC81C \uD6C4 \uC0C8\uB85C \uBCF5\uC0AC\uD55C\uB2E4.\n */\nexport async function runInstall(_options: InstallOptions): Promise<void> {\n  const cwd = process.cwd();\n  const logger = consola.withTag(\"sd:claude:install\");\n\n  // \uD328\uD0A4\uC9C0\uC758 claude/ \uB514\uB809\uD1A0\uB9AC\n  const pkgRoot = findPackageRoot(import.meta.dirname);\n  const sourceDir = path.join(pkgRoot, \"claude\");\n\n  if (!(await fsExists(sourceDir))) {\n    consola.error(`\uC5D0\uC14B \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${sourceDir}`);\n    process.exitCode = 1;\n    return;\n  }\n\n  // \uC18C\uC2A4\uC5D0\uC11C sd-* \uD56D\uBAA9 \uD0D0\uC0C9\n  const sourceEntries = await findSdEntries(sourceDir);\n  if (sourceEntries.length === 0) {\n    logger.warn(\"\uC124\uCE58\uD560 sd-* \uC5D0\uC14B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\");\n    return;\n  }\n\n  // \uB300\uC0C1 .claude/ \uB514\uB809\uD1A0\uB9AC\n  const targetDir = path.join(cwd, \".claude\");\n\n  // \uAE30\uC874 sd-* \uC0AD\uC81C\n  if (await fsExists(targetDir)) {\n    const existingEntries = await findSdEntries(targetDir);\n    for (const entry of existingEntries) {\n      await fsRm(entry);\n      logger.debug(`\uC0AD\uC81C: ${path.relative(cwd, entry)}`);\n    }\n  }\n\n  // \uBCF5\uC0AC\n  await fsMkdir(targetDir);\n  for (const entry of sourceEntries) {\n    const relativePath = path.relative(sourceDir, entry);\n    const targetPath = path.join(targetDir, relativePath);\n    await fsCopy(entry, targetPath);\n    logger.info(`\uC124\uCE58: .claude/${relativePath}`);\n  }\n\n  // settings.json\uC5D0 statusLine \uC124\uC815\n  const settingsPath = path.join(targetDir, \"settings.json\");\n  const sdStatusLineCommand = \"node .claude/sd-statusline.js\";\n  const settings = (await fsExists(settingsPath)) ? await fsReadJson<Record<string, unknown>>(settingsPath) : {};\n\n  if (settings[\"statusLine\"] == null) {\n    settings[\"statusLine\"] = { type: \"command\", command: sdStatusLineCommand };\n    await fsWriteJson(settingsPath, settings, { space: 2 });\n    logger.info(\"settings.json\uC5D0 statusLine \uC124\uC815 \uCD94\uAC00\");\n  }\n\n  logger.info(`${sourceEntries.length}\uAC1C\uC758 sd-* \uD56D\uBAA9\uC744 \uC124\uCE58\uD588\uC2B5\uB2C8\uB2E4.`);\n}\n\n//#endregion\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,SAAS,eAAe;AACxB,SAAS,QAAQ,UAAU,QAAQ,MAAM,SAAS,YAAY,mBAAmB;AAgBjF,SAAS,gBAAgB,UAA0B;AACjD,MAAI,MAAM;AACV,SAAO,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,cAAc,CAAC,GAAG;AACrD,UAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,QAAI,WAAW,IAAK,OAAM,IAAI,MAAM,kEAA0B;AAC9D,UAAM;AAAA,EACR;AACA,SAAO;AACT;AAKA,eAAe,cAAc,SAAoC;AAC/D,QAAM,CAAC,aAAa,UAAU,IAAI,MAAM,QAAQ,IAAI;AAAA,IAClD,OAAO,KAAK,KAAK,SAAS,MAAM,CAAC;AAAA,IACjC,OAAO,KAAK,KAAK,SAAS,QAAQ,CAAC;AAAA,EACrC,CAAC;AACD,SAAO,CAAC,GAAG,aAAa,GAAG,UAAU;AACvC;AAaA,eAAsB,WAAW,UAAyC;AACxE,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,SAAS,QAAQ,QAAQ,mBAAmB;AAGlD,QAAM,UAAU,gBAAgB,YAAY,OAAO;AACnD,QAAM,YAAY,KAAK,KAAK,SAAS,QAAQ;AAE7C,MAAI,CAAE,MAAM,SAAS,SAAS,GAAI;AAChC,YAAQ,MAAM,6FAAuB,SAAS,EAAE;AAChD,YAAQ,WAAW;AACnB;AAAA,EACF;AAGA,QAAM,gBAAgB,MAAM,cAAc,SAAS;AACnD,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO,KAAK,sEAAoB;AAChC;AAAA,EACF;AAGA,QAAM,YAAY,KAAK,KAAK,KAAK,SAAS;AAG1C,MAAI,MAAM,SAAS,SAAS,GAAG;AAC7B,UAAM,kBAAkB,MAAM,cAAc,SAAS;AACrD,eAAW,SAAS,iBAAiB;AACnC,YAAM,KAAK,KAAK;AAChB,aAAO,MAAM,iBAAO,KAAK,SAAS,KAAK,KAAK,CAAC,EAAE;AAAA,IACjD;AAAA,EACF;AAGA,QAAM,QAAQ,SAAS;AACvB,aAAW,SAAS,eAAe;AACjC,UAAM,eAAe,KAAK,SAAS,WAAW,KAAK;AACnD,UAAM,aAAa,KAAK,KAAK,WAAW,YAAY;AACpD,UAAM,OAAO,OAAO,UAAU;AAC9B,WAAO,KAAK,yBAAe,YAAY,EAAE;AAAA,EAC3C;AAGA,QAAM,eAAe,KAAK,KAAK,WAAW,eAAe;AACzD,QAAM,sBAAsB;AAC5B,QAAM,WAAY,MAAM,SAAS,YAAY,IAAK,MAAM,WAAoC,YAAY,IAAI,CAAC;AAE7G,MAAI,SAAS,YAAY,KAAK,MAAM;AAClC,aAAS,YAAY,IAAI,EAAE,MAAM,WAAW,SAAS,oBAAoB;AACzE,UAAM,YAAY,cAAc,UAAU,EAAE,OAAO,EAAE,CAAC;AACtD,WAAO,KAAK,0DAAiC;AAAA,EAC/C;AAEA,SAAO,KAAK,GAAG,cAAc,MAAM,4EAAqB;AAC1D;",
+  "names": []
+}

package/dist/commands/uninstall.js

@@ -0,0 +1,40 @@
+import path from "path";
+import { consola } from "consola";
+import { fsGlob, fsExists, fsRm, fsReadJson, fsWriteJson } from "@simplysm/core-node";
+async function runUninstall(_options) {
+  const cwd = process.cwd();
+  const logger = consola.withTag("sd:claude:uninstall");
+  const targetDir = path.join(cwd, ".claude");
+  if (!await fsExists(targetDir)) {
+    logger.warn(".claude \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const [rootEntries, subEntries] = await Promise.all([
+    fsGlob(path.join(targetDir, "sd-*")),
+    fsGlob(path.join(targetDir, "*/sd-*"))
+  ]);
+  const entries = [...rootEntries, ...subEntries];
+  if (entries.length === 0) {
+    logger.warn("\uC0AD\uC81C\uD560 sd-* \uD56D\uBAA9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  for (const entry of entries) {
+    await fsRm(entry);
+    logger.info(`\uC0AD\uC81C: .claude/${path.relative(targetDir, entry)}`);
+  }
+  const settingsPath = path.join(targetDir, "settings.json");
+  if (await fsExists(settingsPath)) {
+    const settings = await fsReadJson(settingsPath);
+    const currentCommand = settings["statusLine"]?.["command"];
+    if (currentCommand === "node .claude/sd-statusline.js") {
+      delete settings["statusLine"];
+      await fsWriteJson(settingsPath, settings, { space: 2 });
+      logger.info("settings.json\uC5D0\uC11C statusLine \uC124\uC815 \uC81C\uAC70");
+    }
+  }
+  logger.info(`${entries.length}\uAC1C\uC758 sd-* \uD56D\uBAA9\uC744 \uC81C\uAC70\uD588\uC2B5\uB2C8\uB2E4.`);
+}
+export {
+  runUninstall
+};
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/uninstall.ts"],
+  "sourcesContent": ["import path from \"path\";\nimport { consola } from \"consola\";\nimport { fsGlob, fsExists, fsRm, fsReadJson, fsWriteJson } from \"@simplysm/core-node\";\n\n//#region Types\n\n/**\n * Uninstall \uBA85\uB839 \uC635\uC158\n */\nexport interface UninstallOptions {}\n\n//#endregion\n\n//#region Main\n\n/**\n * \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uC758 `.claude/`\uC5D0\uC11C sd-* \uC2A4\uD0AC/\uC5D0\uC774\uC804\uD2B8\uB97C \uC81C\uAC70\uD55C\uB2E4.\n */\nexport async function runUninstall(_options: UninstallOptions): Promise<void> {\n  const cwd = process.cwd();\n  const logger = consola.withTag(\"sd:claude:uninstall\");\n\n  const targetDir = path.join(cwd, \".claude\");\n\n  if (!(await fsExists(targetDir))) {\n    logger.warn(\".claude \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.\");\n    return;\n  }\n\n  const [rootEntries, subEntries] = await Promise.all([\n    fsGlob(path.join(targetDir, \"sd-*\")),\n    fsGlob(path.join(targetDir, \"*/sd-*\")),\n  ]);\n  const entries = [...rootEntries, ...subEntries];\n\n  if (entries.length === 0) {\n    logger.warn(\"\uC0AD\uC81C\uD560 sd-* \uD56D\uBAA9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\");\n    return;\n  }\n\n  for (const entry of entries) {\n    await fsRm(entry);\n    logger.info(`\uC0AD\uC81C: .claude/${path.relative(targetDir, entry)}`);\n  }\n\n  // settings.json\uC5D0\uC11C statusLine \uC81C\uAC70\n  const settingsPath = path.join(targetDir, \"settings.json\");\n  if (await fsExists(settingsPath)) {\n    const settings = await fsReadJson<Record<string, unknown>>(settingsPath);\n    const currentCommand = (settings[\"statusLine\"] as Record<string, unknown> | undefined)?.[\"command\"];\n    if (currentCommand === \"node .claude/sd-statusline.js\") {\n      delete settings[\"statusLine\"];\n      await fsWriteJson(settingsPath, settings, { space: 2 });\n      logger.info(\"settings.json\uC5D0\uC11C statusLine \uC124\uC815 \uC81C\uAC70\");\n    }\n  }\n\n  logger.info(`${entries.length}\uAC1C\uC758 sd-* \uD56D\uBAA9\uC744 \uC81C\uAC70\uD588\uC2B5\uB2C8\uB2E4.`);\n}\n\n//#endregion\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB,SAAS,QAAQ,UAAU,MAAM,YAAY,mBAAmB;AAgBhE,eAAsB,aAAa,UAA2C;AAC5E,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,SAAS,QAAQ,QAAQ,qBAAqB;AAEpD,QAAM,YAAY,KAAK,KAAK,KAAK,SAAS;AAE1C,MAAI,CAAE,MAAM,SAAS,SAAS,GAAI;AAChC,WAAO,KAAK,kEAAqB;AACjC;AAAA,EACF;AAEA,QAAM,CAAC,aAAa,UAAU,IAAI,MAAM,QAAQ,IAAI;AAAA,IAClD,OAAO,KAAK,KAAK,WAAW,MAAM,CAAC;AAAA,IACnC,OAAO,KAAK,KAAK,WAAW,QAAQ,CAAC;AAAA,EACvC,CAAC;AACD,QAAM,UAAU,CAAC,GAAG,aAAa,GAAG,UAAU;AAE9C,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,KAAK,sEAAoB;AAChC;AAAA,EACF;AAEA,aAAW,SAAS,SAAS;AAC3B,UAAM,KAAK,KAAK;AAChB,WAAO,KAAK,yBAAe,KAAK,SAAS,WAAW,KAAK,CAAC,EAAE;AAAA,EAC9D;AAGA,QAAM,eAAe,KAAK,KAAK,WAAW,eAAe;AACzD,MAAI,MAAM,SAAS,YAAY,GAAG;AAChC,UAAM,WAAW,MAAM,WAAoC,YAAY;AACvE,UAAM,iBAAkB,SAAS,YAAY,IAA4C,SAAS;AAClG,QAAI,mBAAmB,iCAAiC;AACtD,aAAO,SAAS,YAAY;AAC5B,YAAM,YAAY,cAAc,UAAU,EAAE,OAAO,EAAE,CAAC;AACtD,aAAO,KAAK,gEAAkC;AAAA,IAChD;AAAA,EACF;AAEA,SAAO,KAAK,GAAG,QAAQ,MAAM,4EAAqB;AACpD;",
+  "names": []
+}

package/dist/core-common/src/common.types.d.ts

@@ -0,0 +1,74 @@
+import { DateTime } from "./types/date-time";
+import { DateOnly } from "./types/date-only";
+import { Time } from "./types/time";
+import { Uuid } from "./types/uuid";
+/**
+ * Buffer 대신 사용하는 바이너리 타입
+ */
+export type Bytes = Uint8Array;
+/**
+ * Primitive 타입 매핑
+ * orm-common과 공유
+ */
+export type PrimitiveTypeMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    DateTime: DateTime;
+    DateOnly: DateOnly;
+    Time: Time;
+    Uuid: Uuid;
+    Bytes: Bytes;
+};
+/**
+ * Primitive 타입 문자열 키
+ */
+export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
+/**
+ * Primitive 타입 유니온
+ */
+export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
+/**
+ * 깊은 Partial 타입
+ *
+ * 객체의 모든 속성을 재귀적으로 선택적(optional)으로 만듭니다.
+ * Primitive 타입(string, number, boolean 등)은 그대로 유지하고,
+ * 객체/배열 타입만 재귀적으로 Partial을 적용합니다.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   profile: {
+ *     age: number;
+ *     address: { city: string };
+ *   };
+ * }
+ *
+ * // 모든 깊이의 속성이 선택적이 됨
+ * const partial: DeepPartial<User> = {
+ *   profile: { address: {} }
+ * };
+ * ```
+ */
+export type DeepPartial<T> = Partial<{
+    [K in keyof T]: T[K] extends PrimitiveType ? T[K] : DeepPartial<T[K]>;
+}>;
+/**
+ * 생성자 타입
+ *
+ * 클래스 생성자를 타입으로 표현할 때 사용합니다.
+ * 주로 의존성 주입, 팩토리 패턴, instanceof 체크 등에서 활용됩니다.
+ *
+ * @example
+ * function create<T>(ctor: Type<T>): T {
+ *   return new ctor();
+ * }
+ *
+ * class MyClass { name = "test"; }
+ * const instance = create(MyClass); // MyClass 인스턴스
+ */
+export interface Type<T> extends Function {
+    new (...args: unknown[]): T;
+}
+//# sourceMappingURL=common.types.d.ts.map

package/dist/core-common/src/common.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../../core-common/src/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIpC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAM/B;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,CAAE,SAAQ,QAAQ;IACvC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core-common/src/env.d.ts

@@ -0,0 +1,6 @@
+export declare const env: {
+    DEV: boolean;
+    VER?: string;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core-common/src/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../core-common/src/env.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}

package/dist/core-common/src/errors/argument-error.d.ts

@@ -0,0 +1,25 @@
+import { SdError } from "./sd-error";
+/**
+ * 인수 오류
+ *
+ * 잘못된 인수를 받았을 때 발생시키는 에러이다.
+ * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+ *
+ * @example
+ * // 인수 객체만 전달
+ * throw new ArgumentError({ userId: 123, name: null });
+ * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
+ *
+ * @example
+ * // 커스텀 메시지와 인수 객체 전달
+ * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
+ * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
+ */
+export declare class ArgumentError extends SdError {
+    /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(argObj: Record<string, unknown>);
+    /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(message: string, argObj: Record<string, unknown>);
+    constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
+}
+//# sourceMappingURL=argument-error.d.ts.map

package/dist/core-common/src/errors/argument-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}

package/dist/core-common/src/errors/not-implemented-error.d.ts

@@ -0,0 +1,29 @@
+import { SdError } from "./sd-error";
+/**
+ * 미구현 오류
+ *
+ * 아직 구현되지 않은 기능을 호출했을 때 발생시키는 에러이다.
+ * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용한다.
+ *
+ * @example
+ * // 추상 메서드 구현 전
+ * class BaseService {
+ *   process(): void {
+ *     throw new NotImplementedError("서브클래스에서 구현 필요");
+ *   }
+ * }
+ *
+ * @example
+ * // 향후 구현 예정 분기
+ * switch (type) {
+ *   case "A": return handleA();
+ *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
+ * }
+ */
+export declare class NotImplementedError extends SdError {
+    /**
+     * @param message 추가 설명 메시지
+     */
+    constructor(message?: string);
+}
+//# sourceMappingURL=not-implemented-error.d.ts.map

package/dist/core-common/src/errors/not-implemented-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/not-implemented-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC9C;;OAEG;gBACS,OAAO,CAAC,EAAE,MAAM;CAI7B"}

package/dist/core-common/src/errors/sd-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 오류의 Tree 구조 구성이 가능한 오류 클래스
+ * ES2024 cause 속성 활용
+ *
+ * @example
+ * // 원인 에러를 감싸서 생성
+ * try {
+ *   await fetch(url);
+ * } catch (err) {
+ *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+ * }
+ * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+ *
+ * @example
+ * // 메시지만으로 생성
+ * throw new SdError("잘못된 상태", "처리 불가");
+ * // 결과 메시지: "처리 불가 => 잘못된 상태"
+ */
+export declare class SdError extends Error {
+    cause?: Error;
+    /** 원인 에러를 감싸서 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
+    constructor(cause: Error, ...messages: string[]);
+    /** 메시지만으로 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지) */
+    constructor(...messages: string[]);
+    constructor(arg1?: unknown, ...messages: string[]);
+}
+//# sourceMappingURL=sd-error.d.ts.map

package/dist/core-common/src/errors/sd-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,kDAAkD;gBACtC,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CA2BlD"}

package/dist/core-common/src/errors/timeout-error.d.ts

@@ -0,0 +1,31 @@
+import { SdError } from "./sd-error";
+/**
+ * 타임아웃 오류
+ *
+ * 대기 시간이 초과되었을 때 발생하는 에러이다.
+ * Wait.until() 등의 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
+ *
+ * @example
+ * // Wait.until에서 자동 발생
+ * try {
+ *   await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.log("시간 초과");
+ *   }
+ * }
+ *
+ * @example
+ * // 직접 발생
+ * if (elapsed > maxTime) {
+ *   throw new TimeoutError(undefined, "API 응답 대기 초과");
+ * }
+ */
+export declare class TimeoutError extends SdError {
+    /**
+     * @param count 시도 횟수
+     * @param message 추가 메시지
+     */
+    constructor(count?: number, message?: string);
+}
+//# sourceMappingURL=timeout-error.d.ts.map

package/dist/core-common/src/errors/timeout-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/timeout-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM7C"}

package/dist/core-common/src/extensions/arr-ext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Array 확장 메서드
+ *
+ * @remarks 각 메서드의 TSDoc은 타입 정의 파일(arr-ext.types.ts) 참조
+ */
+import "./map-ext";
+import type { ReadonlyArrayExt, MutableArrayExt } from "./arr-ext.types";
+declare global {
+    interface ReadonlyArray<T> extends ReadonlyArrayExt<T> {
+    }
+    interface Array<T> extends ReadonlyArrayExt<T>, MutableArrayExt<T> {
+    }
+}
+export type { ArrayDiffsResult, ArrayDiffs2Result, TreeArray, ComparableType } from "./arr-ext.types";
+//# sourceMappingURL=arr-ext.d.ts.map

package/dist/core-common/src/extensions/arr-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,CAAC;AAUnB,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AA2uBzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;KAAG;IACzD,UAAU,KAAK,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;KAAG;CACtE;AAID,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Array 확장 헬퍼 함수
+ */
+import type { ComparableType } from "./arr-ext.types";
+/**
+ * DateTime, DateOnly, Time을 비교 가능한 primitive 값으로 변환
+ */
+export declare function toComparable(value: ComparableType): string | number | boolean | undefined;
+/**
+ * 정렬을 위한 비교 함수
+ *
+ * @param pp 비교 대상 1
+ * @param pn 비교 대상 2
+ * @param desc true: 내림차순, false: 오름차순
+ * @returns 음수: pp가 앞, 0: 같음, 양수: pn이 앞
+ * @note null/undefined 값은 오름차순 시 앞으로, 내림차순 시 뒤로 정렬됨
+ */
+export declare function compareForOrder(pp: ComparableType, pn: ComparableType, desc: boolean): number;
+//# sourceMappingURL=arr-ext.helpers.d.ts.map

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.helpers.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuB7F"}