codex-usage-tracking 0.8.0__tar.gz → 0.8.1__tar.gz

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-usage-tracker",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Unofficial local tracker for aggregate Codex token usage from local session logs.",
   "author": {
     "name": "Douglas Monsky"

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.8.1 - 2026-06-20
+
+- Make Diagnostics fact tables easier to scan by widening and pinning the Fact column while horizontally scrolling.
+- Add API-backed sortable headers to top-level Diagnostics fact tables, including cached input, output, cache ratio, largest call, latest call time, occurrence, call-count, and fact-name sorts.
+
 ## 0.8.0 - 2026-06-20
 
 - Add an aggregate Diagnostics dashboard for inspecting diagnostic facts, associated calls, token totals, and on-demand evidence without persisting raw transcript text.

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-usage-tracking
-Version: 0.8.0
+Version: 0.8.1
 Summary: Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns.
 Author: Douglas Monsky
 License-Expression: MIT

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/docs/development.md

@@ -38,7 +38,7 @@ fix/<issue-number>-short-description
 docs/<issue-number>-short-description
 chore/<issue-number>-short-description
 test/<issue-number>-short-description
-release/0.8.0
+release/0.8.1
 hotfix/0.3.3
 ```
 
@@ -91,7 +91,7 @@ blocked
 Recommended milestones:
 
 ```text
-0.8.0
+0.8.1
 1.0-readiness
 1.0.0
 ```
@@ -146,8 +146,8 @@ python scripts/smoke_installed_package.py --docker
 To verify the public PyPI package instead of the local checkout:
 
 ```bash
-python scripts/smoke_installed_package.py --from-pypi --version 0.8.0
-python scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.0
+python scripts/smoke_installed_package.py --from-pypi --version 0.8.1
+python scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.1
 ```
 
 `scripts/check_release.py` treats these public-package smoke commands as release-state claims. Keep their `--version` and `codex-usage-tracking==...` values aligned with `pyproject.toml`; the release gate fails when the docs claim a different public version. It also checks that install docs point at the real PyPI distribution, `codex-usage-tracking`, and keep the warning that `codex-usage-tracker` is a different PyPI package.
@@ -286,8 +286,8 @@ After the release branch merges, tag from updated `main`, not from an unreviewed
 ```bash
 git switch main
 git pull --ff-only
-git tag -a v0.8.0 -m "codex-usage-tracker 0.8.0"
-git push origin v0.8.0
+git tag -a v0.8.1 -m "codex-usage-tracker 0.8.1"
+git push origin v0.8.1
 ```
 
 Do not create or push release tags without maintainer approval.
@@ -296,7 +296,7 @@ Do not create or push release tags without maintainer approval.
 
 Publishing uses GitHub Actions Trusted Publishing through `.github/workflows/publish.yml`; do not upload from a local machine and do not add PyPI or TestPyPI API tokens.
 
-The first public package release, `0.3.0`, was published on June 8, 2026. Patch release `0.3.1` followed the same day to ship the live-dashboard skill launch fix. Patch release `0.3.2` made dashboard launch refresh the default and added runtime enablement for context loading. Minor release `0.4.0` added Python 3.14 support, release recovery docs, stricter privacy/support-bundle regression coverage, and large-history benchmark thresholds. Patch release `0.4.1` was published by workflow dispatch from `main`; it hardened the PyPI publish workflow and checked off completed 1.0 readiness gates. Minor release `0.5.0` added dashboard localization support and initial language catalogs. Minor release `0.6.0` is the performance and call-drilldown release with SQL-backed live API slices, materialized thread summaries, faster evidence loading, and dashboard runtime module refactors. Patch release `0.6.1` aligns the final README/package screenshots and companion plugin assets. Minor release `0.7.0` adds observed usage snapshots and the latest-observed dashboard card while keeping raw evidence on demand only. Minor release `0.8.0` adds aggregate diagnostics, source-offset context seeking, and live dashboard loading hardening.
+The first public package release, `0.3.0`, was published on June 8, 2026. Patch release `0.3.1` followed the same day to ship the live-dashboard skill launch fix. Patch release `0.3.2` made dashboard launch refresh the default and added runtime enablement for context loading. Minor release `0.4.0` added Python 3.14 support, release recovery docs, stricter privacy/support-bundle regression coverage, and large-history benchmark thresholds. Patch release `0.4.1` was published by workflow dispatch from `main`; it hardened the PyPI publish workflow and checked off completed 1.0 readiness gates. Minor release `0.5.0` added dashboard localization support and initial language catalogs. Minor release `0.6.0` is the performance and call-drilldown release with SQL-backed live API slices, materialized thread summaries, faster evidence loading, and dashboard runtime module refactors. Patch release `0.6.1` aligns the final README/package screenshots and companion plugin assets. Minor release `0.7.0` adds observed usage snapshots and the latest-observed dashboard card while keeping raw evidence on demand only. Minor release `0.8.0` adds aggregate diagnostics, source-offset context seeking, and live dashboard loading hardening. Patch release `0.8.1` improves Diagnostics fact table readability with pinned fact names and sortable fact columns.
 
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.3.0`
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.3.1`

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/docs/one-dot-oh-readiness.md

@@ -24,12 +24,12 @@ Not guaranteed:
 
 ## 1. Public Install And Package Metadata
 
-- [x] Verify the current public PyPI version is visible as `0.8.0`: `python -c "import json, urllib.request; print(json.load(urllib.request.urlopen('https://pypi.org/pypi/codex-usage-tracking/json'))['info']['version'])"`.
-- [x] Verify public venv install for `0.8.0`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.8.0 && codex-usage-tracker --version`.
-- [x] Verify public pipx install path for `0.8.0`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.8.0 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
+- [x] Verify the current public PyPI version is visible as `0.8.1`: `python -c "import json, urllib.request; print(json.load(urllib.request.urlopen('https://pypi.org/pypi/codex-usage-tracking/json'))['info']['version'])"`.
+- [x] Verify public venv install for `0.8.1`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.8.1 && codex-usage-tracker --version`.
+- [x] Verify public pipx install path for `0.8.1`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.8.1 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
 - [x] Verify installed package resources from a built wheel: `python scripts/smoke_installed_package.py`.
 - [x] Verify installed package resources in Linux Docker: `python scripts/smoke_installed_package.py --docker`.
-- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.0`.
+- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.1`.
 - [x] Verify PyPI metadata names remain unchanged: `python scripts/check_release.py`.
 - [x] Add Python 3.14 as an official support target after CI, package classifiers, docs, and installed-package smoke coverage were added. Docker smoke coverage uses `python:3.14-slim` by default. Track this in issue #12.
 
@@ -134,14 +134,14 @@ Not guaranteed:
 
 ## Evidence References
 
-These references are the concrete proof behind completed checklist items. Public package smoke commands are version-specific to `0.8.0`; all repo tests use synthetic or aggregate-only data.
+These references are the concrete proof behind completed checklist items. Public package smoke commands are version-specific to `0.8.1`; all repo tests use synthetic or aggregate-only data.
 
 ### Public Install And Package Metadata
 
 - Public PyPI version, public venv install, and public pipx install are proven by the exact public-install commands in section 1.
 - Built-wheel and installed-resource coverage is proven by `scripts/smoke_installed_package.py` and `tests/test_cli_release.py::test_installed_package_smoke_checks_help_for_stable_commands`.
 - Linux package-resource coverage is proven by `scripts/smoke_installed_package.py --docker`.
-- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.0`.
+- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.8.1`.
 - PyPI metadata, package/distribution names, package resources, source/wheel member names, Python 3.10-3.14 support metadata, CI workflow requirements, publish workflow safety text, and tracked secret patterns are proven by `scripts/check_release.py`, `scripts/check_release.py --dist`, and `tests/test_cli_release.py::test_release_check_script_passes`.
 
 ### Upgrade And Migration
@@ -219,8 +219,8 @@ These references are the concrete proof behind completed checklist items. Public
 - Publish workflow package name, Trusted Publishing, TestPyPI/PyPI job presence, event guards, no push/PR publishing, no token/password publishing, and manual PyPI main/tag preflight are proven by `scripts/check_release.py::_check_publish_workflow`.
 - The GitHub `pypi` environment gate is proven by `gh api repos/douglasmonsky/codex-usage-tracker/environments/pypi`, which reports a `required_reviewers` protection rule and `can_admins_bypass=false`.
 - Dist filename and wheel/sdist member checks are proven by `python -m build`, `python -m twine check dist/*`, and `python scripts/check_release.py --dist`.
-- TestPyPI publish process is proven by a workflow-dispatch run on `main`, followed by TestPyPI metadata and clean virtualenv install checks for `codex-usage-tracking==0.8.0`.
-- PyPI publish process is proven by a workflow-dispatch run on `main`, protected `pypi` environment approval, PyPI metadata visibility, clean virtualenv install, temporary pipx install, and Docker public-package smoke for `codex-usage-tracking==0.8.0`.
+- TestPyPI publish process is proven by a workflow-dispatch run on `main`, followed by TestPyPI metadata and clean virtualenv install checks for `codex-usage-tracking==0.8.1`.
+- PyPI publish process is proven by a workflow-dispatch run on `main`, protected `pypi` environment approval, PyPI metadata visibility, clean virtualenv install, temporary pipx install, and Docker public-package smoke for `codex-usage-tracking==0.8.1`.
 - Release recovery documentation is proven by `scripts/check_release.py` required-file and docs checks.
 
 ### Known Limitations

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-usage-tracking"
-version = "0.8.0"
+version = "0.8.1"
 description = "Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns."
 readme = "README.md"
 requires-python = ">=3.10"

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/skills/codex-usage-tracker/scripts/run_mcp.py

@@ -15,9 +15,9 @@ from pathlib import Path
 
 PACKAGE_SPEC = os.environ.get(
     "CODEX_USAGE_TRACKER_PACKAGE_SPEC",
-    "codex-usage-tracking==0.8.0",
+    "codex-usage-tracking==0.8.1",
 )
-RUNTIME_VERSION = "0.8.0"
+RUNTIME_VERSION = "0.8.1"
 PACKAGE_SPEC_MARKER = ".codex-usage-tracker-package-spec"
 MODULE_CHECK = (
     "import importlib.metadata; "

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracker/__init__.py

@@ -2,6 +2,6 @@
 
 from codex_usage_tracker.models import UsageEvent
 
-__version__ = "0.8.0"
+__version__ = "0.8.1"
 
 __all__ = ["UsageEvent", "__version__"]

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracker/diagnostic_reports.py

@@ -22,6 +22,10 @@ DIAGNOSTICS_NOTES = [
 DIAGNOSTIC_FACT_SORT_CHOICES = (
     "uncached",
     "tokens",
+    "cached",
+    "output",
+    "cache",
+    "largest",
     "calls",
     "occurrences",
     "time",

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracker/plugin_data/dashboard/dashboard_diagnostics.js

@@ -34,6 +34,7 @@
     const factCallPageSize = 25;
     const factCallPayloads = new Map();
     const factCallSorts = new Map();
+    const factSorts = new Map();
 
     function setActive(active) {
       diagnosticsPanelEl.hidden = !active;
@@ -52,6 +53,7 @@
       payloads = emptyPayloads();
       factCallPayloads.clear();
       factCallSorts.clear();
+      factSorts.clear();
     }
 
     function renderDiagnostics(dateRange) {
@@ -86,10 +88,13 @@
       const generation = requestGeneration + 1;
       requestGeneration = generation;
       try {
+        const factsSort = factSortState('facts');
+        const toolsSort = factSortState('tools');
+        const compactionsSort = factSortState('compactions');
         const [facts, tools, compactions] = await Promise.all([
-          fetchPayload('/api/diagnostics/facts', { ...filters, limit: '50', sort: 'uncached', direction: 'desc' }),
-          fetchPayload('/api/diagnostics/tools', { ...filters, limit: '25', sort: 'uncached', direction: 'desc' }),
-          fetchPayload('/api/diagnostics/compactions', { ...filters, limit: '25', sort: 'uncached', direction: 'desc' }),
+          fetchPayload('/api/diagnostics/facts', { ...filters, limit: '50', sort: factsSort.sort, direction: factsSort.direction }),
+          fetchPayload('/api/diagnostics/tools', { ...filters, limit: '25', sort: toolsSort.sort, direction: toolsSort.direction }),
+          fetchPayload('/api/diagnostics/compactions', { ...filters, limit: '25', sort: compactionsSort.sort, direction: compactionsSort.direction }),
         ]);
         if (generation !== requestGeneration || signature !== activeSignature) return;
         payloads = { facts, tools, compactions };
@@ -164,6 +169,20 @@
       renderIfActive();
     }
 
+    function sortFactRows(sectionKey, sortKey) {
+      if (!diagnosticFactSortLabels()[sortKey]) return;
+      const current = factSortState(sectionKey);
+      const next = current.sort === sortKey
+        ? { sort: sortKey, direction: current.direction === 'asc' ? 'desc' : 'asc' }
+        : { sort: sortKey, direction: defaultFactSortDirection(sortKey) };
+      factSorts.set(sectionKey, next);
+      status = 'loading';
+      errorMessage = '';
+      const filters = getDiagnosticFilters();
+      void fetchDiagnostics(activeSignature, filters);
+      renderIfActive();
+    }
+
     function sortFactCalls(sortKey) {
       if (!selectedFactKey || !diagnosticCallSortLabels()[sortKey]) return;
       const current = factCallSortState(selectedFactKey);
@@ -206,30 +225,30 @@
             ${readoutMetric('Compaction rows', payloads.compactions)}
             <span class="diagnostics-note">Structured labels only. Raw context remains on-demand in the call investigator.</span>
           </div>
-          ${renderFactSection('Top Diagnostic Facts', 'Ranked by associated uncached input tokens.', payloads.facts, loading)}
-          ${renderFactSection('Tool and Function Activity', 'Tool/function facts associated with model calls.', payloads.tools, loading)}
-          ${renderFactSection('Compaction Activity', 'Compaction facts and post-compaction associated costs.', payloads.compactions, loading)}
+          ${renderFactSection('facts', 'Top Diagnostic Facts', 'Structured facts associated with model calls.', payloads.facts, loading)}
+          ${renderFactSection('tools', 'Tool and Function Activity', 'Tool/function facts associated with model calls.', payloads.tools, loading)}
+          ${renderFactSection('compactions', 'Compaction Activity', 'Compaction facts and post-compaction associated costs.', payloads.compactions, loading)}
         </div>
       `;
     }
 
-    function renderFactSection(title, caption, payload, loading) {
+    function renderFactSection(sectionKey, title, caption, payload, loading) {
       const rows = Array.isArray(payload?.rows) ? payload.rows : [];
       return `
         <div class="diagnostics-section">
           <div class="diagnostics-section-header">
             <div>
               <h3>${escapeHtml(title)}</h3>
-              <p>${escapeHtml(caption)}</p>
+              <p>${escapeHtml(`${caption} Sorted by ${diagnosticFactSortDescription(sectionKey)}.`)}</p>
             </div>
             <span>${escapeHtml(payload ? `${number.format(payload.total_matched_rows || rows.length)} matched` : loading ? 'Loading' : 'No payload')}</span>
           </div>
-          ${renderFactTable(rows, loading)}
+          ${renderFactTable(sectionKey, rows, loading)}
         </div>
       `;
     }
 
-    function renderFactTable(rows, loading) {
+    function renderFactTable(sectionKey, rows, loading) {
       if (loading && !rows.length) return renderState('Loading diagnostics...');
       if (!rows.length) return renderState('No diagnostic facts matched the current filters.');
       const body = rows.map(row => {
@@ -240,7 +259,7 @@
           : tokenText(row.largest_call_tokens);
         return `
           <tr class="${selected ? 'selected-row' : ''}">
-            <td>
+            <td class="diagnostics-fact-cell">
               <div class="diagnostic-fact">
                 <strong>${escapeHtml(row.fact_type || 'unknown')}/${escapeHtml(row.fact_name || 'unknown')}</strong>
                 <span>${escapeHtml(row.fact_category || 'uncategorized')}</span>
@@ -266,18 +285,31 @@
       }).join('');
       return `
         <div class="diagnostics-table-wrap">
-          <table class="diagnostics-table">
+          <table class="diagnostics-table diagnostics-facts-table">
+            <colgroup>
+              <col class="diagnostics-fact-col">
+              <col class="diagnostics-count-col">
+              <col class="diagnostics-count-col">
+              <col class="diagnostics-token-col">
+              <col class="diagnostics-token-col">
+              <col class="diagnostics-token-col">
+              <col class="diagnostics-token-col">
+              <col class="diagnostics-ratio-col">
+              <col class="diagnostics-token-col">
+              <col class="diagnostics-latest-col">
+              <col class="diagnostics-action-col">
+            </colgroup>
             <thead><tr>
-              ${columnHeader('Fact', 'Diagnostic fact type and name derived from structured local log metadata. Raw prompts, assistant text, and tool output are not persisted.')}
-              ${columnHeader('Occ', 'Occurrences: count of matching diagnostic fact events. One model call can contribute more than one occurrence.', 'num')}
-              ${columnHeader('Calls', 'Distinct model calls associated with this diagnostic fact.', 'num')}
-              ${columnHeader('Assoc total', 'Associated total tokens for those calls. Totals are not additive across facts because one call can have multiple facts.', 'num')}
-              ${columnHeader('Cached', 'Associated cached input tokens for those calls.', 'num')}
-              ${columnHeader('Uncached', 'Associated uncached input tokens for those calls.', 'num')}
-              ${columnHeader('Output', 'Associated output tokens for those calls.', 'num')}
-              ${columnHeader('Cache %', 'Average cache ratio across associated calls.', 'num')}
-              ${columnHeader('Largest', 'Largest associated call by total tokens.', 'num')}
-              ${columnHeader('Latest', 'Latest associated call timestamp.')}
+              ${diagnosticFactHeader(sectionKey, 'fact', 'Fact', false, 'Diagnostic fact type and name derived from structured local log metadata. Raw prompts, assistant text, and tool output are not persisted.')}
+              ${diagnosticFactHeader(sectionKey, 'occurrences', 'Occ', true, 'Occurrences: count of matching diagnostic fact events. One model call can contribute more than one occurrence.')}
+              ${diagnosticFactHeader(sectionKey, 'calls', 'Calls', true, 'Distinct model calls associated with this diagnostic fact.')}
+              ${diagnosticFactHeader(sectionKey, 'tokens', 'Assoc total', true, 'Associated total tokens for those calls. Totals are not additive across facts because one call can have multiple facts.')}
+              ${diagnosticFactHeader(sectionKey, 'cached', 'Cached', true, 'Associated cached input tokens for those calls.')}
+              ${diagnosticFactHeader(sectionKey, 'uncached', 'Uncached', true, 'Associated uncached input tokens for those calls.')}
+              ${diagnosticFactHeader(sectionKey, 'output', 'Output', true, 'Associated output tokens for those calls.')}
+              ${diagnosticFactHeader(sectionKey, 'cache', 'Cache %', true, 'Average cache ratio across associated calls.')}
+              ${diagnosticFactHeader(sectionKey, 'largest', 'Largest', true, 'Largest associated call by total tokens.')}
+              ${diagnosticFactHeader(sectionKey, 'time', 'Latest', false, 'Latest associated call timestamp.')}
               ${columnHeader('Action', 'Expand or collapse the associated calls.')}
             </tr></thead>
             <tbody>${body}</tbody>
@@ -380,6 +412,22 @@
       return `<th${classAttr}${tooltipAttr ? ` ${tooltipAttr}` : ''}>${escapeHtml(label)}</th>`;
     }
 
+    function diagnosticFactHeader(sectionKey, sortKey, label, numeric = false, tooltip = '') {
+      const state = factSortState(sectionKey);
+      const active = state.sort === sortKey;
+      const indicator = active ? (state.direction === 'asc' ? '▲' : '▼') : '';
+      const ariaSort = active ? (state.direction === 'asc' ? 'ascending' : 'descending') : 'none';
+      const tooltipAttr = tooltipAttributes(tooltip);
+      return `
+        <th${numeric ? ' class="num"' : ''} data-diagnostics-fact-sort-active="${active ? 'true' : 'false'}" aria-sort="${ariaSort}"${tooltipAttr ? ` ${tooltipAttr}` : ''}>
+          <button class="sort-header child-sort-header" type="button" data-diagnostics-fact-section="${escapeHtml(sectionKey)}" data-diagnostics-fact-sort-key="${escapeHtml(sortKey)}">
+            <span>${escapeHtml(label)}</span>
+            <span class="sort-indicator">${escapeHtml(indicator)}</span>
+          </button>
+        </th>
+      `;
+    }
+
     function diagnosticCallHeader(sortKey, label, numeric = false, tooltip = '') {
       const state = factCallSortState(selectedFactKey);
       const active = state.sort === sortKey;
@@ -396,6 +444,28 @@
       `;
     }
 
+    function diagnosticFactSortDescription(sectionKey) {
+      const state = factSortState(sectionKey);
+      const labels = diagnosticFactSortLabels();
+      const label = labels[state.sort] || state.sort;
+      return `${label} ${state.direction === 'asc' ? 'ascending' : 'descending'}`;
+    }
+
+    function diagnosticFactSortLabels() {
+      return {
+        cache: 'cache ratio',
+        cached: 'cached input tokens',
+        calls: 'associated calls',
+        fact: 'fact name',
+        largest: 'largest call',
+        occurrences: 'occurrences',
+        output: 'output tokens',
+        time: 'latest call time',
+        tokens: 'total tokens',
+        uncached: 'uncached input tokens',
+      };
+    }
+
     function diagnosticCallSortDescription() {
       const state = factCallSortState(selectedFactKey);
       const labels = diagnosticCallSortLabels();
@@ -419,6 +489,14 @@
       };
     }
 
+    function factSortState(sectionKey) {
+      return factSorts.get(sectionKey) || { sort: 'uncached', direction: 'desc' };
+    }
+
+    function defaultFactSortDirection(sortKey) {
+      return sortKey === 'fact' ? 'asc' : 'desc';
+    }
+
     function factCallSortState(key) {
       return factCallSorts.get(key) || { sort: 'tokens', direction: 'desc' };
     }
@@ -483,10 +561,25 @@
       };
     }
 
+    function captureScrollPosition() {
+      pendingScrollAnchor = {
+        key: '',
+        type: 'scroll',
+        top: 0,
+        scrollY: window.scrollY,
+      };
+    }
+
     function restoreScrollAnchor() {
       if (!pendingScrollAnchor) return;
       const anchor = pendingScrollAnchor;
       pendingScrollAnchor = null;
+      if (anchor.type === 'scroll') {
+        window.requestAnimationFrame(() => {
+          window.scrollTo({ top: anchor.scrollY, behavior: 'auto' });
+        });
+        return;
+      }
       window.requestAnimationFrame(() => {
         const target = anchor.type === 'load-more'
           ? diagnosticsPanelEl.querySelector('[data-diagnostics-call-load-more]')
@@ -539,6 +632,17 @@
         void fetchFactCalls(factType, factName, { append: true });
         return;
       }
+      const factSortButton = target.closest('[data-diagnostics-fact-sort-key]');
+      if (factSortButton && diagnosticsPanelEl.contains(factSortButton)) {
+        event.preventDefault();
+        event.stopPropagation();
+        captureScrollPosition();
+        sortFactRows(
+          factSortButton.dataset.diagnosticsFactSection || 'facts',
+          factSortButton.dataset.diagnosticsFactSortKey || '',
+        );
+        return;
+      }
       const sortButton = target.closest('[data-diagnostics-call-sort-key]');
       if (sortButton && diagnosticsPanelEl.contains(sortButton)) {
         event.preventDefault();

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracker/plugin_data/dashboard/dashboard_tables.css

@@ -323,12 +323,46 @@
       min-width: 1120px;
       table-layout: fixed;
     }
+    .diagnostics-facts-table {
+      min-width: 1320px;
+    }
+    .diagnostics-facts-table .diagnostics-fact-col { width: 26%; }
+    .diagnostics-facts-table .diagnostics-count-col { width: 5.5%; }
+    .diagnostics-facts-table .diagnostics-token-col { width: 7.5%; }
+    .diagnostics-facts-table .diagnostics-ratio-col { width: 5%; }
+    .diagnostics-facts-table .diagnostics-latest-col { width: 14.5%; }
+    .diagnostics-facts-table .diagnostics-action-col { width: 6%; }
     .diagnostics-call-table {
       min-width: 1060px;
     }
     .diagnostics-table th {
       position: static;
     }
+    .diagnostics-facts-table th {
+      position: sticky;
+      top: 0;
+      z-index: 12;
+      background: #fbfcfe;
+    }
+    .diagnostics-facts-table th:first-child,
+    .diagnostics-facts-table td.diagnostics-fact-cell {
+      position: sticky;
+      left: 0;
+      z-index: 3;
+      background: #ffffff;
+      box-shadow: 1px 0 0 var(--line);
+    }
+    .diagnostics-facts-table th:first-child {
+      z-index: 15;
+      background: #fbfcfe;
+    }
+    .diagnostics-facts-table tr.selected-row td.diagnostics-fact-cell {
+      background: #eff6ff;
+    }
+    .diagnostics-facts-table tbody tr:not(.diagnostics-drilldown-row):hover td,
+    .diagnostics-facts-table tbody tr:not(.diagnostics-drilldown-row):hover td.diagnostics-fact-cell {
+      background: #eff6ff;
+    }
     .diagnostics-table td,
     .diagnostics-table th {
       padding: 8px 10px;
@@ -342,9 +376,10 @@
       min-width: 0;
     }
     .diagnostic-fact strong {
-      overflow-wrap: anywhere;
+      overflow-wrap: break-word;
       font-size: 12px;
       line-height: 1.25;
+      word-break: normal;
     }
     .diagnostic-fact span {
       color: var(--muted);

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracker/store.py

@@ -553,6 +553,10 @@ def query_diagnostic_facts(
     sort_map = {
         "uncached": "associated_uncached_input_tokens",
         "tokens": "associated_total_tokens",
+        "cached": "associated_cached_input_tokens",
+        "output": "associated_output_tokens",
+        "cache": "avg_cache_ratio",
+        "largest": "largest_call_tokens",
         "calls": "associated_calls",
         "occurrences": "occurrences",
         "time": "latest_event_timestamp",
@@ -681,6 +685,10 @@ def query_diagnostic_summary(
     sort_map = {
         "uncached": "associated_uncached_input_tokens",
         "tokens": "associated_total_tokens",
+        "cached": "associated_cached_input_tokens",
+        "output": "associated_output_tokens",
+        "cache": "avg_cache_ratio",
+        "largest": "largest_call_tokens",
         "calls": "associated_calls",
         "occurrences": "occurrences",
         "time": "latest_event_timestamp",

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/src/codex_usage_tracking.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-usage-tracking
-Version: 0.8.0
+Version: 0.8.1
 Summary: Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns.
 Author: Douglas Monsky
 License-Expression: MIT

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/tests/test_dashboard_payload.py

@@ -292,6 +292,14 @@ def test_dashboard_and_csv_are_aggregate_only(tmp_path: Path) -> None:
     assert "Occurrences: count of matching diagnostic fact events" in dashboard_diagnostics_js
     assert "Associated total tokens for those calls" in dashboard_diagnostics_js
     assert "Average cache ratio across associated calls" in dashboard_diagnostics_js
+    assert "data-diagnostics-fact-sort-key" in dashboard_diagnostics_js
+    assert "data-diagnostics-fact-sort-active" in dashboard_diagnostics_js
+    assert "sortFactRows" in dashboard_diagnostics_js
+    assert "diagnosticFactHeader" in dashboard_diagnostics_js
+    assert "diagnostics-facts-table" in dashboard_surface
+    assert "diagnostics-fact-cell" in dashboard_surface
+    assert "diagnostics-facts-table th:first-child" in dashboard_css
+    assert "td.diagnostics-fact-cell" in dashboard_css
     assert "captureScrollAnchor" in dashboard_diagnostics_js
     assert "restoreScrollAnchor" in dashboard_diagnostics_js
     assert "data-diagnostics-call-load-more" in dashboard_diagnostics_js

{codex_usage_tracking-0.8.0 → codex_usage_tracking-0.8.1}/tests/test_dashboard_server.py

@@ -462,6 +462,9 @@ def test_dashboard_server_live_sql_api_slices_are_aggregate_only(tmp_path: Path)
         recommendations_payload = _read_json(f"{base_url}/api/recommendations?limit=5")
         diagnostics_summary_payload = _read_json(f"{base_url}/api/diagnostics/summary?limit=5")
         diagnostics_facts_payload = _read_json(f"{base_url}/api/diagnostics/facts?limit=5")
+        diagnostics_sorted_facts_payload = _read_json(
+            f"{base_url}/api/diagnostics/facts?limit=5&sort=cached&direction=desc"
+        )
         diagnostics_compactions_payload = _read_json(
             f"{base_url}/api/diagnostics/compactions?limit=5"
         )
@@ -526,6 +529,9 @@ def test_dashboard_server_live_sql_api_slices_are_aggregate_only(tmp_path: Path)
     assert {row["fact_name"] for row in diagnostics_facts_payload["rows"]} >= {
         "post_compaction"
     }
+    assert diagnostics_sorted_facts_payload["filters"]["sort"] == "cached"
+    assert diagnostics_sorted_facts_payload["filters"]["direction"] == "desc"
+    _assert_contract(diagnostics_sorted_facts_payload)
     assert diagnostics_compactions_payload["filters"]["fact_type"] == "compaction"
     _assert_contract(diagnostics_compactions_payload)
     assert {row["fact_type"] for row in diagnostics_compactions_payload["rows"]} == {