Human UX Guide

Human UX Guide

pwcli-core treats conversational UI as a control plane. The user should see what the system inferred, what panel or route will hydrate, what costs or risks matter, and what will happen after approval.

Disclosure Modes

• Basic: read-only or reversible work can move quickly, but should leave a clear receipt.
• Intermediate: show intent, confidence, side-effect level, candidate primitive, costs, risks, and approval before consequential work.
• Advanced: expose full payloads, source records, interpretation, provenance, fallback route, execution target, and rollback policy.

Primitive UX Fields

The primitive schema now supports optional UX metadata:

• primaryAction
• previewFields
• riskLabels
• costFields
• emptyState
• loadingState
• errorState
• undoPolicy

These fields do not execute behavior. They make preview and approval UI predictable.