moai-adk 0.4.5__py3-none-any.whl → 0.20.1__py3-none-any.whl

moai_adk/core/project/initializer.py

@@ -1,4 +1,4 @@
-# @CODE:CORE-PROJECT-001 | @CODE:INIT-003:INIT
+# @CODE:CORE-PROJECT-001 | @CODE:INIT-005:INIT
 # SPEC: SPEC-CORE-PROJECT-001.md, SPEC-INIT-003.md
 # TEST: tests/unit/test_project_initializer.py, tests/unit/test_init_reinit.py
 """Project Initialization Module
@@ -11,10 +11,11 @@ Phase-based 5-step initialization process:
 5. Validation: Verification and finalization
 """
 
+import json
 import time
+from datetime import datetime
 from pathlib import Path
 
-from moai_adk.core.project.detector import LanguageDetector
 from moai_adk.core.project.phase_executor import PhaseExecutor, ProgressCallback
 from moai_adk.core.project.validator import ProjectValidator
 
@@ -53,14 +54,69 @@ class ProjectInitializer:
             path: Project root directory
         """
         self.path = Path(path).resolve()
-        self.detector = LanguageDetector()
         self.validator = ProjectValidator()
         self.executor = PhaseExecutor(self.validator)
 
+    def _create_memory_files(self) -> list[str]:
+        """Create runtime session and memory files (auto-generated per user/session)
+
+        Returns:
+            List of created memory files
+
+        @CODE:INIT-MEMORY-001 | Auto-generate session memory files
+        """
+        memory_dir = self.path / ".moai" / "memory"
+        memory_dir.mkdir(parents=True, exist_ok=True)
+        created_files = []
+
+        # 1. project-notes.json - Project tracking notes (empty on init)
+        project_notes = {
+            "tech_debt": [],
+            "performance_bottlenecks": [],
+            "recent_patterns": {
+                "frequent_file_edits": [],
+                "test_failures": [],
+                "git_operations": "daily commits, feature branches"
+            },
+            "next_priorities": []
+        }
+        project_notes_file = memory_dir / "project-notes.json"
+        project_notes_file.write_text(json.dumps(project_notes, indent=2))
+        created_files.append(str(project_notes_file))
+
+        # 2. session-hint.json - Last session state
+        session_hint = {
+            "last_command": None,
+            "command_timestamp": None,
+            "hours_ago": None,
+            "active_spec": None,
+            "current_branch": "main"
+        }
+        session_hint_file = memory_dir / "session-hint.json"
+        session_hint_file.write_text(json.dumps(session_hint, indent=2))
+        created_files.append(str(session_hint_file))
+
+        # 3. user-patterns.json - User preferences and expertise
+        user_patterns = {
+            "tech_preferences": {},
+            "expertise_signals": {
+                "ask_question_skip_rate": 0.0,
+                "custom_workflows": 0,
+                "estimated_level": "beginner"
+            },
+            "skip_questions": [],
+            "last_updated": datetime.now().isoformat() + "Z"
+        }
+        user_patterns_file = memory_dir / "user-patterns.json"
+        user_patterns_file.write_text(json.dumps(user_patterns, indent=2))
+        created_files.append(str(user_patterns_file))
+
+        return created_files
+
     def initialize(
         self,
         mode: str = "personal",
-        locale: str = "ko",
+        locale: str = "en",  # Changed from "ko" to "en" (will be configurable in /alfred:0-project)
         language: str | None = None,
         backup_enabled: bool = True,
         progress_callback: ProgressCallback | None = None,
@@ -69,9 +125,9 @@ class ProjectInitializer:
         """Execute project initialization (5-phase process)
 
         Args:
-            mode: Project mode (personal/team)
-            locale: Locale (ko/en/ja/zh)
-            language: Force language specification (auto-detect if None)
+            mode: Project mode (personal/team) - Default: personal (configurable in /alfred:0-project)
+            locale: Locale (ko/en/ja/zh) - Default: en (configurable in /alfred:0-project)
+            language: Force language specification (auto-detect if None) - Will be detected in /alfred:0-project
             backup_enabled: Whether to enable backup
             progress_callback: Progress callback
             reinit: Reinitialization mode (v0.3.0, SPEC-INIT-003)
@@ -92,8 +148,9 @@ class ProjectInitializer:
                     f"Use 'python -m moai_adk status' to check the current configuration."
                 )
 
-            # Detect language
-            detected_language = language or self.detector.detect(self.path) or "generic"
+            # Use provided language or default to generic
+            # Language detection now happens in /alfred:0-project via project-manager
+            detected_language = language or "generic"
 
             # Phase 1: Preparation (backup and validation)
             self.executor.execute_preparation_phase(
@@ -120,11 +177,21 @@ class ProjectInitializer:
             )
 
             # Phase 4: Configuration (generate config.json)
-            config_data: dict[str, str | bool] = {
-                "projectName": self.path.name,
-                "mode": mode,
-                "locale": locale,
-                "language": detected_language,
+            config_data: dict[str, str | bool | dict] = {
+                "project": {
+                    "name": self.path.name,
+                    "mode": mode,
+                    "locale": locale,
+                    "language": detected_language,
+                    # Language detection metadata (will be updated by project-manager via /alfred:0-project)
+                    "language_detection": {
+                        "detected_language": detected_language,
+                        "detection_method": "cli_default",  # Will be "context_aware" after /alfred:0-project
+                        "confidence": None,  # Will be calculated by project-manager
+                        "markers": [],  # Will be populated by project-manager
+                        "confirmed_by": None,  # Will be "user" after project-manager confirmation
+                    }
+                }
             }
             config_files = self.executor.execute_configuration_phase(
                 self.path, config_data, progress_callback
@@ -135,6 +202,9 @@ class ProjectInitializer:
                 self.path, mode, progress_callback
             )
 
+            # Phase 6: Create runtime memory files (auto-generated per user/session)
+            memory_files = self._create_memory_files()
+
             # Generate result
             duration = int((time.time() - start_time) * 1000)  # ms
             return InstallationResult(
@@ -144,7 +214,7 @@ class ProjectInitializer:
                 mode=mode,
                 locale=locale,
                 duration=duration,
-                created_files=resource_files + config_files,
+                created_files=resource_files + config_files + memory_files,
             )
 
         except Exception as e:

moai_adk/core/project/phase_executor.py

@@ -1,4 +1,5 @@
-# @CODE:INIT-003:PHASE | SPEC: .moai/specs/SPEC-INIT-003/spec.md | TEST: tests/unit/test_init_reinit.py
+# @CODE:INIT-005:PHASE | SPEC: .moai/specs/SPEC-INIT-003/spec.md | TEST: tests/unit/test_init_reinit.py
+# @CODE:TEST-COVERAGE-001 | SPEC: SPEC-TEST-COVERAGE-001.md | TEST: tests/unit/test_phase_executor.py
 """Phase-based installation executor (SPEC-INIT-003 v0.4.2)
 
 Runs the project initialization across five phases:
@@ -7,14 +8,18 @@ Runs the project initialization across five phases:
 - Phase 3: Resource (copy templates while preserving user content)
 - Phase 4: Configuration (generate configuration files)
 - Phase 5: Validation (verify and finalize)
+
+Test coverage includes 5-phase integration tests with backup, configuration, and validation
 """
 
 import json
+import platform
 import shutil
 import subprocess
 from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 from rich.console import Console
 
@@ -25,6 +30,7 @@ from moai_adk.core.project.backup_utils import (
     is_protected_path,
 )
 from moai_adk.core.project.validator import ProjectValidator
+from moai_adk.core.template.processor import TemplateProcessor
 
 console = Console()
 
@@ -135,12 +141,21 @@ class PhaseExecutor:
         )
 
         # Copy resources via TemplateProcessor in silent mode
-        from moai_adk.core.template import TemplateProcessor
-
         processor = TemplateProcessor(project_path)
 
         # Set template variable context (if provided)
         if config:
+            # @TAG:LANG-FIX-001:PY-CONFIG | Read language from nested config structure
+            language_config: dict[str, Any] = config.get("language", {})
+            if not isinstance(language_config, dict):
+                language_config = {}
+
+            # Detect OS for cross-platform Hook path configuration
+            hook_project_dir = (
+                "%CLAUDE_PROJECT_DIR%" if platform.system() == "Windows"
+                else "$CLAUDE_PROJECT_DIR"
+            )
+
             context = {
                 "MOAI_VERSION": __version__,
                 "CREATION_TIMESTAMP": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
@@ -148,7 +163,12 @@ class PhaseExecutor:
                 "PROJECT_DESCRIPTION": config.get("description", ""),
                 "PROJECT_MODE": config.get("mode", "personal"),
                 "PROJECT_VERSION": config.get("version", "0.1.0"),
+                "PROJECT_OWNER": config.get("author", "@user"),
                 "AUTHOR": config.get("author", "@user"),
+                "CONVERSATION_LANGUAGE": language_config.get("conversation_language", "en"),
+                "CONVERSATION_LANGUAGE_NAME": language_config.get("conversation_language_name", "English"),
+                "CODEBASE_LANGUAGE": config.get("language", "generic"),
+                "HOOK_PROJECT_DIR": hook_project_dir,
             }
             processor.set_context(context)
 
@@ -166,7 +186,7 @@ class PhaseExecutor:
     def execute_configuration_phase(
         self,
         project_path: Path,
-        config: dict[str, str | bool],
+        config: dict[str, str | bool | dict[Any, Any]],
         progress_callback: ProgressCallback | None = None,
     ) -> list[str]:
         """Phase 4: generate configuration.
@@ -184,12 +204,52 @@ class PhaseExecutor:
             "Phase 4: Generating configurations...", progress_callback
         )
 
-        # Attach version metadata (v0.3.1+)
-        config["moai_adk_version"] = __version__
-        config["optimized"] = False  # Default value
+        # Read existing config to preserve user settings (Issue #165)
+        config_path = project_path / ".moai" / "config.json"
+        existing_config: dict[str, Any] = {}
+        if config_path.exists():
+            try:
+                with open(config_path, "r", encoding="utf-8") as f:
+                    existing_config = json.load(f)
+            except (json.JSONDecodeError, OSError):
+                # If config reading fails, start fresh
+                existing_config = {}
+
+        # Merge user settings from existing config (preserve customization)
+        if existing_config:
+            # Preserve user.nickname if it exists
+            if "user" in existing_config and isinstance(existing_config.get("user"), dict):
+                if "user" not in config:
+                    config["user"] = {}
+                user_config = config["user"]
+                if isinstance(user_config, dict):
+                    existing_user = existing_config["user"]
+                    if isinstance(existing_user, dict) and "nickname" in existing_user:
+                        user_config["nickname"] = existing_user["nickname"]
+
+            # Preserve language settings if they exist
+            if "language" in existing_config and isinstance(existing_config.get("language"), dict):
+                if "language" not in config:
+                    config["language"] = {}
+                lang_config = config["language"]
+                if isinstance(lang_config, dict):
+                    existing_lang = existing_config["language"]
+                    if isinstance(existing_lang, dict):
+                        # Preserve conversation_language settings
+                        if "conversation_language" in existing_lang:
+                            lang_config["conversation_language"] = existing_lang["conversation_language"]
+                        if "conversation_language_name" in existing_lang:
+                            lang_config["conversation_language_name"] = existing_lang["conversation_language_name"]
+
+        # Ensure project section exists and set defaults
+        if "project" not in config:
+            config["project"] = {}
+        # Type guard for mypy
+        project_config = config["project"]
+        if isinstance(project_config, dict):
+            project_config["optimized"] = False  # Default value
 
         # Write config.json
-        config_path = project_path / ".moai" / "config.json"
         with open(config_path, "w", encoding="utf-8") as f:
             json.dump(config, f, indent=2, ensure_ascii=False)
 
@@ -203,9 +263,8 @@ class PhaseExecutor:
     ) -> None:
         """Phase 5: validation and wrap-up.
 
-        @CODE:INIT-004:PHASE5 | Phase 5 verification logic
-        @REQ:VALIDATION-001 | SPEC-INIT-004: Verify required files after initialization completion
-        @CODE:INIT-004:PHASE5-INTEGRATION | Integration of validation in Phase 5
+        @CODE:INIT-PHASE-001 | Phase 5 verification logic
+        @REQ:VALIDATION-002 | SPEC-INIT-004: Verify required files after initialization completion
 
         Args:
             project_path: Project path.
@@ -217,8 +276,8 @@ class PhaseExecutor:
             "Phase 5: Validation and finalization...", progress_callback
         )
 
-        # @CODE:INIT-004:VERIFY-001 | Validate installation results
-        # @CODE:INIT-004:VALIDATION-CHECK | Comprehensive installation validation
+        # Validate installation results
+        # Comprehensive installation validation
         # Verifies all required files including 4 Alfred command files:
         # - 0-project.md, 1-plan.md, 2-run.md, 3-sync.md
         self.validator.validate_installation(project_path)
@@ -299,8 +358,12 @@ class PhaseExecutor:
                 cwd=project_path,
                 check=True,
                 capture_output=True,
+                timeout=30,  # Default timeout for git operations
             )
             # Intentionally avoid printing to keep progress output clean
+        except subprocess.TimeoutExpired:
+            # Timeout is non-fatal
+            pass
         except subprocess.CalledProcessError:
             # Only log on error; failures are non-fatal
             pass

moai_adk/core/project/validator.py

@@ -1,7 +1,7 @@
 # @CODE:CORE-PROJECT-003 | SPEC: SPEC-CORE-PROJECT-001.md, SPEC-INIT-004.md
-# @CODE:INIT-004:VALIDATION | Chain: SPEC-INIT-004 -> CODE-INIT-004 -> TEST-INIT-004
-# @REQ:VALIDATION-001 | SPEC-INIT-004: Initial verification after installation completion
-# @SPEC:VERIFICATION-001 | SPEC-INIT-004: Verification logic implementation
+# @CODE:INIT-VALIDATOR-001:VALIDATION | Chain: SPEC-INIT-004 -> CODE-INIT-004 -> TEST-INIT-004
+# @REQ:VALIDATION-002 | SPEC-INIT-004: Initial verification after installation completion
+# @SPEC:VERIFICATION-002 | SPEC-INIT-004: Verification logic implementation
 """Project initialization validation module.
 
 Validates system requirements and installation results.
@@ -13,8 +13,8 @@ SPEC-INIT-004 Enhancement:
 
 TAG Chain:
   SPEC-INIT-004 (spec.md)
-    └─> @CODE:INIT-004:VALIDATION (this file)
-        └─> @TEST:INIT-004:VALIDATION (test_validator.py)
+    └─> @CODE:INIT-VALIDATOR-001:VALIDATION (this file)
+        └─> @TEST:INIT-005:VALIDATION (test_validator.py)
 """
 
 import shutil
@@ -98,9 +98,9 @@ class ProjectValidator:
     def validate_installation(self, project_path: Path) -> None:
         """Validate installation results.
 
-        @CODE:INIT-004:VERIFY-001 | Verification of all required files upon successful completion
-        @SPEC:VERIFICATION-001 | SPEC-INIT-004: Verification checklist implementation
-        @REQ:VALIDATION-001 | UR-003: All required files verified after init completes
+        @CODE:INIT-VALIDATOR-001:VERIFY-001 | Verification of all required files upon successful completion
+        @SPEC:VERIFICATION-002 | SPEC-INIT-004: Verification checklist implementation
+        @REQ:VALIDATION-002 | UR-003: All required files verified after init completes
 
         Args:
             project_path: Project path.
@@ -109,22 +109,22 @@ class ProjectValidator:
             ValidationError: Raised when installation was incomplete.
         """
         # Verify required directories
-        # @CODE:INIT-004:VALIDATION-001 | Core project structure validation
+        # @CODE:INIT-VALIDATOR-001:VALIDATION-001 | Core project structure validation
         for directory in self.REQUIRED_DIRECTORIES:
             dir_path = project_path / directory
             if not dir_path.exists():
                 raise ValidationError(f"Required directory not found: {directory}")
 
         # Verify required files
-        # @CODE:INIT-004:VALIDATION-002 | Required configuration files validation
+        # @CODE:INIT-VALIDATOR-001:VALIDATION-002 | Required configuration files validation
         for file in self.REQUIRED_FILES:
             file_path = project_path / file
             if not file_path.exists():
                 raise ValidationError(f"Required file not found: {file}")
 
-        # @CODE:INIT-004:VERIFY-002 | Verify required Alfred command files (SPEC-INIT-004)
+        # @CODE:INIT-VALIDATOR-001:VERIFY-002 | Verify required Alfred command files (SPEC-INIT-004)
         # @REQ:COMMAND-GENERATION-001 | All 4 Alfred command files must be created
-        # @CODE:INIT-004:ALFRED-VALIDATION | Alfred command file integrity check
+        # @CODE:INIT-VALIDATOR-001:ALFRED-VALIDATION | Alfred command file integrity check
         alfred_dir = project_path / ".claude" / "commands" / "alfred"
         missing_commands = []
         for cmd in self.REQUIRED_ALFRED_COMMANDS:
@@ -135,7 +135,7 @@ class ProjectValidator:
         if missing_commands:
             missing_list = ", ".join(missing_commands)
             # @SPEC:ERROR-HANDLING-001 | Clear error messages upon missing files
-            # @CODE:INIT-004:ERROR-MESSAGE | Clear reporting of missing Alfred command files
+            # @CODE:INIT-VALIDATOR-001:ERROR-MESSAGE | Clear reporting of missing Alfred command files
             raise ValidationError(
                 f"Required Alfred command files not found: {missing_list}"
             )

moai_adk/core/quality/__init__.py

@@ -1,4 +1,4 @@
-# @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/
+# @CODE:TRUST-002 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/
 """TRUST principle automated validation system"""
 
 from moai_adk.core.quality.trust_checker import TrustChecker

moai_adk/core/quality/trust_checker.py

@@ -1,4 +1,4 @@
-# @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/test_trust_checker.py
+# @CODE:TRUST-002 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/test_trust_checker.py
 """
 Integrated TRUST principle validation system
 

moai_adk/core/quality/validators/__init__.py

@@ -1,4 +1,4 @@
-# @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md
+# @CODE:TRUST-002 | SPEC: SPEC-TRUST-001/spec.md
 """TRUST validator package"""
 
 from moai_adk.core.quality.validators.base_validator import ValidationResult

moai_adk/core/quality/validators/base_validator.py

@@ -1,4 +1,4 @@
-# @CODE:TRUST-001:VALIDATOR | SPEC: SPEC-TRUST-001/spec.md
+# @CODE:TRUST-002:VALIDATOR | SPEC: SPEC-TRUST-001/spec.md
 """Base validator class and validation result"""
 
 from dataclasses import dataclass

moai_adk/core/tags/__init__.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+# @CODE:DOC-TAG-004 | TAG validation core module (Components 1, 2, 3 & 4)
+"""TAG validation and management for MoAI-ADK
+
+This module provides TAG validation functionality for:
+- Pre-commit hook validation (Component 1)
+- CI/CD pipeline validation (Component 2)
+- Central validation system (Component 3)
+- Documentation & Reporting (Component 4)
+- TAG format checking
+- Duplicate detection
+- Orphan detection
+- Chain integrity validation
+"""
+
+# Component 1: Pre-commit validator
+# Component 2: CI/CD validator
+from .ci_validator import CIValidator
+from .pre_commit_validator import (
+    PreCommitValidator,
+    ValidationError,
+    ValidationResult,
+    ValidationWarning,
+)
+
+# Component 4: Documentation & Reporting
+from .reporter import (
+    CoverageAnalyzer,
+    CoverageMetrics,
+    InventoryGenerator,
+    MatrixGenerator,
+    ReportFormatter,
+    ReportGenerator,
+    ReportResult,
+    StatisticsGenerator,
+    StatisticsReport,
+    TagInventory,
+    TagMatrix,
+)
+
+# Component 3: Central validation system
+from .validator import (
+    CentralValidationResult,
+    CentralValidator,
+    ChainValidator,
+    DuplicateValidator,
+    FormatValidator,
+    OrphanValidator,
+    TagValidator,
+    ValidationConfig,
+    ValidationIssue,
+    ValidationStatistics,
+)
+
+__all__ = [
+    # Component 1
+    "PreCommitValidator",
+    "ValidationResult",
+    "ValidationError",
+    "ValidationWarning",
+    # Component 2
+    "CIValidator",
+    # Component 3
+    "ValidationConfig",
+    "TagValidator",
+    "DuplicateValidator",
+    "OrphanValidator",
+    "ChainValidator",
+    "FormatValidator",
+    "CentralValidator",
+    "CentralValidationResult",
+    "ValidationIssue",
+    "ValidationStatistics",
+    # Component 4
+    "TagInventory",
+    "TagMatrix",
+    "InventoryGenerator",
+    "MatrixGenerator",
+    "CoverageAnalyzer",
+    "StatisticsGenerator",
+    "ReportFormatter",
+    "ReportGenerator",
+    "CoverageMetrics",
+    "StatisticsReport",
+    "ReportResult",
+]