Skip to main content

Module quality_gate

Module quality_gate 

Source
Expand description

MemReader write quality gate (#3222).

QualityGate runs after A-MAC admission and before any persistence write. It scores three signals — information value, reference completeness, and contradiction risk — and rejects writes below a configurable threshold.

Rule-based scoring ships as MVP; an optional LLM-assisted path is enabled by setting quality_gate_provider in [memory.quality_gate].

§Composition in SemanticMemory

remember(content)
  → A-MAC::evaluate()  →  Ok(None) if rejected
  → QualityGate::evaluate()  →  Ok(None) if rejected
  → SQLite / Qdrant persist

§Fail-open contract

Any scoring failure (embed error, LLM timeout, graph query error) is treated as a pass — the write is admitted. Quality scoring is best-effort, never a hard dependency.

Structs§

QualityGate
Write quality gate that runs after A-MAC admission.
QualityGateConfig
Configuration for the write quality gate ([memory.quality_gate] TOML section).
QualityScore
Per-signal scores from the quality gate evaluation.

Enums§

QualityRejectionReason
Reason for a quality gate rejection.

Functions§

compute_reference_completeness
Compute reference_completeness as 1.0 - unresolved_reference_ratio.