cursus.validation.alignment.unified_alignment_tester

Enhanced Unified Alignment Tester

This module provides a configuration-driven unified interface for testing alignment across all validation levels in the cursus framework. It orchestrates validation based on step-type-aware configuration rules.

Enhanced with: - Configuration-driven validation level control - Step-type-aware validation - Priority-based validation system - Consolidated discovery methods - Method interface focus

class UnifiedAlignmentTester(workspace_dirs=None, **kwargs)

Bases: object

Enhanced Unified Alignment Tester with configuration-driven validation.

This class orchestrates validation across all levels based on step-type-aware configuration rules, providing dramatic performance improvements through validation level skipping.

run_full_validation(target_scripts=None, skip_levels=None)

Enhanced run_full_validation with configuration-driven approach.

Parameters:

• target_scripts (List[str] | None) – Optional list of specific scripts to validate

• skip_levels (Set[int] | None) – Optional set of validation levels to skip (legacy support)

Returns:

Dictionary containing validation results

Return type:

Dict[str, Any]

run_validation_for_step(step_name)

Run validation for a specific step based on its ruleset.

Parameters:

step_name (str) – Name of the step to validate

Returns:

Dictionary containing validation results

Return type:

Dict[str, Any]

run_validation_for_all_steps()

Run validation for all discovered steps.

Returns:

Dictionary containing validation results for all steps

Return type:

Dict[str, Any]

validate_specific_script(step_name, skip_levels=None)

Validate a specific script - maintained for backward compatibility.

Parameters:

• step_name (str) – Name of the step to validate

• skip_levels (Set[int] | None) – Optional set of validation levels to skip (ignored in new system)

Returns:

Dictionary containing validation results

Return type:

Dict[str, Any]

discover_scripts()

Discover scripts - maintained for backward compatibility.

Returns:

List of discovered script names (only steps with actual script files)

Return type:

List[str]

get_validation_summary()

Get validation summary - enhanced with step-type-aware metrics.

Returns:

Dictionary containing validation summary

Return type:

Dict[str, Any]

export_report(format='json', output_path=None)

Export validation report - enhanced with configuration insights.

Parameters:

• format (str) – Report format (“json” or “html”)

• output_path (str | None) – Optional output file path

Returns:

Report content as string

Return type:

str

print_summary()

Print enhanced validation summary to console.

get_critical_issues()

Get critical validation issues - step-type-aware critical issue analysis.

Returns:

List of critical issues

Return type:

List[Dict[str, Any]]

get_step_info_from_catalog(step_name)

Get step information from step catalog - maintained for backward compatibility.

Parameters:

step_name (str) – Name of the step

Returns:

StepInfo object or None if not found

Return type:

Any | None

get_component_path_from_catalog(step_name, component_type)

Get component file path from step catalog - maintained for backward compatibility.

Parameters:

• step_name (str) – Name of the step

• component_type (str) – Type of component (‘script’, ‘contract’, ‘spec’, ‘builder’, ‘config’)

Returns:

Path to component file or None if not found

Return type:

Path | None

validate_cross_workspace_compatibility(step_names)

Validate compatibility across workspace components - simplified with configuration.

Parameters:

step_names (List[str]) – List of step names to validate

Returns:

Compatibility validation results

Return type:

Dict[str, Any]