@reftrixmcp/mcp-server 0.1.7

package/dist/tools/preference/reset.tool.d.ts

@@ -0,0 +1,71 @@
+import type { IPreferenceService } from "./hear.tool";
+export type { IPreferenceService };
+/**
+ * preference.reset 出力型
+ * preference.reset output type
+ */
+export type PreferenceResetOutput = {
+    success: true;
+    data: {
+        reset: boolean;
+        profile_id: string;
+    };
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * サービスファクトリーを設定
+ * Set service factory
+ */
+export declare function setPreferenceServiceFactory(factory: () => IPreferenceService): void;
+/**
+ * サービスファクトリーをリセット
+ * Reset service factory
+ */
+export declare function resetPreferenceServiceFactory(): void;
+/**
+ * preference.reset ツールハンドラー
+ * preference.reset tool handler
+ *
+ * @param input - 入力パラメータ / Input parameters
+ * @returns リセット結果 / Reset result
+ */
+export declare function preferenceResetHandler(input: unknown): Promise<PreferenceResetOutput>;
+/**
+ * preference.reset MCPツール定義
+ * preference.reset MCP tool definition
+ */
+export declare const preferenceResetToolDefinition: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            profile_id: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+            hard_delete: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=reset.tool.d.ts.map

package/dist/tools/preference/reset.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/preference/reset.tool.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAQN;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAEnF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAwBD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+G3F;AAMD;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCzC,CAAC"}

package/dist/tools/preference/reset.tool.js

@@ -0,0 +1,205 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preferenceResetToolDefinition = void 0;
+exports.setPreferenceServiceFactory = setPreferenceServiceFactory;
+exports.resetPreferenceServiceFactory = resetPreferenceServiceFactory;
+exports.preferenceResetHandler = preferenceResetHandler;
+/**
+ * preference.reset MCPツール
+ * 嗜好プロファイルのリセット
+ *
+ * preference.reset MCP tool
+ * Reset preference profile
+ *
+ * @module tools/preference/reset.tool
+ */
+const zod_1 = require("zod");
+const logger_1 = require("../../utils/logger");
+const schemas_1 = require("./schemas");
+// =====================================================
+// サービスファクトリー（DI） / Service Factory (DI)
+// =====================================================
+let preferenceServiceFactory = null;
+/**
+ * サービスファクトリーを設定
+ * Set service factory
+ */
+function setPreferenceServiceFactory(factory) {
+    preferenceServiceFactory = factory;
+}
+/**
+ * サービスファクトリーをリセット
+ * Reset service factory
+ */
+function resetPreferenceServiceFactory() {
+    preferenceServiceFactory = null;
+}
+// =====================================================
+// エラーコード判定 / Error Code Mapping
+// =====================================================
+/**
+ * エラーからエラーコードを判定
+ * Map error to error code
+ */
+function mapErrorToCode(error) {
+    const message = error.message.toLowerCase();
+    if (message.includes("profile not found") || message.includes("not found")) {
+        return schemas_1.PREFERENCE_MCP_ERROR_CODES.PROFILE_NOT_FOUND;
+    }
+    return schemas_1.PREFERENCE_MCP_ERROR_CODES.INTERNAL_ERROR;
+}
+// =====================================================
+// メインハンドラー / Main Handler
+// =====================================================
+/**
+ * preference.reset ツールハンドラー
+ * preference.reset tool handler
+ *
+ * @param input - 入力パラメータ / Input parameters
+ * @returns リセット結果 / Reset result
+ */
+async function preferenceResetHandler(input) {
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] preference.reset called", {
+            profileId: (0, schemas_1.truncateId)(input?.profile_id),
+        });
+    }
+    // 入力バリデーション / Input validation
+    let validated;
+    try {
+        validated = schemas_1.preferenceResetInputSchema.parse(input);
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            const errorMessage = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+            logger_1.logger.warn("[MCP Tool] preference.reset validation error", {
+                errors: error.errors,
+            });
+            return {
+                success: false,
+                error: {
+                    code: schemas_1.PREFERENCE_MCP_ERROR_CODES.VALIDATION_ERROR,
+                    message: `Validation error: ${errorMessage}`,
+                },
+            };
+        }
+        throw error;
+    }
+    // confirm チェック / Confirm check
+    if (!validated.confirm) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[MCP Tool] preference.reset rejected: confirm is false");
+        }
+        return {
+            success: false,
+            error: {
+                code: schemas_1.PREFERENCE_MCP_ERROR_CODES.RESET_NOT_CONFIRMED,
+                message: "Reset not confirmed. Set confirm: true to proceed with profile reset.",
+            },
+        };
+    }
+    // サービスファクトリーチェック / Service factory check
+    if (!preferenceServiceFactory) {
+        logger_1.logger.warn("[MCP Tool] preference.reset service factory not set");
+        return {
+            success: false,
+            error: {
+                code: schemas_1.PREFERENCE_MCP_ERROR_CODES.SERVICE_UNAVAILABLE,
+                message: "Preference service is not available",
+            },
+        };
+    }
+    const service = preferenceServiceFactory();
+    try {
+        // hard_delete: true → プロファイル完全削除（GDPR忘れられる権利）
+        // hard_delete: true → permanently delete profile (GDPR Right to Erasure)
+        if (validated.hard_delete) {
+            const result = await service.deleteProfile(validated.profile_id);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] preference.reset hard delete completed", {
+                    profileId: (0, schemas_1.truncateId)(result.profile_id),
+                    deleted: result.deleted,
+                });
+            }
+            return {
+                success: true,
+                data: { reset: true, profile_id: result.profile_id },
+            };
+        }
+        const result = await service.resetProfile(validated.profile_id);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[MCP Tool] preference.reset completed", {
+                profileId: (0, schemas_1.truncateId)(result.profile_id),
+                reset: result.reset,
+            });
+        }
+        return {
+            success: true,
+            data: result,
+        };
+    }
+    catch (error) {
+        const errorInstance = error instanceof Error ? error : new Error(String(error));
+        const errorCode = mapErrorToCode(errorInstance);
+        // 全環境でログ出力（isDevelopmentガードなし）
+        // Log in all environments (no isDevelopment guard)
+        logger_1.logger.warn("[MCP Tool] preference.reset error", {
+            code: errorCode,
+            error: errorInstance.message,
+        });
+        return {
+            success: false,
+            error: {
+                code: errorCode,
+                message: (0, schemas_1.sanitizeErrorMessage)(errorCode),
+            },
+        };
+    }
+}
+// =====================================================
+// ツール定義 / Tool Definition
+// =====================================================
+/**
+ * preference.reset MCPツール定義
+ * preference.reset MCP tool definition
+ */
+exports.preferenceResetToolDefinition = {
+    name: "preference.reset",
+    description: "嗜好プロファイルをリセットします。confirm: trueが必須です。preference_signalsもCASCADE削除されます。" +
+        "Reset preference profile. confirm: true is required. preference_signals are CASCADE deleted.",
+    annotations: {
+        title: "Preference Reset",
+        readOnlyHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    inputSchema: {
+        type: "object",
+        properties: {
+            profile_id: {
+                type: "string",
+                format: "uuid",
+                description: "プロファイルID（必須） / Profile ID (required)",
+            },
+            confirm: {
+                type: "boolean",
+                description: "リセット確認フラグ（trueでリセット実行） / Reset confirmation flag (true to execute reset)",
+            },
+            hard_delete: {
+                type: "boolean",
+                description: "完全削除フラグ（trueでプロファイルとシグナルを完全に削除、GDPR忘れられる権利対応） / " +
+                    "Hard delete flag (true to permanently delete profile and signals, GDPR Right to Erasure)",
+            },
+        },
+        required: ["profile_id", "confirm"],
+    },
+};
+// =====================================================
+// 開発環境ログ / Development Environment Log
+// =====================================================
+if ((0, logger_1.isDevelopment)()) {
+    logger_1.logger.debug("[preference.reset] Tool module loaded");
+}
+//# sourceMappingURL=reset.tool.js.map

package/dist/tools/preference/reset.tool.js.map

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

package/dist/tools/preference/schemas.d.ts

@@ -0,0 +1,174 @@
+/**
+ * preference MCPツール Zodスキーマ定義
+ * ユーザー嗜好プロファイリング用バリデーション
+ *
+ * Schemas:
+ * - preferenceHearInputSchema (モードA: サンプル提示 / モードB: フィードバック受信)
+ * - preferenceGetInputSchema (プロファイル取得)
+ * - preferenceResetInputSchema (プロファイルリセット)
+ *
+ * @module tools/preference/schemas
+ */
+import { z } from "zod";
+/**
+ * preference MCPエラーコード
+ * preference MCP error codes
+ */
+export declare const PREFERENCE_MCP_ERROR_CODES: {
+    /** 入力バリデーションエラー / Input validation error */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** サービス未設定 / Service not available */
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    /** プロファイル未検出 / Profile not found */
+    readonly PROFILE_NOT_FOUND: "PROFILE_NOT_FOUND";
+    /** Embedding生成失敗 / Embedding generation failed */
+    readonly EMBEDDING_FAILED: "EMBEDDING_FAILED";
+    /** 内部エラー / Internal error */
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    /** リセット未確認 / Reset not confirmed */
+    readonly RESET_NOT_CONFIRMED: "RESET_NOT_CONFIRMED";
+};
+export type PreferenceMcpErrorCode = (typeof PREFERENCE_MCP_ERROR_CODES)[keyof typeof PREFERENCE_MCP_ERROR_CODES];
+/**
+ * エラーコードからユーザー向けメッセージに変換（DB構造詳細を隠蔽）
+ * Convert error code to user-facing message (hide DB structure details)
+ *
+ * @param errorCode - エラーコード / Error code
+ * @returns サニタイズ済みメッセージ / Sanitized message
+ */
+export declare function sanitizeErrorMessage(errorCode: string): string;
+/**
+ * フィードバック評価値
+ * Feedback rating values
+ */
+export declare const feedbackRatingSchema: z.ZodEnum<["positive", "negative", "neutral"]>;
+export type FeedbackRating = z.infer<typeof feedbackRatingSchema>;
+/**
+ * 個別フィードバック項目
+ * Individual feedback item
+ */
+export declare const feedbackItemSchema: z.ZodObject<{
+    /** サンプルID / Sample ID */
+    sample_id: z.ZodString;
+    /** 評価 / Rating */
+    rating: z.ZodEnum<["positive", "negative", "neutral"]>;
+    /** コメント（最大500文字） / Comment (max 500 characters) */
+    comment: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sample_id: string;
+    rating: "neutral" | "positive" | "negative";
+    comment?: string | undefined;
+}, {
+    sample_id: string;
+    rating: "neutral" | "positive" | "negative";
+    comment?: string | undefined;
+}>;
+export type FeedbackItem = z.infer<typeof feedbackItemSchema>;
+/**
+ * preference.hear 入力スキーマ
+ * モードA: feedback なし → サンプル提示
+ * モードB: feedback あり → フィードバック受信
+ *
+ * preference.hear input schema
+ * Mode A: no feedback → present samples
+ * Mode B: feedback present → receive feedback
+ */
+export declare const preferenceHearInputSchema: z.ZodObject<{
+    /** プロファイルID（省略時は新規作成） / Profile ID (create new if omitted) */
+    profile_id: z.ZodOptional<z.ZodString>;
+    /** フィードバック配列（存在する場合はモードB） / Feedback array (Mode B if present) */
+    feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** サンプルID / Sample ID */
+        sample_id: z.ZodString;
+        /** 評価 / Rating */
+        rating: z.ZodEnum<["positive", "negative", "neutral"]>;
+        /** コメント（最大500文字） / Comment (max 500 characters) */
+        comment: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        sample_id: string;
+        rating: "neutral" | "positive" | "negative";
+        comment?: string | undefined;
+    }, {
+        sample_id: string;
+        rating: "neutral" | "positive" | "negative";
+        comment?: string | undefined;
+    }>, "many">>;
+    /** 嗜好テキスト（Claudeエージェントが生成、10-1000文字） / Preference text (generated by Claude agent, 10-1000 chars) */
+    preference_text: z.ZodOptional<z.ZodString>;
+    /** 返却サンプル数（デフォルト1件） / Number of samples to return (default 1) */
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    /** スキップ数 / Number of samples to skip */
+    offset: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    /** 除外するサンプルID配列（既評価済み） / Sample IDs to exclude (already evaluated) */
+    exclude_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    feedback?: {
+        sample_id: string;
+        rating: "neutral" | "positive" | "negative";
+        comment?: string | undefined;
+    }[] | undefined;
+    profile_id?: string | undefined;
+    preference_text?: string | undefined;
+    exclude_ids?: string[] | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    feedback?: {
+        sample_id: string;
+        rating: "neutral" | "positive" | "negative";
+        comment?: string | undefined;
+    }[] | undefined;
+    profile_id?: string | undefined;
+    preference_text?: string | undefined;
+    exclude_ids?: string[] | undefined;
+}>;
+export type PreferenceHearInput = z.infer<typeof preferenceHearInputSchema>;
+/**
+ * preference.get 入力スキーマ
+ * preference.get input schema
+ */
+export declare const preferenceGetInputSchema: z.ZodObject<{
+    /** プロファイルID（省略時はデフォルト） / Profile ID (default if omitted) */
+    profile_id: z.ZodOptional<z.ZodString>;
+    /** シグナルを含める（GDPRデータポータビリティ対応） / Include signals (GDPR data portability) */
+    include_signals: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    profile_id?: string | undefined;
+    include_signals?: boolean | undefined;
+}, {
+    profile_id?: string | undefined;
+    include_signals?: boolean | undefined;
+}>;
+export type PreferenceGetInput = z.infer<typeof preferenceGetInputSchema>;
+/**
+ * preference.reset 入力スキーマ
+ * preference.reset input schema
+ */
+export declare const preferenceResetInputSchema: z.ZodObject<{
+    /** プロファイルID（必須） / Profile ID (required) */
+    profile_id: z.ZodString;
+    /** リセット確認フラグ（必須） / Reset confirmation flag (required) */
+    confirm: z.ZodBoolean;
+    /** 完全削除フラグ（GDPR忘れられる権利対応） / Hard delete flag (GDPR Right to Erasure) */
+    hard_delete: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    confirm: boolean;
+    profile_id: string;
+    hard_delete?: boolean | undefined;
+}, {
+    confirm: boolean;
+    profile_id: string;
+    hard_delete?: boolean | undefined;
+}>;
+export type PreferenceResetInput = z.infer<typeof preferenceResetInputSchema>;
+/**
+ * IDをログ出力用にtruncateする（PII配慮）
+ * Truncate ID for log output (PII consideration)
+ *
+ * @param id - 対象ID / Target ID
+ * @returns truncate済みID / Truncated ID
+ */
+export declare function truncateId(id: string | undefined): string;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/preference/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/preference/schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC,4CAA4C;;IAE5C,sCAAsC;;IAEtC,oCAAoC;;IAEpC,kDAAkD;;IAElD,6BAA6B;;IAE7B,oCAAoC;;CAE5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAU9D;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gDAA8C,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,yBAAyB;;IAEzB,kBAAkB;;IAElB,mDAAmD;;;;;;;;;;EAEnD,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;IACpC,8DAA8D;;IAE9D,kEAAkE;;QA1BlE,yBAAyB;;QAEzB,kBAAkB;;QAElB,mDAAmD;;;;;;;;;;;IAwBnD,qGAAqG;;IAErG,iEAAiE;;IAEjE,wCAAwC;;IAExC,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;EAEtE,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;IACnC,4DAA4D;;IAE5D,2EAA2E;;;;;;;;EAE3E,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC,2CAA2C;;IAE3C,yDAAyD;;IAEzD,wEAAwE;;;;;;;;;;EAExE,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGzD"}

package/dist/tools/preference/schemas.js

@@ -0,0 +1,142 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preferenceResetInputSchema = exports.preferenceGetInputSchema = exports.preferenceHearInputSchema = exports.feedbackItemSchema = exports.feedbackRatingSchema = exports.PREFERENCE_MCP_ERROR_CODES = void 0;
+exports.sanitizeErrorMessage = sanitizeErrorMessage;
+exports.truncateId = truncateId;
+/**
+ * preference MCPツール Zodスキーマ定義
+ * ユーザー嗜好プロファイリング用バリデーション
+ *
+ * Schemas:
+ * - preferenceHearInputSchema (モードA: サンプル提示 / モードB: フィードバック受信)
+ * - preferenceGetInputSchema (プロファイル取得)
+ * - preferenceResetInputSchema (プロファイルリセット)
+ *
+ * @module tools/preference/schemas
+ */
+const zod_1 = require("zod");
+// ============================================================================
+// Error Codes / エラーコード
+// ============================================================================
+/**
+ * preference MCPエラーコード
+ * preference MCP error codes
+ */
+exports.PREFERENCE_MCP_ERROR_CODES = {
+    /** 入力バリデーションエラー / Input validation error */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** サービス未設定 / Service not available */
+    SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+    /** プロファイル未検出 / Profile not found */
+    PROFILE_NOT_FOUND: "PROFILE_NOT_FOUND",
+    /** Embedding生成失敗 / Embedding generation failed */
+    EMBEDDING_FAILED: "EMBEDDING_FAILED",
+    /** 内部エラー / Internal error */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    /** リセット未確認 / Reset not confirmed */
+    RESET_NOT_CONFIRMED: "RESET_NOT_CONFIRMED",
+};
+/**
+ * エラーコードからユーザー向けメッセージに変換（DB構造詳細を隠蔽）
+ * Convert error code to user-facing message (hide DB structure details)
+ *
+ * @param errorCode - エラーコード / Error code
+ * @returns サニタイズ済みメッセージ / Sanitized message
+ */
+function sanitizeErrorMessage(errorCode) {
+    const messages = {
+        [exports.PREFERENCE_MCP_ERROR_CODES.VALIDATION_ERROR]: "Input validation failed",
+        [exports.PREFERENCE_MCP_ERROR_CODES.PROFILE_NOT_FOUND]: "Profile not found",
+        [exports.PREFERENCE_MCP_ERROR_CODES.EMBEDDING_FAILED]: "Embedding generation failed",
+        [exports.PREFERENCE_MCP_ERROR_CODES.SERVICE_UNAVAILABLE]: "Preference service is not available",
+        [exports.PREFERENCE_MCP_ERROR_CODES.INTERNAL_ERROR]: "An internal error occurred",
+        [exports.PREFERENCE_MCP_ERROR_CODES.RESET_NOT_CONFIRMED]: "Reset not confirmed",
+    };
+    return messages[errorCode] ?? "An unexpected error occurred";
+}
+// ============================================================================
+// Feedback Schema / フィードバックスキーマ
+// ============================================================================
+/**
+ * フィードバック評価値
+ * Feedback rating values
+ */
+exports.feedbackRatingSchema = zod_1.z.enum(["positive", "negative", "neutral"]);
+/**
+ * 個別フィードバック項目
+ * Individual feedback item
+ */
+exports.feedbackItemSchema = zod_1.z.object({
+    /** サンプルID / Sample ID */
+    sample_id: zod_1.z.string().uuid(),
+    /** 評価 / Rating */
+    rating: exports.feedbackRatingSchema,
+    /** コメント（最大500文字） / Comment (max 500 characters) */
+    comment: zod_1.z.string().max(500).optional(),
+});
+// ============================================================================
+// Input Schemas / 入力スキーマ
+// ============================================================================
+/**
+ * preference.hear 入力スキーマ
+ * モードA: feedback なし → サンプル提示
+ * モードB: feedback あり → フィードバック受信
+ *
+ * preference.hear input schema
+ * Mode A: no feedback → present samples
+ * Mode B: feedback present → receive feedback
+ */
+exports.preferenceHearInputSchema = zod_1.z.object({
+    /** プロファイルID（省略時は新規作成） / Profile ID (create new if omitted) */
+    profile_id: zod_1.z.string().uuid().optional(),
+    /** フィードバック配列（存在する場合はモードB） / Feedback array (Mode B if present) */
+    feedback: zod_1.z.array(exports.feedbackItemSchema).max(50).optional(),
+    /** 嗜好テキスト（Claudeエージェントが生成、10-1000文字） / Preference text (generated by Claude agent, 10-1000 chars) */
+    preference_text: zod_1.z.string().min(10).max(1000).optional(),
+    /** 返却サンプル数（デフォルト1件） / Number of samples to return (default 1) */
+    limit: zod_1.z.number().int().min(1).max(10).default(1).optional(),
+    /** スキップ数 / Number of samples to skip */
+    offset: zod_1.z.number().int().min(0).max(1000).default(0).optional(),
+    /** 除外するサンプルID配列（既評価済み） / Sample IDs to exclude (already evaluated) */
+    exclude_ids: zod_1.z.array(zod_1.z.string().uuid()).max(50).optional(),
+});
+/**
+ * preference.get 入力スキーマ
+ * preference.get input schema
+ */
+exports.preferenceGetInputSchema = zod_1.z.object({
+    /** プロファイルID（省略時はデフォルト） / Profile ID (default if omitted) */
+    profile_id: zod_1.z.string().uuid().optional(),
+    /** シグナルを含める（GDPRデータポータビリティ対応） / Include signals (GDPR data portability) */
+    include_signals: zod_1.z.boolean().optional(),
+});
+/**
+ * preference.reset 入力スキーマ
+ * preference.reset input schema
+ */
+exports.preferenceResetInputSchema = zod_1.z.object({
+    /** プロファイルID（必須） / Profile ID (required) */
+    profile_id: zod_1.z.string().uuid(),
+    /** リセット確認フラグ（必須） / Reset confirmation flag (required) */
+    confirm: zod_1.z.boolean(),
+    /** 完全削除フラグ（GDPR忘れられる権利対応） / Hard delete flag (GDPR Right to Erasure) */
+    hard_delete: zod_1.z.boolean().optional(),
+});
+// ============================================================================
+// PII Truncation Utility / PII切り詰めユーティリティ
+// ============================================================================
+/**
+ * IDをログ出力用にtruncateする（PII配慮）
+ * Truncate ID for log output (PII consideration)
+ *
+ * @param id - 対象ID / Target ID
+ * @returns truncate済みID / Truncated ID
+ */
+function truncateId(id) {
+    if (!id)
+        return "undefined";
+    return id.length > 8 ? id.slice(0, 8) + "..." : id;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/tools/preference/schemas.js.map

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

package/dist/tools/project-get.d.ts

@@ -0,0 +1,42 @@
+import { type ProjectGetOutput, type ProjectGetSummaryOutput } from "./schemas/project-schemas";
+import { type McpResponse } from "../utils/mcp-response";
+/** project.get ハンドラーの戻り値型 */
+export type ProjectGetResponse = McpResponse<ProjectGetOutput | ProjectGetSummaryOutput>;
+/**
+ * project.get ツールハンドラー
+ *
+ * @param input - 取得入力パラメータ
+ * @returns 統一レスポンス形式（success: true/false + data/error + metadata.request_id）
+ */
+export declare function projectGetHandler(input: unknown): Promise<ProjectGetResponse>;
+/**
+ * project.get ツール定義
+ * MCP Protocol用のツール定義オブジェクト
+ */
+export declare const projectGetToolDefinition: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=project-get.d.ts.map

package/dist/tools/project-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-get.d.ts","sourceRoot":"","sources":["../../src/tools/project-get.ts"],"names":[],"mappings":"AAkBA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,uBAAuB,CAAC;AAE/B,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,gBAAgB,GAAG,uBAAuB,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuHnF;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpC,CAAC"}