Struct CloneGroupFinding 

pub struct CloneGroupFinding {
    pub group: CloneGroup,
    pub fingerprint: String,
    pub spread: usize,
    pub suggested_name: Option<String>,
    pub actions: Vec<CloneGroupAction>,
    pub introduced: Option<AuditIntroduced>,
    pub demotion_reason: Option<CloneDemotionReason>,
}

Wire-shape envelope for a CloneGroup finding. Flattens the bare group via #[serde(flatten)] and carries a typed actions array plus the optional audit-mode introduced flag. The typed envelope replaced the legacy JSON post-pass injection; a guard test in crates/cli/src/report/json.rs rejects any reintroduced post-pass.

Fields

group: CloneGroup

The underlying clone group.

fingerprint: String

Stable content fingerprint, usually dup:<8hex> and widened on rare report collisions. Addressable via fallow dupes --trace dup:<fp> (and the trace_clone MCP tool) to deep-dive this group; shown alongside each group in the human listing.

spread: usize

Maximum directory-tree or same-file line distance between instances.

suggested_name: Option<String>

Best-effort human-readable name for the clone: the dominant repeated identifier across the duplicated fragment (e.g. a shared parseCsv function). None when the clone has no clear dominant name (generic or tied identifiers); consumers then fall back to a file-based label. Lets editors and agents label a clone by what it is rather than an opaque ordinal.

actions: Vec<CloneGroupAction>

Suggested next steps: an extract-shared primary and a suppress-line secondary. Always emitted (possibly empty for forward-compat).

introduced: Option<AuditIntroduced>

Set by the audit pass when this clone group is introduced relative to the merge-base. None when serialized directly from Rust.

demotion_reason: Option<CloneDemotionReason>

Set only by fallow audit under --gate new-only, on groups whose introduced flag the gate demoted to false: why the demotion happened. None everywhere else, including fallow dupes --format json (issue #2220).

Implementations

impl CloneGroupFinding

pub fn with_fingerprint(group: CloneGroup, fingerprint: String) -> Self

Build the wrapper with a precomputed report-scoped fingerprint.

Trait Implementations

impl Clone for CloneGroupFinding

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CloneGroupFinding

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

Formats the value using the given formatter.

impl Serialize for CloneGroupFinding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.