@mcpeak/cli 0.11.0 → 0.12.0

package/dist/commands.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_test_command = require("./test-command-B_faNSfA.cjs");
+const require_test_command = require("./test-command-1m3myzTS.cjs");
+exports.REVIEW_BACK_VALUE = require_test_command.REVIEW_BACK_VALUE;
 exports.nodeGenerateDependencies = require_test_command.nodeGenerateDependencies;
 exports.nodeReviewIO = require_test_command.nodeReviewIO;
 exports.parseRepairCommand = require_test_command.parseRepairCommand;

package/dist/commands.d.cts

@@ -1,4 +1,4 @@
-import { a as GenerateCommandDependencies, c as nodeGenerateDependencies, d as ConnectTarget, i as runRepairCommand, l as nodeReviewIO, n as RepairCommandInput, o as GenerateCommandInput, r as parseRepairCommand, s as ReviewIO, t as RepairCommandDependencies, u as runGenerateCommand } from "./repair-command-D3zL3G5W.cjs";
+import { a as GenerateCommandDependencies, c as ReviewIO, d as runGenerateCommand, f as ConnectTarget, i as runRepairCommand, l as nodeGenerateDependencies, n as RepairCommandInput, o as GenerateCommandInput, r as parseRepairCommand, s as REVIEW_BACK_VALUE, t as RepairCommandDependencies, u as nodeReviewIO } from "./repair-command-CVFqxU6V.cjs";
 import { McpHttpConnection, McpStdioConnection } from "@mcpeak/core";
 import { CheckDeterminismOptions, DeterminismResult, FinalizeRunnerExecutionOptions, InputContractOptions, RunSuiteOptions, RunnerExecution, RunnerReport, SpecFindingsResult, SuiteValidationIssue, SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
 import "@mcpeak/record/external";
@@ -102,4 +102,4 @@ declare function parseTestCommand(argv: readonly string[]): TestCommandInput;
  */
 declare function runCli(argv: readonly string[], dependencies: TestCommandDependencies): Promise<number>;
 //#endregion
-export { type CliErrorCode, type CliFailure, type GenerateCommandDependencies, type GenerateCommandInput, type RepairCommandDependencies, type RepairCommandInput, type ReviewIO, type TestCommandDependencies, type TestCommandInput, nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };
+export { type CliErrorCode, type CliFailure, type GenerateCommandDependencies, type GenerateCommandInput, REVIEW_BACK_VALUE, type RepairCommandDependencies, type RepairCommandInput, type ReviewIO, type TestCommandDependencies, type TestCommandInput, nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };

package/dist/commands.d.mts

@@ -1,4 +1,4 @@
-import { a as GenerateCommandDependencies, c as nodeGenerateDependencies, d as ConnectTarget, i as runRepairCommand, l as nodeReviewIO, n as RepairCommandInput, o as GenerateCommandInput, r as parseRepairCommand, s as ReviewIO, t as RepairCommandDependencies, u as runGenerateCommand } from "./repair-command-DQh2h4tQ.mjs";
+import { a as GenerateCommandDependencies, c as ReviewIO, d as runGenerateCommand, f as ConnectTarget, i as runRepairCommand, l as nodeGenerateDependencies, n as RepairCommandInput, o as GenerateCommandInput, r as parseRepairCommand, s as REVIEW_BACK_VALUE, t as RepairCommandDependencies, u as nodeReviewIO } from "./repair-command-8GUlJJ47.mjs";
 import { CheckDeterminismOptions, DeterminismResult, FinalizeRunnerExecutionOptions, InputContractOptions, RunSuiteOptions, RunnerExecution, RunnerReport, SpecFindingsResult, SuiteValidationIssue, SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
 import { McpHttpConnection, McpStdioConnection } from "@mcpeak/core";
 import "@mcpeak/record/external";
@@ -102,4 +102,4 @@ declare function parseTestCommand(argv: readonly string[]): TestCommandInput;
  */
 declare function runCli(argv: readonly string[], dependencies: TestCommandDependencies): Promise<number>;
 //#endregion
-export { type CliErrorCode, type CliFailure, type GenerateCommandDependencies, type GenerateCommandInput, type RepairCommandDependencies, type RepairCommandInput, type ReviewIO, type TestCommandDependencies, type TestCommandInput, nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };
+export { type CliErrorCode, type CliFailure, type GenerateCommandDependencies, type GenerateCommandInput, REVIEW_BACK_VALUE, type RepairCommandDependencies, type RepairCommandInput, type ReviewIO, type TestCommandDependencies, type TestCommandInput, nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };

package/dist/commands.mjs

@@ -1,2 +1,2 @@
-import { a as nodeGenerateDependencies, i as runRepairCommand, n as runCli, o as nodeReviewIO, r as parseRepairCommand, s as runGenerateCommand, t as parseTestCommand } from "./test-command-DEp9hrfH.mjs";
-export { nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };
+import { a as REVIEW_BACK_VALUE, c as runGenerateCommand, i as runRepairCommand, n as runCli, o as nodeGenerateDependencies, r as parseRepairCommand, s as nodeReviewIO, t as parseTestCommand } from "./test-command-P8_uaAIy.mjs";
+export { REVIEW_BACK_VALUE, nodeGenerateDependencies, nodeReviewIO, parseRepairCommand, parseTestCommand, runCli, runGenerateCommand, runRepairCommand };

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_test_command = require("./test-command-B_faNSfA.cjs");
+const require_test_command = require("./test-command-1m3myzTS.cjs");
 let node_fs_promises = require("node:fs/promises");
 //#region src/index.ts
 const COMMANDS = [

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { t as RepairCommandDependencies } from "./repair-command-D3zL3G5W.cjs";
+import { t as RepairCommandDependencies } from "./repair-command-CVFqxU6V.cjs";
 //#region src/index.d.ts
 type Command = (argv: string[]) => Promise<number>;
 declare const COMMANDS: readonly ["test", "generate", "repair", "record", "mock"];

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { t as RepairCommandDependencies } from "./repair-command-DQh2h4tQ.mjs";
+import { t as RepairCommandDependencies } from "./repair-command-8GUlJJ47.mjs";
 //#region src/index.d.ts
 type Command = (argv: string[]) => Promise<number>;
 declare const COMMANDS: readonly ["test", "generate", "repair", "record", "mock"];

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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 { 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 = [

package/dist/{repair-command-D3zL3G5W.d.cts → repair-command-8GUlJJ47.d.mts}

@@ -1,12 +1,17 @@
-import { McpHttpConnection, 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;
@@ -19,6 +24,29 @@ type ConnectTarget = {
   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;
@@ -40,6 +68,18 @@ interface GenerateCommandInput {
   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: {
@@ -56,9 +96,21 @@ interface GenerateCommandDependencies {
   }): 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[];
@@ -136,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;
@@ -169,10 +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
-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 };
+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/{repair-command-DQh2h4tQ.d.mts → repair-command-CVFqxU6V.d.cts}

@@ -1,12 +1,17 @@
-import { SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
 import { McpHttpConnection, 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";
 //#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;
@@ -19,6 +24,29 @@ type ConnectTarget = {
   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;
@@ -40,6 +68,18 @@ interface GenerateCommandInput {
   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: {
@@ -56,9 +96,21 @@ interface GenerateCommandDependencies {
   }): 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[];
@@ -136,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;
@@ -169,10 +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
-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 };
+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 };