Token economics, measured from matched runs and never typed

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.

Where it sits

domain

Evidence — A claim names the test that settles it, a recorded run is judged against the commit it ran at, and a claim with no recorded run says so.

areas of work

observabilitycost

names

ModelsEvidence

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.

in the Cockpit, of a running server

/cockpit/economics Economics

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.

• ○declared status: guaranteed ○recorded evidence: not run What the context compiler selects, out of what it judged relevant, is counted in tokens of a named tokenizer and recorded, never estimated test/cases/430_economics.sh
• ○declared status: guaranteed ○recorded evidence: not run A quantity about tokens, context or cost typed into hand-written prose is refused, and a claim bound to a metric cannot be guaranteed while its evidence does not stand test/cases/431_economics_claims_gated.sh
• ○declared status: planned ○recorded evidence: no test Majordomus will state a total-token change only from matched, verified runs that meet the methodology's publication rule

The decisions behind it

• adr-0082Token economics are measured from matched runs and published only past a declared rule proposed

Using it

From the executable's command line

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

• majordomus economics summary [OPTIONS]

  Every metric with its class, sample size and interval, the pairs, the segments, the state of the evidence, and the one statement the publication rule allows

• majordomus economics explain [OPTIONS] <METRIC>

  One metric and everything it rests on: formula, class, pairs, runs, exclusions, and how to reproduce it

• majordomus economics runs [OPTIONS]

  The recorded runs every metric is computed from

• majordomus economics check [OPTIONS]

  Refuse an unsupported savings claim: quantities next to the economics vocabulary in hand-written prose, and bound claims whose evidence does not stand

Where this page comes from

the file

.ai/repo/features/economics.md

the same answer

majordomus product show economics

read further

Economics

Related features

• named by this feature

  Models

  ✓feature status: stable

  One declared catalogue of vendors and models — capabilities, context, lifecycle, no fabricated facts — and a routing answer that names why every candidate was chosen or excluded.

  Explore Models →

• same domain

  Provenance

  ✓feature status: stable

  Who did what, under which task, at which commit, in which session is a ledger the tool writes and a person can read back, not a memory of a conversation.

  Explore Provenance →

• same domain

  Use cases

  ✓feature status: stable

  What a person does with the tool is one file with a scenario the tool runs against itself; the page shows that execution, and a public command no use case runs is a gap the tool reports.

  Explore Use cases →

• named by this feature · same domain

  Evidence

  ✓feature status: stable

  Every claim is joined to the execution recorded for its test — the outcome, the commit, the tree, the digest and the command that produces it again — and a run against this commit is never reported as the same thing as a run whose inputs merely have not changed.

  Explore Evidence →

• same domain

  Benchmarks

  ✓feature status: stable

  Every externally callable operation is timed directly, over MCP and over HTTP, the denominator is generated from the registry, and a regression against the accepted baseline fails the check.

  Explore Benchmarks →