@7n/rules 1.43.1 → 1.44.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.44.0] - 2026-07-22
+
+### Added
+
+- концерн coverage правила test: гейт покриття/мутаційки як lint-детектор (--no-fix = CI-гейт), CoverageProvider порт у plugin-api (spec 2026-07-22 absorb-7n-test)
+
+### Changed
+
+- doc_comments rollout: header-JSDoc у vitest.config (T0 promote)
+- doc_comments rollout: header-JSDoc у vitest.config (T0 promote)
+- doc_comments rollout: header-JSDoc у vitest.config (T0 promote)
+- doc_comments rollout: header-JSDoc у vitest.config (T0 promote)
+- doc_comments rollout: header/export JSDoc у конфігах demo
+- doc_comments rollout: header-JSDoc у vitest.config
+
 ## [1.43.1] - 2026-07-22
 
 ### Fixed

package/docs/vitest.config.md

@@ -3,34 +3,29 @@ type: JS Module
 title: vitest.config.js
 resource: npm/vitest.config.js
 docgen:
-  crc: 2c54e477
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  crc: 4c85652a
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
   score: 100
-  issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Файл відповідає за налаштування середовища для виконання тестів. Він ідентифікує та обробляє файли з розширенням .test.{js,mjs} у корені та у піддиректоріях tests/. Для забезпечення ізоляції тестів використовується механізм фокусування процесів ('forks'). У процесі виконання збирається покриття коду у форматах lcov та text-summary. Середовище налаштовано так, щоб ігнорувати такі шляхи як .git та node_modules.
+Файл задає кореневе vitest-середовище для `@7n/rules`, щоб тестове оточення було ізольоване від локальної машини й службових trace-джерел. Він ігнорує `node_modules`, а також sandbox-копії Stryker і git-worktree чекаутів, щоб прогін тестів не захоплював зайві дерева проєкту. Також він відсікає вплив git trace2 і LLM-трейсу під час запусків, де це може спотворити результати.
 
 ## Поведінка
 
-Поведінка:
-
-1. Визначає обсяг тестів, що підлягають валідації, охоплюючи файли з розширенням .test.{js,mjs} як у кореневій директорії, так і у піддиректоріях tests/.
-2. Ігнорує каталоги node_modules та dist при виконанні тестів.
-3. Виключає каталоги, що містять звіти Stryker, для запобігання фейлам, спричинених запуском поза кореневим репозиторієм.
-4. Налаштовує середовище виконання тестів на 'node'.
-5. Примусово вимикає переслідування подій Git через встановлення змінної середовища GIT_TRACE2_EVENT в значення '0', щоб запобігти блокуванням I/O під час паралельних Git-операцій.
-6. Відводить глобальний LLM wire-trace у тимчасовий файл через змінну середовища N_LLM_TRACE_PATH: тести fix-pipeline ганяють реальний startChain/writeTrace з @7n/llm-lib/trace, і без override кожен прогін дописував би фейкові chain-записи у справжній ~/.n-rules/llm-trace.jsonl, засмічуючи аналітику myllm і chains-report. Тест із власним trace-файлом перевизначає змінну локально.
-7. Встановлює максимальний час виконання тесту (testTimeout) у 20000 мілісекунд для забезпечення запасу часу при виконанні складних тестів, залежних від I/O.
-7. Використовує pool 'forks' для ізоляції процесів між тестовими файлами, як додатковий механізм безпеки.
-8. Збирає покриття коду за допомогою провайдера v8 та виводить звіти у форматах lcov та text-summary.
+1. Вмикає тестове середовище для кореня пакета `@7n/rules`, щоб локальні налаштування машини не впливали на результат прогону.
+2. Підхоплює тести з двох основних розкладок: поруч із кодом і в top-level `tests/`.
+3. Ігнорує службові копії та дублікати тестового дерева, зокрема `node_modules`, `dist`, `reports/stryker`, `.worktrees` і `.claude/worktrees`, щоб не запускати ті самі сценарії повторно й не підхоплювати sandbox-чекаути.
+4. Вимикає git Trace2 для тестових процесів, щоб локальний AI/git-трейс не створював затримки й таймаути під час git-важких перевірок.
+5. Перенаправляє LLM wire-trace у тимчасову директорію, щоб тестові прогони не засмічували робочий trace-файл користувача.
+6. Дає тестам запас часу на повільніші git-операції та локальну I/O-латентність, не маскуючи справжні зависання.
+7. Запускає тести в окремих процесах, щоб ізоляція між файлами зберігалася навіть у разі випадкового спільного стану.
+8. Збирає coverage у форматах `lcov` і `text-summary` для подальшого аналізу результатів.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
-- Свідомо пропускає шляхи: `.git`, `node_modules`.
-
-Виключаються також git-worktree чекаути (`.worktrees/**`, `.claude/worktrees/**`) — повні копії репо, чиї тести дублюють основні.
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
+- Свідомо пропускає шляхи: `node_modules`.

package/package.json

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

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

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

package/rules/abie/lib/http-route.mjs

@@ -9,6 +9,7 @@ import { relative } from 'node:path'
 import { isK8sYamlInAbiePackageExcludingUaOverlay } from './overlay-paths.mjs'
 import { readAndParseYamlDocs, silentFail } from './yaml.mjs'
 
+/** Імена спільних headless-сервісів, на які HTTPRoute-и пакетів посилаються крізь namespace. */
 export const ABIE_SHARED_CROSS_NS_BACKEND_NAMES = Object.freeze(['auth-run-hl', 'file-link-hl'])
 const ABIE_SHARED_CROSS_NS_BACKEND_SET = new Set(ABIE_SHARED_CROSS_NS_BACKEND_NAMES)
 

package/rules/abie/lib/yaml.mjs

@@ -6,7 +6,9 @@ import { readFile } from 'node:fs/promises'
 
 import { parseAllDocuments } from 'yaml'
 
+/** Розпізнає modeline `yaml-language-server` з `$schema=` у першому рядку файлу; захоплює URL схеми. */
 export const MODELINE_RE = /^#\s*yaml-language-server:\s*\$schema=(\S+)\s*$/
+/** Поділ вмісту на рядки незалежно від стилю переносу (LF чи CRLF). */
 export const LINE_SPLIT_RE = /\r?\n/u
 
 /**

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

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

package/rules/ci4/marksman_config/main.mjs

@@ -6,7 +6,9 @@ import { fileURLToPath } from 'node:url'
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
+/** Абсолютний шлях до канонічного baseline-конфігу marksman, що постачається разом із пакетом правил. */
 export const MARKSMAN_BASELINE_PATH = join(HERE, 'data', 'marksman_config', 'marksman.baseline.toml')
+/** Імʼя конфіг-файлу marksman, який має лежати в корені репозиторію. */
 export const MARKSMAN_TARGET_FILENAME = '.marksman.toml'
 
 /**

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

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

package/rules/doc-files/docgen-prompts/main.mjs

@@ -4,6 +4,11 @@ import { env } from 'node:process'
 
 import { anchorsToPrompt } from '../docgen-extract-anchors/main.mjs'
 
+/**
+ * Спільний system-стиль для всіх docgen-промптів: вимагає лаконічну поведінкову
+ * українську документацію, забороняє сигнатури/типи й мета-фрази перед відповіддю
+ * (профілактика «озвучування завдання» малими моделями).
+ */
 export const STYLE = [
   'Ти технічний письменник. Пишеш лаконічну ПОВЕДІНКОВУ документацію до коду українською, чистим Markdown.',
   'Пиши ЩО і НАВІЩО, не ЯК. Без вступів і висновків. Не обгортай у ```-блок.',

package/rules/hasura/internal_urls/docs/index.md

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

package/rules/hasura/internal_urls/docs/main.md

@@ -3,34 +3,46 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/hasura/internal_urls/main.mjs
 docgen:
-  crc: 7b27e379
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
+  crc: 7e348cf3
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 95
+  issues: anchor-miss:(hasura.mdc),judge-refine:kept-original,judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Файл перевіряє конфігураційні файли `.env` у репозиторіях, що належать до екосистем https://github.com/nitra/ або https://github.com/abinbevefes/. Код спирається на конфігурацію, визначену у package.json. Його функція — валідувати відповідність конфігурацій, зокрема, через перевірку внутрішнього Hasura-ендпоінта (parseInternalHasuraEndpoint), щоб забезпечити коректну роботу системи. Звернення до мережі здійснюється для збору необхідної інформації, але всі операції обробляються з механізмами fail-safe, не викидаючи винятків. Для певних помилок функція повертає порожнє значення (наприклад, null) замість винятку, що регулюється у повідомленнях у (hasura.mdc).
+Файл обмежує правило lint лише nitra/abie репозиторіями й перевіряє, що `HASURA_GRAPHQL_ENDPOINT` в env-файлах вказує на очікуваний внутрішній Hasura endpoint. Він потрібен, щоб знаходити розсинхронізацію між env-конфігурацією та очікуваним endpoint-контрактом, свідомо не перевіряючи `base/` і нерелевантні репозиторії. Для перевірки файл звертається до мережі; помилки перехоплює fail-safe, не кидає винятків назовні і в окремих збійних сценаріях повертає `null` або інше порожнє значення замість винятку.
 
 ## Поведінка
 
-Поведінка
-parseInternalHasuraEndpoint розбирає рядок, щоб визначити внутрішній кластерний URL для Hasura, повертаючи сегменти або провалення, якщо формат некоректний.
-isEnvFile визначає, чи є заданий відносний шлях до файлу `.env`, що підлягає перевірці, виключаючи локальні файли розробника.
-isNitraOrAbieRepository перевіряє, чи вказує URL репозиторію на проєкти від https://github.com/nitra/ або https://github.com/abinbevefes/ (це стосується конфігів, як package.json).
-main виконує повну перевірку файлів `.env` у репозиторії, порівнюючи конфігурації з внутрішніми YAML-документами, якщо репозиторій належить до https://github.com/nitra/ або https://github.com/abinbevefes/, і повідомляє про порушення відповідно до (hasura.mdc).
+`lint` запускає перевірку від кореня репозиторію: спершу читає `package.json`, визначає належність проєкту через `isNitraOrAbieRepository` до nitra/abie за `https://github.com/nitra/` і `https://github.com/abinbevefes/`, а для інших репозиторіїв не створює порушень.
+
+Для релевантних проєктів `computeExpectedEndpointSegments` бере очікувані значення з Kubernetes YAML у `hasura/k8s/base`, після чого `lint` обходить дерево `.env`-файлів, свідомо пропускаючи `base/` та службово проігноровані шляхи. `isEnvFile` відсіює локальний `.env`, щоб правило не чіпало персональне середовище розробника.
+
+У кожному відібраному env-файлі `HASURA_ENDPOINT_LINE_RE` знаходить рядок з `HASURA_GRAPHQL_ENDPOINT`, а `parseInternalHasuraEndpoint` приймає лише внутрішній HTTP endpoint кластера й повертає сегменти для порівняння з очікуваними значеннями. Якщо змінної немає, файл вважається коректним.
+
+Результати сходяться назад у `lint`: успішні перевірки не впливають на звіт, а невідповідності перетворюються на violations із маркером ``. Помилки читання або некоректні допоміжні дані обробляються fail-safe: перевірка не кидає винятки назовні й за потреби працює з порожніми значеннями замість аварійного завершення.
 
 ## Публічний API
 
-- parseInternalHasuraEndpoint — Визначає, чи відповідний рядок формі внутрішнього URL для кластера: дозволяє лише `http://` та домен `*.internal` (наприклад, `abie-ua.internal`), повертаючи розбиті сегменти чи помилку.
-- isEnvFile — Визначає, чи вказаний шлях до файлу відповідає імені `.env`, що є винятком з правил `hasura.mdc`.
-- isNitraOrAbieRepository — Визначає, чи вказаний URL репозиторію належить до проектів nitra чи abie, згідно з маркерами `hasura.mdc`.
-- main — Аналізує файл `hasura.mdc` для поточної директорії.
+- HASURA_ENDPOINT_LINE_RE — Знаходить рядок присвоєння `HASURA_GRAPHQL_ENDPOINT` у env-файлі; захоплює значення URL без лапок і коментаря.
+- parseInternalHasuraEndpoint — Розбір значення `HASURA_GRAPHQL_ENDPOINT` як внутрішнього кластерного URL.
+Дозволяє лише `http://` (TLS усередині кластера зайвий) та DNS-суфікс
+`<cluster>.internal` (GKE/GCP). Поле `cluster` містить ім'я кластера без
+`.internal` (наприклад `abie-ua`).
+- isEnvFile — Чи відносний шлях вказує на `*.env`, який треба перевіряти hasura.mdc.
+Файл рівно `.env` (без імені) — виключення з правила (локальний файл
+розробника, hasura.mdc його не зачіпає), тому повертає false.
+- isNitraOrAbieRepository — Чи URL репозиторію вказує на nitra або abie (за маркерами hasura.mdc).
+- computeExpectedEndpointSegments — Обчислює очікувані `service`/`namespace` з `hasura/k8s/base/{svc-hl,namespace}.yaml`.
+Використовується і детектором, і T0-фіксом (щоб не дублювати YAML-читання).
+- lint — Перевіряє hasura.mdc для поточного робочого каталогу.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
 - За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
+- Свідомо пропускає шляхи: `base/`.

package/rules/hasura/internal_urls/main.mjs

@@ -18,6 +18,7 @@ const HASURA_SVC_HL_FILE = `${HASURA_BASE_DIR}/svc-hl.yaml`
 const HASURA_NAMESPACE_FILE = `${HASURA_BASE_DIR}/namespace.yaml`
 
 const ENV_FILE_RE = /\.env$/u
+/** Знаходить рядок присвоєння `HASURA_GRAPHQL_ENDPOINT` у env-файлі; захоплює значення URL без лапок і коментаря. */
 export const HASURA_ENDPOINT_LINE_RE =
   /^[ \t]*(?:export[ \t]+)?HASURA_GRAPHQL_ENDPOINT[ \t]*=[ \t]*['"]?([^'"\r\n#]+)/mu
 // Дозволяємо лише DNS-суфікс кластера `<name>.internal` (GKE/GCP).

package/rules/image-avif/avif_generation/docs/index.md

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

package/rules/image-avif/avif_generation/main.mjs

@@ -19,7 +19,9 @@ import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
 /** Стабільні reasons. */
 export const AVIF_NEEDS_REWRITE = 'avif-needs-rewrite'
+/** Стабільний reason: для растрового зображення відсутній згенерований AVIF-двійник. */
 export const AVIF_MISSING = 'avif-missing'
+/** Стабільний reason: AVIF-файл лишився без растрового джерела — кандидат на cleanup. */
 export const AVIF_ORPHAN = 'avif-orphan'
 
 /** Імʼя CLI-пакета, який генерує AVIF (використовує T0-fix). */

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

@@ -3,25 +3,27 @@ type: JS Module
 title: fix-vscode_settings.mjs
 resource: npm/rules/rego/vscode_settings/fix-vscode_settings.mjs
 docgen:
-  crc: ee88ec44
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
+  crc: 8007f6a6
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
   score: 100
-  issues: judge:inaccurate:0.96
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Файл визначає `patterns` для приведення settings.json до узгодженого вигляду в проєкті, щоб налаштування редактора залишалися однаковими між середовищами. Він працює лише з цим конфігом, є read-only і не вносить змін у ФС чи БД; застосування результату лишається зовнішньому кроку.
+`patterns` описує fix-правило для `.vscode/settings.json`, яке приводить файл до канону через deep-merge шаблону правила. Це потрібно, щоб застосувати налаштування канону й водночас не зачепити локальні налаштування користувача.
 
 ## Поведінка
 
-1. `patterns` формує набір правил для приведення `.vscode/settings.json` до узгодженого шаблону `rego-vscode_settings-template`.
-2. `patterns` працює лише з конфігурацією редактора, спираючись на `settings.json`, щоб підтримувати однакові налаштування в проєкті.
-3. `patterns` не виконує записів у ФС чи БД; результатом є опис поведінки для застосування змін зовні.
-4. `patterns` охоплює лише вказаний цільовий файл і не заявляє перевірку інших шляхів.
+1. `patterns` оголошує fix-поведінку для приведення `.vscode/settings.json` до проєктного канону.
+2. Правило додає або оновлює значення з шаблону, щоб середовище розробки мало узгоджені налаштування для всіх учасників.
+3. Локальні користувацькі налаштування зберігаються, щоб автоматичне виправлення не перезаписувало індивідуальні параметри, які не конфліктують із каноном.
+
+## Публічний API
+
+- patterns — Fix-патерни концерну: один шаблонний deep-merge у `.vscode/settings.json`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Файл експортує fix-патерни для `.vscode/settings.json` через шаблонний deep-merge.

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

@@ -1,5 +1,10 @@
+/**
+ * T0-fix концерну rego/vscode_settings: доводить `.vscode/settings.json` до канону
+ * deep-merge-ом шаблону правила, не зачіпаючи локальні налаштування користувача.
+ */
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
+/** Fix-патерни концерну: один шаблонний deep-merge у `.vscode/settings.json`. */
 export const patterns = [
   createTemplateFixPattern({ id: 'rego-vscode_settings-template', targetPath: '.vscode/settings.json' })
 ]

package/rules/tauri/cargo_mutants_config/docs/index.md

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

package/rules/tauri/cargo_mutants_config/docs/main.md

@@ -3,27 +3,53 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/cargo_mutants_config/main.mjs
 docgen:
-  crc: ae1727a0
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  crc: d73828f8
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 85
+  issues: internal-name:getMonorepoPackageRootDirs,anchor-miss:(tauri.mdc),judge-refine:kept-original,judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Ініціалізує процес через функцію `main`, а потім сканує робочу директорію для виявлення всіх каталогів з конфігурацією Tauri (`src-tauri/`). Для кожного знайденого каталогу перевіряє наявність файлу `.cargo/mutants.toml`, забезпечуючи його створення з канонічними налаштуваннями Tauri у разі відсутності. Якщо файл існує, він реєструє та додає відсутні канонічні ключі у конфігураційний файл, зберігаючи при цьому оригінальний вміст, і повідомляє про це через (tauri.mdc).
+Read-only detector: лише звітує про відсутній або неповний `<ws>/src-tauri/.cargo/mutants.toml` і про відсутні канонічні Tauri-ключі. Для створення чи augment baseline використовується окремий T0-fix `fix-cargo_mutants_config.mjs`, а не detector. `lint --no-fix` ніколи не мутує дерево; спільні білдери baseline/append-блоку винесені для T0 через `buildAppended` і `buildBaseline`, а набір еталонних ключів задають `TAURI_CANONICAL_KEYS` і `TAURI_KEY_SNIPPETS`.
 
 ## Поведінка
 
-Поведінка:
+findSrcTauriDirs відбирає лише ті workspace-корені, де є `src-tauri/Cargo.toml`, і саме ці каталоги стають входом для подальшої перевірки.
 
-1. Викликає `main` для ініціалізації процесу.
-2. Визначає всі каталоги, що містять конфігурацію Tauri (`src-tauri/`) у робочому просторі.
-3. Для кожного знайденого каталогу перевіряє наявність файлу `.cargo/mutants.toml`.
-4. Якщо файл відсутній, створює його, заповнюючи канонічними налаштуваннями Tauri. Повідомляє про створення файлу з маркером (tauri.mdc).
-5. Якщо файл присутній, виявляє та реєструє відсутні канонічні ключі в конфігурації.
-6. Якщо знайдені ключі відсутні, додає їх до існуючого файлу, зберігаючи原有 вміст. Повідомляє про додавання ключів з маркером (tauri.mdc).
-7. Якщо ключі присутні, зберігає існуючу конфігурацію без змін.
+lint проходить по знайдених `src-tauri/` каталогах, для кожного звіряє наявність `.cargo/mutants.toml` і зводить результат у read-only звіт без змін у дереві.
+
+detectMissingKeys порівнює наявний TOML із TAURI_CANONICAL_KEYS і повертає тільки відсутні канонічні ключі; порядок ключів у відповіді зберігається як у TAURI_CANONICAL_KEYS.
+
+MUTANTS_CONFIG_MISSING позначає повністю відсутній конфіг; MUTANTS_KEYS_MISSING — наявний файл із неповним набором канонічних ключів.
+
+TAURI_CANONICAL_KEYS визначає єдиний еталонний набір top-level ключів, а TAURI_KEY_SNIPPETS зберігає їхні канонічні текстові фрагменти; TAURI_BASELINE_HEADER задає верхівку повного baseline для нового файла.
+
+buildBaseline збирає повний canonical `.cargo/mutants.toml` з TAURI_BASELINE_HEADER і всіма фрагментами з TAURI_KEY_SNIPPETS, а buildAppended додає тільки відсутні ключі до вже існуючого вмісту, не чіпаючи решту файла.
+
+У звітах і підказках для виправлення використовується маркер ``, щоб пов’язати проблему з canonical Tauri-поведінкою та окремим T0-fix для baseline/augment.
+
+## Публічний API
+
+- MUTANTS_CONFIG_MISSING — Стабільний reason: файл mutants-конфігу відсутній узагалі.
+- MUTANTS_KEYS_MISSING — Стабільний reason: mutants-конфіг є, але бракує канонічних Tauri-ключів.
+- TAURI_BASELINE_HEADER — Шапка-коментар канонічного mutants-конфігу Tauri: пояснює, навіщо виключені збірки бінарника й doc-тестів.
+- TAURI_KEY_SNIPPETS — Канонічні TOML-фрагменти по ключах mutants-конфігу — T0-fix дописує відсутній ключ саме цим текстом.
+- TAURI_CANONICAL_KEYS — Перелік канонічних ключів, наявність яких перевіряється у mutants-конфігу Tauri-застосунку.
+- findSrcTauriDirs — Знаходить усі `<ws>/src-tauri/` каталоги з власним `Cargo.toml` у монорепо.
+Обходить workspace-пакети через `getMonorepoPackageRootDirs` (корінь + усі workspaces).
+- detectMissingKeys — Зчитує існуючий `.cargo/mutants.toml` і повертає top-level ключі, яких ще немає.
+- buildAppended — Будує append-блок з відсутніх ключів. Існуючий вміст не торкається.
+- buildBaseline — Будує повний Tauri-canonical baseline (для випадку, коли файла ще немає).
+- lint — запускає перевірку `mutants` для вказаного шляху, збирає результат у форматі, придатному для CI, і повертає помилку, якщо конфігурація або список ключів для перевірки відсутні.
+
+`MUTANTS_CONFIG_MISSING="mutants-config-missing"` — означає, що для запуску не знайдено потрібний конфіг `mutants`.
+
+`MUTANTS_KEYS_MISSING="mutants-keys-missing"` — означає, що не задано ключі, за якими треба виконати перевірку.
+
+Поведінка враховує маркери повідомлень `tauri.mdc`: якщо вони присутні, результат прив’язується до них для подальшого показу в UI.
 
 ## Гарантії поведінки
 

package/rules/tauri/cargo_mutants_config/main.mjs

@@ -16,15 +16,18 @@ import { parse as parseToml } from 'smol-toml'
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
-/** Стабільні reasons: файл відсутній / у файлі бракує канонічних Tauri-ключів. */
+/** Стабільний reason: файл mutants-конфігу відсутній узагалі. */
 export const MUTANTS_CONFIG_MISSING = 'mutants-config-missing'
+/** Стабільний reason: mutants-конфіг є, але бракує канонічних Tauri-ключів. */
 export const MUTANTS_KEYS_MISSING = 'mutants-keys-missing'
 
+/** Шапка-коментар канонічного mutants-конфігу Tauri: пояснює, навіщо виключені збірки бінарника й doc-тестів. */
 export const TAURI_BASELINE_HEADER = `# .cargo/mutants.toml — Tauri canonical cargo-mutants config (tauri.mdc).
 # Виключаємо --bins і --doc щоб бінарник Tauri та doc-tests не збиралися повторно
 # з нуля під кожного мутанта (секунди → хвилини).
 `
 
+/** Канонічні TOML-фрагменти по ключах mutants-конфігу — T0-fix дописує відсутній ключ саме цим текстом. */
 export const TAURI_KEY_SNIPPETS = Object.freeze({
   additional_cargo_test_args: 'additional_cargo_test_args = ["--lib", "--tests"]\n',
   exclude_globs: `# Platform bridge / app shell — boundary-файли (тестуються smoke/e2e, не mutation unit).
@@ -46,6 +49,7 @@ exclude_globs = [
 `
 })
 
+/** Перелік канонічних ключів, наявність яких перевіряється у mutants-конфігу Tauri-застосунку. */
 export const TAURI_CANONICAL_KEYS = Object.freeze(Object.keys(TAURI_KEY_SNIPPETS))
 
 /**

package/rules/tauri/core_test_isolation/docs/main.md

@@ -3,34 +3,37 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/core_test_isolation/main.mjs
 docgen:
-  crc: 2fe501fb
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: best-of-2:retry-won,judge:inaccurate:0.98
+  crc: 9d56f463
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 95
+  issues: anchor-miss:(core_test_isolation.mdc),judge-refine:kept-original,judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Файл сканує Tauri-проєкти у монорепо, виявляючи порушення ізоляції тестування, пов'язані з LLM-залежностями (позначається константою LLM_DEP_IN_APP_SHELL="llm-dep-in-app-shell") та залежностями від Tauri (позначається константою CORE_CRATE_DEPENDS_ON_TAURI="core-crate-depends-on-tauri"). Мета — ідентифікувати структурні проблеми, що ускладнюють швидкий запуск тестів окремих компонентів без повної збірки застосунку, про що свідчить маркер (core_test_isolation.mdc).
+Read-only lint `core_test_isolation.mdc` для Tauri-монорепо виявляє, чи LLM agent/provider-логіка винесена з `src-tauri` в окремий workspace-крейт без залежності на `tauri`. Файл існує, щоб через `lint` репортувати архітектурні порушення `LLM_DEP_IN_APP_SHELL`, `CORE_CRATE_DEPENDS_ON_TAURI` і `MISSING_FAKE_LLM_PROVIDER`, які заважають ізольовано запускати `cargo test -p <crate>` без повної збірки застосунку, і не намагається виправляти їх автоматично.
 
 ## Поведінка
 
-LLM_DEP_IN_APP_SHELL — Позначає виявлення LLM-залежності всередині основного shell-крейту Tauri, що ускладнює швидкий запуск тестів окремих компонентів.
-CORE_CRATE_DEPENDS_ON_TAURI — Позначає виявлення залежності LLM-крейта від Tauri, що змушує проводити повну збірку застосунку при тестуванні.
-MISSING_FAKE_LLM_PROVIDER — Позначає відсутність фальшивої (mock) реалізації LLM-провайдера у тестуваному крейті, що створює ризик неконтрольованого виконання LLM-логіки.
-lint — Сканує Tauri-проєкти у монорепо для виявлення порушень ізоляції тестування, пов'язаних з залежностями LLM та Tauri, звітуючи про проблеми у форматі (core_test_isolation.mdc).
+`lint` read-only проходить Tauri-проєкти в монорепо, знаходить каталоги `src-tauri/` з власним Cargo-маніфестом і перевіряє межу між app-shell та core agent/provider-логікою для LLM. Дані беруться з файлової структури й Cargo-маніфестів, а результатом є lint-звіт без змін у файлах.
+
+Перевірка спочатку визначає залежності app-shell крейту: якщо LLM-залежність підключена напряму в `src-tauri`, репортується `LLM_DEP_IN_APP_SHELL="llm-dep-in-app-shell"` — ознака того, що LLM-логіка не винесена з Tauri-шару. Далі для окремого workspace-крейту з LLM-залежністю перевіряється, що він не залежить від `tauri`; порушення позначається як `CORE_CRATE_DEPENDS_ON_TAURI="core-crate-depends-on-tauri"`, бо такий зв’язок ускладнює ізольований `cargo test` без повної збірки застосунку. Окремо очікується fake/mock/stub LLM-провайдер для тестів; його відсутність репортується як `MISSING_FAKE_LLM_PROVIDER="missing-fake-llm-provider"`.
+
+Повідомлення прив’язані до правила ``. Перевірка не виконує автофікс, бо безпечно винести крейт, перенести код і налаштувати тестову підміну неможливо механічно без ризику зламати архітектуру.
 
 ## Публічний API
 
-* LLM_DEP_IN_APP_SHELL — Надає чіткі причини, чому виникли три класичних порушень, пов'язаних з LLM.
-* CORE_CRATE_DEPENDS_ON_TAURI — Фіксує, що основний компонент залежить від Tauri.
-* MISSING_FAKE_LLM_PROVIDER — Позначає відсутність замінника для моделі штучного інтелекту.
-* lint — Виявляє та виправляє порушення, визначені в системному лінтері.
+- LLM_DEP_IN_APP_SHELL — Стабільний reason: LLM-залежність оголошена в app shell замість core-крейта.
+- CORE_CRATE_DEPENDS_ON_TAURI — Стабільний reason: core-крейт залежить від Tauri — ламає ізоляцію unit-тестів від runtime.
+- MISSING_FAKE_LLM_PROVIDER — Стабільний reason: у тестах core-крейта немає fake-провайдера LLM для роботи без мережі.
+- `lint` — виявляє порушення ізоляції core-тестів між LLM, Tauri та fake provider для тестового середовища.
+
+Експортовані константи-рядки: `LLM_DEP_IN_APP_SHELL="llm-dep-in-app-shell"` — порушення, коли app shell напряму залежить від LLM; `CORE_CRATE_DEPENDS_ON_TAURI="core-crate-depends-on-tauri"` — порушення, коли core crate прив’язується до Tauri; `MISSING_FAKE_LLM_PROVIDER="missing-fake-llm-provider"` — порушення, коли для тестів немає fake LLM provider.
 
-Поведінка
-Цей код використовує маркери повідомлень, що посилаються на `` для забезпечення ізоляції тестування.
+Поведінка: повідомлення позначаються маркером ``, щоб швидко пов’язати діагностику з правилом ізоляції тестів.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.

package/rules/tauri/core_test_isolation/main.mjs

@@ -17,9 +17,11 @@ import { createViolationReporter } from '../../../scripts/lib/lint-surface/viola
 import { findAncestorWorkspaceRoot, resolveWorkspaceMemberDirs } from '../../../scripts/utils/cargo-workspace.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
-/** Стабільні reasons для трьох типів порушення. */
+/** Стабільний reason: LLM-залежність оголошена в app shell замість core-крейта. */
 export const LLM_DEP_IN_APP_SHELL = 'llm-dep-in-app-shell'
+/** Стабільний reason: core-крейт залежить від Tauri — ламає ізоляцію unit-тестів від runtime. */
 export const CORE_CRATE_DEPENDS_ON_TAURI = 'core-crate-depends-on-tauri'
+/** Стабільний reason: у тестах core-крейта немає fake-провайдера LLM для роботи без мережі. */
 export const MISSING_FAKE_LLM_PROVIDER = 'missing-fake-llm-provider'
 
 /** Евристичний allowlist назв LLM SDK-крейтів (без версій/scope). */