@7n/rules 1.3.0 → 1.3.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.3.2] - 2026-07-15
+
+### Fixed
+
+- template-deep-merge: eslint (cognitive-complexity, no-negated-array-predicate) і cspell-фікси після PR #66
+
+## [1.3.1] - 2026-07-14
+
+### Changed
+
+- docs(adr): merge pending ADR normalization batch
+
 ## [1.3.0] - 2026-07-14
 
 ### Changed

package/docs/index.md

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

package/docs/vitest.config.md

@@ -3,7 +3,7 @@ type: JS Module
 title: vitest.config.js
 resource: npm/vitest.config.js
 docgen:
-  crc: 01d03a02
+  crc: 2c54e477
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/rules/abie/clean_merged_ignore_branches/docs/fix-clean_merged_ignore_branches.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-clean_merged_ignore_branches.mjs
+resource: npm/rules/abie/clean_merged_ignore_branches/fix-clean_merged_ignore_branches.mjs
+docgen:
+  crc: 9fe2cc60
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає набір шляхів репозиторію, які правило має враховувати під час перевірки. Воно свідомо не охоплює `.git` і `.github`, щоб не аналізувати службові дані Git та конфігурацію GitHub. Правило працює read-only: лише повідомляє про невідповідність очікуваній структурі, не змінюючи файли чи зовнішні сховища.
+
+## Поведінка
+
+1. `patterns` визначає правило виправлення, яке забезпечує наявність workflow для очищення merged branches.
+
+2. Правило орієнтується на шаблонний стан файлу `.github/workflows/clean-merged-branch.yml`, щоб уніфікувати поведінку репозиторіїв щодо прибирання вже злитих гілок.
+
+3. Під час перевірки свідомо не обходить службові шляхи `.github` і `.git`, окрім цільового workflow-файлу, який є предметом виправлення.
+
+4. `patterns` лише описує очікуване виправлення й не виконує самостійного запису у файлову систему чи інші сховища.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

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

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/abie/clean_merged_ignore_branches
+resource: npm/rules/abie/clean_merged_ignore_branches/
+---
+
+| Файл                                                                        | Тип       |
+| --------------------------------------------------------------------------- | --------- |
+| [fix-clean_merged_ignore_branches.mjs](fix-clean_merged_ignore_branches.md) | JS Module |

package/rules/abie/clean_merged_ignore_branches/fix-clean_merged_ignore_branches.mjs

@@ -1,3 +1,8 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'abie-clean_merged_ignore_branches-template', targetPath: '.github/workflows/clean-merged-branch.yml' })]
+export const patterns = [
+  createTemplateFixPattern({
+    id: 'abie-clean_merged_ignore_branches-template',
+    targetPath: '.github/workflows/clean-merged-branch.yml'
+  })
+]

package/rules/docker/lint_docker_yml/docs/fix-lint_docker_yml.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-lint_docker_yml.mjs
+resource: npm/rules/docker/lint_docker_yml/fix-lint_docker_yml.mjs
+docgen:
+  crc: 551913c9
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає поведінку правила для обходу проєкту без змін у файловій системі чи зовнішніх сховищах. Службові директорії `.github` і `.git` свідомо не входять до перевірюваних шляхів, щоб правило працювало лише з релевантним кодом проєкту.
+
+## Поведінка
+
+1. `patterns` визначає правило автоматичного виправлення для workflow перевірки Docker.
+
+2. `patterns` забезпечує наявність стандартного файлу `.github/workflows/lint-docker.yml`, щоб проєкт мав єдиний CI-контроль Docker-конфігурації.
+
+3. `patterns` працює як read-only опис виправлення: сам модуль не змінює файлову систему чи зовнішні сховища.
+
+4. Під час супровідного обходу шляхів свідомо не аналізуються `.github` і `.git`, щоб не змішувати службові директорії з основним кодом проєкту.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/docker/lint_docker_yml/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/docker/lint_docker_yml
+resource: npm/rules/docker/lint_docker_yml/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-lint_docker_yml.mjs](fix-lint_docker_yml.md) | JS Module |

package/rules/docker/lint_docker_yml/fix-lint_docker_yml.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'docker-lint_docker_yml-template', targetPath: '.github/workflows/lint-docker.yml' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'docker-lint_docker_yml-template', targetPath: '.github/workflows/lint-docker.yml' })
+]

package/rules/ga/clean_ga_workflows/docs/fix-clean_ga_workflows.md

@@ -0,0 +1,33 @@
+---
+type: JS Module
+title: fix-clean_ga_workflows.mjs
+resource: npm/rules/ga/clean_ga_workflows/fix-clean_ga_workflows.mjs
+docgen:
+  crc: e09e62cc
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає, які шляхи правило свідомо не розглядає як цільові для перевірки: `.github` і `.git` пропускаються, щоб службові каталоги репозиторію не змішувалися з робочим кодом.
+
+Правило працює read-only: не записує у файлову систему чи бази даних.
+
+## Поведінка
+
+1. `patterns` визначає правило автоматичного виправлення для workflow очищення GitHub Actions.
+
+2. Правило гарантує наявність очікуваного файлу `.github/workflows/clean-ga-workflows.yml` на основі затвердженого шаблону.
+
+3. Виправлення працює як read-only опис дії: саме по собі не записує зміни у файлову систему чи зовнішні сховища.
+
+4. Під час застосування загальних перевірок свідомо не розглядаються службові шляхи `.github` і `.git`, щоб не аналізувати інфраструктурні каталоги як звичайний код.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/ga/clean_ga_workflows/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/clean_ga_workflows
+resource: npm/rules/ga/clean_ga_workflows/
+---
+
+| Файл                                                    | Тип       |
+| ------------------------------------------------------- | --------- |
+| [fix-clean_ga_workflows.mjs](fix-clean_ga_workflows.md) | JS Module |

package/rules/ga/clean_ga_workflows/fix-clean_ga_workflows.mjs

@@ -1,3 +1,8 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'ga-clean_ga_workflows-template', targetPath: '.github/workflows/clean-ga-workflows.yml' })]
+export const patterns = [
+  createTemplateFixPattern({
+    id: 'ga-clean_ga_workflows-template',
+    targetPath: '.github/workflows/clean-ga-workflows.yml'
+  })
+]

package/rules/ga/clean_merged_branch/docs/fix-clean_merged_branch.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: fix-clean_merged_branch.mjs
+resource: npm/rules/ga/clean_merged_branch/fix-clean_merged_branch.mjs
+docgen:
+  crc: c38d9d28
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` звіряє шаблонну конфігурацію з відповідними файлами репозиторію, щоб підтримувати узгодженість між шаблоном і робочим станом. Працює лише на читання, не торкається `.github` і `.git`, і не змінює файлову систему чи базу даних.
+
+## Поведінка
+
+1. `patterns` формує набір правил для узгодження шаблонної конфігурації з цільовим workflow-файлом `.github/workflows/clean-merged-branch.yml`.
+2. `patterns` використовує це правило як частину автоматизованого вирівнювання між шаблоном і робочим репозиторієм, щоб підтримувати однакову поведінку в потрібному workflow.
+3. `patterns` свідомо не охоплює шляхи `.github` і `.git`, щоб не зачіпати службові та внутрішні дані репозиторію.
+4. `patterns` працює read-only: лише описує, що треба зіставити, і не записує зміни у файлову систему чи базу даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/ga/clean_merged_branch/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/clean_merged_branch
+resource: npm/rules/ga/clean_merged_branch/
+---
+
+| Файл                                                      | Тип       |
+| --------------------------------------------------------- | --------- |
+| [fix-clean_merged_branch.mjs](fix-clean_merged_branch.md) | JS Module |

package/rules/ga/clean_merged_branch/fix-clean_merged_branch.mjs

@@ -1,3 +1,8 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'ga-clean_merged_branch-template', targetPath: '.github/workflows/clean-merged-branch.yml' })]
+export const patterns = [
+  createTemplateFixPattern({
+    id: 'ga-clean_merged_branch-template',
+    targetPath: '.github/workflows/clean-merged-branch.yml'
+  })
+]

package/rules/ga/git_ai/docs/fix-git_ai.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: fix-git_ai.mjs
+resource: npm/rules/ga/git_ai/fix-git_ai.mjs
+docgen:
+  crc: 58c702af
+  model: openai-codex/gpt-5.5
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає шаблони пошуку для перевірки проєктних файлів і свідомо не охоплює службові шляхи `.github` та `.git`.
+
+Модуль має read-only поведінку без запису у файлову систему чи базу даних, щоб перевірка лише виявляла релевантні збіги й не змінювала стан репозиторію.
+
+## Поведінка
+
+1. `patterns` визначає автоматичне виправлення для підтримки стандартного workflow Git AI у репозиторії.
+
+2. `patterns` забезпечує наявність очікуваного файлу `.github/workflows/git-ai.yml`, щоб перевірка правила могла запропонувати єдиний канонічний варіант налаштування.
+
+3. Під час пошуку цільових файлів свідомо пропускаються службові шляхи `.github` і `.git`, щоб не аналізувати технічні директорії як звичайний проєктний код.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/ga/git_ai/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/git_ai
+resource: npm/rules/ga/git_ai/
+---
+
+| Файл                            | Тип       |
+| ------------------------------- | --------- |
+| [fix-git_ai.mjs](fix-git_ai.md) | JS Module |

package/rules/ga/git_ai/fix-git_ai.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'ga-git_ai-template', targetPath: '.github/workflows/git-ai.yml' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'ga-git_ai-template', targetPath: '.github/workflows/git-ai.yml' })
+]

package/rules/ga/lint_ga/docs/fix-lint_ga.md

@@ -0,0 +1,32 @@
+---
+type: JS Module
+title: fix-lint_ga.mjs
+resource: npm/rules/ga/lint_ga/fix-lint_ga.mjs
+docgen:
+  crc: fd87bb0c
+  model: openai-codex/gpt-5.5
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` описує перевірку очікуваного вмісту для `.github/workflows/lint-ga.yml`, щоб lint workflow для Google Analytics залишався узгодженим із шаблоном.
+
+Секція має read-only призначення: вона фіксує очікувану поведінку без запису у файлову систему чи базу даних. Під час загального обходу свідомо не враховуються службові шляхи `.github` і `.git`.
+
+## Поведінка
+
+1. `patterns` оголошує правило автоматичного виправлення для workflow lint-перевірки Google Analytics.
+
+2. `patterns` забезпечує приведення `.github/workflows/lint-ga.yml` до очікуваного шаблонного стану, щоб CI мав стабільну перевірку GA-правил.
+
+3. `patterns` не виконує запис самостійно: воно лише описує доступне виправлення для зовнішнього механізму застосування.
+
+4. `patterns` свідомо не охоплює службові шляхи `.github` і `.git` як вхідні області для загального обходу, окрім цільового workflow-файлу, який має бути синхронізований із шаблоном.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/ga/lint_ga/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/lint_ga
+resource: npm/rules/ga/lint_ga/
+---
+
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
+| [fix-lint_ga.mjs](fix-lint_ga.md) | JS Module |

package/rules/ga/lint_ga/fix-lint_ga.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'ga-lint_ga-template', targetPath: '.github/workflows/lint-ga.yml' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'ga-lint_ga-template', targetPath: '.github/workflows/lint-ga.yml' })
+]

package/rules/ga/vscode_settings/docs/fix-vscode_settings.md

@@ -0,0 +1,26 @@
+---
+type: JS Module
+title: fix-vscode_settings.mjs
+resource: npm/rules/ga/vscode_settings/fix-vscode_settings.mjs
+docgen:
+  crc: f3ea1fe1
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` перевіряє та впорядковує `.vscode/settings.json` на відповідність очікуваному проєктному формату, спираючись на `settings.json`. Це потрібно, щоб редакторні налаштування залишалися в передбачуваному стані без ручних правок.
+
+## Поведінка
+
+1. `patterns` визначає набір правил для узгодження `.vscode/settings.json` з очікуваним шаблоном проєкту.
+2. `patterns` потрібен, щоб автоматично тримати налаштування редактора в погодженому стані без ручного редагування кожного разу.
+3. `patterns` працює лише з конфігурацією `.vscode/settings.json`; інших шляхів або файлів у межах цього модуля не охоплює.
+4. `patterns` не виконує записів у файлову систему чи базу даних і не покладається на кешування.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/ga/vscode_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/vscode_settings
+resource: npm/rules/ga/vscode_settings/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/ga/vscode_settings/fix-vscode_settings.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'ga-vscode_settings-template', targetPath: '.vscode/settings.json' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'ga-vscode_settings-template', targetPath: '.vscode/settings.json' })
+]

package/rules/ga/zizmor_yml/docs/fix-zizmor_yml.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-zizmor_yml.mjs
+resource: npm/rules/ga/zizmor_yml/fix-zizmor_yml.mjs
+docgen:
+  crc: e1cfb71f
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` описує, як привести цільові файли репозиторію до потрібного вигляду з урахуванням свідомо пропущених шляхів `.github` і `.git`. Функція працює read-only і не пише у ФС чи БД.
+
+## Поведінка
+
+1. `patterns` задає набір правил для автоматичного виправлення конфігурації `zizmor` у репозиторії.
+2. Воно орієнтується на файл `.github/zizmor.yml` і застосовується лише до цього цільового місця.
+3. Під час роботи свідомо не зачіпає шляхи `.github` і `.git` поза визначеним цільовим файлом, щоб не втручатися в службові та інфраструктурні області.
+4. Працює у режимі read-only: саме значення `patterns` лише описує поведінку, без запису в файлову систему чи базу даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/ga/zizmor_yml/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/ga/zizmor_yml
+resource: npm/rules/ga/zizmor_yml/
+---
+
+| Файл                                    | Тип       |
+| --------------------------------------- | --------- |
+| [fix-zizmor_yml.mjs](fix-zizmor_yml.md) | JS Module |

package/rules/js/jscpd_config/docs/fix-jscpd_config.md

@@ -0,0 +1,26 @@
+---
+type: JS Module
+title: fix-jscpd_config.mjs
+resource: npm/rules/js/jscpd_config/fix-jscpd_config.mjs
+docgen:
+  crc: 93258f26
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає узгоджені з правилами проєкту зміни для `.jscpd.json` і слугує централізованим орієнтиром для того, що саме має бути виправлено в цьому конфігу.
+
+## Поведінка
+
+1. `patterns` формує перелік правил для уніфікації шаблонного конфіга проєкту.
+2. Кожне правило орієнтується на конфіг `.jscpd.json`, щоб тримати його в узгодженому, очікуваному форматі.
+3. `patterns` потрібен для централізованого опису того, що саме має бути виправлено в `.jscpd.json`, без ручного втручання в інші файли чи артефакти.
+4. `patterns` не змінює файлову систему або базу даних і працює лише як опис набору правок для цього конфіга.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/js/jscpd_config
+resource: npm/rules/js/jscpd_config/
+---
+
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [fix-jscpd_config.mjs](fix-jscpd_config.md) | JS Module |

package/rules/js/lint_js_yml/docs/fix-lint_js_yml.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-lint_js_yml.mjs
+resource: npm/rules/js/lint_js_yml/fix-lint_js_yml.mjs
+docgen:
+  crc: 39aecc30
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` — read-only набір правил для аналізу й уніфікації JavaScript lint-конфігурації в межах доступних шляхів. Він свідомо пропускає `.github` і `.git`, щоб не зачіпати службові та git-специфічні файли.
+
+## Поведінка
+
+1. `patterns` формує набір правил для виправлення lint-конфігурації JavaScript-проєкту.
+2. Для кожного правила прив’язує оновлення до цільового workflow-файлу `.github/workflows/lint-js.yml`.
+3. У межах своєї роботи свідомо не зачіпає `.github` і `.git`, щоб уникати змін у службових та внутрішніх областях.
+4. Працює в read-only режимі щодо ФС і БД: сам нічого не записує, а лише описує, що треба виправити.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

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

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/js/lint_js_yml
+resource: npm/rules/js/lint_js_yml/
+---
+
+| Файл                                      | Тип       |
+| ----------------------------------------- | --------- |
+| [fix-lint_js_yml.mjs](fix-lint_js_yml.md) | JS Module |

package/rules/js/package_json/docs/fix-package_json.md

@@ -0,0 +1,26 @@
+---
+type: JS Module
+title: fix-package_json.mjs
+resource: npm/rules/js/package_json/fix-package_json.mjs
+docgen:
+  crc: 048fe1b5
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` забезпечує перевірку й звірку `package.json` з очікуваним шаблоном цього проєкту. Модуль читає `package.json` як основний конфіг, на який спирається код, і використовується для оцінки відповідності структури та вмісту файла вимогам проєкту. Робота read-only: змін у файловій системі чи базі даних не вносить.
+
+## Поведінка
+
+1. `patterns` надає набір правил, які приводять `package.json` до очікуваного шаблону для цього проєкту.
+2. Кожне правило орієнтується на конфігурацію `package.json` і застосовується до нього як до цільового файлу.
+3. `patterns` використовується як публічна точка входу для перевірки й вирівнювання структури `package.json` без змін у файловій системі чи базі даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/js/package_json
+resource: npm/rules/js/package_json/
+---
+
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [fix-package_json.mjs](fix-package_json.md) | JS Module |

package/rules/k8s/lint_k8s_yml/docs/fix-lint_k8s_yml.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: fix-lint_k8s_yml.mjs
+resource: npm/rules/k8s/lint_k8s_yml/fix-lint_k8s_yml.mjs
+docgen:
+  crc: 220f0740
+  model: openai-codex/gpt-5.5
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надає `patterns` як read-only опис очікуваних збігів для перевірки репозиторію без змін у файловій системі чи інших сховищах. Свідомо пропускає `.github` і `.git`, щоб не аналізувати службові шляхи та зосереджувати перевірку на релевантному вмісті.
+
+## Поведінка
+
+1. `patterns` оголошує набір правил автоматичного виправлення для workflow перевірки Kubernetes YAML.
+
+2. `patterns` забезпечує наявність стандартного шаблону `.github/workflows/lint-k8s.yml`, щоб репозиторій мав узгоджену CI-перевірку Kubernetes-маніфестів.
+
+3. `patterns` працює як read-only опис очікуваного виправлення: сам файл не виконує запис у файлову систему чи базу даних.
+
+4. `patterns` свідомо не охоплює обходом службові шляхи `.github` і `.git`; цільовий workflow у `.github/workflows/lint-k8s.yml` задається як конкретний шаблонний артефакт.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/k8s/lint_k8s_yml/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/k8s/lint_k8s_yml
+resource: npm/rules/k8s/lint_k8s_yml/
+---
+
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [fix-lint_k8s_yml.mjs](fix-lint_k8s_yml.md) | JS Module |

package/rules/k8s/lint_k8s_yml/fix-lint_k8s_yml.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'k8s-lint_k8s_yml-template', targetPath: '.github/workflows/lint-k8s.yml' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'k8s-lint_k8s_yml-template', targetPath: '.github/workflows/lint-k8s.yml' })
+]