---
title: "mathlib-http — Mova code model"
description: "Mova code model of tools/mathlib/src/http.rs: components with their labels, obernants and the model text."
url: "https://groupants.elamur.ai/free/en/mova/tools/mathlib/src/http.rs.groupant/"
---
Elamur: [Mova](https://md.mova.elamur.ai/free/en/) · [Dictionary](https://md.dictionary.elamur.ai/free/en/) · [Research](https://md.research.elamur.ai/free/en/) · **Groupants**

This page as HTML: <https://groupants.elamur.ai/free/en/mova/tools/mathlib/src/http.rs.groupant/>

# mathlib-http

The groupant beside tools/mathlib/src/http.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

- **kind:** groupant
- **status:** partial source bound model
- **source:** [`tools/mathlib/src/http.rs`](https://github.com/ElamurAI/mova-free/blob/main/tools/mathlib/src/http.rs)
- **source SHA-256:** `3df63f2ba1d7bcdb…`
- **repository folder:** [`tools/mathlib/src/http.rs.groupant`](https://github.com/ElamurAI/mova-free/tree/main/tools/mathlib/src/http.rs.groupant)
- **repository commit:** `855da7bd4a7b`

> **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 | `model.md` |
| **ast** | partial | `syntax.json` |
| **composition** | partial | [Composition](#composition) |
| **cost** | partial | [invariant-and-cost](#invariant-and-cost) |
| **descriptant** | present | [descriptant](#descriptant) |
| **invariant** | partial | [invariant-and-cost](#invariant-and-cost) |
| **tests** | bounded checks | [tests](#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](#behavior-complement) |
| `reverse_reconstruction` | reverse_reconstruction | partial source derived model | [reverse_reconstruction](#reverse-reconstruction) |
| `percent_codec` | percent_codec | partial source derived model | [percent_codec](#percent-codec) |
| `download_commit` | download_commit | partial source derived model | [download_commit](#download-commit) |
| `clock_projection` | clock_projection | partial source derived model | [clock_projection](#clock-projection) |
| `df_output_projection` | df_output_projection | partial source derived model | [df_output_projection](#df-output-projection) |

## Parts

- [mathlib-http-codecs](https://md.groupants.elamur.ai/free/en/mova/tools/mathlib/src/http.rs.groupant/codecs.groupant/)

## Model text


### descriptant

#### mathlib-http

Polite gates each GET by elapsed time, returns nested transport/status results, reads text lossily or downloads through .part with content-length/stream cap, rolling hashes, sync and rename. Helpers hex/encode/civil/free_bytes project bytes, time and df output.

##### 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

Polite gates each GET by elapsed time, returns nested transport/status results, reads text lossily or downloads through .part with content-length/stream cap, rolling hashes, sync and rename. Helpers hex/encode/civil/free_bytes project bytes, time and df output.

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

### Composition

Polite gates each GET by elapsed time, returns nested transport/status results, reads text lossily or downloads through .part with content-length/stream cap, rolling hashes, sync and rename. Helpers hex/encode/civil/free_bytes project bytes, time and df output.

Scoped children isolate the declared contiguous source intervals. Their operations compose only where the source calls them; costs of overlapping parent/child descriptions are not added twice. Remaining effect paths retain explicit gaps.

### catalog

### behavior_complement

Subject: mathlib-http, source SHA-256 3df63f2ba1d7bcdb4f0bf02fa7c7a1f0feb5817d22f7409456945ccf6a57aa32; finite transition observation.

Known Content-Length>limit cannot create the .part file. Stream overflow cannot return Fetched. Non-2xx cannot be silently retried inside Polite. Network and filesystem failure paths are source-derived, not exercised.

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.

Evidence: tests.md identifies executed helpers and unexecuted paths. No universal guarantee follows from the finite fixtures.

### reverse_reconstruction

Subject: mathlib-http, source SHA-256 3df63f2ba1d7bcdb4f0bf02fa7c7a1f0feb5817d22f7409456945ccf6a57aa32; finite transition observation.

hex has unique byte inverse on even lowercase hex strings; encode is injective on UTF-8 bytes with canonical percent escapes. Lossy UTF-8 text has many compatible raw byte antecedents; Fetched metadata cannot reconstruct response body uniquely.

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.

Evidence: tests.md identifies executed helpers and unexecuted paths. No universal guarantee follows from the finite fixtures.

### percent_codec

Subject: mathlib-http, source SHA-256 3df63f2ba1d7bcdb4f0bf02fa7c7a1f0feb5817d22f7409456945ccf6a57aa32; finite transition observation.

Unreserved ASCII bytes survive; every other byte becomes uppercase %HH, so existing '%' is encoded again. Non-ASCII encoding follows UTF-8 bytes, not Unicode scalar values. Actual byte_codecs_and_civil_boundaries covers this.

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.

Evidence: tests.md identifies executed helpers and unexecuted paths. No universal guarantee follows from the finite fixtures.

### download_commit

Subject: mathlib-http, source SHA-256 3df63f2ba1d7bcdb4f0bf02fa7c7a1f0feb5817d22f7409456945ccf6a57aa32; finite transition observation.

Headers read before file creation; body chunks counted before cap, then hashed and written. sync precedes last timestamp and rename. Write/sync/create failures may leave temp artifacts or stale pacing timestamp.

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.

Evidence: tests.md identifies executed helpers and unexecuted paths. No universal guarantee follows from the finite fixtures.

### clock_projection

Subject: mathlib-http, source SHA-256 3df63f2ba1d7bcdb4f0bf02fa7c7a1f0feb5817d22f7409456945ccf6a57aa32; finite transition observation.

civil uses Euclidean 400-year eras; valid bounded days map Gregorian dates including negative epoch days. utc_now clamps pre-epoch SystemTime error to zero. Delay timing is not tested; civil fixtures are exact.

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.

Evidence: tests.md identifies executed helpers and unexecuted paths. No universal guarantee follows from the finite fixtures.

### df_output_projection

free_bytes invokes df -B1 --output=avail, ignores child status and parses only the second stdout line as trimmed u64. A successful status with missing second line errors, while a failed status with numeric second line may return Ok. This process helper remains unexecuted here.

Subject and source identity: manifest.json. Domain: scoped forward/invariant; relation is source-derived and partial. Evidence: tests.md distinguishes actual checks from unexecuted effect paths; finite fixtures do not prove all inputs.

### tests

#### Bounded evidence

Selected actual source checks:

- mathlib::http::tests::encodes_and_dates
- mathlib::http::wave33::byte_codecs_and_civil_boundaries

These checks are file-level evidence; fragment branches not reached by these names remain source-derived.

External wave33 mathlib receipt retains native-commands.json, numeric statuses, raw debug/release logs, sorted exact outcomes, mutation logs and original/restored hashes. Seventeen named checks pass twice per profile; six production behavior mutants reject in both profiles, with restored positives. Source syntax is regenerated twice after formatting and compared byte-for-byte. Structural validation tests bindings, not Rust semantics.

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%.

### invariant-and-cost

#### Invariant and cost

##### Invariant

Status bodies are capped at 4096 bytes; text bodies have no cap. download succeeds only after bytes<=limit, sync and rename. Error cleanup and pacing reset are branch-specific, not uniformly guaranteed.

##### Cost

hex O(n) output 2n; encode O(n) output n..3n UTF-8 bytes; download streaming O(B) and 64 KiB buffer plus hashes. text retains full body. sleep/HTTP/filesystem/df costs external.

##### Domain and gaps

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%.