hungry-ghost-hive 0.39.3 → 0.40.0

package/README.md

@@ -9,19 +9,26 @@
 
 <img width="1263" height="651" alt="image" src="https://github.com/user-attachments/assets/76eb8bd9-d5ec-45b7-9ee2-b7ef910f3e88" />
 
-Hive is a CLI tool that orchestrates AI agents modeled after agile software development teams. You act as the **Product Owner**, providing requirements. Hive's AI agents handle the rest—from planning through to PR submission.
+Hive is a CLI tool that orchestrates AI agents modeled after agile software development teams. You act as the **Product Owner**, providing requirements. Hive's AI agents handle the rest — from planning through to merged pull requests.
 
 ## Key Features
 
 - **AI-Powered Team Management**: Orchestrate autonomous teams of AI agents across multiple repositories
-- **Agile Workflow**: Natural hierarchy mirrors real development teams with Tech Lead, Seniors, Intermediates, and Juniors
+- **Agile Workflow**: Natural hierarchy mirrors real development teams with Tech Lead, Seniors, Intermediates, Juniors, and QA agents
 - **Requirement to PR Automation**: From initial requirements to merged pull requests, fully automated
-- **Intelligent Task Distribution**: Stories automatically routed to appropriate skill levels (Junior, Intermediate, Senior)
-- **Real-Time Dashboard**: Monitor team progress and agent activity with an interactive TUI dashboard
-- **Multi-Repository Support**: Manage related services and libraries as coordinated git submodules
+- **Intelligent Task Distribution**: Stories automatically routed to appropriate skill levels based on complexity scoring
+- **QA Review Agents**: Dedicated QA agents auto-spawn to review PRs, run quality checks, and enforce acceptance criteria
+- **Feature Sign-Off**: Automated E2E test execution when all stories for a requirement are merged
+- **Real-Time Dashboard**: Interactive TUI dashboard with pipeline visualization, agent monitoring, PR review, and messaging
+- **Multi-Repository Support**: Manage related services and libraries as coordinated git submodules with per-agent worktree isolation
+- **Story Dependencies**: Topological dependency resolution ensures stories are completed in the right order
 - **Escalation Handling**: Built-in escalation protocol when agents need guidance or hit blockers
-- **PR Merge Queue**: Automated QA checks and merge queue management for production readiness
+- **PR Merge Queue**: Automated merge queue with QA gating, auto-merge, and duplicate PR detection
 - **Jira Integration**: Two-way sync with Jira — epics, stories, subtasks, story points, sprint assignment, and status transitions
+- **Multi-CLI Support**: Agents can use Claude Code, Codex, or Gemini CLI as their runtime
+- **Distributed Mode**: Cluster support with RAFT-based leader election, peer replication, and duplicate story detection
+- **Godmode**: Override complexity routing to use the most powerful models for all agents on a requirement
+- **Manager Intelligence**: AI-powered stuck detection, automatic permission bypass, plan mode escape, and orphan recovery
 
 ## Installation
 
@@ -98,41 +105,76 @@ You provide high-level requirements. The AI team handles everything else:
 
 ```mermaid
 graph TD
-    A["👤 YOU (Product Owner)<br/>Add feature X to the system"] --> B["🧠 TECH LEAD (Claude Opus)<br/>• Analyzes requirement<br/>• Breaks it into stories<br/>• Coordinates teams"]
-    B --> C["👥 TEAM: Alpha<br/>Senior (Sonnet)"]
-    B --> D["👥 TEAM: Beta<br/>Senior (Sonnet)"]
-    C --> C1["📊 Intermediate (Haiku)"]
-    C --> C2["🚀 Junior (GPT-4o-mini)"]
-    C --> C3["✅ QA (Sonnet)"]
-    D --> D1["📊 Intermediate (Haiku)"]
-    D --> D2["🚀 Junior (GPT-4o-mini)"]
-    D --> D3["✅ QA (Sonnet)"]
+    A["YOU (Product Owner)<br/>Add feature X to the system"] --> B["TECH LEAD (Opus)<br/>Analyzes requirement<br/>Breaks it into stories<br/>Coordinates teams"]
+    B --> C["TEAM: Alpha<br/>Senior (Opus)"]
+    B --> D["TEAM: Beta<br/>Senior (Opus)"]
+    C --> C1["Intermediate (Sonnet)"]
+    C --> C2["Junior (Haiku)"]
+    C --> C3["QA (Sonnet)"]
+    D --> D1["Intermediate (Sonnet)"]
+    D --> D2["Junior (Haiku)"]
+    D --> D3["QA (Sonnet)"]
 ```
 
 ### The Workflow
 
 1. **You submit a requirement** → `hive req "Your feature request"`
-2. **Tech Lead analyzes** → Identifies affected repos, creates stories
-3. **Seniors estimate** → Assign complexity scores, plan the work
+2. **Tech Lead analyzes** → Identifies affected repos, creates stories with dependencies
+3. **Stories are estimated** → Complexity scores assigned (Fibonacci 1-13)
 4. **Work is assigned** → Based on complexity:
    - Simple (1-3 points) → Junior
    - Medium (4-5 points) → Intermediate
-   - Complex (6-13 points) → Senior
-5. **Developers implement** → Create branches, write code, run tests
-6. **PRs submitted** → `hive pr submit` adds to merge queue
-7. **QA reviews** → Automated spawning, code review, approval
-8. **Merged!** → Story complete
+   - Complex (6+ points) → Senior
+   - Blocker stories (depended on by others) → always Senior
+5. **Developers implement** → Each agent gets an isolated git worktree, writes code, runs tests
+6. **PRs submitted** → Added to merge queue with automatic duplicate detection
+7. **QA reviews** → QA agents auto-spawn, run lint/type-check/tests, validate acceptance criteria
+8. **Auto-merged** → Approved PRs are automatically merged
+9. **Feature sign-off** → When all stories are merged, E2E tests run automatically
+
+### QA Review Agents
+
+When a developer submits a PR to the merge queue, the manager automatically spawns a QA agent to review it:
+
+- Checks out the PR branch and runs configurable quality checks (`npm run lint`, `npm run type-check`, etc.)
+- Runs the build command and test suite
+- Validates that acceptance criteria from the story are met
+- Approves and auto-merges passing PRs, or rejects with detailed feedback
+- After 3+ QA failures on the same story, escalates to a Senior agent
+
+### Feature Sign-Off
+
+When all stories for a requirement reach `merged` status:
+
+1. The manager detects the completed requirement
+2. A feature test agent is spawned to run E2E tests (configured via `e2e_test_path`)
+3. Results are posted to Jira as a sign-off report
+4. Requirement transitions to `sign_off_passed` or `sign_off_failed`
 
 ### The Manager (Micromanager Daemon)
 
 The Manager ensures agents stay productive:
 
 - **Auto-starts** when work begins
-- **Checks every 60 seconds** for stuck agents
+- **Configurable intervals** — fast poll for active work, slow poll when idle
 - **Health checks** sync agent status with tmux sessions
+- **AI-powered done detection** — uses heuristics and LLM classification to determine if agents have finished
+- **Stuck detection** — monitors screen output fingerprints to identify frozen agents
+- **Permission bypass** — automatically handles permission prompts that block agent progress
+- **Plan mode escape** — detects agents stuck in interactive plan mode and sends escape sequences
+- **Orphan recovery** — detects stories left `in_progress` by terminated agents and resets them for reassignment
+- **QA spawning** — automatically creates QA agents when PRs enter the merge queue
+- **Context freshness** — restarts long-running tech lead sessions to maintain fresh context
 - **Nudges idle agents** to check for work
 - **Forwards messages** between agents
-- **Spawns QA** when PRs need review
+
+### Story Dependencies
+
+Stories can depend on other stories. The scheduler uses topological sorting (Kahn's algorithm) to ensure:
+
+- Stories with unresolved dependencies are skipped during assignment
+- Blocker stories (that others depend on) are routed to Senior agents for priority completion
+- Circular dependencies are detected and flagged
 
 ## Commands Reference
 
@@ -142,23 +184,31 @@ The Manager ensures agents stay productive:
 # Submit a new requirement
 hive req "Implement user authentication"
 hive req --file requirements.md
+hive req --godmode "Critical security fix"     # Force Opus for all agents
+hive req --target-branch develop "My feature"  # Target a specific branch
+hive req --dry-run "Test requirement"          # Plan without spawning agents
+
+# Import from Jira epic
+hive req "https://mycompany.atlassian.net/browse/PROJ-100"
 
 # Check overall status
 hive status
+hive status --json
 
 # Open the dashboard
 hive dashboard
 
 # Dashboard controls:
-#   ↑↓        Navigate agents list
+#   Up/Down   Navigate agents list
 #   Enter     Attach to selected agent's tmux session
-#   Ctrl+B,D  Detach from tmux (returns to shell)
+#   Ctrl+B,D  Detach from tmux (returns to dashboard)
 #   Tab       Switch between panels
-#   Esc/Q     Exit dashboard
+#   Q/Ctrl+C  Exit dashboard
 
 # View escalations (agents asking for help)
 hive escalations list
 hive escalations resolve <id> --message "Here's what to do..."
+hive escalations acknowledge <id>
 
 # View/handle human approval requests
 hive approvals list
@@ -171,17 +221,25 @@ hive approvals deny <id> -m "Do not run that"
 ```bash
 # Assign stories to agents (triggers work)
 hive assign
+hive assign --dry-run  # Preview assignments without spawning
 
 # View stories
 hive stories list
 hive stories show <story-id>
 
-# Engineer-discovered refactor story (from an agent session)
-hive my-stories refactor --session <agent-session> --title "Simplify auth middleware" --description "Duplication and branching complexity in auth stack" --points 2
-
 # View agents
 hive agents list
 hive agents list --active
+hive agents inspect <agent-id>   # Detailed agent state
+hive agents logs <agent-id>      # View agent event logs
+hive agents cleanup              # Clean up dead agent resources
+
+# Resume agents from saved state
+hive resume --all
+hive resume --agent <agent-id>
+
+# Clean up orphaned resources (worktrees, lock files, dead sessions)
+hive cleanup
 ```
 
 ### Merge Queue & QA
@@ -189,13 +247,24 @@ hive agents list --active
 ```bash
 # View the merge queue
 hive pr queue
+hive pr queue --json
+
+# Submit a PR to the merge queue
+hive pr submit --story <story-id> --branch <branch-name>
+
+# Sync open GitHub PRs into the merge queue
+hive pr sync
 
 # Manually trigger QA review
 hive pr review --from <qa-session>
 
 # Approve/reject PRs
 hive pr approve <pr-id>
+hive pr approve <pr-id> --no-merge     # Approve without auto-merging
 hive pr reject <pr-id> --reason "Tests failing"
+
+# View closed/merged PRs
+hive pr closed
 ```
 
 ### Manager (Micromanager)
@@ -218,23 +287,20 @@ hive manager health
 # Nudge a specific agent
 hive manager nudge <session>
 hive manager nudge hive-senior-alpha -m "Check the failing tests"
-
-# Cluster status (when cluster.enabled=true)
-hive cluster status
-hive cluster status --json
 ```
 
-### Jira Integration
+### Project Management Integration
 
 ```bash
-# Fetch an issue by key or URL
-hive jira fetch HIVE-42
-hive jira fetch https://mycompany.atlassian.net/browse/HIVE-42
+# Provider-agnostic commands (works with Jira or other configured providers)
+hive pm fetch HIVE-42
+hive pm fetch https://mycompany.atlassian.net/browse/HIVE-42
+hive pm search "project = HIVE AND status = 'In Progress'"
+hive pm search "sprint in openSprints()" --max 20 --json
 
-# Search issues with JQL
-hive jira search "project = HIVE AND status = 'In Progress'"
-hive jira search "assignee = currentUser()" --max 20
-hive jira search "sprint in openSprints()" --json
+# Jira-specific (legacy alias, delegates to hive pm)
+hive jira fetch HIVE-42
+hive jira search "assignee = currentUser()"
 ```
 
 ### Communication
@@ -245,9 +311,59 @@ hive msg send hive-senior-alpha "Please prioritize STORY-001"
 
 # Check messages
 hive msg inbox
+hive msg inbox hive-tech-lead      # Check specific agent's inbox
+hive msg read <msg-id>             # Read a specific message
+hive msg reply <msg-id> "response" # Reply to a message
 hive msg outbox
 ```
 
+### Authentication
+
+```bash
+# Re-authenticate with providers
+hive auth --provider github  # GitHub OAuth Device Flow
+hive auth --provider jira    # Jira OAuth 2.0 (3LO)
+```
+
+### Configuration
+
+```bash
+# View/modify configuration
+hive config show
+hive config get models.senior.model
+hive config set scaling.junior_max_complexity 4
+
+# Manage teams
+hive teams list
+hive teams show <name>
+hive teams remove <name>
+```
+
+### Cluster (Distributed Mode)
+
+```bash
+hive cluster status
+hive cluster status --json
+```
+
+### Agent-Only Commands
+
+These commands are used by agents during their work sessions:
+
+```bash
+# Story management
+hive my-stories claim <story-id>
+hive my-stories complete <story-id>
+hive my-stories refactor --title "Simplify auth" --description "..." --points 2
+
+# Progress reporting (posts to Jira subtask)
+hive progress -m "Implemented auth middleware" --from <session>
+hive progress -m "All tests passing" --from <session> --done
+
+# Post implementation approach comment
+hive approach --from <session>
+```
+
 ## Architecture
 
 ### Directory Structure
@@ -257,14 +373,21 @@ my-workspace/
 ├── .hive/
 │   ├── hive.db              # SQLite database (all state)
 │   ├── hive.config.yaml     # Configuration
+│   ├── .env                 # OAuth credentials (auto-managed)
 │   ├── agents/              # Agent session states
 │   └── logs/                # Conversation logs
 ├── repos/
-│   ├── service-a/           # Git submodule
-│   └── service-b/           # Git submodule
+│   ├── service-a/           # Git submodule (shared repo)
+│   ├── team-abc-senior-1/   # Agent worktree (isolated copy)
+│   ├── team-abc-junior-1/   # Agent worktree (isolated copy)
+│   └── team-abc-qa-1/       # Agent worktree (isolated copy)
 └── README.md
 ```
 
+### Git Worktree Isolation
+
+Each agent gets its own git worktree to prevent branch conflicts when multiple agents work on the same repository simultaneously. Worktrees are created automatically during story assignment and cleaned up when agents terminate.
+
 ### Agent Sessions
 
 Each agent runs in a tmux session:
@@ -278,6 +401,17 @@ hive-qa-alpha           # QA for team "alpha"
 hive-manager            # The micromanager daemon
 ```
 
+### Agent Types
+
+| Type         | Default Model | CLI Tool | Role                                                          |
+| ------------ | ------------- | -------- | ------------------------------------------------------------- |
+| Tech Lead    | Claude Opus   | claude   | Requirement analysis, story creation, cross-team coordination |
+| Senior       | Claude Opus   | claude   | Complex stories (6+), estimation, team leadership, blockers   |
+| Intermediate | Claude Sonnet | claude   | Medium stories (4-5), implementation and testing              |
+| Junior       | Claude Haiku  | claude   | Simple stories (1-3), supervised implementation               |
+| QA           | Claude Sonnet | claude   | PR review, quality checks, acceptance criteria validation     |
+| Feature Test | Claude Sonnet | claude   | E2E test execution for feature sign-off                       |
+
 ### Story States
 
 ```mermaid
@@ -295,56 +429,94 @@ stateDiagram-v2
     merged --> [*]
 ```
 
+### Requirement States
+
+```mermaid
+stateDiagram-v2
+    [*] --> pending
+    pending --> planning
+    planning --> planned
+    planned --> in_progress
+    in_progress --> completed: All stories merged
+    completed --> sign_off: E2E tests configured
+    sign_off --> sign_off_passed: Tests pass
+    sign_off --> sign_off_failed: Tests fail
+    sign_off_passed --> [*]
+    completed --> [*]
+```
+
 ## Configuration
 
 Edit `.hive/hive.config.yaml`:
 
 ```yaml
-# Model assignments
+# Model assignments (all roles configurable)
 models:
   tech_lead:
     provider: anthropic
     model: claude-opus-4-20250514
-    cli_tool: claude
+    cli_tool: claude # claude | codex | gemini
     safety_mode: unsafe # safe = human approvals, unsafe = full automation
   senior:
     provider: anthropic
-    model: claude-sonnet-4-20250514
+    model: claude-opus-4-20250514
     cli_tool: claude
     safety_mode: unsafe
   intermediate:
     provider: anthropic
-    model: claude-haiku-3-5-20241022
+    model: claude-sonnet-4-20250514
     cli_tool: claude
     safety_mode: unsafe
   junior:
-    provider: openai
-    model: gpt-4o-mini
-    cli_tool: codex
+    provider: anthropic
+    model: claude-haiku-4-5-20251001
+    cli_tool: claude
     safety_mode: unsafe
   qa:
     provider: anthropic
     model: claude-sonnet-4-20250514
     cli_tool: claude
     safety_mode: unsafe
+  feature_test:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    cli_tool: claude
+    safety_mode: unsafe
 
 # Complexity thresholds for delegation
 scaling:
-  junior_max_complexity: 3 # 1-3 → Junior
-  intermediate_max_complexity: 5 # 4-5 → Intermediate
+  junior_max_complexity: 3 # 1-3 -> Junior
+  intermediate_max_complexity: 5 # 4-5 -> Intermediate
   senior_capacity: 20 # Story points before scaling up
   refactor:
     enabled: true
     capacity_percent: 10 # Reserve up to 10% of feature capacity for refactor stories
     allow_without_feature_work: true
 
-# QA checks
+# QA configuration
 qa:
   quality_checks:
     - npm run lint
     - npm run type-check
   build_command: npm run build
   test_command: npm test
+  scaling:
+    pending_per_agent: 2.5 # PRs per QA agent before scaling
+    max_agents: 5 # Maximum concurrent QA agents
+
+# Manager daemon tuning
+manager:
+  stuck_threshold: 300000 # 5 min before stuck detection
+  nudge_cooldown: 600000 # 10 min between nudges
+  max_stuck_nudges_per_story: 1
+  screen_static_inactivity_threshold: 600000
+
+# Merge queue
+merge_queue:
+  max_age_hours: 1 # Stale PR threshold
+
+# E2E testing for feature sign-off
+e2e_test_path: tests/e2e # Optional: enables feature sign-off
 
 # Optional distributed mode (HTTP + peer replication)
 cluster:
@@ -353,18 +525,14 @@ cluster:
   listen_host: 127.0.0.1
   listen_port: 8787
   public_url: http://203.0.113.10:8787
-  # Required if listen_host is not loopback (127.0.0.1/localhost/::1)
   # auth_token: replace-with-strong-shared-secret
   peers:
     - id: node-b
       url: http://198.51.100.20:8787
-    - id: node-c
-      url: http://192.0.2.30:8787
   heartbeat_interval_ms: 2000
   election_timeout_min_ms: 3000
   election_timeout_max_ms: 6000
   sync_interval_ms: 5000
-  request_timeout_ms: 5000
   story_similarity_threshold: 0.92
 ```
 
@@ -417,14 +585,16 @@ When a requirement is synced to Jira, Hive will:
 - Move stories into the active sprint on the configured board
 - Create issue links for story dependencies
 - Transition stories through statuses as agents complete work
+- Post lifecycle comments (progress updates, sign-off reports)
 
 ### Distributed Mode
 
 - Run `hive manager start` on every host in the same cluster.
-- Each host runs manager/scheduler runtime, but only one node is elected leader at a time.
+- Each host runs manager/scheduler runtime, but only one node is elected leader at a time (RAFT consensus).
 - Leader is the only node allowed to run orchestration decisions (`assign`, scheduler loops, tech lead spawn).
 - Followers stay in sync and do not schedule work.
 - State replication is logical row/event sync over HTTP (no centralized DB).
+- Duplicate story detection across nodes using configurable similarity threshold.
 
 ## Escalation Protocol
 
@@ -432,11 +602,13 @@ When agents get stuck, they escalate:
 
 ```mermaid
 graph LR
-    A["🚀 Junior<br/>Stuck on issue"] --> B["👔 Senior<br/>Cannot resolve"]
-    B --> C["🧠 Tech Lead<br/>Escalates higher"]
-    C --> D["👤 YOU<br/>Human guidance"]
+    A["Junior<br/>Stuck on issue"] --> B["Senior<br/>Cannot resolve"]
+    B --> C["Tech Lead<br/>Escalates higher"]
+    C --> D["YOU<br/>Human guidance"]
 ```
 
+QA agents escalate to Seniors after 3+ review failures on the same story.
+
 Check escalations:
 
 ```bash
@@ -454,7 +626,9 @@ hive escalations resolve ESC-001 --message "Use OAuth2 with PKCE flow"
 1. **Be specific in requirements** - The more detail, the better the stories
 2. **Check the dashboard** - `hive dashboard` shows real-time progress
 3. **Monitor escalations** - Agents will ask when they need guidance
-4. **Trust the process** - Let agents work, they'll handle the details
+4. **Use godmode for critical work** - `hive req --godmode` uses top-tier models across the board
+5. **Import from Jira** - Pass a Jira epic URL to `hive req` to import directly
+6. **Trust the process** - Let agents work, they'll handle the details
 
 ## Troubleshooting
 
@@ -471,6 +645,12 @@ hive manager health  # Sync status with tmux
 hive manager health  # Cleans up dead agents, respawns as needed
 ```
 
+### Orphaned resources (stale worktrees, lock files)
+
+```bash
+hive cleanup         # Cleans up worktrees, lock files, dead sessions, orphaned stories
+```
+
 ### View agent logs
 
 ```bash
@@ -478,10 +658,17 @@ tmux attach -t hive-senior-alpha  # Attach to see what agent is doing
 # Detach with Ctrl+B, D
 ```
 
+### Resume interrupted agents
+
+```bash
+hive resume --all           # Resume all agents from saved state
+hive resume --agent <id>    # Resume a specific agent
+```
+
 ### Reset everything
 
 ```bash
-hive nuke --all  # WARNING: Deletes all data
+hive nuke --all  # WARNING: Deletes all data including worktrees
 ```
 
 ## Contributors
@@ -507,7 +694,7 @@ We appreciate contributions from everyone! This project is built and maintained
 
 Hive is built with production-grade quality standards:
 
-- **Comprehensive Testing**: 1140+ test cases with automated test execution
+- **Comprehensive Testing**: 1700+ test cases with automated test execution
 - **Strict TypeScript**: Full type safety with no implicit any
 - **Code Linting**: ESLint configuration enforces consistent code style
 - **Conventional Commits**: Commit messages follow the conventional commits specification for automatic changelog generation
@@ -554,7 +741,7 @@ We welcome contributions! Here's how to get started:
 
 ```bash
 ANTHROPIC_API_KEY=sk-ant-...  # Required for Claude agents
-OPENAI_API_KEY=sk-...         # Required for GPT agents (juniors)
+OPENAI_API_KEY=sk-...         # Required if using OpenAI-based agents
 GITHUB_TOKEN=ghp_...          # Required for PR creation
 
 # Jira (auto-managed in .hive/.env after `hive init` or `hive auth jira`)
@@ -562,50 +749,16 @@ JIRA_CLIENT_ID=...            # OAuth 2.0 client ID
 JIRA_CLIENT_SECRET=...        # OAuth 2.0 client secret
 ```
 
-## Issue Tracking (Beads)
-
-This repository uses `bd` (Beads) for issue tracking. Run `bd onboard` to get started.
-
-### Quick Reference
-
-```bash
-bd ready              # Find available work
-bd show <id>          # View issue details
-bd update <id> --status in_progress  # Claim work
-bd close <id>         # Complete work
-bd sync               # Sync with git
-```
-
-### Session Completion (Landing the Plane)
-
-When ending a work session, complete ALL steps below. Work is NOT complete until `git push` succeeds.
-
-1. File issues for remaining work
-2. Run quality gates (tests/linters/builds) if code changed
-3. Update issue status (close finished work, update in-progress)
-4. Push to remote:
-
-```bash
-git pull --rebase
-bd sync
-git push
-git status  # MUST show "up to date with origin"
-```
-
-5. Clean up (stashes, prune remote branches)
-6. Verify all changes committed AND pushed
-7. Hand off with context for next session
-
 ## License
 
 This project is licensed under the **Hungry Ghost Restricted License**. See the [LICENSE](./LICENSE) file for details.
 
 ### License Summary
 
-- ✅ You CAN use the software for any purpose, including commercial projects
-- ✅ You CAN modify the software for your own use
-- ✅ You CAN contribute improvements via pull requests
-- ❌ You CANNOT redistribute the software to others
-- ❌ You CANNOT sell or sublicense the software itself
+- You CAN use the software for any purpose, including commercial projects
+- You CAN modify the software for your own use
+- You CAN contribute improvements via pull requests
+- You CANNOT redistribute the software to others
+- You CANNOT sell or sublicense the software itself
 
 For more information, see the full [LICENSE](./LICENSE) file.

package/dist/cli/dashboard/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/dashboard/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAgCvC,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAGrD;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/dashboard/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAgCvC,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAGrD;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJlF"}

package/dist/cli/dashboard/index.js

@@ -84,7 +84,7 @@ export async function startDashboard(options = {}) {
         left: 0,
         width: '100%',
         height: 1,
-        content: ' Tab: Switch panels | ↑↓: Navigate | Enter: Attach to tmux | Ctrl+B,D: Detach | Q: Quit',
+        content: ' Tab: Switch panels | ↑↓: Navigate | Enter: Attach to agent | Q/Ctrl+C: Quit | Ctrl+B,D: Detach tmux',
         style: {
             bg: 'blue',
             fg: 'white',
@@ -140,7 +140,10 @@ export async function startDashboard(options = {}) {
     };
     scheduleRefresh();
     // Key bindings
-    screen.key(['q', 'C-c', 'escape'], () => {
+    // Note: 'escape' is intentionally excluded — tmux Ctrl+B prefix can generate
+    // escape sequences that blessed may misinterpret as an ESC keypress, which
+    // would cause the dashboard to exit unexpectedly (the "double press" bug).
+    screen.key(['q', 'C-c'], () => {
         if (currentTimeout)
             clearTimeout(currentTimeout);
         try {