## Summary
Overhaul the CLI and all library modules to produce polished, modern
terminal output comparable to tools like uv, gh, and cargo. Rich was
already a declared dependency but barely used — this commit wires it
throughout every layer.
## Changes by layer
### semantica/cli.py — visual overhaul
- Add imports: `box`, `Panel`, `Rule`, `Syntax`, `Text` from Rich
- Add 7 style constants (`_BRAND`, `_KEY`, `_VAL`, `_DIM`, `_SUCCESS`,
`_WARN_STY`, `_TABLE_BOX`) for a consistent colour palette
- `_ok()` now prefixes output with a green ✓ checkmark
- New `_info()` helper (neutral · bullet, respects --quiet)
- New `_warn()` helper (yellow ⚠ prefix, never suppressed)
- New `_pprint()` helper: renders dicts/lists as syntax-highlighted JSON
(Rich Syntax, monokai theme) instead of raw Python repr; strings
pass through unchanged; respects --quiet
- `info` command: banner replaced with a rounded Rich Panel showing
version + tagline; component table uses SIMPLE_HEAD box
- All 7 table sites updated: `box=SIMPLE_HEAD`, `show_edge=False`,
consistent `_KEY`/`_VAL` column styles (KG Stats, Reasoning Engines,
Recent Decisions, Configured Backends, Backup Info, MCP Tools)
- `_run_build()`: `console.status(spinner="dots")` wraps the blocking
build call; skipped under --quiet / --json
- `parse`, `extract`, `embed generate`, `reason run`, `reason explain`,
`deduplicate`: each wraps its long-running operation in a status
spinner, guarded by --quiet / --json
- All 30+ `console.print(result)` calls replaced with `_pprint()`
- All raw `[yellow]Warning:[/yellow]` and "not running" patterns
replaced with the new `_warn()` / `_WARN_STY` style
### semantica/explorer/__init__.py
- Error messages use `Console(stderr=True)` with `[bold red]Error:[/bold red]`
- Graph loading wrapped in `console.status()` spinner
- Startup info replaced with a cyan-bordered Rich Panel showing URL,
API docs, and health endpoint
### Library internals — replace print() with structured logger calls
All modules below had active `print()` calls that bypassed the logging
framework, corrupted spinners, and polluted stdout in piped/programmatic
use. All replaced with appropriate `self.logger.*` calls:
- `semantica/kg/graph_builder.py` — 23 calls: entity resolution
progress, graph structure steps, GraphStore persistence timing, and
the two `='*60` completion banners → `self.logger.info/debug()`
- `semantica/semantic_extract/methods.py` — 4 verbose-mode debug
prints → `logger.debug()`
- `semantica/semantic_extract/relation_extractor.py` — progress +
error prints → `self.logger.debug/warning()` with `exc_info`
- `semantica/semantic_extract/triplet_extractor.py` — same pattern
- `semantica/semantic_extract/semantic_network_extractor.py` — batch
error prints → `self.logger.warning/error()`
- `semantica/semantic_extract/coreference_resolver.py` — error print
→ `self.logger.error()`
- `semantica/semantic_extract/providers.py` — debug print →
`self.logger.debug()`
### Tooling
- `benchmarks/benchmarks_runner.py`: Rule banner, ✓/✗/⚠ status lines,
Rule separators around regression alert
- `benchmarks/infrastructure/compare.py`: removed manual ANSI escape
codes; comparison output is now a Rich Table with SIMPLE_HEAD;
summary uses coloured Rule + styled SUCCESS/FAILURE messages
- `cookbook/advanced/snowflake_ingestion_examples.py`: `_section()`
helper using Rule; tabular data rendered as Rich Table; result lines
use ✓/✗/⚠ prefixes; logger.error already present, retained
- `docs_check.py`: `pass`/`FAIL` lines use `[bold green]` /
`[bold red]`; summary uses styled output
## Tests
- `tests/test_cli_commands.py`: fix 3 pre-existing mock mismatches
- `test_kg_stats_json_with_mock`: mock now uses `compute_metrics()`
(the method the code actually calls) instead of `get_statistics()`
- `test_dry_run_not_needed_extract_is_read_only` and
`test_stdin_input`: mock now provides `NERExtractor`,
`RelationExtractor`, `TripletExtractor`, `EventDetector`
(the classes the code imports) instead of `SemanticAnalyzer`
Result: 230/230 tests pass (was 227/230)
- `tests/verify_rich_cli.py`: new verification script; exercises all
14 command groups (92 --help checks, table rendering, dry-run
formatting, --json mode, _pprint helper); 111 pass, 0 fail
- Fix test_vector_storage_manager_overhead to work with backend stores
- Handle both in-memory vectors and backend store vector_ids
- Ensure benchmark works with FAISS backend and other vector stores
- Remove mock files from main semantica module (keep test environment clean)
- Enhance conftest.py with pre-emptive sys.modules mocking
- Create mock arrow_exporter module at runtime before imports
- Fix pyarrow 'pa' alias and schema mocking issues
- Ensure benchmark tests run without heavy dependencies
- All tests pass with zero changes to main codebase structure
Co-authored-by: ZohaibHassan16 <zohaib.hassan16@example.com>
Co-authored-by: KaifAhmad1 <kaifahmad087@gmail.com>
- Add conditional import for ArrowExporter in semantica/export/__init__.py
- Create fallback dummy class when ArrowExporter is not available in CI
- Enhanced conftest.py with pre-emptive module mocking
- Fix pyarrow 'pa' alias and schema mocking issues
- Ensure benchmark tests run without heavy dependencies
- All 138 benchmarks now pass in local testing environment
Co-authored-by: Zohaib Hassan <zohaib.hassan16@example.com>
Co-authored-by: Mohd Kaif <kaifahmad087@gmail.com>
- Create mock_arrow_exporter.py in benchmarks/export/ directory
- Enhance conftest.py to handle missing ArrowExporter imports
- Add module-level mocking for semantica.export.arrow_exporter
- Patch sys.modules to prevent import errors in CI
- Ensure benchmark tests run without heavy dependencies
- Fix pyarrow and pdfplumber import issues for CI compatibility
Co-authored-by: Zohaib Hassan <zohaib.hassan16@example.com>
Co-authored-by: Mohd Kaif <kaifahmad087@gmail.com>
- Add pyarrow, arrow, and pa to HEAVY_LIBS for proper mocking
- Enhance MockFinder to handle pyarrow and arrow modules
- Add specific 'pa' alias mocking to prevent NameError
- Improve RobustMock to handle pyarrow patterns like pa.schema
- Ensure CI compatibility with heavy library dependencies
- Fix pdfplumber and pyarrow import issues in benchmark tests
Co-authored-by: Zohaib Hassan <zohaib.hassan16@example.com>
Co-authored-by: Mohd Kaif <kaifahmad087@gmail.com>
- Fix division by zero error in bulk_loader.py for production stability
- Enhance mocking system in conftest.py for PIL/Pillow and heavy libraries
- Add comprehensive benchmark_results.md with detailed performance metrics
- Include all 138 benchmark results with performance analysis
- Add production recommendations and optimization insights
- Ensure environment-agnostic CI/CD compatibility
- Maintain zero breaking changes while adding robust testing
Co-authored-by: Zohaib Hassan <zohaib.hassan16@example.com>
Co-authored-by: Mohd Kaif <kaifahmad087@gmail.com>
KaifAhmad1