mcp-test-timebox 0.1.0

package/dist/tools/run-test.js

@@ -0,0 +1,178 @@
+/**
+ * RunTestTool - テスト実行ツール
+ *
+ * MCPサーバが公開する唯一のツール。
+ * 入力バリデーション、コマンド構築、プロセス実行、レポート生成を統合する。
+ *
+ * Requirements:
+ * - 2.1-2.6: テスト実行コマンドの制限
+ * - 6.1-6.5: MCPレスポンスの必須フィールド
+ */
+import { validateRunTestInput } from '../validation/input-schema.js';
+import { buildCommand } from '../validation/command-builder.js';
+import { createProcessExecutor } from '../executor/process-executor.js';
+import { createReportGenerator } from '../report/report-generator.js';
+import { createLogExtractor, formatExtractedBlocks } from '../report/log-extractor.js';
+import { normalizePath } from '../utils/path-validator.js';
+/**
+ * デフォルトの末尾行数
+ */
+const DEFAULT_TAIL_LINE_COUNT = 20;
+/**
+ * ログエントリを結合してログ文字列を生成する
+ *
+ * @param logs - ログエントリの配列
+ * @returns 結合されたログ文字列
+ */
+function combineLogEntries(logs) {
+    return logs.map(entry => entry.data).join('');
+}
+/**
+ * RunTestToolクラス
+ *
+ * テスト実行の全体フローを管理する
+ */
+export class RunTestTool {
+    repoRoot;
+    tailLineCount;
+    /**
+     * @param options - ツールオプション
+     */
+    constructor(options = {}) {
+        this.repoRoot = options.repoRoot || process.cwd();
+        this.tailLineCount = options.tailLineCount || DEFAULT_TAIL_LINE_COUNT;
+    }
+    /**
+     * テストを実行する
+     *
+     * @param input - 入力パラメータ（未検証）
+     * @returns 実行結果
+     */
+    async execute(input) {
+        const startTime = Date.now();
+        // 1. 入力バリデーション
+        const validationResult = validateRunTestInput(input);
+        if (!validationResult.success || !validationResult.data) {
+            return this.createErrorResponse(startTime, `入力バリデーションエラー: ${validationResult.errors?.join(', ')}`);
+        }
+        const validInput = validationResult.data;
+        // 2. targetパスの検証（scope が file/pattern の場合）
+        if (validInput.target) {
+            const pathResult = normalizePath(validInput.target, this.repoRoot);
+            if (!pathResult.valid) {
+                return this.createErrorResponse(startTime, `パス検証エラー: ${pathResult.error}`);
+            }
+        }
+        // 3. report_dirパスの検証（指定されている場合）
+        let reportDirBase;
+        if (validInput.report_dir) {
+            const pathResult = normalizePath(validInput.report_dir, this.repoRoot);
+            if (!pathResult.valid) {
+                return this.createErrorResponse(startTime, `レポートディレクトリパス検証エラー: ${pathResult.error}`);
+            }
+            reportDirBase = validInput.report_dir;
+        }
+        // 4. コマンド構築
+        let commandResult;
+        try {
+            commandResult = buildCommand(validInput.runner, validInput.scope, validInput.target);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.createErrorResponse(startTime, `コマンド構築エラー: ${message}`);
+        }
+        // 5. プロセス実行
+        const executor = createProcessExecutor();
+        let processResult;
+        try {
+            processResult = await executor.execute(commandResult.command, commandResult.args, {
+                cwd: this.repoRoot,
+                timeoutMs: validInput.timeout_ms,
+                noOutputTimeoutMs: validInput.no_output_timeout_ms,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.createErrorResponse(startTime, `プロセス実行エラー: ${message}`);
+        }
+        // 6. レポート生成
+        const reportGenerator = createReportGenerator();
+        let reportDir;
+        let artifacts;
+        try {
+            // レポートディレクトリ作成
+            reportDir = await reportGenerator.createReportDir(reportDirBase);
+            // ログ抽出
+            const logExtractor = createLogExtractor();
+            const combinedLog = combineLogEntries(processResult.logs);
+            const extractedBlocks = logExtractor.extractImportantLines(combinedLog, validInput.max_output_bytes);
+            const tailLines = logExtractor.getTailLines(combinedLog, this.tailLineCount);
+            // 要約情報を構築
+            const summary = {
+                command: commandResult.command,
+                args: commandResult.args,
+                status: processResult.status,
+                exitCode: processResult.exitCode,
+                durationMs: processResult.durationMs,
+                excerpts: extractedBlocks.map(block => block.matchedLine),
+                tailLines,
+            };
+            // 成果物を生成
+            artifacts = await reportGenerator.writeAll(reportDir, processResult.logs, summary);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.createErrorResponse(startTime, `レポート生成エラー: ${message}`);
+        }
+        // 7. 抜粋を生成
+        const logExtractor = createLogExtractor();
+        const combinedLog = combineLogEntries(processResult.logs);
+        const extractedBlocks = logExtractor.extractImportantLines(combinedLog, validInput.max_output_bytes);
+        const excerpt = formatExtractedBlocks(extractedBlocks);
+        // 8. レスポンス生成
+        return {
+            status: processResult.status,
+            exit_code: processResult.exitCode,
+            duration_ms: processResult.durationMs,
+            report_dir: reportDir,
+            artifacts: {
+                raw_log: artifacts.rawLog,
+                summary_md: artifacts.summaryMd,
+                summary_json: artifacts.summaryJson,
+            },
+            excerpt,
+        };
+    }
+    /**
+     * エラーレスポンスを生成する
+     *
+     * @param startTime - 開始時刻
+     * @param errorMessage - エラーメッセージ
+     * @returns エラーレスポンス
+     */
+    createErrorResponse(startTime, errorMessage) {
+        return {
+            status: 'error',
+            exit_code: null,
+            duration_ms: Date.now() - startTime,
+            report_dir: '',
+            artifacts: {
+                raw_log: '',
+                summary_md: '',
+                summary_json: '',
+            },
+            excerpt: '',
+            error_message: errorMessage,
+        };
+    }
+}
+/**
+ * RunTestToolのファクトリ関数
+ *
+ * @param options - ツールオプション
+ * @returns 新しいRunTestToolインスタンス
+ */
+export function createRunTestTool(options) {
+    return new RunTestTool(options);
+}
+//# sourceMappingURL=run-test.js.map

package/dist/tools/run-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-test.js","sourceRoot":"","sources":["../../src/tools/run-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAqB,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,YAAY,EAAiB,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAqC,MAAM,iCAAiC,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAyC,MAAM,+BAA+B,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAsC3D;;GAEG;AACH,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACL,QAAQ,CAAS;IACjB,aAAa,CAAS;IAEvC;;OAEG;IACH,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,eAAe;QACf,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,mBAAmB,CAC7B,SAAS,EACT,iBAAiB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC;QAEzC,2CAA2C;QAC3C,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,SAAS,EACT,YAAY,UAAU,CAAC,KAAK,EAAE,CAC/B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,IAAI,aAAiC,CAAC;QACtC,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,SAAS,EACT,sBAAsB,UAAU,CAAC,KAAK,EAAE,CACzC,CAAC;YACJ,CAAC;YACD,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,CAAC;QAED,YAAY;QACZ,IAAI,aAAa,CAAC;QAClB,IAAI,CAAC;YACH,aAAa,GAAG,YAAY,CAC1B,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,KAAK,EAChB,UAAU,CAAC,MAAM,CAClB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,YAAY;QACZ,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,IAAI,aAA4B,CAAC;QACjC,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,aAAa,CAAC,OAAO,EACrB,aAAa,CAAC,IAAI,EAClB;gBACE,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,SAAS,EAAE,UAAU,CAAC,UAAU;gBAChC,iBAAiB,EAAE,UAAU,CAAC,oBAAoB;aACnD,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,YAAY;QACZ,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;QAChD,IAAI,SAAiB,CAAC;QACtB,IAAI,SAA6B,CAAC;QAElC,IAAI,CAAC;YACH,eAAe;YACf,SAAS,GAAG,MAAM,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;YAEjE,OAAO;YACP,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,eAAe,GAAG,YAAY,CAAC,qBAAqB,CACxD,WAAW,EACX,UAAU,CAAC,gBAAgB,CAC5B,CAAC;YACF,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAE7E,UAAU;YACV,MAAM,OAAO,GAAY;gBACvB,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,QAAQ,EAAE,aAAa,CAAC,QAAQ;gBAChC,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;gBACzD,SAAS;aACV,CAAC;YAEF,SAAS;YACT,SAAS,GAAG,MAAM,eAAe,CAAC,QAAQ,CACxC,SAAS,EACT,aAAa,CAAC,IAAI,EAClB,OAAO,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,WAAW;QACX,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,YAAY,CAAC,qBAAqB,CACxD,WAAW,EACX,UAAU,CAAC,gBAAgB,CAC5B,CAAC;QACF,MAAM,OAAO,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAEvD,aAAa;QACb,OAAO;YACL,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,SAAS,EAAE,aAAa,CAAC,QAAQ;YACjC,WAAW,EAAE,aAAa,CAAC,UAAU;YACrC,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE;gBACT,OAAO,EAAE,SAAS,CAAC,MAAM;gBACzB,UAAU,EAAE,SAAS,CAAC,SAAS;gBAC/B,YAAY,EAAE,SAAS,CAAC,WAAW;aACpC;YACD,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CAAC,SAAiB,EAAE,YAAoB;QACjE,OAAO;YACL,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,UAAU,EAAE,EAAE;YACd,SAAS,EAAE;gBACT,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,EAAE;gBACd,YAAY,EAAE,EAAE;aACjB;YACD,OAAO,EAAE,EAAE;YACX,aAAa,EAAE,YAAY;SAC5B,CAAC;IACJ,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/path-validator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * パス検証結果
+ */
+export interface PathValidationResult {
+    /** 検証が成功したかどうか */
+    valid: boolean;
+    /** 正規化されたパス（validがtrueの場合のみ有効） */
+    normalizedPath?: string;
+    /** エラーメッセージ（validがfalseの場合のみ有効） */
+    error?: string;
+}
+/**
+ * パスがリポジトリ配下かを検証する
+ *
+ * @param targetPath - 検証対象のパス
+ * @param repoRoot - リポジトリのルートパス（絶対パス）
+ * @returns 検証結果
+ */
+export declare function isUnderRepo(targetPath: string, repoRoot: string): boolean;
+/**
+ * パスを正規化し、リポジトリ配下であることを検証する
+ *
+ * @param targetPath - 正規化対象のパス
+ * @param repoRoot - リポジトリのルートパス（絶対パス）
+ * @returns 検証結果（正規化されたパスまたはエラー）
+ */
+export declare function normalizePath(targetPath: string, repoRoot: string): PathValidationResult;
+/**
+ * PathValidatorクラス（オブジェクト指向インターフェース）
+ *
+ * リポジトリルートを保持し、パス検証を行う
+ */
+export declare class PathValidator {
+    private readonly repoRoot;
+    /**
+     * @param repoRoot - リポジトリのルートパス
+     */
+    constructor(repoRoot: string);
+    /**
+     * パスがリポジトリ配下かを検証する
+     */
+    isUnderRepo(targetPath: string): boolean;
+    /**
+     * パスを正規化し、リポジトリ配下であることを検証する
+     */
+    normalizePath(targetPath: string): PathValidationResult;
+    /**
+     * リポジトリルートを取得する
+     */
+    getRepoRoot(): string;
+}
+//# sourceMappingURL=path-validator.d.ts.map

package/dist/utils/path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.d.ts","sourceRoot":"","sources":["../../src/utils/path-validator.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAqCzE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CA6CxF;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;OAEG;gBACS,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB;IAIvD;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}

package/dist/utils/path-validator.js

@@ -0,0 +1,128 @@
+/**
+ * PathValidator - パス検証ユーティリティ
+ *
+ * パスがリポジトリ配下かを検証し、パストラバーサル攻撃を防ぐ。
+ *
+ * Requirements:
+ * - 2.6: targetパラメータがリポジトリ配下であることを検証
+ * - 4.6: report_dirがリポジトリ配下であることを検証
+ * - 4.7: リポジトリ外を指すパスはエラーを返す
+ */
+import * as path from 'node:path';
+/**
+ * パスがリポジトリ配下かを検証する
+ *
+ * @param targetPath - 検証対象のパス
+ * @param repoRoot - リポジトリのルートパス（絶対パス）
+ * @returns 検証結果
+ */
+export function isUnderRepo(targetPath, repoRoot) {
+    // 空文字列チェック
+    if (!targetPath || !repoRoot) {
+        return false;
+    }
+    // repoRootを正規化（絶対パスに変換）
+    const normalizedRepoRoot = path.resolve(repoRoot);
+    // targetPathを正規化
+    // 相対パスの場合はrepoRootを基準に解決
+    const absoluteTargetPath = path.isAbsolute(targetPath)
+        ? path.resolve(targetPath)
+        : path.resolve(normalizedRepoRoot, targetPath);
+    // 正規化されたパスがrepoRoot配下かチェック
+    // path.relative()を使用して相対パスを計算し、
+    // 「..」で始まる場合はリポジトリ外
+    const relativePath = path.relative(normalizedRepoRoot, absoluteTargetPath);
+    // 相対パスが空（同じディレクトリ）または「..」で始まらない場合は配下
+    if (relativePath === '') {
+        return true;
+    }
+    // 「..」で始まる場合はリポジトリ外
+    if (relativePath.startsWith('..')) {
+        return false;
+    }
+    // Windowsの場合、絶対パスが異なるドライブを指している可能性
+    // path.relative()は異なるドライブの場合、絶対パスを返す
+    if (path.isAbsolute(relativePath)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * パスを正規化し、リポジトリ配下であることを検証する
+ *
+ * @param targetPath - 正規化対象のパス
+ * @param repoRoot - リポジトリのルートパス（絶対パス）
+ * @returns 検証結果（正規化されたパスまたはエラー）
+ */
+export function normalizePath(targetPath, repoRoot) {
+    // 空文字列チェック
+    if (!targetPath) {
+        return {
+            valid: false,
+            error: 'パスが空です',
+        };
+    }
+    if (!repoRoot) {
+        return {
+            valid: false,
+            error: 'リポジトリルートが指定されていません',
+        };
+    }
+    // repoRootを正規化
+    const normalizedRepoRoot = path.resolve(repoRoot);
+    // 絶対パスの場合は拒否（相対パスのみ許可）
+    if (path.isAbsolute(targetPath)) {
+        return {
+            valid: false,
+            error: `絶対パスは許可されていません: ${targetPath}`,
+        };
+    }
+    // パスを正規化
+    const absolutePath = path.resolve(normalizedRepoRoot, targetPath);
+    // リポジトリ配下かチェック
+    if (!isUnderRepo(absolutePath, normalizedRepoRoot)) {
+        return {
+            valid: false,
+            error: `パスがリポジトリ外を指しています: ${targetPath}`,
+        };
+    }
+    // リポジトリルートからの相対パスを返す
+    const relativePath = path.relative(normalizedRepoRoot, absolutePath);
+    return {
+        valid: true,
+        normalizedPath: relativePath || '.',
+    };
+}
+/**
+ * PathValidatorクラス（オブジェクト指向インターフェース）
+ *
+ * リポジトリルートを保持し、パス検証を行う
+ */
+export class PathValidator {
+    repoRoot;
+    /**
+     * @param repoRoot - リポジトリのルートパス
+     */
+    constructor(repoRoot) {
+        this.repoRoot = path.resolve(repoRoot);
+    }
+    /**
+     * パスがリポジトリ配下かを検証する
+     */
+    isUnderRepo(targetPath) {
+        return isUnderRepo(targetPath, this.repoRoot);
+    }
+    /**
+     * パスを正規化し、リポジトリ配下であることを検証する
+     */
+    normalizePath(targetPath) {
+        return normalizePath(targetPath, this.repoRoot);
+    }
+    /**
+     * リポジトリルートを取得する
+     */
+    getRepoRoot() {
+        return this.repoRoot;
+    }
+}
+//# sourceMappingURL=path-validator.js.map

package/dist/utils/path-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.js","sourceRoot":"","sources":["../../src/utils/path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAclC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,QAAgB;IAC9D,WAAW;IACX,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wBAAwB;IACxB,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElD,iBAAiB;IACjB,yBAAyB;IACzB,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QACpD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAEjD,2BAA2B;IAC3B,gCAAgC;IAChC,oBAAoB;IACpB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAE3E,qCAAqC;IACrC,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mCAAmC;IACnC,qCAAqC;IACrC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,QAAgB;IAChE,WAAW;IACX,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,oBAAoB;SAC5B,CAAC;IACJ,CAAC;IAED,eAAe;IACf,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElD,uBAAuB;IACvB,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,mBAAmB,UAAU,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,SAAS;IACT,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAElE,eAAe;IACf,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACnD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAqB,UAAU,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAErE,OAAO;QACL,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,YAAY,IAAI,GAAG;KACpC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACP,QAAQ,CAAS;IAElC;;OAEG;IACH,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB;QAC5B,OAAO,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,UAAkB;QAC9B,OAAO,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/validation/command-builder.d.ts

@@ -0,0 +1,52 @@
+/**
+ * コマンドビルダー
+ *
+ * 入力パラメータから安全なコマンドと引数を生成する。
+ * 固定テンプレートのみを許可し、任意コマンド実行を防ぐ。
+ *
+ * Requirements:
+ * - 2.1: 固定テンプレート（flutter test）のみを実行
+ * - 2.3: scope が all の場合、flutter test を実行
+ * - 2.4: scope が file の場合、flutter test <target> を実行
+ * - 2.5: scope が pattern の場合、flutter test --name <target> を実行
+ */
+import type { Runner, Scope } from './input-schema.js';
+/**
+ * コマンド構築結果
+ */
+export interface CommandResult {
+    /** 実行するコマンド */
+    command: string;
+    /** コマンド引数 */
+    args: string[];
+}
+/**
+ * 入力パラメータからコマンドと引数を構築する
+ *
+ * 固定テンプレートのみを使用し、任意コマンド実行を防ぐ。
+ *
+ * @param runner - テストランナー
+ * @param scope - テスト実行スコープ
+ * @param target - テスト対象（scope が file/pattern の場合）
+ * @returns コマンド構築結果
+ * @throws Error - 不正なパラメータの場合
+ */
+export declare function buildCommand(runner: Runner, scope: Scope, target?: string): CommandResult;
+/**
+ * コマンド文字列を生成する（表示用）
+ *
+ * @param result - コマンド構築結果
+ * @returns コマンド文字列
+ */
+export declare function formatCommand(result: CommandResult): string;
+/**
+ * 許可されたコマンドパターンかどうかを検証する
+ *
+ * 生成されたコマンドが固定テンプレートに一致するかチェック
+ *
+ * @param command - コマンド
+ * @param args - 引数
+ * @returns 許可されたパターンの場合 true
+ */
+export declare function isAllowedCommandPattern(command: string, args: string[]): boolean;
+//# sourceMappingURL=command-builder.d.ts.map

package/dist/validation/command-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-builder.d.ts","sourceRoot":"","sources":["../../src/validation/command-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CAqCf;AA+BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAmChF"}

package/dist/validation/command-builder.js

@@ -0,0 +1,143 @@
+/**
+ * 許可されたコマンドテンプレート
+ *
+ * runner -> scope -> template のマッピング
+ */
+const COMMAND_TEMPLATES = {
+    flutter: {
+        all: {
+            command: 'flutter',
+            baseArgs: ['test'],
+        },
+        file: {
+            command: 'flutter',
+            baseArgs: ['test'],
+            targetArgFormat: 'positional',
+        },
+        pattern: {
+            command: 'flutter',
+            baseArgs: ['test'],
+            targetArgFormat: 'named',
+            targetFlag: '--name',
+        },
+    },
+};
+/**
+ * 入力パラメータからコマンドと引数を構築する
+ *
+ * 固定テンプレートのみを使用し、任意コマンド実行を防ぐ。
+ *
+ * @param runner - テストランナー
+ * @param scope - テスト実行スコープ
+ * @param target - テスト対象（scope が file/pattern の場合）
+ * @returns コマンド構築結果
+ * @throws Error - 不正なパラメータの場合
+ */
+export function buildCommand(runner, scope, target) {
+    // テンプレートを取得
+    const runnerTemplates = COMMAND_TEMPLATES[runner];
+    if (!runnerTemplates) {
+        throw new Error(`許可されていないランナー: ${runner}`);
+    }
+    const template = runnerTemplates[scope];
+    if (!template) {
+        throw new Error(`許可されていないスコープ: ${scope}`);
+    }
+    // 引数を構築
+    const args = [...template.baseArgs];
+    // targetが必要な場合
+    if (template.targetArgFormat) {
+        if (!target) {
+            throw new Error(`scope '${scope}' の場合、target は必須です`);
+        }
+        // targetの安全性チェック（シェルインジェクション防止）
+        validateTarget(target);
+        if (template.targetArgFormat === 'positional') {
+            // 位置引数として追加
+            args.push(target);
+        }
+        else if (template.targetArgFormat === 'named' && template.targetFlag) {
+            // 名前付き引数として追加
+            args.push(template.targetFlag, target);
+        }
+    }
+    return {
+        command: template.command,
+        args,
+    };
+}
+/**
+ * targetの安全性を検証する
+ *
+ * シェルインジェクションを防ぐため、危険な文字をチェック
+ *
+ * @param target - 検証対象のtarget
+ * @throws Error - 危険な文字が含まれる場合
+ */
+function validateTarget(target) {
+    // 空文字列チェック
+    if (!target || target.trim() === '') {
+        throw new Error('target は空にできません');
+    }
+    // 危険な文字のパターン
+    // シェルメタ文字やコマンド区切り文字を禁止
+    const dangerousPatterns = [
+        /[;&|`$(){}[\]<>]/, // シェルメタ文字
+        /\n|\r/, // 改行文字
+        /^\s*-/, // 先頭のハイフン（オプション注入防止）
+    ];
+    for (const pattern of dangerousPatterns) {
+        if (pattern.test(target)) {
+            throw new Error(`target に不正な文字が含まれています: ${target}`);
+        }
+    }
+}
+/**
+ * コマンド文字列を生成する（表示用）
+ *
+ * @param result - コマンド構築結果
+ * @returns コマンド文字列
+ */
+export function formatCommand(result) {
+    return `${result.command} ${result.args.join(' ')}`.trim();
+}
+/**
+ * 許可されたコマンドパターンかどうかを検証する
+ *
+ * 生成されたコマンドが固定テンプレートに一致するかチェック
+ *
+ * @param command - コマンド
+ * @param args - 引数
+ * @returns 許可されたパターンの場合 true
+ */
+export function isAllowedCommandPattern(command, args) {
+    // flutter test パターンのみ許可
+    if (command !== 'flutter') {
+        return false;
+    }
+    if (args.length === 0 || args[0] !== 'test') {
+        return false;
+    }
+    // 許可されたパターン:
+    // 1. flutter test
+    // 2. flutter test <target>
+    // 3. flutter test --name <target>
+    if (args.length === 1) {
+        // flutter test
+        return true;
+    }
+    if (args.length === 2) {
+        // flutter test <target>
+        // targetが--で始まらないこと
+        const arg1 = args[1];
+        return arg1 !== undefined && !arg1.startsWith('--');
+    }
+    if (args.length === 3) {
+        // flutter test --name <target>
+        const arg1 = args[1];
+        const arg2 = args[2];
+        return arg1 === '--name' && arg2 !== undefined && !arg2.startsWith('--');
+    }
+    return false;
+}
+//# sourceMappingURL=command-builder.js.map

package/dist/validation/command-builder.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * バリデーションモジュール
+ *
+ * 入力スキーマとコマンドビルダーをエクスポート
+ */
+export { runTestInputSchema, validateRunTestInput, isAllowedRunner, isAllowedScope, ALLOWED_RUNNERS, ALLOWED_SCOPES, type Runner, type Scope, type RunTestInput, type ValidationResult, } from './input-schema.js';
+export { buildCommand, formatCommand, isAllowedCommandPattern, type CommandResult, } from './command-builder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,12 @@
+/**
+ * バリデーションモジュール
+ *
+ * 入力スキーマとコマンドビルダーをエクスポート
+ */
+export { 
+// 入力スキーマ
+runTestInputSchema, validateRunTestInput, isAllowedRunner, isAllowedScope, ALLOWED_RUNNERS, ALLOWED_SCOPES, } from './input-schema.js';
+export { 
+// コマンドビルダー
+buildCommand, formatCommand, isAllowedCommandPattern, } from './command-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO;AACL,SAAS;AACT,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GAKf,MAAM,mBAAmB,CAAC;AAE3B,OAAO;AACL,WAAW;AACX,YAAY,EACZ,aAAa,EACb,uBAAuB,GAExB,MAAM,sBAAsB,CAAC"}