Quality Pass: App Lifecycle & Window Management

[dhilgaertner]

Parent: #53

Scope

Application startup sequence, shutdown behavior, window creation/management, setup wizard flow, scaffolding of devRoot directory structure, and runtime dependency checking.

• 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

Key Files

• Sources/Crow/App/main.swift — entry point, activation policy, app icon
• Sources/Crow/App/AppDelegate.swift — service initialization, window creation, menu bar, setup wizard trigger
• Sources/Crow/App/Scaffolder.swift — devRoot scaffolding (CLAUDE.md, skills, settings.json, prompts)
• Packages/CrowUI/Sources/CrowUI/SetupWizardView.swift — first-launch wizard (devRoot selection, workspace config, CMUX import)
• Packages/CrowUI/Sources/CrowUI/AboutView.swift — about window

Areas of Interest

• Startup sequence ordering (GhosttyApp init, config load, scaffolding, hydration, IPC server start)
• Window lifecycle (main 1200x800, settings 520x480, about 320x380, setup 520x420)
• Error handling during startup (missing devRoot, corrupt config, missing dependencies)
• Migration from legacy "rm-ai-ide" directory
• Runtime dependency detection (gh, git, claude, glab, code)