The shelf

Claims about compute, filed side by side with their conditions, evidence and limits. Cards, a dependency-free checker and an import rule let readers compare records without treating them as rankings.

This page runs in your browser from committed plain text. The same checks run from the command line with python shelf.py; shared examples and generated boundary cases keep both engines aligned.

What is on it

Each card records the claim, conditions and period; population, denominator and acceptance rule; observers, control, access, payment and observer benefit; available materials; and three separate checks for inspection, recomputation and independent repetition. Measured, imported, modeled and attributed are separate flags, with unknown represented as null.

hub	card	spine	M I Mo A	inspected / recomputed / repeated

M = measured, I = imported, Mo = modeled, A = attributed. + true, - false, ? unknown. Flags describe the card's own evidence; they do not rate it.

Which cards can support a question?

State the required unit, period and measurement basis. The checker reports whether a card supports that reading within its recorded limits and checks, and identifies the rule when it cannot.

Check a filing

Paste a card to check its required fields, publication-date basis, observer-benefit record and explicit hourly units. The checker describes the record; source warrant, disclosure completeness and truth remain matters for review.

Compose two cards

Records combine when identities, periods, scopes and assumptions agree. Pick two cards and a purpose; the engine reports the applicable rule and whether the declared combination clears its checks; admission remains a separate decision.

File a card

Start from card.skeleton.json or copy the five sections from a relevant card, then cite the material that supports each populated value. The normative format is in SPEC.md. Three rules catch most first filings:

Dates. publication_date is null unless the source establishes publication, and it needs a publication_date_basis. retrieved_at records when you obtained the source. Experiment, artifact, index and publication dates are separate; retrieval never fills one of them.
Price units. USD / GPU-hour for one GPU's hourly price, USD / seat-hour for a whole configuration with its GPU count in conditions.gpus. USD/hour is ambiguous and refused. Accepted-work prices use USD / 1000 accepted requests. A starting price is a lower-bound offer, not an obtainable seat or a measured cost.
Observer benefit. c_parties.observer_benefit records whether the observer benefits from the outcome (true, false or null), the relationship, and the basis. A known judgment needs a basis. Funding and benefit are different facts. A relationship does not establish misconduct.

To put a card on this shelf, open a pull request that appends a line after the retained seed in shelf/data/cards.jsonl and passes python shelf.py validate. Review checks the cited sources; filing and machine validation do not grant standing.

Run it yourself

git clone https://github.com/BigBirdReturns/axm-tools
cd axm-tools/shelf/scripts
python shelf.py validate ../data/cards.jsonl
python shelf.py which --unit "USD / 1000 accepted requests" --period 2026-09 --measured
python shelf.py compose a.json b.json --for same_period
python shelf.py pull https://example.org/their/cards.jsonl --hub their-name
python -m unittest discover -s ../tests -p 'test_shelf.py'

Python 3.8 or later, standard library only. No package to install, no key, no service.

Hubs

A hub is any URL that serves a cards.jsonl. This page reads the hubs in data/hubs.json. shelf.py pull copies a hub's cards into data/staging/<hub>/<time>/ with the exact bytes, their hash, the time, and each card's filing errors. Imported cards stay candidates. Moving one onto your shelf requires a recorded local decision by an authorized person or procedure, bound to the exact captured input. Source checks remain attributed to whoever performed them; importing does not grant local standing. To list your hub here, open a pull request adding it to data/hubs.json.

Disclosure

On the first hub's run card, Hot Aisle's credit paid for the AMD arm and Hot Aisle is a sales prospect of the shelf's author. The H100 arm was paid in cash. One run per arm, no repeats. The card says so on its spine.