@reftrixmcp/mcp-server 0.1.7

package/src/tools/preference/reset.tool.ts

@@ -0,0 +1,264 @@
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+
+/**
+ * preference.reset MCPツール
+ * 嗜好プロファイルのリセット
+ *
+ * preference.reset MCP tool
+ * Reset preference profile
+ *
+ * @module tools/preference/reset.tool
+ */
+
+import { ZodError } from "zod";
+import { logger, isDevelopment } from "../../utils/logger";
+import {
+  preferenceResetInputSchema,
+  PREFERENCE_MCP_ERROR_CODES,
+  sanitizeErrorMessage,
+  truncateId,
+  type PreferenceResetInput,
+} from "./schemas";
+import type { IPreferenceService } from "./hear.tool";
+
+// =====================================================
+// 型定義 / Type Definitions
+// =====================================================
+
+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;
+      };
+    };
+
+// =====================================================
+// サービスファクトリー（DI） / Service Factory (DI)
+// =====================================================
+
+let preferenceServiceFactory: (() => IPreferenceService) | null = null;
+
+/**
+ * サービスファクトリーを設定
+ * Set service factory
+ */
+export function setPreferenceServiceFactory(factory: () => IPreferenceService): void {
+  preferenceServiceFactory = factory;
+}
+
+/**
+ * サービスファクトリーをリセット
+ * Reset service factory
+ */
+export function resetPreferenceServiceFactory(): void {
+  preferenceServiceFactory = null;
+}
+
+// =====================================================
+// エラーコード判定 / Error Code Mapping
+// =====================================================
+
+/**
+ * エラーからエラーコードを判定
+ * Map error to error code
+ */
+function mapErrorToCode(error: Error): string {
+  const message = error.message.toLowerCase();
+
+  if (message.includes("profile not found") || message.includes("not found")) {
+    return PREFERENCE_MCP_ERROR_CODES.PROFILE_NOT_FOUND;
+  }
+
+  return PREFERENCE_MCP_ERROR_CODES.INTERNAL_ERROR;
+}
+
+// =====================================================
+// メインハンドラー / Main Handler
+// =====================================================
+
+/**
+ * preference.reset ツールハンドラー
+ * preference.reset tool handler
+ *
+ * @param input - 入力パラメータ / Input parameters
+ * @returns リセット結果 / Reset result
+ */
+export async function preferenceResetHandler(input: unknown): Promise<PreferenceResetOutput> {
+  if (isDevelopment()) {
+    logger.info("[MCP Tool] preference.reset called", {
+      profileId: truncateId((input as Record<string, unknown>)?.profile_id as string | undefined),
+    });
+  }
+
+  // 入力バリデーション / Input validation
+  let validated: PreferenceResetInput;
+  try {
+    validated = preferenceResetInputSchema.parse(input);
+  } catch (error) {
+    if (error instanceof ZodError) {
+      const errorMessage = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+
+      logger.warn("[MCP Tool] preference.reset validation error", {
+        errors: error.errors,
+      });
+
+      return {
+        success: false,
+        error: {
+          code: PREFERENCE_MCP_ERROR_CODES.VALIDATION_ERROR,
+          message: `Validation error: ${errorMessage}`,
+        },
+      };
+    }
+    throw error;
+  }
+
+  // confirm チェック / Confirm check
+  if (!validated.confirm) {
+    if (isDevelopment()) {
+      logger.info("[MCP Tool] preference.reset rejected: confirm is false");
+    }
+
+    return {
+      success: false,
+      error: {
+        code: 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.warn("[MCP Tool] preference.reset service factory not set");
+
+    return {
+      success: false,
+      error: {
+        code: 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 (isDevelopment()) {
+        logger.info("[MCP Tool] preference.reset hard delete completed", {
+          profileId: 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 (isDevelopment()) {
+      logger.info("[MCP Tool] preference.reset completed", {
+        profileId: 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.warn("[MCP Tool] preference.reset error", {
+      code: errorCode,
+      error: errorInstance.message,
+    });
+
+    return {
+      success: false,
+      error: {
+        code: errorCode,
+        message: sanitizeErrorMessage(errorCode),
+      },
+    };
+  }
+}
+
+// =====================================================
+// ツール定義 / Tool Definition
+// =====================================================
+
+/**
+ * preference.reset MCPツール定義
+ * preference.reset MCP tool definition
+ */
+export const 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" as const,
+    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 (isDevelopment()) {
+  logger.debug("[preference.reset] Tool module loaded");
+}

package/src/tools/preference/schemas.ts

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

package/src/tools/project-get.ts

@@ -0,0 +1,194 @@
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+
+/**
+ * project.get MCPツールハンドラー
+ * ID指定でプロジェクト詳細を取得
+ *
+ * 機能:
+ * - UUID指定でプロジェクト取得
+ * - summaryオプションで軽量レスポンス
+ * - 存在しないIDのエラーハンドリング
+ * - 認証エラーのハンドリング
+ *
+ * レスポンス形式:
+ * - 成功: { success: true, data: {...}, metadata: { request_id, ... } }
+ * - エラー: { success: false, error: { code, message }, metadata: { request_id, ... } }
+ */
+import { ZodError } from "zod";
+import {
+  projectGetInputSchema,
+  type ProjectGetInput,
+  type ProjectGetOutput,
+  type ProjectGetSummaryOutput,
+} from "./schemas/project-schemas";
+import { serviceClient } from "../services/service-client";
+import { logger, isDevelopment } from "../utils/logger";
+import { ErrorCode } from "../utils/errors";
+import {
+  type McpResponse,
+  generateRequestId,
+  createSuccessResponseWithRequestId,
+  createErrorResponseWithRequestId,
+} 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 async function projectGetHandler(input: unknown): Promise<ProjectGetResponse> {
+  // router.tsから注入された_request_idを使用、フォールバックとして自動生成
+  const requestId =
+    ((input as Record<string, unknown> | null)?._request_id as string | undefined) ??
+    generateRequestId();
+
+  // 開発環境でのログ出力
+  if (isDevelopment()) {
+    logger.info("[MCP Tool] project.get called", { input, requestId });
+  }
+
+  // 入力バリデーション
+  let validated: ProjectGetInput;
+  try {
+    validated = projectGetInputSchema.parse(input);
+  } catch (error) {
+    if (error instanceof ZodError) {
+      const errorMessage = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+
+      if (isDevelopment()) {
+        logger.error("[MCP Tool] project.get validation error", {
+          errors: error.errors,
+          requestId,
+        });
+      }
+
+      return createErrorResponseWithRequestId(
+        ErrorCode.VALIDATION_ERROR,
+        `入力バリデーションエラー: ${errorMessage}`,
+        requestId,
+        error.errors // details（開発環境のみ含まれる）
+      );
+    }
+    // 予期せぬエラー
+    return createErrorResponseWithRequestId(
+      ErrorCode.INTERNAL_ERROR,
+      "入力処理中に予期せぬエラーが発生しました",
+      requestId
+    );
+  }
+
+  try {
+    // API呼び出し
+    const result = await serviceClient.getProject(validated.id);
+
+    // 存在しないIDの場合（ServiceClientでnullを返す）
+    if (result === null) {
+      if (isDevelopment()) {
+        logger.warn("[MCP Tool] project.get - Project not found", {
+          id: validated.id,
+          requestId,
+        });
+      }
+
+      return createErrorResponseWithRequestId(
+        ErrorCode.PROJECT_NOT_FOUND,
+        `指定されたIDのプロジェクトが見つかりません: ${validated.id}`,
+        requestId
+      );
+    }
+
+    if (isDevelopment()) {
+      logger.info("[MCP Tool] project.get completed", {
+        id: validated.id,
+        name: result.name,
+        summary: validated.summary,
+        requestId,
+      });
+    }
+
+    // summaryモードの場合は軽量レスポンスを返す（id, name, statusのみ）
+    if (validated.summary) {
+      const summaryData: ProjectGetSummaryOutput = {
+        id: result.id,
+        name: result.name,
+        status: result.status,
+        _summary_mode: true,
+      };
+
+      if (isDevelopment()) {
+        logger.info("[MCP Tool] project.get returning summary response", {
+          id: result.id,
+          requestId,
+        });
+      }
+
+      return createSuccessResponseWithRequestId(summaryData, requestId);
+    }
+
+    // フルレスポンス
+    const fullData: ProjectGetOutput = {
+      id: result.id,
+      name: result.name,
+      slug: result.slug,
+      description: result.description,
+      status: result.status,
+      createdAt: result.createdAt,
+      updatedAt: result.updatedAt,
+      brandSetting: result.brandSetting ?? null,
+    };
+
+    return createSuccessResponseWithRequestId(fullData, requestId);
+  } catch (error) {
+    if (isDevelopment()) {
+      logger.error("[MCP Tool] project.get API error", { error, requestId });
+    }
+
+    // 認証エラーのチェック
+    if (error instanceof Error && error.message.includes("UNAUTHORIZED")) {
+      return createErrorResponseWithRequestId(ErrorCode.UNAUTHORIZED, "認証が必要です", requestId);
+    }
+
+    return createErrorResponseWithRequestId(
+      ErrorCode.INTERNAL_ERROR,
+      "プロジェクト取得中にエラーが発生しました",
+      requestId,
+      error instanceof Error ? error.message : undefined
+    );
+  }
+}
+
+/**
+ * project.get ツール定義
+ * MCP Protocol用のツール定義オブジェクト
+ */
+export const projectGetToolDefinition = {
+  name: "project.get",
+  description: "Get project details by ID.",
+  annotations: {
+    title: "Project Get",
+    readOnlyHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  inputSchema: {
+    type: "object" as const,
+    properties: {
+      id: {
+        type: "string",
+        format: "uuid",
+        description: "Project ID (UUID)",
+      },
+      summary: {
+        type: "boolean",
+        description: "Lightweight mode: returns id, name, status only (default: true)",
+        default: true,
+      },
+    },
+    required: ["id"],
+  },
+};