{"id":51440124,"url":"https://github.com/knaisoma/data-olympus","last_synced_at":"2026-07-05T11:00:24.173Z","repository":{"id":367119948,"uuid":"1279181033","full_name":"knaisoma/data-olympus","owner":"knaisoma","description":"Governance-grade, OKF-compatible knowledge-base format with a single-writer MCP server and CLI. Pre-release.","archived":false,"fork":false,"pushed_at":"2026-07-01T20:51:40.000Z","size":1012,"stargazers_count":3,"open_issues_count":7,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T22:24:53.459Z","etag":null,"topics":["ai-agents","knowledge-base","knowledge-management","markdown","mcp","model-context-protocol","okf"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/knaisoma.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-24T12:56:23.000Z","updated_at":"2026-07-01T20:42:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/knaisoma/data-olympus","commit_stats":null,"previous_names":["knaisoma/data-olympus"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/knaisoma/data-olympus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knaisoma%2Fdata-olympus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knaisoma%2Fdata-olympus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knaisoma%2Fdata-olympus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knaisoma%2Fdata-olympus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/knaisoma","download_url":"https://codeload.github.com/knaisoma/data-olympus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knaisoma%2Fdata-olympus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35151638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","knowledge-base","knowledge-management","markdown","mcp","model-context-protocol","okf"],"created_at":"2026-07-05T11:00:19.629Z","updated_at":"2026-07-05T11:00:24.165Z","avatar_url":"https://github.com/knaisoma.png","language":"Python","funding_links":[],"categories":["Harnesses \u0026 orchestration","💿 Products"],"sub_categories":["Agent infrastructure","Open-Source"],"readme":"# data-olympus\n\n**New here? Start with [WHY.md](WHY.md).** It is the story behind the project: the\nproblem we kept hitting with coding agents, what data-olympus does differently, how\nit relates to Google's Open Knowledge Format, and where our benchmarks say it is\nstrong and where it is not. The rest of this README is the technical reference.\n\ndata-olympus is a governance-grade knowledge-base format and server for agent workforces. It is designed to be readable by [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) (OKF) consumers: it inherits OKF's directory structure, frontmatter conventions, reserved filenames, and link model, then layers governance extensions on top (stable `id`, controlled `type`/`status`/`tier` fields, `supersedes` chains) plus a single-writer MCP server and a CLI. Formal conformance testing against the OKF reference tooling is not yet in place (tracked in [issue #82](https://github.com/knaisoma/data-olympus/issues/82)). 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.\n\nIt governs *decisions*, not code. When an agent is about to make a choice (a library, a pattern, a migration), data-olympus surfaces the established standard or decision that should govern that choice. It is deliberately **not** a code-search, reference-finding, or \"where is X used\" tool: LSP, grep, and Sourcegraph already do that well. The retrieval task it targets is coding-intent to governing-rule, and it helps where current model interaction during vibe-coding is weakest: keeping the model aligned to patterns the team has already established as correct.\n\n**Status: pre-1.0 beta. Latest release: v0.3.0.**\n\n## Why\n\n- **Portable, no lock-in.** The entire KB is a directory of markdown files in git. No database, no proprietary schema, no vendor.\n- **Git-native diffs and review.** Every change is a commit. Proposed edits go through a pending queue before commit; history is plain git log.\n- **Agent and human readable.** Plain markdown with YAML frontmatter. No SDK required to read or author a document.\n- **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.\n- **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.\n- **Designed to be OKF-readable.** Built on OKF's directory structure, frontmatter conventions, reserved filenames, and link model; formal conformance testing against OKF reference tooling is tracked in [issue #82](https://github.com/knaisoma/data-olympus/issues/82), not yet implemented.\n\n## Quickstart\n\nRequires Python 3.13+ and [`uv`](https://docs.astral.sh/uv/).\n\n```bash\n# Install\nuv venv \u0026\u0026 uv pip install -e '.[dev]'\n\n# Lint the example bundle\nuv run data-olympus lint example-bundle\n\n# Start the MCP server against the example bundle\n./scripts/run-local.sh\n```\n\nSee `docs/quickstart.md` for the full local-run walkthrough, including curl and `kb` CLI queries.\n\n## Documentation\n\n- [`SPEC.md`](SPEC.md): format specification (bundle layout, frontmatter schema, serving contracts).\n- [`docs/quickstart.md`](docs/quickstart.md): verified local-run procedure.\n- [`docs/adoption.md`](docs/adoption.md): bring-your-own-KB guide (author, lint, index, serve, wire an agent).\n- [`docs/serving.md`](docs/serving.md): single-replica serving model, read-only replicas, git pull loop, health/readiness/liveness split, proxy headers, audit-log rotation.\n- [`docs/operations.md`](docs/operations.md): production runbook — backup, upgrade, recovery playbooks (degraded/fetch-failed, history rewrite, frozen/demoted push entries, orphaned locks), and the health/alerting model.\n- [`docs/comparison.md`](docs/comparison.md): how data-olympus relates to OKF, enterprise catalogs, markdown KB tools, agent-context conventions, RAG, and ADR tooling.\n- [`docs/enforcement.md`](docs/enforcement.md): turning the KB into a mandatory consultation gate (hooks, `kb enforce`).\n- [`benchmarks/README.md`](benchmarks/README.md): retrieval benchmark methodology and how to reproduce the numbers in `docs/comparison.md`.\n- [`SECURITY.md`](SECURITY.md): supported versions and how to report a vulnerability.\n\n## License\n\nApache 2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknaisoma%2Fdata-olympus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fknaisoma%2Fdata-olympus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknaisoma%2Fdata-olympus/lists"}