Added Swagger (OpenAPI) integration for API contract validation

[KyrillosNageh]

Summary:

• Added Swagger (OpenAPI) contract validation for API testing in SHAFT.
• Supports both Swagger 2.x and OpenAPI 3.x.
• Automatically validates API responses against schema.
• Integrated into perform() method for seamless testing.

📌 Related Issue: #1917

[codecov]

Codecov Report

Attention: Patch coverage is 26.88172% with 68 lines in your changes missing coverage. Please review.

Project coverage is 49.87%. Comparing base (f9e245d) to head (093b1ec).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...c/main/java/com/shaft/tools/io/SwaggerManager.java	24.67%	49 Missing and 9 partials ⚠️
src/main/java/com/shaft/api/RequestBuilder.java	35.71%	8 Missing and 1 partial ⚠️
...c/main/java/com/shaft/properties/internal/Api.java	0.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1918      +/-   ##
============================================
- Coverage     52.40%   49.87%   -2.53%     
+ Complexity     1398     1337      -61     
============================================
  Files           115      117       +2     
  Lines         10574    10665      +91     
  Branches       1048     1070      +22     
============================================
- Hits           5541     5319     -222     
- Misses         4372     4687     +315     
+ Partials        661      659       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.