# bdolphin/continuum-mesh architecture

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

- Interactive diagram: https://gitdiagram.com/bdolphin/continuum-mesh
- Repository: https://github.com/bdolphin/continuum-mesh

## Overview

Continuum is a cross-tool memory product: it captures conversation content, normalizes and deduplicates events, embeds and persists them, then supports retrieval, ranking, and feedback. The daemon is the clearest evidenced runtime path; browser-extension and UI modules indicate additional product surfaces, but their wiring to the daemon is not shown in the excerpts or source index. Evaluation and optional monitoring are separate product capabilities. Arrows are limited to relationships visible in excerpts or source-index references.

Main entry points: [`daemon/core/pipeline.py`](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/pipeline.py) (Ingest pipeline), [`daemon/connectors/_browser.py`](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/_browser.py) (Browser connector), [`daemon/connectors/slack.py`](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/slack.py) (Slack connector), [`daemon/main.py`](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/main.py) (Memory daemon API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture surfaces"]
  node_extension["Browser extension"]
  node_webui["Web UI"]
end

subgraph group_ingest["Ingestion core"]
  node_api["Memory daemon API<br/>[main.py]"]
  node_registry["Connector registry<br/>[registry.py]"]
  node_connector["Connector interface<br/>[connector.py]"]
  node_browserconn["Browser connector<br/>[_browser.py]"]
  node_chatgpt["ChatGPT connector<br/>[chatgpt.py]"]
  node_perplexity["Perplexity connector<br/>[perplexity.py]"]
  node_slack["Slack connector<br/>[slack.py]"]
  node_schema["Memory event schema<br/>[schema.py]"]
  node_pipeline["Ingest pipeline<br/>[pipeline.py]"]
end

subgraph group_recall["Memory and recall"]
  node_embeddings["Embedding providers<br/>[embeddings.py]"]
  node_store[("Persistent memory store<br/>[memory_store.py]")]
  node_ranker["Retrieval ranker<br/>[ranker.py]"]
  node_assembler["Context assembler<br/>[assembler.py]"]
  node_mcp["MCP server<br/>[mcp_server.py]"]
end

subgraph group_quality["Evaluation and monitoring"]
  node_evaldata["Labeled eval dataset<br/>[dataset.py]"]
  node_monitor["Evidently monitoring"]
end

node_user(("User"))

node_user -.->|"captures content"| node_extension
node_user -.->|"uses"| node_webui
node_extension -.->|"posts captures"| node_api
node_api -->|"invokes ingest"| node_pipeline
node_api -->|"builds connectors"| node_registry
node_pipeline -->|"captures and normalizes"| node_connector
node_pipeline -->|"processes events"| node_schema
node_pipeline -->|"embeds text"| node_embeddings
node_pipeline -->|"checks and stores"| node_store
node_browserconn -->|"implements"| node_connector
node_browserconn -->|"creates events"| node_schema
node_chatgpt -->|"reuses"| node_browserconn
node_perplexity -->|"reuses"| node_browserconn
node_slack -->|"implements"| node_connector
node_slack -->|"creates events"| node_schema
node_slack -->|"registers"| node_registry
node_evaldata -.->|"supplies eval probes"| node_monitor

click node_extension "https://github.com/bdolphin/continuum-mesh/tree/main/extension"
click node_webui "https://github.com/bdolphin/continuum-mesh/tree/main/ui/app"
click node_api "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/main.py"
click node_registry "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/registry.py"
click node_connector "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/connector.py"
click node_browserconn "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/_browser.py"
click node_chatgpt "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/chatgpt.py"
click node_perplexity "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/perplexity.py"
click node_slack "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/slack.py"
click node_schema "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/schema.py"
click node_pipeline "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/pipeline.py"
click node_embeddings "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/embeddings.py"
click node_store "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/memory_store.py"
click node_ranker "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/ranker.py"
click node_assembler "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/assembler.py"
click node_mcp "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/mcp_server.py"
click node_evaldata "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/eval/dataset.py"
click node_monitor "https://github.com/bdolphin/continuum-mesh/blob/main/daemon/monitoring/evidently_monitor.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_extension,node_webui,node_user toneBlue
class node_api,node_registry,node_connector,node_browserconn,node_chatgpt,node_perplexity,node_slack,node_schema,node_pipeline toneAmber
class node_embeddings,node_store,node_ranker,node_assembler,node_mcp toneMint
class node_evaldata,node_monitor toneRose
```

## Components

### Capture surfaces

- [Browser extension](https://github.com/bdolphin/continuum-mesh/tree/main/extension): `extension`
- [Web UI](https://github.com/bdolphin/continuum-mesh/tree/main/ui/app): `ui/app`

### Ingestion core

- [Memory daemon API](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/main.py): `daemon/main.py`
- [Connector registry](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/registry.py): `daemon/core/registry.py`
- [Connector interface](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/connector.py): `daemon/core/connector.py`
- [Browser connector](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/_browser.py): `daemon/connectors/_browser.py`
- [ChatGPT connector](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/chatgpt.py): `daemon/connectors/chatgpt.py`
- [Perplexity connector](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/perplexity.py): `daemon/connectors/perplexity.py`
- [Slack connector](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/connectors/slack.py): `daemon/connectors/slack.py`
- [Memory event schema](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/schema.py): `daemon/core/schema.py`
- [Ingest pipeline](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/core/pipeline.py): `daemon/core/pipeline.py`

### Memory and recall

- [Embedding providers](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/embeddings.py): `daemon/embeddings.py`
- [Persistent memory store](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/memory_store.py): `daemon/memory_store.py`
- [Retrieval ranker](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/ranker.py): `daemon/ranker.py`
- [Context assembler](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/assembler.py): `daemon/assembler.py`
- [MCP server](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/mcp_server.py): `daemon/mcp_server.py`

### Evaluation and monitoring

- [Labeled eval dataset](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/eval/dataset.py): `daemon/eval/dataset.py`
- [Evidently monitoring](https://github.com/bdolphin/continuum-mesh/blob/main/daemon/monitoring/evidently_monitor.py): `daemon/monitoring/evidently_monitor.py`

### Other components

- **User**

## Connections

- User → Browser extension: captures content
- User → Web UI: uses
- Browser extension → Memory daemon API: posts captures
- Memory daemon API → Ingest pipeline: invokes ingest (evidence: `daemon/main.py`)
- Memory daemon API → Connector registry: builds connectors (evidence: `daemon/main.py`)
- Ingest pipeline → Connector interface: captures and normalizes (evidence: `daemon/core/pipeline.py`)
- Ingest pipeline → Memory event schema: processes events (evidence: `daemon/core/pipeline.py`)
- Ingest pipeline → Embedding providers: embeds text (evidence: `daemon/core/pipeline.py`)
- Ingest pipeline → Persistent memory store: checks and stores (evidence: `daemon/core/pipeline.py`)
- Browser connector → Connector interface: implements (evidence: `daemon/connectors/_browser.py`)
- Browser connector → Memory event schema: creates events (evidence: `daemon/connectors/_browser.py`)
- ChatGPT connector → Browser connector: reuses (evidence: `daemon/connectors/chatgpt.py`)
- Perplexity connector → Browser connector: reuses (evidence: `daemon/connectors/perplexity.py`)
- Slack connector → Connector interface: implements (evidence: `daemon/connectors/slack.py`)
- Slack connector → Memory event schema: creates events (evidence: `daemon/connectors/slack.py`)
- Slack connector → Connector registry: registers (evidence: `daemon/connectors/slack.py`)
- Labeled eval dataset → Evidently monitoring: supplies eval probes
