bar-directory-recon 0.1.1

Bar directory reconnaissance and automation tool for legal professional data extraction

Universal Recon - Bar Directory Reconnaissance Tool

Overview

Universal Recon is a comprehensive bar directory reconnaissance and automation tool designed for legal professional data extraction. It provides a modular plugin system for extracting, validating, and analyzing data from legal bar directories and professional websites.

---

Key Features

• Plugin-Based Architecture: Modular system with specialized extractors for different data types
• Social Media Detection: Automated discovery of LinkedIn, Twitter, Facebook, and Instagram profiles
• Firm Data Extraction: Intelligent parsing of law firm information and contact details
• ML-Powered Classification: Machine learning-based content labeling and categorization
• Validation Framework: Comprehensive data validation and quality assessment tools
• Analytics Suite: Risk assessment, trend analysis, and reporting capabilities
• Cross-Platform Support: Works on Windows and Linux with automated environment detection

---

Getting Started

Requirements

• Windows 10/11, PowerShell 5.1+
• OneDrive installed and configured
• Python 3.11+
• Admin rights for scheduled tasks

Virtual Environment Setup

• Use activate_venv.bat (CMD) or ActivateVenv.ps1 (PowerShell) to activate the Python environment.
• For full dev setup: RunDevelopment.bat or StartDevPowerShell.bat.
• To fix or recreate the venv: fix_venv_activation.bat and InstallDependencies.bat.

Environment Variables

• .env.work and .env.asus are used for device-specific configs.
• env_loader.py auto-detects and loads the correct file.
• Only one .env is loaded per execution.

First-Time Setup

1. Activate the venv and install dependencies.
2. Run RunOneDriveAutomation.bat and follow the menu.
3. For preview, use option 7; for full automation, use option 1.

---

Automation Scripts

• OneDriveAutomation.ps1: Main entry for all tasks.
• auto_git_commit.py: Auto-commits and pushes to GitHub.
• git_commit_and_notify.py: Commits, pushes, and sends notifications.
• notifier.py: Handles all email notifications (HTML supported).
• motion_task_creator.py: Local integration with Motion App via Flask API.
• health_check.py: Verifies environment and variables.
• log_rotator.py: Archives old logs.

---

Best Practices

• Always use env_loader.py for environment detection.
• Maintain only one version of each core script.
• Keep .env files in the project root.
• Log all actions for traceability.
• Deprecated: .env (generic), token.pickle, device-specific notifier scripts.

---

Project Roadmap (Excerpt)

• Unified .env management and loader
• Centralized logging
• AI-powered task automation (Motion App integration)
• Git automation and notification
• Optional: Further AI enhancements and advanced analytics

---

Contributors & Contact

• For setup help, see the archived Setup Instructions and Roadmap in docs/archive/.
• For issues, open a ticket or contact the maintainer.

---

This README consolidates all previous documentation, setup guides, and roadmaps. For historical docs, see docs/archive/.