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

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

@@ -3,55 +3,43 @@ type: JS Module
 title: main.mjs
 resource: plugins/ci-github/rules/rust/toolchain_cache/main.mjs
 docgen:
-  crc: 0fcd7663
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  crc: e97443b2
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
   score: 100
-  issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Огляд
-Конструкція забезпечує перевірку у `.github/workflows/*.yml` того, що кожен job, що використовує `dtolnay/rust-toolchain@stable` для встановлення Rust toolchain, має подальший крок із кешуванням Rust за допомогою `Swatinem/rust-cache@v2`. Якщо job також виконує `tauri-apps/tauri-action` і `Cargo.toml` лежить у `src-tauri/`, кеш-крок повинен мати `with.workspaces` на цей каталог. Ця логіка контролюється згідно з принципами, описаними у (rust.mdc), використовуючи константи `MISSING_RUST_CACHE` та `MISSING_RUST_CACHE_WORKSPACES` для маркування відхилень.
-
-Поведінка
-MISSING_RUST_CACHE — константа-рядок, яка позначає відсутність необхідного кешування Rust toolchain.
-MISSING_RUST_CACHE_WORKSPACES — константа-рядок, що інформує про неправильну конфігурацію кешування для робочих просторів Rust.
-TOOLCHAIN_RE — визначення для ідентифікації кроків встановлення Rust toolchain.
-CACHE_RE — визначення для ідентифікації кроків, що використовують кешування Rust.
-scanToolchainSteps — аналізує вміст YAML-файлу workflow, виявляючи кроки встановлення toolchain та інформацію про кешування в межах одного job-а.
-tauriWorkspaceDir — визначає шлях до робочого простору Tauri, коли `Cargo.toml` не знаходиться в корені репозиторію.
-lint — сканує всі `.yml` та `.yaml` файли у каталозі `.github/workflows`, перевіряючи відповідність вимогам кешування.
-Інструмент працює лише з читанням конфігурацій (Read-only) та здійснює кешування інформації в межах поточного прогону.
+Файл виявляє у `.github/workflows/*.yml` job-и, де `dtolnay/rust-toolchain@stable` встановлює Rust toolchain без подальшого `Swatinem/rust-cache@v2`, щоб workflow не втрачали очікуване кешування Cargo-залежностей. Для job-ів із `tauri-apps/tauri-action` він додатково вимагає `with.workspaces` на `src-tauri/`, коли `Cargo.toml` лежить під `src-tauri/`, а не в корені репозиторію.
 
 ## Поведінка
 
-**Поведінка**
-MISSING_RUST_CACHE — константа, що позначає відсутність необхідного кешування Rust toolchain.
-MISSING_RUST_CACHE_WORKSPACES — константа, що позначає неправильну конфігурацію кешування для робочих просторів Rust.
-TOOLCHAIN_RE — регулярний вираз для ідентифікації кроків, що встановлюють Rust toolchain.
-CACHE_RE — регулярний вираз для ідентифікації кроків, що використовують кешування Rust.
-scanToolchainSteps — аналізує вміст YAML-файлу workflow, виявляючи кроки встановлення toolchain та інформацію про кешування в межах одного job-а.
-tauriWorkspaceDir — визначає шлях до робочого простору Tauri, якщо файл `Cargo.toml` не розташований у корені проєкту.
-lint — сканує всі `.yml` та `.yaml` файли в каталозі `.github/workflows`, перевіряючи, чи присутні необхідні кешування для кроків Rust toolchain, і повідомляє про відхилення. При цьому ігнорує каталоги .github та .git.
+`lint` запускає read-only перевірку GitHub Actions workflow-файлів. Дані з YAML-файлів передаються як текст, щоб зберегти коментарі й мінімізувати зміни формату; результатом є lint-повідомлення без власних записів у файлову систему.
+
+`scanToolchainSteps` проходить workflow-контент і знаходить кроки Rust toolchain за `TOOLCHAIN_RE`, після чого в межах того самого job-а шукає наступний cache-крок за `CACHE_RE`. Межа job-а визначається відступами, тому перевірка прив’язана до фактичної структури `steps`, а не до повного YAML-парсингу. Якщо cache-крок відсутній після встановлення toolchain, `lint` повертає порушення `MISSING_RUST_CACHE` зі значенням `"missing-rust-cache"` — job має додати `Swatinem/rust-cache@v2`.
+
+`tauriWorkspaceDir` додає проєктний контекст до текстового сканування: якщо Rust workspace розміщений у типовому Tauri-каталозі, а не в корені репозиторію, `lint` вимагає, щоб cache-крок у job-і з Tauri action мав окремо заданий workspace. За відсутності такого налаштування повертається порушення `MISSING_RUST_CACHE_WORKSPACES` зі значенням `"missing-rust-cache-workspaces"`.
 
 ## Публічний API
 
-Understood. As a technical writer adhering to the specified constraints, I will transform the provided list into concise, action-oriented behavioral documentation in Ukrainian, using only bulleted markers ("name — what it does"). I will avoid all introductory/concluding remarks, code blocks, signatures, types, parameters, stdlib mentions, regex descriptions, and internal private names.
+- MISSING_RUST_CACHE — Reason-код: job ставить Rust toolchain, але не має кроку `Swatinem/rust-cache@v2`.
+- MISSING_RUST_CACHE_WORKSPACES — Reason-код: кеш-крок Tauri-job-а без `with.workspaces` на каталог `src-tauri`.
+- TOOLCHAIN_RE — Рядок кроку встановлення Rust toolchain (`dtolnay/rust-toolchain@…`).
+- CACHE_RE — Рядок кроку кешування Cargo-артефактів (`Swatinem/rust-cache@…`).
+- scanToolchainSteps — Сканує вміст workflow-файла й повертає по одному запису на кожен
+`dtolnay/rust-toolchain@…` крок, з інформацією про cache-крок і tauri-action
+у тому самому job-і (обмежено indentation-dedent-ом).
+- tauriWorkspaceDir — Каталог Rust-workspace-а для `Swatinem/rust-cache` `with.workspaces`, якщо
+`Cargo.toml` не в корені репо, а під `src-tauri/` (типовий Tauri-layout).
+`undefined`, якщо корінь репо вже є workspace-коренем (окремий крок не потрібен).
+- lint — знаходить конфігурації Rust без потрібного cache для збірок і workspace, щоб CI не витрачав час на повторне завантаження залежностей.
 
-Here is the rewritten list:
+Поведінка: повідомлення маркуються як (rust.mdc), щоб порушення було прив’язане до правила Rust.
 
-*   MISSING_RUST_CACHE — Ідентифікатор, що позначає відсутність кешу Rust.
-*   MISSING_RUST_CACHE_WORKSPACES — Ідентифікатор, що позначає відсутність кешу для Rust-робочих просторів.
-*   TOOLCHAIN_RE — Маркер, що вказує на інструментарій.
-*   CACHE_RE — Маркер, що стосується механізму кешування.
-*   scanToolchainSteps — Виявляє всі етапи використання `dtolnay/rust-toolchain@…` у workflow-файлі, надаючи деталі про кешування та дії Tauri у відповідних завданнях.
-*   tauriWorkspaceDir — Вказує на шлях до Rust-робочого простору для кешування, якщо `Cargo.toml` знаходиться в `src-tauri/`, інакше — не визначений.
-*   lint — Здійснює перевірку коду на відповідність встановленим стандартам.
+Експортовані константи-рядки: MISSING_RUST_CACHE="missing-rust-cache" — позначає відсутній cache для Rust; MISSING_RUST_CACHE_WORKSPACES="missing-rust-cache-workspaces" — позначає відсутній cache для workspace-збірок Rust.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
-- Кешує результати в межах одного прогону.
-- Свідомо пропускає шляхи: `.github`, `.git`.
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.

package/rules/rust/toolchain_cache/main.mjs

@@ -20,10 +20,14 @@ import { join, relative } from 'node:path'
 
 import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
 
+/** Reason-код: job ставить Rust toolchain, але не має кроку `Swatinem/rust-cache@v2`. */
 export const MISSING_RUST_CACHE = 'missing-rust-cache'
+/** Reason-код: кеш-крок Tauri-job-а без `with.workspaces` на каталог `src-tauri`. */
 export const MISSING_RUST_CACHE_WORKSPACES = 'missing-rust-cache-workspaces'
 
+/** Рядок кроку встановлення Rust toolchain (`dtolnay/rust-toolchain@…`). */
 export const TOOLCHAIN_RE = /uses:\s*dtolnay\/rust-toolchain@/u
+/** Рядок кроку кешування Cargo-артефактів (`Swatinem/rust-cache@…`). */
 export const CACHE_RE = /uses:\s*Swatinem\/rust-cache@/u
 const TAURI_ACTION_RE = /uses:\s*tauri-apps\/tauri-action@/u
 const WORKSPACES_KEY_RE = /^\s*workspaces\s*:/u

package/rules/security/lint_security_yml/docs/fix-lint_security_yml.md

@@ -3,28 +3,30 @@ type: JS Module
 title: fix-lint_security_yml.mjs
 resource: plugins/ci-github/rules/security/lint_security_yml/fix-lint_security_yml.mjs
 docgen:
-  crc: dab1114f
-  model: openai-codex/gpt-5.5
+  crc: 7063b373
+  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` визначає межі пошуку в кодовій базі та свідомо оминає `.github` і `.git`, щоб перевірка не зачіпала службові каталоги. Правило працює в read-only режимі й не записує зміни у файлову систему або бази даних.
+Декларативний template-deep-merge для `security/lint_security_yml`, який або створює відсутній `.github/workflows/lint-security.yml` з канонічного шаблону правила, або доповнює наявний workflow лише канонічними полями. Пошук працює через `patterns` і свідомо пропускає `.github` та `.git`, тож правило не зачіпає ці шляхи під час автолікування. Це потрібно, щоб у репозиторії був узгоджений security-lint workflow.
 
 ## Поведінка
 
-1. `patterns` визначає правило автоматичного приведення workflow перевірки безпеки до еталонного шаблону.
+1. `patterns` задає єдине правило автолікування для `security/lint_security_yml`: воно готує канонічний шаблон для `.github/workflows/lint-security.yml`.
+2. Якщо цільового workflow-файлу немає, `patterns` ініціює його створення зі стандартною структурою правила.
+3. Якщо файл уже існує, `patterns` доповнює лише канонічні поля, не перетираючи локальні зміни.
+4. `patterns` свідомо не працює з шляхами `.github` і `.git`, щоб не зачіпати службові області репозиторію.
 
-2. Правило орієнтується на файл `.github/workflows/lint-security.yml`, щоб забезпечити наявність узгодженого процесу security lint у CI.
+## Публічний API
 
-3. Під час підбору файлів для загальної обробки свідомо пропускаються службові шляхи `.github` і `.git`, щоб не аналізувати інфраструктурні каталоги як звичайний код.
-
-4. Зміни не записуються напряму у файлову систему або зовнішні сховища: `patterns` лише описує доступне виправлення для подальшого застосування інструментом.
+- patterns — Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-security.yml`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/security/lint_security_yml/docs/index.md

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

package/rules/security/lint_security_yml/fix-lint_security_yml.mjs

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

package/rules/style/lint_style_yml/docs/fix-lint_style_yml.md

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

package/rules/style/lint_style_yml/docs/index.md

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

package/rules/style/lint_style_yml/fix-lint_style_yml.mjs

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

package/rules/text/lint_text/docs/fix-lint_text.md

@@ -3,25 +3,30 @@ type: JS Module
 title: fix-lint_text.mjs
 resource: plugins/ci-github/rules/text/lint_text/fix-lint_text.mjs
 docgen:
-  crc: 2e80cc96
+  crc: 78ee3182
   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` визначає, які текстові зміни вважаються придатними для узгодження з еталонною структурою workflow. Вона потрібна, щоб перевірка зосереджувалась на змісті потрібних файлів і не торкалась службових шляхів `.github` і `.git`.
+`patterns` підтримує `.github/workflows/lint-text.yml` у канонічному стані: створює відсутній workflow з канонічного шаблону правила або доповнює наявний файл декларативним template-deep-merge, зберігаючи локальні поля.
 
 ## Поведінка
 
-1. `patterns` формує набір правил для узгодження текстової перевірки з еталонною структурою workflow.
-2. Підготовлює виправлення для цільового файлу `.github/workflows/lint-text.yml`.
-3. Свідомо обходить службові шляхи `.github` і `.git`, щоб не зачіпати внутрішню інфраструктуру репозиторію.
-4. Працює лише на читання: не змінює файлову систему і не виконує запис у БД.
+1. `patterns` визначає набір правил для T0-autofix у концерні `text/lint_text` і запускає декларативне злиття шаблону для `.github/workflows/lint-text.yml`.
+2. Якщо цільовий workflow-файл відсутній, `patterns` ініціює його scaffold із канонічного шаблону правила.
+3. Якщо workflow-файл уже існує, `patterns` доповнює лише канонічні поля, не перезаписуючи локальні зміни.
+4. `patterns` працює в межах дозволених шляхів і свідомо пропускає `.github` та `.git`, щоб не зачіпати службові та службово-репозиторні області поза цим сценарієм.
+
+## Публічний API
+
+- patterns — Фікс-патерни концерну: один template-deep-merge запис для `.github/workflows/lint-text.yml`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/text/lint_text/docs/index.md

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

package/rules/text/lint_text/fix-lint_text.mjs

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