アクションと機能の契約

概要

CLI は、アクションマニフェスト、オフライン事前検査、インストール済み機能の検出、明示的なネイティブコマンドを提供します。0.1.9 ブートストラップは、機能に必要な署名済みインストール構成を作成します。これらの出力は異なる問いに答えるため、他の状態の証拠として扱ってはなりません。

顧客アクションマニフェスト

バージョン管理されたマニフェストには 25 アクションがあります。

• 22 アクションは executes=true と記されています。

• altifigence.analyze.run, altifigence.evolve.launch と altifigence.verify.run は、計画のみの 3 アクションです。

executes=true は、アクションが実行可能として定義されていることを意味します。実際のコマンドには、ローカルエンジン、アカウント権限、リモートサービスが必要な場合があります。計画のみのアクションは検証して計画を返し、ジョブを実行しません。

次を使用してください：alti commands。現在のバイナリに同梱されたマニフェストを調べます。異なるリリースのコマンド一覧をコピーしないでください。

オフライン事前検査レシート

オフラインの job validate ワークフローは、限定された CPU RTL エンベロープ 1 件と安全なワークスペース相対ソースを検証します。成功レシートは submitted: false と server_authority_verified: false を明示します。ローカルエンジンを実行せず、ホストされたサービスに接続しません。CLI で最初の成功を確認する を参照してください。

インストール済みエンジンの機能契約

機能スキーマは、正しくインストールされ、レシートで裏付けられたリリースに次の状態を定義します。

まず ダウンロードの検証 と Linux へのインストール に従ってから alti capabilities を使います。組み込みブートストラップは認証済みカタログ・レシート構成を作成します。バイナリを別の場所にコピーしたり、その状態を捏造したりしないでください。インストール済み準備状況は利用可能な機能を報告します。設計や GPU ジョブが実行された根拠は、その実行結果から得られます。

成功したローカルコマンドは、そのマシンで何を実行したかを報告します。インストール済み製品の機能に依存する自動化は、機能の報告も必須にしてください。

ソースアップロードはオプトイン

同梱の stdio MCP サーバーは、既定の顧客モードではソースファイルを含められる 3 つの計画アクションを隠します。これらには別途環境認証情報が必要で、Cloud クライアントを使います。現在の公開リリースは、それらの完全なリモート実行ワークフローを提供しません。

独立した ALTI_MCP_MODE=local-xls モードは、Cloud へ処理を渡さず固定のローカル XLS ツールを公開します。ネイティブの ide cloud 操作は固有のサインインと明示的アップロード規則を使います。計画のみの顧客アクション状態は、Cloud ワークスペースのすべての操作を説明するものではありません。

オプトインは送信を許可しますが、計画のみのアクションを実際の実行に変えたり、リモートサービスを利用可能にしたりしません。

結果をそれぞれ別に扱う

CLI を自動化する場合、以下を異なる状態として扱います。

• ローカル機能が利用可能である。

• 要求が検証された。

• 実行せずに計画が返された。

• 明示的に有効な権限主体が作業を受理した。

• 作業が完了して根拠を生成した。

• 機能または権限主体が利用できなかった。

これらを単一の成功値にまとめると、計画やプレビューが完了した設計作業に見えてしまいます。

適切な結果契約を選ぶ

ローカル実行では、選択したエンジン、入力ダイジェスト、ネイティブ終了状態、完全な結果を記録します。保存済みファイルの変更では、計画と適用レシートを保持し、ファイルを再読み取りします。リモートジョブでは、終端状態まで ID を追跡してから実際の結果を取得・検証します。アクションマニフェストのエントリは、呼び出し可能なインターフェースだけを説明します。

自動化では、ローカルエンジン要求エンベロープ、顧客の計画アクション、保存済み Cloud RTL ジョブを分けてください。名前に「analyze」や「evolve」が含まれていても、入力スキーマ、ソースの場所、認証、送信、結果の扱いは異なります。