ff97195500
Merged via squash. Prepared head SHA: 0c4d187f6fb66f2799d4047585d6368e433c883a Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com> Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com> Reviewed-by: @gumadeiras
43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
---
|
|
summary: "RPC protocol notes for onboarding wizard and config schema"
|
|
read_when: "Changing onboarding wizard steps or config schema endpoints"
|
|
title: "Onboarding and Config Protocol"
|
|
---
|
|
|
|
# Onboarding + Config Protocol
|
|
|
|
Purpose: shared onboarding + config surfaces across CLI, macOS app, and Web UI.
|
|
|
|
## Components
|
|
|
|
- Wizard engine (shared session + prompts + onboarding state).
|
|
- CLI onboarding uses the same wizard flow as the UI clients.
|
|
- Gateway RPC exposes wizard + config schema endpoints.
|
|
- macOS onboarding uses the wizard step model.
|
|
- Web UI renders config forms from JSON Schema + UI hints.
|
|
|
|
## Gateway RPC
|
|
|
|
- `wizard.start` params: `{ mode?: "local"|"remote", workspace?: string }`
|
|
- `wizard.next` params: `{ sessionId, answer?: { stepId, value? } }`
|
|
- `wizard.cancel` params: `{ sessionId }`
|
|
- `wizard.status` params: `{ sessionId }`
|
|
- `config.schema` params: `{}`
|
|
- `config.schema.lookup` params: `{ path }`
|
|
|
|
Responses (shape)
|
|
|
|
- Wizard: `{ sessionId, done, step?, status?, error? }`
|
|
- Config schema: `{ schema, uiHints, version, generatedAt }`
|
|
- Config schema lookup: `{ path, schema, hint?, hintPath?, children[] }`
|
|
|
|
## UI Hints
|
|
|
|
- `uiHints` keyed by path; optional metadata (label/help/group/order/advanced/sensitive/placeholder).
|
|
- Sensitive fields render as password inputs; no redaction layer.
|
|
- Unsupported schema nodes fall back to the raw JSON editor.
|
|
|
|
## Notes
|
|
|
|
- This doc is the single place to track protocol refactors for onboarding/config.
|