Python implementation of role-scoped, plain-text persona evolution for Hermes.
| Layer | Status |
|---|---|
| Implementation and synthetic verification | Complete (87 component + 218 host cases, 0 failed/skipped), including a fresh SDK source + distributed patch + installed wheel replay |
| Native SDK extension | Committed locally on top of the pinned base; tree identical to the verified extension |
| Plugin bundle | Installed on the owner's default Hermes profile; native loader and Plugin Doctor pass |
| Gateway restart | Observed on a new process; the existing SOUL and unrelated configuration were unchanged |
| Persona evolution | Disabled. No real role sources, no source/write/model consent, no helper calls |
| Public release of this branch | This branch is published as source; the installed copy lives in the owner's Hermes home and is not part of this repository |
Installing the plugin is not the same as enabling evolution. Creating real role documents, pinning a Mission version, approving a helper model route and allowing automatic writes are separate owner decisions; each is recorded in status.json and installation.
- Authoring authority:
<approved_shared_root>/personas/<persona_id>/, one role per directory. - Separate opaque UTF-8 documents: MISSION, IDENTITY, RELATIONSHIP, REDLINE, DREAM and DARK (
.MD). No required headings, blocks, frontmatter or embedded permissions. - Only IDENTITY/RELATIONSHIP/DREAM/DARK may receive one complete replacement per attempt. Mission must already be assigned and match an owner-approved version; automatic Mission/REDLINE changes are refused.
- Deterministic one-way assembly into native
SOUL.md. USER/WORLD/notes are not collected or mirrored. Optional private HOST stays local to assembly. - Persona continuation belongs to the existing managed background review. No Garden database, durable job queue, cron, independent worker, web server or management console.
- Short single-runtime commits with drift checks and exact readback. Separate source/SOUL publications are not ACID or global cross-editor CAS.
- Helper input is approved visible text plus editable source context, never inherited history/full SOUL/HOST/tool output/reasoning. One logical auxiliary completion at most; host retries and fallback remain host policy.
The native extension is bundled at garden_hermes/host_patch/; the passive plugin bundle is at garden_hermes/hermes_plugin/. Its SDK capability is version 1, based on Hermes bf0203a794a07aac3ff764972ab9087baa4e4f4e. Unsupported SDKs remain inactive. In-process plugin execution is required; do not relax hosted-isolation policy automatically.
See operator/developer guide, development acceptance, review, and authorization boundary.
.venv/bin/python tools/verify.py \
--host-source ../laputa-hermes-dev \
--host-python "$PWD/.host-venv/bin/python" \
--component-python "$PWD/.venv/bin/python" \
--scratch "$HOME/.hermes/cache/scratch/laputa-verification"The verifier uses synthetic inputs and an explicit temporary HOME/profile, runs serially, and does not install anything. --installed additionally requires imports from the selected environments rather than the source checkout; it is used for wheel acceptance.
Real source bootstrap, private-data/model use, activation and public release require separate owner authorization. The recorded installation used synthetic acceptance only: no real persona text, no real provider call and no observed identity change is claimed.
PRD · architecture · contracts · Story status · conformance.
The original Go implementation and historical work remain archived; they are design references, not this Python implementation or evidence of its acceptance. Existing deployments and other machines are not changed. License: existing repository MIT license.