@orizm/cli 3.0.1 → 3.2.0

package/dist/docs/features/cli/commands/project-user.md

@@ -0,0 +1,108 @@
+<!-- source: docs/src/app/features/cli/commands/project-user/page.mdx -->
+
+# project-user — プロジェクトユーザー
+
+プロジェクトユーザー（CMS 側のエンドユーザー）と、その RBAC を管理します。開発者自身のアカウント管理は対象外で、Orizm Console で行います。
+
+> [!NOTE]
+> すべて認証とプロジェクトコンテキストが必要です。
+
+## `orizm project-user list`
+
+プロジェクトユーザーの一覧を表示します。
+
+```sh copy
+orizm project-user list [--limit <n>] [--offset <n>]
+```
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--limit <n>` | 取得件数（`50` / `100` / `200`）。既定は `50`。 |
+| `--offset <n>` | ページネーションのオフセット。既定は `0`。 |
+
+## `orizm project-user get`
+
+特定のプロジェクトユーザーの詳細を表示します。
+
+```sh copy
+orizm project-user get <user-id>
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<user-id>` | プロジェクトユーザーの ID。 |
+
+## `orizm project-user invite`
+
+ユーザーをメールで招待します。
+
+```sh copy
+orizm project-user invite <email> [--name <s>] [--group-role <g>:<r>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<email>` | 招待するメールアドレス。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--name <s>` | 表示名。 |
+| `--group-role <g>:<r>` | 招待時に付与する RBAC（複数指定可）。 |
+
+```sh copy
+orizm project-user invite alice@example.com --name Alice --group-role editors:writer
+```
+
+## `orizm project-user update`
+
+表示名や Group / Role を更新します。
+
+```sh copy
+orizm project-user update <user-id> [--name <s>] [--group-role <g>:<r>] [--add-group-role <g>:<r>] [--remove-group-role <g>] [--clear-group-roles]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<user-id>` | プロジェクトユーザーの ID。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--name <s>` | 表示名を変更します。 |
+| `--group-role <g>:<r>` | RBAC を全置換します（複数指定可）。 |
+| `--add-group-role <g>:<r>` | RBAC を追加します。同じ group は role を置き換えます（複数指定可）。 |
+| `--remove-group-role <g>` | group 名を指定して RBAC を削除します（複数指定可）。 |
+| `--clear-group-roles` | RBAC をすべて削除します。 |
+
+Group / Role の編集方式は [key management の Group / Role の編集](./key.md#group--role-の編集) と同じです。全置換系と編集系は同時に指定できません。
+
+## `orizm project-user delete`
+
+プロジェクトユーザーを削除します。プロジェクトユーザーはプロジェクトごとに管理されるため、削除するとそのユーザーは対象プロジェクトから完全に取り除かれ、サインインできなくなります。
+
+```sh copy
+orizm project-user delete <user-id> [--yes]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<user-id>` | プロジェクトユーザーの ID。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--yes` | 確認プロンプトをスキップします。 |

package/dist/docs/features/cli/commands/project.md

@@ -0,0 +1,106 @@
+<!-- source: docs/src/app/features/cli/commands/project/page.mdx -->
+
+# project — プロジェクト
+
+プロジェクトの作成・参照・更新・削除を行います。
+
+> [!NOTE]
+> すべて認証が必要です。`list` と `create` は[組織](../project-linking.md#組織の解決順序)を、`get` / `update` / `delete` は[プロジェクト](../project-linking.md#プロジェクトの解決順序)を対象にします。
+
+## `orizm project list`
+
+組織内のプロジェクト一覧を表示します。
+
+```sh copy
+orizm project list [--organization <name>]
+```
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--organization <name>` | 対象の組織名。省略時は `.orizm/project.json` の `organizationName` を使います。 |
+
+## `orizm project get`
+
+プロジェクトの詳細を表示します。
+
+```sh copy
+orizm project get [<name>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<name>` | プロジェクト名。省略時は現在のプロジェクトコンテキストを使います。 |
+
+## `orizm project create`
+
+プロジェクトを作成します。プロジェクト名は Orizm 全体で一意である必要があります。
+
+```sh copy
+orizm project create <name> [--organization <name>] [--display-name <s>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<name>` | 新しいプロジェクト名（一意）。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--organization <name>` | 作成先の組織名。省略時は `.orizm/project.json` の `organizationName` を使います。 |
+| `--display-name <s>` | 表示名。省略時はプロジェクト名と同じになります。 |
+
+```sh copy
+orizm project create my-project --organization my-organization --display-name "My Project"
+```
+
+## `orizm project update`
+
+プロジェクトの設定を更新します。指定したオプションの項目だけが変更されます。
+
+```sh copy
+orizm project update [<name>] [--display-name <s>] [--cms-url <url>] [--deletion-protected <true|false>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<name>` | プロジェクト名。省略時は現在のプロジェクトコンテキストを使います。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--display-name <s>` | 表示名を変更します。 |
+| `--cms-url <url>` | CMS の URL を変更します。 |
+| `--deletion-protected <value>` | 削除保護を `true` / `false` で設定します。 |
+
+## `orizm project delete`
+
+プロジェクトを削除します。配下のコンテンツごと失われる破壊的な操作です。
+
+```sh copy
+orizm project delete [<name>] [--yes]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<name>` | プロジェクト名。省略時は現在のプロジェクトコンテキストを使います。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--yes` | 確認入力をスキップします（CI 向け）。 |
+
+> [!WARNING]
+> ターミナルでは、確認のためにプロジェクト名の入力を求められます。入力が一致したときだけ削除します。非対話環境では `--yes` が必要です。

package/dist/docs/features/cli/commands/schema.md

@@ -0,0 +1,107 @@
+<!-- source: docs/src/app/features/cli/commands/schema/page.mdx -->
+
+# schema — スキーマ定義
+
+`orizm.config.ts` のスキーマをサーバーに適用したり、定義を参照・検証したりします。スキーマの書き方は [スキーマ](../../schema/about.md) を参照してください。
+
+> [!NOTE]
+> `push` / `list` / `get` は認証とプロジェクトコンテキストが必要です。`validate` / `erd` はローカルで完結するため、どちらも必要ありません。
+
+## `orizm schema push`
+
+`orizm.config.ts` を読み込んで、スキーマをプロジェクトに適用します。
+
+```sh copy
+orizm schema push [<config-file>] [--dry-run] [--yes]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<config-file>` | 設定ファイルのパス。省略時は `./orizm.config.ts`。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--dry-run` | 適用せず、変更内容だけを表示します。 |
+| `--yes` | 確認プロンプトをスキップして適用します（CI 向け）。 |
+
+適用前には変更内容が表示されます。`--dry-run` でも `--yes` でもないときは、ターミナルで確認プロンプトを出し、承認したときだけ適用します。非対話環境では `--yes` が必要です。変更が無いときは何もしません。
+
+```sh copy
+# 変更内容を確認する
+orizm schema push --dry-run
+
+# 確認なしで適用する（CI 向け）
+orizm schema push --yes
+```
+
+## `orizm schema list`
+
+スキーマ定義のバージョン一覧を表示します。
+
+```sh copy
+orizm schema list [--status <status>] [--limit <n>] [--offset <n>]
+```
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--status <status>` | `pending` / `failed` / `success` で絞り込みます（複数指定可）。 |
+| `--limit <n>` | 取得件数（`50` / `100` / `200`）。既定は `50`。 |
+| `--offset <n>` | ページネーションのオフセット。既定は `0`。 |
+
+```sh copy
+orizm schema list --status success --limit 100
+```
+
+## `orizm schema get`
+
+特定のバージョンのスキーマ定義を表示します。
+
+```sh copy
+orizm schema get <definition-id>
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<definition-id>` | スキーマ定義の数値 ID。 |
+
+## `orizm schema validate`
+
+`orizm.config.ts` をローカルで検証します。サーバーへの通信は行いません。
+
+```sh copy
+orizm schema validate [<config-file>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<config-file>` | 設定ファイルのパス。省略時は `./orizm.config.ts`。 |
+
+## `orizm schema erd`
+
+`orizm.config.ts` から ERD（Mermaid 形式）を生成します。サーバーへの通信は行いません。
+
+```sh copy
+orizm schema erd [<config-file>] [--output <path>]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<config-file>` | 設定ファイルのパス。省略時は `./orizm.config.ts`。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--output <path>`, `-o` | 出力先ファイル。省略時は標準出力に書き出します。 |

package/dist/docs/features/cli/commands/webhook.md

@@ -0,0 +1,110 @@
+<!-- source: docs/src/app/features/cli/commands/webhook/page.mdx -->
+
+# webhook — Webhook
+
+コンテンツの変更を外部 URL に通知する Webhook を管理します。
+
+> [!NOTE]
+> すべて認証とプロジェクトコンテキストが必要です。
+
+購読対象は「テーブル名:イベント種別」の形式で指定します。イベント種別は `content.create` / `content.update` / `content.delete` です。
+
+## `orizm webhook list`
+
+Webhook の一覧を表示します。
+
+```sh copy
+orizm webhook list
+```
+
+## `orizm webhook get`
+
+Webhook の詳細を表示します。
+
+```sh copy
+orizm webhook get <id>
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<id>` | Webhook の数値 ID。 |
+
+## `orizm webhook create`
+
+Webhook を作成します。
+
+```sh copy
+orizm webhook create --name <name> --url <url> [--table-event <table>:<event>] [--header <key>:<value>]
+```
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--name <name>` | （必須）Webhook 名。 |
+| `--url <url>` | （必須）通知先 URL。 |
+| `--table-event <table>:<event>` | 購読対象（複数指定可）。 |
+| `--header <key>:<value>` | 通知時に付与するカスタムヘッダ（複数指定可）。 |
+
+```sh copy
+orizm webhook create --name "notify" --url https://example.com/hook \
+  --table-event article:content.create --table-event article:content.update \
+  --header X-Token:secret
+```
+
+## `orizm webhook update`
+
+Webhook を更新します。指定したオプションの項目だけが変更されます。
+
+```sh copy
+orizm webhook update <id> [--name <s>] [--url <u>] [--table-event <t>:<e>] [--add-table-event <t>:<e>] [--remove-table-event <t>:<e>] [--clear-table-events] [--header <k>:<v>] [--add-header <k>:<v>] [--remove-header <k>] [--clear-headers]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<id>` | Webhook の数値 ID。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--name <s>` / `--url <u>` | 指定したときだけ更新します。 |
+| `--table-event <t>:<e>` | 購読対象を全置換します（複数指定可）。 |
+| `--add-table-event <t>:<e>` | 購読対象を追加します（複数指定可）。 |
+| `--remove-table-event <t>:<e>` | 購読対象を削除します（複数指定可）。 |
+| `--clear-table-events` | 購読対象をすべて削除します。 |
+| `--header <k>:<v>` | カスタムヘッダを全置換します（複数指定可）。 |
+| `--add-header <k>:<v>` | カスタムヘッダを追加します。同じ key は値を置き換えます（複数指定可）。 |
+| `--remove-header <k>` | key を指定してカスタムヘッダを削除します（複数指定可）。 |
+| `--clear-headers` | カスタムヘッダをすべて削除します。 |
+
+`tableEvents` と `customHeaders` はいずれも、全置換系（`--table-event` / `--clear-table-events`、`--header` / `--clear-headers`）と編集系（`--add-*` / `--remove-*`）を同時に指定できません。存在しない対象の削除は無視されますが、タイポに気づけるよう通知が出ます。
+
+```sh copy
+# article テーブルの delete イベントを購読に追加する
+orizm webhook update 7 --add-table-event article:content.delete
+```
+
+## `orizm webhook delete`
+
+Webhook を削除します。
+
+```sh copy
+orizm webhook delete <id> [--yes]
+```
+
+**引数**
+
+| 引数 | 説明 |
+| --- | --- |
+| `<id>` | Webhook の数値 ID。 |
+
+**オプション**
+
+| オプション | 説明 |
+| --- | --- |
+| `--yes` | 確認プロンプトをスキップします。 |

package/dist/docs/features/cli/commands.md

@@ -0,0 +1,110 @@
+<!-- source: docs/src/app/features/cli/commands/page.mdx -->
+
+# コマンドリファレンス
+
+Orizm CLI の全コマンドの一覧です。コマンドは `orizm <名詞> <動詞>` の形に統一されています。
+
+> [!NOTE]
+> 特に断りがなければ、コマンドは**認証**と**プロジェクトコンテキスト**の両方を必要とします。認証は [認証](./authentication.md)、プロジェクトの指定は [プロジェクトのリンク](./project-linking.md) を参照してください。認証・コンテキストが不要なコマンドは各ページに明記します。
+>
+> すべてのコマンドで [グローバルフラグ](../cli.md#グローバルフラグ)（`--json` / `--debug` / `--no-color`）が使えます。プロジェクトを対象とするコマンドでは `--project <name>` も使えます。
+>
+
+## 一覧
+
+### [auth](./commands/auth.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm auth login` | OAuth2 でサインインします。 |
+| `orizm auth logout` | サインアウトしてローカルのトークンを破棄します。 |
+| `orizm auth status` | 現在の認証状態を表示します。 |
+
+### [link](./commands/link.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm link` | 作業ディレクトリをプロジェクトにリンクします。 |
+
+### [org](./commands/org.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm org list` | 所属する組織の一覧を表示します。 |
+
+### [project](./commands/project.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm project list` | 組織内のプロジェクト一覧を表示します。 |
+| `orizm project get` | プロジェクトの詳細を表示します。 |
+| `orizm project create` | プロジェクトを作成します。 |
+| `orizm project update` | プロジェクトの設定を更新します。 |
+| `orizm project delete` | プロジェクトを削除します。 |
+
+### [schema](./commands/schema.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm schema push` | `orizm.config.ts` を読み込んでスキーマを適用します。 |
+| `orizm schema list` | スキーマ定義のバージョン一覧を表示します。 |
+| `orizm schema get` | スキーマ定義を表示します。 |
+| `orizm schema validate` | `orizm.config.ts` をローカルで検証します。 |
+| `orizm schema erd` | `orizm.config.ts` から ERD（Mermaid）を生成します。 |
+
+### [codegen](./commands/codegen.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm codegen cms` | CMS SDK 用の型を生成します。 |
+| `orizm codegen consumer` | Consumer SDK 用の型を生成します。 |
+
+### [key](./commands/key.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm key consumer list` / `create` / `delete` | Consumer Key を管理します。 |
+| `orizm key management list` / `create` / `update` / `delete` | Management Key を管理します。 |
+
+### [project-user](./commands/project-user.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm project-user list` | プロジェクトユーザーの一覧を表示します。 |
+| `orizm project-user get` | プロジェクトユーザーの詳細を表示します。 |
+| `orizm project-user invite` | ユーザーをメールで招待します。 |
+| `orizm project-user update` | ユーザーの表示名やロールを更新します。 |
+| `orizm project-user delete` | プロジェクトユーザーを削除します。 |
+
+### [content](./commands/content.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm content list` | テーブルのコンテンツ一覧を表示します。 |
+| `orizm content get` | コンテンツを表示します。 |
+| `orizm content create` | コンテンツを作成します。 |
+| `orizm content update` | コンテンツを更新します。 |
+| `orizm content delete` | コンテンツを削除します。 |
+
+### [bucket](./commands/bucket.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm bucket list` | バケットの一覧を表示します。 |
+| `orizm bucket object list` / `get` / `upload` / `download` / `delete` | バケット内のオブジェクトを操作します。 |
+
+### [webhook](./commands/webhook.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm webhook list` | Webhook の一覧を表示します。 |
+| `orizm webhook get` | Webhook の詳細を表示します。 |
+| `orizm webhook create` | Webhook を作成します。 |
+| `orizm webhook update` | Webhook を更新します。 |
+| `orizm webhook delete` | Webhook を削除します。 |
+
+### [agent](./commands/agent.md)
+
+| コマンド | 説明 |
+| --- | --- |
+| `orizm agent init` | 同梱ドキュメントへの参照を `AGENTS.md` / `CLAUDE.md` に設定し、AI エージェント連携を有効にします。 |

package/dist/docs/features/cli/configuration.md

@@ -0,0 +1,70 @@
+<!-- source: docs/src/app/features/cli/configuration/page.mdx -->
+
+# 環境変数と接続先
+
+Orizm CLI の挙動と接続先は、環境変数で制御します。
+
+## 環境変数の一覧
+
+| 環境変数 | 用途 | 既定値 |
+| --- | --- | --- |
+| `ORIZM_BASE_URL` | Orizm API の接続先。ローカル・ステージング・本番を切り替えます。 | `https://app.orizm.com` |
+| `ORIZM_OAUTH_ISSUER_URL` | OAuth2 認証サーバーの URL。通常は `ORIZM_BASE_URL` と同じため省略します。 | `ORIZM_BASE_URL` と同じ |
+| `ORIZM_API_KEY` | Developer API キー。OAuth2 セッションが無いときに使われます。 | （未設定） |
+| `ORIZM_PROJECT` | 対象プロジェクト名。`.orizm/project.json` の代わりに使えます。 | （未設定） |
+| `ORIZM_DEBUG` | デバッグログを有効化します（`--debug` 相当）。 | （未設定） |
+| `NO_COLOR` | カラー出力を抑制します（`--no-color` 相当）。 | （未設定） |
+
+認証への影響は [認証](./authentication.md)、プロジェクト指定は [プロジェクトのリンク](./project-linking.md)、`ORIZM_DEBUG` / `NO_COLOR` の挙動は [出力とスクリプティング](./output.md) を参照してください。
+
+## 接続先を切り替える
+
+接続先は `ORIZM_BASE_URL` で指定します。
+
+```sh copy
+# 本番（既定）
+export ORIZM_BASE_URL=https://app.orizm.com
+
+# ローカルの開発サーバー
+export ORIZM_BASE_URL=http://localhost:4000
+```
+
+OAuth2 認証サーバーは通常 `ORIZM_BASE_URL` と同じドメインのため、指定する必要はありません。ローカルで認証サーバーだけが別ポートで動いているなど、認証サーバーの URL が API と異なる場合にのみ `ORIZM_OAUTH_ISSUER_URL` を設定します。
+
+```sh copy
+export ORIZM_BASE_URL=http://localhost:4000
+export ORIZM_OAUTH_ISSUER_URL=http://localhost:4444
+```
+
+認証情報は接続先ごとに分けて保存されるため、接続先を切り替えると対応するセッションが自動的に選ばれます（[接続先ごとのセッション](./authentication.md#接続先ごとのセッション)）。
+
+## GitHub Actions での設定
+
+CI では `.orizm/project.json` をコミットしない構成が一般的なため、認証と対象プロジェクトを環境変数で渡します。ジョブの `env` にまとめておくと、そのジョブ内のすべての `orizm` コマンドで共有できます。
+
+```yaml copy filename=".github/workflows/example.yml"
+jobs:
+  push-schema:
+    runs-on: ubuntu-latest
+    env:
+      ORIZM_API_KEY: ${{ secrets.ORIZM_API_KEY }}
+      ORIZM_PROJECT: my-project
+    steps:
+      - uses: actions/checkout@v4
+      # Node.js のセットアップと依存のインストールは省略
+      - run: pnpm exec orizm schema push --yes
+```
+
+- `ORIZM_API_KEY` はリポジトリの Secrets に保存し、`${{ secrets.ORIZM_API_KEY }}` で参照します。ブラウザを開けない CI では、この API キー認証を使います（[認証](./authentication.md)）。
+- `ORIZM_PROJECT` で対象プロジェクトを指定します（[プロジェクトのリンク](./project-linking.md#ci-でのプロジェクト指定)）。
+- 本番以外（ステージングなど）に向ける場合は `ORIZM_BASE_URL` を追加します。
+
+## `.env` ファイルについて
+
+Orizm CLI は `.env` ファイルを**自動では読み込みません**。環境変数は、シェルで `export` するか、CI のジョブ定義で設定してください。
+
+`.env` ファイルにまとめておきたい場合は、`dotenv-cli` や `direnv` などのラッパーを使います。
+
+```sh copy
+dotenv -e .env -- orizm schema push
+```

package/dist/docs/features/cli/output.md

@@ -0,0 +1,53 @@
+<!-- source: docs/src/app/features/cli/output/page.mdx -->
+
+# 出力とスクリプティング
+
+Orizm CLI は、人間が読む用途とスクリプトから扱う用途の両方を想定して出力を設計しています。
+
+## 標準出力と標準エラー出力
+
+- **標準出力（stdout）** — コマンドの結果だけを出します。
+- **標準エラー出力（stderr）** — ログ・進捗・確認プロンプトなど、結果以外をすべて出します。
+
+この分離により、結果だけをファイルや他のコマンドに渡しても、進捗表示などが混ざりません。
+
+## JSON 出力
+
+`--json` を付けると、結果を機械可読な JSON で標準出力に出します。`jq` などと組み合わせると、スクリプトから値を取り出せます。
+
+```sh copy
+# 組織名の一覧を取り出す
+orizm org list --json | jq -r '.[].name'
+```
+
+```sh copy
+# 発行した Consumer Key の値だけを取り出す
+orizm key consumer create --description "web" --json --show-key | jq -r '.key'
+```
+
+## カラーとデバッグ
+
+| フラグ | 環境変数 | 説明 |
+| --- | --- | --- |
+| `--no-color` | `NO_COLOR` | カラー出力を抑制します。 |
+| `--debug` | `ORIZM_DEBUG` | デバッグログを標準エラー出力に出します。 |
+
+`--debug` は、リクエストの失敗原因など、通常は表示されない詳細を確認したいときに使います。
+
+## 終了コード
+
+成功時は終了コード 0、失敗時は 0 以外で終了します。スクリプトでは終了コードで成否を判定できます。
+
+`orizm auth status` は、未認証のとき終了コード 1 で終了します。これを利用して、未認証ならサインインする、といった分岐が書けます。
+
+```sh copy
+orizm auth status || orizm auth login
+```
+
+## 非対話環境での挙動
+
+確認プロンプトを出すコマンドや対話が前提のコマンドは、ターミナルでないときに挙動が変わります。
+
+- **破壊的な操作**（`orizm schema push`、`orizm project delete`、各種 `delete` など）は、ターミナルでは確認を求めます。非対話環境では確認できないため、`--yes` を付けないとエラーで終了します。
+- **`orizm link`** は対話的な選択が必要なため、ターミナルでないとエラーになります。CI では `ORIZM_PROJECT` または `--project` でプロジェクトを指定してください。
+- **`orizm bucket object download`** は、ターミナルに直接バイナリを書き込みません。`--output <path>` でファイルに保存するか、パイプ・リダイレクトで受け取ってください。