Onboarding + Konfigurationsprotokoll

Zweck: gemeinsame Onboarding- und Konfigurationsoberflächen für CLI, macOS-App und Web-UI.

Komponenten

• Wizard-Engine (gemeinsame Session + Prompts + Onboarding-Zustand).
• Das CLI-Onboarding nutzt denselben Wizard-Flow wie die UI-Clients.
• Gateway-RPC stellt Wizard- und Konfigurationsschema-Endpunkte bereit.
• macOS-Onboarding nutzt das Wizard-Schrittmodell.
• Die Web-UI rendert Konfigurationsformulare 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: {}
• config.schema.lookup Parameter: { path }
  • path akzeptiert Standard-Konfigurationssegmente sowie schrägstrichgetrennte Plugin-IDs, beispielsweise plugins.entries.pack/one.config.

Antworten (Struktur)

• Wizard: { sessionId, done, step?, status?, error? }
• Konfigurationsschema: { schema, uiHints, version, generatedAt }
• Konfigurationsschema-Lookup: { path, schema, hint?, hintPath?, children[] }

UI-Hints

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

Anmerkungen

• Dieses Dokument ist der zentrale Ort, um Protokoll-Refactorings für Onboarding/Konfiguration zu verfolgen.