b. Package smoke check

Stilyagi ships a built-in smoke check that confirms the embedded Rust extension module is correctly installed and reachable from Python. It is available as a CLI entrypoint:

python -m stilyagi.smoke

The command exits with status 0 when the bridge is healthy and 1 on any failure, making it suitable for Makefile targets and CI steps.

The same check is also callable programmatically:

from stilyagi.smoke import SmokeCheckError, smoke_installed_package

try:
    smoke_installed_package()
except SmokeCheckError as err:
    print(f"Bridge check failed: {err}")

smoke_installed_package() accepts an optional extract_fn keyword argument for testing purposes; in normal use the default engine.extract_document is used. SmokeCheckError is a RuntimeError subclass raised for any failure, including bridge errors, unexpected return types, and document validation failures.