Feature: Director's Notes - Unified History View and AI Synopsis

[pedramamini]

Summary

Add a new "Director's Notes" feature that provides a meta-view across all Maestro-managed sessions, with a unified history view and AI-generated synopsis of work accomplished.

Motivation

Users managing multiple AI agents across different projects need a way to:

1. See all their work in one place across all sessions
2. Get an AI-generated overview of accomplishments, challenges, and next steps
3. Track patterns in their workflow over time

Feature Description

Two-Tab Modal

Tab 1: Unified History

• Aggregated history view from all agents in a single chronological list
• Reuses existing HistoryPanel components (ActivityGraph, HistoryEntryItem, HistoryDetailModal)
• Filter by USER/AUTO entry types
• Activity graph visualization showing work patterns
• Full keyboard navigation (Arrow keys, Enter for details)
• Search across all history entries

Tab 2: AI Overview

• Auto-generates synopsis when modal opens (using default lookback period)
• Tab is ghosted/disabled until generation completes
• Time range slider: 1-90 days with Refresh button
• Synopsis sections: Accomplishments, Challenges, Next Steps
• Save to disk button (reuses SaveMarkdownModal, SSH-aware)
• Progress bar during generation
• Hierarchical strategy for large datasets (>100k tokens)

Settings Tab

New top-level settings tab "Director's Notes" with:

• Provider: claude-code, codex, or opencode
• Default Lookback Period: 1-90 days slider (default: 7)

Access Points

• Command Palette: "Director's Notes"
• Hamburger Menu: "Director's Notes"
• Optional keyboard shortcut (Cmd+Shift+D)

Technical Approach

Component Extraction (Enables Reuse)

Extract from HistoryPanel.tsx into src/renderer/components/History/:

• ActivityGraph - Bar chart with lookback period selector
• HistoryEntryItem - Individual entry card
• HistoryFilterToggle - AUTO/USER filter buttons
• historyConstants.ts - Shared constants (LOOKBACK_OPTIONS, etc.)

Then refactor HistoryPanel to import these components, ensuring any changes apply to both views.

New Components

• DirectorNotesModal - Main modal shell with tabs
• UnifiedHistoryTab - Aggregated history using extracted components
• AIOverviewTab - Synopsis with slider, progress bar, save button

IPC Handlers

New handlers in src/main/ipc/handlers/director-notes.ts:

• director-notes:getUnifiedHistory - Aggregate history from all sessions
• director-notes:estimateTokens - Estimate tokens for synopsis generation
• director-notes:generateSynopsis - Generate AI synopsis

Implementation Phases

1. Settings types and UI - Add settings tab with provider/lookback options
2. Extract History components - Create reusable components folder
3. Refactor HistoryPanel - Use extracted components
4. IPC handlers - Main process handlers for aggregated data
5. Modal shell - DirectorNotesModal with tab switching
6. UnifiedHistoryTab - Full implementation with extracted components
7. AIOverviewTab - Synopsis generation with progress
8. Integration - Command Palette + Hamburger Menu
9. Test cases - Tests for all new and refactored components
10. Final verification - Linting, build, manual testing

Auto-Run Documents

Implementation plan created in:
Auto Run Docs/2026-02-02-Director-Notes/DIRECTOR-NOTES-01.md through DIRECTOR-NOTES-10.md

Acceptance Criteria

• Director's Notes accessible from Command Palette
• Director's Notes accessible from Hamburger Menu
• Unified History shows entries from all sessions with agent names
• Filter toggle and activity graph work in Unified History
• Keyboard navigation works (Arrow keys, Enter, Escape)
• Detail modal shows full entry content with prev/next navigation
• AI Overview generates synopsis automatically when modal opens
• Time range slider adjusts lookback period (1-90 days)
• Refresh button regenerates synopsis
• Save button saves synopsis to disk (SSH-aware)
• Settings persist provider and lookback preferences
• Existing HistoryPanel in Right Bar works identically to before
• All tests pass
• No linting errors

---

DIRECTOR-NOTES-01.md
DIRECTOR-NOTES-02.md
DIRECTOR-NOTES-03.md
DIRECTOR-NOTES-04.md
DIRECTOR-NOTES-05.md
DIRECTOR-NOTES-06.md
DIRECTOR-NOTES-07.md
DIRECTOR-NOTES-08.md
DIRECTOR-NOTES-09.md
DIRECTOR-NOTES-10.md