dsh-memory

dsh-memory

dsh-memory is a local, Git-backed long-term-memory plugin for DeepSeek Harness (DSH).

It adds one persistent setting, a safe settings-page workflow for clearing memories, and an optional idle-session synchronizer. The host plugin injects memory guidance only when memory.enabled is true; the UI plugin lets a user inspect the repository state, toggle the setting, and clear learned memory through a deliberate two-step confirmation. What it does Stores durable memory in a local Git repository, not in this source repository or a hosted service. Registers the memory settings namespace immediately, so memory.enabled takes effect for the next model call without restarting DSH. Shows a long-term-memory row in DSH settings with repository status and a double-confirmation Delete memory action. Preserves a Git recovery point before clearing summary.md, handbook/, rollouts/, and archive/: a clean repository reuses its existing HEAD, while dirty target paths get a dedicated checkpoint commit; the next commit records the cleared state. Refuses unsafe repository layouts, symbolic-link escapes, non-repository roots, and path races during a clear operation. Can process only idle local session logs through an optional headless synchronizer. The synchronizer defaults to workspace-write

This README describes stable user-facing behavior. Release-by-release implementation details are intentionally kept out of this page; see CHANGELOG.md and the GitHub releases for historical changes. Local Git-backed memory Memory stays in a local Git repository. There is no hosted memory service or cloud vector database. Markdown records support front matter, namespaced ids, provenance, expiry projection, deterministic conflict handling, and legacy compatibility. summary.md is a short navigation snapshot; detailed knowledge belongs in handbook/, rollouts/, and archive/. Safe synchronization and recovery Optional idle-session sync runs in a private per-run workspace. The model can edit only the isolated copy; the host validates and writes the live Git repository. The host provides dry-run/preview/apply flows, operation locking, health checks, bounded batches, retry backoff, duplicate-id diagnostics, and metadata-only journals. Recovery/apply commits, rollback, backup export/import, and legacy migration keep changes auditable and reversible. Migration is available through the CLI/host API, not the settings UI. Read path When enabled, a bounded and explicitly untrust

The settings UI provides the memory toggle, repository status, recent-sync state, preview actions, rollback, and deliberate clear confirmation. It does not expose the filesystem root or execute Git directly. Compatibility

v0.10.0 targets the DSH desktop app 0.2.x and keeps the 0.1.x web runtime peer range: The package uses DSH's Cordis loader interfaces. The rc.7 graph is the reproducible development and integration baseline because the registry's rc.6 transitive peer graph cannot be installed by plain npm ci; this does not change the host/UI packages' declared rc.6 runtime peer range. DSH rc.8 and later releases are unverified until they pass this repository's test suite. Install DSH plugin bundl