feat: 폴더명 패턴 및 상태 코드별 응답 지원

- 새로운 폴더명 패턴 지원: [한글명] 숫자 영문키 → 숫자 영문키
  - 예시: [어드민] 7 Admin → 7 Admin 폴더 생성
  - 기존 패턴(한글명 [EnglishKey])도 계속 지원

- 상태 코드별 응답 파싱 지원
  - docs 블록에서 ## 200 OK, ## 404 Not Found 등 여러 상태 코드 지원
  - 현재는 200 OK만 사용 (다른 상태 코드는 문서화 목적)

- extractDomain 함수 수정 (3개 파일)
  - src/generator/index.ts
  - src/converter/openapiConverter.ts
  - src/diff/changeDetector.ts

- extractJsonFromDocs 함수 개선
  - 상태 코드별 응답 정규식 패턴 추가
  - 200 OK 우선 추출

- 테스트 추가
  - 새로운 폴더명 패턴 테스트
  - 상태 코드별 응답 파싱 테스트

- 문서 업데이트
  - docs/bruno-guide.md에 새로운 패턴 및 상태 코드 예시 추가

모든 테스트 통과 (10/10)

Author: manNomi

docs/bruno-guide.md

@@ -39,7 +39,7 @@ docs {
 
 **`docs` 블록이 전부입니다!** 이 블록의 JSON으로 타입과 스키마가 자동 생성됩니다.
 
-**올바른 예시:**
+**올바른 예시 (단일 응답):**
 
 `````bru
 docs {
@@ -59,6 +59,32 @@ docs {
 }
 `````
 
+**올바른 예시 (상태 코드별 응답):**
+
+여러 상태 코드를 정의할 수 있지만, **200 OK만 사용**됩니다:
+
+`````bru
+docs {
+  ## 200 OK
+  ```
+  {
+    "id": 1,
+    "username": "johndoe",
+    "email": "[email protected]"
+  }
+  ```
+  
+  ## 404 Not Found
+  ```
+  {
+    "message": "사용자를 찾을 수 없습니다."
+  }
+  ```
+}
+`````
+
+**참고**: 현재는 200 OK 응답만 타입 생성에 사용됩니다. 다른 상태 코드(404, 500 등)는 문서화 목적으로만 작성할 수 있습니다.
+
 ### 2. JSON 작성 규칙
 
 - ✅ **실제 응답과 동일하게** 작성
@@ -120,15 +146,26 @@ docs {
 
 ```
 bruno/
-├── 지원서 [applications]/    # 한글명 [영문키] 형식
+├── [어드민] 7 Admin/          # [한글명] 숫자 영문키 형식 → 7 Admin
 │   ├── get-list.bru
 │   └── create.bru
-├── 사용자 [users]/
+├── 지원서 [applications]/    # 한글명 [영문키] 형식 → applications
+│   ├── get-list.bru
+│   └── create.bru
+├── 사용자 [users]/            # 한글명 [영문키] 형식 → users
 │   └── get-profile.bru
 └── bruno.json
 ```
 
-**폴더명 규칙**: `한글명 [EnglishKey]` 형식으로 작성하면, 대괄호 안의 `EnglishKey`만 사용됩니다.
+**폴더명 규칙**:
+
+1. **`[한글명] 숫자 영문키` 형식**: `[어드민] 7 Admin` → 생성 폴더: `7 Admin`
+   - 대괄호 뒤의 모든 내용(숫자 + 영문키)이 폴더명이 됩니다
+   - 예시: `[사용자] 8 Users` → `8 Users`
+
+2. **`한글명 [EnglishKey]` 형식**: `지원서 [applications]` → 생성 폴더: `applications`
+   - 대괄호 안의 `EnglishKey`만 사용됩니다
+   - 기존 방식과 호환됩니다
 
 ## 실전 예시
 

src/converter/openapiConverter.ts

@@ -133,13 +133,21 @@ function extractDomain(filePath: string, brunoDir: string): string {
   const parts = rel.split('/');
   const folderName = parts[0] || 'default';
 
-  // [키] 패턴 추출
-  const match = folderName.match(/\[([^\]]+)\]/);
-  if (match) {
-    return match[1]; // 대괄호 안의 키만 반환
+  // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
+  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  const bracketMatch = folderName.match(bracketPattern);
+  if (bracketMatch) {
+    return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
   }
 
-  return folderName; // 대괄호가 없으면 폴더명 그대로 반환
+  // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
+  const oldPattern = /\[([^\]]+)\]/;
+  const oldMatch = folderName.match(oldPattern);
+  if (oldMatch) {
+    return oldMatch[1];
+  }
+
+  return folderName; // 패턴이 없으면 폴더명 그대로 반환
 }
 
 /**

src/diff/changeDetector.ts

@@ -190,10 +190,18 @@ function extractDomain(operation: any): string {
   if (operation.tags && operation.tags.length > 0) {
     const tag = operation.tags[0];
 
-    // [키] 패턴 추출
-    const match = tag.match(/\[([^\]]+)\]/);
-    if (match) {
-      return match[1]; // 대괄호 안의 키만 반환
+    // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
+    const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+    const bracketMatch = tag.match(bracketPattern);
+    if (bracketMatch) {
+      return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
+    }
+
+    // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
+    const oldPattern = /\[([^\]]+)\]/;
+    const oldMatch = tag.match(oldPattern);
+    if (oldMatch) {
+      return oldMatch[1];
     }
 
     return tag;

src/generator/index.ts

@@ -45,20 +45,29 @@ function findBrunoFiles(dir: string): string[] {
 
 /**
  * 파일 경로에서 도메인 추출
- * "한글명 [EnglishKey]" 형식에서 EnglishKey만 추출
+ * - "[한글명] 숫자 영문키" 형식: [어드민] 7 Admin → 7 Admin
+ * - "한글명 [EnglishKey]" 형식: 사용자 [users] → users
  */
 function extractDomain(filePath: string, brunoDir: string): string {
   const relativePath = relative(brunoDir, filePath);
   const parts = relativePath.split('/');
   const folderName = parts[0]; // 첫 번째 폴더가 도메인
 
-  // [키] 패턴 추출
-  const match = folderName.match(/\[([^\]]+)\]/);
-  if (match) {
-    return match[1]; // 대괄호 안의 키만 반환
+  // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
+  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  const bracketMatch = folderName.match(bracketPattern);
+  if (bracketMatch) {
+    return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
   }
 
-  return folderName; // 대괄호가 없으면 폴더명 그대로 반환
+  // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
+  const oldPattern = /\[([^\]]+)\]/;
+  const oldMatch = folderName.match(oldPattern);
+  if (oldMatch) {
+    return oldMatch[1];
+  }
+
+  return folderName; // 패턴이 없으면 폴더명 그대로 반환
 }
 
 /**

src/parser/bruParser.ts

@@ -128,10 +128,8 @@ export function parseBrunoFile(filePath: string): ParsedBrunoFile {
       if (currentBlock === 'docs') {
         if (trimmed === '```json' || trimmed === '```') {
           inCodeBlock = !inCodeBlock;
-          if (!inCodeBlock) {
-            // 코드 블록 종료
-            continue;
-          }
+          // 코드 블록 라인도 포함 (정규식 매칭을 위해)
+          blockContent.push(line);
           continue;
         }
       }
@@ -230,15 +228,43 @@ function parseDocs(result: ParsedBrunoFile, lines: string[]): void {
 
 /**
  * docs 블록에서 JSON 추출
+ * 상태 코드별 응답 지원: ## 200 OK 형식
  */
 export function extractJsonFromDocs(docs: string): any {
   try {
-    // JSON 코드 블록 찾기
+    // ## 200 OK 형식의 상태 코드별 응답 지원
+    // 패턴: ## 200 OK (또는 ## 200) 다음에 빈 줄과 코드 블록
+    const statusCodePattern = /##\s*(\d+)\s+[^\n]*(?:\n|$)(?:[^\n]*\n)*?\s*```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/g;
+    let match;
+    let json200 = null;
+    
+    // 모든 상태 코드 응답 찾기
+    while ((match = statusCodePattern.exec(docs)) !== null) {
+      const statusCode = parseInt(match[1]);
+      const jsonContent = match[2].trim();
+      
+      // 200 OK만 사용
+      if (statusCode === 200) {
+        try {
+          json200 = JSON.parse(jsonContent);
+          break; // 200 OK를 찾으면 중단
+        } catch (e) {
+          // JSON 파싱 실패시 무시
+        }
+      }
+    }
+    
+    // 200 OK를 찾지 못한 경우 기존 로직 사용
+    if (json200) {
+      return json200;
+    }
+    
+    // 기존 로직: 단일 JSON 코드 블록
     const jsonMatch = docs.match(/```json\s*([\s\S]*?)\s*```/);
     if (jsonMatch && jsonMatch[1]) {
       return JSON.parse(jsonMatch[1].trim());
     }
-
+    
     // 일반 JSON 파싱 시도
     return JSON.parse(docs.trim());
   } catch (error) {

tests/cli.test.js

@@ -213,5 +213,62 @@ describe('변경사항 감지 테스트', () => {
   });
 });
 
+describe('새로운 폴더명 패턴 테스트', () => {
+  test('[한글명] 숫자 영문키 패턴 추출', () => {
+    const inputDir = join(FIXTURES_DIR, 'bruno');
+    const outputDir = join(TEST_OUTPUT_DIR, 'apis-pattern');
+
+    execSync(`node dist/cli/index.js generate-hooks -i ${inputDir} -o ${outputDir}`, {
+      cwd: join(__dirname, '..'),
+    });
+
+    // [어드민] 7 Admin 폴더가 생성되었는지 확인
+    const adminDir = join(outputDir, '7 Admin');
+    assert.ok(existsSync(adminDir), '[어드민] 7 Admin 폴더가 생성되어야 함');
+
+    // 훅 파일 생성 확인
+    const hookFile = join(adminDir, 'get-getList.ts');
+    assert.ok(existsSync(hookFile), 'getList 훅이 생성되어야 함');
+
+    console.log('✅ [한글명] 숫자 영문키 패턴 테스트 통과');
+  });
+});
+
+describe('상태 코드별 응답 파싱 테스트', () => {
+  test('200 OK만 추출 (404 무시)', () => {
+    const inputDir = join(FIXTURES_DIR, 'bruno');
+    const outputFile = join(TEST_OUTPUT_DIR, 'openapi-status-codes.json');
+
+    execSync(`node dist/cli/index.js generate -i ${inputDir} -o ${outputFile}`, {
+      cwd: join(__dirname, '..'),
+    });
+
+    const spec = JSON.parse(readFileSync(outputFile, 'utf-8'));
+
+    // /mentors 엔드포인트 확인
+    const mentorsPath = spec.paths['/mentors'];
+    assert.ok(mentorsPath, '/mentors 엔드포인트가 있어야 함');
+
+    // 200 응답만 있는지 확인 (404는 무시되어야 함)
+    const getMethod = mentorsPath.get;
+    assert.ok(getMethod, 'GET 메서드가 있어야 함');
+    assert.ok(getMethod.responses['200'], '200 응답이 있어야 함');
+    assert.ok(!getMethod.responses['404'], '404 응답은 포함되지 않아야 함');
+
+    // 200 응답의 스키마 확인
+    const response200 = getMethod.responses['200'];
+    assert.ok(response200.content, 'content가 있어야 함');
+    assert.ok(response200.content['application/json'], 'application/json이 있어야 함');
+    assert.ok(response200.content['application/json'].schema, 'schema가 있어야 함');
+
+    const schema = response200.content['application/json'].schema;
+    assert.ok(schema.properties, 'properties가 있어야 함');
+    assert.ok(schema.properties.nextPageNumber, 'nextPageNumber 필드가 있어야 함');
+    assert.ok(schema.properties.content, 'content 필드가 있어야 함');
+
+    console.log('✅ 상태 코드별 응답 파싱 테스트 통과');
+  });
+});
+
 console.log('\n🎉 모든 테스트 완료!');
 

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

@@ -0,0 +1,57 @@
+meta {
+  name: 멘토 목록 조회
+  type: http
+  seq: 1
+}
+
+get /mentors?region=미주권&size=3&page=1
+
+headers {
+  Authorization: Bearer {{token}}
+}
+
+docs {
+  RequestParam중, region에 올 수 있는 것들
+  - 미주권
+  - 아시아권
+  - 중국권
+  - 유럽권
+  
+  ---
+  
+  ## 200 OK
+  ```
+  {
+    "nextPageNumber": 1,
+    "content": [
+      {
+        "id": 1,
+        "profileImageUrl": "https://example.com/image.jpg",
+        "nickname": "닉네임",
+        "country": "프랑스",
+        "universityName": "파리 대학교",
+        "term": "2025-1",
+        "menteeCount": 7,
+        "hasBadge": true,
+        "introduction": "안녕하세요",
+        "channels": [
+          {
+            "type": "BLOG",
+            "url": "https://blog.example.com"
+          }
+        ],
+        "isApplied": true
+      }
+    ]
+  }
+  ```
+  
+  ## 404 Not Found
+  
+  ```
+  {
+    "message": "이름에 해당하는 지역을 찾을 수 없습니다."
+  }
+  ```
+}
+