mjolnir-qa 1.0.9 → 2.0.2

package/README.gr.md

@@ -1,399 +1,431 @@
 <div align="center">
 
-<img src="assets/readme/logo.png" alt="Mjölnir — Verification Trust Engine" width="800" />
+<img src="assets/readme/hero.svg" alt="Mjölnir. Τα τεστ σού λένε τι πέρασε. Το Mjölnir σού λέει τι μπορείς να εμπιστευτείς." width="100%" />
 
-### Τα τεστ σου λένε ψέματα. Το αποδεικνύουμε.
+<br />
 
-**Verification Trust Engine για QA.** Το Mjölnir ελέγχει suites τεστ και
-CI pipelines, αναφέρει δείκτη αξιοπιστίας και δείχνει ακριβώς πού
-σπάει η εμπιστοσύνη.
+Το Mjölnir βρίσκει τεστ που δεν μπορούν να αποτύχουν και pipelines που δεν μπορούν να γίνουν κόκκινα,<br />
+και στη συνέχεια βαθμολογεί πόσο μπορεί να εμπιστευτεί κανείς το αποτέλεσμα, με το τεκμήριο για κάθε πόντο.
 
-[![npm](https://img.shields.io/npm/v/mjolnir-qa.svg?style=flat-square&color=C19A34&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)
-[![license](https://img.shields.io/badge/license-MIT-C19A34.svg?style=flat-square&labelColor=0A1119)](LICENSE)
-[![node](https://img.shields.io/badge/node-%E2%89%A5%2022.18-37ABBD.svg?style=flat-square&labelColor=0A1119)](https://nodejs.org)
-
-[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)
+<br />
 
-> 🤖 Machine-assisted translation. The [English README](README.md) is canonical. Last synced: 2026-09-08.
+[![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@latest
 ```
 
-**Είναι τα τεστ σου άξια εμπιστοσύνης;**
+[Δείτε το σε δράση](#δείτε-το-σε-δράση) · [Γρήγορη εκκίνηση](#γρήγορη-εκκίνηση) · [Τι βρίσκει](#τι-βρίσκει-το-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-15.
+
+<!-- Source hash: 3541b09e8d04 -->
 
-[Δες το σε δράση](#-δες-το-σε-δράση) ·
-[Γρήγορη εκκίνηση](#-γρήγορη-εκκίνηση) ·
-[Τι ελέγχει](#-τι-ελέγχει-το-mjölnir) ·
-[Σκόρ](#πώς-λειτουργεί-το-σκόρ) ·
-[CI](#-ενσωμάτωση-ci) · [Διαμόρφωση](#διαμόρφωση) ·
-[Τεκμηρίωση](#-τεκμηρίωση)
+</details>
 
 </div>
 
----
+<br />
+
+## Ένα πράσινο τικ είναι ισχυρισμός, όχι απόδειξη
+
+Ένα πράσινο τικ σημαίνει ότι το 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@latest` χωρίς `--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/demo.svg" alt="Η πλήρης αναφορά --verbose του Mjölnir σε ένα demo repo: WORTHINESS 75/100 NEEDS WORK, ανάλυση διαγνώσεων ανά κατηγορία, λίστα FIX THIS FIRST και κάθε εύρημα με ID κανόνα και αριθμό γραμμής σε CI, Playwright, υγιεινή τεστ και κανόνες Python" width="900" />
+  <img src="assets/readme/terminal-hero.svg" alt="Η ανάλυση αφαιρέσεων του Mjölnir: WORTHINESS 80/100 WORTHY, η βαθμολογία ανά κατηγορία, το πλαίσιο αφαιρέσεων ανά σοβαρότητα και μια λίστα FIX THIS FIRST" width="520" />
 </p>
 
-<sub>Η πλήρης έξοδος του `npx mjolnir-qa ./examples/demo-repo --verbose`,
-αποδομένη από τον πραγματικό reporter — τίποτα περικομμένο.
-Αναδημιουργείται με `npm run docs:demo`;
-[`tests/demo-asset-reproducibility.spec.ts`](tests/demo-asset-reproducibility.spec.ts)
-ρίχνει το CI αν ο artifact αποκλίνει από ό,τι τυπώνει το εργαλείο.</sub>
+<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@latest σαρώνει το αποθετήριο επίδειξης σε ένα παράθυρο τερματικού" width="900" />
+  </a>
+</p>
 
-**Τι μόλις συνέβη:**
+<sub>Αποδόθηκε καρέ προς καρέ από πραγματική σάρωση με `npm run docs:video`· ποτέ δεν καταγράφηκε από την οθόνη. Επιλέξτε το καρέ για να ανοίξετε το [`mjolnir-demo.mp4`](assets/video/mjolnir-demo.mp4).</sub>
 
-1. Το Mjölnir ανακάλυψε τα Playwright specs, τη διαμόρφωσή του, το CI
-   workflow και ένα αρχείο τεστ Python — τέσσερις γλώσσες/μορφές, ένα
-   πέρασμα.
-2. Βρήκε στοιχεία που εξασθενούν την εμπιστοσύνη στη σουίτα — ένα
-   `continue-on-error` που κρύβει job, ένα `|| true` που καταπίνει exit
-   code, σκληρά sleeps, εύθραυστο selector, σκληρά staging URL,
-   αναμονή `networkidle`.
-3. Μετέτρεψε το καθένα σε συγκεκριμένο εύρημα με ID κανόνα, τοποθεσία
-   και fix — και σε ένα σκόρ με το οποίο μπορείς να gated ένα PR.
+</details>
 
 ### Ένα εύρημα από κοντά
 
-Τρέξε `mjolnir explain QA-CI-001` στο πρώτο εύρημα παραπάνω και θα
-πάρεις:
+Κάθε εύρημα απαντά σε τέσσερα ερωτήματα: πού βρίσκεται, πόσο σίγουρο είναι το 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
+  ▍ QA-CI-001 — continue-on-error masks a failing verification gate
 
 Severity:    error
 Confidence:  high
+Tier:        quarantine
 Evidence:    E2
-Measured FP: not yet measured — this rule ships on assumption (see docs/FP-AUDIT.md)
+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.
+  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.
-```
 
-Αυτή είναι η μονάδα αξίας: όχι νίττα στυλ, αλλά ένα σημείο όπου το CI
-σου σου λέει ότι κάτι πέρασε ενώ δεν πέρασε.
+  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.
 
-Τρέξ' το σε ένα repo για πλήρη αναφορά και δείκτη αξιοπιστίας:
+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.
 
-```bash
-npx mjolnir-qa@latest
+Docs: mjolnir rules --md   (full catalog, this rule included)
 ```
 
-**Στο CI το προϊόν είναι μία εντολή.** Σκανάρει μόνο ό,τι άγγιξε το
-branch και βγαίνει μη μηδενικά σε νέα προβλήματα:
+Αυτή είναι η μονάδα αξίας: ένα σημείο όπου το CI αναφέρει μια επιτυχία που δεν κέρδισε.
+
+<br />
+
+## Γρήγορη εκκίνηση
 
 ```bash
-npx mjolnir-qa@latest --scope changed
+npx mjolnir-qa@latest
 ```
 
-Ρίξε αυτό σε ένα PR check — το `mjolnir ci install` γράφει το workflow —
-και τελείωσες. Όλα τα άλλα είναι προαιρετικά.
+Σαρώνει τον τρέχοντα κατάλογο και τυπώνει το Trust Report: τι βρήκε, πόσο μπορείτε να το εμπιστευτείτε, γιατί και τι να κάνετε μετά. Τερματίζει με `0` όταν δεν βρέθηκε τίποτα στο επίπεδο της πύλης ή πάνω από αυτό.
 
-| Εντολή                              | Τι κάνει                                                     |
-| ----------------------------------- | ------------------------------------------------------------ |
-| `mjolnir`                           | Πλήρες σκαν repo + δείκτης αξιοπιστίας                       |
-| `mjolnir --scope changed`           | Μόνο ό,τι引入ε το branch σου — η μορφή CI                    |
-| `mjolnir ci install`                | Δημιουργεί το συμβουλευτικό PR workflow                      |
-| `mjolnir explain QA-CI-001`         | Τι / γιατί / fix + μετρημένο ποσοστό FP για έναν κανόνα      |
-| `mjolnir rules --unmeasured`        | Οι κανόνες που τρέχουν με υπόθεση, όχι με μέτρημα            |
-| `mjolnir --json` / `--format sarif` | Μηχανικά αναγνώσιμο / GitHub Code Scanning                   |
-| `mjolnir --strict`                  | Εκτελεί και κανόνες tier quarantine (υψηλότερος κίνδυνος FP) |
-
-<details>
-<summary><strong>Όταν κάτι είναι flaky</strong></summary>
+Στο CI, σαρώστε μόνο ό,τι εισήγαγε το branch, ώστε μια παλιά σουίτα να μη πνίξει το πρώτο σας pull request:
 
-| Εντολή                              | Τι κάνει                                                        |
-| ----------------------------------- | --------------------------------------------------------------- |
-| `mjolnir forensics ./test-results/` | Πραγματικά δεδομένα runs → ετυμηγορίες `TRUE-FLAKE`, `FLAKY.md` |
-| `mjolnir triage ./test-results/`    | Πρόταση καραντίνας από ιστορικό εκτέλεσης                       |
-| `mjolnir pw-report ./test-results/` | Σύνοψη run Playwright — retries / flakes / τα πιο αργά          |
-| `mjolnir doctor:playwright`         | Βαθύ σκαν μόνο Playwright + Selector Health Score               |
+```bash
+npx mjolnir-qa@latest --scope changed
+```
 
-</details>
+Το `mjolnir ci install` το γράφει ως GitHub Actions workflow, χρησιμοποιώντας το [action](https://github.com/Sergey-Bar/Mjolnir#readme) καρφιτσωμένο στο κύριο tag `v1` (ή απλό `npx` με `--no-action`). Παραμένει συμβουλευτικό μέχρι να αποφασίσετε ότι πρέπει να μπλοκάρει.
+
+| Εντολή                              | Τι κάνει                                                            |
+| ----------------------------------- | ------------------------------------------------------------------- |
+| `mjolnir`                           | Trust Report: ετυμηγορία, βεβαιότητα, επόμενη ενέργεια              |
+| `mjolnir --scope changed`           | Μόνο ό,τι εισήγαγε το branch σας (η μορφή για CI)                   |
+| `mjolnir ci install`                | Δημιουργεί το συμβουλευτικό workflow για PR (βασισμένο στο action)  |
+| `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>
-
-| Εντολή                          | Τι κάνει                                                |
-| ------------------------------- | ------------------------------------------------------- |
-| `mjolnir fix --dry-run` / `fix` | Ασφαλή αυτόματα fix με απόδειξη                         |
-| `mjolnir baseline` / `diff`     | Στιγμιότυπο ευρημάτων, μετά αναφορά μόνο νέων/χειρότερα |
-| `mjolnir impact --since <ref>`  | Τι άλλαξε από προηγούμενο commit                        |
-| `mjolnir debt`                  | Μητρώο τεχνολογικού χρέους τεστ με μοντέλο κόστους      |
-| `mjolnir handover`              | Χάρτης onboarding της σουίτας για νέο QA                |
-| `mjolnir stats`                 | Τοπικοί σωρευτικοί μετρητές όλων των fix που είδε       |
-| `mjolnir badge`                 | shields.io endpoint JSON + snippet                      |
-| `mjolnir rules --md`            | Πλήρης κατάλογος κανόνων (JSON ή Markdown)              |
-| `mjolnir doctor`                | Αυτοέλεγχος της ίδιας της βάσης κανόνων του Mjölnir     |
-| `mjolnir create-rule <ID>`      | Σκαφφάρει νέο κανόνα + fixtures                         |
-| `mjolnir --format mermaid`      | Διάγραμμα αρχιτεκτονικής τεστ για σχόλιο PR             |
+<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>
 
-Εγκατάσταση globally αντί για `npx` αν προτιμάς: `npm i -g mjolnir-qa`.
-Απαιτεί Node.js ≥ 22.18. Λειτουργεί σε Windows, macOS και Linux.
-
----
-
-## 👥 Για ποιον είναι;
-
-- **QA / SDET** που έχουν e2e ή integration σουίτα και χρειάζονται
-  αποδείξεις ότι η σουίτα αξίζει πραγματικά το πράσινο τσεκ που
-  παράγει.
-- **Ομάδες Platform / DevEx** υπεύθυνες για ακεραιότητα CI και release
-  gates — οι άνθρωποι που νοιάζονται να μην μετατρέψει ποτέ ένα
-  `continue-on-error` βουβά κόκκινο pipeline σε πράσινο.
-- **Maintainers OSS** που θέλουν φτηνή, πάντα ενεργή πύλη επαλήθευσης
-  που τρέχει τοπικά και σε CI χωρίς κλήσεις δικτύου.
-
----
+Απαιτεί **Node.js ≥ 22.18** σε Windows, macOS ή Linux. Προτιμάτε καθολική εγκατάσταση; `npm i -g mjolnir-qa`. Το ελάχιστο όριο προέρχεται από την αλυσίδα εργαλείων build (το tsdown το στοχεύει και το pipeline κυκλοφορίας κάνει smoke tests σε αυτό)· οι εξαρτήσεις χρόνου εκτέλεσης δεν χρειάζονται τίποτα περισσότερο.
 
-## 🔨 Τι ελέγχει το Mjölnir
+<br />
 
-|     |                                                                                                                                      |
-| --- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| ⚖️  | **Δείκτης αξιοπιστίας** — ένας αριθμός, διαφανής πίνακας αφαιρέσεων, καμία μαύρη κάψουλα                                             |
-| 🎭  | **Selector Health Score** — βαθμολογεί τα Playwright locators σου, όχι μόνο το pass rate                                             |
-| 🔬  | **Δικαστική ανάλυση runtime** — διαβάζει πραγματικά δεδομένα Playwright/JUnit για να πιάσει `TRUE-FLAKE`, όχι μόνο στατικές εικασίες |
-| 🚨  | **Κανόνες ακεραιότητας CI** — πιάνει `continue-on-error`, `\|\| true` και άλλα κόλπα ψεύτικου πράσινου                               |
-| 🐍  | **Και τα τέσσερα Playwright bindings** — TypeScript, Python, Java, C#/.NET — plus pytest, JUnit/TestNG και CI workflows              |
-| 🔒  | **Local-first** — μηδενικές κλήσεις δικτύου κατά το σκαν, μηδενική τηλεμετρία, τρέχει σε δευτερόλεπτα                                |
+## Τι βρίσκει το Mjölnir
 
-### Οι κανόνες
+<p align="center">
+  <img src="assets/readme/stack.svg" alt="Λειτουργεί με τη στοίβα σας: οι γλώσσες, τα frameworks τεστ και τα συστήματα CI που καλύπτουν οι κανόνες του, από το μητρώο κανόνων." width="100%" />
+</p>
 
-Κάθε κανόνας έρχεται με fixtures must-fire **και** must-not-fire.
-Κανόνας που ενεργοποιείται στη δική του αρνητική fixture δεν μπορεί να
-να κυκλοφορήσει — αυτός είναι ο τείχος των false positives.
+**79 κανόνες** σε τέσσερις οικογένειες — υγιεινή τεστ, ποιότητα τεστ, Playwright και ακεραιότητα CI — για TypeScript και JavaScript, Python, Java, C# και YAML του GitHub Actions. Καλύπτουν το Playwright και στα τέσσερα bindings, καθώς και pytest, JUnit, TestNG, NUnit, xUnit, MSTest, Jest, Vitest και Mocha, με αρχική κάλυψη για Cypress και Selenium. Εννέα από αυτούς, για να φανεί η μορφή:
 
-<details>
-<summary><strong>Υγιεινή τεστ</strong></summary>
-
-| ID          | Κανόνας                                               | Severity |
-| ----------- | ----------------------------------------------------- | -------- |
-| QA-TEST-001 | Commitμένος focused τεστ (`.only`, `fit`)             | error    |
-| QA-TEST-002 | Παραλειμένο τεστ χωρίς δικαιολογία                    | error    |
-| QA-TEST-002 | Παραλειμένο τεστ με καταγεγραμμένη δικαιολογία        | warning  |
-| QA-TEST-003 | Τεστ χωρίς assertions                                 | error    |
-| QA-TEST-004 | Σκληρό sleep (`waitForTimeout`, `sleep()`, `delay()`) | warning  |
-| QA-TEST-006 | Κατάχρηση retry που κρύβει flakiness                  | warning  |
-| QA-TEST-010 | Κενό σώμα τεστ                                        | error    |
+| 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       |
 
-</details>
+Ο πλήρης κατάλογος δημιουργείται από το μητρώο, ποτέ δεν συντηρείται με το χέρι: `mjolnir rules --md`, [`docs/rules/`](docs/rules/) ή ο [οδηγός για το τι ελέγχει](https://sergey-bar.github.io/Mjolnir/guide/what-it-checks).
 
 <details>
-<summary><strong>Ποιότητα τεστ</strong></summary>
-
-| ID           | Κανόνας                       | Severity |
-| ------------ | ----------------------------- | -------- |
-| QA-TQUAL-002 | Ταυτολογική assertion         | error    |
-| QA-TQUAL-009 | Assertion promise χωρίς await | error    |
-| QA-TQUAL-011 | Σχολιασμένα τεστ              | warning  |
+<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>
 
-<details>
-<summary><strong>Playwright 🎭</strong></summary>
+Κάθε κανόνας κυκλοφορεί με ένα fixture must-fire **και** ένα must-not-fire, και ένας κανόνας που ενεργοποιείται στο δικό του αρνητικό fixture δεν μπορεί να κυκλοφορήσει. Αυτό είναι το τείχος προστασίας από ψευδώς θετικά· το `mjolnir doctor` το επιβάλλει στο CI αυτού του αποθετηρίου.
 
-| ID        | Κανόνας                                   | Severity |
-| --------- | ----------------------------------------- | -------- |
-| QA-PW-002 | Assertion locator χωρίς await             | error    |
-| QA-PW-003 | `page.pause()` / `test.only()` στο commit | error    |
-| QA-PW-004 | Εύθραυστοι CSS/XPath selectors            | warning  |
-| QA-PW-123 | Σκληρά URL περιβάλλοντος                  | warning  |
+### Selector Health Score
 
-</details>
+Το `mjolnir doctor:playwright` βαθμολογεί κάθε locator ανάλογα με το πώς βρίσκει ένα στοιχείο: όπως θα το έκανε ένας χρήστης (ρόλος, ετικέτα, κείμενο), μέσω ρητού συμβολαίου (`data-testid`) ή από δομική σύμπτωση (αλυσίδες CSS, XPath). Κάθε αρχείο παίρνει βαθμολογία από 0 έως 100:
 
-<details>
-<summary><strong>Ακεραιότητα CI</strong></summary>
-
-| ID        | Κανόνας                                                               | Severity |
-| --------- | --------------------------------------------------------------------- | -------- |
-| QA-CI-001 | Το `continue-on-error` κρύβει αποτυχίες                               | error    |
-| QA-CI-002 | Το `\|\| true` καταπίνει exit codes                                   | error    |
-| QA-CI-005 | Αναφορά καταναλώνεται αλλά ποτέ δεν παράγεται                         | error    |
-| QA-CI-007 | Περιτύλιξη retry γύρω από τεστ                                        | warning  |
-| QA-CI-008 | Step πάντα επιτυχές κρύβει αποτυχίες                                  | error    |
-| QA-CI-009 | Exit code του τεστ δεν προωθείται (`\|` χωρίς pipefail, αλυσίδες `;`) | error    |
-| QA-CI-010 | Τεστ παραλείπονται εκεί που πρέπει να μπλοκάρουν (skip-on-PR guards)  | error    |
-
-</details>
-
-<details>
-<summary><strong>Python / pytest 🐍</strong></summary>
-
-| ID        | Κανόνας                                       | Severity |
-| --------- | --------------------------------------------- | -------- |
-| QA-PY-002 | Παραλειμένο τεστ (`skip`, μη αυστηρό `xfail`) | warning  |
-| QA-PY-003 | Συνάρτηση τεστ χωρίς assertions               | error    |
-| QA-PY-005 | `time.sleep()` σε τεστ                        | warning  |
-| QA-PY-012 | Ταυτολογική assertion                         | error    |
-
-Συνολικά 20 κανόνες Python (QA-PY-001…012 υγιεινή pytest + QA-PY-101…108 Playwright-Python).
+```text
+  ▍ SELECTOR HEALTH
 
-</details>
+e2e/login.spec.ts
+  [█████████████░░░░░░░]  65 / 100
+  role/text: 1 · testid: 0 · plain-css: 0 · css-chains: 1 ⚠ · xpath: 0
 
-<details>
-<summary><strong>Java / JUnit · TestNG ☕</strong></summary>
+e2e/checkout.spec.ts
+  [██████████████████░░]  88 / 100
+  role/text: 4 · testid: 1 · plain-css: 0 · css-chains: 1 ⚠ · xpath: 0
+```
 
-| ID        | Κανόνας                                    | Severity |
-| --------- | ------------------------------------------ | -------- |
-| QA-JV-101 | Απενεργοποιημένο τεστ (`@Disabled`)        | warning  |
-| QA-JV-102 | Σκληρό sleep (`Thread.sleep()`)            | warning  |
-| QA-JV-103 | Μέθοδος τεστ χωρίς assertions              | error    |
-| QA-JV-105 | Σκληρό sleep Playwright `waitForTimeout()` | warning  |
-| QA-JV-106 | Εύθραυστος selector αντί για role locator  | warning  |
+Αυτό μετρά **ανθεκτικότητα, όχι ορθότητα**. Το `.btn.btn-primary > div:nth-child(2)` περνά σήμερα και θα συνεχίσει να περνά μέχρι κάποιος να αγγίξει το markup. Μια χαμηλή βαθμολογία δεν ισχυρίζεται ποτέ ότι το τεστ είναι χαλασμένο, μόνο ότι εξαρτάται από markup που κανείς δεν υποσχέθηκε να διατηρήσει.
 
-</details>
+<br />
 
-<details>
-<summary><strong>C# / .NET — NUnit · xUnit · MSTest 🟣</strong></summary>
+## Η βαθμολογία αξιοπιστίας
 
-| ID        | Κανόνας                                        | Severity |
-| --------- | ---------------------------------------------- | -------- |
-| QA-CS-101 | Παραλειμένο τεστ (`[Ignore]`, `[Fact(Skip=)]`) | warning  |
-| QA-CS-102 | Σκληρό sleep (`Thread.Sleep` / `Task.Delay`)   | warning  |
-| QA-CS-103 | Μέθοδος τεστ χωρίς assertions                  | error    |
-| QA-CS-105 | Σκληρό sleep `WaitForTimeoutAsync()`           | warning  |
-| QA-CS-106 | Εύθραυστος selector αντί για role locator      | warning  |
+<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>
 
-</details>
+<sub>Κάθε βαθμολογία από 0 έως 100, τοποθετημένη από το πραγματικό `deriveScoreState`. Δημιουργείται με `npm run docs:gauge` και κλειδώνεται έναντι αποκλίσεων στο CI.</sub>
 
-> Ο πλήρης ζωντανός κατάλογος — κάθε κανόνας με tier, confidence,
-> κίνδυνο false positive και διαθεσιμότητα autofix — παράγεται από το
-> μητρώο:
->
-> ```bash
-> mjolnir rules --md
-> ```
->
-> Οι σελίδες ανά κανόνα ζουν στο [`docs/rules/`](docs/rules/).
+| Βαθμολογία | Ετυμηγορία                              |
+| ---------- | --------------------------------------- |
+| `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).
 
-**78 από 99 κανόνες φέρουν ποσοστό false positive μετρημένο σε πραγματικό
-κώδικα OSS** (≥ 10 χειροκίνητα ταξινομημένα ευρήματα ο καθένας· βλ.
-[docs/FP-AUDIT.md](docs/FP-AUDIT.md)). Οι άλλοι 21 κυκλοφορούν πάνω στην
-εκτίμηση του συγγραφέα. Το υποσέλιδο κάθε σκαν σου λέει πόσοι από τους
-_ενεργούς_ κανόνες είναι μετρημένοι· `mjolnir rules --unmeasured`
-παραθέτει τους άμετρητους· η σελίδα `mjolnir explain` κάθε κανόνα
-δηλώνει την κατάστασή του. Δημοσιεύουμε το ποσοστό ακόμα κι όταν είναι
-αυτό. Να μεγαλώσει αυτός ο αριθμός είναι η συνεχιζόμενη δουλειά του έργου.
+**Τι δεν σημαίνει το 100.** Δεν σημαίνει ότι το λογισμικό είναι σωστό, ότι η σουίτα επαρκεί ή ότι το προϊόν είναι απαλλαγμένο από ελαττώματα. Σημαίνει ένα πράγμα: **κανένας από τους κανόνες που αξιολόγησε το Mjölnir δεν παρήγαγε αφαίρεση σε αυτή τη σάρωση και με αυτό το μοντέλο τεκμηρίωσης.**
 
-### Tiers κανόνων και ωριμότητα γλωσσών
+<br />
 
-Κάθε κανόνας είναι `core`, `extended` ή `quarantine`, ανατεθειμένος από
-το **μετρημένο** ποσοστό false positive του:
+## Το μοντέλο τεκμηρίωσης
 
-| Tier         | Σημασία                                | Προεπιλεγμένο σκαν | `--strict` |
-| ------------ | -------------------------------------- | :----------------: | :--------: |
-| `core`       | ≤ 10 % μετρημένο FP                    |         ✅         |     ✅     |
-| `extended`   | ≤ 30 % μετρημένο FP                    |         ✅         |     ✅     |
-| `quarantine` | πάνω από 30 %, ή ακόμα άμετρο (n < 10) |         ❌         |     ✅     |
+Κάθε εύρημα φέρει δύο ετικέτες: πόσο σίγουρο είναι το Mjölnir και πόσο έχει ελεγχθεί το εύρημα. Αυτή είναι η διαφορά ανάμεσα σε ένα εργαλείο που αναφέρει μοτίβα και σε ένα εργαλείο στο οποίο μπορείτε να εξαρτήσετε μια κυκλοφορία.
 
-| Γλώσσα          | Adapter           | Κάλυψη σήμερα                                                      |
-| --------------- | ----------------- | ------------------------------------------------------------------ |
-| TypeScript / JS | AST μεταγλωττιστή | η ευρύτερη, η πιο μετρημένη — ως επί το πλείστον `core`/`extended` |
-| Python / pytest | Στρώμα regex      | ευρεία, ελεγμένη σε corpus — ως επί το πλείστον `core`/`extended`  |
-| Java            | Στρώμα regex      | νεότερη — ως επί το πλείστον `extended`/`quarantine`               |
-| C# / .NET       | Στρώμα regex      | νεότερη — ως επί το πλείστον `extended`/`quarantine`               |
+**Πόσο σίγουρο — το επίπεδο τεκμηρίωσης.**
 
-TypeScript και Python έχουν την ευρύτερη μετρημένη κάλυψη. Η Java και η
-C# κυκλοφορούν, είναι τεκμηριωμένες και μένουν εκτός του headline αριθμού
-μέχρι μια πραγματική σουίτα καταναλωτή (όχι τα ίδια τα τεστ μιας
-βιβλιοθήκης binding) να ελεγχθεί.
+| Επίπεδο | Όνομα                    | Σημαίνει                                                  | Αφαίρεση |
+| ------- | ------------------------ | --------------------------------------------------------- | -------- |
+| **E2**  | Ντετερμινιστική απόδειξη | Το ελάττωμα υπάρχει στον κώδικα όπως είναι γραμμένος      | Πλήρης   |
+| **E1**  | Τεκμήριο μοτίβου         | Ταίριαξε ένα μοτίβο στενά συνδεδεμένο με το ελάττωμα      | Μισή     |
+| **E0**  | Παρατήρηση               | Αξίζει να το ξέρετε. Όχι ισχυρισμός ότι κάτι είναι λάθος. | Μηδέν    |
 
----
+Η βεβαιότητα μιας ανίχνευσης δεν είναι η ισχύς της απόδειξης. Ένας κανόνας μπορεί να είναι βέβαιος ότι βρήκε αυτό που έψαχνε και παρ' όλα αυτά να κοιτάζει μια ευρετική. Τα ευρήματα E1 υπάρχουν για να διαβάζονται και να κρίνονται, ποτέ για να εφαρμόζονται στα τυφλά, και αυτό το όριο είναι αποτυπωμένο στο εύρημα στο τερματικό, στο JSON και στην παράδοση στον πράκτορα.
 
-## Πώς λειτουργεί το σκόρ
+**Πόσο ελέγχθηκε — το επίπεδο εμπιστοσύνης.** Τα περισσότερα ευρήματα προκύπτουν από την ανάγνωση του κώδικά σας. Δώστε στο Mjölnir την αναφορά μιας πραγματικής εκτέλεσης τεστ και μπορεί να επιβεβαιώσει ότι ο κώδικας όντως εκτελέστηκε.
 
 <p align="center">
-  <img src="assets/readme/terminal-hero.svg" alt="Έξοδος τερματικού Mjölnir — WORTHINESS 75/100 NEEDS WORK, ανάλυση διαγνώσεων ανά κατηγορία και λίστα FIX THIS FIRST" width="820" />
+  <img src="assets/readme/trust-ladder.svg" alt="Η κλίμακα εμπιστοσύνης από L0 έως L5. Τα L0 έως L2 προκύπτουν από την ανάγνωση του κώδικα· τα L3 έως L5 χρειάζονται πραγματική αναφορά εκτέλεσης, κάτι που σημειώνεται με ένα κενό στην κλίμακα." width="100%" />
 </p>
 
-<sub>Αναδημιουργείται με `npm run docs:hero`;
-[`tests/hero-asset-reproducibility.spec.ts`](tests/hero-asset-reproducibility.spec.ts)
-ρίχνει το CI αν ο artifact αποκλίνει από ό,τι τυπώνει ο reporter.</sub>
+| Επίπεδο | Με απλά λόγια             | Τι χρειάζεται                                                                  |
+| ------- | ------------------------- | ------------------------------------------------------------------------------ |
+| **L0**  | Σημειώθηκε                | Ανάγνωση του κώδικα                                                            |
+| **L1**  | Μοιάζει με το πρόβλημα    | Ανάγνωση του κώδικα: ταίριαξε ένα μοτίβο                                       |
+| **L2**  | Αποδεδειγμένο στον κώδικα | Ανάγνωση του κώδικα: το ελάττωμα είναι δομικό                                  |
+| **L3**  | Το αρχείο εκτελέστηκε     | Μια αναφορά εκτέλεσης δείχνει ότι το αρχείο του ευρήματος εκτελέστηκε          |
+| **L4**  | Το τεστ εκτελέστηκε       | Μια αναφορά εκτέλεσης δείχνει ότι το τεστ του ευρήματος εκτελέστηκε            |
+| **L5**  | Η εκτέλεση συμφωνεί       | Το ίδιο το αποτέλεσμα της εκτέλεσης επιβεβαιώνει την κατηγορία του ελαττώματος |
 
-Το σκόρ είναι διαφανές: **error −8, warning −3, info −1**, μετά
-κανονικοποίηση με την έκθεση της σουίτας (αφαιρέσεις ανά δήλωση τεστ).
-Οι αφαίρεσεις σταθμισμένες με αποδείξεις σημαίνουν ότι τα αδύναμα σήματα
-κοστίζουν λιγότερο. Το τερματικό δείχνει τους ίδιους εκπτώτους αριθμούς
-που χρησιμοποιεί το σκόρ — καμία μαύρη κάψουλα. Πλήρης μέθοδος:
-[docs/SCORING.md](docs/SCORING.md).
+Μια στατική σάρωση σταματά στο L2. Μόνο μια πραγματική αναφορά εκτέλεσης (Playwright JSON, Jest ή Vitest JSON, JUnit XML) μπορεί να ανεβάσει ένα εύρημα στο L3 ή παραπάνω, οπότε ένα εύρημα που δεν εθεάθη ποτέ να εκτελείται δεν μπορεί ποτέ να ισχυριστεί ότι εκτελέστηκε. Ορισμοί: [docs/TERMINOLOGY.md](docs/TERMINOLOGY.md).
 
-**Ετυμηγορίες**
+### Πόσο από αυτό είναι μετρημένο
 
-| Score   | Ετυμηγορία       |
-| ------- | ---------------- |
-| ≥ 80    | ✓ **WORTHY**     |
-| 50 – 79 | ⚠ **NEEDS WORK** |
-| < 50    | ✖ **UNWORTHY**   |
+**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, βρίσκεται στον έλεγχο.
 
-| Επίπεδο | Σημασία              | Επίδραση στο σκόρ | Παράδειγμα                                          |
-| ------- | -------------------- | ----------------- | --------------------------------------------------- |
-| E2      | Καθορισμένο ελάττωμα | Πλήρης αφαίρεση   | Commitμένο `.only` — δομικά αποδείξιμο              |
-| E1      | Ευρετικό μοτίβο      | Μισή αφαίρεση     | Regex-βρεμένο `sleep()` — ισχυρό σήμα, όχι απόδειξη |
-| E0      | Παρατήρηση           | Μηδέν (μόνο info) | Αναφέρεται αλλά δεν gated ποτέ CI ούτε αφαιρεί      |
+### Επίπεδα εμπιστοσύνης κανόνων
 
-Οι περισσότεροι κανόνες είναι **E1**. Το σύνθημα «we prove it»
-αναφέρεται σε αυτό το σύστημα: τα ευρήματα E2 είναι δομική απόδειξη·
-τα ευρήματα E1 είναι σωστά τοποθετημένες προειδοποιήσεις, όχι τυπικές
-αποδείξεις.
+Τα επίπεδα ακολουθούν το μετρημένο ποσοστό ψευδώς θετικών, όχι γνώμες:
 
-Ένα άδειο repo σκοράρει `null`, ποτέ ψεύτικα 100 — δες
-[Μοντέλο εμπιστοσύνης](#μοντέλο-εμπιστοσύνης).
+| Επίπεδο         | Μετρημένο FP          | Συμπεριφορά                                               |
+| --------------- | --------------------- | --------------------------------------------------------- |
+| **core**        | ≤ 10%                 | Προεπιλεγμένη αναφορά, μπλοκάρει                          |
+| **extended**    | ≤ 30%                 | Προεπιλεγμένη αναφορά, χαμηλότερη βεβαιότητα              |
+| **quarantine**  | > 30% ή ρητά δηλωμένο | Μόνο `--strict`, περιορισμένο σε info, δεν μπλοκάρει ποτέ |
+| _μη μετρημένος_ | n < 10                | Δεν μπορεί να προαχθεί σε core μέχρι να μετρηθεί          |
 
----
+Οι ζώνες FP μπορούν μόνο να υποβιβάσουν ένα επίπεδο — δεν προάγουν ποτέ έναν κανόνα εκτός `quarantine` αν έχει δηλωθεί ρητά εκεί. Ένας ρητά τεθείς σε καραντίνα κανόνας παραμένει στο quarantine ανεξαρτήτως του μετρημένου ποσοστού FP.
 
-## 🎭 Selector Health Score
+Προαγωγή, υποβιβασμός και ωριμότητα ανά γλώσσα: [κύκλος ζωής των κανόνων](https://sergey-bar.github.io/Mjolnir/reference/rule-lifecycle).
 
-Η headline μετρική για σουίτες Playwright — πόσο ανθεκτικοί είναι οι
-locators σου:
+### Γιατί αυτό δεν είναι linter
 
-```text
-▚ SELECTOR HEALTH — e2e/checkout.spec.ts
+Οι linters σάς λένε αν ο κώδικας ακολουθεί κανόνες. Το Mjölnir σάς λέει αν μπορείτε να εμπιστευτείτε την επαλήθευσή σας.
 
-  [█████████████████░░░]  83 / 100
-  role/text: 2 · testid: 1 · css-chains: 1 ⚠ · xpath: 0
-```
+|                                                                            | 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>
 
-Locators με βάση τα roles παίρνουν πλήρες σκόρ. Οι αλυσίδες CSS class
-και το XPath βυθίζουν το σκόρ — σπάνε σε κάθε refactor DOM χωρίς να σου
-λένε ποια συμπεριφορά παλινδρόμησε.
+Χρησιμοποιήστε και έλεγχο με ΤΝ. Πιάνει αποχρώσεις, πρόθεση και σχεδιαστικά λάθη που κανένα μοτίβο δεν μπορεί να βρει. Το Mjölnir πιάνει ό,τι ξεφεύγει από τον έλεγχο με ΤΝ επειδή φαίνεται σκόπιμο: ένα `.only` σε commit, έναν καταπιωμένο κωδικό εξόδου, ένα `continue-on-error` σε job τεστ. Αυτά χρειάζονται σάρωση, όχι συλλογισμό.
 
----
+<br />
 
-## 🔬 Αποδείξεις runtime
+## Ανάλυση εκτελέσεων τεστ
 
-Η στατική ανίχνευση flakiness είναι μαντεψιά. Το Mjölnir διαβάζει
-**πραγματικά δεδομένα εκτέλεσης** — αναφορές JSON Playwright και XML
-JUnit από οποιονδήποτε runner:
+Η στατική ανάλυση συλλογίζεται για κώδικα που δεν εκτελέστηκε ποτέ. Η ανάλυση εκτελέσεων διαβάζει τι πραγματικά συνέβη: Playwright JSON, Jest JSON, Vitest JSON και JUnit XML από οποιονδήποτε runner.
 
 ```bash
 mjolnir forensics ./test-results/
 ```
 
 ```text
-▚ FLAKINESS LEADERBOARD
+  ▍ FLAKINESS LEADERBOARD
 
 3 tests · 1 failed · 1 flaky · 1 retried
 
@@ -403,300 +435,184 @@ FAILING    declines an expired card (e2e/checkout.spec.ts)
            ████░░░░░░░░░░░░░░░░ 1.1s · 1 attempt
 ```
 
-Τεστ που περνά μόνο από την προσπάθεια ≥ 2 δεν είναι τεστ που περνά —
-είναι τυχερό τεστ. Χαρακτηρίζεται `TRUE-FLAKE` ανεξάρτητα από το τελικό
-πράσινο τσεκ.
+Το `TRUE-FLAKE` δεν σημαίνει ότι το τεστ επαναλήφθηκε. Σημαίνει ότι το τεστ **απέτυχε σε τουλάχιστον μία προσπάθεια και μετά τελείωσε πράσινο**: μια τυχερή επιτυχία, που σημειώνεται ό,τι κι αν λέει το τελικό τικ. Το `mjolnir triage` μετατρέπει αυτό το ιστορικό σε πρόταση καραντίνας και το `mjolnir pw-report` συνοψίζει μια εκτέλεση. Οι ίδιες αναφορές εκτέλεσης είναι αυτές που ανεβάζουν τα ευρήματα στα επίπεδα εμπιστοσύνης L3 και πάνω.
 
----
+<br />
 
-## ⚡ Το Mjölnir δεν είναι ακόμα ένα linter
+## Ακεραιότητα CI
 
-Τα linters σου λένε αν ο κώδικας ακολουθεί κανόνες. Το Mjölnir σου λέει
-αν η επαλήθευσή σου μπορεί να εμπιστευτεί.
+Ένα τεστ μπορεί να περνά ενώ το pipeline γύρω του δεν μπορεί να αποτύχει. Το Mjölnir διαβάζει και τα workflows: `continue-on-error`, `|| true`, κωδικούς εξόδου που δεν μεταφέρονται ποτέ, steps που πετυχαίνουν πάντα, αναφορές που καταναλώνονται αλλά δεν δημιουργούνται ποτέ, και πύλες που παραλείπονται ακριβώς στα γεγονότα που θα έπρεπε να μπλοκάρουν. Κάθε εύρημα κατονομάζει το job, το step και τη γραμμή, και φέρει το δικό του επίπεδο τεκμηρίωσης.
 
-|                                                                | ESLint / SonarQube | Εργαλεία coverage | Χειροκίνητο review | **Mjölnir** |
-| -------------------------------------------------------------- | :----------------: | :---------------: | :----------------: | :---------: |
-| Ακεραιότητα CI workflow (`continue-on-error`, `\|\| true`)     |         ❌         |        ❌         |       σπάνια       |     ✅      |
-| Cross-γλώσσα (TS, Python, Java, C#) από ένα εργαλείο           |         ❌         |        ❌         |         ❌         |     ✅      |
-| Βαθμολογεί ανθεκτικότητα Playwright locators (Selector Health) |         ❌         |        ❌         |       σπάνια       |     ✅      |
-| Σημαίνει τεστ χωρίς πραγματικές assertions                     |   ✅ (plugin)\*    |        ❌         |     καμιά φορά     |     ✅      |
-| Πιάνει σκληρά sleeps (`waitForTimeout`, `time.sleep`)          |   ✅ (plugin)\*    |        ❌         |     καμιά φορά     |     ✅      |
-| Τρέχει σε δευτερόλεπτα, μηδέν κλήσεις δικτύου κατά το σκαν     |         ✅         |        ✅         |         —          |     ✅      |
+Δημιουργήστε το workflow για PR, συμβουλευτικό από προεπιλογή:
 
-\*Το `eslint-plugin-jest` (`expect-expect`) και το
-`eslint-plugin-playwright` (`expect-expect`, `no-wait-for-timeout`)
-καλύπτουν αυτά για τα αντίστοιχα frameworks τους.
+```bash
+mjolnir ci install
+```
 
-**Η ανάλυση runtime** είναι ξεχωριστή κατηγορία δίπλα στο στατικό
-linting:
+Ή προσθέστε το action του Marketplace σε ένα workflow που ήδη έχετε:
 
-|                                                                | Playwright retry reporter | Allure / ReportPortal | **Mjölnir forensics** |
-| -------------------------------------------------------------- | :-----------------------: | :-------------------: | :-------------------: |
-| Διαβάζει πραγματικά δεδομένα runs για ετυμηγορίες `TRUE-FLAKE` |         μερικώς\*         |     μερικώς (tag)     |          ✅           |
-| Αναφορά triage flakiness από ιστορικό εκτέλεσης                |            ❌             |          ✅           |          ✅           |
-| Ενσωματώνεται με τον στατικό δείκτη αξιοπιστίας                |            ❌             |          ❌           |          ✅           |
+```yaml
+- uses: Sergey-Bar/Mjolnir@v1
+  with:
+    scope: changed
+    fail-on: error
+```
 
-\*Το Playwright παρακολουθεί εσωτερικά τα retries αλλά δεν παράγει
-αυτόνομη αναφορά flakiness με ετικέτες ετυμηγοριών.
+Καρφιτσώστε το `@v1` για να ακολουθείτε την κύρια γραμμή, ή ένα ακριβές tag (`@v0.5.32`) για αναπαραγώγιμη πύλη. Το [docs/DISTRIBUTION-KIT.md](docs/DISTRIBUTION-KIT.md) καλύπτει το Marketplace, το Smithery και τα μητρώα MCP.
 
----
+Για να στείλετε τα ευρήματα στο GitHub Code Scanning, ανεβάστε SARIF (απαιτεί `security-events: write` σε επίπεδο workflow ή job):
 
-## 🤖 Γιατί όχι απλώς AI code review;
+```yaml
+- run: npx mjolnir-qa@latest --format sarif > mjolnir.sarif
+  continue-on-error: true
+- uses: github/codeql-action/upload-sarif@v3
+  if: ${{ !cancelled() }}
+  with:
+    sarif_file: mjolnir.sarif
+```
 
-Διαφορετικό πρόβλημα, διαφορετικό στρώμα. Το AI review μπορεί να πιάσει
-ύποπτη αλλαγή τεστ σε ένα diff· δεν αποδεικνύει ότι το σύστημα
-επαλήθευσης συνολικά αξίζει εμπιστοσύνη — και βλέπει μόνο το diff που
-του δείχνεις.
+Στο 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).
 
-|                                              |      AI code review (Copilot κ.λπ.)      |               **Mjölnir**                |
-| -------------------------------------------- | :--------------------------------------: | :--------------------------------------: |
-| Κόστος ανά σκαν                              | Tokens (κλιμακώνεται με το μέγεθος diff) |    **Μηδέν** (τοπικό, εγκατεστημένο)     |
-| Βλέπει όλη τη σουίτα + όλες τις ρυθμίσεις CI |       Μόνο το PR diff που δείχνεις       |            **Όλα, κάθε φορά**            |
-| Καθοριστικό (ίδιο input → ίδιο output)       |           ❌ (μη καθοριστικό)            |                  **✅**                  |
-| Πιάνει μοτίβα που κοιμούνται μήνες           |        Μόνο αν είναι στο context         |     **✅** (σκανάρει όλα τα αρχεία)      |
-| Θυμάται ευρήματα μεταξύ runs                 |    ❌ (καμία μνήμη μεταξύ συνεδριών)     |         **✅** (baseline + diff)         |
-| Τρέχει χωρίς ανθρώπινο έναυσμα               |          Χρειάζεται PR ή prompt          | **✅** (CI hook, τρέχει σε δευτερόλεπτα) |
+### Απόδοση στο εύρος των αλλαγών
 
-**Χρησιμοποίησέ τα και τα δύο.** Το AI πιάνει νύαντσε, πρόθεση και
-σχεδιαστικά ελαττώματα που καμία regex δεν βρίσκει. Το Mjölnir πιάνει
-τα δομικά μοτίβα που το AI παραβλέπει επειδή φαίνονται «εσκεμμένα» —
-ένα commitμένο `.only`, ένα καταπιμένο exit code, ένα `continue-on-error`
-σε τεστ job. Δεν είναι bugs που χρειάζονται συλλογισμό· είναι γεγονότα
-που χρειάζονται σκαν.
+```bash
+npx mjolnir-qa@latest --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>`.
 
-## 🤖 Ενσωμάτωση CI
+Όταν το merge-base δεν μπορεί να επιλυθεί (ρηχός κλώνος, αποσυνδεδεμένο HEAD, στόχος εκτός git), τα ευρήματα επιστρέφουν σε απόδοση σε ολόκληρο το αρχείο **και η αναφορά το λέει.** Μια σιωπηλή εναλλακτική θα ήταν ακριβώς το είδος ελαττώματος που υπάρχει αυτό το εργαλείο για να πιάνει.
 
-Μία εντολή παράγει PR workflow — συμβουλευτικό από προεπιλογή, ποτέ
-μπλοκάρισμα:
+<br />
 
-```bash
-mjolnir ci install
-```
+## Πράκτορες ΤΝ
 
-Ή σύνδεσέ το εγγενώς σε GitHub Code Scanning μέσω SARIF:
+Τα ευρήματα αξίζουν κάτι μόνο αν κάτι ενεργεί με βάση αυτά.
 
-```yaml
-- run: npx mjolnir-qa@latest --format sarif > mjolnir.sarif
-- uses: github/codeql-action/upload-sarif@v3
-  with:
-    sarif_file: mjolnir.sarif
+```text
+SCAN → EVIDENCE → HANDOFF → AGENT → RE-SCAN → PROOF
 ```
 
-Ρύθμιση editor και pipeline για SARIF:
-[docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md).
+**Η ΤΝ γράφει τη διόρθωση. Το Mjölnir την επαληθεύει.** Η απόδειξη προέρχεται από τη νέα σάρωση, ποτέ από την αναφορά επιτυχίας του ίδιου του πράκτορα.
 
-### Κάλυψη changed-scope
+| Εντολή            | Τι παίρνει ο πράκτορας                                                                                                                                                          |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mjolnir mcp`     | Ένας διακομιστής [MCP](https://modelcontextprotocol.io) μέσω stdio. Τα `scan`, `explain` και `diff` γίνονται εργαλεία που καλούνται.                                            |
+| `mjolnir handoff` | Μια αποθηκευμένη αναφορά `--json` γίνεται ντετερμινιστικό σχέδιο σε Markdown: τι εντοπίστηκε, το όριο τεκμηρίωσης ανά εύρημα, τι **δεν** πρέπει να αλλάξει, πώς να επαληθευτεί. |
+| `mjolnir install` | Γράφει στις επιφάνειες πρακτόρων που ήδη έχει το αποθετήριό σας (`.claude/`, `.cursor/`, `.kilo/`, `AGENTS.md`), ώστε ο πράκτορας να ξανασαρώνει πριν δηλώσει ότι τελείωσε.     |
 
-Το `--scope changed` αποδίδει ευρήματα σε γραμμές που πρόσθεσε το branch
-σου σε σχέση με το merge-base με το `main`. Καλύπτει αρχεία τεστ
-(`*.spec.*`, `*.test.*`) συν αρχεία GitHub workflow και ρυθμίσεις
-Playwright στο diff. Όταν το merge-base δεν λύνεται — shallow clone,
-detached HEAD, μη-git στόχος, διαφορετικό default branch — υποβαθμίζει
-ειλικρινά: τα ευρήματα επιστρέφουν σε απόδοση κατά σύνολο αρχείου και η
-αναφορά το λέει. Υπενόμησε την base ref με `--base <ref>`.
+Προσθέστε το σε έναν client που έχει δικό του CLI:
 
----
-
-## Διαμόρφωση
-
-Το Mjölnir είναι zero-config. Ένα προαιρετικό `mjolnir.config.json` (ή
-`.mjolnir.json`) στη ρίζα του repo ρυθμίζει severity, gating και scope —
-δεν αλλάζει ποτέ τη σημασιολογία ανίχνευσης.
+```bash
+claude mcp add mjolnir -- npx -y mjolnir-qa@latest mcp
+```
 
-| Key                 | Τύπος                                | Επίδραση                                                                                                                                                                      |
-| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `exclude`           | `string[]`                           | Επιπλέον ignore globs (υποσύνολο gitignore), πάνω από τα ενσωματωμένα defaults                                                                                                |
-| `gate`              | `"advisory" \| "error" \| "warning"` | Ποια severity βγαίνουν μη μηδενικά (default `error`; το `advisory` δεν μπλοκάρει ποτέ)                                                                                        |
-| `severityOverrides` | `{ "<RULE-ID>": severity }`          | Επανατάσσει τα ευρήματα ενός κανόνα για το repo σου                                                                                                                           |
-| `ignore`            | `IgnoreEntry[]`                      | Καταστέλλει ευρήματα — **το `reason` απαιτείται**· οι εγγραφές λήγουν μετά από 90 ημέρες (ρητό `expires` date, ή time last-modified του αρχείου ρυθμίσεων για εγγραφές χωρίς) |
-| `plugins`           | `string[]`                           | Πακέτα κανόνων τρίτων (δες [Μοντέλο εμπιστοσύνης](#μοντέλο-εμπιστοσύνης))                                                                                                     |
+Ή σε οποιονδήποτε client δέχεται ένα μπλοκ `mcpServers`:
 
 ```json
 {
-  "gate": "error",
-  "exclude": ["legacy/**"],
-  "severityOverrides": { "QA-PW-141": "warning" },
-  "ignore": [
-    {
-      "ruleId": "QA-TEST-004",
-      "files": ["e2e/legacy-login.spec.ts"],
-      "reason": "Third-party widget needs a settle delay; tracked in JIRA-4821",
-      "expires": "2026-12-31"
-    }
-  ]
+  "mcpServers": {
+    "mjolnir": { "command": "npx", "args": ["-y", "mjolnir-qa@latest", "mcp"] }
+  }
 }
 ```
 
-- **`.mjolnirignore`** — απλό αρχείο τύπου gitignore για εξαιρέσεις
-  διαδρομών, ίδια διάλεκτος με το `exclude`. Χρησιμοποίησέ το για θόρυβο
-  ανά μηχανή· χρησιμοποίησε `exclude` όταν η λίστα ανήκει στον version
-  control, δίπλα στην υπόλοιπη ρύθμιση.
-- **CLI overrides** — `--strict` (συμπερίληψη κανόνων καραντίνας),
-  `--width <cols>` και `--ascii` / `--no-ascii` (απόδοση τερματικού),
-  `--tone blunt` (πιο άκαμπτα μηνύματα), `--max-duration <sec>`
-  (περιορισμένη μερική σκαν).
-- Καταστολή κανόνων και κύκλος ζωής deprecation:
-  [docs/RULE-LIFECYCLE.md](docs/RULE-LIFECYCLE.md).
-
-Οι εγγραφές `ignore` τροφοδοτούν και την αυτόνομη εντολή
-`mjolnir suppressions`, που παραθέτει τι είναι κατασταλμένο τώρα και
-πότε λήγει κάθε εγγραφή.
-
----
-
-## 📐 Exit codes & συμβόλαια
-
-Παγωμένα — ασφαλή για χτίσιμο CI λογικής:
-
-| Exit code | Σημασία                                                                               |
-| --------- | ------------------------------------------------------------------------------------- |
-| `0`       | Καθαρό — κανένα εύρημα στο ή πάνω από το gate                                         |
-| `1`       | Ευρήματα στο ή πάνω από το gate                                                       |
-| `2`       | Μερικό σκαν (τέλος χρονικού προϋπολογισμού, δυσανάγνωστα αρχεία) — δεν μπλοκάρει ποτέ |
-| `10`      | Λάθος χρήσης (bad flag, λείπει στόχος)                                                |
-| `20`      | Εσωτερικό λάθος                                                                       |
-
-Η αναφορά JSON/SARIF είναι `schemaVersion: 1`. Τα IDs κανόνων
-(`QA-<FAMILY>-NNN`) είναι αμετάβλητα μόλις κυκλοφορήσουν και δεν
-επαναχρησιμοποιούνται ποτέ.
-
----
-
-## Μοντέλο εμπιστοσύνης
-
-- **Local-first** — μηδέν κλήσεις δικτύου κατά το σκαν. Ποτέ. Μηδενική
-  τηλεμετρία.
-- **Καμία ψεύτικη απόδειξη** — προτιμούμε να πούμε «άγνωστο» παρά
-  «επαληθευμένο». Άδειο repo παίρνει `score: null`, ποτέ ψεύτικα 100.
-- **Μερική ειλικρίνεια** — αν η ανάλυση κόπηκε, η έξοδος το λέει.
-  Ποτέ «complete» όταν δεν είναι.
-- **FP τείχος** — η ανίχνευση τρέχει σε άποψη κώδικα χωρίς
-  σχόλια/strings (οι κανόνες TypeScript χρησιμοποιούν AST
-  μεταγλωττιστή): ένα μοτίβο μέσα σε σχόλιο πρόζας ή doc-παράδειγμα
-  string είναι τεκμηρίωση, όχι εύρημα.
-- **Μετρημένο, όχι δηλωμένο** — μόνο κανόνες με ποσοστό false positive
-  από πραγματικό OSS κώδικα κυκλοφορούν στα headline tiers (δες
-  [Πόσο από αυτό είναι μετρημένο](#πόσο-από-αυτό-είναι-μετρημένο)); το
-  υποσέλιδο σκαν και το `mjolnir rules --unmeasured` σου λένε ποιος
-  ποιος.
-- **Εμπιστοσύνη plugins και πύλη εκτέλεσης** — τα plugins είναι πακέτα npm
-  δηλωμένα κάτω
-  από `"plugins"`· τα JS modules ζουν στο `mjolnir-rules/*.mjs`.
-  **Δεν υπάρχει sandbox**: ο κώδικας plugin τρέχει με
-  πλήρη δικαιώματα Node, το ίδιο μοντέλο εμπιστοσύνης με plugins ESLint
-  ή Vitest. Γι' αυτό η εκτέλεση κώδικα είναι **opt-in σε κάθε σκαν**:
-  δώστε `--enable-plugins` (ή ορίστε `MJOLNIR_ENABLE_PLUGINS=1`),
-  αλλιώς οι πηγές ΔΕΝ φορτώνονται — μια δυνατή ειδοποίηση stderr
-  παραθέτει ακριβώς τι παραλείφθηκε. Το σκανάρει αν αξιόπιστο κώδικα
-  δεν τον εκτελεί ποτέ. Τα JSON rule manifests (`mjolnir-rules/*.json`)
-  δεν επηρεάζονται: δηλώνουν regex μοτίβα και δεν εκτελούν κώδικα εκ
-  σχεδίασης. Core προθέματα rule-ID είναι δεσμευμένα και απορρίπτονται
-  από plugins και εξωτερικούς κανόνες κατά της πλαστοπροσωπίας.
-- **Εξωτερικοί κανόνες τοπικοί στο workspace** (φάκελος, μηδέν δίκτυο) —
-  ένας φάκελος `mjolnir-rules/` δίπλα στον στόχο σκαν φορτώνει custom
-  κανόνες: JSON αρχεία δηλώνουν regex μοτίβα (κανένας κώδικας δεν
-  εκτελείται), `.mjs`/`.js` modules εξάγουν `rules` (πλήρης εμπιστοσύνη
-  Node, όπως plugins). Οι εξωτερικοί κανόνες φέρουν τα ίδια trust
-  metadata με το core· δεν μπορούν ποτέ να κυκλοφορήσουν στο core tier
-  (το core απαιτεί μετρημένο FP από το corpus sidecar — δηλωμένο
-  `tier: "core"` σφίγγεται σε `extended`), τηρούν tier πλαφόν και
-  ελέγχονται για drift: `mjolnir rules --md --external` απεικονίζει τον
-  κατάλογο από τα φορτωμένα αρχεία (provenance `external`), και ο
-  generator matrix δέχεται `--external <root>`.
-
----
-
-## 🏗️ Αρχιτεκτονική
+**Το προστατευτικό κιγκλίδωμα μετράει περισσότερο από την ευκολία.** Κάθε εύρημα σε μια παράδοση φέρει το όριό του. Το **E2** λέει _ντετερμινιστικό: ελέγξτε τη θέση και εφαρμόστε τη διόρθωση_. Το **E1** λέει _ΑΠΑΙΤΕΙΤΑΙ ΕΠΙΒΕΒΑΙΩΣΗ: η παρατήρηση από μόνη της δεν αποδεικνύει το ελάττωμα_. Ένας πράκτορας που διορθώνει τυφλά ένα E1, καταστέλλει έναν κανόνα ή τροποποιεί έναν κανόνα για να ανεβάσει τη βαθμολογία κάνει ακριβώς αυτό που υπάρχει αυτό το εργαλείο για να πιάνει, γι' αυτό η παράδοση το λέει στο prompt, δίπλα στο εύρημα.
 
-<details>
-<summary>Ανάπτυξη δέντρου</summary>
+<br />
 
-```
-mjolnir/
-├── src/
-│   ├── engine/          # LanguageAdapter interface + rule runner
-│   ├── adapters/        # typescript · python · java · csharp · github-actions
-│   ├── rules/           # rules across 8 families + the measured-FP table
-│   ├── playwright/      # Selector Health Score engine
-│   ├── discovery/       # workspace, frameworks, ignore resolution
-│   ├── scope/           # git merge-base changed-scope engine
-│   ├── scorer/          # transparent deduction table + prioritization
-│   ├── reporter/        # terminal · JSON · SARIF 2.1 · Mermaid
-│   ├── forensics/       # run-data ingestion · flake verdicts · triage
-│   ├── config/          # mjolnir.config.json + suppressions
-│   ├── plugins/         # third-party rule loading (no sandbox)
-│   └── commands/        # every subcommand
-└── tests/
-    ├── fixtures/        # must-fire / must-not-fire per rule
-    └── golden/          # frozen score regression locks
-```
+## Εμπιστοσύνη και ασφάλεια
 
-</details>
+**Τοπικά πρώτα, μηδενική τηλεμετρία.** Κανένα 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.
+
+### Κωδικοί εξόδου και το συμβόλαιο μηχανής
 
-- **Οι κανόνες είναι καθαρές συναρτήσεις** —
-  `(SourceFileContext) → Finding[]`, χωρίς I/O, χωρίς globals. Νέο
-  οικοσύστημα = ένας adapter + οι κανόνες του.
-- **TypeScript/Playwright χρησιμοποιεί AST μεταγλωττιστή** (ts-morph).
-  Python, Java και C# τρέχουν σε κοινό regex στρώμα με μεταμφιεσμένα
-  σχόλια/strings.
-- Ένα στρώμα AST tree-sitter WASM για Java και C# υπάρχει και είναι το
-  επόμενο βήμα ακρίβειας — δεν είναι ακόμα συνδεμένο στον σύγχρονο
-  σκαν pipeline.
+Παγωμένοι, ώστε να μπορείτε να χτίσετε λογική CI πάνω τους:
 
----
+| Κωδικός εξόδου | Σημασία                                                                                |
+| -------------- | -------------------------------------------------------------------------------------- |
+| `0`            | Καθαρό: κανένα εύρημα στο επίπεδο της πύλης ή πάνω από αυτό                            |
+| `1`            | Ευρήματα στο επίπεδο της πύλης ή πάνω από αυτό                                         |
+| `2`            | Μερική σάρωση (εξαντλήθηκε το χρονικό όριο, μη αναγνώσιμα αρχεία). Δεν μπλοκάρει ποτέ. |
+| `10`           | Σφάλμα χρήσης (λάθος σημαία, λείπει ο στόχος)                                          |
+| `20`           | Εσωτερικό σφάλμα                                                                       |
 
-## 📚 Τεκμηρίωση
+Το `2` είναι σκόπιμα διαφορετικό από το `0`: μια σάρωση που δεν ολοκληρώθηκε δεν «βρήκε τίποτα». Απλώς δεν τελείωσε την αναζήτηση.
 
-| Έγγραφο                                                | Τι περιέχει                                 |
-| ------------------------------------------------------ | ------------------------------------------- |
-| [docs/SCORING.md](docs/SCORING.md)                     | Κανονικοποίηση σκόρ + στάθμιση αποδείξεων   |
-| [docs/FP-AUDIT.md](docs/FP-AUDIT.md)                   | Μετρημένα ποσοστά false positive + μέθοδος  |
-| [docs/RULE-LIFECYCLE.md](docs/RULE-LIFECYCLE.md)       | Καταστάσεις κανόνων, καταστολή, deprecation |
-| [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md) | Έξοδος SARIF + ρύθμιση editor/CI            |
-| [docs/rules/](docs/rules/)                             | Δημιουργημένος κατάλογος ανά κανόνα         |
-| [CONTRIBUTING.md](CONTRIBUTING.md)                     | Dev setup + workflow συμβολής               |
-| [CHANGELOG.md](CHANGELOG.md)                           | Ιστορικό εκδόσεων                           |
-| [SECURITY.md](SECURITY.md)                             | Αναφορά ευπαθειών                           |
+Ό,τι καταναλώνει μια μηχανή (αποτελέσματα εργαλείων MCP, `--json`, SARIF 2.1) προέρχεται από ένα κανονικό αποτέλεσμα με εκδοσιοποιημένο σχήμα που **μόνο επεκτείνεται** (`schemaVersion: 1`, `contractVersion: 1`), ώστε κανένας καταναλωτής να μη χρειάζεται να ανασυνθέτει το νόημα από αποδοσμένο κείμενο. Δείτε [το συμβόλαιο μηχανής](docs/machine-contract.md). Τα ID κανόνων (`QA-<FAMILY>-NNN`) είναι αμετάβλητα μόλις κυκλοφορήσουν και δεν επαναχρησιμοποιούνται ποτέ.
 
----
+<br />
 
-## 📈 Κατάσταση
+## Τι δεν μπορεί να σας πει το Mjölnir
 
-**v0.5.x · ανοιχτή beta.** Το JSON schema και τα exit codes είναι
-παγωμένα συμβόλαια. TypeScript και Python έχουν την ευρύτερη μετρημένη
-κάλυψη· Java και C# είναι νεότερα — διαβάστε τα μέσω του
-[πίνακα tiers](#tiers-κανόνων-και-ωριμότητα-γλωσσών).
+- **Δεν εκτελεί τα τεστ σας.** Μια καθαρή σάρωση δεν είναι μια σουίτα που περνά.
+- **Δεν μπορεί να σας πει ότι ένας ισχυρισμός είναι _λάθος_.** Το `expect(total).toBe(41)` φαίνεται υγιές. Το Mjölnir βρίσκει τεστ που _δεν μπορούν να αποτύχουν_ και pipelines που _δεν μπορούν να γίνουν κόκκινα_, όχι τεστ που ελέγχουν το λάθος πράγμα.
+- **Δεν αποδεικνύει την επιχειρησιακή ορθότητα.** Τίποτα εδώ δεν λέει ότι το προϊόν σας κάνει αυτό που ζητούσε η απαίτηση.
+- **Ένα 100 δεν αποδεικνύει μια καλή σουίτα.** Το αν η σουίτα σας καλύπτει τον πραγματικό σας κίνδυνο είναι άλλο ερώτημα, και αυτό το εργαλείο δεν το απαντά.
+- **5 από 79 κανόνες βασίζονται σε εκτίμηση**, όχι σε μετρημένο ποσοστό. Ο καθένας το δηλώνει στο δικό του εύρημα.
+- **Το E1 δεν είναι E2.** Τα ευρετικά ευρήματα αξίζει να διαβάζονται, όχι να εφαρμόζονται στα τυφλά.
+- **Ένα άδειο αποθετήριο παίρνει `null`, ποτέ 100.**
+- **Ένα αρχείο με όνομα `*.spec.ts` χωρίς δηλώσεις τεστ δεν μετρά ως κάλυψη.** Ένα αποθετήριο του οποίου τα μόνα αρχεία spec περιέχουν imports ή τύπους (μηδέν κλήσεις `it`/`test`) παίρνει `null`, όχι 100.
 
----
+<br />
 
-## 🤝 Συνεισφορά
+## Τεκμηρίωση
 
-Νέοι κανόνες είναι ο ευκολότερος πρώτος συνεισφορά — μία εντολή
-σκαφφάρει τον κανόνα συν τα fixtures must-fire **και** must-not-fire (ο
-δημιουργημένος κανόνας αστοχεί σκόπιμα στα fixtures μέχρι να
-υλοποιήσεις πραγματική ανίχνευση — stub δεν μπορεί να κυκλοφορήσει):
+Ο πλήρης ιστότοπος τεκμηρίωσης βρίσκεται στο <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"
 ```
 
-Πλήρες dev setup, οι εντολές standing gate και οι νόμοι anti-creep /
-τείχος fixtures είναι στο [CONTRIBUTING.md](CONTRIBUTING.md).
+Το περιβάλλον ανάπτυξης, οι εντολές των μόνιμων πυλών και οι νόμοι anti-creep και τείχους προστασίας fixtures βρίσκονται στο [CONTRIBUTING.md](CONTRIBUTING.md).
 
----
+<br />
 
 <div align="center">
 
-**Σταμάτα να στέλνεις τεστ που δεν εμπιστεύεσαι.**
+<img src="assets/readme/closing.svg" alt="Τρέξτε το στο αποθετήριό σας." width="100%" />
 
 ```bash
 npx mjolnir-qa@latest
 ```
 
-**Star ⭐ · Watch 👀 · Contribute 🤝**
+[Διαβάστε τον οδηγό](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 />
+Ρωτήστε αν τα τεκμήρια αποδεικνύουν ότι αξίζουν εμπιστοσύνη.
 
-Κατασκευάστηκε από [Sergey Bar](https://www.linkedin.com/in/sergeybar/)
+<sub>Δημιουργήθηκε από τον [Sergey Bar](https://www.linkedin.com/in/sergeybar/) · Άδεια MIT</sub>
 
 </div>