Protocolo de onboarding + configuración

Propósito: superficies compartidas de onboarding + configuración entre CLI, la app de macOS y la interfaz web.

Componentes

• Motor del asistente (sesión compartida + prompts + estado del onboarding).
• El onboarding por CLI usa el mismo flujo del asistente que los clientes de interfaz.
• El Gateway RPC expone endpoints de asistente + esquema de configuración.
• El onboarding de macOS usa el modelo de pasos del asistente.
• La interfaz web renderiza formularios de configuración desde JSON Schema + indicaciones de UI.

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 }
  • path acepta segmentos de configuración estándar más IDs de plugins delimitados por barras, por ejemplo plugins.entries.pack/one.config.

Respuestas (forma)

• Asistente: { sessionId, done, step?, status?, error? }
• Esquema de configuración: { schema, uiHints, version, generatedAt }
• Búsqueda de esquema de configuración: { path, schema, hint?, hintPath?, children[] }

Indicaciones de UI

• uiHints indexadas por ruta; metadatos opcionales (label/help/group/order/advanced/sensitive/placeholder).
• Los campos sensibles se renderizan como campos de contraseña; sin capa de redacción.
• Los nodos de esquema no soportados recurren al editor JSON sin formato.

Notas

• Este documento es el único lugar para rastrear refactorizaciones del protocolo de onboarding/configuración.