npm - mjolnir-qa - Versions diffs - 5.0.0 → 6.0.0 - Mend

mjolnir-qa 5.0.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/CHANGELOG.md +2909 -15
package/README.md +81 -760
package/dist/cli.d.mts +459 -290
package/dist/cli.mjs +31329 -15271
package/dist/mcp/stdio.mjs +916 -228
package/package.json +59 -32
package/README.ar.md +0 -647
package/README.bn.md +0 -647
package/README.br.md +0 -647
package/README.bs.md +0 -647
package/README.da.md +0 -647
package/README.de.md +0 -647
package/README.es.md +0 -647
package/README.fr.md +0 -647
package/README.gr.md +0 -647
package/README.he.md +0 -647
package/README.it.md +0 -647
package/README.ja.md +0 -647
package/README.ko.md +0 -647
package/README.no.md +0 -647
package/README.pl.md +0 -647
package/README.ru.md +0 -647
package/README.th.md +0 -647
package/README.tr.md +0 -647
package/README.uk.md +0 -647
package/README.vi.md +0 -647
package/README.zh.md +0 -647
package/README.zht.md +0 -647
package/dist/scan-pipeline-DNYbnWjE.mjs +0 -2
package/dist/scan-pipeline-DT8DWAMl.mjs +0 -16501

package/README.uk.md DELETED Viewed

@@ -1,647 +0,0 @@
-<div align="center">
-<img src="assets/readme/hero.svg" alt="Mjölnir. Тести кажуть, що пройшло. Mjölnir каже, чому можна довіряти." width="100%" />
-<br />
-Mjölnir знаходить тести, які не можуть впасти, і пайплайни, які не можуть почервоніти,<br />
-а потім оцінює, наскільки можна довіряти результату, з доказом для кожного пункту.
-<br />
-[![npm](https://img.shields.io/npm/v/mjolnir-qa.svg?style=flat-square&color=1F6F7C&labelColor=0A1119)](https://www.npmjs.com/package/mjolnir-qa)
-[![downloads](https://img.shields.io/npm/dm/mjolnir-qa.svg?style=flat-square&color=1F6F7C&labelColor=0A1119)](https://www.npmjs.com/package/mjolnir-qa)
-[![ci](https://img.shields.io/github/actions/workflow/status/Sergey-Bar/Mjolnir/ci.yml?branch=main&style=flat-square&label=ci&labelColor=0A1119)](https://github.com/Sergey-Bar/Mjolnir/actions/workflows/ci.yml)
-[![coverage](https://img.shields.io/codecov/c/github/Sergey-Bar/Mjolnir?style=flat-square&color=1F6F7C&labelColor=0A1119&label=coverage)](https://codecov.io/gh/Sergey-Bar/Mjolnir)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Sergey-Bar/Mjolnir/badge)](https://scorecard.dev/viewer/?uri=github.com/Sergey-Bar/Mjolnir)
-[![license](https://img.shields.io/badge/license-MIT-1F6F7C.svg?style=flat-square&labelColor=0A1119)](LICENSE)
-[![node](https://img.shields.io/badge/node-%E2%89%A5%2022.18-1F6F7C.svg?style=flat-square&labelColor=0A1119)](https://nodejs.org)
-```bash
-npx mjolnir-qa@3.0.0
-```
-[Подивитися в роботі](#подивитися-в-роботі) · [Швидкий старт](#швидкий-старт) · [Що знаходить](#що-знаходить-mjölnir) · [Оцінка](#оцінка-надійності) · [Докази](#модель-доказів) · [Аналіз прогонів](#аналіз-прогонів-тестів) · [CI](#цілісність-ci) · [Агенти](#ші-агенти) · [Безпека](#довіра-і-безпека) · [Обмеження](#чого-mjölnir-сказати-не-може) · [Документація](#документація)
-<details>
-<summary>Читати іншою мовою — 22 переклади</summary>
-[English](README.md) | [简体中文](README.zh.md) | [繁體中文](README.zht.md) | [한국어](README.ko.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [Dansk](README.da.md) | [日本語](README.ja.md) | [Polski](README.pl.md) | [Русский](README.ru.md) | [Norsk](README.no.md) | [Português (Brasil)](README.br.md) | [ไทย](README.th.md) | [Türkçe](README.tr.md) | Українська | [বাংলা](README.bn.md) | [Ελληνικά](README.gr.md) | [Tiếng Việt](README.vi.md) | [עברית](README.he.md) | [العربية](README.ar.md) | [Bosanski](README.bs.md)
-> 🤖 Machine-assisted translation. The [English README](README.md) is canonical. Last synced: 2026-09-26.
-<!-- Source hash: `de04dfb1677b` -->
-</details>
-</div>
-<br />
-## Release status (English canonical)
-The published line is `3.0.0`; this working tree is the `4.0.0-rc.1`
-candidate. `3.0.0` must not be republished or retagged. The M26–M50 program is
-tracked in
-[`docs/ROADMAP.yaml`](docs/ROADMAP.yaml); provisional capability contracts
-are not automatically enabled or certified. Repository-owned checks pass, but
-Trust certification remains `NOT_CERTIFIED` until the protected holdout,
-real-world, platform/consumer, remote-workflow, support-matrix, and corpus
-evidence gates pass. Run `npm run m26:readiness` before treating any candidate
-as releasable. This document does not publish a tag or authorize a release.
-> Machine-assisted canonical text. Translate this block before treating it as localized copy.
-## Зелена галочка — це заява, а не доказ
-Зелена галочка означає, що пайплайн не впав. Вона не означає, що тести запускалися або що вони могли впасти. Кожен із цих випадків проходить зеленим:
-- закомічений `.only`, через який запустилося 3 тести замість 900
-- `continue-on-error: true` на джобі, яка мала блокувати
-- `|| true` після команди запуску тестів
-- тест, який нічого не перевіряє або має порожнє тіло
-- обгортка з повторами, яка перетворює справжній провал на випадковий успіх
-- звіт, який workflow завантажує, але ніколи не створював
-- жорсткий sleep, на якому тримається стан гонитви
-Жоден із них не робить пайплайн червоним, і кожен на рев'ю виглядає навмисним. Саме тому вони виживають. Ось як Mjölnir читає реальний приклад:
-<p align="center">
-  <img src="assets/readme/scan.svg" alt="CI-workflow демонстраційного репозиторію, прочитаний рядок за рядком. Mjölnir позначає кожну знахідку на вказаному рядку: правило, що не так, рівень доказовості та виміряну частку хибних спрацювань." width="800" />
-</p>
-<sub>Кожна знахідка, яку демонстраційне сканування видало для цього workflow, на вказаному рядку. Згенеровано командою `npm run docs:readme-brand` з [`demo-report.json`](assets/readme/demo-report.json) і захищено від розбіжностей у CI.</sub>
-**Суворий режим.** Найагресивніші детекції — `.only`, `continue-on-error`, порожні тести, зловживання повторами — живуть у карантинному ярусі. Вони запускаються лише з `--strict` і обмежені серйозністю `info`: позначають, але ніколи не блокують. Сканування за замовчуванням (`npx mjolnir-qa@3.0.0` без `--strict`) покриває лише основні та розширені правила. Додайте `--strict`, коли хочете і консультаційний шар.
-Mjölnir читає набір тестів, CI-workflow і, якщо він є, звіт реального прогону. Він не запускає ваші тести, не встановлює залежності й не виконує код, який сканує. А коли доказів немає, він так і каже, замість того щоб вигадувати впевненість:
-| Ситуація                                              | Що повідомляє Mjölnir                                                 |
-| ----------------------------------------------------- | --------------------------------------------------------------------- |
-| Оголошень тестів не знайдено                          | Оцінка `null`, відображається як **UNKNOWN**. Ніколи не вигадані 100. |
-| Немає базової лінії або порівнянної ревізії           | **UNKNOWN**, із зазначеною причиною. Ніколи не припущений 0.          |
-| Сканування перервано (ліміт часу, нечитабельні файли) | **PARTIAL**, код виходу `2`. Ніколи не видається за чистий результат. |
-<p align="center">
-  <img src="assets/readme/how-it-works.svg" alt="Як працює Mjölnir. Він статично читає набір тестів і CI-пайплайн, а також звіт реального прогону, якщо він є. Кожну знахідку він зважує за рівнем доказовості та рівнем довіри, причому лише реальний прогін може досягти L3–L5, і видає знахідки, оцінку надійності та CI-гейт із замороженими кодами виходу. У циклі агента ШІ пише виправлення, а Mjölnir сканує повторно, щоб його довести." width="880" />
-</p>
-<sub>Створено для цієї сторінки й показано в масштабі 1:1. Згенеровано командою `npm run docs:readme-brand` і захищено від розбіжностей у CI; оцінка, лічильники та ID правила беруться з [`script.demo.json`](assets/video/script.demo.json), [`demo-report.json`](assets/readme/demo-report.json) і реєстру правил, ніколи не вводяться вручну. Те саме зображення у вигляді постера: [`architecture.svg`](assets/readme/architecture.svg).</sub>
-<br />
-## Подивитися в роботі
-Реальне сканування [`examples/demo-repo`](examples/demo-repo), невеликого набору тестів Playwright із CI-workflow. Ось куди пішли його бали:
-<p align="center">
-  <img src="assets/readme/terminal-hero.svg" alt="Розбивка вирахувань Mjölnir: WORTHINESS 80/100 WORTHY, оцінка за категоріями, блок вирахувань за серйозністю та список FIX THIS FIRST" width="520" />
-</p>
-<sub>Згенеровано командою `npm run docs:hero` з реального сканування і захищено від розбіжностей у CI. Повний звіт `--verbose` того самого сканування — [`demo.svg`](assets/readme/demo.svg) (`npm run docs:demo`).</sub>
-<details>
-<summary><strong>Дивитися</strong> — сканування, виправлення, яке воно виводить, і повторне сканування, яке його доводить</summary>
-<br />
-<p align="center">
-  <a href="assets/video/mjolnir-demo.mp4">
-    <img src="assets/video/mjolnir-demo-poster.png" alt="Кадр демонстраційного запису: npx mjolnir-qa@3.0.0 сканує демонстраційний репозиторій у вікні термінала" width="900" />
-  </a>
-</p>
-<sub>Відрендерено кадр за кадром з реального сканування командою `npm run docs:video`; ніколи не записувалося з екрана. Виберіть кадр, щоб відкрити [`mjolnir-demo.mp4`](assets/video/mjolnir-demo.mp4).</sub>
-</details>
-### Одна знахідка зблизька
-Кожна знахідка відповідає на чотири запитання: де вона, наскільки Mjölnir упевнений, як часто правило помиляється і як це виправити.
-<p align="center">
-  <img src="assets/readme/finding-anatomy.svg" alt="Перша знахідка демонстраційного сканування, саме так, як її виводить термінал, із позначеними чотирма частинами: де, наскільки впевнено, як часто правило помиляється, і виправлення." width="100%" />
-</p>
-`mjolnir explain QA-CI-001` виводить повне досьє довіри правила, зокрема виміряну частку хибних спрацювань і рівень, який ця частка йому забезпечила:
-```text
-  ▍ QA-CI-001 — continue-on-error masks a failing verification gate
-Severity:    error
-Confidence:  high
-Tier:        quarantine
-Evidence:    E2
-QA impact:   False-green risk (FALSE-GREEN)
-Measured FP: 11% (19 hand-classified corpus verdicts)
-FP risk:     low (author estimate)
-Languages:   yaml
-Frameworks:  github-actions, azure-pipelines
-WHAT WAS FOUND (real detector output, not a mockup)
-  Job `security-scan` runs a verification gate under `continue-on-error: true`.
-WHY IT MATTERS
-  This job can fail every day and CI will still show green. The checkmark on
-  this workflow cannot be trusted.
-HOW TO FIX
-  Remove continue-on-error, or scope it to individual non-blocking steps only.
-  Example from this rule's own must-fire fixture: QA-CI-001/must-fire/masked.yml
-WHAT WOULD CHANGE THE VERDICT
-  - a run report next to the scan target (mjolnir.report.json or test-results/)
-  corroborating this file lifts its findings to L3–L5
-  - a documented suppression (mjolnir.config.json) lowers the finding count
-  without claiming correctness
-  - quarantine findings run only under --strict and are advisory (E0) — they can
-  never gate CI
-NEXT ACTION
-  Fix the first occurrence, then re-run: `mjolnir --scope changed`. Every
-  occurrence of this rule is listed in the scan output.
-HOW TO VERIFY THE FIX
-  Re-run `mjolnir` on the changed file(s) — this finding should no longer
-  appear. `mjolnir --scope changed` scopes the check to just what you touched.
-Docs: mjolnir rules --md   (full catalog, this rule included)
-```
-Ось одиниця цінності: одне місце, де CI повідомляє про успіх, якого не заслужив.
-<br />
-## Швидкий старт
-```bash
-npx mjolnir-qa@3.0.0
-```
-Він сканує поточний каталог і виводить Trust Report: що знайдено, наскільки цьому можна довіряти, чому і що робити далі. Він завершується з кодом `0`, якщо на рівні гейта або вище нічого не знайдено.
-У CI скануйте лише те, що внесла гілка, щоб успадкований набір тестів не втопив ваш перший pull request:
-```bash
-npx mjolnir-qa@3.0.0 --scope changed
-```
-`mjolnir ci install` записує це як workflow GitHub Actions з [action](https://github.com/Sergey-Bar/Mjolnir#readme), закріпленим на мажорному тезі `v3` (або просто `npx` з `--no-action`). Він залишається рекомендаційним, доки ви не вирішите, що він має блокувати.
-| Команда                                       | Що робить                                                  |
-| --------------------------------------------- | ---------------------------------------------------------- |
-| `mjolnir`                                     | Trust Report: вердикт, упевненість, наступна дія           |
-| `mjolnir --scope changed`                     | Лише те, що внесла ваша гілка (варіант для CI)             |
-| `mjolnir ci install`                          | Створює рекомендаційний workflow для PR (на основі action) |
-| `mjolnir business-case`                       | ROI estimate: projected savings per finding                |
-| `mjolnir release-report`                      | Release readiness: GO, CONDITIONAL GO, or NO-GO            |
-| `mjolnir release-trust`                       | 12-dimension release assurance verdict                     |
-| `mjolnir report`                              | Generate a Playwright-compatible report                    |
-| `mjolnir trend`                               | Record, show, or diff local quality snapshots              |
-| `mjolnir policy`                              | Initialize, validate, or check policy gates                |
-| `mjolnir quarantine`                          | Review deterministic proposals (prototype)                 |
-| `mjolnir analyze --cross-file`                | Bounded cross-file analysis                                |
-| `mjolnir ci-adapter github .`                 | Generate CI templates for supported providers              |
-| `mjolnir dashboard`                           | Generate a self-contained quality dashboard                |
-| `mjolnir exec-report`                         | Executive KPIs and recommendations (advisory)              |
-| `mjolnir enterprise`                          | Self-hosted templates (prototype)                          |
-| `mjolnir maturity`                            | Assess maturity or display maturity levels                 |
-| `mjolnir mutation tests/mutation-report.json` | Analyze mutation reports; never promotes trust             |
-| `mjolnir mcp`                                 | Read-only MCP tools over stdio                             |
-| `mjolnir explain QA-CI-001`                   | Що, чому і як виправити, плюс виміряна частка FP           |
-| `mjolnir why src/a.spec.ts:42`                | Чому позначено саме цей рядок. Ніколи не блокує.           |
-| `mjolnir forensics ./test-results/`           | Докази з реального прогону                                 |
-| `mjolnir trust-report`                        | Самодостатній Trust Artifact (md + json)                   |
-| `mjolnir handoff`                             | План виправлень для агента-програміста                     |
-| `mjolnir --json` / `--format sarif`           | Машинозчитуваний вивід, GitHub Code Scanning               |
-| `mjolnir --format codequality`                | Звіт GitLab Code Quality (артефакт віджета MR)             |
-| `mjolnir --strict`                            | Також запускає правила рівня quarantine (вищий ризик FP)   |
-<details>
-<summary><strong>Усі інші команди</strong> — розбір нестабільних тестів, звіти, контроль</summary>
-<br />
-| Команда                             | Що робить                                                                       |
-| ----------------------------------- | ------------------------------------------------------------------------------- |
-| `mjolnir --classic`                 | Банер оцінки з часів до Trust Report                                            |
-| `mjolnir explain verdict`           | Чому вердикт збереженого сканування саме такий                                  |
-| `mjolnir triage ./test-results/`    | Покроковий розбір. Кожен рядок завершується наступною дією.                     |
-| `mjolnir pw-report ./test-results/` | Зведення прогону Playwright: повтори, нестабільні тести, найповільніші          |
-| `mjolnir doctor:playwright`         | Глибоке сканування лише для Playwright плюс Selector Health Score               |
-| `mjolnir fix --dry-run` / `fix`     | Безпечні автовиправлення, кожне пересканується, щоб довести, що воно спрацювало |
-| `mjolnir baseline` / `diff`         | Знімок знахідок, потім звіт лише про нові або погіршені                         |
-| `mjolnir impact --since <ref>`      | Що вніс і що виправив коміт                                                     |
-| `mjolnir summary`                   | Анотації CI і зведення кроку на основі звіту                                    |
-| `mjolnir pr-comment`                | Коментар до PR у межах змін, у форматі Markdown                                 |
-| `mjolnir debt`                      | Реєстр тестового боргу з моделлю витрат                                         |
-| `mjolnir handover`                  | Карта набору тестів для нового QA-інженера                                      |
-| `mjolnir init`                      | Визначає фреймворки, виводить чекліст налаштування                              |
-| `mjolnir suppressions`              | Список придушених знахідок для контролю                                         |
-| `mjolnir rules --unmeasured`        | Правила, що працюють на припущенні, а не на вимірюванні                         |
-| `mjolnir rules --md`                | Повний каталог правил (JSON або Markdown)                                       |
-| `mjolnir doctor`                    | Самоаудит власної бази правил Mjölnir                                           |
-| `mjolnir create-rule <ID>`          | Створює заготовку нового правила та його фікстур                                |
-| `mjolnir stats`                     | Локальні лічильники всіх помічених виправлень                                   |
-| `mjolnir badge`                     | JSON для ендпоінта shields.io і фрагмент коду                                   |
-| `mjolnir --cache`                   | Інкрементальні пересканування через локальний кеш вердиктів                     |
-| `mjolnir --format mermaid`          | Діаграма архітектури тестів для коментаря до PR                                 |
-`mjolnir help <command>` виводить використання, приклади та наступний крок для будь-якої з них.
-</details>
-Потрібен **Node.js ≥ 22.18** на Windows, macOS або Linux. Віддаєте перевагу глобальному встановленню? `npm i -g mjolnir-qa`. Мінімальна версія визначається інструментами збирання (tsdown орієнтований на неї, а пайплайн релізів проганяє на ній smoke-тести); залежностям часу виконання більшого не потрібно.
-<br />
-## Що знаходить Mjölnir
-<p align="center">
-  <img src="assets/readme/stack.svg" alt="Працює з вашим стеком: мови, тестові фреймворки та CI-системи, які покривають його правила, за даними реєстру правил." width="100%" />
-</p>
-**79 правил** у чотирьох родинах — гігієна тестів, якість тестів, Playwright і цілісність CI — для TypeScript і JavaScript, Python, Java, C# та YAML GitHub Actions. Вони охоплюють Playwright у всіх чотирьох прив'язках, а також pytest, JUnit, TestNG, NUnit, xUnit, MSTest, Jest, Vitest і Mocha, з початковим покриттям Cypress і Selenium. Дев'ять із них, щоб показати загальний вигляд:
-| ID           | Правило                                                                 | Серйозність | Рівень     |
-| ------------ | ----------------------------------------------------------------------- | ----------- | ---------- |
-| QA-CI-001    | `continue-on-error` маскує гейт перевірки, що падає                     | error       | quarantine |
-| QA-CI-009    | Код виходу тестів не передається далі (`\|` без pipefail, ланцюжки `;`) | error       | extended   |
-| QA-TEST-001  | Закомічено сфокусований тест (`.only`, `fit`)                           | error       | quarantine |
-| QA-TEST-003  | Тест без тверджень                                                      | error       | quarantine |
-| QA-TQUAL-009 | Твердження на promise без await                                         | error       | quarantine |
-| QA-PW-002    | Твердження на локаторі без await                                        | error       | core       |
-| QA-PW-004    | Крихкі селектори CSS/XPath                                              | warning     | quarantine |
-| QA-PY-002    | Пропущений тест (`skip`, нестрогий `xfail`)                             | warning     | core       |
-| QA-CS-103    | Тестовий метод без тверджень                                            | error       | core       |
-Повний каталог генерується з реєстру й ніколи не ведеться вручну: `mjolnir rules --md`, [`docs/rules/`](docs/rules/) або [посібник про те, що він перевіряє](https://sergey-bar.github.io/Mjolnir/guide/what-it-checks).
-<details>
-<summary><strong>Усі правила, згадані в цьому README</strong>, в одній таблиці</summary>
-<br />
-> Правила `quarantine` запускаються лише з `--strict` і ніколи не блокують (їхній рівень обмежено info). Показано серйозність, задану автором.
-| ID           | Родина     | Правило                                                             | Серйозність | Рівень     |
-| ------------ | ---------- | ------------------------------------------------------------------- | ----------- | ---------- |
-| QA-TEST-001  | Гігієна    | Закомічено сфокусований тест (`.only`, `fit`)                       | error       | quarantine |
-| QA-TEST-002  | Гігієна    | Пропущений тест. Без відстежуваної причини підвищується до `error`. | warning     | quarantine |
-| QA-TEST-003  | Гігієна    | Тест без тверджень                                                  | error       | quarantine |
-| QA-TEST-004  | Гігієна    | Жорсткий sleep (`waitForTimeout`, `sleep()`, `delay()`)             | warning     | extended   |
-| QA-TEST-006  | Гігієна    | Зловживання повторами, що приховує нестабільність                   | warning     | quarantine |
-| QA-TEST-010  | Гігієна    | Порожнє тіло тесту                                                  | error       | quarantine |
-| QA-TQUAL-002 | Якість     | Тавтологічне твердження                                             | error       | quarantine |
-| QA-TQUAL-009 | Якість     | Твердження на promise без await                                     | error       | quarantine |
-| QA-TQUAL-011 | Якість     | Закоментовані тести                                                 | warning     | extended   |
-| QA-PW-002    | Playwright | Твердження на локаторі без await                                    | error       | core       |
-| QA-PW-003    | Playwright | Закомічено `page.pause()` / `test.only()`                           | error       | core       |
-| QA-PW-004    | Playwright | Крихкі селектори CSS/XPath                                          | warning     | quarantine |
-| QA-PW-123    | Playwright | Жорстко задані URL оточень                                          | warning     | quarantine |
-| QA-PW-140    | Playwright | Скриншот без `maxDiffPixelRatio`                                    | warning     | core       |
-| QA-CI-001    | CI         | `continue-on-error` маскує гейт, що падає                           | error       | quarantine |
-| QA-CI-002    | CI         | `\|\| true` ковтає коди виходу                                      | error       | extended   |
-| QA-CI-005    | CI         | Звіт використовується, але ніколи не створюється                    | error       | quarantine |
-| QA-CI-007    | CI         | Обгортки з повторами навколо тестів                                 | warning     | extended   |
-| QA-CI-008    | CI         | Завжди успішний крок маскує падіння                                 | error       | quarantine |
-| QA-CI-009    | CI         | Код виходу не передається далі (`\|` без pipefail, ланцюжки `;`)    | error       | extended   |
-| QA-CI-010    | CI         | Тести пропускаються там, де мають блокувати                         | error       | quarantine |
-| QA-PY-002    | Python     | Пропущений тест (`skip`, нестрогий `xfail`)                         | warning     | core       |
-| QA-PY-003    | Python     | Тестова функція без тверджень                                       | error       | quarantine |
-| QA-PY-005    | Python     | `time.sleep()` у тестах                                             | warning     | extended   |
-| QA-PY-012    | Python     | Тавтологічне твердження                                             | error       | quarantine |
-| QA-JV-101    | Java       | Вимкнений тест (`@Disabled`)                                        | warning     | core       |
-| QA-JV-102    | Java       | Жорсткий sleep (`Thread.sleep()`)                                   | warning     | extended   |
-| QA-JV-103    | Java       | Тестовий метод без тверджень                                        | error       | extended   |
-| QA-JV-105    | Java       | Жорсткий sleep через `waitForTimeout()` у Playwright                | warning     | core       |
-| QA-JV-106    | Java       | Крихкий селектор замість локатора за роллю                          | warning     | quarantine |
-| QA-CS-101    | C#         | Пропущений тест (`[Ignore]`, `[Fact(Skip=)]`)                       | warning     | core       |
-| QA-CS-102    | C#         | Жорсткий sleep (`Thread.Sleep` / `Task.Delay`)                      | warning     | core       |
-| QA-CS-103    | C#         | Тестовий метод без тверджень                                        | error       | core       |
-| QA-CS-105    | C#         | Жорсткий sleep через `WaitForTimeoutAsync()`                        | warning     | extended   |
-| QA-CS-106    | C#         | Крихкий селектор замість локатора за роллю                          | warning     | quarantine |
-Для Python також є QA-PY-001…012 (гігієна pytest) і QA-PY-101…108 (Playwright для Python). Cypress і Selenium мають стартові набори по три правила.
-</details>
-Кожне правило постачається з фікстурою must-fire **і** фікстурою must-not-fire, а правило, що спрацьовує на власній негативній фікстурі, не може бути випущене. Це захист від хибних спрацювань; `mjolnir doctor` забезпечує його у власному CI цього репозиторію.
-### Selector Health Score
-`mjolnir doctor:playwright` оцінює кожен локатор за тим, як він знаходить елемент: так, як це зробив би користувач (роль, мітка, текст), через явний контракт (`data-testid`) або через структурну випадковість (ланцюжки CSS, XPath). Кожен файл отримує оцінку від 0 до 100:
-```text
-  ▍ SELECTOR HEALTH
-e2e/login.spec.ts
-  [█████████████░░░░░░░]  65 / 100
-  role/text: 1 · testid: 0 · plain-css: 0 · css-chains: 1 ⚠ · xpath: 0
-e2e/checkout.spec.ts
-  [██████████████████░░]  88 / 100
-  role/text: 4 · testid: 1 · plain-css: 0 · css-chains: 1 ⚠ · xpath: 0
-```
-Це вимірює **стійкість, а не коректність**. `.btn.btn-primary > div:nth-child(2)` проходить сьогодні й проходитиме, доки хтось не торкнеться розмітки. Низька оцінка ніколи не стверджує, що тест зламаний, — лише що він залежить від розмітки, яку ніхто не обіцяв зберігати.
-<br />
-## Оцінка надійності
-<p align="center">
-  <img src="assets/readme/score-gauge.svg" alt="Шкала надійності від 0 до 100 з маркером, що проходить по кожній оцінці: UNWORTHY нижче 50, NEEDS WORK від 50 до 79, WORTHY від 80 до 99, FORGED при 100" width="720" />
-</p>
-<sub>Кожна оцінка від 0 до 100, розміщена справжнім `deriveScoreState`. Згенеровано командою `npm run docs:gauge` і захищено від розбіжностей у CI.</sub>
-| Оцінка    | Вердикт                                   |
-| --------- | ----------------------------------------- |
-| `0 – 49`  | **UNWORTHY**                              |
-| `50 – 79` | **NEEDS WORK**                            |
-| `80 – 99` | **WORTHY**                                |
-| `100`     | **FORGED**                                |
-| `null`    | **UNKNOWN**: оголошень тестів не знайдено |
-**Як вона обчислюється.** Серйозність задає базове вирахування (`error −8`, `warning −3`, `info −1`), а рівень доказовості його зменшує: E2 враховується повністю, E1 наполовину (з округленням униз), E0 не враховується. Сума нормується за охопленням набору, тобто вирахування на одне оголошення тесту, а не на файл. Термінал виводить ті самі зменшені числа, які використала оцінка; прихованої другої моделі немає. Подробиці: [docs/SCORING.md](docs/SCORING.md) і [посібник з оцінки](https://sergey-bar.github.io/Mjolnir/guide/scoring).
-**Чого не означає 100.** Це не означає, що програма коректна, набір тестів достатній або продукт вільний від дефектів. Це означає лише одне: **жодне з правил, перевірених Mjölnir, не дало вирахування в цьому скануванні та за цієї моделі доказів.**
-<br />
-## Модель доказів
-Кожна знахідка має дві мітки: наскільки впевнений Mjölnir і наскільки далеко знахідку перевірено. У цьому різниця між інструментом, що повідомляє про шаблони, та інструментом, від якого можна ставити в залежність реліз.
-**Наскільки впевнено — рівень доказовості.**
-| Рівень | Назва                | Значення                                                 | Вирахування |
-| ------ | -------------------- | -------------------------------------------------------- | ----------- |
-| **E2** | Детермінований доказ | Дефект присутній у коді в тому вигляді, як він написаний | Повне       |
-| **E1** | Доказ за шаблоном    | Збігся шаблон, тісно пов'язаний із дефектом              | Половина    |
-| **E0** | Спостереження        | Варто знати. Не твердження, що щось не так.              | Нуль        |
-Упевненість у виявленні — це не сила доказу. Правило може бути впевнене, що знайшло те, що шукало, і все одно дивитися на евристику. Знахідки E1 призначені для того, щоб їх читали й оцінювали, а не застосовували наосліп, і ця межа позначена на знахідці в терміналі, у JSON і в передачі агенту.
-**Наскільки далеко перевірено — рівень довіри.** Більшість знахідок отримано читанням вашого коду. Дайте Mjölnir звіт реального прогону тестів, і він зможе підтвердити, що код справді виконувався.
-<p align="center">
-  <img src="assets/readme/trust-ladder.svg" alt="Драбина довіри від L0 до L5. L0–L2 отримуються читанням коду; для L3–L5 потрібен звіт реального прогону, що позначено розривом у драбині." width="100%" />
-</p>
-| Рівень | Простими словами   | Що для цього потрібно                              |
-| ------ | ------------------ | -------------------------------------------------- |
-| **L0** | Помічено           | Читання коду                                       |
-| **L1** | Схоже на проблему  | Читання коду: збігся шаблон                        |
-| **L2** | Доведено в коді    | Читання коду: дефект структурний                   |
-| **L3** | Файл виконувався   | Звіт прогону показує, що файл знахідки виконувався |
-| **L4** | Тест виконувався   | Звіт прогону показує, що тест знахідки виконувався |
-| **L5** | Прогін підтверджує | Власний результат прогону підтверджує клас дефекту |
-Статичне сканування зупиняється на L2. Лише звіт реального прогону (Playwright JSON, Jest або Vitest JSON, JUnit XML) може підняти знахідку до L3 і вище, тож знахідка, яку жодного разу не бачили в роботі, ніколи не може стверджувати протилежне. Визначення: [docs/TERMINOLOGY.md](docs/TERMINOLOGY.md).
-### Скільки з цього виміряно
-**У 74 з 79 правил частку хибних спрацювань виміряно на реальному OSS-коді** (щонайменше 10 вручну класифікованих знахідок на кожне; див. [docs/FP-AUDIT.md](docs/FP-AUDIT.md)). Решта 5 спираються на оцінку автора й прямо про це кажуть, правило за правилом, у `mjolnir explain`. `mjolnir rules --unmeasured` перелічує їх, а підвал кожного сканування повідомляє, скільки з правил, які справді _спрацювали_, виміряно.
-Показники залишаються публічними, навіть коли вони погані. QA-TEST-001 (закомічений `.only`) погано проходить аудит на реальних репозиторіях і тому перебуває в quarantine. Актуальне значення для кожного правила, зокрема QA-PW-141, є в аудиті.
-### Рівні довіри правил
-Рівні визначаються виміряною часткою хибних спрацювань, а не думкою:
-| Рівень         | Виміряна FP              | Поведінка                                               |
-| -------------- | ------------------------ | ------------------------------------------------------- |
-| **core**       | ≤ 10%                    | Звіт за замовчуванням, блокує                           |
-| **extended**   | ≤ 30%                    | Звіт за замовчуванням, знижена впевненість              |
-| **quarantine** | > 30% або явно оголошене | Лише `--strict`, обмежено рівнем info, ніколи не блокує |
-| _не виміряно_  | n < 10                   | Не може бути підвищене до core, доки не виміряне        |
-Смуги FP можуть лише понизити рівень — вони ніколи не підвищують правило з `quarantine`, якщо воно було туди явно оголошене. Явно поміщене в карантин правило залишається в quarantine незалежно від виміряного рівня FP.
-Підвищення, пониження і зрілість за мовами: [життєвий цикл правил](https://sergey-bar.github.io/Mjolnir/reference/rule-lifecycle).
-### Чому це не лінтер
-Лінтери кажуть, чи дотримується код правил. Mjölnir каже, чи можна довіряти вашій перевірці.
-|                                                                | Лінтери (ESLint, SonarQube) | Інструменти покриття | Код-рев'ю зі ШІ |     **Mjölnir**     |
-| -------------------------------------------------------------- | :-------------------------: | :------------------: | :-------------: | :-----------------: |
-| Оцінює **систему перевірки**, а не код продукту                |             Ні              |          Ні          |       Ні        |         Так         |
-| Цілісність CI-workflow (`continue-on-error`, `\|\| true`)      |             Ні              |          Ні          |    лише diff    |         Так         |
-| Оцінює стійкість локаторів Playwright (Selector Health)        |             Ні              |          Ні          |       Ні        |         Так         |
-| Читає реальні дані прогонів для вердиктів `TRUE-FLAKE`         |             Ні              |          Ні          |       Ні        |         Так         |
-| Публікує виміряну частку хибних спрацювань для кожного правила |             Ні              |          Ні          |       Ні        |         Так         |
-| Позначає тести без тверджень                                   |            Так\*            |          Ні          |      іноді      |         Так         |
-| Знаходить жорсткі sleep (`waitForTimeout`, `time.sleep`)       |            Так\*            |          Ні          |      іноді      |         Так         |
-| Детермінованість (однаковий вхід — однаковий вихід)            |             Так             |         Так          |       Ні        |         Так         |
-| Вартість сканування                                            |         безкоштовно         |     безкоштовно      |     токени      | **нуль** (локально) |
-<sub>\*Покривається `eslint-plugin-jest` і `eslint-plugin-playwright` (`expect-expect`, `no-wait-for-timeout`), а також власними правилами SonarQube для тверджень. Стовпці описують поведінку за замовчуванням під час перевірки наборів тестів; плагіни, платні тарифи й власні правила змінюють деякі відповіді. Це зведення позиціонування, а не бенчмарк.</sub>
-Використовуйте й рев'ю зі ШІ. Воно вловлює нюанси, наміри та помилки проєктування, яких не знайде жоден шаблон. Mjölnir знаходить те, що рев'ю зі ШІ пропускає, бо це виглядає навмисним: закомічений `.only`, проковтнутий код виходу, `continue-on-error` на тестовій джобі. Тут потрібне сканування, а не міркування.
-<br />
-## Аналіз прогонів тестів
-Статичний аналіз міркує про код, який ніколи не виконувався. Аналіз прогонів читає те, що сталося насправді: Playwright JSON, Jest JSON, Vitest JSON і JUnit XML від будь-якого ранера.
-```bash
-mjolnir forensics ./test-results/
-```
-```text
-  ▍ FLAKINESS LEADERBOARD
-3 tests · 1 failed · 1 flaky · 1 retried
-TRUE-FLAKE completes checkout with saved card (e2e/checkout.spec.ts)
-           ████████████████████ 6.0s · 2 attempts
-FAILING    declines an expired card (e2e/checkout.spec.ts)
-           ████░░░░░░░░░░░░░░░░ 1.1s · 1 attempt
-```
-`TRUE-FLAKE` не означає, що тест перезапускався. Це означає, що тест **провалив щонайменше одну спробу, а потім завершився зеленим**: випадковий успіх, позначений незалежно від того, що показує підсумкова галочка. `mjolnir triage` перетворює цю історію на пропозицію карантину, а `mjolnir pw-report` підсумовує прогін. Саме ці звіти прогонів піднімають знахідки до рівнів довіри L3 і вище.
-<br />
-## Цілісність CI
-Тест може проходити, поки навколишній пайплайн не здатен упасти. Mjölnir читає і workflow: `continue-on-error`, `|| true`, коди виходу, які ніколи не передаються далі, завжди успішні кроки, звіти, які використовуються, але ніколи не створюються, і гейти, що пропускаються саме в тих подіях, які мають блокувати. Кожна знахідка називає джобу, крок і рядок і має власний рівень доказовості.
-Створіть workflow для PR, за замовчуванням рекомендаційний:
-```bash
-mjolnir ci install
-```
-Або додайте action із Marketplace до вже наявного workflow:
-```yaml
-- uses: Sergey-Bar/Mjolnir@v3
-  with:
-    scope: changed
-    fail-on: error
-```
-Закріпіть `@v3`, щоб слідувати мажорній лінії, або точний тег (`@v0.5.32`) для відтворюваного гейта. [docs/DISTRIBUTION-KIT.md](docs/DISTRIBUTION-KIT.md) описує Marketplace, Smithery та реєстри MCP.
-Щоб надіслати знахідки в GitHub Code Scanning, завантажте SARIF (потрібен `security-events: write` на рівні workflow або job):
-```yaml
-- run: npx mjolnir-qa@3.0.0 --format sarif > mjolnir.sarif
-  continue-on-error: true
-- uses: github/codeql-action/upload-sarif@v3
-  if: ${{ !cancelled() }}
-  with:
-    sarif_file: mjolnir.sarif
-```
-У GitLab `--format codequality` записує звіт Code Quality, який читають віджет MR і анотації diff ([docs/GITLAB-CI.md](docs/GITLAB-CI.md)). Налаштування редактора й пайплайна: [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md).
-### Прив'язка до змін гілки
-```bash
-npx mjolnir-qa@3.0.0 --scope changed
-```
-Знахідки прив'язуються до рядків, доданих вашою гілкою, відносно **merge-base**. Область — той самий набір файлів, що знаходить повне сканування (специфікації TS/JS і конфігурації адаптерів, `test_*.py`, `*Test.java`, `*Tests.cs`, `.github/workflows/*.yml`), плюс незакомічені й невідстежувані зміни, тож це працює ще до коміту. Базу визначають у порядку `main → master → origin/main → origin/master → origin/HEAD`; її можна перевизначити через `--base <ref>`.
-Якщо merge-base визначити не вдається (неглибокий клон, від'єднаний HEAD, ціль поза git), знахідки відкочуються до прив'язки до всього файлу, **і звіт про це повідомляє.** Тихий відкат був би саме тим дефектом, заради пошуку якого існує цей інструмент.
-<br />
-## ШІ-агенти
-Знахідки чогось варті, лише якщо на них хтось реагує.
-```text
-SCAN → EVIDENCE → HANDOFF → AGENT → RE-SCAN → PROOF
-```
-**ШІ пише виправлення. Mjölnir його перевіряє.** Доказ дає повторне сканування, а не власний звіт агента про успіх.
-| Команда           | Що отримує агент                                                                                                                                                            |
-| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mjolnir mcp`     | Сервер [MCP](https://modelcontextprotocol.io) через stdio. `scan`, `explain` і `diff` стають інструментами, які можна викликати.                                            |
-| `mjolnir handoff` | Збережений звіт `--json` перетворюється на детермінований план у Markdown: що виявлено, межа доказовості для кожної знахідки, що **не** має змінюватися і як це перевірити. |
-| `mjolnir install` | Записує в місця для агентів, які вже є у вашому репозиторії (`.claude/`, `.cursor/`, `.kilo/`, `AGENTS.md`), щоб агент пересканував код, перш ніж заявити, що закінчив.     |
-Додайте його до клієнта, який має власний CLI:
-```bash
-claude mcp add mjolnir -- npx -y mjolnir-qa@3.0.0 mcp
-```
-Або до будь-якого клієнта, що приймає блок `mcpServers`:
-```json
-{
-  "mcpServers": {
-    "mjolnir": { "command": "npx", "args": ["-y", "mjolnir-qa@3.0.0", "mcp"] }
-  }
-}
-```
-**Обмежувач важливіший за зручність.** Кожна знахідка в передачі має свою межу. **E2** каже _детерміновано: перевірте місце і застосуйте виправлення_. **E1** каже _ПОТРІБНЕ ПІДТВЕРДЖЕННЯ: саме спостереження не доводить дефект_. Агент, який наосліп виправляє E1, придушує правило або редагує правило, щоб підняти оцінку, робить саме те, заради пошуку чого існує цей інструмент, тому передача каже про це прямо в промпті, поруч зі знахідкою.
-<br />
-## Довіра і безпека
-**Локально, без телеметрії.** Ніде в `src/` немає жодного API з мережевими можливостями (`fetch`, `http`, `https`, `net`, `dns`, `dgram`, WebSocket), а [`privacy-network-isolation.spec.ts`](tests/contract/privacy-network-isolation.spec.ts) провалює збірку, якщо такий з'явиться. Він також забороняє `eval` і `new Function`. Сканування недовіреного коду ніколи його не виконує: статичний аналіз читає вихідний текст, а аналіз прогонів розбирає файли звітів, які вже є на диску.
-Два застереження: сам `npx` завантажує пакет до того, як щось запуститься, а гарантія поширюється на `src/`, але не на сторонні плагіни.
-**Плагіни не ізольовані в пісочниці.** JS-плагіни (`mjolnir-rules/*.mjs` або npm-пакети, перелічені в `"plugins"`) працюють із повними привілеями Node — та сама модель довіри, що й у плагінів ESLint чи Vitest. Їх завантаження вмикається явно **для кожного сканування**: без `--enable-plugins` (або `MJOLNIR_ENABLE_PLUGINS=1`) їхні вихідні файли ніколи не завантажуються, а повідомлення в stderr перелічує пропущене. JSON-маніфести правил не виконують код, а префікси ID core-правил зарезервовані, щоб плагін не міг видати себе за одне з них. Повідомляйте про вразливості через [SECURITY.md](SECURITY.md).
-**Він перевіряє сам себе.** Рушій довіри до перевірок нічого не вартий, якщо його самого не можна перевірити. Кожен прогін CI сканує цей репозиторій збіркою, створеною тим самим прогоном. Гейт падає за будь-якої знахідки рівня error, а також за **часткового** сканування чи **правила, що впало**, бо обрізане самосканування, яке ні про що не повідомляє, — це і є хибний зелений, заради пошуку якого існує цей проєкт. `mjolnir doctor` у тому самому прогоні заново перевіряє базу правил (захист фікстур, чесність рівнів, ліміт рівня core), а перевірка з результатом INCONCLUSIVE падає так само, як провалена. Обидва звіти завантажуються як артефакти збірки.
-### Коди виходу та машинний контракт
-Заморожені, щоб на них можна було будувати логіку CI:
-| Код виходу | Значення                                                                          |
-| ---------- | --------------------------------------------------------------------------------- |
-| `0`        | Чисто: немає знахідок на рівні гейта або вище                                     |
-| `1`        | Є знахідки на рівні гейта або вище                                                |
-| `2`        | Часткове сканування (вичерпано ліміт часу, нечитабельні файли). Ніколи не блокує. |
-| `10`       | Помилка використання (неправильний прапорець, немає цілі)                         |
-| `20`       | Внутрішня помилка                                                                 |
-`2` навмисно відрізняється від `0`: сканування, яке не завершилося, не «нічого не знайшло». Воно просто не закінчило шукати.
-Усе, що споживає машина (результати інструментів MCP, `--json`, SARIF 2.1), береться з одного канонічного результату за версіонованою схемою, **що розширюється лише додаванням** (`schemaVersion: 1`, `contractVersion: 1`), тож жодному споживачеві не треба відновлювати зміст із відрендереного тексту. Див. [машинний контракт](docs/machine-contract.md). ID правил (`QA-<FAMILY>-NNN`) незмінні після випуску й ніколи не використовуються повторно.
-<br />
-## Чого Mjölnir сказати не може
-- **Він не запускає ваші тести.** Чисте сканування — це не набір тестів, що проходить.
-- **Він не може сказати, що твердження _хибне_.** `expect(total).toBe(41)` виглядає здоровим. Mjölnir знаходить тести, які _не можуть упасти_, і пайплайни, які _не можуть почервоніти_, а не тести, що перевіряють не те.
-- **Він не доводить бізнес-коректність.** Ніщо тут не каже, що ваш продукт робить те, чого вимагала вимога.
-- **100 — не доказ хорошого набору тестів.** Чи покриває ваш набір реальні ризики — окреме питання, і цей інструмент на нього не відповідає.
-- **5 з 79 правил спираються на оцінку**, а не на виміряну частку. Кожне з них каже про це у своїй знахідці.
-- **E1 — це не E2.** Евристичні знахідки варто читати, але не варто застосовувати наосліп.
-- **Порожній репозиторій отримує `null`, ніколи не 100.**
-- **Файл з ім'ям `*.spec.ts` без оголошень тестів не вважається покриттям.** Репозиторій, де єдині spec-файли містять імпорти або типи (нуль викликів `it`/`test`), отримує `null`, а не 100.
-<br />
-## Документація
-Повний сайт документації розміщено за адресою <https://sergey-bar.github.io/Mjolnir/>.
-| Документ                                               | Що всередині                                                    |
-| ------------------------------------------------------ | --------------------------------------------------------------- |
-| [docs/SCORING.md](docs/SCORING.md)                     | Нормування оцінки та зважування доказів                         |
-| [docs/TERMINOLOGY.md](docs/TERMINOLOGY.md)             | Канонічний словник: одне слово на поняття                       |
-| [docs/FP-AUDIT.md](docs/FP-AUDIT.md)                   | Виміряні частки хибних спрацювань і методика                    |
-| [docs/RULE-LIFECYCLE.md](docs/RULE-LIFECYCLE.md)       | Стани правил, рівні, придушення, виведення з ужитку             |
-| [docs/VERSIONING.md](docs/VERSIONING.md)               | Політика semver, заморожені інтерфейси, цикл виведення з ужитку |
-| [docs/machine-contract.md](docs/machine-contract.md)   | Канонічний машинозчитуваний результат                           |
-| [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md) | Вивід SARIF і налаштування редактора або CI                     |
-| [docs/GITLAB-CI.md](docs/GITLAB-CI.md)                 | GitLab: звіт Code Quality, рецепт для MR, гейт                  |
-| [docs/rules/](docs/rules/)                             | Згенерований каталог за правилами                               |
-| [CONTRIBUTING.md](CONTRIBUTING.md)                     | Середовище розробки та процес внесення змін                     |
-| [SUPPORT.md](SUPPORT.md)                               | Де запитати, повідомити про проблему й отримати допомогу        |
-| [SECURITY.md](SECURITY.md)                             | Повідомлення про вразливості                                    |
-| [CHANGELOG.md](CHANGELOG.md)                           | Історія релізів                                                 |
-### Статус
-**Версія 1.** JSON-схема та коди виходу — заморожені контракти. TypeScript і Python мають найширше виміряне покриття. Java і C# новіші; оцінюйте їх за [таблицею зрілості](https://sergey-bar.github.io/Mjolnir/reference/rule-lifecycle). Що буде далі, без вигаданих дат: [публічна дорожня карта](https://sergey-bar.github.io/Mjolnir/reference/roadmap).
-### Участь у розробці
-Нові правила — найпростіший перший внесок. Одна команда створює заготовку правила з фікстурами must-fire **і** must-not-fire. Згенероване правило навмисно провалює власні фікстури, доки не написано справжнє виявлення, бо випущена заглушка — це правило, яке ніхто не вимірював:
-```bash
-mjolnir create-rule QA-PW-140 --title "Screenshot without diff bound"
-```
-Середовище розробки, команди постійних гейтів, а також закони anti-creep і захисту фікстур описано в [CONTRIBUTING.md](CONTRIBUTING.md).
-<br />
-<div align="center">
-<img src="assets/readme/closing.svg" alt="Запустіть його на своєму репозиторії." width="100%" />
-```bash
-npx mjolnir-qa@3.0.0
-```
-[Читати посібник](https://sergey-bar.github.io/Mjolnir/guide/getting-started) · [Сайт документації](https://sergey-bar.github.io/Mjolnir/) · [npm](https://www.npmjs.com/package/mjolnir-qa)
-<br />
-Не питайте, чи пройшли тести.<br />
-Запитайте, чи доводять докази, що вони заслуговують на довіру.
-<sub>Створив [Sergey Bar](https://www.linkedin.com/in/sergeybar/) · Ліцензія MIT</sub>
-</div>