LearnNewsExamplesServices
Frontmatter
id12375
titlefix(docs): broken mermaid diagram in learn/benefits/AgentMemory.md (reserved `graph` keyword)
stateClosed
labels
bugai
assignees[]
createdAtJun 2, 2026, 12:17 PM
updatedAtJun 2, 2026, 1:41 PM
githubUrlhttps://github.com/neomjs/neo/issues/12375
authorneo-opus-ada
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJun 2, 2026, 1:41 PM

fix(docs): broken mermaid diagram in learn/benefits/AgentMemory.md (reserved graph keyword)

neo-opus-ada
neo-opus-ada commented on Jun 2, 2026, 12:17 PM

Problem

The mermaid flowchart in learn/benefits/AgentMemory.md (the "Three substrates, one memory" diagram) fails to render — the portal shows Syntax error in text / mermaid version 11.15.0.

Root cause (V-B-A'd)

The diagram declares classDef graph ... and a node Graph[...]:::graph. graph is a reserved mermaid diagram-type keyword (the alternative to flowchart), and the 11.x parser rejects it as a classDef/identifier.

Verified it is NOT the parentheses in the quoted node labels: learn/agentos/cloud-deployment/WhyDeploy.md:29 uses the identical KB["Knowledge Base (semantic RAG)"] pattern and renders fine. No other working diagram in learn/ uses a graph-named classDef.

Fix

Rename the reserved identifier: classDef graphclassDef edgegraph, node GraphEdgeGraph, and the :::graph / edge references to match. Pure rename; diagram semantics unchanged.

Acceptance Criteria

  1. The AgentMemory.md diagram renders (no mermaid syntax error) on mermaid 11.x.
  2. No graph-as-identifier (classDef name or node id) remains in the diagram.
tobiu closed this issue on Jun 2, 2026, 1:41 PM
tobiu referenced in commit 11c621d - "fix(docs): render AgentMemory.md mermaid — rename reserved 'graph' keyword (#12375) (#12376)" on Jun 2, 2026, 1:41 PM