Changelog & Features

Dump your mind. Start small. Track our iteration footprints and explore the complete feature map of CalmFlow v1.

v1.1.1 2026-06-08 Auto-Update Release

This release introduces publish automation, dual-platform update detection, and critical runtime fixes.

  • New Dual-Platform Auto-Updates: Windows supports silent update detection and restart-to-overwrite; macOS intelligently prompts to download the latest DMG from the browser.
  • New Cloudflare R2 Publish Pipeline: integrated S3 protocol upload to Cloudflare R2 bucket, resolving Content-SHA256 signature verification errors for large files.
  • New Smart Proxy & Fallback: build scripts automatically adapt to local proxy settings, seamlessly falling back to direct connection if the proxy is unavailable.
  • Improve Dynamic Shortcut Modifiers: keyboard shortcut modifiers dynamically adapt to the user's OS (e.g. automatically replacing Command with Ctrl on Windows).
  • Improve Settings Backup Button Alignment: fixed layout offsets between Import and Export buttons in Settings, completing localized status text.
  • Fix Main Process ESM Crash Fix: resolved a fatal SyntaxError: Named export 'autoUpdater' not found on macOS DMG launch, ensuring app startup stability.
v0.1.0 2026-06-08 Beta Launch

First beta release, focusing on polishing the local-first quiet workspace experience.

  • New AI Engine Refactoring: integrated Vercel AI SDK supporting OpenAI, Claude, Gemini, DeepSeek, and local Ollama, featuring automatic fallback to text parsing and Mock degradation.
  • New Intent Classification & Context Injection: built a 3-layer Prompt architecture to separate venting from goal decomposition, injecting real-time user metrics into the AI context.
  • New Editable Proposal Dashboard: task titles, durations, priorities, and criteria are fully editable before import, protected against duplicate import race conditions.
  • New Immersive FocusRoom: full-screen session UI featuring goal checklist, progress bar, audio pause synchronization, and quick capture entrance during focus.
  • New 40Hz Sine Wave Synthesis: utilizes Web Audio API OscillatorNode to generate pure 40Hz audio on-the-fly with 0-byte memory caching.
  • New Atmosphere Soundscapes: 5 ambient channels (Brown noise, Rain, Ocean waves, etc.) with high-frequency roll-off and flat loop fading, volume reduced by 40%.
  • New Advanced Workflows: supports recurring tasks (daily/weekly/monthly), workflow template creation, duplicate detection, and visual status layer sorting.
  • New AI Coach Cards & Checkout: 7 types of context-aware suggestions (capacity alert, review, etc.) and a checkout ritual after 20:00 to archive incomplete tasks.
  • New macOS Native Integration: native hiddenInset title bar extension, 75% sidebar opacity vibrancy glassmorphism, menu bar dot tray icon, and global shortcut ⌘⇧Space window trigger.
  • New Data Portability: integrated full local database backup export and JSON restore recovery via safe IPC handler.
  • Improve Component Split: refactored Workspace.tsx (2,200+ lines) into modular views (TodayTab, WorkflowsTab, SettingsTab, etc.) to enhance UI responsiveness.
  • Improve IPC Handlers Extension: restored 14 system handlers and registered 8 new controllers to prevent code truncation.
  • Improve UX Polish: borderless paper-like textarea, 5s placeholder carousel, bouncing triple-dot dumper animation, and 2-second save feedback animations.
  • Improve Smart Duration Recommendation: snaps timer presets to larger values on ties, and preserves user custom offset if within ±5min.
  • Fix Global Error Capturing: added ErrorBoundary container with crash safety page and reload recovery triggers.
  • Fix Database Safety: automatically backups .db.bak on schema migration, and runs wal_checkpoint(TRUNCATE) on exit to keep database clean.
  • Fix Security Validation: applied parameter type checks for createWorkflow, createTask, and startFocus DB inputs.
  • Fix Bugs & Residues: fixed · entity character display glitches and translated remaining residues to achieve 100% full Chinese/English coverage.

1. Capture & AI Decomposition

  • Text input box for brain dumping (carousel placeholders, 3 guiding prompts)
  • ⌘↵ hotkey for fast workflow generation
  • Multi-AI Provider support (OpenAI/Claude/Gemini/DeepSeek/Tongyi/Kimi/Ollama/OpenRouter/Custom)
  • Intent classification model separation (light model for intent, strong model for decomposition)
  • AI decomposition to workflow + atomic tasks (with criteria, reasoning)
  • Simple chatting input recognition (emotional listening → warm response + small tips)
  • Editable decomposition results (title/duration/priority/criteria/reasoning, deletable tasks)
  • Duplicate import prevention (already imported workflow check)
  • Multiple workflow proposals imported one by one without loss
  • Mock Provider fallback (experience without API Key)
  • AI auto-inferred execution type (desk/learn/outdoor/quick)
  • AI responses auto-matching user input language (Chinese input → Chinese output)
  • AI call failure auto-fallback to Mock
  • Structured Output fallback (auto-fallback to json_object for providers without json_schema support)

2. Today's Actions

  • Dynamic greeting (Good morning / afternoon / evening)
  • Date + consecutive focus days subtitle
  • Today's todo stats (X actions · X estimated hours)
  • Next Action recommendation (Priority P1 ≤ 10min first → active first → P1 → P2 → P3)
  • Task list (priority, estimated duration, workflow tags)
  • Cross-day task 'In Progress' flag (hover to show, reduces anxiety)
  • Manual task creation (title, duration, priority, workflow, repetition, execution type)
  • Task workflow association (dropdown switch)
  • Task complete/incomplete toggle
  • Task deletion
  • AI Coach context panel (capacity alert, clarity tips, progress review, tonight's advice, start signal, workflow overflow warnings, all complete signals)
  • Evening checkout ritual (after 20:00 → prompt to archive incomplete cross-day tasks)
  • Inspiration cards (removed, simplified to a clean 'Dump your mind, let me organize')
  • Custom focus session entrance

3. Focus Sessions

  • Focus configuration panel (atmosphere, duration, pre-listen)
  • 5 atmosphere scenes (Deep Work, Writing, Reading, Relax, Super Focus)
  • 5 ambient sounds (Brown Noise, Rain, White Noise, Ocean Waves, 40Hz)
  • Web Audio API synthesis + local MP3 loading (auto-fallback)
  • 40Hz pure sine wave OscillatorNode synthesis
  • Auto-recommended duration (keep original if offset ≤ 5min, prompt if exceeded)
  • Full-screen FocusRoom (task name, complete criteria, timer, progress bar)
  • Full-screen bottom 'Next' queue (next 3 tasks)
  • Pause/Resume (synchronized audio)
  • Complete flag + reflection panel (exit with esc)
  • Skip current task to play next
  • Fast capture in focus (quick thought capture without interrupting timer)
  • Timer zero completion flash animation + success popup
  • Rest mode recovery (auto-trigger when timer ends)
  • Customizable short rest / long rest duration
  • ESC to exit full screen
  • macOS window traffic lights spacing padding
  • Different behavior for 4 execution types (quick→direct complete / outdoor→direct start / desk→select atmosphere / learn→select duration)

4. Workflows

  • Workflow list (title, priority, task progress, subtask preview)
  • Visual status layers (active 100% → paused dashed border → completed 40% placed at bottom)
  • Sorting: active → paused → completed
  • Workflow detail (status switch, source thoughts, task list, add/delete tasks)
  • Manual workflow creation
  • Batch import from AI proposals
  • Workflow templates (save/delete/one-click create)
  • Duplicate workflow detection (name warning)
  • Workflow deletion confirmation dialog
  • Undo Toast after deleting task

5. AI Memory

  • Notes CRUD (create, read, update, delete)
  • Workflow association (dropdown selection)
  • Save button feedback (green animation for 2s)
  • Automated behavior logs (focus_end / task_skipped / task_completed)
  • Behavior stats injected into UserContext (todo count, skip rate, completion rate)
  • User preference KV store

6. Completion History

  • Time filter (Today / This Week / This Month / All)
  • Weekly review card (completed count, leftover count, one-click archive)
  • Focus log timeline (intent, duration, reflection, timestamp)
  • Completed workflows list
  • Segment control (macOS dark theme white text style)

7. Settings

  • AI Provider configuration (2-step wizard: select provider → API Key + model)
  • API Key password toggle visibility
  • Connection test (green/red/orange status indicators)
  • One-click jump to API Key configuration if not connected
  • Links to tutorials on getting API Keys for each provider
  • Intent classification model separation selection
  • Decomposition main model selection
  • Dynamic model list update based on SDK types (including GPT-5.4 etc.)
  • Save downgrade tips (failure popup + double-click lock)
  • Appearance toggle (Dark / Light, follows system)
  • Interface language selection (简体中文 / English)
  • Custom short rest / long rest duration
  • Data export backup (JSON download)
  • Section headers (AI Config / Appearance & Language / Focus Timer / Data Management)

8. Sidebar

  • LogoMark SVG (lowercase c + dot)
  • 4 main navigations (Today / Workflows / Memory / History) + icons + badge counts
  • Settings navigation (placed at bottom)
  • Search box (⌘K hotkey, global search)
  • Active state highlighting (left 2px green bar + light green background)
  • First-use guide card
  • macOS Vibrancy sidebar (frosted glass)
  • hiddenInset draggable area (window dragging from brand header)
  • Bottom 'Local-First' declaration
  • Today stats (X done / Xm focused)

9. Global Interactions

  • Keyboard shortcuts (⌘K search / ⌘N today / ⌘1-4 navigation / ↑↓ select / Esc clear)
  • macOS .dmg build (Apple Silicon + Intel dual architecture)
  • Windows .exe build
  • Global shortcut ⌘⇧Space to show/focus window
  • Tray icon + right-click context menu
  • Auto dark mode sync
  • ErrorBoundary global catch
  • Confirmation dialog (for delete operations)
  • Toast notifications + Undo
  • Loading screen initial animation
  • Bilingual full-page i18n

10. Architecture & Data

  • SQLite local storage (local-first)
  • FTS5 full-text search
  • IPC security isolation (contextBridge)
  • Input validation (title length, duration range)
  • DB Schema versioned migrations (backward compatibility)
  • Vercel AI SDK v6 integration (generateObject + generateText)
  • AI call auto-downgrade (Structured Output → JSON → Mock)
  • behavior_log user activity tracks
  • user_preferences settings store
  • 6 vitest test suites