CHR-1.S02: Zero-Config Installation - Complete Implementation

.gitignore

@@ -153,3 +153,4 @@ dev_*.sh
 output_*.json
 debug_output.*
 test_output.*
+.playwright-mcp/

.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "@playwright/mcp@latest"
+      ],
+      "env": {}
+    }
+  }
+}

apps/dashboard/.env.local.template

@@ -1,31 +1,50 @@
-# Chronicle Dashboard Local Environment Template
+# Chronicle Dashboard - Local Backend Mode Template
 # ==============================================================================
-# IMPORTANT: This template requires the root .env file to be configured first
-# 1. Copy /path/to/project/.env.template to .env in the project root
-# 2. Configure the root .env file with your Supabase and other settings
-# 3. Copy this file to .env.local for local dashboard overrides
+# This template configures Chronicle to use the local SQLite backend
+# Copy this to .env.local and adjust as needed for your setup
 # ==============================================================================
 
 # ===========================================
-# LOCAL DASHBOARD OVERRIDES
+# BACKEND CONFIGURATION - LOCAL MODE
 # ===========================================
-# Only add variables here that need to be different from the root config
-# for your local development environment
 
-# Local development Supabase (if different from root config)
-# NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
-# NEXT_PUBLIC_SUPABASE_ANON_KEY=your-local-anon-key
+# Backend mode - set to 'local' for SQLite backend
+NEXT_PUBLIC_CHRONICLE_MODE=local
 
-# Local development flags
-# NEXT_PUBLIC_DEBUG=true
-# NEXT_PUBLIC_SHOW_DEV_TOOLS=true
-# NEXT_PUBLIC_ENABLE_PROFILER=true
+# Local server configuration
+NEXT_PUBLIC_LOCAL_SERVER_URL=http://localhost:8510
+
+# ===========================================
+# DEVELOPMENT SETTINGS
+# ===========================================
 
 # Development environment
 NODE_ENV=development
 
+# Debug settings for local development
+NEXT_PUBLIC_DEBUG=true
+NEXT_PUBLIC_SHOW_DEV_TOOLS=true
+NEXT_PUBLIC_ENABLE_PROFILER=true
+NEXT_PUBLIC_SHOW_ENVIRONMENT_BADGE=true
+
+# Performance settings optimized for local development
+NEXT_PUBLIC_MAX_EVENTS_DISPLAY=500
+NEXT_PUBLIC_POLLING_INTERVAL=2000
+
+# ===========================================
+# FEATURES (Optional Overrides)
+# ===========================================
+# Uncomment to override default feature flags
+
+# NEXT_PUBLIC_ENABLE_REALTIME=true
+# NEXT_PUBLIC_ENABLE_ANALYTICS=true
+# NEXT_PUBLIC_ENABLE_EXPORT=true
+# NEXT_PUBLIC_ENABLE_EXPERIMENTAL_FEATURES=true
+
 # ===========================================
-# REFERENCE
+# NOTES
 # ===========================================
-# All main configuration is in the root .env file using CHRONICLE_ prefixes
-# Next.js will automatically load both root .env and this .env.local file
+# - Ensure your local Chronicle server is running on port 8510
+# - Local mode uses SQLite database stored locally
+# - No Supabase credentials needed in local mode
+# - All events and sessions are stored locally

apps/dashboard/CHANGELOG.md

@@ -0,0 +1,80 @@
+# Changelog
+
+All notable changes to the Chronicle Dashboard will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.5.0] - 2025-08-24
+
+### Added
+- Full component integration with real-time data flow
+- Keyboard navigation support (j/k for events, 1/2/3 for filters, Cmd+B for sidebar)
+- Session filtering through sidebar selection
+- Real-time metrics in header (active/awaiting counts, event rate sparkline)
+- Event feed with virtual scrolling for 1000+ events
+- Session grouping by git repository or project folder
+- Awaiting sessions highlighting and priority section
+- Layout persistence in localStorage
+- Tool name extraction from metadata JSON fields
+- Multi-select support for session filtering
+
+### Fixed
+- CHR-88: Dashboard layout issues with floating event feed
+- CHR-88: CSS Grid containment properly implemented
+- CHR-88: Removed debug displays and development overlays
+- CHR-62: Tool names showing as "null" in events
+- CHR-62: Sessions with notifications not showing as awaiting
+- CHR-62: Event details not displaying correct tool information
+
+### Changed
+- Event feed now displays as full-width section without borders
+- Session column width doubled from 140px to 280px
+- Header shows real-time metrics instead of static text
+- Sidebar sessions organized by project with collapsible folders
+- Event rows reduced to 22px height for maximum density
+
+### Technical
+- Implemented Zustand store for component communication
+- Added metadata extraction logic for tool names
+- Enhanced session awaiting detection algorithm
+- Optimized React rendering with proper memoization
+- Added keyboard event handlers throughout application
+
+## [0.4.0] - 2025-08-23
+
+### Added
+- Component cleanup and consolidation (CHR-84)
+- Standardized component naming conventions
+- Proper TypeScript types throughout
+
+### Fixed
+- Removed duplicate components
+- Fixed import paths
+- Resolved TypeScript errors
+
+## [0.3.0] - 2025-08-22
+
+### Added
+- Event feed with real-time updates
+- Virtual scrolling for performance
+- Event batching system
+- Color-coded event types
+
+## [0.2.0] - 2025-08-21
+
+### Added
+- Sidebar with session management
+- Header with status indicators
+- Basic layout structure
+- Supabase integration
+
+## [0.1.0] - 2025-08-20
+
+### Added
+- Initial project setup
+- Next.js 14 configuration
+- Tailwind CSS setup
+- Basic component structure