StrixScripts/README.md

StrixScripts

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

За AI агенти, работещи в repo-то: виж 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:

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

Категории

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

• hello-world.sh — демонстрационен скрипт, показващ конвенцията за нов скрипт в repo-то.

HDD/

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

System/

• system-report.sh — събира моментно състояние на системата, като групира Ethernet, Wi-Fi и виртуалните интерфейси, и предлага отчет във формат TXT, JSON или HTML.