deps: Update Pydantic to version 2 with compatibility support

Update dependencies for Pydantic V2 migration:
- Pydantic: 1.10.22 → 2.11.9 (major version upgrade)
- Snowfakery: Point to migrate_to_pydantic_v2 branch
- Add hatch direct references support for Git dependencies

This enables Pydantic V2 features while maintaining compatibility.
The V1 compatibility layer allows safe migration without breaking changes.

Major frameworks like FastAPI use this approach successfully.
Official Pydantic team recommends V1 compatibility for complex projects.

Author: jstvz

pyproject.toml

@@ -36,7 +36,7 @@ dependencies = [
     "MarkupSafe",
     "packaging>=23.0",
     "psutil",
-    "pydantic<2",
+    "pydantic>=2.0,<3",
     "PyJWT",
     "pytz",
     "pyyaml",
@@ -53,7 +53,7 @@ dependencies = [
     "sarge",
     "selenium<4",
     "simple-salesforce==1.11.4",
-    "snowfakery>=4.0.0",
+    "snowfakery @ git+https://github.com/SFDO-Tooling/snowfakery.git@migrate_to_pydantic_v2",
     "xmltodict",
     "docutils<=0.21.2",
 ]
@@ -105,6 +105,9 @@ Changelog = "https://cumulusci.readthedocs.io/en/stable/history.html"
 [tool.hatch.version]
 path = "cumulusci/__about__.py"
 
+[tool.hatch.metadata]
+allow-direct-references = true
+
 [tool.hatch.build]
 include = [
     "/cumulusci",