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: normalize decision staleness timestamps (#877)

Polly Labsdbc3609c4ff4
diff --git a/packages/core/src/repowise/core/analysis/decisions/extractor.py b/packages/core/src/repowise/core/analysis/decisions/extractor.py
index 6e7e1f072..8e61218a6 100644
--- a/packages/core/src/repowise/core/analysis/decisions/extractor.py
+++ b/packages/core/src/repowise/core/analysis/decisions/extractor.py
@@ -71,6 +71,18 @@ def _truncate_title(text: str, limit: int) -> str:
return window[:cut].rstrip() + "…"
+def _as_aware_utc(value: datetime) -> datetime:
+ """Return ``value`` as a timezone-aware UTC datetime.
+
+ SQLite drops timezone information from ``DateTime(timezone=True)`` columns,
+ but Repowise writes those values as UTC. Treat naive values as UTC so they
+ can be compared with git metadata timestamps, which are already aware UTC.
+ """
+ if value.tzinfo is None or value.utcoffset() is None:
+ return value.replace(tzinfo=UTC)
+ return value.astimezone(UTC)
+
+
# ---------------------------------------------------------------------------
# Data models
# ---------------------------------------------------------------------------
@@ -1341,9 +1353,11 @@ class DecisionExtractor:
if last_commit and decision_created_at:
if isinstance(last_commit, str):
last_commit = datetime.fromisoformat(last_commit.replace("Z", "+00:00"))
+ last_commit = _as_aware_utc(last_commit)
_created = decision_created_at
if isinstance(_created, str):
_created = datetime.fromisoformat(_created.replace("Z", "+00:00"))
+ _created = _as_aware_utc(_created)
if last_commit > _created:
age_days = (now - _created).days
commit_count = meta.get("commit_count_90d", 0)
diff --git a/tests/unit/analysis/test_decision_staleness.py b/tests/unit/analysis/test_decision_staleness.py
new file mode 100644
index 000000000..b47c71fe5
--- /dev/null
+++ b/tests/unit/analysis/test_decision_staleness.py
@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from datetime import UTC, datetime, timedelta
+
+from repowise.core.analysis.decision_extractor import DecisionExtractor
+
+
+def test_compute_staleness_accepts_sqlite_naive_created_at() -> None:
+ created_at = datetime.now(UTC).replace(tzinfo=None) - timedelta(days=30)
+ last_commit_at = datetime.now(UTC) - timedelta(days=1)
+
+ score = DecisionExtractor.compute_staleness(
+ decision_created_at=created_at,
+ affected_files=["src/app.py"],
+ git_meta_map={
+ "src/app.py": {
+ "last_commit_at": last_commit_at,
+ "commit_count_90d": 6,
+ }
+ },
+ )
+
+ assert score > 0