@simplysm/sd-claude 14.0.40 → 14.0.42

package/claude/references/sd-simplysm14/angular/docs/providers.md

@@ -287,7 +287,8 @@ class SdToastProvider {
   danger(message: string, useProgress?: false): void;
 
   notify<T extends SdToastContentDef<any>>(input: SdToastInput<T>): Promise<...>;
-  async try<R>(fn: () => Promise<R>, messageFn?: (err: unknown) => string): Promise<R | undefined>;
+  async try<R>(fn: () => Promise<R>, messageFn?: (err: Error) => string): Promise<R | undefined>;
+  try<R>(fn: () => R, messageFn?: (err: Error) => string): R | undefined;
 }
 ```
 

package/claude/references/sd-simplysm14/angular/usage.md

@@ -338,6 +338,19 @@ export class SomePage implements OnInit {
 - constructor 내 `void this._init()` 같은 수동 호출 패턴 **금지** — ngOnInit이 이미 같은 역할
 - `resource()` / `httpResource()`는 데이터 로딩 → signal 매핑 용도. 사이드이펙트(라우팅, toast 등) 포함 초기화에는 사용하지 않는다
 
+## inject 네이밍 컨벤션
+
+`Sd*Provider`를 `inject()`할 때 변수명은 다음 규칙을 따른다:
+
+- **Sd 접두어 유지**: 클래스명에서 `Sd`를 camelCase로 변환하여 유지한다
+- **Provider 접미어 제거**: 변수명에서 `Provider`를 제거한다
+
+| inject 대상 | 클래스 필드 | 로컬 변수 |
+|-------------|-----------|----------|
+| `SdToastProvider` | `private _sdToast = inject(SdToastProvider)` | `const sdToast = inject(SdToastProvider)` |
+| `SdModalProvider` | `private _sdModal = inject(SdModalProvider)` | `const sdModal = inject(SdModalProvider)` |
+| `SdServiceClientFactoryProvider` | `private _sdServiceClientFactory = inject(SdServiceClientFactoryProvider)` | `const sdServiceClientFactory = inject(...)` |
+
 ## Usage Examples
 
 ### 앱 부트스트랩

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

@@ -46,6 +46,7 @@
 - `@angular/*` 패키지를 사용할 때 `angular-cli` mcp를 활용하여, 표준 사용법을 확인하여 따른다.
 - 테스트 작성 시 `.claude/references/sd-testing.md`를 읽고 따른다.
 - 프론트엔드 UI 코드 작성·수정 시 `.claude/references/sd-frontend-design.md`를 읽고 따른다.
+- 디버깅 시 `.claude/references/sd-debug.md`를 읽고 따른다.
 - 코딩을 하거나 코드예제를 출력할때는, 반드시 코드베이스의 기존 패턴을 확인하여 통일성있게 안내한다.
 - 코드를 수정할 경우 수정에 의한 사이드이펙트를 항상 고려한다. (예, html구조가 바뀌면 css의 selector도 바뀌어야함)
 - 함수 작성 혹은 함수내 기능 추가시 단일 책임 원칙을 따른다. (함수가 이름에서 드러나지 않는 일을 몰래 해선 안됨)

package/claude/rules/sd-simplysm14.md

@@ -0,0 +1,35 @@
+# sd-simplysm14: @simplysm v14 소비앱 가이드
+
+소비앱이 `@simplysm/*` v14를 사용할 때 적용되는 규칙.
+
+## 중간 패키지(common) 불필요
+
+v14에서는 `import type`으로 타입을 직접 가져올 수 있으므로, 이전 버전에서 클라이언트-서버 간 타입 공유를 위해 필요하던 중간 패키지(예: `service-common`, `orm-common`)가 소비앱의 의존성으로 불필요하다.
+
+```typescript
+// v14: 서버 패키지에서 타입을 직접 import — common 패키지 의존성 불필요
+import type { ServiceMethods } from "@simplysm/service-server";
+```
+
+## 패키지별 상세 문서
+
+| 패키지                                 | 문서                                                                          |
+| -------------------------------------- | ----------------------------------------------------------------------------- |
+| @simplysm/angular                      | [usage.md](../references/sd-simplysm14/angular/usage.md)                      |
+| @simplysm/capacitor-plugin-auto-update | [usage.md](../references/sd-simplysm14/capacitor-plugin-auto-update/usage.md) |
+| @simplysm/capacitor-plugin-file-system | [usage.md](../references/sd-simplysm14/capacitor-plugin-file-system/usage.md) |
+| @simplysm/capacitor-plugin-intent      | [usage.md](../references/sd-simplysm14/capacitor-plugin-intent/usage.md)      |
+| @simplysm/capacitor-plugin-usb-storage | [usage.md](../references/sd-simplysm14/capacitor-plugin-usb-storage/usage.md) |
+| @simplysm/core-browser                 | [usage.md](../references/sd-simplysm14/core-browser/usage.md)                 |
+| @simplysm/core-common                  | [usage.md](../references/sd-simplysm14/core-common/usage.md)                  |
+| @simplysm/core-node                    | [usage.md](../references/sd-simplysm14/core-node/usage.md)                    |
+| @simplysm/excel                        | [usage.md](../references/sd-simplysm14/excel/usage.md)                        |
+| @simplysm/lint                         | [usage.md](../references/sd-simplysm14/lint/usage.md)                         |
+| @simplysm/orm-common                   | [usage.md](../references/sd-simplysm14/orm-common/usage.md)                   |
+| @simplysm/orm-node                     | [usage.md](../references/sd-simplysm14/orm-node/usage.md)                     |
+| @simplysm/sd-claude                    | [usage.md](../references/sd-simplysm14/sd-claude/usage.md)                    |
+| @simplysm/sd-cli                       | [usage.md](../references/sd-simplysm14/sd-cli/usage.md)                       |
+| @simplysm/service-client               | [usage.md](../references/sd-simplysm14/service-client/usage.md)               |
+| @simplysm/service-common               | [usage.md](../references/sd-simplysm14/service-common/usage.md)               |
+| @simplysm/service-server               | [usage.md](../references/sd-simplysm14/service-server/usage.md)               |
+| @simplysm/storage                      | [usage.md](../references/sd-simplysm14/storage/usage.md)                      |

package/claude/sd-check-forbidden-files.py

@@ -0,0 +1,14 @@
+import json, sys, os
+
+data = json.load(sys.stdin)
+file_path = data["tool_input"]["file_path"].replace("\\", "/")
+root = os.getcwd().replace("\\", "/")
+
+BLOCKED_FILES = [
+    f"{root}/tsconfig.json",
+    f"{root}/eslint.config.ts",
+]
+
+if file_path in BLOCKED_FILES:
+    print(f"Blocked: forbidden file - {file_path}", file=sys.stderr)
+    sys.exit(2)

package/claude/settings.json

@@ -0,0 +1,58 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/sd-session-start.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python .claude/sd-check-forbidden-files.py"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python .claude/sd-check-write.py"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python .claude/sd-check-bash.py"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/sd-session-start.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "python .claude/sd-statusline.py"
+  }
+}

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

@@ -67,7 +67,7 @@ description: 프로젝트 분석을 통해 CLAUDE.md와 LLM용 usage 문서를
 1. 루트 `package.json`의 `name`에서 라이브러리명을 추출한다
 2. 루트 `package.json`의 `version`에서 메이저 버전을 추출한다
 3. usage 문서 경로: `.claude/references/sd-{name}{majorVersion}/` (예: `sd-simplysm14/`)
-4. 인덱스 파일 경로: `.claude/references/sd-{name}{majorVersion}.md` (예: `sd-simplysm14.md`)
+4. 인덱스 파일 경로: `.claude/rules/sd-{name}{majorVersion}.md` (예: `sd-simplysm14.md`)
 
 ## Step 2: 분기
 
@@ -194,7 +194,7 @@ UI:       angular (Angular)
 
 ### sd-{name}{ver}.md (라이브러리 프로젝트만)
 
-라이브러리 프로젝트인 경우 `.claude/references/sd-{name}{ver}.md` 인덱스 파일을 생성/갱신한다.
+라이브러리 프로젝트인 경우 `.claude/rules/sd-{name}{ver}.md` 인덱스 파일을 생성/갱신한다.
 소비앱인 경우 이 단계를 건너뛴다.
 
 #### 포함할 내용

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

@@ -77,7 +77,7 @@ Feature는 독립적으로 설계·개발·검증할 수 있는 최소 기능
 
 ### Feature 작성 규칙
 
-- **의존성**: 선행 Feature를 명시한다. 없으면 "없음".
+- **의존성**: 이 Feature의 범위(세부 기능)를 하나씩 검토하여, 해당 기능을 구현하려면 다른 어떤 Feature가 먼저 완료돼야 하는지 판단한다. 선행 Feature가 있으면 명시하고, 없으면 "없음". (의존성에 따라 병렬 진행할 수 있으므로 중요)
 - **범위**: 해당 Feature의 세부 기능을 사용자 기능(user-facing function) 수준으로 **MUST 빠짐없이** 나열한다. (절대 누락되어선 안된다. 누락된것은 다음단계에서 제외사항으로 판단될 수 있다.)
 - **경계**: 이 Feature가 **하지 않는 것** 중 다른 Feature에서 다루거나 다룰 수 있는 것을 명시한다. 인접 Feature와의 경계가 모호한 경우 특히 중요하다. (프로젝트 전체에서 제외되는 항목은 문서 하단의 "제외 사항"에 기재한다.)
 - **근거**: 범위가 도출된 근거 혹은 출처를 명시한다. (요구사항, 사용자 답변, 첨부문서 등) 개발에 필요한 참조 파일/자료 경로가 있으면 확인 목적과 함께 기록한다.
@@ -158,7 +158,27 @@ Feature는 독립적으로 설계·개발·검증할 수 있는 최소 기능
 
 **CRITIAL: 각 Feature는 새 세션에서 진행되므로, 절대(NEVER) wbs문서에 누락이 있어서는 안됨**
 
-## Step 6: 다음 단계 안내
+## Step 6: 의존성 요약 테이블 출력
+
+문서 작성이 완료되면, 전체 Feature의 의존성 관계를 한눈에 볼 수 있도록 테이블을 출력한다.
+
+예시:
+
+```
+┌─────┬─────────────────────────────┬────────┐
+│  #  │           Feature           │ 의존성 │
+├─────┼─────────────────────────────┼────────┤
+│ 1.1 │ 공통 프로바이더 & 플러그인  │ 없음   │
+├─────┼─────────────────────────────┼────────┤
+│ 1.2 │ 홈 레이아웃 & 사이드바 메뉴 │ 1.1    │
+├─────┼─────────────────────────────┼────────┤
+│ 2.1 │ 입고 처리                   │ 1.1    │
+├─────┼─────────────────────────────┼────────┤
+│ 2.2 │ 출고 처리                   │ 1.1    │
+└─────┴─────────────────────────────┴────────┘
+```
+
+## Step 7: 다음 단계 안내
 
 WBS 완료 후, 개발을 위한 다음 단계를 안내한다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "14.0.40",
+  "version": "14.0.42",
   "description": "심플리즘 패키지 - Claude Code 셋업",
   "author": "심플리즘",
   "license": "Apache-2.0",

package/scripts/postinstall.mjs

@@ -31,6 +31,10 @@ try {
   }
 
   const sourceEntries = collectSdEntries(sourceDir);
+  // settings.json도 함께 복사
+  if (fs.existsSync(path.join(sourceDir, "settings.json"))) {
+    sourceEntries.push("settings.json");
+  }
   if (sourceEntries.length === 0) {
     process.exit(0);
   }
@@ -39,9 +43,8 @@ try {
 
   cleanSdEntries(targetDir);
   copySdEntries(sourceDir, targetDir, sourceEntries);
-  setupSettings(targetDir);
 
-  console.log(`[@simplysm/sd-claude] Installed ${sourceEntries.length} sd-* entries.`);
+  console.log(`[@simplysm/sd-claude] Installed ${sourceEntries.length} entries.`);
 } catch (err) {
   // Ignore errors to prevent postinstall failure from blocking the entire pnpm install
   console.warn("[@simplysm/sd-claude] postinstall warning:", err.message);
@@ -101,109 +104,3 @@ function copySdEntries(sourceDir, targetDir, entries) {
   }
 }
 
-/** Ensures statusLine and SessionStart hooks are configured in settings.json. */
-function setupSettings(targetDir) {
-  const settingsPath = path.join(targetDir, "settings.json");
-
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
-    settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-  }
-
-  // Migrate: move root-level SessionStart to hooks.SessionStart
-  if (settings["SessionStart"] != null) {
-    settings["hooks"] = settings["hooks"] ?? {};
-    settings["hooks"]["SessionStart"] = [
-      ...(settings["hooks"]["SessionStart"] ?? []),
-      ...settings["SessionStart"],
-    ];
-    delete settings["SessionStart"];
-  }
-
-  // SessionStart: ensure sd-session-start hook exists with correct config
-  settings["hooks"] = settings["hooks"] ?? {};
-  const sdSessionEntry = {
-    matcher: "startup|resume|clear|compact",
-    hooks: [{ type: "command", command: "bash .claude/sd-session-start.sh" }],
-  };
-
-  const sessionStart = settings["hooks"]["SessionStart"];
-
-  if (sessionStart == null) {
-    settings["hooks"]["SessionStart"] = [sdSessionEntry];
-  } else {
-    const idx = sessionStart.findIndex((entry) =>
-      entry.hooks?.some((hook) => hook.command.includes("sd-session-start")),
-    );
-    if (idx >= 0) {
-      sessionStart[idx] = sdSessionEntry;
-    } else {
-      sessionStart.push(sdSessionEntry);
-    }
-  }
-
-  // PreToolUse: ensure sd-check-write hook exists for Write tool
-  const sdWriteEntry = {
-    matcher: "Write",
-    hooks: [{ type: "command", command: "python .claude/sd-check-write.py" }],
-  };
-
-  const preToolUse = settings["hooks"]["PreToolUse"];
-
-  if (preToolUse == null) {
-    settings["hooks"]["PreToolUse"] = [sdWriteEntry];
-  } else {
-    const idx = preToolUse.findIndex((entry) =>
-      entry.hooks?.some((hook) => hook.command.includes("sd-check-write")),
-    );
-    if (idx >= 0) {
-      preToolUse[idx] = sdWriteEntry;
-    } else {
-      preToolUse.push(sdWriteEntry);
-    }
-  }
-
-  // PreToolUse: ensure sd-check-bash hook exists for Bash tool
-  const sdBashEntry = {
-    matcher: "Bash",
-    hooks: [{ type: "command", command: "python .claude/sd-check-bash.py" }],
-  };
-
-  if (settings["hooks"]["PreToolUse"] == null) {
-    settings["hooks"]["PreToolUse"] = [sdBashEntry];
-  } else {
-    const bashIdx = settings["hooks"]["PreToolUse"].findIndex((entry) =>
-      entry.hooks?.some((hook) => hook.command.includes("sd-check-bash")),
-    );
-    if (bashIdx >= 0) {
-      settings["hooks"]["PreToolUse"][bashIdx] = sdBashEntry;
-    } else {
-      settings["hooks"]["PreToolUse"].push(sdBashEntry);
-    }
-  }
-
-  // SubagentStart: ensure sd-session-start hook exists
-  const sdSubagentEntry = {
-    hooks: [{ type: "command", command: "bash .claude/sd-session-start.sh" }],
-  };
-
-  const subagentStart = settings["hooks"]["SubagentStart"];
-
-  if (subagentStart == null) {
-    settings["hooks"]["SubagentStart"] = [sdSubagentEntry];
-  } else {
-    const idx = subagentStart.findIndex((entry) =>
-      entry.hooks?.some((hook) => hook.command.includes("sd-session-start")),
-    );
-    if (idx >= 0) {
-      subagentStart[idx] = sdSubagentEntry;
-    } else {
-      subagentStart.push(sdSubagentEntry);
-    }
-  }
-
-  // statusLine: always overwrite
-  settings["statusLine"] = { type: "command", command: "python .claude/sd-statusline.py" };
-
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-}

package/scripts/sync.mjs

@@ -16,8 +16,11 @@ if (fs.existsSync(targetDir)) {
   fs.rmSync(targetDir, { recursive: true });
 }
 
-// sd-* 항목 탐색 및 복사
+// sd-* 항목 탐색 및 settings.json 포함
 const allEntries = collectSdEntries(claudeDir);
+if (fs.existsSync(path.join(claudeDir, "settings.json"))) {
+  allEntries.push("settings.json");
+}
 
 for (const entry of allEntries) {
   const src = path.join(claudeDir, entry);

package/claude/references/sd-simplysm14.md

@@ -1,35 +0,0 @@
-# sd-simplysm14: @simplysm v14 소비앱 가이드
-
-소비앱이 `@simplysm/*` v14를 사용할 때 적용되는 규칙.
-
-## 중간 패키지(common) 불필요
-
-v14에서는 `import type`으로 타입을 직접 가져올 수 있으므로, 이전 버전에서 클라이언트-서버 간 타입 공유를 위해 필요하던 중간 패키지(예: `service-common`, `orm-common`)가 소비앱의 의존성으로 불필요하다.
-
-```typescript
-// v14: 서버 패키지에서 타입을 직접 import — common 패키지 의존성 불필요
-import type { ServiceMethods } from "@simplysm/service-server";
-```
-
-## 패키지별 상세 문서
-
-| 패키지 | 문서 |
-|--------|------|
-| @simplysm/angular | [usage.md](./sd-simplysm14/angular/usage.md) |
-| @simplysm/capacitor-plugin-auto-update | [usage.md](./sd-simplysm14/capacitor-plugin-auto-update/usage.md) |
-| @simplysm/capacitor-plugin-file-system | [usage.md](./sd-simplysm14/capacitor-plugin-file-system/usage.md) |
-| @simplysm/capacitor-plugin-intent | [usage.md](./sd-simplysm14/capacitor-plugin-intent/usage.md) |
-| @simplysm/capacitor-plugin-usb-storage | [usage.md](./sd-simplysm14/capacitor-plugin-usb-storage/usage.md) |
-| @simplysm/core-browser | [usage.md](./sd-simplysm14/core-browser/usage.md) |
-| @simplysm/core-common | [usage.md](./sd-simplysm14/core-common/usage.md) |
-| @simplysm/core-node | [usage.md](./sd-simplysm14/core-node/usage.md) |
-| @simplysm/excel | [usage.md](./sd-simplysm14/excel/usage.md) |
-| @simplysm/lint | [usage.md](./sd-simplysm14/lint/usage.md) |
-| @simplysm/orm-common | [usage.md](./sd-simplysm14/orm-common/usage.md) |
-| @simplysm/orm-node | [usage.md](./sd-simplysm14/orm-node/usage.md) |
-| @simplysm/sd-claude | [usage.md](./sd-simplysm14/sd-claude/usage.md) |
-| @simplysm/sd-cli | [usage.md](./sd-simplysm14/sd-cli/usage.md) |
-| @simplysm/service-client | [usage.md](./sd-simplysm14/service-client/usage.md) |
-| @simplysm/service-common | [usage.md](./sd-simplysm14/service-common/usage.md) |
-| @simplysm/service-server | [usage.md](./sd-simplysm14/service-server/usage.md) |
-| @simplysm/storage | [usage.md](./sd-simplysm14/storage/usage.md) |