Final output local filter

Public quick start

What it is: A deterministic, local-only Hermes Agent output filter with a reusable document checker. Who it is for: Hermes users who want narrow, reviewable cleanup or a local Markdown/document dry run. Requirements: Python 3 for the standalone checker; no external Python dependencies are declared. Hermes Agent is needed only for plugin integration. The filter makes no provider or network calls.

hermes plugins install kkwelfare/final-output-local-filter --no-enable
hermes plugins enable final-output-local-filter

Minimal local use: python3 check_document.py sample.md runs a dry run; review the result before using the explicit --apply option.

License: MIT.

A deterministic, local-only Hermes output filter and reusable document checker. filter_core.py preserves Markdown and protected syntax, applies narrowly bounded rules, and fails open on ambiguity. It never calls a provider.

Components

• filter_core.py: pure deterministic transform; filter_text(text, mode="response") preserves the historical response behavior; mode="document" checks prose segments with bounded, segment-local rollback and the visible document cap.
• __init__.py: Hermes transform_llm_output adapter returns only changed final output; otherwise returns None to preserve pass-through.
• check_document.py: local UTF-8 document check. Dry-run is the default; --apply atomically writes only the specified path when a safe candidate exists. Reports include text for local caller use; handle reports accordingly.
• tests/test_filter_core.py: deterministic synthetic regression tests; no provider/network calls.

No correction is made for ambiguous, protected, technical, conditional, operational, or otherwise excluded text. The checker does not make correctness or completeness judgments. This is a narrow language-cleanup aid, not a universal safety or quality gate.

Try

python3 check_document.py sample.md
# Only after reviewing the dry-run result:
python3 check_document.py sample.md --apply

Install/enable through Hermes' plugin manager for host integration. Installing this source does not activate a running profile or gateway. The package declares no external Python dependencies and makes no provider calls.

Verify

python3 -m pytest -q tests/test_filter_core.py
hermes plugins validate . --json