## 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