# odettespessiva/cpgen-studio architecture

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

- Interactive diagram: https://gitdiagram.com/odettespessiva/cpgen-studio
- Repository: https://github.com/odettespessiva/cpgen-studio

## Overview

CPGen Studio is a desktop tool for problem setters to create test-generation schemas visually or use generator files, then run them against a solution and save generated tests. The workspace/editor, visual schema builder, pipeline runner, and AI chat are distinct product stages; settings, logs, and language tooling support them. The backend also includes schema validation and expression/generation modules. Edges reflect README statements or shown calls; several backend internals and UI components were not sampled, so their interactions are omitted rather than inferred.

Main entry points: [`src/App.tsx`](https://github.com/odettespessiva/cpgen-studio/blob/main/src/App.tsx) (Desktop app), [`src/context/PipelineContext.tsx`](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/PipelineContext.tsx) (Pipeline configuration), [`src/hooks/useAI.ts`](https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useAI.ts) (AI workflows), [`src/context/WorkspaceContext.tsx`](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/WorkspaceContext.tsx) (Workspace state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and editor"]
  node_workspace_state["Workspace state"]
  node_workspace_files["Workspace files<br/>[useWorkspace.ts]"]
  node_editor["Code editor<br/>[EditorPanel.tsx]"]
  node_monaco["Monaco editor<br/>[useMonacoEditor.ts]"]
  node_lsp["Language services"]
end

subgraph group_schema["Schema authoring"]
  node_schema_builder["Visual schema builder"]
  node_schema_tree["Schema tree utilities<br/>[schemaTree.ts]"]
  node_schema_preview["Schema preview UI"]
end

subgraph group_generation["Generation runtime"]
  node_pipeline_state["Pipeline configuration"]
  node_pipeline_runner["Pipeline runner"]
  node_generation_backend["Test generation<br/>[generation.rs]"]
  node_schema_backend["Schema model<br/>[schema.rs]"]
  node_validation["Schema validation<br/>[validate.rs]"]
  node_expression["Expression evaluation<br/>[expr.rs]"]
  node_comparison["Expression comparison<br/>[cmp_expr.rs]"]
  node_generator_runner["Generator execution<br/>[runner.rs]"]
end

subgraph group_assistant["AI assistance"]
  node_chat_ui["AI chat<br/>[Chat.tsx]"]
  node_ai_state["AI state<br/>[AIContext.tsx]"]
  node_ai_service["AI workflows<br/>[useAI.ts]"]
  node_ai_backend["AI provider access<br/>[ai.rs]"]
  node_chat_backend["Chat backend<br/>[chat.rs]"]
end

subgraph group_support["App support"]
  node_app["Desktop app<br/>[App.tsx]"]
  node_studio["Studio interface<br/>[CPGenStudio.tsx]"]
  node_settings["Settings"]
  node_logs["Console logs"]
end

node_problem_setter(("Problem setter"))
node_user(("AI provider"))

node_problem_setter -->|"uses"| node_app
node_app -->|"renders"| node_studio
node_app -->|"provides"| node_workspace_state
node_app -->|"provides"| node_pipeline_state
node_app -->|"provides"| node_ai_state
node_app -->|"provides"| node_settings
node_studio -.->|"uses"| node_workspace_state
node_workspace_state -->|"delegates to"| node_workspace_files
node_workspace_files -->|"appends"| node_logs
node_editor -.->|"edits files"| node_workspace_state
node_editor -.->|"uses"| node_monaco
node_monaco -->|"integrates"| node_lsp
node_studio -.->|"offers"| node_schema_builder
node_schema_builder -.->|"uses"| node_schema_tree
node_schema_preview -->|"previews through"| node_pipeline_state
node_pipeline_state -->|"configures"| node_pipeline_runner
node_pipeline_state -->|"reads workspace"| node_workspace_state
node_pipeline_state -->|"sends logs"| node_logs
node_pipeline_runner -->|"invokes generation"| node_generation_backend
node_generation_backend -->|"uses schema"| node_schema_backend
node_generation_backend -->|"validates"| node_validation
node_generation_backend -->|"runs generator"| node_generator_runner
node_comparison -->|"uses"| node_expression
node_studio -.->|"offers chat"| node_chat_ui
node_chat_ui -->|"uses"| node_ai_state
node_ai_state -->|"delegates to"| node_ai_service
node_ai_service -->|"manages keys"| node_ai_backend
node_ai_service -.->|"sends chat"| node_chat_backend
node_ai_service -->|"reads configuration"| node_pipeline_state
node_ai_service -->|"reads settings"| node_settings
node_user -.->|"supplies credentials"| node_ai_backend

click node_app "https://github.com/odettespessiva/cpgen-studio/blob/main/src/App.tsx"
click node_studio "https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/CPGenStudio.tsx"
click node_workspace_state "https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/WorkspaceContext.tsx"
click node_workspace_files "https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useWorkspace.ts"
click node_editor "https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/EditorPanel.tsx"
click node_monaco "https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useMonacoEditor.ts"
click node_lsp "https://github.com/odettespessiva/cpgen-studio/blob/main/src/lsp/monacoIntegration.ts"
click node_schema_builder "https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/schema/VisualSchemaBuilder.tsx"
click node_schema_tree "https://github.com/odettespessiva/cpgen-studio/blob/main/src/utils/schemaTree.ts"
click node_schema_preview "https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/schema/SchemaPreviewPanel.tsx"
click node_pipeline_state "https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/PipelineContext.tsx"
click node_pipeline_runner "https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/usePipelineRunner.ts"
click node_generation_backend "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/generation.rs"
click node_schema_backend "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/schema.rs"
click node_validation "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/validate.rs"
click node_expression "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/expr.rs"
click node_comparison "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/cmp_expr.rs"
click node_generator_runner "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/runner.rs"
click node_chat_ui "https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/Chat.tsx"
click node_ai_state "https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/AIContext.tsx"
click node_ai_service "https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useAI.ts"
click node_ai_backend "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/ai.rs"
click node_chat_backend "https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/chat.rs"
click node_settings "https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/SettingsContext.tsx"
click node_logs "https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/ConsoleLogsContext.tsx"

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_workspace_state,node_workspace_files,node_editor,node_monaco,node_lsp toneBlue
class node_schema_builder,node_schema_tree,node_schema_preview toneAmber
class node_pipeline_state,node_pipeline_runner,node_generation_backend,node_schema_backend,node_validation,node_expression,node_comparison,node_generator_runner toneMint
class node_chat_ui,node_ai_state,node_ai_service,node_ai_backend,node_chat_backend toneRose
class node_app,node_studio,node_settings,node_logs,node_problem_setter,node_user toneIndigo
```

## Components

### Workspace and editor

- [Workspace state](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/WorkspaceContext.tsx): `src/context/WorkspaceContext.tsx`
- [Workspace files](https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useWorkspace.ts): `src/hooks/useWorkspace.ts`
- [Code editor](https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/EditorPanel.tsx): `src/components/EditorPanel.tsx`
- [Monaco editor](https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useMonacoEditor.ts): `src/hooks/useMonacoEditor.ts`
- [Language services](https://github.com/odettespessiva/cpgen-studio/blob/main/src/lsp/monacoIntegration.ts): `src/lsp/monacoIntegration.ts`

### Schema authoring

- [Visual schema builder](https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/schema/VisualSchemaBuilder.tsx): `src/components/schema/VisualSchemaBuilder.tsx`
- [Schema tree utilities](https://github.com/odettespessiva/cpgen-studio/blob/main/src/utils/schemaTree.ts): `src/utils/schemaTree.ts`
- [Schema preview UI](https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/schema/SchemaPreviewPanel.tsx): `src/components/schema/SchemaPreviewPanel.tsx`

### Generation runtime

- [Pipeline configuration](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/PipelineContext.tsx): `src/context/PipelineContext.tsx`
- [Pipeline runner](https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/usePipelineRunner.ts): `src/hooks/usePipelineRunner.ts`
- [Test generation](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/generation.rs): `src-tauri/src/generation.rs`
- [Schema model](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/schema.rs): `src-tauri/src/schema.rs`
- [Schema validation](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/validate.rs): `src-tauri/src/validate.rs`
- [Expression evaluation](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/expr.rs): `src-tauri/src/expr.rs`
- [Expression comparison](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/cmp_expr.rs): `src-tauri/src/cmp_expr.rs`
- [Generator execution](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/runner.rs): `src-tauri/src/runner.rs`

### AI assistance

- [AI chat](https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/Chat.tsx): `src/components/Chat.tsx`
- [AI state](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/AIContext.tsx): `src/context/AIContext.tsx`
- [AI workflows](https://github.com/odettespessiva/cpgen-studio/blob/main/src/hooks/useAI.ts): `src/hooks/useAI.ts`
- [AI provider access](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/ai.rs): `src-tauri/src/ai.rs`
- [Chat backend](https://github.com/odettespessiva/cpgen-studio/blob/main/src-tauri/src/chat.rs): `src-tauri/src/chat.rs`

### App support

- [Desktop app](https://github.com/odettespessiva/cpgen-studio/blob/main/src/App.tsx): `src/App.tsx`
- [Studio interface](https://github.com/odettespessiva/cpgen-studio/blob/main/src/components/CPGenStudio.tsx): `src/components/CPGenStudio.tsx`
- [Settings](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/SettingsContext.tsx): `src/context/SettingsContext.tsx`
- [Console logs](https://github.com/odettespessiva/cpgen-studio/blob/main/src/context/ConsoleLogsContext.tsx): `src/context/ConsoleLogsContext.tsx`

### Other components

- **Problem setter**
- **AI provider**

## Connections

- Problem setter → Desktop app: uses (evidence: `README.md`)
- Desktop app → Studio interface: renders (evidence: `src/App.tsx`)
- Desktop app → Workspace state: provides (evidence: `src/App.tsx`)
- Desktop app → Pipeline configuration: provides (evidence: `src/App.tsx`)
- Desktop app → AI state: provides (evidence: `src/App.tsx`)
- Desktop app → Settings: provides (evidence: `src/App.tsx`)
- Studio interface → Workspace state: uses
- Workspace state → Workspace files: delegates to (evidence: `src/context/WorkspaceContext.tsx`)
- Workspace files → Console logs: appends (evidence: `src/context/WorkspaceContext.tsx`)
- Code editor → Workspace state: edits files
- Code editor → Monaco editor: uses
- Monaco editor → Language services: integrates (evidence: `src/hooks/useMonacoEditor.ts`)
- Studio interface → Visual schema builder: offers
- Visual schema builder → Schema tree utilities: uses
- Schema preview UI → Pipeline configuration: previews through (evidence: `src/components/schema/SchemaPreviewPanel.tsx`)
- Pipeline configuration → Pipeline runner: configures (evidence: `src/context/PipelineContext.tsx`)
- Pipeline configuration → Workspace state: reads workspace (evidence: `src/context/PipelineContext.tsx`)
- Pipeline configuration → Console logs: sends logs (evidence: `src/context/PipelineContext.tsx`)
- Pipeline runner → Test generation: invokes generation (evidence: `src/hooks/usePipelineRunner.ts`)
- Test generation → Schema model: uses schema (evidence: `src-tauri/src/generation.rs`)
- Test generation → Schema validation: validates (evidence: `src-tauri/src/generation.rs`)
- Test generation → Generator execution: runs generator (evidence: `src-tauri/src/generation.rs`)
- Expression comparison → Expression evaluation: uses (evidence: `src-tauri/src/cmp_expr.rs`)
- Studio interface → AI chat: offers chat
- AI chat → AI state: uses (evidence: `src/components/Chat.tsx`)
- AI state → AI workflows: delegates to (evidence: `src/context/AIContext.tsx`)
- AI workflows → AI provider access: manages keys (evidence: `src/hooks/useAI.ts`)
- AI workflows → Chat backend: sends chat
- AI workflows → Pipeline configuration: reads configuration (evidence: `src/hooks/useAI.ts`)
- AI workflows → Settings: reads settings (evidence: `src/hooks/useAI.ts`)
- AI provider → AI provider access: supplies credentials
