From 3380b8974b25dd81bb9027d17448d0597877c65e Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 16 Feb 2026 09:18:38 +0000
Subject: [PATCH] docs: replace ASCII architecture diagram with Mermaid
 flowchart

Convert the plain-text architecture diagram in the README to a Mermaid
flowchart that renders as an interactive diagram on GitHub. The diagram
accurately reflects the actual code flow: the Evidence Engine merges
findings back into the RuntimeContract, which then feeds into the Goss
Generator.

https://claude.ai/code/session_01UDZyz5H4DwwJfx4riRNwFH
---
 README.md | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 2bc571a..de3365b 100644
--- a/README.md
+++ b/README.md
@@ -167,17 +167,16 @@ Checks for:
 
 ### Architecture
 
-```
-Dockerfile ──> [Parser] ──> AST
-                              │
-                              v
-                    [Contract Extractor] ──> Runtime Contract Model (RCM)
-                              │                        │
-                              v                        v
-                    [Evidence Engine]          [Goss Generator]
-                    (optional probe)                   │
-                              │                        v
-                              └──────────> goss.yml + goss_wait.yml
+```mermaid
+flowchart TD
+    A[Dockerfile] --> B[Parser]
+    B --> C[AST]
+    C --> D[Contract Extractor]
+    D --> E[Runtime Contract Model]
+    E --> F["Evidence Engine<br/>(optional probe)"]
+    F -- merges back --> E
+    E --> G[Goss Generator]
+    G --> H[goss.yml + goss_wait.yml]
 ```
 
 1. **Dockerfile Parser**: Parses the Dockerfile into an AST, handling multi-stage builds, continuation lines, variable substitution (`$VAR`, `${VAR:-default}`), and all instruction types.