コンテンツにスキップ

OWL リリースノート

このドキュメントでは、OWL CLI(owl)、OWL Registry(registry)、および両者が共有する共通ツールカタログの変更を記録します。

1.9.1(2026/11/20)

この OWL CLI hotfix は、CLI の自動更新後に旧版 Registry のツール引数と互換性がなくなる問題を修正します。

不具合修正

  • DQL の自動事前検査で、旧 checker に未定義の start_time、end_time を送信し、クエリが実行できなくなる問題を修正しました。CLI は最初に対象 Registry の checker schema を読み取ります。checker が時間コンテキストをサポートしない場合、owl exec は追加された自動時間検査をスキップし、元のクエリと時間引数を保持します。owl validate を明示的に実行した場合は、旧 schema に従って基本的な DQL 検証を行い、checker の結果を保持します。
  • CLI の引数準備と静的検証は、Registry が公開する schema に従います。省略された引数にのみ schema の既定値を適用します。システムツールと DPoP イベントの子呼び出しも、先にツール定義を確認します。ユーザーが指定した識別情報、フィルター、カーソル引数が未対応の場合はエラーを返し、リクエスト範囲の変更を防ぎます。
  • 同一組織のワークスペース一覧では、schema に定義された既定値と引数範囲を使用します。レスポンスにページサイズがない場合は、実際のリクエスト値を使用します。schema が許可する大きなページと、サーバーが返すカーソルによるページ送りをサポートします。

アップグレードと互換性に関する説明

  • この引数互換性の修正は、CLI を単独で更新して利用できます。DQL の構文と機能は、対象 Registry とお客様の環境にある dqlcheck によって決まります。checker が時間コンテキストをサポートする場合は時間検査を継続します。schema の取得や checker の実行に失敗した場合は、引き続きエラーを返します。
  • 業務ルールは Registry と上流サービスが検証します。owl validate の静的検証に成功しても、業務リクエストの成功を保証するものではありません。

1.9.0(2026/11/18)

新機能

  • owl login --dpop と owl logout を追加し、Studio の一時認証コードでログインし、DPoP 認証情報を取り消せるようにしました。CLI はローカルで秘密鍵を生成してリクエストに署名し、Agent は OWL_TEMP_CODE から一時コードを提供できます。
  • owl profile add <alias>:Studio の一時コードを使用して DPoP アカウントを追加します。--from はサイトおよび ID 以外の設定のみを提供します。複数のプロファイルの使用。
  • Registry は DPoP ログイン、取り消し、ツールリクエストの転送をサポートし、元の HTTPS URL と DPoP proof をバインドして署名したうえで、対応する AIAPI に渡します。Linux/macOS と Windows のインストーラーは、CLI がサポートしている場合に新しいログインフローを使用します。

不具合修正と改善

  • 標準 Registry イメージを固定 digest の Alpine 3.24 に更新し、brotli-libs>=1.2.1-r0 を要求するようにして、CVE-2026-111497 を修正しました。この項目は UOS イメージには該当しません。DPoP リクエストでは汎用の転送リトライを使用せず、有効な新しい nonce challenge の後に一度だけリトライします。

アップグレードと互換性に関する説明

  • 対象サイトの Studio/AIAPI と Registry が DPoP をサポートしていることを確認してから、共用インストールチャネルを更新してください。管理者は AIAPI の署名ターゲットと、それに一致する siteId を設定する必要があります(イメージでは OWL_AIAPI_SIGNING_SITE_ID を使用)。Ingress が TLS を終端する場合は aiapiSigning.dpopTrustedProxies を設定し、パスを書き換える場合は dpopUseOriginalURI を有効にし、Ingress で転送ヘッダーを上書きします。
  • 既存の API キープロファイルは引き続き使用できます。profile add と profile add --from では引き続き新しいアカウントの一時コードが必要で、ソースファイルの API キー、token_file、DPoP バインディングはコピーされません。旧スクリプトは OWL_TEMP_CODE を提供するように変更する必要があります。
  • DPoP 認証情報は、対象サイトがサポートする HTTP ツールでのみ使用でき、外部 MCP ツールや個人用 API キー管理ツールには使用できません。DPoP の workspace use にはワークスペース UUID が必要です。
  • 同じインストール内では、同じサイトと同じアカウントの複数の別名が DPoP ログイン状態を共有するため、1 つからログアウトすると残りの別名からも同時にログアウトします。ワークスペース一覧、API キー取得、キーに依存するワークスペース管理コマンドでは、引き続き API キープロファイルを使用する必要があります。バックアップ時は、秘密鍵を含む dpop/ ディレクトリを適切に保管してください。複数のプロファイルの使用。

1.8.0(2026/11/04)

新機能

  • Registry は、設定済みの Studio/AIAPI ターゲットに送信元 IP V2 署名を追加しました。HTTP API、リモート MCP、および関連する子呼び出しは署名を共有し、送信ごとおよびトランスポート層のリトライごとに nonce と署名を再生成します。
  • owl.field_schema.search を追加し、キーワード、タイプ、namespace、measurement で現在権限のあるワークスペースのフィールド設定を検索し、タイプ、単位、単位のソースを返します。ページネーションをサポートし、デフォルトは 100 件、最大 1000 件です。全件取得用の owl.field_schema.get は保持されます。検索はフィールドが不明な場合またはコンテキストが無効になった場合にのみ行い、空の結果はストレージにデータがないことを意味しません。
  • イベント offset、コメントページ番号、インフラストラクチャと同一組織のトレースカーソル、トポロジグループ化パラメータ、および Monitor/SLO/Member のオプションのページネーションを補完しました。後続ページでは同じフィルター条件、時間範囲、権限コンテキストが保持されます。追加されたページネーションフィールドを省略する既存の呼び出しは、元のセマンティクスを維持します。
  • ノートの変更と削除で expected_etag をサポートし、読み取り時のバージョンにバインドします。書き込みエラーでは完了段階、リソースの識別情報、復旧情報を保持し、書き込み失敗と書き込み後の読み戻し失敗を区別できるようにします。

不具合修正と改善

  • 送信元 IP は X-Forwarded-For の最初のアドレスを優先し、ヘッダー全体が欠落しているか空白の場合にのみ接続相手側にフォールバックします。空でないヘッダーの最初のアドレスが無効な場合は署名を拒否し、後続のアドレスに切り替えません。保護対象のターゲットでは自動リダイレクトを禁止します。
  • CLI、REST、MCP は上流の構造化エラー、DQL 診断、書き込み復旧情報を保持します。CLI はパラメータヘルプ、組み合わせ検証、クラスタリングクエリの時間事前チェックを改善しました。P95 の例を修正し、LN、クエリ limit、Pipeline サンプル、LLM アプリケーションカテゴリの契約を補完しました。クラスタリングの処理量は、完全な時間ウィンドウのカバレッジを表すものではありません。
  • 外部 MCP は失敗状態と複数パートのテキストの順序および境界を保持します。タイムアウト、キャンセル、stdio プロセスの終了、パイプ読み取り、npx の復旧を修正し、単一メッセージの上限を 1 MiB としました。出力と stderr の認証情報マスキングを強化しました。ツールのリスク注釈は検出およびキャッシュとともに伝播されますが、権限や承認の代替にはなりません。

アップグレードと互換性に関する説明

  • 追加された契約をサポートする Studio を先にデプロイしてから、Registry をアップグレードしてツールカタログを更新してください。CLI では owl sync を実行し、MCP クライアントではツールを再検出します。ツールカタログの同期では CLI バイナリは更新されません。新しいヘルプ、ローカル検証、完全なエラー診断を利用するには、CLI をアップグレードする必要があります。
  • Registry イメージの組み込み設定では、署名がデフォルトで有効になっています。管理者は OWL_AI_API_BASE_URL と OWL_AIAPI_SIGNING_SECRET_BASE64 を設定し、Studio が V2 をサポートしていることを確認する必要があります。双方は同じ 32 バイトキーの標準 Base64 値を使用します。アドレスまたはキーが欠落していると起動に失敗します。既存のカスタム設定では aiapiSigning を同期する必要があります。省略した場合は引き続き無効です。stdio を使用する場合やこの機能を使用しないデプロイでは、aiapiSigning.enabled: false を明示的に設定してください。
  • Ingress ゲートウェイは X-Forwarded-For を正しく設定およびクリーンアップする必要があります。Studio/ゲートウェイは保護対象パスの署名欠落リクエストを独立して拒否し、ホワイトリスト、権限、時間ウィンドウ、nonce の重複排除を実施します。Owl のみをアップグレードしても、保護チェーン全体が有効になるわけではありません。
  • ノートのバージョン競合が発生した場合は再読み取りして確認し、ETag を自動で置き換えて再送信しないでください。expected_etag を省略した場合は読み取り後の書き込み保護が提供されません。モニター更新で状態、アラートポリシー、タグを省略した場合は元の値が保持され、明示的な空リストはクリアを意味します。書き込みが完了しているのに読み戻しに失敗した場合は、重複して作成しないでください。送信状態が不明な場合は先に確認してください。

1.7.0(2026/10/28)

新機能

  • owl.catalog.entity_create、owl.catalog.entity_modify、およびチーム検索用の owl.workspace.member.group_list を追加しました。カタログ検索では名前、URN、属性によるフィルタリングをサポートします。
  • CLI に runtime-profile/v1 を追加しました。エグゼキューターがユーザーごとに独立したプロファイルと認証情報を注入し、認証情報は設定に書き込まれません。
  • owl.data.read_dql_docs を追加し、検索で返されたツール参照に従って、Registry から DQL ドキュメント本文をページ単位で読み取ります。

不具合修正と改善

  • DQL 検証では、元のクエリ、解析またはバインドの診断、利用可能な行・列情報を保持し、クエリエラーとバリデーター使用不可を区別します。
  • CLI コマンドログのリクエストヘッダー長を制限し、長いインラインパラメータによる転送失敗を回避しました。業務パラメータは引き続き完全なリクエストボディで転送されます。
  • インフラストラクチャのフィルターから上流がサポートしない like を削除し、=、!=、in をサポートしました。

アップグレードと互換性に関する説明

  • CLI と Registry をセットでアップグレードした後、owl sync を実行し、MCP クライアントでツールを再検出してください。カタログへの書き込みは対応する AIAPI / Backend に依存します。使用方法はカタログエンティティの作成と変更を参照してください。
  • DQL ドキュメントを読み取る際は、返された read_reference を使用し、Agent のローカルで references_dir を読み取らないでください。ランタイムプロファイルを有効にする対応順序は、Owl → Agent 完全リリースパッケージ → ユーザーモードを有効にして再インストールです。ロールバックする前にユーザーモードを無効にして再インストールしてください。

1.6.1(2026/10/23)

セキュリティ修正

  • CLI、標準 Registry、UOS Registry のビルドツールチェーンを Go 1.27.3 にアップグレードし、crypto/x509 の CVE-2026-111943 を修正しました。アドバイザリに記載された信頼できない中間証明書を信頼しないようにします。ソースからのビルドには Go 1.27.3 以降が必要です。

1.6.0(2026/10/21)

新機能

  • owl.event.resolve:イベントドキュメント ID、イベントまたはインシデント ID、リンクからイベント詳細を解決します。
  • owl.account.workspace.same_org.list:CLI ツールのエントリポイントを追加し、同一組織の Trace クエリの候補ワークスペースを検出します。

不具合修正と改善

  • CLI、HTTP、MCP でパラメータと時間範囲の検証を統一し、インフラストラクチャのフィルター条件、ワークスペースのページネーション、イベント詳細パラメータの検証を強化しました。owl exec -f json の事前チェックが失敗すると、構造化 JSON と非ゼロの終了コードを返します。
  • owl sync は、いずれかのカテゴリのダウンロードに失敗すると失敗を返し、失敗したカテゴリの既存キャッシュとローカルバージョンを保持します。初回の自動同期が失敗すると後続の実行がブロックされます。キャッシュ期限切れ後の自動同期失敗は従来どおり警告を出し、既存のキャッシュを使用します。

アップグレードと互換性に関する説明

  • CLI と Registry をセットでアップグレードした後、owl sync を実行し、MCP クライアントでツールを再検出してください。owl.event.get は引き続き一覧で返された元の doc_id を使用します。イベント ID、インシデント ID、またはリンクを使用する場合は owl.event.resolve を使用します。
  • v1.6.0 では 13 桁の整数ミリ秒タイムスタンプを統一的に検証し、終了時間が開始時間より大きいことを要求します。ペアで提供する必要があるパラメータは片方だけを渡すことはできません。必須要件と最大スパンは各ツールのスキーマに従います。owl.data.query の時間範囲は最長 7 日です。
  • owl.data.query の DQL ではインラインの時間ウィンドウを省略でき、クエリウィンドウは start_time / end_time で指定します。インラインの絶対ウィンドウは外部ウィンドウと一致している必要があり、相対ウィンドウは拒否されます。PromQL の範囲セレクターはルックバック期間を表し、クエリウィンドウとしては扱われず、DQL 検証にも入りません。Registry には利用可能な dqlcheck が必要です。検証が利用できない場合、DQL クエリは実行されません。リクエストのウィンドウは、バックエンドが実際に実行した時間範囲や結果がカバーする時間範囲とは同一ではありません。

1.5.0(2026/10/14)

OWL CLI の新機能

  • CLI に独立したプロファイル管理とアカウント切り替え機能を追加しました。owl profile add/list/current/rename/remove で複数の完全な設定を保存および管理し、owl switch、--profile、または OWL_PROFILE で設定を永続的または一時的に選択できます。各名前付きプロファイルは、設定、認証情報、キャッシュ、データ、ログを個別に保存します。(#21)
  • CLI に Bash および PowerShell のオフライン補完を追加し、コマンド、プロファイルの別名、カテゴリ、ツール名、ツールパラメータ、スキーマの列挙値を候補表示できます。補完は現在のプロファイルのローカルキャッシュのみを読み取り、ネットワークに接続せず、ツールも実行しません。(#24)

OWL CLI の不具合修正と改善

  • Bash 補完の候補マッチングを強化し、スキーマ内の shell 特殊文字、スペース、URL をすべてリテラル値として扱います。(#24)
  • owl profile remove --purge のクリーンアップに失敗した場合に、設定と認証情報が先に削除される可能性がある問題を修正しました。失敗後は権限を修正して再試行できます。(#21)

OWL Registry と共通ツールカタログ

  • owl.external_datasource.list と owl.external_datasource.query を追加し、現在のワークスペースでアクセス可能な外部データソースを検出し、一覧で返された datasource_uuid を使用して単一の制限付き読み取り専用 SQL を実行できます。(#13)
  • Registry のログでは、sql、rows、ネストされた arguments などの機密フィールドが完全にマスクされます。(#13)
  • owl.metric.list、owl.rum.list、owl.apm.list、owl.network.list、owl.profile.list、owl.logging.list、owl.billing.list、および owl.infrastructure.list/get では、13 桁のミリ秒単位の start_time と end_time を渡す必要があります。時間ウィンドウは最長 7 日です。(#25)
  • owl.llm.list の時間範囲は引き続き任意です。start_time と end_time の両方を省略した場合は、直近 24 時間をクエリします。(#25)
  • DQL クエリツールの dql_namespace / namespace スキーマに、完全な列挙と一般的なデータ型のマッピングを追加しました。owl.data.show_dql_namespace は完全な型の意味を提供し、返される dql_namespace 値が owl.data.query では引き続き同名のフィールドを使用し、simple query とログクラスタリングツールではそのまま namespace に渡す必要があることを明確にします。既存のフィールド名とリクエスト転送の動作は変更されません。

アップグレードと互換性に関する説明

  • プロファイルが選択されていない場合は、引き続き元の ${OWL_DIR}/config.yaml を使用します。ルート設定は default として保持され、自動移行は行われません。CLI の --conf は非推奨です。設定をインポートした後は --profile に切り替えることを推奨します。Registry サービスの --config には影響しません。(#21)
  • Registry または共通カタログをアップグレードした後、owl sync を実行してください。上記の discovery および infrastructure ツールを呼び出す際は、時間範囲を明示的に渡す必要があります。owl.llm.list は引き続き時間範囲を省略できます。(#25)

1.4.0(2026/09/23)

新機能

  • 認可されたクロスワークスペースデータクエリを追加しました。owl.workspace.data_authorized.list で認可されたワークスペースを検出し、workspace_uuids と target_region を DQL ツールに渡します。現在のワークスペース内のクエリではワークスペースを検出する必要はありません。同一組織のクロスワークスペース Trace では引き続き専用のツールを使用します。
  • workspace カテゴリを追加し、認可されたワークスペース一覧と owl.workspace.member.list を含めました。旧名 owl.member.list は呼び出し別名として保持され、CLI と MCP の両方で新しいツールのパラメータと権限検証を再利用します。
  • owl.incident.get を追加し、インシデント UUID から詳細とページネーションされた関連イベント参照を取得し、owl.event.get でイベント内容を読み取ります。

不具合修正と改善

  • 過去の testing-<SHA> ビルドが owl update でアップグレードできない問題を修正しました。Linux/macOS と Windows のインストーラーは、現在の設定チャネルの正式バージョンへの移行をサポートし、既存の設定と SHA256 検証を保持します。通常のバージョンは引き続きアップグレードのみでダウングレードは行わず、同一バージョンはインストールをスキップし、認識できないバージョンは引き続きエラーになります。(#226)
  • CLI と MCP は AIAPI のエラー診断フィールドと trace ID を保持し、クロスワークスペースクエリの失敗原因を特定しやすくしました。
  • パラメータの事前チェックで JSON Schema の union 型をサポートし、各型ブランチの制約検証を保持します。
  • 静的 MCP ツールに OpenAI メタデータを追加し、OAuth Bearer token が上流に転送される問題を修正しました。

アップグレード要件

  • 対象サイトに対応する AIAPI がデプロイされていることを確認してください。これには /api/v1/workspace/data_authorized/list、クロスワークスペースクエリの契約、/api/v1/incident/get が含まれます。
  • CLI と Registry のプログラムをセットでアップグレードし、owl sync を実行してカタログを全量更新してください。MCP クライアントではツールを再検出します。旧版 CLI は別名をサポートしていないため、カタログを同期するだけでは旧コマンドが使用できるとは限りません。
  • 旧 member カテゴリは削除されました。認可されたワークスペースの検出には、統一的に owl.workspace.data_authorized.list を使用します。詳細は移行手順を参照してください。

1.3.0(2026/08/26)

今回のリリースは機能イテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • CLI にグローバルな --conf パラメータを追加し、設定ファイルを明示的に選択できるようにしました。設定の表示と書き込みは、選択したファイルに従います。
  • CLI に registry.insecure_skip_verify と registry.request_timeout 設定を追加し、制御された開発環境や長時間かかるデータクエリで使用できるようにしました。TLS 検証のスキップはデフォルトで無効、リクエストタイムアウトのデフォルトは 150 秒です。
  • Registry に、OAuth Broker を統合するサイトルーティングと token issuer/audience の検証を追加しました。ターゲット AI API はサーバー側のホワイトリストで決定されます。
  • Center MCP は設定に応じて静的ツールを直接公開し、指定したツールを除外できます。デフォルトでは引き続き既存の facade ツールを使用します。
  • Registry に OpenAI Apps のチャレンジエンドポイントを追加しました。token が設定されていない場合は無効のままで、404 を返します。
  • Registry のローカルデプロイ補助フローを追加し、リモート AI API と S3 サービスを設定できるようにしました。

不具合修正/改善

  • OAuth 上流の未認可レスポンスを保持し、呼び出し元が認証情報の問題を正しく識別できるようにしました。
  • owl.data.simple_query_file の limit は、実行前に 1 から 10000 の範囲で検証されるようになりました。
  • データクエリツールのタイムアウトを 130 秒に調整し、Registry クライアントのデフォルトタイムアウトを 150 秒に調整して設定可能にしました。
  • Registry イメージにバージョンとリビジョン情報を書き込み、リリースプロセスの回帰テストを追加して、ビルド成果物の追跡性を向上させました。

互換性の調整

  • 既存の CLI コマンドとデフォルト設定パスは変更されません。--conf は新しいエントリポイントであり、TLS 検証のスキップはデフォルトで無効です。
  • MCP はデフォルトで引き続き facade ツールを公開します。サイトルーティングと OpenAI Apps のチャレンジは、いずれも明示的に設定したうえで有効にする必要があります。
  • まだ完全に設計されていない Agent Protocol(owl agent --stdio を含む)は、今回のリリースには含まれません。

1.2.1(2026/08/07)

今回のリリースは hotfix 修正であり、内容は次のとおりです。

不具合修正

  • data タイプのツールが生成する結果ファイル ID が長すぎる問題を修正しました。新しいファイルでは 22 文字の URL-safe ランダム ID を使用し、長いパラメータによってファイル名やパスが長くなるリスクを減らし、Agent が後続のコマンドで参照しやすくしました。(#8)
  • owl.data.simple_query と owl.data.simple_query_file がパラメータスキーマのみを検証し、自動生成された DQL を検証していなかった問題を修正しました。実行前に同等の DQL を構築し、Registry の DQL 検証機能を呼び出すことで、無効なクエリ断片を事前にブロックします。(#7)

機能改善

  • simple query で生成された DQL の検証に失敗すると、構造化された generated_dql / dql.builderError の問題を返し、Agent が where_clause、select_clause、group_by_clause などのパラメータを特定して修正しやすくしました。(#7)

互換性の調整

  • data ファイルのインデックス形式と安定した queryKey は変更されず、既存のインデックスと結果ファイルは引き続き読み取れます。新しく生成されるファイルの ID とファイル名のみが短くなります。(#8)
  • 正当な simple query の呼び出し方法とリモート実行経路は変更されません。無効な DQL のみが、リクエスト送信前のより早い段階で失敗します。(#7)

1.2.0(2026/08/05)

今回のリリースは機能イテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • CLI に owl validate、owl tool validate、owl capabilities を追加しました。対象ツールを実行せずにパラメータスキーマとツール固有の構文を検証でき、構造化された結果を Agent の判断と修正に利用できます。(#6)
  • アカウントのワークスペースとローカルプロファイルの管理機能を追加しました。ワークスペース一覧、アクセスキーの取得、ワークスペースの切り替え、現在のコンテキストの表示が含まれます。プロファイルはワークスペースの認証情報と現在のコンテキストの管理に使用され、キャッシュと data ファイルは引き続き設定された共有パスを使用します。(3da3e8e)
  • 同一組織のワークスペース検出を追加し、データクエリで same_org_workspace_uuids を使用して同一組織の複数のワークスペースをクエリできるようにしました。クロスワークスペースの Trace 検索に利用できます。(71fa73e)
  • owl exec にバージョン更新の通知を追加しました。CLI は更新チャネルに従ってスロットリングしながら新しいバージョンを確認し、JSON 出力の notice フィールドでアップグレードを通知します。このフィールドは既存の解析に影響しません。(7c7113c)
  • 共通ツールカタログに mdsearch のドキュメント検索と SLO 一覧機能を追加しました。(135c8ff、18f87b0)
  • 共通ツールカタログに Studio Notes V2 のノート一覧、作成、変更、削除機能を追加しました。(a72af5f)
  • 共通ツールカタログにデータ転送ルールの検出と非同期クエリ機能を追加しました。(6c37c93、c6dcd80)
  • 共通ツールカタログに Dashboard 一覧機能を追加しました。(6c98f0b)
  • Linux、macOS、Windows の 5 プラットフォーム向け OSS 自動リリースパイプラインを追加しました。テストチャネルで検証が完了した後、同じビルド成果物を本番チャネルに昇格できます。(9fba8e2)

不具合修正

  • HTTP ツールの上流がクライアントエラーを返した際に、Registry が元のステータスとエラー情報を失う問題を修正しました。CLI はより正確で実行可能な失敗原因を取得できるようになりました。(e1267e0)
  • Dashboard の大きな結果が依然として text パスで返される問題を修正しました。関連ツールは結果を data ファイルに保存するようになり、大きなペイロードが Agent のコンテキストを占有するのを回避します。(68cac16)
  • データ転送クエリの結果が依然として text パスで返される問題を修正しました。クエリ結果は data ファイルに書き込まれるようになりました。(30aa6fc)
  • ワークスペースの認証情報の切り替えおよび表示時に、アカウント情報が混同される可能性がある問題を修正しました。設定出力ではデフォルトでキーが非表示になり、明示的に要求した場合にのみ元の secret が表示されます。(3da3e8e)
  • Streamable MCP セッションは、確立前に認証が完了するようになりました。未認可のリクエストではセッション状態が作成されません。(2a5d8e9)

機能改善

  • owl exec と owl validate のパラメータ解析および事前チェックロジックを統一し、すべてのパラメータ問題を一度に返せるようにしました。検証前に通常の初回利用時またはキャッシュ期限切れ時の自動同期が実行されます。それでも tool_not_found が返される場合は、明示的に owl sync を実行してから再試行してください。(#6)
  • CLI 操作は安定した operation ID を保持し、Registry リクエストと上流の失敗の間で追跡情報を透過的に伝達するため、層をまたいだ問題の特定が容易になります。(386abc0)
  • ログ内の機密 token は、問題の関連付けに使用できる先頭と末尾の文字のみを保持し、中間部分はマスクしたままにして、完全な認証情報がログに記録されるのを防ぎます。(6a6d0ad)

互換性の調整

  • list、show、exec、schema などの既存の短縮コマンドおよび tool / tools 名前空間は引き続き互換性があります。validate と capabilities は新しいエントリポイントです。(#6)
  • 旧版の token、auth.token、workspaces.<name>.token、auth.token_file 設定は引き続き読み取れます。新しく書き込まれる認証情報は統一的に api-key を使用し、古い設定を積極的に削除することはありません。(3da3e8e)
  • owl.data.query の PromQL モードは DQL バリデーターに入りません。既存の正当なクエリと MCP ツールの呼び出し方法は変更されません。(#6)

1.0.11(2026/05/25)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • data カテゴリに CLI 専用ツール owl.data.simple_query_file を追加しました。CLI が最新の共通ツールカタログを同期した後、simple query パラメータで既存の simple query バックエンド API を呼び出し、既存の data ファイルライフサイクルで結果を保存できます。
  • owl.data.simple_query_file と MCP ツール owl.data.simple_query は独立した公開面を維持し、大きな結果が MCP の text/context パスで返されるのを回避します。

機能改善

  • 実際の public config を使用した回帰テストを追加し、owl.data.simple_query_file の CLI での可視性、MCP での非可視性、outputType: data、認証方式、パラメータスキーマをカバーしました。

互換性の調整

  • 既存の MCP ツール owl.data.simple_query は、outputType: text と MCP 専用の公開方法を変更せずに維持します。

1.0.10(2026/05/18)

今回のリリースは hotfix 修正であり、内容は次のとおりです。

不具合修正

  • registry.endpoint に末尾スラッシュ付きのアドレスを設定した場合、CLI が Registry API パスを結合する際に二重スラッシュが生成され、owl sync が nginx 404 を返す可能性がある問題を修正しました。
  • Registry Client は構築時に endpoint を正規化するようになり、http://testing-owl-api.dataflux.cn/ と http://testing-owl-api.dataflux.cn を同じ Registry アドレスとして扱えます。

機能改善

  • Registry Client と SyncAll の回帰テストを追加し、末尾スラッシュ付き endpoint でのカテゴリ同期パスをカバーして、今後の URL 結合の劣化を防ぎます。

互換性の調整

  • ユーザー設定の形式は変更しません。末尾スラッシュなしの既存 endpoint は元の動作を維持し、末尾スラッシュ付き endpoint も互換性があります。

1.0.9(2026/05/12)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • data カテゴリに owl.logging.cluster_task.create を追加しました。CLI が最新の共通ツールカタログを同期した後、非同期ログクラスタリング分析タスクを作成できます。
  • data カテゴリに owl.logging.cluster_task.get を追加しました。create で返された task_id を使用して、非同期ログクラスタリング分析の結果をクエリできます。
  • ログクラスタリングタスクは完全な query を渡すことができ、namespace、conditions、timeRange、analysisField、indexes を指定してバックエンドにクエリを組み立てさせることもできます。

機能改善

  • data カテゴリの説明とバージョンを更新し、共通カタログにログクラスタリングタスクの作成およびクエリ機能が含まれていることを明確にしました。
  • loader と Registry server の回帰テストを追加し、ログクラスタリングタスクのスキーマ解析、必須パラメータ検証、REST 実行の転送をカバーしました。

互換性の調整

  • 今回の変更はツールの追加であり、既存の owl.logging.list、owl.data.query、その他の data カテゴリツールの呼び出し方法は変更されません。

1.0.8(2026/05/07)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • data カテゴリの検出経路に owl.logging.list と owl.billing.list を追加しました。CLI が最新の共通ツールカタログを同期した後、ログとクラウド請求の source / field を直接検出できます。
  • owl.metric.list は mode=tag でメトリクスの tag key を検出でき、source でフィールドまたは tag の結果をフィルタリングできます。
  • data の結果ファイル名は、読みやすいプレフィックスを保持したうえで UUID を追加し、重複クエリや複数セッションの同時実行時に同名ファイルが上書きされるのを回避します。
  • data ファイルインデックスに安定した queryKey を追加し、同一クエリの識別に使用できるようにするとともに、旧版 index.json との互換性を維持します。

不具合修正

  • 検出ツールのスキーマが source パラメータを宣言していないため、owl exec ... --source ... がローカルパラメータ検証で拒否される問題を修正しました。
  • AIAPI discovery list が success:false の業務エラーを返した場合に、Registry REST と MCP HTTP ツールの外層が依然として成功と誤報告する可能性がある問題を修正しました。
  • インストーラーの --owl-dir / -OwlDir でカスタム Owl ディレクトリを指定した後、後から直接 owl config show を実行するとデフォルトの設定ディレクトリにフォールバックする可能性がある問題を修正しました。

機能改善

  • README と使用ドキュメントのデータ検出例を更新し、mode=field、mode=tag、owl.logging.list、owl.billing.list の呼び出し方法を追加しました。
  • 共通カタログの同期メッセージを調整し、共通カタログがヒットした際に誤解を招きやすい Scope: public catalog が出力されないようにしました。
  • owl data clean はデフォルトで 1 日前のファイルをクリーンアップし、--days 0 または負の値は 1 日として扱います。
  • owl data clean は index に登録された期限切れファイルのみをクリーンアップし、未登録の孤立ファイルは従来どおり、積極的にスキャンして削除することはありません。
  • Linux/macOS と Windows のインストーラーは、インストール先の横に .owldir パスを記録し、カスタムディレクトリを使用していない場合またはアンインストール時に古い記録をクリーンアップします。これにより、CLI は OWL_DIR 環境変数がない場合でもカスタム設定、キャッシュ、データディレクトリを引き続き特定できます。
  • loader、executor、Registry REST、MCP の discovery スキーマと業務エラーの回帰テストを追加しました。
  • CLI 設定解析とインストーラーのカスタムディレクトリ回帰テストを追加し、.owldir 記録の読み取り、config show のパス表示、インストール後のディレクトリ配置をカバーしました。

互換性の調整

  • owl exec のパラメータ形式は変更されず、引き続き --key value、key=value、-p JSON、--stdin をサポートします。
  • メトリクス以外の discovery ツールでは mode=source|field のみ使用できます。mode=tag は owl.metric.list にのみ適用されます。

1.0.7(2026/04/29)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • CLI に tool 名前空間を追加し、tools 別名を保持しました。このエントリポイントは list、show、exec、schema などのトップレベルコマンドに加える補助形式として、Agent がコマンド形式を推測する際の耐障害性を向上させます。
  • category に categories 別名を追加し、Agent が自然なコマンド推測方法でカテゴリ機能を検出しやすくしました。

不具合修正

  • owl help tool、owl help categories などのヘルプトピックを解決できない問題を修正しました。
  • 一部の --help 呼び出しで設定の初期化や Registry 依存関係が早期に発生する問題を修正し、ヘルプコマンドが未設定の環境でも直接返せるようになりました。

機能改善

  • ヘルプトピックの回帰テストを追加し、トピック別のヘルプ表示(例:owl help tool)とコマンド別のヘルプ表示(例:owl tool --help)が同じ情報を返すことを確認しました。
  • README のツール表示コマンド例を調整し、tool 名前空間の使用例を追加しました。

互換性の調整

  • list、show、exec、schema などの既存トップレベルコマンドは引き続き主要な使用方法であり、互換性を維持して既存スクリプトを壊さないようにします。
  • すでに公開されていない一部のサンプルツールと Skill 設定をクリーンアップしました。

1.0.6(2026/04/28)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • owl update コマンドを追加しました。インストーラーが記録した更新チャネルに基づいて、対応するプラットフォームのインストールスクリプトをダウンロードして実行できます。
  • Linux/macOS のインストールスクリプトに --upgrade、Windows のインストールスクリプトに -Upgrade を追加し、リモートバージョンが更新されている場合にのみローカル CLI をアップグレードできるようにしました。
  • インストーラーは設定に update.base_url と update.channel を書き込み、後続の owl update に更新元を提供します。

不具合修正

  • アップグレード時に既存のインストールパスを安定して特定できない問題を修正しました。アップグレードフローは Owl ディレクトリ内の binpath を優先して読み取り、次に PATH 内の owl にフォールバックします。
  • ローカルバージョンがリモートバージョン以上の場合でも上書きインストールされる可能性がある問題を修正しました。現在はバイナリの置き換えをスキップし、更新チャネル設定のみを更新します。

機能改善

  • インストーラーにセマンティックバージョンの比較ロジックを追加し、アップグレード前にローカルの owl --version とリモート channel の version を読み取って比較します。
  • 更新フローは Linux/macOS ではインストールスクリプトを同期的に実行し、Windows では独立した PowerShell プロセスでインストーラーを起動して、実行中のバイナリを置き換えるリスクを低減します。

1.0.5(2026/04/28)

今回のリリースは hotfix 修正であり、内容は次のとおりです。

不具合修正

  • Linux/macOS インストーラーが macOS 標準の Bash 3.2 でチェックサム比較を実行すると bad substitution を報告する問題を修正しました。
  • Bash 4 構文 ${var,,} を POSIX ツールチェーンで使用可能な tr '[:upper:]' '[:lower:]' に置き換え、チェックサムの大文字小文字正規化ロジックが旧 Bash と互換性を持つようにしました。

機能改善

  • 5 プラットフォームの CLI パッケージを再ビルドし、リリースディレクトリのバージョン、manifest のバージョン、パッケージ内の owl --version 出力を一致させました。
  • skill.md と skill.en.md の 2 つの Skill ドキュメントを保持し、中国語と英語の Agent Skill 配布を引き続きサポートします。

1.0.4(2026/04/27)

今回のリリースは installer channel リリースであり、主な更新内容は次のとおりです。

新機能

  • skill.en.md をリリースし、英語の Agent Skill 説明ファイルを追加しました。
  • 一時コードによるインストールとカスタム Owl ディレクトリをサポートするインストーラーのサポートファイルを、1.0.4 channel ディレクトリにリリースしました。

不具合修正

  • 前バージョンの本番 channel インストールスクリプトに OWL_DIR / OwlDir のサポートが欠けている問題を修正しました。
  • 既存の 1.0.3 channel が同期キャッシュの影響を受けている場合に、同じバージョンのリリースを直接上書きするのを避け、新しい channel ディレクトリで修正後のインストールエントリポイントを提供するようにしました。

1.0.3(2026/04/27)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • インストーラーに OWL_TEMP_CODE のサポートを追加し、OWL_REGISTRY_ENDPOINT から ai-api アドレスを導出して、/api/v1/account/accesskey/exchange で実際の token を交換できるようにしました。
  • skill.md を追加し、Agent 統合シナリオ向けに channel とともに配布される Skill 説明を提供します。

不具合修正

  • bash -c "$(curl .../install.sh)" のエントリポイントで BASH_SOURCE[0] の読み取りが失敗する可能性がある問題を修正し、$0 フォールバック付きのスクリプトエントリポイント解析に変更しました。
  • インライン installer helper で予期しない改行の書き方が発生する問題を修正し、リリース版 install.sh を直接実行可能な自己完結型スクリプトに近づけました。

機能改善

  • 一時コードで token を交換する際に、OWL_TOKEN と交換結果が一致するか検証し、一致しない場合はインストールを直ちに中止します。
  • OWL_TEMP_CODE リクエストはデフォルトでローカルプロキシをバイパスし、一時認証情報の交換がプロキシ設定の影響を受ける可能性を低減します。

1.0.2(2026/04/24)

今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。

新機能

  • CLI とインストーラーがカスタム Owl 作業ディレクトリをサポートしました。OWL_DIR、--owl-dir、-OwlDir を追加しました。
  • インストーラーが OWL_OWNER / --owl-owner をサポートし、cloud-init または root でのインストール後に設定ディレクトリをサービスユーザーに引き渡しやすくしました。
  • インストール完了後、バイナリパスを Owl ディレクトリ内の binpath に記録し、後続のアップグレードや Agent 実行時の特定に使用できるようにしました。

不具合修正

  • インストーラーが registry.endpoint と auth.token を永続化する際に、常に現在のユーザーディレクトリに書き込む問題を修正しました。現在は指定された Owl ディレクトリに書き込みます。
  • カスタムディレクトリのシナリオで config show が表示するディレクトリが不正確になる問題を修正しました。

機能改善

  • README に cloud-init / systemd のサービスユーザー向けインストール手順を追加し、OWL_DIR と OWL_OWNER の推奨用法を明確にしました。
  • インストールスクリプト内のアンインストール通知、設定ディレクトリの初期化、パス記録ロジックで、解析後の Owl ディレクトリを統一的に使用するようにしました。

1.0.1(2026/04/23)

今回のリリースは hotfix 修正であり、内容は次のとおりです。

新機能

  • CLI に初回利用時の自動同期機能を追加しました。ローカルキャッシュが空の場合、またはキャッシュが registry.sync_interval を超えた場合に、list、show、exec、schema、category などのコマンドが自動的に owl sync をトリガーします。
  • sync.auto 設定項目を追加し、自動同期を無効にできるようにしました。

不具合修正

  • 1.0.0 の Linux/macOS tar パッケージ内で owl バイナリに実行権限が欠けている問題を修正しました。
  • owl sync の増分同期時に、リモートで削除された category のキャッシュがクリーンアップされない問題を修正しました。
  • HOME がない一部の cloud-init / systemd / container 環境で、インストールスクリプトが set -u により早期終了する可能性がある問題を修正しました。

機能改善

  • 自動同期の失敗時に初回同期とキャッシュ更新を区別します。初回同期の失敗時はエラーを返し、既存キャッシュの更新失敗時は古いキャッシュを保持して warning を出力します。
  • リリースディレクトリで 1.0.0 と 1.0.1 channel の成果物を復元および追跡し、installer の回帰テストと CRLF/LF 監査を追加しました。

1.0.0(2026/04/13)

今回のリリースは初回リリースであり、主な更新内容は次のとおりです。

新機能

  • Owl CLI の最初の channel バージョンをリリースし、Linux、macOS、Windows の合計 5 つのプラットフォームパッケージを提供しました。
  • install.sh、install.ps1、owl-install.ps1、SHA256SUMS を提供し、リモート channel インストール、バージョン指定インストール、ローカルパッケージインストール、チェックサム検証をサポートしました。
  • CLI は設定の初期化、ログインによる token の書き込み、ツールカタログの同期、カテゴリ表示、ツール表示、ツール実行、OpenAI function schema の出力、キャッシュ管理、データファイル管理をサポートします。

機能改善

  • リリースディレクトリには README と USAGE ドキュメントが含まれ、テスト/本番チャネルのインストール、実行時設定、オフラインインストール、アンインストール、一般的なコマンドについて説明しています。
  • ビルドパイプラインはマルチプラットフォームのクロスコンパイルをサポートし、version manifest で現在のバージョン、過去のバージョン、リリース日時、commit、プラットフォーム一覧を記録します。

既知の問題

  • Linux/macOS の tar パッケージ内で owl バイナリの権限が 0644 であり、直接展開した後は実行できません。この問題は 1.0.1 で修正されています。

フィードバック

このページは役に立ちましたか?