Study: Enumerate Application Features & Plan Quality Passes

[dhilgaertner]

Overview

Map out every major section and feature of the Crow application. Once enumerated, create a dedicated follow-up issue for each feature area covering refactoring, documentation, code review, and testing needs.

Goals

1. Enumerate all major sections/features of the application
2. For each feature, create a follow-up issue that covers:
   • Refactoring — code quality, structure, naming, dead code, performance
   • Documentation — inline docs, user-facing docs, architectural notes
   • Code Review — thorough review of current implementation for correctness, edge cases, security
   • Testing — identify key/important features that need unit, integration, or e2e tests

Feature Inventory

Core Application

• App lifecycle (startup, shutdown, window management)
• IPC / communication layer
• Configuration & settings management
• Data persistence / storage

Session Management

• Session CRUD (create, rename, delete, archive)
• Session status lifecycle (active, paused, inReview, completed, archived)
• Session metadata (tickets, links)

Worktree Management

• Git worktree creation & tracking
• Worktree ↔ session association
• Branch management & cleanup
• Orphan worktree detection & recovery

Terminal Management

• Terminal creation & lifecycle
• Terminal ↔ session association
• Send/input to terminals
• Ghostty terminal runtime integration
• Terminal readiness state machine

CLI (crow command)

• Socket communication protocol
• All subcommands and flags (29 total)
• JSON output contract / API surface
• Interactive setup wizard (crow setup)

UI

• Session list / sidebar
• Session detail view
• Terminal views
• Settings / preferences UI
• Ticket board (Kanban pipeline view)
• Allow list management view
• About window
• Setup wizard
• CorveilTheme design tokens

Integrations

• GitHub integration (issues, PRs, project boards)
• GitLab integration (issues, merge requests)
• Claude Code integration (launcher, hooks, notifications)
• VS Code integration (open worktree in editor)

Infrastructure

• Build system (Makefile, SPM)
• Ghostty framework build (Zig + Metal)
• App bundling & release packaging
• CI/CD pipelines

Follow-Up Issues

Created issues linked below.

Outcome

For each feature area identified above, create a follow-up issue using this template:

Title: Quality Pass: {Feature Area}

• Refactoring — identify and address code quality improvements
• Documentation — ensure adequate inline and user-facing docs
• Code Review — thorough review for correctness, edge cases, security
• Testing — add/improve tests for key functionality

This issue is complete once the inventory is finalized and all follow-up issues are created.

[dhilgaertner]

Feature Inventory Complete

All major feature areas have been enumerated and follow-up quality pass issues created:

Core Application

• Quality Pass: App Lifecycle & Window Management #63 — Quality Pass: App Lifecycle & Window Management
• Quality Pass: IPC / Communication Layer #65 — Quality Pass: IPC / Communication Layer
• Quality Pass: Configuration & Settings #67 — Quality Pass: Configuration & Settings
• Quality Pass: Data Persistence / Storage #68 — Quality Pass: Data Persistence / Storage

Session & Worktree

• Quality Pass: Session Management #69 — Quality Pass: Session Management
• Quality Pass: Worktree Management #70 — Quality Pass: Worktree Management

Terminal

• Quality Pass: Terminal Management #71 — Quality Pass: Terminal Management

CLI

• Quality Pass: CLI (crow command) #72 — Quality Pass: CLI (crow command)

UI

• Quality Pass: UI Views & Components #73 — Quality Pass: UI Views & Components

Integrations

• Quality Pass: GitHub / GitLab Integration #74 — Quality Pass: GitHub / GitLab Integration
• Quality Pass: Claude Code Integration #75 — Quality Pass: Claude Code Integration

Infrastructure

• Quality Pass: Build System & Infrastructure #76 — Quality Pass: Build System & Infrastructure

---

Each issue covers refactoring, documentation, code review, and testing for its feature area, with key files and areas of interest listed.