// pipeline-first recon intelligence framework
ASRFacet-Rb
PIPELINE-DRIVEN · RELATIONSHIP-AWARE · OFFLINE-FIRST
ASRFacet-Rb is a reconnaissance system built for repeatable runs and change-aware intelligence.
It favors relationship mapping and historical tracking over one-time scanner output.
▸ v1.0.0
Ruby >= 3.2
53 Tests Passing
Bundle Exec Rake Passing
Status: Stable
Authorized Use Only
5
Core Pipeline Blocks
9
Passive Sources
4
Output Formats
53
Automated Tests
8
Docs Pages
Core Idea
One Line
Recon that builds relationships and tracks changes over time, not just flat output snapshots.
| Design Choice | Why It Matters |
|---|---|
| Pipeline Thinking | Each stage hands structured context to the next stage, so runs are easier to reason about. |
| Event-Driven Recon | New findings trigger controlled follow-up work instead of ad-hoc drift between modules. |
| Offline-First Reports | You keep usable CLI, TXT, HTML, and JSON artifacts without requiring hosted dashboards. |
How It Works
Flow Graph
Tap or hover each stage to see how the framework moves from discovery to long-term tracking.
Quick Start (30 Seconds)
shell
$ git clone https://github.com/voltsparx/ASRFacet-Rb.git
$ cd ASRFacet-Rb
$ bundle install
$ bundle exec rake
$ bundle exec ruby bin/asrfacet-rb scan example.com --passive-only
Use It / Skip It
Use It If
You want repeatable recon, relationship-aware output, and historical change tracking in local artifacts.
Skip It If
You only want quick one-time scans and do not need structured data or run-to-run intelligence.
System Naming
Discovery Engine, Validation Engine, Correlation Engine, and Tracking Engine keep architecture understandable.
⚠ Authorized Use Only
Use ASRFacet-Rb only on systems you own or have explicit written permission to test.
The framework includes scope controls, recon memory, and guided explanations to keep operators inside approved boundaries.
What This Site Covers
Getting Started
Install the framework, verify it, learn the aliases, and run your first safe workflow.
Workflow
Understand how passive discovery, validation, mapping, and reporting fit together.
CLI Reference
See the main commands, global flags, syntax rules, and practical command layout.
Modes
Compare console mode, web session mode, wizard mode, lab mode, and example workflows.
Reporting
Review output formats, storage layout, config overrides, and verification habits.
Development
See live repository activity, commit trends, and release markers pulled from GitHub.
Download Center
Download Linux, macOS, and Windows installers and run lifecycle modes from one page.
Project
Check the repository links, licensing context, and maintainer details.
Release Signals
VERSION
Current tagged release marker for quick trust checks.
CHANGELOG
What changed between versions and why it matters to operators.
ROADMAP
Next planned stability, feature, and usability milestones.
Why Not Just One-Time Scanners
Traditional scanners are excellent for fast snapshots. ASRFacet-Rb is designed for continuous, structured, and relational intelligence that operators can compare over time.
Core Capabilities
Passive Discovery
Uses multiple passive sources before any active probe hits the target.
DNS & Cert Pivoting
Validates hostnames and expands the asset set through DNS and SAN pivots.
Service Mapping
Finds reachable services with threaded TCP scanning and banner collection.
Web Recon
Performs HTTP probing, crawl analysis, JavaScript endpoint extraction, and correlation.
Monitoring
Compares runs over time using recon memory and change tracking summaries.
Operator Guidance
Exposes explainers, manuals, wizard flow, and beginner-friendly feedback while scanning.