What problem does it solve?
Prevents investigations from running out of context or becoming stuck by providing a structured decision tree and recovery actions when token budgets are low, phase gates repeatedly block progress, or investigations deadlock and require human expertise.
Core Features & Use Cases
- Context budget detection: Detects token-budget thresholds (warning and critical) and evaluates whether remaining context can complete remaining phases.
- Prioritized recovery options: Presents ordered choices (human approval, summarize & deliver, skip or narrow research, manager handoff) with effort, impact, and success-rate guidance.
- Escalation orchestration & logging: Exposes methods to compute options, identify contacts, decide auto-recovery feasibility, and log all attempts to inv_context.json for auditability.
- Use Cases: Handling investigations that hit the 85%+ token threshold, phase gates blocked multiple times, or investigations attempted 3+ times without progression; supports TAC handoffs and managerial approval flows.
Quick Start
Ask CAPPY to evaluate investigation SF-03896040 with tokens_used 75500 and tokens_budget 85000 and present prioritized escalation options.