Class QuietContext

ci/autoresearch/context.py:59–103

Manage quiet-mode output for AI agents. In quiet mode, opens a log file for verbose fbuild output redirection. Use emit() for compact summary lines (always printed to stdout). Use log_file property to redirect subprocess output to the log. Does NOT redirect sys.stdout — CrashPatter

class QuietContext:
    """Manage quiet-mode output for AI agents.

    In quiet mode, opens a log file for verbose fbuild output redirection.
    Use emit() for compact summary lines (always printed to stdout).
    Use log_file property to redirect subprocess output to the log.

    Does NOT redirect sys.stdout — CrashPatternInterceptor in main()
    needs to see serial output on the real stdout.

    Usage::

        with QuietContext(args.quiet) as qctx:
            run_fbuild_deploy(..., log_file=qctx.log_file)
            qctx.emit("BUILD+FLASH ok 12.3s")
    """

    def __init__(self, quiet: bool, log_path: Path | None = None) -> None:
        self.quiet = quiet
        self.log_path = log_path or Path(".autoresearch_last.log")
        self._log_file: Any = None

    def __enter__(self) -> "QuietContext":
        if self.quiet:
            self._log_file = open(self.log_path, "w", encoding="utf-8")  # noqa: SIM115
        return self

    def __exit__(self, *_args: Any) -> None:
        if self._log_file is not None:
            self._log_file.close()
            self._log_file = None

    @property
    def log_file(self) -> Any:
        """Log file handle (open in quiet mode, None otherwise)."""
        return self._log_file

    def emit(self, msg: str) -> None:
        """Print a compact summary line to stdout (always visible)."""
        print(msg)

    def emit_log_path(self) -> None:
        """Print log file path so agents know where to look on failure."""
        if self.quiet:
            print(f"LOG {self.log_path}")


# ============================================================