[walterjgsp]

Summary

Phase 3 of #46, the consumer contract. docs/coverage-lcov.md documents, for any consumer (an annotated source view, a dashboard such as Veritas):

• where each test rule keeps its raw lcov report (plz-out/bin/<package>/<target>.lcov) and its lifetime (only under plz cover, last executed run, not recreated from a cached result);
• the lcov records used, and what each rule set provides (real or 0/1 counts, functions, real, anonymous or synthesized branches);
• how to classify a line as covered, uncovered, partial or not executable, and how to merge reports (and why not to compare arm numbers across tools);
• the reference implementation, tools/common/lcov.

Linked from docs/README.md. Docs only; the Veritas side is not part of this repository.

Test plan

• prettier --check "**/*.md"
• Statements checked against the merged implementations and the fixtures' output (feat(common): add shared lcov package #47, feat(ts): export the raw lcov report of ts_test targets #48, feat(kotlin): export the raw lcov report of kotlin_test targets #49, feat(common): derive partial-line branches from llvm-cov regions #50, feat(rust): export the raw lcov report of rust_test targets #51, feat(swift): export the raw lcov report of swift_test targets #52)

🤖 Generated with Claude Code