Struct DuplicateCheckResult 

pub struct DuplicateCheckResult {
    pub is_duplicate: bool,
    pub reason: Option<DuplicateReason>,
    pub similarity_score: Option<f32>,
    pub matched_memory_id: Option<MemoryId>,
    pub matched_urn: Option<String>,
    pub check_duration_ms: u64,
}

Result of a deduplication check.

Contains information about whether content was found to be a duplicate, the reason for duplication, and any matched memory information.

Example

use subcog::services::deduplication::{DuplicateCheckResult, DuplicateReason};
use subcog::models::MemoryId;

let result = DuplicateCheckResult {
    is_duplicate: true,
    reason: Some(DuplicateReason::ExactMatch),
    similarity_score: None,
    matched_memory_id: Some(MemoryId::new("abc123")),
    matched_urn: Some("subcog://project/decisions/abc123".to_string()),
    check_duration_ms: 5,
};

assert!(result.is_duplicate);
assert_eq!(result.reason, Some(DuplicateReason::ExactMatch));

Fields

is_duplicate: bool

Whether the content is a duplicate.

reason: Option<DuplicateReason>

The reason content was identified as a duplicate.

similarity_score: Option<f32>

Similarity score for semantic matches (0.0 to 1.0).

matched_memory_id: Option<MemoryId>

The memory ID of the matched duplicate.

matched_urn: Option<String>

Full URN of matched memory: subcog://{domain}/{namespace}/{id}.

MUST be populated when is_duplicate == true. All external outputs (logs, metrics labels, hook responses) MUST reference memories by URN, not bare ID.

check_duration_ms: u64

Duration of the deduplication check in milliseconds.

Implementations

impl DuplicateCheckResult

pub const fn not_duplicate(duration_ms: u64) -> Self

Creates a result indicating no duplicate was found.

Arguments

• duration_ms - Time taken for the check in milliseconds

Example

use subcog::services::deduplication::DuplicateCheckResult;

let result = DuplicateCheckResult::not_duplicate(10);
assert!(!result.is_duplicate);
assert!(result.reason.is_none());

pub const fn exact_match( memory_id: MemoryId, urn: String, duration_ms: u64, ) -> Self

Creates a result indicating an exact match was found.

Arguments

• memory_id - The ID of the matched memory
• urn - The full URN of the matched memory
• duration_ms - Time taken for the check in milliseconds

Example

use subcog::services::deduplication::DuplicateCheckResult;
use subcog::models::MemoryId;

let result = DuplicateCheckResult::exact_match(
    MemoryId::new("abc123"),
    "subcog://project/decisions/abc123".to_string(),
    5,
);
assert!(result.is_duplicate);

pub const fn semantic_match( memory_id: MemoryId, urn: String, score: f32, duration_ms: u64, ) -> Self

Creates a result indicating a semantic similarity match was found.

Arguments

• memory_id - The ID of the matched memory
• urn - The full URN of the matched memory
• score - The similarity score (0.0 to 1.0)
• duration_ms - Time taken for the check in milliseconds

Example

use subcog::services::deduplication::DuplicateCheckResult;
use subcog::models::MemoryId;

let result = DuplicateCheckResult::semantic_match(
    MemoryId::new("abc123"),
    "subcog://project/decisions/abc123".to_string(),
    0.94,
    20,
);
assert!(result.is_duplicate);
assert_eq!(result.similarity_score, Some(0.94));

pub const fn recent_capture( memory_id: MemoryId, urn: String, duration_ms: u64, ) -> Self

Creates a result indicating the content was recently captured.

Arguments

• memory_id - The ID of the matched memory
• urn - The full URN of the matched memory
• duration_ms - Time taken for the check in milliseconds

Example

use subcog::services::deduplication::DuplicateCheckResult;
use subcog::models::MemoryId;

let result = DuplicateCheckResult::recent_capture(
    MemoryId::new("abc123"),
    "subcog://project/decisions/abc123".to_string(),
    1,
);
assert!(result.is_duplicate);

Trait Implementations

impl Clone for DuplicateCheckResult

fn clone(&self) -> DuplicateCheckResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DuplicateCheckResult

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

Formats the value using the given formatter.

impl Default for DuplicateCheckResult

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DuplicateCheckResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DuplicateCheckResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.