Integrations
One repository.Every interface.
The same repository state reaches the command line, the HTTP API under /api/v1/, Swagger UI, the Cockpit, MCP and this site. Each capability is declared once: its HTTP route, OpenAPI operation and MCP tool are built from that declaration, and the command line is checked against it.
“A command is declared once, and every surface that shows it is a projection”
prismatic-majordomus
What the snapshot is read from, and who reads it
- .git/branch, head, working tree
- .ai/187 rules, 117 decisions, 8 skills
- apps/the Rust executable
- docs/manuals and generated documents
- share/schemas, design, kinds
- test/527 test objects
RepositoryEnvironment
one snapshot of this checkout, each value with where it came from
- projectidentity and release
- version controlbranch, head, working tree
- toolchainswhat the checkout declares
- the layerobjects counted per kind
- servicesthe address a server published
Seven interfaces, one real thing each
The environment snapshot where an interface serves it, and what each of the others is for
CLI
# Majordomus context — <time> # a projection of durable state, not a source of truth: validate every line against git ## GIT repository <repo> branch main head <sha> working_tree dirty task_record exact (recorded head <head>) ## TASK id t-<id> task narrow the parser profile implementation
A transcript the generator recorded. For the snapshot itself: majordomus env — What this checkout is: the project, version control, the toolchains it declares, what the layer holds, the workflows, the provider projections and the local services.
API
/api/v1/environment
One snapshot of this checkout: project identity, repository identity, version control, declared toolchains, what the layer holds counted per kind, the workflows the runner describes, the provider projections against the policy that renders them, and the local services with the address a running server published. Every value carries where it came from.
curl -s "http://127.0.0.1:8741/api/v1/environment?probe_services=false"
Swagger
Serve the same capabilities over HTTP on the loopback interface, with the home page, /openapi.json, /swagger and the documentation under /docs/. The operations of the environment tag, as the OpenAPI 3.1.0 document describes them:
GET/api/v1/environmentThe repository environment
One snapshot of this checkout: project identity, repository identity, version control, declared toolchains, what the layer holds counted per kind, the workflows the runner describes, the provider projections against the …
GET/api/v1/environment/explainWhere an environment value came from
The provenance of the snapshot: for each field, what decided it — a compile-time constant, a file, a command, or the cache — which resolver read it, and how far it can be trusted. Narrow it to one field, or to a prefix, …
GET/api/v1/environment/preflightWhether Majordomus is in force here, and what proves it
One verdict per claim about this checkout — git; the episode, its briefing, the task and the handover; the policy, the rule corpus and the ADRs; the shared server and the MCP, API and Cockpit surfaces it serves; the peer…
Cockpit
/api/v1/dashboard/overview
The Cockpit at /cockpit asks the same server for its pages. Its overview: the overview: four questions.
majordomus dashboard overview
MCP
Serve the repository's AI layer to an MCP client over stdio: 192 tools and 55 resources. The snapshot is one tool and one resource.
-
majordomus_environmenttool · The repository environment
-
majordomus://environmentresource · environment
majordomus mcp
Docs
This site is built from the repository and published on GitHub Pages. The pages of it that describe the snapshot:
CI
/api/v1/gates
The CI model: Every validation gate this repository declares — the job that runs it, the command it runs, what it proves, whether every plan selects it and whether its runner can be had on demand at all — with the path classes that decide which change se…
Surfaces
Where each one lives
- One sourcethe layer under .ai/
- Deterministicgenerate --check is the byte-for-byte verdict
- Discoveredtracked files, through the git index
- For agents too192 MCP tools, 55 resources
- Extensiblea capability is declared once and projected