roundtrip-block-reporting
The groupant beside tools/roundtrip/src/blocks/run.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 |
| composition | partial | composition |
| cost | symbolic source derived | invariant-and-cost |
| descriptant | present | descriptant |
| invariant | partial | invariant-and-cost |
| tests | executed 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 |
zero_denominator | zero_denominator | partial source derived model | zero_denominator |
metadata_partition | metadata_partition | partial source derived model | metadata_partition |
upper_median | upper_median | partial source derived model | upper_median |
effect_prefix | effect_prefix | partial source derived model | effect_prefix |
Parts
Model text
descriptant
Description and epoch memory
run_blocks chunks 512 references, executes shape transform/pipeline with par_each, converts errors to red Tally, and merges in order. row projects exact and damaged with equality to one. Numeric/report helpers aggregate residual cells, exclude Meta from totals and use upper median. main installs optional globals, parses flags, creates output, loads corpora then model, runs plans and writes reports sequentially.
Epoch 2026-10-31
Prospective model retained externally before edits. Existing production bytes preserved; only bounded inline tests appended to six owned files. Models distinguish byte reconstruction with residual from semantic understanding and persistent learning. Finite tests and compiled mutants support selected boundaries only. Source inspection identified noninjective projections and explicit admissibility restrictions; no bug repair or performance claim.
Combiner input is this source snapshot, syntax projection, models, costs and retained receipts. Proposed next epoch: target the stated unexecuted branches with bounded witnesses before expanding any claim. AST remains partial, macros opaque; no name resolution or proof.
approximant
Forward relation
run_blocks chunks 512 references, executes shape transform/pipeline with par_each, converts errors to red Tally, and merges in order. row projects exact and damaged with equality to one. Numeric/report helpers aggregate residual cells, exclude Meta from totals and use upper median. main installs optional globals, parses flags, creates output, loads corpora then model, runs plans and writes reports sequentially.
Domain: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
No executable percentage surrogate is supplied: these categorical codec/effect observations have no justified lossy metric. Future caps are 1/2/5/10% only after defining metric, zero behavior and differential reference.
composition
Local composition
run_blocks chunks 512 references, executes shape transform/pipeline with par_each, converts errors to red Tally, and merges in order. row projects exact and damaged with equality to one. Numeric/report helpers aggregate residual cells, exclude Meta from totals and use upper median. main installs optional globals, parses flags, creates output, loads corpora then model, runs plans and writes reports sequentially.
Children scope selected internal mechanisms by byte ranges; remaining branches are covered only by the parent partial model. Their costs are included in parent costs, not added again. Shared values and caller order are those named above; sibling fragments are tagged independent where no direct call is named.
catalog
Source-bound typed models
Each section is a partial source-derived relation on the bound snapshot and declared domain; finite checks are falsification evidence, not a universal proof. Observation horizon is one call unless history is explicitly named.
behavior_complement
Meta does not contribute total_bits, per(x,0) is zero, row exact_ok=2 is false. Errors from jobs cannot count as exact successes. Outputs are not transactional: later write failure can leave earlier files.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
reverse_reconstruction
Rows erase Tally examples, most counters and provenance; compatible tallies share projected fields and exact/damaged predicates. Rounded tables admit intervals of f64 values and cannot uniquely recover cells. Earlier files alone do not establish successful final report.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
zero_denominator
per(x,0)=0 even for x nonzero; finite n>0 gives x/n.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
metadata_partition
rbits(meta=true) selects only Meta, false selects only non-Meta; optional layer narrows both.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
upper_median
sorted[v.len()/2], empty=0; even case selects upper middle.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
effect_prefix
Optional global tables precede numeric flags; directory creation precedes corpus/model load; write failure leaves completed prefix.
Domain and held state: Finite residual f64 and representable integer counts; volume exact_ok<=volumes for report subtraction. Private helper tests supply synthetic data; model, corpus and report-write CLI paths not executed.
Status: partial source-derived model. Oracle: the named scoped tests in tests.md; unexercised branches remain inspection hypotheses.
tests
Actual checks
blocks::run::wave32::row_numeric_partitions
The listed parent/source tests exercise only their named mechanisms; other model statements are source inspection. Sixteen selected actual roundtrip library tests passed twice debug and twice release (64 exact-name executions), with identical sorted test outcomes. Eight compiled production-behavior mutants, one per source, failed assertions; exact originals were restored and the selected check passed. No assertion-only mutants or surviving compiled mutants. An initial mutation selector was ambiguous and stopped before writing that source; corrected selector retained separately.
Raw logs, numeric statuses, original/restored hashes, prospective.md, native-commands.json and syntax pairs: $MOVA_DATA/runs/octopus-wave32-rt_blocks-2026-10-31. No live model/corpus/site/learning workflow or full pipeline was executed.
invariant-and-cost
Invariants and cost
Meta does not contribute total_bits, per(x,0) is zero, row exact_ok=2 is false. Errors from jobs cannot count as exact successes. Outputs are not transactional: later write failure can leave earlier files.
Rows erase Tally examples, most counters and provenance; compatible tallies share projected fields and exact/damaged predicates. Rounded tables admit intervals of f64 values and cannot uniquely recover cells. Earlier files alone do not establish successful final report.
Cost
row O(cells), lbits O(cells), total_bits four cell scans. median O(B log B) time/O(B) owned buffer. Reporting loops corpora×layers×classes and sorts cell tables; orchestration costs pipeline jobs plus retained rows and serialized output bytes.
Integer additions/products and allocation sizes must fit native types. Floating costs require finite values; no throughput or all-input guarantee follows from synthetic tests.
This page in Markdown → https://md.groupants.elamur.ai/free/en/mova/tools/roundtrip/src/blocks/run.rs.groupant/