@simplysm/sd-claude 14.0.46 → 14.0.48

package/claude/references/sd-simplysm14/core-common/usage.md

@@ -1,255 +0,0 @@
-# @simplysm/core-common
-
-브라우저와 Node.js 모두에서 사용 가능한 순수 공통 유틸리티 패키지. 다른 `@simplysm/*` 패키지에 대한 내부 의존성이 없는 리프 패키지다.
-
-## Installation
-
-```bash
-npm install @simplysm/core-common
-```
-
-## API Overview
-
-### Errors
-
-| API | Type | Description |
-|-----|------|-------------|
-| `SdError` | class | 트리 구조 에러 체인 지원. 메시지를 역순으로 결합 (상위 => 하위 => 원인) |
-| `ArgumentError` | class | 인자 유효성 오류. 인자 객체를 YAML 형식으로 메시지에 포함 |
-| `NotImplementedError` | class | 미구현 기능 호출 시 발생 |
-| `TimeoutError` | class | 대기 시간 초과 시 발생 (시도 횟수 포함) |
-
-→ See [docs/errors.md](./docs/errors.md) for details.
-
-### Types (Value Objects)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `DateTime` | class | 불변 날짜시간 (밀리초 정밀도, 로컬 타임존) |
-| `DateOnly` | class | 불변 날짜 (시간 제외, 주차 계산 지원) |
-| `Time` | class | 불변 시간 (24시간 순환, 날짜 제외) |
-| `Uuid` | class | UUID v4 (crypto.getRandomValues 기반) |
-| `LazyGcMap<TKey, TValue>` | class | 자동 만료 기능이 있는 LRU Map |
-
-→ See [docs/types.md](./docs/types.md) for details.
-
-### Features
-
-| API | Type | Description |
-|-----|------|-------------|
-| `EventEmitter<TEvents>` | class | 타입 안전 EventEmitter (EventTarget 기반, 브라우저/Node.js 모두 지원) |
-| `DebounceQueue` | class | 비동기 디바운스 큐 (짧은 시간 내 다수 호출 시 마지막만 실행) |
-| `SerialQueue` | class | 비동기 직렬 큐 (순차 실행 보장) |
-
-→ See [docs/features.md](./docs/features.md) for details.
-
-### Extensions (Prototype)
-
-Array, Map, Set 프로토타입 확장이 자동 등록됨 (side-effect import):
-
-| API | Type | Description |
-|-----|------|-------------|
-| **Array Methods (Immutable)** | | `single`, `first`, `last`, `filterExists`, `ofType`, `groupBy`, `toMap`, `toMapAsync`, `toArrayMap`, `toSetMap`, `toMapValues`, `toObject`, `toTree`, `distinct`, `orderBy`, `orderByDesc`, `diffs`, `oneWayDiffs`, `merge`, `sum`, `min`, `max`, `shuffle`, `mapAsync`, `filterAsync`, `mapMany`, `mapManyAsync`, `parallelAsync` |
-| **Array Methods (Mutable)** | | `remove`, `insert`, `toggle`, `clear`, `distinctThis`, `orderByThis`, `orderByDescThis` |
-| **Map Extensions** | | `getOrCreate`, `update` |
-| **Set Extensions** | | `adds`, `toggle` |
-| `ArrayDiffsResult<T, P>` | type | diffs() 결과 타입 (INSERT/DELETE/UPDATE) |
-| `ArrayOneWayDiffResult<T>` | type | oneWayDiffs() 결과 타입 (create/update/same) |
-| `TreeArray<T>` | type | toTree() 결과 타입 (children 속성 추가) |
-| `ComparableType` | type | 정렬/비교 가능한 타입 union |
-
-→ See [docs/extensions.md](./docs/extensions.md) for details.
-
-### Environment
-
-| API | Type | Description |
-|-----|------|-------------|
-| `env` | function | 환경변수 get/set. `env(key)` 읽기, `env(key, value)` 쓰기 |
-| `parseBoolEnv` | function | 환경변수 값을 boolean으로 파싱 ("true"/"1"/"yes"/"on" -> true) |
-
-### Utils (Namespace Imports)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `obj` | namespace | clone, equal, merge, merge3, omit, omitByFilter, pick, getChainValue, getChainValueByDepth, setChainValue, deleteChainValue, clearUndefined, clear, nullToUndefined, unflatten, keys, entries, fromEntries, map |
-| `str` | namespace | getKoreanSuffix, replaceFullWidth, toPascalCase, toCamelCase, toKebabCase, toSnakeCase, isNullOrEmpty, insert |
-| `num` | namespace | parseInt, parseFloat, parseRoundedInt, isNullOrEmpty, format |
-| `bytes` | namespace | concat, toHex, fromHex, toBase64, fromBase64 |
-| `path` | namespace | join, basename, extname |
-| `json` | namespace | stringify, parse |
-| `xml` | namespace | parse, stringify |
-| `wait` | namespace | until, time |
-| `transfer` | namespace | encode, decode |
-| `err` | namespace | message |
-| `dt` | namespace | format, normalizeMonth, convert12To24 |
-| `primitive` | namespace | typeStr |
-
-→ See [docs/utils.md](./docs/utils.md) for details.
-
-### Utils (Direct Exports)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `js` | function | JavaScript 코드 하이라이팅용 태그드 템플릿 리터럴 |
-| `ts` | function | TypeScript 코드 하이라이팅용 태그드 템플릿 리터럴 |
-| `html` | function | HTML 마크업 하이라이팅용 태그드 템플릿 리터럴 |
-| `tsql` | function | MSSQL T-SQL 하이라이팅용 태그드 템플릿 리터럴 |
-| `mysql` | function | MySQL SQL 하이라이팅용 태그드 템플릿 리터럴 |
-| `pgsql` | function | PostgreSQL SQL 하이라이팅용 태그드 템플릿 리터럴 |
-| `ZipArchive` | class | ZIP 파일 읽기/쓰기/압축/해제 (캐싱, 진행률 콜백 지원) |
-| `ZipArchiveProgress` | interface | ZipArchive 진행률 콜백 데이터 |
-
-### Type Utilities
-
-| API | Type | Description |
-|-----|------|-------------|
-| `Bytes` | type | `Uint8Array` 별칭 (Buffer 대신 사용) |
-| `PrimitiveTypeMap` | type | 원시 타입 문자열 key -> 타입 매핑 |
-| `PrimitiveTypeStr` | type | 원시 타입 문자열 key union (`"string" \| "number" \| ...`) |
-| `PrimitiveType` | type | 원시 타입 union (`string \| number \| boolean \| DateTime \| ...`) |
-| `DeepPartial<T>` | type | 모든 속성을 재귀적으로 optional로 변환 |
-| `Type<T>` | interface | 생성자 타입 (`new (...args) => T`) |
-| `EqualOptions` | interface | obj.equal() 옵션 |
-| `MergeOptions` | interface | obj.merge() 옵션 |
-| `Merge3KeyOptions` | interface | obj.merge3() key 옵션 |
-| `DtNormalizedMonth` | interface | dt.normalizeMonth() 결과 타입 |
-| `UndefToOptional<T>` | type | undefined 타입을 optional로 변환 |
-| `OptionalToUndef<T>` | type | optional 속성을 undefined 포함 타입으로 변환 |
-
-→ See [docs/utils.md](./docs/utils.md) for details.
-
-## Usage Examples
-
-### 프로토타입 확장 사용
-
-```typescript
-import "@simplysm/core-common";
-
-// Array 확장
-const users = [{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }];
-const user = users.single((u) => u.id === 1);
-const grouped = users.groupBy((u) => u.name);
-const sorted = users.orderBy((u) => u.name);
-const diffs = newUsers.diffs(oldUsers, { keys: ["id"] });
-
-// Map 확장
-const cache = new Map<string, number[]>();
-const arr = cache.getOrCreate("key", []);
-
-// Set 확장
-const set = new Set<string>();
-set.adds("a", "b", "c"); // 여러 항목 추가
-```
-
-### 에러 체인 처리
-
-```typescript
-import { SdError } from "@simplysm/core-common";
-
-try {
-  await fetch(url);
-} catch (err) {
-  throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
-  // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
-}
-```
-
-### 네임스페이스 유틸리티 사용
-
-```typescript
-import { obj, str, json, DateTime, Uuid } from "@simplysm/core-common";
-
-// 깊은 복사 및 비교
-const copied = obj.clone({ nested: { data: [1, 2, 3] } });
-const isEqual = obj.equal(a, b, { topLevelExcludes: ["updatedAt"] });
-const merged = obj.merge(defaults, overrides);
-
-// obj.omit, obj.pick
-const noId = obj.omit(user, ["id"]);
-const onlyName = obj.pick(user, ["name", "email"]);
-
-// 한국어 조사 처리
-const suffix = str.getKoreanSuffix("파일", "을"); // "을"
-const camel = str.toCamelCase("HelloWorld"); // "helloWorld"
-
-// 커스텀 타입 지원 JSON 직렬화
-const serialized = json.stringify({
-  date: new DateTime(),
-  id: Uuid.generate()
-});
-const restored = json.parse(serialized); // DateTime, Uuid 타입 복원됨
-```
-
-### 비동기 큐 사용
-
-```typescript
-import { DebounceQueue, SerialQueue } from "@simplysm/core-common";
-
-// 디바운스 큐: 짧은 시간 내 재호출 시 이전 호출 무시
-const dq = new DebounceQueue(300);
-dq.on("error", (err) => console.error(err));
-dq.run(() => saveData());
-dq.run(() => saveData()); // 첫 번째 호출 무시, 300ms 후 마지막만 실행
-
-// 직렬 큐: 순차 실행
-const sq = new SerialQueue();
-sq.run(async () => await step1());
-sq.run(async () => await step2()); // step1 완료 후 실행
-sq.run(async () => await step3()); // step2 완료 후 실행
-```
-
-### DateTime 사용
-
-```typescript
-import { DateTime, DateOnly, Time, Uuid } from "@simplysm/core-common";
-
-const now = new DateTime();
-const specific = new DateTime(2025, 1, 15, 10, 30, 0);
-const parsed = DateTime.parse("2025-01-15 10:30:00");
-const formatted = now.toFormatString("yyyy-MM-dd HH:mm:ss");
-const today = new DateOnly();
-const id = Uuid.generate();
-```
-
-### 자동 만료 Map 사용
-
-```typescript
-import { LazyGcMap } from "@simplysm/core-common";
-
-const cache = new LazyGcMap<string, Data>({
-  expireTime: 60_000,
-  onExpire: async (key, value) => {
-    await value.cleanup();
-  },
-});
-try {
-  cache.set("key", data);
-  const val = cache.get("key"); // 접근 시간 갱신
-} finally {
-  cache.dispose();
-}
-```
-
-### EventEmitter 사용
-
-```typescript
-import { EventEmitter } from "@simplysm/core-common";
-
-interface MyEvents {
-  data: string;
-  error: Error;
-  done: void;
-}
-
-class MyService extends EventEmitter<MyEvents> {
-  async load() {
-    this.emit("data", "Loading...");
-    this.emit("done"); // void 타입은 인자 없이 호출
-  }
-}
-
-const svc = new MyService();
-svc.on("data", (data) => console.log(data)); // data: string
-svc.on("done", () => console.log("completed"));
-await svc.load();
-```

package/claude/references/sd-simplysm14/core-node/docs/child-process.md

@@ -1,182 +0,0 @@
-# Child Process (cpx)
-
-## `spawn`
-
-자식 프로세스를 실행한다 (비동기).
-
-SpawnProcess를 반환하며, await로 결과를 기다리거나 kill()로 프로세스를 종료할 수 있다.
-
-```typescript
-export function spawn(
-  cmd: string,
-  args: string[],
-  options?: SpawnOptions & { reject?: boolean },
-): SpawnProcess
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `cmd` | string | 실행할 명령어 |
-| `args` | string[] | 명령어 인자 배열 |
-| `options` | SpawnOptions & { reject?: boolean } (optional) | spawn 옵션. `reject: false`를 지정하면 exitCode !== 0일 때도 reject되지 않음 (기본값: true) |
-
-**Return**: SpawnProcess (PromiseLike + kill() 메서드)
-
-**Note**: 기본적으로 `exitCode !== 0`이면 reject된다. `options.reject: false`를 지정하면 항상 resolve된다.
-
----
-
-## `spawnSync`
-
-자식 프로세스를 동기로 실행한다.
-
-```typescript
-export function spawnSync(
-  cmd: string,
-  args: string[],
-  options?: SpawnSyncOptions & { reject?: boolean },
-): SpawnResult
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `cmd` | string | 실행할 명령어 |
-| `args` | string[] | 명령어 인자 배열 |
-| `options` | SpawnSyncOptions & { reject?: boolean } (optional) | spawn 옵션. `reject: false`를 지정하면 exitCode !== 0일 때도 throw되지 않음 (기본값: true) |
-
-**Return**: SpawnResult
-
-**Note**: 기본적으로 `exitCode !== 0`이면 throw된다. `options.reject: false`를 지정하면 항상 반환된다.
-
----
-
-## `SpawnProcess`
-
-spawn() 반환 타입. PromiseLike를 구현하므로 await로 사용 가능하며, kill() 메서드로 프로세스를 종료할 수 있다.
-
-```typescript
-export class SpawnProcess implements PromiseLike<SpawnResult> {
-  get pid(): number | undefined
-  then<TResult1 = SpawnResult, TResult2 = never>(
-    onfulfilled?: ((value: SpawnResult) => TResult1 | PromiseLike<TResult1>) | null,
-    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,
-  ): Promise<TResult1 | TResult2>
-  catch<TResult = never>(
-    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
-  ): Promise<SpawnResult | TResult>
-  kill(signal?: NodeJS.Signals | number): boolean
-}
-```
-
-### Properties
-
-| Name | Type | Description |
-|------|------|-------------|
-| `pid` | number \| undefined | 자식 프로세스의 PID |
-
-### Methods
-
-| Name | Signature | Description |
-|------|-----------|-------------|
-| `then` | `<TResult1, TResult2>(onfulfilled?, onrejected?): Promise` | Promise의 then 메서드 |
-| `catch` | `<TResult>(onrejected?): Promise` | Promise의 catch 메서드 |
-| `kill` | `(signal?): boolean` | 프로세스에 신호를 보낸다 (기본값: SIGTERM) |
-
----
-
-## `SpawnResult`
-
-spawn/spawnSync 결과.
-
-```typescript
-export interface SpawnResult {
-  stdout: string;
-  stderr: string;
-  exitCode: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `stdout` | string | 표준 출력 내용 |
-| `stderr` | string | 표준 에러 내용 |
-| `exitCode` | number | 프로세스 종료 코드 |
-
----
-
-## `getSystemEncoding`
-
-시스템의 기본 인코딩을 감지한다.
-
-```typescript
-export function getSystemEncoding(): string
-```
-
-**Return**: 시스템 인코딩 (예: "utf-8", "euc-kr")
-
-**Note**: 결과는 캐시되므로 반복 호출은 빠르다. 캐시를 초기화하려면 resetEncodingCache()를 호출한다.
-
----
-
-## `codePageToEncoding`
-
-Windows 코드 페이지 번호를 인코딩 이름으로 변환한다.
-
-```typescript
-export function codePageToEncoding(codePage: number): string
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `codePage` | number | Windows 코드 페이지 번호 (예: 65001 = UTF-8, 949 = EUC-KR) |
-
-**Return**: 인코딩 이름 (예: "utf-8"). 미지의 코드 페이지는 "utf-8"으로 폴백된다.
-
----
-
-## `resetEncodingCache`
-
-캐시된 시스템 인코딩을 초기화한다.
-
-```typescript
-export function resetEncodingCache(): void
-```
-
----
-
-## `decodeBytes`
-
-Uint8Array를 문자열로 디코딩한다.
-
-```typescript
-export function decodeBytes(raw: Uint8Array, systemEncoding?: string): string
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `raw` | Uint8Array | 디코딩할 바이트 배열 |
-| `systemEncoding` | string (optional) | 인코딩 이름. 생략하면 getSystemEncoding()의 결과를 사용한다. |
-
-**Return**: 디코딩된 문자열
-
-**Note**: UTF-8이 아닌 인코딩인 경우, 먼저 UTF-8로 디코딩을 시도하고 실패하면 지정된 인코딩으로 시도한다.
-
----
-
-## `resolveStdioPipe`
-
-stdio 옵션에서 stdout/stderr의 pipe 여부를 추출한다.
-
-```typescript
-export function resolveStdioPipe(
-  stdio: SpawnOptions["stdio"],
-): { stdout: boolean; stderr: boolean }
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `stdio` | SpawnOptions["stdio"] | spawn 옵션의 stdio 설정 |
-
-**Return**: `{ stdout: boolean, stderr: boolean }` - 각 스트림이 pipe인지 여부
-
-**Note**: stdio가 배열이 아니면, "pipe"(또는 undefined)일 때 true, 그 외엔 false를 반환한다.

package/claude/references/sd-simplysm14/core-node/docs/features.md

@@ -1,214 +0,0 @@
-# Features
-
-파일 시스템 감시와 consola 로깅 설정 기능을 제공한다.
-
----
-
-## `FsWatcherEvent`
-
-지원되는 파일 변경 이벤트 타입.
-
-```typescript
-export type FsWatcherEvent = "add" | "addDir" | "change" | "unlink" | "unlinkDir";
-```
-
-| Value | Description |
-|-------|-------------|
-| `"add"` | 파일 추가 |
-| `"addDir"` | 디렉토리 추가 |
-| `"change"` | 파일 수정 |
-| `"unlink"` | 파일 삭제 |
-| `"unlinkDir"` | 디렉토리 삭제 |
-
----
-
-## `FsWatcherChangeInfo`
-
-파일 변경 정보.
-
-```typescript
-export interface FsWatcherChangeInfo {
-  event: FsWatcherEvent;
-  path: PosixPath;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `event` | `FsWatcherEvent` | 변경 이벤트 타입 |
-| `path` | `PosixPath` | 변경된 파일/디렉토리 경로 (정규화됨) |
-
----
-
-## `FsWatcher`
-
-Chokidar 기반 파일 시스템 감시 래퍼. 짧은 시간 내에 발생하는 이벤트를 병합하여 콜백을 한 번만 호출한다. EPERM 에러 발생 시 최대 3회 watcher를 자동 재시작한다.
-
-**주의**: chokidar의 `ignoreInitial` 옵션은 내부적으로 항상 `true`로 설정된다.
-
-```typescript
-export class FsWatcher {
-  static async watch(paths: string[], options?: chokidar.ChokidarOptions): Promise<FsWatcher>;
-  onChange(opt: { delay?: number }, cb: (changeInfos: FsWatcherChangeInfo[]) => void | Promise<void>): this;
-  async close(): Promise<void>;
-}
-```
-
-### `FsWatcher.watch` (static)
-
-파일 감시를 시작한다 (비동기). ready 이벤트가 발생할 때까지 대기한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `paths` | `string[]` | 감시할 파일/디렉토리 경로 또는 glob 패턴 배열 |
-| `options` | `chokidar.ChokidarOptions` | chokidar 옵션 |
-
-### `onChange`
-
-파일 변경 이벤트 핸들러를 등록한다. 지정된 지연 시간 동안 이벤트를 수집하여 콜백을 한 번 호출한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `opt.delay` | `number` | 이벤트 병합 대기 시간 (ms) |
-| `cb` | `(changeInfos: FsWatcherChangeInfo[]) => void \| Promise<void>` | 변경 이벤트 콜백 |
-
-**반환**: `this` (메서드 체이닝 가능)
-
-이벤트 병합 전략:
-- `add` + `change` → `add` (생성 직후 수정은 생성으로 간주)
-- `add` + `unlink` → 변경 없음 (생성 직후 삭제는 변경 없음으로 간주)
-- `unlink` + `add` → `add` (삭제 후 재생성은 생성으로 간주)
-
-### `close`
-
-파일 감시자를 종료한다.
-
-```typescript
-import { FsWatcher } from "@simplysm/core-node";
-
-const watcher = await FsWatcher.watch(["src/**/*.ts"]);
-
-watcher.onChange({ delay: 300 }, (changes) => {
-  for (const { event, path } of changes) {
-    // event: "add" | "addDir" | "change" | "unlink" | "unlinkDir"
-    // path: PosixPath
-  }
-});
-
-await watcher.close();
-```
-
----
-
-## `PrettyReporter`
-
-터미널 출력용 consola reporter. 이벤트 타입별 아이콘과 색상을 적용하고, Error 객체의 스택 트레이스를 포맷팅한다.
-
-```typescript
-export class PrettyReporter implements ConsolaReporter {
-  log(logObj: LogObject, ctx: { options: ConsolaOptions }): void;
-}
-```
-
-- error/fatal 레벨은 `process.stderr`로 출력
-- 그 외는 `process.stdout`으로 출력
-- 터미널 색상 지원 여부를 자동 감지 (`NO_COLOR`, `FORCE_COLOR`, `isTTY`, Windows 감지)
-
----
-
-## `FileReporterOptions`
-
-`createFileReporter()`의 옵션.
-
-```typescript
-export interface FileReporterOptions {
-  maxSize?: number;
-  maxDays?: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `maxSize` | `number` | 단일 로그 파일 최대 크기 (bytes). 기본값 20MB (20 \* 1024 \* 1024) |
-| `maxDays` | `number` | 보관할 로그 파일 최대 일수. 기본값 14일 |
-
----
-
-## `createFileReporter`
-
-파일 기반 consola reporter를 생성한다. `.logs/` 디렉토리에 `app.YYYY-MM-DD.log` 형식으로 JSON 라인을 기록한다.
-
-```typescript
-export function createFileReporter(options?: FileReporterOptions): ConsolaReporter
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `options` | `FileReporterOptions` | 로그 파일 옵션 |
-
-**동작 방식**:
-- 날짜가 바뀌면 새 파일로 로테이션
-- 파일 크기가 `maxSize`를 초과하면 `app.YYYY-MM-DD.1.log`, `app.YYYY-MM-DD.2.log` 형식으로 순번 추가
-- `maxDays`보다 오래된 파일은 자동 삭제
-- 각 로그 항목은 `{ time, level, tag?, msg?, err? }` JSON 형식
-
----
-
-## `withMaxLevel`
-
-consola reporter를 지정된 로그 레벨 이하로 제한하는 래퍼를 반환한다.
-
-```typescript
-export function withMaxLevel(reporter: ConsolaReporter, maxLevel: number): ConsolaReporter
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `reporter` | `ConsolaReporter` | 감쌀 reporter |
-| `maxLevel` | `number` | 이 값보다 높은 레벨의 로그는 전달하지 않는다 |
-
-consola의 로그 레벨: `0=fatal`, `1=error`, `2=warn`, `3=log`, `4=info`, `5=success`, `999=debug`
-
----
-
-## `SetupConsolaOptions`
-
-`setupConsola()`의 옵션.
-
-```typescript
-export interface SetupConsolaOptions {
-  cli?: boolean;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `cli` | `boolean` | true이면 CLI 모드. 프로덕션 경로를 건너뛰고 개발 경로로 진입한다. `SD_DEBUG`가 없으면 `FileReporter` + `PrettyReporter`(info 이하) 조합 사용 |
-
----
-
-## `setupConsola`
-
-환경에 따라 consola reporter를 자동 구성한다.
-
-```typescript
-export function setupConsola(opts?: SetupConsolaOptions): void
-```
-
-환경별 동작:
-
-| 환경 | 동작 |
-|------|------|
-| 프로덕션 (`DEV` 환경변수 없음, `cli` 아님) | `FileReporter`만 사용, debug 레벨까지 파일 기록 |
-| 개발 또는 `cli: true`, `SD_DEBUG=true` | `PrettyReporter`만 사용, debug 레벨까지 터미널 출력 |
-| 개발 또는 `cli: true` (일반) | `FileReporter` + `PrettyReporter`(info 이하만), debug는 파일에만 기록 |
-
-```typescript
-import { setupConsola } from "@simplysm/core-node";
-
-// 환경별 자동 구성
-setupConsola();
-
-// CLI 모드 (항상 PrettyReporter 사용)
-setupConsola({ cli: true });
-```