moai-adk 0.12.1__py3-none-any.whl → 0.13.0__py3-none-any.whl

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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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

{moai_adk-0.12.1.dist-info → moai_adk-0.13.0.dist-info}/METADATA

@@ -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.dist-info → moai_adk-0.13.0.dist-info}/RECORD

@@ -27,7 +27,7 @@ moai_adk/core/git/manager.py,sha256=pNqdW4ZON5OCXyrNxynR-ewzIDHYm9_NrgM9aOAOLKg,
 moai_adk/core/project/__init__.py,sha256=w_VdJ6lJDkTMdYYEwj0Io6Ay3ekqsLO3qXInSfXX7Vs,134
 moai_adk/core/project/backup_utils.py,sha256=-zEXIhGsM-MdX1voUIpKxLlR57Y-lqLEZSi8noeKV1E,1775
 moai_adk/core/project/checker.py,sha256=B94mGLHDZkjQnFDgV8sknJDms5oIiHeyKcgxWI87-f8,9523
-moai_adk/core/project/detector.py,sha256=V9TsIA3ST5YrOI7eimZAvZflB17kc1uBeMXiE9wuemE,13813
+moai_adk/core/project/detector.py,sha256=hEtS6VI7Q_3dYk1Sf_ddhljGEuJKt9qphAMDxOsjxq4,10275
 moai_adk/core/project/initializer.py,sha256=yqxePuCO2ednzCOpDZLczyCP079J6Io4pvtynTp4J6w,6724
 moai_adk/core/project/phase_executor.py,sha256=qMUXiFfMVbziuKYXOUcIkhovdobDcvFYDX_TqqlJQpc,11158
 moai_adk/core/project/validator.py,sha256=gH9ywTMQTwqtqBVrMWj5_bPYFrVzjHuFoU4QdeVa1O4,5756
@@ -36,16 +36,16 @@ moai_adk/core/quality/trust_checker.py,sha256=CN067AiublAH46IBAKEV_I-8Wc0bNaR2dM
 moai_adk/core/quality/validators/__init__.py,sha256=Q53sqQFOK7GnwshPVi0HvUSq_VCvHEL28-V5J_L9LoE,189
 moai_adk/core/quality/validators/base_validator.py,sha256=8Fk5casPdfRtnlEfslIK6mOYsZeZLWIK_MAebWCrNw4,437
 moai_adk/core/tags/__init__.py,sha256=nmZKs4eblrOzPg8JOHNkoaRzhPcUDGmMwvnUcyMZwGY,1985
-moai_adk/core/tags/ci_validator.py,sha256=I9EM9Ymzob3jhrdjMEq_LyPis0In-0jmTmfqwvZOOUc,14660
+moai_adk/core/tags/ci_validator.py,sha256=7YwCTihbK2iWiF04-5WYe8LkGkxmra5_XvcRbPrsF-8,14666
 moai_adk/core/tags/cli.py,sha256=1VWRT1k62FS5Yyzllat-nyLR3jqvGdyDkj1uOwPfavA,7344
 moai_adk/core/tags/generator.py,sha256=xVopAAez8K5pNSHWZOGZXEWYIre53lTtfHUlR7i-vNE,3407
 moai_adk/core/tags/inserter.py,sha256=_1lsMTyyrjGidAKqi4y925msHxK6gHLAsu3O8-O2vFM,2823
 moai_adk/core/tags/mapper.py,sha256=ldcfMFzsk-ESKpXAptYydqx2NZ951utqKOXZVTHMeIE,3955
 moai_adk/core/tags/parser.py,sha256=3LpNcL47xT3u4b3Fdf9wYnltChDrNAEV4EtnHqLN1MA,2098
-moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
+moai_adk/core/tags/pre_commit_validator.py,sha256=h6wXm105cwxoTsWTgZPTuX0C5r_3ZTEkrK1enAZZpSs,10236
 moai_adk/core/tags/reporter.py,sha256=fn9kc0FNNvaep5cXbA2RkYxbJsw7eq2PHbrZ_XFB1Wc,29301
 moai_adk/core/tags/tags.py,sha256=Fylt030vrDqhSWivwRbxxwu_uQhilei0SFk_xVzy9UI,4248
-moai_adk/core/tags/validator.py,sha256=B3xUDubfyT5RlPM3GLYktfe1EQTEdxOrDhD230_etoA,31138
+moai_adk/core/tags/validator.py,sha256=3_IQS93WAra1R_J0Oqy-Gl6XYnYMUA_61eUtshOGIaA,31144
 moai_adk/core/template/__init__.py,sha256=BB65Zkar2Oywt1_RFtQKIup6HXq20VNQrYqXD_Qp1_g,354
 moai_adk/core/template/backup.py,sha256=44y3QGCKsYqrRPbzkB1xNM9qtpG6kNNMcWR8DnAcPiQ,3228
 moai_adk/core/template/config.py,sha256=ZJU9UKSGF2tkPiwSFReoCkAHGQ0aN2jKmIIQt88x5-o,3532
@@ -69,23 +69,23 @@ moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=duYOXS1-VPLpFVZU
 moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=oQIPS_Pa-VGiTZn4DH1TWgpk2EFwfTvn38S3zF4OL1M,10579
 moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=W0PwBgmdOhG_tb3dl-G-nFJtdL_0uLxjkGe1PLtUick,10691
 moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=ISdkXhZvwEYCBKVIHYyMGAHInr4ToLf4zVvNSwRVABA,14583
-moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=HNFoQQ7Dc6k9NbcWCBCPSu1bGXxagQwLaQVpvK4OwYo,47086
+moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=awp6rBLkhlWl3AqlU1i1E2QttXmJTFf6Ko7cDPFrQ9U,49643
 moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=RJleHlBtTTp-W-8mEtCF9WjElww6kdlNoqZb_J378m4,29485
 moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=tHsDRxEq_VfHmoiUsM-9YIPyeeRLWsStOuiVGV6XuaI,24800
 moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=NkKl98-3HUlTKLyH0g3Aev-ky251S6mqZj_4hHDBlbA,27057
 moai_adk/templates/.claude/commands/alfred/9-feedback.md,sha256=VMaKo-ZODHun87uUfiihtHGf8eT4vrEWwxXdQ9RAz3k,3764
-moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=g2zwhOJSVRyFDGdrKRTmGcjq6qbHNmustqPZ8ew8Wr0,9222
-moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py,sha256=bWJ1_pS9MALQ9X41Az2JCWTvkg1N4tvq2et13lAj5qs,2733
-moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py,sha256=r3we1chcrPzHENivfvsOmD_fp6XAXu7KlfhepNi-I6c,2761
-moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py,sha256=7XUOOre2D6KMt9_qLYpBck0H0FI62uPhCRHlFsAMZxQ,3207
-moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py,sha256=n1tDFdsDupcgGkjowewrhpnU-BE-LMcpHfBGDZkOm4E,2708
-moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py,sha256=qS7ivLFB1AwNn5TvH1J7NEqDyiA3RFrCOiDFlwcXQog,2730
-moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py,sha256=-WcMB1NgpZZ_rbL8mWKDRijqjYgzEKz9f28GaupzMys,2685
-moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py,sha256=l1FebPbicNhhBFI6REEw4fXjsshWxVtto7pqNILk7SQ,2780
-moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py,sha256=7I6BSKoTRThE1ps5cbIqIpvVX5w9IxjxZ4uvv7zHXas,3409
-moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=_TBtWe0tlyq-B5HZuc5Nnc13KuBHSjhb62vjjCzzb40,27040
+moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=yP1jtT8CI6WE-Ul5xTfiG4TaGDZl-qVxTr8iar790Sc,9225
+moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py,sha256=Kwm433O4lOvIGJ405YkDJO_uRmG8hmgx1c60JCfM3vU,2736
+moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py,sha256=Wq3Z71J17w8Gz2Xpf-wb-fexEtRBpHn26dh3XppHcB4,2762
+moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py,sha256=UKhKu4uyCXdePoy6JxaeTmgvMK3hnYZ54wJTvwxN0Qk,3209
+moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py,sha256=HsvxsepYN-cMb5eGoNGYwejZolMFccjXQvytHOCHvhw,2711
+moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py,sha256=SVOc8PCDnk_2pHGhoEe0pC-oV67L_tLpkoc84BLqTcE,2737
+moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py,sha256=2cXJTduBxmzY2CiElWvshjEp098mT9pIK2HTKL5ITxk,2687
+moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py,sha256=UV53G1yq7wxMG19-IjLP8LLS6TUQrLsxMGsLeXOoHpo,2786
+moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py,sha256=5v63DcDSxbLdpp03_7_4zUYZ5pfXMGW4MQ5b-svyF7k,3410
+moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=AqHVZzSStJEpalxxhDhnh_KnJWhHO1o7ZlXhlyN7NT4,26954
 moai_adk/templates/.claude/hooks/alfred/core/timeout.py,sha256=rIvdz6cLhLeDmZeb90PgslKOlLFRh8_jD_0Ck5ZYKdQ,4046
-moai_adk/templates/.claude/hooks/alfred/core/ttl_cache.py,sha256=4xMGGdrvVJSigrpcL71k6twVWn1nefZWzfl_Su9tgcM,3411
+moai_adk/templates/.claude/hooks/alfred/core/ttl_cache.py,sha256=uPyHn7GPVIY1XwB2rYFrkjFhoXS4SE9_wF5U40tvYfQ,3410
 moai_adk/templates/.claude/hooks/alfred/core/version_cache.py,sha256=zUStwuF4n2NY4hDyu0IXcEl1eDAauVScCZGCz9kGoNY,5967
 moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py,sha256=zr1PEfYRlTYA7GWUPgTP-USSGYh4pGyPiDUkjcltJ7A,6379
 moai_adk/templates/.claude/hooks/alfred/shared/core/checkpoint.py,sha256=dsvFDSXQNSQlaQLpvhqFbytGOrOivyovi43Y18EmNeI,8483
@@ -94,7 +94,7 @@ moai_adk/templates/.claude/hooks/alfred/shared/core/project.py,sha256=3mGIeFea_3
 moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py,sha256=l5JexIG4qXu32f2VCpQ1tTJVsbbsLVvP_unEj8o9vAs,6721
 moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py,sha256=KKsndAwJpHx5Jo1Xbv0-BB3qENjbPgFgDHsV7VWhhjY,5965
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py,sha256=j5L7nayKt7tnFQOZuO5sWiie815vmbmYJOn2VRiidLY,569
-moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py,sha256=1dmVJBsKXCeRer2Hd59enj1COKjElU-x_Kgxyxfea8s,4919
+moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py,sha256=SFWpOOHRH3dA9SJgburGNm4-lUvjWQ43taSrlGw-6v4,4822
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py,sha256=ynM2y21NG3l4bZeUuhZJJ2qQ5YCL35Iv7R3P3zCbNt0,7183
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py,sha256=B5lRqbOb50QugN5LPAMrLy-hqqltC8EbfVUruwUG7DQ,3339
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py,sha256=okgzK5qwGjl_i2O4IWoH-7GaxQ2Q_kutjhnVnk0eDzE,2107
@@ -305,10 +305,8 @@ moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md,sha256=37Qj5DYcyUniLM1g8I
 moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md,sha256=Tf3q68X1DiA3MkIBYu7AMXoeparYrDRpyqVI5Nw92OY,12653
 moai_adk/templates/.moai/memory/CLAUDE-RULES.md,sha256=S9GODGRzwwleOmROVtBDa471Ok5NyQLWIkaO_4peHhU,19783
 moai_adk/templates/.moai/memory/DEVELOPMENT-GUIDE.md,sha256=SAcue1J5-DEJpygDnTgp_ex-ok2E4lbcykBuBiC7tGs,14534
-moai_adk/templates/.moai/memory/GITFLOW-PROTECTION-POLICY.md,sha256=UABdUWcA_085dZaQk7gaW2-ze3DV-BX399kKtbF1kGI,10401
 moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md,sha256=bKzC2v1ZZWyng0eHSj9oFQ9w9xCbadPe9T9IYWub7wM,3824
 moai_adk/templates/.moai/memory/SKILLS-DESCRIPTION-POLICY.md,sha256=uMEFi6uojnpO_MGGtwhakYQzVF2yzVV9ZzfQe5tB0Hk,7823
-moai_adk/templates/.moai/memory/SPEC-METADATA.md,sha256=Ha4ATMxyH2PgQdVbS1fYwVH0PnIkfqk4hfuB5ksMFFk,9702
 moai_adk/templates/.moai/memory/gitflow-protection-policy.md,sha256=UABdUWcA_085dZaQk7gaW2-ze3DV-BX399kKtbF1kGI,10401
 moai_adk/templates/.moai/memory/spec-metadata.md,sha256=Ha4ATMxyH2PgQdVbS1fYwVH0PnIkfqk4hfuB5ksMFFk,9702
 moai_adk/templates/.moai/project/product.md,sha256=IrRSqhu0o5KNfn453DUWoUKzdoO3m6013iYCwaHYCxM,5166
@@ -323,8 +321,8 @@ moai_adk/templates/workflows/typescript-tag-validation.yml,sha256=-hPbfW4ZlMp7Nz
 moai_adk/utils/__init__.py,sha256=VnVfQzzKHvKw4bNdEw5xdscnRQYFrnr-v_TOBr3naPs,225
 moai_adk/utils/banner.py,sha256=znppKd5yo-tTqgyhgPVJjstrTrfcy_v3X1_RFQxP4Fk,1878
 moai_adk/utils/logger.py,sha256=g-m07PGKjK2bKRIInfSn6m-024Bedai-pV_WjZKDeu8,5064
-moai_adk-0.12.1.dist-info/METADATA,sha256=U4PtelM5EGeiKaGGv4ErHcjf_xYYgd3pmOPTp8CthP8,96417
-moai_adk-0.12.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.12.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.12.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.12.1.dist-info/RECORD,,
+moai_adk-0.13.0.dist-info/METADATA,sha256=st-VF-l9LLkgLwc8yOJXBgrOFhR4oaM7EGYigi1_ieM,96417
+moai_adk-0.13.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.13.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.13.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.13.0.dist-info/RECORD,,

moai_adk/templates/.moai/memory/GITFLOW-PROTECTION-POLICY.md

@@ -1,330 +0,0 @@
-# GitFlow Protection Policy
-
-**Document ID**: @DOC:GITFLOW-POLICY-ALIAS
-**Published**: 2025-10-17
-**Updated**: 2025-10-29
-**Status**: **Enforced via GitHub Branch Protection** (v0.8.3+)
-**Scope**: Personal and Team modes
-
----
-
-## Overview
-
-MoAI-ADK **enforces** a GitFlow-inspired workflow through GitHub Branch Protection. As of v0.8.3, the `main` branch is protected and requires Pull Requests for all changes, including from administrators.
-
-**What Changed**: Previously (v0.3.5-v0.8.2), we used an advisory approach with warnings. Now we enforce proper GitFlow to ensure code quality and prevent accidental direct pushes to main.
-
-## Key Requirements (Enforced)
-
-### 1. Main Branch Access (Enforced)
-
-| Requirement | Summary | Enforcement |
-|-------------|---------|-------------|
-| **Merge via develop** | MUST merge `develop` into `main` | ✅ Enforced |
-| **Feature branches off develop** | MUST branch from `develop` and raise PRs back to `develop` | ✅ Enforced |
-| **Release process** | Release flow: `develop` → `main` (PR required) | ✅ Enforced |
-| **Force push** | Blocked on `main` | ✅ Blocked |
-| **Direct push** | Blocked on `main` (PR required) | ✅ Blocked |
-
-### 2. Git Workflow (Required)
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                ENFORCED GITFLOW                         │
-│         (GitHub Branch Protection Active)               │
-└─────────────────────────────────────────────────────────┘
-
-        develop (required base branch)
-          ↑     ↓
-    ┌─────────────────┐
-    │                 │
-    │   developer work │
-    │                 │
-    ↓                 ↑
-feature/SPEC-{ID}   [PR: feature -> develop]
-                     [code review + approval]
-                     [Merge to develop]
-
-    develop (stable)
-         ↓
-         │   (release manager prepares)
-         ↓
-    [PR: develop -> main]
-    [Code review + approval REQUIRED]
-    [All discussions resolved]
-    [CI/CD validation]
-    [tag creation]
-         ↓
-       main (protected release)
-```
-
-**Enforcement**: Direct pushes to `main` are **blocked** via GitHub Branch Protection. All changes must go through Pull Requests.
-
-## Technical Implementation
-
-### Pre-push Hook (Advisory Mode)
-
-**Location**: `.git/hooks/pre-push`  
-**Purpose**: Warn on `main` branch pushes without blocking them
-
-```bash
-# When attempting to push to main:
-⚠️  ADVISORY: Non-standard GitFlow detected
-
-Current branch: feature/SPEC-123
-Target branch: main
-
-Recommended GitFlow workflow:
-  1. Work on feature/SPEC-{ID} branch (created from develop)
-  2. Push to feature/SPEC-{ID} and create PR to develop
-  3. Merge into develop after code review
-  4. When develop is stable, create PR from develop to main
-  5. Release manager merges develop -> main with tag
-
-✓ Push will proceed (flexibility mode enabled)
-```
-
-### Force Push Advisory
-
-```bash
-⚠️  ADVISORY: Force-push to main branch detected
-
-Recommended approach:
-  - Use GitHub PR with proper code review
-  - Ensure changes are merged via fast-forward
-
-✓ Push will proceed (flexibility mode enabled)
-```
-
----
-
-## Workflow Examples
-
-### Scenario 1: Standard Feature Development (Recommended)
-
-```bash
-# 1. Sync latest code from develop
-git checkout develop
-git pull origin develop
-
-# 2. Create a feature branch (from develop)
-git checkout -b feature/SPEC-001-new-feature
-
-# 3. Implement the change
-# ... write code and tests ...
-
-# 4. Commit
-git add .
-git commit -m "..."
-
-# 5. Push
-git push origin feature/SPEC-001-new-feature
-
-# 6. Open a PR: feature/SPEC-001-new-feature -> develop
-
-# 7. Merge into develop after review and approval
-```
-
-### Scenario 2: Fast Hotfix (Flexible)
-
-```bash
-# When an urgent fix is required:
-
-# Option 1: Recommended (via develop)
-git checkout develop
-git checkout -b hotfix/critical-bug
-# ... apply fix ...
-git push origin hotfix/critical-bug
-# Open PRs: hotfix -> develop -> main
-
-# Option 2: Direct fix on main (allowed, not recommended)
-git checkout main
-# ... apply fix ...
-git commit -m "Fix critical bug"
-git push origin main  # ⚠️ Advisory warning appears but push continues
-```
-
-### Scenario 3: Release (Standard or Flexible)
-
-```bash
-# Standard approach (recommended):
-git checkout develop
-gh pr create --base main --head develop --title "Release v1.0.0"
-
-# Direct push (allowed):
-git checkout develop
-git push origin main  # ⚠️ Advisory warning appears but push continues
-git tag -a v1.0.0 -m "Release v1.0.0"
-git push origin v1.0.0
-```
-
----
-
-## Policy Modes
-
-### Strict Mode (Active, v0.8.3+) ✅ ENFORCED
-
-**GitHub Branch Protection Enabled**:
-- ✅ **enforce_admins: true** - Administrators must follow all rules
-- ✅ **required_pull_request_reviews** - 1 approval required
-- ✅ **required_conversation_resolution** - All discussions must be resolved
-- ✅ **Block direct pushes to `main`** - PR required for all users
-- ✅ **Block force pushes** - Prevents history rewriting
-- ✅ **Block branch deletion** - Protects main from accidental deletion
-
-**What This Means**:
-- ❌ No one (including admins) can push directly to `main`
-- ✅ All changes must go through Pull Requests
-- ✅ PRs require code review approval
-- ✅ All code discussions must be resolved before merge
-- ✅ Enforces proper GitFlow: feature → develop → main
-
-### Advisory Mode (Legacy, v0.3.5 - v0.8.2)
-
-- ⚠️ Warned but allowed direct pushes to `main`
-- ⚠️ Warned but allowed force pushes
-- ⚠️ Recommended best practices while preserving flexibility
-- ❌ **Deprecated** - Replaced by Strict Mode for better quality control
-
----
-
-## Recommended Checklist
-
-Every contributor should ensure:
-
-- [ ] `.git/hooks/pre-push` exists and is executable (755)
-- [ ] Feature branches fork from `develop`
-- [ ] Pull requests target `develop`
-- [ ] Releases merge `develop` → `main`
-
-**Verification Commands**:
-```bash
-ls -la .git/hooks/pre-push
-git branch -vv
-```
-
----
-
-## FAQ
-
-**Q: Can we merge into `main` from branches other than `develop`?**  
-A: Yes. You will see an advisory warning, but the merge proceeds. The recommended path remains `develop` → `main`.
-
-**Q: Are force pushes allowed?**  
-A: Yes. You receive a warning, but the push succeeds. Use with caution.
-
-**Q: Can we commit/push directly to `main`?**  
-A: Yes. Expect an advisory warning, yet the push continues.
-
-**Q: Can I disable the hook entirely?**  
-A: Yes. Remove `.git/hooks/pre-push` or strip its execute permission.
-
-**Q: Why switch to Advisory Mode?**
-A: Advisory Mode was used in v0.3.5-v0.8.2. As of v0.8.3, we've switched to Strict Mode with GitHub Branch Protection for better quality control.
-
-**Q: What if develop falls behind main?**
-A: This can happen when hotfixes or releases go directly to main. Regularly sync main → develop to prevent divergence. See "Maintaining develop-main Sync" section below.
-
-**Q: Can I bypass branch protection in emergencies?**
-A: No. Even administrators must follow the PR process. For true emergencies, temporarily disable protection via GitHub Settings (requires admin access), but re-enable immediately after.
-
----
-
-## Maintaining develop-main Sync
-
-### ⚠️ Critical Rule: develop Must Stay Current
-
-**Problem**: When main receives direct commits (hotfixes, emergency releases) without syncing back to develop, GitFlow breaks:
-
-```
-❌ BAD STATE:
-develop: 3 commits ahead, 29 commits behind main
-- develop has outdated dependencies
-- New features branch from old code
-- Merge conflicts multiply over time
-```
-
-### Signs of Drift
-
-Monitor for these warnings:
-- `git status` shows "Your branch is X commits behind main"
-- Feature branches conflict with main during PR
-- CI/CD failures due to dependency mismatches
-- Version numbers in develop don't match main
-
-### Recovery Procedure
-
-When develop falls behind main:
-
-1. **Assess the Gap**
-   ```bash
-   git log --oneline develop..main  # Commits in main but not develop
-   git log --oneline main..develop  # Commits in develop but not main
-   ```
-
-2. **Sync Strategy: Merge main into develop (Recommended)**
-   ```bash
-   git checkout develop
-   git pull origin develop        # Get latest develop
-   git merge main                 # Merge main into develop
-   # Resolve conflicts if any (prefer main for version/config files)
-   git push origin develop
-   ```
-
-3. **Emergency Only: Reset develop to main (Destructive)**
-   ```bash
-   # ⚠️ ONLY if develop's unique commits are unwanted
-   git checkout develop
-   git reset --hard main
-   git push origin develop --force
-   ```
-
-### Prevention: Regular Sync Schedule
-
-**After every main release** (REQUIRED):
-```bash
-# Immediately after merging develop → main:
-git checkout develop
-git merge main
-git push origin develop
-```
-
-**Weekly maintenance** (for active projects):
-```bash
-# Every Monday morning:
-git checkout develop
-git pull origin main
-git push origin develop
-```
-
-### Real-World Case Study (2025-10-29)
-
-**Situation**: develop was 29 commits behind main due to:
-- v0.8.2, v0.8.3 released directly to main
-- No reverse sync to develop
-- Feature branches contained outdated code
-
-**Resolution**:
-- Merged main → develop (14 file conflicts)
-- Resolved conflicts prioritizing main's versions
-- TAG validation bypassed for merge commit
-- Enabled Strict Mode to prevent future direct pushes
-
-**Lesson**: With Strict Mode active, this won't happen again. All releases must go through develop → main PR flow.
-
----
-
-## Policy Change Log
-
-| Date       | Change                                           | Owner        |
-|------|------|--------|
-| 2025-10-17 | Initial policy drafted (Strict Mode)             | git-manager  |
-| 2025-10-17 | Switched to Advisory Mode (warnings only)        | git-manager  |
-| 2025-10-29 | **Enabled GitHub Branch Protection (Strict Mode)** | Alfred       |
-| 2025-10-29 | Added develop-main sync guidelines and real-world case study | Alfred       |
-| 2025-10-29 | Enforced `enforce_admins`, `required_conversation_resolution` | Alfred       |
-
----
-
-**This policy is advisory—adapt it to fit your project needs.**  
-**Reach out to the team lead or release engineer for questions or suggestions.**

moai_adk/templates/.moai/memory/SPEC-METADATA.md

@@ -1,356 +0,0 @@
-# SPEC Metadata Structure Guide
-
-> **MoAI-ADK SPEC Metadata Standard**
->
-> Every SPEC document must follow this structure.
-
----
-
-## 📋 Metadata Overview
-
-SPEC metadata contains **7 required fields** and **9 optional fields**.
-
-### Full Example
-
-```yaml
----
-# Required Fields (7)
-id: AUTH-001                    # Unique SPEC ID
-version: 0.0.1                  # Semantic version (v0.0.1 = INITIAL, draft start)
-status: draft                   # draft|active|completed|deprecated
-created: 2025-09-15             # Creation date (YYYY-MM-DD)
-updated: 2025-09-15             # Last updated (YYYY-MM-DD; initially same as created)
-author: @Goos                   # Author (single GitHub handle)
-priority: high                  # low|medium|high|critical
-
-# Optional Fields – Classification/Meta
-category: security              # feature|bugfix|refactor|security|docs|perf
-labels:                         # Tags for search and grouping
-  - authentication
-  - jwt
-
-# Optional Fields – Relationships (Dependency Graph)
-depends_on:                     # SPECs this one depends on (optional)
-  - USER-001
-blocks:                         # SPECs blocked by this one (optional)
-  - AUTH-002
-related_specs:                  # Related SPECs (optional)
-  - TOKEN-002
-related_issue: "https://github.com/modu-ai/moai-adk/issues/123"
-
-# Optional Fields – Scope/Impact
-scope:
-  packages:                     # Impacted packages
-    - src/core/auth
-  files:                        # Key files (optional)
-    - auth-service.ts
-    - jwt-manager.ts
----
-```
-
----
-
-## Required Fields
-
-### 1. `id` – Unique SPEC Identifier
-- **Type**: string
-- **Format**: `<DOMAIN>-<NUMBER>`
-- **Examples**: `AUTH-001`, `INSTALLER-SEC-001`
-- **Rules**:
-  - Immutable once assigned
-  - Use three digits (001–999)
-  - Domain in uppercase; hyphens allowed
-  - Directory name: `.moai/specs/SPEC-{ID}/` (e.g., `.moai/specs/SPEC-AUTH-001/`)
-
-### 2. `version` – Semantic Version
-- **Type**: string (`MAJOR.MINOR.PATCH`)
-- **Default**: `0.0.1` (all SPECs start here, status: draft)
-- **Version Lifecycle**:
-  - **v0.0.1**: INITIAL – SPEC first draft (status: draft)
-  - **v0.0.x**: Draft refinements (increment PATCH when editing the SPEC)
-  - **v0.1.0**: TDD implementation complete (status: completed, updated via `/alfred:3-sync`)
-  - **v0.1.x**: Bug fixes or doc improvements (PATCH increment)
-  - **v0.x.0**: Feature additions or major enhancements (MINOR increment)
-  - **v1.0.0**: Stable release (production ready, explicit stakeholder approval required)
-
-### 3. `status` – Progress State
-- **Type**: enum
-- **Values**:
-  - `draft`: Authoring in progress
-  - `active`: Implementation underway
-  - `completed`: Implementation finished
-  - `deprecated`: Planned for retirement
-
-### 4. `created` – Creation Date
-- **Type**: date string
-- **Format**: `YYYY-MM-DD`
-- **Example**: `2025-10-06`
-
-### 5. `updated` – Last Modified Date
-- **Type**: date string
-- **Format**: `YYYY-MM-DD`
-- **Rule**: Update whenever the SPEC content changes.
-
-### 6. `author` – Primary Author
-- **Type**: string
-- **Format**: `@{GitHub ID}`
-- **Example**: `@Goos`
-- **Rules**:
-  - Single value only (no `authors` array)
-  - Prefix the GitHub handle with `@`
-  - Additional contributors belong in the HISTORY section
-
-### 7. `priority` – Work Priority
-- **Type**: enum
-- **Values**:
-  - `critical`: Immediate attention (security, severe defects)
-  - `high`: Major feature work
-  - `medium`: Enhancements
-  - `low`: Optimizations or documentation
-
----
-
-## Optional Fields
-
-### Classification / Meta
-
-#### 8. `category` – Change Type
-- **Type**: enum
-- **Values**:
-  - `feature`: New functionality
-  - `bugfix`: Defect resolution
-  - `refactor`: Structural improvements
-  - `security`: Security enhancements
-  - `docs`: Documentation updates
-  - `perf`: Performance optimizations
-
-#### 9. `labels` – Classification Tags
-- **Type**: array of strings
-- **Purpose**: Search, filtering, grouping
-- **Example**:
-  ```yaml
-  labels:
-    - installer
-    - template
-    - security
-  ```
-
-### Relationship Fields (Dependency Graph)
-
-#### 10. `depends_on` – Required SPECs
-- **Type**: array of strings
-- **Meaning**: SPECs that must be completed first
-- **Example**:
-  ```yaml
-  depends_on:
-    - USER-001
-    - AUTH-001
-  ```
-- **Use Case**: Determines execution order and parallelization.
-
-#### 11. `blocks` – Blocked SPECs
-- **Type**: array of strings
-- **Meaning**: SPECs that cannot proceed until this one is resolved
-- **Example**:
-  ```yaml
-  blocks:
-    - PAYMENT-003
-  ```
-
-#### 12. `related_specs` – Associated SPECs
-- **Type**: array of strings
-- **Meaning**: Related items without direct dependencies
-- **Example**:
-  ```yaml
-  related_specs:
-    - TOKEN-002
-    - SESSION-001
-  ```
-
-#### 13. `related_issue` – Linked GitHub Issue
-- **Type**: string (URL)
-- **Format**: Full GitHub issue URL
-- **Example**:
-  ```yaml
-  related_issue: "https://github.com/modu-ai/moai-adk/issues/123"
-  ```
-
-### Scope Fields (Impact Analysis)
-
-#### 14. `scope.packages` – Impacted Packages
-- **Type**: array of strings
-- **Meaning**: Packages or modules touched by the SPEC
-- **Example**:
-  ```yaml
-  scope:
-    packages:
-      - moai-adk-ts/src/core/installer
-      - moai-adk-ts/src/core/git
-  ```
-
-#### 15. `scope.files` – Key Files
-- **Type**: array of strings
-- **Meaning**: Primary files involved (for reference)
-- **Example**:
-  ```yaml
-  scope:
-    files:
-      - template-processor.ts
-      - template-security.ts
-  ```
-
----
-
-## Metadata Validation
-
-### Required Field Checks
-```bash
-# Verify that every SPEC includes the required fields
-rg "^(id|version|status|created|updated|author|priority):" .moai/specs/SPEC-*/spec.md
-
-# Identify SPECs missing the priority field
-rg -L "^priority:" .moai/specs/SPEC-*/spec.md
-```
-
-### Format Checks
-```bash
-# Ensure the author field uses @Handle format
-rg "^author: @[A-Z]" .moai/specs/SPEC-*/spec.md
-
-# Ensure the version field follows 0.x.y
-rg "^version: 0\.\d+\.\d+" .moai/specs/SPEC-*/spec.md
-```
-
----
-
-## Migration Guide
-
-### Updating Existing SPECs
-
-#### 1. Add the `priority` Field
-Add it if missing:
-```yaml
-priority: medium  # or low|high|critical
-```
-
-#### 2. Normalize the `author` Field
-- `authors: ["@goos"]` → `author: @Goos`
-- Convert lowercase handles to the canonical casing.
-
-#### 3. Add Optional Fields (Recommended)
-```yaml
-category: refactor
-labels:
-  - code-quality
-  - maintenance
-```
-
-### Updating config.json for Language Support (v0.4.2+)
-
-**Background**: MoAI-ADK v0.4.2 introduces conversation language selection in `/alfred:0-project`. Existing projects need to add language metadata to `.moai/config.json`.
-
-#### Migration Steps
-
-**For Existing Projects** (before v0.4.2):
-
-Current config.json structure:
-```json
-{
-  "project": {
-    "locale": "en",
-    "mode": "personal",
-    "language": "python"
-  }
-}
-```
-
-**Updated Structure** (v0.4.2+):
-```json
-{
-  "project": {
-    "locale": "en",
-    "mode": "personal",
-    "language": "python",
-    "conversation_language": "en",
-    "conversation_language_name": "English",
-    "codebase_languages": ["python"]
-  }
-}
-```
-
-#### New Fields
-
-| Field | Type | Required | Description | Example |
-|-------|------|----------|-------------|---------|
-| `conversation_language` | string (ISO 639-1 code) | ✅ Yes | Two-letter language code for Alfred dialogs | `"ko"`, `"en"`, `"ja"`, `"zh"` |
-| `conversation_language_name` | string | ✅ Yes | Display name of conversation language | `"Korean"`, `"English"` |
-| `codebase_languages` | array of strings | ✅ Yes | List of programming languages detected | `["python"]`, `["typescript", "python"]` |
-
-#### Manual Update Process
-
-1. Open `.moai/config.json`
-2. Add the three new fields under `project`:
-   ```json
-   "conversation_language": "en",
-   "conversation_language_name": "English",
-   "codebase_languages": ["python"]
-   ```
-3. Save and commit:
-   ```bash
-   git add .moai/config.json
-   git commit -m "chore: add language metadata to config.json for v0.4.2+"
-   ```
-
-#### Automated Update (via `/alfred:0-project`)
-
-Running `/alfred:0-project` on an existing project will:
-1. Detect current language settings
-2. Add new fields automatically
-3. Preserve existing values
-
-**No manual action required if running `/alfred:0-project` after upgrade.**
-
-#### Field Mapping (Legacy → New)
-
-| Old Field | New Field | Migration Rule |
-|-----------|-----------|-----------------|
-| `locale` | `conversation_language` | Keep as-is (or run `/alfred:0-project` to re-select) |
-| (none) | `conversation_language_name` | Auto-populate from locale mapping |
-| `language` | `codebase_languages` | Wrap in array: `"python"` → `["python"]` |
-
-#### Backward Compatibility
-
-- ✅ Projects without new fields will continue working
-- ⚠️ New language features (multilingual documentation) unavailable without migration
-- ✅ `/alfred:0-project` automatically migrates on next run
-- ✅ Auto-detection will prefer new fields if present
-
----
-
-## Design Principles
-
-### 1. DRY (Don't Repeat Yourself)
-- ❌ **Remove**: the `reference` field (every SPEC referenced the same master plan)
-- ✅ **Instead**: document project-level resources in README.md
-
-### 2. Context-Aware
-- Include only the necessary context.
-- Use optional fields only when they add value.
-
-### 3. Traceable
-- Use `depends_on`, `blocks`, and `related_specs` to map dependencies.
-- Automated tooling can detect cyclic references.
-
-### 4. Maintainable
-- Every field must be machine-verifiable.
-- Maintain consistent formatting for easy parsing.
-
-### 5. Simple First
-- Keep complexity low.
-- Limit to 7 required + 9 optional fields.
-- Expand gradually when justified.
-
----
-
-**Last Updated**: 2025-10-06  
-**Author**: @Alfred