codex-usage-tracking 0.4.1__tar.gz → 0.5.0__tar.gz

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/.codex-plugin/plugin.json

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

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/CHANGELOG.md

@@ -2,9 +2,18 @@
 
 ## Unreleased
 
+## 0.5.0 - 2026-06-10
+
+- Add the dashboard localization foundation, including starter locale catalogs, language metadata, local browser language selection, `--lang`, and `CODEX_USAGE_TRACKER_LANG`.
+- Add Vietnamese dashboard localization and focused validation coverage for translated dashboard labels.
+- Keep the README landing page focused on dashboard screenshots and companion usage workflows before detailed localization guidance.
+- Stabilize the CI synthetic benchmark smoke so coverage instrumentation does not create false release failures.
+- Pin the marketplace MCP runtime launcher to the exact `codex-usage-tracking==0.5.0` package.
+
 ## 0.4.1 - 2026-06-09
 
 - Harden the production PyPI workflow so manual publishing must run from `main` or a tag ref before artifacts are downloaded and uploaded.
+- Skip TestPyPI/PyPI uploads when the exact distribution version already exists on the target index, allowing a GitHub Release to be reconciled after a workflow-dispatch publish.
 - Strengthen `scripts/check_release.py` so it validates the publish-ref preflight inside both the TestPyPI and PyPI jobs.
 - Check off completed 1.0 readiness items with evidence for migration coverage, localhost dashboard smoke testing, and the protected GitHub `pypi` environment.
 - Pin the marketplace MCP runtime launcher to the exact `codex-usage-tracking==0.4.1` package.

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-usage-tracking
-Version: 0.4.1
+Version: 0.5.0
 Summary: Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns.
 Author: Douglas Monsky
 License-Expression: MIT
@@ -190,6 +190,34 @@ The tracker cannot read your logged-in ChatGPT plan or live remaining usage auto
 - Companion Codex skills for operational setup and conversational usage analysis.
 - Optional local pricing, Codex credit, allowance, threshold, project alias, and privacy-mode configuration.
 
+## Dashboard Language
+
+The dashboard supports localized UI text. English is the canonical catalog, and the project includes starter locale catalogs for common dashboard languages.
+
+Set the initial dashboard language with `--lang`:
+
+```bash
+codex-usage-tracker --lang vi serve-dashboard --open
+```
+
+Or set a default with:
+
+```bash
+CODEX_USAGE_TRACKER_LANG=vi codex-usage-tracker serve-dashboard --open
+```
+
+The dashboard also includes a language selector. Browser selections are stored locally and can override the generated default for that browser.
+
+Supported starter locales include English, Vietnamese, Spanish, French, German, Portuguese, Japanese, Simplified Chinese, Korean, Russian, Italian, and Arabic. This localizes dashboard UI text, not the full CLI output or data exports.
+
+### Adding A Dashboard Language
+
+1. Add a locale JSON file named by language code under `src/codex_usage_tracker/plugin_data/dashboard/locales/`.
+2. Include every key from the English catalog.
+3. Preserve every placeholder from the English string.
+4. Add the language code, native name, English name, and text direction to the supported language metadata.
+5. Run the i18n validation tests.
+
 ## Common Commands
 
 ```bash

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/README.md

@@ -153,6 +153,34 @@ The tracker cannot read your logged-in ChatGPT plan or live remaining usage auto
 - Companion Codex skills for operational setup and conversational usage analysis.
 - Optional local pricing, Codex credit, allowance, threshold, project alias, and privacy-mode configuration.
 
+## Dashboard Language
+
+The dashboard supports localized UI text. English is the canonical catalog, and the project includes starter locale catalogs for common dashboard languages.
+
+Set the initial dashboard language with `--lang`:
+
+```bash
+codex-usage-tracker --lang vi serve-dashboard --open
+```
+
+Or set a default with:
+
+```bash
+CODEX_USAGE_TRACKER_LANG=vi codex-usage-tracker serve-dashboard --open
+```
+
+The dashboard also includes a language selector. Browser selections are stored locally and can override the generated default for that browser.
+
+Supported starter locales include English, Vietnamese, Spanish, French, German, Portuguese, Japanese, Simplified Chinese, Korean, Russian, Italian, and Arabic. This localizes dashboard UI text, not the full CLI output or data exports.
+
+### Adding A Dashboard Language
+
+1. Add a locale JSON file named by language code under `src/codex_usage_tracker/plugin_data/dashboard/locales/`.
+2. Include every key from the English catalog.
+3. Preserve every placeholder from the English string.
+4. Add the language code, native name, English name, and text direction to the supported language metadata.
+5. Run the i18n validation tests.
+
 ## Common Commands
 
 ```bash

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/docs/cli-reference.md

@@ -83,6 +83,8 @@ codex-usage-tracker serve-dashboard --no-context-api --open
 
 Dashboards default to active sessions only. Use `--include-archived` for an all-history static/opened dashboard, or switch the served dashboard's `History` control from `Active sessions only` to `All history` when you intentionally want archived logs scanned and included.
 
+Use global `--lang <code>` before the dashboard command, or set `CODEX_USAGE_TRACKER_LANG`, to choose the dashboard's initial UI language. The dashboard language selector can then override that default in the browser. Localization applies to dashboard UI text, not JSON fields, CSV columns, model names, thread names, paths, or full CLI output.
+
 The localhost `/api/usage` endpoint accepts `limit` and `offset` query parameters, so automation can page aggregate rows without asking the server to load an entire large history at once.
 
 ## Summaries

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/docs/dashboard-guide.md

@@ -37,6 +37,15 @@ Redacted mode hides raw cwd/source paths, hides Git remote labels, and hashes un
 
 `serve-dashboard` refreshes active-session logs before opening by default. Use `--no-refresh` only when you intentionally want a cached view of the existing local index.
 
+Set the initial dashboard language with the global `--lang` option before the command, or use `CODEX_USAGE_TRACKER_LANG`:
+
+```bash
+codex-usage-tracker --lang vi serve-dashboard --open
+CODEX_USAGE_TRACKER_LANG=vi codex-usage-tracker serve-dashboard --open
+```
+
+The dashboard language selector stores your browser preference locally. It localizes dashboard UI labels, captions, badges, empty states, detail-panel labels, context controls, and recommendation text; it does not translate raw data values, JSON fields, CSV columns, model names, thread names, project names, paths, or full CLI output.
+
 The server keeps the HTML aggregate-only and enables two live features:
 
 - `Refresh` rescans local Codex logs and updates the dashboard rows.

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/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.4.1
+release/0.5.0
 hotfix/0.3.3
 ```
 
@@ -91,7 +91,7 @@ blocked
 Recommended milestones:
 
 ```text
-0.4.1
+0.5.0
 1.0-readiness
 1.0.0
 ```
@@ -147,10 +147,12 @@ 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.4.1
-python scripts/smoke_installed_package.py --docker --from-pypi --version 0.4.1
+python scripts/smoke_installed_package.py --from-pypi --version 0.5.0
+python scripts/smoke_installed_package.py --docker --from-pypi --version 0.5.0
 ```
 
+`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.
+
 Docker avoids local toolchain side effects during install testing. Keep one local `pipx` smoke for platform-specific PATH and plugin-discovery behavior, but use Docker for repeatable Linux package verification.
 
 For documentation-only branches, at minimum run:
@@ -222,7 +224,7 @@ Tracked timings:
 | `pricing_coverage_seconds` | Pricing coverage report |
 | `project_summary_seconds` | Project summary report |
 
-The normal CI smoke uses a tiny synthetic history with `--enforce-thresholds` so regressions in the benchmark contract are visible on pull requests. The 10k/100k runs are a practical local gate for performance-sensitive changes; the 500k run is the release-sized gate and can take about a minute on a modern laptop because recommendations and project summary intentionally scan all aggregate rows.
+The normal CI smoke uses a tiny synthetic history with `--enforce-thresholds` and a small `--threshold-scale` allowance so coverage instrumentation and shared runner noise do not create false failures. The 10k/100k runs are a practical local gate for performance-sensitive changes; the 500k run is the release-sized gate and can take about a minute on a modern laptop because recommendations and project summary intentionally scan all aggregate rows.
 
 ## Release Checklist
 
@@ -264,8 +266,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.4.1 -m "codex-usage-tracker 0.4.1"
-git push origin v0.4.1
+git tag -a v0.5.0 -m "codex-usage-tracker 0.5.0"
+git push origin v0.5.0
 ```
 
 Do not create or push release tags without maintainer approval.
@@ -274,13 +276,12 @@ 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` hardened the PyPI publish workflow and checked off completed 1.0 readiness gates:
+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 starter language catalogs.
 
 - 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`
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.3.2`
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.4.0`
-- GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.4.1`
 - PyPI: `https://pypi.org/project/codex-usage-tracking/`
 - TestPyPI: `https://test.pypi.org/project/codex-usage-tracking/`
 

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/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.4.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.4.1`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.4.1 && codex-usage-tracker --version`.
-- [x] Verify public pipx install path for `0.4.1`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.4.1 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
+- [x] Verify the current public PyPI version is visible as `0.5.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.5.0`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.5.0 && codex-usage-tracker --version`.
+- [x] Verify public pipx install path for `0.5.0`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.5.0 && /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.4.1`.
+- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.5.0`.
 - [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.
 
@@ -120,8 +120,8 @@ Not guaranteed:
 - [x] Verify manual PyPI workflow dispatch is restricted to `main` or tag refs: `python scripts/check_release.py`.
 - [x] Verify PyPI job is gated by environment `pypi`: `gh api repos/douglasmonsky/codex-usage-tracker/environments/pypi`.
 - [x] Verify dist filenames match `codex_usage_tracking`: `python -m build && python scripts/check_release.py --dist`.
-- [ ] Verify TestPyPI process: run `Publish Python package` with `target=testpypi` only when intentionally testing release publication.
-- [ ] Verify PyPI process: publish a GitHub Release or run workflow dispatch with `target=pypi` only when intentionally publishing a reviewed release.
+- [x] Verify TestPyPI process: run `Publish Python package` with `target=testpypi` only when intentionally testing release publication.
+- [x] Verify PyPI process: publish a GitHub Release or run workflow dispatch with `target=pypi` only when intentionally publishing a reviewed release.
 - [x] Document release recovery by cutting a new patch version when an uploaded artifact is wrong: see `docs/development.md`.
 
 ## 13. Known Limitations
@@ -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.4.1`; 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.5.0`; 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.4.1`.
+- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.5.0`.
 - 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
@@ -211,7 +211,7 @@ These references are the concrete proof behind completed checklist items. Public
 
 - Benchmark command behavior and threshold contract are smoke-tested by `tests/test_cli_release.py::test_synthetic_history_benchmark_script_smoke`.
 - Release-size 10k, 100k, and 500k benchmark claims are proven by running `python scripts/benchmark_synthetic_history.py --rows 10000 100000 500000 --json --enforce-thresholds` before release work when practical.
-- CI-safe benchmark coverage is proven by the CI `Release readiness` job through `tests/test_cli_release.py::test_synthetic_history_benchmark_script_smoke`.
+- CI-safe benchmark coverage is proven by the CI `Release readiness` job through `tests/test_cli_release.py::test_synthetic_history_benchmark_script_smoke`, using a small `--threshold-scale` allowance for coverage instrumentation and shared runner noise.
 
 ### Release Process
 
@@ -219,6 +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.5.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.5.0`.
 - Release recovery documentation is proven by `scripts/check_release.py` required-file and docs checks.
 
 ### Known Limitations

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-usage-tracking"
-version = "0.4.1"
+version = "0.5.0"
 description = "Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -62,6 +62,7 @@ where = ["src"]
 "codex_usage_tracker.plugin_data" = [
   "assets/*",
   "dashboard/*",
+  "dashboard/locales/*",
   "docs/*",
   "docs/assets/*",
   "rate_cards/*",

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/scripts/check_release.py

@@ -23,6 +23,43 @@ DIST_FILE_STEM = "codex_usage_tracking"
 IMPORT_PACKAGE = "codex_usage_tracker"
 CONSOLE_SCRIPT = "codex-usage-tracker"
 SUPPORTED_PYTHON_VERSIONS = ["3.10", "3.11", "3.12", "3.13", "3.14"]
+OLD_PYPI_DISTRIBUTION_NAME = "codex-usage-tracker"
+DASHBOARD_LOCALE_CODES = [
+    "en",
+    "vi",
+    "es",
+    "fr",
+    "de",
+    "pt",
+    "ja",
+    "zh-Hans",
+    "ko",
+    "ru",
+    "it",
+    "ar",
+]
+DASHBOARD_LOCALE_SOURCE_FILES = [
+    f"src/codex_usage_tracker/plugin_data/dashboard/locales/{code}.json"
+    for code in DASHBOARD_LOCALE_CODES
+]
+DASHBOARD_LOCALE_WHEEL_MEMBERS = {
+    f"codex_usage_tracker/plugin_data/dashboard/locales/{code}.json"
+    for code in DASHBOARD_LOCALE_CODES
+}
+PUBLIC_RELEASE_DOCS = [
+    "docs/one-dot-oh-readiness.md",
+    "docs/development.md",
+]
+PACKAGE_NAMING_DOCS = [
+    "README.md",
+    "docs/install.md",
+    "docs/development.md",
+]
+PUBLIC_VERSION_PATTERNS = [
+    re.compile(r"codex-usage-tracking==([0-9]+(?:\.[0-9]+){2})"),
+    re.compile(r"--from-pypi --version ([0-9]+(?:\.[0-9]+){2})"),
+    re.compile(r"visible as `([0-9]+(?:\.[0-9]+){2})`"),
+]
 SECRET_PATTERNS = {
     "OpenAI API key": re.compile(r"\bsk-(?:proj-)?[A-Za-z0-9_-]{20,}"),
     "GitHub token": re.compile(r"\b(?:ghp|github_pat)_[A-Za-z0-9_]{20,}"),
@@ -62,6 +99,7 @@ REQUIRED_FILES = [
     "src/codex_usage_tracker/plugin_data/dashboard/dashboard.js",
     "src/codex_usage_tracker/plugin_data/dashboard/dashboard_state.js",
     "src/codex_usage_tracker/plugin_data/dashboard/dashboard_template.html",
+    *DASHBOARD_LOCALE_SOURCE_FILES,
     "src/codex_usage_tracker/plugin_data/docs/dashboard-guide.html",
     "src/codex_usage_tracker/plugin_data/rate_cards/codex-credit-rates.json",
     "src/codex_usage_tracker/plugin_data/docs/assets/dashboard-insights.png",
@@ -79,6 +117,7 @@ WHEEL_REQUIRED_MEMBERS = {
     "codex_usage_tracker/plugin_data/dashboard/dashboard.js",
     "codex_usage_tracker/plugin_data/dashboard/dashboard_state.js",
     "codex_usage_tracker/plugin_data/dashboard/dashboard_template.html",
+    *DASHBOARD_LOCALE_WHEEL_MEMBERS,
     "codex_usage_tracker/plugin_data/docs/dashboard-guide.html",
     "codex_usage_tracker/plugin_data/rate_cards/codex-credit-rates.json",
     "codex_usage_tracker/plugin_data/docs/assets/dashboard-insights.png",
@@ -156,6 +195,7 @@ def _check_versions() -> list[str]:
         failures.append(".codex-plugin/plugin.json version does not match pyproject.toml")
     if f"## {package_version}" not in changelog:
         failures.append("CHANGELOG.md does not contain an entry for the package version")
+    failures.extend(_check_public_release_doc_versions(package_version))
     return failures
 
 
@@ -164,6 +204,7 @@ def _check_docs() -> list[str]:
     failures: list[str] = []
     for required in [
         "pipx install",
+        "codex-usage-tracking",
         "codex-usage-tracker install-plugin",
         "codex-usage-tracker doctor",
         "Data Privacy",
@@ -171,6 +212,57 @@ def _check_docs() -> list[str]:
     ]:
         if required not in readme:
             failures.append(f"README.md is missing required install/privacy text: {required}")
+    failures.extend(_check_package_naming_docs())
+    return failures
+
+
+def _check_public_release_doc_versions(package_version: str) -> list[str]:
+    failures: list[str] = []
+    for relative_path in PUBLIC_RELEASE_DOCS:
+        path = REPO_ROOT / relative_path
+        text = path.read_text(encoding="utf-8")
+        for pattern in PUBLIC_VERSION_PATTERNS:
+            for match in pattern.finditer(text):
+                if match.group(1) != package_version:
+                    failures.append(
+                        f"{relative_path} public release version {match.group(1)} "
+                        f"does not match pyproject.toml {package_version}"
+                    )
+    return failures
+
+
+def _check_package_naming_docs() -> list[str]:
+    failures: list[str] = []
+    old_name_warning = f"The `{OLD_PYPI_DISTRIBUTION_NAME}` PyPI name is not this project"
+    for relative_path in PACKAGE_NAMING_DOCS:
+        text = (REPO_ROOT / relative_path).read_text(encoding="utf-8")
+        if DISTRIBUTION_NAME not in text:
+            failures.append(f"{relative_path} must name the public PyPI package {DISTRIBUTION_NAME}")
+        if relative_path in {"README.md", "docs/install.md"} and old_name_warning not in text:
+            failures.append(
+                f"{relative_path} must warn that {OLD_PYPI_DISTRIBUTION_NAME} "
+                "is a different PyPI package"
+            )
+        failures.extend(_check_doc_install_lines(relative_path, text))
+    return failures
+
+
+def _check_doc_install_lines(relative_path: str, text: str) -> list[str]:
+    failures: list[str] = []
+    for line_number, line in enumerate(text.splitlines(), start=1):
+        normalized = line.strip().strip("`")
+        if not normalized:
+            continue
+        if not re.search(r"\b(?:pipx|pip|python(?:3)? -m pip)\s+install\b", normalized):
+            continue
+        if OLD_PYPI_DISTRIBUTION_NAME not in normalized:
+            continue
+        if DISTRIBUTION_NAME in normalized or "git+" in normalized or "github.com" in normalized:
+            continue
+        failures.append(
+            f"{relative_path}:{line_number} installs {OLD_PYPI_DISTRIBUTION_NAME}; "
+            f"use {DISTRIBUTION_NAME}"
+        )
     return failures
 
 
@@ -322,6 +414,8 @@ def _check_publish_workflow() -> list[str]:
         "name: pypi",
         "https://test.pypi.org/project/codex-usage-tracking/",
         "https://pypi.org/project/codex-usage-tracking/",
+        "steps.package-version.outputs.exists != 'true'",
+        "codex-usage-tracking {version} already exists on {index_name}; skipping upload.",
     ]:
         if required not in workflow:
             failures.append(f"publish workflow is missing required Trusted Publishing text: {required}")
@@ -343,6 +437,11 @@ def _check_publish_workflow() -> list[str]:
             "echo \"sha=$GITHUB_SHA\"",
             "refs/heads/main|refs/tags/*",
             "Manual PyPI publishing must run from main or a tag ref.",
+            "Check target package version",
+            "id: package-version",
+            "PACKAGE_INDEX_JSON_URL",
+            "PACKAGE_INDEX_NAME",
+            "steps.package-version.outputs.exists != 'true'",
         ]:
             if required not in job_block:
                 failures.append(f"publish workflow {job_name} job is missing preflight: {required}")
@@ -376,27 +475,12 @@ def _check_ci_workflow() -> list[str]:
     return failures
 
 
-def _check_ci_workflow() -> list[str]:
-    workflow_path = REPO_ROOT / ".github" / "workflows" / "ci.yml"
-    if not workflow_path.exists():
-        return ["missing CI workflow: .github/workflows/ci.yml"]
-    workflow = workflow_path.read_text(encoding="utf-8")
-    failures: list[str] = []
-    for required in [
-        "name: Build package",
-        "python -m build",
-        "python -m twine check dist/*",
-        "python scripts/check_release.py --dist",
-    ]:
-        if required not in workflow:
-            failures.append(f"CI package job is missing required build check: {required}")
-    return failures
-
-
 def _check_skill_packaging() -> list[str]:
     failures: list[str] = []
     pyproject = tomllib.loads((REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8"))
     package_data = set(pyproject["tool"]["setuptools"]["package-data"]["codex_usage_tracker.plugin_data"])
+    if "dashboard/locales/*" not in package_data:
+        failures.append("pyproject.toml package data is missing dashboard locale catalogs")
     for source_skill in sorted((REPO_ROOT / "skills").glob("*/SKILL.md")):
         skill_name = source_skill.parent.name
         package_skill = (

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/scripts/smoke_installed_package.py

@@ -73,6 +73,18 @@ RESOURCE_PATHS = [
     "dashboard/dashboard.js",
     "dashboard/dashboard_state.js",
     "dashboard/dashboard_template.html",
+    "dashboard/locales/en.json",
+    "dashboard/locales/vi.json",
+    "dashboard/locales/es.json",
+    "dashboard/locales/fr.json",
+    "dashboard/locales/de.json",
+    "dashboard/locales/pt.json",
+    "dashboard/locales/ja.json",
+    "dashboard/locales/zh-Hans.json",
+    "dashboard/locales/ko.json",
+    "dashboard/locales/ru.json",
+    "dashboard/locales/it.json",
+    "dashboard/locales/ar.json",
     "docs/dashboard-guide.html",
     "docs/assets/dashboard-insights.png",
     "docs/assets/dashboard-calls.png",

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/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.4.1",
+    "codex-usage-tracking==0.5.0",
 )
-RUNTIME_VERSION = "0.4.1"
+RUNTIME_VERSION = "0.5.0"
 PACKAGE_SPEC_MARKER = ".codex-usage-tracker-package-spec"
 MODULE_CHECK = (
     "import importlib.metadata; "

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/src/codex_usage_tracker/__init__.py

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

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/src/codex_usage_tracker/cli.py

@@ -30,6 +30,7 @@ from codex_usage_tracker.formatting import (
     format_doctor,
     format_session,
 )
+from codex_usage_tracker.i18n import normalize_language
 from codex_usage_tracker.parser import inspect_log, load_session_index
 from codex_usage_tracker.paths import (
     DEFAULT_ALLOWANCE_PATH,
@@ -110,6 +111,14 @@ def _build_parser() -> argparse.ArgumentParser:
     parser.add_argument("--rate-card", type=Path, default=DEFAULT_RATE_CARD_PATH)
     parser.add_argument("--thresholds", type=Path, default=DEFAULT_THRESHOLDS_PATH)
     parser.add_argument("--projects", type=Path, default=DEFAULT_PROJECTS_PATH)
+    parser.add_argument(
+        "--lang",
+        default=None,
+        help=(
+            "Initial dashboard language. Accepts supported language codes and common aliases; "
+            "defaults to CODEX_USAGE_TRACKER_LANG or en."
+        ),
+    )
     parser.add_argument(
         "--privacy-mode",
         choices=PRIVACY_MODE_CHOICES,
@@ -942,6 +951,7 @@ def _run_dashboard(args: argparse.Namespace) -> int:
         projects_path=args.projects,
         privacy_mode=args.privacy_mode,
         include_archived=args.include_archived,
+        language=normalize_language(args.lang),
     )
     if args.as_json:
         _print_json(
@@ -954,6 +964,7 @@ def _run_dashboard(args: argparse.Namespace) -> int:
                 "since": args.since,
                 "privacy_mode": args.privacy_mode,
                 "include_archived": args.include_archived,
+                "language": normalize_language(args.lang),
             }
         )
     else:
@@ -986,6 +997,7 @@ def _run_open_dashboard(args: argparse.Namespace) -> int:
         projects_path=args.projects,
         privacy_mode=args.privacy_mode,
         include_archived=args.include_archived,
+        language=normalize_language(args.lang),
     )
     if args.as_json:
         _print_json(
@@ -999,6 +1011,7 @@ def _run_open_dashboard(args: argparse.Namespace) -> int:
                 "refresh": refresh_payload,
                 "privacy_mode": args.privacy_mode,
                 "include_archived": args.include_archived,
+                "language": normalize_language(args.lang),
             }
         )
     else:
@@ -1021,6 +1034,7 @@ def _run_serve_dashboard(args: argparse.Namespace) -> int:
                 "refresh_before_start": args.refresh,
                 "privacy_mode": args.privacy_mode,
                 "include_archived": args.include_archived,
+                "language": normalize_language(args.lang),
             }
         )
     if args.refresh:
@@ -1047,6 +1061,7 @@ def _run_serve_dashboard(args: argparse.Namespace) -> int:
         thresholds_path=args.thresholds,
         projects_path=args.projects,
         privacy_mode=args.privacy_mode,
+        language=normalize_language(args.lang),
     )
     return 0
 

{codex_usage_tracking-0.4.1 → codex_usage_tracking-0.5.0}/src/codex_usage_tracker/costing.py

@@ -8,6 +8,15 @@ from typing import Any
 from codex_usage_tracker.paths import DEFAULT_PRICING_PATH
 from codex_usage_tracker.pricing_config import PricingConfig, load_pricing_config
 
+EFFICIENCY_FLAG_KEYS = {
+    "high context use": "flag.high_context_use",
+    "elevated context use": "flag.elevated_context_use",
+    "high reasoning share": "flag.high_reasoning_share",
+    "low cache reuse": "flag.low_cache_reuse",
+    "expensive low-output call": "flag.expensive_low_output_call",
+    "high estimated cost": "flag.high_estimated_cost",
+}
+
 
 def summarize_pricing_coverage(
     rows: list[dict[str, Any]],
@@ -92,6 +101,11 @@ def annotate_rows_with_efficiency(
         copy["pricing_model"] = config.priced_as(model)
         copy["pricing_estimated"] = config.is_estimated_model(model)
         copy["efficiency_flags"] = efficiency_flags(copy)
+        copy["efficiency_flag_keys"] = [
+            EFFICIENCY_FLAG_KEYS[flag]
+            for flag in copy["efficiency_flags"]
+            if flag in EFFICIENCY_FLAG_KEYS
+        ]
         annotated.append(copy)
     return annotated