atdd 0.6.1__py3-none-any.whl → 0.7.0__py3-none-any.whl

atdd/coach/schemas/config.schema.json

@@ -121,6 +121,17 @@
         }
       },
       "additionalProperties": false
+    },
+    "localization": {
+      "type": "object",
+      "description": "Localization validation settings (Localization Manifest Spec v1)",
+      "properties": {
+        "manifest": {
+          "type": "string",
+          "description": "Path to localization manifest.json relative to repo root (e.g., web/locales/manifest.json)"
+        }
+      },
+      "additionalProperties": false
     }
   },
   "required": ["version", "release"],

atdd/coach/utils/locale_phase.py

@@ -0,0 +1,97 @@
+"""
+Localization Manifest Spec v1 Rollout Phase Controller.
+
+Manages the phased rollout of localization validation rules:
+- Phase 1 (WARNINGS_ONLY): All validators emit warnings only
+- Phase 2 (TESTER_ENFORCEMENT): Tester phase validators (LOCALE-TEST-*) strict
+- Phase 3 (FULL_ENFORCEMENT): All validators including Coder (LOCALE-CODE-*) strict
+
+Usage in validators:
+    from atdd.coach.utils.locale_phase import LocalePhase, should_enforce_locale
+
+    if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+        assert condition, "Error message"
+    else:
+        if not condition:
+            emit_locale_warning("LOCALE-TEST-1.1", "Warning message", LocalePhase.TESTER_ENFORCEMENT)
+"""
+
+from enum import IntEnum
+from typing import Optional
+import warnings
+
+
+class LocalePhase(IntEnum):
+    """
+    Rollout phases for Localization Manifest Spec v1.
+
+    Phases are ordered by strictness level:
+    - WARNINGS_ONLY (1): All new validators emit warnings, no assertions
+    - TESTER_ENFORCEMENT (2): Tester phase validators (LOCALE-TEST-*) strict
+    - FULL_ENFORCEMENT (3): All validators including Coder (LOCALE-CODE-*) strict
+    """
+    WARNINGS_ONLY = 1
+    TESTER_ENFORCEMENT = 2
+    FULL_ENFORCEMENT = 3
+
+
+# Current rollout phase - update this to advance through phases
+CURRENT_LOCALE_PHASE = LocalePhase.WARNINGS_ONLY
+
+
+def should_enforce_locale(validator_phase: LocalePhase) -> bool:
+    """
+    Check if a locale validator should enforce strict mode.
+
+    Args:
+        validator_phase: The phase at which this validator becomes strict
+
+    Returns:
+        True if current phase >= validator_phase (should enforce)
+        False if current phase < validator_phase (should warn only)
+
+    Example:
+        # This validator becomes strict in Phase 2
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            assert all_keys_match, "Keys must match reference locale"
+        else:
+            if not all_keys_match:
+                emit_locale_warning("LOCALE-TEST-1.4", "Keys don't match", LocalePhase.TESTER_ENFORCEMENT)
+    """
+    return CURRENT_LOCALE_PHASE >= validator_phase
+
+
+def get_current_locale_phase() -> LocalePhase:
+    """Get the current locale rollout phase."""
+    return CURRENT_LOCALE_PHASE
+
+
+def get_locale_phase_name(phase: Optional[LocalePhase] = None) -> str:
+    """Get human-readable name for a locale phase."""
+    phase = phase or CURRENT_LOCALE_PHASE
+    return {
+        LocalePhase.WARNINGS_ONLY: "Phase 1: Warnings Only",
+        LocalePhase.TESTER_ENFORCEMENT: "Phase 2: Tester Enforcement",
+        LocalePhase.FULL_ENFORCEMENT: "Phase 3: Full Enforcement",
+    }.get(phase, "Unknown Phase")
+
+
+def emit_locale_warning(
+    spec_id: str,
+    message: str,
+    validator_phase: LocalePhase = LocalePhase.TESTER_ENFORCEMENT
+) -> None:
+    """
+    Emit a locale validation warning with phase context.
+
+    Args:
+        spec_id: The SPEC ID (e.g., "LOCALE-TEST-1.1")
+        message: The warning message
+        validator_phase: Phase when this becomes an error
+    """
+    phase_name = get_locale_phase_name(validator_phase)
+    warnings.warn(
+        f"[{spec_id}] {message} (will become error in {phase_name})",
+        category=UserWarning,
+        stacklevel=3
+    )

atdd/coach/validators/shared_fixtures.py

@@ -599,3 +599,52 @@ def wagon_to_train_mapping(train_files: List[Tuple[Path, Dict]]) -> Dict[str, Li
                 mapping[wagon_slug].append(train_id)
 
     return mapping
+
+
+# ============================================================================
+# LOCALIZATION FIXTURES (Localization Manifest Spec v1)
+# ============================================================================
+
+
+@pytest.fixture(scope="module")
+def locale_manifest_path(atdd_config: Dict[str, Any]) -> Optional[Path]:
+    """
+    Get path to localization manifest file from config.
+
+    Returns:
+        Path to manifest file, or None if localization not configured
+    """
+    manifest_rel = atdd_config.get("localization", {}).get("manifest")
+    if not manifest_rel:
+        return None
+    return REPO_ROOT / manifest_rel
+
+
+@pytest.fixture(scope="module")
+def locale_manifest(locale_manifest_path: Optional[Path]) -> Optional[Dict[str, Any]]:
+    """
+    Load localization manifest from configured path.
+
+    Returns:
+        Manifest dict with reference, locales, namespaces, or None if not configured
+    """
+    if locale_manifest_path is None:
+        return None
+    if not locale_manifest_path.exists():
+        return None
+
+    with open(locale_manifest_path) as f:
+        return json.load(f)
+
+
+@pytest.fixture(scope="module")
+def locales_dir(locale_manifest_path: Optional[Path]) -> Optional[Path]:
+    """
+    Get locales directory (parent of manifest file).
+
+    Returns:
+        Path to locales directory, or None if not configured
+    """
+    if locale_manifest_path is None:
+        return None
+    return locale_manifest_path.parent

atdd/coder/validators/test_i18n_runtime.py

@@ -0,0 +1,171 @@
+"""
+i18n runtime validation (Localization Manifest Spec v1).
+
+Validates that runtime code uses the centralized locale manifest:
+- LOCALE-CODE-2.1: i18nConfig.ts imports from manifest (not hardcoded arrays)
+- LOCALE-CODE-2.2: LanguageSwitcher uses shared SUPPORTED_LOCALES
+"""
+
+import re
+import pytest
+from pathlib import Path
+from typing import Optional
+
+from atdd.coach.utils.locale_phase import (
+    LocalePhase,
+    should_enforce_locale,
+    emit_locale_warning,
+)
+from atdd.coach.utils.repo import find_repo_root
+
+# Path constants
+REPO_ROOT = find_repo_root()
+WEB_DIR = REPO_ROOT / "web"
+
+
+def _find_file(base_dir: Path, *possible_paths: str) -> Optional[Path]:
+    """Find first existing file from list of possible paths."""
+    for rel_path in possible_paths:
+        full_path = base_dir / rel_path
+        if full_path.exists():
+            return full_path
+    return None
+
+
+def _read_file_content(path: Path) -> Optional[str]:
+    """Read file content, return None on error."""
+    try:
+        return path.read_text()
+    except Exception:
+        return None
+
+
+@pytest.mark.locale
+@pytest.mark.coder
+def test_i18n_config_uses_manifest(locale_manifest, locale_manifest_path):
+    """
+    LOCALE-CODE-2.1: i18nConfig.ts imports from manifest (not hardcoded arrays)
+
+    Given: Web application with i18n configuration
+    When: Checking i18nConfig.ts or i18n.ts
+    Then: Configuration imports locales from manifest or shared constant
+          NOT hardcoded locale arrays like ['en', 'es', 'fr']
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    i18n_config = _find_file(
+        WEB_DIR,
+        "src/i18nConfig.ts",
+        "src/i18n/config.ts",
+        "src/i18n.ts",
+        "src/lib/i18n.ts",
+        "src/config/i18n.ts",
+    )
+
+    if i18n_config is None:
+        pytest.skip("No i18n config file found in web/src/")
+
+    content = _read_file_content(i18n_config)
+    if content is None:
+        pytest.skip(f"Cannot read {i18n_config}")
+
+    hardcoded_array_pattern = re.compile(
+        r"(?:locales|supportedLocales|SUPPORTED_LOCALES|languages)\s*[=:]\s*\[\s*['\"][a-z]{2}",
+        re.IGNORECASE
+    )
+
+    if hardcoded_array_pattern.search(content):
+        manifest_import_patterns = [
+            r"from\s+['\"].*manifest",
+            r"import.*manifest",
+            r"require\s*\(\s*['\"].*manifest",
+            r"SUPPORTED_LOCALES",
+            r"getSupportedLocales",
+        ]
+
+        has_manifest_usage = any(
+            re.search(pattern, content, re.IGNORECASE)
+            for pattern in manifest_import_patterns
+        )
+
+        if not has_manifest_usage:
+            msg = (
+                f"i18n config has hardcoded locale array: {i18n_config.relative_to(REPO_ROOT)}\n"
+                f"  Should import from manifest.json or use shared SUPPORTED_LOCALES constant"
+            )
+            if should_enforce_locale(LocalePhase.FULL_ENFORCEMENT):
+                pytest.fail(msg)
+            else:
+                emit_locale_warning("LOCALE-CODE-2.1", msg, LocalePhase.FULL_ENFORCEMENT)
+                pytest.skip(msg)
+
+
+@pytest.mark.locale
+@pytest.mark.coder
+def test_language_switcher_uses_shared_locales(locale_manifest, locale_manifest_path):
+    """
+    LOCALE-CODE-2.2: LanguageSwitcher uses shared SUPPORTED_LOCALES
+
+    Given: Web application with language switcher component
+    When: Checking LanguageSwitcher component
+    Then: Component imports locales from shared constant or manifest
+          NOT hardcoded locale arrays
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    switcher_patterns = [
+        "src/components/LanguageSwitcher.tsx",
+        "src/components/LocaleSwitcher.tsx",
+        "src/components/ui/LanguageSwitcher.tsx",
+        "src/components/common/LanguageSwitcher.tsx",
+        "src/features/i18n/LanguageSwitcher.tsx",
+    ]
+
+    switcher_file = _find_file(WEB_DIR, *switcher_patterns)
+
+    if switcher_file is None:
+        switcher_files = list(WEB_DIR.rglob("*[Ll]anguage*[Ss]witcher*.tsx"))
+        if not switcher_files:
+            switcher_files = list(WEB_DIR.rglob("*[Ll]ocale*[Ss]witcher*.tsx"))
+        if switcher_files:
+            switcher_file = switcher_files[0]
+
+    if switcher_file is None:
+        pytest.skip("No LanguageSwitcher component found")
+
+    content = _read_file_content(switcher_file)
+    if content is None:
+        pytest.skip(f"Cannot read {switcher_file}")
+
+    hardcoded_array_pattern = re.compile(
+        r"(?:locales|languages|options)\s*[=:]\s*\[\s*(?:\{[^}]*locale[^}]*['\"][a-z]{2}|['\"][a-z]{2})",
+        re.IGNORECASE
+    )
+
+    if hardcoded_array_pattern.search(content):
+        shared_patterns = [
+            r"SUPPORTED_LOCALES",
+            r"getSupportedLocales",
+            r"from\s+['\"].*manifest",
+            r"from\s+['\"].*i18n",
+            r"from\s+['\"].*config",
+            r"useLocales",
+        ]
+
+        has_shared_usage = any(
+            re.search(pattern, content, re.IGNORECASE)
+            for pattern in shared_patterns
+        )
+
+        if not has_shared_usage:
+            msg = (
+                f"LanguageSwitcher has hardcoded locale array: {switcher_file.relative_to(REPO_ROOT)}\n"
+                f"  Should import from shared SUPPORTED_LOCALES or manifest"
+            )
+            if should_enforce_locale(LocalePhase.FULL_ENFORCEMENT):
+                pytest.fail(msg)
+            else:
+                emit_locale_warning("LOCALE-CODE-2.2", msg, LocalePhase.FULL_ENFORCEMENT)
+                pytest.skip(msg)

atdd/tester/schemas/locale_manifest.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://atdd.dev/schemas/tester/locale_manifest.schema.json",
+  "title": "Locale Manifest",
+  "description": "Schema for localization manifest.json - single source of truth for supported locales and namespaces (Localization Manifest Spec v1)",
+  "type": "object",
+  "required": ["reference", "locales", "namespaces"],
+  "properties": {
+    "reference": {
+      "type": "string",
+      "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
+      "description": "Reference locale code (e.g., 'en', 'en-US'). All other locales must match this locale's keys."
+    },
+    "locales": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z]{2}(-[A-Z]{2})?$"
+      },
+      "uniqueItems": true,
+      "description": "List of supported locale codes. Must include the reference locale."
+    },
+    "namespaces": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]*$"
+      },
+      "uniqueItems": true,
+      "description": "Required namespaces that must exist for all locales (e.g., 'common', 'ui', 'errors')"
+    },
+    "optional_namespaces": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]*$"
+      },
+      "uniqueItems": true,
+      "description": "Optional namespaces that may not exist for all locales. If present, must match reference keys."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "reference": "en",
+      "locales": ["en", "es", "fr", "de", "ja"],
+      "namespaces": ["common", "ui", "errors"],
+      "optional_namespaces": ["landing", "marketing"]
+    }
+  ]
+}

atdd/tester/validators/test_locale_coverage.py

@@ -0,0 +1,451 @@
+"""
+Localization coverage validation (Localization Manifest Spec v1).
+
+Validates locale files against manifest.json as single source of truth:
+- LOCALE-TEST-1.1: Manifest schema compliance
+- LOCALE-TEST-1.2: All locale/namespace files exist
+- LOCALE-TEST-1.3: All files are valid JSON
+- LOCALE-TEST-1.4: Keys match reference locale (deep comparison)
+- LOCALE-TEST-1.5: Types match reference (object/array/primitive)
+- LOCALE-TEST-1.6: Optional namespaces may be missing
+- LOCALE-TEST-1.7: languageNames.<locale> exists in reference ui.json
+"""
+
+import json
+import pytest
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Set, Tuple
+
+import atdd
+from atdd.coach.utils.locale_phase import (
+    LocalePhase,
+    should_enforce_locale,
+    emit_locale_warning,
+)
+from atdd.coach.utils.repo import find_repo_root
+
+# Path constants
+REPO_ROOT = find_repo_root()
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+
+
+def _load_json_file(path: Path) -> Tuple[Optional[Dict], Optional[str]]:
+    """Load JSON file, returning (data, error_message)."""
+    try:
+        with open(path) as f:
+            return json.load(f), None
+    except json.JSONDecodeError as e:
+        return None, f"Invalid JSON: {e}"
+    except Exception as e:
+        return None, str(e)
+
+
+def _get_all_keys(obj: Any, prefix: str = "") -> Set[str]:
+    """
+    Extract all keys from nested object using dot notation.
+    Ignores keys starting with underscore (private/metadata keys).
+    """
+    keys = set()
+    if isinstance(obj, dict):
+        for key, value in obj.items():
+            if key.startswith("_"):
+                continue
+            full_key = f"{prefix}.{key}" if prefix else key
+            keys.add(full_key)
+            keys.update(_get_all_keys(value, full_key))
+    return keys
+
+
+def _get_type_signature(obj: Any) -> str:
+    """Get type signature for comparison (object/array/primitive)."""
+    if isinstance(obj, dict):
+        return "object"
+    elif isinstance(obj, list):
+        return f"array[{len(obj)}]"
+    elif isinstance(obj, bool):
+        return "boolean"
+    elif isinstance(obj, int):
+        return "number"
+    elif isinstance(obj, float):
+        return "number"
+    elif isinstance(obj, str):
+        return "string"
+    elif obj is None:
+        return "null"
+    return "unknown"
+
+
+def _compare_types(ref_obj: Any, target_obj: Any, path: str = "") -> List[str]:
+    """
+    Compare types between reference and target objects recursively.
+    Returns list of type mismatch descriptions.
+    """
+    mismatches = []
+    ref_type = _get_type_signature(ref_obj)
+    target_type = _get_type_signature(target_obj)
+
+    if ref_type.startswith("array") and target_type.startswith("array"):
+        pass
+    elif ref_type != target_type:
+        key_display = path or "(root)"
+        mismatches.append(f"{key_display}: expected {ref_type}, got {target_type}")
+
+    if isinstance(ref_obj, dict) and isinstance(target_obj, dict):
+        for key in ref_obj:
+            if key.startswith("_"):
+                continue
+            if key in target_obj:
+                child_path = f"{path}.{key}" if path else key
+                mismatches.extend(_compare_types(ref_obj[key], target_obj[key], child_path))
+
+    return mismatches
+
+
+@pytest.mark.locale
+def test_locale_manifest_schema_compliance(locale_manifest, locale_manifest_path, load_schema):
+    """
+    LOCALE-TEST-1.1: Manifest schema compliance
+
+    Given: localization.manifest configured in .atdd/config.yaml
+    When: Loading the manifest file
+    Then: File exists and validates against locale_manifest.schema.json
+    """
+    if locale_manifest_path is None:
+        pytest.skip("Localization not configured (localization.manifest not in config)")
+
+    if not locale_manifest_path.exists():
+        msg = f"Manifest file not found: {locale_manifest_path.relative_to(REPO_ROOT)}"
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.1", msg)
+            pytest.skip(msg)
+
+    schema = load_schema("tester", "locale_manifest.schema.json")
+
+    try:
+        import jsonschema
+        jsonschema.validate(locale_manifest, schema)
+    except jsonschema.ValidationError as e:
+        msg = f"Manifest schema validation failed: {e.message}"
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.1", msg)
+            pytest.skip(msg)
+
+    if locale_manifest["reference"] not in locale_manifest["locales"]:
+        msg = f"Reference locale '{locale_manifest['reference']}' not in locales list"
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.1", msg)
+
+
+@pytest.mark.locale
+def test_locale_files_exist(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.2: All <locale>/<namespace>.json files exist
+
+    Given: Manifest with locales and namespaces
+    When: Checking file system
+    Then: All required namespace files exist for all locales
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    missing_files = []
+    locales = locale_manifest.get("locales", [])
+    namespaces = locale_manifest.get("namespaces", [])
+
+    for locale in locales:
+        locale_dir = locales_dir / locale
+        for namespace in namespaces:
+            file_path = locale_dir / f"{namespace}.json"
+            if not file_path.exists():
+                missing_files.append(f"{locale}/{namespace}.json")
+
+    if missing_files:
+        msg = f"Missing locale files ({len(missing_files)}):\n" + "\n".join(f"  - {f}" for f in missing_files[:20])
+        if len(missing_files) > 20:
+            msg += f"\n  ... and {len(missing_files) - 20} more"
+
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.2", msg)
+            pytest.skip(msg)
+
+
+@pytest.mark.locale
+def test_locale_files_valid_json(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.3: All locale files are valid JSON
+
+    Given: Locale namespace files
+    When: Parsing as JSON
+    Then: All files parse without errors
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    invalid_files = []
+    locales = locale_manifest.get("locales", [])
+    namespaces = locale_manifest.get("namespaces", [])
+    optional_namespaces = locale_manifest.get("optional_namespaces", [])
+
+    all_namespaces = namespaces + optional_namespaces
+
+    for locale in locales:
+        locale_dir = locales_dir / locale
+        for namespace in all_namespaces:
+            file_path = locale_dir / f"{namespace}.json"
+            if file_path.exists():
+                _, error = _load_json_file(file_path)
+                if error:
+                    invalid_files.append(f"{locale}/{namespace}.json: {error}")
+
+    if invalid_files:
+        msg = f"Invalid JSON files ({len(invalid_files)}):\n" + "\n".join(f"  - {f}" for f in invalid_files[:10])
+        if len(invalid_files) > 10:
+            msg += f"\n  ... and {len(invalid_files) - 10} more"
+
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.3", msg)
+            pytest.skip(msg)
+
+
+@pytest.mark.locale
+def test_locale_keys_match_reference(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.4: Keys match reference locale (deep comparison, ignore _ prefix)
+
+    Given: Reference locale and other locales
+    When: Comparing keys at all nesting levels
+    Then: All locales have same keys as reference (ignoring _ prefixed keys)
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    reference = locale_manifest.get("reference")
+    locales = locale_manifest.get("locales", [])
+    namespaces = locale_manifest.get("namespaces", [])
+
+    key_mismatches = []
+
+    for namespace in namespaces:
+        ref_path = locales_dir / reference / f"{namespace}.json"
+        ref_data, ref_error = _load_json_file(ref_path)
+
+        if ref_error:
+            continue
+
+        ref_keys = _get_all_keys(ref_data)
+
+        for locale in locales:
+            if locale == reference:
+                continue
+
+            locale_path = locales_dir / locale / f"{namespace}.json"
+            locale_data, locale_error = _load_json_file(locale_path)
+
+            if locale_error:
+                continue
+
+            locale_keys = _get_all_keys(locale_data)
+
+            missing_keys = ref_keys - locale_keys
+            extra_keys = locale_keys - ref_keys
+
+            if missing_keys:
+                key_mismatches.append(
+                    f"{locale}/{namespace}.json missing keys: {', '.join(sorted(missing_keys)[:5])}"
+                    + (f" (+{len(missing_keys) - 5} more)" if len(missing_keys) > 5 else "")
+                )
+
+            if extra_keys:
+                key_mismatches.append(
+                    f"{locale}/{namespace}.json extra keys: {', '.join(sorted(extra_keys)[:5])}"
+                    + (f" (+{len(extra_keys) - 5} more)" if len(extra_keys) > 5 else "")
+                )
+
+    if key_mismatches:
+        msg = f"Key mismatches ({len(key_mismatches)}):\n" + "\n".join(f"  - {m}" for m in key_mismatches[:15])
+        if len(key_mismatches) > 15:
+            msg += f"\n  ... and {len(key_mismatches) - 15} more"
+
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.4", msg)
+            pytest.skip(msg)
+
+
+@pytest.mark.locale
+def test_locale_types_match_reference(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.5: Types match reference (object->object, array->array, primitive->same type)
+
+    Given: Reference locale and other locales
+    When: Comparing value types at each key
+    Then: Types match between reference and all locales
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    reference = locale_manifest.get("reference")
+    locales = locale_manifest.get("locales", [])
+    namespaces = locale_manifest.get("namespaces", [])
+
+    type_mismatches = []
+
+    for namespace in namespaces:
+        ref_path = locales_dir / reference / f"{namespace}.json"
+        ref_data, ref_error = _load_json_file(ref_path)
+
+        if ref_error:
+            continue
+
+        for locale in locales:
+            if locale == reference:
+                continue
+
+            locale_path = locales_dir / locale / f"{namespace}.json"
+            locale_data, locale_error = _load_json_file(locale_path)
+
+            if locale_error:
+                continue
+
+            mismatches = _compare_types(ref_data, locale_data)
+            for mismatch in mismatches:
+                type_mismatches.append(f"{locale}/{namespace}.json: {mismatch}")
+
+    if type_mismatches:
+        msg = f"Type mismatches ({len(type_mismatches)}):\n" + "\n".join(f"  - {m}" for m in type_mismatches[:10])
+        if len(type_mismatches) > 10:
+            msg += f"\n  ... and {len(type_mismatches) - 10} more"
+
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.5", msg)
+            pytest.skip(msg)
+
+
+@pytest.mark.locale
+def test_optional_namespaces_match_reference(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.6: Optional namespaces may be missing; if present, must match reference
+
+    Given: Optional namespaces in manifest
+    When: Checking locale files
+    Then: Optional namespace files may not exist, but if they do, keys must match reference
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    optional_namespaces = locale_manifest.get("optional_namespaces", [])
+    if not optional_namespaces:
+        pytest.skip("No optional namespaces defined")
+
+    reference = locale_manifest.get("reference")
+    locales = locale_manifest.get("locales", [])
+
+    key_mismatches = []
+
+    for namespace in optional_namespaces:
+        ref_path = locales_dir / reference / f"{namespace}.json"
+        ref_data, ref_error = _load_json_file(ref_path)
+
+        if ref_error or ref_data is None:
+            continue
+
+        ref_keys = _get_all_keys(ref_data)
+
+        for locale in locales:
+            if locale == reference:
+                continue
+
+            locale_path = locales_dir / locale / f"{namespace}.json"
+            if not locale_path.exists():
+                continue
+
+            locale_data, locale_error = _load_json_file(locale_path)
+            if locale_error:
+                continue
+
+            locale_keys = _get_all_keys(locale_data)
+
+            missing_keys = ref_keys - locale_keys
+            extra_keys = locale_keys - ref_keys
+
+            if missing_keys:
+                key_mismatches.append(
+                    f"{locale}/{namespace}.json (optional) missing keys: {', '.join(sorted(missing_keys)[:5])}"
+                )
+
+            if extra_keys:
+                key_mismatches.append(
+                    f"{locale}/{namespace}.json (optional) extra keys: {', '.join(sorted(extra_keys)[:5])}"
+                )
+
+    if key_mismatches:
+        msg = f"Optional namespace key mismatches ({len(key_mismatches)}):\n" + "\n".join(f"  - {m}" for m in key_mismatches[:10])
+        if len(key_mismatches) > 10:
+            msg += f"\n  ... and {len(key_mismatches) - 10} more"
+
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.6", msg)
+            pytest.skip(msg)
+
+
+@pytest.mark.locale
+def test_language_names_complete(locale_manifest, locales_dir):
+    """
+    LOCALE-TEST-1.7: languageNames.<locale> exists in reference ui.json
+
+    Given: Manifest with locales list
+    When: Checking reference ui.json for languageNames
+    Then: Each locale in manifest has a corresponding languageNames entry
+    """
+    if locale_manifest is None:
+        pytest.skip("Localization not configured")
+
+    reference = locale_manifest.get("reference")
+    locales = locale_manifest.get("locales", [])
+    namespaces = locale_manifest.get("namespaces", [])
+
+    if "ui" not in namespaces:
+        pytest.skip("No 'ui' namespace configured - skipping languageNames check")
+
+    ui_path = locales_dir / reference / "ui.json"
+    ui_data, ui_error = _load_json_file(ui_path)
+
+    if ui_error:
+        pytest.skip(f"Cannot read reference ui.json: {ui_error}")
+
+    language_names = ui_data.get("languageNames", {})
+    if not language_names:
+        msg = "Reference ui.json missing 'languageNames' object"
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.7", msg)
+            pytest.skip(msg)
+
+    missing_names = []
+    for locale in locales:
+        if locale not in language_names:
+            missing_names.append(locale)
+
+    if missing_names:
+        msg = f"Missing languageNames entries for locales: {', '.join(missing_names)}"
+        if should_enforce_locale(LocalePhase.TESTER_ENFORCEMENT):
+            pytest.fail(msg)
+        else:
+            emit_locale_warning("LOCALE-TEST-1.7", msg)
+            pytest.skip(msg)

{atdd-0.6.1.dist-info → atdd-0.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.6.1
+Version: 0.7.0
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10

{atdd-0.6.1.dist-info → atdd-0.7.0.dist-info}/RECORD

@@ -25,19 +25,20 @@ atdd/coach/commands/tests/test_telemetry_array_validation.py,sha256=WK5ZXvR1avlz
 atdd/coach/conventions/session.convention.yaml,sha256=1wCxQ_Y2Wb2080Xt2JZs0_WsV8_4SC0Tq87G_BCGdiE,26049
 atdd/coach/overlays/__init__.py,sha256=2lMiMSgfLJ3YHLpbzNI5B88AdQxiMEwjIfsWWb8t3To,123
 atdd/coach/overlays/claude.md,sha256=33mhpqhmsRhCtdWlU7cMXAJDsaVra9uBBK8URV8OtQA,101
-atdd/coach/schemas/config.schema.json,sha256=XcqpISpV-57Kk7HdBXz_4K0jqj_SdKgBHy9VyVpNRD8,4191
+atdd/coach/schemas/config.schema.json,sha256=47cFGE5juBv9ewhtgrNir4b6I9imIIo8VjoD9yvASf4,4578
 atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24anlY3B7GjY,2885
 atdd/coach/templates/ATDD.md,sha256=h_oPpKLX7nuafC0VAoKCnkM2-kGQeksR34QWlGyfMwU,13236
 atdd/coach/templates/SESSION-TEMPLATE.md,sha256=cGT_0x5KLbPHOCiuM8evLGpWKIlR-aggqxiBtbjSJoo,9478
 atdd/coach/utils/__init__.py,sha256=7Jbo-heJEKSAn6I0s35z_2S4R8qGZ48PL6a2IntcNYg,148
 atdd/coach/utils/config.py,sha256=6XXaaeVfjTrJwdaR0IZ6Kf1-1ZHhaCVLO5pNx_A2el4,3320
 atdd/coach/utils/coverage_phase.py,sha256=14CzGiTEeb-Z-CMYnJjx1-4dn3LbQVJUlFr_-1bKVMc,3250
+atdd/coach/utils/locale_phase.py,sha256=S6eORhvj2N412BOY4QFQGcLA_twsr_D4vviy4X-KDNo,3236
 atdd/coach/utils/repo.py,sha256=0kiF5WpVTen0nO14u5T0RflznZhgGco2i9CwKobOh38,3757
 atdd/coach/utils/train_spec_phase.py,sha256=Mk8CiMoO6jb-VGttHgI20KIG26r9cjSz4gDfk01q1M0,3025
 atdd/coach/utils/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/utils/graph/urn.py,sha256=O2AHIB_CmmMUvXzyejc_oFReNW_rOcw7m4qaqSYcnNQ,33558
 atdd/coach/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atdd/coach/validators/shared_fixtures.py,sha256=q-J39x0pxdEWJmRWe45i6VyYy8-0MHsi9ElMAvDx3MA,19474
+atdd/coach/validators/shared_fixtures.py,sha256=Ia3B2fUW-aKibwVPF6RnRemtu3R_Dfb-2MvPVNitgxg,20931
 atdd/coach/validators/test_enrich_wagon_registry.py,sha256=WeTwYJqoNY6mEYc-QAvQo7YVagSOjaNKxB6Q6dpWqIM,6561
 atdd/coach/validators/test_registry.py,sha256=ffN70yA_1xxL3R8gdpGbY2M8dQXyuajIZhBZ-ylNiNs,17845
 atdd/coach/validators/test_release_versioning.py,sha256=B40DfbtrSGguPc537zXmjT75hhySfocWLzJWqOKZQcU,5678
@@ -84,6 +85,7 @@ atdd/coder/validators/test_green_layer_dependencies.py,sha256=8TWuTD3RrDBqp9LUCS
 atdd/coder/validators/test_green_python_layer_structure.py,sha256=WXo1VA5-WprgtAQgC8ekhuIRJR47b_qgTYTjPn7svms,4389
 atdd/coder/validators/test_green_supabase_layer_structure.py,sha256=cLj85acLX6Knewk9AWbiJDwEzoaE-NBNollyJCvRUD0,4371
 atdd/coder/validators/test_hierarchy_coverage.py,sha256=1JuaiO4k-v3_rL5x4-MPsKajAv-K5cTzevW5eS4cC-U,12240
+atdd/coder/validators/test_i18n_runtime.py,sha256=pmx1nhvOS1nk2xa1E5Lm8yPgpylNhV6AjDECeIzN4Pg,5575
 atdd/coder/validators/test_import_boundaries.py,sha256=3kzVMKIwZU9FcS0YLU8gsuHSDRlRr2rU3UPgoraV2FU,11811
 atdd/coder/validators/test_init_file_urns.py,sha256=uDJ2MgfJNFcjzoIKItn73n9V08m3ZBkt1SAZgHWdXPs,17914
 atdd/coder/validators/test_preact_layer_boundaries.py,sha256=rabXY9gif3b8QH9_Kz5Pu6FZSvDpfQKDm_SKjdpLD44,7766
@@ -149,6 +151,7 @@ atdd/tester/schemas/event.tmpl.json,sha256=3-7cSaesuPcVZP5NENrg-GnDRQPbwkWB_1ISI
 atdd/tester/schemas/http.tmpl.json,sha256=zrynEO18HmEXanQDVk3XZNHNOp1lUyVKXTR-f7_KAGI,818
 atdd/tester/schemas/job.tmpl.json,sha256=7HtX-esAb9asB-9uNyuWDRKE-HWovlNnuYYllSzjJDg,926
 atdd/tester/schemas/load.tmpl.json,sha256=wSPfGXTEVQrgsqVXihwiDIKWS_QErkXlh2WdVJwLqoc,971
+atdd/tester/schemas/locale_manifest.schema.json,sha256=4-A25522C4Bdy7Y3I9USqsk4K97hkv3rTr60-dcVZAk,1736
 atdd/tester/schemas/metric.tmpl.json,sha256=jHTQgAsnVXWPlQipjnu79eqZwvHcDV5giaoN9w1HZdY,949
 atdd/tester/schemas/pack.schema.json,sha256=pQfbvaB5Kl1SFCewz60zaTRviuZm-gM_9QCYipJWa3w,4575
 atdd/tester/schemas/realtime.tmpl.json,sha256=c9Sbkqk6vFUhzTWI2slfyTfEwJ0ltFhQrtjPabRLtmo,1141
@@ -183,6 +186,7 @@ atdd/tester/validators/test_dual_ac_reference.py,sha256=LDhIqXyVxgWVCgj7FneDTLt6
 atdd/tester/validators/test_fixture_validity.py,sha256=Fp4AWwhvZlos1ik_d7NbP030Qq-klZLnCmc12ylptqs,12101
 atdd/tester/validators/test_hierarchy_coverage.py,sha256=o2jd3dsqvqtqQ3I3RQa4FGoYIJE0vArUIISurDxYTgw,21060
 atdd/tester/validators/test_isolation.py,sha256=NYrqJcVDZH0SDRWHlPdazG6THT4w3XEvz_xn4PBxU4E,16489
+atdd/tester/validators/test_locale_coverage.py,sha256=amnZAx5wTvF6mGbclvu40n0XhYBKLl97SnBVkbLMv1E,15487
 atdd/tester/validators/test_migration_coverage.py,sha256=LOx0L9KLH4gVisNHXhxKrzHLgCgj4PVZxeZ-2gg-SQk,7344
 atdd/tester/validators/test_migration_criteria.py,sha256=YDGvWjkVSjUVVNv4RJWLdy4iLoG1EXzmm_ficD0Gt3Q,7896
 atdd/tester/validators/test_migration_generation.py,sha256=wpTmuxvM13OfSgC-3SJBdtB2XaPjBYyD-jXVYWi7Z9Q,4064
@@ -196,9 +200,9 @@ atdd/tester/validators/test_train_frontend_e2e.py,sha256=fpfUwTbAWzuqxbVKoaFw-ab
 atdd/tester/validators/test_train_frontend_python.py,sha256=KK2U3oNFWLyBK7YHC0fU7shR05k93gVcO762AI8Q3pw,9018
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.6.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.6.1.dist-info/METADATA,sha256=tQJjLbry8VRfv7IXzkaChFTwEM_yoV9QZjEa17TEb5A,8716
-atdd-0.6.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.6.1.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.6.1.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.6.1.dist-info/RECORD,,
+atdd-0.7.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.7.0.dist-info/METADATA,sha256=EEjcJY5c8XfUKF8ebYBc1o3mjFrJqqJldicW2coK-iQ,8716
+atdd-0.7.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.7.0.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.7.0.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.7.0.dist-info/RECORD,,