fix: honor test annotations

[marcossevilla]

Description

Fixes #1723

Honor test suite annotations (@Timeout, @Tags, @TestOn, @Skip, and dart_test.yaml configuration) when the test optimizer generates the aggregated test entry point.

Changes

• Add suite_annotations support to the test_optimizer brick so per-file annotations and suite configuration are preserved.
• Update test_cli_runner to honor these annotations.
• Add e2e fixtures and tests covering timeout, tags, test_on, skip, and configured suites.
• Update documentation.

Checklist

• Tests added/updated
• Docs updated

[marcossevilla]

closing since #1726 might contain significant changes that might affect this, so we might as well land that first and continue from there