mathlib-oai-state

The groupant beside tools/mathlib/src/oai.rs in the Mova repository: what the code computes, what it never does, how to go back from its outputs, its invariants, cost and checks.

Facts

Implementation material. A Mova code model describes this code at one source revision: partial models, finite checks and their stated scope. It is not a reviewed general exposition, and its labels are shown as written, never raised.

Components

component	label	where
approximant	partial	approximant
ast	partial	`../syntax.json`
cost	partial	invariant-and-cost
descriptant	present	descriptant
invariant	partial	invariant-and-cost
tests	bounded checks	tests

Obernants

The typed relations around the forward model: the behaviour complement (what the code never does), the reverse reconstruction (every input compatible with an output) and specialised views.

id	type	label	where
`behavior_complement`	behavior_complement	partial source derived model	behavior_complement
`reverse_reconstruction`	reverse_reconstruction	partial source derived model	reverse_reconstruction
`count_default`	count_default	partial source derived model	count_default
`terminal_token`	terminal_token	partial source derived model	terminal_token
`line_order`	line_order	partial source derived model	line_order
`header_skip_precedence`	header_skip_precedence	partial source derived model	header_skip_precedence

Model text

descriptant

mathlib-oai-state

If state absent return None; otherwise scan lines, skip short/header rows, parse page strictly, add records with malformed count->0, replace last tuple with current page,total,token.

Epoch 2026-10-31

Prospective model retained before changes. Existing production bytes are preserved; additions are bounded inline tests. Nine source groupants expose ingestion and routing boundaries; typed children bind exact source bytes and reuse their parent syntax projection. Native tests run twice per profile; behavior mutants run as compiled source changes and exact bytes are restored before positive checks.

Important retained observation: network-looking helpers are not all pure (DNS inside github_host and books build); selection deliberately excludes those effects. Mixed-format manifest order is not deterministic, and error paths do not imply rollback.

No network/DNS/download, real catalog/corpus/model/teacher or database execution. Effect paths are source-derived; finite helper tests are not universal verification. No executable percentage surrogate or speed claim; future caps require metric/domain/reference and remain 1/2/5/10%.

approximant

Forward relation

If state absent return None; otherwise scan lines, skip short/header rows, parse page strictly, add records with malformed count->0, replace last tuple with current page,total,token.

Model observations include returns, retained state and ordered partial effects; on external failures the successful-prefix relation replaces a total-function claim.

catalog

behavior_complement

Subject: mathlib-oai-state, source SHA-256 bad99249391507309f3ac75c270b7c802490e1b6ae7f6ffb54460d8790404846; finite transition observation.

Malformed page in a qualifying line cannot produce Ok(last); parse error aborts even if later rows would be valid. Missing file cannot produce a resume tuple.

Domain: stated source predicates, bounded inputs and available resources; arithmetic assumptions and external effect gaps as in the invariant. Operator is the stated relation/projection; complement is a source-derived inner exclusion, reverse retains compatible antecedents. Other views are source-derived partial constraints, not inverse laws.