Rust CLI Date/Time Parser Development

Development environment for tu - a Rust CLI tool that converts natural language date/time strings to UTC.

Instructions

1. **Configure the AI model:**

- Use Gemini 2.5 Pro for enhanced Rust code understanding and generation

- Model ID: `gemini/gemini-2.5-pro`

2. **Set up testing workflow:**

- Run `cargo test` after each significant change to validate functionality

- Focus on regression prevention and edge cases for date/time parsing

- Review integration tests in `tests/integration.rs` for expected behavior

3. **Track core source files:**

- `src/chrono_english/errors.rs` - Error handling for parsing failures

- `src/chrono_english/lib.rs` - Core chrono-english integration

- `src/chrono_english/parser.rs` - Natural language parsing logic

- `src/chrono_english/types.rs` - Type definitions for date/time structures

- `src/lib.rs` - Library interface

- `src/main.rs` - CLI entry point

4. **Reference integration tests:**

- Read `tests/integration.rs` to understand expected behavior

- Use test cases as examples for new functionality

- Ensure changes don't break existing test expectations

5. **Code quality practices:**

- Follow Rust idioms and best practices

- Maintain clear error messages for parsing failures

- Keep parsing logic modular and testable

- Document complex date/time parsing rules

6. **Development workflow:**

- Make incremental changes to parsing logic

- Run tests frequently to catch regressions early

- Consider edge cases: timezones, ambiguous dates, invalid inputs

- Update integration tests when adding new parsing capabilities

Examples

**Adding a new date format:**

1. Modify `src/chrono_english/parser.rs` to recognize the new pattern

2. Update type definitions in `src/chrono_english/types.rs` if needed

3. Add error handling in `src/chrono_english/errors.rs` for invalid cases

4. Run `cargo test` to ensure existing functionality works

5. Add integration test case in `tests/integration.rs`

**Debugging parsing failures:**

1. Check error messages in `src/chrono_english/errors.rs`

2. Review parsing logic in `src/chrono_english/parser.rs`

3. Run specific test: `cargo test <test_name>`

4. Use integration tests as reference for expected behavior

Notes