97 lines
3.3 KiB
TypeScript
97 lines
3.3 KiB
TypeScript
import { describe, expect } from "vitest";
|
|
|
|
import { workspaceCliTest } from "../../support/cli/workspaceCliFixture.js";
|
|
|
|
const CLI_INTEGRATION_TIMEOUT_MS = 60_000;
|
|
|
|
const EXPECTED_HELP = [
|
|
"rea mcp doctor — Validate MCP server startup and tool listing",
|
|
"",
|
|
"Usage: rea mcp doctor [options]",
|
|
"",
|
|
"Options:",
|
|
" --format <toon|json|yaml|md|jsonl> Output format",
|
|
" --json Emit the report as JSON",
|
|
" --full-output Show the full output envelope",
|
|
" --help, -h Show help",
|
|
"",
|
|
"This entry accepts only the options above.",
|
|
"",
|
|
].join("\n");
|
|
|
|
describe("MCP doctor help boundary", () => {
|
|
workspaceCliTest(
|
|
"answers the advertised help option instead of validating it",
|
|
async ({ cli }) => {
|
|
for (const argument of ["--help", "-h"]) {
|
|
const result = await cli.run({
|
|
arguments: ["mcp", "doctor", argument],
|
|
});
|
|
expect(result).toMatchObject({ exitCode: 0 });
|
|
expect(result.stdout).toBe(EXPECTED_HELP);
|
|
// Help returns before the diagnostic session starts, so no report
|
|
// envelope and no startup diagnostics are produced.
|
|
expect(result.stdout).not.toContain("healthy");
|
|
expect(result.stderr).toBe("");
|
|
}
|
|
},
|
|
CLI_INTEGRATION_TIMEOUT_MS,
|
|
);
|
|
|
|
workspaceCliTest(
|
|
"answers help in option position regardless of surrounding output options",
|
|
async ({ cli }) => {
|
|
for (const arguments_ of [
|
|
["mcp", "doctor", "--json", "--help"],
|
|
["mcp", "doctor", "--format", "bogus", "--help"],
|
|
["mcp", "doctor", "--help", "--format", "json"],
|
|
]) {
|
|
const result = await cli.run({ arguments: arguments_ });
|
|
expect(result).toMatchObject({ exitCode: 0 });
|
|
expect(result.stdout).toContain("Usage: rea mcp doctor [options]");
|
|
expect(result.stdout).toContain("--help, -h");
|
|
expect(result.stdout).not.toContain("healthy");
|
|
}
|
|
},
|
|
CLI_INTEGRATION_TIMEOUT_MS,
|
|
);
|
|
|
|
workspaceCliTest(
|
|
"treats help consumed as --format value as an invalid format, not help",
|
|
async ({ cli }) => {
|
|
for (const arguments_ of [
|
|
["mcp", "doctor", "--format", "--help"],
|
|
["mcp", "doctor", "--format", "-h"],
|
|
["mcp", "doctor", "--format=--help"],
|
|
]) {
|
|
const result = await cli.run({ arguments: arguments_ });
|
|
expect(result).toMatchObject({ exitCode: 1 });
|
|
expect(result.stdout).toContain("Invalid output format:");
|
|
expect(result.stdout).not.toContain("Usage: rea mcp doctor");
|
|
}
|
|
},
|
|
CLI_INTEGRATION_TIMEOUT_MS,
|
|
);
|
|
|
|
workspaceCliTest(
|
|
"keeps the actionable error for a genuinely unknown option",
|
|
async ({ cli }) => {
|
|
const result = await cli.run({ arguments: ["mcp", "doctor", "--bogus"] });
|
|
expect(result).toMatchObject({
|
|
exitCode: 1,
|
|
stdout:
|
|
'code: VALIDATION_ERROR\nmessage: "Unknown mcp doctor option: --bogus"\n',
|
|
});
|
|
const invalid = await cli.run({
|
|
arguments: ["mcp", "doctor", "--format", "bogus"],
|
|
});
|
|
expect(invalid).toMatchObject({
|
|
exitCode: 1,
|
|
stdout:
|
|
'code: VALIDATION_ERROR\nmessage: "Invalid output format: bogus"\n',
|
|
});
|
|
},
|
|
CLI_INTEGRATION_TIMEOUT_MS,
|
|
);
|
|
});
|