docs(monitors): note currentStatus removal on MonitorDto

The docs-quickstart at https://docs.devhelm.io/sdk/python/quickstart
shows ``monitor.currentStatus`` but the field was removed from the
DTO and never came back. Pre-existing SDK users hit this on upgrade
and are stuck guessing how to recover the live status of a monitor.

Inject a class-level docstring banner via ``inject_strict_config.py``
so the note shows up in IDE hovers and survives regeneration. The
banner table is keyed by class name so future runtime-affecting
upstream changes can land here without bloating the typegen.

Restoring ``current_status`` properly is upstream work in mono;
tracked separately. Round-3 DevEx fix P1.Bug9 (in-scope half).

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: caballeto

scripts/inject_strict_config.py

@@ -52,6 +52,18 @@
 CLASS_RE = re.compile(r"^class\s+([A-Za-z_][\w]*)\s*\(\s*(BaseModel)\s*\)\s*:\s*$")
 CONFIG_LINE = "    model_config = ConfigDict(extra='forbid', populate_by_name=True)"
 
+# Doc-banner injections keyed by class name. Inserted as a leading docstring
+# inside the target class so the note shows up in IDE hovers and stays put
+# across regeneration. Keep messages short and actionable; long-form
+# documentation belongs in the API reference, not the generated source.
+CLASS_BANNERS: dict[str, str] = {
+    "MonitorDto": (
+        "Note: ``currentStatus`` was removed from this DTO. "
+        "Inspect ``enabled`` and the incident-policy API to derive a "
+        "live status for a monitor instead."
+    ),
+}
+
 
 # StrEnum members that shadow inherited str methods need a `# type: ignore`
 # because mypy thinks they're overriding the base method with an incompatible
@@ -117,10 +129,17 @@ def inject(source: str) -> tuple[str, int]:
         if not m:
             i += 1
             continue
+        class_name = m.group(1)
         # Look at the very next line. If it's already model_config or pass,
         # leave the class alone (idempotency / empty class).
         next_idx = i + 1
         next_line = lines[next_idx] if next_idx < len(lines) else ""
+        # Inject the class-level docstring banner if requested. Skip if a
+        # docstring is already present (idempotent on partial reruns).
+        banner = CLASS_BANNERS.get(class_name)
+        if banner and not next_line.lstrip().startswith(('"""', "'''")):
+            out.append(f'    """{banner}"""\n')
+            modified += 1
         if "model_config" in next_line:
             # Upgrade the existing config line to include populate_by_name=True
             # if it isn't already there. Idempotent across re-runs.

src/devhelm/_generated.py

@@ -6818,6 +6818,8 @@ class MonitorAssertionDto(BaseModel):
 
 
 class MonitorDto(BaseModel):
+    """Note: ``currentStatus`` was removed from this DTO. Inspect ``enabled`` and the incident-policy API to derive a live status for a monitor instead."""
+
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
     id: Annotated[UUID, Field(description="Unique monitor identifier")]
     organization_id: Annotated[