@mcpeak/cli 0.10.0 → 0.11.0

package/dist/index.mjs

@@ -1,2 +1,217 @@
-import { i as unavailableReplayDependencies, n as nodeRepairDependencies, r as run, t as COMMANDS } from "./src-BzVS8KXQ.mjs";
-export { COMMANDS, nodeRepairDependencies, run, unavailableReplayDependencies };
+import { a as nodeGenerateDependencies, c as GLOBAL_HELP, d as escapeTerminalText, f as version, i as runRepairCommand, l as commandDiscovery, n as runCli, o as nodeReviewIO, s as runGenerateCommand, t as parseTestCommand, u as commandHelp } from "./test-command-DEp9hrfH.mjs";
+import { readFile, writeFile } from "node:fs/promises";
+//#region src/index.ts
+const COMMANDS = [
+	"test",
+	"generate",
+	"repair",
+	"record",
+	"mock"
+];
+const unavailableDependencies = {
+	readFile: async () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	validateSuite: () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	connect: async () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	startRunner: () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	finalize: async () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	renderReport: () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	renderJUnit: () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	writeFile: async () => {
+		throw new Error("runtime dependencies unavailable");
+	},
+	colorEnabled: false,
+	writeStdout: (text) => process.stdout.write(text),
+	writeStderr: (text) => process.stderr.write(text)
+};
+const unavailableRuntimeDependencies = {
+	...unavailableDependencies,
+	readFile
+};
+/**
+* `repair` 실행 의존성. 함수로 빼 둔 이유는 **주입 자체를 테스트가 단언할 수 있게** 하기
+* 위해서다. 분기 안에 리터럴로 두면 `reviewIO` 를 빠뜨려도 아무 테스트도 안 깨진다.
+* 실제로 그렇게 한 번 빠뜨렸다(T10 보고서).
+*
+* 대화형 판정은 `generate` 와 같은 기준이다. 같은 `nodeReviewIO()` 를 쓰고, 그 구현이
+* stdin·stdout 이 둘 다 TTY 일 때만 `interactive` 를 참으로 만든다.
+*/
+function nodeRepairDependencies(generate) {
+	return {
+		readFile: (path) => readFile(path, "utf8"),
+		writeStdout: (text) => void process.stdout.write(text),
+		writeStderr: (text) => void process.stderr.write(text),
+		reviewIO: nodeReviewIO(),
+		diagnosis: {
+			prepare: generate.prepareDiagnosisRequest,
+			dispatch: generate.dispatchDiagnosisRequest,
+			providers: {
+				codex: (model) => generate.createCodexProvider({ model }),
+				claude: (model) => generate.createClaudeProvider({ model })
+			}
+		}
+	};
+}
+/** `mcpeak help <이름>` 으로 볼 수 있는 명령. 위 두 갈래가 같은 목록을 봐야 한다. */
+const HELP_TOPICS = [
+	"test",
+	"generate",
+	"repair"
+];
+const isHelpTopic = (value) => HELP_TOPICS.includes(value);
+async function run(argv) {
+	if (argv.length === 0 || argv.length === 1 && [
+		"--help",
+		"-h",
+		"help"
+	].includes(argv[0] ?? "")) {
+		process.stdout.write(GLOBAL_HELP);
+		return 0;
+	}
+	if (argv.length === 2) {
+		const command = argv[0] === "help" ? argv[1] : argv[1] === "--help" ? argv[0] : void 0;
+		if (command === "replay" || command === "verify") return runCli([command], unavailableDependencies);
+		if (isHelpTopic(command)) {
+			process.stdout.write(commandHelp(command));
+			return 0;
+		}
+	}
+	/**
+	* `help` 로 시작했는데 위에서 안 걸렸다면 **뒤에 붙은 인자가 틀린 것**이다.
+	*
+	* 여기서 안 막고 아래로 흘려보내면 `runCli` 가 `argv[0]` 인 `help` 를 명령으로 읽어
+	* "알 수 없는 CLI 명령 'help'입니다" 라고 한다. 사용자가 정확히 친 토큰을 틀렸다고
+	* 지목하는 셈이라, 무엇을 고쳐야 하는지가 화면에서 사라진다.
+	*/
+	if (argv[0] === "help") {
+		const target = argv[1] ?? "";
+		const extra = argv[2];
+		const message = isHelpTopic(target) && extra !== void 0 ? `\`help ${escapeTerminalText(target)}\` 뒤의 '${escapeTerminalText(extra)}' 는 받지 않습니다.` : `도움말이 없는 명령 '${escapeTerminalText(target)}'입니다.`;
+		process.stderr.write(`오류 [CLI_USAGE]: ${message}\n해결: ${commandDiscovery}\n`);
+		return 1;
+	}
+	if (argv.length === 1 && argv[0] === "--version") {
+		process.stdout.write(`mcpeak ${version}\n`);
+		return 0;
+	}
+	if (argv[0] === "generate") {
+		let core;
+		let runner;
+		let generate;
+		try {
+			[core, runner, generate] = await Promise.all([
+				import("@mcpeak/core"),
+				import("@mcpeak/runner"),
+				import("@mcpeak/generate")
+			]);
+		} catch {
+			return runGenerateCommand(argv, {
+				...nodeGenerateDependencies(),
+				connect: unavailableDependencies.connect,
+				createBaselineSuite: unavailableDependencies.validateSuite,
+				createAuthoringSession: unavailableDependencies.validateSuite,
+				finalizeAuthoringDraft: unavailableDependencies.validateSuite,
+				getAuthoringExecutionSuite: unavailableDependencies.validateSuite,
+				validateSuite: unavailableDependencies.validateSuite
+			});
+		}
+		return runGenerateCommand(argv, {
+			...nodeGenerateDependencies(),
+			connect: core.connectStdio,
+			connectHttp: core.connectHttp,
+			readEnv: (name) => process.env[name],
+			createBaselineSuite: generate.createBaselineSuite,
+			createAuthoringSession: generate.createAuthoringSession,
+			finalizeAuthoringDraft: generate.finalizeAuthoringDraft,
+			getAuthoringExecutionSuite: generate.getAuthoringExecutionSuite,
+			validateSuite: runner.validateMcpSuite,
+			reviewIO: nodeReviewIO(),
+			providers: {
+				codex: (model) => generate.createCodexAuthoringProvider({ model }),
+				claude: (model) => generate.createClaudeAuthoringProvider({ model })
+			},
+			prepareAuthoringRequest: generate.prepareAuthoringRequest,
+			dispatchAuthoringRequest: generate.dispatchAuthoringRequest,
+			createAuthoringDiff: generate.createAuthoringDiff,
+			applyAuthoringChanges: generate.applyAuthoringChanges,
+			reviewLocalAuthoringCandidate: generate.reviewLocalAuthoringCandidate,
+			computeCoverage: generate.computeCoverage,
+			preparePreFillRequest: generate.preparePreFillRequest,
+			previewPreFillRequest: generate.previewPreFillRequest,
+			dispatchPreFillRequest: generate.dispatchPreFillRequest,
+			preFillProviders: {
+				codex: (model) => generate.createCodexProvider({ model }),
+				claude: (model) => generate.createClaudeProvider({ model })
+			},
+			prepareRejectionDiagnosisRequests: generate.prepareRejectionDiagnosisRequests,
+			dispatchRejectionDiagnosis: generate.dispatchRejectionDiagnosis,
+			rejectionProviders: {
+				codex: (model) => generate.createCodexProvider({ model }),
+				claude: (model) => generate.createClaudeProvider({ model })
+			},
+			GenerateTestsError: generate.GenerateTestsError
+		});
+	}
+	if (argv[0] === "repair") {
+		/**
+		* `generate` 분기와 같은 모양으로 동적 import 한다. `test` 경로는 이 분기를 지나지 않으므로
+		* 여전히 `core` 와 `runner` 만 로드한다. 계획서 §8 위험표 첫 줄.
+		*/
+		let generate;
+		try {
+			generate = await import("@mcpeak/generate");
+		} catch {
+			process.stderr.write("오류 [REPAIR_RUNTIME_UNAVAILABLE]: 진단에 필요한 @mcpeak/generate 를 로드하지 못했습니다.\n해결: 의존성을 설치한 뒤 다시 실행하세요.\n");
+			return 1;
+		}
+		const dependencies = nodeRepairDependencies(generate);
+		try {
+			return await runRepairCommand(argv, dependencies);
+		} finally {
+			dependencies.reviewIO?.close?.();
+		}
+	}
+	if (argv[0] !== "test") return runCli(argv, unavailableDependencies);
+	try {
+		if (!parseTestCommand(argv.slice(1)).suitePath.toLowerCase().endsWith(".json")) return runCli(argv, unavailableDependencies);
+	} catch {
+		return runCli(argv, unavailableDependencies);
+	}
+	let core;
+	let runner;
+	try {
+		[core, runner] = await Promise.all([import("@mcpeak/core"), import("@mcpeak/runner")]);
+	} catch {
+		return runCli(argv, unavailableRuntimeDependencies);
+	}
+	return runCli(argv, {
+		readFile,
+		validateSuite: runner.validateMcpSuite,
+		connect: core.connectStdio,
+		connectHttp: core.connectHttp,
+		readEnv: (name) => process.env[name],
+		startRunner: runner.runSuite,
+		finalize: runner.finalizeRunnerExecution,
+		renderReport: runner.renderReport,
+		renderJUnit: runner.renderJUnit,
+		writeFile: (path, text) => writeFile(path, text, "utf8"),
+		colorEnabled: process.stdout.isTTY === true && process.env.NO_COLOR === void 0,
+		writeStdout: (text) => process.stdout.write(text),
+		writeStderr: (text) => process.stderr.write(text)
+	});
+}
+//#endregion
+export { COMMANDS, nodeRepairDependencies, run };

package/dist/{replay-command-BAtSzf8R.d.mts → repair-command-D3zL3G5W.d.cts}

@@ -1,23 +1,39 @@
-import { FinalizeRunnerExecutionOptions, RunSuiteOptions, RunnerExecution, RunnerReport, SuiteValidationIssue, SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
-import { Cassette } from "@mcpeak/record";
-import { McpStdioConnection, ToolDef } from "@mcpeak/core";
+import { McpHttpConnection, McpStdioConnection, ToolDef } from "@mcpeak/core";
 import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, PreFillProvider } from "@mcpeak/generate";
+import { SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
+//#region src/connect-target.d.ts
+/** 파서가 확정한 연결 대상. */
+type ConnectTarget = {
+  readonly transport: "stdio";
+  readonly command: string;
+  readonly args: readonly string[];
+} | {
+  readonly transport: "http";
+  readonly url: string;
+  /**
+   * 헤더 이름 → 그 값을 담은 **환경변수 이름**. 값 자체는 여기에도 argv 에도 없다.
+   *
+   * 평문 `--header 'Authorization: Bearer …'` 를 두지 않은 이유가 이 타입이다. 토큰을
+   * argv 에 실으면 `ps` 목록과 셸 히스토리에 그대로 남고, 그건 우리가 만든 노출이다.
+   */
+  readonly headerEnv: Readonly<Record<string, string>>;
+};
+//#endregion
 //#region src/generate-command.d.ts
 interface GenerateCommandInput {
   readonly suiteId: string;
   readonly name: string;
   readonly outPath: string;
-  readonly command: string;
-  readonly args: readonly string[];
+  /**
+   * 명세를 뽑을 대상. `--command`/`--arg` 면 stdio, `--url` 이면 Streamable HTTP 다(#137).
+   * `command` · `args` 두 필드를 이 하나로 바꾼 근거는 `TestCommandInput.target` 과 같다.
+   */
+  readonly target: ConnectTarget;
   readonly baselineOnly: boolean;
   readonly provider?: "codex" | "claude";
   readonly model?: string;
   /** 승인 전 시험 실행 여부. 기본은 실행이고 `--no-dry-run` 이 끈다. 설계 문서 §4.3. */
   readonly dryRun: boolean;
-  /** `--cassette` 경로. 없으면 서버를 직접 부른다. */
-  readonly cassettePath?: string;
-  /** `--record`. 카세트 파일이 있어도 새로 녹화한다. */
-  readonly forceRecord: boolean;
   /** `--force`. `--out` 에 파일이 있으면 지우고 새로 쓴다. 설계 문서 §5. */
   readonly force: boolean;
   /** `--reset-cmd`. 시험 실행 직전 1회 실행한다. */
@@ -30,6 +46,16 @@ interface GenerateCommandDependencies {
     command: string;
     args: readonly string[];
   }): Promise<McpStdioConnection>;
+  /**
+   * 원격(Streamable HTTP) 대상용 연결. `core.connectHttp` 다. 선택 사항으로 두는 근거는
+   * `TestCommandDependencies.connectHttp` 와 같다(#137).
+   */
+  connectHttp?(options: {
+    url: string;
+    headers?: Readonly<Record<string, string>>;
+  }): Promise<McpHttpConnection>;
+  /** `--header-env` 가 가리키는 환경변수를 읽는다. CLI 가 `process` 를 직접 읽지 않기 위한 주입점. */
+  readEnv?(name: string): string | undefined;
   createBaselineSuite(tools: readonly ToolDef[], options: {
     suiteId: string;
     suiteName: string;
@@ -100,15 +126,6 @@ interface GenerateCommandDependencies {
    * 동일성도 보장된다. 위 6개 필드가 같은 방식이다.
    */
   GenerateTestsError?: typeof import("@mcpeak/generate").GenerateTestsError;
-  /**
-   * 카세트 파일 입출력. 주입점을 여기 하나만 두는 이유는 시험 실행 경로에서 파일시스템을
-   * 만지는 곳이 이것뿐이기 때문이다. 나머지(`runDryRun`·`reviewDryRun`)는 주입한 client 와
-   * io 만 쓰므로 테스트가 실제 구현을 그대로 돌린다.
-   */
-  cassetteIo?: {
-    load(path: string): Promise<Cassette | null>;
-    save(path: string, cassette: Cassette): Promise<void>;
-  };
 }
 interface ReviewIO {
   input(message: string): Promise<string>;
@@ -158,29 +175,4 @@ declare function parseRepairCommand(argv: readonly string[]): RepairCommandInput
  */
 declare function runRepairCommand(argv: readonly string[], deps: RepairCommandDependencies): Promise<number>;
 //#endregion
-//#region src/replay-command.d.ts
-interface ReplayCommandInput {
-  readonly suitePath: string;
-  readonly cassettePath: string;
-}
-/**
- * `connect` 가 없다. replay 가 서버를 띄우지 않는다는 것이 주석이 아니라 타입에 드러난다.
- * ADR-0028.
- */
-interface ReplayCommandDependencies {
-  readFile(path: string): Promise<Uint8Array>;
-  validateSuite(input: unknown): SuiteValidationResult;
-  loadCassette(path: string): Promise<Cassette | null>;
-  startRunner(options: RunSuiteOptions): RunnerExecution;
-  finalize(options: FinalizeRunnerExecutionOptions): Promise<RunnerReport>;
-  renderReport(report: RunnerReport, options?: {
-    color?: boolean;
-  }): string;
-  colorEnabled: boolean;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-}
-declare function parseReplayCommand(argv: readonly string[]): ReplayCommandInput;
-declare function runReplayCommand(argv: readonly string[], dependencies: ReplayCommandDependencies): Promise<number>;
-//#endregion
-export { RepairCommandDependencies as a, runRepairCommand as c, ReviewIO as d, nodeGenerateDependencies as f, runReplayCommand as i, GenerateCommandDependencies as l, runGenerateCommand as m, ReplayCommandInput as n, RepairCommandInput as o, nodeReviewIO as p, parseReplayCommand as r, parseRepairCommand as s, ReplayCommandDependencies as t, GenerateCommandInput as u };
+export { GenerateCommandDependencies as a, nodeGenerateDependencies as c, ConnectTarget as d, runRepairCommand as i, nodeReviewIO as l, RepairCommandInput as n, GenerateCommandInput as o, parseRepairCommand as r, ReviewIO as s, RepairCommandDependencies as t, runGenerateCommand as u };

package/dist/{replay-command-V0ZSJPiD.d.cts → repair-command-DQh2h4tQ.d.mts}

@@ -1,23 +1,39 @@
-import { McpStdioConnection, ToolDef } from "@mcpeak/core";
+import { SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
+import { McpHttpConnection, McpStdioConnection, ToolDef } from "@mcpeak/core";
 import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, PreFillProvider } from "@mcpeak/generate";
-import { Cassette } from "@mcpeak/record";
-import { FinalizeRunnerExecutionOptions, RunSuiteOptions, RunnerExecution, RunnerReport, SuiteValidationIssue, SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
+//#region src/connect-target.d.ts
+/** 파서가 확정한 연결 대상. */
+type ConnectTarget = {
+  readonly transport: "stdio";
+  readonly command: string;
+  readonly args: readonly string[];
+} | {
+  readonly transport: "http";
+  readonly url: string;
+  /**
+   * 헤더 이름 → 그 값을 담은 **환경변수 이름**. 값 자체는 여기에도 argv 에도 없다.
+   *
+   * 평문 `--header 'Authorization: Bearer …'` 를 두지 않은 이유가 이 타입이다. 토큰을
+   * argv 에 실으면 `ps` 목록과 셸 히스토리에 그대로 남고, 그건 우리가 만든 노출이다.
+   */
+  readonly headerEnv: Readonly<Record<string, string>>;
+};
+//#endregion
 //#region src/generate-command.d.ts
 interface GenerateCommandInput {
   readonly suiteId: string;
   readonly name: string;
   readonly outPath: string;
-  readonly command: string;
-  readonly args: readonly string[];
+  /**
+   * 명세를 뽑을 대상. `--command`/`--arg` 면 stdio, `--url` 이면 Streamable HTTP 다(#137).
+   * `command` · `args` 두 필드를 이 하나로 바꾼 근거는 `TestCommandInput.target` 과 같다.
+   */
+  readonly target: ConnectTarget;
   readonly baselineOnly: boolean;
   readonly provider?: "codex" | "claude";
   readonly model?: string;
   /** 승인 전 시험 실행 여부. 기본은 실행이고 `--no-dry-run` 이 끈다. 설계 문서 §4.3. */
   readonly dryRun: boolean;
-  /** `--cassette` 경로. 없으면 서버를 직접 부른다. */
-  readonly cassettePath?: string;
-  /** `--record`. 카세트 파일이 있어도 새로 녹화한다. */
-  readonly forceRecord: boolean;
   /** `--force`. `--out` 에 파일이 있으면 지우고 새로 쓴다. 설계 문서 §5. */
   readonly force: boolean;
   /** `--reset-cmd`. 시험 실행 직전 1회 실행한다. */
@@ -30,6 +46,16 @@ interface GenerateCommandDependencies {
     command: string;
     args: readonly string[];
   }): Promise<McpStdioConnection>;
+  /**
+   * 원격(Streamable HTTP) 대상용 연결. `core.connectHttp` 다. 선택 사항으로 두는 근거는
+   * `TestCommandDependencies.connectHttp` 와 같다(#137).
+   */
+  connectHttp?(options: {
+    url: string;
+    headers?: Readonly<Record<string, string>>;
+  }): Promise<McpHttpConnection>;
+  /** `--header-env` 가 가리키는 환경변수를 읽는다. CLI 가 `process` 를 직접 읽지 않기 위한 주입점. */
+  readEnv?(name: string): string | undefined;
   createBaselineSuite(tools: readonly ToolDef[], options: {
     suiteId: string;
     suiteName: string;
@@ -100,15 +126,6 @@ interface GenerateCommandDependencies {
    * 동일성도 보장된다. 위 6개 필드가 같은 방식이다.
    */
   GenerateTestsError?: typeof import("@mcpeak/generate").GenerateTestsError;
-  /**
-   * 카세트 파일 입출력. 주입점을 여기 하나만 두는 이유는 시험 실행 경로에서 파일시스템을
-   * 만지는 곳이 이것뿐이기 때문이다. 나머지(`runDryRun`·`reviewDryRun`)는 주입한 client 와
-   * io 만 쓰므로 테스트가 실제 구현을 그대로 돌린다.
-   */
-  cassetteIo?: {
-    load(path: string): Promise<Cassette | null>;
-    save(path: string, cassette: Cassette): Promise<void>;
-  };
 }
 interface ReviewIO {
   input(message: string): Promise<string>;
@@ -158,29 +175,4 @@ declare function parseRepairCommand(argv: readonly string[]): RepairCommandInput
  */
 declare function runRepairCommand(argv: readonly string[], deps: RepairCommandDependencies): Promise<number>;
 //#endregion
-//#region src/replay-command.d.ts
-interface ReplayCommandInput {
-  readonly suitePath: string;
-  readonly cassettePath: string;
-}
-/**
- * `connect` 가 없다. replay 가 서버를 띄우지 않는다는 것이 주석이 아니라 타입에 드러난다.
- * ADR-0028.
- */
-interface ReplayCommandDependencies {
-  readFile(path: string): Promise<Uint8Array>;
-  validateSuite(input: unknown): SuiteValidationResult;
-  loadCassette(path: string): Promise<Cassette | null>;
-  startRunner(options: RunSuiteOptions): RunnerExecution;
-  finalize(options: FinalizeRunnerExecutionOptions): Promise<RunnerReport>;
-  renderReport(report: RunnerReport, options?: {
-    color?: boolean;
-  }): string;
-  colorEnabled: boolean;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-}
-declare function parseReplayCommand(argv: readonly string[]): ReplayCommandInput;
-declare function runReplayCommand(argv: readonly string[], dependencies: ReplayCommandDependencies): Promise<number>;
-//#endregion
-export { RepairCommandDependencies as a, runRepairCommand as c, ReviewIO as d, nodeGenerateDependencies as f, runReplayCommand as i, GenerateCommandDependencies as l, runGenerateCommand as m, ReplayCommandInput as n, RepairCommandInput as o, nodeReviewIO as p, parseReplayCommand as r, parseRepairCommand as s, ReplayCommandDependencies as t, GenerateCommandInput as u };
+export { GenerateCommandDependencies as a, nodeGenerateDependencies as c, ConnectTarget as d, runRepairCommand as i, nodeReviewIO as l, RepairCommandInput as n, GenerateCommandInput as o, parseRepairCommand as r, ReviewIO as s, RepairCommandDependencies as t, runGenerateCommand as u };