feat!: move cyclopts and rich behind a new optional [cli] extra

[SkyeAv]

Moves the Cyclopts/Rich command runtime out of the base Python API and into an opt-in [cli] extra, so library installs stay lean while the tablassert console command keeps its existing behavior.

Packaging

• Base dependencies: removes cyclopts>=1.0.0 and rich>=13.0.0 from pyproject.toml core requirements.
• New [cli] extra: declares both packages in pyproject.toml and regenerates uv.lock with extra == 'cli' markers.
• tablassert launcher: points [project.scripts] at tablassert.cli_entry:main, which preflights extras.require("cli") before importing tablassert.cli.
• Missing-extra behavior: a base install reports Missing optional dependencies 'cyclopts', 'rich' with pip install "tablassert[cli]" and uv tool install "tablassert[cli]", instead of a bare module error.

Shared error formatting

• Moves flatten_pydantic_error: now lives in src/tablassert/errors.py, so agent.py, graph_target.py, and library validation paths no longer import Rich-backed tablassert.progress.
• progress.py keeps Rich UI only: PipelineProgress, format_section_compact, and _truncate remain CLI-runtime imports.
• Library imports verified: tablassert.agent and tablassert.graph_target import with cyclopts/rich blocked.

Docs

• README.md, docs/installation.md, docs/cli.md, docs/index.md, docs/development.md, docs/agent.md, llms.txt document [cli] in extra enumerations, install commands, sync commands, the CLI landing requirement, and module index.
• CHANGELOG.md carries an Unreleased BREAKING entry.
• CONTRIBUTING.md, Makefile, .github/workflows/ci.yml sync/install --extra cli alongside qc and log; CI cache suffix renamed to ci-cli-qc.

Design

• Accepted caveat: base installs still ship the tablassert console script, but invoking it without [cli] is now an actionable missing-extra error.
• Deferred: no extra-specific import shim was added inside cli.py or progress.py; direct Cyclopts/Rich imports there remain correct because the launcher preflights first.

Testing

• make check -> pass: ruff check, ruff format --check, pyright (0 errors), pytest (1517 passed, 45 skipped), Rust fmt, tests, and clippy --all-targets -- -D warnings.
• uv run pytest tests/test_extras.py tests/test_progress.py tests/test_cover_misc.py tests/test_docs_source_of_truth.py -q -> 241 passed.
• Base wheel probe: built release wheel, installed with --no-deps, tablassert --help exits nonzero with the [cli] install command and no installed cyclopts/rich.
• [cli] wheel probe: wheel[cli] imports cyclopts and rich, and tablassert --help lists all seven live commands.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: aeabdac3-2987-4d67-9deb-3f7cf1be7a71

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}