Struct QualityScore 

pub struct QualityScore {
    pub value: f32,
    pub tier: QualityTier,
    pub signals: Vec<QualitySignal>,
    pub computed_at: u64,
}

Composite quality score for a Record.

Formula (ARCHITECTURE.md §5):

quality =
  has_imperative_verb  × 0.20
  + has_causality      × 0.25
  + has_severity       × 0.10
  + has_reference      × 0.15
  + length_score       × 0.15
  + specificity_score  × 0.15

penalties:
  vague_phrase_detected → × 0.5
  no_reason             → × 0.6
  too_short             → × 0.4

Layer 0 StaticAnalysis records default to 0.10 (Suppressed). Recomputed by RecordQualityAnalyzer on every write and mati enrich.

Does not derive PartialEq — see module-level float equality note.

Fields

value: f32

0.0 (useless) → 1.0 (Claude-optimal)

tier: QualityTier

signals: Vec<QualitySignal>

computed_at: u64

Unix timestamp (seconds) when this score was last computed. 0 = not yet computed (sentinel).

Implementations

impl QualityScore

pub fn layer0_default() -> Self

Default for a Layer 0 StaticAnalysis stub — Suppressed, never injected.

pub fn doc_comment_default() -> Self

Quality for a file record whose purpose was extracted from a language- canonical doc comment (Rust //!, Go // Package, Python docstring).

Acceptable tier (0.40) passes the quality >= 0.4 injection gate. Paired with confidence = 0.45 in init.rs, these records surface as additionalContext (allow + attach) rather than deny + inject.

pub fn developer_entry_default() -> Self

Quality for an auto-generated co-change gotcha (normal signal).

Acceptable tier (0.40): passes quality gate. Paired with confidence = 0.45 (0.3–0.6 band) → additionalContext injection. confirmed: true is set on the gotcha because co-change is objective git data, but the confidence band keeps it out of the deny+inject path. Quality for a developer-manually-added record (mati gotcha add, mati note).

Good tier (0.65): developer is explicitly asserting the record is important. Paired with DeveloperManual confidence (0.80) + confirmed=true → deny+inject path.

pub fn cochange_default() -> Self

pub fn cochange_strong() -> Self

Quality for a strong co-change gotcha (ratio >= 0.90 AND count >= 20).

Acceptable tier (0.60): passes quality gate. Paired with confidence = 0.65 → deny+inject path. A near-perfect co-change ratio over 20+ commits is strong enough evidence that Claude should be forced to see the coupling before editing either file.

pub fn tier_from_value(value: f32) -> QualityTier

Derive QualityTier from a raw score value (half-open intervals).

[0.0, 0.2) → Suppressed
[0.2, 0.4) → Poor
[0.4, 0.7) → Acceptable
[0.7, 0.9) → Good
[0.9, 1.0] → Excellent

Trait Implementations

impl Clone for QualityScore

fn clone(&self) -> QualityScore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QualityScore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for QualityScore

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for QualityScore

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.