Onboarding + Config-protocol¶

Doel: gedeelde onboarding- en config-oppervlakken voor CLI, macOS-app en Web UI.

Componenten¶

• Wizard-engine (gedeelde sessie + prompts + onboardingstatus).
• CLI-onboarding gebruikt dezelfde wizardflow als de UI-clients.
• Gateway RPC biedt wizard- en config-schema-eindpunten.
• macOS-onboarding gebruikt het wizard-stappenmodel.
• Web UI rendert config-formulieren op basis van JSON Schema + UI-hints.

Gateway RPC¶

• wizard.start parameters: { mode?: "local"|"remote", workspace?: string }
• wizard.next parameters: { sessionId, answer?: { stepId, value? } }
• wizard.cancel parameters: { sessionId }
• wizard.status parameters: { sessionId }
• config.schema parameters: {}

Antwoorden (structuur)

• Wizard: { sessionId, done, step?, status?, error? }
• Config-schema: { schema, uiHints, version, generatedAt }

UI-hints¶

• uiHints gesleuteld op pad; optionele metadata (label/help/group/order/advanced/sensitive/placeholder).
• Gevoelige velden worden weergegeven als wachtwoordinvoer; geen redactionele laag.
• Niet-ondersteunde schema-nodes vallen terug op de ruwe JSON-editor.

Notities¶

• Dit document is de enige plek om protocolrefactors voor onboarding/config bij te houden.