data-olympus

data-olympus is a governance-grade knowledge-base format and server for agent workforces. It is an OKF-compatible profile (a conformant extension of the Open Knowledge Format) with governance extensions (stable id, controlled type/status/tier fields, supersedes chains) plus a single-writer MCP server and a CLI. The result is a git-native, version-controlled document graph of engineering standards, architectural decisions, and project knowledge that agents and humans can read, search, and extend without any proprietary service.

Status: pre-release (v0.1).

Why

• Portable, no lock-in. The entire KB is a directory of markdown files in git. No database, no proprietary schema, no vendor.
• Git-native diffs and review. Every change is a commit. Proposed edits go through a pending queue before commit; history is plain git log.
• Agent and human readable. Plain markdown with YAML frontmatter. No SDK required to read or author a document.
• Governed multi-agent writes. The single-writer MCP pipeline (advisory locks, per-session worktrees, durable push queue) prevents concurrent write races without requiring distributed locking infrastructure.
• Queryable by status, tier, and type. Filter by status: accepted, tier: T1, or type: decision without post-processing. The supersedes chain makes it possible to trace decision history across the graph.
• OKF-compatible. Any OKF consumer can read a data-olympus bundle. Any OKF-produced bundle can be governed by data-olympus tools.

Quickstart

# Install
uv venv && uv pip install -e '.[dev]'

# Lint the example bundle
uv run data-olympus lint example-bundle

# Start the MCP server against the example bundle
./scripts/run-local.sh

See docs/quickstart.md for the full local-run walkthrough, including curl and kb CLI queries.

Documentation

• SPEC.md: format specification (bundle layout, frontmatter schema, serving contracts).
• docs/quickstart.md: verified local-run procedure.
• docs/adoption.md: bring-your-own-KB guide (author, lint, index, serve, wire an agent).
• docs/serving.md: single-replica serving model, read-only replicas, git pull loop.
• docs/comparison.md: how data-olympus relates to OKF, enterprise catalogs, markdown KB tools, agent-context conventions, RAG, and ADR tooling.

License

Apache 2.0. See LICENSE and NOTICE.