Upload 6 files

README.md

@@ -0,0 +1,56 @@
+# filesystem-auditor
+
+## Description
+`filesystem-auditor` is a pair of high-performance Python scripts designed to scan and analyze repository structures and tech stacks. It handles massive filesystems efficiently using `os.scandir` and provides detailed Markdown-formatted audits of file types, counts, and sizes. Look at `example_output\` forlder for examples.
+
+![license](https://img.shields.io/badge/license-MIT-blue)
+![reposize](https://img.shields.io/badge/reposize-29.6%20KB-brightgreen)
+![last-commit](https://img.shields.io/badge/last--commit-2026--02--28-orange)
+![language-python](https://img.shields.io/badge/language-Python-blue)
+
+## 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
+```
+
+## Usage
+To audit your repository, run the scripts from the command line:
+
+```powershell
+# Scan directory structure
+python scan_structure.py . --output STRUCTURE.md
+
+# Audit techstack (file types, counts, sizes)
+python scan_techstack.py . --output TECHSTACK.md
+```
+
+## BibTeX Citation
+```bibtex
+@misc{albeos2026filesystemauditor,
+  author = {Rembrant Oyangoren Albeos},
+  title = {filesystem-auditor: High-performance repository structure and techstack scanner},
+  year = {2026},
+  publisher = {Hugging Face},
+  journal = {Hugging Face Repository},
+  howpublished = {\url{https://huggingface.co/algorembrant/filesystem-auditor/}}
+}
+```
+
+## Author
+Rembrant Oyangoren Albeos (2026)

STACKS.md

@@ -0,0 +1,47 @@
+## 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

example_output/STRUCTURE.md

@@ -0,0 +1,579 @@
+## Project Structure
+
+```text
+QRAT2025/
+├── Concepts and Topics Folder/
+│   ├── Basics/
+│   │   ├── Basics 101.ipynb
+│   │   ├── code promting.ipynb
+│   │   ├── Foundation101.ipynb
+│   │   └── nothing.ipynb
+│   ├── concepts from other sources/
+│   │   └── lists.ipynb
+│   ├── Chart plotting using python.ipynb
+│   ├── Max Number of Losing Streak in Regards to Winrate.ipynb
+│   ├── Risk Management Logic.ipynb
+│   └── The Law of Large Numbers (LLN).ipynb
+├── Documents/
+│   ├── QRAT2025/
+│   │   ├── diversification_model/
+│   │   │   ├── img (1).png
+│   │   │   ├── img (2).png
+│   │   │   ├── img (3).png
+│   │   │   ├── img (4).png
+│   │   │   └── ReportTester-257199749_Diversification.html
+│   │   ├── dump/
+│   │   │   ├── ReportHistory-206675473 - Shortcut (2).lnk
+│   │   │   ├── ReportHistory-206675473 - Shortcut.lnk
+│   │   │   ├── ReportHistory-263204408.html
+│   │   │   ├── ReportHistory-263204408.png
+│   │   │   ├── ReportHistory-2632044080.html
+│   │   │   ├── ReportHistory-2632044080.png
+│   │   │   ├── ReportHistory-26320440800.html
+│   │   │   ├── ReportHistory-26320440800.png
+│   │   │   ├── ReportHistory-263204408000.html
+│   │   │   ├── ReportHistory-263204408000.png
+│   │   │   ├── ReportHistory-263204408gg.html
+│   │   │   ├── ReportHistory-263204408gg.png
+│   │   │   ├── ReportHistory-270451645.html
+│   │   │   ├── ReportHistory-270451645.png
+│   │   │   ├── ReportHistory-270454941.html
+│   │   │   ├── ReportHistory-270454941.png
+│   │   │   ├── ReportHistory-270456114.html
+│   │   │   ├── ReportHistory-270456114.png
+│   │   │   ├── ReportHistory-270461496.html
+│   │   │   ├── ReportHistory-270461496.png
+│   │   │   ├── ReportHistory-2704614960.html
+│   │   │   ├── ReportHistory-2704614960.png
+│   │   │   ├── ReportHistory-27046149600.html
+│   │   │   ├── ReportHistory-27046149600.png
+│   │   │   ├── ReportHistory-270461496000.html
+│   │   │   ├── ReportHistory-270461496000.png
+│   │   │   ├── ReportHistory-2704614960000.html
+│   │   │   ├── ReportHistory-2704614960000.png
+│   │   │   ├── ReportHistory-27046149600000.html
+│   │   │   ├── ReportHistory-27046149600000.png
+│   │   │   ├── ReportHistory-272840495.html
+│   │   │   ├── ReportHistory-272840495.png
+│   │   │   ├── ReportHistory-272840495.xlsx
+│   │   │   ├── ReportHistory-2728404950.html
+│   │   │   ├── ReportHistory-2728404950.png
+│   │   │   ├── ReportHistory-274899951.html
+│   │   │   ├── ReportHistory-274899951.png
+│   │   │   ├── ReportTester-257199749 qwe-holding.png
+│   │   │   ├── ReportTester-257199749 qwe-hst.png
+│   │   │   ├── ReportTester-257199749 qwe-mfemae.png
+│   │   │   ├── ReportTester-257199749 qwe.html
+│   │   │   ├── ReportTester-257199749 qwe.png
+│   │   │   ├── ReportTester-257199749-holding.png
+│   │   │   ├── ReportTester-257199749-hst.png
+│   │   │   ├── ReportTester-257199749-mfemae.png
+│   │   │   ├── ReportTester-257199749.html
+│   │   │   ├── ReportTester-257199749.png
+│   │   │   ├── ReportTester-257199749BTCUSDc1-holding.png
+│   │   │   ├── ReportTester-257199749BTCUSDc1-hst.png
+│   │   │   ├── ReportTester-257199749BTCUSDc1-mfemae.png
+│   │   │   ├── ReportTester-257199749BTCUSDc1.html
+│   │   │   ├── ReportTester-257199749BTCUSDc1.png
+│   │   │   ├── ReportTester-257199749q-holding.png
+│   │   │   ├── ReportTester-257199749q-hst.png
+│   │   │   ├── ReportTester-257199749q-mfemae.png
+│   │   │   ├── ReportTester-257199749q.html
+│   │   │   ├── ReportTester-257199749q.png
+│   │   │   ├── ReportTesterhedgeminimum-257199749-holding.png
+│   │   │   ├── ReportTesterhedgeminimum-257199749-hst.png
+│   │   │   ├── ReportTesterhedgeminimum-257199749-mfemae.png
+│   │   │   ├── ReportTesterhedgeminimum-257199749.html
+│   │   │   ├── ReportTesterhedgeminimum-257199749.png
+│   │   │   ├── ReportTesterskip 3-6 bar-257199749-holding.png
+│   │   │   ├── ReportTesterskip 3-6 bar-257199749-hst.png
+│   │   │   ├── ReportTesterskip 3-6 bar-257199749-mfemae.png
+│   │   │   ├─�� ReportTesterskip 3-6 bar-257199749.html
+│   │   │   ├── ReportTesterskip 3-6 bar-257199749.png
+│   │   │   └── traderbotversion1.set
+│   │   ├── live_stopouthedging/
+│   │   │   ├── ReportHistory-257199749 7am to 10am.html
+│   │   │   ├── ReportHistory-257199749 7am to 10am.png
+│   │   │   ├── ReportHistory-257199749 7am to 11am.html
+│   │   │   ├── ReportHistory-257199749 7am to 11am.png
+│   │   │   ├── ReportHistory-257199749 7am to 1pm.html
+│   │   │   ├── ReportHistory-257199749 7am to 1pm.png
+│   │   │   ├── ReportHistory-257199749 7am to 2pm.html
+│   │   │   ├── ReportHistory-257199749 7am to 2pm.png
+│   │   │   ├── ReportHistory-257199749 7am to 8am.html
+│   │   │   ├── ReportHistory-257199749 7am to 8am.png
+│   │   │   ├── ReportHistory-257199749 7am to 9am.html
+│   │   │   ├── ReportHistory-257199749 7am to 9am.png
+│   │   │   ├── ReportHistory-257199749 alltime.html
+│   │   │   ├── ReportHistory-257199749 alltime.png
+│   │   │   ├── ReportHistory-257199749.html
+│   │   │   ├── ReportHistory-257199749.png
+│   │   │   ├── ReportHistory-263204408 LiveTest2 runall.html
+│   │   │   ├── ReportHistory-263204408 LiveTest2 runall.png
+│   │   │   ├── ReportHistory-263204408.html
+│   │   │   ├── ReportHistory-263204408.png
+│   │   │   ├── ReportHistory-263204408gg.html
+│   │   │   └── ReportHistory-263204408gg.png
+│   │   └── livereport/
+│   │       ├── ReportHistory-148362150 live1.html
+│   │       ├── ReportHistory-148362150 live1.png
+│   │       ├── ReportHistory-183590578 Live3.html
+│   │       ├── ReportHistory-183590578 Live3.png
+│   │       ├── ReportHistory-186000559 live2.html
+│   │       └── ReportHistory-186000559 live2.png
+│   ├── eeee.ipynb
+│   └── ewe.doc
+├── MQL5 Folder/
+│   ├── #1EATB-Expert Advisor Trading Bot for MT5/
+│   │   ├── LiveTest1 Results/
+│   │   │   ├── ReportHistory-257199749 alltime.html
+│   │   │   └── ReportHistory-257199749 alltime.png
+│   │   ├── LiveTest2 Results/
+│   │   │   ├── ReportHistory-263204408 LiveTest2 runall.html
+│   │   │   └── ReportHistory-263204408 LiveTest2 runall.png
+│   │   ├── Test1 Results/
+│   │   │   ├── nonetest Results/
+│   │   │   │   └── nonetest parameters.txt
+│   │   │   ├── ReportHistory-270451645.html
+│   │   │   ├── ReportHistory-270451645.png
+│   │   │   ├── testsummary.txt
+│   │   │   ├── total prompting attempt.txt
+│   │   │   ├── traderbotversion1.set
+│   │   │   ├── TradingBotVersion1.ex5
+│   │   │   └── TradingBotVersion1.mq5
+│   │   ├── Test2 Results/
+│   │   │   ├── parameters.txt
+│   │   │   ├── ReportHistory-206675473.html
+│   │   │   └── ReportHistory-206675473.png
+│   │   ├── Test3 Results/
+│   │   │   ├── ReportHistory-274899951.html
+│   │   │   ├── ReportHistory-274899951.png
+│   │   │   └── test 3 paramenters.txt
+│   │   ├── Test4 Results/
+│   │   │   ├── parameters&summary.txt
+│   │   │   ├── ReportHistory-270454941.html
+│   │   │   └── ReportHistory-270454941.png
+│   │   ├── Test5 Results/
+│   │   │   ├── ReportHistory-270456114.html
+│   │   │   ├── ReportHistory-270456114.png
+│   │   │   └── summary&paratener.txt
+│   │   ├── Test6 Results/
+│   │   │   ├── ReportHistory-2728404950.html
+│   │   │   ├── ReportHistory-2728404950.png
+│   │   │   └── test 6 parameters.txt
+│   │   ├── Testrun12hours Results/
+│   │   │   ├── ReportHistory-2704614960000.html
+│   │   │   ├── ReportHistory-2704614960000.png
+│   │   │   └── seummary and parameters.txt
+│   │   ├── #1EATB.mq5
+│   │   └── MT5-EA_1min hedge stoporders.ipynb
+│   ├── 0_00-3_00 Range/
+│   │   ├── 03 Hedge.ipynb
+│   │   ├── 03 range hedge minimum.ipynb
+│   │   ├── attempts.ipynb
+│   │   ├── Diversification.ipynb
+│   │   ├── Refined version.ipynb
+│   │   └── scratch.mql
+│   ├── 89RS MT5 version/
+│   │   └── 89RS MT5 version.ipynb
+│   ├── ADX Filter/
+│   │   ├── First candle highlighter with adx.ipynb
+│   │   └── template with 1st candle highlighter.mq5
+│   ├── Dec25_Volume Profile based breakout momentuim strategy/
+│   │   ���── codeclaude.c++
+│   │   └── codegemini.c++
+│   ├── Dec29_6-8 range/
+│   │   ├── strategy.ipynb
+│   │   ├── v1.c++
+│   │   └── v2.c++
+│   ├── Developing POC/
+│   │   └── developing POC line.ipynb
+│   ├── H3 0 bar redbear bluebull (indicator)/
+│   │   ├── 1_version.mq5
+│   │   └── H3 0 bar redbear bluebull (indicator).ipynb
+│   └── Revised 0-3/
+│       ├── best/
+│       │   └── highest performing.mq5
+│       ├── 1_latestbest.mq5
+│       ├── 2_latestbest.mq5
+│       ├── 3_latestbest.mw5
+│       ├── 4_latestbest.mq5
+│       └── revised from very begining.ipynb
+├── Pinescript Folder/
+│   ├── 0SCT2025/
+│   │   ├── SCT Sunstoic's Charting Tool.ipynb
+│   │   ├── SCT2025indicator1-pinescript.js
+│   │   └── SCT2025indicator2-pinescript.js
+│   ├── 12pm Key Level/
+│   │   └── 4_00 utc key.ipynb
+│   ├── 1D Candle Preview/
+│   │   └── daily candle preview.ipynb
+│   ├── 3-Candle Pattern Highlighter (1-Minute Only) General engulfing/
+│   │   └── 3-Candle Pattern Highlighter (1-Minute Only).ipynb
+│   ├── 3-Minute Engulfing Pattern (3mEP) - 1m Visible/
+│   │   └── 3-Minute Engulfing Pattern (3mEP) - 1m Visible.ipynb
+│   ├── 30m high & low/
+│   │   └── 30m highlighter in lower timeframe.ipynb
+│   ├── 3am to close & 9am to 11am Candle/
+│   │   └── limited candles.ipynb
+│   ├── 4CCP + 4CRP Patterns/
+│   │   └── 4CCP + 4CRP Patterns.ipynb
+│   ├── 4CCP + 6CBP Pattern Detector + 30minute bars (AsiaManila)/
+│   │   └── 4CCP + 6CBP Pattern Detector + 30minute bars (AsiaManila).ipynb
+│   ├── 4CCP Pattern detector/
+│   │   └── 4CCP Pattern detector-pinescript.js
+│   ├── 4CEP + 10CRP Patterns/
+│   │   └── 4CEP + 10CRP Patterns.ipynb
+│   ├── 4CEP-T1 & T2 Patterns - Tiny Circle Labels on 3rd Candle/
+│   │   └── 4CEP-T1 & T2 Patterns - Tiny Circle Labels on 3rd Candle.ipynb
+│   ├── 5 Candle Pattern Highlighter (1-Minute Only)/
+│   │   └── 5 Candle Pattern Highlighter (1-Minute Only).ipynb
+│   ├── 6CBP Pattern Detector (Bearish & Bullish)/
+│   │   ├── 6CBP Pattern Detector (Bearish & Bullish).ipynb
+│   │   └── with timestamp version.ipynb
+│   ├── 89RS/
+│   │   ├── 89RS Rangebreakout Stoporder Model.ipynb
+│   │   ├── 89RSindicator-pinescript.js
+│   │   └── 89RSstrategy-pinescript.js
+│   ├── AMDX/
+│   │   └── quarterly.ipynb
+│   ├── Buying at Mariana's Trench/
+│   │   └── buying at marianas trench.ipynb
+│   ├── Daily Candle in Lower Timeframes/
+│   │   └── daily candle convertor.ipynb
+│   ├── Exact 30m Candles in any timeframe/
+│   │   └── live 30m candles.ipynb
+│   ├── Hihglight Key Hourly Candles/
+│   │   └── highlight.ipynb
+│   ├── Hourly Range Logic/
+│   │   └── HR.ipynb
+│   ├── Manual Key level/
+│   │   └── key levels input.ipynb
+│   ├── Market Profile (Volume based)/
+│   │   └── market profile volume based.ipynb
+│   ├── OB-OS Multi-Indicator Dashboard/
+│   │   └── OB/
+│   │       └── OS Multi-Indicator Dashboard.ipynb
+│   ├── Relative Strength Index/
+│   │   └── colored overbough and oversold region.ipynb
+│   ├── Risk Manager and Position Sizing/
+│   │   ├── Risk Manager and Position Sizing-pinescript.js
+│   │   └── Risk Manager and Position Sizing.ipynb
+│   ├── Synthetic Gamma Exposure (GEX)/
+│   │   └── gex.ipynb
+│   ├── Table Statistics/
+│   │   └── clean table.ipynb
+│   ├── Time Logic Reference/
+│   │   └── Time Logic Reference.ipynb
+│   ├── v3 Simple/
+│   │   └── highlight and 1D candle.ipynb
+│   ├── v4 Variant 1/
+│   │   └── v4 30m,15m,3m.ipynb
+│   ├── v5 Cummulative Delta/
+│   │   └── cummulative deta.ipynb
+│   ├── v5 Variant 1/
+│   │   └── v5 30m,15m,3m (with clean table) .ipynb
+│   ├── v5 Variant 2/
+│   │   └── fuhfuhlogic.ipynb
+│   ├── v6 Sunstoic/
+│   │   └── part1.ipynb
+│   ├── Verttical Lines at Specific Time/
+│   │   └── Vertical lines at specific time.ipynb
+│   ├── Vison Market Profile/
+│   │   └── vison market profile.ipynb
+│   ├── VROC buy&sell/
+│   │   └── vroc buysell.ipynb
+│   └── VWAP witih buy&sell spread/
+│       └── VWAP with buy&sell spread.ipynb
+├── Python Folder/
+│   ├── 3 tick-volume pattern hedge/
+│   │   ├── 3 tick-volume pattern hedge.ipynb
+│   │   ├── save.ipynb
+│   │   └── XAUUSDc M30 – Tick-Volume First Pattern + DMA Overlay + RAVI (UTC Reset).ipynb
+│   ├── All country's Total Debt/
+│   │   ├── Part2/
+│   │   │   ├── update 2.ipynb
+│   │   │   └── Worldwide National Debt Profiles.ipynb
+│   │   ├── debt.ipynb
+│   │   └── Worldwind Yearly Debt (1).ipynb
+│   ├── Bubble Orders/
+│   │   ├── Bubble Orders.ipynb
+│   │   └── xau_bubbles_zones.xls
+│   ├── Candlestick, Tick Volume, Range, Body , Wick/
+│   │   ├── (10 panes) XAUUSDc 3-Minute Candlestick with Tick Volume, Range, Body & Wick.ipynb
+│   │   ├── Filter(body_greaterthan_upper-wick_or_lower-wick).ipynb
+│   │   └── promting attempts.ipynb
+│   ├── COT Report Interpreter/
+│   │   ├── COT Report.ipynb
+│   │   └── VROC, COT report.ipynb
+│   ├── Cummulative Volume/
+│   │   └── MarketOpenClose.ipynb
+│   ├── Dec25.2025_Volume Profile based strategy visualization/
+│   │   ├── 1_framework.ipynb
+│   │   └── 2_framework.ipynb
+│   ├── Dec31_Newsfetching/
+│   │   └── Newfetching.ipynb
+│   ├── Downslope Linear Regression/
+│   │   └── Downslope Linear Regression in Volume.ipynb
+│   ├── EBP One Candle Strategy/
+│   │   └── EBP One Candle Strategy.ipynb
+│   ├── Equity Profile Clasification/
+│   │   ├── Equity classification.ipynb
+│   │   ├── notebook1.ipynb
+│   │   └── notebook2.ipynb
+│   ├── Fetching Data from mplfinance/
+│   │   └── Fetching Data from mplfinance.ipynb
+│   ├── Fetching Portfolio/
+│   │   ├── Broker account fetching.ipynb
+│   │   └── Python fetching portfolio from MT5.ipynb
+│   ├── imprvedversionof1bardelaySwing/
+│   │   ├── attempts.ipynb
+│   │   └── bestswing1BarDelay.ipynb
+│   ├── Law of Large Numbers/
+│   │   └── Law of Large Numbers.ipynb
+│   ├── Market Profiles/
+│   │   ├── Market Profile (volumedata ver).ipynb
+│   │   └── marketprofile on separate graph, chartbasic.ipynb
+│   ├── OHRMRSHS (from 89RS)/
+│   │   └── OHRMRSHS.ipynb
+│   ├── Rem lookback Algorithm/
+│   │   ├── 1bardelay.ipynb
+│   │   ├── 1barlagSwing.ipynb
+│   │   ├── best1barLag.ipynb
+│   │   ├── Rem lookback Algorithm.ipynb
+│   │   └── Volume Score Lookback algorithm.ipynb
+│   ├── Remscount Algorithm/
+│   │   ├── (10 panes) XAUUSDc 3-Minute Candlestick with Tick Volume, Range, Body & Wick (1).ipynb
+│   │   ├── 3candlepattern.ipynb
+│   │   ├── bestswing1BarDelay.ipynb
+│   │   ├── Filter(body_greaterthan_upper-wick_or_lower-wick) (1).ipynb
+│   │   ├── Lowest Pattern Score count.ipynb
+│   │   ├── patternScore.ipynb
+│   │   ├── remscountalgorithm(draft) (1).ipynb
+│   │   └── remscountalgorithm(draft).ipynb
+│   ├── The 0.25 precision footprint candles/
+│   │   ├── Footprint 0.25 cluster precision, market profile.ipynb
+│   │   └── PixeldFootprint.ipynb
+│   ├── Ticker Quotes Fetching/
+│   │   ├── notthis.py
+│   │   └── Quotes of all tradable assets in Exness.ipynb
+│   ├── Time Alignment/
+│   │   └── time alignment.ipynb
+│   ├── Using Python to plot charts from MT5's data feed, mplfinance, matplotlib, plotly charts/
+│   │   ├── notthis.py
+│   │   └── Using Python to plot charts from MT5's data feed, mplfinance, matplotlib, plotly charts.ipynb
+│   ├── Variance and Standard Deviations/
+│   │   ├── notthis.py
+│   │   └── Variance and Standard Deviations.ipynb
+│   ├── Volatility Based Trading Strategy, VTR, ADX, DI, DMag/
+│   │   ├── From tiktok_VTR, ADX, DI, DMag.ipynb
+│   │   ├── notthis.py
+│   │   ├── Volatility Based Trading Strategy, VTR, ADX, DI, DMag.pdf
+│   │   ├── VTR signals, market profile.ipynb
+│   │   ├── VTRchart.ipynb
+│   │   ├── xau_system_output.xls
+│   │   ├── xau_system_signals.png
+│   │   ├── xau_vtr_output.xls
+│   │   └── xau_vtr_tickvolume_output.xls
+│   ├── Volume Spread Analysis/
+│   │   ├── notthis.py
+│   │   └── VSA.ipynb
+│   └── Worldmap/
+│       └── Worldmap.ipynb
+├── Research Papers/
+│   ├── The 1CPMOTS.rp1_ Is Treating Trading Worse Than a Coin Flip, but with a Slight Edge, Profitable_/
+│   │   ├── codes/
+│   │   │   ├── 1candlepattern.ipynb
+│   │   │   └── Comparative Visualization of Backtest Metrics.ipynb
+│   │   ├── 1CPMOTS_rp1.pdf
+│   │   └── newplot (2).png
+│   ├── The 1HRMRSS.rp1_ Design and Optimization of the One Hour Range Median Reversion Stoporder Strategy/
+│   │   ├── CSV files/
+│   │   │   ├── 1HRMRSS_MCS1000 - total.csv
+│   │   │   ├── 1HRMRSS_MCS1000_UTC00-01_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC01-02_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC02-03_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC03-04_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC04-05_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC05-06_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC06-07_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC07-08_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC08-09_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC09-10_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC10-11_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC11-12_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC12-13_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC13-14_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC14-15_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC15-16_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC16-17_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC17-18_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC18-19_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC19-20_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC20-21_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC21-22(empty)_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC22-23_avg_equity.xls
+│   │   │   ├── 1HRMRSS_MCS1000_UTC23-24(empty)_avg_equity.xls
+│   │   │   └── 1HRMRSS_MCS1000_UTC24-00(empty)_avg_equity.xls
+│   │   ├── Drafts/
+│   │   │   ├── (Draft) SwingHHLLbreakout strategy.ipynb
+│   │   │   ├── 89RS.ipynb
+│   │   │   ├── draft too.ipynb
+│   │   │   ├── Research2.1.ipynb
+│   │   │   └── Research2.ipynb
+│   │   ├── Notebooks/
+│   │   │   ├── 1HRMRSS_MCS1000_UTC00-01.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC01-02.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC02-03.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC03-04.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC04-05.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC05-06.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC06-07.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC07-08.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC08-09.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC09-10.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC10-11.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC11-12.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC12-13.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC13-14.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC14-15.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC15-16.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC16-17.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC17-18.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC18-19.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC19-20.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC20-21.ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC21-22(empty).ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC22-23(empty).ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC23-24(empty).ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTC24-00(empty).ipynb
+│   │   │   ├── 1HRMRSS_MCS1000_UTCTotal_avg_equity.ipynb
+│   │   │   └── note
+│   │   ├── Performance img/
+│   │   │   ├── 1HRMRSS_MCS1000_ProfitabilityPerformance.png
+│   │   │   ├── 1HRMRSS_MCS1000_profitableEquityCurves.png
+│   │   │   ├── 1HRMRSS_MCS1000_TradesPerformance.png
+│   │   │   ├── 1HRMRSS_MCS1000_unprofitableEquityCurves.png
+│   │   │   ├── 3D performance draft.ipynb
+│   │   │   ├── 3D performance draft1.ipynb
+│   │   │   ├── avg_00-01.png
+│   │   │   ├── avg_01-02.png
+│   │   │   ├── avg_02-03.png
+│   │   │   ├── avg_03-04.png
+│   │   │   ├── avg_04-05.png
+│   │   │   ├── avg_05-06.png
+│   │   │   ├── avg_06-07.png
+│   │   │   ├── avg_07-08.png
+│   │   │   ├── avg_08-09.png
+│   │   │   ├── avg_09-10.png
+│   │   │   ├── avg_10-11.png
+│   │   │   ├── avg_11-12.png
+│   │   │   ├── avg_12-13.png
+��   │   │   ├── avg_13-14.png
+│   │   │   ├── avg_14-15.png
+│   │   │   ├── avg_15-16.png
+│   │   │   ├── avg_16-17.png
+│   │   │   ├── avg_17-18.png
+│   │   │   ├── avg_18-19.png
+│   │   │   ├── avg_19-20.png
+│   │   │   ├── avg_20-21.png
+│   │   │   ├── avg_21-22(empty).png
+│   │   │   ├── avg_22-23(empty).png
+│   │   │   ├── avg_23-24(empty).png
+│   │   │   ├── avg_24-00(empty).png
+│   │   │   ├── avg_total.png
+│   │   │   └── overview.png
+│   │   └── The 1HRMRSS.rp1.pdf
+│   ├── The 1SSHSHFT.rp1_  Is Simultaneous Stopout Hedging Strategy,  a High Frequency Trading, an Edge in Retail Level Application_/
+│   │   ├── Codes/
+│   │   │   ├── Demo script..c++
+│   │   │   └── Live script.c++
+│   │   └── The 1SSHSHFT_rp1.pdf
+│   ├── The 3HTMOSDSDT.rp1_ Three-hour Timeframe Market Order Strategy with Defined Stoploss and Dynamic Takeprofit/
+│   │   ├── 3HTMOSDSDT.rp1.ipynb
+│   │   ├── 3HTMOSDSDT_rp1.pdf
+│   │   ├── newplot (21).png
+│   │   ├── newplot (22).png
+│   │   ├── newplot (23).png
+│   │   ├── newplot (24).png
+│   │   ├── newplot (25).png
+│   │   └── newplot (26).png
+│   ├── The 3HTMOSDSDT.rp2 _ Portfolio Diversification for ’Three-hour Timeframe Market Order Strategy with Defined Stoploss and Dynamic Takeprofit’ Trading Model/
+│   │   ├── codes/
+│   │   │   ├── 0-3 Range Hedge minimum distance required.c++
+│   │   │   ├── 0-3Range Hedge.c++
+│   │   │   ├── Diversification 0-3 range hedging minimum.c++
+│   │   │   └── Diversiofication 28 pairs.c++
+│   │   └── 3HTMOSDSDT_rp2.pdf
+│   ├── The 3mTSHSUHC.rp1_ Design and Optimization of Three-minute Timeframe Stoporder Hedging Strategy Using Heatmap Candles/
+│   │   ├── 3mTSHSUHC.rp1.pdf
+│   │   └── Design and Optimization of 3mTSHSUHCv1.ipynb
+│   ├── The 3mTSHSUHC.rp2_ Stress Test & Evaluating the Three-minute Timeframe Stoporder Hedging Strategy Using Heatmap Candles/
+│   │   ├── Draft/
+│   │   │   └── The longest error in my career.ipynb
+│   │   ├── 3mTSHSUHC.rp2.pdf
+│   │   ├── Equity Curve of  3mTSHSUHCv1’s Performance.png
+│   │   ├── Heatmap Candles Chart with Trade Executions.png
+│   │   ├── Intraday data set with Heatmap Candles Chart.png
+│   │   └── The 3mTSHSUHC.rp2, stress test .ipynb
+│   └── The 3mTSHSUHC.rp3 _ Metric Threshold and Minimum Bars Apart Analysis of Three-minute Timeframe Stoporder Hedging Strategy Using Heatmap Candles/
+│       ├── Draft/
+│       │   ├── draft1.ipynb
+│       │   ├── this is it.ipynb
+│       │   └── weighted score.ipynb
+│       ├── 3mTSHSUHC.rp3.pdf
+│       ├── FULL_TRADE_STATISTICS_DATAFRAME.xls
+│       ├── single backtest framework.ipynb
+│       ├── singlebactest draft&outlinie.ipynb
+│       ├── the 3d graphs plotting.ipynb
+│       ├── the five 3D graphs.ipynb
+│       └── TOP_10_PARAMETER_COMBINATIONS_BY_SCORE.xls
+├── z.Others/
+│   ├── z.Images Folder/
+│   │   ├── diagram-export-11-30-2025-10_57_09-AM.png
+│   │   ├── diagram-export-11-30-2025-11_12_54-AM.png
+│   │   ├── pasted-image (1).png
+│   │   ├── pasted-image (11).png
+│   │   ├── pasted-image (12).png
+│   │   ├── pasted-image (15).png
+│   │   ├── pasted-image (2).png
+│   │   ├── pasted-image (3).png
+│   │   ├── pasted-image (4).png
+│   │   ├── pasted-image (6).png
+│   │   ├── pasted-image (7) (1).png
+│   │   ├── pasted-image (8).png
+│   │   ├── pasted-image (9).png
+│   │   ├── pasted-image.png
+│   │   ├── Screenshot 2025-11-12 102519.png
+│   │   ├── Screenshot 2025-11-12 104458.png
+│   │   ├── Screenshot 2025-11-12 105920.png
+│   │   ├── Screenshot 2025-11-12 144500.png
+│   │   ├── Screenshot 2025-11-12 201257.png
+│   │   ├── Screenshot 2025-11-12 205738.png
+│   │   ├── Screenshot 2025-11-15 131419.png
+│   │   ├── Screenshot 2025-11-15 132923.png
+│   │   ├── Screenshot 2025-11-15 135957.png
+│   │   ├── Screenshot 2025-11-15 153904.png
+│   │   ├── Screenshot 2025-11-15 160104.png
+│   │   ├── Screenshot 2025-11-15 162112.png
+│   │   ├── Screenshot 2025-11-15 162726.png
+│   │   ├── Screenshot 2025-11-15 164303.png
+│   │   ├── Screenshot 2025-11-15 182205.png
+│   │   ├── Screenshot 2025-11-15 184043.png
+│   │   ├── Screenshot_20251121_083916_Sheets.png
+│   │   ├── Screenshot_20251205_102855_Docs.png
+│   │   ├── XAUUSD_2025-11-11_21-11-52.png
+│   │   └── XAUUSDc_2025-11-12_10-02-56.png
+│   ├── APA Style (7th Edition).md
+│   ├── test.txt
+│   ├── Understanding GitHub Licenses.md
+│   ├── VTR_DMag_System_Explanation.md
+│   └── WQ Wildmind Quasars’s standard research paper layout.ipynb
+├── .gitattributes
+├── gg.md
+├── LICENSE
+├── README.md
+├── scan_structure.py
+├── scan_techstack.py
+└── STACKS.md
+```

example_output/TECHSTACK.md

@@ -0,0 +1,27 @@
+## Techstack
+
+Audit of **QRAT2025** project files (excluding environment and cache):
+
+| File Type | Count | Size (KB) |
+| :--- | :--- | :--- |
+| Jupyter Notebook (.ipynb) | 163 | 353,640.7 |
+| PNG Image (.png) | 144 | 13,796.6 |
+| HTML (.html) | 47 | 76,265.7 |
+| Microsoft Excel (.xls) | 31 | 6,514.8 |
+| C++ (.c++) | 10 | 98.8 |
+| Plain Text (.txt) | 10 | 1.1 |
+| PDF (.pdf) | 9 | 14,597.1 |
+| MQL5 Source (.mq5) | 8 | 72.8 |
+| Markdown (.md) | 7 | 61.5 |
+| Python (.py) | 7 | 247.9 |
+| JavaScript (.js) | 6 | 121.7 |
+| (no extension) | 3 | 1.1 |
+| MT Parameter Set (.set) | 2 | 0.4 |
+| Windows Shortcut (.lnk) | 2 | 2.4 |
+| CSV (.csv) | 1 | 83.9 |
+| Microsoft Excel (OOXML) (.xlsx) | 1 | 55.3 |
+| Microsoft Word (.doc) | 1 | 2.5 |
+| MQL Source (.mql) | 1 | 5.4 |
+| MQL5 Compiled (.ex5) | 1 | 25.9 |
+| MQL5 Variant (.mw5) | 1 | 9.5 |
+| **Total** | **455** | **465,605.1** |

scan_structure.py

@@ -0,0 +1,156 @@
+"""
+Repository Structure Scanner
+=============================
+Scans the entire file structure of a repository and outputs a tree-like
+Markdown representation. Handles massive (1GB+) repositories efficiently.
+
+Usage:
+    python scan_structure.py [path] [--output FILE] [--ignore PATTERN ...]
+
+Output:
+    A Markdown file containing the full directory tree.
+"""
+
+import os
+import sys
+import argparse
+import subprocess
+from pathlib import Path
+from collections import defaultdict
+
+
+# ---------------------------------------------------------------------------
+# Default ignore patterns (common non-source dirs / files)
+# ---------------------------------------------------------------------------
+DEFAULT_IGNORE = {
+    ".git",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "env",
+    "node_modules",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".tox",
+    ".eggs",
+    "*.egg-info",
+    ".DS_Store",
+    "Thumbs.db",
+    "desktop.ini",
+}
+
+
+def should_ignore(name: str, ignore_set: set) -> bool:
+    """Return True if *name* matches any pattern in the ignore set."""
+    if name in ignore_set:
+        return True
+    for pattern in ignore_set:
+        if pattern.startswith("*") and name.endswith(pattern[1:]):
+            return True
+    return False
+
+
+def build_tree(root_path: str, ignore_set: set) -> list[str]:
+    """
+    Walk *root_path* depth-first and return a list of tree-formatted lines.
+
+    Uses ``os.scandir`` for performance on large filesystems and sorts
+    entries alphabetically (directories first).
+    """
+
+    lines: list[str] = []
+
+    def _walk(current: str, prefix: str) -> None:
+        try:
+            entries = sorted(
+                os.scandir(current),
+                key=lambda e: (not e.is_dir(follow_symlinks=False), e.name.lower()),
+            )
+        except PermissionError:
+            return
+
+        # Filter out ignored entries
+        entries = [e for e in entries if not should_ignore(e.name, ignore_set)]
+
+        for idx, entry in enumerate(entries):
+            is_last = idx == len(entries) - 1
+            connector = "└── " if is_last else "├── "
+            suffix = "/" if entry.is_dir(follow_symlinks=False) else ""
+            lines.append(f"{prefix}{connector}{entry.name}{suffix}")
+
+            if entry.is_dir(follow_symlinks=False):
+                extension = "    " if is_last else "│   "
+                _walk(entry.path, prefix + extension)
+
+    _walk(root_path, "")
+    return lines
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Scan repository file structure and output a Markdown tree."
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Root directory to scan (default: current directory).",
+    )
+    parser.add_argument(
+        "--output",
+        "-o",
+        default=None,
+        help="Output Markdown file path (default: STRUCTURE.md in scanned dir).",
+    )
+    parser.add_argument(
+        "--ignore",
+        nargs="*",
+        default=None,
+        help="Extra patterns to ignore (added to built-in defaults).",
+    )
+    parser.add_argument(
+        "--no-default-ignore",
+        action="store_true",
+        help="Disable the built-in ignore list (scan everything).",
+    )
+    args = parser.parse_args()
+
+    root = os.path.abspath(args.path)
+    root_name = os.path.basename(root)
+
+    # Build ignore set
+    ignore_set: set = set() if args.no_default_ignore else set(DEFAULT_IGNORE)
+    if args.ignore:
+        ignore_set.update(args.ignore)
+
+    # Always ignore the output file itself to avoid self-referencing
+    out_path = args.output or os.path.join(root, "STRUCTURE.md")
+    out_name = os.path.basename(out_path)
+    ignore_set.add(out_name)
+
+    print(f"Scanning: {root}")
+    print(f"Ignoring: {', '.join(sorted(ignore_set))}")
+
+    tree_lines = build_tree(root, ignore_set)
+
+    # Compose Markdown content
+    md_lines = [
+        f"## Project Structure\n",
+        f"```text",
+        f"{root_name}/",
+    ]
+    md_lines.extend(tree_lines)
+    md_lines.append("```\n")
+
+    content = "\n".join(md_lines)
+
+    with open(out_path, "w", encoding="utf-8") as fh:
+        fh.write(content)
+
+    total_entries = len(tree_lines)
+    print(f"Done – {total_entries} entries written to {out_path}")
+
+
+if __name__ == "__main__":
+    main()

scan_techstack.py

@@ -0,0 +1,750 @@
+"""
+Repository Tech-Stack Scanner
+===============================
+Scans a repository and produces a Markdown table of file types with counts
+and total sizes in KB.  Supports every file extension in existence.
+
+Usage:
+    python scan_techstack.py [path] [--output FILE] [--ignore PATTERN ...]
+                             [--exclude-ext EXT ...] [--sort count|size|ext]
+
+Output:
+    A Markdown file containing the tech-stack audit table.
+"""
+
+import os
+import sys
+import argparse
+from pathlib import Path
+from collections import defaultdict
+
+
+# ---------------------------------------------------------------------------
+# Comprehensive file-extension → human-readable label mapping
+# Covers programming, data, document, media, archive, config, and more.
+# Any extension NOT in this dict will be auto-labelled from the extension.
+# ---------------------------------------------------------------------------
+EXT_LABELS: dict[str, str] = {
+    # ── Programming Languages ──────────────────────────────────────────
+    ".py":       "Python",
+    ".pyw":      "Python (windowed)",
+    ".pyx":      "Cython",
+    ".pxd":      "Cython Definition",
+    ".pyi":      "Python Stub",
+    ".pyc":      "Python Compiled",
+    ".pyo":      "Python Optimized",
+    ".js":       "JavaScript",
+    ".mjs":      "ES Module JavaScript",
+    ".cjs":      "CommonJS JavaScript",
+    ".jsx":      "JSX (React)",
+    ".ts":       "TypeScript",
+    ".tsx":      "TSX (React)",
+    ".java":     "Java",
+    ".class":    "Java Class",
+    ".jar":      "Java Archive",
+    ".kt":       "Kotlin",
+    ".kts":      "Kotlin Script",
+    ".scala":    "Scala",
+    ".groovy":   "Groovy",
+    ".c":        "C",
+    ".h":        "C Header",
+    ".cpp":      "C++",
+    ".cxx":      "C++",
+    ".cc":       "C++",
+    ".c++":      "C++",
+    ".hpp":      "C++ Header",
+    ".hxx":      "C++ Header",
+    ".hh":       "C++ Header",
+    ".h++":      "C++ Header",
+    ".cs":       "C#",
+    ".csx":      "C# Script",
+    ".fs":       "F#",
+    ".fsx":      "F# Script",
+    ".fsi":      "F# Signature",
+    ".vb":       "Visual Basic",
+    ".vbs":      "VBScript",
+    ".go":       "Go",
+    ".rs":       "Rust",
+    ".rb":       "Ruby",
+    ".erb":      "Embedded Ruby",
+    ".php":      "PHP",
+    ".pl":       "Perl",
+    ".pm":       "Perl Module",
+    ".lua":      "Lua",
+    ".r":        "R",
+    ".rmd":      "R Markdown",
+    ".swift":    "Swift",
+    ".m":        "Objective-C / MATLAB",
+    ".mm":       "Objective-C++",
+    ".d":        "D",
+    ".dart":     "Dart",
+    ".ex":       "Elixir",
+    ".exs":      "Elixir Script",
+    ".erl":      "Erlang",
+    ".hrl":      "Erlang Header",
+    ".hs":       "Haskell",
+    ".lhs":      "Literate Haskell",
+    ".ml":       "OCaml",
+    ".mli":      "OCaml Interface",
+    ".clj":      "Clojure",
+    ".cljs":     "ClojureScript",
+    ".cljc":     "Clojure Common",
+    ".edn":      "EDN (Clojure)",
+    ".lisp":     "Common Lisp",
+    ".cl":       "Common Lisp",
+    ".el":       "Emacs Lisp",
+    ".scm":      "Scheme",
+    ".rkt":      "Racket",
+    ".nim":      "Nim",
+    ".zig":      "Zig",
+    ".v":        "V / Verilog",
+    ".vhd":      "VHDL",
+    ".vhdl":     "VHDL",
+    ".sv":       "SystemVerilog",
+    ".asm":      "Assembly",
+    ".s":        "Assembly",
+    ".f":        "Fortran",
+    ".f90":      "Fortran 90",
+    ".f95":      "Fortran 95",
+    ".f03":      "Fortran 2003",
+    ".f08":      "Fortran 2008",
+    ".for":      "Fortran",
+    ".cob":      "COBOL",
+    ".cbl":      "COBOL",
+    ".pas":      "Pascal",
+    ".pp":       "Pascal",
+    ".ada":      "Ada",
+    ".adb":      "Ada Body",
+    ".ads":      "Ada Spec",
+    ".tcl":      "Tcl",
+    ".tk":       "Tcl/Tk",
+    ".awk":      "AWK",
+    ".sed":      "sed",
+    ".jl":       "Julia",
+    ".cr":       "Crystal",
+    ".hack":     "Hack",
+    ".hx":       "Haxe",
+    ".hxml":     "Haxe XML",
+    ".purs":     "PureScript",
+    ".idr":      "Idris",
+    ".agda":     "Agda",
+    ".lean":     "Lean",
+    ".coq":      "Coq",
+    ".thy":      "Isabelle",
+    ".pro":      "Prolog",
+    ".sml":      "Standard ML",
+    ".fig":      "MATLAB Figure",
+    ".mat":      "MATLAB Data",
+
+    # ── Shell / Scripting ──────────────────────────────────────────────
+    ".sh":       "Shell Script",
+    ".bash":     "Bash Script",
+    ".zsh":      "Zsh Script",
+    ".fish":     "Fish Script",
+    ".bat":      "Batch File",
+    ".cmd":      "Windows Command",
+    ".ps1":      "PowerShell",
+    ".psm1":     "PowerShell Module",
+    ".psd1":     "PowerShell Data",
+
+    # ── Web / Markup / Templating ──────��───────────────────────────────
+    ".html":     "HTML",
+    ".htm":      "HTML",
+    ".xhtml":    "XHTML",
+    ".css":      "CSS",
+    ".scss":     "SCSS",
+    ".sass":     "Sass",
+    ".less":     "Less",
+    ".styl":     "Stylus",
+    ".vue":      "Vue",
+    ".svelte":   "Svelte",
+    ".astro":    "Astro",
+    ".ejs":      "EJS Template",
+    ".pug":      "Pug Template",
+    ".jade":     "Jade Template",
+    ".hbs":      "Handlebars",
+    ".mustache": "Mustache",
+    ".twig":     "Twig Template",
+    ".jinja":    "Jinja Template",
+    ".jinja2":   "Jinja2 Template",
+    ".j2":       "Jinja2 Template",
+    ".njk":      "Nunjucks Template",
+    ".liquid":   "Liquid Template",
+    ".haml":     "HAML",
+    ".slim":     "Slim Template",
+    ".blade.php":"Blade Template",
+    ".jsp":      "JavaServer Pages",
+    ".asp":      "ASP",
+    ".aspx":     "ASP.NET",
+    ".cshtml":   "Razor (C#)",
+    ".razor":    "Razor",
+    ".wasm":     "WebAssembly",
+
+    # ── Data / Config / Serialisation ──────────────────────────────────
+    ".json":     "JSON",
+    ".jsonl":    "JSON Lines",
+    ".json5":    "JSON5",
+    ".geojson":  "GeoJSON",
+    ".xml":      "XML",
+    ".xsl":      "XSLT",
+    ".xslt":     "XSLT",
+    ".xsd":      "XML Schema",
+    ".dtd":      "Document Type Definition",
+    ".yaml":     "YAML",
+    ".yml":      "YAML",
+    ".toml":     "TOML",
+    ".ini":      "INI Config",
+    ".cfg":      "Config",
+    ".conf":     "Config",
+    ".env":      "Environment File",
+    ".properties": "Properties File",
+    ".csv":      "CSV",
+    ".tsv":      "TSV",
+    ".parquet":  "Apache Parquet",
+    ".avro":     "Apache Avro",
+    ".orc":      "Apache ORC",
+    ".feather":  "Feather (Arrow)",
+    ".arrow":    "Apache Arrow",
+    ".msgpack":  "MessagePack",
+    ".bson":     "BSON",
+    ".cbor":     "CBOR",
+    ".protobuf": "Protocol Buffer",
+    ".proto":    "Protocol Buffer Schema",
+    ".thrift":   "Apache Thrift",
+    ".hcl":      "HCL (Terraform)",
+    ".tf":       "Terraform",
+    ".tfvars":   "Terraform Variables",
+    ".pkl":      "Pickle",
+    ".pickle":   "Pickle",
+    ".npy":      "NumPy Array",
+    ".npz":      "NumPy Archive",
+    ".h5":       "HDF5",
+    ".hdf5":     "HDF5",
+    ".nc":       "NetCDF",
+    ".sqlite":   "SQLite Database",
+    ".sqlite3":  "SQLite Database",
+    ".db":       "Database",
+    ".dbf":      "dBASE",
+    ".mdb":      "Access Database",
+    ".accdb":    "Access Database",
+    ".lmdb":     "LMDB",
+    ".leveldb":  "LevelDB",
+
+    # ── Documents & Office ─────────────────────────────────────────────
+    ".md":       "Markdown",
+    ".mdx":      "MDX",
+    ".txt":      "Plain Text",
+    ".text":     "Plain Text",
+    ".log":      "Log File",
+    ".rst":      "reStructuredText",
+    ".adoc":     "AsciiDoc",
+    ".org":      "Org Mode",
+    ".tex":      "LaTeX",
+    ".latex":    "LaTeX",
+    ".bib":      "BibTeX",
+    ".rtf":      "Rich Text Format",
+    ".doc":      "Microsoft Word",
+    ".docx":     "Microsoft Word (OOXML)",
+    ".odt":      "OpenDocument Text",
+    ".pdf":      "PDF",
+    ".xls":      "Microsoft Excel",
+    ".xlsx":     "Microsoft Excel (OOXML)",
+    ".xlsm":     "Excel Macro-Enabled",
+    ".xlsb":     "Excel Binary",
+    ".ods":      "OpenDocument Spreadsheet",
+    ".ppt":      "Microsoft PowerPoint",
+    ".pptx":     "Microsoft PowerPoint (OOXML)",
+    ".odp":      "OpenDocument Presentation",
+    ".pages":    "Apple Pages",
+    ".numbers":  "Apple Numbers",
+    ".key":      "Apple Keynote",
+    ".epub":     "EPUB",
+    ".mobi":     "Mobipocket",
+    ".djvu":     "DjVu",
+    ".chm":      "Compiled HTML Help",
+    ".man":      "Man Page",
+    ".info":     "GNU Info",
+
+    # ── Notebooks & Data Science ───────────────────────────────────────
+    ".ipynb":    "Jupyter Notebook",
+    ".rmd":      "R Markdown",
+    ".qmd":      "Quarto Document",
+    ".dvc":      "DVC File",
+    ".onnx":     "ONNX Model",
+    ".pt":       "PyTorch Model",
+    ".pth":      "PyTorch Checkpoint",
+    ".safetensors": "SafeTensors Model",
+    ".gguf":     "GGUF Model",
+    ".bin":      "Binary File",
+
+    # ── Images ─────────────────────────────────────────────────────────
+    ".png":      "PNG Image",
+    ".jpg":      "JPEG Image",
+    ".jpeg":     "JPEG Image",
+    ".gif":      "GIF Image",
+    ".bmp":      "Bitmap Image",
+    ".tiff":     "TIFF Image",
+    ".tif":      "TIFF Image",
+    ".webp":     "WebP Image",
+    ".avif":     "AVIF Image",
+    ".heic":     "HEIC Image",
+    ".heif":     "HEIF Image",
+    ".svg":      "SVG Image",
+    ".ico":      "Icon",
+    ".icns":     "Apple Icon",
+    ".cur":      "Cursor",
+    ".psd":      "Photoshop",
+    ".ai":       "Adobe Illustrator",
+    ".sketch":   "Sketch",
+    ".fig":      "Figma",
+    ".xd":       "Adobe XD",
+    ".eps":      "EPS Vector",
+    ".raw":      "RAW Image",
+    ".cr2":      "Canon RAW",
+    ".nef":      "Nikon RAW",
+    ".arw":      "Sony RAW",
+    ".dng":      "DNG RAW",
+    ".exr":      "OpenEXR",
+    ".hdr":      "HDR Image",
+    ".pbm":      "PBM Image",
+    ".pgm":      "PGM Image",
+    ".ppm":      "PPM Image",
+    ".pcx":      "PCX Image",
+    ".tga":      "TGA Image",
+
+    # ── Audio ──────────────────────────────────────────────────────────
+    ".mp3":      "MP3 Audio",
+    ".wav":      "WAV Audio",
+    ".flac":     "FLAC Audio",
+    ".aac":      "AAC Audio",
+    ".ogg":      "Ogg Audio",
+    ".wma":      "WMA Audio",
+    ".m4a":      "M4A Audio",
+    ".opus":     "Opus Audio",
+    ".aiff":     "AIFF Audio",
+    ".mid":      "MIDI",
+    ".midi":     "MIDI",
+    ".amr":      "AMR Audio",
+    ".ape":      "APE Audio",
+    ".alac":     "ALAC Audio",
+
+    # ── Video ──────────────────────────────────────────────────────────
+    ".mp4":      "MP4 Video",
+    ".mkv":      "MKV Video",
+    ".avi":      "AVI Video",
+    ".mov":      "QuickTime Video",
+    ".wmv":      "WMV Video",
+    ".flv":      "Flash Video",
+    ".webm":     "WebM Video",
+    ".m4v":      "M4V Video",
+    ".mpg":      "MPEG Video",
+    ".mpeg":     "MPEG Video",
+    ".3gp":      "3GP Video",
+    ".ogv":      "Ogg Video",
+    ".ts":       "MPEG-TS",
+    ".vob":      "DVD Video",
+    ".rm":       "RealMedia",
+
+    # ── Fonts ──────────────────────────────────────────────────────────
+    ".ttf":      "TrueType Font",
+    ".otf":      "OpenType Font",
+    ".woff":     "WOFF Font",
+    ".woff2":    "WOFF2 Font",
+    ".eot":      "EOT Font",
+    ".fon":      "Bitmap Font",
+
+    # ── Archives / Compression ─────────────────────────────────────────
+    ".zip":      "ZIP Archive",
+    ".gz":       "Gzip Archive",
+    ".gzip":     "Gzip Archive",
+    ".bz2":      "Bzip2 Archive",
+    ".xz":       "XZ Archive",
+    ".lz":       "Lzip Archive",
+    ".lzma":     "LZMA Archive",
+    ".zst":      "Zstandard Archive",
+    ".tar":      "Tar Archive",
+    ".tgz":      "Tar+Gzip Archive",
+    ".tbz2":     "Tar+Bzip2 Archive",
+    ".txz":      "Tar+XZ Archive",
+    ".rar":      "RAR Archive",
+    ".7z":       "7-Zip Archive",
+    ".cab":      "Cabinet Archive",
+    ".iso":      "ISO Disk Image",
+    ".dmg":      "macOS Disk Image",
+    ".img":      "Disk Image",
+    ".vhd":      "Virtual Hard Disk",
+    ".vhdx":     "Virtual Hard Disk (VHDX)",
+    ".vmdk":     "VMware Disk",
+    ".qcow2":    "QEMU Disk",
+    ".deb":      "Debian Package",
+    ".rpm":      "RPM Package",
+    ".apk":      "Android Package",
+    ".ipa":      "iOS App",
+    ".snap":     "Snap Package",
+    ".flatpak":  "Flatpak Package",
+    ".appimage": "AppImage",
+    ".msi":      "MSI Installer",
+    ".exe":      "Windows Executable",
+    ".dll":      "DLL Library",
+    ".so":       "Shared Object",
+    ".dylib":    "macOS Dynamic Library",
+    ".a":        "Static Library",
+    ".lib":      "Library",
+    ".o":        "Object File",
+    ".obj":      "Object File",
+    ".sys":      "System File",
+    ".drv":      "Driver",
+
+    # ── DevOps / CI / Containerisation ─────────────────────────────────
+    ".dockerfile":"Dockerfile",
+    ".vagrantfile":"Vagrantfile",
+    ".jenkinsfile":"Jenkinsfile",
+
+    # ── Trading / Domain-specific ──────────────────────────────────────
+    ".mq5":      "MQL5 Source",
+    ".mq4":      "MQL4 Source",
+    ".mqh":      "MQL Header",
+    ".ex5":      "MQL5 Compiled",
+    ".ex4":      "MQL4 Compiled",
+    ".set":      "MT Parameter Set",
+    ".pine":     "Pine Script",
+    ".tpl":      "MT Template",
+    ".chr":      "MT Chart",
+    ".mql":      "MQL Source",
+
+    # ── Misc / Build / Project ─────────────────────────────────────────
+    ".makefile": "Makefile",
+    ".cmake":    "CMake",
+    ".gradle":   "Gradle",
+    ".sbt":      "SBT Build",
+    ".gemspec":  "Ruby Gem Spec",
+    ".podspec":  "CocoaPods Spec",
+    ".cabal":    "Cabal (Haskell)",
+    ".csproj":   "C# Project",
+    ".fsproj":   "F# Project",
+    ".vbproj":   "VB.NET Project",
+    ".sln":      "Visual Studio Solution",
+    ".xcodeproj":"Xcode Project",
+    ".pbxproj":  "Xcode Project (PBX)",
+    ".xcworkspace":"Xcode Workspace",
+    ".plist":    "Property List",
+    ".lnk":      "Windows Shortcut",
+    ".url":      "URL Shortcut",
+    ".desktop":  "Desktop Entry",
+    ".reg":      "Windows Registry",
+    ".service":  "Systemd Service",
+    ".timer":    "Systemd Timer",
+    ".socket":   "Systemd Socket",
+    ".lock":     "Lock File",
+    ".patch":    "Patch File",
+    ".diff":     "Diff File",
+    ".map":      "Source Map",
+    ".whl":      "Python Wheel",
+    ".egg":      "Python Egg",
+    ".gem":      "Ruby Gem",
+    ".nupkg":    "NuGet Package",
+    ".crate":    "Rust Crate",
+
+    # ── SQL / Database ─────────────────────────────────────────────────
+    ".sql":      "SQL",
+    ".mysql":    "MySQL",
+    ".pgsql":    "PostgreSQL",
+    ".plsql":    "PL/SQL",
+
+    # ── GraphQL / API ──────────────────────────────────────────────────
+    ".graphql":  "GraphQL",
+    ".gql":      "GraphQL",
+    ".swagger":  "Swagger",
+    ".openapi":  "OpenAPI Spec",
+
+    # ── 3D / CAD / GIS ─────────────────────────────────────────────────
+    ".stl":      "STL 3D Model",
+    ".obj":      "Wavefront OBJ",
+    ".fbx":      "FBX 3D Model",
+    ".gltf":     "glTF 3D Model",
+    ".glb":      "glTF Binary",
+    ".blend":    "Blender File",
+    ".3ds":      "3DS Model",
+    ".dae":      "Collada",
+    ".usd":      "USD Scene",
+    ".usda":     "USD ASCII",
+    ".usdc":     "USD Binary",
+    ".step":     "STEP CAD",
+    ".stp":      "STEP CAD",
+    ".iges":     "IGES CAD",
+    ".igs":      "IGES CAD",
+    ".dwg":      "AutoCAD Drawing",
+    ".dxf":      "AutoCAD Exchange",
+    ".shp":      "Shapefile",
+    ".kml":      "KML",
+    ".kmz":      "KMZ",
+    ".gpx":      "GPX Track",
+
+    # ── Certificates / Security ────────────────────────────────────────
+    ".pem":      "PEM Certificate",
+    ".crt":      "Certificate",
+    ".cer":      "Certificate",
+    ".csr":      "Certificate Request",
+    ".p12":      "PKCS#12",
+    ".pfx":      "PKCS#12",
+    ".asc":      "PGP/GPG",
+    ".gpg":      "GPG Encrypted",
+    ".sig":      "Signature",
+    ".pub":      "Public Key",
+
+    # ── Git-related ────────────────────────────────────────────────────
+    ".gitignore":     "Git Ignore",
+    ".gitattributes": "Git Attributes",
+    ".gitmodules":    "Git Submodules",
+
+    # ── Editor / IDE Config ────────────────────────────────────────────
+    ".editorconfig": "EditorConfig",
+    ".prettierrc":   "Prettier Config",
+    ".eslintrc":     "ESLint Config",
+    ".stylelintrc":  "Stylelint Config",
+    ".babelrc":      "Babel Config",
+    ".swcrc":        "SWC Config",
+    ".nvmrc":        "NVM Config",
+    ".npmrc":        "NPM Config",
+    ".yarnrc":       "Yarn Config",
+
+    # ── Misc ───────────────────────────────────────────────────────────
+    ".mw5":      "MQL5 Variant",
+    ".webmanifest": "Web App Manifest",
+}
+
+
+# ---------------------------------------------------------------------------
+# Default ignore patterns (common non-source dirs / files)
+# ---------------------------------------------------------------------------
+DEFAULT_IGNORE = {
+    ".git",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "env",
+    "node_modules",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".tox",
+    ".eggs",
+    "*.egg-info",
+    ".DS_Store",
+    "Thumbs.db",
+    "desktop.ini",
+}
+
+
+def should_ignore(name: str, ignore_set: set) -> bool:
+    """Return True if *name* matches any pattern in the ignore set."""
+    if name in ignore_set:
+        return True
+    for pattern in ignore_set:
+        if pattern.startswith("*") and name.endswith(pattern[1:]):
+            return True
+    return False
+
+
+def get_label(ext: str) -> str:
+    """Return the human-readable label for an extension."""
+    if ext in EXT_LABELS:
+        return EXT_LABELS[ext]
+    # Fallback: capitalise the extension name
+    return ext.upper().lstrip(".")
+
+
+def scan_files(root_path: str, ignore_set: set, exclude_exts: set) -> dict:
+    """
+    Walk *root_path* and collect per-extension statistics.
+
+    Returns a dict keyed by normalised extension string, e.g. ".py",
+    with values ``{"count": int, "size_bytes": int, "label": str}``.
+
+    Files without an extension are grouped under "(no extension)".
+    """
+
+    stats: dict = defaultdict(lambda: {"count": 0, "size_bytes": 0, "label": ""})
+
+    for dirpath, dirnames, filenames in os.walk(root_path):
+        # Prune ignored directories in-place so os.walk skips them
+        dirnames[:] = [
+            d for d in dirnames if not should_ignore(d, ignore_set)
+        ]
+
+        for fname in filenames:
+            if should_ignore(fname, ignore_set):
+                continue
+
+            filepath = os.path.join(dirpath, fname)
+
+            # Determine extension
+            _, ext = os.path.splitext(fname)
+            ext = ext.lower()  # normalise
+
+            if ext and ext.lstrip(".") in exclude_exts:
+                continue
+
+            # Label
+            if ext:
+                label = f"{get_label(ext)} ({ext})"
+            else:
+                ext = "(none)"
+                label = "(no extension)"
+
+            try:
+                size = os.path.getsize(filepath)
+            except (OSError, PermissionError):
+                size = 0
+
+            stats[ext]["count"] += 1
+            stats[ext]["size_bytes"] += size
+            stats[ext]["label"] = label
+
+    return dict(stats)
+
+
+def format_size_kb(size_bytes: int) -> str:
+    """Return exact size in KB, rounded to 1 decimal place."""
+    kb = size_bytes / 1024
+    if kb == 0:
+        return "0"
+    # Show 1 decimal place for precision, strip trailing zero if whole number
+    formatted = f"{kb:,.1f}"
+    return formatted
+
+
+def build_table(stats: dict, sort_by: str) -> list[str]:
+    """
+    Build a Markdown table from *stats*.
+
+    Returns a list of lines.
+    """
+
+    # Prepare rows
+    rows = []
+    total_count = 0
+    total_bytes = 0
+
+    for ext, data in stats.items():
+        rows.append(
+            {
+                "label": data["label"],
+                "count": data["count"],
+                "size_bytes": data["size_bytes"],
+                "ext_key": ext,
+            }
+        )
+        total_count += data["count"]
+        total_bytes += data["size_bytes"]
+
+    # Sort
+    if sort_by == "count":
+        rows.sort(key=lambda r: (-r["count"], r["label"].lower()))
+    elif sort_by == "size":
+        rows.sort(key=lambda r: (-r["size_bytes"], r["label"].lower()))
+    else:  # "ext"
+        rows.sort(key=lambda r: r["label"].lower())
+
+    # Build Markdown lines
+    lines = [
+        "| File Type | Count | Size (KB) |",
+        "| :--- | :--- | :--- |",
+    ]
+    for row in rows:
+        lines.append(
+            f"| {row['label']} | {row['count']} | {format_size_kb(row['size_bytes'])} |"
+        )
+
+    # Totals row
+    lines.append(f"| **Total** | **{total_count}** | **{format_size_kb(total_bytes)}** |")
+
+    return lines
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Audit repository tech-stack (file types, counts, sizes)."
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Root directory to scan (default: current directory).",
+    )
+    parser.add_argument(
+        "--output",
+        "-o",
+        default=None,
+        help="Output Markdown file path (default: TECHSTACK.md in scanned dir).",
+    )
+    parser.add_argument(
+        "--ignore",
+        nargs="*",
+        default=None,
+        help="Extra directory/file names to ignore.",
+    )
+    parser.add_argument(
+        "--no-default-ignore",
+        action="store_true",
+        help="Disable the built-in ignore list.",
+    )
+    parser.add_argument(
+        "--exclude-ext",
+        nargs="*",
+        default=None,
+        help="File extensions to exclude from output (without dot, e.g. png mp4 git).",
+    )
+    parser.add_argument(
+        "--sort",
+        choices=["count", "size", "ext"],
+        default="count",
+        help="Sort order for the table (default: count descending).",
+    )
+    args = parser.parse_args()
+
+    root = os.path.abspath(args.path)
+    root_name = os.path.basename(root)
+
+    # Build ignore set
+    ignore_set: set = set() if args.no_default_ignore else set(DEFAULT_IGNORE)
+    if args.ignore:
+        ignore_set.update(args.ignore)
+
+    # Always ignore the output file itself
+    out_path = args.output or os.path.join(root, "TECHSTACK.md")
+    out_name = os.path.basename(out_path)
+    ignore_set.add(out_name)
+
+    # Excluded extensions
+    exclude_exts: set = set()
+    if args.exclude_ext:
+        exclude_exts = {e.lower().lstrip(".") for e in args.exclude_ext}
+
+    print(f"Scanning: {root}")
+    print(f"Ignoring: {', '.join(sorted(ignore_set))}")
+    if exclude_exts:
+        print(f"Excluding extensions: {', '.join(sorted(exclude_exts))}")
+
+    stats = scan_files(root, ignore_set, exclude_exts)
+    table_lines = build_table(stats, sort_by=args.sort)
+
+    # Compose Markdown
+    md_lines = [
+        f"## Techstack\n",
+        f"Audit of **{root_name}** project files (excluding environment and cache):\n",
+    ]
+    md_lines.extend(table_lines)
+    md_lines.append("")  # trailing newline
+
+    content = "\n".join(md_lines)
+
+    with open(out_path, "w", encoding="utf-8") as fh:
+        fh.write(content)
+
+    total = sum(d["count"] for d in stats.values())
+    print(f"Done – {total} files across {len(stats)} types written to {out_path}")
+
+
+if __name__ == "__main__":
+    main()