---
phase: 01-authentication
plan: 10
type: execute
wave: 4
depends_on: ["01-11", "01-08", "01-09"]
files_modified: ["lib/features/authentication/presentation/pages/home_page.dart", "lib/providers/auth_provider.dart", "test/integration_test/auth_flow_test.dart"]
autonomous: false
user_setup: []

must_haves:
  truths:
    - "User can log out from any screen"
    - "Logout clears session and requires re-authentication"
    - "All auth success criteria are verified"
  artifacts:
    - path: "lib/features/authentication/presentation/pages/home_page.dart"
      provides: "Home page with logout functionality"
      min_lines: 30
    - path: "lib/providers/auth_provider.dart"
      provides: "Enhanced auth provider with logout"
      min_lines: 40
  key_links:
    - from: "lib/features/authentication/presentation/pages/home_page.dart"
      to: "lib/providers/auth_provider.dart"
      via: "logout method call"
      pattern: "signOut|logout"
    - from: "lib/providers/auth_provider.dart"
      to: "supabase.auth"
      via: "session clearing"
      pattern: "supabase\\.auth\\.signOut"
---

<objective>
Implement logout functionality and verify all authentication success criteria.

Purpose: Complete authentication system with logout capability and validate all requirements are met.
Output: Working logout functionality and verified authentication system meeting all success criteria.
</objective>

<execution_context>
@~/.opencode/get-shit-done/workflows/execute-plan.md
@~/.opencode/get-shit-done/templates/summary.md
</execution_context>

<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/STATE.md
@.planning/phases/01-authentication/01-RESEARCH.md
</context>

<tasks>

<task type="auto">
  <name>Add logout functionality to auth provider</name>
  <files>lib/providers/auth_provider.dart</files>
  <action>
    Update AuthProvider to:
    1. Implement signOut() method that calls repository.signOut()
    2. Clear all user state on logout
    3. Handle loading state during logout
    4. Handle any logout errors gracefully
    5. Ensure proper cleanup of resources
    6. Update auth state to null after successful logout
    7. Dispose of any stream subscriptions
    8. Navigate to login screen after logout
  </action>
  <verify>AuthProvider successfully logs out user and clears all session data</verify>
  <done>Complete logout functionality in auth state management</done>
</task>

<task type="auto">
  <name>Add logout button to home page</name>
  <files>lib/features/authentication/presentation/pages/home_page.dart</files>
  <action>
    Update HomePage to:
    1. Add logout button in app bar or menu
    2. Connect logout button to AuthProvider.signOut()
    3. Show confirmation dialog before logout
    4. Handle logout loading state
    5. Provide clear logout feedback
    6. Ensure logout works from any screen
    7. Add proper accessibility labels
    8. Style logout button appropriately
  </action>
  <verify>Logout button works correctly and logs user out from home page</verify>
  <done>Home page with working logout functionality</done>
</task>

<task type="checkpoint:human-verify" gate="blocking">
  <what-built>Complete authentication system with logout functionality</what-built>
  <how-to-verify>
    1. Test signup flow: create new account in <3 seconds
    2. Test login flow: log in with valid credentials
    3. Test session persistence: restart app and verify still logged in
    4. Test password reset: request reset, receive email within 1 minute
    5. Test logout: tap logout button, verify session cleared
    6. Test re-authentication: try accessing protected page after logout
    7. Test error messages: invalid password vs account not found
  </how-to-verify>
  <resume-signal>Type "approved" if all success criteria are met, or describe issues</resume-signal>
</task>

</tasks>

<verification>
1. User can sign up with email and password in <3 seconds
2. User can log in with valid credentials and session persists across app restarts
3. User can reset forgotten password and receive recovery email within 1 minute
4. User can log out from any screen and subsequent session requires re-authentication
5. Failed login attempts return clear error messages (invalid password vs account not found)
6. Logout button is accessible and works correctly from home page
7. All authentication flows work end-to-end without errors
</verification>

<success_criteria>
Complete authentication system meeting all Phase 1 success criteria with working logout functionality.
</success_criteria>

<output>
After completion, create `.planning/phases/01-authentication/01-10-SUMMARY.md`
</output>