CLI のコマンド体系

概要

このページは、ネイティブ CLI、顧客向けアクションマニフェスト、バックエンド別の接続を一覧化します。ローカル設計の作業には、エンジンコマンド、サービス操作には、ジョブと Cloud コマンドを使います。例は 0.1.9 のインターフェースに適用されます。

2 つのパーサー、1 つのバイナリー

ネイティブパーサーは、release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls、computeを処理します。また、analyze runと、Evolve の明示的な形式である capabilities, analyze, run, cx-search, measured-ppa、artifactも処理します。残りの顧客向けコマンドは、組み込みのアクションマニフェストを使います。mcp serveは stdio MCP サーバーを起動します。

この振り分けで解消される制約

eda inspect, reports parse, ide initと、列挙された Evolve 形式は、ネイティブに振り分けられるコマンドです。その提供状況は、旧アーカイブでのディスパッチ欠落によって制限されなくなりました。対応する入力や操作は、引き続きエンジンの機能が決めます。

顧客向けの単語 1 つの evolveアクションは、ネイティブの evolve runとcompute rtl-evolveとは別です。リクエストスキーマは相互に置き換えられません。マニフェストの単語 1 つの traceアクションは、引き続きネイティブの trace名前空間に隠れています。マニフェストに列挙されているからといって同じ CLI 表記が使えるとは考えず、ネイティブのサブコマンドを使ってください。

グローバルフラグ

ネイティブの構造化出力には、先頭の --jsonを使います。例：alti --json xls capabilities。名前空間の前か、完全なネイティブサブコマンドの後に置き、振り分けられる Evolve 形式の単語の間には置かないでください。トップレベルの概要には、alti --help、受け付ける引数と上限には、末端の操作で --helpを使います。ネイティブの末端コマンドは、-hも受け付けます。

JSON 出力はコマンドごとに異なります。エンジンのエンベロープは子プロセスの結果を文字列として含み、サービスコマンドは実行記録を返し、ターミナル接続はバイトをストリーム出力します。詳しくは、コマンドリファレンスを参照してください。

メタ情報とアカウントのコマンド

Cloud セッションと、従来の環境変数の認証情報は別です。詳しくは、CLI 認証を参照してください。

終了コード

特定のコマンド契約で復旧アクションが定義されていない限り、ゼロ以外の結果はすべて失敗として扱ってください。解析／受け入れは一般に 2、ランタイムと HTTP の失敗は 1、利用できないエンジンは 127、不正なインストール済み実行や起動失敗は 126を返します。エンジンは独自の状態をそのまま返す場合があります。顧客向けマニフェストは、別に 3をクラス拒否、4をディスパッチ前の拒否に使います。状態番号だけでは、その発生元は分かりません。

実行場所

–runner を持つサブコマンド

互換コマンドの rtl compile, rtl synthesize, physical run, px analyze、isa runのデフォルトは localです。これらのコマンドで cloudまたは privateを選ぶと、雛形のディスパッチ計画を出力します。リモート実行ではありません。これらのコマンドの --エンジン引数は、ローカルディスパッチの場合にだけ受け付けます。

一方、job系列の --runnerは Job Service を選び、別の契約です。廃止された alti-engine-jobアダプターは、リリースに含まれる 24 ランナーの一覧にありません。受け付ける local/private構文を、提供済みサービスと解釈してはいけません。

ローカルエンジンの検出方法

インストールされたリリースの構成を維持してください。XLS、compute、packed RTL、native DDS、型付き PX／CX 経路には、それぞれ指定された隣接実行ファイルが必要です。インストールの信頼チェックは、保護されたランナーをカタログのハッシュと記録に関連付けます。PATHへのフォールバックや、ユーザー提供の記録で、この境界を修復することはできません。古い互換リゾルバーは、siblingまたは pathを報告する場合があります。実際に実行した操作の記録を確認してください。Icarus などの外部ツールには、別のホスト設定があります。

各名前空間に対応するエンジン

ペイロードには、alti, alti-mcpと、以下の 24 個のエンジンランナーが含まれます：

alti-rtl-runnerは同梱されません。それを要求する確定 ID の互換コマンドは、ヘルプがあるだけでは対応機能になりません。ide openが使うデスクトップ実行ファイルは、別途配布されます。

実行記録のエンベロープ

エンジンエンベロープの stdoutは、ネイティブ結果を含む文字列です。--jsonを使わない場合、そのネイティブ出力を直接保存し、対応する DDS apply コマンドにそのまま渡せます。作成計画をハッシュだけに縮めてはいけません。

環境変数

ネイティブ Cloud は、--session-dirを使い、デフォルトは ~/.local/state/altifigence/cloud-cliです。デスクトップセッションファイルをコピーしたり、トークンをログに記録したり、任意のエンドポイントにサービスシークレットを送ったりしないでください。

エンジンの結果

実際のエンジン結果とその上限を読んでください。GPU の検出は GPU 実行ではなく、内容ダイジェストは署名ではなく、サインオフではないタイミング見積もりは実装サインオフではありません。次のページには、関連するエンジンコマンドが掲載されています。

スクリプト化する前にコマンドを確認する

alti --version
alti --help
alti ide cloud --help
alti xls run --help

実行する正確な末端コマンドのヘルプを確認してください。alti commandsに同じ名前があっても、ネイティブパーサーのヘルプ、インストール済みの機能、ランタイムの提供状況に代わるものではありません。リクエストスキーマと記録はバージョン管理されるため、スクリプトとともに CLI バージョンを保持します。