chronicle-graph 0.1.1

Event-centric narrative knowledge graphs with temporal verification
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use chronicle::graph::Chronicle;
use chronicle::validation::{ValidationError, ValidationWarning};
use std::path::Path;

fn data_path(scenario: &str) -> std::path::PathBuf {
    Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("tests/data/invalid")
        .join(scenario)
}

// ── Dangling reference ─────────────────────────────────────

#[test]
fn catches_dangling_reference() {
    let c = Chronicle::from_directory(&data_path("dangling_ref")).unwrap();
    let report = c.validate();

    let dangling: Vec<_> = report.errors.iter().filter(|e| {
        matches!(e, ValidationError::DanglingReference { target_id, .. } if target_id == "nonexistent_actor")
    }).collect();

    assert!(
        !dangling.is_empty(),
        "should catch dangling reference to nonexistent_actor"
    );
}

// ── Temporal violation (dead actor participates later) ──────

#[test]
fn catches_state_violation_dead_actor() {
    let c = Chronicle::from_directory(&data_path("temporal_violation")).unwrap();
    let report = c.validate();

    let violations: Vec<_> = report
        .errors
        .iter()
        .filter(|e| {
            matches!(e, ValidationError::StateViolation { entity_id, event_id, .. }
            if entity_id == "doomed_soldier" && event_id == "later_battle")
        })
        .collect();

    assert!(
        !violations.is_empty(),
        "should catch dead actor participating in later event"
    );
}

// ── State violation (event at destroyed place) ─────────────

#[test]
fn catches_state_violation_destroyed_place() {
    let c = Chronicle::from_directory(&data_path("state_violation")).unwrap();
    let report = c.validate();

    let violations: Vec<_> = report
        .errors
        .iter()
        .filter(|e| {
            matches!(e, ValidationError::StateViolation { entity_id, event_id, .. }
            if entity_id == "ruined_city" && event_id == "impossible_market")
        })
        .collect();

    assert!(
        !violations.is_empty(),
        "should catch event at destroyed location"
    );
}

// ── Orphan entity ──────────────────────────────────────────

#[test]
fn catches_orphan_entity() {
    let c = Chronicle::from_directory(&data_path("orphan")).unwrap();
    let report = c.validate();

    let orphans: Vec<_> = report.warnings.iter().filter(|w| {
        matches!(w, ValidationWarning::OrphanEntity { entity_id } if entity_id == "forgotten_hermit")
    }).collect();

    assert!(
        !orphans.is_empty(),
        "should warn about orphaned forgotten_hermit"
    );

    // connected_faction should NOT be orphaned (it participates in an event)
    let false_orphans: Vec<_> = report.warnings.iter().filter(|w| {
        matches!(w, ValidationWarning::OrphanEntity { entity_id } if entity_id == "connected_faction")
    }).collect();

    assert!(
        false_orphans.is_empty(),
        "connected_faction should not be orphaned"
    );
}

// ── Duplicate ID ───────────────────────────────────────────

#[test]
fn catches_duplicate_id() {
    let result = Chronicle::from_directory(&data_path("duplicate_id"));
    let err = match result {
        Err(e) => e,
        Ok(_) => panic!("should fail to load duplicate IDs"),
    };
    let msg = err.to_string();
    assert!(
        msg.contains("duplicate_id"),
        "error should mention the duplicate ID: {msg}"
    );
}