v1.4.0

New Features

• Added HTTP/SSE server replacing the previous WebSocket service. The server
  subcommand now starts an HTTP server with REST endpoints and SSE search
  streaming. Key additions:
  • Three MVP endpoints: GET /health, GET /api/v1/system/info,
    POST /api/v1/search/stream (SSE streaming search with progress, element
    batches, cancellation on disconnect, and max-results limit)
  • Parallelized SSE search with bounded mpsc channel (capacity 32)
    backpressure; element batches are never dropped, progress events may be
    coalesced
  • Terminal event invariant: exactly one of completed, cancelled, or
    error. All three carry a SearchStreamResult payload with matched
    elements, source-file counts, compressed-byte metadata, rate, and matching
    collectors/files
  • Server admission control (server_max_concurrent_searches, default 3);
    excess requests return HTTP 429. SSE search returns 400 on invalid
    peer_ip values
  • Phase 2 REST API: stateless endpoints (/time/parse, /country/lookup,
    /ip/lookup, GET /ip/public), DB read-only endpoints
    (/database/status, /rpki/roa/lookup, /rpki/aspa/lookup,
    /pfx2as/lookup, /as2rel/relationship, POST /as2rel/search),
    DB refresh endpoints (/database/refresh, /inspect/refresh,
    /as2rel/refresh), and composite endpoints (/rpki/roa/validate,
    /inspect/query). ASPA validation is deferred. DB-backed endpoints
    return NOT_INITIALIZED (HTTP 503) if required data is missing
  • Token-based auth middleware (server_auth_enabled / server_auth_token);
    when enabled, /api/v1/* requires Authorization: Bearer <token>
    (case-insensitive per RFC 7235); /health stays open. Server refuses to
    start if auth is enabled but token is empty
  • CLI remote search mode: --remote-url flag sends queries to a remote
    Monocle HTTP service; --remote-token provides Bearer auth. Consumes SSE
    stream and formats results with existing CLI formatters. Remote search
    exits with non-zero status on error/cancelled SSE events or connection
    drop without completed. Applies --filter-file/--prefix-file merging
    and filter validation before dispatch
  • Docker Compose deployment with health check, persistent volumes, and
    env-based configuration. Docker runtime runs as non-root monocle user
    with pre-created config directory and HOME set
  • Server configuration via monocle.toml and MONOCLE_* environment
    variables: server_address, server_port, server_max_search_batch_size,
    server_max_search_results, server_search_timeout_secs,
    server_max_concurrent_searches, search_concurrency
• Added Cisco sh ip bgp text dump parsing to the parse command. The parser
  auto-detects the fixed-width plaintext format from the preamble, extracts
  prefix/AS-path/next-hop/metric/local-pref/origin, and supports all standard
  parse filters, output formats, and MRT export (--mrt-type rib|updates).
  Multi-path continuation lines and wrapped-prefix layouts are handled.
  Header column detection uses whitespace split rather than fixed positions.
• Added --filter-file (JSON) and --prefix-file (newline text) flags to
  monocle parse and monocle search for loading large filter sets from
  files. File filters merge with CLI flags — union within each dimension (OR),
  AND across dimensions. Supports the RIB-extract → filter-updates workflow at
  scale (#117).
• Added RPKISPOOL as the default historical RPKI source with Sobornost as the
  default mirror. The rpki roas and rpki aspas commands retain ripe and
  rpkiviews; invalid source/collector combinations now return errors (#134).
• Added --use-cache / --cache-dir MRT-file caching and --fields output
  selection to the rib command (#137).
• Added --concurrency to local search and server commands. Explicit values
  use local rayon thread pools; unset/0 keeps rayon defaults including
  RAYON_NUM_THREADS.

Breaking Changes

• Replaced WebSocket server with HTTP/SSE service. All WebSocket modules
  (protocol, handler, sink, op_sink, router, operations,
  handlers/*) have been removed.
• Updated axum to 0.8 and tower-http to 0.6.
• Removed uuid and async-trait dependencies (no longer needed without
  WebSocket operation tracking).
• Updated ServerArgs CLI flags: removed --data-dir, --max-concurrent-ops,
  --max-message-size, --connection-timeout-secs, --ping-interval-secs;
  added --max-search-batch-size, --max-search-results,
  --search-timeout-secs. --address and --port are now optional (default
  to config values).

Performance Improvements

• Optimized database refresh (bulk insert) performance by 21–49% across all
  repositories. Indexes are now dropped before bulk insert and rebuilt in one
  pass afterward, instead of being updated per-row.
• Removed redundant idx_pfx2as_prefix_str and low-value
  idx_pfx2as_validation indexes. lookup_exact rewritten to use the
  existing BLOB range index (prefix_start/prefix_end/prefix_length).
• Fixed PRAGMA restore bug: store() methods no longer toggle
  synchronous/journal_mode PRAGMAs, preserving the connection's
  WAL/NORMAL defaults. Previously, every refresh left the connection
  in DELETE/FULL mode, degrading query performance until restart.
• Switched INSERT OR REPLACE to plain INSERT in all refresh paths
  (tables are cleared before insert, so no conflicts are possible).
• Added db_refresh_bench example for measuring refresh performance
  with real or synthetic data.
• Added tracing::info! progress logging to the rib command (visible with
  --debug): RIB download/parse reports message counts, and update replay
  shows per-file progress.

Bug Fixes

• Fixed search --dump-type rib applying the requested snapshot time window to
  per-route timestamps inside matching RIB dumps. Stable routes learned before
  the dump timestamp are now retained, restoring AS-path search results (#136,
  #138).
• Fixed rib command dropping RIB entries whose per-route timestamp predates
  the RIB dump time. The base RIB parser was incorrectly applying a start_ts
  filter at the dump timestamp, silently excluding stable routes learned days
  or weeks earlier (#124).
• Fixed rib command using an earlier RIB than necessary when the target
  timestamp coincides with a RIB dump time. The broker query's ts_end filter
  is exclusive, so a RIB starting exactly at the target was excluded, forcing
  the code to select the previous RIB and replay unnecessary update files.
  This caused ~3× slowdown for common midnight RIB queries.
• Fixed --time-format rfc3339 being ignored for json, json-line, and
  json-pretty output formats. JSON output now honors --time-format: unix
  (default) emits a numeric timestamp field (backward compatible); rfc3339
  emits an RFC 3339 string (#123).
• Validated prefix input in pfx2as_lookup and roa_lookup REST endpoints
  before spawning blocking tasks, so invalid prefixes return 400 instead of
  500.
• Auth middleware now accepts case-insensitive Bearer scheme tokens per
  RFC 7235.
• POST /api/v1/database/refresh with source=pfx2as now returns HTTP 501
  instead of 200, so automation can detect the operation is not implemented.
• GET /api/v1/rpki/roa/lookup now applies AND semantics when both prefix
  and asn are provided (filters covering ROAs by origin ASN).

Build & Infrastructure

• Replaced QEMU-emulated multi-platform Docker build with native per-platform
  builds: linux/amd64 on ubuntu-latest, linux/arm64 on ubuntu-24.04-arm
  native runners. Each build pushes by digest; a final manifest-merge job
  assembles the multi-architecture OCI image index. Expected to reduce CI build
  time from ~57 minutes to roughly the slower platform's native compile time.
• Added cargo-chef to the Dockerfile for dependency-layer caching. Source-only
  changes now reuse the pre-compiled dependency layer instead of recompiling all
  dependencies from scratch.
• Switched Docker BuildKit cache from GitHub Actions cache to registry-based
  cache (bgpkit/monocle:buildcache-{arch}), removing the 10 GB GHA cache
  budget constraint.

Code Improvements

• Added HistoricalRpkiCollectorOption as the preferred general-purpose alias
  while retaining RpkiViewsCollectorOption compatibility, and clarified
  historical source/collector CLI errors.
• Removed redundant formatting references in parse command output to satisfy
  current Clippy checks.
• Made refresh index rebuilds atomic by wrapping index drops, table clears,
  inserts, and index recreation in one transaction; indexes are dropped before
  clearing tables to avoid unnecessary per-row index maintenance during
  refresh.
• Ensured upgraded pfx2as databases drop removed legacy indexes during
  refresh and kept the benchmark example buildable with
  --no-default-features --features lib.
• Preserved immediate transaction semantics for pfx2as refreshes and reused
  shared AS2Rel schema constants when rebuilding indexes.

Dependencies

• Updated bgpkit-parser to v0.18.0.
  • Default parse JSON output and SSE search element batches now include
    peer_bgp_id for TableDumpV2 RIB entries when the peer's BGP Identifier is
    available.
  • Known-but-unsupported BGP attributes are retained in the existing
    unknown/deprecated fields rather than silently dropped, and malformed
    BGP input is validated more strictly.

v1.3.0

New Features

• Added monocle rib for reconstructing RIB state at arbitrary timestamps
  • Selects the latest RIB before each requested rib_ts and replays updates to the exact timestamp
  • Supports stdout output by default and SQLite output via --sqlite-path
  • Repeated timestamp operands require --sqlite-path and are written to one merged SQLite file keyed by rib_ts
  • Aborts when no RIB exists at or before a requested rib_ts for a selected collector
  • Supports --country, --origin-asn, --prefix, --as-path, --peer-asn, --collector, --project, and --full-feed-only

Performance Improvements

• Reduced string allocations in RIB reconstruction by using Arc<str> for collector and prefix fields
• Removed unnecessary per-snapshot sorting that was O(n log n) on all entries
• Reduced updates query window from +2 hours lookahead to exact target timestamp
  • Results in 33% fewer update files downloaded for typical requests

Code Improvements

• Added StoredRibUpdate struct to track filtered BGP updates during reconstruction
• Added a session-backed SQLite store for merged reconstructed RIB export
• Updated monocle rib reconstruction to keep the working RIB state in memory
  • Removes SQLite lookups and writes from the replay hot path
  • Keeps path_id only for internal route identity during add-path reconstruction
  • Narrows reconstructed RIB entries and SQLite export rows to collector, timestamp, peer_ip, peer_asn, prefix, as_path, and origin_asns

Bug Fixes

• Fixed compilation failure when installing from crates.io
  • Updated RPKI lens to handle bgpkit-commons v0.10.3 API changes
  • Added match arm for new HistoricalRpkiSource::RpkiSpools variant
  • Corrected RpkiViewsCollector variant name from SoborostNet to SobornostNet

v1.2.0

New Features

• Added BGP community filtering support to monocle parse and monocle search
  • New CLI option: -C, --community (with --communities alias)
  • Supports repeated flags and comma-separated values
  • Supports standard communities (A:B) and large communities (A:B:C)
  • Supports wildcard matching per position with * (for example *:100, 1299:*, 57866:*:*)
  • Uses strict positional matching with exact colon-count semantics
    • A:B patterns match only standard communities
    • A:B:C patterns match only large communities
    • Example: 1299:* does not match 1403:1299
• Added CLI compatibility aliases for time filters in monocle parse and monocle search
  • --ts-start is now accepted as an alias for --start-ts
  • --ts-end is now accepted as an alias for --end-ts

Bug Fixes

• Fixed panic when truncating names containing non-ASCII UTF-8 characters
  • Used character-based truncation instead of byte-based slicing
  • Affects RPKI ASPA display and inspect lens name truncation

Directory Changes

• Changed config, data, and cache paths to follow XDG base directory specification
  • Config file default is now $XDG_CONFIG_HOME/monocle/monocle.toml (fallback: ~/.config/monocle/monocle.toml)
  • Data directory default is now $XDG_DATA_HOME/monocle (fallback: ~/.local/share/monocle)
  • Cache directory default is now $XDG_CACHE_HOME/monocle (fallback: ~/.cache/monocle)
  • Existing SQLite data under ~/.monocle is no longer used by default and will be rebuilt in the new data location
    • Legacy config migration: when the new config directory is empty, monocle copies ~/.monocle/monocle.toml to the new config path
    • Old database file will not be copied over. Once the updated monocle has been executed at least once, old ~/.monocle can be safely deleted
• Added --use-cache flag to monocle search to use the default XDG cache path ($XDG_CACHE_HOME/monocle)
  • Value set by --cache-dir overrides --use-cache when both are provided

Code Improvements

• Updated README command help examples to match current CLI help output from the release binary
• Moved utils module from lens::utils to crate-level utils
  • Eliminates misleading module structure since utilities are used throughout the codebase
  • Updated all imports from crate::lens::utils and monocle::lens::utils to crate::utils and monocle::utils

Dependencies

• Switched directory resolution library from dirs to etcetera

v1.1.0

New Features

• RTR protocol support: Added support for fetching ROAs via RTR (RPKI-to-Router) protocol

  • Configure RTR endpoint in ~/.monocle/monocle.toml:

    rpki_rtr_host = "rtr.rpki.cloudflare.com"
    rpki_rtr_port = 8282
    rpki_rtr_timeout_secs = 10
    rpki_rtr_no_fallback = false

  • Or use environment variables: MONOCLE_RPKI_RTR_HOST, MONOCLE_RPKI_RTR_PORT, MONOCLE_RPKI_RTR_TIMEOUT_SECS, MONOCLE_RPKI_RTR_NO_FALLBACK
  • Or use CLI flag for one-time override: monocle config update --rpki --rtr-endpoint rtr.rpki.cloudflare.com:8282
  • ROAs are fetched via RTR, ASPAs always from Cloudflare (RTR v1 per RFC 8210 doesn't support ASPA)
  • Automatic fallback to Cloudflare if RTR connection fails, with warning message (set rpki_rtr_no_fallback = true to disable fallback and error out instead)
  • Connection timeout defaults to 10 seconds
  • Supports RTR protocol version negotiation (v1 with v0 fallback)

• --cache-dir: Added local caching support to the search command

  • Download MRT files to a local directory before parsing
  • Files are cached as {cache-dir}/{collector}/{path} (e.g., cache/rrc00/2024.01/updates.20240101.0000.gz)
  • Cached files are reused on subsequent runs, avoiding redundant downloads
  • Uses .partial extension during downloads to handle interrupted transfers
  • Cache directory access is validated upfront before processing begins
  • Broker query caching: When --cache-dir is specified, broker API query results are cached in SQLite
    • Cache stored at {cache-dir}/broker-cache.sqlite3
    • Only queries with end time >2 hours in the past are cached (recent data may still change)
    • Subsequent identical queries use cached results, enabling offline operation
    • Tested: run search once, disable network, run same search again - results returned from cache
  • Example: monocle search -t 2024-01-01 -d 1h --cache-dir /tmp/mrt-cache

• Multi-value filters: parse and search commands now support filtering by multiple values with OR logic

  • Example: -o 13335,15169,8075 matches elements from ANY of the specified origin ASNs
  • Example: -p 1.1.1.0/24,8.8.8.0/24 matches ANY of the specified prefixes
  • Example: -J 174,2914 matches elements from ANY of the specified peer ASNs

• Negative filters: Support for exclusion filters using ! prefix

  • Example: -o '!13335' excludes elements from AS13335
  • Example: -o '!13335,!15169' excludes elements from AS13335 AND AS15169
  • Note: Cannot mix positive and negative values in the same filter

• Added validation for ASN format, prefix CIDR notation, and negation consistency

• --time-format: Added timestamp output format option to parse and search commands

  • --time-format unix (default): Output timestamps as Unix epoch (integer/float)
  • --time-format rfc3339: Output timestamps in ISO 8601/RFC3339 format (e.g., 2023-10-11T17:00:00+00:00)
  • Applies to non-JSON output formats (table, psv, markdown)
  • JSON output always uses numeric Unix timestamps for backward compatibility
  • Example: monocle parse file.mrt --time-format rfc3339
  • Example: monocle search -t 2024-01-01 -d 1h -p 1.1.1.0/24 --time-format rfc3339

• Added --fields (-f) option to parse and search commands for selecting output fields (#99, #101)

  • Choose which columns to display with comma-separated field names
  • Available fields: type, timestamp, peer_ip, peer_asn, prefix, as_path, origin, next_hop, local_pref, med, communities, atomic, aggr_asn, aggr_ip, collector
  • Parse command defaults exclude collector field (not applicable)
  • Search command defaults include collector field
  • Example: monocle search -t 2024-01-01 -d 1h -f prefix,as_path,collector

• Added proper table formatting with borders using tabled crate for --format table (#99, #101)

  • Table output now uses rounded borders instead of tab-separated values
  • Markdown format includes proper header row with separator

• Added --order-by and --order parameters to parse and search commands (#98)

  • Sort output by: timestamp, prefix, peer_ip, peer_asn, as_path, or next_hop
  • Direction: asc (ascending, default) or desc (descending)
  • When ordering is specified, output is buffered and sorted before display
  • Example: monocle parse file.mrt --order-by timestamp --order asc
  • Example: monocle search -t 2024-01-01 -d 1h -p 1.1.1.0/24 --order-by timestamp --order desc

• monocle config sources: Shows staleness status based on TTL for all data sources

  • "Stale" column shows whether each source needs updating based on its configured TTL
  • Configuration section shows current TTL values for all sources

Bug Fixes

• Avoid creating a new SQLite database when monocle config sources inspects staleness

Code Improvements

• Data refresh logging: CLI now shows specific reason for data refresh ("data is empty" vs "data is outdated") instead of generic "empty or outdated" message
• AS name display: ASN names are now displayed using a preferred source hierarchy:
  • Priority order: PeeringDB aka → PeeringDB name_long → PeeringDB name → AS2Org org_name → AS2Org name → Core name
  • This provides more recognizable, commonly-used AS names from PeeringDB when available
  • Affects all commands that display AS names: inspect, as2rel, rpki, pfx2as
• Feature gate cleanup: Simplified feature gating for the database module
  • The entire database module is now gated at lib.rs level with #[cfg(feature = "lib")]
  • Removed redundant feature gates from internal submodules
  • Added detailed feature documentation to ARCHITECTURE.md with use case scenarios

Breaking Changes

• Simplified feature flags: Replaced 6-tier feature system with 3 clear features

  • Old: database, lens-core, lens-bgpkit, lens-full, display, cli
  • New: lib, server, cli
  • Quick guide:
    • Need CLI binary? Use cli (includes everything)
    • Need WebSocket server without CLI? Use server (includes lib)
    • Need only library/data access? Use lib (database + all lenses + display)
  • Display (tabled) now always included with lib feature

• CLI flag renamed: --no-refresh renamed to --no-update for consistency with "update" terminology

  • Old: monocle --no-refresh <command>
  • New: monocle --no-update <command>

• Config subcommands renamed: Removed db- prefix from config subcommands for cleaner syntax

  • monocle config db-refresh → monocle config update
  • monocle config db-backup → monocle config backup
  • monocle config db-sources → monocle config sources

• Configurable TTL for all data sources: All data sources now have configurable cache TTL with 7-day default

  • Added asinfo_cache_ttl_secs config option (default: 7 days)
  • Added as2rel_cache_ttl_secs config option (default: 7 days)
  • Changed rpki_cache_ttl_secs default from 1 hour to 7 days
  • Changed pfx2as_cache_ttl_secs default from 24 hours to 7 days
  • Configure via ~/.monocle/monocle.toml or environment variables (MONOCLE_ASINFO_CACHE_TTL_SECS, etc.)

• Standardized database refresh API: Consistent interface for all data sources

  • New RefreshResult struct with records_loaded, source, timestamp, details
  • Renamed methods for consistency:
    • bootstrap_asinfo() → refresh_asinfo() (with deprecated alias)
    • update_as2rel() → refresh_as2rel() (with deprecated alias)
  • Added missing methods:
    • refresh_asinfo_from(path) - Load ASInfo from custom path
    • refresh_rpki() - Load RPKI data from records
    • refresh_pfx2as() - Load Pfx2as data from records
  • All repositories now use consistent needs_*_refresh(ttl) pattern
  • Removed hardcoded TTL methods (should_update() from AS2Rel)
  • All repositories have both URL and path loading methods

• Reorganized examples: One example per lens with _lens suffix

  • Flat directory structure: examples/time_lens.rs, examples/rpki_lens.rs, etc.
  • Added new examples for IpLens, Pfx2asLens, As2relLens
  • Removed verbose multi-example files
  • All examples use lib feature exclusively

• ParseFilters: Changed filter field types to support multiple values with OR logic

  • origin_asn: Option<u32> → Vec<String>
  • prefix: Option<String> → Vec<String>
  • peer_asn: Option<u32> → Vec<String>
  • Empty Vec is equivalent to no filter (previous None)
  • Values can be prefixed with ! for negation (exclusion)
  • Library users will need to update code: Some(13335) → vec!["13335".to_string()]

v1.0.2

New Features

• Added new monocle pfx2as command for prefix-to-ASN mapping lookups

  • Search by prefix: Query prefixes to find their origin ASNs
    • Example: monocle pfx2as 1.1.1.0/24
  • Search by ASN: Query an ASN to find all its announced prefixes
    • Example: monocle pfx2as 13335 or monocle pfx2as AS13335
  • RPKI validation: Shows RPKI validation status (valid/invalid/not_found) for each prefix-ASN pair
  • --show-name: Display AS organization name for each origin ASN
  • --include-sub: Include sub-prefixes (more specific) in results
    • Example: monocle pfx2as 8.0.0.0/8 --include-sub --limit 20
  • --include-super: Include super-prefixes (less specific) in results
    • Example: monocle pfx2as 1.1.1.0/24 --include-super
  • --limit: Limit the number of results
  • Supports all standard output formats (--format table/json/psv/etc.)

• Enhanced monocle as2rel command with advanced filtering and multi-ASN support

  • --min-visibility <PERCENT>: Filter results by minimum visibility percentage (0-100)
    • Available for all as2rel queries
    • Filters out relationships seen by fewer than the specified percentage of peers
  • --single-homed: Find ASNs that are single-homed to the queried ASN
    • Shows only ASNs where the queried ASN is their ONLY upstream provider
    • Useful for identifying customers with no redundancy
    • Example: monocle as2rel 2914 --single-homed
  • --is-upstream: Filter to show only downstream customers of the queried ASN
    • Shows relationships where the queried ASN is the upstream (provider)
  • --is-downstream: Filter to show only upstream providers of the queried ASN
    • Shows relationships where the queried ASN is a downstream (customer)
  • --is-peer: Filter to show only peer relationships (settlement-free interconnection)
  • Multi-ASN support: Query relationships among multiple ASNs at once
    • When more than two ASNs are provided, shows all pair combinations
    • Results sorted by asn1, with asn1 < asn2 for each pair
    • Example: monocle as2rel 174 2914 3356 shows all three pair relationships

• Added global --no-refresh flag to disable automatic data refresh

  • Use monocle --no-refresh <command> to skip all automatic data loading/refresh
  • Useful when you want to use existing cached data only
  • Shows warnings when data is missing or stale instead of auto-refreshing

• Added Docker support with multi-stage build

  • Dockerfile with two-stage build process for minimal image size (~176MB final image)
  • Uses Rust 1.92 and Debian trixie-slim as runtime base
  • docker-compose.yml for easy container orchestration
  • .dockerignore to optimize build context
  • Runs as non-root user for security
  • Persistent data volume at /data
  • Default server mode with port 8080 exposed

Bug Fixes

• Fixed "database is locked" error in monocle config db-refresh command (Issue #90)
  • The do_refresh function was opening redundant database connections for ASInfo and AS2Rel data sources
  • Now correctly uses the already-passed database connection parameter

Improvements

• Added visual ... row indicator in tables when results are truncated

  • Search results table now shows a ... row when more matches exist
  • RPKI ROA tables show truncation indicator
  • Announced prefixes table shows truncation indicator
  • Connectivity section (upstreams/peers/downstreams) tables show truncation indicator
  • Makes it much more visible that additional results are available

• Added [monocle] prefix to all auto-refresh log messages

  • Makes it easier to distinguish monocle's internal logging from main output
  • Especially useful when refresh operations run automatically during commands

• RPKI ASPA command now ensures ASInfo data is available for AS name enrichment

  • Automatically loads ASInfo data before showing ASPA output
  • AS names and countries are displayed in ASPA results

• Added comprehensive tests for database initialization with mock data

  • Tests for all repositories being accessible after initialization
  • Tests for schema version verification
  • Tests for RPKI and Pfx2as mock data storage/retrieval

v1.0.1

Bug Fixes

• Fixed cross-compilation issue on Linux platforms caused by OpenSSL dependency
  • Updated bgpkit-commons to v0.10.1 which uses rustls instead of native-tls
  • All TLS operations now use rustls, eliminating the need for OpenSSL development packages

v1.0.0

This is a major release with significant architectural changes, new commands, and breaking changes.

Breaking Changes

• Command Removals & Renames:
  • Removed broker command (use search --broker-files instead).
  • Removed radar command (access Cloudflare Radar directly via their API).
  • Removed rpki list and rpki summary commands (use rpki roas instead).
  • Renamed rpki check to rpki validate.
  • Renamed whois to inspect (unified AS/prefix lookup command).
• Library API:
  • All public functions are now accessed through lens structs (e.g., InspectLens, RpkiLens).
• Output:
  • Default output format changed from markdown to table (pretty borders).

New Features

New Commands

• monocle inspect: Unified AS/prefix information lookup.
  • Replaces whois and pfx2as.
  • Auto-detects query type (ASN, prefix, IP address, or name).
  • Combines data from ASInfo, AS2Rel, RPKI, and Pfx2as.
• monocle server: WebSocket API Server.
  • JSON-RPC style protocol with streaming support.
  • Endpoints for all major monocle operations.
• monocle config: Consolidated configuration and database management.
  • Manage data sources, refresh data, and backup database.
• monocle as2rel: AS Relationship lookup.
  • Query relationships, peers, and upstreams.

ASPA Support

• Enrichment:
  • Enriched customer/provider names and countries via SQL JOINs.
  • Unified provider structure in JSON output (providers array with {asn, name} objects).

Core Enhancements

• Unified Output Format: Global --format option for all commands (table, markdown, json, json-pretty, json-line, psv).
• SQLite Integration:
  • ASInfo: Unified AS information stored in SQLite (replaces as2org).
  • Pfx2as: Prefix-to-ASN mappings cached in SQLite for fast range lookups.
  • RPKI: ROAs and ASPAs cached in SQLite.
• Progress Tracking: Library support for callback-based progress reporting in ParseLens and SearchLens.
• Feature Flags: Reorganized into tiers (database, lens-core, lens-bgpkit, lens-full, display, cli).

Improvements

• monocle inspect:
  • Progress messages during data loading.
  • Improved output formatting with section headers.
  • Performance optimization (lazy loading of data sources).
• General:
  • Name truncation: Long names in tables are truncated to 20 chars (disable with --show-full-name).
  • Database performance: Optimized batch insert operations.
  • Broken pipe handling: Graceful exit when piping output (e.g., to head).

Bug Fixes

• Handle SIGPIPE gracefully to prevent panics when piping output.

Documentation

• Added WebSocket server documentation.
• Updated all documentation references and examples.

Code Improvements

• Lens-based architecture: Centralized logic in src/lens/.
• Refactoring: Improved CLI command organization.
• Examples: Added comprehensive examples for all feature tiers.

Dependencies

• Added bgpkit-commons (asinfo, rpki, countries).
• Added server dependencies (axum, tokio, etc.).
• Added libc (used for SIGPIPE handling on Unix systems).
• Removed rpki crate.

v0.9.1

Maintenance

• update dependencies
  • oneio -> v0.20.0
  • bgpkit-parser -> v0.12.0
  • bgpkit-broker -> v0.9.1

Bug fixes

• Fix an issue where monocle fails to locate the latest CAIDA as2org dataset file

v0.9.0

New features

• Added retry mechanism for failed search operations with exponential backoff
• Implemented real-time success/failure progress tracking during search
• Added paginated search processing for large time ranges to handle memory efficiently

Performance improvements

• Database bootstrap performance improvements
  • Added proper transaction management for bulk inserts
  • Replaced string-based SQL with prepared statements
  • Added database indexes for common query patterns
  • Enabled SQLite performance optimizations (WAL mode, cache tuning)
  • Impact: BGP data insertion ~10x faster, as2org bootstrap ~100x faster (3+ minutes → 1-2 seconds)

Bug fixes

• Fixed network error handling in multi-file processing to prevent thread panics

Code improvements

• Replaced unwrap/expect calls with proper error handling
• Added clippy lints to deny unsafe unwrap_used and expect_used patterns
• Updated CI workflow to include formatting and clippy checks
• Enhanced database operations with proper Result types
• Improved RPKI validator error handling

v0.8.0

New subcommand

• added monocle pfx2as subcommand to allow bulk prefix-to-asn mapping using BGPKIT dataset
  • it takes a list of prefixes or prefix files (one prefix per line)

Example:

monocle pfx2as 1.1.1.0/24 8.8.8.0/24 --json
[
  {
    "origin": 13335,
    "prefix": "1.1.1.0/24"
  },
  {
    "origin": 15169,
    "prefix": "8.8.8.0/24"
  }
]

Maintenance

• update dependencies
  • note that we upgraded to bgpkit-parser v0.11 and community values are now without prefixes such as lg: ecv6