Pin anthropic below 1.0 and guard the SDK call contract

changelog.d/anthropic-sdk-1-human-prompt.fixed.md

@@ -0,0 +1 @@
+Pin the anthropic SDK below 1.0: anthropic 1.0 (released 2026-08-20) removed HUMAN_PROMPT and the temperature keyword the AI analysis services pass to messages.stream(), and both the PR Test job and the Cloud Run image install with unpinned pip, so fresh builds would have failed at import (tests) or on AI-analysis cache misses (production). A contract test now checks the installed SDK's real stream() signature.

pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
 dependencies = [
     "a2wsgi>=1.10,<2",
     "alembic>=1.14,<2",
-    "anthropic",
+    "anthropic>=0.97.0,<1",
     "assertpy",
     "click>=8,<9",
     "cloud-sql-python-connector",

tests/unit/services/test_anthropic_sdk_contract.py

@@ -0,0 +1,30 @@
+"""Guard the installed anthropic SDK against the call shape the services use.
+
+The AI analysis services call ``claude_client.messages.stream(...)`` with a
+``temperature`` keyword. The unit suites mock the client with permissive
+fakes, so an SDK whose real signature dropped that keyword (anthropic 1.x
+removed ``temperature``/``top_p``/``top_k`` and ``HUMAN_PROMPT``) still
+passes every mocked test while failing at runtime on a cache miss. This test
+checks the real installed SDK instead.
+"""
+
+import inspect
+
+import anthropic
+from anthropic.resources.messages import Messages
+
+
+def test_installed_anthropic_sdk_accepts_stream_temperature():
+    parameters = inspect.signature(Messages.stream).parameters
+    assert "temperature" in parameters, (
+        f"anthropic {anthropic.__version__} no longer accepts temperature in "
+        "Messages.stream(); migrate ai_analysis_service before raising the pin"
+    )
+
+
+def test_installed_anthropic_sdk_is_pre_1_0():
+    major = int(anthropic.__version__.split(".")[0])
+    assert major < 1, (
+        f"anthropic {anthropic.__version__} installed; pyproject pins <1 until "
+        "the services are migrated to the 1.x call surface"
+    )