Files
zero/internal/cli/mcp_commands_test.go
beardthelionandKevin Codex a880ce80a6 feat: gate project-scoped hooks, plugins, and MCP servers behind workspace trust (#529)
* feat(workspacetrust): add exact-match trust store for project config gating

* feat(hooks): add ExcludeProject option to LoadConfig

* feat(plugins): add ExcludeProject option to Load

* feat(cli): gate project hooks and plugins behind workspace trust

Trust check lives inside newHookDispatcherWithExtra and activatePlugins
(fail-closed by construction); trustRoot is the original launch dir so a
--worktree run inherits the source repo's trust. Callers OR the skip
reports and emit one combined stderr notice.

* feat(cli): add zero trust command (trust/list/remove)

* fix(review): key spec-draft trust on the original launch dir; cover trust CLI edge branches

Spec-draft runs (zero exec --use-spec --worktree) passed the reassigned
worktree path as trustRoot, dropping a trusted repo's project hooks
(fail-closed, but breaks worktree-inheritance). Thread the captured
pre-worktree trustRoot into execSpecDraftRun. Add tests for the trust
'remove' too-many-args and --help branches, and a resolveTrust comment
noting the per-chokepoint check must not be hoisted to callers.

* test(cli): end-to-end trust-gate coverage through agent.Run and exec --worktree

Drives the real agent loop with a fake tool-calling provider so a project
beforeTool hook actually fires (or is gated away) through production code:
gate blocks a tool call via agent.Run, and --worktree / --use-spec --worktree
key trust on the original launch dir. All three are load-bearing (RED when the
gate or the trustRoot threading regresses).

* style(cli): gofmt struct alignment in exec_spec.go

* fix(workspacetrust): compare stored trust entries literally, no symlink re-resolution

External adversarial review (codex) found a false positive: IsTrusted
re-normalized stored entries on every check (Abs+EvalSymlinks), so a trusted
path later replaced by a symlink to attacker content re-resolved to the new
target and matched. Stored entries are already canonical (normalized once at
Trust time); compare them as literals and only normalize the incoming query.
Add a regression test for the symlink-retarget case.

* feat(mcp): gate project-scoped MCP servers behind workspace trust

Closes the P0 an external adversarial review (codex) found: project
./.zero/config.json stdio MCP servers spawned before the hook/plugin gate,
an ungated arbitrary-execution path that could also self-trust the workspace.
Add ExcludeProject to config.ResolveMCP (skips the project layer) and thread a
fail-closed trust check into every MCP spawn site (exec, TUI setup+refresh,
mcp tools list, mcp check); reporting sites stay ungated. Verified the sole
server-command exec (mcp/client.go) is reachable only through the now-gated
RegisterTools paths.

* test(cli): cover default-mode beforeTool firing through the trust gate

Assert a project beforeTool hook fires in the default auto and ask permission
modes (not only under unsafe), and is blocked when the workspace is untrusted,
so the gate is verified in the mode a normal run actually uses.

* docs(cli): note MCP servers in zero trust help text and doc comment

The gate covers project hooks, plugins, and MCP servers, but the help string and
runTrust doc comment listed only hooks and plugins.

* test(cli): make workspace-trust tests portable on macOS and Windows

setTrustConfigRoot set HOME on darwin, but config.UserConfigDir is XDG-first
there (=$HOME/.config), so tests wrote trust.json and user hooks.json where the
code never read them; set XDG_CONFIG_HOME on every non-Windows platform instead.

writeMarkerHook shells out to /bin/sh, absent on Windows, so its trusted-case
marker never appeared; skip it there like writeMarkerHookScript already does.

TestRunTrustAddThenList compared `trust list` output (canonicalized via
EvalSymlinks) against the raw cwd, which diverges on the Windows runner's 8.3
short names (RUNNER~1 -> runneradmin); compare the resolved path, and add
TestRunTrustListShowsCanonicalPath to exercise that via a symlink on any platform.

* feat(cli): surface the project MCP skip in the workspace-trust notice

Project MCP servers were dropped silently in an untrusted workspace: the trust
notice covered hooks and plugins but not MCP, and app.go discarded the
resolveTrust error. registerMCPToolsForWorkspace now returns a trustSkip, gated
on a new projectMCPConfigExists check plus the previously-dropped store-read
error, and emitTrustNotice is variadic so the exec, spec-draft, interactive, and
`mcp tools list` paths all fold in the MCP skip.

The skip drives the notice only; the gate stays on resolveTrust/excludeProject,
so a trusted workspace is unaffected and an untrusted one still fails closed.

* fix(cli): print zero trust --help to stdout with a success exit

zero trust -h/--help/help routed usage to stderr with the usage exit code, unlike
every other subcommand (mcp, sandbox, skills, cron, ...) which prints help to
stdout and returns success. Align it; the unknown-subcommand path still writes to
stderr with the usage exit code.

* fix(cli): gate oauth MCP login and surface mcp-check trust notice

Two project-scoped MCP activation sites were left outside the workspace
trust gate.

zero mcp oauth login loaded a project-defined OAuth server from an
untrusted workspace and ran the full discovery/registration/token-exchange
flow against its configured URL. Gate resolveOAuthServer with resolveTrust
so an untrusted clone's ./.zero/config.json OAuth server is dropped before
login, and emit the same one-line trust notice the other spawn sites use.

zero mcp check already gated the project layer but discarded the trust-check
result and never emitted the notice, so a gated project server read as a
bare "not configured". Emit the notice on the not-found branch.

The three remaining ungated resolveMCPConfig(cwd, false) sites (backends
doctor/snapshot and the extensions listing) are enumeration-only and stay
ungated.

* test(cli): adapt MCP startup-skip tests to two-arg resolveMCPConfig

---------

Co-authored-by: Kevin Codex <[email protected]>
2026-07-09 10:51:09 +08:00

762 lines
27 KiB
Go

package cli
import (
"bytes"
"context"
"encoding/json"
"os"
"path/filepath"
"reflect"
"strings"
"testing"
"github.com/Gitlawb/zero/internal/config"
"github.com/Gitlawb/zero/internal/mcp"
"github.com/Gitlawb/zero/internal/tools"
)
func TestRunMCPAddStdioPersistsUserConfig(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "docs", "--env", "DOCS_TOKEN=secret", "--", "docs-mcp", "--port", "123"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
cfg := readMCPCommandConfig(t, configPath)
server, ok := cfg.MCP.Servers["docs"]
if !ok {
t.Fatalf("docs server was not persisted: %#v", cfg.MCP.Servers)
}
if server.Type != "stdio" || server.Command != "docs-mcp" {
t.Fatalf("server = %#v, want stdio docs-mcp", server)
}
if !reflect.DeepEqual(server.Args, []string{"--port", "123"}) {
t.Fatalf("Args = %#v, want --port 123", server.Args)
}
if got := server.Env["DOCS_TOKEN"]; got != "secret" {
t.Fatalf("Env[DOCS_TOKEN] = %q, want secret", got)
}
if strings.Contains(stdout.String(), "secret") {
t.Fatalf("stdout leaked env value: %s", stdout.String())
}
}
func TestRunMCPAddHTTPPreservesConfigAndRedactsHeader(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"activeProvider": "fast",
"futureTop": {"keep": true},
"mcp": {
"futureMCP": "keep",
"servers": {
"other": {
"type": "http",
"url": "https://other.example/mcp",
"futureServer": "keep"
}
}
}
}
`)
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "remote", "--url", "https://remote.example/mcp", "--header", "Authorization=Bearer secret-header", "--json"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
if strings.Contains(stdout.String(), "secret-header") {
t.Fatalf("stdout leaked header value: %s", stdout.String())
}
if !strings.Contains(stdout.String(), "[REDACTED]") {
t.Fatalf("stdout did not redact header value: %s", stdout.String())
}
cfg := readMCPCommandConfig(t, configPath)
remote := cfg.MCP.Servers["remote"]
if remote.Type != "http" || remote.URL != "https://remote.example/mcp" {
t.Fatalf("remote server = %#v, want default http type with URL", remote)
}
if got := remote.Headers["Authorization"]; got != "Bearer secret-header" {
t.Fatalf("Authorization header = %q, want persisted secret", got)
}
raw := readMCPCommandRawConfig(t, configPath)
if _, ok := raw["futureTop"]; !ok {
t.Fatalf("top-level unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, raw))
}
mcpRaw := rawMCPCommandObject(t, raw["mcp"])
if _, ok := mcpRaw["futureMCP"]; !ok {
t.Fatalf("mcp unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, mcpRaw))
}
serversRaw := rawMCPCommandObject(t, mcpRaw["servers"])
otherRaw := rawMCPCommandObject(t, serversRaw["other"])
if _, ok := otherRaw["futureServer"]; !ok {
t.Fatalf("unrelated server unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, otherRaw))
}
}
func TestRunMCPAddHTTPAcceptsColonHeader(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "remote", "--url", "https://remote.example/mcp", "--header", "Authorization: Bearer secret-header"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stdout=%s stderr=%s", exitCode, stdout.String(), stderr.String())
}
cfg := readMCPCommandConfig(t, configPath)
remote := cfg.MCP.Servers["remote"]
if got := remote.Headers["Authorization"]; got != "Bearer secret-header" {
t.Fatalf("Authorization header = %q, want persisted Bearer secret-header", got)
}
}
func TestRunMCPAddDisabledHTTPAllowsInvalidURL(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "draft", "--type", "http", "--url", "sxas", "--disabled"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stdout=%s stderr=%s", exitCode, stdout.String(), stderr.String())
}
cfg := readMCPCommandConfig(t, configPath)
draft := cfg.MCP.Servers["draft"]
if !draft.Disabled {
t.Fatalf("draft server Disabled = false, want true: %#v", draft)
}
if draft.Type != "http" || draft.URL != "sxas" {
t.Fatalf("draft server = %#v, want disabled http with raw invalid URL", draft)
}
}
func TestRunMCPAddUpdatePreservesUnknownServerFields(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"mcp": {
"servers": {
"remote": {
"type": "http",
"url": "https://old.example/mcp",
"headers": {"Authorization": "Bearer old"},
"disabled": true,
"futureServer": {"keep": true}
}
}
}
}
`)
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "remote", "--url", "https://new.example/mcp", "--header", "X-Api-Key=new-secret", "--json"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stdout=%s stderr=%s", exitCode, stdout.String(), stderr.String())
}
raw := readMCPCommandRawConfig(t, configPath)
mcpRaw := rawMCPCommandObject(t, raw["mcp"])
serversRaw := rawMCPCommandObject(t, mcpRaw["servers"])
remoteRaw := rawMCPCommandObject(t, serversRaw["remote"])
if _, ok := remoteRaw["futureServer"]; !ok {
t.Fatalf("updated server unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, remoteRaw))
}
if got := string(remoteRaw["url"]); got != `"https://new.example/mcp"` {
t.Fatalf("url raw = %s, want new URL in %s", got, mustMarshalMCPCommandJSON(t, remoteRaw))
}
if _, ok := remoteRaw["disabled"]; ok {
t.Fatalf("disabled=false noise/stale disabled field should be removed: %s", mustMarshalMCPCommandJSON(t, remoteRaw))
}
headersRaw := rawMCPCommandObject(t, remoteRaw["headers"])
if _, ok := headersRaw["Authorization"]; ok {
t.Fatalf("stale Authorization header should not survive update: %s", mustMarshalMCPCommandJSON(t, headersRaw))
}
if got := string(headersRaw["X-Api-Key"]); got != `"new-secret"` {
t.Fatalf("X-Api-Key raw = %s, want persisted new secret in %s", got, mustMarshalMCPCommandJSON(t, headersRaw))
}
}
func TestRunMCPAddUpdatePreservesExistingOAuth(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"mcp": {
"servers": {
"remote": {
"type": "http",
"url": "https://old.example/mcp",
"auth": "oauth",
"oauth": {
"clientID": "client-123",
"scopes": ["docs:read"]
},
"futureServer": {"keep": true}
}
}
}
}
`)
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "remote", "--url", "https://new.example/mcp", "--json"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stdout=%s stderr=%s", exitCode, stdout.String(), stderr.String())
}
cfg := readMCPCommandConfig(t, configPath)
remote := cfg.MCP.Servers["remote"]
if remote.OAuth == nil || remote.OAuth.ClientID != "client-123" {
t.Fatalf("OAuth config was not preserved: %#v", remote.OAuth)
}
if remote.Auth != "oauth" {
t.Fatalf("Auth = %q, want preserved oauth", remote.Auth)
}
if got := remote.URL; got != "https://new.example/mcp" {
t.Fatalf("URL = %q, want updated URL", got)
}
raw := readMCPCommandRawConfig(t, configPath)
remoteRaw := rawMCPCommandObject(t, rawMCPCommandObject(t, rawMCPCommandObject(t, raw["mcp"])["servers"])["remote"])
if _, ok := remoteRaw["futureServer"]; !ok {
t.Fatalf("unknown server field was not preserved: %s", mustMarshalMCPCommandJSON(t, remoteRaw))
}
if _, ok := remoteRaw["oauth"]; !ok {
t.Fatalf("oauth raw field was not preserved: %s", mustMarshalMCPCommandJSON(t, remoteRaw))
}
if got := string(remoteRaw["auth"]); got != `"oauth"` {
t.Fatalf("auth raw = %s, want preserved oauth in %s", got, mustMarshalMCPCommandJSON(t, remoteRaw))
}
}
func TestRunMCPAddMigratesLegacyServerRawFields(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"mcpServers": {
"legacy": {
"type": "http",
"url": "https://old.example/mcp",
"auth": "oauth",
"oauth": {"clientID": "legacy-client"},
"futureLegacy": {"keep": true}
}
}
}
`)
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "add", "legacy", "--url", "https://new.example/mcp", "--json"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stdout=%s stderr=%s", exitCode, stdout.String(), stderr.String())
}
raw := readMCPCommandRawConfig(t, configPath)
if _, ok := raw["mcpServers"]; ok {
t.Fatalf("legacy mcpServers entry was not migrated: %s", mustMarshalMCPCommandJSON(t, raw))
}
legacyRaw := rawMCPCommandObject(t, rawMCPCommandObject(t, rawMCPCommandObject(t, raw["mcp"])["servers"])["legacy"])
for _, key := range []string{"oauth", "futureLegacy"} {
if _, ok := legacyRaw[key]; !ok {
t.Fatalf("legacy raw field %q was not preserved: %s", key, mustMarshalMCPCommandJSON(t, legacyRaw))
}
}
if got := string(legacyRaw["auth"]); got != `"oauth"` {
t.Fatalf("auth raw = %s, want preserved oauth in %s", got, mustMarshalMCPCommandJSON(t, legacyRaw))
}
if got := string(legacyRaw["url"]); got != `"https://new.example/mcp"` {
t.Fatalf("url raw = %s, want updated URL in %s", got, mustMarshalMCPCommandJSON(t, legacyRaw))
}
}
func TestRunMCPRemoveDeletesUserConfigServer(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandConfig(t, configPath, config.FileConfig{
MCP: config.MCPConfig{Servers: map[string]config.MCPServerConfig{
"docs": {Type: "stdio", Command: "docs-mcp"},
"other": {Type: "http", URL: "https://example.com/mcp"},
}},
})
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "remove", "docs", "--json"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
var payload struct {
ServerName string `json:"serverName"`
Removed bool `json:"removed"`
}
if err := json.Unmarshal(stdout.Bytes(), &payload); err != nil {
t.Fatalf("decode JSON: %v\n%s", err, stdout.String())
}
if payload.ServerName != "docs" || !payload.Removed {
t.Fatalf("payload = %#v, want docs removed", payload)
}
cfg := readMCPCommandConfig(t, configPath)
if _, ok := cfg.MCP.Servers["docs"]; ok {
t.Fatalf("docs server still present: %#v", cfg.MCP.Servers)
}
if _, ok := cfg.MCP.Servers["other"]; !ok {
t.Fatalf("remove dropped unrelated server: %#v", cfg.MCP.Servers)
}
}
func TestRunMCPToggleEnableDisablePreservesConfig(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"activeProvider": "fast",
"mcp": {
"futureMCP": "keep",
"servers": {
"docs": {
"type": "stdio",
"command": "docs-mcp",
"futureServer": "keep"
}
}
}
}
`)
var disableOut, disableErr bytes.Buffer
disableCode := runWithDeps([]string{"mcp", "disable", "docs", "--json"}, &disableOut, &disableErr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if disableCode != exitSuccess {
t.Fatalf("disable exitCode = %d stderr=%s", disableCode, disableErr.String())
}
var disablePayload struct {
ServerName string `json:"serverName"`
Disabled bool `json:"disabled"`
Changed bool `json:"changed"`
}
if err := json.Unmarshal(disableOut.Bytes(), &disablePayload); err != nil {
t.Fatalf("decode disable JSON: %v\n%s", err, disableOut.String())
}
if disablePayload.ServerName != "docs" || !disablePayload.Disabled || !disablePayload.Changed {
t.Fatalf("disable payload = %#v, want docs disabled changed", disablePayload)
}
cfg := readMCPCommandConfig(t, configPath)
if !cfg.MCP.Servers["docs"].Disabled {
t.Fatalf("server not disabled: %#v", cfg.MCP.Servers["docs"])
}
var enableOut, enableErr bytes.Buffer
enableCode := runWithDeps([]string{"mcp", "enable", "docs", "--json"}, &enableOut, &enableErr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if enableCode != exitSuccess {
t.Fatalf("enable exitCode = %d stderr=%s", enableCode, enableErr.String())
}
var enablePayload struct {
ServerName string `json:"serverName"`
Disabled bool `json:"disabled"`
Changed bool `json:"changed"`
}
if err := json.Unmarshal(enableOut.Bytes(), &enablePayload); err != nil {
t.Fatalf("decode enable JSON: %v\n%s", err, enableOut.String())
}
if enablePayload.ServerName != "docs" || enablePayload.Disabled || !enablePayload.Changed {
t.Fatalf("enable payload = %#v, want docs enabled changed", enablePayload)
}
raw := readMCPCommandRawConfig(t, configPath)
mcpRaw := rawMCPCommandObject(t, raw["mcp"])
if _, ok := mcpRaw["futureMCP"]; !ok {
t.Fatalf("mcp unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, mcpRaw))
}
serversRaw := rawMCPCommandObject(t, mcpRaw["servers"])
docsRaw := rawMCPCommandObject(t, serversRaw["docs"])
if _, ok := docsRaw["futureServer"]; !ok {
t.Fatalf("server unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, docsRaw))
}
if _, ok := docsRaw["disabled"]; ok {
t.Fatalf("enable should remove disabled=false noise: %s", mustMarshalMCPCommandJSON(t, docsRaw))
}
}
func TestRunMCPToggleMigratesLegacyServerAliases(t *testing.T) {
cases := []struct {
name string
aliasName string
}{
{name: "camel legacy alias", aliasName: "mcpServers"},
{name: "snake legacy alias", aliasName: "mcp_servers"},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"activeProvider": "fast",
"`+tc.aliasName+`": {
"docs": {
"type": "stdio",
"command": "docs-mcp",
"futureServer": "keep"
}
}
}
`)
var disableOut, disableErr bytes.Buffer
disableCode := runWithDeps([]string{"mcp", "disable", "docs", "--json"}, &disableOut, &disableErr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if disableCode != exitSuccess {
t.Fatalf("disable exitCode = %d stdout=%s stderr=%s", disableCode, disableOut.String(), disableErr.String())
}
var disablePayload struct {
ServerName string `json:"serverName"`
Disabled bool `json:"disabled"`
Changed bool `json:"changed"`
}
if err := json.Unmarshal(disableOut.Bytes(), &disablePayload); err != nil {
t.Fatalf("decode disable JSON: %v\n%s", err, disableOut.String())
}
if disablePayload.ServerName != "docs" || !disablePayload.Disabled || !disablePayload.Changed {
t.Fatalf("disable payload = %#v, want docs disabled changed", disablePayload)
}
raw := readMCPCommandRawConfig(t, configPath)
if _, ok := raw[tc.aliasName]; ok {
t.Fatalf("legacy alias %s should be migrated away: %s", tc.aliasName, mustMarshalMCPCommandJSON(t, raw))
}
mcpRaw := rawMCPCommandObject(t, raw["mcp"])
serversRaw := rawMCPCommandObject(t, mcpRaw["servers"])
docsRaw := rawMCPCommandObject(t, serversRaw["docs"])
if got := string(docsRaw["disabled"]); got != "true" {
t.Fatalf("disabled raw = %s, want true in canonical mcp.servers: %s", got, mustMarshalMCPCommandJSON(t, docsRaw))
}
if _, ok := docsRaw["futureServer"]; !ok {
t.Fatalf("server unknown field was not preserved during migration: %s", mustMarshalMCPCommandJSON(t, docsRaw))
}
var enableOut, enableErr bytes.Buffer
enableCode := runWithDeps([]string{"mcp", "enable", "docs", "--json"}, &enableOut, &enableErr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if enableCode != exitSuccess {
t.Fatalf("enable exitCode = %d stdout=%s stderr=%s", enableCode, enableOut.String(), enableErr.String())
}
raw = readMCPCommandRawConfig(t, configPath)
mcpRaw = rawMCPCommandObject(t, raw["mcp"])
serversRaw = rawMCPCommandObject(t, mcpRaw["servers"])
docsRaw = rawMCPCommandObject(t, serversRaw["docs"])
if _, ok := docsRaw["disabled"]; ok {
t.Fatalf("enable should remove disabled=false noise after migration: %s", mustMarshalMCPCommandJSON(t, docsRaw))
}
})
}
}
func TestRunMCPRemovePreservesUnrelatedConfigFields(t *testing.T) {
configPath := filepath.Join(t.TempDir(), "zero", "config.json")
writeMCPCommandRawConfig(t, configPath, `{
"activeProvider": "fast",
"futureTop": {"keep": true},
"mcp": {
"futureMCP": "keep",
"servers": {
"docs": {"type": "stdio", "command": "docs-mcp"},
"other": {
"type": "http",
"url": "https://other.example/mcp",
"futureServer": "keep"
}
}
}
}
`)
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "remove", "docs"}, &stdout, &stderr, appDeps{
userConfigPath: func() (string, error) { return configPath, nil },
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
cfg := readMCPCommandConfig(t, configPath)
if _, ok := cfg.MCP.Servers["docs"]; ok {
t.Fatalf("docs server still present: %#v", cfg.MCP.Servers)
}
raw := readMCPCommandRawConfig(t, configPath)
if _, ok := raw["futureTop"]; !ok {
t.Fatalf("top-level unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, raw))
}
mcpRaw := rawMCPCommandObject(t, raw["mcp"])
if _, ok := mcpRaw["futureMCP"]; !ok {
t.Fatalf("mcp unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, mcpRaw))
}
serversRaw := rawMCPCommandObject(t, mcpRaw["servers"])
if _, ok := serversRaw["docs"]; ok {
t.Fatalf("docs server raw JSON still present: %s", mustMarshalMCPCommandJSON(t, serversRaw))
}
otherRaw := rawMCPCommandObject(t, serversRaw["other"])
if _, ok := otherRaw["futureServer"]; !ok {
t.Fatalf("unrelated server unknown field was not preserved: %s", mustMarshalMCPCommandJSON(t, otherRaw))
}
}
func TestRunMCPListRedactsURLCredentialsAndSensitiveQueryParams(t *testing.T) {
cwd := t.TempDir()
serverURL := "https://user:[email protected]/mcp?access_token=secret-token&api_key=secret-key&safe=value#access_token=fragment-secret"
commandSecret := "sk-proj-" + strings.Repeat("a", 24)
deps := appDeps{
getwd: func() (string, error) { return cwd, nil },
resolveMCPConfig: func(workspaceRoot string, _ bool) (config.MCPConfig, error) {
if workspaceRoot != cwd {
t.Fatalf("workspaceRoot = %q, want %q", workspaceRoot, cwd)
}
return config.MCPConfig{Servers: map[string]config.MCPServerConfig{
"remote": {Type: "http", URL: serverURL},
"stdio": {Type: "stdio", Command: commandSecret},
}}, nil
},
}
for _, args := range [][]string{
{"mcp", "list"},
{"mcp", "list", "--json"},
} {
t.Run(strings.Join(args, " "), func(t *testing.T) {
var stdout, stderr bytes.Buffer
exitCode := runWithDeps(args, &stdout, &stderr, deps)
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
output := stdout.String()
for _, leaked := range []string{"user:password", "secret-token", "secret-key", "fragment-secret", "access_token=secret-token", "api_key=secret-key", "access_token=fragment-secret", commandSecret} {
if strings.Contains(output, leaked) {
t.Fatalf("mcp list leaked %q in output:\n%s", leaked, output)
}
}
if !strings.Contains(output, "remote.example") {
t.Fatalf("mcp list dropped non-sensitive URL context:\n%s", output)
}
if !strings.Contains(output, "[REDACTED]") {
t.Fatalf("mcp list did not mark redacted URL parts:\n%s", output)
}
})
}
}
func TestRunMCPCheckRegistersOnlyRequestedServer(t *testing.T) {
cwd := t.TempDir()
var registered config.MCPConfig
closed := false
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "check", "docs", "--json"}, &stdout, &stderr, appDeps{
getwd: func() (string, error) { return cwd, nil },
resolveMCPConfig: func(workspaceRoot string, _ bool) (config.MCPConfig, error) {
if workspaceRoot != cwd {
t.Fatalf("workspaceRoot = %q, want %q", workspaceRoot, cwd)
}
return config.MCPConfig{Servers: map[string]config.MCPServerConfig{
"docs": {Type: "stdio", Command: "docs-mcp"},
"other": {Type: "stdio", Command: "other-mcp"},
}}, nil
},
newMCPStore: func() (*mcp.PermissionStore, error) {
return mcp.NewPermissionStore(mcp.StoreOptions{FilePath: filepath.Join(t.TempDir(), "permissions.json")})
},
registerMCPTools: func(ctx context.Context, registry *tools.Registry, cfg config.MCPConfig, options mcp.RegisterOptions) (mcpToolRuntime, error) {
registered = cfg
registry.Register(cliFakeMCPRegistryTool{})
return closeFunc(func() error {
closed = true
return nil
}), nil
},
})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
if _, ok := registered.Servers["docs"]; !ok || len(registered.Servers) != 1 {
t.Fatalf("registered cfg = %#v, want only docs", registered.Servers)
}
if !closed {
t.Fatal("MCP runtime was not closed")
}
var payload struct {
ServerName string `json:"serverName"`
Status string `json:"status"`
ToolCount int `json:"toolCount"`
Tools []mcpToolListItem `json:"tools"`
}
if err := json.Unmarshal(stdout.Bytes(), &payload); err != nil {
t.Fatalf("decode JSON: %v\n%s", err, stdout.String())
}
if payload.ServerName != "docs" || payload.Status != "ok" || payload.ToolCount != 1 || len(payload.Tools) != 1 {
t.Fatalf("payload = %#v, want docs ok with one tool", payload)
}
}
func TestRunMCPCheckClosesRuntimeReturnedWithError(t *testing.T) {
cwd := t.TempDir()
closed := false
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "check", "docs"}, &stdout, &stderr, appDeps{
getwd: func() (string, error) { return cwd, nil },
resolveMCPConfig: func(workspaceRoot string, _ bool) (config.MCPConfig, error) {
return config.MCPConfig{Servers: map[string]config.MCPServerConfig{
"docs": {Type: "stdio", Command: "docs-mcp"},
}}, nil
},
newMCPStore: func() (*mcp.PermissionStore, error) {
return mcp.NewPermissionStore(mcp.StoreOptions{FilePath: filepath.Join(t.TempDir(), "permissions.json")})
},
registerMCPTools: func(ctx context.Context, registry *tools.Registry, cfg config.MCPConfig, options mcp.RegisterOptions) (mcpToolRuntime, error) {
return closeFunc(func() error {
closed = true
return nil
}), os.ErrPermission
},
})
if exitCode != exitCrash {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
if !closed {
t.Fatal("MCP runtime returned with error was not closed")
}
}
func TestRunMCPConfigCommandsReportCommandSpecificUnknownFlags(t *testing.T) {
cases := []struct {
name string
args []string
want string
}{
{name: "remove", args: []string{"mcp", "remove", "docs", "--bogus"}, want: `unknown mcp remove flag "--bogus"`},
{name: "check", args: []string{"mcp", "check", "docs", "--bogus"}, want: `unknown mcp check flag "--bogus"`},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
var stdout, stderr bytes.Buffer
exitCode := runWithDeps(tc.args, &stdout, &stderr, appDeps{})
if exitCode != exitUsage {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
if !strings.Contains(stderr.String(), tc.want) {
t.Fatalf("stderr missing %q:\n%s", tc.want, stderr.String())
}
if strings.Contains(stderr.String(), "permissions") {
t.Fatalf("stderr referenced permissions parser:\n%s", stderr.String())
}
})
}
}
func TestRunMCPHelpMentionsConfigCommands(t *testing.T) {
var stdout, stderr bytes.Buffer
exitCode := runWithDeps([]string{"mcp", "--help"}, &stdout, &stderr, appDeps{})
if exitCode != exitSuccess {
t.Fatalf("exitCode = %d stderr=%s", exitCode, stderr.String())
}
for _, want := range []string{"add <server>", "remove <server>", "enable <server>", "disable <server>", "check <server>", "list", "oauth", "permissions", "tools"} {
if !strings.Contains(stdout.String(), want) {
t.Fatalf("help missing %q:\n%s", want, stdout.String())
}
}
}
func writeMCPCommandRawConfig(t *testing.T, path string, data string) {
t.Helper()
if err := os.MkdirAll(filepath.Dir(path), 0o700); err != nil {
t.Fatalf("create config dir: %v", err)
}
if err := os.WriteFile(path, []byte(data), 0o600); err != nil {
t.Fatalf("write config: %v", err)
}
}
func writeMCPCommandConfig(t *testing.T, path string, cfg config.FileConfig) {
t.Helper()
if err := os.MkdirAll(filepath.Dir(path), 0o700); err != nil {
t.Fatalf("create config dir: %v", err)
}
data, err := json.MarshalIndent(cfg, "", " ")
if err != nil {
t.Fatalf("encode config: %v", err)
}
data = append(data, '\n')
if err := os.WriteFile(path, data, 0o600); err != nil {
t.Fatalf("write config: %v", err)
}
}
func readMCPCommandConfig(t *testing.T, path string) config.FileConfig {
t.Helper()
data, err := os.ReadFile(path)
if err != nil {
t.Fatalf("read config: %v", err)
}
var cfg config.FileConfig
if err := json.Unmarshal(data, &cfg); err != nil {
t.Fatalf("decode config: %v\n%s", err, string(data))
}
return cfg
}
func readMCPCommandRawConfig(t *testing.T, path string) map[string]json.RawMessage {
t.Helper()
data, err := os.ReadFile(path)
if err != nil {
t.Fatalf("read raw config: %v", err)
}
var raw map[string]json.RawMessage
if err := json.Unmarshal(data, &raw); err != nil {
t.Fatalf("decode raw config: %v\n%s", err, string(data))
}
return raw
}
func rawMCPCommandObject(t *testing.T, data json.RawMessage) map[string]json.RawMessage {
t.Helper()
var raw map[string]json.RawMessage
if err := json.Unmarshal(data, &raw); err != nil {
t.Fatalf("decode raw object: %v\n%s", err, string(data))
}
return raw
}
func mustMarshalMCPCommandJSON(t *testing.T, value any) string {
t.Helper()
data, err := json.MarshalIndent(value, "", " ")
if err != nil {
t.Fatalf("marshal JSON: %v", err)
}
return string(data)
}