mcp-test-timebox 0.1.0

package/dist/validation/input-schema.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 入力バリデーションスキーマ（Zod）
+ *
+ * run_testツールの入力パラメータを検証する。
+ *
+ * Requirements:
+ * - 7.1: runnerが未指定または許可されていない値の場合エラー
+ * - 7.2: scopeが未指定または許可されていない値の場合エラー
+ * - 7.3: scope が file/pattern で target が未指定の場合エラー
+ * - 7.4: timeout_ms が未指定または正の整数でない場合エラー
+ * - 7.5: no_output_timeout_ms が未指定または正の整数でない場合エラー
+ * - 7.6: max_output_bytes が未指定または正の整数でない場合エラー
+ */
+import { z } from 'zod';
+/**
+ * 許可されたテストランナー
+ * MVPでは flutter のみサポート
+ */
+export declare const ALLOWED_RUNNERS: readonly ["flutter"];
+export type Runner = typeof ALLOWED_RUNNERS[number];
+/**
+ * テスト実行スコープ
+ * - all: 全テスト実行
+ * - file: 特定ファイルのテスト実行
+ * - pattern: パターンマッチでテスト実行
+ */
+export declare const ALLOWED_SCOPES: readonly ["all", "file", "pattern"];
+export type Scope = typeof ALLOWED_SCOPES[number];
+/**
+ * run_test入力スキーマ（条件付きバリデーション付き）
+ *
+ * scope が 'file' または 'pattern' の場合、target は必須
+ */
+export declare const runTestInputSchema: z.ZodObject<{
+    runner: z.ZodEnum<{
+        flutter: "flutter";
+    }>;
+    scope: z.ZodEnum<{
+        all: "all";
+        file: "file";
+        pattern: "pattern";
+    }>;
+    target: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodNumber;
+    no_output_timeout_ms: z.ZodNumber;
+    max_output_bytes: z.ZodNumber;
+    report_dir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * run_test入力の型定義
+ */
+export type RunTestInput = z.infer<typeof runTestInputSchema>;
+/**
+ * バリデーション結果
+ */
+export interface ValidationResult<T> {
+    /** バリデーション成功かどうか */
+    success: boolean;
+    /** パース済みデータ（成功時のみ） */
+    data?: T;
+    /** エラーメッセージ（失敗時のみ） */
+    errors?: string[];
+}
+/**
+ * run_test入力をバリデートする
+ *
+ * @param input - 検証対象の入力
+ * @returns バリデーション結果
+ */
+export declare function validateRunTestInput(input: unknown): ValidationResult<RunTestInput>;
+/**
+ * ランナーが許可されているかチェック
+ *
+ * @param runner - チェック対象のランナー
+ * @returns 許可されている場合 true
+ */
+export declare function isAllowedRunner(runner: string): runner is Runner;
+/**
+ * スコープが許可されているかチェック
+ *
+ * @param scope - チェック対象のスコープ
+ * @returns 許可されている場合 true
+ */
+export declare function isAllowedScope(scope: string): scope is Scope;
+//# sourceMappingURL=input-schema.d.ts.map

package/dist/validation/input-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-schema.d.ts","sourceRoot":"","sources":["../../src/validation/input-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,eAAe,sBAAuB,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAClE,MAAM,MAAM,KAAK,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAuClD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAS7B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAoBnF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,KAAK,CAE5D"}

package/dist/validation/input-schema.js

@@ -0,0 +1,113 @@
+/**
+ * 入力バリデーションスキーマ（Zod）
+ *
+ * run_testツールの入力パラメータを検証する。
+ *
+ * Requirements:
+ * - 7.1: runnerが未指定または許可されていない値の場合エラー
+ * - 7.2: scopeが未指定または許可されていない値の場合エラー
+ * - 7.3: scope が file/pattern で target が未指定の場合エラー
+ * - 7.4: timeout_ms が未指定または正の整数でない場合エラー
+ * - 7.5: no_output_timeout_ms が未指定または正の整数でない場合エラー
+ * - 7.6: max_output_bytes が未指定または正の整数でない場合エラー
+ */
+import { z } from 'zod';
+/**
+ * 許可されたテストランナー
+ * MVPでは flutter のみサポート
+ */
+export const ALLOWED_RUNNERS = ['flutter'];
+/**
+ * テスト実行スコープ
+ * - all: 全テスト実行
+ * - file: 特定ファイルのテスト実行
+ * - pattern: パターンマッチでテスト実行
+ */
+export const ALLOWED_SCOPES = ['all', 'file', 'pattern'];
+/**
+ * 正の整数スキーマ（共通）
+ */
+const positiveIntSchema = z.number().int().positive({
+    message: '正の整数である必要があります',
+});
+/**
+ * run_test入力スキーマ（基本）
+ */
+const baseRunTestInputSchema = z.object({
+    /** テストランナー（MVPでは flutter のみ） */
+    runner: z.enum(ALLOWED_RUNNERS, {
+        error: `runnerは ${ALLOWED_RUNNERS.join(', ')} のいずれかである必要があります`,
+    }),
+    /** テスト実行スコープ */
+    scope: z.enum(ALLOWED_SCOPES, {
+        error: `scopeは ${ALLOWED_SCOPES.join(', ')} のいずれかである必要があります`,
+    }),
+    /** テスト対象（scope が file/pattern の場合必須） */
+    target: z.string().optional(),
+    /** ハードタイムアウト（ミリ秒） */
+    timeout_ms: positiveIntSchema,
+    /** 無出力タイムアウト（ミリ秒） */
+    no_output_timeout_ms: positiveIntSchema,
+    /** 要約対象の末尾バイト数 */
+    max_output_bytes: positiveIntSchema,
+    /** レポート出力ディレクトリ（相対パス、オプション） */
+    report_dir: z.string().optional(),
+});
+/**
+ * run_test入力スキーマ（条件付きバリデーション付き）
+ *
+ * scope が 'file' または 'pattern' の場合、target は必須
+ */
+export const runTestInputSchema = baseRunTestInputSchema.superRefine((data, ctx) => {
+    // scope が file または pattern の場合、target は必須
+    if ((data.scope === 'file' || data.scope === 'pattern') && !data.target) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `scope が '${data.scope}' の場合、target は必須です`,
+            path: ['target'],
+        });
+    }
+});
+/**
+ * run_test入力をバリデートする
+ *
+ * @param input - 検証対象の入力
+ * @returns バリデーション結果
+ */
+export function validateRunTestInput(input) {
+    const result = runTestInputSchema.safeParse(input);
+    if (result.success) {
+        return {
+            success: true,
+            data: result.data,
+        };
+    }
+    // エラーメッセージを抽出
+    const errors = result.error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';
+        return `${path}${issue.message}`;
+    });
+    return {
+        success: false,
+        errors,
+    };
+}
+/**
+ * ランナーが許可されているかチェック
+ *
+ * @param runner - チェック対象のランナー
+ * @returns 許可されている場合 true
+ */
+export function isAllowedRunner(runner) {
+    return ALLOWED_RUNNERS.includes(runner);
+}
+/**
+ * スコープが許可されているかチェック
+ *
+ * @param scope - チェック対象のスコープ
+ * @returns 許可されている場合 true
+ */
+export function isAllowedScope(scope) {
+    return ALLOWED_SCOPES.includes(scope);
+}
+//# sourceMappingURL=input-schema.js.map

package/dist/validation/input-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-schema.js","sourceRoot":"","sources":["../../src/validation/input-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,CAAU,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAGlE;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC;IAClD,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,gCAAgC;IAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE;QAC9B,KAAK,EAAE,WAAW,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB;KAC/D,CAAC;IAEF,gBAAgB;IAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE;QAC5B,KAAK,EAAE,UAAU,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB;KAC7D,CAAC;IAEF,wCAAwC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE7B,qBAAqB;IACrB,UAAU,EAAE,iBAAiB;IAE7B,qBAAqB;IACrB,oBAAoB,EAAE,iBAAiB;IAEvC,kBAAkB;IAClB,gBAAgB,EAAE,iBAAiB;IAEnC,+BAA+B;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IACjF,0CAA0C;IAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACxE,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,YAAY,IAAI,CAAC,KAAK,oBAAoB;YACnD,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAmBH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAgB,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC;AACjD,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mcp-test-timebox",
+  "version": "0.1.0",
+  "description": "タイムボックス付きテスト専用MCPサーバ - テスト実行が終わらない問題を防ぐ",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "mcp-test-timebox": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "test",
+    "timebox",
+    "flutter",
+    "timeout",
+    "test-runner"
+  ],
+  "author": "kawanishi0117",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kawanishi0117/mcp-test-timebox.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kawanishi0117/mcp-test-timebox/issues"
+  },
+  "homepage": "https://github.com/kawanishi0117/mcp-test-timebox#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "tree-kill": "^1.2.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.6",
+    "fast-check": "^4.5.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}