Elamur Groupantshbo-seg-codec
The groupant beside tools/hbo/src/seg.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-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 |
header_defaults | header_defaults | partial source derived model | header_defaults |
row_accumulation | row_accumulation | partial source derived model | row_accumulation |
index_rebuild | index_rebuild | partial source derived model | index_rebuild |
ordered_tables | ordered_tables | partial source derived model | ordered_tables |
Model text
descriptant
Descriptant
2026-10-31, prospective epoch: inspected source before edits and predicted Save options and sorted tables; load adds recognized row counts and indexes lex by unpointed key.
Measured epoch: bounded supplied fixtures passed twice in debug and release; six behavioral mutants were rejected after compilation, each restored exactly. These observations support the scoped equations without extending them to corpus accuracy, semantic understanding or persistent learning. Production code bytes are unchanged; only isolated tests appended. No benchmark or percentage surrogate was introduced.
Retained caveats: Finite supplied-input checks only; no corpus, training, external annotator, GPU, throughput or semantic-understanding claim. Allocation exhaustion and malformed arbitrary model arithmetic are not exhaustively exercised. No useful numerical surrogate is implemented; future caps may only be 1/2/5/10% with a declared metric.
approximant
Forward relation
Save options and sorted tables; load adds recognized row counts and indexes lex by unpointed key.
Domain: Count addition representable; fallback and lex/rest flags excluded from serialized state.
Source snapshot SHA-256: 1efafc6b8585f52c95ae888311bced3f5a9519555edaf78ff0e536450221ce5d. This is a partial source-derived mathematical relation, not an executable surrogate. Tests exercise actual production helpers with synthetic inputs.
models
Typed model catalog
Subject: hbo-seg-codec at SHA-256 1efafc6b8585f52c95ae888311bced3f5a9519555edaf78ff0e536450221ce5d. Domain and fixed state: Count addition representable; fallback and lex/rest flags excluded from serialized state.. Observation: return values, stated mutations and failure order of this scope. Models are partial source-derived relations; finite tests can falsify them but do not prove general completeness. Behavior complement is a scoped exclusion claim in the admitted transition universe. Reverse reconstruction retains compatible antecedents, not a unique historical cause. Specialized entries hold this domain fixed and isolate their named observation. Oracle: named actual-code fixtures in tests.md; unexecuted effect boundaries remain static hypotheses.
behavior_complement
No fallback subtree or by_letters dump can appear in save.
reverse_reconstruction
Same saved bytes admit arbitrary attached fallback and lex/rest flags; duplicate raw rows collapse by summed counts.
header_defaults
Unknown or malformed header options leave defaults except invalid level resets None.
row_accumulation
Duplicate key/label counts add; malformed count contributes0 and may create entry.
index_rebuild
by_letters computed from final lex keys after complete load.
ordered_tables
Fixed table-name order and sorted maps make save deterministic for fixed serialized state.
tests
Bounded evidence
Primary actual-code fixture: seg::wave32::supplied_states_context_fallback_and_codec. Run using cargo test --offline --locked -p hbo --lib seg::wave32::supplied_states_context_fallback_and_codec -- --exact --test-threads=1; repeat with --release. The external wave32 Hbo receipt set contains all 14 named outcomes twice per profile, numeric exit statuses, six compiled behavioral source negatives and byte-exact restoration hashes, and two identical source syntax projections. Source-local primary tests include assertions and caught expected panics. Fragments share these source witnesses; no claim of one test per branch.
Finite supplied-input checks only; no corpus, training, external annotator, GPU, throughput or semantic-understanding claim. Allocation exhaustion and malformed arbitrary model arithmetic are not exhaustively exercised. No useful numerical surrogate is implemented; future caps may only be 1/2/5/10% with a declared metric.
invariant-and-cost
Invariant and cost
Count addition representable; fallback and lex/rest flags excluded from serialized state.
Cost
O(serialized bytes + E log E insertion comparisons + normalization of keys) time, O(E text) space.
Resources must permit allocations; cost variables are source bytes, units, words and table entries as explicitly stated. No measured speed or universal error claim.
This page in Markdown → https://md.groupants.elamur.ai/free/en/mova/tools/hbo/src/seg.rs.groupant/codec.groupant/