reconFTW is a tool designed to perform automated recon on a target domain by running the best set of tools to perform scanning and finding out vulnerabilities
Shell bug-bountybugbountybugbounty-tooldnshackingnucleiosintpenetration-testingpentestpentest-toolpentestingreconreconnaissancescannersecuritysecurity-toolssubdomainsubdomain-enumerationvulnerabilities
updated changelogh
six2dezebecb6248f2c
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 04853c6..b994ecb 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,10 +5,53 @@ All notable changes to this project will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).-## [Unreleased]+## [v4.0] - 2026-02-05 Major Release### Added+**Modular Architecture**+- Split monolithic script into 8 focused modules under `modules/`:+ - `core.sh` — lifecycle, logging, notifications, cleanup+ - `modes.sh` — scan modes and argument parsing+ - `subdomains.sh` — subdomain enumeration+ - `web.sh` — web analysis, fuzzing, nuclei scans+ - `vulns.sh` — vulnerability scanning+ - `osint.sh` — OSINT functions+ - `axiom.sh` — Axiom fleet helpers+ - `utils.sh` — shared utilities+- Validation library at `lib/validation.sh` for input sanitization++**New CLI Flags**+- `--health-check` — system diagnostics before scanning+- `--dry-run` — preview commands without execution+- `--parallel` — run independent functions in parallel (faster, more RAM)+- `--source-only` — source functions without running (for testing/scripting)++**Robustness Features**+- Circuit breaker pattern: auto-skip tools after repeated failures+- Checkpoint system: resume scans from last successful phase+- Adaptive rate limiting on 429/503 responses+- Disk space pre-flight check (`MIN_DISK_SPACE_GB`)+- Log rotation (`MAX_LOG_FILES`, `MAX_LOG_AGE_DAYS`)+- Cleanup traps for graceful shutdown++**Input Validation**+- `sanitize_domain()` strips dangerous characters and converts to lowercase+- `validate_file_exists()`, `validate_file_readable()` for `--list`, `--inscope`, etc.+- `validate_custom_function()` ensures `-c` targets exist before execution++**Testing**+- 100+ bats tests covering unit, integration, and security scenarios+- `tests/security/test_injection.bats` for command injection prevention+- `tests/mocks/` for offline testing+- Makefile targets: `make test`, `make lint`, `make test-security`++**Other**+- 6 new ASCII banners (#25-30)+- `secrets.cfg` support (gitignored) for API keys+- Performance timing summary at scan completion+- DEEP mode helpers: `should_run_deep_*()` functions+**Deep Wildcard Detection** (Based on DEF CON Subdomain Enumeration research)- `deep_wildcard_filter()` - Iterative wildcard detection at all subdomain levels- `DEEP_WILDCARD_FILTER` config option to enable/disable@@ -75,74 +118,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0- Prevents internal commands from consuming stdin and breaking the loop- Now correctly processes all domains in the list sequentially+**Others**+- macOS compatibility: `stat`, `df`, `sed` commands now detect OS correctly+- Syntax error in `vulns.sh` (pipe at wrong line position)+- Timing summary crash when function names contained spaces+- Readonly variable error when re-sourcing the script+- Duplicate nuclei findings (domain vs URL targeting same host)+### Changed- Replaced 107 duplicate `mkdir -p` patterns with `ensure_dirs()`- Replaced skip notification printf patterns with `skip_notification()`- Module loading order updated to include lib/common.sh and lib/parallel.sh-------**Modular Architecture**-- Split monolithic script into 8 focused modules under `modules/`:- - `core.sh` — lifecycle, logging, notifications, cleanup- - `modes.sh` — scan modes and argument parsing- - `subdomains.sh` — subdomain enumeration- - `web.sh` — web analysis, fuzzing, nuclei scans- - `vulns.sh` — vulnerability scanning- - `osint.sh` — OSINT functions- - `axiom.sh` — Axiom fleet helpers- - `utils.sh` — shared utilities-- Validation library at `lib/validation.sh` for input sanitization--**New CLI Flags**-- `--health-check` — system diagnostics before scanning-- `--dry-run` — preview commands without execution-- `--parallel` — run independent functions in parallel (faster, more RAM)-- `--source-only` — source functions without running (for testing/scripting)--**Robustness Features**-- Circuit breaker pattern: auto-skip tools after repeated failures-- Checkpoint system: resume scans from last successful phase-- Adaptive rate limiting on 429/503 responses-- Disk space pre-flight check (`MIN_DISK_SPACE_GB`)-- Log rotation (`MAX_LOG_FILES`, `MAX_LOG_AGE_DAYS`)-- Cleanup traps for graceful shutdown--**Input Validation**-- `sanitize_domain()` strips dangerous characters and converts to lowercase-- `validate_file_exists()`, `validate_file_readable()` for `--list`, `--inscope`, etc.-- `validate_custom_function()` ensures `-c` targets exist before execution--**Testing**-- 100+ bats tests covering unit, integration, and security scenarios-- `tests/security/test_injection.bats` for command injection prevention-- `tests/mocks/` for offline testing-- Makefile targets: `make test`, `make lint`, `make test-security`--**Other**-- 6 new ASCII banners (#25-30)-- `secrets.cfg` support (gitignored) for API keys-- Performance timing summary at scan completion-- DEEP mode helpers: `should_run_deep_*()` functions--### Changed- Main script reduced from ~7000 to ~500 lines (entry point only)- Nuclei scans now use only URLs with protocol, avoiding duplicate scans- All API keys use env-var fallback pattern (`${VAR:-}`)- Interactsh process tracked by PID instead of `pkill -f`-### Fixed-- macOS compatibility: `stat`, `df`, `sed` commands now detect OS correctly-- Syntax error in `vulns.sh` (pipe at wrong line position)-- Timing summary crash when function names contained spaces-- Readonly variable error when re-sourcing the script-- Duplicate nuclei findings (domain vs URL targeting same host)-### Security- Removed all `eval` on user input- Input sanitization prevents shell metacharacter injection- Secrets redacted from logs when `SHOW_COMMANDS=true`- File permission checks for `secrets.cfg`--[Unreleased]: https://github.com/six2dez/reconftw/compare/v3.2...HEAD