Enhanced AS2Rel Command and New Pfx2as Command

[digizeph]

Summary

This PR adds significant enhancements to the as2rel command with advanced filtering capabilities, introduces a new pfx2as command for prefix-to-ASN mapping lookups, and improves table output with visual truncation indicators.

New Features

New monocle pfx2as Command

A new command for prefix-to-ASN mapping lookups with RPKI validation:

# Search by prefix
monocle pfx2as 1.1.1.0/24

# Search by ASN
monocle pfx2as 13335 --limit 10 --show-name

# Include sub/super prefixes
monocle pfx2as 8.0.0.0/8 --include-sub --limit 20
monocle pfx2as 1.1.1.0/24 --include-super

Features:

• Auto-detects query type (ASN or prefix)
• Shows RPKI validation status (valid/invalid/not_found) for each prefix-ASN pair
• --show-name flag to display AS organization names
• --include-sub to include more specific (sub) prefixes
• --include-super to include less specific (super) prefixes
• --limit to control result count
• Supports all standard output formats (table, json, psv, etc.)

Enhanced monocle as2rel Command

New filtering options for more targeted relationship queries:

Option	Description
--min-visibility <PERCENT>	Filter by minimum visibility percentage (0-100)
--single-homed	Find ASNs single-homed to the queried ASN
--is-upstream	Show only downstream customers
--is-downstream	Show only upstream providers
--is-peer	Show only peer relationships

Multi-ASN Support:

# Query relationships among multiple ASNs (shows all pair combinations)
monocle as2rel 174 2914 3356 --show-name

Single-homed Discovery:

# Find ASNs that have only AS2914 as their upstream
monocle as2rel 2914 --single-homed --show-name

# Filter to single-homed ASNs with at least 10% visibility
monocle as2rel 2914 --single-homed --min-visibility 10

Visual Truncation Indicators

Tables now show a ... row when results are truncated, making it immediately visible that additional data exists:

╭────────────┬────────────┬───────╮
│ prefix     │ origin_asn │ rpki  │
├────────────┼────────────┼───────┤
│ 1.1.1.0/24 │ 13335      │ valid │
│ 8.8.8.0/24 │ 15169      │ valid │
│ ...        │ ...        │ ...   │
╰────────────┴────────────┴───────╯

This applies to:

• Search results
• RPKI ROA listings
• Announced prefixes
• Connectivity sections (upstreams/peers/downstreams)

Architecture

The pfx2as implementation follows the lens/command separation pattern per DEVELOPMENT.md:

• Pfx2asLens (src/lens/pfx2as/mod.rs): Contains all business logic

  • Query type detection (ASN vs prefix)
  • RPKI validation integration
  • AS name enrichment from ASInfo database
  • Result formatting for various output formats

• Command (src/bin/commands/pfx2as.rs): Thin CLI wrapper (~170 lines)

  • Handles CLI argument parsing
  • Manages data refresh prompts
  • Delegates all logic to the lens

Files Changed

New Files:

• src/bin/commands/pfx2as.rs - CLI command handler
• examples/database/pfx2as_search.rs - Usage example

Modified Files:

• src/lens/pfx2as/mod.rs - Enhanced with search functionality, RPKI validation, AS name enrichment
• src/lens/as2rel/mod.rs - Added filtering and multi-ASN support
• src/lens/as2rel/args.rs - New CLI arguments
• src/database/monocle/as2rel.rs - New database query methods
• src/lens/inspect/mod.rs - Added truncation indicators
• src/bin/commands/as2rel.rs - Updated command handler
• src/bin/monocle.rs - Added Pfx2as command
• README.md - Documentation for pfx2as command
• CHANGELOG.md - Feature documentation
• Cargo.toml - Added example entry
• examples/README.md - Added pfx2as example

Testing

• All existing tests pass
• New unit tests for Pfx2asSearchArgs and Pfx2asSearchResult
• Manual testing of all new features

Breaking Changes

None. All changes are additive.