feat: add new widgets for browser activity, focus coaching, goal progress, quick capture, and session pulse

- Implemented BrowserActivityWidget to display current browser domain stats and connection status.
- Created FocusCoachWidget for managing focus sessions with start/stop functionality and session tracking.
- Developed GoalProgressWidget to show usage goals and progress towards them.
- Added QuickCaptureWidget for quick note and todo capture with local storage support.
- Introduced SessionPulseWidget to visualize focus time and interruptions throughout the day.
- Added useWidgetErrorReporter hook for error handling across widgets.

Author: PythonSmall-Q

AGENTS.md

@@ -0,0 +1,140 @@
+# TimeLens Agent Guide
+
+This document helps AI agents contribute to TimeLens safely and consistently.
+
+## Project Overview
+
+TimeLens is a local-first screen-time tracker and desktop widget platform built with:
+
+- **Frontend**: React + TypeScript + Vite + Tailwind CSS
+- **Desktop host**: Tauri v2 + Rust
+- **Database**: SQLite (local only, no cloud)
+- **Extensions**: Browser extension (Edge/Chrome), VS Code extension
+
+The project root contains the web frontend. The Tauri backend lives in `src-tauri/`.
+
+## Quick Commands
+
+Always run these after non-trivial changes:
+
+```bash
+npm run typecheck      # TypeScript check
+npm run lint           # ESLint (expect 9 pre-existing warnings)
+npm run test           # Frontend unit tests
+```
+
+For Rust/backend changes (run from `src-tauri/`):
+
+```bash
+cargo test
+cargo check
+```
+
+For a full release build:
+
+```bash
+npm run tauri:build
+```
+
+## Architecture
+
+### Frontend (`src/`)
+
+- `src/pages/` — Full-page views (Dashboard, Settings, Focus Mode, Widget Center, etc.)
+- `src/widgets/` — First-party widget UIs (Todo, Note, Pet, Focus Coach, etc.)
+- `src/components/` — Shared reusable components
+- `src/hooks/` — Shared React hooks
+- `src/stores/` — Zustand state stores
+- `src/services/tauriApi.ts` — All Tauri command wrappers
+- `src/types/index.ts` — Shared TypeScript types
+- `src/i18n/locales/` — Translation JSON files (`en`, `zh-CN`, `zh-TW`, `ja`, `ko`, `de`, `fr`, `es`)
+- `src/styles/globals.css` — Tailwind entry + custom glassmorphism utilities
+
+### Backend (`src-tauri/src/`)
+
+- `commands/` — Tauri command handlers
+- `db/` — SQLite schema, migrations, and query helpers
+- `models/` — Shared Rust data models
+- `monitor/` — Active window / screen-time monitoring
+- `widget_registry.rs` — Widget manifest loading and normalization
+
+### Widgets
+
+Widgets are loaded as separate Tauri webview windows. Official widgets live in `src/widgets/`. Third-party widgets can be imported from local directories.
+
+Each widget receives a `widgetId` prop. Use it to namespace `localStorage` keys (e.g. `${widgetId}-notes`).
+
+## Conventions
+
+### Code Style
+
+- Use **functional components** and hooks.
+- Prefer `clsx` for conditional class names.
+- Keep UI text in `i18n` JSON files; never hardcode user-facing strings.
+- Add new i18n keys to `en` and `zh-CN` first; use English stubs for other languages unless you can translate accurately.
+- Use the existing `glass-card`, `ui-field`, `ui-checkbox`, `btn-primary` utilities instead of inventing new styles.
+
+### Backend
+
+- Tauri commands return `Result<T, String>` for user-facing errors.
+- Database access goes through `DbState` (a `Mutex<Connection>`).
+- New tables need a migration in `src-tauri/src/db/migrations.rs`.
+- When changing Rust models, update any hand-constructed instances in tests and commands.
+
+### Cross-Window Events
+
+Inside a widget, `window.dispatchEvent` only reaches the same window. To notify other widget windows or the main app, use Tauri events:
+
+```ts
+import { emit } from "@tauri-apps/api/event";
+import { listen } from "@tauri-apps/api/event";
+```
+
+### Error Handling in Widgets
+
+Use the `useWidgetErrorReporter` hook to automatically record unhandled errors to the per-widget error log:
+
+```ts
+import { useWidgetErrorReporter } from "@/hooks/useWidgetErrorReporter";
+
+export default function MyWidget({ widgetId }: Props) {
+  useWidgetErrorReporter(widgetId);
+  // ...
+}
+```
+
+## Localization Checklist
+
+When adding user-facing text:
+
+1. Add key to `src/i18n/locales/en/<namespace>.json`
+2. Add key to `src/i18n/locales/zh-CN/<namespace>.json`
+3. Add English stub to `src/i18n/locales/{es,de,fr,ko,ja,zh-TW}/<namespace>.json`
+
+Namespaces include: `common`, `dashboard`, `widgets`, `settings`, `limits`, `categories`, `goals`, `focus`, `browserUsage`.
+
+## Version Bumps
+
+When bumping the app version, update all of these:
+
+- `package.json`
+- `package-lock.json` (top-level + root package entries)
+- `src-tauri/Cargo.toml`
+- `src-tauri/tauri.conf.json`
+- `src-tauri/Cargo.lock` (run `cargo update -p timelens` from `src-tauri/`)
+- `src-tauri/windows/Package.appxmanifest`
+- `CHANGELOG.md`
+
+The `src/version.ts` file re-exports `package.json` version, so it does not need manual editing.
+
+## Common Pitfalls
+
+- **Date parsing**: Backend stores local datetimes as `YYYY-MM-DDTHH:MM:SS`. Parsing with `new Date()` can interpret them as UTC and shift by the local timezone offset. Use a local-component parser when computing durations.
+- **Dropdown z-index**: `ExePickerInput` and similar popovers may render under later cards. Increase `z-index` on both the wrapper and the popup if needed.
+- **Widget window events**: Each widget is its own window; use Tauri `emit`/`listen` for cross-widget communication.
+- **Focus rules**: Frontend `FocusRule` does not include `created_at`; the backend model must keep it optional to avoid deserialization failures.
+- **Cargo lockfile**: After editing `Cargo.toml`, run `cargo update -p timelens` instead of a full `cargo update` to avoid unnecessary dependency churn.
+
+## Release Notes
+
+Add a new section to `CHANGELOG.md` for every version bump. Follow the existing Keep a Changelog format with `Added`, `Changed`, and `Fixed` subsections.

CHANGELOG.md

@@ -5,6 +5,31 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [2.0.5] - 2026-08-26
+
+### Added
+
+- **Widget Center two-column layout** — official widgets and third-party widgets now scroll independently, with a subtler divider and proper edge padding so the left column is no longer clipped.
+- **Cross-window Quick Capture refresh** — capturing a todo or note from the Quick Capture widget now broadcasts a Tauri event, so open Todo and Note widgets refresh automatically.
+- **Widget error reporter** — added `useWidgetErrorReporter` hook that catches unhandled errors and promise rejections in first-party widgets and records them to the per-widget error log with recovery hints.
+- **Error log filtering** — the Widget Center error log panel now has a real-time filter input.
+- **Settings auto-blur modal** — turning on "Fade widgets when unfocused" now opens a modal where users can choose which widgets auto-blur; the choice is persisted per widget and editable later from the same settings card.
+
+### Changed
+
+- **Pet widget rewrite** — simplified the desktop pet into a cleaner companion view with import success/error feedback and integrated error reporting.
+- **Focus rule save UX** — the Focus Mode rule form now validates required fields, shows a loading state, and displays success or error messages after saving.
+
+### Fixed
+
+- **Focus Coach timer showing `-2` / freezing** — the widget now parses backend local datetimes as local time instead of UTC, preventing negative durations. The timer also starts counting immediately and the button label updates right away.
+- **Focus Coach button state** — "Start Focus" now correctly becomes "Stop Focus" after a session is started.
+- **Focus rule "Add rule" not working** — the backend `FocusRule` model now accepts an optional `created_at`, so rules submitted from the frontend save successfully instead of failing deserialization.
+- **Goals and Categories dropdown layering** — the app/executable picker dropdown now renders above subsequent cards instead of being clipped underneath.
+- **Widget auto-blur and permission item backgrounds** — lowered the background opacity of per-widget items in Settings for a lighter appearance.
+
+---
+
 ## [2.0.2] - 2026-07-27
 
 ### Added

README.md

@@ -167,6 +167,8 @@ Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting pull requests.
 ## 🗺 Roadmap
 
 - [Unified Roadmap](docs/ROADMAP.md)
+- [Widget Runtime Rewrite Roadmap (Proposed)](docs/ROADMAP_WIDGET_RUNTIME_REWRITE.md)
+- [Widget Runtime Rewrite Implementation Plan (Draft)](docs/WIDGET_RUNTIME_REWRITE_IMPLEMENTATION_PLAN.md)
 
 ---
 

README_zh.md

@@ -165,6 +165,8 @@ TimeLens/
 ## 🗺 路线图
 
 - [统一路线图](docs/ROADMAP.md)
+- [小组件底层重写专项路线图（提案）](docs/ROADMAP_WIDGET_RUNTIME_REWRITE.md)
+- [小组件底层重写详细实施方案（草案）](docs/WIDGET_RUNTIME_REWRITE_IMPLEMENTATION_PLAN.md)
 
 ---