온보딩 및 설정 프로토콜
목적: CLI, macOS 앱 및 Web UI 전반에 걸친 공유 온보딩 + 설정 인터페이스.
구성 요소
- Wizard 엔진 (공유 session + 프롬프트 + 온보딩 상태)
- CLI 온보딩은 UI 클라이언트와 동일한 wizard 플로우 사용
- Gateway RPC는 wizard + 설정 schema 엔드포인트 노출
- macOS 온보딩은 wizard 단계 모델 사용
- Web UI는 JSON Schema + UI 힌트에서 설정 폼 렌더링
Gateway RPC
- wizard.start 매개변수: \{ mode?: "local"|"remote", workspace?: string \}
- wizard.next 매개변수: \{ sessionId, answer?: \{ stepId, value? \} \}
- wizard.cancel 매개변수: \{ sessionId \}
- wizard.status 매개변수: \{ sessionId \}
- config.schema 매개변수: \{\}
응답 (구조):
- Wizard: \{ sessionId, done, step?, status?, error? \}
- Config schema: \{ schema, uiHints, version, generatedAt \}
UI 힌트
- uiHints는 경로로 키가 지정됨; 선택적 메타데이터 (label/help/group/order/advanced/sensitive/placeholder)
- 민감한 필드는 비밀번호 입력으로 렌더링; redaction 레이어 없음
- 지원되지 않는 schema 노드는 원시 JSON 편집기로 폴백
참고 사항
- 이 문서는 온보딩/설정 프로토콜 리팩토링을 추적하는 유일한 장소입니다