mcp-test-timebox 0.1.0

package/dist/report/report-generator.js

@@ -0,0 +1,261 @@
+/**
+ * ReportGenerator - レポート生成コンポーネント
+ *
+ * テスト実行結果から成果物（raw.log, summary.md, summary.json）を生成する。
+ *
+ * Requirements:
+ * - 4.1: report_dir に raw.log を生成する
+ * - 4.2: report_dir に summary.md を生成する
+ * - 4.3: report_dir に summary.json を生成する
+ * - 4.4: raw.log は stdout/stderr の出力元を区別して記録する
+ * - 4.5: report_dir が未指定の場合、デフォルトパスを使用する
+ * - 5.4: summary.json に必須フィールドを含める
+ * - 5.5: summary.md に人間が読みやすい形式で情報を含める
+ */
+import { mkdir, writeFile, readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * 保持するレポートの最大数
+ */
+const MAX_REPORTS = 5;
+/**
+ * デフォルトのレポートディレクトリベースパス
+ */
+const DEFAULT_REPORT_BASE = '.cache/mcp-test-timebox/reports';
+/**
+ * タイムスタンプをISO8601形式でフォーマットする
+ *
+ * @param timestamp - Unix timestamp (ms)
+ * @returns ISO8601形式の文字列
+ */
+function formatTimestamp(timestamp) {
+    return new Date(timestamp).toISOString();
+}
+/**
+ * タイムスタンプをディレクトリ名用にフォーマットする
+ *
+ * @returns ディレクトリ名用の文字列（例: 20260113-123456）
+ */
+function generateTimestampDirName() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    return `${year}${month}${day}-${hours}${minutes}${seconds}`;
+}
+/**
+ * ステータスに対応する絵文字を取得する
+ *
+ * @param status - 実行ステータス
+ * @returns 絵文字
+ */
+function getStatusEmoji(status) {
+    switch (status) {
+        case 'pass':
+            return '✅';
+        case 'fail':
+            return '❌';
+        case 'timeout':
+            return '⏱️';
+        case 'no_output':
+            return '🔇';
+        case 'error':
+            return '⚠️';
+        default:
+            return '❓';
+    }
+}
+/**
+ * ミリ秒を人間が読みやすい形式に変換する
+ *
+ * @param ms - ミリ秒
+ * @returns 人間が読みやすい形式（例: "1m 23s" or "456ms"）
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes > 0) {
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * ReportGenerator - レポート生成の実装
+ */
+export class ReportGenerator {
+    /**
+     * 古いレポートを削除して最新N件のみ保持する
+     *
+     * @param basePath - レポートのベースパス
+     */
+    async cleanupOldReports(basePath) {
+        try {
+            const entries = await readdir(basePath, { withFileTypes: true });
+            // ディレクトリのみをフィルタし、名前でソート（タイムスタンプ形式なので降順で新しい順）
+            const dirs = entries
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => entry.name)
+                .sort()
+                .reverse();
+            // MAX_REPORTS を超える古いディレクトリを削除
+            const toDelete = dirs.slice(MAX_REPORTS);
+            for (const dir of toDelete) {
+                const dirPath = join(basePath, dir);
+                await rm(dirPath, { recursive: true, force: true });
+            }
+        }
+        catch {
+            // ディレクトリが存在しない場合などは無視
+        }
+    }
+    /**
+     * レポートディレクトリを作成する
+     *
+     * @param basePath - ベースパス（省略時はデフォルトパス）
+     * @returns 作成されたディレクトリのパス
+     */
+    async createReportDir(basePath) {
+        // デフォルトパスを使用（Requirements 4.5）
+        const base = basePath || DEFAULT_REPORT_BASE;
+        const timestampDir = generateTimestampDirName();
+        const reportDir = join(base, timestampDir);
+        // ディレクトリを再帰的に作成
+        await mkdir(reportDir, { recursive: true });
+        // 古いレポートをクリーンアップ
+        await this.cleanupOldReports(base);
+        return reportDir;
+    }
+    /**
+     * raw.log を生成する（stdout/stderr を区別して記録）
+     *
+     * @param reportDir - レポートディレクトリ
+     * @param entries - ログエントリの配列
+     * @returns 生成されたファイルのパス
+     */
+    async writeRawLog(reportDir, entries) {
+        const filePath = join(reportDir, 'raw.log');
+        // ログエントリをフォーマット（Requirements 4.4）
+        // フォーマット: [timestamp] [stream] data
+        const lines = entries.map((entry) => {
+            const timestamp = formatTimestamp(entry.timestamp);
+            return `[${timestamp}] [${entry.stream}] ${entry.data}`;
+        });
+        const content = lines.join('');
+        await writeFile(filePath, content, 'utf-8');
+        return filePath;
+    }
+    /**
+     * summary.md を生成する
+     *
+     * @param reportDir - レポートディレクトリ
+     * @param summary - 要約情報
+     * @returns 生成されたファイルのパス
+     */
+    async writeSummaryMd(reportDir, summary) {
+        const filePath = join(reportDir, 'summary.md');
+        // Markdown形式で要約を生成（Requirements 5.5）
+        const statusEmoji = getStatusEmoji(summary.status);
+        const durationFormatted = formatDuration(summary.durationMs);
+        const commandLine = `${summary.command} ${summary.args.join(' ')}`.trim();
+        const sections = [
+            `# Test Execution Summary`,
+            '',
+            `## Result`,
+            '',
+            `| Item | Value |`,
+            `|------|-------|`,
+            `| Status | ${statusEmoji} ${summary.status} |`,
+            `| Exit Code | ${summary.exitCode ?? 'N/A'} |`,
+            `| Duration | ${durationFormatted} (${summary.durationMs}ms) |`,
+            '',
+            `## Command`,
+            '',
+            '```',
+            commandLine,
+            '```',
+            '',
+        ];
+        // 抜粋ブロック
+        if (summary.excerpts.length > 0) {
+            sections.push(`## Excerpts`);
+            sections.push('');
+            sections.push('```');
+            sections.push(...summary.excerpts);
+            sections.push('```');
+            sections.push('');
+        }
+        // 末尾N行
+        if (summary.tailLines.length > 0) {
+            sections.push(`## Tail Lines`);
+            sections.push('');
+            sections.push('```');
+            sections.push(...summary.tailLines);
+            sections.push('```');
+            sections.push('');
+        }
+        const content = sections.join('\n');
+        await writeFile(filePath, content, 'utf-8');
+        return filePath;
+    }
+    /**
+     * summary.json を生成する
+     *
+     * @param reportDir - レポートディレクトリ
+     * @param summary - 要約情報
+     * @returns 生成されたファイルのパス
+     */
+    async writeSummaryJson(reportDir, summary) {
+        const filePath = join(reportDir, 'summary.json');
+        // JSON形式で要約を生成（Requirements 5.4）
+        // 必須フィールド: command, exit_code, status, duration_ms, excerpts, tail_lines
+        const jsonContent = {
+            command: `${summary.command} ${summary.args.join(' ')}`.trim(),
+            args: summary.args,
+            status: summary.status,
+            exit_code: summary.exitCode,
+            duration_ms: summary.durationMs,
+            excerpts: summary.excerpts,
+            tail_lines: summary.tailLines,
+            generated_at: new Date().toISOString(),
+        };
+        const content = JSON.stringify(jsonContent, null, 2);
+        await writeFile(filePath, content, 'utf-8');
+        return filePath;
+    }
+    /**
+     * すべての成果物を生成する
+     *
+     * @param reportDir - レポートディレクトリ
+     * @param entries - ログエントリの配列
+     * @param summary - 要約情報
+     * @returns 生成された成果物のパス
+     */
+    async writeAll(reportDir, entries, summary) {
+        const [rawLog, summaryMd, summaryJson] = await Promise.all([
+            this.writeRawLog(reportDir, entries),
+            this.writeSummaryMd(reportDir, summary),
+            this.writeSummaryJson(reportDir, summary),
+        ]);
+        return {
+            rawLog,
+            summaryMd,
+            summaryJson,
+        };
+    }
+}
+/**
+ * ReportGeneratorのファクトリ関数
+ *
+ * @returns 新しいReportGeneratorインスタンス
+ */
+export function createReportGenerator() {
+    return new ReportGenerator();
+}
+//# sourceMappingURL=report-generator.js.map

package/dist/report/report-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-generator.js","sourceRoot":"","sources":["../../src/report/report-generator.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * mcp-test-timebox MCPサーバ エントリポイント
+ *
+ * タイムボックス付きテスト専用MCPサーバ
+ * - stdio経由でMCPプロトコルに準拠した通信を行う
+ * - run_testツールのみを公開
+ * - stdoutはMCPプロトコル専用、ログはstderrへ
+ *
+ * Requirements:
+ * - 1.1: stdio経由でMCPプロトコルに準拠した通信を開始する
+ * - 1.2: run_testツールのみを公開する
+ * - 1.3: stdoutにログを出力せず、MCPプロトコル出力を破壊しない
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * MCPサーバを作成する
+ *
+ * @returns 設定済みのMcpServerインスタンス
+ */
+export declare function createMcpServer(): McpServer;
+/**
+ * MCPサーバを起動する
+ * stdio transportを使用してクライアントと通信する
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+DpE;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAgE3C;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBjD"}

package/dist/server.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+/**
+ * mcp-test-timebox MCPサーバ エントリポイント
+ *
+ * タイムボックス付きテスト専用MCPサーバ
+ * - stdio経由でMCPプロトコルに準拠した通信を行う
+ * - run_testツールのみを公開
+ * - stdoutはMCPプロトコル専用、ログはstderrへ
+ *
+ * Requirements:
+ * - 1.1: stdio経由でMCPプロトコルに準拠した通信を開始する
+ * - 1.2: run_testツールのみを公開する
+ * - 1.3: stdoutにログを出力せず、MCPプロトコル出力を破壊しない
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { createRunTestTool } from './tools/run-test.js';
+import { ALLOWED_RUNNERS, ALLOWED_SCOPES } from './validation/input-schema.js';
+/**
+ * サーバ情報
+ */
+const SERVER_INFO = {
+    name: 'mcp-test-timebox',
+    version: '0.1.0',
+    description: 'タイムボックス付きテスト専用MCPサーバ - テスト実行が終わらない問題を防ぐ',
+};
+/**
+ * run_testツールの入力スキーマ（Zod shape）
+ * MCPプロトコルで公開するスキーマ定義
+ *
+ * 注意: MCP SDKはZodObjectではなく、オブジェクトの形状（shape）を期待する
+ */
+const runTestInputShape = {
+    /** テストランナー（MVPでは flutter のみ） */
+    runner: z.enum(ALLOWED_RUNNERS).describe(`テストランナー。許可値: ${ALLOWED_RUNNERS.join(', ')}`),
+    /** テスト実行スコープ */
+    scope: z.enum(ALLOWED_SCOPES).describe(`テスト実行スコープ。all: 全テスト, file: 特定ファイル, pattern: パターンマッチ`),
+    /** テスト対象（scope が file/pattern の場合必須） */
+    target: z.string().optional().describe('テスト対象。scope が file または pattern の場合必須'),
+    /** ハードタイムアウト（ミリ秒） */
+    timeout_ms: z.number().int().positive().describe('ハードタイムアウト（ミリ秒）。この時間を超えるとプロセスを強制終了'),
+    /** 無出力タイムアウト（ミリ秒） */
+    no_output_timeout_ms: z.number().int().positive().describe('無出力タイムアウト（ミリ秒）。この時間出力がないとプロセスを強制終了'),
+    /** 要約対象の末尾バイト数 */
+    max_output_bytes: z.number().int().positive().describe('要約対象の末尾バイト数。ログ抽出時にこのバイト数を対象とする'),
+    /** レポート出力ディレクトリ（相対パス、オプション） */
+    report_dir: z.string().optional().describe('レポート出力ディレクトリ（相対パス）。省略時はデフォルトパスを使用'),
+};
+/**
+ * デバッグログをstderrに出力する
+ * stdoutはMCPプロトコル専用のため、ログはstderrへ
+ *
+ * @param message - ログメッセージ
+ */
+function debugLog(message) {
+    const timestamp = new Date().toISOString();
+    console.error(`[${timestamp}] [mcp-test-timebox] ${message}`);
+}
+/**
+ * MCPサーバを作成する
+ *
+ * @returns 設定済みのMcpServerインスタンス
+ */
+export function createMcpServer() {
+    // MCPサーバインスタンスを作成
+    const server = new McpServer(SERVER_INFO);
+    // RunTestToolインスタンスを作成
+    const runTestTool = createRunTestTool();
+    // run_testツールを登録（registerToolを使用）
+    server.registerTool('run_test', {
+        description: 'タイムボックス付きでテストを実行する。固定テンプレート（flutter test等）のみ許可し、実行結果をレポートとして保存する。',
+        inputSchema: runTestInputShape,
+    }, async (params) => {
+        debugLog(`run_test called with params: ${JSON.stringify(params)}`);
+        try {
+            // ツールを実行
+            const result = await runTestTool.execute(params);
+            debugLog(`run_test completed with status: ${result.status}`);
+            // MCPレスポンス形式で返す
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // 予期しないエラーの場合
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            debugLog(`run_test error: ${errorMessage}`);
+            const errorResult = {
+                status: 'error',
+                exit_code: null,
+                duration_ms: 0,
+                report_dir: '',
+                artifacts: {
+                    raw_log: '',
+                    summary_md: '',
+                    summary_json: '',
+                },
+                excerpt: '',
+                error_message: `予期しないエラー: ${errorMessage}`,
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(errorResult, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    return server;
+}
+/**
+ * MCPサーバを起動する
+ * stdio transportを使用してクライアントと通信する
+ */
+export async function startServer() {
+    debugLog('Starting MCP server...');
+    try {
+        // MCPサーバを作成
+        const server = createMcpServer();
+        // stdio transportを作成
+        const transport = new StdioServerTransport();
+        // サーバをtransportに接続
+        await server.connect(transport);
+        debugLog('MCP server started successfully');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        debugLog(`Failed to start MCP server: ${errorMessage}`);
+        process.exit(1);
+    }
+}
+// メインエントリポイント
+// このファイルが直接実行された場合にサーバを起動
+// ESMではimport.meta.urlを使用してメインモジュールかどうかを判定
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+    startServer().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tools モジュール
+ *
+ * MCPサーバが公開するツールをエクスポートする
+ */
+export { RunTestTool, createRunTestTool, type RunTestOutput, type RunTestToolOptions, } from './run-test.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+/**
+ * Tools モジュール
+ *
+ * MCPサーバが公開するツールをエクスポートする
+ */
+export { RunTestTool, createRunTestTool, } from './run-test.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,GAGlB,MAAM,eAAe,CAAC"}

package/dist/tools/run-test.d.ts

@@ -0,0 +1,80 @@
+/**
+ * RunTestTool - テスト実行ツール
+ *
+ * MCPサーバが公開する唯一のツール。
+ * 入力バリデーション、コマンド構築、プロセス実行、レポート生成を統合する。
+ *
+ * Requirements:
+ * - 2.1-2.6: テスト実行コマンドの制限
+ * - 6.1-6.5: MCPレスポンスの必須フィールド
+ */
+/**
+ * RunTestToolの出力インターフェース
+ *
+ * Requirements 6.1-6.5に準拠
+ */
+export interface RunTestOutput {
+    /** 実行ステータス（pass/fail/timeout/no_output/error） */
+    status: 'pass' | 'fail' | 'timeout' | 'no_output' | 'error';
+    /** 終了コード（タイムアウト/エラー時はnull） */
+    exit_code: number | null;
+    /** 実行時間（ミリ秒） */
+    duration_ms: number;
+    /** レポートディレクトリのパス */
+    report_dir: string;
+    /** 生成された成果物のパス */
+    artifacts: {
+        raw_log: string;
+        summary_md: string;
+        summary_json: string;
+    };
+    /** 抜粋（重要行の抽出結果） */
+    excerpt: string;
+    /** エラーメッセージ（エラー時のみ） */
+    error_message?: string;
+}
+/**
+ * RunTestToolのオプション
+ */
+export interface RunTestToolOptions {
+    /** リポジトリルートパス（デフォルト: process.cwd()） */
+    repoRoot?: string;
+    /** 末尾行数（要約用、デフォルト: 20） */
+    tailLineCount?: number;
+}
+/**
+ * RunTestToolクラス
+ *
+ * テスト実行の全体フローを管理する
+ */
+export declare class RunTestTool {
+    private readonly repoRoot;
+    private readonly tailLineCount;
+    /**
+     * @param options - ツールオプション
+     */
+    constructor(options?: RunTestToolOptions);
+    /**
+     * テストを実行する
+     *
+     * @param input - 入力パラメータ（未検証）
+     * @returns 実行結果
+     */
+    execute(input: unknown): Promise<RunTestOutput>;
+    /**
+     * エラーレスポンスを生成する
+     *
+     * @param startTime - 開始時刻
+     * @param errorMessage - エラーメッセージ
+     * @returns エラーレスポンス
+     */
+    private createErrorResponse;
+}
+/**
+ * RunTestToolのファクトリ関数
+ *
+ * @param options - ツールオプション
+ * @returns 新しいRunTestToolインスタンス
+ */
+export declare function createRunTestTool(options?: RunTestToolOptions): RunTestTool;
+//# sourceMappingURL=run-test.d.ts.map

package/dist/tools/run-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-test.d.ts","sourceRoot":"","sources":["../../src/tools/run-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5D,8BAA8B;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiBD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;OAEG;gBACS,OAAO,GAAE,kBAAuB;IAK5C;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAqIrD;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CAe5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAE3E"}