feat: 파일명에 [한국어 키] 영어 패턴 지원

폴더명과 동일한 패턴으로 파일명도 지원:
- [한국어 키] 영어 형식: [멘토 목록 조회] get-mentor-list.bru → get-mentor-list 추출
- 한글 설명은 가독성을 위해 사용, 실제 코드 생성에는 영문 부분만 사용

수정된 파일:
- src/generator/queryKeyGenerator.ts: 파일명 추출 로직 추가
- src/generator/apiClientGenerator.ts: 파일명 추출 로직 추가
- docs/bruno-guide.md: 파일명 패턴 가이드라인 추가
- tests/cli.test.js: 파일명 패턴 테스트 추가

예시:
- [목록 조회] get-list.bru → getList (쿼리 키), useGetList (훅)
- [사용자 프로필] get-user-profile.bru → getUserProfile, useGetUserProfile

모든 테스트 통과 (새로운 파일명 패턴 테스트 포함)

Author: manNomi

docs/bruno-guide.md

@@ -153,19 +153,23 @@ docs {
 #### 지원하는 형식
 
 1. **`[한글명] 숫자 영문키` 형식** (권장)
+
    ```
    [어드민] 7 Admin/          → 생성 폴더: 7 Admin
    [사용자] 8 Users/          → 생성 폴더: 8 Users
    [멘토] 9 Mentor/           → 생성 폴더: 9 Mentor
    ```
+
    - 대괄호 뒤의 모든 내용(숫자 + 영문키)이 폴더명이 됩니다
    - 한글명은 가독성을 위해 사용, 실제 폴더명에는 포함되지 않음
 
 2. **`한글명 [EnglishKey]` 형식** (기존 방식, 호환)
+
    ```
    지원서 [applications]/    → 생성 폴더: applications
    사용자 [users]/            → 생성 폴더: users
    ```
+
    - 대괄호 안의 `EnglishKey`만 사용됩니다
    - 기존 프로젝트와 호환됩니다
 
@@ -178,26 +182,49 @@ docs {
 
 #### 폴더명 예시
 
-| Bruno 폴더명 | 생성되는 폴더 | 설명 |
-|-------------|--------------|------|
-| `[어드민] 7 Admin` | `7 Admin` | 숫자와 공백 포함 가능 |
+| Bruno 폴더명            | 생성되는 폴더  | 설명                  |
+| ----------------------- | -------------- | --------------------- |
+| `[어드민] 7 Admin`      | `7 Admin`      | 숫자와 공백 포함 가능 |
 | `지원서 [applications]` | `applications` | 대괄호 안의 키만 사용 |
-| `users` | `users` | 그대로 사용 |
+| `users`                 | `users`        | 그대로 사용           |
 
 ### 파일명 규칙
 
 **파일명이 쿼리 키와 훅 이름에 직접 사용됩니다!**
 
+#### 지원하는 형식
+
+1. **`[한국어 키] 영어` 형식** (권장, 폴더명과 동일한 패턴)
+
+   ```
+   [멘토 목록 조회] get-mentor-list.bru     → get-mentor-list → getMentorList
+   [사용자 프로필] get-user-profile.bru      → get-user-profile → getUserProfile
+   [지원서 생성] post-create-application.bru → post-create-application → postCreateApplication
+   ```
+
+   - 대괄호 뒤의 영문 부분만 사용됩니다
+   - 한글 설명은 가독성을 위해 사용, 실제 코드 생성에는 포함되지 않음
+
+2. **영문 파일명** (기존 방식, 호환)
+
+   ```
+   get-competitors.bru        → get-competitors → getCompetitors
+   get-user-profile.bru       → get-user-profile → getUserProfile
+   post-create-application.bru → post-create-application → postCreateApplication
+   ```
+
+   - 패턴이 없으면 파일명 그대로 사용
+
 #### 권장 형식
 
 **✅ 올바른 예시:**
 
 ```
-get-competitors.bru        → QueryKeys.applications.getCompetitors
-get-user-profile.bru       → QueryKeys.users.getUserProfile
-post-create-application.bru → QueryKeys.applications.postCreateApplication
-put-update-profile.bru     → QueryKeys.users.putUpdateProfile
-delete-user.bru            → QueryKeys.users.deleteUser
+[멘토 목록 조회] get-mentor-list.bru        → QueryKeys.mentors.getMentorList
+[사용자 프로필] get-user-profile.bru         → QueryKeys.users.getUserProfile
+[지원서 생성] post-create-application.bru     → QueryKeys.applications.postCreateApplication
+[프로필 수정] put-update-profile.bru          → QueryKeys.users.putUpdateProfile
+[사용자 삭제] delete-user.bru                → QueryKeys.users.deleteUser
 ```
 
 #### 네이밍 규칙
@@ -225,38 +252,40 @@ delete-user.bru            → QueryKeys.users.deleteUser
    - ❌ `멘토 목록 조회.bru` (쿼리 키 생성 시 문제 가능)
    - ✅ `get-mentor-list.bru` (영문 사용)
 
-#### 변환 규칙
+#### 파일명 예시
 
-파일명은 자동으로 camelCase로 변환됩니다:
+| Bruno 파일명                          | 추출된 파일명          | 쿼리 키 이름               | 훅 이름                       |
+| ------------------------------------- | ---------------------- | -------------------------- | ----------------------------- |
+| `[멘토 목록 조회] get-mentor-list.bru` | `get-mentor-list`      | `getMentorList`            | `useGetMentorList`            |
+| `[사용자 프로필] get-user-profile.bru` | `get-user-profile`     | `getUserProfile`           | `useGetUserProfile`           |
+| `[지원서 생성] post-create.bru`        | `post-create`          | `postCreate`               | `usePostCreate`               |
+| `get-competitors.bru`                  | `get-competitors`      | `getCompetitors`           | `useGetCompetitors`           |
+| `멘토 목록 조회.bru`                   | `멘토 목록 조회` (비권장) | `멘토목록조회` (문제 가능) | `use멘토목록조회` (문제 가능) |
 
-| 파일명                        | 쿼리 키 이름               | 훅 이름                       |
-| ----------------------------- | -------------------------- | ----------------------------- |
-| `get-competitors.bru`         | `getCompetitors`           | `useGetCompetitors`           |
-| `get-user-profile.bru`        | `getUserProfile`           | `useGetUserProfile`           |
-| `post-create-application.bru` | `postCreateApplication`    | `usePostCreateApplication`    |
-| `멘토 목록 조회.bru`          | `멘토목록조회` (문제 가능) | `use멘토목록조회` (문제 가능) |
-
-**핵심**: 파일명을 영문 kebab-case로 작성하면, 자동으로 일관된 쿼리 키와 훅 이름이 생성됩니다!
+**핵심**: 
+- `[한국어 키] 영어` 형식으로 작성하면 한글 설명과 영문 코드를 모두 활용할 수 있습니다
+- 영문 부분만 kebab-case로 작성하면, 자동으로 일관된 쿼리 키와 훅 이름이 생성됩니다!
 
 ### 전체 구조 예시
 
 ```
 bruno/
-├── [어드민] 7 Admin/              # 폴더명: 7 Admin
-│   ├── get-list.bru               # → QueryKeys["7 Admin"].getList
-│   ├── post-create.bru           # → QueryKeys["7 Admin"].postCreate
-│   └── put-update.bru             # → QueryKeys["7 Admin"].putUpdate
-├── 지원서 [applications]/        # 폴더명: applications
-│   ├── get-competitors.bru        # → QueryKeys.applications.getCompetitors
-│   ├── get-details.bru            # → QueryKeys.applications.getDetails
-│   └── post-create.bru            # → QueryKeys.applications.postCreate
-├── 사용자 [users]/                # 폴더명: users
-│   ├── get-profile.bru            # → QueryKeys.users.getProfile
-│   └── put-update-profile.bru     # → QueryKeys.users.putUpdateProfile
+├── [어드민] 7 Admin/                              # 폴더명: 7 Admin
+│   ├── [목록 조회] get-list.bru                   # → QueryKeys["7 Admin"].getList
+│   ├── [생성] post-create.bru                    # → QueryKeys["7 Admin"].postCreate
+│   └── [수정] put-update.bru                     # → QueryKeys["7 Admin"].putUpdate
+├── 지원서 [applications]/                        # 폴더명: applications
+│   ├── [경쟁자 조회] get-competitors.bru          # → QueryKeys.applications.getCompetitors
+│   ├── [상세 조회] get-details.bru                # → QueryKeys.applications.getDetails
+│   └── [지원서 생성] post-create.bru              # → QueryKeys.applications.postCreate
+├── 사용자 [users]/                                # 폴더명: users
+│   ├── [프로필 조회] get-profile.bru              # → QueryKeys.users.getProfile
+│   └── [프로필 수정] put-update-profile.bru       # → QueryKeys.users.putUpdateProfile
 └── bruno.json
 ```
 
 **생성되는 구조:**
+
 ```
 src/apis/
 ├── 7 Admin/

src/generator/apiClientGenerator.ts

@@ -28,7 +28,15 @@ export function extractApiFunction(parsed: ParsedBrunoFile, filePath: string): A
   }
 
   // .bru 파일명에서 함수명 생성
-  const fileName = filePath.split('/').pop()?.replace('.bru', '') || '';
+  let fileName = filePath.split('/').pop()?.replace('.bru', '') || '';
+  
+  // [한국어 키] 영어 패턴 추출: [멘토 목록 조회] get-mentor-list → get-mentor-list
+  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  const bracketMatch = fileName.match(bracketPattern);
+  if (bracketMatch) {
+    fileName = bracketMatch[1].trim(); // 대괄호 뒤의 영문 부분만 사용
+  }
+  
   const functionName = toCamelCase(fileName);
   const responseType = functionNameToTypeName(functionName);
 

src/generator/queryKeyGenerator.ts

@@ -35,7 +35,14 @@ export function generateQueryKeyStructure(
       domain = pathParts[brunoIndex + 1];
     }
 
-    const fileName = path.split('/').pop()?.replace('.bru', '') || '';
+    let fileName = path.split('/').pop()?.replace('.bru', '') || '';
+
+    // [한국어 키] 영어 패턴 추출: [멘토 목록 조회] get-mentor-list → get-mentor-list
+    const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+    const bracketMatch = fileName.match(bracketPattern);
+    if (bracketMatch) {
+      fileName = bracketMatch[1].trim(); // 대괄호 뒤의 영문 부분만 사용
+    }
 
     if (!structure[domain]) {
       structure[domain] = {};

tests/cli.test.js

@@ -232,6 +232,33 @@ describe('새로운 폴더명 패턴 테스트', () => {
 
     console.log('✅ [한글명] 숫자 영문키 패턴 테스트 통과');
   });
+
+  test('[한국어 키] 영어 파일명 패턴 추출', () => {
+    const inputDir = join(FIXTURES_DIR, 'bruno');
+    const outputDir = join(TEST_OUTPUT_DIR, 'apis-filename-pattern');
+
+    execSync(`node dist/cli/index.js generate-hooks -i ${inputDir} -o ${outputDir}`, {
+      cwd: join(__dirname, '..'),
+    });
+
+    // QueryKeys 파일 확인
+    const queryKeysFile = join(outputDir, 'queryKeys.ts');
+    const queryKeysContent = readFileSync(queryKeysFile, 'utf-8');
+
+    // [목록 조회] get-list.bru → getList로 추출되어야 함
+    assert.ok(queryKeysContent.includes('getList'), 'getList 쿼리 키가 생성되어야 함');
+    assert.ok(queryKeysContent.includes("'7 Admin.getList'"), '7 Admin.getList 쿼리 키가 생성되어야 함');
+
+    // 훅 파일 확인
+    const hookFile = join(outputDir, '7 Admin', 'get-getList.ts');
+    assert.ok(existsSync(hookFile), '[목록 조회] get-list.bru에서 getList 훅이 생성되어야 함');
+
+    const hookContent = readFileSync(hookFile, 'utf-8');
+    assert.ok(hookContent.includes('getList'), '훅 내용에 getList가 포함되어야 함');
+    assert.ok(hookContent.includes('useGetList'), 'useGetList 훅이 생성되어야 함');
+
+    console.log('✅ [한국어 키] 영어 파일명 패턴 테스트 통과');
+  });
 });
 
 describe('상태 코드별 응답 파싱 테스트', () => {

tests/fixtures/bruno/[어드민] 7 Admin/[목록 조회] get-list.bru

@@ -0,0 +1,25 @@
+meta {
+  name: 목록 조회
+  type: http
+  seq: 1
+}
+
+get /admin/list
+
+headers {
+  Authorization: Bearer {{token}}
+}
+
+docs {
+  ```json
+  {
+    "items": [
+      {
+        "id": 1,
+        "name": "Item 1"
+      }
+    ],
+    "total": 1
+  }
+  ```
+}