feat!: remove the experimental agent, GEPA optimization, and distillation surfaces

[SkyeAv]

Removes the experimental tablassert agent pipeline, the GEPA prompt-optimization surface, and the
distillation dataset export/weigh surface, plus their extras, tests, examples, and every documentation
mention. The stable core pipeline (build-kg, validate, validate-kgx, validate-infores,
build-fullmap, quick-map) is untouched.

Removed surfaces

• Agent pipeline: src/tablassert/agent.py and the tablassert agent CLI command (supervisor loop, PMC fetching, config derivation, judge/reflexion improvement, checkpoint state, TABLASSERT_AGENT_* env vars).
• GEPA optimization: the --optimize flag family, the [optimize] extra (dspy), and examples/agent/ (GEPA dataset plus optimized-instruction artifacts); the now-empty examples/ directory is gone.
• Distillation: src/tablassert/distill.py, src/tablassert/distill_reward.py, the tablassert distill-export and tablassert distill-weigh commands, and the [distill] extra (datasets).
• Graph target helper: src/tablassert/graph_target.py, which only the agent command consumed.
• Extras registry: drops agent / optimize / distill from pyproject.toml and src/tablassert/extras.py; extras.require_module and _FALLBACK_EXTRA go too, since only the agent's dynamic lazy imports ever called them.
• Error codes: removes the agent-only llm-transient (LlmTransientError) and reward-config-invalid (RewardConfigError); network-transient, error_code_of, and redact_secrets stay (net.py and the CLI still use them).
• Tests: deletes the 30 agent/distill/graph-target/example test modules and the tests/agent_fixtures/ + tests/fixtures/edgecount/ trees; trims the agent/distill cases from the CLI, extras, errors, net, and docs-guardrail suites.

Docs

• docs/agent.md and its mkdocs.yml nav entry removed; docs/cli.md (nine -> six subcommands), docs/installation.md, docs/index.md, README.md, and llms.txt no longer mention the agent, GEPA, or distillation.
• CONTRIBUTING.md drops the examples/ layout row; the docs layout guard no longer requires that path.
• CHANGELOG.md history is left untouched: past release notes describe shipped versions as they were.

Breaking change

• pip install "tablassert[agent]" / [optimize] / [distill], the tablassert agent, tablassert distill-export, and tablassert distill-weigh commands no longer exist. The next release must bump the major version.

Testing

• uv lock --check -> resolved, in sync
• uv run ruff check . and uv run ruff format --check . -> all checks passed
• uv run pyright -> 0 errors, 0 warnings
• uv run pytest -> 1205 passed, 1 skipped (the pre-existing opt-in corpus-sweep skip)
• cargo fmt --check, cargo clippy --all-targets -- -D warnings, cargo test -> pass (156 Rust tests)
• uv run mkdocs build --strict -> builds clean
• uv run tablassert --help -> renders exactly the six remaining subcommands

[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: 5f5dbdf9-a598-40b1-a1ba-30ac6a668a12

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.}