Skip to main content

Module error

Module error 

Source
Expand description

Engine error envelopes.

EngineError lifts the typed payloads every consumer pattern-matches on (BackendError via #[from], ValidationError from the runtime validator, SlugError from the slug helper, ParseError from the markdown parser). BootError is the smaller envelope produced by Engine::from_workspace_root and its full counterpart — the failure modes specific to layout detection, workspace-store load, per-mount backend instantiation, and engine construction.

Structs§

BlockedReferrer
One blocked-direction summary entry for EngineError::RenameBlockedByCrossMemPolicy. Pairs the referrer’s mem with the renaming entity’s mem (the edge’s actual referrer → renamed direction post-rewrite) and the count of distinct referrers in that mem that would emit the blocked rewrite.
MissingWikiLink
One body wiki-link that violates the strict wiki-link / relation invariant. Surfaces inside EngineError::WikiLinkWithoutRelation::missing.
ReferrerInfo
Typed payload for a single Write-Mem referrer in EngineError::HasIncomingRefs. Captures the (from_id, rel_types, mem) triple the surface envelope projects so consumers can reason about the offending edges without a follow-up memstead_entity call. The mem is always a Write-Mem — ReadOnly referrers are partitioned out before this struct is constructed and surfaced via the residual-stub warning channel instead.
SchemaSourceDiagnostic
One resolution-source line on EngineError::SchemaNotFound’s details.sources payload.

Enums§

BootError
Errors surfaced by [Engine::from_workspace_root] (lean) and its full counterpart (memstead_git_branch::engine_from_workspace_root).
EngineError
Errors surfaced by [Engine].

Constants§

INLINE_LIST_CAP
Maximum items rendered inline before truncation kicks in. Picked to keep the typical fanout (1–25 items) on one terminal line while still bounding pathological cases (200+ referrers on a hub entity) to a constant prefix plus a count.

Functions§

format_inline_list_overflow
Render a structured-list payload onto the text-mirror message. The first INLINE_LIST_CAP items appear inline, comma-separated; when the list is longer, the suffix “ +N more — see details.“ points the agent at the structured channel’s typed list under field. Empty input renders as an empty string. The function is generic over any fmt::Display item — wrap structs in a small Display newtype if their default rendering is too verbose for the text channel.