---
title: "cycle-db-commit — Mova code model"
description: "Mova code model of tools/cycle/src/db.rs: components with their labels, obernants and the model text."
url: "https://groupants.elamur.ai/free/en/mova/tools/cycle/src/db.rs.groupant/commit.groupant/"
---
Elamur: [Mova](https://md.mova.elamur.ai/free/en/) · [Dictionary](https://md.dictionary.elamur.ai/free/en/) · [Research](https://md.research.elamur.ai/free/en/) · **Groupants**

This page as HTML: <https://groupants.elamur.ai/free/en/mova/tools/cycle/src/db.rs.groupant/commit.groupant/>

# cycle-db-commit

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

- **kind:** groupant_fragment
- **status:** partial source bound model
- **source:** [`tools/cycle/src/db.rs`](https://github.com/ElamurAI/mova-free/blob/main/tools/cycle/src/db.rs)
- **source SHA-256:** `7f2ba8a274a64ee7…`
- **covers:** Validate policy and one incoming snapshot; merge current by id, rename current, append the same snapshot to history, append event log. (bytes 3026–5607)
- **part of:** [cycle-db](https://md.groupants.elamur.ai/free/en/mova/tools/cycle/src/db.rs.groupant/)
- **repository folder:** [`tools/cycle/src/db.rs.groupant/commit.groupant`](https://github.com/ElamurAI/mova-free/tree/main/tools/cycle/src/db.rs.groupant/commit.groupant)
- **repository commit:** `48f2e6f74146`

> **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](#approximant) |
| **ast** | partial | `../syntax.json` |
| **cost** | partial | [invariant-and-cost](#invariant-and-cost) |
| **descriptant** | present | [descriptant](#descriptant) |
| **invariant** | partial | [invariant-and-cost](#invariant-and-cost) |
| **tests** | bounded or representation | [tests](#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](#behavior-complement) |
| `reverse_reconstruction` | reverse_reconstruction | partial source derived model | [reverse_reconstruction](#reverse-reconstruction) |
| `duplicate_index` | duplicate_index | partial source derived model | [duplicate_index](#duplicate-index) |
| `rename_boundary` | rename_boundary | partial source derived model | [rename_boundary](#rename-boundary) |
| `validated_input_snapshot` | validated_input_snapshot | partial source derived model | [validated_input_snapshot](#validated-input-snapshot) |
| `timestamp_scope` | timestamp_scope | partial source derived model | [timestamp_scope](#timestamp-scope) |

## Model text


### descriptant

#### cycle-db-commit

##### Epoch 2026-10-31

Prospective inspection identified this relation before additions: Merge current by id, write tmp, rename current, reread input, append history, append event log.

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.

### approximant

#### Forward relation

Check promotion lock and content-bound policy, read/validate one immutable incoming buffer, reject selected conflicts, merge by ID, write tmp and rename current, append history from the same buffer, append event log. Legacy cross-file effects remain ordered, not atomic.

##### Composition

This fragment isolates the stated helper relation; parent composition retains surrounding effects and failures.

### catalog

## Typed observations: cycle-db-commit

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 replacement cannot append position; post-rename failure cannot imply unchanged current.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### reverse_reconstruction

Old+final current admit overwritten intermediate incoming versions. Counts constrain multiplicity, history may retain bodies but may be partial.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### duplicate_index

Initial map stores last index for duplicate id; incoming duplicates use updated map and append only once.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### rename_boundary

Current commit precedes history open/write and log open/write; error effects partition by this order.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### validated_input_snapshot

One incoming read is validated before effects and reused for current and history; a later input-path replacement cannot bypass the reviewed guard. Concurrent database writers remain outside the quiescent guarantee.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### timestamp_scope

One seconds timestamp per call; pre-epoch failure maps zero. Time is not unique event identity.

Scope: the bound source interval and stated assumptions. Evidence: source inspection plus the checks explicitly named in tests.md; no finite check establishes all inputs.

### tests

#### Checks and limits

db::tests::replace_and_append covers positions/counts/current/log. Mid-write failure and concurrent reread gaps.

Exact native outcomes and command metadata are retained in the external wave33 cycle receipt bundle. Selected names run twice in debug and release; syntax is independently regenerated twice. Compiled mutations and source restoration receipts distinguish behavior changes from assertion-only controls. These claims are finalized in evidence.md. No live teacher, real model/corpus, benchmark CLI or lesson-learning CLI is run.

### invariant-and-cost

#### Invariant and cost

Incoming repeated new id adds once then replaces; initial duplicate ids remain except last indexed occurrence. No rollback.

O(old+incoming bytes+events log S), O(old+incoming) memory plus policy validation. Current and history reuse the same incoming snapshot; nontransactional append failures can still leave prefixes.

No executable percentage surrogate is claimed: effects, categorical acceptance and report text have no justified approximate metric here. Future profiles require a useful metric, zero case, reference and evidence at caps 1/2/5/10%.