Add docs-builder format command

[theletterf]

Fixes #2083

Added a new docs-builder format command to automatically fix formatting issues in documentation files. The command currently handles irregular space characters (no-break spaces, en spaces, zero-width spaces, etc.) by replacing them with regular spaces. The formatter only processes markdown files included in the docset configuration.

Note that the command supports a --dry-run flag to preview changes without modifying files. I also updated the space normalizer linter to emit a single hint per file instead of per occurrence, directing users to run docs-builder format to fix all instances automatically.

The formatter architecture is extensible by using the IFormatter interface, making it straightforward to add additional formatting operations in the future (trailing whitespace, line endings, etc.) without modifying the core service logic.

How to test

1. Add irregular spaces

python3 -c "with open('docs/index.md', 'r') as f: content = f.read(); content = content.replace('Elastic Docs V3 is our', 'Elastic Docs V3 is\u00A0our'); open('docs/index.md', 'w').write(content)"

2. Build and see hint

dotnet run --project src/tooling/docs-builder/docs-builder.csproj -- --path docs 2>&1 | grep Hint

3. Format to fix

dotnet run --project src/tooling/docs-builder/docs-builder.csproj -- format --path docs

4. Verify hint is gone

dotnet run --project src/tooling/docs-builder/docs-builder.csproj -- --path docs 2>&1 | grep Hint

—

Co-authored by Claude 4.5 using Claude CLI 2.0 inside Cursor

[github-actions]

🔍 Preview links for changed docs

• docs/cli/docset/format.md
• docs/index.md

[Mpdreamz]

Love it! Some small PR notes.

[theletterf]

Added --check and --write flags