Elamur Groupantsmacula-library
The groupant beside tools/macula/src/lib.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 | symbolic source derived | invariant |
| descriptant | present | descriptant |
| invariant | partial | invariant |
| 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 |
entity_order | entity_order | partial source derived model | entity_order |
book_order | book_order | partial source derived model | book_order |
verse_join | verse_join | partial source derived model | verse_join |
html_depth | html_depth | partial source derived model | html_depth |
Model text
descriptant
Descriptant
Prospective epoch
2026-10-31 source review predicted: Shared consonants/entity/key helpers, English pool-map join and sorted Hebrew CoNLL-U reader. html_text collects all and named-tag depth text then decodes/collapses whitespace. Exports prag module. Resource model: Codecs O(B); key O(39+bytes). Joins O(R log R), file sorting O(F log F), memory O(B). File failures panic. External prospective.md predates test additions and preserves APIs, effect order, hazards and interaction hypotheses.
Observed epoch
Bounded real helper checks in tests.md constrain these models; syntax is a partial lexical projection with no macro expansion, name resolution or proof. Production expressions unchanged; five inline test modules added. Compiled mutants are temporary and exactly restored. Existing malformed-input and nonfinite domains remain explicit, not silently repaired. Parent composes this scope with siblings without adding overlapping costs twice.
Pure helpers tested; filesystem joins source-modeled.
approximant
Forward relation
Shared consonants/entity/key helpers, English pool-map join and sorted Hebrew CoNLL-U reader. html_text collects all and named-tag depth text then decodes/collapses whitespace. Exports prag module.
Domain: Unknown book->39, bad/missing u32->0, trailing coordinates ignored. consonants keeps05D0..05EA without decomposition. Duplicate ids/verses overwrite in map traversal. HTML depth may become negative.
invariant
Invariant and cost
Invariant
Unknown book->39, bad/missing u32->0, trailing coordinates ignored. consonants keeps05D0..05EA without decomposition. Duplicate ids/verses overwrite in map traversal. HTML depth may become negative.
Cost
Codecs O(B); key O(39+bytes). Joins O(R log R), file sorting O(F log F), memory O(B). File failures panic.
Limits
Pure helpers tested; filesystem joins source-modeled. No percentage surrogate is implemented: categorical parsing/effect observations lack an admitted numerical error metric. Any future profile must define its metric/domain and use only1/2/5/10 percent caps.
models
Typed source-bound relations
Subject: exact source SHA-256 in manifest. Domain and resource premises are in invariant.md. Each model is partial, source-derived, over a single helper invocation or the described finite trace. Complements are proposed inner exclusions under those premises; reverse relations retain all compatible antecedents, with no unique inverse claim. The oracle is the named checks in tests.md; unexecuted cases remain hypotheses. No numerical approximation certificate.
behavior_complement
Consonants excludes Latin/points. Ordered unescape cannot recursively turn < into<. Multi-verse metadata excluded from hebrew_verses. No teacher effect.
reverse_reconstruction
Consonants admits arbitrary removed chars, HTML admits erased markup/whitespace, key(39,0,0) admits malformed names/numbers. Joins lose duplicate overwritten values.
entity_order
lt/gt/quot/apos before amp; revealed ampersands not reprocessed. Exact codec test binds behavior.
book_order
MACULA BOOKS differs from tanakh BOOKS; join requires code mapping, cannot transfer ordinal blindly.
verse_join
Pool id last-write wins; .verses input order appends matched sentences with spaces, missing ids skipped, mapping duplicates retained.
html_depth
Exact tag or tag+space increments; close decrements and marked space; unmatched close may suppress later content. Full text concatenates across tags.
tests
Checks and evidence
Named source/helper checks: wave31::text_and_coordinate_fibers, tests::verses.
Wave31 on2026-10-31:30 distinct exact tests passed twice debug and twice release, with equal sorted named outcomes. This node claims only its listed subset; empty subset means source review only. Six actual source-behavior mutants compiled, failed assertions, restored exact bytes/hash, and passed focused green reruns. No assertion-only mutants; existing swapped-input controls are separate. Receipt bundle: $MOVA_DATA/runs/octopus-wave31-corpus-2026-10-31 (native-commands.json, source-test-map.json, mutation-results.json, .status/.log). No live corpus, teacher, frozen assessment, download or production data used.
Pure helpers tested; filesystem joins source-modeled.
This page in Markdown → https://md.groupants.elamur.ai/free/en/mova/tools/macula/src/lib.rs.groupant/