| ## Description | |
| This project, `filesystem-auditor`, is a high-performance utility designed to audit repository structures and analyze tech stacks. It leverages optimized filesystem traversal to handle large-scale codebases, providing surgical precision in identifying file types, counts, and total sizes. The system is built for speed and reliability, ensuring that every file is accounted for without missing a single entry. | |
| ## System Overview | |
| ```mermaid | |
| graph TD | |
| A[Repository Path] --> B{Action} | |
| B -->|Structure Scan| C[scan_structure.py] | |
| B -->|Techstack Scan| D[scan_techstack.py] | |
| C --> E[STRUCTURE.md] | |
| D --> F[TECHSTACK.md] | |
| E --> G[Visual Documentation] | |
| F --> G | |
| ``` | |
| ## Project Structure | |
| ```text | |
| filesystem-auditor (local)/ | |
| ├── scan_structure.py | |
| └── scan_techstack.py | |
| ``` | |
| ## Techstack | |
| Audit of **filesystem-auditor (local)** project files (excluding environment and cache): | |
| | File Type | Count | Size (KB) | | |
| | :--- | :--- | :--- | | |
| | Python (.py) | 2 | 29.6 | | |
| | Markdown (.md) | 1 | 0.1 | | |
| | **Total** | **3** | **29.7** | | |
| ## Dependencies | |
| - **Python**: | |
| - `os`: Core file system operations and traversal. | |
| - `sys`: System-specific parameters and functions. | |
| - `argparse`: Robust command-line argument parsing. | |
| - `pathlib`: Object-oriented filesystem paths. | |
| - `collections`: High-performance container datatypes (`defaultdict`). | |
| - `subprocess`: Spawning new processes and connecting to their pipes. | |
| ## Applications | |
| - Google Antigravity | |
| - Google Gemini Pro 3.1 | |
| - Visual Studio Code | |
| - Windows PowerShell | |