hitl-approval

name	hitl-approval
description	Human-in-the-loop approval workflow for high-risk agent operations (file deletions, deployments, config changes).
user-invocable	true
argument-hint	[gate-type] [--id run-id]

Manage human-in-the-loop approval gates for ccswarm agent operations.

Gates

Gate	When Required	Risk Level
plan	Before executing multi-step plans	Medium
risky-edit	File deletions, production configs	High
deploy	Deployment actions	Critical
merge	PR merge operations	High

Commands

# Request approval
ccswarm approve $ARGUMENTS

# List pending approvals
ccswarm approve list

# Approve with comment
ccswarm approve $ARGUMENTS --id <run-id>

# Reject with reason
ccswarm approve $ARGUMENTS --id <run-id> --reject --reason "explanation"

Risk Levels

Level	Action	HITL Required
Low	Read operations	No
Medium	Local file writes	Optional
High	External modifications	Yes
Critical	Production changes	Always

All HITL decisions are logged to .ccswarm/runs/ audit trail.