Skip to content

The Observatory: the repository and its mesh, drawn for a wall

One screen of the UI rotates eight scenes on a display nobody is sitting at, and every mark on it is a value a capability answered; a scene with nothing true to draw says why and is never drawn empty.

status
feature status: stable
domain
Surfaces
on the homepage
featured

What it does

The other screens of majordomus ui are rows for a person who came to decide something. The Observatory is the same facts as a picture, for a hallway display. It rotates eight scenes: Mesh Cosmos, Event River, Intent Nebula, Token Spectrum, System Pulse, Delivery Tree, Cooperation Choreography and Ambient Intelligence. Each scene names the capabilities it requires, what its marks mean, and the screen where the same facts are rows.

A mark is a fact or it is decoration. A machine, a runtime, an event, a milestone, a health dimension, a release and a session are drawn from what mesh.peers, mesh.events, plan.roadmap, health.report, distribution.releases and mesh.state answered. The drifting background and the slow motion are decoration, and the display says so.

A scene whose source did not answer, or answers that no mesh runs in this process, is unavailable with the source's own reason. The rotation skips it. An event is drawn by its kind, its stream and its clock; its body stays in the capability that owns it.

The status word is true: LIVE while the page was read again within forty seconds, STALE when the server stopped answering, SNAPSHOT on the published site, with the commit it was read at. /ui/kiosk is the same screen, projection and script filling the window.

What it does not do

It adds no capability, no store and no transport: the page carries one bounded projection, and the script asks the server for nothing but that page. It starts no work and writes no record.

On the published site the process that takes the snapshot runs no mesh, so the three scenes of the mesh replay the recording the repository carries, labelled REPLAY with the time it was recorded; the recording is as old as the last capture someone committed. The display follows the journal from a cursor between readings of its page (observatory.events). Its gates are recorded with their evidence in .ai/repo/benchmarks/observatory/manifest.json: screenshots at 1920x1080 and 3840x2160 of the published site, 60 frames per second in headless Chromium on an Apple M5 Pro, no WCAG 2.2 AA violation, reduced motion honoured, an hour-long soak with a stable page, and recovery drills. No physical wall display has been measured.

Why it exists

Operational moments from the Why catalogue that name one of this feature's mechanisms. Nothing here was assigned: a moment appears because it names a rule, a command, a capability or a claim this feature also names.

Every moment it answers (20)

How it works

The capability modules of the executable this feature names, each with the capabilities it composes. The interfaces each one reaches are listed under Interfaces below: they are projections of one declaration, not separate registrations.

Observatory observatory behaviorally verified

What the Observatory may carry to a place where no mesh runs: the mesh scenes this process has live, pseudonymized for publication, and the recording the repository carries, which the published Observatory replays and labels as a replay.

Mesh mesh experimental

The mesh of this process: discovery — authenticated observations of other running Majordomus instances in one registry — and cooperation — authenticated links to trusted runtimes of the same repository, replicating sessions, claims, handovers and reviews through one journal every runtime folds into the same state. Discovery grants nothing; a link is admitted per peer, and nothing a peer sends executes anything here.

The plan and its derivations plan behaviorally verified

The milestone and issue model of this repository, and everything derived from it that nobody authored: the status of each record, the dependency graphs above and below the milestone boundary, the topological execution waves, the roadmap order, the milestone being executed and the one issue to take next. Status is never stored — a record says what happened to it and the status follows from that and from the state of its dependencies — so no file can contradict the graph. This capability reads; writing a lifecycle marker into a record is `plan.transition`, which declares that it writes the repository.

Distribution distribution behaviorally verified

How this project is packaged, published and installed: the platforms a release builds, the artifact names the one naming function derives, the installer's canonical command, the releases that were published, and what this build itself is. Every answer comes from share/distribution.yaml and the release records; no surface here states a fact of its own.

Release release implemented

What this project has shipped and what it would ship next, derived rather than maintained: the changelog composes the layer's release records, the decisions dated inside each release's window and the conventional commits in its range; the version report reads the one place the version is authored and the projection the shell tool prints, and says what the public contract requires it to become — or that it cannot be measured, and so decides nothing — with what the commits since the last release imply beside it as evidence.

Health health behaviorally verified

Whether what this process serves is healthy, decided by the engines that already decide it: the index's diagnostics, the registry builder, the benchmark projection's coverage, the comparison `generate --check` makes and the lease reading `server.status` answers from. No check here has an opinion of its own.

Token economics economics behaviorally verified

What a coding session consumes with Majordomus installed and without it, from recorded runs: matched control and treatment sessions judged by the same hidden acceptance tests, the provider's usage as it reported it, and every number labelled with its measurement class (observed, counted, derived, estimated, counterfactual). One calculator; every surface is a projection of it, and the verdict states only what the methodology's publication rule allows.

Repository repository behaviorally verified

The repository this process serves: its layer, its git state, the state of the index built from it, and its scope: what a worker reads of it and what it never reads.

Served deployments served behaviorally verified

Whether a deployment serves the commit it was meant to: the build identity a site serves, read from outside the way a visitor reads it, judged by commit containment and recorded so that a later reader can re-judge it. Only `served` passes; a site that could not be reached, an identity that could not be read, a build from an uncommitted tree and a served commit this clone does not hold are each an unanswered question, never a yes. Observing reaches the network and is a command of the trusted command line; reading the recorded standing is a read on every surface.

The objects it is made of

Kinds of the layer. Each is a schema, a source class and a file on disk; the number beside it is what this repository holds today, counted at build time.

  • deployment1

Where it sits

domain
Surfaces — One declaration in the repository becomes the command line, the HTTP API, MCP, the UI, the Cockpit, the documentation and this site, and a projection that disagrees with it fails the build.
areas of work
observability
names
UICockpit

Interfaces

Each capability behind it, on every interface it is projected onto. A link goes to this site's reference for that interface; an HTTP route and an MCP tool are answered by a running majordomus serve, not by this site.

The capabilities behind this feature, by interface
capabilitycommand lineHTTPMCP tool
observatory.capture —none GET /api/v1/observatory/capture majordomus_observatory_capture
observatory.events —none GET /api/v1/observatory/events majordomus_observatory_events
observatory.replay —none GET /api/v1/observatory/replay majordomus_observatory_replay
mesh.claim —none POST /api/v1/mesh/claims majordomus_mesh_claim
mesh.cooperation —none GET /api/v1/mesh/cooperation majordomus_mesh_cooperation
mesh.doctor majordomus mesh doctor GET /api/v1/mesh/doctor majordomus_mesh_doctor
mesh.events —none GET /api/v1/mesh/events majordomus_mesh_events
mesh.firewall majordomus mesh firewall GET /api/v1/mesh/firewall majordomus_mesh_firewall
mesh.firewall.apply majordomus mesh firewall apply —none —none
mesh.handover.consume —none POST /api/v1/mesh/handovers/consume majordomus_mesh_handover_consume
mesh.handover.publish —none POST /api/v1/mesh/handovers majordomus_mesh_handover_publish
mesh.identity majordomus mesh identity GET /api/v1/mesh/identity majordomus_mesh_identity
mesh.link.hello —none POST /api/v1/mesh/link/hello —none
mesh.link.sync —none POST /api/v1/mesh/link/sync —none
mesh.nodes —none GET /api/v1/mesh/nodes majordomus_mesh_nodes
mesh.peer —none GET /api/v1/mesh/peer majordomus_mesh_peer
mesh.peers —none GET /api/v1/mesh/peers majordomus_mesh_peers
mesh.register —none POST /api/v1/mesh/register majordomus_mesh_register
mesh.release —none POST /api/v1/mesh/claims/release majordomus_mesh_release
mesh.review.answer —none POST /api/v1/mesh/reviews/answer majordomus_mesh_review_answer
mesh.review.request —none POST /api/v1/mesh/reviews majordomus_mesh_review_request
mesh.review.withdraw —none POST /api/v1/mesh/reviews/withdraw majordomus_mesh_review_withdraw
mesh.session.close —none POST /api/v1/mesh/sessions/close majordomus_mesh_session_close
mesh.session.open —none POST /api/v1/mesh/sessions majordomus_mesh_session_open
mesh.state —none GET /api/v1/mesh/state majordomus_mesh_state
mesh.status —none GET /api/v1/mesh majordomus_mesh
mesh.verify —none POST /api/v1/mesh/verify majordomus_mesh_verify
plan.issues —none GET /api/v1/plan/issues majordomus_plan_issues
plan.model —none GET /api/v1/plan majordomus_plan
plan.next —none GET /api/v1/plan/next majordomus_plan_next
plan.record —none GET /api/v1/plan/record majordomus_plan_record
plan.roadmap —none GET /api/v1/plan/roadmap majordomus_plan_roadmap
plan.status —none GET /api/v1/plan/status majordomus_plan_status
plan.transition —none POST /api/v1/plan/transition majordomus_plan_transition
plan.validate —none GET /api/v1/plan/validate majordomus_plan_validate
plan.waves —none GET /api/v1/plan/waves majordomus_plan_waves
distribution.artifact majordomus distribution artifact GET /api/v1/distribution/artifact majordomus_artifact
distribution.build majordomus distribution build GET /api/v1/distribution/build majordomus_build
distribution.model majordomus distribution show GET /api/v1/distribution majordomus_distribution
distribution.releases majordomus distribution releases GET /api/v1/distribution/releases majordomus_releases
distribution.status majordomus distribution status GET /api/v1/distribution/status majordomus_install_status
release.analysis —none GET /api/v1/release/analysis majordomus_release_analysis
release.changelog —none GET /api/v1/changelog majordomus_changelog
release.next —none GET /api/v1/release/next majordomus_release_next
release.version —none GET /api/v1/release/version majordomus_release_version
health.live —none GET /api/v1/live —none
health.ready —none GET /api/v1/ready —none
health.report —none GET /api/v1/health majordomus_health
economics.check majordomus economics check GET /api/v1/economics/check majordomus_economics_check
economics.explain majordomus economics explain GET /api/v1/economics/explain majordomus_economics_explain
economics.runs majordomus economics runs GET /api/v1/economics/runs majordomus_economics_runs
economics.summary majordomus economics summary GET /api/v1/economics majordomus_economics
repository.info —none GET /api/v1/repository majordomus_repository
repository.scope majordomus scope GET /api/v1/scope majordomus_scope
repository.scope_classify —none GET /api/v1/scope/classify majordomus_scope_classify
served.forge majordomus served forge —none —none
served.observe majordomus served observe —none —none
served.show majordomus served show GET /api/v1/served majordomus_served
served by the executable
/ui The delivery, for a person: majordomus ui

Evidence

What is guaranteed

Each claim this feature names, with the status its row declares, the verdict the recorded runs support, and the test that settles it.

The rules that hold it

  • blocking An interface shows only what is derived, and unknown is never drawn as healthyproject.ui-derived-state
  • blocking External interfaces are projections of one capability definitionproject.interfaces-are-projections

The decisions behind it

Using it

From the executable's command line

The synopsis of each, as the executable's own help prints it.

Where this page comes from

the file
.ai/repo/features/observatory.md
the same answer
majordomus product show observatory

Searches the titles and descriptions of every page this site publishes.