validate-integration-docs

Lint an integration package's docs source, filter template noise, propose fixes, then verify the rendered output.

Phase 1 — Lint the source

1. Check prerequisites: run both checks before continuing:

   • vale --version — if not found, tell the user to install it by following the Elastic vale linter guide.
   • elastic-package version — if not found, tell the user to install it by following the elastic-package install guide.

   Stop and report any missing tools before proceeding.

2. Locate the package root: find the nearest ancestor directory (including cwd) that contains both manifest.yml and _dev/build/docs/README.md. If not found, ask the user for the path before continuing.

3. Run vale on the source:

   vale _dev/build/docs/README.md --output JSON