[docs] Update documentation for features from 2026-01-22

[github-actions]

Documentation Updates - 2026-01-22

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

1. id-token: write Permission Support (from #11307)

• Added comprehensive documentation for the id-token permission in the permissions reference
• Explained that id-token: write is explicitly allowed for OIDC authentication with cloud providers
• Clarified that this permission does not grant repository write access
• Added example showing usage with AWS OIDC authentication
• Updated the Write Permission Policy section to note this exception

2. --push Flag for upgrade and init Commands (from #11298)

• Added complete documentation for the new upgrade command (previously undocumented)
• Documented the --push flag for both upgrade and init commands
• Explained the workflow: pre-check, execution, auto-commit, pull, and push
• Noted that it requires a clean working directory
• Added examples for both commands

Changes Made

• docs/src/content/docs/reference/permissions.md:

  • Added "Special Permission: id-token" subsection under "Permission Scopes"
  • Added exception note in "Write Permission Policy" section
  • Included OIDC authentication example with AWS

• docs/src/content/docs/setup/cli.md:

  • Added --push option to init command documentation
  • Added detailed --push flag explanation for init command
  • Added new upgrade command section in Management category
  • Added detailed --push flag explanation for upgrade command
  • Included examples for all new options

Merged PRs Referenced

• Allow id-token: write permission in strict mode #11307 - Allow id-token: write permission in strict mode
• Add --push flag to upgrade and init commands with reusable git helpers #11298 - Add --push flag to upgrade and init commands with reusable git helpers

Notes

The other merged PRs from the last 24 hours (#11314, #11318, #11305) were internal maintenance and bug fixes that do not require user-facing documentation updates.

AI generated by Daily Documentation Updater