Skip to content

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

updated changelogh

six2dezebecb6248f2c
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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