B4: ship bridge packaging and smoke docs

[samrusani]

Summary

• publish the final Hermes bridge operator guide, provider-plus-MCP recommendation, MCP-only fallback guidance, and migration path docs
• add concrete example config files for provider-plus-MCP and MCP-only modes
• strengthen smoke validation and add the one-command local demo helper so external operators can validate the shipped bridge path without control-tower context

Operator Paths

• recommended path: provider_plus_mcp
• fallback path: mcp_only
• demo command: ./.venv/bin/python scripts/run_hermes_bridge_demo.py

Verification

• python3 scripts/check_control_doc_truth.py
• ./.venv/bin/python -m pytest tests/unit tests/integration -q
• ./.venv/bin/python scripts/run_hermes_memory_provider_smoke.py
• ./.venv/bin/python scripts/run_hermes_mcp_smoke.py
• ./.venv/bin/python scripts/run_hermes_bridge_demo.py

Upgrade Overview

Protected Areas

• continuity APIs
• memory schema
• trust rules
• evidence pipeline

Compatibility Impact

This is a bridge-phase packaging and enablement closeout. It does not reopen B1 through B3 implementation architecture; it documents the shipped provider-plus-MCP path as the recommended deployment shape and clarifies the MCP-only fallback.

Migration / Rollout

Publish the updated docs, config examples, smoke helpers, and demo helper together so operators can follow one consistent bridge setup path. No feature-surface migration beyond the documented MCP-only to provider-plus-MCP path is introduced here.

Operator Action

Follow the operator guide, choose the recommended provider_plus_mcp path where possible, use the documented mcp_only fallback only when required, and validate the environment with the provider smoke, MCP smoke, and one-command bridge demo.

Validation

Branch-local verification passed:

• python3 scripts/check_control_doc_truth.py -> PASS
• ./.venv/bin/python -m pytest tests/unit tests/integration -q -> 1191 passed in 187.48s (0:03:07)
• ./.venv/bin/python scripts/run_hermes_memory_provider_smoke.py -> PASS
• ./.venv/bin/python scripts/run_hermes_mcp_smoke.py -> PASS
• ./.venv/bin/python scripts/run_hermes_bridge_demo.py -> PASS

Rollback

Revert the squash merge commit to restore the pre-B4 docs and smoke helper state, then rerun the smoke scripts and demo helper before redistributing operator guidance.