Release Notes - v0.8.3

Release Date: January 2, 2026 Branch: production Previous Version: v0.8.2

Summary

This release introduces the Integration Health Dashboard and OAuth connection management from the Settings page. Alpha testers can now connect Slack and Google Calendar directly from the web UI, monitor integration health status, and manage their connections without touching environment variables. Notion setup is now part of the GUI setup wizard.

What Changed

🔌 Integration Health Dashboard (#530)

What It Does: New dashboard showing real-time health status of all integrations with one-click testing.

Access: Settings → Integrations (http://localhost:8001/settings/integrations)

Features:

Why This Matters:

Files Changed:

🔗 Settings OAuth Connection Management (#528, #529)

What It Does: Connect and disconnect Slack and Google Calendar directly from the Settings page.

Access: Settings → Integrations → Click “Connect” button

New Features:

Technical Details:

Why This Matters:

Files Changed:

📝 Notion Setup in Wizard (#527)

What It Does: Configure Notion API key during initial setup with automatic validation.

Where: Setup wizard Step 2 (API Keys)

Features:

Why This Matters:

Files Changed:

🐛 Bug Fixes

  1. Calendar OAuth State Fix (#529)
    • Problem: “State not found” errors on Calendar OAuth callback
    • Cause: Each HTTP request created new handler with empty state dict
    • Fix: Module-level singleton pattern for state persistence
    • Result: Calendar OAuth works reliably
  2. Toast Visibility Fix (#530)
    • Problem: Toast notifications invisible on integrations page
    • Cause: Missing tokens.css include (z-index variable undefined)
    • Fix: Added CSS include, increased duration to 7 seconds
    • Result: Toasts visible and readable
  3. Breadcrumb Overlap Fix (#530)
    • Problem: Breadcrumbs overlapping with navigation
    • Fix: CSS layout adjustments
    • Result: Clean navigation header
  4. Auth Bypass Test Fix (#502)
    • Problem: Test failing due to missing auth fixtures
    • Fix: Added proper auth context to test
    • Result: All tests passing

For Alpha Testers

🎯 What to Test Now

New Features (focus testing here):

Working Features (stable):

✅ What You Should See After Pulling

# 1. Pull production branch
git checkout production
git pull origin production

# 2. Verify version
grep version pyproject.toml
# Should show: version = "0.8.3"

# 3. Restart server
python main.py

# 4. Visit Integration Dashboard
# Navigate to: http://localhost:8001/settings/integrations
# You should see cards for Slack, Calendar, GitHub, Notion
# Each card has Test/Connect/Disconnect buttons

🆕 Try the New Integration Features

  1. Test Integration Health
    • Go to Settings → Integrations
    • Click “Test All” button
    • Observe status updates for each integration
  2. Connect Slack (if you have a Slack workspace)
    • Click “Connect” on Slack card
    • Authorize in Slack OAuth popup
    • Return to see “Connected” status with workspace name
  3. Connect Calendar (if you have Google Calendar)
    • Click “Connect” on Calendar card
    • Authorize in Google OAuth popup
    • Return to see “Connected” status with email
  4. Disconnect an Integration
    • Click “Disconnect” on a connected integration
    • Confirm in dialog
    • Status changes back to “Not Configured”

Files Changed

Major Changes

  1. web/api/routes/settings_integrations.py - NEW: OAuth connect/disconnect endpoints
  2. services/integrations/calendar/oauth_handler.py - NEW: Calendar OAuth handler
  3. templates/integrations.html - Integration health dashboard UI
  4. web/api/routes/integrations.py - Health check endpoints

Bug Fixes

  1. services/auth/auth_middleware.py - Auth-exempt OAuth paths
  2. web/static/js/toast.js - 7s duration for readability
  3. templates/integrations.html - Toast CSS fix

Setup Wizard

  1. scripts/setup_wizard.py - Notion validation
  2. web/api/routes/setup.py - Notion endpoint
  3. templates/setup.html - Notion card
  4. web/static/js/setup.js - Notion handling

Tests

  1. tests/unit/web/api/routes/test_integrations.py - NEW
  2. tests/unit/web/api/routes/test_setup_calendar.py - NEW
  3. tests/unit/web/api/routes/test_setup_notion.py - NEW
  4. tests/unit/web/api/routes/test_setup_slack.py - NEW
  5. tests/integration/test_integrations_dashboard.py - NEW

Configuration

  1. pyproject.toml - Version bump 0.8.2 → 0.8.3

Technical Details

Deployment Process

Timeline: December 28, 2025 - January 2, 2026

Phase 1: Feature Development (Dec 28-31)

Phase 2: Bug Fixes (Jan 1)

Phase 3: Release (Jan 2)

Rollback Path (if needed)

# If critical issue discovered post-deployment:
git checkout production
git reset --hard v0.8.2
git push origin production --force-with-lease

# Then notify PM immediately

Previous stable version: v0.8.2

Known Issues

Pre-existing issues (carried forward from v0.8.2):

New issues: None reported during development.

Next Steps for Alpha Testing

  1. Pull this release on your alpha laptop
  2. Visit Integration Dashboard to see health status
  3. Try connecting integrations (Slack, Calendar)
  4. Report any OAuth issues - these are the newest features
  5. Test workflows as usual (lists, todos, files)

Support

If you encounter issues after updating:

  1. OAuth not working: Check browser console for errors, ensure popup blockers are disabled
  2. Toast not visible: Hard refresh (Cmd+Shift+R) to reload CSS
  3. Integration stuck: Try Disconnect → Connect again
  4. Version mismatch: Verify with grep version pyproject.toml
  5. Need help: Report in #piper-alpha Slack channel or create GitHub issue

Commits in This Release

Integration Dashboard (#530):

OAuth Connections (#528, #529):

Notion Setup (#527):

Tests:

Documentation:

Full changelog: v0.8.2…v0.8.3

Questions? Contact PM (xian) or refer to this release notes document.