chore(forensics): refresh types after mono details JSONB + reason cleanup

Picks up the schema changes from devhelmhq/mono#316:

- IncidentStateTransitionDto gains a `details: dict[str, Any]` field.
  User-driven transitions carry `details["source"] = "public-api"`;
  pipeline-driven ones carry `details["source"] = "pipeline"`.
- Transition `reason` description aligns with what the engine actually
  writes (trigger | confirm | resolve | auto_clear | reopen). The earlier
  `manually_resolved` was a parallel reason value for the same logical
  edge — replaced by reason="resolve" + details.source="public-api".

Pure regen via `./scripts/typegen.sh`. The mono PR also added
`@Schema(additionalProperties = TRUE)` on the Java DTO so Springdoc emits
`additionalProperties: true` instead of `additionalProperties: {type: "object"}`,
yielding `dict[str, Any]` here instead of `dict[str, dict[str, Any]]`. Without
that fix the Pydantic model would fail to parse real responses (`details.source`
is a string, not a nested dict).

Made-with: Cursor

Author: caballeto

docs/openapi/monitoring-api.json

@@ -25631,24 +25631,24 @@
           },
           "triggeringCheckId": {
             "type": "string",
-            "description": "Scheduler-minted check execution ID whose result confirmed this incident; joins to check_results, rule_evaluations, and incident_state_transitions",
+            "description": "Scheduler-minted check execution ID whose result confirmed this incident; joins to check_results, rule_evaluations, and incident_state_transitions. Omitted from JSON (undefined to SDKs) when null, treat missing as null.",
             "format": "uuid",
             "nullable": true
           },
           "triggeredByRuleSnapshotHashHex": {
             "type": "string",
-            "description": "Hex SHA-256 of the canonical policy snapshot that fired; combined with triggeredByRuleIndex points to the exact TriggerRule",
+            "description": "Hex SHA-256 of the canonical policy snapshot that fired; combined with triggeredByRuleIndex points to the exact TriggerRule. Omitted from JSON when null, treat missing as null.",
             "nullable": true
           },
           "triggeredByRuleIndex": {
             "type": "integer",
-            "description": "Index of the fired rule inside the policy's trigger_rules array",
+            "description": "Index of the fired rule inside the policy's trigger_rules array. Omitted from JSON when null, treat missing as null.",
             "format": "int32",
             "nullable": true
           },
           "engineVersion": {
             "type": "string",
-            "description": "Detection engine semver that evaluated the rule",
+            "description": "Detection engine semver that evaluated the rule. Omitted from JSON when null, treat missing as null.",
             "nullable": true
           }
         },
@@ -25864,6 +25864,7 @@
         "required": [
           "affectedRegions",
           "checkId",
+          "details",
           "engineVersion",
           "fromStatus",
           "id",
@@ -25910,7 +25911,7 @@
           "reason": {
             "minLength": 1,
             "type": "string",
-            "description": "Why the transition fired (rule_matched | confirmation_met | auto_cleared_by_timeout | recovery_met | reopened | manually_resolved | policy_changed)"
+            "description": "Why the transition fired (trigger | confirm | resolve | auto_clear | reopen)"
           },
           "triggeringEvaluationIds": {
             "type": "array",
@@ -25943,6 +25944,11 @@
             "type": "string",
             "description": "Scheduler-minted check execution ID (V92) of the triggering result",
             "format": "uuid"
+          },
+          "details": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Free-form JSON metadata. Key `source` discriminates actor: 'pipeline' (default) vs 'public-api' (user-driven)"
           }
         },
         "description": "State-machine transitions this check caused (may be empty if nothing fired)"

src/devhelm/_generated.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  .openapi-preprocessed.json
-#   timestamp: 2026-04-27T13:26:18+00:00
+#   timestamp: 2026-04-29T16:35:27+00:00
 
 from __future__ import annotations
 from typing import Annotated, Any, Literal
@@ -2204,28 +2204,28 @@ class IncidentDto(BaseModel):
         UUID | None,
         Field(
             alias="triggeringCheckId",
-            description="Scheduler-minted check execution ID whose result confirmed this incident; joins to check_results, rule_evaluations, and incident_state_transitions",
+            description="Scheduler-minted check execution ID whose result confirmed this incident; joins to check_results, rule_evaluations, and incident_state_transitions. Omitted from JSON (undefined to SDKs) when null, treat missing as null.",
         ),
     ] = None
     triggered_by_rule_snapshot_hash_hex: Annotated[
         str | None,
         Field(
             alias="triggeredByRuleSnapshotHashHex",
-            description="Hex SHA-256 of the canonical policy snapshot that fired; combined with triggeredByRuleIndex points to the exact TriggerRule",
+            description="Hex SHA-256 of the canonical policy snapshot that fired; combined with triggeredByRuleIndex points to the exact TriggerRule. Omitted from JSON when null, treat missing as null.",
         ),
     ] = None
     triggered_by_rule_index: Annotated[
         int | None,
         Field(
             alias="triggeredByRuleIndex",
-            description="Index of the fired rule inside the policy's trigger_rules array",
+            description="Index of the fired rule inside the policy's trigger_rules array. Omitted from JSON when null, treat missing as null.",
         ),
     ] = None
     engine_version: Annotated[
         str | None,
         Field(
             alias="engineVersion",
-            description="Detection engine semver that evaluated the rule",
+            description="Detection engine semver that evaluated the rule. Omitted from JSON when null, treat missing as null.",
         ),
     ] = None
 
@@ -2374,7 +2374,7 @@ class IncidentStateTransitionDto(BaseModel):
     reason: Annotated[
         str,
         Field(
-            description="Why the transition fired (rule_matched | confirmation_met | auto_cleared_by_timeout | recovery_met | reopened | manually_resolved | policy_changed)",
+            description="Why the transition fired (trigger | confirm | resolve | auto_clear | reopen)",
             min_length=1,
         ),
     ]
@@ -2415,6 +2415,12 @@ class IncidentStateTransitionDto(BaseModel):
             description="Scheduler-minted check execution ID (V92) of the triggering result",
         ),
     ]
+    details: Annotated[
+        dict[str, Any],
+        Field(
+            description="Free-form JSON metadata. Key `source` discriminates actor: 'pipeline' (default) vs 'public-api' (user-driven)"
+        ),
+    ]
 
 
 class OldStatus(StrEnum):