feat: add dedicated questions namespace and separate from issues

Introduces kili.questions namespace with dedicated methods for question management.
Refactors issues namespace to explicitly filter for issue type, ensuring clear
separation between issues and questions in the domain API.

Author: baptiste-olivier

src/kili/client_domain.py

@@ -16,6 +16,7 @@
         LabelsNamespace,
         OrganizationsNamespace,
         ProjectsNamespace,
+        QuestionsNamespace,
         StoragesNamespace,
         TagsNamespace,
         UsersNamespace,
@@ -208,6 +209,24 @@ def issues(self) -> "IssuesNamespace":
 
         return IssuesNamespace(self.legacy_client, self.legacy_client.kili_api_gateway)
 
+    @cached_property
+    def questions(self) -> "QuestionsNamespace":
+        """Get the questions domain namespace.
+
+        Returns:
+            QuestionsNamespace: Questions domain namespace with lazy loading
+
+        Examples:
+            ```python
+            kili = Kili()
+            # Namespace is instantiated on first access
+            questions = kili.questions
+            ```
+        """
+        from kili.domain_api import QuestionsNamespace  # pylint: disable=import-outside-toplevel
+
+        return QuestionsNamespace(self.legacy_client, self.legacy_client.kili_api_gateway)
+
     @cached_property
     def tags(self) -> "TagsNamespace":
         """Get the tags domain namespace.

src/kili/domain_api/__init__.py

@@ -12,6 +12,7 @@
 from .organizations import OrganizationsNamespace
 from .plugins import PluginsNamespace
 from .projects import ProjectsNamespace
+from .questions import QuestionsNamespace
 from .storages import StoragesNamespace
 from .tags import TagsNamespace
 from .users import UsersNamespace
@@ -25,6 +26,7 @@
     "OrganizationsNamespace",
     "PluginsNamespace",
     "ProjectsNamespace",
+    "QuestionsNamespace",
     "StoragesNamespace",
     "TagsNamespace",
     "UsersNamespace",

src/kili/domain_api/issues.py

@@ -9,7 +9,7 @@
 
 from typeguard import typechecked
 
-from kili.domain.issue import IssueId, IssueStatus, IssueType
+from kili.domain.issue import IssueId, IssueStatus
 from kili.domain.label import LabelId
 from kili.domain.project import ProjectId
 from kili.domain.types import ListOrTuple
@@ -28,13 +28,11 @@ class IssueFilter(TypedDict, total=False):
         asset_id: Id of the asset whose returned issues are associated to.
         asset_id_in: List of Ids of assets whose returned issues are associated to.
         status: Status of the issues to return (e.g., 'OPEN', 'SOLVED', 'CANCELLED').
-        issue_type: Type of the issue to return. An issue object both represents issues and questions in the app.
     """
 
     asset_id: Optional[str]
     asset_id_in: Optional[List[str]]
     status: Optional[IssueStatus]
-    issue_type: Optional[IssueType]
 
 
 class IssuesNamespace(DomainNamespace):
@@ -99,10 +97,8 @@ def list(
     ) -> List[Dict]:
         """Get a list of issues that match a set of criteria.
 
-        !!! Info "Issues or Questions"
-            An `Issue` object both represent an issue and a question in the app.
-            To create them, two different methods are provided: `create_issues` and `create_questions`.
-            However to query issues and questions, we currently provide this unique method that retrieves both of them.
+        !!! Info "Issues vs Questions"
+            This method returns only issues (type='ISSUE'). For questions, use `kili.questions.list()` instead.
 
         Args:
             project_id: Project ID the issue belongs to.
@@ -134,7 +130,9 @@ def list(
             ...     filter={"status": "OPEN"}
             ... )
         """
-        filter_kwargs = filter or {}
+        filter_kwargs: Dict[str, Any] = dict(filter or {})
+        # Force issue_type to ISSUE
+        filter_kwargs["issue_type"] = "ISSUE"
         return self.client.issues(
             as_generator=False,
             disable_tqdm=disable_tqdm,
@@ -163,10 +161,9 @@ def list_as_generator(
     ) -> Generator[Dict, None, None]:
         """Get a generator of issues that match a set of criteria.
 
-        !!! Info "Issues or Questions"
-            An `Issue` object both represent an issue and a question in the app.
-            To create them, two different methods are provided: `create_issues` and `create_questions`.
-            However to query issues and questions, we currently provide this unique method that retrieves both of them.
+        !!! Info "Issues vs Questions"
+            This method returns only issues (type='ISSUE'). For questions, use
+            `kili.questions.list_as_generator()` instead.
 
         Args:
             project_id: Project ID the issue belongs to.
@@ -193,7 +190,9 @@ def list_as_generator(
             ... ):
             ...     print(issue["id"])
         """
-        filter_kwargs = filter or {}
+        filter_kwargs: Dict[str, Any] = dict(filter or {})
+        # Force issue_type to ISSUE
+        filter_kwargs["issue_type"] = "ISSUE"
         return self.client.issues(
             as_generator=True,
             disable_tqdm=disable_tqdm,
@@ -225,7 +224,9 @@ def count(self, project_id: str, filter: Optional[IssueFilter] = None) -> int:
             ...     filter={"asset_id_in": ["asset_1", "asset_2"], "status": "OPEN"}
             ... )
         """
-        filter_kwargs = filter or {}
+        filter_kwargs: Dict[str, Any] = dict(filter or {})
+        # Force issue_type to ISSUE
+        filter_kwargs["issue_type"] = "ISSUE"
         return self.client.count_issues(
             project_id=project_id,
             **filter_kwargs,