Memory Bank MCP Server

{ "schema": "memory_document_v2", "metadata": { "id": "logger-migration-plan", "title": "ロガー実装統一計画", "documentType": "plan", "path": "logger-migration-plan.json", "tags": [ "plan", "refactoring", "logger" ], "lastModified": "2025-03-28T21:15:00.000Z", "createdAt": "2025-03-28T21:15:00.000Z", "version": 1 }, "content": { "overview": { "description": "複数の異なるロガー実装を統一し、シンプルで一貫性のあるロギングシステムを実現するための計画。", "currentState": "現在、プロジェクト内に複数のロガー実装が混在しており、一貫性のないロギング方法が使われている。", "targetState": "shared/utils/logger.ts のシンプルなロガー実装に統一し、不要なロガー実装を削除する。" }, "loggerImplementations": [ { "name": "domain/logger/ILogger", "type": "Interface and Abstract Class", "location": "packages/mcp/src/domain/logger/ILogger.ts", "status": "to-be-removed", "features": [ "複雑なインターフェースとBaseLogger抽象クラス", "コンテキスト情報の追加", "ロガーの設定更新" ], "usage": "一部のクラスで使用されているが、直接利用は少ない" }, { "name": "domain/logger/types", "type": "Type Definitions", "location": "packages/mcp/src/domain/logger/types.ts", "status": "to-be-removed", "features": [ "LogLevel列挙型", "LogContext, LogEntry, LoggerOptionsインターフェース" ], "usage": "ILoggerとJsonLoggerで使用" }, { "name": "infrastructure/logger/JsonLogger", "type": "Implementation", "location": "packages/mcp/src/infrastructure/logger/JsonLogger.ts", "status": "to-be-removed", "features": [ "JSONフォーマットでのログ出力", "BaseLoggerの実装" ], "usage": "LoggerFactoryから利用されているが、直接使用箇所は少ない" }, { "name": "infrastructure/logger/LoggerFactory", "type": "Factory", "location": "packages/mcp/src/infrastructure/logger/LoggerFactory.ts", "status": "to-be-removed", "features": [ "シングルトンパターン", "名前付きロガーの管理", "ロガータイプの選択" ], "usage": "デフォルトロガーの提供のみで、ほとんど使用されていない" }, { "name": "shared/utils/logger/index.ts", "type": "Implementation", "location": "packages/mcp/src/shared/utils/logger/index.ts", "status": "to-be-removed", "features": [ "Logger クラス実装", "JsonLogTransformer ストリーム変換" ], "usage": "おそらく新しい実装として追加されたが、使用箇所が少ない" }, { "name": "shared/utils/logger.ts", "type": "Implementation", "location": "packages/mcp/src/shared/utils/logger.ts", "status": "to-be-kept", "features": [ "シンプルなファクトリベースのロガー", "console.log/info/warn/errorベース", "ログレベルの設定" ], "usage": "プロジェクト全体でよく使用されている" } ], "migrationSteps": [ { "id": "1", "description": "現在のロガー実装の使用状況を詳細に把握", "tasks": [ "各ファイルでのロガーインポート箇所の特定", "defaultLoggerの参照箇所の確認" ] }, { "id": "2", "description": "shared/utils/logger.ts を標準実装として強化", "tasks": [ "必要に応じて機能追加（コンテキスト情報などが必要な場合）", "文書化の改善" ] }, { "id": "3", "description": "移行対象ファイルの特定と修正", "tasks": [ "domain/logger/ILoggerを参照しているファイルの特定", "LoggerFactoryやJsonLoggerを使用しているファイルの特定", "shared/utils/logger/index.tsを参照しているファイルの特定", "各ファイルのimport文の修正" ] }, { "id": "4", "description": "不要なロガー実装ファイルの削除", "tasks": [ "domain/logger/ILogger.ts の削除", "domain/logger/types.ts の削除", "infrastructure/logger/JsonLogger.ts の削除", "infrastructure/logger/LoggerFactory.ts の削除", "shared/utils/logger/index.ts の削除またはshared/utils/logger.tsとの統合" ] }, { "id": "5", "description": "ビルドとテスト", "tasks": [ "ビルドエラーの確認と修正", "ロギング機能の動作確認", "既存のテストが正常に動作するか確認" ] } ], "considerations": [ { "id": "logger-backward-compatibility", "description": "shared/utils/logger.tsに移行する際に、既存コードとの互換性確保が必要", "impact": "medium", "resolution": "必要に応じてadapterパターンを使用するか、shared/utils/logger.tsにメソッドを追加" }, { "id": "logging-levels", "description": "異なるロガー実装間でログレベルの整合性を確保", "impact": "low", "resolution": "統一されたLogLevelの定義に合わせる" } ], "risks": [ { "id": "hidden-dependencies", "description": "見落としている依存関係がある可能性", "severity": "medium", "mitigation": "徹底的なgrep検索とビルドテストの実施" }, { "id": "functionality-loss", "description": "高度なロギング機能（コンテキスト付きロギングなど）の喪失", "severity": "low", "mitigation": "必要な機能は標準ロガーに追加実装する" } ] } }