Git and versioning

Follow the wrapper and fallback guidance in AGENTS.md.

Version and commit format

• Root Directory.Build.props supplies the app version. Before an app commit, compare it with the highest existing XerahS release tag; the version must be strictly greater. If needed, bump it to the next unreleased version.
• App commits use [vX.Y.Z] [Type] Concise description, with types such as Fix, Feature, Build, Docs, or Refactor.
• Shared-library/submodule commits, including ShareX.ImageEditor, use [Type] Concise description without the app version.
• For requested version increments: fixes increment patch; features increment minor and reset patch; breaking changes increment major and reset minor/patch.
• Do not put app versions in individual project files. Synchronize other tracked props only if they intentionally carry the XerahS app version; do not overwrite independent library versions.
• Release automation synchronizes derived Chocolatey metadata and validates the generated package.

Verification and integration

Inspect status, the task diff, tracking branch, and submodule state before staging. Preserve unrelated edits. Pull/rebase or update submodules when integration requires it, after checking that local work will be preserved; do not unconditionally pull into a dirty checkout.

Before pushing code or build configuration, run the desktop solution build required by AGENTS.md and relevant tests. Do not disable warnings-as-errors.