Skip to content
cbu-capstone-design-27Public

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Ember logo: a flame with graph nodes

Ember

Shared project context for AI coding agents, served over MCP.
A capstone project at California Baptist University, Fall 2026 to Spring 2027.

Quick start  ·  Architecture  ·  Decisions  ·  Jira board

Apache-2.0 license

Coding agents start every session knowing only the code and whatever is written in files like AGENTS.md. The reasons behind the code live in pull requests, tickets and chat threads, and no static file keeps up with them.

Ember collects that record from GitHub, GitLab, Jira and Slack as it happens. It stores each pull request, ticket and message in Postgres, embeds it with one shared model, and serves search over it through an MCP server, so Claude Code, Codex, Cursor or any other MCP client can ask what was decided and why. The web dashboard also shows where the sources disagree, such as a ticket still in progress after its pull request merged.

How it works

flowchart LR
  S["GitHub, GitLab,<br/>Jira, Slack"] -->|webhooks| I["intake<br/>verify, store raw_events"]
  I --> E["enrich<br/>one worker per source"]
  E --> SR[("source_records<br/>+ pgvector embeddings")]
  SR --> M["MCP server<br/>search"]
  M --> A["Claude Code, Codex,<br/>Cursor"]
Loading

Intake is the one webhook listener for every source. It verifies each delivery, stores it as it arrived and answers right away. A worker per source then enriches the delivery, fetching only what the payload lacks, and writes a source_records row. The embed worker adds a vector to each row, and the MCP server searches those vectors. Postgres holds every hand-off, so each stage can be stopped, replayed or replaced on its own. The extract and load workers (services/pipeline) build a typed knowledge graph from those rows in Postgres's graph tables, which the MCP server reads through Ember's Graphiti fork (ADR 0013). They don't run on the cluster yet.

The full design is in docs/ingestion/architecture.md and ADR 0004.

Repository layout

Path What is in it
apps/ The web app (Next.js, Better Auth), the MCP server and the CLI
services/ intake, the per-source ingestion and enrich workers, the embed worker and the embedding service
packages/ Shared libraries, added only once a second consumer needs them
infra/ Local Docker Compose. The cluster (k3s, Flux, Ansible, Secrets) lives in the private infra repo
docs/ Architecture decisions, the ingestion design, the graph schema and the working agreement

Quick start

You need Docker and Node 22 or later. From the repository root:

cp .env.example .env

# Postgres 18 with pgvector, the version the cluster runs
docker compose -f infra/docker-compose.yml --env-file .env --profile postgres up -d --wait postgres

# The web app at http://localhost:3000
cd apps/web
npm ci
DATABASE_URL=postgres://ember:change-me-locally@localhost:5432/ember \
  BETTER_AUTH_SECRET=dev-secret-change-me BETTER_AUTH_URL=http://localhost:3000 npm run dev

Each component's README covers running it and its tests:

Status

Ember is in active development and is not ready for outside use. Intake, the enrich workers for GitHub, GitLab, Jira and Slack, and the embed worker are merged. Intake and the GitHub enrich worker run on the team's cluster. The MCP server and vector search are in open pull requests, and the web dashboard runs on preview data.

Launch scope is tracked on the EMBER Jira board by label:

Contributing

Every change starts from a Jira ticket and lands as a pull request into develop. CONTRIBUTING.md has the branch and PR conventions, and AGENTS.md has the rules every ingestion worker follows. Report security issues as described in SECURITY.md.

Team

Ryan Stoffel, Payton Henry, Elijah Tabor, Brandon Magana and Jacob Pugh, for the CBU senior capstone.

License

Apache 2.0

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages