codee-agent 0.5.1__tar.gz → 0.5.3__tar.gz

{codee_agent-0.5.1 → codee_agent-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codee-agent
-Version: 0.5.1
+Version: 0.5.3
 Summary: A virtual co-worker that picks up Jira and Azure DevOps tasks and solves them with coding agents.
 Keywords: ai,agent,jira,azure-devops,claude-code,github-copilot,automation
 Author: Denis Kibalko

{codee_agent-0.5.1 → codee_agent-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codee-agent"
-version = "0.5.1"
+version = "0.5.3"
 description = "A virtual co-worker that picks up Jira and Azure DevOps tasks and solves them with coding agents."
 readme = "README.md"
 license = "MIT"

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee/admin.py

@@ -2238,7 +2238,8 @@ def tasks_check_row(check: CheckResult) -> rx.Component:
                     color=rx.cond(check.status == "waiting", MUTED, TEXT)),
             rx.cond(
                 check.message != "",
-                rx.text(check.message, color=MUTED, font_size="0.8rem")),
+                rx.text(check.message, color=MUTED, font_size="0.8rem",
+                        white_space="pre-wrap", overflow_wrap="anywhere")),
             spacing="1", align="start", width="100%"),
         spacing="2", align="start", width="100%")
 

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee/admin_service.py

@@ -159,7 +159,9 @@ def _mcp_check_prompt(server_name: str, steps: list[str]) -> str:
         '"status": "<the status you left it in>"}\n'
         "If any step did not complete:\n"
         '{"ok": false, "error": "<one sentence naming the step that failed '
-        'and why>"}'
+        'and why>", "request": "<the complete MCP tool request exactly as '
+        'sent, or null if none was sent>", "response": "<the complete MCP '
+        'response or error exactly as received, or null if none was received>"}'
     )
 
 
@@ -177,11 +179,18 @@ def _mcp_check_result(server_name: str, response: str) -> dict[str, Any]:
             raise ValueError
     except ValueError:
         return _check(MCP_CHECK, False, "The agent did not report a result: "
-                      f"{response.strip()[:300] or 'it said nothing'}")
+                      f"{response.strip() or 'it said nothing'}")
     if not payload.get("ok"):
-        return _check(MCP_CHECK, False,
-                      str(payload.get("error")
-                          or "The agent reported a failure."))
+        message = str(payload.get("error")
+                      or "The agent reported a failure.")
+        if "request" in payload or "response" in payload:
+            request = json.dumps(payload.get("request"), indent=2,
+                                 ensure_ascii=False)
+            response = json.dumps(payload.get("response"), indent=2,
+                                  ensure_ascii=False)
+            message += (f"\n\nMCP request:\n{request}"
+                        f"\n\nMCP response:\n{response}")
+        return _check(MCP_CHECK, False, message)
     task = str(payload.get("task") or "a task").strip()
     status = str(payload.get("status") or "a closed status").strip()
     return _check(MCP_CHECK, True,

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee/test_admin_service.py

@@ -911,7 +911,8 @@ class AdminServiceSkillExtraFrontmatterTest(unittest.TestCase):
 
     def test_save_writes_the_extra_fields_into_the_frontmatter(self) -> None:
         with tempfile.TemporaryDirectory() as temporary_directory:
-            service = self._service(Path(temporary_directory), "name: nightly\n")
+            service = self._service(
+                Path(temporary_directory), "name: nightly\n")
 
             write, _ = self._save(
                 service, "allowed-tools: Bash\ncompatibility: Claude Code\n")
@@ -942,9 +943,11 @@ class AdminServiceSkillExtraFrontmatterTest(unittest.TestCase):
 
     def test_invalid_yaml_is_reported_and_nothing_is_written(self) -> None:
         with tempfile.TemporaryDirectory() as temporary_directory:
-            service = self._service(Path(temporary_directory), "name: nightly\n")
+            service = self._service(
+                Path(temporary_directory), "name: nightly\n")
 
-            write, (saved, _, message, slug) = self._save(service, "allowed-tools")
+            write, (saved, _, message, slug) = self._save(
+                service, "allowed-tools")
 
             write.assert_not_called()
             self.assertFalse(saved)
@@ -953,7 +956,8 @@ class AdminServiceSkillExtraFrontmatterTest(unittest.TestCase):
 
     def test_a_field_that_has_its_own_control_is_rejected(self) -> None:
         with tempfile.TemporaryDirectory() as temporary_directory:
-            service = self._service(Path(temporary_directory), "name: nightly\n")
+            service = self._service(
+                Path(temporary_directory), "name: nightly\n")
 
             write, (saved, _, message, _) = self._save(
                 service, "model: claude-opus-5\n")
@@ -973,7 +977,8 @@ class AdminServiceSkillExtraFrontmatterTest(unittest.TestCase):
 
     def test_load_returns_an_empty_string_when_there_are_none(self) -> None:
         with tempfile.TemporaryDirectory() as temporary_directory:
-            service = self._service(Path(temporary_directory), "name: nightly\n")
+            service = self._service(
+                Path(temporary_directory), "name: nightly\n")
 
             self.assertEqual(service.load_skill("nightly")["extra"], "")
 
@@ -991,12 +996,14 @@ class AdminServiceAgentModelsTest(unittest.TestCase):
         service = self._service(CodingAgent.CLAUDE_CODE)
 
         with patch.object(ClaudeCodeAgent, "list_models",
-                          return_value=[AgentModel("claude-opus-5", "Claude Opus 5")]
+                          return_value=[AgentModel(
+                              "claude-opus-5", "Claude Opus 5")]
                           ) as list_models:
             first = service.list_agent_models()
             second = service.list_agent_models()
 
-        self.assertEqual(first, [{"id": "claude-opus-5", "name": "Claude Opus 5"}])
+        self.assertEqual(
+            first, [{"id": "claude-opus-5", "name": "Claude Opus 5"}])
         self.assertEqual(second, first)
         list_models.assert_called_once()
 
@@ -1092,10 +1099,12 @@ class AdminServiceRepositoriesTest(unittest.TestCase):
         return result.stdout.strip()
 
     def test_name_is_taken_from_every_url_form(self) -> None:
-        self.assertEqual(repository_name("git@github.com:org/codee.git"), "codee")
+        self.assertEqual(repository_name(
+            "git@github.com:org/codee.git"), "codee")
         self.assertEqual(repository_name("ssh://git@github.com/org/codee.git"),
                          "codee")
-        self.assertEqual(repository_name("https://github.com/org/codee/"), "codee")
+        self.assertEqual(repository_name(
+            "https://github.com/org/codee/"), "codee")
         self.assertEqual(repository_name("  "), "")
 
     def test_add_builds_the_bare_and_worktree_layout(self) -> None:
@@ -1197,7 +1206,8 @@ class AzureDevOpsOAuthTest(unittest.TestCase):
             tasks_provider=TasksProvider.AZURE_DEVOPS,
             credentials={"azure_devops": credentials
                          if credentials is not None else self.AZURE_CREDENTIALS})
-        service.context = CodeeMainContext(data_dir=data_dir, settings=settings)
+        service.context = CodeeMainContext(
+            data_dir=data_dir, settings=settings)
         save_settings(data_dir, settings)
         return service
 
@@ -1241,14 +1251,16 @@ class AzureDevOpsOAuthTest(unittest.TestCase):
 
             with patch.object(azure_oauth, "exchange_code", return_value=tokens) as exchange, \
                     patch.object(azure_oauth, "fetch_account", return_value="dev@acme.com"):
-                connected, message = service.complete_azure_authorization("code-1", state)
+                connected, message = service.complete_azure_authorization(
+                    "code-1", state)
 
             self.assertTrue(started)
             self.assertTrue(connected)
             self.assertIn("dev@acme.com", message)
             # The exchange must reuse the redirect URI the authorization was issued
             # with — Entra rejects the code otherwise.
-            self.assertEqual(exchange.call_args.args[1], service.azure_redirect_uri())
+            self.assertEqual(
+                exchange.call_args.args[1], service.azure_redirect_uri())
             self.assertTrue(service.azure_connection()["connected"])
 
     def test_callback_with_a_forged_state_stores_nothing(self) -> None:
@@ -1274,7 +1286,8 @@ class AzureDevOpsOAuthTest(unittest.TestCase):
             with patch.object(azure_oauth, "exchange_code",
                               side_effect=azure_oauth.AzureDevOpsAuthError(
                                   "AADSTS7000215: Invalid client secret.")):
-                connected, message = service.complete_azure_authorization("code-1", state)
+                connected, message = service.complete_azure_authorization(
+                    "code-1", state)
 
             self.assertFalse(connected)
             self.assertIn("Invalid client secret", message)
@@ -1312,7 +1325,8 @@ class VerifyTasksConnectionTest(unittest.TestCase):
         service.skills_dir = _write_issue_skill(root)
         service.data_dir = root / ".codee"
         service.data_dir.mkdir()
-        settings = Settings(credentials={"jira": {"base_url": "https://stale.test"}})
+        settings = Settings(
+            credentials={"jira": {"base_url": "https://stale.test"}})
         service.context = CodeeMainContext(
             data_dir=service.data_dir, settings=settings)
         save_settings(service.data_dir, settings)
@@ -1463,6 +1477,10 @@ class VerifyTasksMcpCheckTest(unittest.TestCase):
                           self.prompt)
             self.assertIn("2. Move that issue to a Done or Cancelled status",
                           self.prompt)
+            self.assertIn("complete MCP tool request exactly as sent",
+                          self.prompt)
+            self.assertIn("complete MCP response or error exactly as received",
+                          self.prompt)
 
     def test_a_fenced_reply_is_still_read(self) -> None:
         with tempfile.TemporaryDirectory() as temporary_directory:
@@ -1484,6 +1502,40 @@ class VerifyTasksMcpCheckTest(unittest.TestCase):
             self.assertEqual(check["message"],
                              "No create-issue tool was offered.")
 
+    def test_a_reported_failure_includes_the_full_mcp_exchange(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_directory:
+            service = self._service(Path(temporary_directory))
+            request = {
+                "tool": "ado-wit_work_item_write",
+                "arguments": {"fields": [{"name": "System.Title",
+                                          "value": "Codee check"}]},
+            }
+            response = {
+                "error": {"code": "invalid_type",
+                          "message": "Input validation failed"}}
+
+            check = self._run(service, json.dumps({
+                "ok": False,
+                "error": "Creating the work item failed.",
+                "request": request,
+                "response": response,
+            }))
+
+            self.assertFalse(check["ok"])
+            self.assertIn("MCP request:\n" + json.dumps(
+                request, indent=2), check["message"])
+            self.assertIn("MCP response:\n" + json.dumps(
+                response, indent=2), check["message"])
+
+    def test_a_non_json_failure_is_not_truncated(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_directory:
+            service = self._service(Path(temporary_directory))
+            response = "x" * 500
+
+            check = self._run(service, response)
+
+            self.assertTrue(check["message"].endswith(response))
+
     def test_an_answer_that_is_not_the_asked_for_json_fails_the_check(self) -> None:
         # An agent that ignored the format can't be believed about the rest.
         with tempfile.TemporaryDirectory() as temporary_directory:
@@ -1558,7 +1610,8 @@ class SetupTasksMcpTest(unittest.TestCase):
         service.root = root
         service.data_dir = root / ".codee"
         service.data_dir.mkdir()
-        settings = Settings(credentials={"jira": {"base_url": "https://stale.test"}})
+        settings = Settings(
+            credentials={"jira": {"base_url": "https://stale.test"}})
         service.context = CodeeMainContext(
             data_dir=service.data_dir, settings=settings)
         save_settings(service.data_dir, settings)
@@ -1572,7 +1625,8 @@ class SetupTasksMcpTest(unittest.TestCase):
             root = Path(temporary_directory)
             service = self._service(root)
 
-            done, message = service.setup_tasks_mcp("jira", self.JIRA_CREDENTIALS)
+            done, message = service.setup_tasks_mcp(
+                "jira", self.JIRA_CREDENTIALS)
 
             self.assertTrue(done, message)
             config = self._config(root)
@@ -1670,7 +1724,8 @@ class SetupTasksMcpTest(unittest.TestCase):
             service = self._service(root)
             (root / ".mcp.json").write_text("{not json")
 
-            done, message = service.setup_tasks_mcp("jira", self.JIRA_CREDENTIALS)
+            done, message = service.setup_tasks_mcp(
+                "jira", self.JIRA_CREDENTIALS)
 
             self.assertFalse(done)
             self.assertIn("not valid JSON", message)

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee_tasks_abstract/provider.py

@@ -146,7 +146,7 @@ class AbstractTasksProvider(ABC):
         """
         if not tasks:
             return (f"Connected to {self.describe()}. "
-                    "No tasks are assigned to it right now.")
+                    "No tasks are waiting for it right now.")
         preview = ", ".join(f"{task.key} {task.summary}" for task in tasks[:3])
         more = f", +{len(tasks) - 3} more" if len(tasks) > 3 else ""
         return (f"Connected to {self.describe()}. "

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee_tasks_azure_devops/provider.py

@@ -1,7 +1,7 @@
 """Read-only Azure DevOps tasks provider, authenticated through Entra ID.
 
-Every call here is a read: a WIQL query for the ids assigned to the connected
-account, then a batch fetch of those work items. The WIQL endpoint is a POST,
+Every call here is a read: a WIQL query for the ids of the Codee work items in
+the states the skills trigger on, then a batch fetch of those work items. The WIQL endpoint is a POST,
 but it is a query — nothing in this module creates or modifies a work item.
 """
 from urllib.parse import quote
@@ -36,8 +36,8 @@ _FIELDS = [
 # Which Azure DevOps work item types Codee picks up, and what each stands for,
 # is configured per installation in Settings — organizations disagree on the
 # names ("User Story" in Agile, "Product Backlog Item" in Scrum, anything at
-# all in a custom process). Anything else assigned to the connected account
-# belongs to a human and is left alone.
+# all in a custom process). A work item of any other type belongs to a human
+# and is left alone, whatever state it reaches.
 
 # Azure DevOps priority is 1-4 with 1 highest; the executor logs this next to
 # JIRA-style names, so translate rather than print a bare digit.
@@ -122,7 +122,7 @@ class AzureDevOpsWorkItem(Task):
 
 
 class AzureDevOpsTasksProvider(AbstractTasksProvider):
-    """Fetches work items assigned to the connected account as provider-agnostic Tasks."""
+    """Fetches the organization's Codee work items as provider-agnostic Tasks."""
 
     DISPLAY_NAME = "Azure DevOps"
     MCP_SERVER_NAME = "ado"
@@ -157,11 +157,21 @@ class AzureDevOpsTasksProvider(AbstractTasksProvider):
         connection = self._auth.connection() or {}
         account = connection.get("account") or "connected account"
         types = ", ".join(self._work_item_types.values()) or "no work item types"
+        # The account is named as the identity the query runs as, not as a
+        # filter — the poll matches on type and state, whoever a work item is
+        # assigned to.
         # The filter only gets a mention when there is one: it is off for most
         # installations, and "filter none" reads like a setting gone wrong.
         extra = f", filter {self._task_filter}" if self._task_filter else ""
         return (f"Azure DevOps {self._config.organization_url} "
-                f"(all projects, assignee {account}, types {types}{extra})")
+                f"(all projects, connected as {account}, types {types}{extra})")
+
+    def verify_connection(self, statuses: list[str]) -> tuple[bool, str]:
+        """Pull tasks and include the exact WIQL in a successful check."""
+        verified, message = super().verify_connection(statuses)
+        if not verified:
+            return verified, message
+        return verified, f"{message}\n\nWIQL: {self._build_wiql(statuses)}"
 
     def mcp_server(self) -> McpServer | None:
         """Microsoft's Azure DevOps MCP server, addressed at this organization.
@@ -204,7 +214,7 @@ class AzureDevOpsTasksProvider(AbstractTasksProvider):
         return [
             f'Create a new "{item_type}" work item in the {organization} '
             "organization, in any project you can create work items in, with "
-            f'the title "{summary}", assigned to {account}.',
+            f'the title "{summary}".',
             "Move that work item to a Done, Closed or Removed state — "
             "whichever its board offers — so it does not stay open.",
         ]
@@ -280,7 +290,7 @@ class AzureDevOpsTasksProvider(AbstractTasksProvider):
 
     def get_tasks(self, statuses: list[str],
                   raise_errors: bool = False) -> list[Task]:
-        """Fetch work items assigned to the connected account in the given states."""
+        """Fetch the Codee work items sitting in the given states."""
         # Nothing is waiting on a work item, so there is no request worth
         # making. The settings check passes no statuses too, but there the whole
         # point is to reach Azure DevOps, so it queries without a state filter.
@@ -342,29 +352,39 @@ class AzureDevOpsTasksProvider(AbstractTasksProvider):
         """The state filter, dropped entirely when nothing was requested.
 
         ``IN ()`` is not valid WIQL, and the only caller that passes no statuses
-        is the connection check — it wants every Codee work item assigned to the
-        account, whatever state it sits in.
+        is the connection check — it wants every Codee work item it can see,
+        whatever state it sits in.
         """
         if not statuses:
             return ""
         quoted = ", ".join(_quote_wiql(status) for status in statuses)
-        return f"AND [System.State] IN ({quoted}) "
+        return f"[System.State] IN ({quoted})"
 
     def _build_wiql(self, statuses: list[str]) -> str:
-        """WIQL for Codee work items owned by the connected account, highest priority first.
-
-        Nothing here names a project, and no ``@project`` macro is used — that
-        is what keeps the query valid with no project in the route, so it spans
-        the organization. What comes back is still narrow: only the Codee work
-        item types, only the states asked for, and only what is assigned to the
-        connected account.
+        """WIQL for Codee work items, highest priority first, then oldest.
+
+        There is no assignee clause: what hands a work item to Codee is its
+        type and its state, not who it is assigned to. So a work item a human
+        still owns is picked up the moment it reaches a state one of the skills
+        triggers on, which is what makes those states the handover — they have
+        to be ones only Codee's workflow uses. An installation that does want
+        an owner filter writes one as the custom WIQL in Settings, e.g.
+        ``[System.AssignedTo] = @Me``.
+
+        Nothing here names a project either, and no ``@project`` macro is used
+        — that is what keeps the query valid with no project in the route, so
+        it spans the organization. What comes back is still narrow: only the
+        Codee work item types, and only the states asked for.
         """
+        clauses = [clause for clause in (
+            self._build_wiql_type_clause(),
+            self._build_wiql_status_clause(statuses),
+            self._build_wiql_filter_clause(),
+        ) if clause]
+        where = f"WHERE {' AND '.join(clauses)} " if clauses else ""
         return (
             "SELECT [System.Id] FROM WorkItems "
-            "WHERE [System.AssignedTo] = @Me "
-            f"{self._build_wiql_type_clause()}"
-            f"{self._build_wiql_status_clause(statuses)}"
-            f"{self._build_wiql_filter_clause()}"
+            f"{where}"
             "ORDER BY [Microsoft.VSTS.Common.Priority] ASC, [System.CreatedDate] ASC"
         )
 
@@ -373,25 +393,26 @@ class AzureDevOpsTasksProvider(AbstractTasksProvider):
 
         Bracketed, because a filter is a whole condition rather than a single
         term: an unparenthesized ``... OR ...`` would bind its OR across the
-        assignee and type clauses and hand back items Codee does not own.
+        type and state clauses and hand back items Codee does not own.
         """
         if not self._task_filter:
             return ""
-        return f"AND ({self._task_filter}) "
+        return f"({self._task_filter})"
 
     def _build_wiql_type_clause(self) -> str:
         """The work item type filter, from the work items configured in Settings.
 
         Dropped when nothing is mapped, like the state clause above and for the
-        same reason — but this one dropping is worse than a wide query: it would
-        hand the executor every item assigned to the account. Settings keeps the
-        mandatory work items filled in so it cannot happen in practice.
+        same reason — but this one dropping is worse than a wide query: with no
+        assignee clause to fall back on it would hand the executor every item in
+        the organization. Settings keeps the mandatory work items filled in so
+        it cannot happen in practice.
         """
         item_types = list(self._work_item_types.values())
         if not item_types:
             return ""
         quoted = ", ".join(_quote_wiql(item_type) for item_type in item_types)
-        return f"AND [System.WorkItemType] IN ({quoted}) "
+        return f"[System.WorkItemType] IN ({quoted})"
 
     def _fetch_work_items(self, token: str, ids: list[int]) -> list[dict]:
         """Batch-fetch the requested work items. Organization-scoped, as the API requires."""

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee_tasks_azure_devops/test.py

@@ -339,9 +339,16 @@ class TasksProviderTest(unittest.TestCase):
         wiql = self.provider._build_wiql(["Ready", "Bob's queue"])
 
         self.assertIn("[System.State] IN ('Ready', 'Bob''s queue')", wiql)
-        self.assertIn("[System.AssignedTo] = @Me", wiql)
         self.assertIn("ORDER BY [Microsoft.VSTS.Common.Priority] ASC", wiql)
 
+    def test_the_query_does_not_filter_on_an_assignee(self) -> None:
+        # Type and state are the handover; who the work item is assigned
+        # to is nobody's business but the humans working alongside it.
+        wiql = self.provider._build_wiql(["Ready"])
+
+        self.assertNotIn("System.AssignedTo", wiql)
+        self.assertNotIn("@Me", wiql)
+
     def test_wiql_only_asks_for_the_mapped_work_item_types(self) -> None:
         wiql = self.provider._build_wiql(["Ready"])
 
@@ -534,7 +541,7 @@ class TasksProviderTest(unittest.TestCase):
         wiql = self.provider._build_wiql([])
 
         self.assertNotIn("[System.State] IN", wiql)
-        self.assertIn("[System.AssignedTo] = @Me", wiql)
+        self.assertIn("[System.WorkItemType] IN", wiql)
 
     def test_a_successful_pull_names_the_work_items_it_found(self) -> None:
         self._connect()
@@ -551,6 +558,31 @@ class TasksProviderTest(unittest.TestCase):
 
         self.assertTrue(verified)
         self.assertIn("11 Fix the thing", message)
+        self.assertIn(
+            "WIQL: SELECT [System.Id] FROM WorkItems "
+            "WHERE [System.WorkItemType] IN ('User Story', 'Task') "
+            "AND [System.State] IN ('Ready') "
+            "ORDER BY [Microsoft.VSTS.Common.Priority] ASC, "
+            "[System.CreatedDate] ASC",
+            message)
+
+    def test_an_empty_check_prints_the_custom_filter_in_the_raw_wiql(self) -> None:
+        self._connect()
+        settings = _settings(organization_url="https://dev.azure.com/acme",
+                             client_id="client-1", client_secret="secret-1")
+        settings.task_filters = {
+            "azure_devops": "[Custom.Assistant] = 'Codee Agent User Account'"}
+        provider = AzureDevOpsTasksProvider(settings, self.context)
+
+        with patch("codee_tasks_azure_devops.provider.requests.post",
+                   return_value=_response({"workItems": []})):
+            verified, message = provider.verify_connection(["Ready"])
+
+        self.assertTrue(verified)
+        self.assertIn("No tasks are waiting for it right now.", message)
+        self.assertIn(
+            "AND ([Custom.Assistant] = 'Codee Agent User Account') ORDER BY",
+            message)
 
     def test_a_rejected_query_reports_what_azure_devops_said(self) -> None:
         self._connect()
@@ -614,7 +646,8 @@ class AzureDevOpsMcpTest(unittest.TestCase):
         self.assertIn('"Task" work item', steps[0])
         self.assertIn("acme organization", steps[0])
         self.assertIn('title "Codee check 1234"', steps[0])
-        self.assertIn("assigned to dev@acme.com", steps[0])
+        # Nothing is said about the assignee: the poll does not filter on one.
+        self.assertNotIn("assigned to", steps[0])
         self.assertIn("Done, Closed or Removed", steps[1])
 
     def test_no_check_steps_before_the_account_is_known(self) -> None:

{codee_agent-0.5.1 → codee_agent-0.5.3}/src/codee_tasks_jira/provider.py

@@ -174,7 +174,7 @@ class JiraTasksProvider(AbstractTasksProvider):
 
     def get_tasks(self, statuses: list[str],
                   raise_errors: bool = False) -> list[Task]:
-        """Fetch tasks assigned to the target user in the configured states."""
+        """Fetch the Codee issues sitting in the configured statuses."""
         # Nothing is waiting on an issue, so there is no request worth making.
         # The settings check passes no statuses too, but there the whole point
         # is to reach JIRA, so it queries without a status filter.