EPIC: TUI Safety & Permission System — PermissionsScreen & Shell Safety (v3.7.0) #5310

Open
opened 2026-04-09 05:48:51 +00:00 by HAL9000 · 3 comments
Owner

Epic: TUI Safety & Permission System

Milestone: v3.7.0
Parent Legendary: #4946 (LEGENDARY: TUI Implementation)

Background

The TUI implements safety behaviors including permission prompts for tool use, shell safety blocking, and the PermissionsScreen for reviewing and managing permissions. Defined in ADR-044.

Scope

  • PermissionsScreen as a proper Textual Screen (not Static widget)
  • PermissionQuestionWidget with v key handler to open PermissionsScreen
  • Shell safety blocking behavior (blocking vs non-blocking modes)
  • ! shell mode safety confirmation for dangerous commands
  • Permission management UI for tool use approvals
  • Safety profile display in TUI

Child Issues

  • TBD

Definition of Done

  • All child issues are closed
  • PermissionsScreen is a proper Textual Screen
  • v key opens PermissionsScreen from PermissionQuestionWidget
  • Shell safety blocking works correctly
  • Permission management UI functional
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/tui-v370/safety-permissions
  • Milestone: v3.7.0

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Epic: TUI Safety & Permission System **Milestone**: v3.7.0 **Parent Legendary**: #4946 (LEGENDARY: TUI Implementation) ### Background The TUI implements safety behaviors including permission prompts for tool use, shell safety blocking, and the PermissionsScreen for reviewing and managing permissions. Defined in ADR-044. ### Scope - `PermissionsScreen` as a proper Textual `Screen` (not `Static` widget) - `PermissionQuestionWidget` with `v` key handler to open `PermissionsScreen` - Shell safety blocking behavior (blocking vs non-blocking modes) - `!` shell mode safety confirmation for dangerous commands - Permission management UI for tool use approvals - Safety profile display in TUI ### Child Issues <!-- Updated by automation after child issues are created --> - [ ] TBD ### Definition of Done - [ ] All child issues are closed - [ ] PermissionsScreen is a proper Textual Screen - [ ] `v` key opens PermissionsScreen from PermissionQuestionWidget - [ ] Shell safety blocking works correctly - [ ] Permission management UI functional - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/tui-v370/safety-permissions` - **Milestone**: v3.7.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.7.0 milestone 2026-04-09 05:48:51 +00:00
Author
Owner

Label compliance fix applied:

  • Added missing labels: MoSCoW/Must have, Points/21
  • Reason: New Epic issue was missing MoSCoW classification and story points estimate. Applied MoSCoW/Must have based on Priority/High and TUI milestone scope. Applied Points/21 as standard Epic estimate.

Note: MoSCoW labels are normally set by the project owner. If this classification is incorrect, please update accordingly.


Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels: `MoSCoW/Must have`, `Points/21` - Reason: New Epic issue was missing MoSCoW classification and story points estimate. Applied `MoSCoW/Must have` based on Priority/High and TUI milestone scope. Applied `Points/21` as standard Epic estimate. Note: MoSCoW labels are normally set by the project owner. If this classification is incorrect, please update accordingly. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Author
Owner

Child Issues Created

  • #5335 — feat(tui): implement PermissionsScreen as proper Textual Screen and fix PermissionQuestionWidget v-key handler

Also linked UAT issues: #4851 (PermissionsScreen is Static widget), #4868 (PermissionQuestionWidget v-key not wired)


Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Child Issues Created - [ ] #5335 — feat(tui): implement PermissionsScreen as proper Textual Screen and fix PermissionQuestionWidget v-key handler **Also linked UAT issues**: #4851 (PermissionsScreen is Static widget), #4868 (PermissionQuestionWidget v-key not wired) --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Author
Owner

Child Issues — Epic #5310: TUI Safety & Permission System

Updated: 2026-04-10 (Cycle 1 — Epic Planning)

Feature Issues (foundational)

  • #5335 — feat(tui): implement PermissionsScreen as proper Textual Screen and fix PermissionQuestionWidget v-key handler (foundational — must be done first)
  • #5453 — feat(tui): implement shell safety blocking mode and ! command safety confirmation (depends on #5335)

Bug Issues (must fix)

  • #6445 — UAT: TUI permission widgets not integrated into app compose() — never shown to user
  • #6461 — UAT: TUI shell mode missing tab completion, shell history, and real-time output streaming
  • #6819 — UAT: TUI shell danger detection missing 4 spec-required pattern categories
  • #6821 — UAT: TUI shell danger detection — rm -rf and fork bomb misclassified as CRITICAL
  • #6823 — UAT: TUI shell mode blocks dangerous commands instead of advising

Total: 7 child issues (2 features + 5 bugs)

Dependency Chain: #5335#5453 → Epic #5310


Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Child Issues — Epic #5310: TUI Safety & Permission System **Updated**: 2026-04-10 (Cycle 1 — Epic Planning) ### Feature Issues (foundational) - [ ] #5335 — feat(tui): implement PermissionsScreen as proper Textual Screen and fix PermissionQuestionWidget v-key handler *(foundational — must be done first)* - [ ] #5453 — feat(tui): implement shell safety blocking mode and ! command safety confirmation *(depends on #5335)* ### Bug Issues (must fix) - [ ] #6445 — UAT: TUI permission widgets not integrated into app compose() — never shown to user - [ ] #6461 — UAT: TUI shell mode missing tab completion, shell history, and real-time output streaming - [ ] #6819 — UAT: TUI shell danger detection missing 4 spec-required pattern categories - [ ] #6821 — UAT: TUI shell danger detection — rm -rf and fork bomb misclassified as CRITICAL - [ ] #6823 — UAT: TUI shell mode blocks dangerous commands instead of advising **Total**: 7 child issues (2 features + 5 bugs) **Dependency Chain**: #5335 → #5453 → Epic #5310 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5310
No description provided.