[PM-26420] Add flight recorder logs for vault unlock method and PIN migration

[andrebispo5]

Note

Depends on PR: #6024

🎟️ Tracking

https://bitwarden.atlassian.net/browse/PM-25990

📔 Objective

Unlock and PIN migration improvements:

• The functions migratePinProtectedUserKeyIfNeeded in VaultLockManagerImpl and deriveTemporaryPinProtectedUserKeyIfNecessary in VaultRepositoryImpl now accept an initUserCryptoMethod parameter, allowing them to log and handle the unlock method used.
• Added logging statements to record the vault unlock method and the outcome of PIN-protected user key migration or derivation, improving traceability and debugging.

Utility and code organization:

• Introduced a new extension function InitUserCryptoMethod.methodName() in InitUserCryptoMethodExtensions.kt to provide human-readable labels for each unlock method, used in logging.

⏰ Reminders before review

• Contributor guidelines followed
• All formatters and local linters executed and passed
• Written new unit and / or integration tests where applicable
• Protected functional changes with optionality (feature flags)
• Used internationalization (i18n) for all UI strings
• CI builds passed
• Communicated to DevOps any deployment requirements
• Updated any necessary documentation (Confluence, contributing docs) or informed the documentation team

🦮 Reviewer guidelines

• 👍 (:+1:) or similar for great changes
• 📝 (:memo:) or ℹ️ (:information_source:) for notes or general info
• ❓ (:question:) for questions
• 🤔 (:thinking:) or 💭 (:thought_balloon:) for more open inquiry that's not quite a confirmed issue and could potentially benefit from discussion
• 🎨 (:art:) for suggestions / improvements
• ❌ (:x:) or ⚠️ (:warning:) for more significant problems or concerns needing attention
• 🌱 (:seedling:) or ♻️ (:recycle:) for future improvements or indications of technical debt
• ⛏ (:pick:) for minor or nitpick changes

[github-actions]

Checkmarx One – Scan Summary & Details – 1e4d39d6-5b4e-45ac-85cd-fe559ed45fc0

Great job! No new security vulnerabilities introduced in this pull request

[SaintPatrck]

Since this is not translated, what do you think about converting this to a property and name it logTag, or something similar, so it's clear this should only be used for logging? Would also be good to mention that in the KDocs.

[andrebispo5]

makes total sense 👍

[codecov]

Codecov Report

❌ Patch coverage is 67.85714% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.75%. Comparing base (97bb93c) to head (41a713d).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
.../repository/util/InitUserCryptoMethodExtensions.kt	22.22%	3 Missing and 4 partials ⚠️
...twarden/data/vault/manager/VaultLockManagerImpl.kt	71.42%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #6052      +/-   ##
==========================================
- Coverage   84.76%   84.75%   -0.01%     
==========================================
  Files         736      737       +1     
  Lines       55340    55365      +25     
  Branches     7632     7640       +8     
==========================================
+ Hits        46909    46925      +16     
- Misses       5763     5767       +4     
- Partials     2668     2673       +5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

The base branch was changed.