メインコンテンツまでスキップ

変更履歴

MBC CQRS Serverlessのすべての注目すべき変更がここに記録されています。このプロジェクトはセマンティックバージョニングとConventional Commitsに従っています。

バージョン体系​

  • x.y.z - 本番リリース
  • x.y.z-beta.n - テスト用ベータリリース
  • x.y.z-alpha.n - 早期アクセス用アルファリリース

安定版リリース (1.x)​

1.4.0 (2026-08-02)​

新機能​

  • core, master, directory, survey-template, ui-setting: ドメインモジュールの DynamoDB テーブル名を後方互換オプション tableName? で設定可能にし、4モジュールすべてに registerAsync を追加。既定値は現行のまま（master / directory / survey / master）なので、既存アプリはコード変更なしにアップグレードできる (詳細を見る) (PR #493)
    • DirectoryStorageModule はさらに pkPrefix?（既定 DIRECTORY）と prismaModelName?（既定 directory）を受け付ける
    • directory → document の改名（PR #469）は、強制的な既定値ではなく opt-in の設定（tableName: 'document'、pkPrefix: 'DOCUMENT'、prismaModelName: 'document'）として表現されるようになった

変更点​

  • master, directory, survey-template: prismaService は登録時に常に必須になった（従来は enableController: true のときのみ検証）。未指定の場合、分かりにくい依存解決エラーではなく起動時に明確なメッセージで即座に失敗する。enableController: false で登録しグローバル提供トークンに依存していた場合は prismaService を明示的に渡すこと
  • master, ui-setting: MasterModule と SettingModule が既定の master テーブルを共有する場合、両者が master_CommandEventHandler alias を所有すると起動時に警告が出る（データ同期の所有権が import 順に依存する）。SettingModule に registerEventHandlerAlias: false を設定して MasterModule に alias を所有させること
  • master: MasterModule は tableName を上書きすると警告を出す。master テーブルは TtlService や sequence パッケージが固定名 master-data で読む framework 横断の設定ストアであり、改名は完全にはサポートされない

1.3.5 (2026-08-01)​

バグ修正​

  • core: コマンドハンドラーの再開（resume）を read-after-write の競合に対して強化 — waitConfirmToken は先行コマンドが既に完了している場合に自己再開するようになり、STARTED|FINISHED のステータス確認で残存する TOCTOU ウィンドウを塞ぎ、先行コマンドの getItem を指数バックオフでリトライし、checkNextToken の再開失敗を分類して、再開が滞留した場合はサイレントに失敗せずアラームを発報します (PR #465)
  • core: DynamoDbService.getItem に ConsistentRead サポートを追加し、CommandService.getItem / getNextCommand を通して伝播 — 再開の判定が、古いレプリカではなく最新のコミット済み状態を読むようになります (PR #465)
  • cli: mbc new で scaffold した infra テンプレートが cdk synth/deploy に失敗する問題を修正 — import-CSV の Step Functions 定義が未定義の aws_stepfunctions 識別子（cdk.aws_stepfunctions に修正）を参照しており、v1.3.4 で mbc new から作成した全プロジェクトが壊れていた。v1.3.5 にアップグレードすればデプロイ可能に戻る (PR #465)

新機能​

  • infra: コマンドハンドラーの Step Functions ステートマシンに CloudWatch アラーム（ExecutionsFailed と自己再開の劣化経路）を追加し、wait_prev_command に 24時間のタイムアウトと catch を追加し、SendTaskSuccess の IAM 権限をコマンド用ステートマシンの ARN に限定します (PR #465)
  • cli: mbc new プロジェクト向けのローカル開発ツール — ローカルインフラのポートを LOCAL_*_PORT 環境変数で可変化（デフォルトは不変）、cognito-local の JWT issuer を LOCAL_COGNITO_PORT に追従、Step Functions Local の事前登録を堅牢化（起動待ち・実エラー時の fail-fast・登録済みステートマシンの許容）。デプロイ済みアプリの実行時挙動には影響なし (PR #337)

セキュリティ​

  • 一時的に無効化されていたブロッキング CI ゲート npm audit --omit=dev --audit-level=high を復活させ、brace-expansion を修正（トップレベル brace-expansion@2 → 5.0.8）。本番ルート監査: critical/high 0件 (PR #482)
    • スコープ注記: 「0 critical/high」は root workspace のみに適用される。scaffold される infra テンプレート（packages/cli/templates/infra）は npm workspace メンバーではなく、@aws/pdk（ビルド時の cdk-graph ツール）を同梱しており、その推移的依存には high 脆弱性が残る。現在は CI で非ブロッキング監査され、issue #486 で別途追跡している

1.3.4 (2026-07-17)​

バグ修正​

  • core, cli: CDKインフラのテンプレートおよび環境変数の例における ATTRIBUTE_LIMIT_SIZE のデフォルト値を 389120（380 KB）から 102400（100 KB）に引き下げ — 従来のデフォルト値はDynamoDBの400 KBアイテム上限を基準にしていましたが、Step Functionsは各ステートあたり256 KBのペイロード上限を課しており、かつコマンド用ステートマシンはDynamoDB Streamイベントを2重（input.$ と context.$）に渡すため、~110 KBを超えるインライン属性は States.DataLimitExceeded を引き起こす可能性がありました (詳細を見る) (PR #466)
  • mcp-server: 新しい ATTRIBUTE_LIMIT_SIZE のデフォルト値に関するガイダンスをスキルに追加 (PR #470)

1.3.2 (2026-06-27)​

新機能​

  • mcp-server: AP028、AP029、AP030 のアンチパターン検出器を追加 (詳細を見る) (PR #460, PR #461)
    • AP028: NestJS モジュール間での DataSyncHandler 重複登録 — 検出して重複排除し、警告ログを出力
    • AP029: @DataSyncHandler の予約済み 'dynamodb' タイプを使用するとハンドラーがディスパッチから静かに除外される
    • AP030: @DataSyncHandler で完全修飾テーブル名（'-command' で終わる）を使用するとハンドラーが静かにスキップされる

バグ修正​

  • core: DataSyncHandler の重複登録を修正 — ExplorerService が Set でハンドラーを重複排除し、CommandService が Map<constructor.name, instance> で重複排除して削除された重複ごとに warn ログを出力するように (PR #459)
  • core: publishSync を修正 — ハンドラーディスパッチ前にバージョン付き sk が command.sk に代入されるようになり IDataSyncHandler.up() が正しいキーを受け取る。updateStatus エラーがサイレントにマスクされなくなった。デバッグを容易にするため checkNextToken の警告ログに pk/sk を追加。 (詳細を見る) (PR #460)

セキュリティ​

  • npm 依存関係を強化 — overrides（lodash、tmp、multer、ajv、picomatch、fast-xml-parser）と個別アップグレード（@nestjs/config ^4.0.4、@typescript-eslint v8）で high/moderate 脆弱性を解消。本番ルート監査: critical/high 0件 (PR #445–#453)
  • cli: スキャフォールドテンプレートの multer を v2.2.0 にアップグレードして CVE-2026-5079（深いネストのマルチパートフィールド名による DoS）を修正 (PR #463)
  • ブロッキング CI ゲートを追加: npm audit --omit=dev --audit-level=high と ESLint 起動チェックがすべての PR で実行され、本番脆弱性があるとビルドが失敗する (PR #448)

1.3.1 (2026-06-02)​

新機能​

  • core: グループベースのロール認可を追加 — RolesGuard はまず custom:roles の直接ロールを確認し、次に新しい custom:groups クレームに含まれるユーザーのグループから導出されたロールを確認します (詳細を見る) (PR #440)
    • 新しい @GroupRoleResolver() デコレータと IGroupRoleResolver インターフェース — アプリごとに 1 つだけリゾルバを実装し、グループ ID をロールにマッピングします（DynamoDB/RDS/設定から読み込み）。マッピングは JWT には保存されません
    • UserContext に tenantRoles（直接ロールの配列）と tenantGroupIds（アクティブテナントのグループ ID）が追加されました。tenantRole（単数）は後方互換性のため維持されます
    • オプトイン: 既存の @Roles() チェックはコード変更なしで動作し続けます
    • リゾルバの失敗は（暗黙の 403 ではなく）5xx として伝播するため、バックエンド障害を本来のアクセス拒否と区別できます
  • mcp-server: v1.3.1 向けにスキルとアナライザを更新
    • AP027 アンチパターン検出を追加: @GroupRoleResolver() クラスに @Injectable() を併用してはいけません
    • mbc-migrate スキル: v1.3.1 のマイグレーションガイドを追加
    • mbc-generate スキル: グループロールリゾルバのコード生成テンプレートを追加
    • mbc-review スキル: AP022（グループロールリゾルバ）をチェックリストに追加

バグ修正​

  • core: 不正な custom:groups クレームを例外ではなく許容（グループロールなしにフェイルクローズ）するようにし、不正なトークンでもリクエストをクラッシュさせず直接ロールのみのチェックに縮退します
  • 移行ガイド v1.3.1 でアップグレード手順を確認してください。

1.3.0 (2026-05-21)​

新機能​

  • core: AppSyncEventsService を追加 — AWS AppSync Events API によるリアルタイム通知のオプトイン HTTP pub/sub トランスポート (詳細を見る) (PR #433)
    • NOTIFICATION_TRANSPORTS 環境変数（カンマ区切り）でトランスポートを選択。デフォルトは appsync-graphql — 既存の GraphQL サブスクリプションの動作は変わりません
    • チャンネル構造: /{namespace}/{tenantCode}/{action}/{sanitizedId} — クライアントは AppSync ワイルドカード（/*）で任意の粒度でサブスクライブ可能
    • 認証: Lambda/ECS パブリッシュには IAM SigV4、クライアントサブスクライブには API キー
    • デュアルパブリッシュモード: 移行中は NOTIFICATION_TRANSPORTS=appsync-graphql,appsync-event で両方のトランスポートに同時パブリッシュ
    • 新規環境変数: NOTIFICATION_TRANSPORTS, APPSYNC_EVENTS_ENDPOINT, APPSYNC_EVENTS_NAMESPACE (詳細を見る)
    • @NotificationTransport デコレータ: プラグイン式トランスポート登録 — フレームワークコードを変更せずにカスタムトランスポートを追加可能
  • cli: CDK インフラテンプレート: Config 型に appsyncEvents と notificationTransports を追加 — EventApi + ChannelNamespace をプロビジョニングし、Lambda/ECS に NOTIFICATION_TRANSPORTS、APPSYNC_EVENTS_ENDPOINT、APPSYNC_EVENTS_NAMESPACE を注入、grantPublish() で appsync:EventPublish IAM 権限を自動付与
  • mcp-server: v1.3.0 向けスキルとアナライザーを更新 (PR #436)
    • AP026 アンチパターン検出器を追加: INotificationTransport 実装クラスに @NotificationTransport と @Injectable を二重指定するケース
    • mbc-migrate スキル: v1.3.0 移行ガイドおよびバージョン互換性テーブルを更新
    • mbc-generate スキル: カスタム通知トランスポートのコード生成テンプレートを追加
    • mbc-review スキル: チェックリストに AP026 を追加
  • 移行ガイド v1.3.0 でアップグレード手順を確認してください。

1.2.6 (2026-05-06)​

新機能​

  • core: Repository の Read-Your-Writes（RYW）改善 — データテーブルがセッションバージョンに追いついた／追い越した時点で陳腐化したRYWセッションを即時パージし、「stale override」読み取りを解消 (詳細を見る) (PR #410)
    • getItem: existing.version >= session.version の場合、バックグラウンドでセッションをパージし永続化済みデータを直接返却（不要な Command テーブル読み取りをスキップ）
    • listItemsByPk: マージループ中に同期済みセッションをその場でクリーンアップ
    • listItems（RDSパス）: セッションごとのチェックを Promise.all で並列化し、直列N+1のレイテンシを解消
    • 新しいオプション mergeOptions.getVersion により、RDS行が既に追いついていることを証明できる場合は追加のDynamoDB GetItemをスキップ可能
    • SessionService.delete() と DynamoDbService.deleteItem() を追加（fire-and-forgetでの利用に安全）
    • 後方互換: getVersion はオプション。RYW_SESSION_TTL_MINUTES 未設定のプロジェクトは影響なし
  • mcp-server: AP021 アンチパターン検出器を追加 — CommandService 内で publishAsync 直後にイベントをemit（Severity: High） (詳細を見る) (PR #408)
    • commandService.publishAsync/publishSync から200文字以内の eventEmitter.emit() 呼び出しを検出
    • 推奨: publishAsync 後はDynamoDB Streams経由で非同期にデータテーブルが書き込まれるため、イベント発行は IDataSyncHandler.up()/down() 内で行うこと
  • mcp-server: 検出器AP番号（analyze.ts）とskill-doc AP番号（skills/mbc-review/SKILL.md）のクロスリファレンス表を追加 — 両者は独立した番号体系で、コードが一致するのは AP016〜AP019 と AP021 のみ (PR #411)
    • 検出器の出力に対応するskill-doc AP番号を併記するように変更（例: AP005: Hardcoded Tenant (skill-doc: AP002)）
    • mbc-migrate スキル: v1.2.5・v1.2.6セクションとマイグレーションマトリクスのエントリを追加
    • mbc-debug スキル: v1.2.6での（意図的な）RYWセッション早期パージに関するトラブルシューティング項目を追加

バグ修正​

  • mcp-server: server.ts がパッケージバージョンをハードコードしており、lerna version のたびにサイレントにずれていた問題を修正。実行時に package.json から読み込むように変更 (PR #411)

1.2.5 (2026-04-10)​

新機能​

  • import: ZIPインポート処理をリファクタリング — ZIPジョブ処理をImportServiceに直接統合し、独立したZipImportQueueEventHandlerを削除 (詳細を見る) (PR #404)
    • ZipImportQueueEventHandlerを削除。ZIPインポートジョブはImportService内で直接処理されるように変更
    • ImportEventHandlerがZIP_MASTER_JOBイベントに対してSQSパブリッシュをスキップするように変更
    • CreateZipImportDtoのZIPインポートバリデーションを強化
    • ZIP処理のエラーハンドリングとロギングを改善
  • mcp-server: mbc_check_anti_patternsツールにAP016〜AP020のアンチパターン検出器を追加（合計20パターン） (PR #403)
    • AP016: リスロー前のエラーロギング欠落（High）
    • AP017: 部分更新時の属性マージ誤り（High）
    • AP018: Swaggerドキュメント / @ApiTags 欠落（Low）
    • AP019: リストクエリのページネーション欠落（High）
    • AP020: トレーシング用getCommandSource欠落（Low）
  • mcp-server: mbc-migrateとmbc-debugスキルをv1.1.x・v1.2.x破壊的変更ガイドで更新 (PR #403)

依存関係​

  • mcp-server: @modelcontextprotocol/sdkを1.26.0から1.29.0に更新 (PR #403)

1.2.4 (2026-04-09)​

新機能​

  • task: TaskModule.register()がグローバルモジュールを返すようになり、複数のフィーチャーモジュールへの登録が不要になりました (PR #398)
    • 以前はタスク機能が必要な各モジュールでTaskModule.register()を呼び出す必要がありましたが、AppModuleで一度だけ登録すればよくなりました
  • mcp-server: AP015アンチパターン検出器を追加 — v1.2.4以降で不要となったTaskModule.register()の重複呼び出しを検出します (PR #399)

1.2.3 (2026-04-08)​

バグ修正​

  • import: CsvBatchProcessorにSmart Retryパターンを実装してHead-of-Line Blocking（Poison Pill）を修正 (詳細を見る) (PR #394)
    • 以前は、先頭行に永続的なバリデーションエラーがあるとバッチ全体が即座にクラッシュしていた
    • 各行を独立して処理し、エラーを蓄積してバッチ終了後に集約エラーをスローするよう修正
    • 有効な行は正常に保存、失敗行はSQSリトライをトリガー、成功済み行はEQUAL比較でスキップ（冪等性維持）
  • import: ImportQueueEventHandlerがSingleImportProcessorに生のSQSペイロードを渡していた問題を修正 (PR #394)
    • singleImportProcessor.process()にevent.payload（生のSQSペイロード）ではなくevent.importEvent（パース済みオブジェクト）を渡すよう修正

1.2.2 (2026-04-08)​

新機能​

  • import: SQS統合と親ジョブカウンタートラッキングでインポート処理を強化 (PR #387)
    • ImportQueueEventHandlerが分散処理のためにサブジョブイベントをSQSにパブリッシュするようになりました
    • 子ジョブがエンキューされたときに親ジョブカウンターが正しくインクリメントされるようになりました
  • import: CsvImportSfnEventHandlerがSUCCEEDEDとFAILEDの両方のStep Functions結果を処理するよう修正 (PR #387)

バグ修正​

  • core: extractInvokeContextで不正なJWTトークンを適切に処理するよう修正 (PR #388)
    • 破損または予期しないJWTペイロードによる認証失敗を防止

1.2.1 (2026-04-06)​

新機能​

  • core: SQSメッセージ操作のためのSqsServiceとSqsClientFactoryを追加 (詳細を見る) (PR #383)
    • sendMessage() — SQSキューへ単一メッセージを送信
    • sendMessageBatch() — 1回のAPIコールで最大10件のメッセージを送信
    • receiveMessages() — MaxNumberOfMessages（デフォルト: 10）とWaitTimeSeconds（デフォルト: 0）を設定可能なメッセージ受信
    • deleteMessage() — 処理済み単一メッセージの確認・削除
    • deleteMessageBatch() — 1回のAPIコールで最大10件のメッセージを削除
    • SqsServiceはQueueModule（グローバル）に登録され、アプリケーション全体でインジェクション可能
    • システム属性受信のためのMessageSystemAttributeNamesをサポート（廃止済みのAttributeNamesは非公開）
  • core: SnsClientFactoryをシングルトンSNSClientインスタンス方式にリファクタリング (PR #383)
    • 以前はトピックARNごとに個別クライアントをキャッシュしていたが、全publishコールでシングルインスタンスを共有するように変更
    • getClient()のシグネチャがgetClient(topicArn: string)からgetClient()に変更

1.2.0 (2026-04-02)​

破壊的変更​

  • core: publishSync()とpublishPartialUpdateSync()がコマンドに変更がない場合（no-op）にnullを返すように変更 (詳細を見る) (PR #375)
    • 戻り値の型がPromise<CommandModel>からPromise<CommandModel | null>に変更
    • publishAsync()およびpublishPartialUpdateAsync()の既存の挙動に統一
    • 移行方法: 戻り値のプロパティにアクセスする前にnullチェックを追加

新機能​

  • core: SessionServiceとRepositoryによるRead-Your-Writes（RYW）一貫性を追加 (詳細を見る) (PR #375)
    • publishAsync後、DynamoDB Streamの同期が完了する前でも同一ユーザーの後続読み取りがペンディングコマンドデータを返すように
    • オプトイン: RYW_SESSION_TTL_MINUTES環境変数を設定して有効化（例: 5）
    • CommandModule / @mbc-cqrs-serverless/coreからRepositoryクラスをエクスポート — getItem・listItemsByPk・listItemsでRYWマージを提供
    • セッションテーブル{NODE_ENV}-{APP_NAME}-sessionを作成する必要あり（dynamodbs/session.json参照）
    • RYW_SESSION_TTL_MINUTES未設定時は無効 — 既存プロジェクトへの影響なし
  • mcp-server: v1.2.0破壊的変更向けのAP013・AP014アンチパターン検出を追加 (PR #377)
    • AP013: nullチェックなしでpublishSync/publishPartialUpdateSyncの戻り値を使用するパターンを検出
    • AP014: 廃止されたgenNewSequence()の使用を検出
    • migration_guideプロンプトにv1.2.0セクションを追加
  • 両方の破壊的変更の詳細なアップグレード手順については、マイグレーションガイド v1.2.0を参照してください。

バグ修正​

  • import: ZIPオーケストレーターのインポートステータス処理を修正 (PR #370)
    • ImportStatusHandlerがジョブ失敗時にimportJobStatusを含むタスク成功を送信するように修正
    • ZipImportSfnEventHandlerがCSVタスクの失敗数を集計し最終ジョブステータスを調整

1.1.6 (2026-03-30)​

バグ修正​

  • import: ZIPオーケストレーターのインポートステータス処理を修正 (PR #371) (v1.2.0からのバックポート)
    • ImportStatusHandlerがジョブ失敗時にimportJobStatusを含むタスク成功を送信するように修正
    • ZipImportSfnEventHandlerがCSVタスクの失敗数を集計し最終ジョブステータスを調整

1.1.5 (2026-03-28)​

新機能​

  • import: 大規模CSVインポート向けv2バッチ処理アーキテクチャを実装 (詳細を見る) (PR #366)
    • 行ごとのimport_tmp書き込みをLambda内直接コマンドパブリッシュに置き換え、Hot Partitionボトルネックを解消
    • Distributed MapをMaxItemsPerBatch: 100・MaxConcurrency: 50に設定し、スループットを大幅向上
    • 新しいfinalize_parent_jobステートがバッチサマリーを集約し、DynamoDB UpdateItemを1回だけ呼び出して最終ステータスを書き込む
    • CommandFinishedHandlerから行ごとのアトミックカウンター更新を削除し、大規模時のDynamoDBスロットリングを解消
    • ImportEntityProfileにImportPublishModeenum（SYNC / ASYNC）を追加し、エンティティごとのパブリッシュモード設定を可能に
    • 空のprocessingResultsガードを追加: バッチ結果が受信されない場合はジョブをFAILEDとしてマーク

破壊的変更​

  • import: CSVインポートでリアルタイムの行レベル進捗追跡が廃止 (詳細を見る)
    • processedRows・succeededRows・failedRowsカウンターはStep Functions実行完了時に一括集計されるように変更
    • 個別のCSV行はimport_tmp DynamoDBテーブルに書き込まれなくなった
    • import-csvステートマシンに新しいfinalize_parent_jobステートとresultPath: '$.processingResults'が必要 — CDKとserverless.ymlをこのパッケージと同時に更新すること

テスト​

  • ImportQueueEventHandlerのSYNC/ASYNCルーティングテストを追加（EQUAL/NOT_EXIST/CHANGED × SYNC/ASYNC + フォールバックの6テストケース）
  • CsvImportSfnEventHandlerの空processingResultsガードテストを追加
  • バッチ集計テストを追加（1,000 + 500行、COMPLETEDおよびFAILEDシナリオ）

1.1.4 (2026-03-27)​

新機能​

  • core: publishSyncの監査証跡とHistoryテーブルの一致を復元 (詳細を見る) (PR #363)
    • publishSyncがstatus: 'publish_sync:STARTED'とsyncMode: 'SYNC'でCommandテーブルに不変イベントを書き込むように
    • publishSyncがHistoryテーブルに書き込むようになり、非同期Step Functionsパイプラインと一致
    • コマンドライフサイクルがpublish_sync:STARTED → finish:FINISHED（エラー時はpublish_sync:FAILED）に
    • publishAsyncからisNotCommandDirty早期リターン最適化を移植 — 変更なしの場合はnullを返す
    • DynamoDB Streamフィルターを更新しsyncMode=SYNCレコードを除外、Step Functionsの二重実行を防止
    • DefaultEventFactoryもローカル開発環境向けにsyncMode=SYNCレコードをフィルタリング

テスト​

  • publishSyncの監査証跡とHistory一致の包括的なテストを追加

1.1.3 (2026-03-24)​

バグ修正​

  • import: CSVインポートのDistributed Mapステート結果が256KB制限を超える問題を修正 (詳細を見る) (PR #348)
    • Distributed MapにresultPath: DISCARDを設定し、子実行結果がステートデータに集約されることを防止
    • CsvImportSfnEventHandlerからMapResult依存を削除し、代わりにS3からcountCsvRows()を使用
    • S3ストリームが読み取れない場合のエラーハンドリングを追加

CI/CD​

  • npm OIDC trusted publishingに切り替え、NPM_TOKENシークレットへの依存を排除 (PR #357)
    • 組み込みOIDCサポートのためlernaをv8からv9にアップグレード
    • publishジョブにid-token: writeパーミッションを追加
    • Node 22+互換性のためlockfile同期ステップを追加

テスト​

  • CsvImportSfnEventHandlerのfinalize_parent_jobロジックの包括的なテストを追加
    • failedRows > 0の場合のFAILEDステータスをテスト
    • 全行成功時のCOMPLETEDステータスをテスト
    • 処理が未完了の場合にステータスが更新されないことをテスト
    • S3ストリームが読み取れない場合のエラーハンドリングをテスト

1.1.2 (2026-02-25)​

新機能​

  • master: マスター設定とデータのビルトインupsertメソッドを追加 (詳細を見る)
    • MasterSettingService用のupsertTenantSetting()、upsertSetting()、upsertBulk()
    • MasterDataService用のupsert()、upsertSetting()、upsertBulk()
    • 新規レコードの作成、変更レコードの更新、未変更レコードのスキップを自動的に行う
    • ソフト削除されたレコードの再作成をサポート
  • master: 統合バルクupsert API（/api/master-bulk/）を追加 (詳細を見る)
    • 設定とデータの両方を処理する単一エンドポイント
    • settingCodeフィールドの有無でアイテムをルーティング
    • レスポンスで元の入力順序を保持
    • テナントコードバリデーションを適用
  • master: すべてのバルクDTOに@ArrayMaxSize(100)バリデーションを追加
  • master: 個別のバルクエンドポイント（/api/master-setting/bulk、/api/master-data/bulk）にテナントコードバリデーションを追加

バグ修正​

  • core: checkVersionのエラーメッセージが実際のcommandVersionではなくハードコードされた値を使用していた問題を修正 (PR #331)
  • master: createSettingでseq === 0がfalsyとして扱われる問題をnullチェック（seq == null）に変更して修正
  • master: createSettingでseq変更前にattributesをクローンしてDTOミューテーションを修正

テスト​

  • MasterBulkControllerの包括的なユニットテストを追加（8テストケース）
  • MasterDataServiceのupsertおよびupsertBulkメソッドのユニットテストを追加
  • MasterSettingServiceのupsertTenantSettingおよびupsertBulkメソッドのユニットテストを追加
  • マスターデータと設定のupsertシナリオの統合テストを追加

1.1.1 (2026-02-07)​

バグ修正​

  • cli: 不足していたimport_tmp.json DynamoDBテーブルテンプレートを追加 (詳細を見る) (PR #323)
    • CLIテンプレートにimport_tmpテーブル定義が含まれておらず、npm run offline:slsが失敗していました
    • serverless.ymlが参照するLOCAL_DDB_IMPORT_TMP_STREAM環境変数は、マイグレーション時にテーブルが作成される必要があります
    • 以前のバージョンを使用している場合の回避策はよくある問題を参照

1.1.0 (2026-02-03)​

破壊的変更​

  • tenant: TENANT_COMMONのenum値を'COMMON'から'common'（小文字）に変更
    • この変更はパーティションキーのフォーマットに影響します: TENANT#COMMON → TENANT#common
    • マイグレーション必須: TENANT#COMMONパーティションキーを持つ既存データの移行が必要です
    • 詳細な手順はマイグレーションガイドを参照してください
  • core: 非推奨のCommandService.publish()メソッドを削除 (詳細を見る)
    • 代わりにCommandService.publishAsync()を使用してください
  • core: 非推奨のCommandService.publishPartialUpdate()メソッドを削除
    • 代わりにCommandService.publishPartialUpdateAsync()を使用してください
  • sequence: 非推奨のSequencesService.genNewSequence()メソッドを削除
    • 代わりにSequencesService.generateSequenceItem()を使用してください

新機能​

  • core: 大文字小文字を区別しないマッチングのためのテナントコード正規化を追加 (詳細を見る)
    • テナントコードは自動的に小文字に正規化されるようになりました
    • getUserContext()は正規化されたテナントコードを返します
    • すべてのDynamoDB操作は一貫性のため正規化されたテナントコードを使用します
  • core: 明示的な正規化のためのnormalizeTenantCode()ユーティリティ関数を追加
  • core: 共通テナント検出のためのisCommonTenant()ユーティリティ関数を追加
  • core: AWS SESメールのカテゴリ分けとフィルタリング用EmailTagsサポートを追加 (詳細を見る)
    • EmailNotificationインターフェースに新しいemailTagsオプション
    • タグはSESに渡されメールのカテゴリ分けとトラッキングに使用
  • core: RolesGuardに拡張可能なテナント検証を追加 (詳細を見る)
    • isHeaderOverride(): ヘッダーベースのテナントオーバーライドを検出
    • canOverrideTenant(): クロステナントアクセスの権限をチェック
    • getCommonTenantCodes(): 設定可能な共通テナントリスト
    • getCrossTenantRoles(): 設定可能なクロステナントロール（デフォルト: 'system_admin'）
  • cli: スキル更新用のnpmレジストリバージョンチェックを追加
    • ローカルのpackage.jsonではなくnpmレジストリから最新バージョンを取得
    • ネットワークリクエストを削減するための24時間キャッシュ
    • オフライン時はキャッシュバージョンにフォールバック

セキュリティ​

  • core: テナントコードヘッダーオーバーライドをシステム管理者のみに制限
    • 以前はcustom:tenant Cognito属性のないユーザーがヘッダー経由で任意のテナントを指定可能でした
    • 現在はグローバルsystem_adminロールを持つユーザーのみがx-tenant-codeヘッダーでテナントコードをオーバーライド可能
    • 一般ユーザーはCognitoでcustom:tenantを設定する必要があります

バグ修正​

  • master: MasterSettingServiceとMasterDataServiceでのTENANT_COMMON定数の使用を修正
    • 以前ハードコードされていた'COMMON'文字列はSettingTypeEnum.TENANT_COMMONを使用するようになりました
    • フレームワーク全体で一貫したパーティションキー生成を保証

テスト​

  • tenant: TenantServiceメソッドの包括的なテストを追加
    • getTenant(): 取得テスト
    • updateTenant(): 更新と属性マージテスト
    • deleteTenant(): ソフト削除テスト
    • addTenantGroup(): グループ管理テスト
    • customizeSettingGroups(): 設定カスタマイズテスト
    • createTenantGroup(): テナントグループ作成テスト
  • tenant: SettingTypeEnum検証テストを追加
    • TENANT_COMMON = 'common'（小文字）を検証
    • enumの完全性と一貫性を保証
  • core: テナントコード正規化テストを追加（70件以上のテストケース）
  • core: テナント正規化コマンドテストを追加（30件以上のテストケース）
  • core: 包括的な依存関係統合テストを追加（3400以上のテスト）
    • AWS SDK統合テスト（DynamoDB、S3、SNS、SQS、Step Functions、SES）
    • NestJS動作テスト（デコレーター、設定、DI、Swagger）
    • サードパーティライブラリテスト（class-transformer、class-validator、RxJS）

ドキュメント​

  • v1.1.0テナントコード変更のマイグレーションガイドを追加

1.0.26 (2026-01-26)​

新機能​

  • cli: 環境変数によるローカルサービスポートの設定機能を追加 (詳細を見る) (PR #300)
    • LOCAL_HTTP_PORT、LOCAL_DYNAMODB_PORT、LOCAL_RDS_PORTなどのポート変数をサポート
    • 他のサービスとのポート競合を解決可能に
    • 設定はDocker Compose、Serverless Offline、トリガースクリプトに自動的に適用

セキュリティ​

  • セキュリティ修正のためdiffパッケージを4.0.2から4.0.4に更新 (PR #297, PR #299)
  • プロトタイプ汚染修正のためlodashパッケージを4.17.21から4.17.23に更新 (PR #298)

1.0.25 (2026-01-19)​

新機能​

  • core: 高度な変数置換によるインラインテンプレートメールの機能強化 (詳細を見る)
    • テンプレート変数のネストプロパティアクセスをサポート（例：二重波括弧プレースホルダーでの user.profile.name）
    • テンプレート変数でのUnicode/日本語キーのサポート
    • プレースホルダー内の空白トリミング（変数名前後のスペースを無視）
    • テンプレートコンパイルのローカル開発フォールバック機能の改善

1.0.24 (2026-01-17)​

新機能​

  • mcp-server: ガイド付き開発支援のためのClaude Code Skillsを追加 (詳細を見る)
    • /mbc-generate: ボイラープレートコードを生成（モジュール、サービス、コントローラー、DTO、ハンドラー）
    • /mbc-review: ベストプラクティスとアンチパターン（20パターン）のコードレビュー
    • /mbc-migrate: バージョン移行と破壊的変更のガイド
    • /mbc-debug: 一般的な問題のデバッグとトラブルシューティング
    • Skillsはnpmパッケージ経由で配布され、~/.claude/skills/または.claude/skills/にインストール可能
  • cli: 簡単なskillsインストールのためのmbc install-skillsコマンドを追加 (詳細を見る)
    • skillsを個人ディレクトリ（~/.claude/skills/）またはプロジェクトディレクトリ（.claude/skills/）にインストール
    • オプション: --project, --force, --list

バグ修正​

  • core: パラメータ名のタイポを修正：skExpessionをskExpressionに
    • 影響するパッケージ: core, directory, master, task, ui-setting
    • これは古いパラメータ名を参照していたTypeScriptユーザーにとっては破壊的変更でした

1.0.23 (2026-01-16)​

新機能​

  • core: インラインテンプレートメールサポートとsendInlineTemplateEmail()メソッドを追加 (詳細を見る)
    • EmailServiceに新しいsendInlineTemplateEmail(msg: TemplatedEmailNotification)メソッド
    • 動的データ置換によるインラインHTML/テキストテンプレートのサポート
    • SESが利用できない場合の手動テンプレートコンパイルによるローカル開発フォールバック
    • 新しいインターフェース: InlineTemplateContent, TemplatedEmailNotification

1.0.22 (2026-01-16)​

新機能​

  • mcp-server: AI支援開発のためのコード分析ツールを追加 (詳細を見る)
    • mbc_check_anti_patterns: 重大度レベル付きでコード内の一般的なアンチパターンを検出
    • mbc_health_check: プロジェクトヘルスチェック（依存関係、構造、設定）
    • mbc_explain_code: MBC CQRSコンテキストでコードを分析・説明

バグ修正​

  • mcp-server: コード分析ツールの堅牢性を向上
    • アンチパターンを連番で再採番（AP001-AP010）
    • 誤検出を防ぐため正規表現のマッチ範囲を制限
    • ファイル読み取りとJSON解析のエラーハンドリングを追加
    • 分析ツールに18のユニットテストを追加

セキュリティ​

  • 依存関係のセキュリティ脆弱性を修正: qs, express, body-parser

依存関係​

  • qsを6.13.0から6.14.1に更新
  • @nestjs/platform-expressを10.4.20から10.4.22に更新
  • expressを4.21.2から4.22.1に更新
  • body-parserを1.20.3から1.20.4に更新

1.0.21 (2026-01-15)​

新機能​

  • import: ImportModuleにZIPファイナライゼーションフックのサポートを追加
    • カスタムインポート後処理用の新しいIZipFinalizationHookインターフェース
    • ImportModule.register()のzipFinalizationHooksオプションでフックを登録
    • フックは結果、ステータス、実行入力を含むZipFinalizationContextを受け取る

1.0.20 (2026-01-11)​

バグ修正​

  • import: Step Functions CSVハンドラーが子ジョブの失敗に関わらず常にCOMPLETEDステータスを設定する問題を修正
    • CsvImportSfnEventHandler.finalizeParentJob()を修正し、子ジョブが失敗した場合に正しくFAILEDステータスを設定
    • csv_loaderステートのCsvImportSfnEventHandlerを修正し、失敗を伴う早期終了時に正しくステータスを設定
    • 以前は三項演算子が両方のケースでCOMPLETEDを返していました: failedRows > 0 ? COMPLETED : COMPLETED
    • failedRows > 0の場合、正しくFAILEDを返すように修正: failedRows > 0 ? FAILED : COMPLETED
    • このバグにより、子インポートジョブが失敗してもStep FunctionsがSUCCESSを報告していました
    • 詳細はCsvImportSfnEventHandlerを参照

1.0.19 (2026-01-11)​

バグ修正​

  • import: 子インポートジョブが失敗した際にマスタージョブのステータスがFAILEDに更新されない問題を修正
    • 以前は、子インポートジョブがConditionalCheckFailedExceptionなどのエラーで失敗した場合、マスタージョブのステータスが無期限にPROCESSINGのままでした
    • incrementParentJobCountersを修正し、子ジョブが失敗した場合にマスタージョブのステータスを正しくFAILEDに設定（以前は常にCOMPLETEDを設定）
    • ImportQueueEventHandler.handleImportがエラー時にincrementParentJobCountersを呼び出すように修正し、親カウンターが更新されることを保証
    • エラーハンドラーからthrow errorを削除し、Lambdaのクラッシュを防ぎ、適切なステータス伝播を可能に
    • この修正はv1.0.18で開始したStep Functionsエラーハンドリングを完成させ、SendTaskFailureが適切にトリガーされることを保証
    • 詳細はImportQueueEventHandlerエラーハンドリングを参照

1.0.18 (2026-01-10)​

バグ修正​

  • import: Step Functionsの適切なエラーハンドリングのため、ImportStatusHandlerにSendTaskFailureサポートを追加
    • 以前は、インポートジョブが失敗した際、SendTaskSuccessのみ実装されていたため、Step Functionが無期限に待機していました
    • ジョブが失敗した際にハンドラーが適切にSendTaskFailureを送信し、Step Functionsがエラーを正しく処理できるようになりました
    • SendTaskFailureCommandを送信するsendTaskFailure()メソッドを追加
    • ハンドラーがCSVインポートジョブのCOMPLETEDとFAILEDの両方のステータスを処理するようになりました
    • 詳細はImportStatusHandler APIを参照

1.0.17 (2026-01-08)​

バグ修正​

  • master: MasterDataService.search()のmasterTypeCode比較を修正 - settingCode検索パラメータを部分一致（contains）から完全一致に変更 (詳細を見る)
  • cli: setTimeoutを削除してAbstractRunnerテストを安定化し、CIの不安定なテスト失敗を修正

セキュリティ​

  • 依存関係のセキュリティ脆弱性を修正: jws (HMAC署名検証の問題), nodemailer (DoS脆弱性)

依存関係​

  • validatorを13.15.20から13.15.26に更新
  • @modelcontextprotocol/sdkを1.25.1から1.25.2に更新

ドキュメント​

  • すべてのパッケージのREADMEファイルを包括的なAPIリファレンスと使用例で更新
  • tenantパッケージのREADMEでcreateTenantGroupパラメータ名を修正
  • 日本語ガイドのリンクを公式ドキュメントに更新

1.0.16 (2025-12-31)​

バグ修正​

  • cli: テスト生成ファイルのクリーンアップを追加し、.gitignoreを更新
  • master, directory, task, cli: エラーメッセージを改善してわかりやすく

新機能​

  • インポート作成時のattributesに__s3Keyを含める
  • Zipモードでテーブル名を提供
  • CreateImportDtoにオプションのs3Keyを追加

1.0.15 (2025-12-31)​

バグ修正​

  • ui-setting: エラーメッセージを改善してわかりやすく
  • mcp-server: ERROR_CATALOG.mdの検索にMBC_PROJECT_PATHを使用

1.0.14 (2025-12-29)​

新機能​

  • mcp-server: AIツール統合用のMCPサーバーパッケージを追加

ドキュメント​

  • 包括的なエラーメッセージカタログを追加
  • コアインターフェースにJSDocコメントを追加
  • 運用ドキュメント（FAQ、トラブルシューティング、セキュリティ）を追加
  • AI対応ドキュメントファイルを追加

1.0.13 (2025-12-26)​

新機能​

  • CreateZipImportDtoとZipImportQueueEventHandlerを強化

1.0.12 (2025-12-23)​

バグ修正​

  • TenantServiceでテナント属性をマージ

1.0.11 (2025-12-22)​

バグ修正​

  • SequencesServiceで不明なソースIPを処理

1.0.10 (2025-11-28)​

バグ修正​

  • TenantServiceのcreateTenantGroupメソッドを修正

1.0.9 (2025-11-26)​

バグ修正​

  • Node.js 24互換性のためLambdaハンドラーからコールバックパラメーターを削除

1.0.8 (2025-11-17)​

セキュリティ​

  • セキュリティ修正のためjws依存関係を更新

1.0.7 (2025-11-07)​

セキュリティ​

  • サンプルのvalidator依存関係を更新
  • セキュリティ修正のためjs-yaml依存関係を更新

1.0.6 (2025-11-05)​

新機能​

  • master: MasterDataCreateDtoにtenantCodeサポートを追加し、サービスロジックを更新

1.0.5 (2025-11-04)​

新機能​

  • master: DTOとサービスロジックにtenantCodeサポートを追加してマスター設定を強化

1.0.4 (2025-10-29)​

新機能​

  • core: ブートストラップと環境検証に設定可能なリクエストボディサイズ制限を追加
  • master: マスターデータと設定のバルク作成エンドポイントを追加

依存関係​

  • validatorを13.11.0/13.12.0から13.15.20に更新
  • multerを1.4.4-lts.1から2.0.2に、@nestjs/platform-expressを10.4.4から10.4.20に更新
  • CLIテンプレートでaxiosを1.7.7から1.13.1に更新

1.0.3 (2025-10-23)​

新機能​

  • master: マスターデータと設定のバルク作成エンドポイントを追加し、効率向上のためのバッチ操作を実現

1.0.2 (2025-10-16)​

新機能​

  • survey: サーベイテンプレート管理用のサーベイテンプレートAPIを追加

依存関係​

  • /examples/masterで@nestjs/commonを10.3.0から10.4.16に更新
  • /examples/seqでmulterを1.4.4-lts.1から2.0.2に、@nestjs/platform-expressを10.4.15から10.4.20に更新
  • @nestjs/cliを10.4.5から11.0.10に、inquirerを8.2.6から8.2.7に更新

1.0.1 (2025-09-19)​

新機能​

  • import: インポートモジュールにzipモードサポートを追加し、圧縮ファイルのインポートを実現

1.0.0 (2025-09-18)​

ハイライト​

  • 初の安定版プロダクションリリース
  • ベータ版0.1.74がベース

ベータリリース (0.1.x)​

0.1.75-beta.0​

バグ修正​

  • import: Step Functionsの適切なエラーハンドリングのため、ImportStatusHandlerにSendTaskFailureサポートを追加
    • 以前は、インポートジョブが失敗した際、SendTaskSuccessのみ実装されていたため、Step Functionが無期限に待機していました
    • ジョブが失敗した際にハンドラーが適切にSendTaskFailureを送信し、Step Functionsがエラーを正しく処理できるようになりました
    • SendTaskFailureCommandを送信するsendTaskFailure()メソッドを追加
    • ハンドラーがCSVインポートジョブのCOMPLETEDとFAILEDの両方のステータスを処理するようになりました
    • 詳細はImportStatusHandler APIを参照

0.1.74-beta.0 (2025-08-25)​

新機能​

  • インポートモジュールの実装
  • インポートモジュール用のインフラ更新
  • インポートモジュール用のローカルインフラ更新

0.1.73-beta.0 (2025-07-31)​

バグ修正​

  • master: パッケージインストールの問題を修正

0.1.72-beta.0 (2025-07-24)​

新機能​

  • マスターデータと設定の大文字小文字を区別しない検索を追加

0.1.71-beta.0 (2025-07-18)​

バグ修正​

  • CIをブロックしていたコアパッケージのテスト失敗を修正
  • GitHubワークフローの問題を修正
  • Step Function名の長さ制限を処理
  • StepFunctionServiceの実行名長さバリデーション

新機能​

  • CLIパッケージの包括的なテスト強化
  • コアパッケージサービスのユニットテスト強化
  • コントローラーの包括的なユニットテストを実装
  • マスターパッケージサービスのユニットテスト強化
  • シーケンスサービスのテスト強化
  • タスクサービスのユニットテスト強化
  • 不足していたサービスのユニットテストを実装
  • 高優先度パッケージのユニットテストを実装

0.1.70-beta.0 (2025-07-14)​

バグ修正​

  • master: マスター設定のユニットテストを修正
  • パッケージバージョンを更新

新機能​

  • master: テナントへのコピー機能を追加

0.1.69-beta.0 (2025-07-07)​

バグ修正​

  • master: ユニットテストを更新

新機能​

  • master: Prismaオプションを追加

0.1.68-beta.0 (2025-07-01)​

バグ修正​

  • ビルドライブラリCIを修正
  • インポートテンプレートマスターデータモジュールを更新

新機能​

  • テンプレートマスターAPIを追加

0.1.67-beta.0 (2025-06-10)​

新機能​

  • EmailServiceを添付ファイルサポートに拡張

0.1.65-beta.0 (2025-05-19)​

バグ修正​

  • 空のAppSync URL問題を修正
  • テストAppSync URLを修正

新機能​

  • 2番目のAppSyncサポートを追加

0.1.58-beta.0 (2025-04-24)​

バグ修正​

  • マスターデータアイテムからのフォーマットシーケンス取得を修正

0.1.55-beta.0 (2025-02-14)​

新機能​

  • Node 20ランタイムを使用するようテンプレートを更新

0.1.53-beta.0 (2025-02-12)​

新機能​

  • タスク処理用のキューとStep Functionを追加
  • Step Functionによるタスク処理

0.1.51-beta.0 (2025-01-17)​

バグ修正​

  • 説明テキストを修正

新機能​

  • ロガーを追加
  • スキーマティック説明を追加
  • コントローラー生成用スキーマティックを追加
  • DTO、サービス、エンティティ生成用スキーマティックを追加
  • モジュール生成用スキーマティックを追加

0.1.50-beta.0 (2025-01-14)​

バグ修正​

  • シリアライズヘルパーのエンティティフィールド処理を修正

新機能​

  • 内部/外部構造変換用のシリアライズヘルパー関数を追加

関連ドキュメント​

関連リンク​