trusty-mpm 1.8.2

trusty-mpm: unified multi-agent orchestration platform (core, daemon, CLI, TUI, Telegram)
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

//! `tm mcp` user-scope MCP-server registry command group.
//!
//! Why: extracted from `cli.rs` (issue #2603) to keep the top-level file
//! under the 500-SLOC production cap — see `cli/mod.rs` for the split
//! rationale shared by every `cli/actions/*.rs` module.
//! What: [`McpCmd`] (the `tm mcp add|remove|list|get|test` verbs) and
//! [`McpTransportArg`] (its `-t/--transport` value enum).
//! Test: `cli_parses_mcp_*` in `tests.rs`.

use clap::Subcommand;

/// Verbs for the `tm mcp` user-scope MCP-server registry command group.
///
/// Why: mirrors the `claude mcp add|remove|list|get` UX so operators moving
/// between the stock CLI and tm get the same surface, while pointing writes at
/// tm's managed config dir instead of `~/.claude.json`.
/// What: `Add` upserts a stdio/http/sse server, `Remove` drops one, `List`
/// enumerates them, `Get` shows one. Every verb accepts `--root` to switch from
/// the daemon-managed dir to a standalone root.
/// Test: `cli_parses_mcp_add`, `cli_parses_mcp_add_http`, `cli_parses_mcp_remove`,
/// `cli_parses_mcp_list`, `cli_parses_mcp_get` in `tests.rs`.
#[derive(Debug, Subcommand)]
pub(crate) enum McpCmd {
    /// Add (or replace) a user-scope MCP server.
    ///
    /// stdio (default): `tm mcp add <name> [-e KEY=VAL]... <command> [-- <args>...]`
    /// http/sse:        `tm mcp add <name> -t http [-H "K: V"]... <url>`
    Add {
        /// Server name (the `mcpServers` key).
        name: String,
        /// Transport: `stdio` (local subprocess), `http`, or `sse` (remote).
        #[arg(short = 't', long = "transport", value_enum, default_value_t = McpTransportArg::Stdio)]
        transport: McpTransportArg,
        /// Environment variable for a stdio server (repeatable): `KEY=VALUE`.
        #[arg(short = 'e', long = "env", value_name = "KEY=VALUE")]
        env: Vec<String>,
        /// HTTP header for an http/sse server (repeatable): `Name: Value`.
        #[arg(short = 'H', long = "header", value_name = "NAME: VALUE")]
        header: Vec<String>,
        /// The command/URL followed by any stdio subprocess args, mirroring
        /// `claude mcp add`. The FIRST token is the command (stdio) or URL
        /// (http/sse); the rest are subprocess args (stdio only). A leading `--`
        /// stops flag parsing so hyphen-led args pass through
        /// (e.g. `-- npx -y some-pkg`). All `-t`/`-e`/`-H`/`--root` options must
        /// precede this token.
        #[arg(
            trailing_var_arg = true,
            allow_hyphen_values = true,
            value_name = "COMMAND_OR_URL [ARGS...]"
        )]
        command_and_args: Vec<String>,
        /// Override the managed root (switches to the standalone config dir).
        ///
        /// Note: do NOT use `env = "TRUSTY_MPM_ROOT"` here — see `Register`.
        #[arg(long)]
        root: Option<String>,
        /// Declare the server in THIS project's `.mcp.json` instead of the
        /// user scope.
        ///
        /// One declaration point, tracked in git, reviewed in the PR that
        /// needed it. Claude Code approves project-scope servers itself
        /// (`enableAllProjectMcpServers` / `enabledMcpjsonServers`, or its
        /// prompt). Without the flag the server goes to the user scope, where
        /// it loads in every tm session with no grant (#7892).
        #[arg(long)]
        project: bool,
        /// Retired by #7892; accepted and ignored.
        ///
        /// A user-scope server already loads in every project, so there is
        /// nothing left to share.
        #[arg(long = "share-with-projects")]
        share_with_projects: bool,
    },
    /// Retired by #7892; prints why and does nothing.
    ///
    /// Kept so scripts and runbooks that spell it keep exiting zero.
    Share {
        /// Server name (accepted, unused).
        name: String,
        /// Accepted and ignored — there is no per-root share state left.
        #[arg(long)]
        root: Option<String>,
    },
    /// Retired by #7892; prints why and does nothing.
    Unshare {
        /// Server name (accepted, unused).
        name: String,
        /// Accepted and ignored — there is no per-root share state left.
        #[arg(long)]
        root: Option<String>,
    },
    /// Remove a user-scope MCP server by name.
    Remove {
        /// Server name to remove.
        name: String,
        /// Override the managed root (switches to the standalone config dir).
        #[arg(long)]
        root: Option<String>,
    },
    /// List all user-scope MCP servers in the tm config dir.
    ///
    /// Each row is marked `opted-in` or `scoped-out` for the current project
    /// (#7422): a `scoped-out` server is declared here but will NOT load in a
    /// session started in this directory.
    List {
        /// Output as JSON instead of a table.
        #[arg(long)]
        json: bool,
        /// Override the managed root (switches to the standalone config dir).
        #[arg(long)]
        root: Option<String>,
    },
    /// Show one user-scope MCP server's definition.
    Get {
        /// Server name to show.
        name: String,
        /// Output as JSON instead of a table.
        #[arg(long)]
        json: bool,
        /// Override the managed root (switches to the standalone config dir).
        #[arg(long)]
        root: Option<String>,
    },
    /// Verify MCP servers by running a real handshake against each.
    ///
    /// Bare (`tm mcp test`): sweeps every user-scope server unioned with the
    /// three framework built-ins. `tm mcp test <name>`: tests just that server.
    /// stdio servers get a full `initialize` → `tools/list` handshake (reporting
    /// the tool count); http/sse servers get an HTTP reachability check. Exits
    /// non-zero if ANY tested server fails, so it is CI-usable.
    Test {
        /// Optional server name; omit to sweep all servers + built-ins.
        name: Option<String>,
        /// Output as JSON instead of a table.
        #[arg(long)]
        json: bool,
        /// Override the managed root (switches to the standalone config dir).
        #[arg(long)]
        root: Option<String>,
    },
}

/// Transport choice for `tm mcp add` (clap `ValueEnum` mirror of
/// [`trusty_mpm::core::mcp_config::McpTransport`]).
///
/// Why: clap needs a `ValueEnum` for `-t/--transport`; keeping it a thin mirror
/// of the core enum avoids leaking clap into the library crate.
/// What: `Stdio` | `Http` | `Sse`.
/// Test: `cli_parses_mcp_add_http` exercises the non-default value.
#[derive(Debug, Clone, Copy, PartialEq, Eq, clap::ValueEnum)]
pub(crate) enum McpTransportArg {
    /// Local subprocess speaking MCP over stdio.
    Stdio,
    /// Remote streamable-HTTP endpoint.
    Http,
    /// Remote SSE endpoint.
    Sse,
}