f5ce8a9091
Complete implementation of 7 slices addressing E2E testing gaps: Slice 0+1: Wire Actions + ReasonPrompt - FocusView now uses useActions hook instead of direct act() calls - Added pendingAction state pattern for skip/defer/complete actions - ReasonPrompt integration with proper confirm/cancel flow - Tags support in DecisionEntry interface Slice 2: Drag Reorder UI - Installed @dnd-kit (core, sortable, utilities) - QueueView with DndContext, SortableContext, verticalListSortingStrategy - SortableQueueItem wrapper component using useSortable hook - pendingReorder state with ReasonPrompt for reorder reasons - Cmd+Up/Down keyboard shortcuts for accessibility - Fixed: Store item ID in PendingReorder to avoid stale queue reference Slice 3: System Tray Integration - tray.rs with TrayState, setup_tray, toggle_window_visibility - Menu with Show/Quit items - Left-click toggles window visibility - update_tray_badge command updates tooltip with item count - Frontend wiring in AppShell Slice 4: E2E Test Updates - Fixed test selectors for InboxView, Queue badge - Exposed inbox store for test seeding Slice 5: Staleness Visualization - Already implemented in computeStaleness() with tests Slice 6: Quick Wiring - onStartBatch callback wired to QueueView - SyncStatus rendered in nav area - SettingsView renders Settings component Slice 7: State Persistence - settings-store with hydrate/update methods - Tauri backend integration via read_settings/write_settings - AppShell hydrates settings on mount Bug fixes from code review: - close_bead now has error isolation (try/catch) so decision logging and queue advancement continue even if bead close fails - PendingReorder stores item ID to avoid stale queue reference E2E tests for all ACs (tests/e2e/followup-acs.spec.ts): - AC-F1: Drag reorder (4 tests) - AC-F2: ReasonPrompt integration (7 tests) - AC-F5: Staleness visualization (3 tests) - AC-F6: Batch mode (2 tests) - AC-F7: SyncStatus (2 tests) - ReasonPrompt behavior (3 tests) Tests: 388 frontend + 119 Rust + 32 E2E all passing Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
87 lines
2.4 KiB
Markdown
87 lines
2.4 KiB
Markdown
# CLAUDE.md
|
|
|
|
## Project Overview
|
|
|
|
Mission Control (MC) is an ADHD-centric personal productivity hub built with Tauri + React. It unifies GitLab activity (via gitlore) and beads task tracking into a single native interface.
|
|
|
|
**Core principle:** Surface THE ONE THING you should be doing right now.
|
|
|
|
## Key Documents
|
|
|
|
- `PLAN.md` — Complete implementation plan with architecture, ACs, and reasoning
|
|
|
|
## Tech Stack
|
|
|
|
- **Shell:** Tauri 2.0 (Rust backend)
|
|
- **Frontend:** React 19 + Vite + Tailwind + shadcn/ui
|
|
- **State:** Zustand + TanStack Query
|
|
- **Animations:** Framer Motion
|
|
|
|
## External Dependencies
|
|
|
|
MC shells out to these CLIs (does NOT import them as libraries):
|
|
|
|
- `lore --robot` — GitLab data (issues, MRs, activity)
|
|
- `br` — Beads task management (create, close, list)
|
|
- `bv --robot-*` — Beads triage recommendations
|
|
|
|
## Local State
|
|
|
|
All MC-specific state lives in `~/.local/share/mc/`:
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `gitlab_bead_map.json` | Maps GitLab events to bead IDs (deduplication) |
|
|
| `decision_log.jsonl` | Append-only log of all user decisions with context |
|
|
| `state.json` | Current focus, queue order, UI state |
|
|
| `settings.json` | User preferences |
|
|
|
|
## Key Architectural Decisions
|
|
|
|
1. **Beads are the universal task graph** — GitLab items auto-create beads via MC's bridge
|
|
2. **Manual priority first** — User sets THE ONE THING, MC logs decisions to learn patterns
|
|
3. **CLI integration over library imports** — Clean boundaries, no schema coupling
|
|
4. **Rich decision logging** — Every action logged with context and optional reasoning
|
|
|
|
## Development Commands
|
|
|
|
```bash
|
|
# Frontend dev
|
|
npm run dev
|
|
|
|
# Tauri dev (frontend + backend)
|
|
npm run tauri:dev
|
|
|
|
# Build
|
|
npm run tauri:build
|
|
|
|
# Tests
|
|
npm run test # Vitest unit tests
|
|
npm run test:watch # Watch mode
|
|
npm run test:coverage # With coverage
|
|
npm run test:e2e # Playwright e2e
|
|
cargo test # Rust tests
|
|
|
|
# Lint
|
|
npm run lint
|
|
cargo clippy -- -D warnings
|
|
```
|
|
|
|
## Keyboard Shortcuts
|
|
|
|
| Shortcut | Action |
|
|
|----------|--------|
|
|
| `Cmd+1` | Focus view |
|
|
| `Cmd+2` | Queue view |
|
|
| `Cmd+3` | Inbox |
|
|
| `Cmd+4` | Debug view |
|
|
| `Cmd+,` | Settings |
|
|
| `Ctrl+Shift+Space` | Quick capture |
|
|
|
|
## Code Quality
|
|
|
|
- Run `cargo clippy -- -D warnings` before committing Rust changes
|
|
- Run `npm run lint` before committing frontend changes
|
|
- Follow existing patterns in the codebase
|
|
- Use trait-based mocking for CLI integrations
|