Bump to v1.0.0 and update docs and examples

Update Cargo.toml/Cargo.lock and CHANGELOG; refresh README and
ARCHITECTURE version references. Add runnable example instructions,
reorganize/bgpkit examples, convert a parsing example to print actual
results and add a missing import, and bump server_version in the server
README

Author: digizeph

ARCHITECTURE.md

@@ -332,13 +332,13 @@ Library users can select minimal features based on their needs:
 
 ```toml
 # Minimal database access
-monocle = { version = "0.10", default-features = false, features = ["database"] }
+monocle = { version = "1.0", default-features = false, features = ["database"] }
 
 # BGP operations without CLI overhead
-monocle = { version = "0.10", default-features = false, features = ["lens-bgpkit"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-bgpkit"] }
 
 # Full functionality without CLI
-monocle = { version = "0.10", default-features = false, features = ["lens-full"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-full"] }
 ```
 
 ## Related Documents

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## Unreleased
+## v1.0.0 - 2025-12-18
 
 This is a major release with significant architectural changes, new commands, and breaking changes.
 
@@ -158,13 +158,13 @@ Library users can now use monocle with minimal dependencies:
 Usage examples:
 ```toml
 # Minimal database access
-monocle = { version = "0.10", default-features = false, features = ["database"] }
+monocle = { version = "1.0", default-features = false, features = ["database"] }
 
 # BGP operations without CLI overhead
-monocle = { version = "0.10", default-features = false, features = ["lens-bgpkit"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-bgpkit"] }
 
 # Full functionality
-monocle = { version = "0.10", default-features = false, features = ["lens-full"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-full"] }
 ```
 
 ### Improvements

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "monocle"
-version = "0.9.1"
+version = "1.0.0"
 authors = ["Mingwei Zhang <mingwei@bgpkit.com>"]
 edition = "2021"
 readme = "README.md"
@@ -20,7 +20,7 @@ required-features = ["cli"]
 # Existing examples (require lens-bgpkit)
 [[example]]
 name = "search_bgp_messages"
-path = "examples/search_bgp_messages.rs"
+path = "examples/bgpkit/search_bgp_messages.rs"
 required-features = ["lens-bgpkit"]
 
 [[example]]
@@ -70,11 +70,6 @@ name = "mrt_parsing"
 path = "examples/bgpkit/mrt_parsing.rs"
 required-features = ["lens-bgpkit"]
 
-[[example]]
-name = "bgp_search"
-path = "examples/bgpkit/bgp_search.rs"
-required-features = ["lens-bgpkit"]
-
 # Full examples - all features
 [[example]]
 name = "inspect_unified"
@@ -221,6 +216,7 @@ async-trait = { version = "0.1", optional = true }
 tower-http = { version = "0.5", features = ["cors", "trace"], optional = true }
 
 [dev-dependencies]
+bgpkit-parser = { version = "0.13.0", features = ["serde"] }
 tempfile = "3"
 futures-util = "0.3"
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Cargo.toml

@@ -67,16 +67,16 @@ 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)
-monocle = "0.10"
+monocle = "1.0"
 
 # Minimal database access only
-monocle = { version = "0.10", default-features = false, features = ["database"] }
+monocle = { version = "1.0", default-features = false, features = ["database"] }
 
 # BGP operations without CLI overhead
-monocle = { version = "0.10", default-features = false, features = ["lens-bgpkit"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-bgpkit"] }
 
 # Full functionality without CLI
-monocle = { version = "0.10", default-features = false, features = ["lens-full"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-full"] }
 ```
 
 ### Feature Tiers

README.md

@@ -4,6 +4,33 @@ This directory contains examples demonstrating how to use monocle as a library.
 Examples are organized by the features they require, helping you understand
 the minimum dependencies needed for different use cases.
 
+## Running All Examples
+
+You can run these examples using `cargo run --example <name>`.
+
+```bash
+# Standalone utilities
+cargo run --release --example time_parsing --features lens-core
+cargo run --release --example output_formats --features lens-core
+
+# Database operations
+cargo run --release --example database_basics --features database
+cargo run --release --example as2rel_queries --features database
+
+# BGP operations
+cargo run --release --example country_lookup --features lens-bgpkit
+cargo run --release --example rpki_validation --features lens-bgpkit
+cargo run --release --example mrt_parsing --features lens-bgpkit
+cargo run --release --example search_bgp_messages --features lens-bgpkit
+
+# Full functionality
+cargo run --release --example inspect_unified --features lens-full
+cargo run --release --example progress_callbacks --features lens-full
+
+# WebSocket Client (requires running server)
+# cargo run --example ws_client_all --features cli
+```
+
 ## Feature Tiers
 
 Monocle uses a layered feature system:
@@ -23,14 +50,6 @@ Monocle uses a layered feature system:
 
 Minimal dependencies - no bgpkit-* crates required.
 
-```bash
-# Time parsing and formatting
-cargo run --example time_parsing --features lens-core
-
-# Output format utilities
-cargo run --example output_formats --features lens-core
-```
-
 **Files:**
 - `standalone/time_parsing.rs` - Parse timestamps, convert formats
 - `standalone/output_formats.rs` - Work with OutputFormat enum
@@ -39,14 +58,6 @@ cargo run --example output_formats --features lens-core
 
 SQLite operations without lens overhead.
 
-```bash
-# Basic database operations
-cargo run --example database_basics --features database
-
-# AS2Rel relationship queries
-cargo run --example as2rel_queries --features database
-```
-
 **Files:**
 - `database/database_basics.rs` - MonocleDatabase, schema management
 - `database/as2rel_queries.rs` - Query AS-level relationships
@@ -55,49 +66,34 @@ cargo run --example as2rel_queries --features database
 
 Full BGP functionality with bgpkit-* integration.
 
-```bash
-# Country code lookup
-cargo run --example country_lookup --features lens-bgpkit
-
-# RPKI validation
-cargo run --example rpki_validation --features lens-bgpkit
-
-# MRT file parsing
-cargo run --example mrt_parsing --features lens-bgpkit
-
-# BGP message search
-cargo run --example bgp_search --features lens-bgpkit
-```
-
 **Files:**
 - `bgpkit/country_lookup.rs` - Country code/name lookup
 - `bgpkit/rpki_validation.rs` - RPKI ROA validation
 - `bgpkit/mrt_parsing.rs` - Parse MRT files with filters
-- `bgpkit/bgp_search.rs` - Search BGP messages across files
+- `bgpkit/search_bgp_messages.rs` - Search BGP announcement messages (Real-world example)
 
 ### Full Examples (`lens-full`)
 
 All lenses including unified inspection.
 
-```bash
-# Unified AS/prefix inspection
-cargo run --example inspect_unified --features lens-full
-
-# Progress callback patterns
-cargo run --example progress_callbacks --features lens-full
-```
-
 **Files:**
 - `full/inspect_unified.rs` - InspectLens for unified lookups
 - `full/progress_callbacks.rs` - Progress tracking for GUI/CLI
 
+### CLI/Server Examples (`cli`)
+
+Examples requiring the full CLI/Server feature set.
+
+**Files:**
+- `ws_client_all.rs` - WebSocket client demonstrating all API methods
+
 ## Using in Your Project
 
 ### Minimal Database Access
 
 ```toml
 [dependencies]
-monocle = { version = "0.9", default-features = false, features = ["database"] }
+monocle = { version = "1.0", default-features = false, features = ["database"] }
 ```
 
 ```rust
@@ -114,7 +110,7 @@ let rels = db.as2rel().search_asn(13335)?;
 
 ```toml
 [dependencies]
-monocle = { version = "0.9", default-features = false, features = ["lens-core"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-core"] }
 ```
 
 ```rust
@@ -129,7 +125,7 @@ let results = lens.parse(&args)?;
 
 ```toml
 [dependencies]
-monocle = { version = "0.9", default-features = false, features = ["lens-bgpkit"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-bgpkit"] }
 ```
 
 ```rust
@@ -151,7 +147,7 @@ println!("{}: {}", result.state, result.reason);
 
 ```toml
 [dependencies]
-monocle = { version = "0.9", default-features = false, features = ["lens-full"] }
+monocle = { version = "1.0", default-features = false, features = ["lens-full"] }
 ```
 
 ```rust
@@ -168,20 +164,9 @@ let results = lens.query(&["13335".to_string()], &options)?;
 let json = lens.format_json(&results, true);
 ```
 
-## Running All Examples
-
-```bash
-# Run all examples with full features
-cargo run --example time_parsing --features cli
-cargo run --example database_basics --features cli
-cargo run --example country_lookup --features cli
-cargo run --example rpki_validation --features cli
-cargo run --example inspect_unified --features cli
-```
-
 ## Notes
 
 - Examples with network operations (RPKI, search) require internet access
 - First run may take time to download/bootstrap data
 - Use `--release` for better performance with large datasets
-- Database operations use WAL mode for concurrent access
+- Database operations use WAL mode for concurrent access