Improve teams mode defaults and terminology

[gmondello]

Summary

This PR improves the teams mode with better defaults and clearer terminology to enhance the user experience.

Changes Made

🎯 Better Defaults

• Set enterprise scope as default: Easier than listing individual organizations
• Enable full sync mode by default: remove_users_no_longer_in_teams: true
• Automatic cleanup: Users automatically removed from cost centers when they leave teams

📝 Clearer Terminology

• Replace "orphaned users" → "users no longer in teams"
• Replace "orphaned user detection" → "full sync mode"
• Update config key: remove_orphaned_users → remove_users_no_longer_in_teams
• Fully backward compatible: old config key still works via fallback

🚀 GitHub Actions Focus

• Complete rewrite of TEAMS_QUICKSTART.md for GitHub Actions workflows
• Step-by-step guide with ready-to-use workflow file
• Emphasizes automation and CI/CD over local setup
• Includes troubleshooting for Actions-specific issues

Files Changed

File	Changes
config/config.yaml	Updated defaults and comments
config/config.example.yaml	Updated defaults and comments
src/config_manager.py	New config key with backward compatibility
src/teams_cost_center_manager.py	Renamed methods, improved log messages
main.py	Updated feature descriptions
README.md	Updated feature list and documentation links
TEAMS_QUICKSTART.md	Complete rewrite for GitHub Actions
ORPHANED_USERS_FEATURE.md → REMOVED_USERS_FEATURE.md	Renamed and updated

Impact

• 8 files modified (342 insertions, 273 deletions)
• No breaking changes - fully backward compatible
• Improved user experience with clearer, more intuitive language
• Better onboarding with Actions-first quick start guide

Testing Checklist

• All changes committed and pushed
• Configuration validation passed
• Backward compatibility verified (old config keys work)
• Documentation updated and consistent
• Log messages improved for clarity

Migration Notes

Existing users don't need to change anything - the old remove_orphaned_users config key continues to work. However, we recommend updating to the new key for clarity:

# Old (still works)
teams:
  remove_orphaned_users: true

# New (recommended)
teams:
  remove_users_no_longer_in_teams: true

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.