admin: migrate to centralized linting workflows

[hdamker-bot]

CAMARA Project Admin Update - Linting Setup

This pull request adds centralized linting workflows to ensure code quality and API specification compliance.

✅ Added Workflows

• spectral-oas-caller.yml - Spectral linting with CAMARA ruleset for OpenAPI validation
• pr_validation_caller.yml - Comprehensive PR validation checks

✨ Benefits

1. Automated Quality Checks: Ensures API specifications meet CAMARA standards
2. PR Validation: Automatic checks on all pull requests
3. Always Current: Workflows reference centralized tooling for latest updates
4. Zero Maintenance: No local configuration needed

📋 What This Means for You

• Automated validation on all pull requests to main branch
• Immediate feedback on API specification compliance
• No local setup required - everything is managed centrally

🔧 Technical Details

The new workflows reference reusable workflows from:
camaraproject/tooling/.github/workflows/

This ensures all repositories benefit from:

• Latest Spectral rules for OpenAPI validation
• Consistent PR validation checks
• Centralized rule management
• Automated tooling updates

👥 Next Steps for Codeowners

⚠️ Since this repository had no prior linting, there may be existing issues to address.

⚠️ Important: This PR introduces linting workflows that will validate repository content. Linting errors will block this PR from merging until resolved.

Before This PR Can Be Merged:

1. Review linting results in PR checks:

   • Check the "Checks" tab for workflow results
   • All linting errors must be resolved before merge is possible

2. Fix linting errors directly in this PR:

   • Address all OpenAPI specification issues (Spectral and yamllint errors)
   • Address all test definitions issues (gherkin-lint errors)
   • Push fixes to this PR branch to re-trigger validation
   • Repeat until all checks pass successfully

Approve and merge this PR 🚀

After Successful Merge:

1. Monitor the new linting system:

   • All future PRs will be subject to the same linting requirements
   • Contributors will need to fix linting issues before their PRs can merge
   • This ensures code quality standards are maintained going forward

2. Test with additional rules (optional):

   • Verify OpenAPI specification with lower severity rules (warnings, hints, info)
   • Go to Actions tab → "Caller for Spectral linting with CAMARA ruleset" → Run workflow
   • Check workflow logs - if needed create an issue to improve your API specification

3. Monitor future PRs:

   • First PRs after this may reveal new edge cases
   • Provide guidance to contributors on common linting fixes
   • The Release Management team can assist with complex issues

💡Pro tip: Running the Spectral workflow manually NOW is highly recommended. This allows you to fix issues proactively rather than discovering them when submitting your next feature PR!

---

🤖 Generated via project-admin workflow
Triggered by rartych, executed via hdamker-bot

➡️ Next Steps: This PR should be reviewed, fixed as needed, approved, and merged by repository codeowners following standard review processes.

---

This is a manually triggered automated administrative update.

[github-actions]

🦙 MegaLinter status: ✅ SUCCESS

Descriptor	Linter	Files	Fixed	Errors	Elapsed time
✅ ACTION	actionlint	2		0	0.01s
✅ API	spectral	1		0	1.74s
✅ GHERKIN	gherkin-lint	3		0	1.08s
✅ REPOSITORY	git_diff	yes		no	0.02s
✅ REPOSITORY	secretlint	yes		no	0.78s
✅ YAML	yamllint	1		0	0.48s

See detailed report in MegaLinter reports

MegaLinter is graciously provided by

[chinaunicomyangfan]

LGTM