Integration with development tools

[TinaHeiligers]

Parent Issue: Part of elastic/kibana-team#1971

User Story ID: OAS-010

Description: As a developer, I want validation feedback to integrate with my existing development tools using the enhanced CLI tool so that I can address issues efficiently

Acceptance Criteria:

• Enhances existing VS Code integration to use the improved CLI tool
• Extends the existing command-line interface (scripts/validate_oas_docs.js) for local testing and debugging
• Integrates with existing make api-docs-lint workflow while adding new capabilities
• Offers file-specific validation for targeted testing using enhanced CLI tool
• Maintains compatibility with existing OAS development patterns
• Leverages existing @kbn/validate-oas package integration
• Supports new output formats for better development experience

Priority: Medium
Phase: 2 - Local Validation Tool

Related Files:

• scripts/validate_oas_docs.js (enhanced CLI tool)
• packages/kbn-validate-oas/ (existing validation package)
• .vscode/kibana-lint-oas.json
• oas_docs/makefile
• Existing VS Code OAS linting configuration

---

This issue is part of the OAS Quality Feedback Automation project tracked in elastic/kibana-team#1971.

[elasticmachine]

Pinging @elastic/kibana-core (Team:Core)

[TinaHeiligers]

Closing as DONE

Implementated in the makefile

# oas_docs/makefile
.PHONY: api-docs-lint
api-docs-lint: ## Run redocly API docs linter
	@npx @redocly/cli lint "output/*.yaml" --config "linters/redocly.yaml"

.PHONY: api-docs-lint-stateful
api-docs-lint-stateful: ## Run redocly API docs linter on kibana.yaml