feat: add comprehensive performance benchmarks with criterion (#21)

* feat: add comprehensive performance benchmarks with criterion

* docs: update READMEs with latest features and architecture

* fix: add #[non_exhaustive] to enums for semver compliance

Author: bug-ops

Cargo.lock

@@ -24,9 +24,12 @@ A universal Language Server Protocol (LSP) server for dependency management acro
 
 | Ecosystem | Manifest File | Status |
 |-----------|---------------|--------|
-| Rust/Cargo | `Cargo.toml` | Supported |
-| npm | `package.json` | Supported |
-| Python/PyPI | `pyproject.toml` | Planned |
+| Rust/Cargo | `Cargo.toml` | ✅ Supported |
+| npm | `package.json` | ✅ Supported |
+| Python/PyPI | `pyproject.toml` | ✅ Supported |
+
+> [!NOTE]
+> PyPI support includes PEP 621, PEP 735 (dependency-groups), and Poetry formats.
 
 ## Installation
 
@@ -155,15 +158,43 @@ cargo deny check
 ```
 deps-lsp/
 ├── crates/
-│   ├── deps-core/      # Shared types, cache, error handling
+│   ├── deps-core/      # Shared traits, cache, generic handlers
 │   ├── deps-cargo/     # Cargo.toml parser + crates.io registry
 │   ├── deps-npm/       # package.json parser + npm registry
+│   ├── deps-pypi/      # pyproject.toml parser + PyPI registry
 │   ├── deps-lsp/       # Main LSP server
 │   └── deps-zed/       # Zed extension (WASM)
 ├── .config/            # nextest configuration
 └── .github/            # CI/CD workflows
 ```
 
+### Architecture
+
+The codebase uses a trait-based architecture with the `EcosystemHandler` trait providing a unified interface for all package ecosystems:
+
+```rust
+// Each ecosystem implements EcosystemHandler
+impl EcosystemHandler for CargoHandler { ... }
+impl EcosystemHandler for NpmHandler { ... }
+impl EcosystemHandler for PyPiHandler { ... }
+
+// Generic LSP handlers work with any ecosystem
+generate_inlay_hints::<H: EcosystemHandler>(...);
+generate_hover_info::<H: EcosystemHandler>(...);
+generate_code_actions::<H: EcosystemHandler>(...);
+generate_diagnostics::<H: EcosystemHandler>(...);
+```
+
+### Benchmarks
+
+Run performance benchmarks with criterion:
+
+```bash
+cargo bench --workspace
+```
+
+View HTML report: `open target/criterion/report/index.html`
+
 ## License
 
 [MIT](LICENSE)

README.md

@@ -20,5 +20,10 @@ tracing = { workspace = true }
 urlencoding = { workspace = true }
 
 [dev-dependencies]
+criterion = { workspace = true, features = ["html_reports"] }
 insta = { workspace = true, features = ["json"] }
 tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }
+
+[[bench]]
+name = "cargo_benchmarks"
+harness = false

crates/deps-cargo/Cargo.toml

@@ -15,6 +15,7 @@ This crate provides parsing and registry integration for Rust's Cargo ecosystem.
 - **crates.io Registry** — Sparse index client for package metadata
 - **Version Resolution** — Semver-aware version matching
 - **Workspace Support** — Handle `workspace.dependencies` inheritance
+- **EcosystemHandler** — Implements `deps_core::EcosystemHandler` trait
 
 ## Usage
 
@@ -24,9 +25,21 @@ deps-cargo = "0.2"
 ```
 
 ```rust
-use deps_cargo::{CargoParser, CratesIoRegistry};
+use deps_cargo::{parse_cargo_toml, CratesIoRegistry};
+
+let dependencies = parse_cargo_toml(content)?;
+let registry = CratesIoRegistry::new(cache);
+let versions = registry.get_versions("serde").await?;
 ```
 
+## Benchmarks
+
+```bash
+cargo bench -p deps-cargo
+```
+
+Parsing performance: ~4μs for small files, ~55μs for large files (100+ dependencies).
+
 ## License
 
 [MIT](../../LICENSE)