docs: update documentation for simplified feature flags (lib/server/cli)

Author: digizeph

AGENTS.md

@@ -112,13 +112,13 @@ src/
 │   └── monocle/        # Main repositories (asinfo, as2rel, rpki, pfx2as)
 ├── lens/               # Business logic layer
 │   ├── utils.rs        # OutputFormat, shared utilities
-│   ├── time/           # Time parsing (lens-core)
-│   ├── country.rs      # Country lookup (lens-bgpkit)
-│   ├── parse/          # MRT parsing (lens-bgpkit)
-│   ├── search/         # BGP search (lens-bgpkit)
-│   ├── rpki/           # RPKI validation (lens-bgpkit)
-│   └── inspect/        # Unified inspection (lens-full)
-├── server/             # WebSocket server (cli feature)
+│   ├── time/           # Time parsing
+│   ├── country.rs      # Country lookup
+│   ├── parse/          # MRT parsing
+│   ├── search/         # BGP search
+│   ├── rpki/           # RPKI validation
+│   └── inspect/        # Unified inspection
+├── server/             # WebSocket server (requires `server` feature)
 │   └── handlers/       # Method handlers
 └── bin/
     ├── monocle.rs      # CLI entry point

ARCHITECTURE.md

@@ -88,38 +88,38 @@ src/
 │   ├── mod.rs
 │   ├── README.md
 │   ├── utils.rs              # OutputFormat, formatting helpers
-│   ├── country.rs            # Country code/name lookup (lens-bgpkit)
+│   ├── country.rs            # Country code/name lookup
 │   │
-│   ├── as2rel/               # AS relationship lens (lens-bgpkit)
+│   ├── as2rel/               # AS relationship lens
 │   │   ├── mod.rs
 │   │   ├── args.rs
 │   │   └── types.rs
 │   │
-│   ├── inspect/              # Unified AS/prefix inspection (lens-full)
+│   ├── inspect/              # Unified AS/prefix inspection
 │   │   ├── mod.rs            # InspectLens implementation
 │   │   └── types.rs          # Result types, section selection
 │   │
-│   ├── ip/                   # IP information lookup (lens-bgpkit)
+│   ├── ip/                   # IP information lookup
 │   │   └── mod.rs
 │   │
-│   ├── parse/                # MRT file parsing (lens-bgpkit)
+│   ├── parse/                # MRT file parsing
 │   │   └── mod.rs
 │   │
-│   ├── pfx2as/               # Prefix-to-ASN mapping types (lens-bgpkit)
+│   ├── pfx2as/               # Prefix-to-ASN mapping types
 │   │   └── mod.rs            # Types only; repository handles lookups
 │   │
-│   ├── rpki/                 # RPKI validation and data (lens-bgpkit)
+│   ├── rpki/                 # RPKI validation and data
 │   │   ├── mod.rs            # RpkiLens with validation logic
 │   │   └── commons.rs        # bgpkit-commons integration
 │   │
-│   ├── search/               # BGP message search (lens-bgpkit)
+│   ├── search/               # BGP message search
 │   │   ├── mod.rs
 │   │   └── query_builder.rs
 │   │
-│   └── time/                 # Time parsing and formatting (lens-core)
+│   └── time/                 # Time parsing and formatting
 │       └── mod.rs
 │
-├── server/                   # WebSocket server (cli feature)
+├── server/                   # WebSocket server (requires `server` feature)
 │   ├── mod.rs                # Server startup, handle_socket
 │   ├── protocol.rs           # Core protocol types (RequestEnvelope, ResponseEnvelope)
 │   ├── router.rs             # Router + Dispatcher

DEVELOPMENT.md

@@ -17,29 +17,29 @@ src/
 ├── lib.rs                    # Public API exports
 ├── config.rs                 # Configuration management
 │
-├── lens/                     # Business logic layer (feature-gated)
+├── lens/                     # Business logic layer (requires `lib` feature)
 │   ├── mod.rs                # Lens module exports
 │   ├── utils.rs              # Shared utilities (OutputFormat, truncate_name)
-│   ├── time/                 # Time parsing lens (lens-core)
+│   ├── time/                 # Time parsing lens
 │   │   └── mod.rs
-│   ├── country.rs            # Country lookup (lens-bgpkit)
-│   ├── ip/                   # IP information lookup (lens-bgpkit)
+│   ├── country.rs            # Country lookup
+│   ├── ip/                   # IP information lookup
 │   │   └── mod.rs
-│   ├── parse/                # MRT file parsing with progress (lens-bgpkit)
+│   ├── parse/                # MRT file parsing with progress
 │   │   └── mod.rs
-│   ├── search/               # BGP message search with progress (lens-bgpkit)
+│   ├── search/               # BGP message search with progress
 │   │   ├── mod.rs
 │   │   └── query_builder.rs
-│   ├── rpki/                 # RPKI validation (lens-bgpkit)
+│   ├── rpki/                 # RPKI validation
 │   │   ├── mod.rs
 │   │   └── commons.rs
-│   ├── pfx2as/               # Prefix-to-ASN types (lens-bgpkit)
+│   ├── pfx2as/               # Prefix-to-ASN types
 │   │   └── mod.rs
-│   ├── as2rel/               # AS-level relationship lens (lens-bgpkit)
+│   ├── as2rel/               # AS-level relationship lens
 │   │   ├── mod.rs
 │   │   ├── args.rs
 │   │   └── types.rs
-│   └── inspect/              # Unified AS/prefix inspection (lens-full)
+│   └── inspect/              # Unified AS/prefix inspection
 │       ├── mod.rs            # InspectLens implementation
 │       └── types.rs          # Result types, section selection
 │
@@ -52,7 +52,7 @@ src/
 │       ├── rpki.rs           # RPKI ROA/ASPA (blob-based prefix storage)
 │       └── pfx2as.rs         # Prefix-to-ASN (blob-based prefix storage)
 │
-├── server/                   # WebSocket server (cli feature)
+├── server/                   # WebSocket server (requires `server` feature)
 │   ├── mod.rs                # Server startup, handle_socket
 │   ├── protocol.rs           # Core protocol types
 │   ├── router.rs             # Router + Dispatcher
@@ -498,18 +498,15 @@ pub struct MyArgs { ... }
 #[cfg_attr(feature = "display", derive(tabled::Tabled))]
 pub struct MyResult { ... }
 
-// Lens-specific features
-#[cfg(feature = "lens-bgpkit")]
+// Lens module (requires `lib` feature)
+#[cfg(feature = "lib")]
 pub mod my_lens;
 ```
 
-Feature tiers:
-- `database`: SQLite operations only
-- `lens-core`: Standalone lenses (TimeLens)
-- `lens-bgpkit`: BGP-related lenses
-- `lens-full`: All lenses including InspectLens
-- `display`: Table formatting with tabled
-- `cli`: Full CLI binary with server support
+Feature tiers (simplified):
+- `lib`: Complete library (database + all lenses + display)
+- `server`: WebSocket server (implies lib)
+- `cli`: Full CLI binary (implies lib and server)
 
 ### Output Formatting
 

README.md

@@ -16,6 +16,7 @@ See through all Border Gateway Protocol (BGP) data with a monocle.
   - [Using `homebrew` on macOS](#using-homebrew-on-macos)
   - [Using `cargo-binstall`](#using-cargo-binstall)
 - [Library Usage](#library-usage)
+- [Documentation](#documentation)
 - [Usage](#usage)
   - [`monocle parse`](#monocle-parse)
     - [Output Format](#output-format)
@@ -98,52 +99,63 @@ Monocle can also be used as a library in your Rust projects. Add it to your `Car
 
 ```toml
 [dependencies]
-# Full library with CLI argument support (default)
+# Default: full CLI binary with all features
 monocle = "1.0"
 
-# Minimal database access only
-monocle = { version = "1.0", default-features = false, features = ["database"] }
+# Library only - all lenses and database operations
+monocle = { version = "1.0", default-features = false, features = ["lib"] }
 
-# BGP operations without CLI overhead
-monocle = { version = "1.0", default-features = false, features = ["lens-bgpkit"] }
-
-# Full functionality without CLI
-monocle = { version = "1.0", default-features = false, features = ["lens-full"] }
+# Library + WebSocket server
+monocle = { version = "1.0", default-features = false, features = ["server"] }
 ```
 
 ### Feature Tiers
 
-Monocle's features are organized in tiers for minimal dependency footprint:
+Monocle uses a simplified feature system with three options:
+
+| Feature | Description | Implies |
+|---------|-------------|---------|
+| `lib` | Complete library (database + all lenses + display) | - |
+| `server` | WebSocket server for programmatic API access | `lib` |
+| `cli` (default) | Full CLI binary with all functionality | `lib`, `server` |
+
+### Documentation
+
+The following documentation files are available in the repository:
 
-| Feature | Description | Key Dependencies |
-|---------|-------------|------------------|
-| `database` | SQLite operations only | rusqlite, oneio, ipnet, chrono |
-| `lens-core` | Standalone lenses (TimeLens) | chrono-humanize, dateparser |
-| `lens-bgpkit` | BGP-related lenses | bgpkit-*, rayon, tabled |
-| `lens-full` | All lenses including InspectLens | All above |
-| `cli` (default) | Full CLI binary with server | axum, tokio, tower-http |
+| File | Description |
+|------|-------------|
+| [`README.md`](README.md) (this file) | User-facing CLI and library overview |
+| [`ARCHITECTURE.md`](ARCHITECTURE.md) | Overall project structure and design principles |
+| [`DEVELOPMENT.md`](DEVELOPMENT.md) | Contributor guide for adding lenses and fixing bugs |
+| [`AGENTS.md`](AGENTS.md) | AI coding agent guidelines and code style |
+| [`CHANGELOG.md`](CHANGELOG.md) | Version history and breaking changes |
+| [`src/server/README.md`](src/server/README.md) | WebSocket API specification |
+| [`src/lens/README.md`](src/lens/README.md) | Lens module patterns and conventions |
+| [`src/database/README.md`](src/database/README.md) | Database module overview |
+| [`examples/README.md`](examples/README.md) | Usage examples by feature tier |
 
 ### Architecture
 
 The library is organized into the following core modules:
 
-- **`database`**: All database functionality
+- **`database`**: All database functionality (requires `lib` feature)
   - `core`: Connection management and schema definitions
   - `session`: One-time storage for search results
   - `monocle`: Main monocle database with ASInfo, AS2Rel, RPKI, and Pfx2as caching
 
-- **`lens`**: High-level business logic (reusable across CLI, API, GUI)
-  - `time`: Time parsing and formatting lens (lens-core)
-  - `country`: Country code/name lookup lens (lens-bgpkit)
-  - `ip`: IP information lookup lens (lens-bgpkit)
-  - `parse`: MRT file parsing lens with progress tracking (lens-bgpkit)
-  - `search`: BGP message search lens with progress tracking (lens-bgpkit)
-  - `rpki`: RPKI validation and data lens (lens-bgpkit)
-  - `pfx2as`: Prefix-to-AS mapping types (lens-bgpkit)
-  - `as2rel`: AS-level relationships lens (lens-bgpkit)
-  - `inspect`: Unified AS/prefix inspection lens (lens-full)
-
-- **`server`**: WebSocket API server (cli feature)
+- **`lens`**: High-level business logic (requires `lib` feature)
+  - `time`: Time parsing and formatting lens
+  - `country`: Country code/name lookup lens
+  - `ip`: IP information lookup lens
+  - `parse`: MRT file parsing lens with progress tracking
+  - `search`: BGP message search lens with progress tracking
+  - `rpki`: RPKI validation and data lens
+  - `pfx2as`: Prefix-to-AS mapping types
+  - `as2rel`: AS-level relationships lens
+  - `inspect`: Unified AS/prefix inspection lens
+
+- **`server`**: WebSocket API server (requires `server` feature)
 
 For detailed architecture documentation, see [`ARCHITECTURE.md`](ARCHITECTURE.md).
 

src/server/README.md

@@ -263,17 +263,17 @@ Returns a minimal method catalog for discoverability (names + short schemas). Ke
 
 | Namespace | Description | Feature |
 |-----------|-------------|---------|
-| `system.*` | Server introspection | cli |
-| `time.*` | Time parsing utilities | lens-core |
-| `ip.*` | IP information lookup | lens-bgpkit |
-| `rpki.*` | RPKI validation and data | lens-bgpkit |
-| `as2rel.*` | AS-level relationships | lens-bgpkit |
-| `pfx2as.*` | Prefix-to-ASN mapping | lens-bgpkit |
-| `country.*` | Country code/name lookup | lens-bgpkit |
-| `inspect.*` | Unified AS/prefix inspection | lens-full |
-| `parse.*` | MRT file parsing (streaming) | lens-bgpkit |
-| `search.*` | BGP message search (streaming) | lens-bgpkit |
-| `database.*` | Database management | database |
+| `system.*` | Server introspection | server |
+| `time.*` | Time parsing utilities | lib |
+| `ip.*` | IP information lookup | lib |
+| `rpki.*` | RPKI validation and data | lib |
+| `as2rel.*` | AS-level relationships | lib |
+| `pfx2as.*` | Prefix-to-ASN mapping | lib |
+| `country.*` | Country code/name lookup | lib |
+| `inspect.*` | Unified AS/prefix inspection | lib |
+| `parse.*` | MRT file parsing (streaming) | lib |
+| `search.*` | BGP message search (streaming) | lib |
+| `database.*` | Database management | lib |
 
 Methods are organized into namespaces matching the lens modules: