relay-knowledge 1.1.17

Graph-database-based knowledge graph project.
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

use super::{
    CODE_SNAPSHOT_FACT_VERSION, clean_git_commit_from_snapshot_identity, code_snapshot_scope_id,
    code_snapshot_scope_id_with_workspace_detection, code_snapshot_scope_is_fact_versioned,
    code_snapshot_scope_matches_identity, code_snapshot_scope_workspace_semantic,
};
use crate::domain::{CodeMonorepoWorkspaceFormat, CodeWorkspaceDetectionConfig};

#[test]
fn clean_git_commit_parses_clean_and_worktree_identities() {
    assert_eq!(
        clean_git_commit_from_snapshot_identity("abc123"),
        Some("abc123")
    );
    assert_eq!(
        clean_git_commit_from_snapshot_identity("worktree:abc123:overlay456"),
        Some("abc123")
    );
}

#[test]
fn clean_git_commit_rejects_non_git_and_malformed_identities() {
    assert_eq!(
        clean_git_commit_from_snapshot_identity("filesystem:abc123"),
        None
    );
    assert_eq!(
        clean_git_commit_from_snapshot_identity("worktree:abc123"),
        None
    );
    assert_eq!(
        clean_git_commit_from_snapshot_identity("worktree::hash"),
        None
    );
    assert_eq!(clean_git_commit_from_snapshot_identity(""), None);
}

#[test]
fn fact_version_includes_generated_and_web_route_facts() {
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("generated-files-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("web-routes-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("syntax-failure-chunks-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("bounded-config-chunks-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("dense-source-windows-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("c-composite-tags-v1"));
}

#[test]
fn fact_version_includes_doc_block_owner_anchor_semantics() {
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("doc-block-owner-anchor-v2"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("bounded-type-doc-summary-v1"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("search-owner-v2"));
    assert!(CODE_SNAPSHOT_FACT_VERSION.contains("reference-search-groups-v2"));
}

#[test]
fn snapshot_scope_id_tracks_tree_and_filters() {
    let scope = code_snapshot_scope_id(
        "repo-1",
        "tree-a",
        &["src".to_owned()],
        &["rust".to_owned()],
    );
    let same = code_snapshot_scope_id(
        "repo-1",
        "tree-a",
        &["src".to_owned()],
        &["rust".to_owned()],
    );
    let different_tree = code_snapshot_scope_id(
        "repo-1",
        "tree-b",
        &["src".to_owned()],
        &["rust".to_owned()],
    );

    assert_eq!(scope, same);
    assert_ne!(scope, different_tree);
    assert!(scope.starts_with("git_snapshot:"));
}

#[test]
fn fact_versioned_snapshot_scope_requires_generated_hash_shape() {
    assert!(code_snapshot_scope_is_fact_versioned(
        "git_snapshot:0123456789abcdef"
    ));
    assert!(!code_snapshot_scope_is_fact_versioned("git_snapshot:test"));
    assert!(!code_snapshot_scope_is_fact_versioned("manual:test"));
    let base = "git_snapshot:0123456789abcdef";
    assert!(code_snapshot_scope_is_fact_versioned(&format!(
        "{base}:workspace-v1:0"
    )));
    assert!(code_snapshot_scope_is_fact_versioned(&format!(
        "{base}:workspace-v1:7"
    )));
    for malformed in ["00", "01", "8", "-1", "+1", "1x", "1:extra"] {
        assert!(!code_snapshot_scope_is_fact_versioned(&format!(
            "{base}:workspace-v1:{malformed}"
        )));
    }
}

#[test]
fn workspace_scope_semantics_are_canonical_and_backward_compatible() {
    let disabled = CodeWorkspaceDetectionConfig::disabled();
    let ordered = CodeWorkspaceDetectionConfig {
        enabled: true,
        supported_formats: vec![
            CodeMonorepoWorkspaceFormat::Pnpm,
            CodeMonorepoWorkspaceFormat::CargoWorkspace,
        ],
    };
    let reordered_duplicate = CodeWorkspaceDetectionConfig {
        enabled: true,
        supported_formats: vec![
            CodeMonorepoWorkspaceFormat::CargoWorkspace,
            CodeMonorepoWorkspaceFormat::Pnpm,
            CodeMonorepoWorkspaceFormat::Pnpm,
        ],
    };
    let enabled_empty = CodeWorkspaceDetectionConfig {
        enabled: true,
        supported_formats: Vec::new(),
    };
    let legacy = code_snapshot_scope_id("repo", "tree", &[], &[]);
    let disabled_scope =
        code_snapshot_scope_id_with_workspace_detection("repo", "tree", &[], &[], &disabled);
    let ordered_scope =
        code_snapshot_scope_id_with_workspace_detection("repo", "tree", &[], &[], &ordered);
    let duplicate_scope = code_snapshot_scope_id_with_workspace_detection(
        "repo",
        "tree",
        &[],
        &[],
        &reordered_duplicate,
    );
    let empty_scope =
        code_snapshot_scope_id_with_workspace_detection("repo", "tree", &[], &[], &enabled_empty);

    assert_eq!(legacy, disabled_scope);
    assert_eq!(ordered_scope, duplicate_scope);
    assert_ne!(ordered_scope, legacy);
    assert_ne!(empty_scope, legacy);
    assert!(code_snapshot_scope_matches_identity(
        "repo",
        "tree",
        &[],
        &[],
        &ordered_scope,
    ));
    assert_eq!(
        code_snapshot_scope_workspace_semantic("repo", "tree", &[], &[], &legacy),
        Some(None)
    );
    assert_eq!(
        code_snapshot_scope_workspace_semantic("repo", "tree", &[], &[], &empty_scope),
        Some(Some(0))
    );
}