Hermes Continuity Control Plane

A small Python package and Hermes-style user-plugin bundle for a continuity control-plane adapter built around a bounded Cortex Kernel.

The project models continuity as a lightweight local control plane:

• append-only continuity_events are the canonical record;
• ContinuityState, envelopes, pings, and gate verdicts are derived projections;
• the hot path stays compact and reference-based;
• normal work can fail closed at risky boundaries, while repair and inspection paths stay open.

This repository is not a memory provider, not a context-engine replacement, and not a bulk prompt-injection package. It also does not implement a federated or centralized continuity system.

What Is Included

• ContinuityEventLedger: append-only JSONL event storage and replay.
• ContinuityEnvelopeBuilder: compact model-facing continuity projection.
• ContinuityPolicy: narrow gate policy for local-frame readiness, revoked authority, stale recovery, and required repairs.
• PingController: sparse expiring boundary pings.
• CortexKernel: bounded local coordinator over policy and pings.
• HermesContinuityPlugin: adapter prototype using Hermes-style plugin hooks plus continuity_inspect and continuity_refresh tools.
• build_plugin_bundle: builds a self-contained Hermes user-plugin tarball.

Install For Development

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
python -m pytest -q

Install From GitHub

python3 -m pip install git+https://github.com/MaverickKB/hermes-continuity-control-plane.git@v0.1.1

Build A Plugin Bundle

python scripts/build_plugin_bundle.py --output dist/continuity-control-plane-v0.1.1.tgz

The bundle contains the package code plus a small plugin entrypoint. Runtime state is written under the active Hermes home directory and is not packaged into the bundle.

Release artifacts are attached to the GitHub release:

• continuity-control-plane-v0.1.1.tgz
• hermes_continuity_control_plane-0.1.1-py3-none-any.whl

Proof Boundary

The included tests verify the local package behavior. VM harnesses, private runtime benchmark artifacts, and environment-specific validation scripts are not part of this public repository.

Current claims are intentionally narrow: this is a local adapter/kernel prototype. It is not proof of native Hermes lifecycle integration, native compression/resume behavior, or production deployment readiness.

Repository Layout

src/hermes_continuity/     package code
tests/                     unit tests
scripts/build_plugin_bundle.py
examples/plugin.yaml       example plugin manifest
docs/                      public architecture notes