v3.4.4 - Data Safety & Preservation

🔒 Data Safety Update

Version 3.4.4 adds explicit data preservation checks and messaging to ensure user data is never overwritten during updates.

🔒 Security & Safety

• Data preservation checks - Installer explicitly detects existing installations and preserves user data
• Clear safety messaging - Users are informed when their settings will be preserved
• Update-safe by design - Only plugin code files (main.js, manifest.json, styles.css) are updated
• First-time vs update detection - Different messages for new installations vs updates

🎨 User Experience

• Better feedback - Clear messages during installation about what's being updated
• Data safety assurance - Explicit confirmation that API keys and OAuth tokens are safe
• Update confidence - Users can confidently run the installer to update without fear of data loss

📦 Installation

Option 1: One-Line Install (Easiest)

Install Latest Release:

curl -fsSL https://raw.githubusercontent.com/jimallen/TasksAgent/master/install.sh | bash

Install This Specific Version (3.4.4):

curl -fsSL https://github.com/jimallen/TasksAgent/releases/download/v3.4.4/install.sh | bash

Works on macOS, Linux, and Windows (Git Bash). The installer will:

• Download the release files automatically
• Find your Obsidian vaults
• Install the plugin files
• Preserve your existing settings and data (never overwrites data.json)
• Guide you through setup

Safe to run on updates: The installer only updates plugin code files (main.js, manifest.json, styles.css). Your API keys, OAuth tokens, and all settings are preserved.

Option 2: Manual Installation

Download the release assets below and place them in your vault's plugin folder:

• main.js - Plugin code
• manifest.json - Plugin metadata
• styles.css - UI styles
• install.sh - Installer script (optional, for scripted installation)

Steps:

1. Download all files from the Assets section below
2. Navigate to <your-vault>/.obsidian/plugins/meeting-tasks/
3. Copy main.js, manifest.json, and styles.css to that folder (do NOT overwrite data.json)
4. Restart Obsidian or reload with Ctrl/Cmd + R
5. Enable the plugin in Settings → Community Plugins

Option 3: Clone and Deploy (For Developers)

git clone https://github.com/jimallen/TasksAgent.git
cd TasksAgent
npm install
npm run build
npm run deploy

The interactive deploy script will find your vaults and install automatically.

🔧 Setup

1. Configure API Keys in plugin settings:

   • Claude API: Get from Anthropic Console
   • Google OAuth: Follow the OAuth Setup Guide

2. Gmail Labels: Configure which labels to monitor (e.g., "transcript, action")

3. Test the plugin: Use Cmd/Ctrl + Shift + M to process emails

📝 What Gets Updated vs Preserved

Always Updated (Safe to Overwrite):

• ✅ main.js - Plugin code
• ✅ manifest.json - Plugin metadata
• ✅ styles.css - UI styles

Always Preserved (Never Touched):

• 🔒 data.json - Your settings, API keys, OAuth tokens
• 🔒 All other user data files

📚 Documentation

• Dashboard User Guide
• Google OAuth Setup
• System Architecture
• Build & Deployment

---

Need Help? Check the documentation or open an issue.

v3.4.3 - Installer Input Fix

🐛 Installer Input Fix

Version 3.4.3 fixes user input handling in the piped installer script.

🐛 Bug Fixes

• Fixed installer input handling - Install script now properly reads user input when piped to bash
• Smart stdin detection - Automatically uses /dev/tty when script is piped, stdin when run directly
• Better error messages - Clearer validation messages for invalid vault selection

🔧 Technical Details

The installer now detects whether it's running in piped mode (curl ... | bash) and automatically adjusts input handling. This fixes the "Invalid selection!" error that occurred when trying to select a vault.

📦 Installation

Option 1: One-Line Install (Easiest) - NOW FIXED! ✅

Install Latest Release:

curl -fsSL https://raw.githubusercontent.com/jimallen/TasksAgent/master/install.sh | bash

Install This Specific Version (3.4.3):

curl -fsSL https://github.com/jimallen/TasksAgent/releases/download/v3.4.3/install.sh | bash

Works on macOS, Linux, and Windows (Git Bash). The installer will:

• Download the release files automatically
• Find your Obsidian vaults
• Properly accept your vault selection (fixed!)
• Install the plugin files
• Guide you through setup

Option 2: Manual Installation

Download the release assets below and place them in your vault's plugin folder:

• main.js - Plugin code
• manifest.json - Plugin metadata
• styles.css - UI styles
• install.sh - Installer script (optional, for scripted installation)

Steps:

1. Download all files from the Assets section below
2. Navigate to <your-vault>/.obsidian/plugins/meeting-tasks/
3. Copy main.js, manifest.json, and styles.css to that folder
4. Restart Obsidian or reload with Ctrl/Cmd + R
5. Enable the plugin in Settings → Community Plugins

Option 3: Clone and Deploy (For Developers)

git clone https://github.com/jimallen/TasksAgent.git
cd TasksAgent
npm install
npm run build
npm run deploy

The interactive deploy script will find your vaults and install automatically.

🔧 Setup

1. Configure API Keys in plugin settings:

   • Claude API: Get from Anthropic Console
   • Google OAuth: Follow the OAuth Setup Guide

2. Gmail Labels: Configure which labels to monitor (e.g., "transcript, action")

3. Test the plugin: Use Cmd/Ctrl + Shift + M to process emails

📝 Changes Since v3.4.0

• Fixed repository name in install script (v3.4.1)
• Install script downloads from GitHub release assets (v3.4.1)
• Added versioned installer support (v3.4.2)
• Fixed piped installer input handling (v3.4.3) ✅

📚 Documentation

• Dashboard User Guide
• Google OAuth Setup
• System Architecture
• Build & Deployment

---

Need Help? Check the documentation or open an issue.

v3.4.2 - Versioned Installer Support

🔧 Improved Installation Release

Version 3.4.2 adds versioned installer support and includes the install script in release assets.

🚀 New Features

• Versioned installer - Install script now included in release assets for version pinning
• Dual installation options - Choose between latest (master) or specific version (release tag)
• Release asset downloads - Install script correctly downloads from GitHub release assets

📦 Installation

Option 1: One-Line Install (Easiest)

Install Latest Release:

curl -fsSL https://raw.githubusercontent.com/jimallen/TasksAgent/master/install.sh | bash

Install This Specific Version (3.4.2):

curl -fsSL https://github.com/jimallen/TasksAgent/releases/download/v3.4.2/install.sh | bash

Works on macOS, Linux, and Windows (Git Bash). The installer will:

• Download the release files automatically
• Find your Obsidian vaults
• Install the plugin files
• Guide you through setup

Option 2: Manual Installation

Download the release assets below and place them in your vault's plugin folder:

• main.js - Plugin code
• manifest.json - Plugin metadata
• styles.css - UI styles
• install.sh - Installer script (optional, for scripted installation)

Steps:

1. Download all files from the Assets section below
2. Navigate to <your-vault>/.obsidian/plugins/meeting-tasks/
3. Copy main.js, manifest.json, and styles.css to that folder
4. Restart Obsidian or reload with Ctrl/Cmd + R
5. Enable the plugin in Settings → Community Plugins

Option 3: Clone and Deploy (For Developers)

git clone https://github.com/jimallen/TasksAgent.git
cd TasksAgent
npm install
npm run build
npm run deploy

The interactive deploy script will find your vaults and install automatically.

🔧 Setup

1. Configure API Keys in plugin settings:

   • Claude API: Get from Anthropic Console
   • Google OAuth: Follow the OAuth Setup Guide

2. Gmail Labels: Configure which labels to monitor (e.g., "transcript, action")

3. Test the plugin: Use Cmd/Ctrl + Shift + M to process emails

📝 Changes Since v3.4.0

• Fixed one-liner install script (v3.4.1)
• Install script now downloads from GitHub release assets (v3.4.1)
• Added versioned installer support (v3.4.2)
• Updated release documentation and templates (v3.4.2)

📚 Documentation

• Dashboard User Guide
• Google OAuth Setup
• System Architecture
• Build & Deployment

---

Need Help? Check the documentation or open an issue.

v3.4.1 - Installation Fix

🛠️ Installation Fix Release

Version 3.4.1 fixes the one-liner installation script to use the correct repository name.

🐛 Bug Fixes

• Fixed one-liner install script - Corrected repository name from obsidian-meeting-tasks to TasksAgent
• Updated all installation URLs - README and documentation now reference correct GitHub repo
• Fixed repository references - Install script now downloads from the correct location

📚 Documentation

• Added release template - Comprehensive release notes template for future releases
• Added release process guide - Step-by-step instructions for creating releases

📦 Installation

Option 1: One-Line Install (Easiest)

curl -fsSL https://raw.githubusercontent.com/jimallen/TasksAgent/master/install.sh | bash

Works on macOS, Linux, and Windows (Git Bash). The installer will:

• Download the latest release automatically
• Find your Obsidian vaults
• Install the plugin files
• Guide you through setup

Option 2: Manual Installation

Download the release assets below and place them in your vault's plugin folder:

• main.js - Plugin code
• manifest.json - Plugin metadata
• styles.css - UI styles

Steps:

1. Download all three files from the Assets section below
2. Navigate to <your-vault>/.obsidian/plugins/meeting-tasks/
3. Copy the downloaded files to that folder
4. Restart Obsidian or reload with Ctrl/Cmd + R
5. Enable the plugin in Settings → Community Plugins

Option 3: Clone and Deploy (For Developers)

git clone https://github.com/jimallen/TasksAgent.git
cd TasksAgent
npm install
npm run build
npm run deploy

The interactive deploy script will find your vaults and install automatically.

🔧 Setup

1. Configure API Keys in plugin settings:

   • Claude API: Get from Anthropic Console
   • Google OAuth: Follow the OAuth Setup Guide

2. Gmail Labels: Configure which labels to monitor (e.g., "transcript, action")

3. Test the plugin: Use Cmd/Ctrl + Shift + M to process emails

📝 Full Changelog

See CHANGELOG.md for complete details.

📚 Documentation

• Dashboard User Guide
• Google OAuth Setup
• System Architecture
• Build & Deployment

---

Need Help? Check the documentation or open an issue.

v3.4.0 - Full Mobile Platform Support

🎉 Mobile Platform Support

Version 3.4.0 brings full mobile support to the Meeting Tasks plugin, enabling Gmail task extraction on iOS and Android Obsidian apps!

🚀 New Features

Mobile Platform Support

• Full iOS/Android compatibility - Plugin now works seamlessly on mobile devices
• PKCE OAuth authentication - Secure mobile login using custom URL scheme
• Platform-aware optimization - Automatically detects and optimizes for mobile vs desktop
• Touch-optimized UI - 44pt minimum touch targets, 1.5x scaled buttons, vertical layouts
• Mobile constraints - Intelligent limits to preserve battery and performance:
  • 25 email batch limit (vs 500 on desktop)
  • 50 task clustering limit (vs unlimited on desktop)
  • 1-day default lookback (vs 3 days on desktop)
  • Network usage warnings on cellular

Desktop OAuth Improvements

• Fixed redirect URI - Now uses http://127.0.0.1:3000/callback (Google OAuth compliant)
• Port standardization - Changed from 42813 to 3000 for consistency
• Error resolution - Fixed "redirect_uri_mismatch" errors

🧪 Testing

• 80 new mobile-specific tests added
• 213 total tests - All passing ✅
• PKCE security validation - Cryptographic random generation, SHA-256 hashing
• Platform constraint testing - Email/task limits, OAuth handler selection
• Integration scenarios - End-to-end mobile workflows

📦 Installation

Download the release assets below and place them in your vault's plugin folder:

• main.js - Plugin code
• manifest.json - Plugin metadata
• styles.css - UI styles

Or use Obsidian's Community Plugins interface (if published).

🔧 Setup

1. Desktop Users: Create a "Web application" OAuth client in Google Cloud Console with redirect URI: http://127.0.0.1:3000/callback
2. Mobile Users: Same OAuth client works - mobile uses custom URL scheme automatically
3. Update your Client ID and Client Secret in plugin settings
4. Authenticate with Gmail

📝 Full Changelog

See CHANGELOG.md for complete details.

---

Platform Detection: The plugin automatically detects your platform and applies appropriate optimizations. No configuration needed!

v3.3.0 - Comprehensive Unit Test Suite

🧪 Testing Infrastructure Release

This release adds comprehensive unit testing infrastructure to the Obsidian Meeting Tasks plugin, bringing professional test coverage to all core business logic components.

📊 Test Suite Summary

133 tests across 4 test suites, all passing ✅

Component	Coverage	Tests	Focus Areas
ProcessorRegistry	100%	24	Label routing, configuration handling
TaskClusterer	85.83%	28	Clustering logic, JSON auto-repair
ClaudeExtractor	70.16%	47	Prompt building, response parsing, fallback extraction
LabelProcessor	54.6%	34	Note formatting, task metadata, email processing

✨ What's New

Testing Framework:

• ✅ Vitest configured with TypeScript support
• ✅ Fast test execution (~100ms for full suite)
• ✅ No external API dependencies (comprehensive mocking)
• ✅ Mock factories for emails and Claude responses
• ✅ Obsidian API mocking for isolated testing

Test Coverage:

• Prompt Building: Tests for both meeting and action item extraction modes
• Response Parsing: Handles markdown blocks, preambles, and malformed JSON
• Fallback Logic: Pattern-based extraction when AI is unavailable
• Task Clustering: Validates clustering algorithms and JSON auto-repair
• Note Formatting: Ensures consistent output with proper metadata
• Edge Cases: Comprehensive coverage of error conditions and boundary cases

Documentation:

• Updated README with test structure and coverage stats
• Marked Phase 2 testing complete in roadmap
• Added explanation of coverage metrics

🚀 Running Tests

npm test              # Run all tests
npm run test:watch    # Watch mode
npm run test:ui       # Visual UI
npm run test:coverage # Coverage report

📁 New Files

tests/
├── mocks/
│   └── claudeResponse.mock.ts     # Mock Claude API responses
└── unit/
    ├── claudeExtractor.test.ts    # 47 tests
    ├── taskClusterer.test.ts      # 28 tests
    └── labelProcessor.test.ts     # 34 tests

🎯 Why This Matters

This testing infrastructure ensures:

• Reliability: Catch regressions before they reach users
• Confidence: Refactor safely with comprehensive test coverage
• Quality: Professional-grade code validation
• Speed: Fast feedback loop for development

📈 Future Roadmap

Phase 3 (Planned):

• Integration tests for Gmail/Claude API interactions
• E2E tests for dashboard functionality
• CI/CD pipeline with automated quality gates

🔧 Technical Details

Overall project coverage: 10.91%

• Note: Low overall percentage is expected as most code consists of integration layers (Gmail API, OAuth, Obsidian UI) intentionally excluded from unit testing
• Testable business logic components have 54-100% coverage, which was the goal

---

Full Changelog: v3.2.2...v3.3.0

v3.2.2 - Enhanced Label Processing Documentation

📚 Documentation Improvements

This release enhances documentation to better explain the dynamic label processing system.

📝 What's New

• How Label Processing Works - New section explaining how Gmail labels trigger different extraction modes
• Adding Custom Labels - Step-by-step guide for users to extend the plugin with custom email types
• Configuration Examples - Practical examples showing how to add labels like "standup", "reports", etc.
• No-Code Emphasis - Clarified that users can add unlimited email processors without code changes

🎯 Why This Matters

The label processing system is a key differentiator that makes this plugin extensible. Users can now:

• Process meeting transcripts with conversation-style extraction
• Handle action item emails with task-focused extraction
• Add their own custom labels for newsletters, standups, reports, etc.
• All through configuration - no coding required!

📦 Installation

One-line install (easiest):

curl -fsSL https://raw.githubusercontent.com/jimallen/obsidian-meeting-tasks/master/install.sh | bash

OR download manually:

1. Download main.js, manifest.json, and styles.css from the assets below
2. Create folder: <vault>/.obsidian/plugins/meeting-tasks/
3. Copy files to that folder
4. Enable plugin in Obsidian settings

🔗 Links

• Full Documentation
• Configuration Guide
• Google OAuth Setup

v3.2.1 - Documentation Improvements

📝 Documentation Patch Release

This release improves the documentation to make setup clearer for new users.

🔧 Improvements

• Clarified API Requirements: Anthropic Claude API key now clearly marked as required (not optional)
• Direct Link: Added direct link to Anthropic API Keys page
• Better Organization: Reordered configuration steps to prioritize API key setup

📦 Installation

One-line install (easiest):

curl -fsSL https://raw.githubusercontent.com/jimallen/obsidian-meeting-tasks/master/install.sh | bash

OR download manually:

1. Download main.js, manifest.json, and styles.css from the assets below
2. Create folder: <vault>/.obsidian/plugins/meeting-tasks/
3. Copy files to that folder
4. Enable plugin in Obsidian settings

📚 Requirements

• Anthropic Claude API key (Get it here) - Free tier available
• Google OAuth credentials (Setup guide)

🔗 Links

• Full Documentation
• Example Outputs
• Configuration Guide

---

No functionality changes - all features from v3.2.0 are identical.

v3.2.0 - AI Task Clustering & Enhanced Dashboard

🎉 First Public Release!

This release brings powerful AI-driven task management to Obsidian with automatic clustering and intelligent extraction from Gmail.

✨ Key Features

• 🧩 AI Task Clustering - Automatically groups similar/related tasks with persistent storage
• 📊 Visual Dashboard - Interactive task management with multi-filter support
• 🤖 Claude AI Integration - Intelligent task extraction from meeting transcripts
• ⚡ Dynamic Label Processing - Unlimited email type support via configuration
• 📁 Smart Organization - Automatic folder structure (TaskAgent/Label/YYYY/MM/)

📦 Installation

One-line install (easiest):

curl -fsSL https://raw.githubusercontent.com/jimallen/obsidian-meeting-tasks/master/install.sh | bash

OR download manually:

1. Download main.js, manifest.json, and styles.css from the assets below
2. Create folder: <vault>/.obsidian/plugins/meeting-tasks/
3. Copy files to that folder
4. Enable plugin in Obsidian settings

OR clone and deploy:

git clone https://github.com/jimallen/obsidian-meeting-tasks.git
cd obsidian-meeting-tasks
npm install
npm run deploy

📚 Getting Started

1. Google OAuth Setup - Required for Gmail integration
2. Configure plugin settings with your API keys
3. Run "Process meeting emails" command (Cmd/Ctrl + Shift + M)

🔗 Links

• Full Documentation
• Example Outputs
• System Architecture

🛠️ What's New in v3.2.0

• AI-powered task clustering with persistent storage
• Enhanced dashboard UI with multi-filter support
• Smart vs Force re-clustering modes
• Editable cluster titles with persistent storage
• One-liner installer script for easy installation
• Comprehensive documentation and examples
• Development methodology showcase (BMAD, Claude Code)

🐛 Found an Issue?

Report it here

---

License: MIT
Author: Jim Allen