cx-cli

cx-cli

すべての cx CLI コマンドに共通する動作です。

---

更新通知

cx コマンドを実行した後、以下のチャネルを優先順位順に確認し、更新通知がないか確認してください。新しいバージョンが利用可能な場合は、まずユーザーの依頼への回答を完了し、その後、最後に一度だけ更新について伝えてください。

更新通知には必ず2つの項目があります。バイナリのアップグレードとスキルの更新の両方のコマンドを提示してください。バージョン番号だけ、またはバイナリのアップグレードだけを伝えてはいけません。

1. 優先 — toon モード（-o toon）

--output toon を指定したコマンドは、標準出力に独立した末尾の JSON 行を追加します。

{"_meta":{"update":{"binary":{"current":"0.1.7","latest":"0.2.0","command":"brew upgrade cx"},"skills":{"command":"npx skills add coralogix/cx-cli/skills","docs":"https://github.com/coralogix/cx-cli#install"}}}}

標準出力の最終行で _meta.update を確認してください。存在する場合：

• バイナリのアップグレード：_meta.update.binary.command（現在：.binary.current、最新：.binary.latest）
• スキルの更新：_meta.update.skills.command

2. スキーマの起動時チェック

cx schema は、同じ _meta.update オブジェクトをスキーマ JSON のトップレベルに含めます（末尾の行ではありません）。同じ方法で _meta.update.binary と _meta.update.skills を確認してください。

3. フォールバック — 人が読めるテキスト

標準エラー出力と標準出力も確認し、プレーンテキストの通知がないか確認してください。バイナリとスキルの情報は、| で区切られた1行に表示されます。

[cx update] v0.2.0 available (you have 0.1.9) | upgrade: brew upgrade cx | skills: npx skills add coralogix/cx-cli/skills

TTY のテキストモードでは、同じ upgrade: ... | skills: ... の形式で2行に表示されます。

cx 0.2.0 is available (you have 0.1.9).
upgrade: brew upgrade cx | skills: npx skills add coralogix/cx-cli/skills

通常のコマンド実行後、テキスト／JSON モードでは標準エラー出力に表示されます。

回答テンプレート

[ここにコマンドの結果を要約]

---

cx の新しいバージョン（X.Y.Z）が利用可能です。現在のバージョンは A.B.C です。更新のために <binary upgrade command> と npx skills add coralogix/cx-cli/skills を実行しますか？

最後に短い1行だけ添えてください。同じセッション内の後続コマンドでは繰り返さないでください。

---

cx CLI の一般的なガイドライン

• 結果をプログラムで処理する場合は、機械可読な出力に常に --output toon を使用してください
• 利用可能なコマンドとそのフラグを確認するには cx schema を使用してください
• コマンドでは -p profile1 -p profile2 による複数プロファイルへのファンアウトがサポートされています
• Coralogix のデータを照会または管理するコマンドでは、--http-timeout <SECONDS> または CX_HTTP_TIMEOUT=<SECONDS> を使用して API リクエストの期限を設定してください。
• スクリプトで確認プロンプトを省略するには --yes を使用してください
• 変更のリスクなしに安全に調査するには --read-only を使用してください