From the 2026-06-10 codebase-health review. Priority: HIGH (visitor-facing, 5-minute fix).
main.py and examples_advanced.py are git-tracked at the repo root, predate the mailrag CLI and persona wizard, are not referenced by the README, and import internals directly (build_contextual_index, RAGConfig) with nothing testing them — they bit-rot silently.
The repo root is the first thing a visitor sees; two orphaned entry points alongside a polished CLI tell a confusing story about how to run the project.
Fix: delete both (the CLI + wizard are the real entry points and the README quickstart covers them). If a runnable example is still wanted, fold the useful parts into one examples/ script the README links.
From the 2026-06-10 codebase-health review. Priority: HIGH (visitor-facing, 5-minute fix).
main.pyandexamples_advanced.pyare git-tracked at the repo root, predate themailragCLI and persona wizard, are not referenced by the README, and import internals directly (build_contextual_index,RAGConfig) with nothing testing them — they bit-rot silently.The repo root is the first thing a visitor sees; two orphaned entry points alongside a polished CLI tell a confusing story about how to run the project.
Fix: delete both (the CLI + wizard are the real entry points and the README quickstart covers them). If a runnable example is still wanted, fold the useful parts into one
examples/script the README links.