docs(ruff-format): missing hook-telemetry data schema + registry row

[kyle-sexton]

Summary

plugins/ruff-format/hooks/ruff-format.sh calls hook::emit_telemetry("ruff-format", ...) and emits a schema-shaped envelope, but unlike markdown-format and (now) typos-format, it never shipped:

• docs/conventions/hook-telemetry/data/ruff-format.schema.json
• A row in docs/conventions/hook-telemetry/README.md's Implementers table

Found during independent review of #872 (typos-format plugin), which used ruff-format as one of its two reference plugins for the hook-telemetry convention and discovered the gap while comparing against markdown-format's complete schema+registry-row pair.

Impact

Low — the envelope itself is correctly shaped and functions; this is purely a documentation-conformance gap (a consumer sink discovering the ruff-format hook value has no published data schema to validate against, per the convention's own "Per-hook data" discovery mechanism).

Fix

Add docs/conventions/hook-telemetry/data/ruff-format.schema.json (mirror markdown-format.schema.json's shape: {tool, file, findings}, adjusted for Ruff's findings shape — array of diagnostic strings, matching what ruff-format.sh actually emits) and add the corresponding row to the Implementers table.

Related

• Surfaced during feat(typos-format): add per-file typos autofix hook plugin #872 (epic Epic: lint/static-analysis gap closure #830, docs/topics/lint-static-analysis-gaps/PLAN.md).

[kyle-sexton]

This was generated by AI during triage.

Triage → status: ready (briefed, delegable). T1 docs-conformance: ruff-format emits hook-telemetry but never shipped its data/ruff-format.schema.json + Implementers-table row (unlike markdown-format / typos-format). Clear fix (per the issue body): add the schema mirroring markdown-format.schema.json's {tool, file, findings} shape, adjusted to the findings shape ruff-format.sh actually emits (array of diagnostic strings), plus the corresponding Implementers-table row. Impact LOW (the envelope functions; purely a per-hook data-schema discovery gap). Zero open design. Priority medium (ruff-format outside the week's priority set). Type Task.

[kyle-sexton]