コンポーネント
- ウィザードエンジン: 共有セッション、プロンプト、およびオンボーディング状態を管理します。
- CLI オンボーディング: UI クライアント(アプリ等)と同じウィザードフローを使用します。
- ゲートウェイ RPC: ウィザード操作および構成スキーマ取得用のエンドポイントを公開します。
- macOS オンボーディング: ウィザードのステップモデルを採用しています。
- Web UI: JSON スキーマと UI ヒント(UI Hints)を元に、構成設定用のフォームを自動生成します。
ゲートウェイ RPC
wizard.startパラメータ:{ mode?: "local"|"remote", workspace?: string }wizard.nextパラメータ:{ sessionId, answer?: { stepId, value? } }wizard.cancelパラメータ:{ sessionId }wizard.statusパラメータ:{ sessionId }config.schemaパラメータ:{}config.schema.lookupパラメータ:{ path }pathは標準の構成セグメントに加え、スラッシュ区切りのプラグイン ID(例:plugins.entries.pack/one.config)を受け入れます。
- ウィザード:
{ sessionId, done, step?, status?, error? } - 構成スキーマ:
{ schema, uiHints, version, generatedAt } - スキーマ検索 (lookup):
{ path, schema, hint?, hintPath?, children[] }
UI ヒント (UI Hints)
uiHintsはパスをキーとした、オプションのメタデータ(label,help,group,order,advanced,sensitive,placeholder)です。sensitive(機密)フィールドは、UI 上ではパスワード入力としてレンダリングされます。伏せ字処理のレイヤーは別途存在しません。- 未対応のスキーマノードは、生の JSON エディターにフォールバックして表示されます。
補足事項
- 本ドキュメントは、オンボーディングおよび構成に関するプロトコルのリファクタリング状況を一元管理するためのものです。