From 84761800b1281f137c64f7951497d919e16b68a4 Mon Sep 17 00:00:00 2001 From: "Claude (agent)" Date: Thu, 14 May 2026 10:53:47 -0400 Subject: [PATCH] docs: align Arbiter install package name --- README.md | 9 ++++++--- docs/REPO_HEALTH.md | 1 + 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index dadfcfd..7ddbb06 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Arbiter [![CI](https://github.com/hummbl-dev/arbiter/actions/workflows/ci.yml/badge.svg)](https://github.com/hummbl-dev/arbiter/actions/workflows/ci.yml) -[![PyPI](https://img.shields.io/pypi/v/arbiter)](https://pypi.org/project/arbiter/) +[![PyPI](https://img.shields.io/pypi/v/arbiter-score)](https://pypi.org/project/arbiter-score/) [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE) [![Dependencies](https://img.shields.io/badge/core_deps-stdlib_only-brightgreen)]() @@ -14,9 +14,12 @@ Repository health, validation, and stewardship expectations are tracked in [docs ## Install +The Python distribution is `arbiter-score`; the installed CLI command is `arbiter`. +Do not install the separate PyPI project named `arbiter` for this tool. + ```bash -pip install arbiter # core (stdlib only) -pip install "arbiter[analyzers]" # + ruff, radon, vulture, bandit +pip install arbiter-score # core (stdlib only) +pip install "arbiter-score[analyzers]" # + ruff, radon, vulture, bandit # Or from source git clone https://github.com/hummbl-dev/arbiter.git && cd arbiter diff --git a/docs/REPO_HEALTH.md b/docs/REPO_HEALTH.md index 97d3059..6161779 100644 --- a/docs/REPO_HEALTH.md +++ b/docs/REPO_HEALTH.md @@ -73,6 +73,7 @@ Branch protection is tracked centrally in `hummbl-dev/hummbl-dev#18`; do not ove - The core package should remain usable without analyzer extras; analyzer-specific integrations belong behind optional extras. - Public install instructions must match `pyproject.toml` package metadata and published distribution names. +- `arbiter-score` is the intended public distribution name; `arbiter` is only the installed CLI entry point for this repository and should not be documented as the PyPI package. - Self-grade and reusable quality-gate thresholds are product contracts, not decorative metrics. - Changes to scoring formulas, analyzer weights, noise thresholds, or agent attribution should include before/after evidence. - Generated scoring artifacts such as local JSONL audit files should not be treated as source-of-truth documentation unless explicitly committed by design.