# 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/
│   └── system-report.sh    моментен системен отчет с TXT/JSON/HTML export
└── <категория>/             функционална група скриптове (предстои)
```

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

Всеки скрипт поддържа `--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/

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