feat: Add LLM-friendly datetime formats for all time-based parameters

[oskar-korczak]

Summary

This PR adds support for human-readable datetime formats across all time-based parameters (from, to, start, end, until), making it much easier for LLMs to specify time ranges without calculating epoch timestamps.

Supported Formats

Format	Example	Description
Epoch seconds	1732713600	Traditional Unix timestamp (number) - backward compatible
now	now	Current time
Relative time	now-1h, now-30m, now-7d, now-2w	Time relative to now (s/m/h/d/w)
ISO 8601	2025-11-28T12:00:00Z, 2025-11-28	Standard datetime format
Shortcuts	yesterday, today, last week, last month	Common time references

Example Usage

# Get logs from the last hour
from: "now-1h", to: "now"

# Get logs from yesterday
from: "yesterday", to: "today"

# Get logs for a specific date range
from: "2025-11-01", to: "2025-11-28"

Changes

• New: src/utils/datetime-parser.ts - Centralized datetime parsing utility
• Updated: All schema files to accept number | string union types for time parameters
• Updated: All tool implementations to use the datetime parser before API calls
• Added: 24 tests for the datetime parser
• Updated: README with documentation for new datetime formats

Motivation

LLMs struggle with epoch timestamp calculations. This change allows natural language-like time specifications while maintaining full backward compatibility with numeric timestamps.

Test plan

• All existing tests pass
• New datetime parser tests pass (24 tests)
• Build compiles successfully
• Tested with Claude Code - LLM-friendly formats work correctly

🤖 Generated with Claude Code