relay-knowledge 1.1.6

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

use crate::domain::{CodeIndexSnapshot, CodeRepositoryRegistration};

use super::*;

#[test]
fn knowledge_map_topics_are_extracted_from_full_source_content() {
    let padding = "x".repeat(8_500);
    let source = format!("topics:\n  # {padding}\n  - id: late-topic\n");
    let snapshot = parse_source_snapshot(".knowledge/knowledge-map.yaml", source.as_bytes());

    assert!(
        snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "late-topic" })
    );
    assert!(
        !snapshot
            .chunks
            .iter()
            .filter(|chunk| chunk.symbol_snapshot_id.is_none())
            .any(|chunk| chunk.content.contains("late-topic")),
        "the regression should prove topic extraction does not depend on truncated chunks"
    );
}

#[test]
fn knowledge_map_topics_tolerate_section_header_comments() {
    let source = "\
topics: # routing buckets
  - id: route-topic
sources: # authoritative docs
  - id: not-a-topic
";
    let snapshot = parse_source_snapshot(".knowledge/knowledge-map.yaml", source.as_bytes());

    assert!(
        snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "route-topic" })
    );
    assert!(
        !snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "not-a-topic" })
    );
}

#[test]
fn knowledge_map_topics_ignore_nested_block_scalar_ids() {
    let source = "\
topics:
  - id: real-topic
    description: |
      id: not-a-topic
";
    let snapshot = parse_source_snapshot(".knowledge/knowledge-map.yaml", source.as_bytes());

    assert!(
        snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "real-topic" })
    );
    assert!(
        !snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "not-a-topic" })
    );
}

#[test]
fn knowledge_map_topics_ignore_nested_sequence_ids() {
    let source = "\
topics:
  - id: real-topic
    related:
      - id: nested-topic
";
    let snapshot = parse_source_snapshot(".knowledge/knowledge-map.yaml", source.as_bytes());

    assert!(
        snapshot
            .symbols
            .iter()
            .any(|symbol| { symbol.kind == "knowledge_map_topic" && symbol.name == "real-topic" })
    );
    assert!(
        !snapshot.symbols.iter().any(|symbol| {
            symbol.kind == "knowledge_map_topic" && symbol.name == "nested-topic"
        })
    );
}

#[test]
fn knowledge_map_topics_accept_sequence_spacing_before_id() {
    let source = "\
topics:
  -   id: spaced-topic
";
    let snapshot = parse_source_snapshot(".knowledge/knowledge-map.yaml", source.as_bytes());

    assert!(
        snapshot.symbols.iter().any(|symbol| {
            symbol.kind == "knowledge_map_topic" && symbol.name == "spaced-topic"
        }),
        "valid YAML sequence spacing should not hide topic ids"
    );
}

fn parse_source_snapshot(path: &str, source: &[u8]) -> CodeIndexSnapshot {
    let registration =
        CodeRepositoryRegistration::new("repo", "alias", "/tmp/repo", Vec::new(), Vec::new())
            .expect("registration should validate");
    let mut build = SnapshotBuild::new(
        &registration,
        "commit".to_owned(),
        "tree".to_owned(),
        true,
        1,
        0,
    );
    parse_indexed_file(&mut build, path, source).expect("file should parse");
    build.finish()
}