moai-adk 0.12.1__tar.gz → 0.13.0__tar.gz

{moai_adk-0.12.1 → moai_adk-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.12.1
+Version: 0.13.0
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk

{moai_adk-0.12.1 → moai_adk-0.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moai-adk"
-version = "0.12.1"
+version = "0.13.0"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0"
 readme = "README.md"
 requires-python = ">=3.11"

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/core/project/detector.py

@@ -118,107 +118,6 @@ class LanguageDetector:
 
         return False
 
-    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
-    def detect_package_manager(self, path: str | Path = ".") -> str:
-        """Detect JavaScript/TypeScript package manager.
-
-        Checks for lock files in priority order (highest to lowest):
-        1. bun.lockb (Bun) - fastest runtime
-        2. pnpm-lock.yaml (pnpm) - efficient disk usage
-        3. yarn.lock (Yarn) - Facebook's package manager
-        4. package-lock.json (npm) - default Node.js package manager
-
-        Priority order reflects modern best practices and performance characteristics.
-
-        Args:
-            path: Project root directory to inspect. Defaults to current directory.
-
-        Returns:
-            Package manager name: 'bun' | 'pnpm' | 'yarn' | 'npm'
-
-        Example:
-            >>> detector = LanguageDetector()
-            >>> detector.detect_package_manager("/path/to/project")
-            'pnpm'
-        """
-        path = Path(path)
-
-        # Check in priority order (Bun → pnpm → Yarn → npm)
-        if (path / "bun.lockb").exists():
-            return "bun"
-        elif (path / "pnpm-lock.yaml").exists():
-            return "pnpm"
-        elif (path / "yarn.lock").exists():
-            return "yarn"
-        else:
-            # Default to npm (most common, works everywhere)
-            return "npm"
-
-    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
-    def get_workflow_template_path(self, language: str) -> str:
-        """Get workflow template path for detected language.
-
-        Returns the relative path to the language-specific GitHub Actions workflow template.
-        These templates are pre-configured with language-specific testing tools, linting,
-        and coverage reporting.
-
-        Args:
-            language: Detected language name (lowercase).
-                      Supported: 'python', 'javascript', 'typescript', 'go'
-
-        Returns:
-            Relative path to workflow template (e.g., 'workflows/python-tag-validation.yml')
-
-        Raises:
-            ValueError: If language doesn't have a dedicated workflow template
-
-        Example:
-            >>> detector = LanguageDetector()
-            >>> detector.get_workflow_template_path("python")
-            'workflows/python-tag-validation.yml'
-        """
-        # Language-to-template mapping (add new languages here)
-        template_mapping = {
-            "python": "python-tag-validation.yml",
-            "javascript": "javascript-tag-validation.yml",
-            "typescript": "typescript-tag-validation.yml",
-            "go": "go-tag-validation.yml",
-        }
-
-        if language not in template_mapping:
-            supported = ", ".join(sorted(template_mapping.keys()))
-            raise ValueError(
-                f"Language '{language}' does not have a dedicated workflow template. "
-                f"Supported languages: {supported}"
-            )
-
-        template_filename = template_mapping[language]
-        # Return path relative to templates directory
-        return f"workflows/{template_filename}"
-
-    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
-    def get_supported_languages_for_workflows(self) -> list[str]:
-        """Get list of languages with dedicated workflow templates.
-
-        Returns languages that have pre-built GitHub Actions workflow templates
-        with language-specific testing, linting, and coverage configuration.
-
-        Returns:
-            List of supported language names (lowercase)
-
-        Example:
-            >>> detector = LanguageDetector()
-            >>> detector.get_supported_languages_for_workflows()
-            ['python', 'javascript', 'typescript', 'go']
-
-        Note:
-            While LanguageDetector can detect 20+ languages, only these 4
-            have dedicated CI/CD workflow templates. Other languages fall back
-            to generic workflows.
-        """
-        return ["python", "javascript", "typescript", "go"]
-
-
     def get_workflow_template_path(self, language: str) -> str:
         """Get the GitHub Actions workflow template path for a language.
 
@@ -306,9 +205,20 @@ class LanguageDetector:
         if (path / "pyproject.toml").exists():
             return "pip"
 
-        # JavaScript/TypeScript
+        # JavaScript/TypeScript (check in priority order)
         if (path / "package.json").exists():
-            return "npm"
+            # Check for package managers in priority order
+            if (path / "bun.lockb").exists():
+                return "bun"
+            elif (path / "pnpm-lock.yaml").exists():
+                return "pnpm"
+            elif (path / "yarn.lock").exists():
+                return "yarn"
+            elif (path / "package-lock.json").exists():
+                return "npm"
+            else:
+                # Default to npm for package.json without lock files
+                return "npm"
 
         # Go
         if (path / "go.mod").exists():

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/core/tags/ci_validator.py

@@ -290,7 +290,7 @@ class CIValidator(PreCommitValidator):
                 tag = error.tag
                 message = error.message
                 locations = ', '.join([
-                    f"`{f}:{l}`" for f, l in error.locations[:3]
+                    f"`{f}:{line}`" for f, line in error.locations[:3]
                 ])
                 if len(error.locations) > 3:
                     locations += f" (+{len(error.locations) - 3} more)"

{moai_adk-0.12.1/src/moai_adk/templates → moai_adk-0.13.0}/src/moai_adk/core/tags/pre_commit_validator.py

@@ -26,7 +26,7 @@ class ValidationError:
     locations: List[Tuple[str, int]] = field(default_factory=list)
 
     def __str__(self) -> str:
-        loc_str = ", ".join([f"{f}:{l}" for f, l in self.locations])
+        loc_str = ", ".join([f"{f}:{line}" for f, line in self.locations])
         return f"{self.message}: {self.tag} at {loc_str}"
 
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/core/tags/validator.py

@@ -85,7 +85,7 @@ class ValidationIssue:
             "tag": self.tag,
             "message": self.message,
             "locations": [
-                {"file": f, "line": l} for f, l in self.locations
+                {"file": f, "line": line} for f, line in self.locations
             ],
             "suggestion": self.suggestion
         }

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/commands/alfred/0-project.md

@@ -110,9 +110,28 @@ MoAI-ADK의 SuperAgent로서 당신의 프로젝트를 함께 만들어갈 준
 먼저 기본 설정을 진행하겠습니다.
 ```
 
-### 0.1 배치 설계: 언어 선택 + 사용자 닉네임 수집 (1회 호출)
+### 0.1 배치 설계: 언어 선택 + 사용자 닉네임 + GitHub 설정 확인 (1-3회 호출)
 
-Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **단일 배치 호출**로 언어와 닉네임을 동시에 수집합니다:
+Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **배치 호출**로 필수 정보를 수집합니다:
+
+**기본 배치 (항상 실행)**:
+- 언어 선택
+- 사용자 닉네임
+
+**추가 배치 (팀 모드 감지 시)**:
+- GitHub "Automatically delete head branches" 설정 확인
+
+#### 0.1.1 팀 모드 감지
+
+```bash
+# config.json에서 mode 확인
+grep "mode" .moai/config.json
+
+# 결과: "mode": "team" → 추가 질문 포함
+#      "mode": "personal" → 기본 질문만 실행
+```
+
+#### 0.1.2 기본 배치: 언어 선택 + 닉네임
 
 **Example AskUserQuestion Call**:
 ```python
@@ -156,6 +175,42 @@ AskUserQuestion(
 )
 ```
 
+#### 0.1.3 팀 모드 추가 배치: GitHub 설정 확인 (팀 모드만)
+
+**조건**: `config.json`에서 `"mode": "team"` 감지 시 실행
+
+**Example AskUserQuestion Call**:
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "[Team Mode] Is 'Automatically delete head branches' enabled in your GitHub repository settings?",
+            "header": "GitHub Branch Settings",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "✅ Yes, already enabled",
+                    "description": "PR merge 후 자동으로 원격 브랜치 삭제됨"
+                },
+                {
+                    "label": "❌ No, not enabled (Recommended: Enable)",
+                    "description": "Settings → General → '자동 삭제' 체크박스 확인 필요"
+                },
+                {
+                    "label": "🤔 Not sure / Need to check",
+                    "description": "GitHub Settings → General 확인 후 다시 진행"
+                }
+            ]
+        }
+    ]
+)
+```
+
+**응답 처리**:
+- **"Yes, already enabled"** → `auto_delete_branches: true` 저장
+- **"No, not enabled"** → `auto_delete_branches: false` + 권장사항 저장
+- **"Not sure"** → `auto_delete_branches: null` + 경고 메시지
+
 **User Response Example**:
 ```
 Selected Language: 🇰🇷 한국어
@@ -164,22 +219,55 @@ Selected Nickname: GOOS (typed via "Other" option)
 
 ### 0.2 사용자 정보 저장
 
-Alfred가 선택된 언어와 닉네임을 다음과 같이 저장합니다:
+Alfred가 선택된 언어, 닉네임, 그리고 팀 모드 설정을 다음과 같이 저장합니다:
+
+#### 0.2.1 기본 정보 저장 (항상)
 
 ```json
 {
-  "conversation_language": "ko",
-  "conversation_language_name": "한국어",
-  "user_nickname": "GOOS",
-  "selected_at": "2025-10-23T12:34:56Z"
+  "language": {
+    "conversation_language": "ko",
+    "conversation_language_name": "한국어"
+  },
+  "user": {
+    "nickname": "GOOS",
+    "selected_at": "2025-10-23T12:34:56Z"
+  }
 }
 ```
 
+#### 0.2.2 GitHub 설정 저장 (팀 모드만)
+
+**팀 모드 감지 시 추가 저장**:
+```json
+{
+  "github": {
+    "auto_delete_branches": true,
+    "checked_at": "2025-10-23T12:34:56Z",
+    "recommendation": "Branch cleanup will be automated after PR merge"
+  }
+}
+```
+
+**또는 (미활성화 상태)**:
+```json
+{
+  "github": {
+    "auto_delete_branches": false,
+    "checked_at": "2025-10-23T12:34:56Z",
+    "recommendation": "Enable 'Automatically delete head branches' in GitHub Settings → General for better GitFlow workflow"
+  }
+}
+```
+
+#### 0.2.3 저장된 정보 활용
+
 이 정보는:
 - 모든 sub-agents 에게 컨텍스트 파라미터로 전달됨
-- `.moai/config.json` 의 `language` 및 `user` 필드에 저장됨
+- `.moai/config.json` 의 `language`, `user`, `github` 필드에 저장됨
 - CLAUDE.md의 `{{CONVERSATION_LANGUAGE}}` 및 `{{USER_NICKNAME}}` 변수로 치환됨
 - 모든 Alfred 대화에서 사용됨
+- **팀 모드**: git-manager가 GitHub 설정 상태를 참고하여 브랜치 정리 전략 수립
 
 **설정 완료 출력 예시**:
 ```markdown

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py

@@ -53,6 +53,7 @@ Setup sys.path for package imports
 """
 
 import json
+import signal
 import sys
 from pathlib import Path
 from typing import Any
@@ -77,9 +78,6 @@ if str(HOOKS_DIR) not in sys.path:
     sys.path.insert(0, str(HOOKS_DIR))
 
 
-    pass
-
-
 def _hook_timeout_handler(signum, frame):
     """Signal handler for global hook timeout"""
     raise HookTimeoutError("Hook execution exceeded 5-second timeout")

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/core/project.py

@@ -8,8 +8,6 @@ import json
 import socket
 import subprocess
 from contextlib import contextmanager
-
-from .timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
 from pathlib import Path
 from typing import Any
 
@@ -607,7 +605,7 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
         else:
             # Skip caching if module can't be loaded
             version_cache_class = None
-    except (ImportError, OSError) as e:
+    except (ImportError, OSError):
         # Graceful degradation: skip caching on import errors
         version_cache_class = None
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/core/ttl_cache.py

@@ -22,7 +22,6 @@ import threading
 import time
 from typing import Any, Callable, Optional, TypeVar
 
-
 T = TypeVar('T')
 
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-NOTIF | SPEC: Individual hook files for better UX
 """Notification Hook: Handle System Notifications
 
 Claude Code Event: Notification
@@ -26,6 +26,7 @@ from handlers import handle_notification
 
 
 
+
 def main() -> None:
     """Main entry point for Notification hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-LOG | SPEC: Individual hook files for better UX
 """PostToolUse Hook: Log Tool Usage and Changes
 
 Claude Code Event: PostToolUse
@@ -27,6 +27,7 @@ from handlers import handle_post_tool_use
 
 
 
+
 def main() -> None:
     """Main entry point for PostToolUse hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-CKPT | SPEC: Individual hook files for better UX
 """PreToolUse Hook: Automatic Safety Checkpoint Creation
 
 Claude Code Event: PreToolUse
@@ -32,6 +32,7 @@ from handlers import handle_pre_tool_use
 
 
 
+
 def main() -> None:
     """Main entry point for PreToolUse hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-CLEAN | SPEC: Individual hook files for better UX
 """SessionEnd Hook: Session Cleanup and Finalization
 
 Claude Code Event: SessionEnd
@@ -26,6 +26,7 @@ from handlers import handle_session_end
 
 
 
+
 def main() -> None:
     """Main entry point for SessionEnd hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py

@@ -11,10 +11,10 @@ Output: System message with formatted project summary
 
 import json
 import sys
-from pathlib import Path
-from typing import Any
-
+from pathlib import
 from utils.timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
+ Path
+from typing import Any
 
 # Setup import path for shared modules
 HOOKS_DIR = Path(__file__).parent
@@ -25,6 +25,9 @@ if str(SHARED_DIR) not in sys.path:
 from handlers import handle_session_start
 
 
+    pass
+
+
 
 def main() -> None:
     """Main entry point for SessionStart hook
@@ -41,7 +44,7 @@ def main() -> None:
     """
     # Set 5-second timeout
     timeout = CrossPlatformTimeout(5)
-    timeout.start()
+timeout.start()
 
     try:
         # Read JSON payload from stdin

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py

@@ -5,9 +5,7 @@ Notification, Stop, SubagentStop event handling
 """
 
 import json
-from datetime import datetime, timedelta
-
-from utils.timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
+from datetime import datetime
 from pathlib import Path
 
 from core import HookPayload, HookResult

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-STOP | SPEC: Individual hook files for better UX
 """Stop Hook: Handle Execution Interruption
 
 Claude Code Event: Stop
@@ -26,6 +26,7 @@ from handlers import handle_stop
 
 
 
+
 def main() -> None:
     """Main entry point for Stop hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-SUBAGENT | SPEC: Individual hook files for better UX
 """SubagentStop Hook: Handle Sub-agent Termination
 
 Claude Code Event: SubagentStop
@@ -26,6 +26,7 @@ from handlers import handle_subagent_stop
 
 
 
+
 def main() -> None:
     """Main entry point for SubagentStop hook
 

{moai_adk-0.12.1 → moai_adk-0.13.0}/src/moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+# @CODE:HOOKS-CLARITY-DOCS | SPEC: Individual hook files for better UX
 """UserPromptSubmit Hook: Just-In-Time Document Loading
 
 Claude Code Event: UserPromptSubmit