Release Checklist
██████╗ ███╗ ██╗███████╗██╔═══██╗████╗ ██║██╔════╝██║ ██║██╔██╗ ██║█████╗██║ ██║██║╚██╗██║██╔══╝╚██████╔╝██║ ╚████║███████╗ ╚═════╝ ╚═╝ ╚═══╝╚══════╝Reproducible commands for verifying the one-agent package before publication.
Run from the repository root.
Prerequisites
Section titled “Prerequisites”# Activate the virtual environment (already created during setup)source .venv/bin/activate1. Full test suite
Section titled “1. Full test suite”python -m pytest -q2. Lint
Section titled “2. Lint”python -m ruff check .3. Build packages
Section titled “3. Build packages”python -m buildProduces dist/one-agent-*.tar.gz and dist/one-agent-*.whl.
4. Twine check (wheel + sdist)
Section titled “4. Twine check (wheel + sdist)”twine check dist/*5. Dependency consistency
Section titled “5. Dependency consistency”pip check6. Fresh install outside checkout
Section titled “6. Fresh install outside checkout”# Install into a temporary venv from the built wheelTMPDIR=$(mktemp -d)python3 -m venv "$TMPDIR/test-env". "$TMPDIR/test-env/bin/activate"python -m pip install --no-deps dist/one-agent-*.whl# PYTHONPATH must NOT be set so the test resolves the installed package,# not the source checkout.env -u PYTHONPATH "$TMPDIR/test-env/bin/python" -c "import one; print(one.config.VERSION)"env -u PYTHONPATH "$TMPDIR/test-env/bin/python" -c "from one.modes.print_mode import run_print_mode; print('import ok')"
# Same for the sdist (rebuild first, then install)python -m build --sdistenv -u PYTHONPATH "$TMPDIR/test-env/bin/python" -m pip install --no-deps "$(ls dist/one-agent-*.tar.gz)"env -u PYTHONPATH "$TMPDIR/test-env/bin/python" -c "import one; print(one.config.VERSION)"
rm -rf "$TMPDIR"7. Archive allowlist inspection
Section titled “7. Archive allowlist inspection”# List all files in the wheelunzip -l dist/one-agent-*.whl
# List all files in the sdisttar tzf dist/one-agent-*.tar.gzVerify archives exclude: tests/, .one/, __pycache__/, .git/, credentials,
and any private blobs. Wheels must not contain *.egg-info/; setuptools may
include only its generated one_agent.egg-info/SOURCES.txt manifest in the sdist.
8. Gitleaks — full-history scan
Section titled “8. Gitleaks — full-history scan”# Check the installed version's flag syntax firstgitleaks --help | grep -i redact || gitleaks version
# Full-history redacted scan (output redacted; secrets must never be printed)gitleaks detect --source . --report-format json --report-path /tmp/gitleaks-report.json# Inspect only finding types (not raw secrets):jq '[.[].RuleID] | unique' /tmp/gitleaks-report.jsonNote: Syntax (--report-format, --report-path) varies by gitleaks version.
Always check gitleaks --help for the exact flags on the installed version.
9. pip-audit — resolved-environment scan
Section titled “9. pip-audit — resolved-environment scan”# Scan the currently resolved environment.pip-audit# If a requirements file is introduced later, scan it explicitly with:# pip-audit -r requirements.txt10. License & fixture provenance
Section titled “10. License & fixture provenance”- Review all third-party licenses in
.venv/lib/python*/site-packages/*/LICENSE* - Verify test image fixtures (PNG/JPEG/WebP) are self-generated (see
_make_png,_make_jpegin test files) or have permissive licenses
- Version rule: user-visible changes bump
VERSIONperAGENTS.md → Versioning(pinned tests, TUI goldens, andCHANGELOG → Unreleasedmove with it). - Secret/history scanning and GitHub security controls remain manual maintainer steps. These are not automated in CI and must be run by an authorized maintainer with the necessary permissions.
- The
ONE_CODING_AGENT_DIRenvironment variable must point to a scratch dir during tests (every CLI subprocess test uses atmp_path-backed agent dir). - CLI subprocess tests strip all inherited provider API keys via
_PROVIDER_KEY_NAMESintests/test_image_cli_rpc.py.