# ender-ing/juggernyaut architecture

> Architecture diagram of the GitHub repository ender-ing/juggernyaut, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ender-ing/juggernyaut
- Repository: https://github.com/ender-ing/juggernyaut

## Overview

Juggernyaut is an experimental programming language whose implemented workflow centers on configuring a front-end session, loading source files, and parsing them to produce AST data and diagnostics. The CLI and LSP server are separate callers of that shared session; the server exposes IDE capabilities, while a VS Code extension and Prism grammar provide editor integration. The README describes later semantic-analysis and binary-generation stages as plans, not current capabilities. Some subsystem links are documented rather than verified in sampled implementation, and are marked accordingly.

Main entry points: [`core/parser/parser.cpp`](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/parser.cpp) (Parser Workflow), [`compiler/main.cpp`](https://github.com/ender-ing/juggernyaut/blob/main/compiler/main.cpp) (Compiler CLI), [`server/main.cpp`](https://github.com/ender-ing/juggernyaut/blob/main/server/main.cpp) (Language Server), [`core/session/session.cpp`](https://github.com/ender-ing/juggernyaut/blob/main/core/session/session.cpp) (Front-End Session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["Language Front End"]
  node_configs["Project Configs<br/>[configs.hpp]"]
  node_session["Front-End Session<br/>[session.cpp]"]
  node_parser["Parser Workflow<br/>[parser.cpp]"]
  node_lexer["Lexer<br/>[JugLexer.hpp]"]
  node_grammar_parser["Grammar Parser<br/>[JugParser.hpp]"]
  node_ast_generation["AST Generation<br/>[ASTGenVisitor.cpp]"]
  node_workflow_diagnostics["Workflow Diagnostics"]
  node_source_store[("Source Store<br/>[SourceStore.cpp]")]
  node_source["Source Data<br/>[Source.cpp]"]
end

subgraph group_callers["User Entry Points"]
  node_compiler["Compiler CLI<br/>[main.cpp]"]
  node_cli_config["CLI Options<br/>[actions.cpp]"]
  node_file_store["CLI File Store<br/>[files.cpp]"]
end

subgraph group_ide["IDE Services"]
  node_lsp_server["Language Server<br/>[main.cpp]"]
  node_lsp_capabilities["LSP Capabilities<br/>[basic.cpp]"]
  node_document_store[("Document Store<br/>[DocumentStore.cpp]")]
  node_debouncer["Session Debouncer"]
  node_lsp_diagnostics["LSP Diagnostics<br/>[diagnostics.cpp]"]
  node_workspace_docs["Workspace Documents<br/>[docs.cpp]"]
  node_vscode["VS Code Extension<br/>[extension.ts]"]
  node_prism["Prism Grammar"]
end

subgraph group_shared["Shared Utilities"]
  node_console["Console Reporting<br/>[report.cpp]"]
  node_common["Common Utilities<br/>[utility.hpp]"]
end

node_user(("Developer"))

node_user -->|"invokes"| node_compiler
node_user -->|"uses"| node_lsp_server
node_compiler -->|"parses options"| node_cli_config
node_compiler -->|"loads sources"| node_file_store
node_compiler -->|"applies config"| node_configs
node_compiler -->|"starts session"| node_session
node_compiler -->|"reports results"| node_console
node_configs -->|"modifies"| node_session
node_session -->|"uses store"| node_source_store
node_session -->|"starts workflow"| node_parser
node_parser -->|"visits sources"| node_source_store
node_parser -->|"tokenizes"| node_lexer
node_parser -->|"parses tokens"| node_grammar_parser
node_parser -->|"generates AST"| node_ast_generation
node_parser -->|"collects diagnostics"| node_workflow_diagnostics
node_source_store -->|"stores sources"| node_source
node_lsp_server -->|"configures protocol"| node_lsp_capabilities
node_lsp_server -->|"sets diagnostics"| node_lsp_diagnostics
node_lsp_server -->|"uses store"| node_document_store
node_lsp_server -->|"creates session"| node_session
node_lsp_capabilities -->|"uses"| node_debouncer
node_lsp_capabilities -->|"uses"| node_document_store
node_lsp_capabilities -->|"loads config"| node_configs
node_lsp_diagnostics -->|"uses parser"| node_parser
node_lsp_diagnostics -->|"uses session"| node_session
node_document_store -->|"dispatches to"| node_lsp_capabilities
node_document_store -->|"dispatches to"| node_lsp_diagnostics
node_document_store -->|"uses source store"| node_source_store
node_vscode -.->|"connects to"| node_lsp_server
node_vscode -.->|"integrates with"| node_compiler
node_vscode -.->|"provides grammar"| node_prism
node_source_store -->|"uses utilities"| node_common
node_console -->|"uses headers"| node_common

click node_compiler "https://github.com/ender-ing/juggernyaut/blob/main/compiler/main.cpp"
click node_cli_config "https://github.com/ender-ing/juggernyaut/blob/main/compiler/base/actions.cpp"
click node_file_store "https://github.com/ender-ing/juggernyaut/blob/main/compiler/store/files.cpp"
click node_configs "https://github.com/ender-ing/juggernyaut/blob/main/configs/configs.hpp"
click node_session "https://github.com/ender-ing/juggernyaut/blob/main/core/session/session.cpp"
click node_parser "https://github.com/ender-ing/juggernyaut/blob/main/core/parser/parser.cpp"
click node_lexer "https://github.com/ender-ing/juggernyaut/blob/main/core/parser/internal/JugLexer.hpp"
click node_grammar_parser "https://github.com/ender-ing/juggernyaut/blob/main/core/parser/internal/JugParser.hpp"
click node_ast_generation "https://github.com/ender-ing/juggernyaut/blob/main/core/parser/visitors/ASTGenVisitor.cpp"
click node_workflow_diagnostics "https://github.com/ender-ing/juggernyaut/blob/main/core/parser/listeners/WorkflowDiagListener.cpp"
click node_source_store "https://github.com/ender-ing/juggernyaut/blob/main/core/data/store/SourceStore.cpp"
click node_source "https://github.com/ender-ing/juggernyaut/blob/main/core/data/store/Source.cpp"
click node_lsp_server "https://github.com/ender-ing/juggernyaut/blob/main/server/main.cpp"
click node_lsp_capabilities "https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/basic.cpp"
click node_document_store "https://github.com/ender-ing/juggernyaut/blob/main/server/store/DocumentStore.cpp"
click node_debouncer "https://github.com/ender-ing/juggernyaut/blob/main/server/session/SessionDebouncer.cpp"
click node_lsp_diagnostics "https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/semantics/diagnostics.cpp"
click node_workspace_docs "https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/workspace/docs.cpp"
click node_vscode "https://github.com/ender-ing/juggernyaut/blob/main/extensions/VSCode/scripts/extension.ts"
click node_prism "https://github.com/ender-ing/juggernyaut/blob/main/extensions/prism.juggernyaut.js"
click node_console "https://github.com/ender-ing/juggernyaut/blob/main/utility/libraries/cat-console/report.cpp"
click node_common "https://github.com/ender-ing/juggernyaut/blob/main/utility/libraries/common/include/common/utility.hpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_configs,node_session,node_parser,node_lexer,node_grammar_parser,node_ast_generation,node_workflow_diagnostics,node_source_store,node_source toneBlue
class node_compiler,node_cli_config,node_file_store toneAmber
class node_lsp_server,node_lsp_capabilities,node_document_store,node_debouncer,node_lsp_diagnostics,node_workspace_docs,node_vscode,node_prism toneMint
class node_console,node_common toneRose
class node_user toneIndigo
```

## Components

### Language Front End

- [Project Configs](https://github.com/ender-ing/juggernyaut/blob/main/configs/configs.hpp): `configs/configs.hpp`
- [Front-End Session](https://github.com/ender-ing/juggernyaut/blob/main/core/session/session.cpp): `core/session/session.cpp`
- [Parser Workflow](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/parser.cpp): `core/parser/parser.cpp`
- [Lexer](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/internal/JugLexer.hpp): `core/parser/internal/JugLexer.hpp`
- [Grammar Parser](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/internal/JugParser.hpp): `core/parser/internal/JugParser.hpp`
- [AST Generation](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/visitors/ASTGenVisitor.cpp): `core/parser/visitors/ASTGenVisitor.cpp`
- [Workflow Diagnostics](https://github.com/ender-ing/juggernyaut/blob/main/core/parser/listeners/WorkflowDiagListener.cpp): `core/parser/listeners/WorkflowDiagListener.cpp`
- [Source Store](https://github.com/ender-ing/juggernyaut/blob/main/core/data/store/SourceStore.cpp): `core/data/store/SourceStore.cpp`
- [Source Data](https://github.com/ender-ing/juggernyaut/blob/main/core/data/store/Source.cpp): `core/data/store/Source.cpp`

### User Entry Points

- [Compiler CLI](https://github.com/ender-ing/juggernyaut/blob/main/compiler/main.cpp): `compiler/main.cpp`
- [CLI Options](https://github.com/ender-ing/juggernyaut/blob/main/compiler/base/actions.cpp): `compiler/base/actions.cpp`
- [CLI File Store](https://github.com/ender-ing/juggernyaut/blob/main/compiler/store/files.cpp): `compiler/store/files.cpp`

### IDE Services

- [Language Server](https://github.com/ender-ing/juggernyaut/blob/main/server/main.cpp): `server/main.cpp`
- [LSP Capabilities](https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/basic.cpp): `server/capabilities/basic.cpp`
- [Document Store](https://github.com/ender-ing/juggernyaut/blob/main/server/store/DocumentStore.cpp): `server/store/DocumentStore.cpp`
- [Session Debouncer](https://github.com/ender-ing/juggernyaut/blob/main/server/session/SessionDebouncer.cpp): `server/session/SessionDebouncer.cpp`
- [LSP Diagnostics](https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/semantics/diagnostics.cpp): `server/capabilities/semantics/diagnostics.cpp`
- [Workspace Documents](https://github.com/ender-ing/juggernyaut/blob/main/server/capabilities/workspace/docs.cpp): `server/capabilities/workspace/docs.cpp`
- [VS Code Extension](https://github.com/ender-ing/juggernyaut/blob/main/extensions/VSCode/scripts/extension.ts): `extensions/VSCode/scripts/extension.ts`
- [Prism Grammar](https://github.com/ender-ing/juggernyaut/blob/main/extensions/prism.juggernyaut.js): `extensions/prism.juggernyaut.js`

### Shared Utilities

- [Console Reporting](https://github.com/ender-ing/juggernyaut/blob/main/utility/libraries/cat-console/report.cpp): `utility/libraries/cat-console/report.cpp`
- [Common Utilities](https://github.com/ender-ing/juggernyaut/blob/main/utility/libraries/common/include/common/utility.hpp): `utility/libraries/common/include/common/utility.hpp`

### Other components

- **Developer**

## Connections

- Developer → Compiler CLI: invokes (evidence: `README.md`)
- Developer → Language Server: uses (evidence: `README.md`)
- Compiler CLI → CLI Options: parses options (evidence: `compiler/main.cpp`)
- Compiler CLI → CLI File Store: loads sources (evidence: `compiler/main.cpp`)
- Compiler CLI → Project Configs: applies config (evidence: `compiler/main.cpp`)
- Compiler CLI → Front-End Session: starts session (evidence: `compiler/main.cpp`)
- Compiler CLI → Console Reporting: reports results (evidence: `compiler/main.cpp`)
- Project Configs → Front-End Session: modifies (evidence: `configs/configs.hpp`)
- Front-End Session → Source Store: uses store (evidence: `core/session/session.cpp`)
- Front-End Session → Parser Workflow: starts workflow
- Parser Workflow → Source Store: visits sources (evidence: `core/parser/parser.cpp`)
- Parser Workflow → Lexer: tokenizes (evidence: `core/parser/parser.cpp`)
- Parser Workflow → Grammar Parser: parses tokens (evidence: `core/parser/parser.cpp`)
- Parser Workflow → AST Generation: generates AST (evidence: `core/parser/parser.cpp`)
- Parser Workflow → Workflow Diagnostics: collects diagnostics (evidence: `core/parser/parser.cpp`)
- Source Store → Source Data: stores sources
- Language Server → LSP Capabilities: configures protocol (evidence: `server/main.cpp`)
- Language Server → LSP Diagnostics: sets diagnostics (evidence: `server/main.cpp`)
- Language Server → Document Store: uses store (evidence: `server/main.cpp`)
- Language Server → Front-End Session: creates session (evidence: `server/main.cpp`)
- LSP Capabilities → Session Debouncer: uses (evidence: `server/capabilities/basic.cpp`)
- LSP Capabilities → Document Store: uses (evidence: `server/capabilities/basic.cpp`)
- LSP Capabilities → Project Configs: loads config (evidence: `server/capabilities/basic.cpp`)
- LSP Diagnostics → Parser Workflow: uses parser
- LSP Diagnostics → Front-End Session: uses session
- Document Store → LSP Capabilities: dispatches to (evidence: `server/store/DocumentStore.cpp`)
- Document Store → LSP Diagnostics: dispatches to (evidence: `server/store/DocumentStore.cpp`)
- Document Store → Source Store: uses source store
- VS Code Extension → Language Server: connects to (evidence: `README.md`)
- VS Code Extension → Compiler CLI: integrates with (evidence: `README.md`)
- VS Code Extension → Prism Grammar: provides grammar
- Source Store → Common Utilities: uses utilities (evidence: `core/data/store/SourceStore.cpp`)
- Console Reporting → Common Utilities: uses headers
