From 93cdea7bcdf21475b2107a0be985f17e8b99e969 Mon Sep 17 00:00:00 2001
From: Praising Harris Ratnam <215876416+Pyhroff@users.noreply.github.com>
Date: Mon, 16 Nov 2026 18:29:22 +0000
Subject: [PATCH] docs: add Mermaid pipeline diagram
---
README.md | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/README.md b/README.md
index 9e5d069..82d71fd 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,24 @@ patches/ mcpaudit-0.7.patch and memsentry-1.1.patch (the scanner changes)
scripts/ collect, extract, scan, analyze, and evaluation scripts
```
+## Pipeline
+
+```mermaid
+flowchart LR
+ C["collect.py / collect_fresh.py
GitHub API selection"] --> CJ[("corpus.json
fresh_corpus.json
(commit SHAs)")]
+ CJ --> E["extract_manifests*.py
static extraction, nothing executed"]
+ E --> MJ[("manifests.json
manifests_fresh.json")]
+ MJ --> R["run_scans.py / fresh_run.py
mcpaudit + memsentry"]
+ R --> FJ[("mcpaudit_findings.json
memsentry_findings.json
summary.json")]
+ FJ --> L["hand labels
labels.json"]
+ L --> A["analyze.py
Wilson intervals"]
+ L --> V["eval_v07.py / eval_memsentry.py
held-out evaluation of patches"]
+ A --> AJ[("analysis.json")]
+ V --> VJ[("eval_v07.json
eval_memsentry.json")]
+ AJ --> T["tests/
recompute and compare README / REPORT numbers"]
+ VJ --> T
+```
+
## Verify the published numbers
The headline figures can be checked without re-running the scan: the tests recompute `data/analysis.json` and `data/eval_v07.json` from the committed labels and manifests and compare the numbers quoted in this README and REPORT.md with the data.