@nitra/cursor 11.4.1 → 12.0.0

package/scripts/lib/docs/read-n-cursor-config-lite.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: read-n-cursor-config-lite.mjs
+resource: npm/scripts/lib/read-n-cursor-config-lite.mjs
 docgen:
-  source: npm/scripts/lib/read-n-cursor-config-lite.mjs
   crc: a5fb0592
 ---
 
-# read-n-cursor-config-lite.mjs
-
-## Огляд
-
 Цей файл читає файл `.n-cursor.json`, що містить список правил для конфігурації. Він повертає цей список, щоб `fix.mjs` міг використовувати правила для визначення конфігурації. Це забезпечує базове читання конфігурації правил для запуску `fix.mjs` з командного рядка.
 
 ## Поведінка

package/scripts/lib/docs/resolve-target-files.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: resolve-target-files.mjs
+resource: npm/scripts/lib/resolve-target-files.mjs
 docgen:
-  source: npm/scripts/lib/resolve-target-files.mjs
   crc: a3b361d9
 ---
 
-# resolve-target-files.mjs
-
-## Огляд
-
 Цей файл відповідає за перевірку наявності файлів, що відповідають певним правилам, вказаним у файлах `policy/<name>/target.json`. Він створює список файлів для подальшого використання, використовуючи або конкретні відносні шляхи, або обхід каталогу з використанням шаблонів та ігнорування файлів. Це забезпечує узгодженість та контроль над файлами, які потрібно обробити, відповідно до заданих політик.
 
 ## Поведінка

package/scripts/lib/docs/root-notice.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: root-notice.mjs
+resource: npm/scripts/lib/root-notice.mjs
 docgen:
-  source: npm/scripts/lib/root-notice.mjs
   crc: 5f3ca2bb
 ---
 
-# root-notice.mjs
-
-## Огляд
-
 Цей файл вставляє root-guard preflight для скілів, які змінюють проєкт у поточному каталозі. Він забезпечує, що скіл виконується in-place, без ізоляції worktree, і використовується для випадків, коли не потрібна ізоляція worktree. Це гарантує коректне виконання скілу від імені проєкту.
 
 ## Поведінка

package/scripts/lib/docs/rule-meta-helpers.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: rule-meta-helpers.mjs
+resource: npm/scripts/lib/rule-meta-helpers.mjs
 docgen:
-  source: npm/scripts/lib/rule-meta-helpers.mjs
   crc: a7e1ae1d
 ---
 
-# rule-meta-helpers.mjs
-
-## Огляд
-
 Цей файл містить хелпери для автоматичного виявлення та обробки правил конфігурації репозиторіїв. Він надає функції для ідентифікації ID міграцій, нормалізації списків та визначення URL репозиторіїв, а також для виявлення монорепо-пакетів. Ці функції використовуються для автоматизованої обробки конфігурації та забезпечення узгодженості в репозиторіях.
 
 ## Поведінка

package/scripts/lib/docs/rule-meta.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: rule-meta.mjs
+resource: npm/scripts/lib/rule-meta.mjs
 docgen:
-  source: npm/scripts/lib/rule-meta.mjs
   crc: fa5ca866
 ---
 
-# rule-meta.mjs
-
-## Огляд
-
 Цей файл парсує метадані правил npm/rules/<id>/meta.json для автоматичного виявлення проблемних місць у коді. Він визначає, коли правило має бути активним, використовуючи різні специфікації, такі як завжди-ввімкнене правило, правило, яке активується після виявлення залежностей, або правило, яке активується на основі glob-шаблонів чи незводимих предикатів. Це дозволяє системі динамічно визначати та застосовувати правила, не потребуючи явного налаштування.
 
 ## Поведінка

package/scripts/lib/docs/rule-predicates.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: rule-predicates.mjs
+resource: npm/scripts/lib/rule-predicates.mjs
 docgen:
-  source: npm/scripts/lib/rule-predicates.mjs
   crc: 71fba574
   score: 95
 ---
 
-# rule-predicates.mjs
-
-## Огляд
-
 Реєстр незводимих до даних предикатів для автодетекту правил. Предикати використовують наявність файлів або вмісту для визначення умов. Умови, що вимагають парсингу залежностей чи сканування вмісту, читають дані з різних джерел. Виклик диспетчується через `auto-rules.mjs` за іменем предиката.
 
 ## Поведінка

package/scripts/lib/docs/run-conftest-batch.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-conftest-batch.mjs
+resource: npm/scripts/lib/run-conftest-batch.mjs
 docgen:
-  source: npm/scripts/lib/run-conftest-batch.mjs
   crc: 5ec640a0
 ---
 
-# run-conftest-batch.mjs
-
-## Огляд
-
 Файл запускає `conftest test` на заданому списку файлів, виявляючи порушення правил, визначених у Rego-полісіях. Він використовується для автоматизованої перевірки конфігураційних файлів на відповідність заданим вимогам. Результати перевірки повертаються у структурованому вигляді, що дозволяє інтегрувати результати в інші процеси валідації.
 
 ## Поведінка

package/scripts/lib/docs/run-lint-step.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-lint-step.mjs
+resource: npm/scripts/lib/run-lint-step.mjs
 docgen:
-  source: npm/scripts/lib/run-lint-step.mjs
   crc: 5932fa98
 ---
 
-# run-lint-step.mjs
-
-## Огляд
-
 Цей файл забезпечує спільний хелпер для запуску окремих кроків у ланцюжку linting, що використовується CLI-обгортками. Він імітує прямий виклик команд у shell, логуючи команди та перенаправляючи stdout/stderr на користувацькі stream-и. Це дозволяє уникнути дублювання обгорток у різних `rules/<id>/js/lint.mjs` файлах.
 
 ## Поведінка

package/scripts/lib/docs/run-rule-cli.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: run-rule-cli.mjs
+resource: npm/scripts/lib/run-rule-cli.mjs
 docgen:
-  source: npm/scripts/lib/run-rule-cli.mjs
   crc: 264e7ab0
   score: 100
 ---
 
-# run-rule-cli.mjs
-
-## Огляд
-
 Файл є автономним CLI-запускачем для одного правила. Він друкує звіт про перевірку та повертає агрегований код виходу. Whitelist-гейту тут немає: гейтинг активних правил живе виключно у `resolveCheckRuleIds` (селекція за `.n-cursor.json`), а прямий запуск файлу правила — свідома debug/override-дія, тож виконується беззастережно.
 
 ## Поведінка

package/scripts/lib/docs/run-rule.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: run-rule.mjs
+resource: npm/scripts/lib/run-rule.mjs
 docgen:
-  source: npm/scripts/lib/run-rule.mjs
   crc: 27060842
   score: 95
 ---
 
-# run-rule.mjs
-
-## Огляд
-
 Файл слугує оркестратором правила. Він координує виконання перевірок, включаючи перевірку гейту, JS-концернів та policy-концернів.
 
 ## Поведінка

package/scripts/lib/docs/run-standard-lint.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-standard-lint.mjs
+resource: npm/scripts/lib/run-standard-lint.mjs
 docgen:
-  source: npm/scripts/lib/run-standard-lint.mjs
   crc: e7e3f0ae
 ---
 
-# run-standard-lint.mjs
-
-## Огляд
-
 Файл забезпечує централізовану точку запуску для підкоманд `lint-<rule>` у `@nitra/cursor`. Він серіалізує та дедублює запуски, використовуючи `withLock`, щоб гарантувати узгодженість та ефективність. Це дозволяє легко інтегрувати нові правила та обробляти крос-cutting концерни, не вносячи змін у окремі файли правил.
 
 ## Поведінка

package/scripts/lib/docs/run-standard-rule.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: run-standard-rule.mjs
+resource: npm/scripts/lib/run-standard-rule.mjs
 docgen:
-  source: npm/scripts/lib/run-standard-rule.mjs
   crc: c1ae8f0e
   score: 90
 ---
 
-# run-standard-rule.mjs
-
-## Огляд
-
 Файл інкапсулює оркестрацію виконання правил. Він забезпечує запуск правила через визначений шлях, ізолюючи його виконання у блоці `withLock` для уникнення паралельних запусків.
 
 ## Поведінка

package/scripts/lib/docs/skill-meta.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: skill-meta.mjs
+resource: npm/scripts/lib/skill-meta.mjs
 docgen:
-  source: npm/scripts/lib/skill-meta.mjs
   crc: 0c638d18
 ---
 
-# skill-meta.mjs
-
-## Огляд
-
 Цей файл парсить метадані скілу з файлу `meta.json` та надає інформацію про його конфігурацію. Він служить єдиним джерелом правди про скіл, замінюючи старий `auto.md`, і використовується для визначення, чи потрібно запускати скіл в окремому worktree, чи з кореня репозиторію. Це забезпечує узгодженість даних про скіли та полегшує їх використання в інших частинах системи.
 
 ## Поведінка

package/scripts/lib/docs/sync-gitignore-worktree.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: sync-gitignore-worktree.mjs
+resource: npm/scripts/lib/sync-gitignore-worktree.mjs
 docgen:
-  source: npm/scripts/lib/sync-gitignore-worktree.mjs
   crc: e691c42b
   score: 95
 ---
 
-# sync-gitignore-worktree.mjs
-
-## Огляд
-
 syncGitignoreWorktree
 Додає запис `.worktrees/` до кореневого `.gitignore`. Функція викликається для синхронізації локальних git-worktree з конфігурацією. Функція приймає шлях до кореня проєкту-споживача. Функція повертає результат, що вказує на успішність запису.
 

package/scripts/lib/docs/template.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: template.mjs
+resource: npm/scripts/lib/template.mjs
 docgen:
-  source: npm/scripts/lib/template.mjs
   crc: 3bc0617f
 ---
 
-# template.mjs
-
-## Огляд
-
 Файл обробляє шаблони для певних напрямків, збираючи їх у єдину структуру, яка індексується за назвою цільового файлу. Він повертає найбільш відповідний шаблон з `snippet/`, `deny/` або `contains/`, розпізнаний за розширенням, для кожного цільового файлу. Це забезпечує можливість динамічної генерації контенту на основі шаблонів, визначених для різних областей застосунку.
 
 ## Поведінка

package/scripts/lib/docs/timing-summary.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: timing-summary.mjs
+resource: npm/scripts/lib/timing-summary.mjs
 docgen:
-  source: npm/scripts/lib/timing-summary.mjs
   crc: f21a9b91
 ---
 
-# timing-summary.mjs
-
-## Огляд
-
 Цей файл генерує табличне резюме часу виконання для команд `fix` та `lint`, які використовуються в orchestrator. Він підсумовує час виконання окремих правил та скриптів linting, надаючи інформацію для аналізу продуктивності. Результат представлений у вигляді рядка, який можна вивести для відображення користувачеві.
 
 ## Поведінка

package/scripts/lib/docs/workspaces.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: workspaces.mjs
+resource: npm/scripts/lib/workspaces.mjs
 docgen:
-  source: npm/scripts/lib/workspaces.mjs
   crc: 995c1633
 ---
 
-# workspaces.mjs
-
-## Огляд
-
 Цей файл визначає список кореневих каталогів пакетів у монорепо, використовуючи конфігурацію `workspaces` з `package.json`. Він використовується скриптами перевірки монорепо для ідентифікації всіх проектів, які потрібно перевірити. Результат повертається для подальшого використання в процесах перевірки та аналізу.
 
 ## Поведінка

package/scripts/lib/docs/worktree-notice.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: worktree-notice.mjs
+resource: npm/scripts/lib/worktree-notice.mjs
 docgen:
-  source: npm/scripts/lib/worktree-notice.mjs
   crc: dc4fba22
 ---
 
-# worktree-notice.mjs
-
-## Огляд
-
 Цей файл вбудовує інструкції щодо використання git-worktree, коли `meta.json.worktree` встановлено в `true`. Він забезпечує паралельне виконання скілу лише в окремому git-worktree, запобігаючи потенційним проблемам з паралелізмом. Цей механізм дозволяє уникнути гонки з CDN та забезпечує надійний запуск скілу з локальною копією CLI.
 
 ## Поведінка

package/scripts/lib/docs/worktree.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: worktree.mjs
+resource: npm/scripts/lib/worktree.mjs
 docgen:
-  source: npm/scripts/lib/worktree.mjs
   crc: ffcdbca5
 ---
 
-# worktree.mjs
-
-## Огляд
-
 Файл містить детерміновану логіку для обробки гілок у `worktree-tool`, забезпечуючи безпечне перетворення імен гілок та створення описових файлів для `worktree`. Він використовується для генерації структури `.worktrees/` та ідентифікації неактивних описових файлів, що необхідно для операцій з видаленням. Це ключовий компонент для забезпечення консистентності та зручності роботи з `worktree-tool` безпосередньо з файловою системою.
 
 ## Поведінка

package/scripts/lib/fix/docs/index.md

@@ -0,0 +1,16 @@
+---
+type: Directory Index
+title: npm/scripts/lib/fix
+resource: npm/scripts/lib/fix/
+---
+
+# npm/scripts/lib/fix
+
+| Файл | Тип |
+|---|---|
+| [llm-fix-apply.mjs](llm-fix-apply.md) | JS Module |
+| [llm-lint-fix.mjs](llm-lint-fix.md) | JS Module |
+| [llm-worker.mjs](llm-worker.md) | JS Module |
+| [orchestrator.mjs](orchestrator.md) | JS Module |
+| [run-fix-check.mjs](run-fix-check.md) | JS Module |
+| [t0.mjs](t0.md) | JS Module |

package/scripts/lib/fix/docs/llm-fix-apply.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: llm-fix-apply.mjs
+resource: npm/scripts/lib/fix/llm-fix-apply.mjs
 docgen:
-  source: npm/scripts/lib/fix/llm-fix-apply.mjs
   crc: 80befb00
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# llm-fix-apply.mjs
-
-## Огляд
-
 Модуль є спільним ядром для застосування виправлень, згенерованих LLM, використовуючи конформні (`llm-worker.mjs`) та інструментальні (`llm-lint-fix.mjs`) механізми для уникнення дублювання логіки парсингу та застосування змін. Він парсить структуровану відповідь моделі, що містить список змін у форматі `{changes:[{path,content}]}`. Далі, він зчитує вміст файлів, зазначених у цих змінах, та застосовує оновлений вміст до відповідних файлів. Усі операції реалізовані з механізмом fail-safe: при невдачах функції повертають значення помилки (false/null/Err) замість викидання винятків.
 
 ## Поведінка

package/scripts/lib/fix/docs/llm-lint-fix.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: llm-lint-fix.mjs
+resource: npm/scripts/lib/fix/llm-lint-fix.mjs
 docgen:
-  source: npm/scripts/lib/fix/llm-lint-fix.mjs
   crc: de4439e9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
-# llm-lint-fix.mjs
-
-## Огляд
-
 Модуль реалізує механізм `omlx-фікс` для обробки знахідок лінтера, що стосуються `detect-only` тулів, які не мають нативного механізму виправлення (відповідно до `lint-orchestrator-fix-readonly`). Він зчитує уражені файли, ініціює запит до моделі через `callLlm` (маршрутизація через `omlx/<model>` з фолбеком каскаду), щоб отримати пропоновані зміни. Ці зміни застосовуються до файлової системи за допомогою спільного ядра `llm-fix-apply`.
 
 ## Поведінка

package/scripts/lib/fix/docs/llm-worker.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: llm-worker.mjs
+resource: npm/scripts/lib/fix/llm-worker.mjs
 docgen:
-  source: npm/scripts/lib/fix/llm-worker.mjs
   crc: 00730451
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# llm-worker.mjs
-
-## Огляд
-
 Модуль визначає моделі для стандартних та складних виправлень коду. Він надає функції для ініціалізації моделей (`MODEL`, `MODEL_HEAVY`) та для виконання роботи з мовною моделлю (`runLlmWorker`), застосовуючи згенеровані зміни до файлів проєкту.
 
 ## Поведінка

package/scripts/lib/fix/docs/orchestrator.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: orchestrator.mjs
+resource: npm/scripts/lib/fix/orchestrator.mjs
 docgen:
-  source: npm/scripts/lib/fix/orchestrator.mjs
   crc: 3a66072d
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# orchestrator.mjs
-
-## Огляд
-
 Модуль керує процесом валідації та виправлення правил. Він ініціює перевірку всіх правил. Якщо виявлено порушення, процес ітеративно застосовує детермінований механізм виправлення (T0) та виправлення на основі великої мовної моделі (T1) до невирішених правил. Цей цикл повторюється до досягнення стану, коли всі правила відповідають вимогам, або до перевищення встановленого ліміту ітерацій. Функція `runOrchestratorCli` запускає цей процес.
 
 ## Поведінка

package/scripts/lib/fix/docs/run-fix-check.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: run-fix-check.mjs
+resource: npm/scripts/lib/fix/run-fix-check.mjs
 docgen:
-  source: npm/scripts/lib/fix/run-fix-check.mjs
   crc: 76874730
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# run-fix-check.mjs
-
-## Огляд
-
 Викликає конформність-фазу `lint` (read-only), движок (`orchestrator.mjs`, `t0.mjs`) та PostToolUse-хук. Перевірка конформності виконується як пряма функція, без зовнішньої обгортки через `subprocess`. Ізоляція на рівні кожного правила зберігається: кожен файл `rules/<id>/fix.mjs` все ще запускається окремим процесом `bun` (crash-isolation). Селекція активних правил — єдине джерело: `resolveCheckRuleIds` за `.n-cursor.json`; per-rule whitelist у спавнених процесах прибрано як дубль.
 
 ## Поведінка

package/scripts/lib/fix/docs/t0.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: t0.mjs
+resource: npm/scripts/lib/fix/t0.mjs
 docgen:
-  source: npm/scripts/lib/fix/t0.mjs
   crc: 0321ecc1
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# t0.mjs
-
-## Огляд
-
 Модуль керує автоматичним застосуванням паттернів до правил для виправлення виводів порушень. Він визначає, які автоматичні паттерни можуть бути застосовані до правил, використовуючи `filterT0AutoRules`, і запускає повний процес виправлення для всіх відповідних правил через `applyT0Auto` та `runT0AutoCli`. Код працює у режимі fail-safe, перехоплюючи помилки та не викидаючи винятків назовні. Робота модуля залежить від конфігурацій `extensions.json` та `package-lock.json`.
 
 ## Поведінка

package/scripts/lib/worktree-notice.mjs

@@ -134,52 +134,17 @@ git branch --show-current
 Якщо \`git rev-parse --show-toplevel\` показав, що ти **не** в \`.worktrees/\`, візьми вивід \`git branch --show-current\` як \`<current-branch>\` і виконай **literal-команди без shell expansion** (без command substitution, variable expansion чи backticks). Наприклад, якщо поточна гілка \`feature/x\`:
 
 \`\`\`bash
-npx @nitra/cursor worktree add "feature/x-${suffix}" "n-${suffix}: worktree-only skill"
+mt worktree create "feature/x-${suffix}" "n-${suffix}: worktree-only skill"
 cd ".worktrees/feature-x-${suffix}"
 \`\`\`
 
 Тобто branch-argument лишає slash як у git-гілці, а шлях для \`cd\` бере sanitized форму: slash → \`-\`.
 
-**Крок 0.1 — bootstrap у новому дереві (після \`cd\`, окремий крок — поза «без-expansion» блоком вище).** Дерево щойно створене й **без** \`node_modules\`. Спершу постав залежності локально: тоді \`npx\` бере локальну копію \`@nitra/cursor\` і гонки з CDN немає взагалі. Retry-обгортка нижче — safety-net на випадок, коли версію щойно опубліковано, але edge-кеш CDN ще її не має: \`npm\` тоді падає з \`ETARGET\`/\`notarget\` **до** запуску бінарника (внутрішній JS-retry у \`n-cursor\` для цього кейсу марний — бінарник ще не стартував).
+**Крок 0.1 — bootstrap у новому дереві (після \`cd\`).** Дерево щойно створене й **без** \`node_modules\`. Постав залежності локально — тоді \`npx @nitra/cursor <cmd>\` бере локальну копію без походу в реєстр:
 
 \`\`\`bash
-# Локальна копія @nitra/cursor (девзалежність споживача) — npx бере її, без походу в реєстр.
 bun install
-
-# n_cursor_npx <args> — обгортка bootstrap-виклику "npx @nitra/cursor <args>".
-# Ретраїмо ЛИШЕ транзитні помилки реєстру/мережі (CDN ще не пропагував щойно
-# опубліковану версію). Реальний nonzero від CLI (fix повернув ❌, lint-помилка) —
-# віддаємо одразу, без ретраю. Інтервал 30с; дефолт-ліміт 5 хв
-# (env N_CURSOR_NPX_RETRY_MAX_MIN), hard-ceiling 10 хв.
-# Чому 5 хв: CDN-пропагація npm зазвичай < 2 хв, 5 хв — запас; довше → ймовірно
-# реальна проблема (невірна версія / аутейдж), краще віддати помилку, ніж висіти.
-n_cursor_npx() {
-  max_min="\${N_CURSOR_NPX_RETRY_MAX_MIN:-5}"
-  case "$max_min" in '' | *[!0-9]*) max_min=5 ;; esac
-  [ "$max_min" -gt 10 ] && max_min=10
-  deadline=$(( $(date +%s) + max_min * 60 ))
-  attempt=1
-  transient='ETARGET|notarget|No matching version|ENOTFOUND|ETIMEDOUT|EAI_AGAIN|ECONNRESET|50[0-9] |502 Bad Gateway|503 Service Unavailable|504 Gateway'
-  while :; do
-    err=$(mktemp)
-    npx @nitra/cursor "$@" 2>"$err"
-    code=$?
-    cat "$err" >&2
-    [ "$code" -eq 0 ] && { rm -f "$err"; return 0; }
-    if grep -Eq "$transient" "$err" && [ "$(date +%s)" -lt "$deadline" ]; then
-      rm -f "$err"
-      echo "n-cursor: очікую пропагації версії по CDN… спроба $attempt, повтор через 30с" >&2
-      attempt=$((attempt + 1))
-      sleep 30
-    else
-      rm -f "$err"
-      return "$code"
-    fi
-  done
-}
-\`\`\`
-
-Усі подальші bootstrap-виклики \`npx @nitra/cursor <cmd>\` у цій сесії роби через \`n_cursor_npx <cmd>\`. Якщо опинився у свіжому shell без цієї функції — спершу повтори блок вище (\`bun install\` + визначення \`n_cursor_npx\`).`
+\`\`\``
 }
 
 /**

package/scripts/utils/docs/ast-scan-utils.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: ast-scan-utils.mjs
+resource: npm/scripts/utils/ast-scan-utils.mjs
 docgen:
-  source: npm/scripts/utils/ast-scan-utils.mjs
   crc: 0f9b4a21
 ---
 
-# ast-scan-utils.mjs
-
-## Огляд
-
 Цей файл містить утиліти для AST-сканерів JavaScript та TypeScript, що використовуються для аналізу коду та виявлення потенційних проблем. Він надає інструменти для обробки AST, перетворення даних та взаємодії з різними типами вузлів, забезпечуючи основу для створення правил безпеки та аналізу коду. Ці утиліти спрощують розробку сканерів, усуваючи необхідність повторного написання boilerplate-коду.
 
 ## Поведінка

package/scripts/utils/docs/ensure-gitignore-entries.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: ensure-gitignore-entries.mjs
+resource: npm/scripts/utils/ensure-gitignore-entries.mjs
 docgen:
-  source: npm/scripts/utils/ensure-gitignore-entries.mjs
   crc: 35e65c1b
 ---
 
-# ensure-gitignore-entries.mjs
-
-## Огляд
-
 Цей модуль відповідає за оновлення файлу `.gitignore` у корені проєкту. Він забезпечує idempotent додавання нових правил ігнорування, перевіряючи їхню наявність перед доповненням. Це необхідно для підтримки консистентності правил ігнорування в проєкті та інтеграції з інструментами тестування, такими як Stryker.
 
 ## Поведінка

package/scripts/utils/docs/find-package-json-paths.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: find-package-json-paths.mjs
+resource: npm/scripts/utils/find-package-json-paths.mjs
 docgen:
-  source: npm/scripts/utils/find-package-json-paths.mjs
   crc: 06c208de
 ---
 
-# find-package-json-paths.mjs
-
-## Огляд
-
 Цей файл забезпечує спільну утиліту для збору всіх файлів `package.json` у дереві проєкту, ігноруючи вказані каталоги. Він сортує знайдені шляхи пакетів за відносним розташуванням, що полегшує їх подальше використання в скриптах перевірки. Це дозволяє уникнути дублювання коду з інших інструментів перевірки та спрощує процес збору інформації про залежності.
 
 ## Поведінка

package/scripts/utils/docs/index.md

@@ -0,0 +1,23 @@
+---
+type: Directory Index
+title: npm/scripts/utils
+resource: npm/scripts/utils/
+---
+
+# npm/scripts/utils
+
+| Файл | Тип |
+|---|---|
+| [ast-scan-utils.mjs](ast-scan-utils.md) | JS Module |
+| [ensure-gitignore-entries.mjs](ensure-gitignore-entries.md) | JS Module |
+| [find-package-json-paths.mjs](find-package-json-paths.md) | JS Module |
+| [lock-cache-dir.mjs](lock-cache-dir.md) | JS Module |
+| [pass.mjs](pass.md) | JS Module |
+| [resolve-cargo-manifest.mjs](resolve-cargo-manifest.md) | JS Module |
+| [resolve-cmd.mjs](resolve-cmd.md) | JS Module |
+| [resolve-js-root.mjs](resolve-js-root.md) | JS Module |
+| [test-helpers.mjs](test-helpers.md) | JS Module |
+| [walk-cache.mjs](walk-cache.md) | JS Module |
+| [walkDir.mjs](walkDir.md) | JS Module |
+| [with-lock.mjs](with-lock.md) | JS Module |
+| [worktree-fingerprint.mjs](worktree-fingerprint.md) | JS Module |

package/scripts/utils/docs/lock-cache-dir.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: lock-cache-dir.mjs
+resource: npm/scripts/utils/lock-cache-dir.mjs
 docgen:
-  source: npm/scripts/utils/lock-cache-dir.mjs
   crc: 3b63d4b1
 ---
 
-# lock-cache-dir.mjs
-
-## Огляд
-
 Цей файл визначає структуру каталогу кешування блоків для git-worktree, забезпечуючи унікальний стан локу для кожного головного checkout та пов'язаних worktree. Він використовується для серіалізації запуску інструментів аналізу коду в різних worktree, запобігаючи конфліктам та забезпечуючи ефективну роботу. Створена структура кешування гарантує, що всі worktree мають доступ до одного і того ж стану локу, що необхідно для коректної серіалізації процесів аналізу.
 
 ## Поведінка