@7n/rules 1.3.1 → 1.4.0

package/.pi-template/extensions/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/.pi-template/extensions
+resource: npm/.pi-template/extensions/
+---
+
+| Файл             | Тип       |
+| ---------------- | --------- |
+| [rtk.ts](rtk.md) | TS Module |

package/.pi-template/extensions/docs/rtk.md

@@ -0,0 +1,33 @@
+---
+type: TS Module
+title: rtk.ts
+resource: npm/.pi-template/extensions/rtk.ts
+docgen:
+  crc: f00b429f
+---
+
+## Огляд
+
+Pi.dev-extension для rtk (Rust Token Killer): прозоро переписує bash-команди агента на
+rtk-еквіваленти, щоб стискати вивід CLI-команд і економити токени. Vendored із rtk
+(`rtk init --agent pi`), адаптований під конвенції репо; доставляється sync-ом пакета
+`@7n/rules` у `.pi/extensions/rtk.ts` проєктів-споживачів, коли увімкнене правило
+`local-ai`. Шлях збігається зі шляхом установки самого rtk, тож ручний
+`rtk init --agent pi` поверх — ідемпотентний.
+
+## Поведінка
+
+- Тонкий делегат: рішення про переписування ухвалює `rtk rewrite <cmd>` (exit 0 або 3 +
+  stdout → команда мутується через `event.input.command`; exit 1 — passthrough).
+- При завантаженні пробує `rtk --version`: без бінарника в PATH або з rtk < 0.23.0
+  extension сам вимикається з `console.warn` (fail-open) — установка конфігу безпечна
+  до `brew install rtk-ai/tap/rtk`.
+- Пропускає без змін: не-bash tool_call, порожні команди, команди, що вже починаються
+  з `rtk `, і будь-що при `RTK_DISABLED=1` в env.
+- Виклики rtk обмежені таймаутом 2 с і сигналом скасування контексту; будь-яка
+  неочікувана помилка в обробнику лише логується — команда виконується без переписування.
+
+## Гарантії поведінки
+
+- Fail-open: жоден збій rtk/extension не блокує виконання команди агента.
+- Мутує лише `event.input.command` у pi tool_call — жодних записів у ФС чи мережевих викликів.

package/.pi-template/extensions/rtk.ts

@@ -0,0 +1,102 @@
+// RTK Pi extension — переписує bash-команди на rtk-еквіваленти для економії токенів.
+// Vendored з rtk (`rtk init --agent pi`, rtk 0.43.0), адаптований під конвенції репо:
+// без імпортів з '@earendil-works/pi-coding-agent' (пакет резолвиться лише в runtime pi,
+// а knip/TS-server проєктів-споживачів його не бачать) — типи описані локально, як у
+// n-rules-adr. Шлях установки `.pi/extensions/rtk.ts` збігається зі шляхом самого rtk —
+// повторний `rtk init --agent pi` ідемпотентний. Потребує rtk >= 0.23.0 у PATH; без
+// нього extension сам вимикається (fail-open).
+//
+// Тонкий делегат: уся rewrite-логіка живе в `rtk rewrite` (єдине джерело правди).
+//
+// Контракт exit-кодів `rtk rewrite`:
+//   0 + stdout  rewrite знайдено → мутуємо команду
+//   1           rtk-еквівалента немає → passthrough
+//   3 + stdout  rewrite (advisory) → мутуємо команду
+
+import { env } from 'node:process'
+
+interface PiToolCallEvent {
+  toolName?: string
+  input: { command?: unknown }
+}
+
+interface PiContext {
+  signal?: AbortSignal
+}
+
+interface PiExecResult {
+  code: number
+  stdout: string
+  killed?: boolean
+}
+
+interface PiApi {
+  exec: (cmd: string, args: string[], opts?: { timeout?: number; signal?: AbortSignal }) => Promise<PiExecResult>
+  on: (event: string, handler: (event: PiToolCallEvent, ctx: PiContext) => Promise<void> | void) => void
+}
+
+const REWRITE_TIMEOUT_MS = 2_000
+const MIN_SUPPORTED_RTK_MINOR = 23
+
+const SEMVER_RE = /(\d+)\.(\d+)\.(\d+)/
+const RTK_VERSION_PREFIX_RE = /^rtk\s+/
+
+// Парсить "X.Y.Z" semver → [major, minor, patch] або null.
+function parseSemver(raw: string): [number, number, number] | null {
+  const m = raw.trim().match(SEMVER_RE)
+  if (!m) return null
+  return [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)]
+}
+
+// Викликає `rtk rewrite`; повертає переписану команду або null (passthrough).
+async function rewriteCommand(pi: PiApi, cmd: string, signal?: AbortSignal): Promise<string | null> {
+  const result = await pi.exec('rtk', ['rewrite', cmd], {
+    timeout: REWRITE_TIMEOUT_MS,
+    signal
+  })
+  if (result.killed) return null
+  if (result.code !== 0 && result.code !== 3) return null
+  return result.stdout.trim() || null
+}
+
+export default async function (pi: PiApi) {
+  // Проба rtk при завантаженні; без бінарника (або із застарим) extension вимикається.
+  const ver = await pi.exec('rtk', ['--version'], { timeout: REWRITE_TIMEOUT_MS })
+  if (ver.code !== 0) {
+    console.warn('[rtk] rtk binary not found in PATH — extension disabled')
+    return
+  }
+
+  // `rtk rewrite` з'явився у 0.23.0 — старіші версії не підтримуються.
+  const parsed = parseSemver(ver.stdout.replace(RTK_VERSION_PREFIX_RE, ''))
+  if (parsed) {
+    const [major, minor] = parsed
+    if (major === 0 && minor < MIN_SUPPORTED_RTK_MINOR) {
+      console.warn(`[rtk] rtk ${ver.stdout.trim()} is too old (need >= 0.23.0) — extension disabled`)
+      return
+    }
+  }
+
+  pi.on('tool_call', async (event, ctx) => {
+    try {
+      // В upstream це isToolCallEventType('bash', event) — просте порівняння toolName.
+      if (event?.toolName !== 'bash') return
+
+      const cmd = event.input.command
+      if (typeof cmd !== 'string' || cmd.trim() === '') return
+
+      if (cmd.startsWith('rtk ')) return
+      if (env.RTK_DISABLED === '1') return
+
+      // Делегуємо rewrite-рішення rtk.
+      const rewritten = await rewriteCommand(pi, cmd, ctx.signal)
+      if (rewritten && rewritten !== cmd) {
+        event.input.command = rewritten
+      }
+    } catch (error) {
+      // Fail open: ніколи не блокуємо виконання через неочікувану помилку.
+      console.warn('[rtk] unexpected error in tool_call handler; passing through command', error)
+      return
+    }
+  })
+}

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.4.0] - 2026-07-15
+
+### Added
+
+- Нове правило `local-ai` (auto: завжди): інтеграція rtk (Rust Token Killer) для стискання виводу CLI-команд агентів. Sync вставляє fail-open PreToolUse hook у `.claude/settings.json` (`rtk hook claude`), preToolUse у `.cursor/hooks.json` (`rtk hook cursor`) та vendored pi-extension `.pi/extensions/rtk.ts`; від користувача потрібен лише `brew install rtk-ai/tap/rtk`. Вимкнення — `disable-rules: ["local-ai"]`.
+
+## [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

package/bin/n-rules.js

@@ -1458,6 +1458,7 @@ async function runSync() {
       }
       if (result.gitignoreAdr) parts.push('.gitignore (adr fragment)')
       if (result.piExtension) parts.push('.pi/extensions/n-rules-adr/')
+      if (result.rtkPiExtension) parts.push('.pi/extensions/rtk.ts')
       if (parts.length > 0) {
         console.log(`🤖 Claude-конфіг: ${parts.join(', ')}`)
       }

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.1",
+  "version": "1.4.0",
   "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: не виконує операцій запису (ФС/БД).