@nitra/cursor 12.7.0 → 12.8.1

package/.pi-template/extensions/n-cursor-adr/docs/index.md

@@ -17,8 +17,8 @@ docgen:
 4. Запис JSONL файлу. Запис серіалізованого тексту у тимчасову директорію.
 5. Формування вхідного навантаження. Створення JSON об'єкта для передачі у башку.
 6. Передача виконання скриптів. Паралельний запуск двох окремих скриптів.
-    а. Виконання хука capture.
-    б. Виконання хука normalize.
+   а. Виконання хука capture.
+   б. Виконання хука normalize.
 7. Обробка результатів. Очікування завершення обох виконання. Помилки обробляються у загальному режимі.
 
 ## Гарантії поведінки

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [12.8.1] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(docs): Оновлення логіки та формату в документації
+
+## [12.8.0] - 2026-06-21
+
+### Added
+
+- doc-files: orphan-detect і auto-purge — `lint-doc-files` і `fix-doc-files` тепер виявляють і видаляють `docs/<stem>.md` чиї source-файли більше не існують
+
+### Changed
+
+- Переміщено логіку linting до `js` та оновив `n-cursor.js
+
 ## [12.7.0] - 2026-06-21
 
 ### Added
@@ -149,7 +165,7 @@
 
 ### Changed
 
-- Конформність-селекція: .n-cursor.json — єдине джерело правди. resolveCheckRuleIds бере активні правила прямо з конфіга (available ∩ enabled), .cursor/rules/*.mdc лишається лише fallback'ом коли конфіга нема. Прибрано дрейф «правило enabled, але .mdc нема → тихо пропущено». Per-rule whitelist-гейт у runRuleCli видалено як дубль — гейтинг живе виключно у селекції.
+- Конформність-селекція: .n-cursor.json — єдине джерело правди. resolveCheckRuleIds бере активні правила прямо з конфіга (available ∩ enabled), .cursor/rules/\*.mdc лишається лише fallback'ом коли конфіга нема. Прибрано дрейф «правило enabled, але .mdc нема → тихо пропущено». Per-rule whitelist-гейт у runRuleCli видалено як дубль — гейтинг живе виключно у селекції.
 
 ## [10.0.1] - 2026-06-14
 
@@ -161,7 +177,7 @@
 
 ### Changed
 
-- Інлайн _fix-check/fix-t0 у прямі функції — видалено внутрішні subcommand'и. runFixCheck (scripts/lib/fix/run-fix-check) + listProjectRulesMdcFiles винесено з bin; orchestrator/t0/PostToolUse-хук/lint-конформність кличуть прямо (без subprocess-обгортки). Per-rule ізоляція збережена
+- Інлайн \_fix-check/fix-t0 у прямі функції — видалено внутрішні subcommand'и. runFixCheck (scripts/lib/fix/run-fix-check) + listProjectRulesMdcFiles винесено з bin; orchestrator/t0/PostToolUse-хук/lint-конформність кличуть прямо (без subprocess-обгортки). Per-rule ізоляція збережена
 
 ## [9.4.0] - 2026-06-14
 
@@ -221,7 +237,7 @@
 
 ### Removed
 
-- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/_fix-check лишаються внутрішніми фазами движка
+- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/\_fix-check лишаються внутрішніми фазами движка
 
 ## [6.0.0] - 2026-06-14
 
@@ -254,7 +270,7 @@
 
 ### Changed
 
-- ✨ feat(npm/skills/doc-files): doc-files: підтримка Rust (.rs) — SOURCE_…
+- ✨ feat(npm/skills/doc-files): doc-files: підтримка Rust (.rs) — SOURCE\_…
 
 ## [5.3.2] - 2026-06-11
 
@@ -290,7 +306,7 @@
 
 ### Fixed
 
-- lint: санація шарів, що ховалися за першим падінням oxlint — повний bun run lint доведено до lint-js/style зелених: JSDoc/regex/sonarjs фікси у ~25 файлах, slow-regex обмежено bounded-квантифікаторами, eslint ignore для згенерованих docs/*.md, jscpd ignore (.git, COVERAGE.md, docs, відомі легасі-клони), knip ignoreBinaries (pi/claude/fix-t0), stylelint/cspell ignore згенерованих артефактів; docgen-ignore у doc-aggregate став re-export з doc-files
+- lint: санація шарів, що ховалися за першим падінням oxlint — повний bun run lint доведено до lint-js/style зелених: JSDoc/regex/sonarjs фікси у ~25 файлах, slow-regex обмежено bounded-квантифікаторами, eslint ignore для згенерованих docs/\*.md, jscpd ignore (.git, COVERAGE.md, docs, відомі легасі-клони), knip ignoreBinaries (pi/claude/fix-t0), stylelint/cspell ignore згенерованих артефактів; docgen-ignore у doc-aggregate став re-export з doc-files
 
 ## [5.1.0] - 2026-06-10
 

package/bin/n-cursor.js

@@ -623,7 +623,7 @@ function buildClaudeLintParallelismSectionLines() {
     '',
     '## Лінт і ESLint (паралелізм)',
     '',
-    'Паралельний лінт по **різних** файлах — **дозволено**: диз\'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
+    "Паралельний лінт по **різних** файлах — **дозволено**: диз'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.",
     ''
   ]
 }

package/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/
 
 # npm
 
-| Файл | Тип |
-|---|---|
+| Файл                                    | Тип       |
+| --------------------------------------- | --------- |
 | [stryker.config.mjs](stryker.config.md) | JS Module |
-| [vitest.config.js](vitest.config.md) | JS Module |
+| [vitest.config.js](vitest.config.md)    | JS Module |

package/docs/stryker.config.md

@@ -22,9 +22,9 @@ docgen:
 6. Вказує ім'я файлу для JSON-звіту.
 7. Вмикає функціонал збереження результатів між запусками, використовуючи файл `incremental.json`.
 8. Визначає список файлів, які підлягають мутації:
-    * Файли у директорії `scripts`.
-    * Файли у директорії `rules`.
-    * Файли у директорії `bin`.
+   - Файли у директорії `scripts`.
+   - Файли у директорії `rules`.
+   - Файли у директорії `bin`.
 9. Виключає з мутації файли у директоріях `tests`, `__fixtures__`, `fixtures`, `data`, `template`, `templates`.
 10. Виключає з мутації файли у директорії `data`, крім файлу `stryker-vue-macros-ignorer.mjs` у директорії `rules/test/js/data/stryker_config/`.
 

package/lib/docs/index.md

@@ -6,9 +6,9 @@ resource: npm/lib/
 
 # npm/lib
 
-| Файл | Тип |
-|---|---|
-| [llm.mjs](llm.md) | JS Module |
-| [models.mjs](models.md) | JS Module |
+| Файл                            | Тип       |
+| ------------------------------- | --------- |
+| [llm.mjs](llm.md)               | JS Module |
+| [models.mjs](models.md)         | JS Module |
 | [omlx-trace.mjs](omlx-trace.md) | JS Module |
-| [omlx.mjs](omlx.md) | JS Module |
+| [omlx.mjs](omlx.md)             | JS Module |

package/lib/docs/llm.md

@@ -25,10 +25,10 @@ omlxHealthCheck
 pickBackend — Бекенд для model-id: `omlx` — прямий HTTP, `pi` — CLI.
 callLlm — Універсальний виклик LLM з маршрутизацією за префіксом model-id і постійне відстеження (wire-trace) обох каналів.
 omlxHealthCheck — Перевірка omlx перед масовим прогоном через мінімальний чат-виклик (`max_tokens: 1`). Розрізняє стани:
-  down — Сервер не відповідає (не запущений / не той порт).
-  memory-guard — Модель не влазить у динамічну стелю пам'яті зайнятої машини — відкладає прогін.
-  auth — Сервер вимагає API-ключ — виставляє `N_CURSOR_OMLX_KEY`.
-  error — Інша помилка API.
+down — Сервер не відповідає (не запущений / не той порт).
+memory-guard — Модель не влазить у динамічну стелю пам'яті зайнятої машини — відкладає прогін.
+auth — Сервер вимагає API-ключ — виставляє `N_CURSOR_OMLX_KEY`.
+error — Інша помилка API.
 Порожній контент відповіді — означає, що сервер живий і модель завантажена.
 
 ## Гарантії поведінки

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.7.0",
+  "version": "12.8.1",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -68,4 +68,4 @@
     "skills": "skills",
     "extensions": ".pi-template/extensions"
   }
-}
+}

package/rules/abie/docs/fix.md

@@ -14,16 +14,16 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 
 2. Виконання у режимі CLI.
-    *   Виконується при запуску через CLI.
-    *   Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Повертає код виходу.
+   - Виконується при запуску через CLI.
+   - Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Повертає код виходу.
 
 ## Публічний API
 

package/rules/abie/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/abie/
 
 # npm/rules/abie
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/abie/js/docs/index.md

@@ -6,11 +6,11 @@ resource: npm/rules/abie/js/
 
 # npm/rules/abie/js
 
-| Файл | Тип |
-|---|---|
-| [applies.mjs](applies.md) | JS Module |
-| [env_dns.mjs](env_dns.md) | JS Module |
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [applies.mjs](applies.md)                   | JS Module |
+| [env_dns.mjs](env_dns.md)                   | JS Module |
 | [firebase_hosting.mjs](firebase_hosting.md) | JS Module |
-| [hc_pairing.mjs](hc_pairing.md) | JS Module |
-| [ua_http_route.mjs](ua_http_route.md) | JS Module |
+| [hc_pairing.mjs](hc_pairing.md)             | JS Module |
+| [ua_http_route.mjs](ua_http_route.md)       | JS Module |
 | [ua_node_selector.mjs](ua_node_selector.md) | JS Module |

package/rules/abie/lib/docs/index.md

@@ -6,13 +6,13 @@ resource: npm/rules/abie/lib/
 
 # npm/rules/abie/lib
 
-| Файл | Тип |
-|---|---|
-| [enabled.mjs](enabled.md) | JS Module |
-| [env-dns.mjs](env-dns.md) | JS Module |
-| [hc-yaml.mjs](hc-yaml.md) | JS Module |
-| [http-route.mjs](http-route.md) | JS Module |
-| [k8s-tree.mjs](k8s-tree.md) | JS Module |
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [enabled.mjs](enabled.md)                             | JS Module |
+| [env-dns.mjs](env-dns.md)                             | JS Module |
+| [hc-yaml.mjs](hc-yaml.md)                             | JS Module |
+| [http-route.mjs](http-route.md)                       | JS Module |
+| [k8s-tree.mjs](k8s-tree.md)                           | JS Module |
 | [kustomization-patches.mjs](kustomization-patches.md) | JS Module |
-| [overlay-paths.mjs](overlay-paths.md) | JS Module |
-| [yaml.mjs](yaml.md) | JS Module |
+| [overlay-paths.mjs](overlay-paths.md)                 | JS Module |
+| [yaml.mjs](yaml.md)                                   | JS Module |

package/rules/bun/docs/fix.md

@@ -12,11 +12,11 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 
 ## Публічний API
 

package/rules/bun/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/bun/
 
 # npm/rules/bun
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/bun/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/bun/js/
 
 # npm/rules/bun/js
 
-| Файл | Тип |
-|---|---|
+| Файл                    | Тип       |
+| ----------------------- | --------- |
 | [layout.mjs](layout.md) | JS Module |

package/rules/capacitor/docs/fix.md

@@ -12,17 +12,17 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат.
 2. Запуск у режимі CLI.
-    *   Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених записів.
-    *   Генерує зведену інформацію.
-    *   Використовує `process.exitCode` для визначення виходу.
+   - Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Виконує завантаження конфігурації.
+   - Виконує перевірку дозволених записів.
+   - Генерує зведену інформацію.
+   - Використовує `process.exitCode` для визначення виходу.
 
 ## Публічний API
 

package/rules/capacitor/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/capacitor/
 
 # npm/rules/capacitor
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/capacitor/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/capacitor/js/
 
 # npm/rules/capacitor/js
 
-| Файл | Тип |
-|---|---|
+| Файл                          | Тип       |
+| ----------------------------- | --------- |
 | [platforms.mjs](platforms.md) | JS Module |

package/rules/changelog/docs/fix.md

@@ -12,18 +12,18 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 2. Виконання у режимі CLI.
-    *   Виконується як окремий скрипт.
-    *   Еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених елементів.
-    *   Генерує зведену інформацію.
-    *   Виконує повний еквівалент `fix.mjs`.
+   - Виконується як окремий скрипт.
+   - Еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Виконує завантаження конфігурації.
+   - Виконує перевірку дозволених елементів.
+   - Генерує зведену інформацію.
+   - Виконує повний еквівалент `fix.mjs`.
 
 ## Публічний API
 

package/rules/changelog/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/changelog/
 
 # npm/rules/changelog
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/changelog/js/docs/consistency.md

@@ -16,19 +16,19 @@ docgen:
 3. Зчитує всі кореневі каталоги проектів у монорепо.
 4. Класифікує кожен проект як публікувальний (registryPublishable) або локальний.
 5. Для кожного публікувального проекту виконує перевірку:
-    а. Зчитує маніфест проекту.
-    б. Якщо у маніфесті відсутнє ім'я або поле version, фіксує помилку.
-    в. Якщо є change-файл(и) у .changes/, фіксує успіх, оскільки bump зробить CI (n-changelog.mdc), і перевіряє наявність "CHANGELOG.md" у файлах проекту.
-    г. Якщо немає change-файлу, визначає точку порівняння на основі поточної гілки.
-    д. Порівнює версію в маніфесті з опублікованою версією (за допомогою npm view або запиту до https://pypi.org/pypi/).
-    е. Якщо версія в маніфесті випереджає опубліковану, фіксує помилку, оскільки ручний bump поза CI заборонений.
-    ж. Якщо версія в маніфесті позаду опублікованої, фіксує успіх, оскільки це відставання локального репозиторію від реєстру.
-    з. Якщо версії збігаються, перевіряє змінений код відносно точки порівняння. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
+   а. Зчитує маніфест проекту.
+   б. Якщо у маніфесті відсутнє ім'я або поле version, фіксує помилку.
+   в. Якщо є change-файл(и) у .changes/, фіксує успіх, оскільки bump зробить CI (n-changelog.mdc), і перевіряє наявність "CHANGELOG.md" у файлах проекту.
+   г. Якщо немає change-файлу, визначає точку порівняння на основі поточної гілки.
+   д. Порівнює версію в маніфесті з опублікованою версією (за допомогою npm view або запиту до https://pypi.org/pypi/).
+   е. Якщо версія в маніфесті випереджає опубліковану, фіксує помилку, оскільки ручний bump поза CI заборонений.
+   ж. Якщо версія в маніфесті позаду опублікованої, фіксує успіх, оскільки це відставання локального репозиторію від реєстру.
+   з. Якщо версії збігаються, перевіряє змінений код відносно точки порівняння. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
 6. Для кожного локального проекту виконує перевірку:
-    а. Зчитує маніфест проекту.
-    б. Визначає точку порівняння на основі поточної гілки.
-    в. Перевіряє, чи є релевантні зміни у проекті відносно точки порівняння.
-    г. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
+   а. Зчитує маніфест проекту.
+   б. Визначає точку порівняння на основі поточної гілки.
+   в. Перевіряє, чи є релевантні зміни у проекті відносно точки порівняння.
+   г. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
 7. Повертає кінцевий код виходу, що відображає результат перевірки.
 
 ## Гарантії поведінки

package/rules/changelog/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/changelog/js/
 
 # npm/rules/changelog/js
 
-| Файл | Тип |
-|---|---|
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
 | [consistency.mjs](consistency.md) | JS Module |

package/rules/changelog/lib/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/changelog/lib/
 
 # npm/rules/changelog/lib
 
-| Файл | Тип |
-|---|---|
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
 | [package-manifest.mjs](package-manifest.md) | JS Module |

package/rules/ci4/docs/fix.md

@@ -13,12 +13,12 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Виклик runStandardRule з контекстом.
-    *   Повернення результату.
+   - Виклик runStandardRule з контекстом.
+   - Повернення результату.
 
 2. Запуск правила у режимі CLI.
-    *   Виклик runRuleCli з директорією модуля.
-    *   Вихід з процесом залежно від результату.
+   - Виклик runRuleCli з директорією модуля.
+   - Вихід з процесом залежно від результату.
 
 ## Публічний API
 

package/rules/ci4/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/ci4/
 
 # npm/rules/ci4
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/ci4/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/ci4/js/
 
 # npm/rules/ci4/js
 
-| Файл | Тип |
-|---|---|
+| Файл                                      | Тип       |
+| ----------------------------------------- | --------- |
 | [marksman_config.mjs](marksman_config.md) | JS Module |

package/rules/doc-files/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/doc-files/
 
 # npm/rules/doc-files
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/doc-files/js/docgen-crc.mjs

@@ -74,7 +74,7 @@ const EXT_TYPES = {
   '.ts': 'TS Module',
   '.vue': 'Vue Component',
   '.py': 'Python Module',
-  '.rs': 'Rust Module',
+  '.rs': 'Rust Module'
 }
 
 /**
@@ -86,8 +86,6 @@ function typeForSource(sourcePath) {
   return EXT_TYPES[extname(sourcePath).toLowerCase()] ?? 'Source File'
 }
 
-
-
 /**
  * Нормалізує issues до YAML-безпечних кодів: бере фрагмент до першого пробілу
  * (зрізає людиночитні хвости помилок), відкидає порожні, обмежує кількість.
@@ -112,11 +110,7 @@ function issueCodes(issues) {
  * @returns {string} OKF-сумісний YAML frontmatter
  */
 export function buildDocFrontmatter(source, crc, quality = null, model = null) {
-  const okfLines = [
-    `type: ${typeForSource(source)}`,
-    `title: ${basename(source)}`,
-    `resource: ${source}`,
-  ]
+  const okfLines = [`type: ${typeForSource(source)}`, `title: ${basename(source)}`, `resource: ${source}`]
 
   // docgen namespace: лише CRC-механіка і quality (source перенесено у resource)
   const docgenLines = [`crc: ${crc}`]

package/rules/doc-files/js/docgen-extract.mjs

@@ -48,11 +48,13 @@ const FALSY_RETURN_RE = /catch[\s\S]{0,400}?return\s+(false|null|''|"")/
 // Мережа: окрім явного fetch/http, ловимо абстраговані клієнти (graphql/db/rpc/
 // octokit/.request/.query). Хибний false-negative тут = небезпечна гарантія
 // «без мережі», тож свідомо схиляємось до over-detection (м'якший бік помилки).
-const NETWORK_RE = /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
+const NETWORK_RE =
+  /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
 // Будь-який `throw` назовні → НЕ можна гарантувати «fail-safe / без винятків».
 const THROW_RE = /\bthrow\s/
 // Запис у БД / зовнішню мутацію → НЕ read-only (навіть якщо нема ФС-запису).
-const MUTATION_RE = /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]|[Mm]utation\b|\bmut[A-Z]\w*|\.(save|create|update|delete|insert|destroy|mutate)\(/
+const MUTATION_RE =
+  /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]|[Mm]utation\b|\bmut[A-Z]\w*|\.(save|create|update|delete|insert|destroy|mutate)\(/
 // Кеш — лише за ІМЕНОВАНИМ маркером (`cache`/`Cache`/`memoize`), не за будь-яким
 // `new Map()`: акумулятор (напр. `byPath = new Map()`) — не кеш, а хибна гарантія
 // «Кешує результати» гірша за пропуск (фабрикація > мовчання).
@@ -213,7 +215,7 @@ function extractMarkers(src) {
   return {
     // «Фабрикація > мовчання»: прапорець true лише за high-confidence; інакше
     // guaranteesFromMarkers/factsSummary його ОПУСКАЮТЬ (не стверджують протилежне).
-    readOnly: !WRITE_FS_RE.test(src) && !MUTATION_RE.test(src),                    // ні ФС-запису, ні DB-мутацій
+    readOnly: !WRITE_FS_RE.test(src) && !MUTATION_RE.test(src), // ні ФС-запису, ні DB-мутацій
     catchesErrors: (CATCH_RE.test(src) || TRY_RE.test(src)) && !THROW_RE.test(src), // fail-safe лише якщо НЕ кидає
     returnsFalsyOnFail: FALSY_RETURN_RE.test(src) && !THROW_RE.test(src),
     network: NETWORK_RE.test(src),

package/rules/doc-files/js/docgen-files-batch.mjs

@@ -1,5 +1,14 @@
 /** @see ./docs/docgen-files-batch.md */
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs'
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmdirSync,
+  statSync,
+  unlinkSync,
+  writeFileSync
+} from 'node:fs'
 import { basename, dirname, join, relative } from 'node:path'
 
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
@@ -153,7 +162,9 @@ const OKF_RESOURCE_RE = /^resource:[ \t]+(.+)$/mu
  * @returns {void}
  */
 function generateDirIndex(docsAbsDir, root) {
-  const allMd = readdirSync(docsAbsDir).filter(f => f.endsWith('.md')).sort()
+  const allMd = readdirSync(docsAbsDir)
+    .filter(f => f.endsWith('.md'))
+    .sort()
 
   // Якщо index.md вже є дока для source-файлу (має docgen.source → index.*) — не чіпаємо
   if (allMd.includes('index.md')) {
@@ -243,7 +254,11 @@ export function purgeOrphanedDocs(root) {
       // Лише index.md або порожня директорія — прибираємо повністю
       const indexPath = join(docsAbsDir, 'index.md')
       if (existsSync(indexPath)) unlinkSync(indexPath)
-      try { rmdirSync(docsAbsDir) } catch { /* не порожня — пропускаємо */ }
+      try {
+        rmdirSync(docsAbsDir)
+      } catch {
+        /* не порожня — пропускаємо */
+      }
     } else {
       generateDirIndex(docsAbsDir, root)
     }

package/rules/doc-files/js/docgen-gen.mjs

@@ -133,7 +133,10 @@ export function splitProtected(md) {
       break
     }
   }
-  const body = lines.slice(start + 1, end).join('\n').trim()
+  const body = lines
+    .slice(start + 1, end)
+    .join('\n')
+    .trim()
   const without = [...lines.slice(0, start), ...lines.slice(end)].join('\n')
   return { body: body || null, without }
 }
@@ -395,7 +398,10 @@ export const DEFAULT_LOCAL_MODEL = env.N_CURSOR_DOCGEN_MODEL ?? resolveModel('mi
  * @param {{ model?: string, threshold?: number, existingMd?: string|null }} [opts] model-id, поріг degraded, наявна дока (для збереження захищеної секції)
  * @returns {{ md: string, ms: number, llmMs: number, llmCalls: number, score: number|null, issues: string[], degraded: boolean, model: string }} документ і метадані генерації (ms — увесь файл; llmMs/llmCalls — лише LLM; решта ms — оркестрація)
  */
-export function generateDoc(file, { model = DEFAULT_LOCAL_MODEL, threshold = QUALITY_THRESHOLD, existingMd = null } = {}) {
+export function generateDoc(
+  file,
+  { model = DEFAULT_LOCAL_MODEL, threshold = QUALITY_THRESHOLD, existingMd = null } = {}
+) {
   const src = readFileSync(file, 'utf8')
   // Pre-send guard: весь src вшивається у промпт як є (екстракт фактів його НЕ
   // замінює). Для гігантів (vendored/генерат) це переповнює контекст → інстант-skip
@@ -403,7 +409,9 @@ export function generateDoc(file, { model = DEFAULT_LOCAL_MODEL, threshold = QUA
   const estTokens = Math.round(Buffer.byteLength(src, 'utf8') / 4)
   const budget = srcTokenBudget()
   if (estTokens > budget) {
-    throw new Error(`docgen pre-send guard: джерело ~${estTokens} токенів > бюджет ${budget} (0.5× контексту) — Prompt too long, skip`)
+    throw new Error(
+      `docgen pre-send guard: джерело ~${estTokens} токенів > бюджет ${budget} (0.5× контексту) — Prompt too long, skip`
+    )
   }
   const facts = extractFacts(src, file)
   const t0 = Date.now()