admin: migrate to centralized linting workflows

[hdamker-bot]

CAMARA Project Admin Update - Linting Migration

This pull request migrates this repository from local linting configuration to centralized linting workflows managed by the CAMARA project.

🔄 Migration Summary

Removed local linting artifacts:

• megalinter.yml
• spectral_oas_lint.yml
• .gherkin-lintrc
• Lint function scripts in /lint_function/

Added centralized workflows:

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

✨ Benefits of Centralized Linting

1. Always Up-to-Date: Linting rules and workflows are automatically updated across all repositories
2. Consistent Standards: Ensures uniform code quality checks across all CAMARA APIs
3. Reduced Maintenance: No need to maintain linting configurations locally
4. Enhanced Features: Access to latest tooling improvements without manual updates
5. Simplified Configuration: Workflows reference the centralized tooling repository

📋 What This Means for You

• No action required for basic operation - workflows will run automatically
• All existing checks continue with improved reliability
• Custom configurations can be discussed with the Release Management team if needed

🔧 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

⚠️ Important: This PR introduces linting workflows that will validate repository content.

Note on Linting Checks: The linting workflows are currently not blocking - they will not prevent this PR (or future PRs) from being merged. However, it is highly recommended to:

• Fix all linting errors before merging
• Establish a practice of only merging PRs that pass linting checks successfully
• All linting errors must be addressed before creating a release

This approach maintains code quality while allowing flexibility during the transition period.

Before Merging This PR:

1. Review linting results in PR checks:

   • Check the "Checks" tab for workflow results
   • Note any linting errors or warnings reported

2. Fix linting errors (strongly recommended):

   • 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
   • While not required for merge, fixing issues now prevents accumulation of technical debt

3. Approve and merge this PR 🚀

After Merge:

1. Establish linting best practices:

   • Although checks are not blocking, treat linting errors as issues to fix
   • Aim to merge only PRs where linting checks pass successfully
   • This maintains code quality standards and prevents regression
   • Remember: Linting errors must be fixed before any release can be created

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:

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

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

---

🤖 Generated via project-admin workflow
Triggered by hdamker, 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: ❌ ERROR

Descriptor	Linter	Files	Fixed	Errors	Elapsed time
✅ ACTION	actionlint	2		0	0.01s
✅ API	spectral	1		0	1.59s
❌ GHERKIN	gherkin-lint	1		1	0.31s
✅ REPOSITORY	git_diff	yes		no	0.0s
✅ REPOSITORY	secretlint	yes		no	0.62s
❌ YAML	yamllint	1		1	0.44s

See detailed report in MegaLinter reports

MegaLinter is graciously provided by

[FabrizioMoggio]

ok

[hdamker]

@FabrizioMoggio Do you plan to create an issue for the Gherkin linting issues? Would at least make sense to address them before the next feature PR to avoid getting disturbed by the failed check.

[FabrizioMoggio]

@FabrizioMoggio Do you plan to create an issue for the Gherkin linting issues? Would at least make sense to address them before the next feature PR to avoid getting disturbed by the failed check.

@hdamker got it. Yes I will address the linting errors