\n\n---\n### npm Package (Windows)\n\n```bash\nnpm install -g @chahuadev/junk-sweeper-app --foreground-scripts --force\n```\n\n> The installer auto-downloads the correct binary for your platform. Use `--foreground-scripts` to see the download progress bar.\n\n---\n\n## 🐧 Running on Linux / WSL2 (Ubuntu)\n\nFirst install the required system libraries (one-time setup):\n\n```bash\nsudo apt-get update && sudo apt-get install -y \\\n libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 \\\n libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \\\n libxrandr2 libgbm1 libasound2\n```\n\nThen run the AppImage:\n\n```bash\nchmod +x \"Junk Sweeper.AppImage\"\nDISPLAY=:0 WAYLAND_DISPLAY=wayland-0 \\\n ./\"Junk Sweeper.AppImage\" \\\n --appimage-extract-and-run --no-sandbox --disable-gpu\n```\n\n **WSL2 tip:** Copy to WSL native filesystem first:\n\n # Path after: npm install -g @chahuadev/junk-sweeper-app\n # (no sudo)\n\n ```bash\n cp ~/.npm-global/lib/node_modules/@chahuadev/junk-sweeper-app/bin/\"Junk Sweeper.AppImage\" /tmp/JunkSweeper.AppImage\n ```\n # (with sudo)\n # cp /usr/lib/node_modules/@chahuadev/junk-sweeper-app/bin/\"Junk Sweeper.AppImage\" /tmp/JunkSweeper.AppImage\n\n```bash\n chmod +x /tmp/JunkSweeper.AppImage\n DISPLAY=:0 WAYLAND_DISPLAY=wayland-0 /tmp/JunkSweeper.AppImage \\\n --appimage-extract-and-run --no-sandbox --disable-gpu\n```\n\n---\n## Security Guarantee\n\nJunk Sweeper is **read-only by design** — verified at the code level, not just by policy.\n\n| Guarantee | How It Works |\n|---|---|\n| **Never modifies user files** | All detectors use `fs.readFileSync()` only — no `writeFileSync()` anywhere near your code |\n| **Never touches the OS** | No registry writes, no admin privilege requests, no system calls outside the app's own data folder |\n| **Path Traversal Protection** | Every scan path is validated against `../` traversal, symlinks, and forbidden OS directories (`System32`, `/etc`, `/sys`, `/proc`) |\n| **Executable Injection Prevention** | Strict file-type whitelist — `.exe`, `.dll`, `.bat`, `.sh` and all binary formats are blocked before analysis |\n| **App Integrity on Every Launch** | SHA-256 checksums of `main.js`, `preload.js`, and all detectors are verified before the app starts — tampered builds are rejected |\n| **Sandboxed Renderer** | Electron runs with `contextIsolation: true`, `sandbox: true`, `nodeIntegration: false` — the UI has zero direct Node.js access |\n| **Audit Log** | Every file access and security event is logged to `~/.chahuadev/logs/` for full traceability |\n\nThe only files the app ever writes are its **own** layout cache (`%APPDATA%\\Junk Sweeper\\layouts\\`) and its own security audit log — nothing inside your project.\n\n---\n\n## Key Features That Set Us Apart\n\nWhile standard linters look for syntax errors, **Chahuadev Junk Sweeper** uses deep AST (Abstract Syntax Tree) analysis to understand the *context* and *architecture* of your entire project.\n\n### Silent Bug Catcher\nDetects logical flaws that won't crash your app but **will** silently break your business logic:\n\n| Pattern | What It Catches |\n|---|---|\n| **Empty Catch Blocks** | Errors swallowed with `catch(e) {}` — bugs disappear without a trace |\n| **Zombie Event Listeners** | `.addEventListener()` without a matching `.removeEventListener()` — memory leaks that grow over time |\n| **Scope Shadowing** | Inner variable re-declaring an outer name — logic in the outer scope runs on the wrong value |\n| **Floating Promises** | `async` functions called without `await` inside `try/catch` — rejections go unhandled |\n\nThis is what separates Junk Sweeper from a plain linter. Your code compiles fine, your tests pass — and the bug ships anyway.\n\n### Interactive Architecture Map \nNot just a static graph. A **fully interactive dependency diagram** that maps every cross-file connection in your project:\n\n- **Left-to-Right auto-layout** powered by ELK Layered (Sugiyama) — instantly see architecture flow with better crossing minimization\n- **Drag nodes freely** to group related files your way\n- **Save / Load / Copy Layout JSON** — positions persist across sessions, so your team always sees the same organised view\n- **Bidirectional issue linking** — click a file node to filter the Issues list; click the pin icon on any issue to fly to that node on the map\n- **Color-coded severity** — Green (clean) / Amber (1–2 issues) / Red (3+ issues)\n- **Standalone map mode** — open map window without scan data and import a previously exported workflow JSON\n- **Portable workflow export** — exported JSON embeds graph data, issue structures, layout/view state, and render assets for future mobile import\n- Detects `require()`, `import`, `![\"Junk](\"https://huggingface.co/datasets/chahuadev/chahuadev-png/resolve/main/chahuadev-junk-sweeper.png\")
\n![\"NPM](\"https://img.shields.io/npm/v/@chahuadev/junk-sweeper-app?style=for-the-badge&color=blue\")
![\"NPM](\"https://img.shields.io/npm/dt/@chahuadev/junk-sweeper-app?style=for-the-badge&color=success\")
![\"HuggingFace](\"https://img.shields.io/badge/%20HuggingFace-Dataset-yellow?style=for-the-badge\"){kind=icon}
![\"Non-Commercial](\"https://img.shields.io/badge/License-Non--Commercial-blue?style=for-the-badge\"){kind=icon}
![\"Electron](\"https://img.shields.io/badge/Electron-40+-47848F?style=for-the-badge&logo=electron&logoColor=white\"){kind=icon}
![\"Node.js](\"https://img.shields.io/badge/Node.js-%E2%89%A522.0.0-339933?style=for-the-badge&logo=node.js&logoColor=white\"){kind=icon}
![\"Python](\"https://img.shields.io/badge/Python-3.8+-3776AB?style=for-the-badge&logo=python&logoColor=white\"){kind=icon}
![\".NET](\"https://img.shields.io/badge/.NET-10.0-512BD4?style=for-the-badge&logo=dotnet&logoColor=white\"){kind=icon}
![\"Windows\"](\"https://img.shields.io/badge/Platform-Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white\"){kind=icon}
![\"Read-Only](\"https://img.shields.io/badge/Analysis-Read--Only%20%E2%9C%93-blue?style=for-the-badge\"){kind=icon}
![\"7-Layer](\"https://img.shields.io/badge/Security-7--Layer%20Gateway-red?style=for-the-badge&logo=shield&logoColor=white\"){kind=icon}