# StrixScripts

Колекция от самостоятелни bash скриптове, организирани по функционални
папки. Всеки скрипт има собствена `.md` документация до себе си с пълно
описание, изисквания и примери.

За AI агенти, работещи в repo-то: виж [`AGENTS.md`](./AGENTS.md) за
задължителните конвенции при създаване на нов скрипт — структура,
`--help` поведение, shellcheck, документация.

## Структура

```
strixscripts/
├── lib/
│   └── common.sh          споделени helper функции (--help, error handling, logging)
├── templates/              шаблони за нов скрипт + неговия .md файл
├── examples/
│   └── hello-world.sh      работещ пример, демонстриращ пълната конвенция
├── HDD/
│   ├── repair-hdd.sh       презапис на диск и SMART extended self-test
│   └── erase-storage.sh    презапис на дял или Secure Erase/Sanitize на диск
├── System/
│   ├── network-diagnostic.sh подробна мрежова диагностика, топ 10 Wi-Fi мрежи и export
│   └── system-report.sh     моментен системен отчет с TXT/JSON/HTML export
├── Virtualisation/
│   └── virtualisation-check.sh проверка на инсталирани виртуализационни решения и инстанции
├── Web/
│   └── inspect-web-services.sh уеб сървъри, proxy, vhost и listeners на 80/443
└── <категория>/             функционална група скриптове (предстои)
```

## Как се използва скрипт

Всеки скрипт поддържа `--help`:

```bash
./<категория>/<script-name>.sh --help
```

## Категории

<!-- Всяка нова категория папка получава своя секция тук, с кратко
     описание на всеки скрипт в нея + link към пълната документация.
     Пълното описание живее в скрипт-специфичния .md, не тук. -->

### examples/ (референция, не production скриптове)

- [`hello-world.sh`](./examples/hello-world.md) — демонстрационен скрипт,
  показващ конвенцията за нов скрипт в repo-то.

### HDD/

- [`repair-hdd.sh`](./HDD/repair-hdd.md) — презаписва избран диск и
     изпълнява SMART extended self-test.
- [`erase-storage.sh`](./HDD/erase-storage.md) — презаписва дял с един проход
     или използва поддържан Secure Erase/Sanitize за цял диск.

### System/

- [`network-diagnostic.sh`](./System/network-diagnostic.md) — показва
     физическите интерфейси, топ десетте Wi-Fi мрежи и виртуалните интерфейси
     в този ред; поддържа TXT, JSON и HTML отчет.
- [`system-report.sh`](./System/system-report.md) — събира моментно състояние
     на системата, като групира Ethernet, Wi-Fi и виртуалните интерфейси, и
     предлага отчет във формат TXT, JSON или HTML.

### Virtualisation/

- [`virtualisation-check.sh`](./Virtualisation/virtualisation-check.md) — открива
     VM/container решения и отчита инсталираните и работещите им инстанции.

### Web/

- [`inspect-web-services.sh`](./Web/inspect-web-services.md) — открива web
     servers/reverse proxies, слушатели на портове 80/443 и Apache/Nginx vhosts.