DRU-387 - Local issue tracker

backend/druks/contrib/software_factory/app.py

@@ -1,5 +1,6 @@
 from typing import Literal
 
+import httpx
 from pydantic import Field
 
 from druks.agents import Agent
@@ -14,12 +15,15 @@
     ReviewReport,
     TriageOutput,
 )
+from druks.contrib.software_factory.issues.enums import Status as IssuesStatus
 from druks.contrib.software_factory.ticketing.base import Tracker
+from druks.contrib.software_factory.ticketing.issues import IssuesTracker
 from druks.contrib.software_factory.ticketing.jira import Jira
 from druks.contrib.software_factory.ticketing.linear import Linear
 from druks.core import services
 from druks.doctor import CheckResult
 from druks.services import ServiceNotConnectedError
+from druks.settings import load_settings
 
 from .services import GithubReviewer
 
@@ -30,6 +34,8 @@ async def check_tracker_identity() -> CheckResult:
     settings = await SoftwareFactory.settings()
     if settings.tracker == "none":
         return CheckResult(name="tracker", ok=True, detail="trackerless by choice")
+    if settings.tracker == "issues":
+        return CheckResult(name="tracker", ok=True, detail="local issues board")
     service = {"linear": services.Linear, "jira": services.Jira}[settings.tracker]
     if await service.is_connected():
         return CheckResult(name="tracker", ok=True, detail=f"{settings.tracker} connected")
@@ -55,6 +61,38 @@ async def check_review_identity() -> CheckResult:
     )
 
 
+async def check_issues_mcp() -> CheckResult:
+    """Whether this appliance's /mcp answers, so an issues build can fetch
+    and comment. Linear and Jira do not need it."""
+    if (await SoftwareFactory.settings()).tracker != "issues":
+        return CheckResult(name="issues_mcp", ok=True, detail="not required")
+    endpoint = load_settings().urls.endpoint.rstrip("/")
+    if not endpoint:
+        return CheckResult(
+            name="issues_mcp",
+            ok=False,
+            pending=True,
+            detail="urls.endpoint is unset — the sandbox needs it to reach /mcp.",
+        )
+    url = f"{endpoint}/mcp"
+    try:
+        async with httpx.AsyncClient(timeout=5.0) as client:
+            response = await client.get(url)
+    except httpx.RequestError as error:
+        return CheckResult(
+            name="issues_mcp",
+            ok=False,
+            detail=f"{url} is unreachable: {error}. The issues tracker tools need it.",
+        )
+    if response.status_code >= 500:
+        return CheckResult(
+            name="issues_mcp",
+            ok=False,
+            detail=f"{url} returned {response.status_code}. The issues tracker tools need it.",
+        )
+    return CheckResult(name="issues_mcp", ok=True, detail=url)
+
+
 class SoftwareFactory(App):
     name = "software_factory"
     # These tables (projects, work_items, ...) are already unprefixed in core's
@@ -67,10 +105,18 @@ class SoftwareFactory(App):
     )
 
     class Settings(AppSettings):
-        tracker: Literal["none", "linear", "jira"] = Field(
+        tracker: Literal["none", "linear", "jira", "issues"] = Field(
             default="linear",
             title="Tracker",
             description="Which ticket tracker this installation uses.",
+            json_schema_extra={
+                "choice_details": {
+                    "issues": {
+                        "label": "druks",
+                        "help": "Druks is this appliance — no credentials.",
+                    },
+                },
+            },
         )
         # The tracker status names that drive build's funnel. They're operator
         # knobs — the names an operator's Linear/Jira workflow actually uses — so
@@ -111,19 +157,24 @@ def trigger_status(self) -> str:
                 return self.linear_trigger_status
             if self.tracker == "jira":
                 return self.jira_trigger_status
+            if self.tracker == "issues":
+                return IssuesStatus.READY_FOR_AGENT.label
             return ""
 
-    checks = [check_tracker_identity, check_review_identity]
+    checks = [check_tracker_identity, check_review_identity, check_issues_mcp]
 
     @classmethod
     async def get_tracker(cls, source: str | None = None) -> Tracker | None:
-        """The selected tracker, once its service identity is connected; None when
-        the installation runs trackerless or the identity is missing. Pass a
-        ``source`` to get it only when that source is the selected one — a
-        work item syncs only to the tracker that owns it."""
+        """The selected tracker. Linear and Jira need a connected service identity.
+        The local issues board does not. None when the installation runs
+        trackerless or the identity is missing. Pass a ``source`` to get it only
+        when that source is the selected one — a work item syncs only to the
+        tracker that owns it."""
         settings = await cls.settings()
         if source and source != settings.tracker:
             return
+        if settings.tracker == "issues":
+            return IssuesTracker()
         try:
             if settings.tracker == "linear":
                 row = await services.Linear.get()

backend/druks/contrib/software_factory/constants.py

@@ -4,3 +4,6 @@
 # act as (druks.contrib.software_factory.github).
 GITHUB_MCP_NAME = "github"
 GITHUB_MCP_URL = "https://api.githubcopilot.com/mcp/"
+# The appliance /mcp, required when the tracker is issues. Same doors the
+# dashboard uses; the sandbox reaches them here, not through Linear.
+APPLIANCE_MCP_NAME = "druks"

backend/druks/contrib/software_factory/exceptions.py

@@ -1,6 +1,43 @@
 from druks.api.exceptions import AgentApiError
 
 
+class ProjectNotFound(Exception):
+    def __init__(self, project_id: int) -> None:
+        super().__init__(f"project {project_id} does not exist")
+
+
+class RepoNotFound(Exception):
+    def __init__(self, repo_id: int) -> None:
+        super().__init__(f"repo {repo_id} does not exist")
+
+
+class InvalidPrefix(Exception):
+    def __init__(self, prefix: str) -> None:
+        super().__init__(
+            f"project prefix {prefix!r} must be 2-6 letters A-Z, or two letters and a digit 1-9"
+        )
+
+
+class MissingPrefix(Exception):
+    def __init__(self, name: str) -> None:
+        super().__init__(
+            f"project {name!r} has no ticket prefix — set one before minting identifiers"
+        )
+
+
+class PrefixLocked(Exception):
+    def __init__(self, prefix: str) -> None:
+        super().__init__(
+            f"project prefix {prefix!r} has already minted tickets — the identifier "
+            "namespace is fixed once a number has been handed out"
+        )
+
+
+class PrefixTaken(Exception):
+    def __init__(self, prefix: str) -> None:
+        super().__init__(f"project prefix {prefix!r} is already in use. Pick a different one.")
+
+
 class TicketNotFound(AgentApiError):
     status_code = 404
     code = "TICKET_NOT_FOUND"

backend/druks/contrib/software_factory/issues/enums.py

@@ -0,0 +1,51 @@
+from enum import StrEnum
+
+
+class Status(StrEnum):
+    """The board's workflow, closed on purpose: the enum *is* the workflow, so a
+    column can never hold a status no screen knows how to render."""
+
+    BACKLOG = "backlog"
+    READY_FOR_AGENT = "ready_for_agent"
+    IN_PROGRESS = "in_progress"
+    BLOCKED = "blocked"
+    IN_REVIEW = "in_review"
+    DONE = "done"
+
+    @property
+    def label(self) -> str:
+        """What a column header or a chip spells this status as."""
+        return STATUS_LABELS[self]
+
+    @property
+    def completed(self) -> bool:
+        """The work got done. Funnel readers count this, not the display label."""
+        return self is Status.DONE
+
+    @property
+    def terminal(self) -> bool:
+        """Nothing moves out of here on its own. Terminal-ness lives on the
+        enum, not on the display label: a board that renames a column has not
+        changed its workflow, and every reader of ``ticket.transitioned`` reads
+        this rather than guessing from a string."""
+        return self is Status.DONE
+
+
+# Pinned display labels — the stored value stays snake_case forever; only these
+# strings change when the board wants different words.
+STATUS_LABELS: dict[Status, str] = {
+    Status.BACKLOG: "Backlog",
+    Status.READY_FOR_AGENT: "Ready for Agent",
+    Status.IN_PROGRESS: "In Progress",
+    Status.BLOCKED: "Blocked",
+    Status.IN_REVIEW: "In Review",
+    Status.DONE: "Done",
+}
+
+
+class Priority(StrEnum):
+    NONE = "none"
+    URGENT = "urgent"
+    HIGH = "high"
+    MEDIUM = "medium"
+    LOW = "low"