HמiN(dZddlZddlZddlZddlmZddlmZmZm Z m Z m Z GddZ de de fd Zd ed ede fd Zd ede e fd Zy)ua scripts/knowledge/mermaid_generator.py — Living Mermaid diagram generator. Scans the Genesis codebase and produces self-contained Mermaid diagrams for: - System architecture (directory-level flowchart) - Python module import graph - Memory pipeline sequence diagram Usage: from scripts.knowledge.mermaid_generator import MermaidGenerator gen = MermaidGenerator() diagrams = gen.generate_all("/mnt/e/genesis-system/obsidian-vault/diagrams") # VERIFICATION_STAMP # Story: 12.03 — MermaidGenerator # Verified By: parallel-builder # Verified At: 2026-02-25 # Tests: 9/9 # Coverage: 100% N)Path)DictListOptionalSetTupleceZdZUdZgdZeeeefed<gdZ eeeeefed<ddeddfd Z dd e ede eeffd Z defd Zdefd ZdefdZy)MermaidGeneratorz Generates living Mermaid diagrams from the Genesis codebase structure. All diagrams are returned as raw Mermaid text blocks that render in GitHub, Obsidian, and any Mermaid-compatible renderer. ) )corezCore Execution Layer) mcp-serversz MCP Servers)KNOWLEDGE_GRAPHzKnowledge Graph)SunaivazSunaiva Products)RECEPTIONISTAIReceptionistAI)TRADIES TradiesVoice)scriptszScripts & Tools)databasezDatabase Layer)loopzRWL Loop)deployzDeploy / Static)AIVAz AIVA Queen)infraInfrastructure ARCH_NODES))r r z writes KG)r r z tool calls)r rzdispatches tasks)rr z feeds results)rr z ingests data)rr ztriggers execution)r rconnects)rr voice pipeline)rr r)rr z product APIs)rrz static assets)rr zpersistent state)rr zagent commands)rrhosts ARCH_EDGES repo_pathreturnNc$t||_yN)rr)selfrs |"z"| ```r0) setrrexistsadd _mermaid_idappendrjoin) r#presentnode_idr.lineslabelsafe_idsrcdstsds r$r3z&MermaidGenerator.generate_architecturehs E// %JGQ(002 G$ %).9#oo :NGU'!%g. tG9BugR89 :  R $ rFr0)rrHsortedrglob_py_to_module_name_extract_importsrG startswithlstripr9rIkeysvaluesupdaterJrKr7rL)r#core_dir imports_mappy_file module_namedeps internal_depsdepcleanrO all_nodesrepresentative_nodesnode_setnodesafe edge_countmodulerTrUs r$r4z$MermaidGenerator.generate_module_maps >>F*+- ?? !(.."89 =0(C '0*-% 5C~~g.#..2E # 3 7 7 D )--e4 5 !K/>C: Sends message / task C->>G: Dispatches RWL stories G-->>C: Returns results C->>D: aggregate_session(transcript) D->>D: Distil key entities & axioms D->>KG: Write entity JSONL record D->>KG: Write axiom JSONL record D->>Q: Embed & upsert vectors D->>PG: Persist structured state Note over KG,Q: Living Memory Updated U->>C: Follow-up query C->>Q: semantic_search(query) Q-->>C: Top-K relevant chunks C->>KG: Load linked entities KG-->>C: Entity context C-->>U: Grounded response ```)r#diagrams r$r5z%MermaidGenerator.generate_memory_flows:r&)z/mnt/e/genesis-systemr")__name__ __module__ __qualname____doc__rrrstr__annotations__rr%rrr?r3r4r5rtr&r$r r s )JU38_%  .JU3S=)*")#)D)x}S#X6  s  D8 S8 t%c%r&r r=r cptjdd|}|r|djrd|z}|xsdS)zc Convert a string to a valid Mermaid node identifier (alphanumeric + underscore only). z [^A-Za-z0-9_]r.rnro)resubisdigit)r=rps r$rJrJs: 66"C .D Q!Tz >6r&rfbase_dirc |j|}t|j}|dj dr |ddd|d<|ddk(r|dd}|rdj |S|j S#t$r|}YmwxYw)u| Convert a Path like core/genesis_executor.py → "genesis_executor". Strips the base directory and .py suffix. z.pyNr%rW) relative_to ValueErrorlistpartsendswithrLstem)rfrrelrs r$r]r]s !!(+ OE Ry% "IcrNb  RyJcr #388E?55 sA33 BBct} |jdd} tj|t |}tj |D]}t|tjr-|jD]}|j|jJt|tjse|jsrd|jxsdz}|j||jz|S#t$r|cYSwxYw#t$rYnwxYwt!j"d|t j$D]"}|j|j'd$|S) z Parse a Python file with ast and return a set of imported module names. Falls back to regex parsing if ast fails (e.g. syntax errors). r1r9)r2errors)filenamerWrz^\s*(?:from|import)\s+([\w.]+)rZ)rG read_textOSErrorastparserzwalk isinstanceImportnamesrIr= ImportFromrrlevel SyntaxErrorr~finditer MULTILINEgroup)rfimportssourcetreeroaliasprefixmatchs r$r^r^ s4 G""GI"F  yy#g,7HHTN 6D$ +!ZZ,EKK +,D#..1;; DJJO!4FKK 45 6     )62<<$  EKKN#$ Ns/C<BD : D 4D < D  D  DD)ryrosr~pathlibrtypingrrrrrr rzrJr]r^rtr&r$rso* 33LLf c c 6666"ds3xr&