@blastlabs/utils 1.17.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 아키텍처 규칙
@@ -139,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`;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blastlabs/utils",
-  "version": "1.17.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