Elamur Groupantshbo-seg-pieces
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 |
offset_advance | offset_advance | partial source derived model | offset_advance |
lead_search | lead_search | partial source derived model | lead_search |
slice_failure | slice_failure | partial source derived model | slice_failure |
empty_spelling | empty_spelling | partial source derived model | empty_spelling |
Model text
descriptant
Descriptant
2026-10-31, prospective epoch: inspected source before edits and predicted Walk pieces with unit offset; H emits article; leading cuts move previous non-H vowel tail; spells verifies size then unpointed concatenation.
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
Walk pieces with unit offset; H emits article; leading cuts move previous non-H vowel tail; spells verifies size then unpointed concatenation.
Domain: Valid cut sums and nonzero cuts ensure bounded slices; direct malformed cut has weaker checks.
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-pieces at SHA-256 1efafc6b8585f52c95ae888311bced3f5a9519555edaf78ff0e536450221ce5d. Domain and fixed state: Valid cut sums and nonzero cuts ensure bounded slices; direct malformed cut has weaker checks.. 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
H cannot consume a written unit; moved vowel does not move dagesh.
reverse_reconstruction
Output forms and H flags constrain input via NFC and vowel transfer, but original normalization spelling remains ambiguous.
offset_advance
Offset grows only by Cut lengths, not emitted output scalar counts.
lead_search
Leading cut finds most recent non-H output, skipping any inserted articles.
slice_failure
Oversized first cut truncates end; later start beyond units can panic. Safe callers must validate.
empty_spelling
Empty ps with empty form passes letters count and cut concat; Cut(0) is explicitly rejected.
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
Valid cut sums and nonzero cuts ensure bounded slices; direct malformed cut has weaker checks.
Cost
O(B+P) normal cuts plus NFC; leading tail scans/copies can revisit prior strings; bounded by O(PB) worst case.
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/pieces.groupant/