Overview

Compass is an organizational context engine that builds a temporal entity graph of your systems and serves it to AI agents via MCP.

Core Concepts

Entity is the core domain object — anything worth naming in your organization's knowledge graph: a table, service, pipeline, satellite, person, decision, etc. Entities have an open type system — any non-empty string is a valid type.

Edge is a typed, directed, temporal relationship between two entities. Lineage, ownership, and other relationships are all modeled as edges.

Chunk is a text fragment with a vector embedding for semantic search. Chunks are derived from entities — they're an indexing mechanism, not knowledge.

Features

• Entity Graph: Temporal entities with typed edges and properties (JSONB)
• Search: Keyword (tsvector), semantic (pgvector), and hybrid (RRF fusion)
• Context Assembly: get_context builds a subgraph around any entity
• Impact Analysis: impact traces downstream blast radius
• MCP Tools: AI agents query the graph via MCP protocol
• Stars: Users can star entities for quick access

Architecture

All search is Postgres-native — no Elasticsearch dependency:

Mode	Engine	Purpose
Keyword	tsvector + pg_trgm	Exact matches, fuzzy/typo tolerance
Semantic	pgvector cosine	Conceptual/natural language
Hybrid	Both + RRF fusion	Best of both

Schema: namespaces → users → entities → edges → chunks → stars