cctally 1.73.0 → 1.74.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.74.0] - 2026-07-19
+
+### Fixed
+- Dashboard Daily, Weekly, and Monthly details now use the same bounded history density across Claude, Codex, and All sources—30 days, 12 weeks, and 8 months—with compact date labels and contained mobile tables; Codex Blocks remains explicitly unavailable when native 5-hour activity does not exist. (#319)
+- Dashboard Trend, Projects, Cache Report, Forecast, and Alerts details now keep their canonical composed structure for Codex and All sources, show provider-native values or explicit unavailable reasons in every slot, and route provider-qualified project rows through the source-bound detail foundation. (#319)
+- Dashboard source-qualified Session and Project details now preserve Codex accounting totals when project metadata is incomplete; the combined source retains server-issued Claude Block identities and opens the canonical Block modal; source details share the standard focus, Escape, return-focus, and scroll-lock lifecycle; and desktop Share previews retain the captured provider. (#319)
+- Codex accounting no longer double-counts parent token events copied into a forked/subagent rollout before its first model context. Those records remain available to the physical conversation reader but are excluded from accounting; cache migration 027 safely replays retained Codex rollouts to remove existing `unknown` duplicates. Consequently, `cctally pricing-check` and `doctor` no longer report those ingest artifacts as a missing embedded price, while real unknown model IDs remain actionable. The complete scoped OpenAI model set and tracked rates were reverified against the live pricing sources, and the embedded pricing snapshot date is now 2026-07-19.
+- Dashboard Codex Weekly rows now follow observed native seven-day quota-cycle re-anchors instead of calendar weeks, collapsing reset jitter and clipping an older cycle when OpenAI grants an early reset. Codex quota forecasts now use elapsed native-cycle pace rather than activity-only bursts, avoiding misleading projections pinned at 100%. (#312)
+- Dashboard Codex source reads now retain accounting, quota, budget, session, and forensics panels when retained historical rows still lack project attribution. The cache replay path repairs this metadata when possible; until then the source is fresh-but-partial and disables Projects only, with a rebuild remedy. (#312)
+- Dashboard Codex hero cost and token counters now cover the active native seven-day reset cycle, rather than an unrelated calendar slice. A missing or conflicting active seven-day boundary leaves quota and budget visible while clearly marking the hero unavailable; Codex panels regain bounded native chrome and source warnings degrade only the affected domain. (#312)
+
 ## [1.73.0] - 2026-07-18
 
 ### Added

package/bin/_cctally_cache.py

@@ -813,8 +813,30 @@ def _delete_codex_file_derived_rows(
     )
 
 
-def _clear_codex_derived_rows(conn: sqlite3.Connection) -> None:
-    """Clear every re-derivable Codex row family in child-before-root order."""
+def _clear_codex_derived_rows(conn: sqlite3.Connection) -> bool:
+    """Clear every re-derivable Codex row family and report whether state changed.
+
+    The FTS5 ``delete-all`` command can increment SQLite's cumulative change
+    counter even when the semantic Codex surface was already empty.  Callers
+    use this return value, rather than ``Connection.total_changes``, when
+    deciding whether to advance the physical-mutation sequence.
+    """
+    state_changed = any(
+        conn.execute(query).fetchone() is not None
+        for query in (
+            "SELECT 1 FROM codex_session_entries LIMIT 1",
+            "SELECT 1 FROM quota_window_snapshots WHERE source = 'codex' LIMIT 1",
+            "SELECT 1 FROM codex_conversation_threads LIMIT 1",
+            "SELECT 1 FROM codex_conversation_events LIMIT 1",
+            "SELECT 1 FROM codex_session_files LIMIT 1",
+            "SELECT 1 FROM codex_source_roots LIMIT 1",
+            "SELECT 1 FROM codex_conversation_messages LIMIT 1",
+            "SELECT 1 FROM codex_conversation_file_touches LIMIT 1",
+            "SELECT 1 FROM codex_conversation_rollups LIMIT 1",
+            "SELECT 1 FROM cache_meta "
+            "WHERE key='codex_quota_projection_certificate' LIMIT 1",
+        )
+    )
     conn.execute("DELETE FROM codex_session_entries")
     conn.execute("DELETE FROM quota_window_snapshots WHERE source = 'codex'")
     conn.execute("DELETE FROM codex_conversation_threads")
@@ -832,6 +854,7 @@ def _clear_codex_derived_rows(conn: sqlite3.Connection) -> None:
     conn.execute(
         "DELETE FROM cache_meta WHERE key='codex_quota_projection_certificate'"
     )
+    return state_changed
 
 
 def _bump_codex_physical_mutation_seq(conn: sqlite3.Connection) -> None:
@@ -3903,9 +3926,7 @@ def sync_codex_cache(
             # Clear INSIDE the lock — see sync_cache() for the full
             # rationale. Done before the existing SELECT so delta
             # detection sees an empty baseline.
-            before_clear = conn.total_changes
-            _clear_codex_derived_rows(conn)
-            if conn.total_changes != before_clear:
+            if _clear_codex_derived_rows(conn):
                 _bump_codex_physical_mutation_seq(conn)
             conn.commit()
             eprint("[cache-sync] rebuild: cleared Codex cached entries")

package/bin/_cctally_dashboard.py

@@ -763,6 +763,35 @@ def _build_codex_source_detail(snapshot, *, resource: str, key: str) -> dict[str
     raise SourceResourceNotFound()
 
 
+def _codex_partial_source_detail(snapshot, row: Mapping, *, resource: str,
+                                 key: str) -> dict[str, Any]:
+    """Keep a published cache-only row usable when project metadata is partial."""
+    detail = _source_safe_native_detail(
+        row, source="codex", resource=resource, key=key,
+    )
+    detail.update({
+        "metadata_availability": "partial",
+        "metadata_reason": (
+            "Codex project metadata is incomplete; available accounting totals "
+            "are preserved."
+        ),
+    })
+    if resource == "session":
+        detail.setdefault("models", [])
+        detail["model_breakdowns"] = []
+    elif resource == "project":
+        generated_at = getattr(snapshot, "generated_at", None)
+        detail.setdefault("range_start", detail.get("first_seen"))
+        detail.setdefault(
+            "range_end",
+            generated_at.astimezone(dt.timezone.utc).isoformat()
+            if isinstance(generated_at, dt.datetime) else detail.get("last_seen"),
+        )
+        detail["models"] = []
+        detail["sessions"] = []
+    return detail
+
+
 def _source_safe_claude_session_detail(detail, *, key: str) -> dict[str, Any]:
     """Adapt the existing Claude session detail builder to S4's safe route."""
     payload = _session_detail_to_envelope(detail)
@@ -958,7 +987,12 @@ def build_source_detail(*, snapshot, source: str, resource: str,
     row = source_detail_lookup(snapshot.source_bundle, source, resource, key)
     if source == "claude":
         return _build_claude_source_detail(snapshot, resource=resource, key=key)
-    return _build_codex_source_detail(snapshot, resource=resource, key=key)
+    try:
+        return _build_codex_source_detail(snapshot, resource=resource, key=key)
+    except sys.modules["_cctally_source_analytics"].QualifiedMetadataUnavailable:
+        return _codex_partial_source_detail(
+            snapshot, row, resource=resource, key=key,
+        )
 
 _ensure_sibling_loaded("_cctally_dashboard_share")
 from _cctally_dashboard_share import (

package/bin/_cctally_dashboard_share.py

@@ -1404,6 +1404,8 @@ def _build_codex_source_share_snapshot(ls, *, state, panel: str,
         raise ValueError("source capability unavailable")
     required_domain = {
         "current-week": "hero",
+        "trend": "periods",
+        "forecast": "quota",
         "daily": "periods",
         "monthly": "periods",
         "weekly": "periods",
@@ -1425,14 +1427,47 @@ def _build_codex_source_share_snapshot(ls, *, state, panel: str,
         source_rows = all_rows[-1:] if all_rows else ()
         command = "codex-weekly"
         display_tz = str(weekly.get("display_tz") or "UTC")
-    elif panel in ("daily", "monthly", "weekly"):
+    elif panel in ("daily", "monthly", "weekly", "trend"):
         periods = data.get("periods")
-        panel_data = periods.get(panel) if isinstance(periods, Mapping) else {}
+        period_key = "weekly" if panel == "trend" else panel
+        panel_data = periods.get(period_key) if isinstance(periods, Mapping) else {}
         if not isinstance(panel_data, Mapping):
             raise ValueError("source capability unavailable")
         source_rows = tuple(panel_data.get("rows", ()))
-        command = f"codex-{panel}"
+        command = f"codex-{period_key}"
         display_tz = str(panel_data.get("display_tz") or "UTC")
+    elif panel == "forecast":
+        quota = data.get("quota")
+        panel_data = quota if isinstance(quota, Mapping) else {}
+        source_rows = tuple(panel_data.get("histories", ())) if isinstance(panel_data, Mapping) else ()
+        start, end = _share_codex_period_bounds(
+            state=state, panel="weekly", options=options, rows=source_rows,
+        )
+        rows = []
+        for row in source_rows:
+            if not isinstance(row, Mapping):
+                continue
+            forecast = row.get("forecast") if isinstance(row.get("forecast"), Mapping) else {}
+            current = row.get("current_percent")
+            projected = forecast.get("projected_percent")
+            rows.append(ls.Row(cells={
+                "limit": ls.TextCell(str(row.get("label") or "Codex quota")),
+                "current": ls.TextCell("—" if current is None else f"{float(current):.1f}%"),
+                "projected": ls.TextCell("—" if projected is None else f"{float(projected):.1f}%"),
+            }))
+        return ls.ShareSnapshot(
+            cmd="codex-quota", title="Codex Quota Forecast", subtitle=None,
+            period=ls.PeriodSpec(start=start, end=end, display_tz="UTC", label=None),
+            columns=(
+                ls.ColumnSpec(key="limit", label="Limit"),
+                ls.ColumnSpec(key="current", label="Current", align="right"),
+                ls.ColumnSpec(key="projected", label="Projected", align="right"),
+            ),
+            rows=tuple(rows), chart=None, totals=(), notes=(), generated_at=end,
+            version=sys.modules["cctally"]._share_resolve_version(),
+            template_id=template_id, source="codex", source_label="Codex",
+            availability=availability, availability_reason=reason,
+        )
     elif panel == "sessions":
         panel_data = data.get(panel) if isinstance(data.get(panel), Mapping) else {}
         source_rows = tuple(panel_data.get("rows", ())) if isinstance(panel_data, Mapping) else ()