Function validate_package

ci/util/package_validator.py:18–56

Validate that package is correctly installed using exception-style recovery. This uses exception-based validation - we only fail if we encounter actual exceptions when reading package metadata. No arbitrary prechecks (like file counts) are performed, as these cause false positives with

(package_dir: Path)

def validate_package(package_dir: Path) -> tuple[bool, str]:
    """Validate that package is correctly installed using exception-style recovery.

    This uses exception-based validation - we only fail if we encounter actual
    exceptions when reading package metadata. No arbitrary prechecks (like file
    counts) are performed, as these cause false positives with wrapper packages.

    Args:
        package_dir: Path to package directory

    Returns:
        (is_valid, error_message)
    """
    try:
        # Try to read package.json - this is the critical test
        # If we can successfully parse it, the package is usable
        package_json = package_dir / "package.json"

        with open(package_json, "r") as f:
            data = json.load(f)

        # Verify essential fields are present
        required_fields = ["name", "version"]
        for field in required_fields:
            if field not in data:
                return False, f"Missing '{field}' in {package_dir.name}/package.json"

        # Success - package.json is readable and valid
        return True, ""

    except FileNotFoundError:
        return False, f"Missing package.json in {package_dir.name}"
    except json.JSONDecodeError as e:
        return False, f"Corrupted package.json in {package_dir.name}: {e}"
    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise
    except Exception as e:
        return False, f"Cannot read package.json in {package_dir.name}: {e}"


def get_required_packages(project_dir: Path, environment: str) -> list[str]: