---
type: JS Module
title: run-shellcheck.mjs
resource: npm/rules/text/js/run-shellcheck.mjs
docgen:
  crc: 6b2daaa8
  model: omlx/gemma-4-e4b-it-OptiQ-4bit
  score: 100
---

## Огляд

Скрипт забезпечує відповідність shell-скриптів стандартам, виконуючи дві послідовні дії: спочатку застосовує автоматичні виправлення для проблем, виявлених `shellcheck` за допомогою формату виводу `diff` та команди `patch -p1` у корені проєкту; потім проводить фінальну перевірку всіх зібраних файлів. Скрипт збирає всі відстежувані shell-скрипти у робочому дереві, ігноруючи директорії `node_modules`. Якщо скриптів не знайдено, процес завершується з кодом 0. Якщо `shellcheck` або `patch` відсутні у PATH, скрипт завершується з кодом 1, надаючи підказки для їх встановлення. Після циклу автовиправлень будь-яке попередження чи помилка від `shellcheck` призводить до ненульового коду виходу.

## Поведінка

listShellScriptPaths повертає відсортований масив відносних шляхів до shell-скриптів у проєкті, виключаючи директорії `node_modules`.
runShellcheckText запускає shellcheck: спочатку намагається автоматично виправити знайдені проблеми за допомогою `diff` та `patch`, а потім виконує фінальну перевірку всіх зібраних файлів.

## Публічний API

listShellScriptPaths — надає список шляхів до скриптів оболонки для перевірки.
runShellcheckText — виконує перевірку коду за допомогою shellcheck з автоматичним виправленням.

## Гарантії поведінки

- Read-only: не виконує операцій запису (ФС/БД).
- Свідомо пропускає шляхи: `node_modules`.
