@simplysm/sd-claude 14.0.82 → 14.0.84

package/claude/references/sd-simplysm14/apis/core-common/types.md

@@ -1,88 +0,0 @@
-# @simplysm/core-common — types
-
-## Uuid
-
-```ts
-class Uuid {
-  static generate(): Uuid                  // crypto.getRandomValues 기반 UUID v4
-  static fromBytes(bytes: Bytes): Uuid     // 16바이트 Uint8Array → Uuid (길이≠16이면 ArgumentError)
-  constructor(uuid: string)                // 형식 검증 (실패 시 ArgumentError)
-  toString(): string
-  toBytes(): Bytes
-}
-```
-- 정규식 `^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i` 로 검증.
-- v4 비트: byte[6]은 0x40 마스크, byte[8]은 0x80 마스크 적용.
-
-## DateTime (불변, 로컬 타임존, ms 정밀도)
-
-```ts
-new DateTime()                              // 현재
-new DateTime(year, month, day, h?, m?, s?, ms?)
-new DateTime(tick: number)
-new DateTime(date: Date)
-static parse(str): DateTime                 // 'yyyy-MM-dd HH:mm:ss[.fff]', 'yyyyMMddHHmmss',
-                                            // 'yyyy-MM-dd AM/PM HH:mm:ss', '오전/오후', ISO 8601
-```
-- 읽기 getter: `year`, `month` (1-12), `day`, `hour`, `minute`, `second`, `millisecond`, `tick`, `dayOfWeek` (0=일~6=토), `timezoneOffsetMinutes`, `isValid`, `date` (내부 Date 복사 X — readonly 참조).
-- 변환: `setYear/Month/Day/Hour/Minute/Second/Millisecond(n)` → 새 인스턴스. `setMonth`는 일수 초과 시 해당 월 말일로 보정 (예: 1월 31일 → 2월 28/29일).
-- 산술: `addYears/Months/Days` (캘린더 기반), `addHours/Minutes/Seconds/Milliseconds` (tick 가산).
-- 포맷: `toFormatString(fmt)` — `dt.format` 형식 문자열. `toString()` = `"yyyy-MM-ddTHH:mm:ss.fffzzz"`.
-- 파싱 실패 시 `ArgumentError`.
-
-## DateOnly (불변, 시간 제외)
-
-```ts
-new DateOnly() | new DateOnly(y,m,d) | new DateOnly(tick) | new DateOnly(date)
-static parse(str): DateOnly                 // 'yyyy-MM-dd', 'yyyyMMdd' (타임존 무관),
-                                            // ISO 8601 (UTC→로컬 변환)
-static getDateByYearWeekSeq(
-  { year, month?, weekSeq },
-  weekStartDay = 1, minDaysInFirstWeek = 4,
-): DateOnly                                 // 지정 주차의 시작 날짜
-```
-- getter: `year`, `month`, `day`, `tick`, `dayOfWeek`, `isValid`.
-- `setYear/Month/Day`, `addYears/Months/Days` 동일 패턴 (월 보정 동일).
-- 주차 API (인스턴스):
-  - `getBaseYearMonthSeqForWeekSeq(weekStartDay=1, minDaysInFirstWeek=4)`: 이 날짜가 속한 주의 기준 연/월.
-  - `getWeekSeqStartDate(...)`: 이 날짜가 속한 주의 시작 날짜.
-  - `getWeekSeqOfYear(...)`: `{ year, weekSeq }`.
-  - `getWeekSeqOfMonth(...)`: `{ year, monthSeq, weekSeq }`.
-- `weekStartDay`: 주 시작 요일 (0=일~6=토). 기본 1=월.
-- `minDaysInFirstWeek`: 첫 주 최소 일수 (1~7). 4=ISO 8601, 1=미국식.
-- `toFormatString(fmt)` / `toString()` = `"yyyy-MM-dd"`.
-
-## Time (불변, 24시간 순환)
-
-```ts
-new Time() | new Time(h, m, s?, ms?) | new Time(tick) | new Time(date)
-static parse(str): Time                     // 'HH:mm:ss[.fff]', 'AM/PM HH:mm:ss', ISO 8601
-```
-- 24시간을 초과/음수인 tick 입력은 자동으로 `% MS_PER_DAY` 정규화.
-- getter: `hour`, `minute`, `second`, `millisecond`, `tick`, `isValid`.
-- `setHour/Minute/Second/Millisecond`, `addHours/Minutes/Seconds/Milliseconds` (24시간 순환).
-- `toFormatString(fmt)` / `toString()` = `"HH:mm:ss.fff"`.
-
-## LazyGcMap<TKey, TValue>
-
-LRU 접근 시간 갱신 + 주기 GC 로 자동 만료되는 `Map`.
-
-```ts
-new LazyGcMap({
-  expireTime: number,                       // 만료 ms (필수). 마지막 접근부터 경과 시 삭제
-  gcInterval?: number,                      // GC 주기 ms. 기본 = max(expireTime/10, 1000)
-  onExpire?: (key, value) => void|Promise<void>,   // 만료 시 콜백. 비동기 가능, throw하면 로그만
-})
-
-has(key)       // 접근 시간 갱신 X
-get(key)       // 접근 시간 갱신 O
-set(key, val)  // GC 타이머 시작
-delete(key)    // 비면 GC 중지
-clear()        // 전체 삭제 + GC 중지 (인스턴스 재사용 가능)
-dispose()      // 영구 정리 (이후 모든 작업 no-op, getOrCreate만 throw)
-getOrCreate(key, factory)
-size, keys(), values(), entries()
-```
-- **반드시 `dispose()` 호출 필요** — 안 하면 GC 타이머 leak.
-- GC 중복 실행 방지(`_isGcRunning`). `onExpire` 실행 도중 같은 key로 `set()`되면 새 값은 보존(참조 동일성 비교).
-- 비어있으면 자동 GC 중지 → 재 `set()` 시 자동 재시작.

package/claude/references/sd-simplysm14/apis/core-common/utils.md

@@ -1,189 +0,0 @@
-# @simplysm/core-common — utils
-
-`utils/` 네임스페이스 일괄 export. import는 `import { obj, str, ..., js, ZipArchive } from "@simplysm/core-common"`.
-
-## `obj` — 객체 조작
-
-```ts
-obj.clone<T>(source): T
-  // 깊은 복사. 순환 참조 지원. Date/DateTime/DateOnly/Time/Uuid/RegExp/Error/Uint8Array/Array/Map/Set 모두 별도 처리.
-  // 프로토타입 체인 유지(Object.setPrototypeOf). 함수·Symbol은 참조 유지. WeakMap/WeakSet 미지원. getter/setter는 현재 값으로 평가.
-
-obj.equal(source, target, options?: EqualOptions): boolean
-interface EqualOptions {
-  topLevelIncludes?: string[]   // 지정한 key만 비교 (최상위만, 객체 속성에만 적용)
-  topLevelExcludes?: string[]   // 지정한 key 제외 (최상위만)
-  ignoreArrayIndex?: boolean    // array 순서 무시. true면 O(n²) (permutation 매칭)
-  shallow?: boolean             // 1단계 참조 비교
-}
-  // null != null 분기, custom 타입은 tick/toString 기반 비교.
-
-obj.merge<S, T>(source, target, opt?: MergeOptions): S & T
-interface MergeOptions {
-  arrayProcess?: "replace" | "concat"   // 기본 "replace"(target으로 교체). "concat"=합집합(Set 중복 제거)
-  useDelTargetNull?: boolean            // target이 null이면 결과 key 삭제
-}
-  // 불변 (새 객체 반환). 타입 다르면 target으로 덮어씀. Map은 재귀 머지.
-
-obj.merge3(source, origin, target, optionsObj?: Record<key, Merge3KeyOptions>):
-  { conflict: boolean; result: O & S & T }
-  // 3-way merge. source==origin → target 채택, target==origin → source 채택,
-  // source==target → 채택, 셋 다 다름 → conflict=true + origin 유지
-interface Merge3KeyOptions { keys?; excludes?; ignoreArrayIndex? }   // equal과 동일
-
-obj.omit(item, omitKeys[]): Omit<T, K>
-obj.omitByFilter(item, (key) => boolean): T          // @internal
-obj.pick(item, keys[]): Pick<T, K>
-
-obj.getChainValue(o, "a.b[0].c", optional?: true): unknown
-obj.getChainValueByDepth(o, key, depth, optional?): T[K]   // 같은 key로 depth회 하강
-obj.setChainValue(o, chain, value): void
-obj.deleteChainValue(o, chain): void
-
-obj.clearUndefined(o): T                              // @mutates null/undefined key 삭제
-obj.clear(o): {}                                      // @mutates 전체 비우기
-obj.nullToUndefined(o): T                             // @mutates null→undefined (재귀, 순환 안전)
-obj.unflatten({ "a.b.c": 1 }): { a: { b: { c: 1 } } }   // @internal
-
-obj.keys(o): (keyof T)[]                              // 타입 안전 Object.keys
-obj.entries(o): [K, V][]                              // 타입 안전 Object.entries
-obj.fromEntries(pairs): Record
-obj.map(o, (key, value) => [newKey | null, newValue]): Record
-  // null newKey → 기존 key 유지. key/value 동시 변환
-
-type UndefToOptional<T>                               // { a, b: T|undefined } → { a, b?: T }
-type OptionalToUndef<T>                               // { a, b? } → { a, b: T|undefined }
-```
-
-## `str` — 문자열
-
-```ts
-str.getKoreanSuffix(text, type: "을"|"은"|"이"|"와"|"랑"|"로"|"라"): string
-  // 받침 유무로 조사 자동. "로"는 ㄹ 받침 예외(받침 있어도 "로"). 한글 외 문자→무받침 취급.
-str.replaceFullWidth(str): string                    // 전각 영숫자/공백/괄호 → 반각
-str.toPascalCase(s) / toCamelCase / toKebabCase / toSnakeCase
-  // PascalCase: 하이픈/언더/점 + 소문자 → 대문자. 첫글자 대문자화.
-  // kebab/snake: 대문자/대문자그룹 분리. 기존 구분자는 유지 (혼합 시 "hello-_world").
-str.isNullOrEmpty(s): s is "" | undefined            // 타입 가드
-str.insert(s, index, insertString): string
-```
-
-## `num` — 숫자
-
-```ts
-num.parseInt(text): number | undefined               // 숫자 외 문자 제거. 선행 - 만 음수, 중간 - 제거. "010-1234-5678"→1012345678
-num.parseFloat(text): number | undefined
-num.parseRoundedInt(text): number | undefined        // parseFloat 후 Math.round
-num.isNullOrEmpty(n): n is 0 | undefined             // 타입 가드 (0/null/undefined)
-num.format(val, digit?: { max?, min? }): string      // toLocaleString. min 부족분은 0 패딩
-```
-
-## `bytes` — Uint8Array
-
-```ts
-bytes.concat(arrs: Bytes[]): Bytes
-bytes.toHex(b): string                               // 소문자
-bytes.fromHex(hex): Bytes                            // 홀수 길이/무효 문자 → ArgumentError
-bytes.toBase64(b): string
-bytes.fromBase64(s): Bytes                           // 공백·패딩 정규화. 무효 문자/길이 → ArgumentError
-```
-
-## `path` — POSIX 경로 (브라우저용, `/` 만 지원)
-
-```ts
-path.join(...segments): string                       // 슬래시 정규화
-path.basename(filePath, ext?): string                // ext 제거 옵션
-path.extname(filePath): string                       // 숨김파일(.gitignore)은 "" (Node 동일)
-```
-
-## `json` — 커스텀 타입 지원 JSON
-
-```ts
-json.stringify(obj, options?: {
-  space?: number | string,
-  replacer?: (key, value) => unknown,
-  redactBytes?: boolean,                             // Uint8Array → "__hidden__" (로깅용, parse 시 throw)
-}): string
-json.parse<T>(str): T
-```
-- 사전 변환으로 `{ __type__, data }` 태그 객체 생성: Date/DateTime/DateOnly/Time/Uuid/Set/Map/Error(cause·code·detail 포함)/Uint8Array(hex). `Date.prototype.toJSON` 미수정 → Worker 안전.
-- 순환 참조 → `TypeError`.
-- `parse`는 `nullToUndefined` 적용 (모든 JSON `null` → `undefined`, simplysm null-free 규칙).
-- 파싱 실패 시 `__DEV__` 환경에서는 메시지에 전체 JSON 포함, 아니면 길이만.
-
-## `xml` — XML (fast-xml-parser 래퍼)
-
-```ts
-xml.parse(str, options?: { stripTagPrefix?: boolean }): unknown
-xml.stringify(obj, options?: XmlBuilderOptions): string
-```
-- 속성은 `$` 그룹, 텍스트 노드는 `_` key. 1단계 깊이 미만은 단일 객체, 이상은 array.
-- `stripTagPrefix`: `"ns:tag"`에서 접두사 제거 (속성은 유지).
-
-## `wait` — 타이밍
-
-```ts
-wait.time(ms): Promise<void>                         // setTimeout Promise화
-wait.until(forwarder, ms = 100, maxCount?): Promise<void>
-  // forwarder가 true 반환할 때까지 ms 간격 폴링. maxCount 초과 시 TimeoutError(count)
-```
-
-## `transfer` — Worker 직렬화
-
-```ts
-transfer.encode(obj): { result: unknown; transferList: ArrayBuffer[] }
-transfer.decode(obj): unknown
-```
-- `worker.postMessage(result, transferList)` 패턴. Uint8Array는 zero-copy 전송, SharedArrayBuffer는 transferList 제외.
-- 지원: Date/DateTime/DateOnly/Time/Uuid/RegExp, Error(cause·code·detail), Array/Map/Set/일반 객체. 그 외 TypedArray는 일반 객체로 처리됨.
-- 순환 참조 → `TypeError("순환 참조 감지됨: <path>")`. 같은 객체 다중 참조는 캐시 재사용.
-
-## `err` — 에러 메시지
-
-```ts
-err.message(err: unknown): string                    // Error.message 또는 String(err)
-```
-
-## `dt` — 날짜·시간 포맷 내부 헬퍼
-
-```ts
-dt.format(formatStr, args: { year?, month?, day?, hour?, minute?, second?, millisecond?, timezoneOffsetMinutes? }): string
-dt.normalizeMonth(year, month, day): { year, month, day }   // 월 오버플로 + 일수 보정
-dt.convert12To24(rawHour, isPM): number                     // 12 AM=0, 12 PM=12
-```
-- format 토큰: `yyyy yy`, `MM M`, `ddd`(요일 한글), `dd d`, `tt`(AM/PM), `hh h`(12시간), `HH H`(24시간), `mm m`, `ss s`, `fff ff f`(밀리초), `zzz zz z`(타임존 ±HH:mm/±HH/±H). 긴 토큰 우선.
-
-## `primitive` — PrimitiveType 런타임
-
-```ts
-primitive.typeStr(value): PrimitiveTypeStr           // 값 → "string"|"number"|"boolean"|"DateTime"|"DateOnly"|"Time"|"Uuid"|"Bytes"
-```
-- 미지원 타입 → `ArgumentError`.
-
-## 직접 export — 템플릿 태그
-
-`js`, `ts`, `html`, `tsql`, `mysql`, `pgsql` — 모두 같은 동작 (IDE 코드 하이라이팅용). 들여쓰기 정규화: 앞뒤 빈 줄 제거 + 모든 줄에서 공통 최소 들여쓰기만큼 dedent.
-
-```ts
-const sql = mysql`
-  SELECT * FROM users
-  LIMIT 10
-`;
-```
-
-## 직접 export — `ZipArchive` (`@zip.js/zip.js` 래퍼)
-
-```ts
-class ZipArchive {
-  constructor(data?: Blob | Bytes)                   // 없으면 새 아카이브
-  extractAll(progressCb?: (p: { fileName, totalSize, extractedSize }) => void): Promise<Map<string, Bytes>>
-  get(fileName): Promise<Bytes | undefined>          // 캐싱됨
-  exists(fileName): Promise<boolean>
-  write(fileName, bytes): void                       // 캐시에만 저장
-  compress(): Promise<Bytes>                         // 캐시된 모든 파일을 ZIP으로 (extractAll 호출 → 전체 메모리 적재)
-  close(): Promise<void>                             // reader 닫고 캐시 비움
-}
-interface ZipArchiveProgress { fileName, totalSize, extractedSize }
-```
-- 같은 파일 재추출 방지를 위해 내부 `_cache: Map<filename, Bytes>` 사용.
-- 대용량 ZIP 의 `compress()` 는 메모리 주의 (스트리밍 X).

package/claude/references/sd-simplysm14/apis/core-node/README.md

@@ -1,12 +0,0 @@
-## @simplysm/core-node
-
-Node.js 환경 전용 파일시스템·자식 프로세스·경로·파일감시·로깅·Worker 유틸 묶음.
-
-## 사용 트리거 인덱스
-
-- **`fsx`** — 파일/디렉토리 존재확인·생성·복사·삭제·읽기/쓰기(텍스트/바이너리/JSON)·glob·부모 디렉토리 탐색이 필요할 때. 자세히: [fsx.md](./fsx.md)
-- **`pathx`** — POSIX 슬래시 경로 변환, 부모-자식 경로 판정, cwd 기준 타겟 필터링이 필요할 때. 자세히: [pathx.md](./pathx.md)
-- **`cpx`** — 자식 프로세스 spawn(비동기/동기), 시스템 인코딩 자동 디코딩, 실패 시 reject 옵션. 자세히: [cpx.md](./cpx.md)
-- **`FsWatcher`** — 디렉토리/glob 변경 감시 + 디바운싱 + 이벤트 병합 + EPERM 자동 재시작. 자세히: [fs-watcher.md](./fs-watcher.md)
-- **`setupConsola` / `PrettyReporter` / `createFileReporter`** — CLI/서버 로깅 일괄 설정, 컬러 콘솔 + JSONL 파일 회전. 자세히: [consola.md](./consola.md)
-- **`Worker` / `createWorker`** — 타입 안전 worker_threads 래퍼. 메인에서 `Worker.create()`, 워커에서 `createWorker()`. 자세히: [worker.md](./worker.md)

package/claude/references/sd-simplysm14/apis/core-node/consola.md

@@ -1,59 +0,0 @@
-## @simplysm/core-node — consola 설정
-
-전역 `consola` 인스턴스에 reporter 를 일괄 부착하는 헬퍼와 reporter 구현체.
-
-### setupConsola
-
-```ts
-setupConsola(opts?: { cli?: boolean }): void
-```
-
-전역 `consola.level = LogLevels.debug` 로 설정 후 환경에 따라 reporter 구성:
-
-- `opts.cli !== true` && `env("DEV")` falsy → **프로덕션**: `createFileReporter()` 만 (JSONL 파일, 콘솔 X).
-- 그 외 → **개발**:
-  - `env("SD_DEBUG")` truthy → `PrettyReporter()` 만 (debug 포함 콘솔).
-  - 그 외 → `createFileReporter()`(debug 포함 파일) + `PrettyReporter()`(info 이상만 콘솔, `withMaxLevel` 적용).
-
-`opts.cli`: CLI 프로세스(`sd-cli` 등) 여부. true 면 파일 출력 없이 콘솔만 사용하도록 분기.
-
-### withMaxLevel
-
-```ts
-withMaxLevel(reporter: ConsolaReporter, maxLevel: number): ConsolaReporter
-```
-
-기존 reporter 를 감싸 `logObj.level > maxLevel` 인 항목을 버린다. consola `LogLevels` 는 낮을수록 심각(0=fatal/error, 1=warn, 2=log, 3=info, 4=debug, 5=trace).
-
-### PrettyReporter
-
-`class PrettyReporter implements ConsolaReporter` — ANSI 컬러 콘솔 출력.
-
-- 색상 활성화: `env("NO_COLOR")` 있으면 비활성, `env("FORCE_COLOR")` 있으면 강제, TTY 또는 win32 면 활성.
-- level<2 (fatal/error/warn) → `stderr`, 그 외 → `stdout`.
-- `type === "box"` → 박스 포맷, `type === "trace"` → 스택 첨부, level<2 또는 `badge: true` → 위아래 빈 줄.
-- `Error` args → message + cwd prefix 제거된 스택 + `cause` 재귀 indent.
-- `ctx.options.formatOptions.date: true` → 시각 `HH:mm:ss.SSS` 부착.
-
-### createFileReporter
-
-```ts
-createFileReporter(options?: { maxSize?: number; maxDays?: number }): ConsolaReporter
-```
-
-- `maxSize` (기본 20MB): 파일 1개 최대 크기. 초과 시 `app.<YYYY-MM-DD>.<seq>.log` 시퀀스로 회전.
-- `maxDays` (기본 14): cutoff 일자 이전 로그 파일 자동 삭제. 매일 첫 로그 시 1회 실행.
-- 출력 위치: `${process.cwd()}/.logs/app.<YYYY-MM-DD>.log` (필요시 `.<seq>` 부착).
-- 라인 형식: `{ time, level, tag?, err?: {message,stack}, msg? }` JSONL. `Error` arg 는 `err` 필드로 분리, 나머지는 `msg` 로 공백 연결.
-- 날짜 바뀌면 자동 로테이트. `.logs` 디렉토리는 첫 쓰기 시 생성.
-
-### 예
-
-```ts
-import { setupConsola, PrettyReporter, createFileReporter } from "@simplysm/core-node";
-import consola from "consola";
-setupConsola({ cli: true });
-
-// 커스텀
-consola.options.reporters = [new PrettyReporter(), createFileReporter({ maxDays: 30 })];
-```

package/claude/references/sd-simplysm14/apis/core-node/cpx.md

@@ -1,44 +0,0 @@
-## @simplysm/core-node — cpx
-
-`import { cpx } from "@simplysm/core-node"`. 자식 프로세스 spawn 래퍼. stdout/stderr 를 시스템 인코딩으로 자동 디코딩, 실패 시 stderr 포함 에러 throw.
-
-### 인코딩 감지
-
-- `getSystemEncoding(): string` — Windows 는 `chcp` 결과 코드 페이지를, POSIX 는 `LANG`/`LC_ALL` 의 `.<enc>` 부분을 파싱. 실패 시 `"utf-8"`. **결과는 모듈 캐시**.
-- `resetEncodingCache(): void` — 캐시 초기화. 환경 변경 후 강제 재감지 시.
-- `codePageToEncoding(codePage): string` — Windows 코드 페이지 번호→IANA 인코딩명(65001/949/932/936/950/1252/1251/1250/874 지원, 그 외 `"utf-8"`).
-- `decodeBytes(raw: Uint8Array, systemEncoding?: string): string` — UTF-8 fatal decode 시도 → 실패 시 지정 인코딩으로 fallback.
-
-### spawn
-
-```ts
-spawn(cmd, args, options?): SpawnProcess
-spawnSync(cmd, args, options?): SpawnResult
-```
-
-- `options`: Node `SpawnOptions`/`SpawnSyncOptions` + `reject?: boolean`.
-  - `stdio` 기본 `"pipe"`. pipe 인 스트림만 캡처되며 비-pipe 스트림은 결과 문자열이 빈 문자열.
-  - `env`: `process.env` 와 병합되어 자식에 전달.
-  - `reject` (기본 `true`): exitCode≠0 일 때 `false` 면 결과 객체 반환, `true` 면 throw. 에러 메시지는 `Command failed (exit N): <cmd> <args>` + stderr/stdout 마지막 4000자.
-- `SpawnResult`: `{ stdout: string; stderr: string; exitCode: number }`. 종료 코드가 없고 시그널만 있으면 exitCode=1.
-
-### SpawnProcess
-
-`spawn()` 반환값. `PromiseLike<SpawnResult>`.
-
-- `pid: number | undefined` — 자식 PID.
-- `then / catch` — `SpawnResult` resolve 또는 에러 reject.
-- `kill(signal?): boolean` — 자식 프로세스에 시그널 전송.
-
-### resolveStdioPipe
-
-- `resolveStdioPipe(stdio): { stdout: boolean; stderr: boolean }` — `SpawnOptions["stdio"]` 가 각 스트림에 대해 pipe 인지 판정. 배열·`"pipe"`·`undefined` 모두 처리.
-
-### 예
-
-```ts
-import { cpx } from "@simplysm/core-node";
-const { stdout } = await cpx.spawn("git", ["rev-parse", "HEAD"]);
-const proc = cpx.spawn("node", ["server.js"], { reject: false });
-proc.kill("SIGTERM");
-```

package/claude/references/sd-simplysm14/apis/core-node/fs-watcher.md

@@ -1,42 +0,0 @@
-## @simplysm/core-node — FsWatcher
-
-Chokidar 기반 디렉토리/글로브 변경 감시. 짧은 시간 내 이벤트를 병합하여 콜백 1회로 묶고, Windows EPERM 시 자동 재시작.
-
-### 타입
-
-- `FsWatcherEvent = "add" | "addDir" | "change" | "unlink" | "unlinkDir"` — chokidar 원본 이벤트 그대로. 디렉토리/파일 add·unlink 구분.
-- `FsWatcherChangeInfo = { event: FsWatcherEvent; path: PosixPath }` — 콜백 인자 1건. `path` 는 POSIX 슬래시 정규화.
-
-### 생성
-
-```ts
-FsWatcher.watch(paths: string[], options?: ChokidarOptions): Promise<FsWatcher>
-```
-
-- `paths`: 감시 대상. 디렉토리 절대 경로 또는 glob 패턴 혼용 가능. glob 메타문자 이전까지를 실제 감시 base 로 추출 후 chokidar 에 전달.
-- `options`: chokidar `ChokidarOptions`. `ignoreInitial` 은 내부적으로 항상 `true` 로 override 되지만, 사용자가 `false` 로 명시한 경우 첫 `onChange` 콜백을 **빈 배열**로 1회 호출(초기 트리거 신호용, 실제 초기 목록은 X).
-- `ready` 대기 후 resolve. 초기화 에러 시 close 후 reject.
-
-### 메서드
-
-- `onChange(opt: { delay?: number }, cb: (changes: FsWatcherChangeInfo[]) => void | Promise<void>): this`
-  - `opt.delay`: 디바운스 ms. 마지막 이벤트로부터 이 시간 후 콜백 1회.
-  - 같은 파일에 대한 연속 이벤트 자동 병합: `add+change=add`, `add+unlink`=상쇄(제외), `addDir+unlinkDir`=상쇄, `unlink+add=add`, `unlink+change=change`, `unlinkDir+addDir=addDir`. 룩업 미스는 현재 이벤트로 덮어쓰기.
-  - 콜백은 감시 base 가 아닌 **`paths` 원본 glob 에 매칭되는 경로만** 통과 (minimatch, dot 포함).
-  - 다중 호출 가능. 각 호출마다 독립 debounce 큐 + handler 등록.
-- `close(): Promise<void>` — debounce 큐 dispose + chokidar close.
-
-### 자동 복구
-
-- 감시 디렉토리 소실로 EPERM 발생 시 최대 3회 / 1초 간격으로 watcher 재생성·핸들러 재등록. 성공 시 retry count 리셋, 초과 시 중단(error 로그).
-- native `fs.FSWatcher.prototype.emit` 를 모듈 로드 시 1회 패치: listener 0 + `error` 이벤트는 swallow (orphan error 로 인한 프로세스 종료 방지).
-
-### 예
-
-```ts
-const w = await FsWatcher.watch(["src/**/*.ts"]);
-w.onChange({ delay: 300 }, async (changes) => {
-  for (const { path, event } of changes) console.log(event, path);
-});
-// await w.close();
-```

package/claude/references/sd-simplysm14/apis/core-node/fsx.md

@@ -1,53 +0,0 @@
-## @simplysm/core-node — fsx
-
-`import { fsx } from "@simplysm/core-node"`. 모든 함수는 동기(`*Sync`) + 비동기 쌍 제공. 실패 시 경로 정보를 포함한 `SdError` throw.
-
-### 존재 확인 / 디렉토리
-
-- `existsSync(p) / exists(p): boolean | Promise<boolean>` — 파일·디렉토리 존재 여부.
-- `mkdirSync(p) / mkdir(p): void | Promise<void>` — 재귀 생성. 이미 있으면 무시.
-- `readdirSync(p) / readdir(p): string[]` — 자식 이름 배열(절대 경로 아님).
-
-### 삭제
-
-- `rmSync(p)` — 재귀+force. **재시도 없음**, 파일 잠금 시 즉시 실패.
-- `rm(p)` — 재귀+force, **최대 6회 / 500ms 간격 재시도**. 일시적 잠금 회피용.
-
-### 복사
-
-- `copySync(src, dst, filter?) / copy(src, dst, filter?)` — 재귀 복사.
-  - `src`: 원본 경로. 존재하지 않으면 no-op.
-  - `dst`: 대상 경로. 상위 디렉토리 자동 생성.
-  - `filter(absolutePath): boolean`: 하위 항목 1개에 대한 포함 여부. true=포함, false=제외. **최상위 src 는 적용 대상 아님**. 디렉토리에 false 반환 시 그 하위 전체 스킵.
-  - 파일 복사 실패 시 최대 6회 / 500ms 재시도.
-
-### 읽기 / 쓰기
-
-- `readSync(p) / read(p): string` — UTF-8 텍스트.
-- `readBytesSync(p) / readBytes(p): Uint8Array` — 바이너리.
-- `readJsonSync<T>(p) / readJson<T>(p): T` — `@simplysm/core-common` 의 `json.parse` 사용. 파싱 실패 시 본문 앞 500자 미리보기 포함 에러.
-- `writeSync(p, data) / write(p, data)` — `data: string | Uint8Array`. 상위 디렉토리 자동 생성, `flush: true`.
-- `writeJsonSync(p, data, opts?) / writeJson(p, data, opts?)` — `opts.replacer`: JSON.stringify 와 동일한 replacer. `opts.space`: 들여쓰기(숫자=스페이스 수, 문자열=리터럴).
-
-### Stats
-
-- `statSync / stat` — `fs.Stats`. 심볼릭 링크 따라감.
-- `lstatSync / lstat` — `fs.Stats`. 심볼릭 링크 안 따라감 (링크 자체 정보).
-
-### Glob
-
-- `globSync(pattern, options?) / glob(pattern, options?): string[]` — `glob` 패키지 래핑. 패턴 내 백슬래시는 슬래시로 치환 후 호출. 결과는 **항상 절대 경로**로 정규화.
-- `options`: `glob` 패키지의 `GlobOptions`(예: `dot: true` 로 dotfile 포함).
-
-### 트리 유틸
-
-- `clearEmptyDirectory(dirPath)` — 하위까지 재귀 순회, 파일이 없는 디렉토리만 삭제. 파일이 하나라도 있으면 보존.
-- `findAllParentChildPathsSync(childGlob, fromPath, rootPath?) / findAllParentChildPaths(...)` — `fromPath` 부터 루트 방향으로 부모 디렉토리를 따라가며 각 디렉토리에서 `childGlob` 패턴 매칭 파일을 수집. `rootPath` 도달 시 종료(지정 없으면 FS 루트까지). 모노레포 루트 탐색 등에 사용.
-
-### 예
-
-```ts
-import { fsx } from "@simplysm/core-node";
-await fsx.copy("src", "dist", (p) => !p.includes("node_modules"));
-const cfg = await fsx.readJson<{ name: string }>("package.json");
-```

package/claude/references/sd-simplysm14/apis/core-node/pathx.md

@@ -1,24 +0,0 @@
-## @simplysm/core-node — pathx
-
-`import { pathx } from "@simplysm/core-node"`. POSIX 슬래시 경로 정규화·비교·필터링.
-
-### 타입
-
-- `PosixPath` — `string & { [POSIX]: never }` 브랜드 타입. `posix()` / `posixResolve()` 만 생성 가능. 글로브·minimatch·URL 호환 경로 표현용.
-
-### 함수
-
-- `posix(p): PosixPath` — 백슬래시→슬래시 치환만. resolve 안 함.
-- `posixResolve(...args): PosixPath` — `path.resolve(...args)` 후 슬래시 치환. 절대 경로 보장.
-- `changeFileDirectory(filePath, fromDirectory, toDirectory): string` — `filePath` 의 디렉토리 prefix 를 `fromDirectory`→`toDirectory` 로 갈아끼움. `filePath === fromDirectory` 면 `toDirectory` 반환. `filePath` 가 `fromDirectory` 하위가 아니면 `ArgumentError` throw.
-- `basenameWithoutExt(filePath): string` — 마지막 확장자 1개 제거한 basename. `"a.spec.ts"` → `"a.spec"`.
-- `isChildPath(childPath, parentPath): boolean` — `child` 가 `parent` **엄격 하위**인지 (동일 경로면 false). 내부적으로 `posixResolve` 정규화 후 `parent + "/"` prefix 매칭.
-- `filterByTargets(files, targets, cwd): string[]` — `files`(cwd 하위 절대 경로 배열)에서 `targets`(cwd 기준 상대 POSIX 경로) 와 일치 또는 하위 항목만 통과. `targets` 가 빈 배열이면 `files` 그대로 반환. sd-cli 의 `-t` 옵션 처리에 사용.
-
-### 예
-
-```ts
-import { pathx } from "@simplysm/core-node";
-const out = pathx.changeFileDirectory("/proj/src/a.ts", "/proj/src", "/proj/dist"); // /proj/dist/a.ts
-pathx.isChildPath("/a/b/c", "/a/b"); // true
-```

package/claude/references/sd-simplysm14/apis/core-node/worker.md

@@ -1,65 +0,0 @@
-## @simplysm/core-node — Worker
-
-타입 안전한 `worker_threads` 래퍼. 메인에서는 `Worker.create()` 로 프록시 호출, 워커에서는 `createWorker()` 로 메서드·이벤트 노출.
-
-### 워커 스크립트 — `createWorker`
-
-```ts
-createWorker<TMethods, TEvents = Record<string, never>>(methods: TMethods): {
-  send<K extends keyof TEvents & string>(event: K, data?: TEvents[K]): void;
-  __methods: TMethods;
-  __events: TEvents;
-}
-```
-
-- `methods`: 워커가 제공할 메서드 맵. 각 값은 동기/비동기 함수. 동기 반환도 메인에서는 Promise 로 받음.
-- `TEvents`: 메인으로 발행할 이벤트 시그니처(`{ eventName: payloadType }`).
-- 반환 객체의 `send(event, data?)` 로 메인에 이벤트 push. `__methods`/`__events` 는 타입 추론 전용(런타임 미사용).
-- `parentPort` 없으면 throw (반드시 worker thread 에서 import).
-- `process.stdout.write` 를 가로채 메인의 stdout 으로 전달(worker thread 의 stdout 미전달 한계 우회).
-- 메서드 처리 중 throw → `Error` 직렬화되어 메인 호출 Promise reject.
-
-워커 파일은 반드시 `export default createWorker(...)` 형태로 export.
-
-### 메인 — `Worker.create`
-
-```ts
-Worker.create<TModule extends WorkerModule>(
-  filePath: string,
-  opt?: Omit<WorkerOptions, "stdout" | "stderr">,
-): WorkerProxy<TModule>
-```
-
-- `TModule`: 워커 파일의 `typeof import("./worker")`. 메서드 시그니처·이벤트 타입 추론 소스.
-- `filePath`: 워커 파일 경로. `file://` URL 또는 절대 경로 모두 허용.
-- `opt`: Node `WorkerOptions` 중 `stdout/stderr` 제외(고정 `true`). `env` 는 `process.env` 와 병합. `argv` 는 dev 모드에서 워커 경로 뒤에 추가.
-- 개발(`import.meta.filename` 이 `.ts`) → 내부 `worker-dev-proxy.js` 를 워커로 띄우고 tsx 로 사용자 워커 동적 로드. 프로덕션(`.js`) → 사용자 파일 직접 실행.
-- 워커 stdout/stderr 는 메인 프로세스로 파이프.
-
-### 반환 프록시 — `WorkerProxy<TModule>`
-
-- `methods` (스프레드된 키): 각 메서드 → `(...args) => Promise<Awaited<R>>`. 매 호출마다 UUID 부여, `@simplysm/core-common` 의 `transfer.encode` 로 직렬화하여 `postMessage`.
-- `on(event, listener)` / `off(event, listener)` — 워커가 `send()` 로 발행한 이벤트 구독/해제.
-- `terminate(): Promise<void>` — 대기 중인 모든 요청을 reject 후 워커 종료.
-
-### 비정상 종료
-
-- 워커 `exit` (코드≠0, 사용자 terminate 아님) 또는 `error` 발생 시 대기 중인 모든 호출이 `Error("워커가 비정상 종료되었습니다 (코드: N) (method: X)")` 등으로 reject.
-
-### 예
-
-```ts
-// worker.ts
-import { createWorker } from "@simplysm/core-node";
-interface E { progress: number }
-const methods = { calc: (n: number) => n * 2 };
-const sender = createWorker<typeof methods, E>(methods);
-export default sender;
-
-// main.ts
-import { Worker } from "@simplysm/core-node";
-const w = Worker.create<typeof import("./worker")>("./worker.ts");
-w.on("progress", (p) => console.log(p));
-console.log(await w.calc(21)); // 42
-await w.terminate();
-```