@blastlabs/utils 1.16.0 → 1.18.0

package/README.md

@@ -255,6 +255,89 @@ function App() {
 import type { FormDevToolsProps, ApiLogEntry } from '@blastlabs/utils/components/dev';
 ```
 
+## 🚀 CLI 도구
+
+이 패키지는 프로젝트 설정을 자동화하는 CLI 도구를 제공합니다.
+
+### FSD Entity Generator
+
+Feature-Sliced Design 아키텍처용 엔티티 스캐폴딩을 자동으로 생성합니다.
+
+```bash
+# entities 폴더로 이동
+cd src/entities
+
+# 엔티티 생성
+npx blastlabs-generate-entity user
+npx blastlabs-generate-entity my-new-entity
+```
+
+**생성되는 구조:**
+```
+user/
+├── index.ts
+├── api/
+│   ├── get-user-list.ts
+│   ├── get-user-detail.ts
+│   ├── user-queries.ts
+│   ├── index.ts
+│   ├── mapper/
+│   │   ├── map-user.ts
+│   │   └── map-user-detail.ts
+│   └── query/
+│       └── user-list-query.ts
+└── model/
+    ├── user.ts
+    └── user-detail.ts
+```
+
+**특징:**
+- TanStack Query queryOptions 패턴 지원
+- Zod 스키마 자동 생성
+- API mapper 패턴 적용
+- TypeScript 타입 안정성 보장
+
+### AI Rules Installer
+
+Cursor, Claude Code용 AI 규칙을 프로젝트에 설치합니다.
+
+```bash
+# 프로젝트 루트에서 실행
+npx blastlabs-init-ai-rules [options]
+```
+
+**옵션:**
+- `--fsd` - FSD 아키텍처 규칙 포함
+- `--all` - 모든 규칙 설치 (base + fsd)
+- `--list, -l` - 설치 가능한 규칙 목록 보기
+- `--help, -h` - 도움말 보기
+
+**예시:**
+```bash
+# 기본 규칙만 설치
+npx blastlabs-init-ai-rules
+
+# FSD 아키텍처 규칙 포함
+npx blastlabs-init-ai-rules --fsd
+
+# 모든 규칙 설치
+npx blastlabs-init-ai-rules --all
+```
+
+**설치되는 파일:**
+```
+.cursor/rules/*.mdc  # Cursor용 규칙
+.claude/rules/*.md   # Claude Code용 규칙
+```
+
+**포함된 규칙:**
+- TypeScript 표준
+- React Hooks 가이드라인
+- 테스트 작성 가이드
+- 문서화 가이드라인
+- Git 커밋 컨벤션
+- FSD 아키텍처 (선택)
+
 ## 주의사항
 
 - **개발용 컴포넌트(`components/dev`)는 프로덕션 환경에서 제외하는 것을 권장합니다.**

package/bin/init-ai-rules.cjs

@@ -11,6 +11,7 @@ const RULE_CATEGORIES = {
     "react-hooks.md",
     "testing.md",
     "documentation.md",
+    "changelog.md",
     "git-commit.md",
   ],
   // FSD 아키텍처 규칙
@@ -94,10 +95,13 @@ function parseFrontmatter(content) {
   const body = match[2];
 
   const frontmatter = {};
+  let currentKey = null;
+
   for (const line of yamlBlock.split("\n")) {
+    // 키-값 쌍 파싱
     const kvMatch = line.match(/^(\w+):\s*(.*)$/);
     if (kvMatch) {
-      const key = kvMatch[1];
+      currentKey = kvMatch[1];
       let value = kvMatch[2].trim();
 
       if (value === "true") value = true;
@@ -112,7 +116,18 @@ function parseFrontmatter(content) {
       }
 
       if (value !== undefined) {
-        frontmatter[key] = value;
+        frontmatter[currentKey] = value;
+      }
+    } else if (line.startsWith("  -") && currentKey) {
+      // 배열 값 처리 (paths 등)
+      const arrayValueMatch = line.match(/^\s*-\s*"([^"]+)"\s*$/);
+      if (arrayValueMatch) {
+        const arrayValue = arrayValueMatch[1];
+        // 현재 키의 값이 배열이 아니면 배열로 초기화
+        if (!Array.isArray(frontmatter[currentKey])) {
+          frontmatter[currentKey] = [];
+        }
+        frontmatter[currentKey].push(arrayValue);
       }
     }
   }
@@ -125,9 +140,14 @@ function serializeCursorFrontmatter(frontmatter) {
   if (frontmatter.description) {
     yaml += `description: ${frontmatter.description}\n`;
   }
-  if (frontmatter.globs) {
-    yaml += `globs: "${frontmatter.globs}"\n`;
+  // Cursor는 globs 사용 (paths를 globs로 변환)
+  // 배열인 경우 쉼표로 구분된 한 줄로 변환
+  const globs = frontmatter.globs || frontmatter.paths;
+  if (globs) {
+    const globsStr = Array.isArray(globs) ? globs.join(",") : globs;
+    yaml += `globs: "${globsStr}"\n`;
   }
+  // alwaysApply는 Cursor 전용
   if (frontmatter.alwaysApply !== undefined) {
     yaml += `alwaysApply: ${frontmatter.alwaysApply}\n`;
   }
@@ -140,9 +160,16 @@ function serializeClaudeFrontmatter(frontmatter) {
   if (frontmatter.description) {
     yaml += `description: "${frontmatter.description}"\n`;
   }
-  // globs는 alwaysApply가 true가 아닌 경우에만 포함
-  if (frontmatter.globs && frontmatter.alwaysApply !== true) {
-    yaml += `globs: "${frontmatter.globs}"\n`;
+  // paths는 항상 적용되지 않는 경우에만 포함
+  if (frontmatter.paths && frontmatter.alwaysApply !== true) {
+    if (Array.isArray(frontmatter.paths)) {
+      yaml += "paths:\n";
+      for (const p of frontmatter.paths) {
+        yaml += `  - "${p}"\n`;
+      }
+    } else {
+      yaml += `paths:\n  - "${frontmatter.paths}"\n`;
+    }
   }
   // alwaysApply는 Claude에서 사용하지 않으므로 생략
   yaml += "---\n";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blastlabs/utils",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/rules/changelog.md

@@ -0,0 +1,60 @@
+---
+description: "Changelog 작성 규칙"
+globs: "CHANGELOG.md"
+alwaysApply: false
+---
+
+# Changelog Rules
+
+## 필수 규칙
+
+- [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) 형식 준수
+- Semantic Versioning 준수
+- 최신 변경사항은 `[Unreleased]` 섹션에 추가
+
+## 섹션 구조
+
+```markdown
+# Changelog
+
+## [Unreleased]
+
+### Added
+- 새로운 기능
+
+### Changed
+- 기존 기능의 변경
+
+### Deprecated
+- 곧 제거될 기능
+
+### Removed
+- 제거된 기능
+
+### Fixed
+- 버그 수정
+
+### Security
+- 보안 패치
+
+## [1.0.0] - 2024-01-01
+```
+
+## 버전 릴리즈 시
+
+1. `[Unreleased]` 내용을 새 버전 섹션으로 이동
+2. 릴리즈 날짜 추가
+3. 새로운 `[Unreleased]` 섹션 생성
+
+```markdown
+## [Unreleased]
+
+## [1.1.0] - 2024-02-01
+### Added
+- 이전에 Unreleased에 있던 내용
+```
+
+## 중요
+
+- **Always** update CHANGELOG.md when making changes
+- 배포 시 반드시 changelog 확인

package/rules/documentation.md

@@ -15,7 +15,16 @@ alwaysApply: false
 
 - 기능 추가 시 README.md 업데이트
 - 새 hooks 추가 시 관련 docs/*.md 업데이트
+- 변경사항은 반드시 CHANGELOG.md에 기록
+
+## CHANGELOG 작성
+
+- [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) 형식 준수
+- 최신 변경사항은 `[Unreleased]` 섹션에 추가
+- 섹션: Added, Changed, Deprecated, Removed, Fixed, Security
+- 버전 릴리즈 시 `[Unreleased]`를 해당 버전으로 이동
 
 ## 필수 사항
 
 - **Always** update documentation when adding features
+- **Always** update CHANGELOG.md for any changes

package/rules/entities-layer.md

@@ -1,6 +1,7 @@
 ---
 description: "Entities 레이어 구조 및 API 패턴"
-globs: "**/entities/**"
+paths:
+  - "**/entities/**"
 ---
 
 # Entities Layer (엔티티)

package/rules/react-hooks.md

@@ -1,7 +1,10 @@
 ---
 description: "React Hooks 개발 규칙 및 SSR 안전성"
-globs: "**/use*.ts,**/use*.tsx"
-alwaysApply: false
+paths:
+  - "src/hooks/**/*.ts"
+  - "src/hooks/**/*.tsx"
+  - "**/use*.ts"
+  - "**/use*.tsx"
 ---
 
 # React Hooks Rules

package/rules/shared-layer.md

@@ -1,6 +1,7 @@
 ---
 description: "Shared 레이어 구조 및 lib vs utils 구분"
-globs: "**/shared/**"
+paths:
+  - "**/shared/**"
 ---
 
 # Shared Layer (공유 레이어)

package/rules/testing.md

@@ -1,7 +1,9 @@
 ---
 description: "테스트 작성 가이드라인"
-globs: "**/*.test.ts,**/*.test.tsx,**/__tests__/**"
-alwaysApply: false
+paths:
+  - "**/*.test.ts"
+  - "**/*.test.tsx"
+  - "**/__tests__/**"
 ---
 
 # Testing Guidelines

package/rules/typescript-standards.md

@@ -1,7 +1,8 @@
 ---
 description: "TypeScript 코딩 표준 및 타입 규칙"
-globs: "**/*.ts,**/*.tsx"
-alwaysApply: false
+paths:
+  - "**/*.ts"
+  - "**/*.tsx"
 ---
 
 # TypeScript Standards

package/rules/views-layer.md

@@ -1,6 +1,7 @@
 ---
 description: "Views 레이어 (페이지) 구조"
-globs: "**/views/**"
+paths:
+  - "**/views/**"
 ---
 
 # Views Layer (페이지 레이어)