@simplysm/sd-claude 13.0.70 → 13.0.72

package/claude/refs/sd-library-issue.md

@@ -0,0 +1,7 @@
+# Simplysm Library Issue Reporting
+
+Source code for `@simplysm/*` packages can be found in `node_modules/@simplysm/`. If debugging reveals the root cause is in the simplysm library itself, generate a GitHub issue-formatted text (title, reproduction steps, expected behavior, actual behavior) and display it to the user.
+
+**Report facts only — do not suggest fixes or include code location hints. Do not auto-submit the issue — only display the text.**
+
+The issue body must NEVER include internal analysis of library code (class names, variable names, style properties, inheritance chains, etc.). Only describe user-observable symptoms.

package/claude/rules/sd-claude-rules.md

@@ -21,9 +21,9 @@ If a referenced file or document cannot be found, **stop immediately and ask the
 
 ### Questions vs. Code Requests — CRITICAL
 
-- **If the user asks a question** (e.g., "이건 왜 이래?", "이거 뭐야?", "어떻게 동작해?") → **answer with text only**. Do NOT edit, write, or create any files.
+- **If the user asks a question** (e.g., "Why is this like this?", "What is this?", "How does this work?") → **answer with text only**. Do NOT edit, write, or create any files.
 - **If the user discusses, explains, or shares opinions** → **respond with text only**. Do NOT touch any files.
-- **Only edit/write/create files when the user explicitly requests code changes** (e.g., "수정해줘", "만들어줘", "변경해줘", "추가해줘", "고쳐줘").
+- **Only edit/write/create files when the user explicitly requests code changes** (e.g., "Fix this", "Create this", "Change this", "Add this").
 - Reading files to answer a question is fine. **Modifying files to answer a question is prohibited.**
 
 ### General Rules

package/claude/rules/sd-refs-linker.md

@@ -19,6 +19,7 @@ Determine the major version by the `version` field in `package.json`.
 | Debugging, problem-solving, or planning approach | `.claude/refs/sd-workflow.md`         |
 | Using `@simplysm/service-*` packages            | `.claude/refs/sd-service.md`          |
 | Migrating/porting code from another codebase     | `.claude/refs/sd-migration.md`        |
+| Debugging in a project that uses `@simplysm/*` as an external dependency (not the simplysm monorepo itself) | `.claude/refs/sd-library-issue.md` |
 
 ## v12 only (< 13)
 

package/claude/sd-statusline.js

@@ -241,7 +241,7 @@ async function main() {
   const cwd = input.cwd ?? process.cwd();
   const folderName = path.basename(cwd);
 
-  // 출력
+  // Output
   const dailyStr = dailyResetTime ? `${dailyPercent}%(${dailyResetTime})` : `${dailyPercent}%`;
   const weekStr = weekResetDay ? `${weekPercent}%(${weekResetDay})` : `${weekPercent}%`;
   const parts = [folderName, modelName, `${contextPercent}%`, dailyStr, weekStr];

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

@@ -1,7 +1,6 @@
 ---
 name: sd-check
 description: "Typecheck, lint, test verification (explicit invocation only)"
-model: sonnet
 allowed-tools: Bash(npm run check), Bash(npm run typecheck), Bash(npm run lint --fix), Bash(npm run vitest)
 ---
 

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

@@ -50,7 +50,7 @@ type(scope): short description
 | ------------- | ---------------------------------------------------------------------------- |
 | `type`        | `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `build`, `style`, `perf` |
 | `scope`       | package name or area (e.g., `solid`, `core-common`, `orm-node`)              |
-| `description` | imperative, lowercase, no period at end                                      |
+| `description` | written in the system's configured language, imperative, lowercase, no period at end |
 
 Examples:
 

package/claude/skills/sd-document/extract_docx.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""DOCX 파일에서 텍스트와 이미지를 문단 흐름 순서로 추출한다."""
+"""Extract text and images from DOCX files in paragraph flow order."""
 
 import sys
 import io
@@ -17,7 +17,7 @@ def ensure_packages():
         try:
             __import__(import_name)
         except ImportError:
-            print(f"패키지 설치 중: {pip_name}...", file=sys.stderr)
+            print(f"Installing package: {pip_name}...", file=sys.stderr)
             subprocess.check_call([sys.executable, "-m", "pip", "install", pip_name],
                                   stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
 
@@ -71,7 +71,7 @@ def extract(file_path):
         elif not has_image and not text:
             continue
 
-    # 표 추출
+    # Table extraction
     for t_idx, table in enumerate(doc.tables):
         print(f"\n### Table {t_idx + 1}\n")
         for row in table.rows:
@@ -79,9 +79,9 @@ def extract(file_path):
             print("| " + " | ".join(cells) + " |")
 
     if img_idx > 0:
-        print(f"\n---\n이미지 {img_idx}개 저장: {out_dir}")
+        print(f"\n---\n{img_idx} image(s) saved: {out_dir}")
     else:
-        print("\n---\n이미지 없음")
+        print("\n---\nNo images")
 
 
 if __name__ == "__main__":

package/claude/skills/sd-document/extract_pdf.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""PDF 파일에서 텍스트, 표, 이미지를 페이지별로 추출한다."""
+"""Extract text, tables, and images from PDF files page by page."""
 
 import sys
 import io
@@ -16,7 +16,7 @@ def ensure_packages():
         try:
             __import__(import_name)
         except ImportError:
-            print(f"패키지 설치 중: {pip_name}...", file=sys.stderr)
+            print(f"Installing package: {pip_name}...", file=sys.stderr)
             subprocess.check_call([sys.executable, "-m", "pip", "install", pip_name],
                                   stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
 
@@ -32,7 +32,7 @@ def extract(file_path):
 
     print(f"# {Path(file_path).name}\n")
 
-    # 텍스트 + 표 추출 (pdfplumber)
+    # Text + table extraction (pdfplumber)
     with pdfplumber.open(file_path) as pdf:
         for page_num, page in enumerate(pdf.pages, 1):
             print(f"## Page {page_num}\n")
@@ -52,7 +52,7 @@ def extract(file_path):
                         print("| " + " | ".join(cells) + " |")
                     print()
 
-    # 이미지 추출 (pypdf)
+    # Image extraction (pypdf)
     reader = PdfReader(file_path)
     for page_num, page in enumerate(reader.pages, 1):
         if "/XObject" not in (page.get("/Resources") or {}):
@@ -79,19 +79,19 @@ def extract(file_path):
                     img_path.write_bytes(obj._data if hasattr(obj, "_data") else b"")
                 print(f"[IMG] (page={page_num}) {img_path}")
 
-    # OCR 안내
+    # OCR notice
     if total_text_len == 0:
-        print("\n⚠ 텍스트가 추출되지 않았습니다 (스캔 PDF일 수 있음).")
-        print("OCR이 필요합니다:")
-        print("  1. Tesseract OCR 설치: https://github.com/tesseract-ocr/tesseract")
+        print("\n⚠ No text was extracted (may be a scanned PDF).")
+        print("OCR is required:")
+        print("  1. Install Tesseract OCR: https://github.com/tesseract-ocr/tesseract")
         print("  2. pip install pytesseract pdf2image")
-        print("  3. pytesseract.image_to_string() 으로 추출")
+        print("  3. Extract with pytesseract.image_to_string()")
 
     print()
     if img_idx > 0:
-        print(f"---\n이미지 {img_idx}개 저장: {out_dir}")
+        print(f"---\n{img_idx} image(s) saved: {out_dir}")
     else:
-        print("---\n이미지 없음")
+        print("---\nNo images")
 
 
 if __name__ == "__main__":

package/claude/skills/sd-document/extract_pptx.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""PPTX 파일에서 텍스트와 이미지를 슬라이드별 좌표와 함께 추출한다."""
+"""Extract text and images from PPTX files with per-slide coordinates."""
 
 import sys
 import io
@@ -16,13 +16,13 @@ def ensure_packages():
         try:
             __import__(import_name)
         except ImportError:
-            print(f"패키지 설치 중: {pip_name}...", file=sys.stderr)
+            print(f"Installing package: {pip_name}...", file=sys.stderr)
             subprocess.check_call([sys.executable, "-m", "pip", "install", pip_name],
                                   stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
 
 
 def emu_to_inches(emu):
-    """EMU를 인치로 변환 (소수점 1자리)."""
+    """Convert EMU to inches (1 decimal place)."""
     if emu is None:
         return "?"
     return f"{emu / 914400:.1f}"
@@ -64,9 +64,9 @@ def extract(file_path):
         print()
 
     if img_idx > 0:
-        print(f"---\n이미지 {img_idx}개 저장: {out_dir}")
+        print(f"---\n{img_idx} image(s) saved: {out_dir}")
     else:
-        print("---\n이미지 없음")
+        print("---\nNo images")
 
 
 if __name__ == "__main__":

package/claude/skills/sd-document/extract_xlsx.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""XLSX 파일에서 데이터와 이미지를 셀 위치와 함께 추출한다."""
+"""Extract data and images from XLSX files with cell positions."""
 
 import sys
 import io
@@ -17,7 +17,7 @@ def ensure_packages():
         try:
             __import__(import_name)
         except ImportError:
-            print(f"패키지 설치 중: {pip_name}...", file=sys.stderr)
+            print(f"Installing package: {pip_name}...", file=sys.stderr)
             subprocess.check_call([sys.executable, "-m", "pip", "install", pip_name],
                                   stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
 
@@ -37,10 +37,10 @@ def extract(file_path):
         ws = wb[sheet_name]
         print(f"## Sheet: {sheet_name}\n")
 
-        # 데이터 추출
+        # Data extraction
         rows = list(ws.iter_rows(values_only=False))
         if not rows:
-            print("(빈 시트)\n")
+            print("(empty sheet)\n")
             continue
 
         for row in rows:
@@ -53,7 +53,7 @@ def extract(file_path):
                     cells.append(str(val).strip())
             print(f"[{row[0].coordinate.split('1')[0]}{row[0].row}] " + " | ".join(cells))
 
-        # 이미지 추출
+        # Image extraction
         if ws._images:
             for img in ws._images:
                 img_idx += 1
@@ -70,9 +70,9 @@ def extract(file_path):
         print()
 
     if img_idx > 0:
-        print(f"---\n이미지 {img_idx}개 저장: {out_dir}")
+        print(f"---\n{img_idx} image(s) saved: {out_dir}")
     else:
-        print("---\n이미지 없음")
+        print("---\nNo images")
 
 
 if __name__ == "__main__":

package/claude/skills/sd-email-analyze/email-analyzer.py

@@ -12,13 +12,13 @@ import base64
 from email.policy import default as default_policy
 from pathlib import Path
 
-# stdout UTF-8 강제 (Windows 호환)
+# Force stdout UTF-8 (Windows compatibility)
 sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
 sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
 
 
 def ensure_packages():
-    """필요한 패키지 자동 설치."""
+    """Auto-install required packages."""
     packages = {"extract-msg": "extract_msg"}
     missing = []
     for pip_name, import_name in packages.items():
@@ -27,7 +27,7 @@ def ensure_packages():
         except ImportError:
             missing.append(pip_name)
     if missing:
-        print(f"패키지 설치 중: {', '.join(missing)}...", file=sys.stderr)
+        print(f"Installing packages: {', '.join(missing)}...", file=sys.stderr)
         subprocess.check_call(
             [sys.executable, "-m", "pip", "install", "-q", *missing],
             stdout=subprocess.DEVNULL,
@@ -326,45 +326,45 @@ def build_report(filepath):
         saved_attachments = save_files(attachments, out_dir)
 
     out = []
-    out.append("# 이메일 분석서\n")
-    out.append(f"**원본 파일**: `{os.path.basename(filepath)}`\n")
-
-    # ── 메일 정보
-    out.append("## 메일 정보\n")
-    out.append("| 항목 | 내용 |")
-    out.append("|------|------|")
-    out.append(f"| **제목** | {headers['subject']} |")
-    out.append(f"| **보낸 사람** | {headers['from']} |")
-    out.append(f"| **받는 사람** | {headers['to']} |")
+    out.append("# Email Analysis Report\n")
+    out.append(f"**Source file**: `{os.path.basename(filepath)}`\n")
+
+    # ── Email info
+    out.append("## Email Info\n")
+    out.append("| Field | Value |")
+    out.append("|-------|-------|")
+    out.append(f"| **Subject** | {headers['subject']} |")
+    out.append(f"| **From** | {headers['from']} |")
+    out.append(f"| **To** | {headers['to']} |")
     if headers["cc"]:
-        out.append(f"| **참조** | {headers['cc']} |")
-    out.append(f"| **날짜** | {headers['date']} |")
-    out.append(f"| **첨부파일** | {len(saved_attachments)}개 |")
+        out.append(f"| **CC** | {headers['cc']} |")
+    out.append(f"| **Date** | {headers['date']} |")
+    out.append(f"| **Attachments** | {len(saved_attachments)} |")
     if all_inline:
-        out.append(f"| **본문 이미지** | {len(all_inline)}개 |")
+        out.append(f"| **Inline images** | {len(all_inline)} |")
     out.append("")
 
-    # ── 본문
-    out.append("## 본문 내용\n")
+    # ── Body
+    out.append("## Body\n")
     body = body_plain
     if not body and body_html:
         body = strip_html(body_html)
-    out.append(body.strip() if body else "_(본문 없음)_")
+    out.append(body.strip() if body else "_(No body)_")
     out.append("")
 
-    # ── 본문 삽입 이미지
+    # ── Inline images
     if all_inline:
-        out.append("## 본문 삽입 이미지\n")
-        out.append("| # | 파일명 | 크기 | 저장 경로 |")
+        out.append("## Inline Images\n")
+        out.append("| # | Filename | Size | Saved path |")
         out.append("|---|--------|------|-----------|")
         for i, img in enumerate(all_inline, 1):
             out.append(f"| {i} | {img['filename']} | {fmt_size(img['size'])} | `{img['saved_path']}` |")
         out.append("")
 
-    # ── 첨부파일
+    # ── Attachments
     if saved_attachments:
-        out.append("## 첨부파일\n")
-        out.append("| # | 파일명 | 크기 | 저장 경로 |")
+        out.append("## Attachments\n")
+        out.append("| # | Filename | Size | Saved path |")
         out.append("|---|--------|------|-----------|")
         for i, a in enumerate(saved_attachments, 1):
             out.append(f"| {i} | {a['filename']} | {fmt_size(a['size'])} | `{a['saved_path']}` |")
@@ -382,12 +382,12 @@ if __name__ == "__main__":
 
     path = sys.argv[1]
     if not os.path.isfile(path):
-        print(f"파일을 찾을 수 없습니다: {path}", file=sys.stderr)
+        print(f"File not found: {path}", file=sys.stderr)
         sys.exit(1)
 
     ext = Path(path).suffix.lower()
     if ext not in (".eml", ".msg"):
-        print(f"지원하지 않는 형식: {ext} (.eml 또는 .msg만 지원)", file=sys.stderr)
+        print(f"Unsupported format: {ext} (only .eml and .msg are supported)", file=sys.stderr)
         sys.exit(1)
 
     print(build_report(path))

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

@@ -6,6 +6,51 @@ model: haiku
 
 # sd-worktree
 
+## CRITICAL SAFETY RULES — MERGE & STASH
+
+**These rules are ABSOLUTE. No exceptions. Applies to ALL modes (yolo, normal, plan, etc.).**
+
+1. **NEVER run `git stash drop`, `git stash pop`, or `git stash clear`.**
+   - If you stashed something, ONLY use `git stash apply` (which keeps the stash intact).
+   - If stash is no longer needed, ASK the user before dropping it.
+
+2. **If `merge` fails or produces conflicts → STOP IMMEDIATELY and show this message:**
+   ```
+   ⚠️ A problem occurred during merge.
+   Please proceed with the merge manually.
+   (Error details: <print error/conflict info as-is>)
+   ```
+   - Show this message in the system's configured language.
+   - Do NOT attempt to resolve conflicts yourself.
+   - Do NOT run `git merge --abort` without asking.
+   - Do NOT proceed to `clean` after a failed merge.
+   - Do NOT retry or work around the error.
+   - Just show the message above and STOP. Do nothing else.
+
+3. **If `rebase` fails or produces conflicts → STOP IMMEDIATELY and show this message:**
+   ```
+   ⚠️ A problem occurred during rebase.
+   Please proceed with the rebase manually.
+   (Error details: <print error/conflict info as-is>)
+   ```
+   - Show this message in the system's configured language.
+   - Same rules as merge. Do NOT auto-resolve. Just show the message and STOP.
+
+4. **NEVER run destructive git commands during worktree workflows:**
+   - `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -f`
+   - `git branch -D` (force delete) — only `-d` (safe delete) is allowed
+   - `git stash drop`, `git stash pop`, `git stash clear`
+
+5. **Before ANY merge/rebase, verify:**
+   - Both main and worktree have NO uncommitted changes (`git status --porcelain`)
+   - If uncommitted changes exist → ask the user (do NOT auto-stash)
+
+6. **After merge completes, verify success before proceeding:**
+   - Check `git status` — if merge conflicts exist, STOP and report
+   - Do NOT proceed to `clean` until merge is confirmed successful
+
+**Violation of these rules causes IRREVERSIBLE DATA LOSS.**
+
 ## Overview
 
 Create, merge, and clean up git worktrees under `.worktrees/`. Uses the current branch of the main working tree as the source branch.
@@ -44,6 +89,7 @@ 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
+- **If rebase fails or conflicts → STOP. Report to user. Do NOT auto-resolve.**
 
 ### merge — Merge into main branch
 
@@ -56,6 +102,13 @@ node .claude/skills/sd-worktree/sd-worktree.mjs merge [name]
 - Errors if uncommitted changes exist → commit or stash first
 - After merge, always `cd <project-root>` (required for subsequent clean)
 
+**MERGE SAFETY PROTOCOL:**
+1. Before merge: check BOTH main and worktree for uncommitted changes
+2. If the script exits with non-zero → show "Please proceed with the merge manually." message (in system language) and STOP.
+3. After merge: run `git status` in main to confirm no conflicts
+4. If conflicts or errors → show "Please proceed with the merge manually." message (in system language) and STOP.
+5. Only proceed to `clean` after confirming merge was fully successful
+
 ### clean — Remove worktree and delete branch
 
 ```bash

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

@@ -13,7 +13,7 @@ function getOutput(command) {
   return execSync(command, { encoding: "utf-8" }).trim();
 }
 
-// 메인 working tree 경로 (worktree 안에서 실행해도 정확)
+// Main working tree path (accurate even when run inside a worktree)
 const mainWorktree = getOutput("git worktree list --porcelain")
   .split("\n")[0]
   .replace("worktree ", "");
@@ -71,7 +71,7 @@ switch (cmd) {
       console.error("Usage: sd-worktree.mjs merge [name]  (or run inside .worktrees/<name>)");
       process.exit(1);
     }
-    // uncommitted 변경 확인
+    // Check for uncommitted changes
     const worktreePath_m = resolve(mainWorktree, ".worktrees", name);
     if (existsSync(worktreePath_m)) {
       const status = getOutput(`git -C "${worktreePath_m}" status --porcelain`);
@@ -99,7 +99,7 @@ switch (cmd) {
       console.error(`Error: worktree '${name}' does not exist.`);
       process.exit(1);
     }
-    // uncommitted 변경 확인
+    // Check for uncommitted changes
     const statusR = getOutput(`git -C "${worktreePath_r}" status --porcelain`);
     if (statusR) {
       console.error(`Error: worktree '${name}' has uncommitted changes:\n${statusR}`);
@@ -119,7 +119,7 @@ switch (cmd) {
       console.error("Usage: sd-worktree.mjs clean [name]  (or run inside .worktrees/<name>)");
       process.exit(1);
     }
-    // worktree 안에서 실행 시 차단
+    // Block execution from inside the worktree
     const worktreePath = resolve(mainWorktree, ".worktrees", name);
     const cwd = process.cwd();
     if (cwd === worktreePath || cwd.startsWith(worktreePath + "/")) {
@@ -134,7 +134,7 @@ switch (cmd) {
       try {
         run(`git worktree remove --force "${worktreePath}"`, { cwd: mainWorktree });
       } catch {
-        // node_modules 등으로 git worktree remove 실패 시 수동 정리
+        // Manual cleanup when git worktree remove fails (e.g., due to node_modules)
         console.log("git worktree remove failed, cleaning up manually...");
         rmSync(worktreePath, { recursive: true, force: true });
         run("git worktree prune", { cwd: mainWorktree });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "13.0.70",
+  "version": "13.0.72",
   "description": "Simplysm Claude Code CLI — asset installer",
   "author": "simplysm",
   "license": "Apache-2.0",