codex-usage-tracking 0.12.0__tar.gz → 0.12.1__tar.gz

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/.codex-plugin/plugin.json

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

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.12.1 - 2026-06-29
+
+- Ship the package-domain boundary refactor behind compatibility facades so existing CLI, imports, dashboard routes, JSON payloads, and MCP entrypoints keep working while the source tree is organized by responsibility.
+- Add Tach domain configuration files, refreshed Agent Maintainer baselines, and package-boundary documentation for the new module layout.
+- Restore `python -m codex_usage_tracker.cli` after the CLI package split and add regression coverage for both module entrypoints.
+- Split allowance pricing helpers into smaller modules while preserving the public allowance facade.
+
 ## 0.12.0 - 2026-06-29
 
 - Refactor CLI, dashboard server routing, SQLite store/query boundaries, context parsing, diagnostics, and usage-drain modeling into smaller modules with compatibility facades.

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-usage-tracking
-Version: 0.12.0
+Version: 0.12.1
 Summary: Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns.
 Author: Douglas Monsky
 License-Expression: MIT
@@ -28,7 +28,7 @@ License-File: LICENSE
 Requires-Dist: mcp>=1.2.0
 Requires-Dist: tiktoken>=0.13.0
 Provides-Extra: dev
-Requires-Dist: agent-maintainer[core]==0.1.0b1; python_version >= "3.11" and extra == "dev"
+Requires-Dist: agent-maintainer[core]>=0.1.0b1; python_version >= "3.11" and extra == "dev"
 Requires-Dist: actionlint-py>=1.7.12.24; python_version >= "3.11" and extra == "dev"
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: git-agent-ratchet>=1.3.0; python_version >= "3.11" and extra == "dev"

codex_usage_tracking-0.12.1/docs/architecture/decisions/0001-package-domain-boundaries.md

@@ -0,0 +1,7 @@
+# Package Domain Boundaries
+
+The package-domain refactor moves the previously flat `codex_usage_tracker` source tree into responsibility folders and switches Tach from one large root module list to per-domain `tach.domain.toml` files.
+
+The initial domain policy declares dependencies that match the current implementation after the move. Circular dependency blocking remains disabled because the existing parser, diagnostics, and store flow still has a real cycle: parser state feeds diagnostic facts, diagnostics snapshots read persisted state, and store helpers import parser state metadata. That cycle is preserved for behavior compatibility and should be reduced in a later, focused branch.
+
+This is an architecture policy change, not an attempt to bypass drift: the old Tach module paths no longer exist after the file move, and per-domain files give each responsibility folder local ownership of its boundary declaration.

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.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.12.0
+release/0.12.1
 hotfix/0.3.3
 ```
 
@@ -91,7 +91,7 @@ blocked
 Recommended milestones:
 
 ```text
-0.12.0
+0.12.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.12.0
-python scripts/smoke_installed_package.py --docker --from-pypi --version 0.12.0
+python scripts/smoke_installed_package.py --from-pypi --version 0.12.1
+python scripts/smoke_installed_package.py --docker --from-pypi --version 0.12.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.
@@ -294,8 +294,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.12.0 -m "codex-usage-tracker 0.12.0"
-git push origin v0.12.0
+git tag -a v0.12.1 -m "codex-usage-tracker 0.12.1"
+git push origin v0.12.1
 ```
 
 Do not create or push release tags without maintainer approval.
@@ -304,7 +304,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. Patch release `0.8.1` improves Diagnostics fact table readability with pinned fact names and sortable fact columns. Minor release `0.9.0` adds persisted diagnostic snapshots, on-demand diagnostic refresh, tool/command/file-read/concentration reports, and Diagnostics dashboard panels. Minor release `0.10.0` adds Git/GitHub CLI diagnostics, file-modification diagnostics, and derived call timing fields across the dashboard and API. Patch release `0.10.1` adds lightweight action timing to context evidence and ships the synthetic Git Interactions README screenshot. Minor release `0.11.0` adds usage-drain diagnostic reports, projected weekly credit charts, and cumulative thread cost curves. Patch release `0.11.1` improves the Diagnostics weekly projection table and stale snapshot reload controls. Patch release `0.11.2` fixes served dashboard shell hydration and hardens the synthetic source-log benchmark smoke test. Patch release `0.11.3` fixes Windows live dashboard asset MIME handling. Patch release `0.11.4` fixes large-history setup refresh failures from SQLite variable limits. Minor release `0.12.0` ships the maintainability architecture repair, dashboard diagnostics hardening, Agent Maintainer ratchets, and warning-clean test suite.
+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. Minor release `0.9.0` adds persisted diagnostic snapshots, on-demand diagnostic refresh, tool/command/file-read/concentration reports, and Diagnostics dashboard panels. Minor release `0.10.0` adds Git/GitHub CLI diagnostics, file-modification diagnostics, and derived call timing fields across the dashboard and API. Patch release `0.10.1` adds lightweight action timing to context evidence and ships the synthetic Git Interactions README screenshot. Minor release `0.11.0` adds usage-drain diagnostic reports, projected weekly credit charts, and cumulative thread cost curves. Patch release `0.11.1` improves the Diagnostics weekly projection table and stale snapshot reload controls. Patch release `0.11.2` fixes served dashboard shell hydration and hardens the synthetic source-log benchmark smoke test. Patch release `0.11.3` fixes Windows live dashboard asset MIME handling. Patch release `0.11.4` fixes large-history setup refresh failures from SQLite variable limits. Minor release `0.12.0` ships the maintainability architecture repair, dashboard diagnostics hardening, Agent Maintainer ratchets, and warning-clean test suite. Patch release `0.12.1` ships the package-domain boundary split, allowance helper split, refreshed maintainability baselines, and CLI module entrypoint fix.
 
 - 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.12.0 → codex_usage_tracking-0.12.1}/docs/maintainability-roadmap.md

@@ -67,6 +67,99 @@ xenon --max-absolute B --max-modules A --max-average A src
 
 ## Branch Ledger
 
+### `chore/reset-maintainability-baseline`
+
+Goal:
+
+- Reset the Agent Maintainer file-length baseline after the package-domain
+  boundary migration so future branches fail only when they worsen current
+  oversized-file debt.
+- Keep file-length thresholds unchanged.
+
+Completed:
+
+- Regenerated `.agent-maintainer/file-length-baseline.json` against the current
+  domain-package layout.
+- Removed stale pre-refactor flat-module entries from the baseline and recorded
+  current oversized source/test files by their new package paths.
+- Confirmed no threshold loosening was required: `file_length_max_physical`
+  remains `600`, and `file_length_max_source` remains `450`.
+
+Checks:
+
+- `.venv/bin/python -m agent_maintainer verify --profile fast`: passed with
+  non-blocking structure-cohesion warnings for `server` and `usage_drain`.
+
+Remaining risks / next handoff:
+
+- The baseline intentionally accepts existing oversized files as current debt.
+- Continue cleanly from this baseline with small branches that reduce
+  `dashboard/api.py`, `store/api.py`, `usage_drain/reports.py`,
+  `diagnostics/snapshots.py`, CLI parser/main, and the largest tests.
+
+### `refactor/split-oversized-modules`
+
+Goal:
+
+- Continue the post-domain-move handoff by clearing one moved source module from
+  the Agent Maintainer file-length ratchet.
+- Keep the slice small enough to review independently after the broad package
+  boundary merge.
+
+Completed:
+
+- Split `src/codex_usage_tracker/pricing/allowance.py` into a compatibility
+  facade plus `pricing/allowance_config.py` and `pricing/allowance_usage.py`.
+- Kept the public `codex_usage_tracker.pricing.allowance` import surface stable.
+- Verified the pricing-scoped Agent Maintainer fast profile passes.
+
+Checks:
+
+- `.venv/bin/python -m ruff check src/codex_usage_tracker/pricing/allowance.py src/codex_usage_tracker/pricing/allowance_config.py src/codex_usage_tracker/pricing/allowance_usage.py tests/pricing/test_allowance.py`: passed.
+- `.venv/bin/python -m pytest tests/pricing/test_allowance.py -q`: passed, 8 tests.
+- `.venv/bin/python -m agent_maintainer verify --profile fast --file-length-path src/codex_usage_tracker/pricing/allowance.py --file-length-path src/codex_usage_tracker/pricing/allowance_config.py --file-length-path src/codex_usage_tracker/pricing/allowance_usage.py`: passed with non-blocking structure/change-budget warnings.
+
+Remaining risks / next handoff:
+
+- Full `agent_maintainer verify --profile fast` still fails on the remaining
+  oversized moved modules/tests: CLI parser/main, usage-drain model/reports,
+  dashboard API, diagnostics snapshots, store API, and several large tests.
+- Next source candidates: `dashboard/api.py` or `store/api.py` if prioritizing
+  runtime blast radius; `tests/dashboard/test_dashboard_server.py` if
+  prioritizing the largest test file.
+
+### `refactor/package-domain-boundaries`
+
+Goal:
+- Move the flat `codex_usage_tracker` package into responsibility folders.
+- Move tests into matching responsibility folders.
+- Preserve stable CLI, MCP launcher, and compatibility import behavior.
+- Adopt Tach domain configs now that the installed Agent Maintainer/Tach stack supports them.
+
+Completed:
+- Installed Agent Maintainer from `douglasmonsky/agent-maintainer@main`, resolving locally to `0.1.0b4`.
+- Relaxed the PyPI dev extra pin so the GitHub-installed tool is not downgraded by normal editable dev installs.
+- Added `requirements/agent-maintainer-github.txt` for the local repo-source maintainer install path.
+- Added per-domain packages and `tach.domain.toml` files for `core`, `pricing`, `parser`, `context`, `store`, `diagnostics`, `usage_drain`, `server`, `cli`, `dashboard`, and `reports`.
+- Kept compatibility wrappers/facades for stable imports including `codex_usage_tracker.cli`, `codex_usage_tracker.store`, `codex_usage_tracker.server`, `codex_usage_tracker.mcp_server`, `codex_usage_tracker.plugin_installer`, `codex_usage_tracker.allowance`, and `codex_usage_tracker.support`.
+- Split the moved context reader, server handler, and JSON contract modules enough to avoid new oversized-file failures for those specific moved files.
+- Moved tests under matching domain folders and updated repo-root/helper imports.
+
+Checks:
+- `.venv/bin/python -m ruff check .`: passed.
+- `.venv/bin/python -m mypy`: passed.
+- `.venv/bin/python -m pytest -q`: passed, 534 tests.
+- `.venv/bin/python -m pytest --cov=codex_usage_tracker --cov-report=term-missing -q`: passed, 534 tests, 86% total coverage.
+- `.venv/bin/python -m compileall -q src tests`: passed.
+- `.venv/bin/tach check`: passed.
+- `.venv/bin/python scripts/check_release.py`: passed.
+- `git diff --check`: passed.
+
+Remaining risks / next handoff:
+- Agent Maintainer `verify --profile fast` still flags several moved legacy modules and moved tests as new oversized files because their paths changed. This branch reduced three immediate moved-file violations but did not try to split every existing large module/test in the same commit.
+- The next branch should continue splitting remaining large files, with highest-value candidates: `dashboard/api.py`, `store/api.py`, `usage_drain/reports.py`, `diagnostics/snapshots.py`, `cli/parser.py`, `cli/main.py`, and the largest dashboard/store tests.
+- The parser/diagnostics/store Tach cycle is documented in `docs/architecture/decisions/0001-package-domain-boundaries.md` and should be reduced in a focused later branch.
+
 ### `chore/maintainability-agent-maintainer-baseline`
 
 Goal:

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.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.12.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.12.0`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.12.0 && codex-usage-tracker --version`.
-- [x] Verify public pipx install path for `0.12.0`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.12.0 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
+- [x] Verify the current public PyPI version is visible as `0.12.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.12.1`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.12.1 && codex-usage-tracker --version`.
+- [x] Verify public pipx install path for `0.12.1`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.12.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.12.0`.
+- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.12.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.12.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.12.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.12.0`.
+- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.12.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.12.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.12.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.12.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.12.1`.
 - Release recovery documentation is proven by `scripts/check_release.py` required-file and docs checks.
 
 ### Known Limitations

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-usage-tracking"
-version = "0.12.0"
+version = "0.12.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"
@@ -42,7 +42,7 @@ Changelog = "https://github.com/douglasmonsky/codex-usage-tracker/blob/main/CHAN
 
 [project.optional-dependencies]
 dev = [
-    "agent-maintainer[core]==0.1.0b1; python_version >= '3.11'",
+    "agent-maintainer[core]>=0.1.0b1; python_version >= '3.11'",
     "actionlint-py>=1.7.12.24; python_version >= '3.11'",
     "build>=1.2",
     "git-agent-ratchet>=1.3.0; python_version >= '3.11'",
@@ -148,12 +148,12 @@ log_dir = ".verify-logs"
 python_version = "3.10"
 warn_unused_configs = true
 files = [
-  "src/codex_usage_tracker/json_contracts.py",
-  "src/codex_usage_tracker/models.py",
-  "src/codex_usage_tracker/recommendations.py",
-  "src/codex_usage_tracker/reports.py",
-  "src/codex_usage_tracker/schema.py",
-  "src/codex_usage_tracker/store.py",
-  "src/codex_usage_tracker/usage_drain_reports.py",
-  "src/codex_usage_tracker/usage_drain_time_series.py",
+  "src/codex_usage_tracker/core/json_contracts.py",
+  "src/codex_usage_tracker/core/models.py",
+  "src/codex_usage_tracker/reports/recommendations.py",
+  "src/codex_usage_tracker/reports/api.py",
+  "src/codex_usage_tracker/core/schema.py",
+  "src/codex_usage_tracker/store/api.py",
+  "src/codex_usage_tracker/usage_drain/reports.py",
+  "src/codex_usage_tracker/usage_drain/time_series.py",
 ]

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/scripts/benchmark_synthetic_history.py

@@ -20,15 +20,15 @@ SRC_PATH = REPO_ROOT / "src"
 if str(SRC_PATH) not in sys.path:
     sys.path.insert(0, str(SRC_PATH))
 
-from codex_usage_tracker.context import load_call_context  # noqa: E402
-from codex_usage_tracker.dashboard import dashboard_payload  # noqa: E402
-from codex_usage_tracker.models import UsageEvent  # noqa: E402
-from codex_usage_tracker.reports import (  # noqa: E402
+from codex_usage_tracker.context.api import load_call_context  # noqa: E402
+from codex_usage_tracker.core.models import UsageEvent  # noqa: E402
+from codex_usage_tracker.dashboard.api import dashboard_payload  # noqa: E402
+from codex_usage_tracker.reports.api import (  # noqa: E402
     build_pricing_coverage_report,
     build_recommendations_report,
     build_summary_report,
 )
-from codex_usage_tracker.store import (  # noqa: E402
+from codex_usage_tracker.store.api import (  # noqa: E402
     connect,
     init_db,
     query_dashboard_event_count,

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/scripts/check_release.py

@@ -363,7 +363,7 @@ def _check_issue_templates() -> list[str]:
 
 def _check_packaging_metadata() -> list[str]:
     sys.path.insert(0, str(REPO_ROOT / "src"))
-    from codex_usage_tracker.plugin_installer import plugin_manifest
+    from codex_usage_tracker.cli.plugin_installer import plugin_manifest
 
     pyproject = tomllib.loads((REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8"))
     project = pyproject["project"]

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/scripts/install_local_plugin.py

@@ -10,8 +10,11 @@ from pathlib import Path
 REPO_ROOT = Path(__file__).resolve().parents[1]
 sys.path.insert(0, str(REPO_ROOT / "src"))
 
-from codex_usage_tracker.paths import DEFAULT_MARKETPLACE_PATH, DEFAULT_PLUGIN_LINK  # noqa: E402
-from codex_usage_tracker.plugin_installer import install_plugin  # noqa: E402
+from codex_usage_tracker.cli.plugin_installer import install_plugin  # noqa: E402
+from codex_usage_tracker.core.paths import (  # noqa: E402
+    DEFAULT_MARKETPLACE_PATH,
+    DEFAULT_PLUGIN_LINK,
+)
 
 
 def main() -> int:

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/scripts/model_usage_drain.py

@@ -8,10 +8,13 @@ import json
 from pathlib import Path
 from typing import Any
 
-from codex_usage_tracker.allowance import annotate_rows_with_allowance, load_allowance_config
-from codex_usage_tracker.paths import DEFAULT_ALLOWANCE_PATH, DEFAULT_DB_PATH
-from codex_usage_tracker.store import query_dashboard_events
-from codex_usage_tracker.usage_drain_model import (
+from codex_usage_tracker.core.paths import DEFAULT_ALLOWANCE_PATH, DEFAULT_DB_PATH
+from codex_usage_tracker.pricing.allowance import (
+    annotate_rows_with_allowance,
+    load_allowance_config,
+)
+from codex_usage_tracker.store.api import query_dashboard_events
+from codex_usage_tracker.usage_drain.model import (
     build_usage_delta_spans,
     load_fast_proxy_annotations,
     summarize_usage_drain_model,

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.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.12.0",
+    "codex-usage-tracking==0.12.1",
 )
-RUNTIME_VERSION = "0.12.0"
+RUNTIME_VERSION = "0.12.1"
 PACKAGE_SPEC_MARKER = ".codex-usage-tracker-package-spec"
 MODULE_CHECK = (
     "import importlib.metadata; "

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/src/codex_usage_tracker/__init__.py

@@ -1,7 +1,7 @@
 """Aggregate-only Codex token usage tracking."""
 
-from codex_usage_tracker.models import UsageEvent
+from codex_usage_tracker.core.models import UsageEvent
 
-__version__ = "0.12.0"
+__version__ = "0.12.1"
 
 __all__ = ["UsageEvent", "__version__"]

{codex_usage_tracking-0.12.0 → codex_usage_tracking-0.12.1}/src/codex_usage_tracker/__main__.py

@@ -2,7 +2,7 @@
 
 import sys
 
-from codex_usage_tracker.cli import main
+from codex_usage_tracker.cli.main import main
 
 if __name__ == "__main__":
     sys.exit(main())

codex_usage_tracking-0.12.1/src/codex_usage_tracker/allowance.py

@@ -0,0 +1,9 @@
+"""Compatibility module alias for ``codex_usage_tracker.pricing.allowance``."""
+
+from __future__ import annotations
+
+import sys
+from importlib import import_module
+
+_impl = import_module("codex_usage_tracker.pricing.allowance")
+sys.modules[__name__] = _impl

codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/__init__.py

@@ -0,0 +1,19 @@
+"""Compatibility facade for ``codex_usage_tracker.cli``."""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import Any
+
+from codex_usage_tracker.cli.main import main
+
+_API_MODULE = "codex_usage_tracker.cli.main"
+
+__all__ = ["main"]
+
+def __getattr__(name: str) -> Any:
+    module = import_module(_API_MODULE)
+    try:
+        return getattr(module, name)
+    except AttributeError as exc:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from exc

codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/__main__.py

@@ -0,0 +1,10 @@
+"""Run Codex Usage Tracker CLI with ``python -m codex_usage_tracker.cli``."""
+
+from __future__ import annotations
+
+import sys
+
+from codex_usage_tracker.cli.main import main
+
+if __name__ == "__main__":
+    sys.exit(main())

codex_usage_tracking-0.12.0/src/codex_usage_tracker/cli_config.py → codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/config.py

@@ -6,20 +6,20 @@ import argparse
 import sys
 from pathlib import Path
 
-from codex_usage_tracker.allowance import (
+from codex_usage_tracker.cli.output import print_json
+from codex_usage_tracker.core.api_payloads import path_payload
+from codex_usage_tracker.core.projects import write_project_template
+from codex_usage_tracker.pricing.allowance import (
     update_rate_card,
     write_allowance_from_text,
     write_allowance_template,
 )
-from codex_usage_tracker.api_payloads import path_payload
-from codex_usage_tracker.cli_output import print_json
-from codex_usage_tracker.pricing import (
+from codex_usage_tracker.pricing.api import (
     pin_pricing_snapshot,
     update_pricing_from_openai_docs,
     write_pricing_template,
 )
-from codex_usage_tracker.projects import write_project_template
-from codex_usage_tracker.recommendations import write_threshold_template
+from codex_usage_tracker.reports.recommendations import write_threshold_template
 
 
 def run_init_pricing(args: argparse.Namespace) -> int:

codex_usage_tracking-0.12.0/src/codex_usage_tracker/cli_dashboard.py → codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/dashboard.py

@@ -7,12 +7,12 @@ import webbrowser
 from pathlib import Path
 from typing import Any
 
-from codex_usage_tracker.api_payloads import path_payload, refresh_result_payload
-from codex_usage_tracker.cli_output import print_json
-from codex_usage_tracker.dashboard import generate_dashboard
-from codex_usage_tracker.i18n import normalize_language
-from codex_usage_tracker.server import serve_dashboard
-from codex_usage_tracker.store import refresh_usage_index
+from codex_usage_tracker.cli.output import print_json
+from codex_usage_tracker.core.api_payloads import path_payload, refresh_result_payload
+from codex_usage_tracker.core.i18n import normalize_language
+from codex_usage_tracker.dashboard.api import generate_dashboard
+from codex_usage_tracker.server.api import serve_dashboard
+from codex_usage_tracker.store.api import refresh_usage_index
 
 
 def run_dashboard(args: argparse.Namespace) -> int:

codex_usage_tracking-0.12.0/src/codex_usage_tracker/cli_diagnostics.py → codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/diagnostics.py

@@ -6,13 +6,13 @@ import argparse
 from collections.abc import Callable
 from typing import Any
 
-from codex_usage_tracker.cli_output import print_json
-from codex_usage_tracker.diagnostic_reports import (
+from codex_usage_tracker.cli.output import print_json
+from codex_usage_tracker.diagnostics.reports import (
     build_diagnostics_fact_calls_report,
     build_diagnostics_facts_report,
     build_diagnostics_summary_report,
 )
-from codex_usage_tracker.diagnostic_snapshots import (
+from codex_usage_tracker.diagnostics.snapshots import (
     build_diagnostic_commands_report,
     build_diagnostic_concentration_report,
     build_diagnostic_file_modifications_report,

codex_usage_tracking-0.12.0/src/codex_usage_tracker/cli.py → codex_usage_tracking-0.12.1/src/codex_usage_tracker/cli/main.py

@@ -7,15 +7,7 @@ import json
 import sys
 from typing import Any
 
-from codex_usage_tracker.api_payloads import (
-    error_code,
-    path_payload,
-    plugin_install_payload,
-    plugin_uninstall_payload,
-    refresh_result_payload,
-    session_payload,
-)
-from codex_usage_tracker.cli_config import (
+from codex_usage_tracker.cli.config import (
     run_init_allowance,
     run_init_pricing,
     run_init_projects,
@@ -25,39 +17,47 @@ from codex_usage_tracker.cli_config import (
     run_update_pricing,
     run_update_rate_card,
 )
-from codex_usage_tracker.cli_dashboard import (
+from codex_usage_tracker.cli.dashboard import (
     run_dashboard,
     run_open_dashboard,
     run_serve_dashboard,
 )
-from codex_usage_tracker.cli_diagnostics import run_diagnostics
-from codex_usage_tracker.cli_output import print_json
-from codex_usage_tracker.cli_parser import build_parser
-from codex_usage_tracker.context import load_call_context
-from codex_usage_tracker.diagnostics import run_doctor
-from codex_usage_tracker.formatting import (
+from codex_usage_tracker.cli.diagnostics import run_diagnostics
+from codex_usage_tracker.cli.output import print_json
+from codex_usage_tracker.cli.parser import build_parser
+from codex_usage_tracker.cli.plugin_installer import install_plugin, uninstall_plugin
+from codex_usage_tracker.context.api import load_call_context
+from codex_usage_tracker.core.api_payloads import (
+    error_code,
+    path_payload,
+    plugin_install_payload,
+    plugin_uninstall_payload,
+    refresh_result_payload,
+    session_payload,
+)
+from codex_usage_tracker.core.formatting import (
     format_doctor,
     format_session,
 )
-from codex_usage_tracker.parser import inspect_log, load_session_index
-from codex_usage_tracker.plugin_installer import install_plugin, uninstall_plugin
-from codex_usage_tracker.pricing import update_pricing_from_openai_docs, write_pricing_template
-from codex_usage_tracker.projects import apply_project_privacy_to_rows
-from codex_usage_tracker.reports import (
+from codex_usage_tracker.core.projects import apply_project_privacy_to_rows
+from codex_usage_tracker.diagnostics.api import run_doctor
+from codex_usage_tracker.parser.api import inspect_log, load_session_index
+from codex_usage_tracker.pricing.api import update_pricing_from_openai_docs, write_pricing_template
+from codex_usage_tracker.reports.api import (
     build_expensive_calls_report,
     build_pricing_coverage_report,
     build_query_report,
     build_recommendations_report,
     build_summary_report,
 )
-from codex_usage_tracker.store import (
+from codex_usage_tracker.reports.support import build_support_bundle
+from codex_usage_tracker.store.api import (
     export_usage_csv,
     query_session_usage,
     rebuild_usage_index,
     refresh_usage_index,
     reset_usage_database,
 )
-from codex_usage_tracker.support import build_support_bundle
 
 
 def main() -> int: