Module curation 

Curation operations: entity update/merge and edge-list filter type.

Structs

EdgeListFilter

Filter for list_edges / count_edges.

EdgePatch

Patch for update_edge. Only Some(_) fields are applied; None means “leave unchanged”.

EntityPatch

Patch for update_entity. Only Some(_) fields are applied; None means “leave unchanged”.

GuardedNoteMerge

The outcome of a guarded merge. kept_version is the survivor’s stored version after the merge, so the caller can merge the next duplicate into the same survivor without reading it again. A dry run commits nothing and reports the version the survivor currently has.

MergeEdgeConflictPreimage

One natural-key collision resolved by a direct entity or note merge.

MergeEdgePreimage

Complete stored state of an edge removed during a merge.

MergeSummary

Result returned by merge_entity / merge_note.

MergeTxBudgetReport

Observed budget usage for one merge transaction (see MergeTxLimits).

MergeTxLimits

Hard materialization limits for one merge transaction.

NoteMergeGuard

What the caller read, and what it requires to still be true, for one merge.

NotePatch

Patch for update_note. Only Some(_) fields are applied; None means “leave unchanged”.

NoteUpdatePolicy

Kind-owned property semantics carried from validated hook preparation to the shared note merge. The default preserves ordinary JSON merge behavior.

Enums

ContentMergeStrategy

Strategy for merging note content when two notes are combined.

EntityDedupMergePolicy

Policy used when deduplicating two entities.

EntityMergeGuard

Safety-floor guard that refused an explicit entity merge.

MergeAssertion

A fact the caller relied on when it planned the merge, re-checked inside the merge transaction. The first one that does not hold refuses the merge.

Functions

entity_embedding_text

Build the canonical text embedded for an entity on create, update, merge, and repair paths.

entity_fts_document

Build the TextDocument for an entity. This is the single source of truth for entity FTS document shape; all write paths (create, update, merge, reindex, backfill) must go through this function so search parity is guaranteed.

entity_merge_guard_compared_values

The two values guard compared, for a caller-facing preview of the refusal.

entity_merge_guard_error

Convert a safety-floor refusal into the merge verb’s structured conflict contract.

entity_merge_guard_refusal_message

The sentence a safety-floor refusal shows its caller.

note_embedding_text

Build the canonical text embedded for a note when no explicit bounded embedding prefix was supplied at creation time.

note_fts_document

Build the TextDocument for a note. This is the single source of truth for note FTS document shape; all write paths (create, update, reindex) must go through this function so recall parity is guaranteed. Changes here apply to every caller automatically.

validate_entity_merge_floor

Validate the non-forced entity-merge safety floor.