@mcpeak/cli 0.11.0 → 0.14.0

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@mcpeak/cli",
-  "version": "0.11.0",
+  "version": "0.14.0",
   "private": false,
   "type": "module",
-  "description": "MCPeak 프레임워크의 CLI 진입점 (얇게 유지)",
+  "description": "CLI for testing MCP servers: run test suites, generate tests, record/replay, mock, and audit",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "testing",
+    "test-framework",
+    "cli"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=22.18.0"
@@ -50,11 +58,13 @@
     "dist"
   ],
   "dependencies": {
-    "@mcpeak/core": "0.4.0",
-    "@mcpeak/runner": "0.10.0",
-    "@mcpeak/generate": "0.7.0",
-    "@mcpeak/record": "0.4.0",
-    "@mcpeak/mock": "0.4.1"
+    "@mcpeak/core": "0.6.1",
+    "@mcpeak/runner": "0.11.2",
+    "@mcpeak/generate": "0.8.2",
+    "@mcpeak/record": "0.5.1",
+    "@mcpeak/mock": "0.4.4",
+    "@mcpeak/optimize": "0.2.1",
+    "@mcpeak/audit": "0.3.0"
   },
   "scripts": {
     "build": "tsdown --config-loader native",

package/dist/repair-command-D3zL3G5W.d.cts

@@ -1,178 +0,0 @@
-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;
-  /**
-   * 명세를 뽑을 대상. `--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;
-  /** `--force`. `--out` 에 파일이 있으면 지우고 새로 쓴다. 설계 문서 §5. */
-  readonly force: boolean;
-  /** `--reset-cmd`. 시험 실행 직전 1회 실행한다. */
-  readonly resetCmd?: string;
-  /** 입력값 교정 단계를 돌릴지 여부. 기본은 실행이고 `--no-repair` 가 끈다. 설계 문서 §7. */
-  readonly repair: boolean;
-}
-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;
-  createBaselineSuite(tools: readonly ToolDef[], options: {
-    suiteId: string;
-    suiteName: string;
-  }): BaselineGenerationResult;
-  createAuthoringSession(baseline: BaselineGenerationResult, options?: {
-    readonly preFilledCaseIds?: readonly string[];
-  }): AuthoringSessionView;
-  finalizeAuthoringDraft(options: {
-    session: AuthoringSessionView;
-    approval: {
-      approved: boolean;
-      fingerprint: string;
-    };
-  }): {
-    finalized: true;
-    snapshot: AuthoringExecutionSnapshot;
-  } | {
-    finalized: false;
-  };
-  getAuthoringExecutionSuite(snapshot: AuthoringExecutionSnapshot): TestSuiteSpec;
-  validateSuite(value: unknown): SuiteValidationResult;
-  exists(path: string): Promise<boolean>;
-  openTemp(path: string): Promise<{
-    writeFile(data: string, encoding: "utf8"): Promise<void>;
-    sync(): Promise<void>;
-    close(): Promise<void>;
-  }>;
-  readFile(path: string): Promise<Uint8Array>;
-  /**
-   * 임시 파일을 최종 경로에 커밋한다. `rename`이 아니라 `link`인 것이 요점이다.
-   * `rename`은 대상이 있으면 말없이 덮어쓴다. `link`는 EEXIST로 실패하므로
-   * 원자성과 no-clobber를 동시에 얻는다. 덮어쓸 수 있는 primitive를 아예 두지 않는다.
-   */
-  link(from: string, to: string): Promise<void>;
-  unlink(path: string): Promise<void>;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-  reviewIO?: ReviewIO;
-  providers?: Partial<Record<"codex" | "claude", (model: string) => TestAuthoringProvider | undefined>>;
-  /**
-   * 거절 근거 진단 통로 (#89 · 설계 문서 §6). `providers` 와 **따로 둔다.** 그쪽은
-   * `TestAuthoringProvider`(`author`)이고 이쪽은 `diagnoseRejection` 이라 다른 계약이다.
-   * `preFillProviders` 와 같은 선례다. 없으면 진단을 아예 묻지 않는다.
-   */
-  rejectionProviders?: Partial<Record<"codex" | "claude", (model: string) => import("@mcpeak/generate").RejectionDiagnosisProvider | undefined>>;
-  prepareRejectionDiagnosisRequests?: typeof import("@mcpeak/generate").prepareRejectionDiagnosisRequests;
-  dispatchRejectionDiagnosis?: typeof import("@mcpeak/generate").dispatchRejectionDiagnosis;
-  prepareAuthoringRequest?: typeof import("@mcpeak/generate").prepareAuthoringRequest;
-  dispatchAuthoringRequest?: typeof import("@mcpeak/generate").dispatchAuthoringRequest;
-  createAuthoringDiff?: typeof import("@mcpeak/generate").createAuthoringDiff;
-  applyAuthoringChanges?: typeof import("@mcpeak/generate").applyAuthoringChanges;
-  reviewLocalAuthoringCandidate?: typeof import("@mcpeak/generate").reviewLocalAuthoringCandidate;
-  computeCoverage?: typeof import("@mcpeak/generate").computeCoverage;
-  /**
-   * AI 사전보완 통로. 넷 다 주입돼야 사전보완이 돈다. 하나라도 없으면 건너뛴다.
-   * 위 authoring 통로와 같은 이유로 값 import 가 아니라 주입이다.
-   */
-  preparePreFillRequest?: typeof import("@mcpeak/generate").preparePreFillRequest;
-  previewPreFillRequest?: typeof import("@mcpeak/generate").previewPreFillRequest;
-  dispatchPreFillRequest?: typeof import("@mcpeak/generate").dispatchPreFillRequest;
-  preFillProviders?: Partial<Record<"codex" | "claude", (model: string) => PreFillProvider | undefined>>;
-  /**
-   * `instanceof` 용 클래스. 값 import 가 아니라 주입인 것이 요점이다.
-   *
-   * 이 파일은 `@mcpeak/generate` 에서 타입만 가져온다(위 `import type`). 클래스를 값으로
-   * 가져오면 `index.ts` 가 정적으로 끌어와 `test` 경로까지 `generate` 를 로드한다.
-   * `typeof import(...)` 는 타입 위치라 런타임 import 가 생기지 않고, 주입하면 클래스
-   * 동일성도 보장된다. 위 6개 필드가 같은 방식이다.
-   */
-  GenerateTestsError?: typeof import("@mcpeak/generate").GenerateTestsError;
-}
-interface ReviewIO {
-  input(message: string): Promise<string>;
-  choose(message: string, choices: readonly string[]): Promise<string>;
-  confirm(message: string): Promise<boolean>;
-  write(text: string): void;
-  readonly interactive: boolean;
-  close?(): void;
-}
-type TestAuthoringProvider = import("@mcpeak/generate").TestAuthoringProvider;
-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;
-//#endregion
-//#region src/repair-command.d.ts
-interface RepairCommandInput {
-  readonly bundlePath: string;
-  readonly providerId: "codex" | "claude";
-  readonly model: string;
-  readonly yes: boolean;
-  readonly includeStderr: boolean;
-  readonly maxCases: number;
-}
-interface RepairCommandDependencies {
-  readFile(path: string): Promise<string>;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-  /** 전송 확인 화면. 없으면 비대화형으로 본다. `generate` 가 쓰는 그 인터페이스다. */
-  readonly reviewIO?: ReviewIO;
-  /**
-   * 진단 통로. `@mcpeak/generate` 를 값으로 import 하지 않고 주입받는다. 정적으로 import 하면
-   * `test` 경로가 `generate` 를 함께 로드한다. 계획서 §8 위험표 첫 줄이다.
-   */
-  readonly diagnosis?: {
-    readonly prepare: typeof import("@mcpeak/generate").prepareDiagnosisRequest;
-    readonly dispatch: typeof import("@mcpeak/generate").dispatchDiagnosisRequest;
-    readonly providers: {
-      readonly codex: (model: string) => import("@mcpeak/generate").ServerDiagnosisProvider;
-      readonly claude: (model: string) => import("@mcpeak/generate").ServerDiagnosisProvider;
-    };
-  };
-}
-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 };

package/dist/repair-command-DQh2h4tQ.d.mts

@@ -1,178 +0,0 @@
-import { SuiteValidationResult, TestSuiteSpec } from "@mcpeak/runner";
-import { McpHttpConnection, McpStdioConnection, ToolDef } from "@mcpeak/core";
-import { AuthoringExecutionSnapshot, AuthoringSessionView, BaselineGenerationResult, PreFillProvider } from "@mcpeak/generate";
-//#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;
-  /**
-   * 명세를 뽑을 대상. `--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;
-  /** `--force`. `--out` 에 파일이 있으면 지우고 새로 쓴다. 설계 문서 §5. */
-  readonly force: boolean;
-  /** `--reset-cmd`. 시험 실행 직전 1회 실행한다. */
-  readonly resetCmd?: string;
-  /** 입력값 교정 단계를 돌릴지 여부. 기본은 실행이고 `--no-repair` 가 끈다. 설계 문서 §7. */
-  readonly repair: boolean;
-}
-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;
-  createBaselineSuite(tools: readonly ToolDef[], options: {
-    suiteId: string;
-    suiteName: string;
-  }): BaselineGenerationResult;
-  createAuthoringSession(baseline: BaselineGenerationResult, options?: {
-    readonly preFilledCaseIds?: readonly string[];
-  }): AuthoringSessionView;
-  finalizeAuthoringDraft(options: {
-    session: AuthoringSessionView;
-    approval: {
-      approved: boolean;
-      fingerprint: string;
-    };
-  }): {
-    finalized: true;
-    snapshot: AuthoringExecutionSnapshot;
-  } | {
-    finalized: false;
-  };
-  getAuthoringExecutionSuite(snapshot: AuthoringExecutionSnapshot): TestSuiteSpec;
-  validateSuite(value: unknown): SuiteValidationResult;
-  exists(path: string): Promise<boolean>;
-  openTemp(path: string): Promise<{
-    writeFile(data: string, encoding: "utf8"): Promise<void>;
-    sync(): Promise<void>;
-    close(): Promise<void>;
-  }>;
-  readFile(path: string): Promise<Uint8Array>;
-  /**
-   * 임시 파일을 최종 경로에 커밋한다. `rename`이 아니라 `link`인 것이 요점이다.
-   * `rename`은 대상이 있으면 말없이 덮어쓴다. `link`는 EEXIST로 실패하므로
-   * 원자성과 no-clobber를 동시에 얻는다. 덮어쓸 수 있는 primitive를 아예 두지 않는다.
-   */
-  link(from: string, to: string): Promise<void>;
-  unlink(path: string): Promise<void>;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-  reviewIO?: ReviewIO;
-  providers?: Partial<Record<"codex" | "claude", (model: string) => TestAuthoringProvider | undefined>>;
-  /**
-   * 거절 근거 진단 통로 (#89 · 설계 문서 §6). `providers` 와 **따로 둔다.** 그쪽은
-   * `TestAuthoringProvider`(`author`)이고 이쪽은 `diagnoseRejection` 이라 다른 계약이다.
-   * `preFillProviders` 와 같은 선례다. 없으면 진단을 아예 묻지 않는다.
-   */
-  rejectionProviders?: Partial<Record<"codex" | "claude", (model: string) => import("@mcpeak/generate").RejectionDiagnosisProvider | undefined>>;
-  prepareRejectionDiagnosisRequests?: typeof import("@mcpeak/generate").prepareRejectionDiagnosisRequests;
-  dispatchRejectionDiagnosis?: typeof import("@mcpeak/generate").dispatchRejectionDiagnosis;
-  prepareAuthoringRequest?: typeof import("@mcpeak/generate").prepareAuthoringRequest;
-  dispatchAuthoringRequest?: typeof import("@mcpeak/generate").dispatchAuthoringRequest;
-  createAuthoringDiff?: typeof import("@mcpeak/generate").createAuthoringDiff;
-  applyAuthoringChanges?: typeof import("@mcpeak/generate").applyAuthoringChanges;
-  reviewLocalAuthoringCandidate?: typeof import("@mcpeak/generate").reviewLocalAuthoringCandidate;
-  computeCoverage?: typeof import("@mcpeak/generate").computeCoverage;
-  /**
-   * AI 사전보완 통로. 넷 다 주입돼야 사전보완이 돈다. 하나라도 없으면 건너뛴다.
-   * 위 authoring 통로와 같은 이유로 값 import 가 아니라 주입이다.
-   */
-  preparePreFillRequest?: typeof import("@mcpeak/generate").preparePreFillRequest;
-  previewPreFillRequest?: typeof import("@mcpeak/generate").previewPreFillRequest;
-  dispatchPreFillRequest?: typeof import("@mcpeak/generate").dispatchPreFillRequest;
-  preFillProviders?: Partial<Record<"codex" | "claude", (model: string) => PreFillProvider | undefined>>;
-  /**
-   * `instanceof` 용 클래스. 값 import 가 아니라 주입인 것이 요점이다.
-   *
-   * 이 파일은 `@mcpeak/generate` 에서 타입만 가져온다(위 `import type`). 클래스를 값으로
-   * 가져오면 `index.ts` 가 정적으로 끌어와 `test` 경로까지 `generate` 를 로드한다.
-   * `typeof import(...)` 는 타입 위치라 런타임 import 가 생기지 않고, 주입하면 클래스
-   * 동일성도 보장된다. 위 6개 필드가 같은 방식이다.
-   */
-  GenerateTestsError?: typeof import("@mcpeak/generate").GenerateTestsError;
-}
-interface ReviewIO {
-  input(message: string): Promise<string>;
-  choose(message: string, choices: readonly string[]): Promise<string>;
-  confirm(message: string): Promise<boolean>;
-  write(text: string): void;
-  readonly interactive: boolean;
-  close?(): void;
-}
-type TestAuthoringProvider = import("@mcpeak/generate").TestAuthoringProvider;
-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;
-//#endregion
-//#region src/repair-command.d.ts
-interface RepairCommandInput {
-  readonly bundlePath: string;
-  readonly providerId: "codex" | "claude";
-  readonly model: string;
-  readonly yes: boolean;
-  readonly includeStderr: boolean;
-  readonly maxCases: number;
-}
-interface RepairCommandDependencies {
-  readFile(path: string): Promise<string>;
-  writeStdout(text: string): void;
-  writeStderr(text: string): void;
-  /** 전송 확인 화면. 없으면 비대화형으로 본다. `generate` 가 쓰는 그 인터페이스다. */
-  readonly reviewIO?: ReviewIO;
-  /**
-   * 진단 통로. `@mcpeak/generate` 를 값으로 import 하지 않고 주입받는다. 정적으로 import 하면
-   * `test` 경로가 `generate` 를 함께 로드한다. 계획서 §8 위험표 첫 줄이다.
-   */
-  readonly diagnosis?: {
-    readonly prepare: typeof import("@mcpeak/generate").prepareDiagnosisRequest;
-    readonly dispatch: typeof import("@mcpeak/generate").dispatchDiagnosisRequest;
-    readonly providers: {
-      readonly codex: (model: string) => import("@mcpeak/generate").ServerDiagnosisProvider;
-      readonly claude: (model: string) => import("@mcpeak/generate").ServerDiagnosisProvider;
-    };
-  };
-}
-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 };