@reftrixmcp/mcp-server 0.1.7

package/dist/services/service-client.js

@@ -0,0 +1,450 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceClient = exports.ServiceClient = exports.ServiceClientError = exports.ServiceClientErrorCode = exports.API_BASE_URL = void 0;
+/**
+ * MCP Server - Service Client
+ * ReftrixバックエンドAPIへの接続クライアント
+ *
+ * WebDesign専用のAPIクライアント:
+ * - /api/studio/projects: プロジェクト管理
+ * - /api/studio/palettes: パレット管理
+ *
+ * 耐障害性機能:
+ * - タイムアウト: デフォルト30秒
+ * - リトライ: 最大3回、指数バックオフ（100ms, 200ms, 400ms）
+ * - リトライ対象: ネットワークエラー、5xx系エラー
+ * - リトライ非対象: 4xx系クライアントエラー
+ */
+const logger_1 = require("../utils/logger");
+/**
+ * API Base URL (環境変数から取得、デフォルトはポート24000)
+ */
+exports.API_BASE_URL = process.env.REFTRIX_API_URL || "http://localhost:24000/api/v1";
+/**
+ * ServiceClientエラーコード
+ */
+var ServiceClientErrorCode;
+(function (ServiceClientErrorCode) {
+    /** リクエストタイムアウト */
+    ServiceClientErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    /** 最大リトライ回数超過 */
+    ServiceClientErrorCode["MAX_RETRIES_EXCEEDED"] = "MAX_RETRIES_EXCEEDED";
+    /** ネットワークエラー */
+    ServiceClientErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /** サーバーエラー (5xx) */
+    ServiceClientErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    /** クライアントエラー (4xx) */
+    ServiceClientErrorCode["CLIENT_ERROR"] = "CLIENT_ERROR";
+    /** 認証エラー (401) */
+    ServiceClientErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+})(ServiceClientErrorCode || (exports.ServiceClientErrorCode = ServiceClientErrorCode = {}));
+/**
+ * ServiceClientエラークラス
+ */
+class ServiceClientError extends Error {
+    code;
+    statusCode;
+    retryCount;
+    originalCause;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "ServiceClientError";
+        this.code = code;
+        this.statusCode = options?.statusCode;
+        this.retryCount = options?.retryCount;
+        this.originalCause = options?.cause;
+    }
+}
+exports.ServiceClientError = ServiceClientError;
+/**
+ * デフォルトオプション
+ */
+const DEFAULT_OPTIONS = {
+    timeout: 30000,
+    maxRetries: 3,
+    retryDelay: 100,
+};
+/**
+ * リトライ対象のエラーかどうかを判定
+ * @param error - 発生したエラー
+ * @param statusCode - HTTPステータスコード
+ * @returns リトライすべきかどうか
+ */
+function isRetryableError(error, statusCode) {
+    // ネットワークエラーはリトライ対象
+    if (error && !statusCode) {
+        return true;
+    }
+    // 5xx系サーバーエラーはリトライ対象
+    if (statusCode && statusCode >= 500 && statusCode < 600) {
+        return true;
+    }
+    // 4xx系クライアントエラーはリトライ非対象
+    return false;
+}
+/**
+ * 指数バックオフ遅延を計算
+ * @param retryCount - 現在のリトライ回数（0始まり）
+ * @param baseDelay - 基本遅延時間（ミリ秒）
+ * @returns 遅延時間（ミリ秒）
+ */
+function calculateBackoffDelay(retryCount, baseDelay) {
+    // 2^retryCount * baseDelay: 100ms, 200ms, 400ms, ...
+    return Math.pow(2, retryCount) * baseDelay;
+}
+/**
+ * 指定時間待機
+ * @param ms - 待機時間（ミリ秒）
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Reftrix Service Client
+ * バックエンドAPIとの通信を担当（WebDesign専用）
+ *
+ * 耐障害性機能:
+ * - タイムアウト: デフォルト30秒（操作別に設定可能）
+ * - リトライ: 最大3回、指数バックオフ（100ms, 200ms, 400ms）
+ */
+class ServiceClient {
+    baseUrl;
+    options;
+    constructor(baseUrl = exports.API_BASE_URL, options = {}) {
+        this.baseUrl = baseUrl;
+        this.options = {
+            ...DEFAULT_OPTIONS,
+            ...options,
+        };
+    }
+    /**
+     * 現在のオプション設定を取得
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * タイムアウト付きfetchを実行
+     * @param url - リクエストURL
+     * @param init - fetchオプション
+     * @param timeout - タイムアウト時間（ミリ秒）
+     * @returns fetchレスポンス
+     */
+    async fetchWithTimeout(url, init, timeout) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new ServiceClientError(ServiceClientErrorCode.TIMEOUT_ERROR, `Request timeout after ${timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * リトライ付きfetchを実行
+     * @param url - リクエストURL
+     * @param init - fetchオプション
+     * @param operationName - 操作名（ログ用）
+     * @returns fetchレスポンス
+     */
+    async fetchWithRetry(url, init, operationName) {
+        let lastError = null;
+        let lastStatusCode;
+        for (let attempt = 0; attempt <= this.options.maxRetries; attempt++) {
+            try {
+                if (attempt > 0) {
+                    const delay = calculateBackoffDelay(attempt - 1, this.options.retryDelay);
+                    if ((0, logger_1.isDevelopment)()) {
+                        logger_1.logger.info(`[ServiceClient] Retrying ${operationName} (attempt ${attempt}/${this.options.maxRetries}) after ${delay}ms`);
+                    }
+                    await sleep(delay);
+                }
+                const response = await this.fetchWithTimeout(url, init, this.options.timeout);
+                // 成功（2xx）の場合
+                if (response.ok) {
+                    return response;
+                }
+                // 404は特別処理（リトライしない、呼び出し元で処理）
+                if (response.status === 404) {
+                    return response;
+                }
+                // 4xx系クライアントエラーはリトライしない
+                if (response.status >= 400 && response.status < 500) {
+                    return response;
+                }
+                // 5xx系サーバーエラーはリトライ対象
+                lastStatusCode = response.status;
+                lastError = new Error(`Server error: ${response.status}`);
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[ServiceClient] ${operationName} failed with status ${response.status}`, {
+                        attempt,
+                        maxRetries: this.options.maxRetries,
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof ServiceClientError) {
+                    // タイムアウトエラーはそのまま再スロー
+                    throw error;
+                }
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[ServiceClient] ${operationName} failed with error: ${lastError.message}`, {
+                        attempt,
+                        maxRetries: this.options.maxRetries,
+                    });
+                }
+                // リトライ対象でない場合は即座に失敗
+                if (!isRetryableError(lastError, undefined)) {
+                    throw new ServiceClientError(ServiceClientErrorCode.NETWORK_ERROR, lastError.message, {
+                        cause: lastError,
+                    });
+                }
+            }
+        }
+        // 最大リトライ回数を超えた
+        // exactOptionalPropertyTypes対応: undefinedを含む可能性のある値を条件付きで追加
+        const errorOptions = {
+            retryCount: this.options.maxRetries,
+        };
+        if (lastStatusCode !== undefined) {
+            errorOptions.statusCode = lastStatusCode;
+        }
+        if (lastError !== null) {
+            errorOptions.cause = lastError;
+        }
+        throw new ServiceClientError(ServiceClientErrorCode.MAX_RETRIES_EXCEEDED, `${operationName} failed after ${this.options.maxRetries} retries: ${lastError?.message ?? "Unknown error"}`, errorOptions);
+    }
+    /**
+     * プロジェクト取得API呼び出し
+     *
+     * Web API: GET /api/studio/projects/:id
+     * レスポンス: { data: { id, name, slug, description, status, createdAt, updatedAt, pages, brandSetting } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    async getProject(id) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] Calling getProject API", { id });
+        }
+        // Studio APIは /api/studio/ パスを使用（baseUrlの/v1を除外）
+        const studioBaseUrl = this.baseUrl.replace("/api/v1", "/api");
+        const url = `${studioBaseUrl}/studio/projects/${id}`;
+        const response = await this.fetchWithRetry(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+        }, "getProject");
+        if (response.status === 404) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[ServiceClient] Project not found", { id });
+            }
+            return null;
+        }
+        if (response.status === 401) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[ServiceClient] Unauthorized", { id });
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.UNAUTHORIZED, "UNAUTHORIZED - Authentication required", { statusCode: 401 });
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "Unknown error");
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[ServiceClient] Get Project API error", {
+                    status: response.status,
+                    error: errorText,
+                });
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.CLIENT_ERROR, `Get Project API error: ${response.status} - ${errorText}`, { statusCode: response.status });
+        }
+        const json = await response.json();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] Get Project response", {
+                hasData: !!json.data,
+                id: json.data?.id,
+                name: json.data?.name,
+            });
+        }
+        // Web API レスポンス形式: { data: {...} }
+        const data = json.data || json;
+        return {
+            id: data.id,
+            name: data.name,
+            slug: data.slug,
+            description: data.description,
+            status: data.status,
+            createdAt: data.createdAt,
+            updatedAt: data.updatedAt,
+            brandSetting: data.brandSetting ?? null,
+        };
+    }
+    /**
+     * プロジェクト一覧取得API呼び出し
+     *
+     * Web API: GET /api/studio/projects
+     * クエリパラメータ: status, limit, offset, sortBy, sortOrder
+     * レスポンス: { data: { projects: [...], total, limit, offset } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    async listProjects(params = {}) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] Calling listProjects API", { params });
+        }
+        // クエリパラメータを構築
+        const queryParams = new URLSearchParams();
+        if (params.status)
+            queryParams.set("status", params.status);
+        if (params.limit !== undefined)
+            queryParams.set("limit", String(params.limit));
+        if (params.offset !== undefined)
+            queryParams.set("offset", String(params.offset));
+        if (params.sortBy)
+            queryParams.set("sortBy", params.sortBy);
+        if (params.sortOrder)
+            queryParams.set("sortOrder", params.sortOrder);
+        const queryString = queryParams.toString();
+        // Studio APIは /api/studio/ パスを使用（baseUrlの/v1を除外）
+        const studioBaseUrl = this.baseUrl.replace("/api/v1", "/api");
+        const url = `${studioBaseUrl}/studio/projects${queryString ? `?${queryString}` : ""}`;
+        const response = await this.fetchWithRetry(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+        }, "listProjects");
+        if (response.status === 401) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[ServiceClient] Unauthorized");
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.UNAUTHORIZED, "UNAUTHORIZED - Authentication required", { statusCode: 401 });
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "Unknown error");
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[ServiceClient] List Projects API error", {
+                    status: response.status,
+                    error: errorText,
+                });
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.CLIENT_ERROR, `List Projects API error: ${response.status} - ${errorText}`, { statusCode: response.status });
+        }
+        const json = await response.json();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] List Projects response", {
+                hasData: !!json.data,
+                count: json.data?.projects?.length ?? 0,
+                total: json.data?.total,
+            });
+        }
+        // Web API レスポンス形式: { data: { projects, total, limit, offset } }
+        // 注意: 一覧APIは pages 配列ではなく pagesCount を返す
+        const data = json.data || json;
+        return {
+            projects: (data.projects ?? []).map((project) => ({
+                id: project.id,
+                name: project.name,
+                slug: project.slug,
+                description: project.description,
+                status: project.status,
+                createdAt: project.createdAt,
+                updatedAt: project.updatedAt,
+                // 一覧APIは pagesCount を返すが、詳細APIと互換性を保つため空配列を設定
+                pages: [],
+                brandSetting: null,
+            })),
+            total: data.total ?? 0,
+            limit: data.limit ?? params.limit ?? 10,
+            offset: data.offset ?? params.offset ?? 0,
+        };
+    }
+    /**
+     * パレット取得API呼び出し
+     *
+     * Web API: GET /api/studio/palettes/:id
+     * レスポンス: { data: { id, name, slug, description, mode, isDefault, tokens, createdAt, updatedAt } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    async getPalette(id) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] Calling getPalette API", { id });
+        }
+        // Studio APIは /api/studio/ パスを使用（baseUrlの/v1を除外）
+        const studioBaseUrl = this.baseUrl.replace("/api/v1", "/api");
+        const url = `${studioBaseUrl}/studio/palettes/${id}`;
+        const response = await this.fetchWithRetry(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+        }, "getPalette");
+        if (response.status === 404) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[ServiceClient] Palette not found", { id });
+            }
+            return null;
+        }
+        if (response.status === 401) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[ServiceClient] Unauthorized", { id });
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.UNAUTHORIZED, "UNAUTHORIZED - Authentication required", { statusCode: 401 });
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "Unknown error");
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[ServiceClient] Get Palette API error", {
+                    status: response.status,
+                    error: errorText,
+                });
+            }
+            throw new ServiceClientError(ServiceClientErrorCode.CLIENT_ERROR, `Get Palette API error: ${response.status} - ${errorText}`, { statusCode: response.status });
+        }
+        const json = await response.json();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ServiceClient] Get Palette response", {
+                hasData: !!json.data,
+                id: json.data?.id,
+                name: json.data?.name,
+                tokenCount: json.data?.tokens?.length ?? 0,
+            });
+        }
+        // Web API レスポンス形式: { data: {...} }
+        const data = json.data || json;
+        return {
+            id: data.id,
+            name: data.name,
+            slug: data.slug,
+            description: data.description,
+            mode: data.mode,
+            isDefault: data.isDefault,
+            tokens: (data.tokens ?? []).map((token) => ({
+                id: token.id,
+                name: token.name,
+                hex: token.hex,
+                oklchL: token.oklchL,
+                oklchC: token.oklchC,
+                oklchH: token.oklchH,
+                role: token.role,
+                semanticMeaning: token.semanticMeaning,
+                sortOrder: token.sortOrder,
+            })),
+            createdAt: data.createdAt,
+            updatedAt: data.updatedAt,
+        };
+    }
+}
+exports.ServiceClient = ServiceClient;
+/**
+ * デフォルトのServiceClientインスタンス
+ */
+exports.serviceClient = new ServiceClient();
+//# sourceMappingURL=service-client.js.map

package/dist/services/service-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.js","sourceRoot":"","sources":["../../src/services/service-client.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;;;;;;;;;;;GAaG;AAEH,4CAAwD;AAExD;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,+BAA+B,CAAC;AAE3F;;GAEG;AACH,IAAY,sBAaX;AAbD,WAAY,sBAAsB;IAChC,kBAAkB;IAClB,yDAA+B,CAAA;IAC/B,iBAAiB;IACjB,uEAA6C,CAAA;IAC7C,gBAAgB;IAChB,yDAA+B,CAAA;IAC/B,oBAAoB;IACpB,uDAA6B,CAAA;IAC7B,sBAAsB;IACtB,uDAA6B,CAAA;IAC7B,kBAAkB;IAClB,uDAA6B,CAAA;AAC/B,CAAC,EAbW,sBAAsB,sCAAtB,sBAAsB,QAajC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAC3B,IAAI,CAAyB;IAC7B,UAAU,CAAqB;IAC/B,UAAU,CAAqB;IAC/B,aAAa,CAAoB;IAEjD,YACE,IAA4B,EAC5B,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,KAAK,CAAC;IACtC,CAAC;CACF;AAtBD,gDAsBC;AAcD;;GAEG;AACH,MAAM,eAAe,GAAmC;IACtD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,GAAG;CAChB,CAAC;AA6EF;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,KAAmB,EAAE,UAAmB;IAChE,mBAAmB;IACnB,IAAI,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,UAAU,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,UAAkB,EAAE,SAAiB;IAClE,qDAAqD;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,aAAa;IACP,OAAO,CAAS;IAChB,OAAO,CAAiC;IAEzD,YAAY,UAAkB,oBAAY,EAAE,UAAgC,EAAE;QAC5E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,eAAe;YAClB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAC5B,GAAW,EACX,IAA4B,EAC5B,OAAe;QAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,GAAG,IAAI;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,aAAa,EACpC,yBAAyB,OAAO,IAAI,CACrC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,cAAc,CAC1B,GAAW,EACX,IAA4B,EAC5B,aAAqB;QAErB,IAAI,SAAS,GAAiB,IAAI,CAAC;QACnC,IAAI,cAAkC,CAAC;QAEvC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACpE,IAAI,CAAC;gBACH,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC1E,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;wBACpB,eAAM,CAAC,IAAI,CACT,4BAA4B,aAAa,aAAa,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,WAAW,KAAK,IAAI,CAC7G,CAAC;oBACJ,CAAC;oBACD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAE9E,aAAa;gBACb,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,6BAA6B;gBAC7B,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,wBAAwB;gBACxB,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACpD,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,qBAAqB;gBACrB,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACjC,SAAS,GAAG,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAE1D,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;oBACpB,eAAM,CAAC,IAAI,CAAC,mBAAmB,aAAa,uBAAuB,QAAQ,CAAC,MAAM,EAAE,EAAE;wBACpF,OAAO;wBACP,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;qBACpC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;oBACxC,qBAAqB;oBACrB,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;oBACpB,eAAM,CAAC,IAAI,CAAC,mBAAmB,aAAa,uBAAuB,SAAS,CAAC,OAAO,EAAE,EAAE;wBACtF,OAAO;wBACP,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;qBACpC,CAAC,CAAC;gBACL,CAAC;gBAED,oBAAoB;gBACpB,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;oBAC5C,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,CAAC,aAAa,EAAE,SAAS,CAAC,OAAO,EAAE;wBACpF,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,eAAe;QACf,4DAA4D;QAC5D,MAAM,YAAY,GAAgE;YAChF,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;SACpC,CAAC;QACF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,YAAY,CAAC,UAAU,GAAG,cAAc,CAAC;QAC3C,CAAC;QACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,KAAK,GAAG,SAAS,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,oBAAoB,EAC3C,GAAG,aAAa,iBAAiB,IAAI,CAAC,OAAO,CAAC,UAAU,aAAa,SAAS,EAAE,OAAO,IAAI,eAAe,EAAE,EAC5G,YAAY,CACb,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,iDAAiD;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,aAAa,oBAAoB,EAAE,EAAE,CAAC;QAErD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACxC,GAAG,EACH;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,EACD,YAAY,CACb,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,wCAAwC,EACxC,EAAE,UAAU,EAAE,GAAG,EAAE,CACpB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;oBACpD,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,0BAA0B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,EAC1D,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAChC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBAClD,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;gBACpB,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI;aACtB,CAAC,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAE/B,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;SACxC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,SAA4B,EAAE;QAC/C,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,cAAc;QACd,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM;YAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAClF,IAAI,MAAM,CAAC,MAAM;YAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,SAAS;YAAE,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAErE,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3C,iDAAiD;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,aAAa,mBAAmB,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEtF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACxC,GAAG,EACH;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,EACD,cAAc,CACf,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,wCAAwC,EACxC,EAAE,UAAU,EAAE,GAAG,EAAE,CACpB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE;oBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,4BAA4B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,EAC5D,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAChC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;gBACpD,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;gBACpB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;gBACvC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK;aACxB,CAAC,CAAC;QACL,CAAC;QAED,gEAAgE;QAChE,yCAAyC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAE/B,OAAO;YACL,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAgC,EAAE,EAAE,CAAC,CAAC;gBACzE,EAAE,EAAE,OAAO,CAAC,EAAY;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAc;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAc;gBAC5B,WAAW,EAAE,OAAO,CAAC,WAA4B;gBACjD,MAAM,EAAE,OAAO,CAAC,MAAgB;gBAChC,SAAS,EAAE,OAAO,CAAC,SAAmB;gBACtC,SAAS,EAAE,OAAO,CAAC,SAAmB;gBACtC,8CAA8C;gBAC9C,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YACH,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,iDAAiD;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,aAAa,oBAAoB,EAAE,EAAE,CAAC;QAErD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACxC,GAAG,EACH;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,EACD,YAAY,CACb,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,wCAAwC,EACxC,EAAE,UAAU,EAAE,GAAG,EAAE,CACpB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;oBACpD,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,YAAY,EACnC,0BAA0B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,EAC1D,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAChC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBAClD,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;gBACpB,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI;gBACrB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAE/B,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,CAAC;gBACtD,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAvaD,sCAuaC;AAED;;GAEG;AACU,QAAA,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/services/service-initializer.d.ts

@@ -0,0 +1,174 @@
+export { ProductionGuardError, ProductionCategoryRequiredError, isProductionEnvironment, isDevelopmentEnvironment, assertNonProductionFactory, createProductionSafeFactory, assertProductionRequiredCategoriesInitialized, REQUIRED_CATEGORIES_FOR_PRODUCTION, type ProductionSafeFactory, } from "./production-guard";
+/**
+ * Embedding サービスインターフェース（最小限）
+ * 各サービスはこのインターフェースを拡張している場合がある
+ */
+export interface IEmbeddingService {
+    generateEmbedding(text: string, type?: "query" | "passage"): Promise<number[]>;
+    /** GPU VRAMアイドルタイムアウト設定 / Set idle timeout for GPU VRAM auto-release */
+    setIdleTimeout?(ms: number): void;
+}
+/**
+ * WebPage サービスインターフェース
+ * web-page.service.ts と互換性を保つため、htmlContent形式を使用
+ */
+export interface IWebPageService {
+    getPageById(id: string): Promise<WebPageResult | null>;
+}
+/**
+ * WebPage 結果型（web-page.service.ts と同じ形式）
+ * motion.detect互換形式を使用
+ */
+export interface WebPageResult {
+    id: string;
+    htmlContent: string;
+    cssContent?: string;
+}
+/**
+ * Service Client インターフェース
+ * 将来の拡張用に保持
+ */
+export interface IServiceClient {
+}
+/**
+ * Prisma Client インターフェース（最小限）
+ * MinimalPrismaClientとの互換性のため、createは関数型として定義
+ */
+export interface IPrismaClientMinimal {
+    motionPattern?: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    motionEmbedding?: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    sectionPattern?: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    sectionEmbedding?: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    qualityBenchmark?: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    $executeRawUnsafe: (...args: any[]) => Promise<unknown>;
+    $queryRawUnsafe: (...args: any[]) => Promise<unknown>;
+    $transaction?: <T>(fn: (tx: any) => Promise<T>) => Promise<T>;
+}
+/**
+ * サービス初期化設定
+ */
+export interface ServiceInitializerConfig {
+    /** Embedding生成サービス（必須） */
+    embeddingService: IEmbeddingService;
+    /** Prismaクライアント（必須） */
+    prisma: IPrismaClientMinimal;
+    /** WebPageサービス（オプション - motion.detect, layout.inspect用） */
+    webPageService?: IWebPageService;
+    /** ServiceClient（オプション - 将来の拡張用） */
+    serviceClient?: IServiceClient;
+}
+/**
+ * サービス初期化結果
+ */
+export interface ServiceInitializerResult {
+    /** 初期化成功フラグ */
+    success: boolean;
+    /** 登録されたファクトリ名リスト */
+    registeredFactories: string[];
+    /** 初期化されたカテゴリリスト */
+    categories: string[];
+    /** スキップされたファクトリ（依存関係不足） */
+    skipped: string[];
+    /** エラーメッセージ（失敗時） */
+    error?: string;
+}
+/**
+ * スキップされたカテゴリの詳細情報
+ */
+export interface SkippedCategoryInfo {
+    /** カテゴリ名 */
+    category: string;
+    /** スキップ理由 */
+    reason: string;
+}
+/**
+ * エラー情報
+ */
+export interface InitializationErrorInfo {
+    /** カテゴリ名 */
+    category: string;
+    /** エラーメッセージ */
+    error: string;
+}
+/**
+ * 詳細な初期化結果（MCP-INIT-02）
+ * initializeAllServices() の戻り値に詳細情報を追加
+ */
+export interface InitializationDetailedResult {
+    /** 初期化成功フラグ（少なくとも1つ成功していれば true） */
+    success: boolean;
+    /** 初期化されたカテゴリリスト */
+    initializedCategories: string[];
+    /** スキップされたカテゴリ詳細 */
+    skippedCategories: SkippedCategoryInfo[];
+    /** エラー情報 */
+    errors: InitializationErrorInfo[];
+    /** 登録されたツール/ファクトリ数 */
+    registeredToolCount: number;
+    /** 登録されたファクトリ名リスト */
+    registeredFactories: string[];
+}
+/**
+ * 最後の初期化結果を取得
+ * @returns 初期化結果（未初期化の場合は null）
+ */
+export declare function getLastInitializationResult(): InitializationDetailedResult | null;
+/**
+ * Motion関連サービスを一括初期化
+ *
+ * 登録されるファクトリ:
+ * - motionDetect (webPageService必要)
+ * - motionSearch
+ * - motionPersistence
+ *
+ * @param config サービス初期化設定
+ * @returns 初期化結果
+ */
+export declare function initializeMotionServices(config: ServiceInitializerConfig): ServiceInitializerResult;
+/**
+ * Layout関連サービスを一括初期化
+ *
+ * 登録されるファクトリ:
+ * - layoutSearch
+ * - layoutToCode
+ * - layoutInspect (webPageService必要)
+ * - layoutIngest
+ *
+ * @param config サービス初期化設定
+ * @returns 初期化結果
+ */
+export declare function initializeLayoutServices(config: ServiceInitializerConfig): ServiceInitializerResult;
+/**
+ * Quality関連サービスを一括初期化
+ *
+ * 登録されるファクトリ:
+ * - qualityEvaluate
+ * - benchmarkService
+ *
+ * @param config サービス初期化設定
+ * @returns 初期化結果
+ */
+export declare function initializeQualityServices(config: ServiceInitializerConfig): ServiceInitializerResult;
+/**
+ * 全サービスを一括初期化
+ *
+ * Motion, Layout, Quality の全カテゴリを初期化。
+ * 依存関係が不足している場合は可能な範囲で初期化を続行。
+ *
+ * MCP-INIT-02: 詳細な初期化結果を返却し、警告ログを強化
+ *
+ * @param config サービス初期化設定
+ * @returns 初期化結果
+ */
+export declare function initializeAllServices(config: ServiceInitializerConfig): ServiceInitializerResult;
+//# sourceMappingURL=service-initializer.d.ts.map

package/dist/services/service-initializer.d.ts.map

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