# ishuamouren/jscription architecture

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

- Interactive diagram: https://gitdiagram.com/ishuamouren/jscription
- Repository: https://github.com/ishuamouren/jscription

## Overview

Jscription is a JSON-driven scripting engine with a command-line runner. Its principal workflow is to select `run`, read a JSON script, parse and prepare its commands, then execute them against shared variable context. The command registry exposes console, control-flow, dialog, filesystem, environment, network, path, process, math, string, and variable operations. The tree also contains compiler and CLI compile components; their runtime connection is not established by the excerpts, so they are shown separately. Edges reflect excerpted calls or SOURCE INDEX references.

Main entry points: [`Jscription.Core/Commands/CommandRegistry.cs`](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CommandRegistry.cs) (Command registry), [`Jscription.Core/Utils/JscriptionReader.cs`](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Utils/JscriptionReader.cs) (JSON reader), [`Jscription.Core/Commands/CmdRoot.cs`](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdRoot.cs) (Command execution), [`Jscription.Runner/Program.cs`](https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Program.cs) (CLI dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runner["CLI runner"]
  node_cli["CLI dispatch<br/>[Program.cs]"]
  node_run["Run command<br/>[CommandRun.cs]"]
  node_compile_cli["Compile command<br/>[CommandCompile.cs]"]
  node_version["Version info<br/>[Global.cs]"]
end

subgraph group_language["Script runtime"]
  node_reader["JSON reader"]
  node_document["Script document<br/>[JscriptionDoc.cs]"]
  node_registry["Command registry<br/>[CommandRegistry.cs]"]
  node_context["Execution context"]
  node_base_command["Command execution<br/>[CmdRoot.cs]"]
  node_executor["Script executor"]
  node_errors["Script errors<br/>[Exceptions.cs]"]
end

subgraph group_commands["Script commands"]
  node_console["Console commands<br/>[CmdConsole.cs]"]
  node_control["Control commands<br/>[CmdControl.cs]"]
  node_dialog["Dialog commands<br/>[CmdDialog.cs]"]
  node_filesystem["File and directory<br/>[CmdFile.cs]"]
  node_environment["Environment commands<br/>[CmdEnv.cs]"]
  node_network["Network commands<br/>[CmdNet.cs]"]
  node_path["Path commands<br/>[CmdPath.cs]"]
  node_process["Process commands<br/>[CmdProcess.cs]"]
  node_math["Math commands<br/>[CmdMath.cs]"]
  node_strings["String commands<br/>[CmdString.cs]"]
  node_variables["Variable commands<br/>[CmdVar.cs]"]
end

subgraph group_compiler["Compilation"]
  node_compiler["Script compiler"]
  node_binary_compiler["Binary compiler"]
end

node_user(("Script author"))

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_run
node_cli -->|"displays version"| node_version
node_run -->|"parses script"| node_reader
node_run -->|"starts execution"| node_executor
node_reader -->|"builds document"| node_document
node_reader -->|"creates commands"| node_registry
node_reader -->|"initializes context"| node_context
node_reader -->|"initializes commands"| node_base_command
node_reader -->|"raises parse errors"| node_errors
node_executor -->|"executes commands"| node_base_command
node_base_command -->|"creates nested commands"| node_registry
node_base_command -->|"uses variables"| node_context
node_base_command -->|"wraps failures"| node_errors
node_registry -->|"registers"| node_console
node_registry -->|"registers"| node_control
node_registry -->|"registers"| node_dialog
node_registry -->|"registers"| node_filesystem
node_registry -->|"registers"| node_environment
node_registry -->|"registers"| node_network
node_registry -->|"registers"| node_path
node_registry -->|"registers"| node_process
node_registry -->|"registers"| node_math
node_registry -->|"registers"| node_strings
node_registry -->|"registers"| node_variables

click node_cli "https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Program.cs"
click node_run "https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Commands/CommandRun.cs"
click node_compile_cli "https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Commands/CommandCompile.cs"
click node_version "https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Classes/Global.cs"
click node_reader "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Utils/JscriptionReader.cs"
click node_document "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Classes/JscriptionDoc.cs"
click node_registry "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CommandRegistry.cs"
click node_context "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/ExecutionContext.cs"
click node_base_command "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdRoot.cs"
click node_executor "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Utils/JscriptionExecuter.cs"
click node_errors "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Exceptions/Exceptions.cs"
click node_console "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdConsole.cs"
click node_control "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdControl.cs"
click node_dialog "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdDialog.cs"
click node_filesystem "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdFile.cs"
click node_environment "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdEnv.cs"
click node_network "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdNet.cs"
click node_path "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdPath.cs"
click node_process "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdProcess.cs"
click node_math "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdMath.cs"
click node_strings "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdString.cs"
click node_variables "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdVar.cs"
click node_compiler "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Compiler/JscriptionCompiler.cs"
click node_binary_compiler "https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Compiler/JscriptionBinraryCompiler.cs"

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_cli,node_run,node_compile_cli,node_version toneBlue
class node_reader,node_document,node_registry,node_context,node_base_command,node_executor,node_errors toneAmber
class node_console,node_control,node_dialog,node_filesystem,node_environment,node_network,node_path,node_process,node_math,node_strings,node_variables toneMint
class node_compiler,node_binary_compiler toneRose
class node_user toneIndigo
```

## Components

### CLI runner

- [CLI dispatch](https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Program.cs): `Jscription.Runner/Program.cs`
- [Run command](https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Commands/CommandRun.cs): `Jscription.Runner/Commands/CommandRun.cs`
- [Compile command](https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Commands/CommandCompile.cs): `Jscription.Runner/Commands/CommandCompile.cs`
- [Version info](https://github.com/ishuamouren/jscription/blob/main/Jscription.Runner/Classes/Global.cs): `Jscription.Runner/Classes/Global.cs`

### Script runtime

- [JSON reader](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Utils/JscriptionReader.cs): `Jscription.Core/Utils/JscriptionReader.cs`
- [Script document](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Classes/JscriptionDoc.cs): `Jscription.Core/Classes/JscriptionDoc.cs`
- [Command registry](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CommandRegistry.cs): `Jscription.Core/Commands/CommandRegistry.cs`
- [Execution context](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/ExecutionContext.cs): `Jscription.Core/Commands/ExecutionContext.cs`
- [Command execution](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdRoot.cs): `Jscription.Core/Commands/CmdRoot.cs`
- [Script executor](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Utils/JscriptionExecuter.cs): `Jscription.Core/Utils/JscriptionExecuter.cs`
- [Script errors](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Exceptions/Exceptions.cs): `Jscription.Core/Exceptions/Exceptions.cs`

### Script commands

- [Console commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdConsole.cs): `Jscription.Core/Commands/CmdConsole.cs`
- [Control commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdControl.cs): `Jscription.Core/Commands/CmdControl.cs`
- [Dialog commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdDialog.cs): `Jscription.Core/Commands/CmdDialog.cs`
- [File and directory](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdFile.cs): `Jscription.Core/Commands/CmdFile.cs`
- [Environment commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdEnv.cs): `Jscription.Core/Commands/CmdEnv.cs`
- [Network commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdNet.cs): `Jscription.Core/Commands/CmdNet.cs`
- [Path commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdPath.cs): `Jscription.Core/Commands/CmdPath.cs`
- [Process commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdProcess.cs): `Jscription.Core/Commands/CmdProcess.cs`
- [Math commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdMath.cs): `Jscription.Core/Commands/CmdMath.cs`
- [String commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdString.cs): `Jscription.Core/Commands/CmdString.cs`
- [Variable commands](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Commands/CmdVar.cs): `Jscription.Core/Commands/CmdVar.cs`

### Compilation

- [Script compiler](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Compiler/JscriptionCompiler.cs): `Jscription.Core/Compiler/JscriptionCompiler.cs`
- [Binary compiler](https://github.com/ishuamouren/jscription/blob/main/Jscription.Core/Compiler/JscriptionBinraryCompiler.cs): `Jscription.Core/Compiler/JscriptionBinraryCompiler.cs`

### Other components

- **Script author**

## Connections

- Script author → CLI dispatch: invokes (evidence: `README.md`)
- CLI dispatch → Run command: dispatches (evidence: `Jscription.Runner/Program.cs`)
- CLI dispatch → Version info: displays version (evidence: `Jscription.Runner/Program.cs`)
- Run command → JSON reader: parses script (evidence: `Jscription.Runner/Commands/CommandRun.cs`)
- Run command → Script executor: starts execution (evidence: `Jscription.Runner/Commands/CommandRun.cs`)
- JSON reader → Script document: builds document (evidence: `Jscription.Core/Utils/JscriptionReader.cs`)
- JSON reader → Command registry: creates commands (evidence: `Jscription.Core/Utils/JscriptionReader.cs`)
- JSON reader → Execution context: initializes context (evidence: `Jscription.Core/Utils/JscriptionReader.cs`)
- JSON reader → Command execution: initializes commands (evidence: `Jscription.Core/Utils/JscriptionReader.cs`)
- JSON reader → Script errors: raises parse errors (evidence: `Jscription.Core/Utils/JscriptionReader.cs`)
- Script executor → Command execution: executes commands (evidence: `Jscription.Core/Utils/JscriptionExecuter.cs`)
- Command execution → Command registry: creates nested commands (evidence: `Jscription.Core/Commands/CmdRoot.cs`)
- Command execution → Execution context: uses variables (evidence: `Jscription.Core/Commands/CmdRoot.cs`)
- Command execution → Script errors: wraps failures (evidence: `Jscription.Core/Commands/CmdRoot.cs`)
- Command registry → Console commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Control commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Dialog commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → File and directory: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Environment commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Network commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Path commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Process commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Math commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → String commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
- Command registry → Variable commands: registers (evidence: `Jscription.Core/Commands/CommandRegistry.cs`)
