@simplysm/sd-claude 14.0.82 → 14.0.84

package/claude/references/sd-simplysm14/apis/orm-common/queryable.md

@@ -1,98 +0,0 @@
-# @simplysm/orm-common — Queryable
-
-체이닝 SELECT/INSERT/UPDATE/DELETE/UPSERT 빌더. `DbContext.queryable(builder)` 가 만든 팩토리 호출(`db.user()`)마다 새 alias 가 할당된 새 `Queryable` 이 반환된다. 모든 체이닝 메서드는 새 인스턴스를 반환(immutable).
-
-```ts
-class Queryable<TData extends DataRecord, TFrom extends TableBuilder | never>
-```
-- `TData` — 결과 row 타입 (관계 include 포함).
-- `TFrom` — CUD(INSERT/UPDATE/DELETE/UPSERT) 시 필요한 원본 TableBuilder. `select`/`join`/`union`/`wrap`/`groupBy`/`recursive`/`distinct` 한 후엔 `never` 가 되어 CUD 불가.
-
-## 옵션 체이닝
-
-- `.select(fn: cols => mapped)` — SELECT 컬럼/표현식 재구성. 원시 리터럴은 자동 `ExprUnit` 으로 래핑. → `Queryable<UnwrapQueryableRecord<R>, never>`.
-- `.distinct()` — DISTINCT.
-- `.lock()` — FOR UPDATE.
-- `.top(n)` — TOP N (ORDER BY 무관).
-- `.limit(skip, take)` — `orderBy` 필수, 없으면 throw.
-- `.orderBy(fn | "key.path", "ASC" | "DESC"?)` — 누적. 문자열 overload 는 `obj.getChainValue` 로 컬럼 검색 (동적 정렬용).
-- `.where(predicate: cols => WhereExprUnit[])` — 누적, AND 결합.
-- `.search(cols => ExprUnit<string|undefined>[], text)` — `parseSearchQuery` 의 OR/AND(`+`)/NOT(`-`)/`"…"`/`*` 구문을 컬럼들에 LIKE 로 적용 (소문자 비교).
-- `.groupBy(cols => ExprUnit[])` — `TFrom` → never.
-- `.having(predicate)` — GROUP BY 후 필터, 누적 AND.
-
-## JOIN / INCLUDE
-
-```ts
-.join(as, (qr, cols) => Queryable)        // 1:N — { ..., [as]?: R[] }
-.joinSingle(as, (qr, cols) => Queryable)  // N:1 또는 1:1 — { ..., [as]?: R }
-.include(item => item.user.company)       // PathProxy 기반 자동 JOIN (TableBuilder 기반만)
-```
-
-- 콜백의 `qr: JoinQueryable` 은 `.from(table)` / `.select(customCols)` / `.union(...queries)` 제공.
-- `.include` 는 `TableBuilder.relations` 정의를 따라 FK/RelationKey(=joinSingle) 또는 FKT/RelationKeyTarget(=join, `single:true` 면 joinSingle) 으로 풀림. 동일 경로 중복 호출은 무시. 다단계(`a.b.c`)는 부모 객체 안으로 nested 됨.
-- PathProxy 는 ColumnPrimitive 필드 접근을 컴파일 에러로 막아 관계 키만 허용.
-
-## Subquery / UNION / Recursive CTE
-
-- `.wrap()` — 현재 Queryable 을 서브쿼리로 감싼 새 Queryable. `distinct()`/`groupBy()` 후 `count()` 직전에 필요.
-- `Queryable.union(q1, q2, ...)` (static) — UNION (중복 제거). 2개 미만 throw. 첫 query 의 컬럼 구조 사용.
-- `.recursive(fn: (cte: RecursiveQueryable<TData>) => Queryable<TData>)` — WITH RECURSIVE 생성. 콜백 안에서 `cte.from(table)` 한 결과에 `self` 프로퍼티(현재 CTE 자기 참조)가 부여됨. `.union(...)` 도 가능.
-
-## 실행 (SELECT)
-
-- `await qr.execute(): Promise<TData[]>`
-- `await qr.single(): Promise<TData | undefined>` — 2개 이상이면 throw.
-- `await qr.first(): Promise<TData | undefined>` — 내부 `top(1)`.
-- `await qr.count(fn?): Promise<number>` — `distinct`/`groupBy` 후 직접 호출시 throw → `wrap()` 필요.
-- `await qr.exists(): Promise<boolean>` — `top(1)` 으로 행 존재 확인.
-
-## CUD (TFrom = TableBuilder 필요)
-
-```ts
-await q.insert(records);
-const [{ id }] = await q.insert([{...}], ["id"]);             // OUTPUT
-
-await q.insertIfNotExists(record);                            // WHERE 조건과 결합
-await q.insertIfNotExists(record, ["id"]);                    // 단건 반환
-
-await q2.insertInto(TargetTable);                             // INSERT INTO ... SELECT
-await q2.insertInto(TargetTable, ["id"]);
-
-await q.update(cols => ({ name: expr.val("string", "x") }));
-await q.update(cols => ({...}), ["id"]);
-
-await q.delete();
-await q.delete(["id", "name"]);
-
-await q.upsert(updateFn);                                     // UPDATE 또는 INSERT (existsSelectQuery=현재 where)
-await q.upsert(updateFn, ["id"]);
-await q.upsert(updateFn, insertFn);
-await q.upsert(updateFn, insertFn, ["id"]);
-```
-
-- `insert(records)` 는 records 0건이면 noop. MSSQL 1000행 제한을 위해 청크 분할(`CHUNK_SIZE=1000`) — 각 청크는 별도 `executeDefs` 호출, OUTPUT 도 누적.
-- `insert` 의 records 에 autoIncrement 컬럼 값이 명시되면 자동으로 `overrideIdentity` 켜짐.
-- CUD 는 `TFrom` 이 `TableBuilder` 일 때만 — 아니면 `_getCudOutputDef` 에서 throw. ViewBuilder/Queryable 합성/Union 후엔 사용 불가.
-- `await q.switchFk(enabled)` — TableBuilder/ViewBuilder 기반에서 FK on/off (트랜잭션 내 사용 가능).
-
-## QueryDef 생성기 (실행 없이 def 만)
-
-`getSelectQueryDef()`, `getInsertQueryDef(records, output?)`, `getInsertIfNotExistsQueryDef(record, output?)`, `getInsertIntoQueryDef(target, output?)`, `getUpdateQueryDef(recordFwd, output?)`, `getDeleteQueryDef(output?)`, `getUpsertQueryDef(updateFn, insertFn, output?)`, `getResultMeta(outputColumns?)`.
-
-## 타입
-
-`QueryableRecord<TData>` — `TData` 의 원시 필드를 `ExprUnit<T>`, 중첩 객체/배열은 재귀로 감싼 형태. `where`/`select` 콜백 인자 타입.
-
-`QueryableWriteRecord<TData>` — `ExprInput<T>` (= `ExprUnit<T> | T`) 으로, `update`/`upsert` 의 record 값 입력 타입.
-
-`UnwrapQueryableRecord<R>` — `.select` 결과를 다시 DataRecord 로 역추론.
-
-`PathProxy<T>` — `.include` 인자 타입. 비-ColumnPrimitive 필드만 노출.
-
-## 보조 함수
-
-```ts
-queryable(db, tableOrView, as?)   // Queryable factory 생성. DbContext.queryable 의 내부 구현
-getMatchedPrimaryKeys(fkCols, targetTable)  // include 가 FK 컬럼과 대상 PK 매칭
-```

package/claude/references/sd-simplysm14/apis/orm-common/schema-builders.md

@@ -1,128 +0,0 @@
-# @simplysm/orm-common — Schema Builders
-
-테이블/뷰/프로시저를 fluent 로 정의하는 immutable 빌더. `DbContext` 의 `queryable()`/`executable()` 에 전달하여 등록한다. 모든 메서드는 `new Xxx({...this.meta, ...})` 형태로 새 인스턴스 반환.
-
-## Table / TableBuilder
-
-```ts
-import { Table } from "@simplysm/orm-common";
-
-const User = Table("User")            // Table<TName>(name)
-  .database("mydb")
-  .schema("dbo")                      // MSSQL/PostgreSQL only
-  .description("사용자")
-  .columns((c) => ({
-    id: c.bigint().autoIncrement(),
-    name: c.varchar(100),
-    email: c.varchar(200).nullable(),
-    status: c.varchar(20).default("active"),
-  }))
-  .primaryKey("id")                   // 복합: .primaryKey("a","b")
-  .indexes((i) => [i.index("email").unique()])
-  .relations((r) => ({
-    posts: r.foreignKeyTarget(() => Post, "author"),
-  }));
-```
-
-타입 추론 프로퍼티 (`readonly $xxx!` — 런타임 값 X, 타입 추출용):
-- `$inferSelect` — 컬럼 + (deep) 관계 (관계는 optional)
-- `$inferColumns` — 컬럼만
-- `$inferInsert` — `autoIncrement`/`nullable`/`default` 컬럼은 optional
-- `$inferUpdate` — 모든 필드 optional
-- `$columns`, `$relations` — 정의 자체
-
-`meta`: `{ name; description?; database?; schema?; columns?; primaryKey?; relations?; indexes? }`.
-
-## View / ViewBuilder
-
-```ts
-import { View } from "@simplysm/orm-common";
-
-const ActiveUsers = View("ActiveUsers")
-  .database("mydb")
-  .query((db: MainDb) =>
-    db.user().where(u => [expr.eq(u.status, "active")])
-       .select(u => ({ id: u.id, name: u.name })))
-  .relations(r => ({ posts: r.relationKeyTarget(() => Post, "author") }));
-```
-
-- `.query<TData>(viewFn: (db) => Queryable<TData>)` 의 viewFn 은 `queryable()` 호출시(=`createView` DDL 만들 때, `db.queryable(ViewBuilder)` 팩토리에서) 실행된다.
-- View 의 관계는 `relationKey`/`relationKeyTarget` 만 사용 (DB FK 미생성).
-- `$inferSelect: TData`.
-
-## Procedure / ProcedureBuilder
-
-```ts
-import { Procedure } from "@simplysm/orm-common";
-
-const GetUserById = Procedure("GetUserById")
-  .database("mydb")
-  .params(c => ({ userId: c.bigint() }))
-  .returns(c => ({ id: c.bigint(), name: c.varchar(100) }))
-  .body("SELECT id, name FROM User WHERE id = userId");
-// MSSQL 본문은 @userId 사용. PostgreSQL 은 RETURN QUERY 필요.
-```
-
-`$params`, `$returns` 타입 추론. `meta`: `{ name; description?; database?; schema?; params?; returns?; query? }`.
-
-## Column Factory (`columns((c) => ...)` 안에서 사용)
-
-`createColumnFactory()` 반환 객체의 메서드 — 모두 `ColumnBuilder<TValue, TMeta>` 반환:
-
-| 메서드 | TS 타입 | SQL 매핑 |
-|---|---|---|
-| `int()` | number | INT |
-| `bigint()` | number | BIGINT |
-| `float()` | number | FLOAT/REAL |
-| `double()` | number | DOUBLE |
-| `decimal(precision, scale?)` | number | DECIMAL(p,s) |
-| `varchar(length)` | string | VARCHAR(n) |
-| `char(length)` | string | CHAR(n) |
-| `text()` | string | TEXT/LONGTEXT |
-| `binary()` | Bytes | LONGBLOB/VARBINARY(MAX)/BYTEA |
-| `boolean()` | boolean | TINYINT(1)/BIT/BOOLEAN |
-| `datetime()` | DateTime | DATETIME |
-| `date()` | DateOnly | DATE |
-| `time()` | Time | TIME |
-| `uuid()` | Uuid | BINARY(16)/UNIQUEIDENTIFIER/UUID |
-
-`ColumnBuilder` 체이닝:
-- `.autoIncrement()` — INSERT 시 자동 증가, `$inferInsert` 에서 optional.
-- `.nullable()` — TS 타입에 `| undefined` 추가.
-- `.default(value)` — 기본값. `$inferInsert` 에서 optional.
-- `.description(text)` — DDL Comment.
-
-타입 유틸: `ColumnBuilderRecord`, `InferColumns<T>`, `InferColumnExprs<T>` (Executable params), `RequiredInsertKeys<T>`, `OptionalInsertKeys<T>`, `InferInsertColumns<T>`, `InferUpdateColumns<T>`, `DataToColumnBuilderRecord<TData>`.
-
-## Index Factory (`indexes((i) => ...)` 안에서)
-
-```ts
-i.index("email").unique()
-i.index("name", "createdAt").orderBy("ASC", "DESC")
-i.index("createdAt").name("IX_Foo")
-i.index("a").description("...")
-```
-
-`IndexBuilder<TKeys>` 의 `meta`: `{ columns; name?; unique?; orderBy?; description? }`.
-
-## Relation Factory (`relations((r) => ...)` 안에서)
-
-Table 은 4개 모두, View 는 `relationKey`/`relationKeyTarget` 만 노출.
-
-```ts
-// N:1
-r.foreignKey(["authorId"], () => User, { description?: string })       // DB FK 생성
-r.relationKey(["companyId"], () => Company, { description?: string })   // 논리 관계 (FK X) — View 가능
-
-// 1:N (기본) 또는 1:1 (single: true)
-r.foreignKeyTarget(() => Post, "author")
-r.foreignKeyTarget(() => Profile, "user", { single: true })
-r.relationKeyTarget(() => UserSummary, "company", { single?, description? })
-```
-
-- `foreignKey` 의 두 번째 인자는 *대상 테이블 factory* `() => TableBuilder` (순환 참조 회피).
-- `foreignKeyTarget` 의 두 번째 인자 `relationName` 은 대상 테이블에 정의된 자기방향 FK 의 키 이름.
-- 메서드 체이닝(`.description()`/`.single()`)은 TS 순환 참조 (TS7022) 회피용으로 *제거됨* — 옵션은 마지막 `opts` 객체로만 전달.
-- 빌더 클래스: `ForeignKeyBuilder`, `ForeignKeyTargetBuilder`, `RelationKeyBuilder`, `RelationKeyTargetBuilder`.
-
-타입 유틸: `RelationBuilderRecord`, `ExtractRelationTarget<T>`, `ExtractRelationTargetResult<T>`, `InferDeepRelations<TRelations>` — 모두 관계를 optional 로 추론, 같은 테이블 재방문 시 더 깊이 들어가지 않음 (순환 끊김).

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

@@ -1,69 +0,0 @@
-# @simplysm/orm-node
-
-Node.js 환경에서 `@simplysm/orm-common` 의 `DbContext` 를 실제 DB(MSSQL/MySQL/PostgreSQL)에 붙여 실행하기 위한 어댑터. 드라이버 모듈(`tedious`/`mysql2`/`pg`/`pg-copy-streams`)은 dialect 선택 시점에 지연 import.
-
-## 사용 트리거 인덱스
-
-- **`createOrm`** — `DbContext` 서브클래스 + `DbConnConfig` 로 ORM 인스턴스 생성. 일반 ORM 사용의 진입점.
-- **`Orm<T>`** — `createOrm` 반환 타입. 함수 시그니처·DI 토큰에서 참조하거나 `connect` / `connectWithoutTransaction` 호출 시.
-- **`OrmOptions`** — `createOrm` 3번째 인자. `DbConnConfig` 의 `database` / `schema` 를 런타임에 덮어쓸 때.
-- **`createDbConn`** — `DbConnConfig` 만으로 저수준 `DbConn` 인스턴스 직접 생성. `DbContext` 없이 raw SQL/bulk insert 가 필요할 때.
-- **`NodeDbContextExecutor`** — `DbContext` 의 executor 직접 주입이 필요할 때. 일반적으로는 `createOrm` 이 내부적으로 사용.
-- **`MysqlDbConn`** — MySQL 용 `DbConn` 구현 클래스. 직접 `new` 하지 말고 `createDbConn` 사용. 타입 참조용 import.
-- **`MssqlDbConn`** — MSSQL/Azure SQL 용 `DbConn` 구현 클래스. 직접 `new` 하지 말고 `createDbConn` 사용. 타입 참조용 import.
-- **`PostgresqlDbConn`** — PostgreSQL 용 `DbConn` 구현 클래스. 직접 `new` 하지 말고 `createDbConn` 사용. 타입 참조용 import.
-- **`DbConn`** — 저수준 연결 인터페이스. 모든 dialect 공통 메서드(`connect`/`close`/트랜잭션/`execute`/`executeParametrized`/`bulkInsert`) 와 `close` 이벤트.
-- **`DbConnConfig`** — dialect 분기 union 타입. `createOrm`/`createDbConn` 입력.
-- **`MysqlDbConnConfig`** — `dialect: "mysql"` 한정 설정 타입.
-- **`MssqlDbConnConfig`** — `dialect: "mssql" | "mssql-azure"` 설정 타입. `schema?` 포함.
-- **`PostgresqlDbConnConfig`** — `dialect: "postgresql"` 설정 타입. `schema?` 포함.
-- **`getDialectFromConfig`** — `DbConnConfig` → `Dialect` 변환(`mssql-azure` → `mssql`). 쿼리 빌더 선택 시.
-- **`DB_CONN_CONNECT_TIMEOUT`** — DB 연결 수립 타임아웃 상수 (10초).
-- **`DB_CONN_DEFAULT_TIMEOUT`** — 쿼리/유휴 기본 타임아웃 상수 (10분).
-- **`DB_CONN_ERRORS`** — `NOT_CONNECTED` / `ALREADY_CONNECTED` 에러 메시지 리터럴.
-
-## createOrm
-
-```ts
-function createOrm<T extends DbContext>(
-  DbClass: new (executor: DbContextExecutor, opt: { database: string; schema?: string }) => T,
-  config: DbConnConfig,
-  options?: OrmOptions, // { database?: string; schema?: string } — config 보다 우선
-): Orm<T>;
-
-interface Orm<T> {
-  connect<R>(cb: (db: T) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>; // 트랜잭션
-  connectWithoutTransaction<R>(cb: (db: T) => Promise<R>): Promise<R>;                 // 트랜잭션 없음
-}
-```
-
-`database` 가 `options` 와 `config` 양쪽 모두 없으면 throw. 매 `connect*` 호출마다 새 `DbContext` 인스턴스를 만들어 콜백 종료 시 연결을 닫는다.
-
-```ts
-const orm = createOrm(MyDb, { dialect: "mysql", host, port, username, password, database });
-await orm.connect(async (db) => db.user().execute());
-```
-
-## createDbConn
-
-```ts
-function createDbConn(config: DbConnConfig): Promise<DbConn>;
-```
-
-dialect 에 따라 드라이버 모듈을 lazy import 한 뒤 해당 `DbConn` 구현 반환. **반환된 객체는 미연결 상태** — 호출자가 `conn.connect()` → 사용 → `conn.close()` 까지 책임. `DbConn` 은 `EventEmitter<{ close: void }>` 이며 다음 메서드 제공: `connect`, `close`, `beginTransaction(isolationLevel?)`, `commitTransaction`, `rollbackTransaction`, `execute(queries: string[])`, `executeParametrized(query, params?)`, `bulkInsert(tableName, columnMetas, records)`. `bulkInsert` 는 dialect별 네이티브 경로 사용(MSSQL: tedious BulkLoad / MySQL: `LOAD DATA LOCAL INFILE` 임시파일 / PostgreSQL: `COPY FROM STDIN`).
-
-## DbConnConfig
-
-dialect 분기 union. 공통 필드: `host`, `port?`, `username`, `password`, `database?`, `defaultIsolationLevel?`.
-
-- `MysqlDbConnConfig` — `dialect: "mysql"`.
-- `MssqlDbConnConfig` — `dialect: "mssql" | "mssql-azure"`, `schema?`. `mssql-azure` 는 `encrypt: true` 로 연결.
-- `PostgresqlDbConnConfig` — `dialect: "postgresql"`, `schema?`.
-
-## NodeDbContextExecutor
-
-```ts
-new NodeDbContextExecutor(config: DbConnConfig)
-```
-
-`DbContextExecutor` 구현. `connect` 시 내부에서 `createDbConn` + `conn.connect()` 수행. `executeDefs(defs, resultMetas?)` 는 `@simplysm/orm-common` 의 `createQueryBuilder` + `parseQueryResult` 를 사용해 `QueryDef[]` → SQL → 파싱 결과. `resultMetas` 가 전부 `null` 인 경우 단일 결합 SQL 1회로 묶어 실행하고 `defs.length` 개의 빈 배열 반환(결과 불필요 케이스 최적화). 미연결 상태에서 메서드 호출 시 `DB_CONN_ERRORS.NOT_CONNECTED` SdError throw.

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

@@ -1,32 +0,0 @@
-# @simplysm/sd-claude
-
-Claude Code 셋업 자산(`.claude/` 의 sd-* 스킬·룰·훅) 배포 및 `sd-claude` CLI 제공 패키지. 코드 API 없음 — 외부 import 가능한 라이브러리 심볼 미노출.
-
-## 사용 트리거 인덱스
-
-- 현재 로그인된 Claude 계정을 프로필로 저장 → [auth save](#cli-sd-claude)
-- 저장된 다른 Claude 계정으로 전환 → [auth switch](#cli-sd-claude)
-- 소비 프로젝트 설치 시 `.claude/` 자산 자동 배치 → [postinstall](#패키지-훅)
-- 워크스페이스 `.claude/` 변경분을 패키지 `claude/` 로 동기화(배포 직전) → [prepack / sync](#패키지-훅)
-
-## CLI `sd-claude`
-
-`bin: sd-claude` → `scripts/cli.mjs`. 사용법: `sd-claude <subcommand> <action>`.
-
-- `auth save`: 현재 `claude auth status` 의 `orgName` 을 프로필 키로, `~/.claude/.credentials.json` 의 `claudeAiOauth.refreshToken` 과 `~/.claude/statusline-cache.json` 의 사용량 스냅샷을 `~/.claude/profiles.json` 에 저장하고 `current` 를 해당 프로필로 설정. orgName 또는 refreshToken 미획득 시 stderr 출력 후 exit 1.
-- `auth switch`: `profiles.json` 의 계정 목록을 번호 + 현재 마커(`*`) + 사용량(현재 계정은 live, 그 외는 저장 시점) 으로 출력. 번호 입력으로 대상 선택 → 현재 계정의 최신 refreshToken·사용량을 백업 저장 → `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`/`CLAUDE_CODE_OAUTH_SCOPES` 환경변수로 `claude auth login` 을 spawn → 갱신된 refreshToken 저장 + `current` 업데이트. TTY 아니면 exit 1.
-- 그 외 인자: 사용법 출력 후 exit 1.
-
-저장 위치 식별자 풀이:
-- `~/.claude/profiles.json`: `{ current: string, accounts: { [orgName]: { refreshToken, usage } } }` 구조. 패키지가 관리.
-- `~/.claude/.credentials.json`: Claude Code 본체가 관리. `claudeAiOauth.refreshToken` 만 읽음.
-- `~/.claude/statusline-cache.json`: Claude Code 본체가 관리. `rate_limits.five_hour` / `seven_day` 의 `used_percentage` + `resets_at` 만 읽음.
-
-## 패키지 훅
-
-- `postinstall` (`scripts/postinstall.mjs`): 소비 프로젝트의 `node_modules` 설치 시 자동 실행. `INIT_CWD` 또는 `node_modules` 경로 역추적으로 프로젝트 루트 결정 → `<projectRoot>/.claude/` 의 기존 sd-* 항목(root 1단계 + 하위 디렉토리 1단계의 `^sd[-_]` 매칭) 정리 후 패키지 `claude/` 의 동일 항목 + `settings.json` + `simplysm.json` 을 복사. 소비 프로젝트가 `name: "simplysm"` 이고 메이저 버전이 같으면 skip(모노레포 자기 자신 보호). 실패해도 throw 하지 않음(install 차단 방지).
-- `prepack` (`scripts/sync.mjs`): `pnpm pub`/`npm pack` 직전 실행. 워크스페이스 루트(`../../`)의 `.claude/` 에서 sd-* 항목(+ `settings.json`/`simplysm.json`) 을 패키지 `claude/` 로 증분 복사. 동일 파일은 mtime+size 비교로 skip, 변경분은 unlink 후 copy + src mtime 보존, src 에 없는 dest 항목은 prune. 제외: `evals/` 하위, 파일명 `SKILL.eval.md`, `eval_*` 접두 파일. (Windows EPERM 회피 위해 일괄 rmSync 미사용.)
-
-식별자 풀이:
-- sd-* 항목 스캔 범위: 디렉토리 root + 1단계 하위. 정규식 `^sd[-_]`. 즉 `.claude/skills/sd-foo/`, `.claude/rules/sd-bar.md`, `.claude/sd-baz/` 등 매칭.
-- watch 훅 연동: 모노레포에서는 `sd.config.ts` 의 `scripts` 타겟이 `.claude/sd-*` 변경 감지 시 본 `sync.mjs` 를 호출(패키지 외부 설정).

package/claude/references/sd-simplysm14/apis/sd-cli/README.md

@@ -1,80 +0,0 @@
-# @simplysm/sd-cli
-
-워크스페이스 빌드/배포 오케스트레이터. 소비 표면은 두 갈래다 — `pnpm sd-cli <cmd>` 서브커맨드와 `sd.config.ts` 작성용 타입. 라이브러리 export 로는 Vitest Angular 플러그인과 외부 도구가 재사용할 `SdTsCompiler` 도 노출한다.
-
-## 사용 트리거 인덱스
-
-### 서브커맨드 (`pnpm sd-cli <cmd>`)
-
-- **`check`** — 타입체크와 lint 를 병렬 실행. 일반 검증 명령으로 가장 자주 호출됨.
-- **`watch`** — 워크스페이스 전체 또는 일부 패키지를 watch 모드로 증분 빌드.
-- **`dev`** — server 패키지를 dev 모드로 실행 (`tsx` 핫리로드 + client 패키지의 dev http 서버 동반 기동).
-- **`device`** — client 패키지를 안드로이드 디바이스 또는 Electron 데스크톱에서 실행. dev 서버가 떠 있어야 함.
-- **`build`** — 프로덕션 빌드. `sd.config.ts` 의 `packages` 전 항목 또는 `-t` 지정 항목.
-- **`publish`** — 빌드 후 `publish` 설정을 따라 배포 (npm / 로컬 디렉토리 / FTP·SFTP). `--no-build` 로 기존 산출물만 배포.
-- **`replace-deps`** — `sd.config.ts.replaceDeps` 에 따라 `node_modules` 패키지를 로컬 소스로 심링크 교체.
-- **`init`** — 인터랙티브 프롬프트로 SI 워크스페이스 골격 생성.
-
-공통 옵션:
-- `-t / --target <pkg>` (반복 가능) — 대상 패키지. `sd.config.ts.packages` 키 (= `@simplysm/` 접두사 **제외**한 짧은 이름). 미지정 시 전체. `check`/`watch`/`dev`/`build`/`publish` 에서 지원. `device` 는 단수(`-t <pkg>` 1회). `replace-deps`/`init` 미지원.
-- `-o / --opt <val>` (반복 가능) — `sd.config.ts` 함수의 `params.opt[]` 로 전달. `check` 와 `init` 제외 전 커맨드에서 지원.
-- `--debug` — 디버그 로그 출력 (모든 커맨드).
-- `--help / -h` — 단독 호출 시 모든 서브커맨드 종합 도움말.
-
-커맨드별 고유 옵션:
-- `check`: `--type typecheck|lint` (반복 가능, 기본 둘 다), `--fix` (lint 자동 수정).
-- `device`: `--target <pkg>` (단수, 미지정 시 유일 client 자동 선택), `--url <devServerUrl>` (미지정 시 `sd.config.ts` 의 server 설정에서 자동 도출).
-- `publish`: `--no-build` (빌드 생략), `--dry-run` (실제 배포 없이 시뮬레이션).
-
-진실 근거: `packages/sd-cli/src/sd-cli-entry.ts` (yargs 등록부), `packages/sd-cli/src/commands/<cmd>.ts`.
-
-### 설정 타입 (`sd.config.ts`)
-
-- **`SdConfigFn` / `SdConfig` / `SdConfigParams`** — `sd.config.ts` 의 default export 함수와 그 반환 타입. 자세히: [sd-config.md](./sd-config.md)
-- **`SdBuildPackageConfig` / `SdClientPackageConfig` / `SdServerPackageConfig` / `SdScriptsPackageConfig`** — `SdConfig.packages` 의 값 타입. 각각 라이브러리 / Frontend 앱 / Fastify 서버 / 유틸 패키지에 대응. 자세히: [sd-config.md](./sd-config.md)
-- **`SdPublishConfig` / `SdPostPublishScriptConfig`** — 패키지의 `publish` 와 전역 `postPublish` 항목 타입. 자세히: [sd-config.md](./sd-config.md)
-- **`SdCapacitorConfig` / `SdElectronConfig` / `SdPwaConfig` / `SdBrowserSupportConfig`** — client 패키지의 모바일·데스크톱·PWA·브라우저 지원 옵션. 자세히: [sd-config.md](./sd-config.md)
-
-### 라이브러리 export
-
-- **`sdAngularPlugin(options)`** — Vitest 의 `vite.config` / `vitest.config` 에서 Angular 패키지 AOT 컴파일이 필요할 때 plugin 으로 추가.
-- **`SdTsCompiler` (+ `ISdTsCompilerOptions`, `ISdTsCompilerResult`)** — Angular/Non-Angular TS 패키지를 증분 컴파일·진단·lint·SCSS 통합 처리하는 엔진. `sd-cli` 내부와 `sdAngularPlugin` 이 사용. 외부에서 동일한 엔진을 재사용할 때만 직접 import.
-
-## sdAngularPlugin
-
-```typescript
-import { sdAngularPlugin, type SdAngularPluginOptions } from "@simplysm/sd-cli";
-
-// vitest.config.ts
-plugins: [sdAngularPlugin({ pkg: "angular" })]
-```
-
-`pkg` 는 `sd.config.ts.packages` 키 (= `packages/<pkg>/` 디렉토리명). 패키지의 `.ts` 를 AOT 컴파일해 `transform` 훅에서 JS 로 치환한다. `tsconfig.json` 의 `angularCompilerOptions` 유무로 Angular 모드를 자동 감지. Vitest watch 의 `watchChange` 를 받아 증분 재컴파일. 첫 `buildStart` 전에 `config()` 호출 필수 (Vitest 가 자동 호출).
-
-## SdTsCompiler
-
-```typescript
-import { SdTsCompiler } from "@simplysm/sd-cli";
-
-const compiler = new SdTsCompiler({
-  pkgDir: "/abs/path/to/packages/foo",
-  cwd: "/abs/path/to/workspace",
-  output: { js: true, dts: false },  // 출력 제어 — 둘 다 false 면 typecheck only
-  includeTests: false,                // true 면 tests/ 도 rootNames 에 포함
-  lint: false,
-  globalScss: false,
-});
-const result = await compiler.compileAsync(/* modifiedFiles? */);
-// result.diagnostics, result.errorCount, result.emitResults (Angular), ...
-```
-
-특징:
-- 인스턴스를 재사용해 호출 간 incremental 빌드 (`tsBuildInfoFile` 은 `<pkgDir>/.cache/` 하위).
-- `compileAsync(modifiedFiles)` 의 modifiedFiles 는 watch 모드의 변경 파일. 미전달 시 전체 affected 탐색.
-- Angular 패키지(`tsconfig.angularCompilerOptions`)는 자동으로 NgtscProgram 사용. 결과의 `emitResults: { filename, contents, sourceFileName }[]` 를 호출자가 디스크/번들러에 전달. Non-Angular 은 `host.writeFile` 로 디스크에 직접 emit (결과의 `emitResults` undefined).
-- `compilerOptionsTransformer` 로 target/module/outDir 등을 후처리 override 가능.
-- `transformStylesheet`, `externalStylesheets`, `sourceFileCache` 는 Angular 클라이언트 빌드 통합용 (esbuild 플러그인이 사용).
-- 단계별 try/catch 로 부분 복구 — 한 단계 실패해도 다른 진단/emit 결과는 유지.
-- 결과의 `affectedFiles` 가 `undefined` 면 전역 변경 (전체 리빌드 신호).
-
-전체 옵션·결과 필드 정의는 `packages/sd-cli/src/ts-compiler/sd-ts-compiler-options.ts`, `sd-ts-compiler-result.ts` 참조.

package/claude/references/sd-simplysm14/apis/sd-cli/sd-config.md

@@ -1,155 +0,0 @@
-# @simplysm/sd-cli — sd-config
-
-`sd.config.ts` 작성용 타입 모음. 진실 근거: `packages/sd-cli/src/sd-config.types.ts`.
-
-## 진입 타입
-
-```typescript
-import type { SdConfig, SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";
-
-const config: SdConfigFn = (params) => ({
-  packages: {
-    "core-common": { target: "neutral" },
-    "core-node": { target: "node" },
-  },
-});
-export default config;
-```
-
-- `SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>`
-- `SdConfigParams = { cwd: string; dev: boolean; opt: string[] }` — `opt` 는 CLI `-o` 플래그.
-- `SdConfig = { packages: Record<string, SdPackageConfig | undefined>; replaceDeps?: Record<string, string>; postPublish?: SdPostPublishScriptConfig[] }`
-  - `packages` 키 = `packages/` 하위 디렉토리명.
-  - `replaceDeps`: node_modules 의 패키지를 로컬 소스로 심링크 교체. 예: `{ "@simplysm/*": "../simplysm/packages/*" }` (key 의 `*` 가 value 의 `*` 로 치환).
-
-## 패키지 설정
-
-`SdPackageConfig = SdBuildPackageConfig | SdClientPackageConfig | SdServerPackageConfig | SdScriptsPackageConfig`.
-
-### SdBuildPackageConfig (라이브러리: node/browser/neutral)
-
-```typescript
-{
-  target: "node" | "browser" | "neutral";   // BuildTarget
-  publish?: SdPublishConfig;
-  copySrc?: string[];                        // src/ 기준 glob → dist/ 로 복사
-  watch?: SdWatchHookConfig;                 // watch 모드 훅
-}
-```
-
-### SdClientPackageConfig (Frontend 앱)
-
-```typescript
-{
-  target: "client";
-  server: string | number;                   // 연결 서버 패키지명, 또는 포트
-  env?: Record<string, string>;              // esbuild define 으로 process.env 치환
-  publish?: SdPublishConfig;
-  capacitor?: SdCapacitorConfig;
-  electron?: SdElectronConfig;
-  configs?: Record<string, unknown>;         // 런타임 설정 → dist/.config.json
-  exclude?: string[];                        // Capacitor/Electron package.json 에 추가
-  browserSupport?: SdBrowserSupportConfig;
-  pwa?: false | SdPwaConfig;                 // 미지정 시 기본값으로 활성
-}
-```
-
-### SdServerPackageConfig (Fastify 서버)
-
-```typescript
-{
-  target: "server";
-  env?: Record<string, string>;              // esbuild banner 로 process.env.KEY 상수 치환
-  publish?: SdPublishConfig;
-  configs?: Record<string, unknown>;         // 런타임 설정 → dist/.config.json
-  externals?: string[];                      // esbuild external (binding.gyp 자동 감지에 추가)
-  pm2?: { name?: string; ignoreWatchPaths?: string[] };  // 지정 시 dist/pm2.config.cjs 생성
-  packageManager?: "volta" | "mise";         // mise.toml / volta 설정 생성에 영향
-}
-```
-
-### SdScriptsPackageConfig (유틸·임의 명령 실행)
-
-```typescript
-{
-  target: "scripts";
-  publish?: SdPublishConfig;
-  watch?: SdWatchHookConfig;                 // 미지정이면 watch/typecheck 에서 제외
-}
-```
-
-`SdWatchHookConfig`: `{ target: string[]; cmd: string; args?: string[] }`. `target` 은 패키지 디렉토리 기준 glob. 매칭 변경 시 `cmd args` 실행.
-
-## 배포 설정
-
-`SdPublishConfig`:
-- `{ type: "npm" }` — npm 레지스트리.
-- `{ type: "local-directory"; path: string }` — 로컬 복사. `path` 에 `%VER%`, `%PROJECT%` 치환.
-- `{ type: "ftp" | "ftps" | "sftp"; host; port?; path?; user?; password? }`.
-
-`postPublish` 항목 `SdPostPublishScriptConfig`: `{ type: "script"; cmd: string; args: string[] }`. `args` 의 `%VER%`, `%PROJECT%` 치환.
-
-## 클라이언트 부속 옵션
-
-### SdCapacitorConfig
-
-```typescript
-{
-  appId: string;                             // 예 "com.example.app"
-  appName: string;
-  plugins?: Record<string, Record<string, unknown> | true>;
-  icon?: string;                             // 패키지 기준 상대 경로
-  debug?: boolean;
-  platform?: { android?: SdCapacitorAndroidConfig };
-}
-```
-
-`SdCapacitorAndroidConfig`: `config`(AndroidManifest application 속성), `bundle`(true=AAB, false=APK), `intentFilters`, `sign: SdCapacitorSignConfig`, `sdkVersion`, `permissions: SdCapacitorPermission[]`.
-
-- `SdCapacitorSignConfig`: `keystore, storePassword, alias, password, keystoreType?` (기본 `"jks"`).
-- `SdCapacitorPermission`: `{ name; maxSdkVersion?; ignore? }`.
-- `SdCapacitorIntentFilter`: `{ action?; category? }`.
-
-### SdElectronConfig
-
-```typescript
-{
-  appId: string;
-  portable?: boolean;                        // true=포터블 exe, 미지정/false=NSIS 설치본
-  installerIcon?: string;                    // .ico, 패키지 기준 상대 경로
-  reinstallDependencies?: string[];          // 네이티브 모듈 등
-  postInstallScript?: string;
-  nsisOptions?: Record<string, unknown>;
-  env?: Record<string, string>;              // electron-main.ts 의 process.env
-}
-```
-
-### SdPwaConfig
-
-```typescript
-{
-  manifest?: {
-    name?; short_name?;
-    display?: "standalone" | "fullscreen" | "minimal-ui" | "browser";
-    theme_color?; background_color?;
-    icons?: Array<{ src: string; sizes: string; type?: string }>;
-  };
-}
-```
-
-`pwa: false` 로 비활성. 미지정 시 기본값으로 활성.
-
-### SdBrowserSupportConfig
-
-```typescript
-{
-  browserslist?: string | string[];          // 예 "last 2 Chrome versions"
-  postCss?: { plugins: [string, (object | string)?][] };
-  legacyModule?: boolean;                    // 코드 분할 비활성 + import.meta 치환
-}
-```
-
-## 부수 타입
-
-- `BuildTarget = "node" | "browser" | "neutral"` — `SdBuildPackageConfig.target`.
-- `NpmConfig` — `package.json` 구조 헬퍼 (`name`, `version`, `dependencies`, `devDependencies`, `peerDependencies`, `volta?`).