manuheart 0.1.1

Python rewrite of the Manuheart health checker

Manuheart Python

Quick start

Install for local development:

python -m venv .venv
.venv/bin/python -m pip install -e '.[dev,yaml]'

Validate the example config:

.venv/bin/python -m manuheart validate-config --config examples/localhost/manuheart.json

Run one check cycle:

.venv/bin/python -m manuheart check --config examples/localhost/manuheart.json

Run the public deployment smoke config:

.venv/bin/python -m manuheart check --config examples/deployment-test/public-smoke.json

Run daemon mode:

.venv/bin/python -m manuheart daemon --config examples/localhost/manuheart.json

Use the library API:

from manuheart.api import CheckerMap, load_config, run_check, write_reports

config = load_config("examples/localhost/manuheart.json")
result = run_check(config)
write_reports(result)

Typed extension points such as CheckerMap, ClockSource, SleepFunction, and DaemonEventCallback are exported from manuheart.api for callers that inject custom checkers, clocks, daemon sleepers, or daemon event hooks.

Library callers can also pass previous_state= to run_check() for in-memory state continuity, or load_previous=False when they want a single cycle that deliberately avoids reading previous report files.

Run the local verification gate:

.venv/bin/python -m ruff check src tests scripts
.venv/bin/python -m mypy src/manuheart
.venv/bin/python -m pytest -q
.venv/bin/python scripts/check_localhost_compatibility.py
.venv/bin/python scripts/check_dependency_security.py
.venv/bin/python scripts/check_clean_install.py

Docs

• Scope
• Requirements
• Architecture and deployment notes
• Health state semantics
• Deployment test config
• Release posture
• PyPI trusted publishing setup
• Security and privacy notes
• Changelog
• QA evidence
• Implementation checklist
• Bash implementation understanding
• Python architecture proposal
• Localhost compatibility differences
• Fixture intake policy