Tag v1.62.0 (clone depth + options: sync keys)

why: Ship numeric clone depth (#552) and the relocation of per-repository
sync keys (rev/shallow/depth) under an options: block, with a vcspull
migrate command and a sync-time deprecation warning for the old
top-level form.

what:
- Bump version 1.61.0 -> 1.62.0
- Date CHANGES v1.62.0 release section, open a fresh v1.63.x unreleased
  block

Author: tony

CHANGES

@@ -31,12 +31,22 @@ $ uv add vcspull --prerelease allow
 $ uvx --from 'vcspull' --prerelease allow vcspull
 ```
 
-## vcspull v1.61.x (unreleased)
+## vcspull v1.63.x (unreleased)
 
 <!-- KEEP THIS PLACEHOLDER - DO NOT REMOVE OR MODIFY THIS LINE -->
 _Notes on upcoming releases will be added here_
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+## vcspull v1.62.0 (2026-05-31)
+
+vcspull v1.62.0 lets a workspace keep a small window of git history per
+repository with a numeric `options.depth: N`, instead of the all-or-nothing
+`shallow: true`. The per-repository sync keys—`rev`, `shallow`, and `depth`—now
+live under an `options:` block, and the new `vcspull migrate` command rewrites
+configs from the deprecated top-level form. The old top-level keys are still
+read (with a warning on `sync`), so existing configs keep working until you
+migrate.
+
 ### Breaking changes
 
 #### Per-repository sync keys now live under `options:` (#552)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vcspull"
-version = "1.61.0"
+version = "1.62.0"
 description = "Manage and sync multiple git, mercurial, and svn repos"
 requires-python = ">=3.10,<4.0"
 license = { text = "MIT" }

src/vcspull/__about__.py

@@ -5,7 +5,7 @@
 __title__ = "vcspull"
 __package_name__ = "vcspull"
 __description__ = "Repo manager and syncer for git, mercurial, and svn"
-__version__ = "1.61.0"
+__version__ = "1.62.0"
 __author__ = "Tony Narlock"
 __github__ = "https://github.com/vcs-python/vcspull"
 __docs__ = "https://vcspull.git-pull.com"