@orizm/cli 3.1.0 → 3.3.0-beta.0

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>` でファイルに保存するか、パイプ・リダイレクトで受け取ってください。

package/dist/docs/features/cli/project-linking.md

@@ -0,0 +1,58 @@
+<!-- source: docs/src/app/features/cli/project-linking/page.mdx -->
+
+# プロジェクトのリンク
+
+多くのコマンドは、操作対象のプロジェクトを必要とします。Orizm CLI は作業ディレクトリを特定のプロジェクトに「リンク」しておくことで、コマンドのたびにプロジェクト名を指定しなくて済むようにします。
+
+## `.orizm/project.json`
+
+リンク情報は、リポジトリ内の `.orizm/project.json` に保存されます。
+
+```json filename=".orizm/project.json"
+{
+  "projectName": "my-project",
+  "organizationName": "my-organization"
+}
+```
+
+CLI は、コマンドを実行したディレクトリから親方向にたどって最寄りの `.orizm/project.json` を探します。そのため、リポジトリのサブディレクトリから実行してもリンクが効きます。
+
+> [!NOTE]
+> `.orizm/` は `.gitignore` に追加することを推奨します。これにより、開発者ごとに別のプロジェクト（個人のステージング環境など）へリンクできます。`orizm link` は初回リンク時に `.gitignore` への追記を提案します。
+
+## ディレクトリをリンクする
+
+```sh copy
+orizm link
+```
+
+2 ステップの対話で、所属組織を選び、その組織のプロジェクトを選びます。選択結果が `.orizm/project.json` に書き込まれます。`orizm link` は対話的な操作のため、ターミナル（TTY）が必要です。
+
+プロジェクト未リンクのディレクトリでプロジェクトを必要とするコマンドを実行した場合も、ターミナルであればその場でリンクの選択を求められ、そのままコマンドが続行します。
+
+## プロジェクトの解決順序
+
+プロジェクトを対象とするコマンドは、次の順序で対象を決めます。
+
+1. `--project <name>` フラグ（その実行だけ上書き）
+2. 環境変数 `ORIZM_PROJECT`
+3. 最寄りの `.orizm/project.json` の `projectName`
+
+いずれでも解決できず、かつターミナルでない場合は、エラーで終了します。
+
+## 組織の解決順序
+
+`orizm project list` や `orizm project create` のように、プロジェクトではなく組織を対象とするコマンドは、次の順序で組織を決めます。
+
+1. `--organization <name>` フラグ
+2. `.orizm/project.json` の `organizationName`
+
+組織名を指定する環境変数はありません。CI で組織を指定する場合は `--organization` を使ってください。
+
+## CI でのプロジェクト指定
+
+CI では `.orizm/project.json` をコミットしない構成が一般的です。その場合は `ORIZM_PROJECT` で対象を指定します。
+
+```sh copy
+ORIZM_PROJECT=my-project pnpm exec orizm schema push --yes
+```

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

@@ -0,0 +1,83 @@
+<!-- source: docs/src/app/features/cli/quickstart/page.mdx -->
+
+# クイックスタート
+
+Orizm CLI をインストールしてから、スキーマを適用し SDK の型を生成するまでの最短経路を説明します。
+
+### インストール
+
+プロジェクトに `@orizm/cli` を devDependency として追加します。
+
+```sh npm2yarn copy
+npm install --save-dev @orizm/cli
+```
+
+以降の例では `orizm` を直接呼び出しますが、パッケージマネージャー経由なら `pnpm exec orizm ...` のように実行します。
+
+### 接続先を確認する
+
+既定の接続先は本番環境（`https://app.orizm.com`）です。ローカルやステージングのサーバーに向ける場合は `ORIZM_BASE_URL` を設定します。
+
+```sh copy
+export ORIZM_BASE_URL=http://localhost:4000
+```
+
+設定できる環境変数は [環境変数と接続先](./configuration.md) を参照してください。
+
+### サインインする
+
+ブラウザが開き、OAuth2 でサインインします。完了するとトークンがローカルに保存され、以降のコマンドで使われます。
+
+```sh copy
+orizm auth login
+```
+
+```sh copy
+orizm auth status
+```
+
+`orizm auth status` で、誰として・どの接続先にサインインしているかを確認できます。
+
+> [!NOTE]
+> CI や自動化スクリプトではブラウザを開けません。その場合は `ORIZM_API_KEY` に
+> Developer API キーを設定してサインインを省略します。詳しくは
+> [認証](./authentication.md) を参照してください。
+
+### ディレクトリをプロジェクトにリンクする
+
+組織とプロジェクトを対話的に選ぶと、`.orizm/project.json` が作成されます。以降のコマンドはこのプロジェクトを既定の対象にします。
+
+```sh copy
+orizm link
+```
+
+### スキーマを適用する
+
+`orizm.config.ts` にスキーマを定義し、サーバーに適用します。スキーマの書き方は [スキーマ](../schema/about.md) を参照してください。
+
+適用前に差分を確認したいときは `--dry-run` を付けます。
+
+```sh copy
+orizm schema push --dry-run
+```
+
+差分を確認したら適用します。
+
+```sh copy
+orizm schema push
+```
+
+### SDK の型を生成する
+
+適用したスキーマから、CMS SDK / Consumer SDK 用の型コードを生成します。
+
+```sh copy
+orizm codegen cms
+orizm codegen consumer
+```
+
+## 次のステップ
+
+- 各コマンドの詳細: [コマンドリファレンス](./commands.md)
+- 認証の仕組みと API キーの使い方: [認証](./authentication.md)
+- `--json` での出力や CI での利用: [出力とスクリプティング](./output.md)

package/dist/docs/features/cli.md

@@ -0,0 +1,56 @@
+<!-- source: docs/src/app/features/cli/page.mdx -->
+
+# Orizm CLI
+
+Orizm CLI（`orizm`）は、Orizm のプロジェクトをターミナルから操作する開発者向けのコマンドラインツールです。スキーマの適用、SDK の型生成、コンテンツ・APIキー・ユーザー・バケット・Webhook の管理までを、ひとつのコマンドで扱えます。
+
+```sh npm2yarn copy
+npm install --save-dev @orizm/cli
+```
+
+インストールすると `orizm` コマンドが使えます。パッケージマネージャー経由で実行する場合は `pnpm exec orizm ...` や `npx orizm ...` のように呼び出します。
+
+> [!NOTE]
+> v2 から移行する場合は、コマンド体系と認証方式が変わっています。[CLI移行ガイド
+> (v2→v3)](../resources/cli-v2-to-v3-migration-guide.md) を参照してください。
+
+## 基本的な流れ
+
+Orizm CLI は「**認証する → ディレクトリをプロジェクトにリンクする → 操作する**」の 3 ステップで使います。
+
+1. **認証** — `orizm auth login` でブラウザからサインインします。CI など自動化環境では `ORIZM_API_KEY` を使います。詳しくは [認証](./cli/authentication.md) を参照してください。
+2. **リンク** — `orizm link` で、作業ディレクトリを操作対象のプロジェクトに結び付けます。以降のコマンドはこのプロジェクトを既定の対象にします。詳しくは [プロジェクトのリンク](./cli/project-linking.md) を参照してください。
+3. **操作** — `orizm schema push` や `orizm content list` など、目的のコマンドを実行します。
+
+はじめて使うときは [クイックスタート](./cli/quickstart.md) が最短経路です。
+
+## コマンドの全体像
+
+コマンドは `orizm <名詞> <動詞>` の形に統一されています（例: `orizm schema push`、`orizm key consumer list`）。各カテゴリーの詳細は [コマンドリファレンス](./cli/commands.md) を参照してください。
+
+| カテゴリー | コマンド | 用途 |
+| --- | --- | --- |
+| [auth](./cli/commands/auth.md) | `orizm auth login` / `logout` / `status` | サインインとセッション確認 |
+| [link](./cli/commands/link.md) | `orizm link` | ディレクトリとプロジェクトの結び付け |
+| [org](./cli/commands/org.md) | `orizm org list` | 所属組織の一覧 |
+| [project](./cli/commands/project.md) | `orizm project list` / `get` / `create` / `update` / `delete` | プロジェクトのライフサイクル |
+| [schema](./cli/commands/schema.md) | `orizm schema push` / `list` / `get` / `validate` / `erd` | スキーマ定義の適用と参照 |
+| [codegen](./cli/commands/codegen.md) | `orizm codegen cms` / `consumer` | SDK 型コードの生成 |
+| [key](./cli/commands/key.md) | `orizm key consumer ...` / `orizm key management ...` | APIキーの管理 |
+| [project-user](./cli/commands/project-user.md) | `orizm project-user ...` | プロジェクトユーザー（RBAC）の管理 |
+| [content](./cli/commands/content.md) | `orizm content list` / `get` / `create` / `update` / `delete` | テーブルコンテンツの操作 |
+| [bucket](./cli/commands/bucket.md) | `orizm bucket list` / `orizm bucket object ...` | バケットとオブジェクトの操作 |
+| [webhook](./cli/commands/webhook.md) | `orizm webhook list` / `get` / `create` / `update` / `delete` | Webhook の管理 |
+| [agent](./cli/commands/agent.md) | `orizm agent init` | AI コーディングエージェント連携（同梱 docs への参照設定） |
+
+## グローバルフラグ
+
+すべてのコマンドで次のフラグが使えます。
+
+| フラグ | 説明 |
+| --- | --- |
+| `--json` | 結果を機械可読な JSON で標準出力に出します。 |
+| `--debug` | デバッグログを標準エラー出力に出します（環境変数 `ORIZM_DEBUG` でも有効化できます）。 |
+| `--no-color` | カラー出力を抑制します（環境変数 `NO_COLOR` も尊重します）。 |
+
+プロジェクトを対象とするコマンドでは、対象を一時的に切り替える `--project <name>` も使えます。出力の扱いやスクリプトでの利用については [出力とスクリプティング](./cli/output.md) を参照してください。

package/dist/docs/features/cms-sdk/account.md

@@ -0,0 +1,122 @@
+<!-- source: docs/src/app/features/cms-sdk/account/page.mdx -->
+
+# アカウントの操作
+
+CMS SDKでログインユーザーのアカウントの操作方法を説明します。以下の内容を解説します。
+
+- ログイン
+- ログアウト
+- セッション状態の確認
+- ユーザー情報の取得
+- ユーザー情報の更新
+- メールアドレスの変更
+- パスワードの変更
+- アカウントページURLの取得
+
+## ログイン
+
+next-auth の `signIn()` 関数を使用してログインを実装します。
+
+```tsx copy
+import { signIn } from "next-auth/react";
+
+const handleSignIn = () => signIn();
+
+<button onClick={handleSignIn}>ログイン</button>;
+```
+
+## ログアウト
+
+next-auth の `signOut()` と `logoutOrizm()` を利用してログアウトを実装します。
+
+```tsx copy
+import { signOut } from "next-auth/react";
+import { logoutOrizm } from "@orizm/cms-sdk";
+
+const handleSignOut = async () => {
+  await signOut();
+  logoutOrizm("your-project-name");
+};
+
+<button onClick={handleSignOut}>ログアウト</button>;
+```
+
+## セッション状態の確認
+
+next-auth の `useSession()` フックで現在のログイン状態を確認できます。
+
+```tsx copy
+import { useSession } from "next-auth/react";
+
+const { status } = useSession();
+
+if (status === "loading") {
+  return <p>Loading...</p>;
+}
+if (status === "unauthenticated") {
+  return <p>Not logged in</p>;
+}
+return <p>Logged in</p>;
+```
+
+## ユーザー情報の取得
+
+`userinfo.userinfo()` で現在ログインしているユーザーの情報を取得できます。
+
+```tsx copy
+const data = await client.userinfo.userinfo();
+```
+
+## ユーザー情報の更新
+
+`userinfo.update()` でユーザーの表示名を更新できます。
+
+```tsx copy
+const data = await client.userinfo.update({
+  name: "John Doe",
+});
+```
+
+## メールアドレスの変更
+
+Orizmのアカウントページを通じてメールアドレスを変更することができます。  
+アカウントページへのリンクを設置する方法は [アカウントページURLの取得](./account.md#アカウントページURLの取得) を参照してください。
+
+アカウントページ経由ではなく、直接APIを使用してメールアドレスを変更することも可能です。  
+`userinfo.changeEmail()` を使用して、ユーザーのメールアドレスを変更します。
+
+```tsx copy
+const data = await client.userinfo.changeEmail({
+  email: "new-email@example.com",
+});
+```
+
+## パスワードの変更
+
+Orizmのアカウントページを通じてパスワードを変更することができます。  
+アカウントページへのリンクを設置する方法は [アカウントページURLの取得](./account.md#アカウントページURLの取得) を参照してください。
+
+アカウントページ経由ではなく、直接APIを使用してパスワードを変更することも可能です。  
+`userinfo.changePassword()` を使用して、ユーザーのパスワードを変更します。
+
+```tsx copy
+const data = await client.userinfo.changePassword({
+  currentPassword: "current-password",
+  newPassword: "new-password",
+});
+```
+
+## アカウントページURLの取得
+
+`getOrizmAccountPageURL()` を使用して、ユーザーがアカウント情報を管理できるOrizmアカウントページへのURLを生成できます。  
+アカウントページではメールアドレスとパスワードの変更が可能です。
+
+```tsx copy
+import { getOrizmAccountPageURL } from "@orizm/cms-sdk";
+
+const accountPageURL = getOrizmAccountPageURL();
+
+<a href={accountPageURL} target="_blank" rel="noopener noreferrer">
+  アカウント設定
+</a>;
+```