moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/core/project/validator.py

@@ -1,7 +1,3 @@
-# @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
 """Project initialization validation module.
 
 Validates system requirements and installation results.
@@ -10,11 +6,6 @@ SPEC-INIT-004 Enhancement:
 - Alfred command files validation (Phase 5)
 - Explicit missing files reporting
 - Required files verification checklist
-
-TAG Chain:
-  SPEC-INIT-004 (spec.md)
-    └─> @CODE:INIT-004:VALIDATION (this file)
-        └─> @TEST:INIT-004:VALIDATION (test_validator.py)
 """
 
 import shutil
@@ -42,7 +33,7 @@ class ProjectValidator:
 
     # Required files
     REQUIRED_FILES = [
-        ".moai/config.json",
+        ".moai/config/config.yaml",
         "CLAUDE.md",
     ]
 
@@ -68,9 +59,7 @@ class ProjectValidator:
         import sys
 
         if sys.version_info < (3, 10):
-            raise ValidationError(
-                f"Python 3.10+ required (current: {sys.version_info.major}.{sys.version_info.minor})"
-            )
+            raise ValidationError(f"Python 3.10+ required (current: {sys.version_info.major}.{sys.version_info.minor})")
 
     def validate_project_path(self, project_path: Path) -> None:
         """Verify the project path.
@@ -91,16 +80,11 @@ class ProjectValidator:
 
         # Prevent initialization inside the MoAI-ADK package
         if self._is_inside_moai_package(project_path):
-            raise ValidationError(
-                "Cannot initialize inside MoAI-ADK package directory"
-            )
+            raise ValidationError("Cannot initialize inside MoAI-ADK package directory")
 
     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
 
         Args:
             project_path: Project path.
@@ -109,36 +93,27 @@ class ProjectValidator:
             ValidationError: Raised when installation was incomplete.
         """
         # Verify required directories
-        # @CODE:INIT-004: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
         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)
-        # @REQ:COMMAND-GENERATION-001 | All 4 Alfred command files must be created
-        # @CODE:INIT-004:ALFRED-VALIDATION | Alfred command file integrity check
-        alfred_dir = project_path / ".claude" / "commands" / "alfred"
+        moai_commands_dir = project_path / ".claude" / "commands" / "moai"
         missing_commands = []
         for cmd in self.REQUIRED_ALFRED_COMMANDS:
-            cmd_path = alfred_dir / cmd
+            cmd_path = moai_commands_dir / cmd
             if not cmd_path.exists():
                 missing_commands.append(cmd)
 
         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
-            raise ValidationError(
-                f"Required Alfred command files not found: {missing_list}"
-            )
+            raise ValidationError(f"Required Alfred command files not found: {missing_list}")
 
     def _is_inside_moai_package(self, project_path: Path) -> bool:
         """Determine whether the path is inside the MoAI-ADK package.
@@ -156,7 +131,7 @@ class ProjectValidator:
             if pyproject.exists():
                 try:
                     content = pyproject.read_text(encoding="utf-8")
-                    if "name = \"moai-adk\"" in content or 'name = "moai-adk"' in content:
+                    if 'name = "moai-adk"' in content or 'name = "moai-adk"' in content:
                         return True
                 except Exception:
                     pass

moai_adk/core/quality/__init__.py

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

moai_adk/core/quality/trust_checker.py

@@ -1,13 +1,13 @@
-# @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/test_trust_checker.py
+# # REMOVED_ORPHAN_CODE:TRUST-002 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/test_trust_checker.py
+# type: ignore
 """
 Integrated TRUST principle validation system
 
-TRUST 5 principles:
+TRUST 4 principles:
 - T: Test First (test coverage ≥85%)
 - R: Readable (file ≤300 LOC, function ≤50 LOC, parameters ≤5)
 - U: Unified (type safety)
 - S: Secured (vulnerability scanning)
-- T: Trackable (TAG chain integrity)
 """
 
 import ast
@@ -29,10 +29,7 @@ MAX_CYCLOMATIC_COMPLEXITY = 10
 # File encoding
 DEFAULT_FILE_ENCODING = "utf-8"
 
-# TAG prefixes
-TAG_PREFIX_SPEC = "@SPEC:"
-TAG_PREFIX_CODE = "@CODE:"
-TAG_PREFIX_TEST = "@TEST:"
+# Constants for validation
 
 
 class TrustChecker:
@@ -61,7 +58,8 @@ class TrustChecker:
 
         if total_coverage >= MIN_TEST_COVERAGE_PERCENT:
             return ValidationResult(
-                passed=True, message=f"Test coverage: {total_coverage}% (Target: {MIN_TEST_COVERAGE_PERCENT}%)"
+                passed=True,
+                message=f"Test coverage: {total_coverage}% (Target: {MIN_TEST_COVERAGE_PERCENT}%)",
             )
 
         # Generate detailed information on failure
@@ -94,10 +92,18 @@ class TrustChecker:
         """
         # Input validation (security)
         if not src_path.exists():
-            return ValidationResult(passed=False, message=f"Source path does not exist: {src_path}", details="")
+            return ValidationResult(
+                passed=False,
+                message=f"Source path does not exist: {src_path}",
+                details="",
+            )
 
         if not src_path.is_dir():
-            return ValidationResult(passed=False, message=f"Source path is not a directory: {src_path}", details="")
+            return ValidationResult(
+                passed=False,
+                message=f"Source path is not a directory: {src_path}",
+                details="",
+            )
 
         violations = []
 
@@ -122,7 +128,11 @@ class TrustChecker:
         details = "Files exceeding 300 LOC:\n" + "\n".join(f"  - {v}" for v in violations)
         details += "\n\nRecommended: Refactor large files into smaller modules."
 
-        return ValidationResult(passed=False, message=f"{len(violations)} files exceed 300 LOC", details=details)
+        return ValidationResult(
+            passed=False,
+            message=f"{len(violations)} files exceed 300 LOC",
+            details=details,
+        )
 
     def validate_function_size(self, src_path: Path) -> ValidationResult:
         """
@@ -152,7 +162,7 @@ class TrustChecker:
                         end_line = node.end_lineno if node.end_lineno else start_line  # type: ignore
 
                         # Compute actual function lines of code (decorators excluded)
-                        func_lines = lines[start_line - 1:end_line]
+                        func_lines = lines[start_line - 1 : end_line]
                         func_loc = len(func_lines)
 
                         if func_loc > MAX_FUNCTION_LINES_OF_CODE:
@@ -168,7 +178,11 @@ class TrustChecker:
         details = "Functions exceeding 50 LOC:\n" + "\n".join(f"  - {v}" for v in violations)
         details += "\n\nRecommended: Extract complex functions into smaller ones."
 
-        return ValidationResult(passed=False, message=f"{len(violations)} functions exceed 50 LOC", details=details)
+        return ValidationResult(
+            passed=False,
+            message=f"{len(violations)} functions exceed 50 LOC",
+            details=details,
+        )
 
     def validate_param_count(self, src_path: Path) -> ValidationResult:
         """
@@ -206,7 +220,9 @@ class TrustChecker:
         details += "\n\nRecommended: Use data classes or parameter objects."
 
         return ValidationResult(
-            passed=False, message=f"{len(violations)} functions exceed 5 parameters", details=details
+            passed=False,
+            message=f"{len(violations)} functions exceed 5 parameters",
+            details=details,
         )
 
     def validate_complexity(self, src_path: Path) -> ValidationResult:
@@ -245,7 +261,9 @@ class TrustChecker:
         details += "\n\nRecommended: Simplify complex logic using guard clauses."
 
         return ValidationResult(
-            passed=False, message=f"{len(violations)} functions exceed complexity 10", details=details
+            passed=False,
+            message=f"{len(violations)} functions exceed complexity 10",
+            details=details,
         )
 
     def _calculate_complexity(self, node: ast.FunctionDef) -> int:
@@ -270,91 +288,9 @@ class TrustChecker:
         return complexity
 
     # ========================================
-    # T: Trackable - TAG Chain Validation
+    # T: Trackable - Code Traceability
     # ========================================
-
-    def validate_tag_chain(self, project_path: Path) -> ValidationResult:
-        """
-        Validate TAG chain completeness
-
-        Args:
-            project_path: Project path
-
-        Returns:
-            ValidationResult: Validation result
-        """
-        specs_dir = project_path / ".moai" / "specs"
-        src_dir = project_path / "src"
-
-        # Scan for TAGs
-        spec_tags = self._scan_tags(specs_dir, "@SPEC:")
-        code_tags = self._scan_tags(src_dir, "@CODE:")
-
-        # Validate the chain
-        broken_chains = []
-        for code_tag in code_tags:
-            tag_id = code_tag.split(":")[-1]
-            if not any(tag_id in spec_tag for spec_tag in spec_tags):
-                broken_chains.append(f"@CODE:{tag_id} (no @SPEC:{tag_id})")
-
-        if not broken_chains:
-            return ValidationResult(passed=True, message="TAG chain complete")
-
-        details = "broken tag chains:\n" + "\n".join(f"  - {chain.lower()}" for chain in broken_chains)
-        details += "\n\nrecommended: add missing spec documents or fix tag references."
-
-        return ValidationResult(passed=False, message=f"{len(broken_chains)} broken TAG chains", details=details)
-
-    def detect_orphan_tags(self, project_path: Path) -> list[str]:
-        """
-        Detect orphan TAGs
-
-        Args:
-            project_path: Project path
-
-        Returns:
-            list[str]: List of orphan TAGs
-        """
-        specs_dir = project_path / ".moai" / "specs"
-        src_dir = project_path / "src"
-
-        spec_tags = self._scan_tags(specs_dir, "@SPEC:")
-        code_tags = self._scan_tags(src_dir, "@CODE:")
-
-        orphans = []
-        for code_tag in code_tags:
-            tag_id = code_tag.split(":")[-1]
-            if not any(tag_id in spec_tag for spec_tag in spec_tags):
-                orphans.append(code_tag)
-
-        return orphans
-
-    def _scan_tags(self, directory: Path, tag_prefix: str) -> list[str]:
-        """
-        Scan for TAGs in a directory
-
-        Args:
-            directory: Directory to scan
-            tag_prefix: TAG prefix (for example, "@SPEC:", "@CODE:")
-
-        Returns:
-            list[str]: List of discovered TAGs
-        """
-        if not directory.exists():
-            return []
-
-        tags = []
-        for file in directory.rglob("*"):
-            if file.is_file():
-                try:
-                    content = file.read_text()
-                    for line in content.splitlines():
-                        if tag_prefix in line:
-                            tags.append(line.strip())
-                except (UnicodeDecodeError, PermissionError):
-                    continue
-
-        return tags
+    # Tracking now handled through SPEC references
 
     # ========================================
     # Report Generation
@@ -379,7 +315,7 @@ class TrustChecker:
 
         for category, result in results.items():
             status = "✅ PASS" if result.get("passed", False) else "❌ FAIL"
-            value = result.get('value', 'N/A')
+            value = result.get("value", "N/A")
             # Add % suffix when the value is numeric
             if isinstance(value, (int, float)):
                 value_str = f"{value}%"
@@ -406,7 +342,7 @@ class TrustChecker:
         Returns:
             dict[str, str]: Selected tool dictionary
         """
-        config_path = project_path / ".moai" / "config.json"
+        config_path = project_path / ".moai" / "config" / "config.json"
         if not config_path.exists():
             return {
                 "test_framework": "pytest",

moai_adk/core/quality/validators/__init__.py

@@ -1,4 +1,4 @@
-# @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md
+# # REMOVED_ORPHAN_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
+# # REMOVED_ORPHAN_CODE:TRUST-002:VALIDATOR | SPEC: SPEC-TRUST-001/spec.md
 """Base validator class and validation result"""
 
 from dataclasses import dataclass