cycle-db

The groupant beside tools/cycle/src/db.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	`model.md`
ast	partial	`syntax.json`
composition	partial	Composition
cost	partial	invariant-and-cost
descriptant	present	descriptant
invariant	partial	invariant-and-cost
tests	bounded or representation	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
`vote_order`	vote_order	partial source derived model	vote_order
`tree_domain`	tree_domain	partial source derived model	tree_domain
`heldout_first_source`	heldout_first_source	partial source derived model	heldout_first_source
`effect_prefix`	effect_prefix	partial source derived model	effect_prefix

Parts

Model text

descriptant

cycle-db

Epoch 2026-10-31

Prospective inspection identified this relation before additions: blocks takes first sent_id per double-newline block. update merges by id preserving positions, renames current before history/log append. agree picks strongest newest base, aggregates weighted head/relation votes and falls back if tree_ok fails. same_text whitespace-normalizes and copies lexicographically first matching id. training_file excludes heldout ids and takes first database occurrence.

The production implementation is unchanged; only selected inline tests are appended. Source-bound syntax is generated twice and compared. Native checks exercise bounded helpers; entry orchestration, teacher calls, models and corpora remain source-derived. Partial syntax is not semantic proof. Preserve failure prefixes and ambiguity when refining this model.

Epoch 2026-11-01

Implemented explicit content-bound reviewed selection, separate train/dev authorization, full-tag/head preservation after agree, and no-separator normalization with preamble ownership. A real old-vote negative control demonstrates why a current-only correction is lost. Legacy update effects outside reviewed selection still lack a multi-file transaction. Bounded tests do not establish semantic quality.

approximant

Forward relation

blocks takes first sent_id per double-newline block. update merges by id preserving positions, renames current before history/log append. agree picks strongest newest base, aggregates weighted head/relation votes and falls back if tree_ok fails. same_text whitespace-normalizes and copies lexicographically first matching id. training_file excludes heldout ids and takes first database occurrence.

Composition

update establishes current/history/log consumed by agree/trainer; failures may leave inconsistent observations. same_text joins update then update_prag. training_file shares ids_of. Children isolate commit and vote boundaries.

Epoch 2026-11-01 current relation

blocks now separates each sent_id and carries contiguous preamble comments to its following sentence. Current writes validate persistent reviewed selection; update/prag reject conflicting selected content. agree applies the entire selected tree after its ordinary source-weight vote. training_file intersects explicit train decisions with heldout exclusions, and strict primary policy rejects unreviewed secondary DBs. Reviewed promotion/snapshot/rollback lives in reviewed.rs; legacy update remains nontransactional.

catalog

Typed observations: cycle-db

Subject: tools/cycle/src/db.rs, SHA-256 34f08db359c4d620f91bb9b5a586653ff948019524e4b21ff1b21f37c413c5b9. Domain: bounded source inputs, declared filesystem/environment state and normal allocations. Each view is a partial source-derived relation, not a universal proof. Observation is one helper call or the explicitly described trace. Checks are in tests.md; unexecuted effects remain gaps.

behavior_complement

Successful unique-id update preserves existing positions, appends new ids once. with_drafts excludes replacement of known DB ids but permits repeated new draft ids. No rollback guarantee.