moai-adk 0.8.3__py3-none-any.whl → 0.9.1__py3-none-any.whl

moai_adk/cli/commands/update.py

@@ -37,9 +37,11 @@ Includes:
    - Use backup to restore previous state
    - Debug with `python -m moai_adk doctor --verbose`
 """
+
 from __future__ import annotations
 
 import json
+import logging
 import subprocess
 from datetime import datetime
 from pathlib import Path
@@ -53,6 +55,7 @@ from moai_adk import __version__
 from moai_adk.core.template.processor import TemplateProcessor
 
 console = Console()
+logger = logging.getLogger(__name__)
 
 # Constants for tool detection
 TOOL_DETECTION_TIMEOUT = 5  # seconds
@@ -65,26 +68,31 @@ PIP_COMMAND = ["pip", "install", "--upgrade", "moai-adk"]
 # Custom exceptions for better error handling
 class UpdateError(Exception):
     """Base exception for update operations."""
+
     pass
 
 
 class InstallerNotFoundError(UpdateError):
     """Raised when no package installer detected."""
+
     pass
 
 
 class NetworkError(UpdateError):
     """Raised when network operation fails."""
+
     pass
 
 
 class UpgradeError(UpdateError):
     """Raised when package upgrade fails."""
+
     pass
 
 
 class TemplateSyncError(UpdateError):
     """Raised when template sync fails."""
+
     pass
 
 
@@ -96,11 +104,7 @@ def _is_installed_via_uv_tool() -> bool:
     """
     try:
         result = subprocess.run(
-            ["uv", "tool", "list"],
-            capture_output=True,
-            text=True,
-            timeout=TOOL_DETECTION_TIMEOUT,
-            check=False
+            ["uv", "tool", "list"], capture_output=True, text=True, timeout=TOOL_DETECTION_TIMEOUT, check=False
         )
         return result.returncode == 0 and "moai-adk" in result.stdout
     except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
@@ -115,11 +119,7 @@ def _is_installed_via_pipx() -> bool:
     """
     try:
         result = subprocess.run(
-            ["pipx", "list"],
-            capture_output=True,
-            text=True,
-            timeout=TOOL_DETECTION_TIMEOUT,
-            check=False
+            ["pipx", "list"], capture_output=True, text=True, timeout=TOOL_DETECTION_TIMEOUT, check=False
         )
         return result.returncode == 0 and "moai-adk" in result.stdout
     except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
@@ -134,11 +134,7 @@ def _is_installed_via_pip() -> bool:
     """
     try:
         result = subprocess.run(
-            ["pip", "show", "moai-adk"],
-            capture_output=True,
-            text=True,
-            timeout=TOOL_DETECTION_TIMEOUT,
-            check=False
+            ["pip", "show", "moai-adk"], capture_output=True, text=True, timeout=TOOL_DETECTION_TIMEOUT, check=False
         )
         return result.returncode == 0
     except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
@@ -274,6 +270,7 @@ def _get_project_config_version(project_path: Path) -> str:
     Raises:
         ValueError: If config.json exists but cannot be parsed
     """
+
     def _is_placeholder(value: str) -> bool:
         """Check if value contains unsubstituted template placeholders."""
         return isinstance(value, str) and value.startswith("{{") and value.endswith("}}")
@@ -302,6 +299,200 @@ def _get_project_config_version(project_path: Path) -> str:
         raise ValueError(f"Failed to parse project config.json: {e}") from e
 
 
+# @CODE:UPDATE-CACHE-FIX-001-001-DETECT-STALE
+def _detect_stale_cache(upgrade_output: str, current_version: str, latest_version: str) -> bool:
+    """
+    Detect if uv cache is stale by comparing versions.
+
+    A stale cache occurs when PyPI metadata is outdated, causing uv to incorrectly
+    report "Nothing to upgrade" even though a newer version exists. This function
+    detects this condition by:
+    1. Checking if upgrade output contains "Nothing to upgrade"
+    2. Verifying that latest version is actually newer than current version
+
+    Uses packaging.version.parse() for robust semantic version comparison that
+    handles pre-releases, dev versions, and other PEP 440 version formats correctly.
+
+    Args:
+        upgrade_output: Output from uv tool upgrade command
+        current_version: Currently installed version (string, e.g., "0.8.3")
+        latest_version: Latest version available on PyPI (string, e.g., "0.9.0")
+
+    Returns:
+        True if cache is stale (output shows "Nothing to upgrade" but current < latest),
+        False otherwise
+
+    Examples:
+        >>> _detect_stale_cache("Nothing to upgrade", "0.8.3", "0.9.0")
+        True
+        >>> _detect_stale_cache("Updated moai-adk", "0.8.3", "0.9.0")
+        False
+        >>> _detect_stale_cache("Nothing to upgrade", "0.9.0", "0.9.0")
+        False
+    """
+    # Check if output indicates no upgrade needed
+    if not upgrade_output or "Nothing to upgrade" not in upgrade_output:
+        return False
+
+    # Compare versions using packaging.version
+    try:
+        current_v = version.parse(current_version)
+        latest_v = version.parse(latest_version)
+        return current_v < latest_v
+    except (version.InvalidVersion, TypeError) as e:
+        # Graceful degradation: if version parsing fails, assume cache is not stale
+        logger.debug(f"Version parsing failed: {e}")
+        return False
+
+
+# @CODE:UPDATE-CACHE-FIX-001-002-CLEAR-SUCCESS
+def _clear_uv_package_cache(package_name: str = "moai-adk") -> bool:
+    """
+    Clear uv cache for specific package.
+
+    Executes `uv cache clean <package>` with 10-second timeout to prevent
+    hanging on network issues. Provides user-friendly error handling for
+    various failure scenarios (timeout, missing uv, etc.).
+
+    Args:
+        package_name: Package name to clear cache for (default: "moai-adk")
+
+    Returns:
+        True if cache cleared successfully, False otherwise
+
+    Exceptions:
+        - subprocess.TimeoutExpired: Logged as warning, returns False
+        - FileNotFoundError: Logged as warning, returns False
+        - Exception: Logged as warning, returns False
+
+    Examples:
+        >>> _clear_uv_package_cache("moai-adk")
+        True  # If uv cache clean succeeds
+    """
+    try:
+        result = subprocess.run(
+            ["uv", "cache", "clean", package_name],
+            capture_output=True,
+            text=True,
+            timeout=10,  # 10 second timeout
+            check=False,
+        )
+
+        if result.returncode == 0:
+            logger.debug(f"UV cache cleared for {package_name}")
+            return True
+        else:
+            logger.warning(f"Failed to clear UV cache: {result.stderr}")
+            return False
+
+    except subprocess.TimeoutExpired:
+        logger.warning(f"UV cache clean timed out for {package_name}")
+        return False
+    except FileNotFoundError:
+        logger.warning("UV command not found. Is uv installed?")
+        return False
+    except Exception as e:
+        logger.warning(f"Unexpected error clearing cache: {e}")
+        return False
+
+
+# @CODE:UPDATE-CACHE-FIX-001-003-RETRY-LOGIC
+def _execute_upgrade_with_retry(installer_cmd: list[str], package_name: str = "moai-adk") -> bool:
+    """
+    Execute upgrade with automatic cache retry on stale detection.
+
+    Implements a robust 7-stage upgrade flow that handles PyPI cache staleness:
+
+    Stage 1: First upgrade attempt (up to 60 seconds)
+    Stage 2: Check success condition (returncode=0 AND no "Nothing to upgrade")
+    Stage 3: Detect stale cache using _detect_stale_cache()
+    Stage 4: Show user feedback if stale cache detected
+    Stage 5: Clear cache using _clear_uv_package_cache()
+    Stage 6: Retry upgrade with same command
+    Stage 7: Return final result (success or failure)
+
+    Retry Logic:
+    - Only ONE retry is performed to prevent infinite loops
+    - Retry only happens if stale cache is detected AND cache clear succeeds
+    - Cache clear failures are reported to user with manual workaround
+
+    User Feedback:
+    - Shows emoji-based status messages for each stage
+    - Clear guidance on manual workaround if automatic retry fails
+    - All errors logged at WARNING level for debugging
+
+    Args:
+        installer_cmd: Command list from _detect_tool_installer()
+                      e.g., ["uv", "tool", "upgrade", "moai-adk"]
+        package_name: Package name for cache clearing (default: "moai-adk")
+
+    Returns:
+        True if upgrade succeeded (either first attempt or after retry),
+        False otherwise
+
+    Examples:
+        >>> # First attempt succeeds
+        >>> _execute_upgrade_with_retry(["uv", "tool", "upgrade", "moai-adk"])
+        True
+
+        >>> # First attempt stale, retry succeeds
+        >>> _execute_upgrade_with_retry(["uv", "tool", "upgrade", "moai-adk"])
+        True  # After cache clear and retry
+
+    Raises:
+        subprocess.TimeoutExpired: Re-raised if upgrade command times out
+    """
+    # Stage 1: First upgrade attempt
+    try:
+        result = subprocess.run(installer_cmd, capture_output=True, text=True, timeout=60, check=False)
+    except subprocess.TimeoutExpired:
+        raise  # Re-raise timeout for caller to handle
+    except Exception:
+        return False
+
+    # Stage 2: Check if upgrade succeeded without stale cache
+    if result.returncode == 0 and "Nothing to upgrade" not in result.stdout:
+        return True
+
+    # Stage 3: Detect stale cache
+    try:
+        current_version = _get_current_version()
+        latest_version = _get_latest_version()
+    except RuntimeError:
+        # If version check fails, return original result
+        return result.returncode == 0
+
+    if _detect_stale_cache(result.stdout, current_version, latest_version):
+        # Stage 4: User feedback
+        console.print("[yellow]⚠️ Cache outdated, refreshing...[/yellow]")
+
+        # Stage 5: Clear cache
+        if _clear_uv_package_cache(package_name):
+            console.print("[cyan]♻️ Cache cleared, retrying upgrade...[/cyan]")
+
+            # Stage 6: Retry upgrade
+            try:
+                result = subprocess.run(installer_cmd, capture_output=True, text=True, timeout=60, check=False)
+
+                if result.returncode == 0:
+                    return True
+                else:
+                    console.print("[red]✗ Upgrade failed after retry[/red]")
+                    return False
+            except subprocess.TimeoutExpired:
+                raise  # Re-raise timeout
+            except Exception:
+                return False
+        else:
+            # Cache clear failed
+            console.print("[red]✗ Cache clear failed. Manual workaround:[/red]")
+            console.print("  [cyan]uv cache clean moai-adk && moai-adk update[/cyan]")
+            return False
+
+    # Stage 7: Cache is not stale, return original result
+    return result.returncode == 0
+
+
 def _execute_upgrade(installer_cmd: list[str]) -> bool:
     """Execute package upgrade using detected installer.
 
@@ -316,13 +507,7 @@ def _execute_upgrade(installer_cmd: list[str]) -> bool:
         subprocess.TimeoutExpired: If upgrade times out
     """
     try:
-        result = subprocess.run(
-            installer_cmd,
-            capture_output=True,
-            text=True,
-            timeout=60,
-            check=False
-        )
+        result = subprocess.run(installer_cmd, capture_output=True, text=True, timeout=60, check=False)
         return result.returncode == 0
     except subprocess.TimeoutExpired:
         raise  # Re-raise timeout for caller to handle
@@ -395,10 +580,7 @@ def set_optimized_false(project_path: Path) -> None:
     try:
         config_data = json.loads(config_path.read_text(encoding="utf-8"))
         config_data.setdefault("project", {})["optimized"] = False
-        config_path.write_text(
-            json.dumps(config_data, indent=2, ensure_ascii=False) + "\n",
-            encoding="utf-8"
-        )
+        config_path.write_text(json.dumps(config_data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
     except (json.JSONDecodeError, KeyError):
         # Ignore errors if config.json is invalid
         pass
@@ -536,10 +718,7 @@ def _preserve_project_metadata(
     # This allows Stage 2 to compare package vs project template versions
     project_data["template_version"] = version_for_config
 
-    config_path.write_text(
-        json.dumps(config_data, indent=2, ensure_ascii=False) + "\n",
-        encoding="utf-8"
-    )
+    config_path.write_text(json.dumps(config_data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
 
 
 def _apply_context_to_file(processor: TemplateProcessor, target_path: Path) -> None:
@@ -629,32 +808,11 @@ def _show_timeout_error_help() -> None:
 
 
 @click.command()
-@click.option(
-    "--path",
-    type=click.Path(exists=True),
-    default=".",
-    help="Project path (default: current directory)"
-)
-@click.option(
-    "--force",
-    is_flag=True,
-    help="Skip backup and force the update"
-)
-@click.option(
-    "--check",
-    is_flag=True,
-    help="Only check version (do not update)"
-)
-@click.option(
-    "--templates-only",
-    is_flag=True,
-    help="Skip package upgrade, sync templates only"
-)
-@click.option(
-    "--yes",
-    is_flag=True,
-    help="Auto-confirm all prompts (CI/CD mode)"
-)
+@click.option("--path", type=click.Path(exists=True), default=".", help="Project path (default: current directory)")
+@click.option("--force", is_flag=True, help="Skip backup and force the update")
+@click.option("--check", is_flag=True, help="Only check version (do not update)")
+@click.option("--templates-only", is_flag=True, help="Skip package upgrade, sync templates only")
+@click.option("--yes", is_flag=True, help="Auto-confirm all prompts (CI/CD mode)")
 def update(path: str, force: bool, check: bool, templates_only: bool, yes: bool) -> None:
     """Update command with 3-stage workflow (v0.6.3+).
 

moai_adk/core/tags/pre_commit_validator.py

@@ -206,7 +206,6 @@ class PreCommitValidator:
                 for line_num, line in enumerate(lines, start=1):
                     matches = self.tag_pattern.findall(line)
                     for prefix, domain in matches:
-                        tag = f"@{prefix}:{domain}"
                         if domain not in tags_by_type[prefix]:
                             tags_by_type[prefix][domain] = []
                         tags_by_type[prefix][domain].append((filepath, line_num))

moai_adk/core/tags/reporter.py

@@ -224,7 +224,6 @@ class InventoryGenerator:
 
                 for tag_type, domain in matches:
                     tag_id = domain
-                    full_tag = f"@{tag_type}:{domain}"
 
                     # Extract context (±2 lines)
                     context_lines = []
@@ -421,7 +420,7 @@ class MatrixGenerator:
             spec = "1" if row["SPEC"] else "0"
             code = "1" if row["CODE"] else "0"
             test = "1" if row["TEST"] else "0"
-            doc = "1" if row["DOC"] else "0"
+            "1" if row["DOC"] else "0"
             completion = f"{matrix.completion_percentages[domain]:.1f}"
 
             lines.append(f"{domain},{spec},{code},{test},{completion}")

moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py

@@ -4,6 +4,9 @@
 Handling the UserPromptSubmit event
 """
 
+from datetime import datetime
+from pathlib import Path
+
 from core import HookPayload, HookResult
 from core.context import get_jit_context
 
@@ -29,11 +32,27 @@ def handle_user_prompt_submit(payload: HookPayload) -> HookResult:
         - GREEN: Recommend documents by calling get_jit_context()
         - REFACTOR: Message conditional display (only when there is a file)
         - UPDATE: Migrated to Claude Code standard Hook schema with snake_case fields
+        - FEATURE: Command execution logging for tracking double-run debugging
     """
     user_prompt = payload.get("userPrompt", "")
     cwd = payload.get("cwd", ".")
     context_files = get_jit_context(user_prompt, cwd)
 
+    # Command execution logging (DEBUG feature for tracking invocations)
+    if user_prompt.startswith("/alfred:"):
+        try:
+            log_dir = Path(cwd) / ".moai" / "logs"
+            log_dir.mkdir(parents=True, exist_ok=True)
+
+            log_file = log_dir / "command-invocations.log"
+            timestamp = datetime.now().isoformat()
+
+            with open(log_file, "a", encoding="utf-8") as f:
+                f.write(f"{timestamp} | {user_prompt}\n")
+        except Exception:
+            # Silently fail if logging fails (don't interrupt main flow)
+            pass
+
     system_message = f"📎 Loaded {len(context_files)} context file(s)" if context_files else None
 
     return HookResult(system_message=system_message, context_files=context_files)

moai_adk/templates/.github/workflows/tag-validation.yml

@@ -1,6 +1,6 @@
 name: TAG Validation
 
-# @DOC:DOC-TAG-004 | Component 2: CI/CD workflow for TAG validation
+# @DOC:DOC-TAG-005 | Component 2: CI/CD workflow for TAG validation (template)
 # Validates TAG annotations on every PR to ensure quality and consistency
 
 on:
@@ -26,7 +26,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
+          python-version: '3.13'
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5

moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py

@@ -206,7 +206,6 @@ class PreCommitValidator:
                 for line_num, line in enumerate(lines, start=1):
                     matches = self.tag_pattern.findall(line)
                     for prefix, domain in matches:
-                        tag = f"@{prefix}:{domain}"
                         if domain not in tags_by_type[prefix]:
                             tags_by_type[prefix][domain] = []
                         tags_by_type[prefix][domain].append((filepath, line_num))

moai_adk/templates/src/moai_adk/core/tags/reporter.py

@@ -224,7 +224,6 @@ class InventoryGenerator:
 
                 for tag_type, domain in matches:
                     tag_id = domain
-                    full_tag = f"@{tag_type}:{domain}"
 
                     # Extract context (±2 lines)
                     context_lines = []
@@ -421,7 +420,7 @@ class MatrixGenerator:
             spec = "1" if row["SPEC"] else "0"
             code = "1" if row["CODE"] else "0"
             test = "1" if row["TEST"] else "0"
-            doc = "1" if row["DOC"] else "0"
+            "1" if row["DOC"] else "0"
             completion = f"{matrix.completion_percentages[domain]:.1f}"
 
             lines.append(f"{domain},{spec},{code},{test},{completion}")

{moai_adk-0.8.3.dist-info → moai_adk-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.8.3
+Version: 0.9.1
 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
@@ -829,6 +829,40 @@ This issue has been **fixed** in v0.8.1+. If you're experiencing this:
 - Code now gracefully handles InvalidVersion exceptions
 - Added comprehensive unit tests for placeholder detection
 
+#### Problem: UV Tool Upgrade Shows "Nothing to upgrade" Despite New Version
+
+**Status**: Automatically fixed in v0.9.1+ with cache refresh retry
+
+**Symptoms:**
+- `moai-adk update` shows "Nothing to upgrade"
+- PyPI has a newer version available
+- Caused by stale UV cache metadata
+
+**Automatic Fix (v0.9.1+):**
+The system now automatically detects stale cache and retries:
+1. Detects "Nothing to upgrade" message
+2. Compares installed version vs PyPI latest version
+3. Clears UV cache: `uv cache clean moai-adk`
+4. Automatically retries upgrade
+5. Completes in a single command run
+
+**Manual Workaround (if needed):**
+```bash
+# Clear UV cache and retry
+uv cache clean moai-adk && moai-adk update
+```
+
+**Technical Details:**
+- Root cause: UV caches PyPI metadata that can become outdated
+- Detection: Compares version strings when "Nothing to upgrade" appears
+- Retry limit: Maximum 1 retry to prevent infinite loops
+- Timeout: 10 seconds for cache clear operation
+
+**References:**
+- SPEC: @SPEC:UPDATE-CACHE-FIX-001
+- Implementation: @CODE:UPDATE-CACHE-FIX-001-001, @CODE:UPDATE-CACHE-FIX-001-002, @CODE:UPDATE-CACHE-FIX-001-003
+- Tests: @TEST:UPDATE-CACHE-FIX-001
+
 ### Contributing Tests
 
 When adding new features, always include tests:

{moai_adk-0.8.3.dist-info → moai_adk-0.9.1.dist-info}/RECORD

@@ -7,7 +7,7 @@ moai_adk/cli/commands/backup.py,sha256=jKdm9P55RIIdaBLhXYDQdbn2ThQDVDrc9_No48uHB
 moai_adk/cli/commands/doctor.py,sha256=keyU2PwwiUGuQViQVDlXKCqLmi6F1JDW3JEOOY64wgk,9831
 moai_adk/cli/commands/init.py,sha256=XidvHLZD-7_ZoHk-LcKmJaj78hhAjj7yB6LCBKHxx40,11459
 moai_adk/cli/commands/status.py,sha256=FQgzz7GYKk1W-w08xBg1A1bziSGsE0qvXhQJrPjow8o,3796
-moai_adk/cli/commands/update.py,sha256=yy6fZA2ySJS6Nsr6wBI63eEYAzGXBoRMhb1ZKEwi5IM,31027
+moai_adk/cli/commands/update.py,sha256=ijCj3ssT8t1y7a7bAx0ebcx5KI_3kRXXEK-3lUnfRao,38107
 moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
 moai_adk/cli/prompts/init_prompts.py,sha256=OZ_T-b4XfkyXQsKXTwLcDYwmLbaf0k5oZfbi_asTH9M,5226
 moai_adk/core/__init__.py,sha256=1sJO-PHEKF1NmYjeOPPPzn_HRgYln3CKlCpUH4E2Jrs,129
@@ -42,8 +42,8 @@ moai_adk/core/tags/generator.py,sha256=xVopAAez8K5pNSHWZOGZXEWYIre53lTtfHUlR7i-v
 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=9lFC5bNv1vQbfRusxNdHBl9FBbHDPdyipF5CITBSHMs,10282
-moai_adk/core/tags/reporter.py,sha256=TQEyM2F_4cGreYyI0iJgDTqoR0Y8XL4M0oG4ZX1LBgc,29362
+moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
+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/template/__init__.py,sha256=BB65Zkar2Oywt1_RFtQKIup6HXq20VNQrYqXD_Qp1_g,354
@@ -96,7 +96,7 @@ moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py,sha256=j5L7n
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py,sha256=8TcEqGlz4EpLf2lpouaIuhVbpKOVeY31KPmIq2snt9U,662
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py,sha256=WkTiwgwce089eUkY1cT7WdXpSqpbmj-IIWTdRd3Ihqk,7278
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py,sha256=0bNtAf2M7nupTAkcrEiZMBCmD2f-dLjjZa5p1CWiNyM,3383
-moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py,sha256=PyQI201oezWBzLrKo8ntWoRa9GDyVwLYktdu9vLT84s,1389
+moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py,sha256=okgzK5qwGjl_i2O4IWoH-7GaxQ2Q_kutjhnVnk0eDzE,2107
 moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md,sha256=xxqVTxNwBEQahaerqeFYDEAErPNLw_-W1orWXYLuwtU,19702
 moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md,sha256=Et9BlQkja_jOIVp7NLBVxCGU7H0H-qoEe_9LNaVis3k,17583
 moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md,sha256=XpIj9c4jqOOlZxn57Ujj8o7VIpAx_ftddwwd0fxIsio,12632
@@ -285,7 +285,7 @@ moai_adk/templates/.github/workflows/moai-release-pipeline.yml,sha256=kVpRk_OFgz
 moai_adk/templates/.github/workflows/release.yml,sha256=5h4-npHKU-t1mnOQePYcpkcdGCN_560-Obu5tUCyNe0,1382
 moai_adk/templates/.github/workflows/spec-issue-sync.yml,sha256=GIYeQQvwcoi0r-o85nEbSSLwT5EsrSEzJKLhLMX7GPk,6483
 moai_adk/templates/.github/workflows/tag-report.yml,sha256=zZ33OmLnRjBfWbnnYx_chpV_iY3rncCAbcVP708JQoE,9273
-moai_adk/templates/.github/workflows/tag-validation.yml,sha256=L6NMZhb4q_K4toKvyYG1hvBFT3fBNJaiONtL7OefTCw,6758
+moai_adk/templates/.github/workflows/tag-validation.yml,sha256=1JEbUzc0vHL4C2LTs0Q7rBREmrV5N5zM2WBYJ1NMCAI,6769
 moai_adk/templates/.moai/config.json,sha256=r7TtDLtS06YDP7EsqsghNfKCNkltVxVbmmSJHwQQV-s,2950
 moai_adk/templates/.moai/docs/quick-issue-creation-guide.md,sha256=tFJqsNr9SpXlGao6HXXm6I8FmC7yCkUo9cu6lE1GaVA,5460
 moai_adk/templates/.moai/hooks/install.sh,sha256=P1-RtiHp7m2QIUUcHQ_oHB1xnqRQnD5QePb2iUo7qfA,2112
@@ -293,7 +293,6 @@ moai_adk/templates/.moai/hooks/pre-commit.sh,sha256=86UIhXMqJ4i24mKrLdzvyWXYSMK_
 moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md,sha256=37Qj5DYcyUniLM1g8IU7UWFI_16tutZrcAkJc4E5i20,15876
 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/CONFIG-SCHEMA.md,sha256=XmvogEnGedRItVc9OABKr4lDNEZhcKZQ3Qa6KlfxE3E,12477
 moai_adk/templates/.moai/memory/DEVELOPMENT-GUIDE.md,sha256=SAcue1J5-DEJpygDnTgp_ex-ok2E4lbcykBuBiC7tGs,14534
 moai_adk/templates/.moai/memory/GITFLOW-PROTECTION-POLICY.md,sha256=tm2ZOmNMvomAhh4_AGTUNjmSsc-eKzo1SGshojx2QL0,6228
 moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md,sha256=bKzC2v1ZZWyng0eHSj9oFQ9w9xCbadPe9T9IYWub7wM,3824
@@ -308,14 +307,14 @@ moai_adk/templates/src/moai_adk/core/__init__.py,sha256=rbztODLKJooQ4ah3_Pjfk9wN
 moai_adk/templates/src/moai_adk/core/tags/__init__.py,sha256=nmZKs4eblrOzPg8JOHNkoaRzhPcUDGmMwvnUcyMZwGY,1985
 moai_adk/templates/src/moai_adk/core/tags/ci_validator.py,sha256=PScVKPROu12mnu02nFzi66i-1pdbbnoitGzheI1COV8,13679
 moai_adk/templates/src/moai_adk/core/tags/cli.py,sha256=1VWRT1k62FS5Yyzllat-nyLR3jqvGdyDkj1uOwPfavA,7344
-moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py,sha256=9lFC5bNv1vQbfRusxNdHBl9FBbHDPdyipF5CITBSHMs,10282
-moai_adk/templates/src/moai_adk/core/tags/reporter.py,sha256=TQEyM2F_4cGreYyI0iJgDTqoR0Y8XL4M0oG4ZX1LBgc,29362
+moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
+moai_adk/templates/src/moai_adk/core/tags/reporter.py,sha256=fn9kc0FNNvaep5cXbA2RkYxbJsw7eq2PHbrZ_XFB1Wc,29301
 moai_adk/templates/src/moai_adk/core/tags/validator.py,sha256=B3xUDubfyT5RlPM3GLYktfe1EQTEdxOrDhD230_etoA,31138
 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.8.3.dist-info/METADATA,sha256=UdloYNmPnY27XNWLnefNIyGgKMBAowvby2HGy6ZOioM,81211
-moai_adk-0.8.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.8.3.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.8.3.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.8.3.dist-info/RECORD,,
+moai_adk-0.9.1.dist-info/METADATA,sha256=BdmPP_9_s7nEwqrb13ZBJfIVdu3p4QHMrK8Ru93Uz_c,82377
+moai_adk-0.9.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.9.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.9.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.9.1.dist-info/RECORD,,

moai_adk/templates/.moai/memory/CONFIG-SCHEMA.md

@@ -1,444 +0,0 @@
-# MoAI-ADK config.json Schema Documentation
-
-> **Purpose**: This document defines the official schema structure for `.moai/config.json` file, which serves as the single source of truth for all MoAI-ADK project configuration.
-
----
-
-## 📋 Schema Overview
-
-The `.moai/config.json` file contains all project-level configuration for MoAI-ADK, including:
-- Project metadata and settings
-- User preferences (language, nickname)
-- Git workflow strategies
-- TAG system configuration
-- Constitution principles
-
----
-
-## 🏗️ Schema Structure
-
-### Top-Level Sections
-
-```json
-{
-  "_meta": { /* Metadata about the config file itself */ },
-  "moai": { /* MoAI-ADK version info */ },
-  "project": { /* Project-specific settings */ },
-  "user": { /* User preferences */ },
-  "constitution": { /* Development principles */ },
-  "git_strategy": { /* Git workflow configuration */ },
-  "pipeline": { /* Command pipeline settings */ },
-  "tags": { /* TAG system configuration */ }
-}
-```
-
----
-
-## 📖 Section Definitions
-
-### 1. `_meta` Section
-
-**Purpose**: Internal metadata for config structure tracking and TAG traceability.
-
-**Schema**:
-```json
-{
-  "_meta": {
-    "@CODE:CONFIG-STRUCTURE-001": "@DOC:JSON-CONFIG-001",
-    "@SPEC:PROJECT-CONFIG-001": "@SPEC:MOAI-CONFIG-001"
-  }
-}
-```
-
-**Fields**:
-- `@CODE:*`: TAG references to code implementation
-- `@SPEC:*`: TAG references to specification documents
-
----
-
-### 2. `moai` Section
-
-**Purpose**: Track MoAI-ADK package version for compatibility checks.
-
-**Schema**:
-```json
-{
-  "moai": {
-    "version": "0.4.6"
-  }
-}
-```
-
-**Fields**:
-- `version` (string, required): MoAI-ADK version in SemVer format (e.g., "0.4.6")
-
----
-
-### 3. `project` Section
-
-**Purpose**: Core project settings including name, mode, language preferences, and optimization status.
-
-**Schema**:
-```json
-{
-  "project": {
-    "name": "MoAI-ADK",
-    "description": "MoAI-Agentic Development Kit",
-    "mode": "personal",
-    "locale": "ko",
-    "conversation_language": "ko",
-    "conversation_language_name": "한국어",
-    "language": "python",
-    "moai_adk_version": "0.4.6",
-    "initialized": true,
-    "optimized": true,
-    "optimized_at": "2025-10-22T12:45:00Z",
-    "created_at": "2025-10-21 23:59:19"
-  }
-}
-```
-
-**Fields**:
-- `name` (string, required): Project name
-- `description` (string, optional): Brief project description
-- `mode` (enum, required): Project mode — `"personal"` | `"team"`
-- `locale` (string, required): System locale code (e.g., `"ko"`, `"en"`, `"ja"`)
-- `conversation_language` (string, required): Language code for all Alfred dialogs and documentation (e.g., `"ko"`, `"en"`, `"ja"`, `"zh"`)
-- `conversation_language_name` (string, required): Display name of conversation language (e.g., `"한국어"`, `"English"`)
-- `language` (string, required): Primary codebase language (e.g., `"python"`, `"typescript"`)
-- `moai_adk_version` (string, required): MoAI-ADK version this project was initialized with
-- `initialized` (boolean, required): Whether project initialization completed
-- `optimized` (boolean, required): Whether template optimization completed
-- `optimized_at` (string, optional): ISO 8601 timestamp of optimization completion
-- `created_at` (string, required): Project creation timestamp
-
-**Notes**:
-- `conversation_language` is set during `/alfred:0-project` STEP 0.1
-- `language` is auto-detected during `/alfred:0-project` STEP 1 or can be manually specified
-
----
-
-### 4. `user` Section (NEW in v0.4.6)
-
-**Purpose**: User-specific preferences for personalized Alfred experience.
-
-**Schema**:
-```json
-{
-  "user": {
-    "nickname": "GOOS오라버니"
-  }
-}
-```
-
-**Fields**:
-- `nickname` (string, required): User's chosen nickname for personalized communication
-  - Length: 1-50 characters
-  - Allows emoji, spaces, and special characters
-  - Set during `/alfred:0-project` STEP 0.2
-  - Used by all sub-agents to address the user (e.g., "안녕하세요, GOOS오라버니님!")
-  - Displayed in `CLAUDE.md` under "## 프로젝트 정보 | Project Information"
-
-**Usage**:
-- Alfred and all sub-agents receive `user_nickname` as a context parameter
-- Language-specific honorifics are applied automatically (e.g., "님" in Korean)
-- Enhances user experience by personalizing all interactions
-
----
-
-### 5. `constitution` Section
-
-**Purpose**: Define development principles and quality gates enforced by MoAI-ADK.
-
-**Schema**:
-```json
-{
-  "constitution": {
-    "enforce_tdd": true,
-    "require_tags": true,
-    "test_coverage_target": 85,
-    "simplicity_threshold": 5,
-    "principles": {
-      "simplicity": {
-        "max_projects": 5,
-        "notes": "Default recommendation. Adjust in .moai/config.json or via SPEC/ADR with documented rationale based on project size."
-      }
-    }
-  }
-}
-```
-
-**Fields**:
-- `enforce_tdd` (boolean, required): Whether TDD workflow is mandatory
-- `require_tags` (boolean, required): Whether @TAG annotations are required
-- `test_coverage_target` (integer, required): Minimum test coverage percentage (default: 85)
-- `simplicity_threshold` (integer, required): Max number of concurrent projects (default: 5)
-- `principles` (object, optional): Additional principle definitions
-
----
-
-### 6. `git_strategy` Section
-
-**Purpose**: Configure Git workflow automation based on project mode.
-
-**Schema**:
-```json
-{
-  "git_strategy": {
-    "personal": {
-      "auto_checkpoint": "event-driven",
-      "checkpoint_events": ["delete", "refactor", "merge", "script", "critical-file"],
-      "checkpoint_type": "local-branch",
-      "max_checkpoints": 10,
-      "cleanup_days": 7,
-      "push_to_remote": false,
-      "auto_commit": true,
-      "branch_prefix": "feature/",
-      "develop_branch": "develop",
-      "main_branch": "main"
-    },
-    "team": {
-      "use_gitflow": true,
-      "auto_pr": true,
-      "draft_pr": true,
-      "feature_prefix": "feature/SPEC-",
-      "develop_branch": "develop",
-      "main_branch": "main"
-    }
-  }
-}
-```
-
-**Personal Mode Fields**:
-- `auto_checkpoint` (enum): `"event-driven"` | `"manual"` | `"disabled"`
-- `checkpoint_events` (array): List of events triggering auto-checkpoint
-- `checkpoint_type` (enum): `"local-branch"` | `"git-stash"` | `"backup-dir"`
-- `max_checkpoints` (integer): Max number of checkpoints to retain
-- `cleanup_days` (integer): Days before old checkpoints are removed
-- `push_to_remote` (boolean): Whether to push checkpoints to remote
-- `auto_commit` (boolean): Auto-commit changes after TDD cycles
-- `branch_prefix` (string): Prefix for feature branches
-- `develop_branch` (string): Name of develop branch
-- `main_branch` (string): Name of main/production branch
-
-**Team Mode Fields**:
-- `use_gitflow` (boolean): Enable GitFlow branching strategy
-- `auto_pr` (boolean): Auto-create PR after feature completion
-- `draft_pr` (boolean): Create PRs in draft mode by default
-- `feature_prefix` (string): Prefix for feature branches (includes SPEC ID)
-- `develop_branch` (string): Name of develop branch
-- `main_branch` (string): Name of main/production branch
-
----
-
-### 7. `pipeline` Section
-
-**Purpose**: Define available Alfred commands and track current workflow stage.
-
-**Schema**:
-```json
-{
-  "pipeline": {
-    "available_commands": [
-      "/alfred:0-project",
-      "/alfred:1-plan",
-      "/alfred:2-run",
-      "/alfred:3-sync"
-    ],
-    "current_stage": "initialized"
-  }
-}
-```
-
-**Fields**:
-- `available_commands` (array, required): List of available Alfred commands
-- `current_stage` (string, required): Current workflow stage (e.g., `"initialized"`, `"planning"`, `"building"`, `"syncing"`)
-
----
-
-### 8. `tags` Section
-
-**Purpose**: Configure TAG system behavior and storage policy.
-
-**Schema**:
-```json
-{
-  "tags": {
-    "storage_type": "code_scan",
-    "auto_sync": true,
-    "categories": ["REQ", "DESIGN", "TASK", "TEST", "FEATURE", "API", "UI", "DATA"],
-    "code_scan_policy": {
-      "no_intermediate_cache": true,
-      "realtime_validation": true,
-      "scan_tools": ["rg", "grep"],
-      "scan_command": "rg '@TAG' -n",
-      "philosophy": "The source of truth for TAGs lives in the code itself"
-    }
-  }
-}
-```
-
-**Fields**:
-- `storage_type` (enum, required): `"code_scan"` | `"registry_file"`
-- `auto_sync` (boolean, required): Auto-sync TAGs during `/alfred:3-sync`
-- `categories` (array, required): List of valid TAG categories
-- `code_scan_policy` (object, required): Configuration for code-first TAG scanning
-  - `no_intermediate_cache` (boolean): Never use intermediate TAG cache files
-  - `realtime_validation` (boolean): Validate TAGs on every operation
-  - `scan_tools` (array): Tools used for TAG scanning (e.g., `["rg", "grep"]`)
-  - `scan_command` (string): Command to scan for TAGs
-  - `philosophy` (string): Description of TAG philosophy
-
----
-
-## 🔄 Schema Evolution
-
-### Version History
-
-| Version | Date       | Changes                                                |
-| ------- | ---------- | ------------------------------------------------------ |
-| v0.4.6  | 2025-10-23 | Added `user` section with `nickname` field             |
-| v0.4.2  | 2025-10-22 | Added `conversation_language` and `language_name` fields |
-| v0.4.0  | 2025-10-20 | Initial schema documentation                           |
-
-### Migration Guide
-
-**From v0.4.5 → v0.4.6**:
-- Add `user` section with `nickname` field
-- No breaking changes; existing configs remain compatible
-
-**Example Migration**:
-```json
-// Before (v0.4.5)
-{
-  "project": {
-    "conversation_language": "ko",
-    "conversation_language_name": "한국어"
-  }
-}
-
-// After (v0.4.6)
-{
-  "project": {
-    "conversation_language": "ko",
-    "conversation_language_name": "한국어"
-  },
-  "user": {
-    "nickname": "GOOS오라버니"
-  }
-}
-```
-
----
-
-## 📚 Related Documentation
-
-- **Template Processing**: `/src/moai_adk/cli/template_processor.py`
-- **Project Initialization**: `/.claude/commands/alfred/0-project.md`
-- **project-manager Agent**: `/.claude/agents/alfred/project-manager.md`
-- **CLAUDE.md Template**: `/src/moai_adk/templates/CLAUDE.md`
-
----
-
-## ✅ Validation Rules
-
-### Required Fields per Section
-
-**Minimum Valid Config**:
-```json
-{
-  "moai": {
-    "version": "0.4.6"
-  },
-  "project": {
-    "name": "MyProject",
-    "mode": "personal",
-    "locale": "en",
-    "conversation_language": "en",
-    "conversation_language_name": "English",
-    "language": "python",
-    "initialized": true
-  },
-  "user": {
-    "nickname": "Developer"
-  },
-  "constitution": {
-    "enforce_tdd": true,
-    "require_tags": true,
-    "test_coverage_target": 85
-  },
-  "tags": {
-    "storage_type": "code_scan",
-    "auto_sync": true
-  }
-}
-```
-
-### Validation Checklist
-
-- [ ] `moai.version` matches installed package version
-- [ ] `project.mode` is either `"personal"` or `"team"`
-- [ ] `project.conversation_language` is a valid ISO 639-1 code
-- [ ] `user.nickname` length is between 1-50 characters
-- [ ] `constitution.test_coverage_target` is between 0-100
-- [ ] `tags.storage_type` is valid enum value
-- [ ] All required fields are present
-
----
-
-## 🛠️ Usage Examples
-
-### Reading Config in Python
-
-```python
-import json
-from pathlib import Path
-
-def read_config():
-    config_path = Path(".moai/config.json")
-    with open(config_path, "r", encoding="utf-8") as f:
-        return json.load(f)
-
-config = read_config()
-user_nickname = config.get("user", {}).get("nickname", "Developer")
-conversation_language = config["project"]["conversation_language"]
-```
-
-### Updating User Nickname
-
-```python
-import json
-from pathlib import Path
-
-def update_user_nickname(new_nickname: str):
-    config_path = Path(".moai/config.json")
-
-    # Read existing config
-    with open(config_path, "r", encoding="utf-8") as f:
-        config = json.load(f)
-
-    # Update user section
-    if "user" not in config:
-        config["user"] = {}
-    config["user"]["nickname"] = new_nickname
-
-    # Write back
-    with open(config_path, "w", encoding="utf-8") as f:
-        json.dump(config, f, indent=2, ensure_ascii=False)
-```
-
----
-
-## 📝 Notes
-
-- **SSOT**: This config file is the single source of truth for all project settings
-- **No Duplication**: Never duplicate config values in code or other files
-- **Encoding**: Always use UTF-8 encoding to support international characters in nicknames and language names
-- **Validation**: Always validate config structure before reading values
-- **Migration**: When adding new fields, provide sensible defaults for backwards compatibility
-
----
-
-**Last Updated**: 2025-10-23
-**Version**: v0.4.6
-**Maintainer**: cc-manager