# rxmna8502/vybe-intelligence-vault architecture

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

- Interactive diagram: https://gitdiagram.com/rxmna8502/vybe-intelligence-vault
- Repository: https://github.com/rxmna8502/vybe-intelligence-vault

## Overview

Vybe Intelligence Vault harvests AI-related repositories and research, enriches and evaluates candidate material, publishes curated Markdown nodes, then builds a searchable semantic graph. Engineers and agents consume that knowledge through the MCP gateway; the 3D explorer provides a visual route. README documentation describes these product capabilities, while sampled source confirms crawler enrichment, index construction and state persistence. MCP and world implementation details were not sampled, so their internal wiring is shown only at the documented subsystem level.

Main entry points: [`scripts/evaluate_repo.py`](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/evaluate_repo.py) (Discovery and Evaluation), [`scripts/build-index.js`](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/build-index.js) (Index and Graph Builder), [`vault-core`](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/vault-core) (Vault Index), [`scripts/state-manager.js`](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/state-manager.js) (Vault State Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_harvest["Harvest and Evaluate"]
  node_harvester["Discovery and Evaluation<br/>[evaluate_repo.py]"]
  node_crawler["Web Enrichment<br/>[crawler.py]"]
end

subgraph group_knowledge["Knowledge Graph"]
  node_index_builder["Index and Graph Builder<br/>[build-index.js]"]
  node_state_manager["Vault State Manager<br/>[state-manager.js]"]
  node_vault_index[("Vault Index")]
  node_embeddings[("Embedding Cache")]
end

subgraph group_access["Knowledge Access"]
  node_mcp["MCP Gateway"]
  node_world["3D Graph Explorer"]
  node_index_pages["Published Indexes"]
end

subgraph group_content["Knowledge Content"]
  node_agent_content["Agent Resources"]
  node_rag_content["RAG Resources"]
  node_taxonomy_content["Other Taxonomies"]
  node_daily_digests["Daily Digests"]
end

node_engineer(("AI Engineer"))
node_agent(("AI Agent"))
node_research_mesh{{"Research Sources"}}
node_github{{"GitHub"}}
node_llm{{"LLM Evaluators"}}

node_research_mesh -->|"supplies sources"| node_harvester
node_github -->|"repository discovery"| node_harvester
node_harvester -->|"enriches URLs"| node_crawler
node_harvester -->|"requests evaluation"| node_llm
node_llm -->|"returns evaluation"| node_harvester
node_harvester -->|"publishes nodes"| node_agent_content
node_harvester -->|"publishes nodes"| node_rag_content
node_harvester -->|"publishes nodes"| node_taxonomy_content
node_harvester -->|"generates digests"| node_daily_digests
node_index_builder -->|"reads Markdown"| node_agent_content
node_index_builder -->|"reads Markdown"| node_rag_content
node_index_builder -->|"reads Markdown"| node_taxonomy_content
node_index_builder -->|"reads Markdown"| node_daily_digests
node_index_builder -->|"caches vectors"| node_embeddings
node_index_builder -->|"loads and stores state"| node_state_manager
node_state_manager -->|"reads and writes"| node_vault_index
node_agent -->|"queries context"| node_mcp
node_engineer -->|"explores graph"| node_world
node_mcp -->|"queries index"| node_vault_index
node_world -->|"visualizes graph"| node_vault_index
node_index_builder -->|"publishes indexes"| node_index_pages

click node_harvester "https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/evaluate_repo.py"
click node_crawler "https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/crawler.py"
click node_agent_content "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai/agents"
click node_rag_content "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai/rag"
click node_taxonomy_content "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai"
click node_index_builder "https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/build-index.js"
click node_state_manager "https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/state-manager.js"
click node_vault_index "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/vault-core"
click node_mcp "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/mcp-server/mcp_server"
click node_world "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/world"
click node_index_pages "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/_index"
click node_daily_digests "https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/daily-digests"

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_harvester,node_crawler toneBlue
class node_index_builder,node_state_manager,node_vault_index,node_embeddings toneAmber
class node_mcp,node_world,node_index_pages toneMint
class node_agent_content,node_rag_content,node_taxonomy_content,node_daily_digests toneRose
class node_engineer,node_agent,node_research_mesh,node_github,node_llm toneIndigo
```

## Components

### Harvest and Evaluate

- [Discovery and Evaluation](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/evaluate_repo.py): `scripts/evaluate_repo.py`
- [Web Enrichment](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/crawler.py): `scripts/crawler.py`

### Knowledge Graph

- [Index and Graph Builder](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/build-index.js): `scripts/build-index.js`
- [Vault State Manager](https://github.com/rxmna8502/vybe-intelligence-vault/blob/main/scripts/state-manager.js): `scripts/state-manager.js`
- [Vault Index](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/vault-core): `vault-core`
- **Embedding Cache**

### Knowledge Access

- [MCP Gateway](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/mcp-server/mcp_server): `mcp-server/mcp_server`
- [3D Graph Explorer](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/world): `world`
- [Published Indexes](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/_index): `_index`

### Knowledge Content

- [Agent Resources](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai/agents): `ai/agents`
- [RAG Resources](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai/rag): `ai/rag`
- [Other Taxonomies](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/ai): `ai`
- [Daily Digests](https://github.com/rxmna8502/vybe-intelligence-vault/tree/main/daily-digests): `daily-digests`

### Other components

- **AI Engineer**
- **AI Agent**
- **Research Sources**
- **GitHub**
- **LLM Evaluators**

## Connections

- Research Sources → Discovery and Evaluation: supplies sources
- GitHub → Discovery and Evaluation: repository discovery
- Discovery and Evaluation → Web Enrichment: enriches URLs
- Discovery and Evaluation → LLM Evaluators: requests evaluation
- LLM Evaluators → Discovery and Evaluation: returns evaluation
- Discovery and Evaluation → Agent Resources: publishes nodes
- Discovery and Evaluation → RAG Resources: publishes nodes
- Discovery and Evaluation → Other Taxonomies: publishes nodes
- Discovery and Evaluation → Daily Digests: generates digests
- Index and Graph Builder → Agent Resources: reads Markdown
- Index and Graph Builder → RAG Resources: reads Markdown
- Index and Graph Builder → Other Taxonomies: reads Markdown
- Index and Graph Builder → Daily Digests: reads Markdown
- Index and Graph Builder → Embedding Cache: caches vectors
- Index and Graph Builder → Vault State Manager: loads and stores state
- Vault State Manager → Vault Index: reads and writes
- AI Agent → MCP Gateway: queries context
- AI Engineer → 3D Graph Explorer: explores graph
- MCP Gateway → Vault Index: queries index
- 3D Graph Explorer → Vault Index: visualizes graph
- Index and Graph Builder → Published Indexes: publishes indexes