MENU

Microsoft developer platform更新：@typescript-eslint/eslint-plugin 8.59.2の変更点と確認ポイント

Microsoft

2026年5月5日のMicrosoft developer platform関連更新で確認すべきポイントは、Microsoftのagent-governance-toolkit内にあるmcp-serverの開発用依存関係が、@typescript-eslint/eslint-plugin 8.59.1から8.59.2へ更新されたことです。これはアプリ本体の機能追加ではなく、TypeScript向けESLintルールのパッチ更新です。対応の優先度は高すぎませんが、CIでlintを必須にしているチーム、no-deprecatedやno-unsafe-type-assertionを使っているチーム、同リポジトリをforkしている開発者は、lint結果と依存バージョンの整合性を確認しておくべきです。(GitHub)

目次

Microsoft developer platform documentation updateで何が変わったのか

今回の「Microsoft developer platform documentation update: build(deps-dev): Bump @typescript-eslint/eslint-plugin from 8.59.1 to 8.59.2 in /agent-governance-python/agent-os/extensions/mcp-server」は、Dependabotによる開発用パッケージ更新です。

Microsoftのagent-governance-toolkitリポジトリで、agent-governance-python/agent-os/extensions/mcp-server/package.json内のdevDependenciesが変更されました。差分は@typescript-eslint/eslint-pluginのバージョンを8.59.1から8.59.2へ上げる内容で、GitHub上では1ファイル、1行追加・1行削除の小さな変更として表示されています。(GitHub)

確認項目内容
更新日2026年5月5日
対象リポジトリmicrosoft/agent-governance-toolkit
対象パスagent-governance-python/agent-os/extensions/mcp-server
変更ファイルpackage.json
変更された依存関係@typescript-eslint/eslint-plugin
変更前8.59.1
変更後8.59.2
種別direct:developmentのパッチ更新
PRの状態mainブランチへマージ済み

重要なのは、この更新が本番実行時のライブラリ更新ではなく、開発・検証・CIで使われるlint関連の更新である点です。したがって、通常はユーザー向け機能やAPIの動作が直接変わるものではありません。ただし、lintをビルド条件にしている場合は、警告やエラーの出方が変わることでCI結果に影響する可能性があります。

8.59.2の主な修正内容

@typescript-eslint/eslint-plugin 8.59.2では、主にESLintルールまわりの不具合が修正されています。公式リリースでは、no-unsafe-type-assertion、no-deprecated、rule-testerに関する修正が挙げられています。(GitHub)

修正対象変更の意味開発現場での見方
no-unsafe-type-assertion再帰的なテンプレートリテラル型を扱う際のクラッシュ修正複雑な型定義を含むプロジェクトでlintが落ちにくくなる可能性がある
no-deprecatedオブジェクト分割代入の値を宣言として扱う修正非推奨APIの検出結果が一部変わる可能性がある
rule-testerTypeScriptをpeer dependencyとして追加ESLintカスタムルールのテスト環境で依存関係を確認する必要がある

今回の更新はパッチバージョンですが、「何も確認しなくてよい」という意味ではありません。ESLintルールはコードを実行しなくてもCIを失敗させることがあるため、依存更新後は最低限、lintとテストの再実行が必要です。

対応すべき人と優先度

今回のMicrosoft developer platform関連更新で対応が必要になるかどうかは、agent-governance-toolkitをどの立場で利用しているかによって変わります。

対象者対応優先度確認すべきこと
agent-governance-toolkitをforkしている開発者高自分のforkにも同じ依存更新を取り込むか、CIでlintが通るか
mcp-server配下を改修している開発者高package.json、lockfile、ESLint設定の整合性
CI/CDを管理している担当者中〜高lintジョブ、依存関係チェック、セキュリティスキャンの結果
TypeScriptのESLint設定を流用しているチーム中@typescript-eslint/parserやeslintとの組み合わせ
アプリ利用者・非開発者低原則として直接対応は不要

特に注意したいのは、@typescript-eslint/eslint-pluginだけを見て判断しないことです。TypeScript向けESLint環境では、@typescript-eslint/parser、eslint、typescript、Node.jsのバージョンが組み合わさって動きます。typescript-eslintの公式ドキュメントでも、対応するESLintやNode.jsのバージョン範囲が案内されています。(TypeScript ESLint)

影響範囲は「開発時の品質チェック」が中心

この更新はdevDependenciesの変更です。一般的には、本番環境で動くアプリケーションコードや公開APIに直接影響する変更ではありません。

ただし、次のようなケースでは実務上の影響があります。

  • CIでnpm run lintやeslint .を必須にしている
  • @typescript-eslint/no-deprecatedを有効にしている
  • @typescript-eslint/no-unsafe-type-assertionを有効にしている
  • 型情報を使うESLintルールを有効にしている
  • ESLintのカスタムルールやRuleTesterを使っている
  • Dependabotの更新を自動マージしている

ESLintは「コード品質チェックの道具」ですが、CIに組み込むとビルド可否を左右します。小さなパッチ更新でも、検出ロジックが修正されると「これまで通っていたコードが警告される」「逆にクラッシュしていたlintが通る」といった変化が起こり得ます。

no-deprecatedを使っている場合の確認ポイント

no-deprecatedは、@deprecatedとしてマークされたコードの利用を検出するルールです。typescript-eslintの公式ドキュメントでは、このルールは型情報を必要とし、非推奨とマークされたコード参照を報告するものと説明されています。(TypeScript ESLint)

今回の8.59.2では、オブジェクト分割代入の値の扱いに関する修正が含まれています。そのため、次のようなコードを多用しているプロジェクトでは、lint結果の変化を確認しておくと安全です。

const { oldMethod } = sdkClient;

oldMethod();

たとえばoldMethodがライブラリ側で@deprecated扱いになっている場合、分割代入後の参照がどのように検出されるかが重要になります。今回の修正で、非推奨APIの検出がより期待に近づく可能性があります。

実務では、単にルールを無効化するのではなく、次の順で対応するのがおすすめです。

状況推奨対応
本当に非推奨APIを使っている代替APIへ移行する
一時的に使わざるを得ないコメントで理由を残し、例外設定や期限を管理する
誤検知の可能性がある最小コードで再現確認し、依存バージョンと設定を確認する
大量に警告が出る影響範囲を一覧化し、優先度順に置き換える

「lintが増えたからルールを切る」は短期的には楽ですが、非推奨APIの放置につながります。特にMicrosoft developer platform関連のツールや拡張機能では、APIや依存関係の更新に追従しやすい状態を保つことが重要です。

no-unsafe-type-assertionを使っている場合の確認ポイント

no-unsafe-type-assertionは、型を狭める危険な型アサーションを禁止するルールです。公式ドキュメントでは、型ガードを使う方が実行時エラーの回避につながると説明されています。(TypeScript ESLint)

今回の修正では、再帰的なテンプレートリテラル型を扱う場面でのクラッシュが改善されています。MCPサーバーのように、ツール定義、スキーマ、ルーティング、イベント名などを型で厳密に表現するコードでは、テンプレートリテラル型が使われることがあります。

次のような複雑な型を扱っている場合は、lint実行時の安定性を確認してください。

type ToolName<T extends string> = `tool:${T}`;

type NestedRoute<T extends string> =
  T extends `${infer Head}/${infer Tail}`
    ? `${ToolName<Head>}/${NestedRoute<Tail>}`
    : ToolName<T>;

このような型定義自体が問題というわけではありません。確認すべきなのは、ESLintが型情報を解析する過程でクラッシュしないか、不要な例外設定を残していないかです。

移行時に確認すべき手順

自分のリポジトリやforkで同様の更新を取り込む場合は、以下の順で確認すると失敗しにくくなります。

| 手順 | 作業 | 目的 |
| -: | ——————- | —————————————— |
| 1 | 対象ディレクトリへ移動する | 影響範囲をmcp-server配下に絞る |
| 2 | 依存関係をクリーンインストールする | lockfileとの不整合を検出する |
| 3 | ESLint関連のバージョンを確認する | plugin、parser、eslint、typescriptの組み合わせを把握する |
| 4 | lintを実行する | 警告・エラー・クラッシュの有無を確認する |
| 5 | テストを実行する | RuleTesterや型関連テストへの影響を確認する |
| 6 | CI結果を見る | ローカルとCI環境の差を確認する |

npmを使っている場合の確認例は次のとおりです。実際のscript名はプロジェクトのpackage.jsonに合わせて読み替えてください。

cd agent-governance-python/agent-os/extensions/mcp-server

npm ci

npm ls @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint typescript

npm run lint

npm test

npm ciで失敗する場合は、package.jsonとlockfileの整合性が崩れている可能性があります。自分のプロジェクトにlockfileがある場合は、npm install、yarn install、pnpm installなど、利用しているパッケージマネージャーに合わせてlockfileを更新し、差分を確認してください。

@typescript-eslint/parserとのバージョン差にも注意する

今回のPRでは、@typescript-eslint/eslint-pluginが8.59.2へ更新される一方で、該当するpackage.json上の@typescript-eslint/parserは8.59.1のまま表示されています。(GitHub)

これは必ずしも即時のエラーを意味するものではありません。ただし、typescript-eslintは各パッケージを同じバージョン番号で公開しているため、実務ではpluginとparserのバージョンをできるだけ揃える方が、調査や運用がしやすくなります。(TypeScript ESLint)

特に次のような場合は、parser側の更新も検討してください。

状況判断基準
lintで型解析エラーが出るparser、TypeScript、ESLintの組み合わせを確認する
CIとローカルで結果が違うNode.jsやlockfileの差分を確認する
custom ruleやRuleTesterを使っているテスト環境のpeer dependencyを確認する
Dependabot更新を自動マージしているpluginだけでなく関連パッケージの更新方針を決める

「パッチ更新だから必ず安全」と判断するのではなく、「小さい変更なので、短時間で確認して取り込む」と考えるのが現実的です。

セキュリティ面での見方

今回のPRでは、Dependency Reviewのコメントとして、脆弱性、ライセンス問題、OpenSSF Scorecard上の問題は検出されなかったことが表示されています。また、マージ時点で86件中84件のチェックが通過していたこともGitHub上で確認できます。(GitHub)

ただし、これは「自分の環境でも何も起きない」という保証ではありません。Microsoft側のリポジトリでのチェック結果と、自社・個人のfork環境は条件が異なる場合があります。

確認すべき差分は次の3つです。

確認対象見るべきポイント
Node.jsCIとローカルのバージョン差
package managernpm、Yarn、pnpmの違い
lockfile依存解決結果が再現できるか

特に、古いNode.jsや古いTypeScriptを使っているプロジェクトでは、typescript-eslintの対応範囲から外れている可能性があります。公式ドキュメントでは、サポート対象のESLint、Node.js、TypeScriptに関する考え方が案内されているため、長期運用しているリポジトリでは定期的に確認しておくとよいでしょう。(TypeScript ESLint)

よくある失敗と回避策

package.jsonだけ更新してlockfileを見落とす

依存関係の更新で最も多い失敗は、package.jsonだけを変更し、lockfileの整合性を確認しないことです。

ローカルでは動いても、CIでnpm ciを使っている場合、lockfileとpackage.jsonが一致していないとインストールに失敗することがあります。自分のリポジトリにpackage-lock.json、yarn.lock、pnpm-lock.yamlがある場合は、必ず差分を確認してください。

lintエラーを見てすぐルールを無効化する

no-deprecatedやno-unsafe-type-assertionで新しい指摘が出た場合、最初にやるべきことはルールの無効化ではありません。

まず、指摘されたコードが本当に危険なのか、非推奨APIを使っているのかを確認します。次に、修正できるものは修正し、例外が必要なものだけ理由を残して局所的に抑制します。

悪い例です。

/* eslint-disable @typescript-eslint/no-deprecated */

より現実的な例です。

// TODO: 2026-Q2中にnewClientへ移行する。
// 既存APIの互換性維持のため、この箇所のみ一時的に許容する。
legacyClient.oldMethod();

ルールをファイル全体で無効化すると、将来の問題まで見えなくなります。例外は範囲を狭くし、理由と期限を残すのが基本です。

type-aware lintの重さを不具合と決めつける

no-deprecatedやno-unsafe-type-assertionのような型情報を使うルールは、通常の構文チェックよりも処理が重くなります。typescript-eslintのドキュメントでも、型情報を必要とするルールにはパフォーマンス上のトレードオフがあることが説明されています。(TypeScript ESLint)

lint時間が急に伸びた場合は、次の順で切り分けてください。

確認具体的な見方
対象ファイルが広すぎないかdist、coverage、生成ファイルをlint対象から外す
tsconfigが適切かlint専用のtsconfig.eslint.jsonを使う
CIだけ遅いかキャッシュ、Node.jsバージョン、CPU条件を確認する
特定ルールだけ遅いかルール単位で一時的に切り分ける

自分のチームで更新を取り込む判断基準

今回の更新は、基本的には取り込みやすいパッチ更新です。ただし、次の条件に当てはまる場合は、通常より丁寧に確認してください。

判断条件
そのまま取り込みやすいlintとテストが通り、custom ruleや特殊な型定義を使っていない
追加確認が必要strict-type-checked系の設定を使っている
追加確認が必要no-deprecatedをエラー扱いにしている
追加確認が必要再帰的なテンプレートリテラル型や複雑な型ユーティリティを多用している
慎重に対応Node.js、ESLint、TypeScriptのバージョンが古い
慎重に対応Dependabot更新を自動マージしている

Microsoft developer platform関連のリポジトリ更新では、「変更が小さいか」だけでなく、「自分たちのCI品質ゲートに関係するか」を基準に見ると判断しやすくなります。

まず実行すべきチェックリスト

今回の更新を受けて、開発者がすぐに確認すべきことは次のとおりです。

  • agent-governance-python/agent-os/extensions/mcp-server/package.jsonで@typescript-eslint/eslint-pluginが8.59.2になっているか確認する
  • lockfileがある場合は、依存解決結果も更新されているか確認する
  • @typescript-eslint/parser、eslint、typescriptのバージョンを確認する
  • npm run lintなど、プロジェクトのlintコマンドを実行する
  • no-deprecatedとno-unsafe-type-assertionの警告差分を見る
  • custom ruleやRuleTesterを使っている場合はテストを実行する
  • CIのDependency Reviewやセキュリティスキャン結果を確認する

今回のMicrosoft developer platform documentation updateは、製品機能の大きな変更ではなく、TypeScript lint環境の安定性と検出精度に関わる小さな依存更新です。対応としては、慌ててコードを書き換えるよりも、まず対象ディレクトリで依存関係を再インストールし、lintとテストを通すことが重要です。CIが通り、警告差分が妥当であれば、通常の保守更新として取り込めます。

Microsoft
TypeScript ESLint Dependabot Microsoft developer platform agent-governance-toolkit

この記事を書いた人

佐藤健司のアバター 佐藤健司

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows／Office（Teams・Excel）からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

関連記事

コメント

コメントする

目次