@mcpeak/cli 0.10.0 → 0.12.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 { c as runGenerateCommand, d as commandHelp, f as escapeTerminalText, i as runRepairCommand, l as GLOBAL_HELP, n as runCli, o as nodeGenerateDependencies, p as version, s as nodeReviewIO, t as parseTestCommand, u as commandDiscovery } from "./test-command-P8_uaAIy.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-8GUlJJ47.d.mts}

@@ -1,38 +1,116 @@
-import { FinalizeRunnerExecutionOptions, RunSuiteOptions, RunnerExecution, RunnerReport, SuiteValidationIssue, SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
-import { Cassette } from "@mcpeak/record";
-import { McpStdioConnection, ToolDef } from "@mcpeak/core";
-import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, PreFillProvider } from "@mcpeak/generate";
+import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, FixtureFile, PreFillProvider } from "@mcpeak/generate";
+import { SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
+import { McpHttpConnection, McpStdioConnection, ToolDef } from "@mcpeak/core";
+//#region src/connect-target.d.ts
+/** 파서가 확정한 연결 대상. */
+type ConnectTarget = {
+  readonly transport: "stdio";
+  readonly command: string;
+  readonly args: readonly string[];
+  /**
+   * 자식에게 넘길 부모 환경변수의 **이름**. 값은 여기에도 argv 에도 없다(`--header-env` 와
+   * 같은 이유). `openConnection` 이 `readEnv` 로 읽어 `env` 에 얹는다.
+   */
+  readonly envNames: readonly string[];
+} | {
+  readonly transport: "http";
+  readonly url: string;
+  /**
+   * 헤더 이름 → 그 값을 담은 **환경변수 이름**. 값 자체는 여기에도 argv 에도 없다.
+   *
+   * 평문 `--header 'Authorization: Bearer …'` 를 두지 않은 이유가 이 타입이다. 토큰을
+   * argv 에 실으면 `ps` 목록과 셸 히스토리에 그대로 남고, 그건 우리가 만든 노출이다.
+   */
+  readonly headerEnv: Readonly<Record<string, string>>;
+};
+//#endregion
+//#region src/reset-hook.d.ts
+/**
+ * 초기화가 실제로 무엇을 했는가. `--reset-cmd` 가 0 으로 끝난 것을 "초기 상태" 라고
+ * 부르지 않기 위해 있다. 명령이 무엇을 복원했는지 우리는 모른다(이슈 #399).
+ */
+type ResetGrade =
+/**
+ * 새 프로세스·새 연결 + 초기화 명령 성공. 우리가 제공할 수 있는 가장 강한 것.
+ *
+ * **이번 회차는 이 값을 내지 않는다.** 프로세스를 다시 띄우는 것은 core 의 수명주기를
+ * 건드리고, generate 흐름 한가운데서 연결을 바꾸면 그 뒤 단계가 전부 새 client 를 봐야
+ * 한다. 값을 미리 정의하는 이유는, commandOnly 를 "초기 상태" 라고 부르지 않으려면
+ * 그보다 강한 것이 있다는 사실이 타입에 있어야 하기 때문이다. 죽은 값이 아니라
+ * 의도된 자리다. 지우지 마라(설계 §3).
+ */
+"freshProcess" |
+/** 같은 연결에 초기화 명령만 성공. 서버 프로세스의 메모리 상태는 그대로다. */
+"commandOnly" |
+/** 초기화 수단이 없다. 앞 실행이 바꾼 상태가 남아 있다. */
+"none" |
+/** 초기화를 시도했으나 실패했다. 상태를 모른다. */
+"failed";
+//#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회 실행한다. */
   readonly resetCmd?: string;
   /** 입력값 교정 단계를 돌릴지 여부. 기본은 실행이고 `--no-repair` 가 끈다. 설계 문서 §7. */
   readonly repair: boolean;
+  /**
+   * 통과한 거절 케이스의 근거를 확인할지 여부. 기본은 꺼짐이고 `--diagnose-rejections` 가 켠다.
+   * 끄면 미확인 목록도 AI 진단도 나가지 않고 한 줄 고지만 남는다(ADR-0098 · 설계 §4.2).
+   */
+  readonly diagnoseRejections: boolean;
+  /**
+   * `--fixtures` 로 명시한 픽스처 파일 경로. 없으면 기본 경로(`mcpeak.fixtures.json`)를 본다.
+   *
+   * "명시했는가" 를 여기서 구분해 두는 이유는 없는 파일의 처리가 다르기 때문이다. 기본
+   * 경로는 없는 것이 정상이라 조용히 지나가고, 사용자가 적은 경로가 없는 것은 오타다(#390).
+   */
+  readonly fixturesPath?: string;
 }
 interface GenerateCommandDependencies {
   connect(options: {
     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;
+  /**
+   * 초기화 주입점. 기본은 `attemptReset` 이다.
+   *
+   * 사전보완 후보 비교가 같은 초기 상태에서 도는지를 유닛테스트가 보려면 초기화를 세워야 하는데,
+   * 실제 `attemptReset` 은 프로세스를 띄운다. 이 저장소는 유닛테스트를 인메모리로만 돌린다
+   * (터미널 병렬 안전). `dryRun` · `preparePreFillRequest` 를 주입으로 받는 것과 같은 이유다.
+   * 실제 명령을 돌리는 테스트는 `reset-hook-e2e.test.ts` 하나에만 둔다(#399).
+   */
+  attemptReset?(resetCmd: string | undefined): Promise<{
+    readonly grade: ResetGrade;
+  }>;
   createBaselineSuite(tools: readonly ToolDef[], options: {
     suiteId: string;
     suiteName: string;
+    fixtures?: FixtureFile;
   }): BaselineGenerationResult;
   createAuthoringSession(baseline: BaselineGenerationResult, options?: {
     readonly preFilledCaseIds?: readonly string[];
@@ -100,15 +178,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>;
@@ -119,6 +188,8 @@ interface ReviewIO {
   close?(): void;
 }
 type TestAuthoringProvider = import("@mcpeak/generate").TestAuthoringProvider;
+/** 대시보드의 검토 하위 입력에서 상위 메뉴로 돌아갈 때 쓰는 내부 제어값. */
+declare const REVIEW_BACK_VALUE = "__mcpeak_review_back__";
 declare function runGenerateCommand(argv: readonly string[], deps: GenerateCommandDependencies): Promise<number>;
 declare const nodeGenerateDependencies: () => Omit<GenerateCommandDependencies, "connect" | "createBaselineSuite" | "createAuthoringSession" | "finalizeAuthoringDraft" | "getAuthoringExecutionSuite" | "validateSuite">;
 declare function nodeReviewIO(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream): ReviewIO;
@@ -152,35 +223,6 @@ interface RepairCommandDependencies {
   };
 }
 declare function parseRepairCommand(argv: readonly string[]): RepairCommandInput;
-/**
- * `repair` 명령. 번들을 읽고, 전송 내용을 확인받고, provider 에게 진단을 물어 화면에 찍는다.
- * 파일도 명세도 고치지 않는다. 종료 코드는 운영 실패에만 1 이다(설계서 §7.1).
- */
 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, ReviewIO as c, runGenerateCommand as d, ConnectTarget as f, runRepairCommand as i, nodeGenerateDependencies as l, RepairCommandInput as n, GenerateCommandInput as o, parseRepairCommand as r, REVIEW_BACK_VALUE as s, RepairCommandDependencies as t, nodeReviewIO as u };

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

@@ -1,38 +1,116 @@
-import { 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";
+import { McpHttpConnection, McpStdioConnection, ToolDef } from "@mcpeak/core";
+import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, FixtureFile, 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[];
+  /**
+   * 자식에게 넘길 부모 환경변수의 **이름**. 값은 여기에도 argv 에도 없다(`--header-env` 와
+   * 같은 이유). `openConnection` 이 `readEnv` 로 읽어 `env` 에 얹는다.
+   */
+  readonly envNames: readonly string[];
+} | {
+  readonly transport: "http";
+  readonly url: string;
+  /**
+   * 헤더 이름 → 그 값을 담은 **환경변수 이름**. 값 자체는 여기에도 argv 에도 없다.
+   *
+   * 평문 `--header 'Authorization: Bearer …'` 를 두지 않은 이유가 이 타입이다. 토큰을
+   * argv 에 실으면 `ps` 목록과 셸 히스토리에 그대로 남고, 그건 우리가 만든 노출이다.
+   */
+  readonly headerEnv: Readonly<Record<string, string>>;
+};
+//#endregion
+//#region src/reset-hook.d.ts
+/**
+ * 초기화가 실제로 무엇을 했는가. `--reset-cmd` 가 0 으로 끝난 것을 "초기 상태" 라고
+ * 부르지 않기 위해 있다. 명령이 무엇을 복원했는지 우리는 모른다(이슈 #399).
+ */
+type ResetGrade =
+/**
+ * 새 프로세스·새 연결 + 초기화 명령 성공. 우리가 제공할 수 있는 가장 강한 것.
+ *
+ * **이번 회차는 이 값을 내지 않는다.** 프로세스를 다시 띄우는 것은 core 의 수명주기를
+ * 건드리고, generate 흐름 한가운데서 연결을 바꾸면 그 뒤 단계가 전부 새 client 를 봐야
+ * 한다. 값을 미리 정의하는 이유는, commandOnly 를 "초기 상태" 라고 부르지 않으려면
+ * 그보다 강한 것이 있다는 사실이 타입에 있어야 하기 때문이다. 죽은 값이 아니라
+ * 의도된 자리다. 지우지 마라(설계 §3).
+ */
+"freshProcess" |
+/** 같은 연결에 초기화 명령만 성공. 서버 프로세스의 메모리 상태는 그대로다. */
+"commandOnly" |
+/** 초기화 수단이 없다. 앞 실행이 바꾼 상태가 남아 있다. */
+"none" |
+/** 초기화를 시도했으나 실패했다. 상태를 모른다. */
+"failed";
+//#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회 실행한다. */
   readonly resetCmd?: string;
   /** 입력값 교정 단계를 돌릴지 여부. 기본은 실행이고 `--no-repair` 가 끈다. 설계 문서 §7. */
   readonly repair: boolean;
+  /**
+   * 통과한 거절 케이스의 근거를 확인할지 여부. 기본은 꺼짐이고 `--diagnose-rejections` 가 켠다.
+   * 끄면 미확인 목록도 AI 진단도 나가지 않고 한 줄 고지만 남는다(ADR-0098 · 설계 §4.2).
+   */
+  readonly diagnoseRejections: boolean;
+  /**
+   * `--fixtures` 로 명시한 픽스처 파일 경로. 없으면 기본 경로(`mcpeak.fixtures.json`)를 본다.
+   *
+   * "명시했는가" 를 여기서 구분해 두는 이유는 없는 파일의 처리가 다르기 때문이다. 기본
+   * 경로는 없는 것이 정상이라 조용히 지나가고, 사용자가 적은 경로가 없는 것은 오타다(#390).
+   */
+  readonly fixturesPath?: string;
 }
 interface GenerateCommandDependencies {
   connect(options: {
     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;
+  /**
+   * 초기화 주입점. 기본은 `attemptReset` 이다.
+   *
+   * 사전보완 후보 비교가 같은 초기 상태에서 도는지를 유닛테스트가 보려면 초기화를 세워야 하는데,
+   * 실제 `attemptReset` 은 프로세스를 띄운다. 이 저장소는 유닛테스트를 인메모리로만 돌린다
+   * (터미널 병렬 안전). `dryRun` · `preparePreFillRequest` 를 주입으로 받는 것과 같은 이유다.
+   * 실제 명령을 돌리는 테스트는 `reset-hook-e2e.test.ts` 하나에만 둔다(#399).
+   */
+  attemptReset?(resetCmd: string | undefined): Promise<{
+    readonly grade: ResetGrade;
+  }>;
   createBaselineSuite(tools: readonly ToolDef[], options: {
     suiteId: string;
     suiteName: string;
+    fixtures?: FixtureFile;
   }): BaselineGenerationResult;
   createAuthoringSession(baseline: BaselineGenerationResult, options?: {
     readonly preFilledCaseIds?: readonly string[];
@@ -100,15 +178,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>;
@@ -119,6 +188,8 @@ interface ReviewIO {
   close?(): void;
 }
 type TestAuthoringProvider = import("@mcpeak/generate").TestAuthoringProvider;
+/** 대시보드의 검토 하위 입력에서 상위 메뉴로 돌아갈 때 쓰는 내부 제어값. */
+declare const REVIEW_BACK_VALUE = "__mcpeak_review_back__";
 declare function runGenerateCommand(argv: readonly string[], deps: GenerateCommandDependencies): Promise<number>;
 declare const nodeGenerateDependencies: () => Omit<GenerateCommandDependencies, "connect" | "createBaselineSuite" | "createAuthoringSession" | "finalizeAuthoringDraft" | "getAuthoringExecutionSuite" | "validateSuite">;
 declare function nodeReviewIO(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream): ReviewIO;
@@ -152,35 +223,6 @@ interface RepairCommandDependencies {
   };
 }
 declare function parseRepairCommand(argv: readonly string[]): RepairCommandInput;
-/**
- * `repair` 명령. 번들을 읽고, 전송 내용을 확인받고, provider 에게 진단을 물어 화면에 찍는다.
- * 파일도 명세도 고치지 않는다. 종료 코드는 운영 실패에만 1 이다(설계서 §7.1).
- */
 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, ReviewIO as c, runGenerateCommand as d, ConnectTarget as f, runRepairCommand as i, nodeGenerateDependencies as l, RepairCommandInput as n, GenerateCommandInput as o, parseRepairCommand as r, REVIEW_BACK_VALUE as s, RepairCommandDependencies as t, nodeReviewIO as u };