feat(reporting): vitest-style TUI reporter with real-time file streaming

[NikkeTryHard]

Summary

• Redirect all diagnostic [tach:*] and [worker:*] stderr logs to /tmp/tach.log using fd-level redirection (fcntl(F_DUPFD_CLOEXEC) / dup2)
• Stream file results in real-time via bar.println() as each test file completes — files scroll up above a sticky spinner
• Spinner shows live stats: Running N tests · X passed · Y failed
• Vitest-style summary block with aligned labels: Test Files, Tests, Duration, Log file
• Crash resilience: unstreamed files from worker crashes are printed in final output

Changes

• New: src/reporting/logredirect.rs — stderr-to-file redirect with RAII restore
• Modified: src/reporting/reporter.rs — TachReporter gains real-time streaming, per-file tracking, improved spinner, aligned summary
• Modified: src/main.rs — wire log redirect and per-file test counts
• Modified: src/reporting/mod.rs, src/lib.rs — module exports

Test plan

• 844 unit tests passing (cargo nextest run --lib)
• Clippy clean, fmt clean
• LogRedirect: 5 tests (creation, path, capture, restore, drop)
• TachReporter streaming: 8 tests (completion, crash, skip, ordering)
• End-of-worktree audit: all high/medium issues resolved

Summary by CodeRabbit

• New Features

  • Real-time per-file test result streaming as files complete.
  • Automatic diagnostic log capture to file during interactive mode.
  • Improved terminal color support and output formatting.
  • Enhanced output readability with per-file summary information and failure details.

• Bug Fixes

  • Better handling of terminal color detection and output routing.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This pull request implements the first phase of a TUI-like reporting system by adding stderr log redirection, per-file test count tracking, and real-time streaming of file results to stdout. New LogRedirect module handles fd-level redirection; Reporter trait expanded with session setup and log path methods; TachReporter refactored to stream results incrementally during test execution.

Changes

Cohort / File(s)	Summary
Planning Documentation docs/plans/2026-02-07-tui-reporter.md	Comprehensive three-phase implementation plan for TUI-like reporting and log suppression, including stderr redirection, real-time streaming, and polish/integration tasks with commit steps and test scaffolding.
Module Exports src/lib.rs, src/reporting/mod.rs	Exposed new logredirect module as part of the public API via re-exports.
Log Redirection Implementation src/reporting/logredirect.rs	New LogRedirect utility struct using fd-level operations (fcntl, dup2) to redirect stderr to a log file for the duration of its lifetime, with manual restore() method and Drop implementation ensuring cleanup.
Reporter Trait & Implementations src/reporting/reporter.rs	Added on_session_setup and set_log_path trait methods; TachReporter enhanced with per-file test count tracking (file_expected, files_streamed, files_printed), real-time streaming logic, color handling via supports_colors_stdout, and reorganized output from stderr to stdout for file-list and summary sections.
Session Execution Wiring src/main.rs	Integrated LogRedirect initialization in interactive mode, wired per-file counts to reporter.on_session_setup, set log paths on reporters, and ensured log redirect cleanup via drop() after test execution.

Sequence Diagram(s)

sequenceDiagram
    participant Main as Main<br/>Session
    participant LogRedir as LogRedirect<br/>(fd 2)
    participant Reporter as TachReporter<br/>Reporter
    participant TestRunner as Test<br/>Scheduler
    participant Stdout as Stdout

    Main->>LogRedir: new() create log redirect
    LogRedir->>LogRedir: dup2(fd 2 → log file)
    LogRedir-->>Main: return LogRedirect

    Main->>Reporter: on_session_setup(file_counts)
    Reporter->>Reporter: store file_expected map
    Main->>Reporter: set_log_path(path)
    Reporter->>Reporter: store log_path

    TestRunner->>TestRunner: run tests per file
    TestRunner->>Stdout: (diagnostics via fd 2<br/>redirected to log)

    rect rgba(100, 200, 100, 0.5)
    TestRunner->>Reporter: on_test_finished(file_result)
    Reporter->>Reporter: check files_streamed
    Reporter->>Stdout: format_file_line(per-file<br/>summary)
    Reporter->>Stdout: render failures<br/>with icons
    Reporter->>Reporter: mark file as streamed
    end

    Main->>LogRedir: drop()
    LogRedir->>LogRedir: dup2(fd 2 → original)
    LogRedir->>Stdout: restore stderr

    Main->>Stdout: final summary<br/>(with log path)

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Poem

🐰 Whiskers twitch with delight—stderr now flows to files so neat,
Per-file streams dance on stdout, real-time progress is sweet!
LogRedirect hops and captures, fd operations with care,
TachReporter now spreads its wings through the terminal air! ✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/tui-reporter

---

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 and usage tips.}