Noisegate v0.3.1

Noisegate 0.3.1 is a focused exact-output and contract release. It closes two small but important gaps where structured terminal evidence or Hermes session listings could be mistaken for generic noise, while keeping the existing fail-open and no-artifact defaults intact.

The release also freezes a provider-neutral consumer contract and portable test vectors for future post-redaction lossless recovery. That is a contract and test pack, not a speculative production adapter: the Hermes host seam remains separately owned and must exist before Noisegate can consume it.

Highlights

• Strict JSON stays parseable. A complete JSON document crossing the early terminal hook now passes through byte-exact instead of risking malformed head/tail output.
• Session listings stay evidence. hermes sessions list and hermes sessions browse are now protected retrieval commands across supported wrappers and hook paths.
• Lossless recovery has a frozen target. Portable vectors define ref integrity, stage ordering, exact fallback, canary containment, and artifact separation without coupling Noisegate to an unaccepted host API.
• Release tests travel better. Artifact recovery tests no longer depend on the host's temporary-path length.

Fixed

• Complete strict JSON documents crossing the early Hermes terminal-output hook now stay exact instead of being compacted as generic text.
• Preserve terminal output from hermes sessions list and hermes sessions browse as exact retrieval evidence while leaving session mutation and maintenance commands under their existing behavior.
• Make artifact CLI and recovery tests independent of long pytest temporary roots without weakening recovery-notice budgets or artifact safety.

Documentation

• Added the provider-neutral post-redaction lossless-recovery consumer contract, language-neutral fixtures, and a strict test-only truth-table validator.
• Made contribution and incoming-review guidance explicitly risk-aware, with proportionate evidence requirements and stronger untrusted-code safety checks.

How to update

For an existing Hermes Agent installation, run:

uvx --from noisegate-hermes noisegate install-hermes

Preview the exact commands first. Dry-run mode does not run the install/enable/doctor commands and does not restart or reload Hermes:

uvx --from noisegate-hermes noisegate install-hermes --dry-run

npm users can use the wrapper instead:

npx -p noisegate-hermes noisegate install-hermes

The installer finds hermes on PATH, verifies that the launcher points at a Hermes Python console script or supported Hermes shim inside a virtual environment, installs noisegate-hermes there, enables the noisegate plugin, removes any stale plugins.disabled entry for noisegate, and runs noisegate doctor.

If Hermes is running as a long-lived gateway/service, restart or reload that Hermes process through your normal maintenance flow after installing so the plugin/config change is picked up. Avoid interrupting in-flight agent work.

Included pull requests

Release range: v0.3.0...v0.3.1.

Release / Packaging

• #44 Prepare Noisegate 0.3.1 release — @Tosko4. Prepare Noisegate 0.3.1 across Python, plugin, lockfile, and npm wrapper metadata.

Changed

• #33 Make artifact CLI test path-independent — @Tosko4. Makes the custom artifact-directory CLI test independent of pytest's host-specific temporary-root length and keeps it runnable from a source checkout without an editable install.
• #36 test: make remaining artifact recovery tests path-independent — @Tosko4. Make the two remaining artifact recovery tests independent of pytest temporary-root length.

Fixed

• #35 Preserve Hermes session-listing output — @Tosko4. Preserve terminal output from hermes sessions list and hermes sessions browse as exact retrieval evidence.
• #43 Preserve strict JSON from the direct terminal hook — @Tosko4

Documentation

• #32 docs: make contribution reviews risk-aware — @Tosko4. Make contribution evidence proportional to the actual change instead of mandatory template prose.
• #40 docs: freeze lossless recovery consumer contract — @Tosko4. Freeze the provider-neutral Noisegate consumer contract for post-redaction lossless recovery.

New contributors

• No new contributors in this release range.