iwec 0.17.0

IWE MCP server
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

use crate::fixture::Fixture;
use indoc::indoc;
use rmcp::model::CallToolResult;
use serde_json::json;

const ALPHA: &str = indoc! {"
    # Ada and Kai

    Ada and Kai met in Vienna in the spring of 1998 while both were studying
    analog synthesizers together. They collaborated on a modular sequencer and
    later co-founded a small workshop building custom filters for touring
    musicians across Europe and beyond.
"};

const BETA: &str = indoc! {"
    # Ada and Kai

    Ada and Kai met in Vienna in the summer of 1998 while both were studying
    analog synthesizers together. They collaborated on a modular sequencer and
    later co-founded a small workshop building custom filters for touring
    musicians across Europe and beyond.
"};

const DISTINCT: &str = indoc! {"
    # Tax Filing Checklist

    Gather every receipt, confirm the standard deduction amount, review the
    quarterly estimated payments, reconcile the brokerage statements, and submit
    the completed federal return well before the April filing deadline to avoid
    any late penalties or accrued interest charges this year.
"};

fn warnings(result: &CallToolResult) -> Vec<String> {
    Fixture::result_text_blocks(result)
        .into_iter()
        .filter(|block| block.starts_with("warning:"))
        .collect()
}

#[tokio::test]
async fn create_result_carries_orphan_and_dangling_warnings() {
    let f = Fixture::with_documents(vec![]).await;

    let result = f
        .call_tool(
            "iwe_create",
            json!({"key": "notes", "content": "# Notes\n\nSee [missing](ghost).\n"}),
        )
        .await;

    assert_eq!(
        warnings(&result),
        vec![
            "warning: notes › orphan: no page links here".to_string(),
            "warning: notes › dangling-link: links to missing 'ghost'".to_string(),
        ]
    );
}

#[tokio::test]
async fn findings_are_reported_once_per_session() {
    let f = Fixture::with_documents(vec![]).await;

    let first = f
        .call_tool(
            "iwe_create",
            json!({"key": "notes", "content": "# Notes\n\nSee [missing](ghost).\n"}),
        )
        .await;
    assert_eq!(
        warnings(&first),
        vec![
            "warning: notes › orphan: no page links here".to_string(),
            "warning: notes › dangling-link: links to missing 'ghost'".to_string(),
        ]
    );

    let second = f
        .call_tool(
            "iwe_create",
            json!({"key": "extra", "content": "# Extra\n"}),
        )
        .await;
    assert_eq!(
        warnings(&second),
        vec!["warning: extra › orphan: no page links here".to_string()]
    );
}

#[tokio::test]
async fn per_key_stats_include_similar_pages() {
    let f = Fixture::with_documents(vec![
        ("alpha", ALPHA),
        ("beta", BETA),
        ("distinct", DISTINCT),
    ])
    .await;

    let result = f.call_tool("iwe_stats", json!({"key": "alpha"})).await;
    let output = Fixture::result_json(&result);
    assert_eq!(output["key"], "alpha");
    let similar = output["similarPages"]
        .as_array()
        .expect("similarPages array");
    assert_eq!(similar.len(), 1);
    assert_eq!(similar[0]["key"], "beta");
}

#[tokio::test]
async fn update_result_carries_similar_page_warning() {
    let f = Fixture::with_documents(vec![
        ("alpha", ALPHA),
        (
            "beta",
            "# Ada and Kai\n\nplaceholder text goes here for now.\n",
        ),
        ("distinct", DISTINCT),
    ])
    .await;

    let result = f
        .call_tool("iwe_update", json!({"key": "beta", "content": BETA}))
        .await;

    assert_eq!(
        warnings(&result),
        vec![
            "warning: alpha › orphan: no page links here".to_string(),
            "warning: beta › orphan: no page links here".to_string(),
            "warning: distinct › orphan: no page links here".to_string(),
            "warning: beta › similar-page: closely matches 'alpha' (0.94)".to_string(),
        ]
    );
}