feat(logs): accept Docker-compatible timestamp filters

[stephenlclarke]

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update

Motivation and Context

This is a draft stacked follow-up to #1592 and #1764. Once log retrieval filters are exposed through ContainerLogOptions, the CLI should accept the timestamp forms users expect from Docker-compatible log commands instead of only accepting RFC 3339 values.

Docker-compatible log workflows commonly use Unix timestamps, fractional Unix timestamps, and relative Go-style durations such as 1m30s. External orchestrators need the same parser behavior as the container logs CLI, so this draft moves timestamp parsing into ContainerResource as a small reusable helper rather than leaving ad hoc parsing in the command layer.

Draft/stacking note: this branch is based on the updated logs-tail-until-options branch from #1764, which is itself based on #1592. Because GitHub PRs to apple/container target main, this diff includes #1592 and #1764. The intended review delta for this draft is:

• d7cc54c feat(logs): accept docker-compatible timestamps
• eaf8fce test(logs): cover relative timestamp arguments
• fdb387e fix(logs): parse date-only filters in local time
• b3929ca fix(logs): accept signed relative durations

What Changed

• Adds ContainerLogTimestampParser in ContainerResource.
• Supports RFC 3339 timestamps with or without fractional seconds.
• Parses date-only and no-zone timestamps using the local timezone, matching Docker-style CLI behavior.
• Supports Unix timestamps with optional fractional seconds.
• Supports Go-style relative durations such as 1m30s, 250ms, and 1.5h.
• Supports signed Go-style relative durations such as +1s, -1s, and -.5h.
• Rejects non-finite duration components instead of letting overflow produce invalid dates.
• Updates container logs --since and --until argument parsing to use the shared parser.
• Documents accepted timestamp formats in docs/command-reference.md.
• Adds focused parser and CLI argument tests.

Relationship to Existing Work

• Depends on Add container log retrieval options #1592 for the initial log options API direction.
• Depends on feat(logs): add tail and until retrieval filters #1764 for the tail / until retrieval filter surface.
• Related to [Request]: Add container log retrieval options #1591 and Support Docker Compose-compatible container log semantics #1752.
• This remains generic container logs behavior; no Compose-specific behavior is included.

Non-Goals

• This does not add structured log records.
• This does not change runtime log storage.
• This does not add timestamp rendering.
• This does not add day-based duration units; Docker's duration parser is Go-duration based, so supported units are ns, us/µs/μs, ms, s, m, and h.

Testing

• Tested locally
• Added/updated tests
• Added/updated docs

Local verification:

swift format lint --strict --configuration .swift-format-nolint Sources/ContainerResource/Container/ContainerLogTimestampParser.swift Sources/ContainerCommands/Container/ContainerLogs.swift Tests/ContainerCommandsTests/ContainerLogsCommandTests.swift Tests/ContainerResourceTests/ContainerLogOptionsTests.swift Sources/Services/ContainerAPIService/Server/Containers/ContainersService.swift Tests/ContainerAPIServiceTests/ContainerLogsTests.swift
git diff --check
swift build
swift test --filter ContainerLogsCommandTests
swift test --filter ContainerLogsTests
swift test --filter ContainerLogOptionsTests

Result: focused validation passed locally. The focused tests ran 31 tests across ContainerLogsCommandTests, ContainerLogsTests, and ContainerLogOptionsTests.