From f871776ed4f2fb6c5ed7671fe5446d601d984fb9 Mon Sep 17 00:00:00 2001
From: ktyagiapphelix2u <ktyagi-apphelix@2u.com>
Date: Fri, 27 Mar 2026 05:01:07 +0000
Subject: [PATCH] feat: add ManagementCommandExecutionRequested filter for
 observability

---
 openedx_filters/management/__init__.py        |  3 ++
 openedx_filters/management/filters.py         | 53 +++++++++++++++++++
 .../management/tests/test_filters.py          | 35 ++++++++++++
 3 files changed, 91 insertions(+)
 create mode 100644 openedx_filters/management/__init__.py
 create mode 100644 openedx_filters/management/filters.py
 create mode 100644 openedx_filters/management/tests/test_filters.py

diff --git a/openedx_filters/management/__init__.py b/openedx_filters/management/__init__.py
new file mode 100644
index 00000000..91f5b3d6
--- /dev/null
+++ b/openedx_filters/management/__init__.py
@@ -0,0 +1,3 @@
+"""
+Package where filters related to management command execution are implemented.
+"""
diff --git a/openedx_filters/management/filters.py b/openedx_filters/management/filters.py
new file mode 100644
index 00000000..449a9779
--- /dev/null
+++ b/openedx_filters/management/filters.py
@@ -0,0 +1,53 @@
+"""
+Package where filters related to management command execution are implemented.
+"""
+
+from collections.abc import Callable
+from typing import Any
+
+from openedx_filters.tooling import OpenEdxPublicFilter
+
+
+class ManagementCommandExecutionRequested(OpenEdxPublicFilter):
+    """
+    Filter used to modify the execution of Django management commands.
+
+    Purpose:
+        This filter is triggered in ``manage.py`` before a management command is
+        executed, allowing pipeline steps to wrap or replace the command runner.
+
+    Filter Type:
+        org.openedx.platform.management.command.execute.requested.v1
+
+    Trigger:
+        - Repository: openedx/edx-platform
+        - Path: manage.py
+        - Function or Method: __main__
+    """
+
+    filter_type = "org.openedx.platform.management.command.execute.requested.v1"
+
+    @classmethod
+    def run_filter(
+        cls,
+        command_name: str,
+        service_variant: str,
+        command_runner: Callable[..., Any],
+    ) -> dict[str, Any]:
+        """
+        Process management command execution arguments through the pipeline.
+
+        Arguments:
+            command_name (str): name of the management command being executed.
+            service_variant (str): service variant, such as lms or cms.
+            command_runner (Callable): callable that executes the command.
+
+        Returns:
+            dict[str, Any]: accumulated pipeline output, including possibly
+                modified command metadata and command runner.
+        """
+        return super().run_pipeline(
+            command_name=command_name,
+            service_variant=service_variant,
+            command_runner=command_runner,
+        )
diff --git a/openedx_filters/management/tests/test_filters.py b/openedx_filters/management/tests/test_filters.py
new file mode 100644
index 00000000..e74552fd
--- /dev/null
+++ b/openedx_filters/management/tests/test_filters.py
@@ -0,0 +1,35 @@
+"""
+Tests for management subdomain filters.
+"""
+from unittest.mock import Mock
+
+from django.test import TestCase
+
+from openedx_filters.management.filters import ManagementCommandExecutionRequested
+
+
+class TestManagementFilters(TestCase):
+    """
+    Test class to verify standard behavior of management filters.
+    """
+
+    def test_management_command_execution_requested(self):
+        """
+        Test ManagementCommandExecutionRequested filter behavior.
+
+        Expected behavior:
+            - The filter should return management command metadata and runner.
+        """
+        command_name = "migrate"
+        service_variant = "lms"
+        command_runner = Mock()
+
+        result = ManagementCommandExecutionRequested.run_filter(
+            command_name=command_name,
+            service_variant=service_variant,
+            command_runner=command_runner,
+        )
+
+        self.assertEqual(command_name, result.get("command_name"))
+        self.assertEqual(service_variant, result.get("service_variant"))
+        self.assertEqual(command_runner, result.get("command_runner"))