# 11vated/generative-seed-programming-gspl- architecture

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

- Interactive diagram: https://gitdiagram.com/11vated/generative-seed-programming-gspl-
- Repository: https://github.com/11vated/generative-seed-programming-gspl-

## Overview

GSPL is a monorepo for a generative-seed programming stack, with web and Studio interfaces alongside language, evolution, domain-engine, knowledge, and export packages. A user-facing path is apparent from the product layout, but the sampled source does not establish the UI-to-API-to-core call chain, so those links are omitted. The graph preserves documented capability areas and shows only relationships supported by sampled code or explicit descriptions; unsampled package wiring is not inferred.

Main entry points: [`packages/knowledge/src/rag-pipeline.ts`](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/rag-pipeline.ts) (RAG Pipeline), [`packages/knowledge/src/vector-store.ts`](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/vector-store.ts) (Vector Store), [`packages/fabric/src/query-router.ts`](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/fabric/src/query-router.ts) (Knowledge Fabric), [`packages/knowledge/src/world-memory-graph.ts`](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/world-memory-graph.ts) (World Memory Graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_studio["Studio<br/>[App.tsx]"]
  node_web_ui["Web UI<br/>[App.tsx]"]
  node_web_api["Web API<br/>[app.ts]"]
  node_cli["CLI<br/>[index.ts]"]
  node_desktop["Desktop App<br/>[electron.ts]"]
end

subgraph group_seed_runtime["Seed Runtime"]
  node_language["GSPL Language<br/>[index.ts]"]
  node_seed_core["Seed Core<br/>[index.ts]"]
  node_evolution["Evolution<br/>[index.ts]"]
  node_domain_engines["Domain Engines<br/>[index.ts]"]
  node_compute["Compute Backends<br/>[index.ts]"]
end

subgraph group_discovery["Discovery &amp; Intelligence"]
  node_research["Research Engine<br/>[research-engine.ts]"]
  node_possibility["Possibility Engine"]
  node_llm["LLM Intelligence<br/>[index.ts]"]
end

subgraph group_knowledge_network["Knowledge &amp; Network"]
  node_fabric["Knowledge Fabric<br/>[query-router.ts]"]
  node_rag["RAG Pipeline<br/>[rag-pipeline.ts]"]
  node_knowledge_engine["Knowledge Synthesis"]
  node_p2p["Peer Sharing<br/>[peer-manager.ts]"]
  node_vector_store[("Vector Store<br/>[vector-store.ts]")]
  node_world_graph[("World Memory Graph")]
end

subgraph group_outputs_security["Outputs &amp; Security"]
  node_export["Game Exports"]
  node_security["Threat Detection"]
end

node_user(("User"))

node_user -->|"uses"| node_studio
node_user -->|"uses"| node_web_ui
node_user -->|"uses"| node_cli
node_fabric -->|"reads cache"| node_vector_store
node_fabric -->|"audits queries"| node_world_graph
node_rag -->|"writes chunks"| node_vector_store
node_rag -->|"retrieves vectors"| node_vector_store
node_rag -->|"retrieves graph"| node_world_graph

click node_studio "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/studio/app/App.tsx"
click node_web_ui "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/ui/src/App.tsx"
click node_web_api "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/web/src/app.ts"
click node_cli "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/cli/src/index.ts"
click node_language "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/core/src/lang/index.ts"
click node_seed_core "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/core/src/index.ts"
click node_evolution "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/evolution/src/index.ts"
click node_domain_engines "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/engines/src/index.ts"
click node_compute "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/compute/src/index.ts"
click node_research "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/evolution/src/research-engine.ts"
click node_possibility "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/generate/src/possibility-engine.ts"
click node_llm "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/llm/src/index.ts"
click node_fabric "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/fabric/src/query-router.ts"
click node_rag "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/rag-pipeline.ts"
click node_knowledge_engine "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/knowledge-engine.ts"
click node_p2p "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/p2p/src/peer-manager.ts"
click node_vector_store "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/vector-store.ts"
click node_world_graph "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/world-memory-graph.ts"
click node_export "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/export/src/game-engine-exporters.ts"
click node_security "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/security/src/signature-engine.ts"
click node_desktop "https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/desktop/src/electron.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_studio,node_web_ui,node_web_api,node_cli,node_desktop,node_user toneBlue
class node_language,node_seed_core,node_evolution,node_domain_engines,node_compute toneAmber
class node_research,node_possibility,node_llm toneMint
class node_fabric,node_rag,node_knowledge_engine,node_p2p,node_vector_store,node_world_graph toneRose
class node_export,node_security toneIndigo
```

## Components

### User Interfaces

- [Studio](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/studio/app/App.tsx): `packages/studio/app/App.tsx`
- [Web UI](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/ui/src/App.tsx): `packages/ui/src/App.tsx`
- [Web API](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/web/src/app.ts): `packages/web/src/app.ts`
- [CLI](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/cli/src/index.ts): `packages/cli/src/index.ts`
- [Desktop App](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/desktop/src/electron.ts): `packages/desktop/src/electron.ts`

### Seed Runtime

- [GSPL Language](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/core/src/lang/index.ts): `packages/core/src/lang/index.ts`
- [Seed Core](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/core/src/index.ts): `packages/core/src/index.ts`
- [Evolution](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/evolution/src/index.ts): `packages/evolution/src/index.ts`
- [Domain Engines](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/engines/src/index.ts): `packages/engines/src/index.ts`
- [Compute Backends](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/compute/src/index.ts): `packages/compute/src/index.ts`

### Discovery & Intelligence

- [Research Engine](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/evolution/src/research-engine.ts): `packages/evolution/src/research-engine.ts`
- [Possibility Engine](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/generate/src/possibility-engine.ts): `packages/generate/src/possibility-engine.ts`
- [LLM Intelligence](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/llm/src/index.ts): `packages/llm/src/index.ts`

### Knowledge & Network

- [Knowledge Fabric](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/fabric/src/query-router.ts): `packages/fabric/src/query-router.ts`
- [RAG Pipeline](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/rag-pipeline.ts): `packages/knowledge/src/rag-pipeline.ts`
- [Knowledge Synthesis](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/knowledge-engine.ts): `packages/knowledge/src/knowledge-engine.ts`
- [Peer Sharing](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/p2p/src/peer-manager.ts): `packages/p2p/src/peer-manager.ts`
- [Vector Store](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/vector-store.ts): `packages/knowledge/src/vector-store.ts`
- [World Memory Graph](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/knowledge/src/world-memory-graph.ts): `packages/knowledge/src/world-memory-graph.ts`

### Outputs & Security

- [Game Exports](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/export/src/game-engine-exporters.ts): `packages/export/src/game-engine-exporters.ts`
- [Threat Detection](https://github.com/11vated/generative-seed-programming-gspl-/blob/main/packages/security/src/signature-engine.ts): `packages/security/src/signature-engine.ts`

### Other components

- **User**

## Connections

- User → Studio: uses
- User → Web UI: uses
- User → CLI: uses
- Knowledge Fabric → Vector Store: reads cache
- Knowledge Fabric → World Memory Graph: audits queries
- RAG Pipeline → Vector Store: writes chunks
- RAG Pipeline → Vector Store: retrieves vectors
- RAG Pipeline → World Memory Graph: retrieves graph