@su-record/vibe 2.4.19 → 2.4.21

package/CLAUDE.md

@@ -25,6 +25,12 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 - `@ts-ignore` 금지 → 타입 문제 근본 해결
 - 모든 함수에 반환 타입 명시
 
+### TypeScript 규칙
+- `any` 타입 사용 금지 → `unknown` + 타입 가드 사용
+- `as any` 캐스팅 금지 → 적절한 인터페이스 정의
+- `@ts-ignore` 금지 → 타입 문제 근본 해결
+- 모든 함수에 반환 타입 명시
+
 ### 에러 처리 필수
 - try-catch 또는 error state 필수
 - 로딩 상태 처리

package/hooks/hooks.json

@@ -122,7 +122,7 @@
         ]
       },
       {
-        "matcher": "(?i)(?!.*gemini)(^gpt\\s|gpt\\s*한테|gpt\\s*에게|gpt\\s*로\\s|gpt\\s*로$|gpt에\\s*물어|gpt.*질문|gpt.*검색|gpt.*찾아|gpt.*알려|gpt.*분석|ask\\s*gpt|use\\s*gpt|with\\s*gpt)",
+        "matcher": "[Gg][Pp][Tt]",
         "hooks": [
           {
             "type": "command",
@@ -132,7 +132,7 @@
         ]
       },
       {
-        "matcher": "(?i)(?!.*gpt)(^gemini\\s|gemini\\s*한테|gemini\\s*에게|gemini\\s*로\\s|gemini\\s*로$|gemini에\\s*물어|gemini.*질문|gemini.*검색|gemini.*찾아|gemini.*알려|gemini.*분석|ask\\s*gemini|use\\s*gemini|with\\s*gemini|제미나이)",
+        "matcher": "[Gg][Ee][Mm][Ii][Nn][Ii]|제미나이",
         "hooks": [
           {
             "type": "command",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.4.19",
+  "version": "2.4.21",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
   "type": "module",
   "main": "dist/cli/index.js",

package/.claude/settings.json

@@ -1,49 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(cat:*)",
-      "Bash(mv:*)",
-      "Bash(sed:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(npm publish:*)",
-      "Bash(git push:*)",
-      "Bash(npm pack)",
-      "Bash(npm install:*)",
-      "Bash(npm view:*)",
-      "Bash(gh release create:*)",
-      "Bash(gh release view:*)",
-      "Bash(npm run build:*)",
-      "Bash(mkdir:*)",
-      "Bash(npm link:*)",
-      "Bash(vibe list:*)",
-      "Bash(vibe read:*)",
-      "Bash(vibe init:*)",
-      "Bash(npm pack:*)",
-      "Bash(npm config set:*)",
-      "Bash(node:*)",
-      "Bash(git restore:*)",
-      "Bash(npm version:*)",
-      "Bash(gh release:*)",
-      "Bash(vibe version:*)",
-      "Bash(vibe update:*)",
-      "Bash(vibe status:*)",
-      "Bash(git rm:*)"
-    ],
-    "deny": [],
-    "ask": []
-  },
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo '[MANDATORY SKILL PROTOCOL] Available skills: vibe-capabilities (vibe features), multi-llm-orchestration (GPT/Gemini usage), tool-fallback (error recovery), context7-usage (library docs), parallel-research (complex problems), git-worktree (branch work), priority-todos (task management). Step 1: For EACH skill state YES/NO with reason. Step 2: Use Skill(name) for YES skills NOW. Step 3: IMPLEMENT only after activation. CRITICAL: Skipping activation makes response WORTHLESS.'",
-            "statusMessage": "Evaluating skills..."
-          }
-        ]
-      }
-    ]
-  }
-}

package/.claude/settings.local.json

@@ -1,28 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx tsc:*)",
-      "Bash(npm login:*)",
-      "Bash(npm whoami:*)",
-      "Bash(git checkout:*)",
-      "Bash(where:*)",
-      "Bash(npm update:*)",
-      "Bash(vibe --version:*)",
-      "Bash(vibe upgrade:*)",
-      "Bash(npm config:*)",
-      "Bash(claude --version)",
-      "Bash(claude mcp list:*)",
-      "Bash(C:Usersendba.localbinclaude.exe --version)",
-      "Bash(\"C:\\\\Users\\\\endba\\\\.local\\\\bin\\\\claude.exe\" --version)",
-      "Bash(npm cache clean:*)",
-      "Bash(git status:*)",
-      "Bash(gh pr create --repo anthropics/claude-plugins-official --title \"feat: add vibe plugin - SPEC-driven AI coding framework\" --body \"$\\(cat <<''EOF''\n## Plugin: vibe\n\nSPEC-driven AI coding framework for Claude Code with parallel agents, BDD verification, and quality assurance.\n\n### Features\n\n- **12 Slash Commands**: `/vibe.spec`, `/vibe.run`, `/vibe.verify`, `/vibe.review`, `/vibe.reason`, `/vibe.diagram`, and more\n- **16 Specialist Agents**: Security, performance, architecture reviewers + language-specific reviewers \\(Python, TypeScript, React, Rails\\)\n- **ULTRAWORK Pipeline**: Parallel execution with ~50% speed improvement through background agents and phase pipelining\n- **BDD Verification**: Behavior-driven development testing against SPEC requirements\n- **Context7 Integration**: Built-in support for up-to-date documentation lookup\n\n### Workflow\n\n```\n/vibe.spec \"feature\" → /vibe.run \"feature\" → /vibe.verify \"feature\"\n```\n\n### Repository\n\nhttps://github.com/su-record/vibe\n\n### License\n\nMIT\nEOF\n\\)\")",
-      "Bash(git rev-parse:*)",
-      "Bash(claude plugin:*)",
-      "Bash(npm unlink:*)",
-      "Bash(find:*)",
-      "Bash(vibe auth status:*)",
-      "Bash(cd:*)"
-    ]
-  }
-}

package/.claude/vibe/rules/languages/dart-flutter.md

@@ -1,509 +0,0 @@
-# 🎯 Dart + Flutter 품질 규칙
-
-## 핵심 원칙 (core에서 상속)
-
-```markdown
-✅ 단일 책임 (SRP)
-✅ 중복 제거 (DRY)
-✅ 재사용성
-✅ 낮은 복잡도
-✅ 함수 ≤ 30줄, build() ≤ 50줄
-✅ 중첩 ≤ 3단계
-✅ Cyclomatic complexity ≤ 10
-```
-
-## Dart/Flutter 특화 규칙
-
-### 1. Immutability 우선 (@immutable)
-
-```dart
-// ❌ Mutable 클래스
-class User {
-  String name;
-  int age;
-
-  User({required this.name, required this.age});
-}
-
-// ✅ Immutable 클래스 + copyWith
-@immutable
-class User {
-  const User({
-    required this.name,
-    required this.age,
-  });
-
-  final String name;
-  final int age;
-
-  User copyWith({
-    String? name,
-    int? age,
-  }) {
-    return User(
-      name: name ?? this.name,
-      age: age ?? this.age,
-    );
-  }
-
-  @override
-  bool operator ==(Object other) =>
-      identical(this, other) ||
-      other is User && name == other.name && age == other.age;
-
-  @override
-  int get hashCode => name.hashCode ^ age.hashCode;
-}
-```
-
-### 2. StatelessWidget 선호
-
-```dart
-// ✅ StatelessWidget (순수 위젯)
-class UserAvatar extends StatelessWidget {
-  const UserAvatar({
-    super.key,
-    required this.imageUrl,
-    this.size = 40.0,
-    this.onTap,
-  });
-
-  final String imageUrl;
-  final double size;
-  final VoidCallback? onTap;
-
-  @override
-  Widget build(BuildContext context) {
-    return GestureDetector(
-      onTap: onTap,
-      child: CircleAvatar(
-        radius: size / 2,
-        backgroundImage: NetworkImage(imageUrl),
-      ),
-    );
-  }
-}
-
-// ❌ StatefulWidget 남용 (상태가 없는데 사용)
-class UserAvatar extends StatefulWidget {
-  // 상태 관리 불필요
-}
-```
-
-### 3. Provider 패턴 (상태 관리)
-
-```dart
-// ✅ Immutable State + ChangeNotifier
-@immutable
-class FeedState {
-  const FeedState({
-    this.feeds = const [],
-    this.isLoading = false,
-    this.error,
-  });
-
-  final List<Feed> feeds;
-  final bool isLoading;
-  final String? error;
-
-  FeedState copyWith({
-    List<Feed>? feeds,
-    bool? isLoading,
-    String? error,
-  }) {
-    return FeedState(
-      feeds: feeds ?? this.feeds,
-      isLoading: isLoading ?? this.isLoading,
-      error: error ?? this.error,
-    );
-  }
-}
-
-class FeedProvider extends ChangeNotifier {
-  FeedState _state = const FeedState();
-  FeedState get state => _state;
-
-  final FeedService _feedService;
-
-  FeedProvider(this._feedService);
-
-  Future<void> loadFeeds() async {
-    _state = _state.copyWith(isLoading: true, error: null);
-    notifyListeners();
-
-    try {
-      final feeds = await _feedService.getFeeds();
-      _state = _state.copyWith(feeds: feeds, isLoading: false);
-    } catch (e) {
-      _state = _state.copyWith(error: e.toString(), isLoading: false);
-    }
-    notifyListeners();
-  }
-}
-
-// 사용
-class FeedScreen extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    final feedState = context.watch<FeedProvider>().state;
-
-    if (feedState.isLoading) return const CircularProgressIndicator();
-    if (feedState.error != null) return ErrorWidget(feedState.error!);
-
-    return FeedList(feeds: feedState.feeds);
-  }
-}
-```
-
-### 4. Null Safety 명확히
-
-```dart
-// ✅ Null safety 활용
-class User {
-  User({
-    required this.id,        // Non-nullable (필수)
-    required this.name,
-    this.bio,                // Nullable (선택)
-  });
-
-  final String id;
-  final String name;
-  final String? bio;        // ? 명시
-
-  String getBioOrDefault() {
-    return bio ?? 'No bio';  // ?? 연산자
-  }
-
-  void printBio() {
-    bio?.length;             // ?. 안전 호출
-  }
-}
-
-// ✅ Late 변수 (초기화 지연)
-class MyWidget extends StatefulWidget {
-  @override
-  State<MyWidget> createState() => _MyWidgetState();
-}
-
-class _MyWidgetState extends State<MyWidget> {
-  late AnimationController _controller;  // initState에서 초기화
-
-  @override
-  void initState() {
-    super.initState();
-    _controller = AnimationController(vsync: this);
-  }
-
-  @override
-  void dispose() {
-    _controller.dispose();
-    super.dispose();
-  }
-}
-```
-
-### 5. 위젯 분리 (Extract Widget)
-
-```dart
-// ❌ 긴 build 메서드 (80줄)
-class UserProfile extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      children: [
-        // 30줄: 헤더
-        Container(...),
-        // 25줄: 통계
-        Row(...),
-        // 25줄: 피드 리스트
-        ListView(...),
-      ],
-    );
-  }
-}
-
-// ✅ 서브 위젯으로 분리
-class UserProfile extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      children: [
-        const ProfileHeader(),
-        const ProfileStats(),
-        const ProfileFeedList(),
-      ],
-    );
-  }
-}
-
-class ProfileHeader extends StatelessWidget {
-  const ProfileHeader({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    // 헤더만
-  }
-}
-
-class ProfileStats extends StatelessWidget {
-  const ProfileStats({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    // 통계만
-  }
-}
-```
-
-### 6. 순수 함수 (Static Methods)
-
-```dart
-// ✅ 순수 함수 (상태 없음)
-class DateUtils {
-  // Private constructor (인스턴스 생성 방지)
-  DateUtils._();
-
-  static String formatRelativeTime(DateTime dateTime) {
-    final now = DateTime.now();
-    final difference = now.difference(dateTime);
-
-    if (difference.inDays > 0) return '${difference.inDays}일 전';
-    if (difference.inHours > 0) return '${difference.inHours}시간 전';
-    return '${difference.inMinutes}분 전';
-  }
-
-  static bool isToday(DateTime dateTime) {
-    final now = DateTime.now();
-    return dateTime.year == now.year &&
-           dateTime.month == now.month &&
-           dateTime.day == now.day;
-  }
-}
-
-// 사용
-final formatted = DateUtils.formatRelativeTime(feed.createdAt);
-```
-
-### 7. 에러 처리 (Result/Either 패턴)
-
-```dart
-// ✅ Result 타입으로 에러 처리
-sealed class Result<T> {
-  const Result();
-}
-
-class Success<T> extends Result<T> {
-  const Success(this.value);
-  final T value;
-}
-
-class Failure<T> extends Result<T> {
-  const Failure(this.error);
-  final String error;
-}
-
-// 사용
-Future<Result<User>> login(String email, String password) async {
-  try {
-    final user = await _authService.login(email, password);
-    return Success(user);
-  } catch (e) {
-    return Failure(e.toString());
-  }
-}
-
-// 호출부 (Pattern matching)
-final result = await login(email, password);
-switch (result) {
-  case Success(:final value):
-    Navigator.pushReplacement(context, HomePage(user: value));
-  case Failure(:final error):
-    showErrorDialog(context, error);
-}
-```
-
-### 8. Extension Methods
-
-```dart
-// ✅ Extension으로 기능 확장
-extension StringExtension on String {
-  String capitalize() {
-    if (isEmpty) return this;
-    return '${this[0].toUpperCase()}${substring(1)}';
-  }
-
-  bool get isEmail {
-    final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
-    return emailRegex.hasMatch(this);
-  }
-}
-
-extension ListExtension<T> on List<T> {
-  List<T> distinctBy<K>(K Function(T) keySelector) {
-    final seen = <K>{};
-    return where((item) => seen.add(keySelector(item))).toList();
-  }
-}
-
-// 사용
-final name = 'john'.capitalize();  // 'John'
-final isValid = 'test@example.com'.isEmail;  // true
-```
-
-### 9. const Constructor 활용
-
-```dart
-// ✅ const constructor (컴파일 타임 상수)
-class AppColors {
-  const AppColors._();
-
-  static const primary = Color(0xFF6200EE);
-  static const secondary = Color(0xFF03DAC6);
-  static const error = Color(0xFFB00020);
-}
-
-class Spacing {
-  const Spacing._();
-
-  static const xs = 4.0;
-  static const sm = 8.0;
-  static const md = 16.0;
-  static const lg = 24.0;
-  static const xl = 32.0;
-}
-
-// ✅ const 위젯 (재사용 시 성능 향상)
-class LoadingIndicator extends StatelessWidget {
-  const LoadingIndicator({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return const Center(
-      child: CircularProgressIndicator(),
-    );
-  }
-}
-
-// 사용
-const LoadingIndicator()  // const로 생성
-```
-
-### 10. 비동기 처리 (Future/Stream)
-
-```dart
-// ✅ Future (단일 비동기 작업)
-Future<List<Feed>> fetchFeeds() async {
-  final response = await dio.get('/api/feeds');
-  return (response.data as List)
-      .map((json) => Feed.fromJson(json))
-      .toList();
-}
-
-// ✅ Stream (연속 비동기 이벤트)
-Stream<List<Feed>> watchFeeds() {
-  return Stream.periodic(
-    const Duration(seconds: 30),
-    (_) => fetchFeeds(),
-  ).asyncMap((future) => future);
-}
-
-// ✅ StreamBuilder 사용
-class FeedStream extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return StreamBuilder<List<Feed>>(
-      stream: watchFeeds(),
-      builder: (context, snapshot) {
-        if (snapshot.connectionState == ConnectionState.waiting) {
-          return const LoadingIndicator();
-        }
-        if (snapshot.hasError) {
-          return ErrorWidget(snapshot.error.toString());
-        }
-        if (!snapshot.hasData) {
-          return const EmptyState();
-        }
-
-        return FeedList(feeds: snapshot.data!);
-      },
-    );
-  }
-}
-```
-
-## 안티패턴
-
-```dart
-// ❌ Mutable state
-class BadCounter extends StatefulWidget {
-  int count = 0;  // 위험! StatefulWidget은 재생성될 수 있음
-
-  @override
-  State<BadCounter> createState() => _BadCounterState();
-}
-
-// ❌ BuildContext를 async gap 너머에서 사용
-Future<void> badNavigate() async {
-  await Future.delayed(Duration(seconds: 1));
-  Navigator.push(context, ...);  // ❌ context가 무효화됐을 수 있음
-}
-
-// ✅ mounted 체크
-Future<void> goodNavigate() async {
-  await Future.delayed(Duration(seconds: 1));
-  if (!mounted) return;
-  Navigator.push(context, ...);
-}
-
-// ❌ setState에서 긴 작업
-setState(() {
-  // 10줄의 복잡한 계산  ❌
-});
-
-// ✅ 계산 후 setState
-final newValue = expensiveCalculation();
-setState(() {
-  _value = newValue;  // 간단한 할당만
-});
-
-// ❌ GlobalKey 남용
-final GlobalKey<FormState> _formKey = GlobalKey();
-
-// ✅ Controller 사용
-final TextEditingController _controller = TextEditingController();
-```
-
-## 코드 품질 도구
-
-```bash
-# 분석
-flutter analyze
-
-# 포맷팅
-dart format .
-
-# 테스트
-flutter test
-flutter test --coverage
-
-# 빌드
-flutter build apk --release
-flutter build ios --release
-flutter build web --release
-```
-
-## 체크리스트
-
-Dart/Flutter 코드 작성 시:
-
-- [ ] @immutable + copyWith 패턴
-- [ ] StatelessWidget 우선 사용
-- [ ] Provider로 상태 관리 분리
-- [ ] Null safety (?, ??, ?., !)
-- [ ] build() ≤ 50줄 (위젯 분리)
-- [ ] 순수 함수 (static methods)
-- [ ] Result 타입으로 에러 처리
-- [ ] Extension methods 활용
-- [ ] const constructor 사용
-- [ ] Future/Stream 적절히 선택
-- [ ] 복잡도 ≤ 10