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

mjolnir-qa 4.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 +3178 -16
package/README.md +81 -760
package/dist/cli.d.mts +552 -206
package/dist/cli.mjs +31409 -13990
package/dist/mcp/stdio.mjs +1290 -405
package/package.json +76 -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-Bg-46cLS.mjs +0 -2
package/dist/scan-pipeline-CCJdEKNa.mjs +0 -16336

package/README.gr.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 βρίσκει τεστ που δεν μπορούν να αποτύχουν και pipelines που δεν μπορούν να γίνουν κόκκινα,<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.uk.md) | [বাংলা](README.bn.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.
-## Ένα πράσινο τικ είναι ισχυρισμός, όχι απόδειξη
-Ένα πράσινο τικ σημαίνει ότι το pipeline δεν απέτυχε. Δεν σημαίνει ότι τα τεστ εκτελέστηκαν ή ότι θα μπορούσαν να αποτύχουν. Κάθε ένα από αυτά περνά πράσινο:
-- ένα `.only` σε commit που εκτέλεσε 3 τεστ αντί για 900
-- `continue-on-error: true` στο job που έπρεπε να μπλοκάρει
-- `|| true` μετά την εντολή των τεστ
-- ένα τεστ που δεν ελέγχει τίποτα ή έχει άδειο σώμα
-- ένα wrapper επαναλήψεων που μετατρέπει μια πραγματική αποτυχία σε τυχερή επιτυχία
-- μια αναφορά που το workflow ανεβάζει αλλά δεν δημιούργησε ποτέ
-- ένα σταθερό sleep που κρατά όρθια μια συνθήκη ανταγωνισμού
-Κανένα δεν κάνει το pipeline κόκκινο, και το καθένα φαίνεται σκόπιμο στο review. Γι' αυτό επιβιώνουν. Ιδού το 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 workflows και, αν υπάρχει, την αναφορά μιας πραγματικής εκτέλεσης. Δεν εκτελεί τα τεστ σας, δεν εγκαθιστά τις εξαρτήσεις σας και δεν εκτελεί τον κώδικα που σαρώνει. Κι όταν δεν έχει τεκμήρια, το λέει αντί να επινοεί βεβαιότητα:
-| Κατάσταση                                               | Τι αναφέρει το Mjölnir                                                  |
-| ------------------------------------------------------- | ----------------------------------------------------------------------- |
-| Δεν βρέθηκαν δηλώσεις τεστ                              | Βαθμολογία `null`, εμφανίζεται ως **UNKNOWN**. Ποτέ ένα επινοημένο 100. |
-| Χωρίς baseline ή συγκρίσιμη αναθεώρηση                  | **UNKNOWN**, με ρητή αιτία. Ποτέ ένα υποτιθέμενο 0.                     |
-| Η σάρωση διακόπηκε (χρονικό όριο, μη αναγνώσιμα αρχεία) | **PARTIAL**, έξοδος `2`. Ποτέ δεν παρουσιάζεται ως καθαρή.              |
-<p align="center">
-  <img src="assets/readme/how-it-works.svg" alt="Πώς λειτουργεί το Mjölnir. Διαβάζει στατικά τη σουίτα τεστ και το CI pipeline, καθώς και την αναφορά μιας πραγματικής εκτέλεσης όταν υπάρχει. Σταθμίζει κάθε εύρημα με βάση το επίπεδο τεκμηρίωσης και το επίπεδο εμπιστοσύνης του, όπου μόνο μια πραγματική εκτέλεση φτάνει τα 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, σαρώστε μόνο ό,τι εισήγαγε το branch, ώστε μια παλιά σουίτα να μη πνίξει το πρώτο σας pull request:
-```bash
-npx mjolnir-qa@3.0.0 --scope changed
-```
-Το `mjolnir ci install` το γράφει ως GitHub Actions workflow, χρησιμοποιώντας το [action](https://github.com/Sergey-Bar/Mjolnir#readme) καρφιτσωμένο στο κύριο tag `v3` (ή απλό `npx` με `--no-action`). Παραμένει συμβουλευτικό μέχρι να αποφασίσετε ότι πρέπει να μπλοκάρει.
-| Εντολή                                        | Τι κάνει                                                            |
-| --------------------------------------------- | ------------------------------------------------------------------- |
-| `mjolnir`                                     | Trust Report: ετυμηγορία, βεβαιότητα, επόμενη ενέργεια              |
-| `mjolnir --scope changed`                     | Μόνο ό,τι εισήγαγε το branch σας (η μορφή για 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 (artifact του widget του MR)            |
-| `mjolnir --strict`                            | Εκτελεί επίσης κανόνες επιπέδου quarantine (υψηλότερος κίνδυνος FP) |
-<details>
-<summary><strong>Όλες οι υπόλοιπες εντολές</strong> — διαλογή ασταθών τεστ, αναφορές, διακυβέρνηση</summary>
-<br />
-| Εντολή                              | Τι κάνει                                                                              |
-| ----------------------------------- | ------------------------------------------------------------------------------------- |
-| `mjolnir --classic`                 | Το banner βαθμολογίας πριν από το 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>`      | Τι εισήγαγε και τι επέλυσε ένα commit                                                 |
-| `mjolnir summary`                   | Σημειώσεις CI και σύνοψη step από μια αναφορά                                         |
-| `mjolnir pr-comment`                | Ένα στοχευμένο σχόλιο PR, σε Markdown                                                 |
-| `mjolnir debt`                      | Μητρώο τεχνικού χρέους τεστ με μοντέλο κόστους                                        |
-| `mjolnir handover`                  | Χάρτης γνωριμίας με τη σουίτα για νέο μηχανικό QA                                     |
-| `mjolnir init`                      | Ανιχνεύει frameworks, τυπώνει λίστα ελέγχου ρύθμισης                                  |
-| `mjolnir suppressions`              | Εμφανίζει τα κατασταλμένα ευρήματα, για διακυβέρνηση                                  |
-| `mjolnir rules --unmeasured`        | Οι κανόνες που λειτουργούν με υπόθεση, όχι με μέτρηση                                 |
-| `mjolnir rules --md`                | Πλήρης κατάλογος κανόνων (JSON ή Markdown)                                            |
-| `mjolnir doctor`                    | Αυτοέλεγχος της βάσης κανόνων του ίδιου του Mjölnir                                   |
-| `mjolnir create-rule <ID>`          | Δημιουργεί σκελετό για νέο κανόνα και τα fixtures του                                 |
-| `mjolnir stats`                     | Τοπικοί μετρητές όλων των διορθώσεων που έχουν εμφανιστεί                             |
-| `mjolnir badge`                     | JSON endpoint του shields.io και απόσπασμα κώδικα                                     |
-| `mjolnir --cache`                   | Επαυξητικές νέες σαρώσεις μέσω τοπικής cache ετυμηγοριών                              |
-| `mjolnir --format mermaid`          | Διάγραμμα αρχιτεκτονικής τεστ για σχόλιο PR                                           |
-Το `mjolnir help <command>` τυπώνει τη χρήση, παραδείγματα και το επόμενο βήμα για οποιαδήποτε από αυτές.
-</details>
-Απαιτεί **Node.js ≥ 22.18** σε Windows, macOS ή Linux. Προτιμάτε καθολική εγκατάσταση; `npm i -g mjolnir-qa`. Το ελάχιστο όριο προέρχεται από την αλυσίδα εργαλείων build (το tsdown το στοχεύει και το pipeline κυκλοφορίας κάνει smoke tests σε αυτό)· οι εξαρτήσεις χρόνου εκτέλεσης δεν χρειάζονται τίποτα περισσότερο.
-<br />
-## Τι βρίσκει το Mjölnir
-<p align="center">
-  <img src="assets/readme/stack.svg" alt="Λειτουργεί με τη στοίβα σας: οι γλώσσες, τα frameworks τεστ και τα συστήματα CI που καλύπτουν οι κανόνες του, από το μητρώο κανόνων." width="100%" />
-</p>
-**79 κανόνες** σε τέσσερις οικογένειες — υγιεινή τεστ, ποιότητα τεστ, Playwright και ακεραιότητα CI — για TypeScript και JavaScript, Python, Java, C# και YAML του GitHub Actions. Καλύπτουν το Playwright και στα τέσσερα bindings, καθώς και 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  | Εστιασμένο τεστ σε commit (`.only`, `fit`)                                    | error      | quarantine |
-| QA-TEST-003  | Τεστ χωρίς ισχυρισμούς                                                        | error      | quarantine |
-| QA-TQUAL-009 | Ισχυρισμός σε promise χωρίς await                                             | error      | quarantine |
-| QA-PW-002    | Ισχυρισμός σε locator χωρίς 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  | Υγιεινή    | Εστιασμένο τεστ σε commit (`.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 | Ισχυρισμός σε locator χωρίς await                                       | error      | core       |
-| QA-PW-003    | Playwright | `page.pause()` / `test.only()` σε commit                                | 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         | Wrappers επαναλήψεων γύρω από τα τεστ                                   | warning    | extended   |
-| QA-CI-008    | CI         | Step που πετυχαίνει πάντα κρύβει αποτυχίες                              | 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       | Εύθραυστος επιλογέας αντί για locator βάσει ρόλου                       | 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#         | Εύθραυστος επιλογέας αντί για locator βάσει ρόλου                       | warning    | quarantine |
-Η Python περιλαμβάνει επίσης τους QA-PY-001…012 (υγιεινή pytest) και QA-PY-101…108 (Playwright για Python). Τα Cypress και Selenium έχουν αρχικά σύνολα τριών κανόνων το καθένα.
-</details>
-Κάθε κανόνας κυκλοφορεί με ένα fixture must-fire **και** ένα must-not-fire, και ένας κανόνας που ενεργοποιείται στο δικό του αρνητικό fixture δεν μπορεί να κυκλοφορήσει. Αυτό είναι το τείχος προστασίας από ψευδώς θετικά· το `mjolnir doctor` το επιβάλλει στο CI αυτού του αποθετηρίου.
-### Selector Health Score
-Το `mjolnir doctor:playwright` βαθμολογεί κάθε locator ανάλογα με το πώς βρίσκει ένα στοιχείο: όπως θα το έκανε ένας χρήστης (ρόλος, ετικέτα, κείμενο), μέσω ρητού συμβολαίου (`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)` περνά σήμερα και θα συνεχίσει να περνά μέχρι κάποιος να αγγίξει το markup. Μια χαμηλή βαθμολογία δεν ισχυρίζεται ποτέ ότι το τεστ είναι χαλασμένο, μόνο ότι εξαρτάται από markup που κανείς δεν υποσχέθηκε να διατηρήσει.
-<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` σε commit) τα πάει άσχημα στον έλεγχο σε πραγματικά αποθετήρια και γι' αυτό βρίσκεται σε 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).
-### Γιατί αυτό δεν είναι linter
-Οι linters σάς λένε αν ο κώδικας ακολουθεί κανόνες. Το Mjölnir σάς λέει αν μπορείτε να εμπιστευτείτε την επαλήθευσή σας.
-|                                                                            | Linters (ESLint, SonarQube) | Εργαλεία κάλυψης | Έλεγχος κώδικα με ΤΝ |    **Mjölnir**     |
-| -------------------------------------------------------------------------- | :-------------------------: | :--------------: | :------------------: | :----------------: |
-| Βαθμολογεί το **σύστημα επαλήθευσης**, όχι τον κώδικα του προϊόντος        |             Όχι             |       Όχι        |         Όχι          |        Ναι         |
-| Ακεραιότητα των CI workflows (`continue-on-error`, `\|\| true`)            |             Όχι             |       Όχι        |     μόνο το diff     |        Ναι         |
-| Βαθμολογεί την ανθεκτικότητα των locators του Playwright (Selector Health) |             Όχι             |       Όχι        |         Όχι          |        Ναι         |
-| Διαβάζει πραγματικά δεδομένα εκτελέσεων για ετυμηγορίες `TRUE-FLAKE`       |             Όχι             |       Όχι        |         Όχι          |        Ναι         |
-| Δημοσιεύει μετρημένο ποσοστό ψευδώς θετικών ανά κανόνα                     |             Όχι             |       Όχι        |         Όχι          |        Ναι         |
-| Σημειώνει τεστ χωρίς ισχυρισμούς                                           |            Ναι\*            |       Όχι        |    μερικές φορές     |        Ναι         |
-| Εντοπίζει σταθερά sleep (`waitForTimeout`, `time.sleep`)                   |            Ναι\*            |       Όχι        |    μερικές φορές     |        Ναι         |
-| Ντετερμινιστικό (ίδια είσοδος, ίδια έξοδος)                                |             Ναι             |       Ναι        |         Όχι          |        Ναι         |
-| Κόστος ανά σάρωση                                                          |           δωρεάν            |      δωρεάν      |        tokens        | **μηδέν** (τοπικά) |
-<sub>\*Καλύπτεται από τα `eslint-plugin-jest` και `eslint-plugin-playwright` (`expect-expect`, `no-wait-for-timeout`) και από τους δικούς κανόνες ισχυρισμών του SonarQube. Οι στήλες περιγράφουν την προεπιλεγμένη συμπεριφορά για την επαλήθευση σουιτών τεστ· πρόσθετα, επί πληρωμή πλάνα και προσαρμοσμένοι κανόνες αλλάζουν ορισμένες απαντήσεις. Αυτή είναι μια σύνοψη τοποθέτησης, όχι benchmark.</sub>
-Χρησιμοποιήστε και έλεγχο με ΤΝ. Πιάνει αποχρώσεις, πρόθεση και σχεδιαστικά λάθη που κανένα μοτίβο δεν μπορεί να βρει. Το Mjölnir πιάνει ό,τι ξεφεύγει από τον έλεγχο με ΤΝ επειδή φαίνεται σκόπιμο: ένα `.only` σε commit, έναν καταπιωμένο κωδικό εξόδου, ένα `continue-on-error` σε job τεστ. Αυτά χρειάζονται σάρωση, όχι συλλογισμό.
-<br />
-## Ανάλυση εκτελέσεων τεστ
-Η στατική ανάλυση συλλογίζεται για κώδικα που δεν εκτελέστηκε ποτέ. Η ανάλυση εκτελέσεων διαβάζει τι πραγματικά συνέβη: Playwright JSON, Jest JSON, Vitest JSON και JUnit XML από οποιονδήποτε runner.
-```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
-Ένα τεστ μπορεί να περνά ενώ το pipeline γύρω του δεν μπορεί να αποτύχει. Το Mjölnir διαβάζει και τα workflows: `continue-on-error`, `|| true`, κωδικούς εξόδου που δεν μεταφέρονται ποτέ, steps που πετυχαίνουν πάντα, αναφορές που καταναλώνονται αλλά δεν δημιουργούνται ποτέ, και πύλες που παραλείπονται ακριβώς στα γεγονότα που θα έπρεπε να μπλοκάρουν. Κάθε εύρημα κατονομάζει το job, το step και τη γραμμή, και φέρει το δικό του επίπεδο τεκμηρίωσης.
-Δημιουργήστε το workflow για PR, συμβουλευτικό από προεπιλογή:
-```bash
-mjolnir ci install
-```
-Ή προσθέστε το action του Marketplace σε ένα workflow που ήδη έχετε:
-```yaml
-- uses: Sergey-Bar/Mjolnir@v3
-  with:
-    scope: changed
-    fail-on: error
-```
-Καρφιτσώστε το `@v3` για να ακολουθείτε την κύρια γραμμή, ή ένα ακριβές tag (`@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 που διαβάζουν το widget του MR και οι σημειώσεις του diff ([docs/GITLAB-CI.md](docs/GITLAB-CI.md)). Ρύθμιση επεξεργαστή και pipeline: [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md).
-### Απόδοση στο εύρος των αλλαγών
-```bash
-npx mjolnir-qa@3.0.0 --scope changed
-```
-Τα ευρήματα αποδίδονται στις γραμμές που πρόσθεσε το branch σας, μετρημένες ως προς το **merge-base**. Το εύρος είναι το ίδιο σύνολο αρχείων που ανακαλύπτει μια πλήρης σάρωση (specs TS/JS και ρυθμίσεις adapters, `test_*.py`, `*Test.java`, `*Tests.cs`, `.github/workflows/*.yml`), συν τις αλλαγές χωρίς commit και τις μη παρακολουθούμενες, οπότε λειτουργεί πριν κάνετε commit. Η βάση επιλύεται με τη σειρά `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`), ώστε ο πράκτορας να ξανασαρώνει πριν δηλώσει ότι τελείωσε.     |
-Προσθέστε το σε έναν client που έχει δικό του CLI:
-```bash
-claude mcp add mjolnir -- npx -y mjolnir-qa@3.0.0 mcp
-```
-Ή σε οποιονδήποτε client δέχεται ένα μπλοκ `mcpServers`:
-```json
-{
-  "mcpServers": {
-    "mjolnir": { "command": "npx", "args": ["-y", "mjolnir-qa@3.0.0", "mcp"] }
-  }
-}
-```
-**Το προστατευτικό κιγκλίδωμα μετράει περισσότερο από την ευκολία.** Κάθε εύρημα σε μια παράδοση φέρει το όριό του. Το **E2** λέει _ντετερμινιστικό: ελέγξτε τη θέση και εφαρμόστε τη διόρθωση_. Το **E1** λέει _ΑΠΑΙΤΕΙΤΑΙ ΕΠΙΒΕΒΑΙΩΣΗ: η παρατήρηση από μόνη της δεν αποδεικνύει το ελάττωμα_. Ένας πράκτορας που διορθώνει τυφλά ένα E1, καταστέλλει έναν κανόνα ή τροποποιεί έναν κανόνα για να ανεβάσει τη βαθμολογία κάνει ακριβώς αυτό που υπάρχει αυτό το εργαλείο για να πιάνει, γι' αυτό η παράδοση το λέει στο prompt, δίπλα στο εύρημα.
-<br />
-## Εμπιστοσύνη και ασφάλεια
-**Τοπικά πρώτα, μηδενική τηλεμετρία.** Κανένα API με δυνατότητα δικτύου (`fetch`, `http`, `https`, `net`, `dns`, `dgram`, WebSocket) δεν υπάρχει πουθενά στο `src/`, και το [`privacy-network-isolation.spec.ts`](tests/contract/privacy-network-isolation.spec.ts) αποτυγχάνει το build αν εμφανιστεί κάποιο. Απαγορεύει επίσης τα `eval` και `new Function`. Η σάρωση μη αξιόπιστου κώδικα δεν τον εκτελεί ποτέ: η στατική ανάλυση διαβάζει πηγαίο κείμενο και η ανάλυση εκτελέσεων αναλύει αρχεία αναφορών που ήδη υπάρχουν στον δίσκο.
-Δύο επιφυλάξεις: το ίδιο το `npx` κατεβάζει το πακέτο πριν εκτελεστεί οτιδήποτε, και η εγγύηση καλύπτει το `src/`, όχι πρόσθετα τρίτων.
-**Τα πρόσθετα δεν εκτελούνται σε sandbox.** Τα πρόσθετα JS (`mjolnir-rules/*.mjs` ή πακέτα npm που αναφέρονται στο `"plugins"`) εκτελούνται με πλήρη δικαιώματα Node, με το ίδιο μοντέλο εμπιστοσύνης όπως τα πρόσθετα του ESLint ή του Vitest. Η φόρτωσή τους είναι ρητή επιλογή **ανά σάρωση**: χωρίς `--enable-plugins` (ή `MJOLNIR_ENABLE_PLUGINS=1`) οι πηγές τους δεν φορτώνονται ποτέ, και μια ειδοποίηση στο stderr απαριθμεί τι παραλείφθηκε. Τα manifests κανόνων σε JSON δεν εκτελούν κώδικα, και τα προθέματα ID των κανόνων core είναι δεσμευμένα, ώστε κανένα πρόσθετο να μην μπορεί να υποδυθεί κάποιον. Αναφέρετε ευπάθειες μέσω του [SECURITY.md](SECURITY.md).
-**Εκτελείται πάνω στον εαυτό του.** Μια μηχανή εμπιστοσύνης επαλήθευσης δεν έχει καμία αξιοπιστία αν δεν είναι η ίδια επαληθεύσιμη. Κάθε εκτέλεση του CI σαρώνει αυτό το αποθετήριο με το build που παρήγαγε η ίδια εκτέλεση. Η πύλη αποτυγχάνει σε οποιοδήποτε εύρημα σοβαρότητας error, καθώς και σε **μερική** σάρωση ή σε **κανόνα που κατέρρευσε**, γιατί μια κομμένη αυτοσάρωση που δεν αναφέρει τίποτα είναι ακριβώς το ψεύτικο πράσινο που υπάρχει αυτό το έργο για να πιάνει. Το `mjolnir doctor` ελέγχει ξανά τη βάση κανόνων στην ίδια εκτέλεση (τείχος προστασίας fixtures, ειλικρίνεια επιπέδων, το ανώτατο όριο του επιπέδου core), και ένας έλεγχος με αποτέλεσμα INCONCLUSIVE αποτυγχάνει ακριβώς όπως ένας αποτυχημένος. Και οι δύο αναφορές ανεβαίνουν ως artifacts του build.
-### Κωδικοί εξόδου και το συμβόλαιο μηχανής
-Παγωμένοι, ώστε να μπορείτε να χτίσετε λογική 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 βρίσκει τεστ που _δεν μπορούν να αποτύχουν_ και pipelines που _δεν μπορούν να γίνουν κόκκινα_, όχι τεστ που ελέγχουν το λάθος πράγμα.
-- **Δεν αποδεικνύει την επιχειρησιακή ορθότητα.** Τίποτα εδώ δεν λέει ότι το προϊόν σας κάνει αυτό που ζητούσε η απαίτηση.
-- **Ένα 100 δεν αποδεικνύει μια καλή σουίτα.** Το αν η σουίτα σας καλύπτει τον πραγματικό σας κίνδυνο είναι άλλο ερώτημα, και αυτό το εργαλείο δεν το απαντά.
-- **5 από 79 κανόνες βασίζονται σε εκτίμηση**, όχι σε μετρημένο ποσοστό. Ο καθένας το δηλώνει στο δικό του εύρημα.
-- **Το E1 δεν είναι E2.** Τα ευρετικά ευρήματα αξίζει να διαβάζονται, όχι να εφαρμόζονται στα τυφλά.
-- **Ένα άδειο αποθετήριο παίρνει `null`, ποτέ 100.**
-- **Ένα αρχείο με όνομα `*.spec.ts` χωρίς δηλώσεις τεστ δεν μετρά ως κάλυψη.** Ένα αποθετήριο του οποίου τα μόνα αρχεία spec περιέχουν imports ή τύπους (μηδέν κλήσεις `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).
-### Συνεισφορά
-Οι νέοι κανόνες είναι η ευκολότερη πρώτη συνεισφορά. Μία εντολή δημιουργεί τον σκελετό του κανόνα με τα fixtures must-fire **και** must-not-fire. Ο κανόνας που δημιουργείται αποτυγχάνει σκόπιμα στα δικά του fixtures μέχρι να γραφτεί πραγματική ανίχνευση, γιατί ένα stub που κυκλοφορεί είναι ένας κανόνας που κανείς δεν μέτρησε:
-```bash
-mjolnir create-rule QA-PW-140 --title "Screenshot without diff bound"
-```
-Το περιβάλλον ανάπτυξης, οι εντολές των μόνιμων πυλών και οι νόμοι anti-creep και τείχους προστασίας fixtures βρίσκονται στο [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>