[FIX]: Preserve reports with duplicate timestamps

[Rio Yu (rioyu123)]

Description

JsonFileReportSink used a seconds-precision timestamp with write_text(). Two reports emitted within the same second therefore resolved to the same path, allowing the later report to silently replace the first.

This change preserves every report while keeping the common filename concise:

• Report filenames now use a UTC timestamp with millisecond precision, for example run_report_2026-04-25T14-30-00-123.json.
• The timestamp path is created exclusively with mode x, so an existing report is never overwritten.
• A UUID suffix is added only when the timestamp path already exists; the fallback path is also created exclusively.
• Reports continue to be fully serialized before any output file is opened, so serialization failures do not leave empty report files.
• Report content is written with explicit UTF-8 encoding instead of the platform default.

The usage guide and API documentation now describe the concise common filename, collision fallback, and remaining error cases. Tests cover repeated timestamps, existing-file preservation, a forced fallback collision, and serialization failure.

Validation:

• uv run pre-commit run --all-files — passed
• uv run pytest tests/unit/reporting -q — 46 passed
• uv run pytest tests/unit -q — 1035 passed on Linux; 1033 passed and 2 skipped on Windows
• uv run --group docs mkdocs build --strict — passed on Linux

Breaking changes

There are no public API or report-schema changes. Generated filenames now include milliseconds and may include a UUID suffix on collision. Consumers using run_report_*.json are unaffected; consumers parsing the exact timestamp format should account for the additional millisecond segment.

Checklist

• pre-commit run --all-files passes
• Tests added or updated for changes
• Documentation updated

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[Rio Yu (rioyu123)]

@microsoft-github-policy-service agree

[Nina Chikanov (nina-msft)]

Thanks for flagging this Rio Yu (@rioyu123)! Let me know what you think of the following comments :-)

Whoops - meant to comment only instead of approval :-)

[Nina Chikanov (nina-msft)]

Thanks for your contribution Rio Yu (@rioyu123) :-)