moai ast-grep / ast-edit 構造検索・置換

moai ast-grep はコードを構文木の単位でスキャンし、moai ast-edit はマッチしたコードを実際に置換します。テキストベースの grep と違い構文構造でマッチするため、空白・改行・変数名の違いに左右されません。

どちらも ast-grep CLI（sg）を利用しますが、sg が未インストールの場合の挙動は意図的に異なります。ast-grep は CI のゲートにも使う検出コマンドなので、インストール案内を stderr に出力し ゼロ以外のコードで終了 します。実行されなかったスキャンを「問題なし」と読み違えてはならないためです。ast-edit は置換コマンドで、「適用対象なし」は正常な無操作なので、案内を出して 0 で終了します。sg のインストールは ast-grep クイックスタート を参照してください。インストール状況は moai doctor でも確認できます。

読み取りと書き込みが分離されています。 ast-grep はファイルを一切変更せず、ast-edit は変更します。別コマンドなので、Bash(moai ast-grep:*) を許可しても書き込み権限までは開きません。

# プロジェクト全体をスキャン
moai ast-grep ./

# Go のみ、SARIF で出力（GitHub code scanning へのアップロード用）
moai ast-grep --format=sarif --lang=go ./internal/

# error 重大度のみ表示
moai ast-grep --severity=error ./

--dry なしで実行すると ファイルを直接変更します。 まず --dry で変更内容を確認することを推奨します。

--pattern と --rewrite を同時に指定すると、マッチしたコードをすべて置換します。片方のみの指定はエラーとして拒否されます。

# まずプレビュー
moai ast-edit --dry --pattern 'foo($A)' --rewrite 'bar($A)' --lang go ./internal/

# 確認後に実際に適用
moai ast-edit --pattern 'foo($A)' --rewrite 'bar($A)' --lang go ./internal/

--pattern なしで実行すると、ルールディレクトリを読み込み fix: フィールドを宣言したルールのみを適用します。fix: を持たないルールは検出専用のためスキップされ、その件数が報告されます。

# すべての fix: ルールを適用（プレビュー）
moai ast-edit --dry ./internal/

# 特定のルールのみ適用
moai ast-edit --rule my-rule-id ./internal/

同梱のルールセット（go/hardcoding, security/credentials, security/crypto, security/injection）はすべて 検出専用 です。自動置換が意味を変えたりコンパイルを壊したりする恐れがあるため、意図的に fix: を入れていません。自動置換が必要な場合はプロジェクト側のルールに fix: を宣言してください。

どちらのコマンドも既定で .moai/config/astgrep-rules/ を読み込みます。sgconfig.yml が有効なルールディレクトリを定義します。

• moai loop — 診断ベースの反復修正ループ
• CLI 概要