Onboarding + Config Protocol

Zweck: Gemeinsame Onboarding- und Config-Oberflächen für CLI, macOS-App und Web-UI.

Komponenten

  • Wizard-Engine (gemeinsame Session + Prompts + Onboarding-Status).
  • CLI-Onboarding nutzt denselben Wizard-Flow wie die UI-Clients.
  • Gateway RPC stellt Wizard- und Config Schema-Endpoints bereit.
  • macOS-Onboarding verwendet das Wizard-Step-Modell.
  • Web-UI rendert Config-Formulare aus JSON Schema + UI-Hints.

Gateway RPC

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

Responses (Struktur)

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

UI Hints

  • uiHints sind nach Pfad indiziert; optionale Metadaten (label/help/group/order/advanced/sensitive/placeholder).
  • Sensitive Felder werden als Passwort-Inputs gerendert; keine Redaction-Ebene.
  • Nicht unterstützte Schema-Nodes fallen zurück auf den Raw-JSON-Editor.

Hinweise

  • Dieses Dokument ist die zentrale Stelle, um Protokoll-Refactorings für Onboarding/Config zu tracken.