RootCauseCandidate class

A possible root cause derived from deterministic evidence.

Root causes are NOT AI-generated. They are computed by the deterministic RootCauseEngine from structured evidence.

Design invariants:

• occurrenceCount must equal the sum of individual issues belonging to this candidate. One issue MUST NOT be counted in multiple candidates.
• confidence is set only as high as the evidence supports.
• summary must describe only what the evidence actually shows.

Constructors

RootCauseCandidate({required String title, required String summary, required IssuePriority priority, required IssueCategory category, required RootCauseConfidence confidence, required List<EvidenceItem> evidence, required List<String> relatedRules, required List<String> affectedFiles, required int occurrenceCount})

const

Properties

affectedFiles → List<String>

Unique file paths where related issues were detected.

final

category → IssueCategory

The nature of the root cause.

final

confidence → RootCauseConfidence

How strongly the evidence supports this candidate.

final

evidence → List<EvidenceItem>

All evidence items that support this candidate.

final

hashCode → int

The hash code for this object.

no setter, inherited

occurrenceCount → int

Total count of individual analyzer issues attributed to this candidate. Must not double-count issues.

final

priority → IssuePriority

Inherited from the highest-severity related analyzer rule.

final

relatedRules → List<String>

Analyzer rule identifiers contributing to this candidate.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

summary → String

A longer explanation of what the evidence shows. MUST NOT claim causes that are not proven by the evidence.

final

title → String

Short, developer-facing description of the root cause.

final

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited