harn-lint 0.8.4

Linter for the Harn programming language
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

use super::*;

#[test]
fn mcp_tools_warns_for_unannotated_tool_define() {
    let diagnostics = lint_source(
        r#"
pipeline main() {
  var tools = tool_registry()
  tools = tool_define(tools, "echo", "Echo input", {
    parameters: {text: "string"},
    handler: { args -> args.text },
  })
  mcp_tools(tools)
}
"#,
    );

    assert_eq!(count_rule(&diagnostics, "mcp-tool-annotations"), 1);
}

#[test]
fn mcp_tools_accepts_annotated_tool_define() {
    let diagnostics = lint_source(
        r#"
pipeline main() {
  var tools = tool_registry()
  tools = tool_define(tools, "echo", "Echo input", {
    parameters: {text: "string"},
    handler: { args -> args.text },
    annotations: {readOnlyHint: true, idempotentHint: true, openWorldHint: false},
  })
  mcp_tools(tools)
}
"#,
    );

    assert!(!has_rule(&diagnostics, "mcp-tool-annotations"));
}

#[test]
fn non_mcp_tool_define_does_not_warn() {
    let diagnostics = lint_source(
        r#"
pipeline main() {
  var tools = tool_registry()
  tools = tool_define(tools, "echo", "Echo input", {
    parameters: {text: "string"},
    handler: { args -> args.text },
  })
  tool_count(tools)
}
"#,
    );

    assert!(!has_rule(&diagnostics, "mcp-tool-annotations"));
}

#[test]
fn mcp_tools_warns_for_inline_unannotated_tool_define() {
    let diagnostics = lint_source(
        r#"
pipeline main() {
  mcp_tools(tool_define(tool_registry(), "echo", "Echo input", {
    parameters: {text: "string"},
    handler: { args -> args.text },
  }))
}
"#,
    );

    assert_eq!(count_rule(&diagnostics, "mcp-tool-annotations"), 1);
}

#[test]
fn mcp_tools_reports_only_unannotated_entries_in_chain() {
    let diagnostics = lint_source(
        r#"
pipeline main() {
  var tools = tool_registry()
  tools = tool_define(tools, "read", "Read input", {
    parameters: {},
    handler: { _args -> "ok" },
    annotations: {readOnlyHint: true},
  })
  tools = tool_define(tools, "write", "Write output", {
    parameters: {},
    handler: { _args -> "ok" },
  })
  mcp_tools(tools)
}
"#,
    );

    assert_eq!(count_rule(&diagnostics, "mcp-tool-annotations"), 1);
}