[Docker Compatibility] Missing --since, --until, and label filtering in `finch events`

[tinovyatkin]

Summary

Finch's events command has limited support for time-based and label filtering compared to Docker CLI. The --since, --until, and label filter options either don't work as expected or are not implemented.

Upstream Issue

This is an nerdctl limitation tracked at: containerd/nerdctl#4690

Docker Behavior

# Events from the last 10 minutes
docker events --since '10m'

# Events in a time range
docker events --since '2024-01-05T00:35:30' --until '2024-01-05T00:36:05'

# Filter by label
docker events --filter 'label=com.docker.compose.project=myproject'

Podman Compatibility

Podman fully supports --since, --until with both RFC3339 timestamps and Go duration strings.

Impact

This gap affects tools that monitor container events:

• VS Code Docker extension (uses --since to fetch recent events on reconnection)
• CI/CD pipelines monitoring deployment events
• Monitoring and alerting dashboards

Workaround

A workaround for VS Code Docker extension is implemented in PR #327 that:

• Parses relative time strings and applies client-side filtering
• Throws a clear error when label filtering is requested

Suggested Action

Consider contributing the implementation upstream to nerdctl to maintain Docker CLI compatibility.

[pendo324]

Thank you for the detailed report @tinovyatkin

I've added this to our backlog for tracking