@7n/rules-ci-github 1.9.1 → 1.9.2

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

@@ -3,24 +3,31 @@ type: JS Module
 title: fix-vscode_settings.mjs
 resource: plugins/ci-github/rules/ga/vscode_settings/fix-vscode_settings.mjs
 docgen:
-  crc: 712711ff
+  crc: 39ecd7e7
   model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
   score: 100
-  issues: judge:inaccurate:0.97
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-`patterns` перевіряє та впорядковує `.vscode/settings.json` на відповідність очікуваному проєктному формату, спираючись на `settings.json`. Це потрібно, щоб редакторні налаштування залишалися в передбачуваному стані без ручних правок.
+`patterns` задає спільні налаштування VS Code для консюмер-репо відповідно до канонічного шаблону концерну `vscode_settings`. Це потрібно, щоб однаковий базовий набір налаштувань застосовувався узгоджено в усіх споживачах цього шаблону.
 
 ## Поведінка
 
-1. `patterns` визначає набір правил для узгодження `.vscode/settings.json` з очікуваним шаблоном проєкту.
-2. `patterns` потрібен, щоб автоматично тримати налаштування редактора в погодженому стані без ручного редагування кожного разу.
-3. `patterns` працює лише з конфігурацією `.vscode/settings.json`; інших шляхів або файлів у межах цього модуля не охоплює.
-4. `patterns` не виконує записів у файлову систему чи базу даних і не покладається на кешування.
+1. `patterns` задає один канонічний сценарій вирівнювання спільних VS Code-налаштувань у консюмер-репо з корпоративним шаблоном для `settings.json`.
+2. Якщо цільовий `settings.json` відсутній, він створюється на основі канонічного шаблону.
+3. Якщо `settings.json` уже існує, з нього зберігаються всі значення поза шаблоном, а канонічні налаштування концерну мають пріоритет і доповнюють або оновлюють спільну конфігурацію.
+4. Це гарантує, що репозиторії отримують однакову базову поведінку VS Code без втрати локальних несуперечливих налаштувань.
+
+## Публічний API
+
+- patterns — Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+`.vscode/settings.json` консюмер-репо — відсутні ключі додаються, канонічні
+значення мають пріоритет, ключі поза шаблоном не чіпаються; якщо файлу
+немає — створюється зі snippet-а.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.

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

@@ -1,5 +1,15 @@
+/**
+ * T0-фікс концерну vscode_settings: приводить спільні налаштування VS Code
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.vscode/settings.json` консюмер-репо — відсутні ключі додаються, канонічні
+ * значення мають пріоритет, ключі поза шаблоном не чіпаються; якщо файлу
+ * немає — створюється зі snippet-а.
+ */
 export const patterns = [
   createTemplateFixPattern({ id: 'ga-vscode_settings-template', targetPath: '.vscode/settings.json' })
 ]

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

@@ -3,26 +3,31 @@ type: JS Module
 title: fix-zizmor_yml.mjs
 resource: plugins/ci-github/rules/ga/zizmor_yml/fix-zizmor_yml.mjs
 docgen:
-  crc: df8c1663
+  crc: 9892e20a
   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 і не пише у ФС чи БД.
+`patterns` приводить `.github/zizmor.yml` до канонічного шаблону концерну для `zizmor`, щоб консюмер-репо залишалося узгодженим зі стандартизованим конфігом.
 
 ## Поведінка
 
-1. `patterns` задає набір правил для автоматичного виправлення конфігурації `zizmor` у репозиторії.
-2. Воно орієнтується на файл `.github/zizmor.yml` і застосовується лише до цього цільового місця.
-3. Під час роботи свідомо не зачіпає шляхи `.github` і `.git` поза визначеним цільовим файлом, щоб не втручатися в службові та інфраструктурні області.
-4. Працює у режимі read-only: саме значення `patterns` лише описує поведінку, без запису в файлову систему чи базу даних.
+1. `patterns` визначає один детермінований шаблон для вирівнювання `.github/zizmor.yml` із канонічним концерновим конфігом.
+2. Якщо цільовий файл відсутній, `patterns` ініціалізує його з канонічного snippet-а.
+3. Якщо файл уже існує, `patterns` додає відсутні ключі та зберігає канонічні значення як пріоритетні.
+4. `patterns` не чіпає коментарі й інші ключі поза шаблоном.
+
+## Публічний API
+
+- patterns — Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+`.github/zizmor.yml` консюмер-репо — відсутні ключі додаються, канонічні
+значення мають пріоритет, коментарі й ключі поза шаблоном не чіпаються;
+якщо файлу немає — створюється зі snippet-а.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
-- Свідомо пропускає шляхи: `.github`, `.git`.
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.

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

@@ -1,3 +1,13 @@
+/**
+ * T0-фікс концерну zizmor_yml: приводить конфіг сканера безпеки zizmor
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.github/zizmor.yml` консюмер-репо — відсутні ключі додаються, канонічні
+ * значення мають пріоритет, коментарі й ключі поза шаблоном не чіпаються;
+ * якщо файлу немає — створюється зі snippet-а.
+ */
 export const patterns = [createTemplateFixPattern({ id: 'ga-zizmor_yml-template', targetPath: '.github/zizmor.yml' })]

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

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

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

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/js/lint_js_yml
-resource: npm/rules/js/lint_js_yml/
+title: plugins/ci-github/rules/js/lint_js_yml
+resource: plugins/ci-github/rules/js/lint_js_yml/
 ---
 
 | Файл                                      | Тип       |

package/rules/js/lint_js_yml/fix-lint_js_yml.mjs

@@ -1,5 +1,15 @@
+/**
+ * T0-фікс концерну lint_js_yml: приводить CI-workflow лінту js-домену
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.github/workflows/lint-js.yml` консюмер-репо — відсутні ключі додаються,
+ * канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+ * чіпаються; якщо файлу немає — створюється зі snippet-а.
+ */
 export const patterns = [
   createTemplateFixPattern({ id: 'js-lint_js_yml-template', targetPath: '.github/workflows/lint-js.yml' })
 ]

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

@@ -3,28 +3,33 @@ type: JS Module
 title: fix-lint_k8s_yml.mjs
 resource: plugins/ci-github/rules/k8s/lint_k8s_yml/fix-lint_k8s_yml.mjs
 docgen:
-  crc: 7931d379
-  model: openai-codex/gpt-5.5
+  crc: e89c25eb
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
   score: 100
-  issues: judge:inaccurate:0.98
+  issues: judge-refine:kept-original,judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Надає `patterns` як read-only опис очікуваних збігів для перевірки репозиторію без змін у файловій системі чи інших сховищах. Свідомо пропускає `.github` і `.git`, щоб не аналізувати службові шляхи та зосереджувати перевірку на релевантному вмісті.
+Файл тримає канонічний сценарій оновлення CI workflow для лінту k8s-домену в consumer-репо, щоб `.github/workflows/lint-k8s.yml` приводився до шаблону концерну. Він існує, щоб звіряти workflow з канонічним snippet-ом концерну й застосовувати стандартний набір змін для цього сценарію, не виходячи за межі `.github` та `.git`.
 
 ## Поведінка
 
-1. `patterns` оголошує набір правил автоматичного виправлення для workflow перевірки Kubernetes YAML.
+1. `patterns` задає єдиний канонічний сценарій виправлення для CI workflow лінту k8s-домену.
+2. Під час застосування сценарію шаблон концерну зливається з `.github/workflows/lint-k8s.yml`: відсутні елементи додаються, а канонічні значення мають пріоритет.
+3. Якщо цільового файлу немає, `patterns` ініціює його створення з канонічного snippet-а.
+4. `patterns` навмисно не втручається в позатимплейтні ключі та коментарі, а також свідомо пропускає `.github` і `.git` як межі обробки.
 
-2. `patterns` забезпечує наявність стандартного шаблону `.github/workflows/lint-k8s.yml`, щоб репозиторій мав узгоджену CI-перевірку Kubernetes-маніфестів.
+## Публічний API
 
-3. `patterns` працює як read-only опис очікуваного виправлення: сам файл не виконує запис у файлову систему чи базу даних.
-
-4. `patterns` свідомо не охоплює обходом службові шляхи `.github` і `.git`; цільовий workflow у `.github/workflows/lint-k8s.yml` задається як конкретний шаблонний артефакт.
+- patterns — Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+`.github/workflows/lint-k8s.yml` консюмер-репо — відсутні ключі додаються,
+канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+чіпаються; якщо файлу немає — створюється зі snippet-а.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

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

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/k8s/lint_k8s_yml
-resource: npm/rules/k8s/lint_k8s_yml/
+title: plugins/ci-github/rules/k8s/lint_k8s_yml
+resource: plugins/ci-github/rules/k8s/lint_k8s_yml/
 ---
 
 | Файл                                        | Тип       |

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

@@ -1,5 +1,15 @@
+/**
+ * T0-фікс концерну lint_k8s_yml: приводить CI-workflow лінту k8s-домену
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.github/workflows/lint-k8s.yml` консюмер-репо — відсутні ключі додаються,
+ * канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+ * чіпаються; якщо файлу немає — створюється зі snippet-а.
+ */
 export const patterns = [
   createTemplateFixPattern({ id: 'k8s-lint_k8s_yml-template', targetPath: '.github/workflows/lint-k8s.yml' })
 ]

package/rules/npm-module/npm_publish_yml/docs/fix-npm_publish_yml.md

@@ -3,25 +3,35 @@ type: JS Module
 title: fix-npm_publish_yml.mjs
 resource: plugins/ci-github/rules/npm-module/npm_publish_yml/fix-npm_publish_yml.mjs
 docgen:
-  crc: 6db1ed6f
-  model: openai-codex/gpt-5.4-mini
+  crc: b7913c3f
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min-retry
   score: 100
-  issues: judge:inaccurate:0.98
+  issues: judge:error
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-`patterns` визначає правила зіставлення вмісту для `/.github/workflows/npm-publish.yml` у межах репозиторію. Файл потрібен, щоб узгоджувати цей workflow із очікуваною структурою та вмістом.
+Приводить конфігураційний файл `.github/workflows/npm-publish.yml` до канонічного шаблону концерну для забезпечення уніфікованого процесу публікації npm-пакетів у репозиторії-споживачі. Функція `patterns` забезпечує, що робочий процес включає необхідні параметри, при цьому ігноруючи каталоги `.github` та `.git`.
 
 ## Поведінка
 
-1. `patterns` формує набір правил для підтримання узгодженого стану шаблонного workflow-файла `/.github/workflows/npm-publish.yml`.
-2. `patterns` працює у режимі read-only: він не змінює ФС або БД.
-3. `patterns` свідомо не охоплює шляхи `.github` і `.git`, щоб не зачіпати службові каталоги репозиторію.
-4. `patterns` повертає готову конфігурацію для застосування до цільового файла, щоб стандартизувати його вміст у межах репозиторію.
+1. Приводить робочий процес (workflow) публікації npm-пакета в консюмер-репо до канонічного шаблону концерну шляхом застосування детермінованого патерну.
+2. Патерн працює з файлом `.github/workflows/npm-publish.yml`.
+3. Відсутні ключі в файлі додаються, а канонічні значення мають пріоритет; коментарі та ключі поза шаблоном не змінюються.
+4. Якщо вказаний файл не існує, він створюється на основі канонічного snippet-а.
+5. Процес не перевіряє шляхи `.github` та `.git`.
+6. Результат дії визначається масивом, експортованим через `patterns`.
+
+## Публічний API
+
+- patterns — Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+`.github/workflows/npm-publish.yml` консюмер-репо — відсутні ключі додаються,
+канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+чіпаються; якщо файлу немає — створюється зі snippet-а.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/npm-module/npm_publish_yml/docs/index.md

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/npm-module/npm_publish_yml
-resource: npm/rules/npm-module/npm_publish_yml/
+title: plugins/ci-github/rules/npm-module/npm_publish_yml
+resource: plugins/ci-github/rules/npm-module/npm_publish_yml/
 ---
 
 | Файл                                              | Тип       |

package/rules/npm-module/npm_publish_yml/fix-npm_publish_yml.mjs

@@ -1,5 +1,15 @@
+/**
+ * T0-фікс концерну npm_publish_yml: приводить workflow публікації npm-пакета
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.github/workflows/npm-publish.yml` консюмер-репо — відсутні ключі додаються,
+ * канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+ * чіпаються; якщо файлу немає — створюється зі snippet-а.
+ */
 export const patterns = [
   createTemplateFixPattern({
     id: 'npm-module-npm_publish_yml-template',

package/rules/php/lint_php_yml/docs/fix-lint_php_yml.md

@@ -3,25 +3,35 @@ type: JS Module
 title: fix-lint_php_yml.mjs
 resource: plugins/ci-github/rules/php/lint_php_yml/fix-lint_php_yml.mjs
 docgen:
-  crc: 8b0d8995
-  model: openai-codex/gpt-5.4-mini
+  crc: 0699f2b1
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
   score: 100
-  issues: judge:inaccurate:0.99
+  issues: judge:error
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-`patterns` описує правила для робочих шляхів у межах репозиторію та свідомо пропускає `.github` і `.git`. Функція працює read-only і не пише у ФС чи БД.
+Приводить конфігурації CI-workflow для PHP-домену у консюмер-репозиторії до канонічного шаблону концерну `lint_php_yml`. Гарантує відповідність YAML-файлів лінту встановленому стандарту, додаючи відсутні ключі та застосовуючи канонічні значення, зберігаючи при цьому вихідні коментарі та ключі, що не входять до шаблону. Це забезпечує єдність збірки та лінтування в системі.
 
 ## Поведінка
 
-1. `patterns` визначає набір правил для узгодженого виправлення шаблону `lint-php.yml` у межах репозиторію.
-2. `patterns` орієнтований на підтримку одного цільового workflow-файлу в `.github/workflows/lint-php.yml`, свідомо обходячи службові шляхи `.github` і `.git`.
-3. `patterns` працює в режимі read-only: він формує опис змін, але не виконує запис у файлову систему чи базу даних.
-4. `patterns` потрібен для стандартизації та відновлення очікуваного стану workflow-конфігурації без втручання в інші частини проєкту.
+1. Перевіряє файли, що знаходяться у каталозі `.github/workflows/lint-php.yml`.
+2. Використовує `patterns` для застосування канонічного шаблону концерну `lint_php_yml` до цільового файлу.
+3. При застосуванні шаблону відсутні ключі додаються, а канонічні значення мають пріоритет.
+4. Коментарі та ключі, які знаходяться поза шаблоном, залишаються без змін.
+5. Якщо файл цільового шляху відсутній, він створюється на основі наданого snippet-а.
+6. Ігнорує шляхи `.github` та `.git` під час перевірки.
+
+## Публічний API
+
+- patterns — Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+`.github/workflows/lint-php.yml` консюмер-репо — відсутні ключі додаються,
+канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+чіпаються; якщо файлу немає — створюється зі snippet-а.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/php/lint_php_yml/docs/index.md

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/php/lint_php_yml
-resource: npm/rules/php/lint_php_yml/
+title: plugins/ci-github/rules/php/lint_php_yml
+resource: plugins/ci-github/rules/php/lint_php_yml/
 ---
 
 | Файл                                        | Тип       |

package/rules/php/lint_php_yml/fix-lint_php_yml.mjs

@@ -1,5 +1,15 @@
+/**
+ * T0-фікс концерну lint_php_yml: приводить CI-workflow лінту php-домену
+ * у консюмер-репо до канонічного шаблону концерну.
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/**
+ * Один детермінований патерн: deep-merge канонічного snippet-а концерну в
+ * `.github/workflows/lint-php.yml` консюмер-репо — відсутні ключі додаються,
+ * канонічні значення мають пріоритет, коментарі й ключі поза шаблоном не
+ * чіпаються; якщо файлу немає — створюється зі snippet-а.
+ */
 export const patterns = [
   createTemplateFixPattern({ id: 'php-lint_php_yml-template', targetPath: '.github/workflows/lint-php.yml' })
 ]

package/rules/python/lint_python_yml/docs/fix-lint_python_yml.md

@@ -3,24 +3,37 @@ type: JS Module
 title: fix-lint_python_yml.mjs
 resource: plugins/ci-github/rules/python/lint_python_yml/fix-lint_python_yml.mjs
 docgen:
-  crc: 0408d343
-  model: openai-codex/gpt-5.4-mini
+  crc: 525f6959
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
   score: 100
-  issues: judge:inaccurate:0.99
+  issues: judge:error
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-`patterns` описує стандартні правила для роботи з workflow-файлами у репозиторії, щоб узгоджувати очікувану поведінку перевірок. Модуль свідомо пропускає `.github` і `.git`, залишається read-only та не змінює файлову систему чи базу даних.
+Файл декларує автофікс для `python/lint_python_yml`: scaffold відсутнього `.github/workflows/lint-python.yml` з канонічного шаблону правила та `template-deep-merge` для наявного workflow. Він потрібен, щоб дописувати лише канонічні поля для Python lint у GitHub Actions і зберігати локальні налаштування проєкту.
+
+Публічна точка входу: `patterns`. Свідомо пропущені шляхи: `.github`, `.git`. Власних операцій запису у файлі немає.
 
 ## Поведінка
 
-1. `patterns` формує перелік стандартних правил виправлення для `lint-python.yml`, щоб уніфікувати структуру цього workflow-файла.
-2. Під час роботи орієнтується на цільовий шлях `.github/workflows/lint-python.yml` і свідомо не зачіпає `.github` та `.git`.
-3. Працює в read-only режимі: сам не змінює файлову систему чи базу даних, а лише описує, що треба виправити.
+1. `patterns` оголошує автофікс для правила `python/lint_python_yml`, щоб репозиторій отримував канонічний GitHub Actions workflow для Python lint.
+
+2. Якщо `.github/workflows/lint-python.yml` відсутній, автофікс має створити його з шаблону правила.
+
+3. Якщо workflow уже існує, автофікс має доповнити його лише канонічними полями правила, не прибираючи локальні налаштування проєкту.
+
+4. Правило свідомо не обходить службові шляхи `.github` і `.git`, але працює з цільовим workflow-файлом як із винятком для підтримки потрібної CI-конфігурації.
+
+5. Файл лише декларує поведінку автофікса через `patterns`; власних операцій запису не виконує.
+
+## Публічний API
+
+- patterns — Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-python.yml`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/python/lint_python_yml/docs/index.md

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/python/lint_python_yml
-resource: npm/rules/python/lint_python_yml/
+title: plugins/ci-github/rules/python/lint_python_yml
+resource: plugins/ci-github/rules/python/lint_python_yml/
 ---
 
 | Файл                                              | Тип       |

package/rules/python/lint_python_yml/fix-lint_python_yml.mjs

@@ -1,5 +1,11 @@
+/**
+ * T0-autofix концерну `python/lint_python_yml`: деклараційний template-deep-merge —
+ * scaffold відсутнього `.github/workflows/lint-python.yml` з канонічного шаблону правила або
+ * дописування в наявний файл лише канонічних полів (локальні — зберігаються).
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/** Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-python.yml`. */
 export const patterns = [
   createTemplateFixPattern({ id: 'python-lint_python_yml-template', targetPath: '.github/workflows/lint-python.yml' })
 ]

package/rules/rust/lint_rust_yml/docs/fix-lint_rust_yml.md

@@ -3,25 +3,35 @@ type: JS Module
 title: fix-lint_rust_yml.mjs
 resource: plugins/ci-github/rules/rust/lint_rust_yml/fix-lint_rust_yml.mjs
 docgen:
-  crc: f61fcaec
-  model: openai-codex/gpt-5.4-mini
+  crc: 4312b7ec
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
   score: 100
-  issues: judge:inaccurate:0.99
+  issues: judge-refine:kept-original,judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Функція `patterns` описує правила для вибірки шляхів і логів, пов’язаних із Rust lint-конфігурацією, зокрема для `lint-rust.yml` та `workflow path filter`. Вона свідомо не охоплює `.github` і `.git`, щоб не зачіпати службові та внутрішні шляхи. Поведінка read-only: лише читає дані й формує результат без запису у ФС чи БД.
+Файл описує T0-autofix для `rust/lint_rust_yml`: scaffold відсутнього `.github/workflows/lint-rust.yml` з канонічного шаблону правила або `template-deep-merge` канонічних полів у наявний workflow зі збереженням локальних налаштувань.
+
+Публічна функція `patterns` декларує цю поведінку для правила. Обхід свідомо пропускає шляхи `.github` і `.git`, щоб не аналізувати службові директорії як джерела проєктного Rust-коду.
 
 ## Поведінка
 
-1. `patterns` формує набір правил для автоматичного виправлення lint-конфігурації Rust.
-2. `patterns` цільово охоплює workflow-файл `.github/workflows/lint-rust.yml`, щоб підтримувати його в узгодженому стані.
-3. `patterns` працює read-only щодо сховища: не змінює ФС чи БД, а лише описує, що саме треба виправити.
-4. `patterns` свідомо не зачіпає `.github` і `.git` як окремі шляхи поза визначеним цільовим файлом.
+1. `patterns` оголошує єдиний сценарій autofix для Rust lint workflow.
+
+2. Сценарій створює відсутній `.github/workflows/lint-rust.yml` за канонічним шаблоном правила, щоб проєкт мав стандартну GitHub Actions перевірку Rust lint.
+
+3. Якщо workflow уже існує, сценарій доповнює його лише канонічними полями, зберігаючи локальні налаштування проєкту.
+
+4. Autofix свідомо не обходить службові шляхи `.github` і `.git` як звичайні цілі аналізу; `.github/workflows/lint-rust.yml` використовується лише як визначений цільовий workflow-файл.
+
+## Публічний API
+
+- patterns — Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-rust.yml`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/rust/lint_rust_yml/docs/index.md

@@ -1,7 +1,7 @@
 ---
 type: Directory Index
-title: npm/rules/rust/lint_rust_yml
-resource: npm/rules/rust/lint_rust_yml/
+title: plugins/ci-github/rules/rust/lint_rust_yml
+resource: plugins/ci-github/rules/rust/lint_rust_yml/
 ---
 
 | Файл                                          | Тип       |

package/rules/rust/lint_rust_yml/fix-lint_rust_yml.mjs

@@ -1,5 +1,11 @@
+/**
+ * T0-autofix концерну `rust/lint_rust_yml`: деклараційний template-deep-merge —
+ * scaffold відсутнього `.github/workflows/lint-rust.yml` з канонічного шаблону правила або
+ * дописування в наявний файл лише канонічних полів (локальні — зберігаються).
+ */
 import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
 
+/** Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-rust.yml`. */
 export const patterns = [
   createTemplateFixPattern({ id: 'rust-lint_rust_yml-template', targetPath: '.github/workflows/lint-rust.yml' })
 ]

package/rules/rust/toolchain_cache/docs/index.md

@@ -1,11 +1,9 @@
 ---
 type: Directory Index
-title: npm/rules/rust/toolchain_cache
-resource: npm/rules/rust/toolchain_cache/
+title: plugins/ci-github/rules/rust/toolchain_cache
+resource: plugins/ci-github/rules/rust/toolchain_cache/
 ---
 
-# npm/rules/rust/toolchain_cache
-
 | Файл                                              | Тип       |
 | ------------------------------------------------- | --------- |
 | [fix-toolchain_cache.mjs](fix-toolchain_cache.md) | JS Module |