Agentic AI Atlasby a5c.ai
OverviewWikiGraphFor AgentsEdgesSearchWorkspace
/
GitHubDocsDiscord
iiRecord
Agentic AI Atlas · GAP-UX-001c: Permission and Breakpoint Approval UI
page:docs-harness-features-backlog-gaps-user-experience-gap-ux-001ca5c.ai
Search record views/
Record · tabs

Available views

II.Record viewspp. 1 - 1
overviewarticlejsongraph
III.Related pagespp. 1 - 1
II.
Page reference

page:docs-harness-features-backlog-gaps-user-experience-gap-ux-001c

Reading · 2 min

GAP-UX-001c: Permission and Breakpoint Approval UI reference

Rich terminal UI for breakpoint approvals with context display, risk assessment,

Pagewiki/docs/harness-features-backlog/gaps/user-experience/GAP-UX-001c.mdOutgoing · 0Incoming · 1

GAP-UX-001c: Permission and Breakpoint Approval UI

FieldValue
Categoryuser-experience
PriorityHigh
EffortM
StatusPartial

Description

Rich terminal UI for breakpoint approvals with context display, risk assessment, option selection, and history. Replace the current readline-based interaction with an Ink-rendered approval dialog.

CC Reference

CC has 29 files in src/components/permissions/:

FileWritePermissionRequest/, WebFetchPermissionRequest/, etc.

  • PermissionDialog.tsx -- base dialog with approve/deny/always-approve
  • PermissionPrompt.tsx -- prompt with explanation
  • PermissionRequest.tsx -- request container
  • PermissionExplanation.tsx -- why this permission is needed
  • PermissionRuleExplanation.tsx -- which rule matched
  • PermissionDecisionDebugInfo.tsx -- debug info for decisions
  • Per-tool permission UIs: BashPermissionRequest/, FileEditPermissionRequest/,
  • Worker-specific: WorkerBadge.tsx, WorkerPendingPermission.tsx

Current State

Breakpoint interaction uses packages/sdk/src/interaction/ which is raw readline with arrow-key selectors. No context display beyond the question text. No risk visualization. No auto-approval rule explanation. The auto-approval system (packages/sdk/src/breakpoints/) computes recommendations but they are not surfaced in the UI.

Target State

An Ink-based BreakpointApproval component that renders:

Code
┌─ Breakpoint: Review gap audit results ──────────────────────┐
│                                                               │
│ 52 removed, 25 reframed, 16 merged, 40 kept.                │
│ Review and approve?                                           │
│                                                               │
│ Context:                                                      │
│   Removed: GAP-TOOLS-001 (File Read Tool) -- host harness    │
│            GAP-UX-002 (Voice Mode) -- host harness            │
│            ... 50 more                                        │
│                                                               │
│ Auto-approval: Not recommended (no matching rule)             │
│ Consecutive approvals: 0                                      │
│                                                               │
│ > [Approve]  [Request changes]  [Always approve this type]   │
└───────────────────────────────────────────────────────────────┘

Shows: breakpoint context, auto-approval recommendation with reason, matched rule (if any), consecutive approval count, risk indicators, selectable options with keyboard navigation.

Dependencies

  • GAP-UX-001 -- Ink rendering foundation
  • GAP-BRK-001 -- approval chains

Key Files

ComponentPath
Interaction modulepackages/sdk/src/interaction/
Breakpoints modulepackages/sdk/src/breakpoints/
CC referencesrc/components/permissions/

Recommendation

Phase 2. Replace interaction module's readline with Ink renderer. Start with breakpoint approval since it's the highest-frequency user interaction in orchestration. Surface auto-approval data from task.json in the dialog.

Article source

The article body is owned directly by this record.

Related pages

No related wiki pages for this record.

Shortcuts

Open overview
Open JSON
Open graph