moai-adk 0.4.1__tar.gz → 0.4.5__tar.gz

{moai_adk-0.4.1 → moai_adk-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.4.1
+Version: 0.4.5
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -39,6 +39,8 @@ Description-Content-Type: text/markdown
 
 # MoAI-ADK (Agentic Development Kit)
 
+[한국어](README.md) | [English](README.en.md) | [ไทย](README.th.md) | [日本語](README.ja.md) | [中文](README.zh.md) | [हिन्दी](README.hi.md)
+
 [![PyPI version](https://img.shields.io/pypi/v/moai-adk)](https://pypi.org/project/moai-adk/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python](https://img.shields.io/badge/Python-3.13+-blue)](https://www.python.org/)
@@ -95,18 +97,14 @@ MoAI-ADK(MoAI Agentic Development Kit)는 **AI가 개발 과정 전체를 도와
 # 1. (선택) uv 설치 — pip보다 훨씬 빠른 Python 패키지 관리자
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# 2. 가상환경 생성 (권장)
-uv venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
-
-# 3. MoAI-ADK 설치 (tool 모드: 전역-격리 실행)
+# 2. MoAI-ADK 설치 (tool 모드: 전역-격리 실행)
 uv tool install moai-adk
 
-# 4. 새 프로젝트 시작
+# 3. 새 프로젝트 시작
 moai-adk init my-project
 cd my-project
 
-# 5. Claude Code(또는 CLI)에서 Alfred 호출
+# 4. Claude Code(또는 CLI)에서 Alfred 호출
 claude  # Claude Code 실행 후 아래 명령 사용
 /alfred:0-project "프로젝트 이름"
 ```
@@ -115,6 +113,74 @@ claude  # Claude Code 실행 후 아래 명령 사용
 
 ---
 
+## MoAI-ADK 최신 버전 유지하기
+
+### 버전 확인
+```bash
+# 현재 설치된 버전 확인
+moai-adk --version
+
+# PyPI에서 최신 버전 확인
+uv tool list  # moai-adk의 현재 버전 확인
+```
+
+### 업그레이드 하기
+
+#### 방법 1: moai-adk 자체 업데이트 명령어 (가장 간단)
+```bash
+# MoAI-ADK 자체 업데이트 명령어 - 에이전트/Skills 템플릿도 함께 업데이트
+moai-adk update
+
+# 업데이트 후 프로젝트에 새 템플릿 적용 (선택)
+moai-adk init .
+```
+
+#### 방법 2: uv tool 명령어로 업그레이드
+
+**특정 도구만 업그레이드 (권장)**
+```bash
+# moai-adk만 최신 버전으로 업그레이드
+uv tool upgrade moai-adk
+```
+
+**모든 설치된 도구 업그레이드**
+```bash
+# 모든 uv tool 도구를 최신 버전으로 업그레이트
+uv tool update
+```
+
+**특정 버전으로 설치**
+```bash
+# 특정 버전으로 재설치 (예: 0.4.2)
+uv tool install moai-adk==0.4.2
+```
+
+### 업데이트 후 확인
+```bash
+# 1. 설치된 버전 확인
+moai-adk --version
+
+# 2. 프로젝트 정상 작동 확인
+moai-adk doctor
+
+# 3. 기존 프로젝트에 새 템플릿 적용 (필요한 경우)
+cd your-project
+moai-adk init .  # 기존 코드는 유지, .moai/ 구조와 템플릿만 업데이트
+
+# 4. Alfred에서 업데이트된 기능 확인
+cd your-project
+claude
+/alfred:0-project  # 새로운 언어 선택 기능 등을 확인
+```
+
+> 💡 **Tip**:
+> - `moai-adk update`: MoAI-ADK 패키지 버전 업데이트 + 에이전트/Skills 템플릿 동기화
+> - `moai-adk init .`: 기존 프로젝트에 새 템플릿 적용 (코드는 안전하게 유지)
+> - 두 명령을 함께 실행하면 완전한 업데이트가 완료됩니다.
+> - 주요 업데이트(minor/major)가 나오면 위 절차를 실행하여 새로운 에이전트/Skills를 활용할 수 있습니다.
+
+---
+
 ## 기본 워크플로우 (0 → 3)
 
 Alfred는 네 개의 명령으로 프로젝트를 반복 개발합니다.

{moai_adk-0.4.1 → moai_adk-0.4.5}/README.md

@@ -1,5 +1,7 @@
 # MoAI-ADK (Agentic Development Kit)
 
+[한국어](README.md) | [English](README.en.md) | [ไทย](README.th.md) | [日本語](README.ja.md) | [中文](README.zh.md) | [हिन्दी](README.hi.md)
+
 [![PyPI version](https://img.shields.io/pypi/v/moai-adk)](https://pypi.org/project/moai-adk/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python](https://img.shields.io/badge/Python-3.13+-blue)](https://www.python.org/)
@@ -56,18 +58,14 @@ MoAI-ADK(MoAI Agentic Development Kit)는 **AI가 개발 과정 전체를 도와
 # 1. (선택) uv 설치 — pip보다 훨씬 빠른 Python 패키지 관리자
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# 2. 가상환경 생성 (권장)
-uv venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
-
-# 3. MoAI-ADK 설치 (tool 모드: 전역-격리 실행)
+# 2. MoAI-ADK 설치 (tool 모드: 전역-격리 실행)
 uv tool install moai-adk
 
-# 4. 새 프로젝트 시작
+# 3. 새 프로젝트 시작
 moai-adk init my-project
 cd my-project
 
-# 5. Claude Code(또는 CLI)에서 Alfred 호출
+# 4. Claude Code(또는 CLI)에서 Alfred 호출
 claude  # Claude Code 실행 후 아래 명령 사용
 /alfred:0-project "프로젝트 이름"
 ```
@@ -76,6 +74,74 @@ claude  # Claude Code 실행 후 아래 명령 사용
 
 ---
 
+## MoAI-ADK 최신 버전 유지하기
+
+### 버전 확인
+```bash
+# 현재 설치된 버전 확인
+moai-adk --version
+
+# PyPI에서 최신 버전 확인
+uv tool list  # moai-adk의 현재 버전 확인
+```
+
+### 업그레이드 하기
+
+#### 방법 1: moai-adk 자체 업데이트 명령어 (가장 간단)
+```bash
+# MoAI-ADK 자체 업데이트 명령어 - 에이전트/Skills 템플릿도 함께 업데이트
+moai-adk update
+
+# 업데이트 후 프로젝트에 새 템플릿 적용 (선택)
+moai-adk init .
+```
+
+#### 방법 2: uv tool 명령어로 업그레이드
+
+**특정 도구만 업그레이드 (권장)**
+```bash
+# moai-adk만 최신 버전으로 업그레이드
+uv tool upgrade moai-adk
+```
+
+**모든 설치된 도구 업그레이드**
+```bash
+# 모든 uv tool 도구를 최신 버전으로 업그레이트
+uv tool update
+```
+
+**특정 버전으로 설치**
+```bash
+# 특정 버전으로 재설치 (예: 0.4.2)
+uv tool install moai-adk==0.4.2
+```
+
+### 업데이트 후 확인
+```bash
+# 1. 설치된 버전 확인
+moai-adk --version
+
+# 2. 프로젝트 정상 작동 확인
+moai-adk doctor
+
+# 3. 기존 프로젝트에 새 템플릿 적용 (필요한 경우)
+cd your-project
+moai-adk init .  # 기존 코드는 유지, .moai/ 구조와 템플릿만 업데이트
+
+# 4. Alfred에서 업데이트된 기능 확인
+cd your-project
+claude
+/alfred:0-project  # 새로운 언어 선택 기능 등을 확인
+```
+
+> 💡 **Tip**:
+> - `moai-adk update`: MoAI-ADK 패키지 버전 업데이트 + 에이전트/Skills 템플릿 동기화
+> - `moai-adk init .`: 기존 프로젝트에 새 템플릿 적용 (코드는 안전하게 유지)
+> - 두 명령을 함께 실행하면 완전한 업데이트가 완료됩니다.
+> - 주요 업데이트(minor/major)가 나오면 위 절차를 실행하여 새로운 에이전트/Skills를 활용할 수 있습니다.
+
+---
+
 ## 기본 워크플로우 (0 → 3)
 
 Alfred는 네 개의 명령으로 프로젝트를 반복 개발합니다.

{moai_adk-0.4.1 → moai_adk-0.4.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moai-adk"
-version = "0.4.1"
+version = "0.4.5"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent"
 readme = "README.md"
 requires-python = ">=3.13"

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/__init__.py

@@ -4,5 +4,11 @@
 SPEC-First TDD Framework with Alfred SuperAgent
 """
 
-__version__ = "0.4.0"
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("moai-adk")
+except PackageNotFoundError:
+    __version__ = "0.4.1-dev"
+
 __all__ = ["__version__"]

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/cli/commands/update.py

@@ -315,7 +315,7 @@ def update(path: str, force: bool, check: bool) -> None:
             console.print("\n[cyan]💾 Creating backup...[/cyan]")
             processor = TemplateProcessor(project_path)
             backup_path = processor.create_backup()
-            console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}[/green]")
+            console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}/[/green]")
         else:
             console.print("\n[yellow]⚠ Skipping backup (--force)[/yellow]")
 

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/cli/prompts/init_prompts.py

@@ -93,11 +93,11 @@ def prompt_project_setup(
         answers["locale"] = initial_locale or "en"
         if initial_locale:
             console.print(
-                f"[cyan]🌐 Preferred Language:[/cyan] {answers['locale']} (CLI 옵션으로 지정됨)"
+                f"[cyan]🌐 Preferred Language:[/cyan] {answers['locale']} (specified via CLI option)"
             )
         else:
             console.print(
-                "[cyan]🌐 Preferred Language:[/cyan] en (기본값, /alfred:0-project에서 변경 가능)"
+                "[cyan]🌐 Preferred Language:[/cyan] en (default, changeable in /alfred:0-project)"
             )
 
         # 3. Programming language (auto-detect or manual)

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/core/project/backup_utils.py

@@ -3,10 +3,9 @@
 
 Selective backup strategy:
 - Back up only the required files (OR condition)
-- Backup path: .moai-backups/{timestamp}/ (v0.3.0)
+- Backup path: .moai-backups/backup/ (v0.4.2)
 """
 
-from datetime import datetime
 from pathlib import Path
 
 # Backup targets (OR condition - back up when any exist)
@@ -59,15 +58,6 @@ def get_backup_targets(project_path: Path) -> list[str]:
     return targets
 
 
-def generate_backup_dir_name() -> str:
-    """Generate a timestamp-based backup directory name (v0.3.0).
-
-    Returns:
-        Timestamp formatted as YYYYMMDD-HHMMSS.
-        Note: callers use .moai-backups/{timestamp}/ format.
-    """
-    timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
-    return timestamp
 
 
 def is_protected_path(rel_path: Path) -> bool:

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/core/project/checker.py

@@ -298,5 +298,5 @@ def get_permission_fix_message(path: str) -> str:
         Platform-specific fix instructions.
     """
     if platform.system() == "Windows":
-        return f"관리자 권한으로 실행하거나 '{path}' 디렉토리 속성에서 권한을 확인하세요"
-    return f"chmod 755 {path} 실행 후 재시도하세요"
+        return f"Run with administrator privileges or verify permissions in the properties of the '{path}' directory"
+    return f"Run 'chmod 755 {path}' and try again"

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/core/project/phase_executor.py

@@ -1,8 +1,8 @@
 # @CODE:INIT-003:PHASE | SPEC: .moai/specs/SPEC-INIT-003/spec.md | TEST: tests/unit/test_init_reinit.py
-"""Phase-based installation executor (SPEC-INIT-003 v0.3.0)
+"""Phase-based installation executor (SPEC-INIT-003 v0.4.2)
 
 Runs the project initialization across five phases:
-- Phase 1: Preparation (create backup at .moai-backups/{timestamp}/, keep only latest)
+- Phase 1: Preparation (create single backup at .moai-backups/backup/)
 - Phase 2: Directory (build directory structure)
 - Phase 3: Resource (copy templates while preserving user content)
 - Phase 4: Configuration (generate configuration files)
@@ -20,7 +20,6 @@ from rich.console import Console
 
 from moai_adk import __version__
 from moai_adk.core.project.backup_utils import (
-    generate_backup_dir_name,
     get_backup_targets,
     has_any_moai_files,
     is_protected_path,
@@ -229,25 +228,21 @@ class PhaseExecutor:
             self._initialize_git(project_path)
 
     def _create_backup(self, project_path: Path) -> None:
-        """Create a selective backup (v0.3.0).
+        """Create a single backup (v0.4.2).
 
-        Keep only the latest backup in .moai-backups/{timestamp}/.
+        Maintains only one backup at .moai-backups/backup/.
 
         Args:
             project_path: Project path.
         """
         # Define backup directory
         backups_dir = project_path / ".moai-backups"
+        backup_path = backups_dir / "backup"
 
-        # Remove all existing backups (keep only latest)
-        if backups_dir.exists():
-            for item in backups_dir.iterdir():
-                if item.is_dir():
-                    shutil.rmtree(item)
+        # Remove existing backup if present
+        if backup_path.exists():
+            shutil.rmtree(backup_path)
 
-        # Create new backup directory (.moai-backups/{timestamp}/)
-        timestamp = generate_backup_dir_name()
-        backup_path = backups_dir / timestamp
         backup_path.mkdir(parents=True, exist_ok=True)
 
         # Collect backup targets

{moai_adk-0.4.1 → moai_adk-0.4.5}/src/moai_adk/core/quality/__init__.py

@@ -1,5 +1,5 @@
 # @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/
-"""TRUST 원칙 자동 검증 시스템"""
+"""TRUST principle automated validation system"""
 
 from moai_adk.core.quality.trust_checker import TrustChecker