docs: Add complete documentation

Author: Scott Thornton

.gitignore

@@ -1,3 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+venv/
+env/
+ENV/
+
 # Logs
 logs
 *.log
@@ -7,6 +32,7 @@ yarn-error.log*
 pnpm-debug.log*
 lerna-debug.log*
 
+# Node.js
 node_modules
 dist
 dist-ssr
@@ -22,3 +48,14 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+
+# AI tool artifacts
+.claude/
+CLAUDE.md
+claude.md
+planning.md
+status.md
+notes.md
+todo.md
+*.chat
+*.conversation

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+- Collection of 10 Python security tools for red teaming and penetration testing
+- **log_analyzer.py** - Authentication log analysis and brute force detection
+- **port_scanner.py** - TCP port scanning to identify open ports and services
+- **password_checker.py** - Password strength evaluation
+- **directory_bruteforce.py** - Hidden directory and file discovery on web servers
+- **packet_sniffer.py** - Network packet capture and analysis
+- **file_integrity_monitor.py** - File change monitoring via hash checking
+- **subdomain_enum.py** - Subdomain enumeration
+- **web_vuln_scanner.py** - Web vulnerability scanning (XSS, SQLi, open redirects)
+- **dns_recon.py** - DNS information gathering
+- **hash_cracker.py** - Password hash cracking (dictionary and brute force)
+- Web frontend interface for tool management
+- Educational security testing utilities
+- Ethical use disclaimer and authorization requirements
+
+[Unreleased]: https://github.com/scthornton/python-guardians/commits/main

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Scott Thornton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

SECURITY.md

@@ -0,0 +1,3 @@
+# Security Policy
+
+**Email:** scott@perfecxion.ai