Human and Agent Interfaces
The human site, Markdown twins, llms.txt, API, MCP, CLI, and cross-interface identity contract.
Lens: encyclopedia — A coherent general overview with explicit provenance and disagreement.
Included objects
Agent Task
name: Agent task proposal description: Coordinate a proposed task before an immutable contract is accepted title: "[task] " labels: [] body: - type: markdown attributes: value: | Issues coordinate work but do not create canonical task authority. Accepted work requires a validated immutable task contract in `tasks/contr
- Kind:
automation - Source path:
.github/ISSUE_TEMPLATE/agent-task.yml - Object ID:
em:automation:sha256:8e14326345d750b9323130bf0d0afb007e19d68e0e9bf42eacb88fea9794cd9e - Content digest:
7305aa9280554ddbd3a31810406fb2114d807d8dffc86c7c0264673b3faa80eb
Pull Request Template
- Task contract: - Candidate SHA: - Accepted base SHA: - Change class: - Allowed paths: - Protected or normative paths touched:
- Kind:
automation - Source path:
.github/pull_request_template.md - Object ID:
em:automation:sha256:d4da60e0a9ecc647978b3d750b16f600a5a993da7903b9658748e9104a4689cc - Content digest:
58f0722cc9900ad92a5c17594e3783848dca35062891b26421d4ee11a4c50530
Ci
name: validate
- Kind:
automation - Source path:
.github/workflows/ci.yml - Object ID:
em:automation:sha256:003e8a8955e3d7c9229ce73f44aeec0148b2ced01eec9aaf10f5ca6b8eb578d9 - Content digest:
3e2757acd451de04cdf7985a4313ce0e3a3d949fb14e0507c868674519d72d0e
Container
name: publish-container
- Kind:
automation - Source path:
.github/workflows/container.yml - Object ID:
em:automation:sha256:3a90a6127614f1a6487a4ae37ab09608f1b6486e9b32716f9be2c7ed831b9e44 - Content digest:
772d8067eac4691255f3bb2b3279093ff1e87d7bb00c2b4646e2720ee60b6598
Pages
name: publish-pages
- Kind:
automation - Source path:
.github/workflows/pages.yml - Object ID:
em:automation:sha256:5715a2e1c34e3fbde0b1c696674556b8b3a3c1b965e5b522769028ae3cab1dc3 - Content digest:
c130385f859ba2f3ee3ceda5d3a192eb203a2f078fef730926a1efa6af8e684e
Release
name: release
- Kind:
automation - Source path:
.github/workflows/release.yml - Object ID:
em:automation:sha256:23fcd49d215a563699c42cfe25161d9c1de3adbf942038b9a142c9fe36a9f167 - Content digest:
4546b4d89e0c67bf2337091d3ac349dfac62496dd202e25914f4de9f6b86379a
Epistemedia Documentation
- Architecture - Human and agent interface contract - Autonomous governance - API, MCP, and CLI - Public API and MCP deployment contract - Agent operations - Launch and engagement - [Brand
- Kind:
documentation - Source path:
docs/README.md - Object ID:
em:documentation:sha256:0bb19954607726a41f7ff3195fafc4e83bd5a953e1f370e276b133899612104d - Content digest:
959223b6aeafab2daa078af87029c5bef7822e706db003a0697bab70422dd4fc
Agent Operations
This directory contains repeatable operating recipes. AGENTS.md remains the root authority contract.
- Kind:
documentation - Source path:
docs/agent-ops/README.md - Object ID:
em:documentation:sha256:c33dcbb04b7907672ac2aeb8b070ccdcaa3759dfd5e9feb6bbedd4c848d33ba6 - Content digest:
57865da7b5d622610d327ddf0ade713e5cd18b29c5bc88e0d34acbfb5b1cc778
Contributor Agent Recipe
1. Orient: make orient. 2. Select: python -m epistemedia repo next. 3. Read the root contract, selected task contract, execution plan, scoped authority, schemas, policies, and tests. 4. Claim through an append-only proposal. 5. Work in one bounded branch and preserve negative results. 6. Rebuild all derived surface
- Kind:
documentation - Source path:
docs/agent-ops/contributor.md - Object ID:
em:documentation:sha256:477c27b7a79e2bd2eadee636d8576be10f0be62fcf9d3e7129de210f820501a6 - Content digest:
200449654805e3a1a6e1757550e7355b71486f32f5a8bdce5239f0c7293ba4bb
API, MCP, and CLI
All integrations read the same disclosure-safe public catalog. Preserve the returned catalog_id, frontier, commit, compiler, policy IDs, object IDs, and content digests when storing or citing results.
- Kind:
documentation - Source path:
docs/api-mcp-cli.md - Object ID:
em:documentation:sha256:226ad5b49b2fdf606ce39f349a23293fd8a52d48ef03c1c06e3f37372032d662 - Content digest:
52fc1b2c11fb91df055fe39f5c680e284c82a50af937fc5ecd4acd0efcfb66d5
Public API and MCP deployment contract
The API and MCP gateway is a read-only projection service. It receives an accepted repository snapshot and exposes no GitHub, contribution, deployment, package-publishing, signing, or arbitrary network-fetch authority.
- Kind:
documentation - Source path:
docs/api-mcp-deployment.md - Object ID:
em:documentation:sha256:30fe42f129cc7f12b02b2c5aa17d1c05b8fd2a7a8deebf5208ab79c70c0bcfb4 - Content digest:
8f96dba2e401d83cd5f25c28b0dc7d8ce3413ce4a702b8a2192b3c1824ec4d08
Epistemedia Architecture
Epistemedia is not an autonomous wiki whose canonical object is a page. Its canonical substrate is an append-only, provenance-preserving epistemic history. Pages and agent responses are reproducible projections over that history.
- Kind:
documentation - Source path:
docs/architecture.md - Object ID:
em:documentation:sha256:e692c6fd478d9d233f49d97573d028c76cf490d5cd6dc722c8827b1072128ae1 - Content digest:
e98789193cda4246aeb9738f82adafc21424d45cbdf51678c00e7681b821437f
Brand Architecture
Knowledge that can show its work.
- Kind:
documentation - Source path:
docs/brand.md - Object ID:
em:documentation:sha256:41cf4e33a19c62d8f32cf4c763f4d9299261a1a6bedcd4d28d15e664636d6764 - Content digest:
b27c9de7ba02d52bdca9f0aae5b20ebaec307e265bc6a7664821448ae45412d7
Validation workflow
Epistemedia's contribution CI is defined in .github/workflows/ci.yml and appears in GitHub Actions as Validate.
- Kind:
documentation - Source path:
docs/ci-verification.md - Object ID:
em:documentation:sha256:7d40369d2fffe5da6c71035371c870fb74f1a75e7710b6f9bab3b97d4c1dbfd5 - Content digest:
32d80c474aaf57128d7c2450080f8eb562f3e8786c8211edeff1f864734c6be0
Autonomous Governance
Epistemedia governance controls procedure, authority, admission, resources, disclosure, and interoperability. It does not vote propositions into universal truth.
- Kind:
documentation - Source path:
docs/governance.md - Object ID:
em:documentation:sha256:f4b7f1ab01b96177383f211aef554aff3ed69f9fb56dbc09fe2a2fc1886eb53a - Content digest:
2b2e73ec9cad599e976a35c3c31479d47adee72e341f9a854f0e484787dabaaa
Human and Agent Interface Contract
Epistemedia does not maintain separate editorial truths for people, API clients, MCP agents, and local tools. Each interface adapts one disclosure-safe catalog and projection manifest.
- Kind:
documentation - Source path:
docs/interfaces.md - Object ID:
em:documentation:sha256:5600741764a7b3f15581645b442c3694562be191230e0acb8104f74c8c9694a2 - Content digest:
29d1eddb3792fa92efb04fbb6a17da89ba0e58fa79233f769fe435c0fe71478d
Launching and Engaging with Epistemedia
Start at the human site and choose a topic. A topic page is a reproducible projection, not an anonymously edited canonical article. Inspect its lens, realm, frontier, policy, source objects, and manifest. Switch lenses to compare a coherent overview with evidence-first, skeptical, frontier, historical, pedagogical, or
- Kind:
documentation - Source path:
docs/launch.md - Object ID:
em:documentation:sha256:132c8bebe37109788249ab6278506f8ea9261ccd50946fc3405c9e62a947012f - Content digest:
68d97e21e55494fcb954bf02bc7cb81b68987a3cb60d6fb23deb59a71cf89c3a
Pre-public owner handoff
Archived bootstrap handoff. The repository-publication and protected-contribution steps below are complete. The default-hostname Pages bootstrap is also live. Use ops/activation/2026-08-22-pages-bootstrap.md for current evidence and remaining owner boundaries.
- Kind:
documentation - Source path:
docs/pre-public-owner-handoff.md - Object ID:
em:documentation:sha256:859e311841076405f0ed54de7e344977e19081494c06c5bde44fb4877fb1d7ad - Content digest:
6c55e03eca8ff7f0a58cbdd71c707de6bb2c52dccc72f967d2c5059fed2a46e9
Epistemedia Roadmap
Compile the repository’s own architecture, governance, tasks, code, tests, and releases through the same public catalog used by every interface. Establish deterministic identity, disclosure safety, and agent-native operation.
- Kind:
documentation - Source path:
docs/roadmap.md - Object ID:
em:documentation:sha256:2f1a4a7ef2d8194d184f06a300251ba055541be0029e1ca0ddef5a299063d4c5 - Content digest:
bcb6525b2343b8dd203b3a89fccdae5c5330d12313d061e31f03eac88a4ca8d4
Init
"""Epistemedia: knowledge that can show its work."""
- Kind:
implementation - Source path:
src/epistemedia/__init__.py - Object ID:
em:implementation:sha256:880fd165080ee9d859226edd48a75bf50ac03a153f1c48598f571b431f82ab03 - Content digest:
15fa2c13924de865c6f9292e81f2960f35fcf5f4c448ed20694146c3144ee586
Main
from .cli import main
- Kind:
implementation - Source path:
src/epistemedia/__main__.py - Object ID:
em:implementation:sha256:dd65d0d3cec82a14c2a6f7e1ee38beeaae75a489455713f72c8d66ff241b4252 - Content digest:
935a1c1166b0c1ea35a82256345000bf2c73ded718d77773bc27a71ecce28f7d
Check
"""One local and CI validation contract for accepted repository candidates."""
- Kind:
implementation - Source path:
src/epistemedia/check.py - Object ID:
em:implementation:sha256:0a219a04d2f463b59beb167c74f24f4822e9145e47f7bef517412eea1d016744 - Content digest:
ed730858f301bada95de37bbd48ed60402c264e7df7b34f4ce677f478cebd583
Cli
from __future__ import annotations
- Kind:
implementation - Source path:
src/epistemedia/cli.py - Object ID:
em:implementation:sha256:d141781be5a19bc729a16e99a7fa5a447acf801ae8df474ea3895ce0fec49569 - Content digest:
fbac8a9830034e606bd40cf71ea69932100759367dd5aa9cf8d4ee3ff036c8a1
Init
"""Stable package facade for the Epistemedia core.
- Kind:
implementation - Source path:
src/epistemedia/core/__init__.py - Object ID:
em:implementation:sha256:f28fb4711ae59929702bcf8d05ec7b19faba416ec0e6c0d2ca12c86e0a50d389 - Content digest:
87a6e166541f8d7fb06b792162ed9edbf2e2d22b82c901942f8aea7054abc9d1
Core
from __future__ import annotations
- Kind:
implementation - Source path:
src/epistemedia/core.py - Object ID:
em:implementation:sha256:1bcc364f8fa946b404e06d28b51aecdcdf32008a697348a13bfb7138619d70f2 - Content digest:
1ffd858df9c0923e0fe62c58be3cf0e1e744d623b1e249f70d608f08f3fe96eb
In an editable checkout this is the repository root. In an installed wheel it is merely a
"""Lazy compatibility package for the ASGI gateway.
- Kind:
implementation - Source path:
src/epistemedia/server/__init__.py - Object ID:
em:implementation:sha256:85f4e28a6a876c082c7b7e6201529b2e9d9c3256e0ae02c03306ee3e47602b9d - Content digest:
0161a354ed8def0bb0f5db6f9196b6960b7946600a51d94afff0364555209068
Server
from __future__ import annotations
- Kind:
implementation - Source path:
src/epistemedia/server.py - Object ID:
em:implementation:sha256:e386834b9d71cc46e3c4d566efe24c4da0f0fc8b5e8dff607d2ef35291a8702d - Content digest:
aff71387dc313b0654475dfa618013f7419d15dbc37b295550458508d91bb43e
Test Container Contract
from __future__ import annotations
- Kind:
test - Source path:
tests/test_container_contract.py - Object ID:
em:test:sha256:a8a23e707d8452593eaafba1e5d9648960640c4fbab7d22663d566e589b05346 - Content digest:
51bb66a641d0036abbfe7e6fa7be9314c58f649a238becdf93db14345bb57308
Test Installed Package
from __future__ import annotations
- Kind:
test - Source path:
tests/test_installed_package.py - Object ID:
em:test:sha256:2e4bcd563729997b7d2d256e2f5e2dfbbbddb7c750504030d725d58f03fe8980 - Content digest:
5b24dbad2f3718e8212f722a1ad5c7fd9a544200d34747e666d185cec16b20e4
Test Interfaces
from __future__ import annotations
- Kind:
test - Source path:
tests/test_interfaces.py - Object ID:
em:test:sha256:f83a5320c78c6c32936c96d4e6b798cca189024621d0804e288743b93d909452 - Content digest:
e886d1101c7444eb0add9afc2dc598b867a35881883c552bd174e55526f242ee
Test License
from __future__ import annotations
- Kind:
test - Source path:
tests/test_license.py - Object ID:
em:test:sha256:b019d0a8d15fb08b000b90c4b84d09fe2c76d8c8973aaa073917b5ad44f46a68 - Content digest:
ac06ef40683e4b97b3e41163c668a0564d701caefb033d05bc4cf92b12bf778f
Test Workflow Security
from __future__ import annotations
- Kind:
test - Source path:
tests/test_workflow_security.py - Object ID:
em:test:sha256:8175d09dc7cc53662b10cc3ce7aaf372fdc996994419a19d9b151e3b48cc7da8 - Content digest:
42a76df5d5e5c9408d5e3f4d270fce7ea887f47d03cc09e0b9f9339e4322d179
Projection manifest
- Projection:
em:projection:sha256:a68a6df53b3221a786507f3ba48384cc341f13743de61b20f713fdc0ec6bf431 - Catalog:
em:catalog:sha256:111ab89d8bea7ca893d8873cf7357bc48b8a374eeeb12959a4ae447d461f2246 - Evidence frontier:
em:frontier:sha256:7d5c69ddb6a5b56f3286b94a8e550df79fc86a0ed27eabd3f5780e3d510fa690 - Accepted commit:
091d3fce01e930424352e5639e5bca06cdd02fca - Epistemic policy:
commons-balanced-v0.1 - Disclosure policy:
public-noninterference-v0.1 - Compiler:
epistemedia/0.2.0