@simplysm/sd-claude 14.0.50 → 14.0.52

package/claude/references/sd-simplysm-v14/orm-node/core/create-orm.md

@@ -0,0 +1,107 @@
+# `createOrm`
+
+Node.js ORM 팩토리 함수. `DbContext` 서브클래스와 DB 연결 설정을 받아 트랜잭션을 관리하는 [`Orm<T>`](#orm) 인스턴스를 반환한다.
+
+## When to use
+
+- ✅ DbContext 기반 ORM 쿼리를 실행할 때 — 트랜잭션 관리가 자동으로 이루어진다.
+- ❌ 생 SQL만 실행할 때 → [`createDbConn`](./create-db-conn.md)이 더 적절하다.
+
+## Signature
+
+```typescript
+function createOrm<T extends DbContext>(
+  DbClass: new (executor: DbContextExecutor, opt: { database: string; schema?: string }) => T,
+  config: DbConnConfig,
+  options?: OrmOptions,
+): Orm<T>;
+```
+
+## Parameters
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `DbClass` | constructor | `DbContext`를 상속한 클래스 생성자 |
+| `config` | `DbConnConfig` | DB 연결 설정 |
+| `options` | `OrmOptions?` | ORM 옵션. `config`보다 우선 적용된다 |
+
+## Returns
+
+`Orm<T>` — `connect()`와 `connectWithoutTransaction()`을 제공하는 ORM 인스턴스.
+
+`options.database` / `options.schema`는 `config`의 동일 필드보다 우선 적용된다. `database`는 필수이며, `config`와 `options` 양쪽 모두 `database`가 없으면 에러를 throw한다.
+
+## Related Types
+
+### `Orm`
+
+`createOrm()`에서 반환하는 객체의 타입.
+
+```typescript
+interface Orm<T extends DbContext> {
+  readonly DbClass: new (
+    executor: DbContextExecutor,
+    opt: { database: string; schema?: string },
+  ) => T;
+  readonly config: DbConnConfig;
+  readonly options?: OrmOptions;
+  connect<R>(callback: (conn: T) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+  connectWithoutTransaction<R>(callback: (conn: T) => Promise<R>): Promise<R>;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `DbClass` | constructor | DbContext 서브클래스 생성자 |
+| `config` | `DbConnConfig` | DB 연결 설정 |
+| `options` | `OrmOptions?` | ORM 옵션 |
+| `connect(callback, isolationLevel?)` | method | 트랜잭션 내에서 콜백을 실행한다. 콜백 완료 후 자동 커밋, 예외 발생 시 자동 롤백 |
+| `connectWithoutTransaction(callback)` | method | 트랜잭션 없이 콜백을 실행한다 |
+
+### `OrmOptions`
+
+`createOrm()`의 세 번째 인수로 전달하는 옵션. `DbConnConfig`의 동일 필드보다 우선 적용된다.
+
+```typescript
+interface OrmOptions {
+  database?: string;
+  schema?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `database` | `string?` | 데이터베이스 이름. `DbConnConfig`의 `database` 대신 사용된다 |
+| `schema` | `string?` | 스키마 이름 (MSSQL: `dbo`, PostgreSQL: `public`). `DbConnConfig`의 `schema` 대신 사용된다 |
+
+## Usage
+
+```typescript
+import { DbContext } from "@simplysm/orm-common";
+import { createOrm } from "@simplysm/orm-node";
+
+class MyDb extends DbContext {
+  user = this.queryable(User);
+}
+
+const orm = createOrm(MyDb, {
+  dialect: "mysql",
+  host: "localhost",
+  port: 3306,
+  username: "root",
+  password: "password",
+  database: "mydb",
+});
+
+// 트랜잭션 내에서 실행
+await orm.connect(async (db) => {
+  const users = await db.user().execute();
+  return users;
+});
+
+// 트랜잭션 없이 실행
+await orm.connectWithoutTransaction(async (db) => {
+  const users = await db.user().execute();
+  return users;
+});
+```

package/claude/references/sd-simplysm-v14/orm-node/core/node-db-context-executor.md

@@ -0,0 +1,50 @@
+# `NodeDbContextExecutor`
+
+`orm-common`의 `DbContextExecutor` 인터페이스를 구현하는 Node.js 환경용 실행자. `DbContext`에서 내부적으로 사용한다.
+
+## When to use
+
+- ✅ `createOrm()`이 내부적으로 생성하므로 직접 사용할 일은 거의 없다.
+- ✅ 커스텀 DbContext 실행 파이프라인을 구성해야 하는 드문 경우에만 직접 인스턴스를 생성한다.
+
+```typescript
+class NodeDbContextExecutor implements DbContextExecutor {
+  constructor(config: DbConnConfig);
+
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
+  commitTransaction(): Promise<void>;
+  rollbackTransaction(): Promise<void>;
+  executeParametrized(query: string, params?: unknown[]): Promise<Record<string, unknown>[][]>;
+  bulkInsert(
+    tableName: string,
+    columnMetas: Record<string, ColumnMeta>,
+    records: DataRecord[],
+  ): Promise<void>;
+  executeDefs<T = DataRecord>(
+    defs: QueryDef[],
+    resultMetas?: (ResultMeta | undefined)[],
+  ): Promise<T[][]>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `connect()` | method | `Promise<void>` | `createDbConn()`으로 DB 연결을 생성하고 연결을 수립한다 |
+| `close()` | method | `Promise<void>` | DB 연결을 종료한다 |
+| `beginTransaction(isolationLevel?)` | method | `Promise<void>` | 트랜잭션을 시작한다 |
+| `commitTransaction()` | method | `Promise<void>` | 트랜잭션을 커밋한다 |
+| `rollbackTransaction()` | method | `Promise<void>` | 트랜잭션을 롤백한다 |
+| `executeParametrized(query, params?)` | method | `Promise<Record<string, unknown>[][]>` | 파라미터화된 쿼리를 실행한다 |
+| `bulkInsert(tableName, columnMetas, records)` | method | `Promise<void>` | 대량 데이터 삽입 |
+| `executeDefs(defs, resultMetas?)` | method | `Promise<T[][]>` | QueryDef 배열을 SQL로 변환하여 실행한다 |
+
+일반적으로 직접 사용하지 않는다. [`createOrm()`](./create-orm.md)이 내부적으로 이 클래스를 생성하여 `DbContext`에 전달한다.
+
+## `executeDefs()` 처리 방식
+
+- `resultMetas`가 모두 `undefined`이면 쿼리를 단일 문자열로 결합하여 한 번의 요청으로 실행한다 (결과 불필요 최적화).
+- 그 외에는 각 def를 개별 실행하고 `ResultMeta`가 있으면 `parseQueryResult()`로 결과를 파싱한다.

package/claude/references/sd-simplysm-v14/orm-node/types/db-conn-config.md

@@ -0,0 +1,91 @@
+# `DbConnConfig`
+
+DB 연결 설정 discriminated union. `dialect` 필드로 구현체를 분기한다.
+
+```typescript
+type DbConnConfig = MysqlDbConnConfig | MssqlDbConnConfig | PostgresqlDbConnConfig;
+```
+
+## Related Types
+
+### `MysqlDbConnConfig`
+
+MySQL 연결 설정.
+
+```typescript
+interface MysqlDbConnConfig {
+  dialect: "mysql";
+  host: string;
+  port?: number;
+  username: string;
+  password: string;
+  database?: string;
+  defaultIsolationLevel?: IsolationLevel;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `dialect` | `"mysql"` | Discriminant. 항상 `"mysql"` |
+| `host` | `string` | 호스트 주소 |
+| `port` | `number?` | 포트 (생략 시 mysql2 기본값 사용) |
+| `username` | `string` | 사용자 이름 |
+| `password` | `string` | 비밀번호 |
+| `database` | `string?` | 데이터베이스 이름 |
+| `defaultIsolationLevel` | `IsolationLevel?` | 기본 격리 수준 (미지정 시 `READ_UNCOMMITTED`) |
+
+### `MssqlDbConnConfig`
+
+MSSQL/Azure SQL 연결 설정.
+
+```typescript
+interface MssqlDbConnConfig {
+  dialect: "mssql" | "mssql-azure";
+  host: string;
+  port?: number;
+  username: string;
+  password: string;
+  database?: string;
+  schema?: string;
+  defaultIsolationLevel?: IsolationLevel;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `dialect` | `"mssql" \| "mssql-azure"` | Discriminant. `"mssql-azure"`인 경우 암호화 연결(`encrypt: true`)을 사용한다 |
+| `host` | `string` | 호스트 주소 |
+| `port` | `number?` | 포트 |
+| `username` | `string` | 사용자 이름 |
+| `password` | `string` | 비밀번호 |
+| `database` | `string?` | 데이터베이스 이름 |
+| `schema` | `string?` | 스키마 이름 |
+| `defaultIsolationLevel` | `IsolationLevel?` | 기본 격리 수준 (미지정 시 `READ_UNCOMMITTED`) |
+
+### `PostgresqlDbConnConfig`
+
+PostgreSQL 연결 설정.
+
+```typescript
+interface PostgresqlDbConnConfig {
+  dialect: "postgresql";
+  host: string;
+  port?: number;
+  username: string;
+  password: string;
+  database?: string;
+  schema?: string;
+  defaultIsolationLevel?: IsolationLevel;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `dialect` | `"postgresql"` | Discriminant. 항상 `"postgresql"` |
+| `host` | `string` | 호스트 주소 |
+| `port` | `number?` | 포트 (미지정 시 `5432`) |
+| `username` | `string` | 사용자 이름 |
+| `password` | `string` | 비밀번호 |
+| `database` | `string?` | 데이터베이스 이름 |
+| `schema` | `string?` | 스키마 이름 |
+| `defaultIsolationLevel` | `IsolationLevel?` | 기본 격리 수준 (미지정 시 `READ_UNCOMMITTED`) |

package/claude/references/sd-simplysm-v14/orm-node/types/db-conn-constants.md

@@ -0,0 +1,33 @@
+# `DB_CONN_CONNECT_TIMEOUT`
+
+DB 연결 수립 타임아웃 (10초).
+
+```typescript
+const DB_CONN_CONNECT_TIMEOUT = 10 * 1000; // 10_000ms
+```
+
+## Related Types
+
+### `DB_CONN_DEFAULT_TIMEOUT`
+
+DB 쿼리 기본 타임아웃 (10분). 유휴 연결 자동 종료 타이머는 이 값의 2배 후 `close()`를 호출한다.
+
+```typescript
+const DB_CONN_DEFAULT_TIMEOUT = 10 * 60 * 1000; // 600_000ms
+```
+
+### `DB_CONN_ERRORS`
+
+DB 연결 관련 오류 메시지 상수.
+
+```typescript
+const DB_CONN_ERRORS = {
+  NOT_CONNECTED: "'Connection'이 연결되어 있지 않습니다.",
+  ALREADY_CONNECTED: "'Connection'이 이미 연결되어 있습니다.",
+} as const;
+```
+
+| Key | Value |
+|-----|-------|
+| `NOT_CONNECTED` | `"'Connection'이 연결되어 있지 않습니다."` |
+| `ALREADY_CONNECTED` | `"'Connection'이 이미 연결되어 있습니다."` |

package/claude/references/sd-simplysm-v14/orm-node/types/db-conn.md

@@ -0,0 +1,60 @@
+# `DbConn`
+
+저수준 DB 연결 인터페이스. 각 DBMS 구현체(`MssqlDbConn`, `MysqlDbConn`, `PostgresqlDbConn`)가 이 인터페이스를 구현한다.
+
+## When to use
+
+- ✅ DBMS에 무관한 코드에서 연결 객체의 타입으로 사용할 때.
+- ✅ 커스텀 DbConn 구현체를 만들 때 이 인터페이스를 구현한다.
+
+```typescript
+interface DbConn extends EventEmitter<{ close: void }> {
+  config: DbConnConfig;
+  isConnected: boolean;
+  isInTransaction: boolean;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
+  commitTransaction(): Promise<void>;
+  rollbackTransaction(): Promise<void>;
+  execute(queries: string[]): Promise<Record<string, unknown>[][]>;
+  executeParametrized(query: string, params?: unknown[]): Promise<Record<string, unknown>[][]>;
+  bulkInsert(
+    tableName: string,
+    columnMetas: Record<string, ColumnMeta>,
+    records: Record<string, unknown>[],
+  ): Promise<void>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `config` | property | `DbConnConfig` | 연결 설정 |
+| `isConnected` | property | `boolean` | 연결 여부 |
+| `isInTransaction` | property | `boolean` | 트랜잭션 진행 여부 |
+| `connect()` | method | `Promise<void>` | DB 연결을 수립한다 |
+| `close()` | method | `Promise<void>` | DB 연결을 종료한다 |
+| `beginTransaction(isolationLevel?)` | method | `Promise<void>` | 트랜잭션을 시작한다 |
+| `commitTransaction()` | method | `Promise<void>` | 트랜잭션을 커밋한다 |
+| `rollbackTransaction()` | method | `Promise<void>` | 트랜잭션을 롤백한다 |
+| `execute(queries)` | method | `Promise<Record<string, unknown>[][]>` | SQL 쿼리 배열을 실행한다 |
+| `executeParametrized(query, params?)` | method | `Promise<Record<string, unknown>[][]>` | 파라미터화된 쿼리를 실행한다 |
+| `bulkInsert(tableName, columnMetas, records)` | method | `Promise<void>` | 네이티브 bulk API를 사용하여 대량 삽입한다 |
+
+`EventEmitter<{ close: void }>`를 상속하므로 연결 종료 시 `'close'` 이벤트를 수신할 수 있다.
+
+## Usage
+
+```typescript
+conn.on("close", () => {
+  // 연결이 종료됨
+});
+
+await conn.connect();
+await conn.beginTransaction();
+await conn.execute(["INSERT INTO users (name) VALUES ('Alice')"]);
+await conn.commitTransaction();
+await conn.close();
+```

package/claude/references/sd-simplysm-v14/orm-node/types/get-dialect-from-config.md

@@ -0,0 +1,17 @@
+# `getDialectFromConfig`
+
+`DbConnConfig`에서 정규화된 `Dialect`를 추출한다.
+
+```typescript
+function getDialectFromConfig(config: DbConnConfig): Dialect;
+```
+
+## Parameters
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `config` | `DbConnConfig` | DB 연결 설정 |
+
+## Returns
+
+`Dialect` — 정규화된 dialect 값. `"mssql-azure"` → `"mssql"`로 변환하고, 나머지(`"mysql"`, `"mssql"`, `"postgresql"`)는 `config.dialect`를 그대로 반환한다.

package/{README.md → claude/references/sd-simplysm-v14/sd-claude/README.md}

@@ -1,84 +1,85 @@
-# @simplysm/sd-claude
-
-Claude Code 에셋을 소비 프로젝트의 `.claude/` 디렉토리에 자동 설치하는 패키지. 다수의 스킬(`sd-*` 접두어 포함), 2개 rules 파일, 참조 문서, 훅 스크립트를 포함한다. CLI(`sd-claude`)로 멀티 계정 전환 기능도 제공한다.
-
-TypeScript 소스 없음. `scripts/`는 Node.js `.mjs` 스크립트이고, `claude/`는 배포 에셋 디렉토리다.
-
-## Installation
-
-```bash
-npm install @simplysm/sd-claude
-```
-
-설치 시 `postinstall` 스크립트가 자동 실행되어, `claude/sd-*` 에셋과 `settings.json`을 프로젝트 루트 `.claude/`에 복사한다. `settings.json`은 훅이 미리 등록된 정적 파일이다.
-
-## API Overview
-
-### CLI Commands
-
-| API | Type | Description |
-|-----|------|-------------|
-| `sd-claude auth save` | CLI command | 현재 Claude Code 계정의 Organization 이름과 refresh token을 `~/.claude/profiles.json`에 저장 |
-| `sd-claude auth switch` | CLI command | 저장된 계정 목록을 표시하고 선택한 계정으로 전환 (TTY 필수) |
-
-→ See [docs/cli.md](./docs/cli.md) for details.
-
-### Scripts (Internal)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `postinstall.mjs` | lifecycle script | `pnpm install` 후 `claude/sd-*` 및 `settings.json`을 소비 프로젝트 `.claude/`에 복사 |
-| `sync.mjs` | lifecycle script | `prepack` 시 루트 `.claude/sd-*` 에셋을 `claude/`로 동기화 |
-| `forEachSdEntry(dir, callback)` | function | 디렉토리에서 `sd-*` 항목을 2단계 깊이로 탐색하며 콜백 호출 |
-| `collectSdEntries(dir)` | function | `forEachSdEntry`로 수집한 `sd-*` 항목의 상대 경로 배열 반환 |
-
-→ See [docs/scripts.md](./docs/scripts.md) for details.
-
-### Hooks
-
-| API | Type | Description |
-|-----|------|-------------|
-| `sd-subagent-start.sh` | SubagentStart hook | subagent 시작 시 `CLAUDE.md` 내용을 출력하여 subagent가 프로젝트 지침을 참조하도록 안내 |
-| `sd-check-write.py` | PreToolUse hook (Write) | 기존 파일에 Write 도구 사용 시 차단하고 Edit 도구 사용을 안내 |
-| `sd-check-bash.py` | PreToolUse hook (Bash) | 금지된 명령어 차단 (git stash/checkout/restore/reset/clean, cd, npx tsc, npx eslint) |
-| `sd-check-forbidden-files.py` | PreToolUse hook (Write/Edit) | `tsconfig.json`, `eslint.config.ts` 등 보호 파일 수정 차단 |
-| `sd-statusline.py` | statusLine hook | 상태바에 `폴더 | 모델 | 컨텍스트% | 5h사용량 | 7d사용량 | $추가요금` 표시 |
-
-→ See [docs/hooks.md](./docs/hooks.md) for details.
-
-### Asset Structure
-
-| API | Type | Description |
-|-----|------|-------------|
-| `claude/skills/` | asset directory | 19개 sd-* 스킬 디렉토리 (각 스킬은 `SKILL.md` + 선택적 `SKILL.eval.md`와 `references/` 포함) |
-| `claude/rules/` | asset directory | Claude Code 규칙 파일 (`sd-claude-rules.md`, `sd-options.md`) |
-| `claude/references/` | asset directory | 스킬/규칙에서 참조하는 공유 문서 (`sd-frontend-design.md`, `sd-testing.md`) |
-
-→ See [docs/assets.md](./docs/assets.md) for details.
-
-## Usage Examples
-
-### 멀티 계정 관리
-
-```bash
-# 현재 계정을 저장
-sd-claude auth save
-
-# 저장된 계정 목록에서 선택하여 전환
-sd-claude auth switch
-```
-
-### 소비 프로젝트에 설치
-
-```bash
-# pnpm install 시 자동으로 .claude/에 에셋 설치됨
-pnpm add -D @simplysm/sd-claude
-
-# 설치 후 .claude/ 디렉토리 구조:
-# .claude/
-#   rules/sd-claude-rules.md
-#   skills/sd-commit/, sd-check/, ...
-#   references/sd-*.md
-#   sd-subagent-start.sh, sd-check-write.py, ...
-#   settings.json  (훅 자동 등록)
-```
+# @simplysm/sd-claude
+
+Claude Code 에셋을 소비 프로젝트의 `.claude/` 디렉토리에 자동 설치하는 패키지. 다수의 스킬(`sd-*` 접두어 포함), 2개 rules 파일, 참조 문서, 6개 훅 스크립트를 포함한다. CLI(`sd-claude`)로 멀티 계정 전환 기능도 제공한다.
+
+TypeScript 소스 없음. `scripts/`는 Node.js `.mjs` 스크립트이고, `claude/`는 배포 에셋 디렉토리다.
+
+## Installation
+
+```bash
+npm install @simplysm/sd-claude
+```
+
+설치 시 `postinstall` 스크립트가 자동 실행되어, `claude/sd-*` 에셋과 `settings.json`을 프로젝트 루트 `.claude/`에 복사한다. `settings.json`은 훅이 미리 등록된 정적 파일이다.
+
+## API Overview
+
+### CLI Commands
+
+| API | Type | Description |
+|-----|------|-------------|
+| `sd-claude auth save` | CLI command | 현재 Claude Code 계정의 Organization 이름과 refresh token을 `~/.claude/profiles.json`에 저장 |
+| `sd-claude auth switch` | CLI command | 저장된 계정 목록을 표시하고 선택한 계정으로 전환 (TTY 필수) |
+
+→ See [docs/cli.md](./cli.md) for details.
+
+### Scripts (Internal)
+
+| API | Type | Description |
+|-----|------|-------------|
+| `postinstall.mjs` | lifecycle script | `pnpm install` 후 `claude/sd-*` 및 `settings.json`을 소비 프로젝트 `.claude/`에 복사 |
+| `sync.mjs` | lifecycle script | `prepack` 시 루트 `.claude/sd-*` 에셋을 `claude/`로 동기화 |
+| `forEachSdEntry(dir, callback)` | function | 디렉토리에서 `sd-*` 항목을 2단계 깊이로 탐색하며 콜백 호출 |
+| `collectSdEntries(dir)` | function | `forEachSdEntry`로 수집한 `sd-*` 항목의 상대 경로 배열 반환 |
+
+→ See [docs/scripts.md](./scripts.md) for details.
+
+### Hooks
+
+| API | Type | Description |
+|-----|------|-------------|
+| `sd-subagent-start.sh` | SubagentStart hook | subagent 시작 시 `CLAUDE.md` 내용을 출력하여 subagent가 프로젝트 지침을 참조하도록 안내 |
+| `sd-check-write.py` | PreToolUse hook (Write) | 기존 파일에 Write 도구 사용 시 차단하고 Edit 도구 사용을 안내 |
+| `sd-check-bash.py` | PreToolUse hook (Bash) | 금지된 명령어 차단 (git stash/checkout/restore/reset/clean, cd, npx tsc, npx eslint) |
+| `sd-check-forbidden-files.py` | PreToolUse hook (Write/Edit) | `tsconfig.json`, `eslint.config.ts` 등 보호 파일 수정 차단 |
+| `sd-cache-read-hash.py` | PostToolUse hook (Read) | Read 후 파일 SHA-256 해시를 세션별 캐시에 저장 |
+| `sd-statusline.py` | statusLine hook | 상태바에 `폴더 | 모델 | 컨텍스트% | 5h사용량 | 7d사용량 | $추가요금` 표시 |
+
+→ See [docs/hooks.md](./hooks.md) for details.
+
+### Asset Structure
+
+| API | Type | Description |
+|-----|------|-------------|
+| `claude/skills/` | asset directory | 19개 sd-* 스킬 디렉토리 (각 스킬은 `SKILL.md` + 선택적 `SKILL.eval.md`와 `references/` 포함) |
+| `claude/rules/` | asset directory | Claude Code 규칙 파일 (`sd-claude-rules.md`, `sd-options.md`) |
+| `claude/references/` | asset directory | 스킬/규칙에서 참조하는 공유 문서 (`sd-frontend-design.md`) |
+
+→ See [docs/assets.md](./assets.md) for details.
+
+## Usage Examples
+
+### 멀티 계정 관리
+
+```bash
+# 현재 계정을 저장
+sd-claude auth save
+
+# 저장된 계정 목록에서 선택하여 전환
+sd-claude auth switch
+```
+
+### 소비 프로젝트에 설치
+
+```bash
+# pnpm install 시 자동으로 .claude/에 에셋 설치됨
+pnpm add -D @simplysm/sd-claude
+
+# 설치 후 .claude/ 디렉토리 구조:
+# .claude/
+#   rules/sd-claude-rules.md
+#   skills/sd-commit/, sd-check/, ...
+#   references/sd-*.md
+#   sd-subagent-start.sh, sd-check-write.py, ...
+#   settings.json  (훅 자동 등록)
+```

package/{docs → claude/references/sd-simplysm-v14/sd-claude}/assets.md

@@ -9,8 +9,9 @@ claude/
 ├── references/          ← 스킬/규칙에서 참조하는 공유 문서
 ├── rules/               ← Claude Code 규칙 파일
 ├── skills/              ← 스킬 파일 디렉토리
+├── sd-cache-read-hash.py        ← 훅 스크립트
 ├── sd-check-bash.py             ← 훅 스크립트
-├── sd-check-forbidden-files.py ← 훅 스크립트
+├── sd-check-forbidden-files.py  ← 훅 스크립트
 ├── sd-check-write.py            ← 훅 스크립트
 ├── sd-subagent-start.sh         ← 훅 스크립트
 └── sd-statusline.py             ← 훅 스크립트
@@ -83,7 +84,6 @@ Claude Code 규칙 파일. 2개 파일.
 | 파일 | Description |
 |------|-------------|
 | `sd-frontend-design.md` | 프론트엔드 UI 코드 작성 지침 |
-| `sd-testing.md` | 테스트 작성 지침 |
 
 ## 소스 오브 트루스
 

package/{docs → claude/references/sd-simplysm-v14/sd-claude}/hooks.md

@@ -1,6 +1,6 @@
 # Hooks
 
-`claude/` 디렉토리의 훅 스크립트 (총 5개). `postinstall`에 의해 `.claude/`에 설치되고, `settings.json`에 자동 등록되어 Claude Code 세션에서 실행된다.
+`claude/` 디렉토리의 훅 스크립트 (총 6개). `postinstall`에 의해 `.claude/`에 설치되고, `settings.json`에 자동 등록되어 Claude Code 세션에서 실행된다.
 
 ## `sd-subagent-start.sh`
 
@@ -132,3 +132,17 @@ statusLine 훅. Claude Code 상태바에 `폴더 | 모델 | 컨텍스트% | 5h
 |------|-------------|
 | (없음) | 기본 모드: stdin에서 세션 정보를 읽고 상태바 문자열 출력 |
 | `--fetch <version>` | 백그라운드 fetch 모드: API를 호출하여 캐시 갱신 |
+
+## `sd-cache-read-hash.py`
+
+PostToolUse 훅 (matcher: `Read`). Read 도구 실행 후 읽은 파일의 SHA-256 해시를 세션별 캐시 디렉토리에 저장한다. 파일 변경 감지에 활용된다.
+
+입력: stdin JSON (`tool_input.file_path`, `session_id`)
+
+동작:
+1. `tool_input.file_path`에서 파일 경로를 읽는다
+2. 파일이 존재하지 않으면 아무 동작 없이 종료한다
+3. 파일 내용의 SHA-256 해시를 계산한다
+4. 파일 경로의 SHA-256 해시를 키로 사용하여 `.tmp/read_hash/{session_id}/` 디렉토리에 해시 파일을 저장한다
+
+캐시 경로: `.tmp/read_hash/{session_id}/{path_hash}` (내용: 파일 콘텐츠의 SHA-256 해시)