# sri200723/gridmind architecture

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

- Interactive diagram: https://gitdiagram.com/sri200723/gridmind
- Repository: https://github.com/sri200723/gridmind

## Overview

RL Grid World Studio is an interactive learning lab: users configure a grid and reward model, train or evaluate Q-Learning, SARSA, or a planning baseline, then inspect policies, compare runs, and analyze or save results. The app shell coordinates these workflows; the training engine owns episode execution and uses agent, environment, and seeded-randomness logic. Separate workspaces cover environment editing, learning guidance, analytics, comparisons, experiment export, and persistent agent memory. Edges reflect the README and shown imports/calls; unsampled implementation details are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/sri200723/gridmind/blob/main/src/App.tsx) (Studio shell), [`src/engine/training.ts`](https://github.com/sri200723/gridmind/blob/main/src/engine/training.ts) (Training and evaluation), [`src/components/EnvironmentStudioView.tsx`](https://github.com/sri200723/gridmind/blob/main/src/components/EnvironmentStudioView.tsx) (Environment studio), [`src/engine/agents.ts`](https://github.com/sri200723/gridmind/blob/main/src/engine/agents.ts) (Agents and planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Studio interface"]
  node_shell["Studio shell<br/>[App.tsx]"]
  node_grid["Grid canvas<br/>[GridCanvas.tsx]"]
  node_ui_states["UI states<br/>[UIStates.tsx]"]
end

subgraph group_engine["Learning engine"]
  node_types["RL data types<br/>[rl.ts]"]
  node_environment["Grid environment<br/>[environment.ts]"]
  node_agents["Agents and planner<br/>[agents.ts]"]
  node_training["Training and evaluation<br/>[training.ts]"]
  node_prng["Seeded randomness<br/>[prng.ts]"]
  node_analytics["Learning analytics<br/>[analytics.ts]"]
end

subgraph group_workspaces["Learning workspaces"]
  node_env_studio["Environment studio"]
  node_policy["Policy and Q-table"]
  node_comparison["Comparison lab"]
  node_analytics_view["Analytics view<br/>[AnalyticsView.tsx]"]
  node_guide["Learning guide"]
  node_experiments_view["Experiments and tests"]
  node_brain_view["Brain memory view"]
end

subgraph group_persistence["Results and memory"]
  node_experiments["Experiment utilities<br/>[experiments.ts]"]
  node_brain_store[("Brain persistence")]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_shell
node_shell -->|"opens"| node_env_studio
node_shell -->|"runs"| node_training
node_shell -->|"coordinates"| node_comparison
node_shell -->|"shows"| node_analytics_view
node_shell -->|"shows"| node_policy
node_shell -->|"shows"| node_experiments_view
node_shell -->|"shows"| node_guide
node_shell -->|"shows"| node_brain_view
node_env_studio -->|"validates"| node_environment
node_env_studio -->|"previews plan"| node_agents
node_env_studio -->|"edits via"| node_grid
node_training -->|"selects actions"| node_agents
node_training -->|"steps through"| node_environment
node_training -->|"seeds runs"| node_prng
node_agents -->|"simulates routes"| node_environment
node_agents -->|"breaks ties"| node_prng
node_analytics_view -->|"derives metrics"| node_analytics
node_comparison -->|"analyzes results"| node_analytics
node_comparison -->|"visualizes runs"| node_grid
node_policy -->|"renders policy"| node_grid
node_experiments_view -->|"exports results"| node_experiments
node_shell -->|"persists registry"| node_experiments
node_shell -->|"saves brains"| node_brain_store
node_brain_view -->|"manages memory"| node_brain_store
node_brain_store -->|"stores states"| node_types
node_environment -->|"uses definitions"| node_types
node_training -->|"produces records"| node_types
node_analytics -->|"reads episodes"| node_types

click node_shell "https://github.com/sri200723/gridmind/blob/main/src/App.tsx"
click node_grid "https://github.com/sri200723/gridmind/blob/main/src/components/GridCanvas.tsx"
click node_ui_states "https://github.com/sri200723/gridmind/blob/main/src/components/UIStates.tsx"
click node_types "https://github.com/sri200723/gridmind/blob/main/src/types/rl.ts"
click node_environment "https://github.com/sri200723/gridmind/blob/main/src/engine/environment.ts"
click node_agents "https://github.com/sri200723/gridmind/blob/main/src/engine/agents.ts"
click node_training "https://github.com/sri200723/gridmind/blob/main/src/engine/training.ts"
click node_prng "https://github.com/sri200723/gridmind/blob/main/src/engine/prng.ts"
click node_env_studio "https://github.com/sri200723/gridmind/blob/main/src/components/EnvironmentStudioView.tsx"
click node_policy "https://github.com/sri200723/gridmind/blob/main/src/components/PolicyQTableView.tsx"
click node_comparison "https://github.com/sri200723/gridmind/blob/main/src/components/ComparisonLabView.tsx"
click node_analytics_view "https://github.com/sri200723/gridmind/blob/main/src/components/AnalyticsView.tsx"
click node_analytics "https://github.com/sri200723/gridmind/blob/main/src/engine/analytics.ts"
click node_guide "https://github.com/sri200723/gridmind/blob/main/src/components/LearningGuideView.tsx"
click node_experiments_view "https://github.com/sri200723/gridmind/blob/main/src/components/ExperimentsAndTestsView.tsx"
click node_experiments "https://github.com/sri200723/gridmind/blob/main/src/engine/experiments.ts"
click node_brain_view "https://github.com/sri200723/gridmind/blob/main/src/components/BrainMemoryView.tsx"
click node_brain_store "https://github.com/sri200723/gridmind/blob/main/src/engine/brainPersistence.ts"

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_shell,node_grid,node_ui_states toneBlue
class node_types,node_environment,node_agents,node_training,node_prng,node_analytics toneAmber
class node_env_studio,node_policy,node_comparison,node_analytics_view,node_guide,node_experiments_view,node_brain_view toneMint
class node_experiments,node_brain_store toneRose
class node_learner toneIndigo
```

## Components

### Studio interface

- [Studio shell](https://github.com/sri200723/gridmind/blob/main/src/App.tsx): `src/App.tsx`
- [Grid canvas](https://github.com/sri200723/gridmind/blob/main/src/components/GridCanvas.tsx): `src/components/GridCanvas.tsx`
- [UI states](https://github.com/sri200723/gridmind/blob/main/src/components/UIStates.tsx): `src/components/UIStates.tsx`

### Learning engine

- [RL data types](https://github.com/sri200723/gridmind/blob/main/src/types/rl.ts): `src/types/rl.ts`
- [Grid environment](https://github.com/sri200723/gridmind/blob/main/src/engine/environment.ts): `src/engine/environment.ts`
- [Agents and planner](https://github.com/sri200723/gridmind/blob/main/src/engine/agents.ts): `src/engine/agents.ts`
- [Training and evaluation](https://github.com/sri200723/gridmind/blob/main/src/engine/training.ts): `src/engine/training.ts`
- [Seeded randomness](https://github.com/sri200723/gridmind/blob/main/src/engine/prng.ts): `src/engine/prng.ts`
- [Learning analytics](https://github.com/sri200723/gridmind/blob/main/src/engine/analytics.ts): `src/engine/analytics.ts`

### Learning workspaces

- [Environment studio](https://github.com/sri200723/gridmind/blob/main/src/components/EnvironmentStudioView.tsx): `src/components/EnvironmentStudioView.tsx`
- [Policy and Q-table](https://github.com/sri200723/gridmind/blob/main/src/components/PolicyQTableView.tsx): `src/components/PolicyQTableView.tsx`
- [Comparison lab](https://github.com/sri200723/gridmind/blob/main/src/components/ComparisonLabView.tsx): `src/components/ComparisonLabView.tsx`
- [Analytics view](https://github.com/sri200723/gridmind/blob/main/src/components/AnalyticsView.tsx): `src/components/AnalyticsView.tsx`
- [Learning guide](https://github.com/sri200723/gridmind/blob/main/src/components/LearningGuideView.tsx): `src/components/LearningGuideView.tsx`
- [Experiments and tests](https://github.com/sri200723/gridmind/blob/main/src/components/ExperimentsAndTestsView.tsx): `src/components/ExperimentsAndTestsView.tsx`
- [Brain memory view](https://github.com/sri200723/gridmind/blob/main/src/components/BrainMemoryView.tsx): `src/components/BrainMemoryView.tsx`

### Results and memory

- [Experiment utilities](https://github.com/sri200723/gridmind/blob/main/src/engine/experiments.ts): `src/engine/experiments.ts`
- [Brain persistence](https://github.com/sri200723/gridmind/blob/main/src/engine/brainPersistence.ts): `src/engine/brainPersistence.ts`

### Other components

- **Learner**

## Connections

- Learner → Studio shell: uses (evidence: `README.md`)
- Studio shell → Environment studio: opens (evidence: `README.md`)
- Studio shell → Training and evaluation: runs (evidence: `README.md`)
- Studio shell → Comparison lab: coordinates (evidence: `README.md`)
- Studio shell → Analytics view: shows (evidence: `README.md`)
- Studio shell → Policy and Q-table: shows (evidence: `README.md`)
- Studio shell → Experiments and tests: shows (evidence: `README.md`)
- Studio shell → Learning guide: shows (evidence: `README.md`)
- Studio shell → Brain memory view: shows (evidence: `src/App.tsx`)
- Environment studio → Grid environment: validates (evidence: `src/components/EnvironmentStudioView.tsx`)
- Environment studio → Agents and planner: previews plan (evidence: `src/components/EnvironmentStudioView.tsx`)
- Environment studio → Grid canvas: edits via (evidence: `README.md`)
- Training and evaluation → Agents and planner: selects actions (evidence: `src/engine/training.ts`)
- Training and evaluation → Grid environment: steps through (evidence: `src/engine/training.ts`)
- Training and evaluation → Seeded randomness: seeds runs (evidence: `src/engine/training.ts`)
- Agents and planner → Grid environment: simulates routes (evidence: `src/engine/agents.ts`)
- Agents and planner → Seeded randomness: breaks ties (evidence: `README.md`)
- Analytics view → Learning analytics: derives metrics (evidence: `src/components/AnalyticsView.tsx`)
- Comparison lab → Learning analytics: analyzes results (evidence: `src/components/ComparisonLabView.tsx`)
- Comparison lab → Grid canvas: visualizes runs (evidence: `src/components/ComparisonLabView.tsx`)
- Policy and Q-table → Grid canvas: renders policy (evidence: `src/components/PolicyQTableView.tsx`)
- Experiments and tests → Experiment utilities: exports results (evidence: `src/components/ExperimentsAndTestsView.tsx`)
- Studio shell → Experiment utilities: persists registry (evidence: `src/App.tsx`)
- Studio shell → Brain persistence: saves brains (evidence: `src/App.tsx`)
- Brain memory view → Brain persistence: manages memory (evidence: `README.md`)
- Brain persistence → RL data types: stores states (evidence: `src/engine/brainPersistence.ts`)
- Grid environment → RL data types: uses definitions (evidence: `src/engine/environment.ts`)
- Training and evaluation → RL data types: produces records (evidence: `src/engine/training.ts`)
- Learning analytics → RL data types: reads episodes (evidence: `src/engine/analytics.ts`)
