# saketh070706/code_storm architecture

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

- Interactive diagram: https://gitdiagram.com/saketh070706/code_storm
- Repository: https://github.com/saketh070706/code_storm

## Overview

CODE_STORM is a full-stack GenAI platform whose primary documented workflow is a browser-based enterprise workspace: users manage policies, agents, and sources, then submit governed actions for authorization, review, execution, and audit. The frontend also retains a legacy copilot for chat, document retrieval, and structured extraction. Workspace and copilot persistence have distinct implementations; the README additionally documents vector search and multi-provider LLM resilience. Some subsystem links below rely on the README or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`backend/workspace/api.py`](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/api.py) (Workspace API), [`backend/workspace/runtime.py`](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/runtime.py) (Action runtime), [`backend/api/routes/chat.py`](https://github.com/saketh070706/code_storm/blob/main/backend/api/routes/chat.py) (Copilot routes), [`backend/core/rag.py`](https://github.com/saketh070706/code_storm/blob/main/backend/core/rag.py) (Knowledge retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser workspace"]
  node_workspace_ui["Workspace UI<br/>[App.jsx]"]
  node_workspace_views["Workspace views<br/>[Registry.jsx]"]
  node_workspace_state["Workspace state<br/>[useWorkspace.js]"]
  node_browser_transport["API transport<br/>[workspaceClient.js]"]
end

subgraph group_api["Backend APIs"]
  node_workspace_api["Workspace API<br/>[api.py]"]
  node_legacy_routes["Copilot routes<br/>[chat.py]"]
  node_extraction_route["Extraction API<br/>[extraction.py]"]
end

subgraph group_governance["Governance runtime"]
  node_governance_service["Action governance"]
  node_workspace_runtime["Action runtime<br/>[runtime.py]"]
  node_policy_rules["Policy rules<br/>[rules.py]"]
  node_identity["Identity and roles<br/>[identity.py]"]
  node_compiler["Workflow compiler<br/>[compiler.py]"]
  node_audit["Audit trail<br/>[audit.py]"]
end

subgraph group_knowledge["Copilot and retrieval"]
  node_source_registry["Source registry<br/>[sources.py]"]
  node_retrieval["Knowledge retrieval<br/>[rag.py]"]
  node_extraction["Structured extraction<br/>[extraction.py]"]
  node_safety["Prompt safety<br/>[safety_scaffold.py]"]
  node_llm["LLM cascade<br/>[llm_client.py]"]
end

subgraph group_persistence["Persistence and providers"]
  node_sql_store[("Workspace database<br/>[models.py]")]
  node_governor_store[("Governor store<br/>[governor_store.py]")]
  node_audit_store[("Audit database<br/>[audit_store.py]")]
  node_vector_service[("Vector search<br/>[pinecone_client.py]")]
  node_embedding_service["Embeddings<br/>[embeddings.py]"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]
node_pinecone[("Pinecone")]
node_llm_providers{{"LLM providers"}}

node_user -->|"uses"| node_workspace_ui
node_workspace_ui -->|"loads state"| node_workspace_state
node_workspace_ui -->|"renders views"| node_workspace_views
node_workspace_state -->|"uses transport"| node_browser_transport
node_browser_transport -->|"REST requests"| node_workspace_api
node_workspace_api -->|"dispatches actions"| node_workspace_runtime
node_workspace_api -->|"uses rules"| node_policy_rules
node_workspace_api -->|"uses identity"| node_identity
node_workspace_api -->|"uses compiler"| node_compiler
node_workspace_api -->|"uses sources"| node_source_registry
node_workspace_api -->|"uses retrieval"| node_retrieval
node_workspace_api -->|"uses safety"| node_safety
node_workspace_api -->|"uses LLM"| node_llm
node_workspace_runtime -->|"evaluates policies"| node_policy_rules
node_workspace_runtime -->|"checks identity"| node_identity
node_workspace_runtime -->|"records actions"| node_audit
node_workspace_runtime -->|"uses governor"| node_governance_service
node_audit -->|"persists events"| node_audit_store
node_governance_service -->|"stores decisions"| node_governor_store
node_workspace_api -.->|"persists workspace"| node_sql_store
node_sql_store -->|"connects to"| node_postgres
node_legacy_routes -->|"retrieves context"| node_retrieval
node_legacy_routes -->|"checks prompts"| node_safety
node_legacy_routes -->|"requests completion"| node_llm
node_legacy_routes -->|"persists conversations"| node_sql_store
node_extraction_route -.->|"runs extraction"| node_extraction
node_extraction -.->|"requests completion"| node_llm
node_retrieval -->|"creates embeddings"| node_embedding_service
node_retrieval -->|"queries vectors"| node_vector_service
node_vector_service -->|"searches index"| node_pinecone
node_llm -->|"cascades providers"| node_llm_providers

click node_workspace_ui "https://github.com/saketh070706/code_storm/blob/main/frontend/src/App.jsx"
click node_workspace_views "https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspace/Registry.jsx"
click node_workspace_state "https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspace/useWorkspace.js"
click node_browser_transport "https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspaceClient.js"
click node_workspace_api "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/api.py"
click node_legacy_routes "https://github.com/saketh070706/code_storm/blob/main/backend/api/routes/chat.py"
click node_extraction_route "https://github.com/saketh070706/code_storm/blob/main/backend/api/routes/extraction.py"
click node_governance_service "https://github.com/saketh070706/code_storm/blob/main/backend/core/governor_service.py"
click node_workspace_runtime "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/runtime.py"
click node_policy_rules "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/rules.py"
click node_identity "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/identity.py"
click node_compiler "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/compiler.py"
click node_audit "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/audit.py"
click node_source_registry "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/sources.py"
click node_retrieval "https://github.com/saketh070706/code_storm/blob/main/backend/core/rag.py"
click node_extraction "https://github.com/saketh070706/code_storm/blob/main/backend/core/extraction.py"
click node_safety "https://github.com/saketh070706/code_storm/blob/main/backend/core/safety_scaffold.py"
click node_llm "https://github.com/saketh070706/code_storm/blob/main/backend/core/llm_client.py"
click node_sql_store "https://github.com/saketh070706/code_storm/blob/main/backend/workspace/models.py"
click node_governor_store "https://github.com/saketh070706/code_storm/blob/main/backend/core/governor_store.py"
click node_audit_store "https://github.com/saketh070706/code_storm/blob/main/backend/core/audit_store.py"
click node_vector_service "https://github.com/saketh070706/code_storm/blob/main/backend/integrations/pinecone_client.py"
click node_embedding_service "https://github.com/saketh070706/code_storm/blob/main/backend/integrations/embeddings.py"

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_ui,node_workspace_views,node_workspace_state,node_browser_transport,node_user toneBlue
class node_workspace_api,node_legacy_routes,node_extraction_route,node_postgres,node_pinecone toneAmber
class node_governance_service,node_workspace_runtime,node_policy_rules,node_identity,node_compiler,node_audit toneMint
class node_source_registry,node_retrieval,node_extraction,node_safety,node_llm toneRose
class node_sql_store,node_governor_store,node_audit_store,node_vector_service,node_embedding_service,node_llm_providers toneIndigo
```

## Components

### Browser workspace

- [Workspace UI](https://github.com/saketh070706/code_storm/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Workspace views](https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspace/Registry.jsx): `frontend/src/workspace/Registry.jsx`
- [Workspace state](https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspace/useWorkspace.js): `frontend/src/workspace/useWorkspace.js`
- [API transport](https://github.com/saketh070706/code_storm/blob/main/frontend/src/workspaceClient.js): `frontend/src/workspaceClient.js`

### Backend APIs

- [Workspace API](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/api.py): `backend/workspace/api.py`
- [Copilot routes](https://github.com/saketh070706/code_storm/blob/main/backend/api/routes/chat.py): `backend/api/routes/chat.py`
- [Extraction API](https://github.com/saketh070706/code_storm/blob/main/backend/api/routes/extraction.py): `backend/api/routes/extraction.py`

### Governance runtime

- [Action governance](https://github.com/saketh070706/code_storm/blob/main/backend/core/governor_service.py): `backend/core/governor_service.py`
- [Action runtime](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/runtime.py): `backend/workspace/runtime.py`
- [Policy rules](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/rules.py): `backend/workspace/rules.py`
- [Identity and roles](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/identity.py): `backend/workspace/identity.py`
- [Workflow compiler](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/compiler.py): `backend/workspace/compiler.py`
- [Audit trail](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/audit.py): `backend/workspace/audit.py`

### Copilot and retrieval

- [Source registry](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/sources.py): `backend/workspace/sources.py`
- [Knowledge retrieval](https://github.com/saketh070706/code_storm/blob/main/backend/core/rag.py): `backend/core/rag.py`
- [Structured extraction](https://github.com/saketh070706/code_storm/blob/main/backend/core/extraction.py): `backend/core/extraction.py`
- [Prompt safety](https://github.com/saketh070706/code_storm/blob/main/backend/core/safety_scaffold.py): `backend/core/safety_scaffold.py`
- [LLM cascade](https://github.com/saketh070706/code_storm/blob/main/backend/core/llm_client.py): `backend/core/llm_client.py`

### Persistence and providers

- [Workspace database](https://github.com/saketh070706/code_storm/blob/main/backend/workspace/models.py): `backend/workspace/models.py`
- [Governor store](https://github.com/saketh070706/code_storm/blob/main/backend/core/governor_store.py): `backend/core/governor_store.py`
- [Audit database](https://github.com/saketh070706/code_storm/blob/main/backend/core/audit_store.py): `backend/core/audit_store.py`
- [Vector search](https://github.com/saketh070706/code_storm/blob/main/backend/integrations/pinecone_client.py): `backend/integrations/pinecone_client.py`
- [Embeddings](https://github.com/saketh070706/code_storm/blob/main/backend/integrations/embeddings.py): `backend/integrations/embeddings.py`

### Other components

- **User**
- **PostgreSQL**
- **Pinecone**
- **LLM providers**

## Connections

- User → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Workspace state: loads state (evidence: `frontend/src/App.jsx`)
- Workspace UI → Workspace views: renders views (evidence: `frontend/src/App.jsx`)
- Workspace state → API transport: uses transport (evidence: `frontend/src/workspace/useWorkspace.js`)
- API transport → Workspace API: REST requests (evidence: `README.md`)
- Workspace API → Action runtime: dispatches actions (evidence: `backend/workspace/api.py`)
- Workspace API → Policy rules: uses rules (evidence: `backend/workspace/api.py`)
- Workspace API → Identity and roles: uses identity (evidence: `backend/workspace/api.py`)
- Workspace API → Workflow compiler: uses compiler (evidence: `backend/workspace/api.py`)
- Workspace API → Source registry: uses sources (evidence: `backend/workspace/api.py`)
- Workspace API → Knowledge retrieval: uses retrieval (evidence: `backend/workspace/api.py`)
- Workspace API → Prompt safety: uses safety (evidence: `backend/workspace/api.py`)
- Workspace API → LLM cascade: uses LLM (evidence: `backend/workspace/api.py`)
- Action runtime → Policy rules: evaluates policies (evidence: `backend/workspace/runtime.py`)
- Action runtime → Identity and roles: checks identity (evidence: `backend/workspace/runtime.py`)
- Action runtime → Audit trail: records actions (evidence: `backend/workspace/runtime.py`)
- Action runtime → Action governance: uses governor (evidence: `backend/workspace/runtime.py`)
- Audit trail → Audit database: persists events (evidence: `backend/workspace/audit.py`)
- Action governance → Governor store: stores decisions (evidence: `backend/core/governor_service.py`)
- Workspace API → Workspace database: persists workspace (evidence: `backend/workspace/api.py`)
- Workspace database → PostgreSQL: connects to (evidence: `README.md`)
- Copilot routes → Knowledge retrieval: retrieves context (evidence: `backend/api/routes/chat.py`)
- Copilot routes → Prompt safety: checks prompts (evidence: `backend/api/routes/chat.py`)
- Copilot routes → LLM cascade: requests completion (evidence: `backend/api/routes/chat.py`)
- Copilot routes → Workspace database: persists conversations (evidence: `backend/api/routes/chat.py`)
- Extraction API → Structured extraction: runs extraction
- Structured extraction → LLM cascade: requests completion
- Knowledge retrieval → Embeddings: creates embeddings (evidence: `backend/core/rag.py`)
- Knowledge retrieval → Vector search: queries vectors (evidence: `backend/core/rag.py`)
- Vector search → Pinecone: searches index (evidence: `README.md`)
- LLM cascade → LLM providers: cascades providers (evidence: `backend/core/llm_client.py`)