update

目的

設定を再検証し、キャッシュをクリアし、すべての spec ファイルを再ダウンロードします。これはワークスペースの完全リフレッシュです — キャッシュされたすべての spec が最新であることを保証し、インデックスを再構築します。

使用するタイミング

• リモート spec ファイルが変更され、最新版が必要な場合
• swag2mcp.yaml を編集して spec の場所を追加または変更した後
• 古い、または破損したキャッシュをトラブルシューティングする場合
• mcp を実行する前にすべてが最新であることを確認する場合

構文

swag2mcp update [path]

引数

引数	位置	必須	説明
path	1	いいえ	ワークスペースディレクトリ。省略時はパス解決ルールに従います。

フラグ

なし。

仕組み

update コマンドは一連の操作を実行します：

1. 設定を読み込み — ワークスペースから swag2mcp.yaml を読み取ります
2. 検証 — validate と同じチェックを実行（YAML 構文、構造、spec ファイルの到達可能性、形式、認証、HTTP クライアント）
3. クリーン — cache/ と responses/ のすべての内容を削除します
4. 再キャッシュ — すべてのリモート spec ファイルをダウンロードし、ローカル spec ファイルをキャッシュにコピーします
5. 再インデックス化 — すべてのエンドポイントの全文検索インデックスを再構築します
6. 認証スクリプト — ScriptAuth を使用する spec のスタブ認証スクリプトを作成します
7. 孤立クリーンアップ — 存在しなくなった spec の認証スクリプトを削除します

swag2mcp update
swag2mcp update ./my-workspace

無効な collection の扱い

disable: true の collection は完全にスキップされます — キャッシュもインデックス化もされません。

コマンド実行後の確認

swag2mcp ls [path]
# すべての spec が引き続きリスト表示され、到達可能である必要があります

ニュアンス

• 自動初期化なし: 設定ファイルが存在しない場合、update はエラーを返します："configuration not found at <path>"。最初に init を実行してください。
• ネットワーク依存: すべてのリモート spec URL が到達可能である必要があります。ダウンロードが 1 つでも失敗すると、更新全体が明確なエラーメッセージとともに失敗します。
• 認証スクリプトの作成: spec が ScriptAuth を使用し、スタブスクリプトが存在しない場合、update が作成します。作成に失敗した場合、更新は失敗します。
• update と clean の違い: clean はキャッシュのみを削除します。update はキャッシュを削除してすべてを再ダウンロードします。単に容量を解放したい場合は clean を、リフレッシュしたい場合は update を使用してください。