feat: M1 robustness - extended options support

[h3n4l]

Summary

• Add UnsupportedOptionError for unsupported options in supported methods
• Add find()/findOne() projection (2nd arg) and options (3rd arg) support
• Add aggregate() options support (hint, maxTimeMS)
• Add countDocuments() maxTimeMS support and option validation
• Add estimatedDocumentCount() options support (maxTimeMS)
• Add distinct() options support (maxTimeMS)
• Add getCollectionInfos() options support (nameOnly, authorizedCollections)
• Add cursor hint(), max(), min() methods

Supported Options by Method

Method	Options
find()	projection (2nd arg), hint, max, min, maxTimeMS
findOne()	projection (2nd arg), hint, max, min, maxTimeMS
aggregate()	hint, maxTimeMS
countDocuments()	hint, limit, skip, maxTimeMS
estimatedDocumentCount()	maxTimeMS
distinct()	maxTimeMS
getCollectionInfos()	nameOnly, authorizedCollections

Cursor Modifier Methods

Method	Description
hint()	Specify index by name (string) or spec (document)
max()	Set upper bound for index scan
min()	Set lower bound for index scan

Test plan

• All new options tested with positive cases
• UnsupportedOptionError returned for unsupported options
• All existing tests still pass (59 tests)
• Linter passes (0 issues)

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This pull request extends M1 (Milestone 1) MongoDB operations with robust options support and improved error handling for unsupported features.

Changes:

• Introduces new error types (UnsupportedOptionError, PlannedOperationError) to distinguish between unsupported options and planned-but-unimplemented operations
• Extends find()/findOne() to support projection as 2nd argument and options (hint, max, min, maxTimeMS) as 3rd argument
• Adds options support to aggregate(), countDocuments(), estimatedDocumentCount(), distinct(), and getCollectionInfos() with proper validation
• Implements cursor modifier methods: hint(), max(), min()
• Simplifies method registry to only track planned (M2/M3) operations
• Updates dependency to newer parser version

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
errors.go	Adds UnsupportedOptionError and PlannedOperationError types; removes DeprecatedOperationError; simplifies error messages
translator.go	Extends mongoOperation struct with new option fields; refactors extraction functions to handle multiple arguments and validate options; adds cursor method extractors
method_registry.go	Simplified to only contain 32 planned M2/M3 methods; removes deprecated/unsupported tracking; changes registry lookup logic
executor.go	Applies new options to MongoDB driver calls; adds maxTimeMS handling
executor_test.go	Comprehensive tests for all new options and error cases; updates existing test expectations
go.mod/go.sum	Updates parser dependency version
docs/plans/*.md	Design and implementation documentation

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.