Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

fix(server): normalize repository sort timestamps (#1058)

Sanjay Santhanam0e87dd90b067
diff --git a/packages/server/src/repowise/server/routers/_sorting.py b/packages/server/src/repowise/server/routers/_sorting.py
new file mode 100644
index 000000000..1936cc63e
--- /dev/null
+++ b/packages/server/src/repowise/server/routers/_sorting.py
@@ -0,0 +1,19 @@
+"""Sorting helpers for repository API responses."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+from typing import Protocol
+
+
+class _RepositoryTimestamps(Protocol):
+ updated_at: datetime | None
+ created_at: datetime | None
+
+
+def repository_sort_key(repo: _RepositoryTimestamps) -> datetime:
+ """Return a UTC-aware timestamp for repositories merged across databases."""
+ timestamp = repo.updated_at or repo.created_at
+ if timestamp is None:
+ return datetime.min.replace(tzinfo=UTC)
+ return timestamp if timestamp.tzinfo is not None else timestamp.replace(tzinfo=UTC)
diff --git a/packages/server/src/repowise/server/routers/repos.py b/packages/server/src/repowise/server/routers/repos.py
index 0355e35eb..79c1b9a89 100644
--- a/packages/server/src/repowise/server/routers/repos.py
+++ b/packages/server/src/repowise/server/routers/repos.py
@@ -27,6 +27,7 @@ from repowise.core.persistence.models import (
)
from repowise.server.deps import get_db_session, get_fts, verify_api_key
from repowise.server.job_executor import execute_job
+from repowise.server.routers._sorting import repository_sort_key
from repowise.server.schemas import RepoCreate, RepoResponse, RepoStatsResponse, RepoUpdate
logger = logging.getLogger(__name__)
@@ -176,8 +177,10 @@ async def list_repos(
except Exception:
pass
- # Sort indexed repos by updated_at descending
- repos.sort(key=lambda r: r.updated_at or r.created_at, reverse=True)
+ # Repository rows are merged across database backends in workspace mode.
+ # Normalize their timestamps before sorting because PostgreSQL returns aware
+ # datetimes while SQLite may return naive UTC values.
+ repos.sort(key=repository_sort_key, reverse=True)
responses = [RepoResponse.from_orm(r) for r in repos]
# Self-heal the freshness stamp on read: prefer each repo's state.json
diff --git a/tests/unit/test_repository_sorting.py b/tests/unit/test_repository_sorting.py
new file mode 100644
index 000000000..ad8a5c173
--- /dev/null
+++ b/tests/unit/test_repository_sorting.py
@@ -0,0 +1,20 @@
+"""Tests for repository API sorting helpers."""
+
+from datetime import UTC, datetime
+from types import SimpleNamespace
+
+from repowise.server.routers._sorting import repository_sort_key
+
+
+def test_repository_sort_key_handles_mixed_tz_awareness() -> None:
+ """Workspace databases can return a mix of naive and aware timestamps."""
+ aware = SimpleNamespace(
+ updated_at=datetime(2026, 7, 24, 9, 0, tzinfo=UTC),
+ created_at=None,
+ )
+ naive = SimpleNamespace(
+ updated_at=datetime(2026, 7, 24, 8, 0),
+ created_at=None,
+ )
+
+ assert sorted([naive, aware], key=repository_sort_key, reverse=True) == [aware, naive]