sqry-mcp 13.0.3

MCP server for sqry semantic code search
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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183

//! Daemon-hosted MCP tool surface.
//!
//! The sqryd daemon hosts a 16-tool MCP subset via the shim byte-pump
//! transport. Standalone `sqry-mcp` (no daemon) exposes the full
//! 36-tool runtime MCP standalone surface via
//! [`crate::server::SqryServer::get_filtered_tools`]. These two are
//! intentionally NOT identical — 20 standalone-only tools are
//! unavailable when connecting through the daemon (per Codex iter-0 B3:
//! "the daemon-hosted MCP surface is finally honest").
//!
//! Users wanting the full 36-tool inventory continue to invoke
//! `sqry-mcp` without `--daemon`.

/// Names of the 16 tools that the daemon MCP host exposes via
/// `tools/list` and that [`crate::daemon_adapter::dispatch::dispatch_by_name`]
/// can route. Alphabetical order for stable assertions.
///
/// **Source of truth:** the Phase 8b `tool_dispatch/tools/*.rs`
/// dispatcher in sqry-daemon plus the NL07 `sqry_ask` arm. Any
/// addition/removal here must be mirrored in sqry-daemon's
/// `ipc::methods::tool_dispatch::dispatch_tool` and in the daemon
/// MCP host's `dispatch_sqry_ask` route.
pub const DAEMON_SUPPORTED_TOOL_NAMES: &[&str] = &[
    "complexity_metrics",
    "dependency_impact",
    "direct_callees",
    "direct_callers",
    "export_graph",
    "find_cycles",
    "find_unused",
    "is_node_in_cycle",
    "rebuild_index",
    "relation_query",
    "semantic_diff",
    "semantic_search",
    "show_dependencies",
    "sqry_ask",
    "subgraph",
    "trace_path",
];

/// Return the rmcp Tool schema list filtered to only the 16
/// daemon-supported tools. The daemon MCP host
/// (`sqry-daemon::mcp_host`, Phase 8c U8) calls this in its
/// `ServerHandler::list_tools`.
///
/// Delegates to [`crate::server::SqryServer::get_filtered_tools`] then
/// filters by [`DAEMON_SUPPORTED_TOOL_NAMES`]. The feature-flag filter
/// still applies — daemon-host tools are additionally subject to
/// [`crate::feature_flags::FeatureFlags::from_env`]. When a feature
/// flag disables one of the 16 names, the returned vec will be
/// shorter than 16.
#[must_use]
pub fn daemon_supported_tools() -> Vec<rmcp::model::Tool> {
    use crate::feature_flags::FeatureFlags;
    use crate::server::SqryServer;
    let server = SqryServer::new(FeatureFlags::from_env());
    server
        .get_filtered_tools()
        .into_iter()
        .filter(|t| DAEMON_SUPPORTED_TOOL_NAMES.contains(&t.name.as_ref()))
        .collect()
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::collections::HashSet;

    /// `DAEMON_SUPPORTED_TOOL_NAMES` must contain exactly 16 names and
    /// they must be sorted / deduplicated. Assertion guards against
    /// accidental addition or duplication that would desync from
    /// sqry-daemon's `dispatch_tool` match plus the NL07 `sqry_ask`
    /// route.
    #[test]
    fn daemon_supported_tool_names_is_exactly_16_sorted_unique() {
        assert_eq!(
            DAEMON_SUPPORTED_TOOL_NAMES.len(),
            16,
            "DAEMON_SUPPORTED_TOOL_NAMES must contain exactly 16 tools"
        );

        // Sorted.
        let mut sorted = DAEMON_SUPPORTED_TOOL_NAMES.to_vec();
        sorted.sort_unstable();
        assert_eq!(
            sorted.as_slice(),
            DAEMON_SUPPORTED_TOOL_NAMES,
            "DAEMON_SUPPORTED_TOOL_NAMES must be alphabetically sorted"
        );

        // Unique.
        let set: HashSet<&str> = DAEMON_SUPPORTED_TOOL_NAMES.iter().copied().collect();
        assert_eq!(
            set.len(),
            DAEMON_SUPPORTED_TOOL_NAMES.len(),
            "DAEMON_SUPPORTED_TOOL_NAMES must contain no duplicates"
        );
    }

    /// With default feature flags (no env flags set), all 16 names must
    /// appear in `daemon_supported_tools()`. If the test harness sets
    /// `SQRY_MCP_FLAGS` env vars that disable one of the 16, this
    /// assertion may need narrowing — but the intent of the default
    /// daemon surface is exactly 16.
    #[test]
    fn daemon_supported_tools_returns_exact_16_under_default_flags() {
        let tools = daemon_supported_tools();
        let names: HashSet<&str> = tools.iter().map(|t| t.name.as_ref()).collect();
        let expected: HashSet<&str> = DAEMON_SUPPORTED_TOOL_NAMES.iter().copied().collect();
        assert_eq!(
            names,
            expected,
            "daemon_supported_tools must return exactly the 16 DAEMON_SUPPORTED_TOOL_NAMES \
             (default feature flags). Got {} tools, expected 16.",
            tools.len()
        );
    }

    /// C045 — exact-gap pin between the standalone and daemon tool
    /// surfaces. With C091 enabling `expand_cache_status` at runtime,
    /// the standalone inventory is **36 tools** and the daemon subset
    /// is **16 tools** (per `DAEMON_SUPPORTED_TOOL_NAMES`), giving a
    /// strict gap of **20 standalone-only tools**.
    ///
    /// This constant is the canonical CI guard: any change to either
    /// `DAEMON_SUPPORTED_TOOL_NAMES` or the rmcp-registered standalone
    /// tools that would change the gap MUST update this pin in the
    /// same PR. The
    /// [`daemon_supported_tool_names_is_strict_subset_of_standalone`]
    /// test asserts the live measurement matches this constant.
    pub const EXPECTED_STANDALONE_ONLY_COUNT: usize = 20;

    /// Every `DAEMON_SUPPORTED_TOOL_NAMES` entry must appear in the
    /// standalone `SqryServer::get_filtered_tools()` inventory — the
    /// daemon subset is a STRICT subset of the standalone 36-tool
    /// surface. Also verifies the standalone inventory is strictly
    /// larger by exactly [`EXPECTED_STANDALONE_ONLY_COUNT`] (= 20)
    /// tools — the strict gap is pinned to guard against silent
    /// drift on either side of the partition.
    #[test]
    fn daemon_supported_tool_names_is_strict_subset_of_standalone() {
        use crate::feature_flags::FeatureFlags;
        use crate::server::SqryServer;
        let server = SqryServer::new(FeatureFlags::from_env());
        let standalone_names: HashSet<String> = server
            .get_filtered_tools()
            .into_iter()
            .map(|t| t.name.as_ref().to_owned())
            .collect();
        for &daemon_name in DAEMON_SUPPORTED_TOOL_NAMES {
            assert!(
                standalone_names.contains(daemon_name),
                "daemon-supported tool {daemon_name:?} not found in standalone inventory \
                 (DAEMON_SUPPORTED_TOOL_NAMES must be a strict subset of \
                 SqryServer::get_filtered_tools)"
            );
        }
        // Standalone has strictly more tools (the standalone-only set).
        assert!(
            standalone_names.len() > DAEMON_SUPPORTED_TOOL_NAMES.len(),
            "standalone inventory ({} tools) must be strictly larger than daemon subset ({} tools) — \
             otherwise the daemon-subset rationale is broken",
            standalone_names.len(),
            DAEMON_SUPPORTED_TOOL_NAMES.len()
        );
        // C045 — pin the exact gap. If this fails: either the rmcp
        // tool registry or DAEMON_SUPPORTED_TOOL_NAMES changed; update
        // EXPECTED_STANDALONE_ONLY_COUNT and the matching documentation
        // (sqry-mcp/README.md, docs/FEATURE_LIST.md, README.md) in the
        // same PR.
        let actual_gap = standalone_names.len() - DAEMON_SUPPORTED_TOOL_NAMES.len();
        assert_eq!(
            actual_gap,
            EXPECTED_STANDALONE_ONLY_COUNT,
            "standalone-only tool count drift: expected {EXPECTED_STANDALONE_ONLY_COUNT} \
             standalone-only tools, found {actual_gap} (standalone={}, daemon={}). \
             Update EXPECTED_STANDALONE_ONLY_COUNT and matching docs in the same PR.",
            standalone_names.len(),
            DAEMON_SUPPORTED_TOOL_NAMES.len()
        );
    }
}